SelectDirect Select Link Analysis. Documentation. Jon Bergström BeLogic Systemutveckling

Transcription

1 SelectDirect Select Link Analysis Documentation Jon Bergström BeLogic Systemutveckling

2 TMALL 0004 Rapport generell v 1.0 Trafikverket Trafikverket, Box 388, Östersund. Besöksadress: Kyrkgatan 43 B. Telefon: , Texttelefon: Dokumenttitel: SelectDirect Select Link Analysis. Författare: Jon Bergström Dokumentdatum: Kontaktperson: Petter Hill, PLep 2

3 Content SELECTDIRECT DOCUMENTATION 4 Version features 4 What does it do? 4 Main purpose, selected transport flows 4 Auxiliary functions 5 Traversal matrices 5 GIS data 5 Domestic ratio 5 Compact Spanning Tree files 5 Cost for empty vehicles 5 CBA sum file 5 Command line 5 Command line arguments 5 Control file 6 - directories 6 --conditions for select link analysis 6 --output files: 8 --input files 8 --other input parameters 10 Program structure 11 Main classes 11 Utility classes 11 3

4 SelectDirect Documentation SelectDirect.jar is a Java program that performs select link analysis. Version features Generates Stan GIS data Runs select zone analysis Generates domestic ratio LOS files Generates compact Spanning Tree files Generates cost file for empty vehicles Generates foreign to foreign traversal matrices These features are further described under Auxiliary functions. The 1.2 version is backwards compatible and used also for version What does it do? SelectDirect uses spanning tree data to resolve transport flows to link and node level for various purposes. It also carries out some auxiliary tasks of aggregating traffic flows, and preparing files for further use in the Samgods model. Main purpose, selected transport flows The main purpose of SelectDirect is to generate input data for visualisation of selected transport flows. For this analysis the program generates five output files. Each contains flows that fulfil the selection criteria given in the program control file. LINKSFILE (LinksSumSL.dat) Total flow per link and vehicle type CONSUMFILE (ConSumSL.dat) Total flow per connection and vehicle type CHAINSFILE (ChainsSL.dat) Flow per each transport chain CONNECTIONSFILE ConnectionsSL.dat Flow and distance for each connection in each transport chain TotalFlows.dat Total flow per vehicle type Two different types of criteria can be used: Select link analysis: Transports that pass certain nodes or links. Select zone analysis: Transports that begins in a selected interval of zones and end in another selected interval of zones. 4

5 For the first case links and / or nodes are given by keywords LINKSSL and NODESSL. If neither of these keywords are used all transport chains for the selected commodities will be included. Output include transports that pass given by Selection can include any or all of the given nodes and links and can be required to be passed either in the order given in the keywords or in random order. These visit conditions are defined by the keywords VISITNODE and VISITLINK. For the second case start zones are given by keyword OZONE, and end zones by DZONE. Auxiliary functions Traversal matrices Using this option the program can produces so called traversal matrices, files specifying flows to and from the Swedish border zones. GIS data This option produces a file Stan.txt that contains flows for each link and Stan group as well as number of trains and used capacity for capacitated rail links. Domestic ratio For this option SelectDirect loops over all time and cost LOS matrices, and uses the resolved path together with time and cost data per link to produce new LOS matrices containing the domestic part of time and cost, respectively. Compact Spanning Tree files This option produces Spanning Tree files on a compact format, reducing the required storage space with approximately 90%. Cost for empty vehicles This function uses LOS data and vehicle cost data to produce a cost file for empty vehicles. CBA sum file Generates a file containing the total cost for all transports divided into the categories Domestic, Import, Export, and Transit transports. Also sums the total vehicle kms for these categories. Command line SelectDirect is a Java command line program. It is run by a command similar to: java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl slnk Command line arguments The task the program is expected to carry out is defined by a command line argument. To run a select link analysis use argument slnk or leave out as this is the default action. 5

6 java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl slnk To run a select zone analysis use zlnk java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl zlnk To run a traversal matrices analysis use trav java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl trav To run foreign to foreign traversal matrices analysis use f2ftrav java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl f2ftrav To produce the Stan group GIS data use stan java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl stan To produce domestic ratio files use ratio java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl ratio To produce cost files for empty vehicles use empty java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl ratio To write compact Spanning Tree files use packspt java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl packspt To generate the CBA sum file containing total costs use cbasum java -d64 -Xmx4g -Xms2024m -jar SelectDirect.JAR SelectDirect.ctl cbasum Control file The last part of the command, SelectDirect.ctl, is the name of the control file containing a number of parameters for the program run. These are described below. The control file can contain comments. Those are rows starting with a hyphen ( - ). Not all parameters are required for all purposes (see table 1). - directories PATH=.. Path relative to the current directory, or absolute path. --conditions for select link analysis LINKSSL=

7 Selection criteria. One or more links which must be passed by the transport chains selected. If there is more than one link the list is comma separated: LINKSSL=46487,46130,63936,65471,3788 If the keyword LINKSSL is not included in the ctl file no transports are excluded on basis of the links passed. NODESSL= Selection criteria. One or more links which must be passed by the transport chains selected. For the traversal matrices these are the border nodes. If there is more than one node the list is comma separated: NODESSL=886000,886111,718017, COMMODITIESSL=1,6,11,15 Only transports of commodities given in the list are evaluated. If omitted all commodities are included. The list is comma separated. VISITNODE=ORDER VISITLINK=ORDER Options: VISITXXXX=ANY, any of the given nodes or links must be used VISITXXXX=ALL, all of the given nodes and links must be used, or VISITXXXX=ORDER, all nodes an links must be used, and nodes must be visited in order they are listed in the LINKSSL or NODESSL parameters, respectively. OZONE=711400, DZONE=960000, Origin and destination zone intervals required for select zone analysis. Instead of an interval a single zone can be give, for example OZONE=

8 --output files: CHAINSFILE=RCM\Output\ChainsSL.dat LINKSFILE= RCM\Output\LinksSumSL.dat CONNECTIONSFILE= RCM\Output\ConnectionsSL.dat CONSUMFILE= RCM\Output\ConSumSL.dat Paths will be relative to the PATH parameter. ERRORLOG=RCM\ErrorSL.txt Name of file to which errors are logged IO_LOG=RCM\SelLink_IO.log Input Output log file, logs which files are read and written. TRAVERSALPATH=RCM\OutputTM Path to a folder where traversal matrices are written. STANFILE=RCM\Output\Stan.dat The file that will contain output from the Stan group GIS data analysis. CBASUMFILE=RCM\Output\CBA_aggr.txt The output file for CBA total cost sum. --input files --Spanning tree SPT_RAIL=RCM\PathTreeRail.txt SPT_ROAD=RCM\PathTreeRoad.txt SPT_SEA=RCM\PathTreeSea.txt SPT_AIR=RCM\PathTreeAir.txt 8

9 Files containing spanning tree data. Paths relative to the PATH parameter. NODESLIST=RCM\Nodes_List.txt List of nodes in the network with Emme and Voyager numbers. LINKLIST=RCM\Links_List.txt List of links in the network with ID link and Voyager and Emme nodes CCFILES=ChainChoi\OUTPUT\ChainChoi[v]_ 01.out The output files from logistics model containing the transports from which data are selected. Also used for CBA sums. LOSPATH=Input\LOS Path to LOS files. The ddist, domestic distances, LOS files are used for the distance column in the ConnectionsSL.out files. ASEKLOS=D:\workfolder\Base2012ASEK\LogMod\Input\LOS Path to the ASEK LOS folder, used for CBA. This parameter can be either absolute or relative. COSTFILES=ChainChoi\Output\ChainChoi[v]_data_07FIN.out Cost data are generated in the ChainsSL, ConnectionsSL and ConSumSL files i f the parameter COSTFILES is specified in the CTL file. TM_EMPTY=EXTRACT\OUTPUT\OD_Emp[f]_STD.314 TM_VHCL=EXTRACT\OUTPUT\OD_Vhcl[f]_STD.314 TM_TONNES=EXTRACT\OUTPUT\OD_Tonnes[f]_STD.314 Files where Extract output files can be found. These files are used to generate traversal matrices. 9

10 CARGO=Input\COST\Cargo.txt The Cargo.txt file is used to translate from commodity to Stan group. CAPLINKS=RCM\RailLinkCapacitiesBidirectional_STD.DAT List of capacitated links. SL_EMPTY=EXTRACT\OUTPUT\OD_Emp[f]_FIN.314 Points to the Extract empty flow output files, used to calculate the empty flow in the CONSUMFILE, and for empty flows in the STAN file. LINKTIMECOST=RCM\TimeAndCost4LinksAndVehicles.txt The file that holds information of time and cost per link. Used in creating domestic ration LOS files for CBA. --other input parameters VEHICLES=101,102,.. Comma separated list of all vehicles used. Default is VEHICLES=101,102,103,104,105,106,201,202,203,204,205,206,207,208,209,210,211,212,3 01,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317,318,319,320,321, 401 VHCLEMPTYCOST=Input\COST\VHCLS_STAN1.txt The file from which the vehicle cost used for Empty Cost analysis is read. DFR=250 Number of days per year for rail traffic. MAX_CMD=16 Sets the highest commodity number. Default

11 Program structure The program is developed in Eclipse Java IDE. Main classes SelectDirect.java This class holds the java main procedure. It reads the control file and calls a procedure for the requested analysis. SPT_Select.java Reads and contains data for the spanning tree. Returns the path for a given connection. Utility classes Funcs.java A utility class that has various functions for string handling etc. CtlReader.java A utility class that reads and holds the values from the control file. LgFileReader.java A standard FileReader with the additional function that it logs the name of the file read. LgFileWriter.java A standard FileWriter with the additional function that it logs the name of the file written. Lists.java Lists keeps track of various input data.

12 Trafikverket, Box 388, Östersund. Besöksadress: Kyrkgatan 43 B. Telefon: , Texttelefon: