Data format of the procedure parameter file *.xml

Note: Files in *.xml format you can open with a text editor or in a browser. Use a text-processing editor for changes to those files.

Example: Procedure parameter file (incomplete)
<?xml version = "1.0"  encoding = "UTF-8"?>
<PROCEDURES VERSION="5">
  <OPERATIONS>
    <OPERATION
      NO = "1"
      OPERATIONTYPE = "InitAssignment"
      ACTIVE = "1"
      COMMENT = "">
      <ASSIGNMENTINITPARA        INITPUT = "1"        INITPRT = "1"      />      
    </OPERATION>
    <OPERATION
      NO = "2"
      OPERATIONTYPE = "PrTAssignment"
      ACTIVE = "1"
      COMMENT = "">
      ...
    </OPERATION>
    <OPERATION
      NO = "3"
      ...
   ...
 </OPERATIONS>
  <FUNCTIONS>
    <PUTSKIMMATRIXSETTINGS
      USELONGLENGTH = "0"
      USESECONDS = "0"
      USESECONDSIMP = "0"
      PATHLEGATTRIBUTE = "LINEROUTE\ADDVAL1"
      PATHLEGAGGREGATETYPE = "MAX"
      DISCOMFORTPARAA = "7.500"
      DISCOMFORTPARAB="4,500">
      <SINGLESKIMMATRIXSETTINGS
        NAME = "JOURNEYTIME"
        ...
      />      
      ...
    </PUTSKIMMATRIXSETTINGS>
    <PRTSKIMMATRIXSETTINGS      USELONGLENGTH="0"     USESECONDS="0">
      <USERDEFSKIM>
        ...
      </USERDEFSKIM>
      ...
    </PRTSKIMMATRIXSETTINGS>
    ...
  </FUNCTIONS>
</PROCEDURES>
Brief introduction to the *.xml data format

An *.xml file contains XML elements, whose names are in brackets. Normally, an XML element starts with the start tag <NAME> and ends with the end tag </NAME>. For example, the procedure parameters file contains the comprehensive XML element <PROCEDURES>.

An XML element may contain further XML elements between the two tags. Thus, the XML elements are structured hierarchically. In the procedure parameter file, the XML element <PROCEDURES> includes the two secondary XML elements <OPERATIONS> and <FUNCTIONS>.

The start tag of an XML element may contain XML attributes coding information on the XML element. They have the structure NAME ="Value" and follow the name of the XML element, separated by a blank each. For example, the XML element <PROCEDURES> contains the XML attribute VERSION="3".

Notes: For a better overview, subordinate XML elements are indented compared to their superior XML element. Some of the browsers allow for hiding and showing subordinate elements of an XML element, use the sign next to the start tag for toggling.

An element without subordinate elements does not necessarily need an end tag. The spelling is <NAME/>.

Structure of the procedure parameters file *.xml

The procedure parameters file contains the comprehensive XML element <PROCEDURES>. This contains the two subordinate XML elements <OPERATIONS> and <FUNCTIONS>. The XML element <OPERATIONS> describes the settings in the Procedure sequence window, whereas the XML element <FUNCTIONS> describes the settings in the General procedure settings window.

The XML element <OPERATIONS> contains the subordinate elements with the name <OPERATION>. These code a row of the procedure sequence each, and thus either a procedure or a group header. Each of the XML elements <OPERATION> has the following XML attributes: NO (consecutive number), OPERATIONTYPE (Name of the procedure or "Group") and COMMENT (Comment).

If the XML element <OPERATION> codes a procedure, it has the attribute ACTIVE additionally, which indicates whether the procedure is active or not. If the XML element <OPERATION> codes a group, it has the attribute ISEXPANDED, which indicates whether the procedures of the group are faded in or out. Some XML elements contain further XML attributes, e.g. those coding the specific selected procedure variant.

XML elements <OPERATION> coding procedures with further settings have subordinate elements with specific XML attributes.

The end of the settings description for the Procedure sequence window is indicated by the end tag </OPERATIONS>.

The XML element <FUNCTIONS> codes the settings in the General procedure settings window. For each navigator entry, a subordinate element is stored.

Note: All of the XML elements and also the XML attributes of the procedure parameters are named in English (Overview of the XML elements and XML attributes).

Overview of the XML elements and XML attributes

The tables below list the allocation of the procedures in the procedure sequence (Adding procedures to the procedure sequence) to the names of the XML elements and XML attributes.

Folder Assignments

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Delete assignment results

InitAssignment

<ASSIGNMENTINITPARA>

PrT assignment

PrTAssignment

 

  • Equilibrium assignment

PRTASSIGNMENTVARIANT=

"Equilibrium"

<EQUILIBRIUMPARA>

  • Equilibrium assignment LUCE

PRTASSIGNMENTVARIANT=

"LUCE"

<LUCEPARA>

  • Assignment with ICA

PRTASSIGNMENTVARIANT=

"ICA"

<ASSIGNMENTICAPARA>

  • Stochastic assignment

PRTASSIGNMENTVARIANT=

"Stochastic"

<STOCHASTICPARA>

  • TRIBUT - Equilibrium assignment

PRTASSIGNMENTVARIANT=

"Tribut"

(not available yet)

  • TRIBUT - Equilibrium_Lohse

PRTASSIGNMENTVARIANT=

"TributEquilibrium_Lohse"

(not available yet)

  • Dynamic User Equilibrium (DUE)

PRTASSIGNMENTVARIANT=

"Dynamic User Equilibrium"

<DUEPARAMETERS>

  • Dynamic stochastic assignment

PRTASSIGNMENTVARIANT=

"DynStochastic"

<DYNSTOCHASTICPARA>

PuT assignment

PuTAssignment

 

  • TSys-based

PUTASSIGNMENTVARIANT=

"TSys-based"

(not available yet)

  • HWay-based

PUTASSIGNMENTVARIANT=

"Headway-based"

<HEADWAYBASEDASSIGNMENTPARAMETERS>

  • Timetable-based

PUTASSIGNMENTVARIANT=

"Timetable-based"

<TTBASEDASSIGNMENTPARAMETERS>

Connection import

ConnectionImport

No subordinate element

Route import

RouteImport

(not available yet)

Extended route import

Extended RouteImport

<PRTEXTROUTEIMPORTPARA>

Set signal programs

Set Signal Programs

<SETSIGNALPROGRAMSPARA>

Update impedances at node

UpdateImpedancesAtNode

No subordinate element

Signal cycle and split optimization

Signal timing optimization

No subordinate element

Signal offset optimization

Signal coordination optimization

No subordinate element

Signal offset analysis

Analyzing signal coordination

No subordinate element

Assignment analysis

AssignmentAnalysis

(not available yet)

Folder Demand model

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Trip generation

TripGeneration

<TRIPGENERATIONPARA>

Trip distribution

TripDistribution

<TRIPDISTRIBUTIONPARA>

Mode choice

ModeChoice

(not available yet)

Time-of-day choice

TimeOfDayChoice

<TIMECHOICEPARA>

EVA trip generation

EVA TripGeneration

<EVAGENERATIONPARA>

EVA weighting

EVA Weighting

<EVAWEIGHTINGPARA>

EVA distribution/mode choice

EVA Distribution/Mode Choice

<EVAMODECHOICEPARA>

Tour-based model - trip generation

VISEM TripGeneration

<VISEMGENERATIONPARA>

Tour-based model - Combined trip distribution / mode choice

VISEM Combined

<VISEMCOMBINEDPARA>

Estimate gravitation parameters (KALIBRI)

Estimate gravitation parameters (KALIBRI)

ESTIMATEGRAVITATIONPARAMETERSPARA

 

Folder PuT Analyses

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Reset PuT operating indicators

InitPuTOperatingIndicators

<INITPUTOPINDPARA>

PuT operating Indicators

PuTOperatingIndicators

<PUTOPINDPARAMETERS>

Delete line blocks

InitLineBlockCalc

<INITLINEBLOCKINGPARA>

Line blocking

LineBlockCalc

<LINEBLOCKINGCALCPARA>

PuT interlining matrix

PuTInterliningMatrix

(not available yet)

Calculate service trip patterns

CalculateServiceTripPatterns

(not available yet)

Folder PuT Passenger Surveys

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Read survey data

ReadSingleRowSurveyData

<READSINGLEROWSURVEYDATAPARA>

Read survey data

Survey Data Plausibility

<PLAUSIPARA>

Direct assignment

Direct Assignment

<DIRECTASSIGNMENTPARA>

Folder Matrices

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Save demand matrix from route volumes

SaveMatrixFromRouteVolumes

(not available yet)

Demand matrix calibration

MatrixCalibration

(not available yet)

Demand matrix correction (TFlowFuzzy)

TFlowFuzzy

<TFLOWFUZZYPARA>

Calculate PrT skim matrix

PrTSkimMatrixCalculation

<PRTSKIMMATRIXPARA>

Calculate PuT skim matrix

PuTSkimMatrixCalculation

<PUTASSIGNMENTPARABASE>

Open matrix

OpenMatrix

<MATRIXREADPARA>

Save matrix

SaveMatrix

<SAVEMATRIXTOFILEPARA>

Combination of matrices and vectors

CombinationOfMatrices

<LINCOMBPARA>

Matrix processing

MatrixOperation

<MATRIXOPPARA>

Matrix aggregation

MatrixAggregation

<MATRIXAGGREGATEPARA>

Matrix disaggregation

MatrixDisaggregation

<MATRIXDISAGGREGATEPARA>

Distribution of demand matrix to paths

DistributeMatrixToPaths

<DISTRIBUTEMATRIXTOPATHSPARA>

Folder Add-ins

Procedure

XML attribute OPERATIONTYPE

Subordinate element

<all procedures>

AddIn

<ADDINPARA>

Folder Miscellaneous

Procedure

XML attribute OPERATIONTYPE

Subordinate element

Edit attribute

EditAttribute

<EDITATTRIBUTEPARA>

Set run and dwell times

UpdateTravelTimes

(not available yet)

Set link run times from line run times

UpdateLinkTravelTimesWithLineTravelTimes

<UPDATELINKTRAVELTIMESFROMLINESPARA>

Read filter

ReadFilter

<READFILTERPARA>

Reset all filters

InitAllFilters

No subordinate element

Go to the procedure

Goto

<JUMPBACKPARA>

Run script

Script

<EXECUTESCRIPTPARA>

NCHRP 255

NCHRP255

(not available yet)

HBEFA-based emission calculation

Calculate HBEFA Emissions

(not available yet)

Delete results of emission calculation

Init HBEFA emissions

(not available yet)

Save version

SaveVersion

<SAVEVERSIONPARA>

Incremental propagation

IncrementalPropagation

<INCREMENTALPROPAGATIONPARA>

Group

Group

<GROUPPARA>

Intersect

Intersect Attribute

<INTERSECTATTRIBUTEPARA>

Converting paths

Convert Paths

<CONVERTPATHSPARA>

Territory indicators

TerritoryIndicators

No subordinate element

The table below shows the allocation of sub-items of the XML element <FUNCTIONS> (in alphabetical order) to navigator entries in the General procedure settings window.

XML element

Navigator entry in the General procedure settings window

<ANALYSISTIMES>

Analysis time slots

<BLOCKINGBACKPARA>

PrT settings > Blocking back model

<IMPEDANCEFUNCTIONS>

PrT settings > Impedance

<NODEIMPEDANCEPARA>

PrT settings > Node impedances

<PRTGENERALPARA>

PrT settings

<PRTSKIMMATRIXSETTINGS>

PrT settings > Skims

<PRTVOLUMESPARA>

PrT settings > Assignment

<PUTREVENUESPARA>

PuT settings > Revenues

<PUTSKIMMATRIXSETTINGS>

PuT settings > Skims

<PUTVOLUMESPARA>

PuT settings > Assignment

<SIGNALCOORDINATIONPARA>

PrT settings > Signal offset optimization

<SIGNALOPTIMIZATIONPARA>

PrT settings > Signal cycle and split optimization

<VDFUNCTIONSPARAMETERS>

PrT settings > Links VD functions

<VOLUMESPARA>

Volumes