RTSS User`s Manual
Contents
1. This file will specify the paths to all the input output files An example of the Control File can be found in List 4 2 4 Preparing Data Files 7 List 4 2 Control File lt xml version 1 0 encoding UTF 8 gt lt rtss _ controls gt lt rtssfile type F name f Ffile xml lt rtssfile type G name g Gfile xml lt rtssfile type N name n Nfile xml lt rtssfile type P name p Pfile xml lt rtssfile type S name s Sfile xml lt rtssfile type R name res res rtss lt rtssfile type C name csv res csv lt rtssfile type L name log res log lt rtss_controls gt 4 3 1 riss controls This element is the root element of the Control File This element can contain one or more lt rtssfile gt elements It must not have any attributes It is recommended that this element contains eight lt rtssfile gt elements containing the paths to all the input output files 43 2 lt rtssfile gt This element is the child of lt rtss_controls gt element This element must be empty It must have two attributes type and name 1 type One of G N S P F R C L each corresponding to one of eight input and output files G File N File etc is to be specified as the value of this attribute Any other values will cause an error This value will show that this element specifies file path of the particular input2. Control File element lt rtss_controls gt AS LAR OS SES Da ME PM IA AAA ATAN EIA A ATI ADA AT da ETE Te IAE AS AAA ES 8 lt rtssfile gt A o al tese E AS O PAT E eal asl RS See A AA A A a o a A ae 8 lt curvature gt G File element ESA AAA AAA NE 11 cycle time CATARATA ERA ELANA AAN TVR EEE NS CRE TEGENE AAA TAIANA AAA 14 15 16 D lt data gt G File element EE PEO AE NOE ia Blige bie A fart dada fre A a bye hahaa pd E PEO tajada 12 diagram pattern AE 14 15 cycle time een rn 15 16 pattern multiplier RR AO NN 16 phase EE AAEE E ll kaa aia delete at rte ell rad S ENE E dad dao 15 E element lt accompanying_file gt N File Grid del Ge de nds Eta res aay re dh duane A td Nr fe Ke 13 14 lt curvature gt G File A A A AS ER TCE A A AS AA AA A AAA 11 lt data gt G File A a iS shang rd iS DS rie ias 12 lt gradcrv gt N File OO RAS ERRONEA ae cae hs enes 17 O Index 21 lt gradcrv data set gt G File ae ce td daa id di er dd eie ee ee hee dhe are area EIE 10 res UG Re 10 ES Ne 13 15 17 SEAN ecos 15 17 se PP 13 14 15 ENN EN EE SIA 8 EE GT 9 EE SEE ENE EE 13 EE TE EE ERE FESTE PETE SA EEE AA APEE RE TEE 8 PE G Milo a Wien ee ees ere Rains 11 EN NT NS Sr Son es 9 Fa datas MO liada e e ne e ar e aao enaa En 11 F File EN NS is NA Ea S E E EES E EEES EEEE A EE EE ad EN E 7 19 feedline object ENILE ara a ara 18 19 free run cycles eee eee eee ee ee eee eee eee ee ee eee eee ee eee eee ee eee eee eee eee ee eee ee ee ee
3. a train to complete one cycle of journey defined by this element This is called the cycle time of this diagram pattern This is in fact a redundant information because it can be calculated by adding up the running times and the dwell times specified in all nextsta data sets in the queue however the cycle time information is not easy to calculate by hand and therefore this attribute must be specified for double checking the validity of the data 2 phase This attribute is given a double precision value which represents the phase in s seconds of this diagram pattern The phase of the diagram pattern is the departure time of a train from the departing station specified by the first nextsta data set in the queue It is recommended that the phase is zero when 4 Preparing Data Files 15 there is only one diagram pattern in N File the non zero phase makes sense only when there are two or more diagram patterns 3 cars This attribute is given an integer value which represents the number of trains that belong to this diagram pattern 4 train class This attribute is given a string value which represents the name of the train type defined in P File All trains that belong to this diagram pattern will be of this train type 5 patterncirc This attribute is given an integer value which is called the pattern multiplier It is given so that the following value Ts is the same for all diagram patterns in N File Ts i x Mp Where Te is
4. lt xml version 1 0 encoding UTF 8 1 gt lt rtss n file gt lt n flags ontprec true gt lt accompanying file name Ref SOC curve xml gt L KG lt pattern cycletime 200 0 phase 0 0 cars train class Class 465 patterncirc 1 init train position 0 0 init train velocity 0 0 init train state Power init train delay 0 0 gt lt nextsta start point 0 0 end point 1 5 end velocity 0 0 start stop time 150 0 dwell time 50 0 notch off velocity 0 0 direction 1 feeder name Line A Up gt lt gradcrv name G_01 gt lt nextsta gt lt pattern gt lt rtss_n file gt 4 5 1 lt rtss_n_file gt This element is the root element of the N File This element can contain the following elements in the order shown below I Upto one lt n_flags gt element II Any number zero or more of lt accompanying_file gt elements and III One or more lt pattern gt elements at least one lt pattern gt element is required This element must not have any attributes 45 2 lt n_flags gt This element is the child element of the lt rtss n file gt element This element is optional and can be omitted If present 1t must be empty If this element is to appear it must be put as the first element within the lt rtss n file gt element 4 Preparing Data Files 13 This element can have the following attributes All attributes are optional and can be omitte
5. lt gradcrv data set gt element 4 Preparing Data Files 11 This element must not have any attributes There must be one or more lt data gt child elements within this element The lt data gt child elements must be continuous 1 e the position specified by the attribute to of a lt data gt child element must be equal to the position specified by the attribute from of the lt data gt child element which comes next to the one in question 4 48 lt data gt This element is the child of either lt gradient gt lt curvature gt lt speed_restriction gt or lt three_data gt elements This element must be empty If this element is the child of lt gradient gt lt curvature gt or lt speed_restriction gt elements then there must be three attributes called from to and value The use of attributes gradient curvature and speed_restriction in this case is prohibited and will cause an error If this element is the child of lt three_data gt element then there must be five attributes called from to gradient curvature and speed_restriction The use of attribute value in this case is prohibited and will cause an error 1 from This attribute is given a double precision value in km which is the starting position of this data 2 to This attribute is given a double precision value in km which is the ending position of this data 3 value This attribute is given a double precision value If this element is the child of lt g
6. output file 2 name The file path to the File specified by type attribute will be given as value of this attribute The path can be relative to the path of Control File itself There can be up to eight appearances of lt rtssfile gt elements within the lt rtss control gt element each with different value of type attribute If there are two or more appearances of lt rtssfile gt elements with the same type attribute value the result is undefined Note that all input files i e files with types G N S P and F must have names that end with xml Also note that types R C and L are output files The directory or directories that will accommodate these files must be created before running RTSS it will not be created automatically by RTSS itself 4 Preparing Data Files 8 44 GFile This file will specify the track profile information including gradient curvature and speed restrictions of the railway line to be simulated An example of the G File can be found in List 4 3 List 4 3 G File lt xml version 1 0 encoding UTF 8 1 gt lt rtss_g_file gt lt speed_restriction_margin value 0 0 gt lt gradcrv_data_set name G_01 gt lt gradient gt lt data from 0 0 to 0 5 value 0 0 gt lt data from 0 5 to 1 0 value 10 0 gt lt gradient gt lt curvature gt lt data from 0 0 to 1 0 value 0 0 gt lt curvature gt lt speed_res
7. the cycle time specified by attribute cycletime Nr is the number of trains specified by attribute cars and Mp is the pattern multiplier specified by this attribute It is recommended that the pattern multiplier is set to 1 when there is only one diagram pattern in N File The time Ts calculated by the above equation will be the cycle of simulation when Ts seconds have passed in the simulation it can be assumed that the condition of the system being simulated roughly returns to where it has started 6 init_train position This attribute is given a double precision value which represents the initial train position in km 7 init_train velocity This attribute is given a double precision value which represents the initial train velocity in km h 8 init train state This attribute is given a string or integer value which represents the initial train state The train state must be one of the following Power or 0 Powering accelerating Brake or 1 Braking Coast or 2 Coasting Stn_stop or 3 Dwelling at station Const_vel or 4 Running at constant velocity or Regenerate or 5 Decelerating using regenerative brake only 9 init_train_delay This attribute is given a double precision value which represents the initial delay of the train in s 10 init_train_departure_time This attribute is given a double precision value which represents the initial train departure time i
8. this train when it runs using this nextsta data set The named SOC curve data must be defined in the accompanying file otherwise it will cause an error 46 SFile To be completed 4 7 PFile To be completed 4 8 F File To be completed 4 Preparing Data Files 19 5 Invoking RTSS To invoke RTSS using the data files you have created you must start the shell and run the following command rtss control file name xml This will cause RTSS to read the control file first interpret it and find the appropriate files for reading If the binary executable file does not reside on one of the directories listed in the Path environment variable you can invoke RTSS by typing in the full path to the binary executable file Note that the Windows installer will not set the environment variable you must do it by hand if you want to The control file name can be either a full path to it or the path relative to the current working directory 5 Invoking RTSS 20 Index A lt accompanying file gt N File element EEE hae haar alas STENE SETE aga KR haat ths Sah alee alata PRS ESTERE ane 13 14 C O File e0erererenencn conocia conocia nana nananana nene ne nena ne enn nana na nana na nana ra nan ne nene nnnanananacananananananannnonanonnanananananas 7 congestion rate NEAR 18 Control File e e eoerrororococnananacacanananannononononononanananananananannnnnnnonnnnnnanananananananananonanonancnnanananananes 7
9. 8 Unicode In the data files of RTSS any data will be given as attributes of a specific element and any one element will either contain child element s and comments or be empty 4 Preparing Data Files 6 4 2 Types of input and output data files To run RTSS you must prepare the following input data files 1 Control File This file will specify the paths of all other input and output data files 2 G File This file will specify track profile information gradient curvature and permanent speed restriction 3 N File This file will specify train schedule data 4 P File This file will specify train performance data 5 S File This file will specify substation characteristics data 6 F File This file will specify the feeding network information and overall simulation parameters and options There are three output files that will be created after you run RTSS 7 R File This file is a simple text file with the summary of simulation results 8 C File This file is a CSV comma separated variables file with all detailed simulation results including records of simulated position of trains voltage and current of substations and trains etc It is a very large file Microsoft Excel is designed to handle CSV files but sometimes the C File can grow too large for older version of Excel to handle 9 L File This file is a simple text file containing log messages It is a very large file 4 3 Control File
10. RISS User s Manual For RTSS Version 2 6 4 DR RYO TAKAGI 2011 1 12 Table of Contents AMIE Data FIG LEE it A A AA ale iv E TOM EEE RER 1 1 1 Whatis ATI td An ab 1 1 2 Whatis the history of RIS Sa ae ED EDEL ieii iiai 1 1 3 What is the track record Of RTSS mnnrenannvnnrnvvnrnrrvnnnrnnrnnnnrerrrnnnrnnsnnrnnenrenrsrreennrensnnnerenn 1 1 4 Who should read this manual seresnronnnnvnnenrvnrnrrrnnnrnnrnnvnnerrennnrrnsnnrnnenrenrrrresnnrnnsnneernnn 1 2 Steps to Use RTSS instinto 2 2 1 Preparing the computer environment W u ssseseeeeeee renen ennen eaeeeeetaeeeeetaeeeeeeaeeeeneaa 2 2 2 Finding the distribution Site EGE rad ERE VAN AKER ANT Aker Lr NS 2 2 3 Compiling and installing the program W ssssseserenrr enn nen nen nn nn cana nn n nen 2 2 4 Prepanng datafles unrunnsnm edda dida 2 2 5 INVOKING the program eerannrrnnnnnnvrnnnannrrnnnonnrrnnnennrrnnrennrannsennrnnnsennrannsennrnnnrenrnnnsennrrnnsennnn 2 2 6 Looking into the simulation results rsrrnnnannvvnnnnnnvvnnnnnnvvrnnrnnvnnnnnnrnnrnrrrrnnnnerennrnnsrennnnn 2 3 Compiling and Installing RTS naaa 3 3 1 Compiling from source tarball erannrnnonvrnrnrrnnnnrrnnnnrnnrnvnnnnrrennnrnnnnnnnnenrennsrresnnrnnsnnnnnnnne 3 3 2 Installing using the Windows installer ernronnrrnnronnrrnnrrnnrrnnnnnnrrnnnnnnrrnnnnnnrrnnnrnnrrnnsennnr 4 3 3 Finding the version of the RTSS executable rrrrannvnnonrnnnnrrnnnnrnnnnnvnnnrrennnrrvnnnr
11. ame time the value will be added to the dwell time specified in all nextsta data sets in this N File so the cycle time of any one diagram pattern in this N File remains the same The default value of this parameter is zero 6 station_object_valid This attribute is given a boolean value true or false If set to true the station object will be valid This part of RTSS is not actively maintained or supported this attribute must not be set to true unless you read the source code and have enough knowledge on the algorithm 4 5 3 lt accompanying_file gt This element is the child element of the lt rtss_n_file gt element This element is optional and can be omitted If present it must be empty If this element is to appear within the lt rtss_n_file gt element it must be put before the appearance of any one lt pattern gt element Any number of lt accompanying_file gt elements can appear within lt rtss_n_file gt This element must have an attribute called name 1 name This attribute is given a name in string of the path to the accompanying 4 Preparing Data Files 14 file to be read by RTSS At present this file is used to describe data of the reference SOC curves which are used in the control of on board energy storage systems 4 5 4 lt pattern gt This element is the child element of the lt rtss n file gt element Any number of lt pattern gt elements can appear within lt rtss n file gt howe
12. and arrive call at the destination station and O Pass pass In this data set the train will pass through both the origin and destination stations without calling at either of them 10 congestion This attribute is given a double precision value which represents the congestion rate of the train Congestion rate is the number of passengers actually on board a train divided by the rated passenger capacity of the train 11 station_object_number This attribute is given an integer value which represents the number of station object associated with this nextsta data set This part of RTSS is not actively maintained or supported 12 nextsta_switch_point This attribute is given a double precision value which represents the position in km of a place where nextsta data set is switched to the next one When a train uses this nextsta data set and reaches 4 Preparing Data Files 18 this position it will switch to the next data set This attribute is used when it is necessary to change from one feedline object under which the train run to another during the inter station run Note that when this attribute is set in one lt nextsta gt element the lt nextsta gt element that follows it must have the same data for all child elements and all attributes except attributes feeder name and nextsta switch point 13 soc feedforward data This attribute is given a string value which represents the name of the SOC curve data associated with
13. art tag with an attribute can be found in line 8 where element lt rtss_E_tag gt has attribute name Note that element lt rtss_E_tag gt also has a child element namely lt rtss F tag gt End tags must not have attributes Attributes with the same name must not coincide within one tag for example the expression below will cause an error lt rtss G tag name G distance 1 0 distance 2 0 gt One way of specifying values named distance twice or more is to have two or more child elements as in lines 11 through 14 of List 4 1 Here instead of having two distance attributes in the tag element lt rtss_G_tag gt has two lt rtss_H_tag gt child elements each with an attribute distance Also note that the order in which attributes appear within a tag is not important you may put them in any order you want On the contrary the order in which elements appear within the XML file may mean something All XML documents must have one root element This is an element in an XML document which is not a child of any other elements in the document In List 4 1 lt rtss A tag gt is the root element On line 2 of List 4 1 is a comment Comments are surrounded by lt and gt Inside these you can put any kind of text strings except double minus You can put any number of comments as contents of an element or outside the root element of the document The encoding of the entire XML file must be UTF
14. ce some antivirus or firewall software rejects the file In this case you will have to disable the software temporarily before performing the download 3 3 Finding the version of the RTSS executable You may want to know the version number of the executable that you have found on your system If the binary is of Version 2 6 2 or newer you can find it by giving RTSS executable the o v command line options 3 Compiling and Installing RTSS 4 4 Preparing Data Files Before you run RTSS you must be familiar with the simulation model implemented in it This is not an ordinary type of software you must have the entire knowledge on what you are doing The information you need is given in the PhD thesis 1995 by the author which can be downloaded from the RTSS website 4 1 General information on the XML format All data files will have the XML format A data file will look like List 4 1 List 4 1 An example XML file lt xml version 1 0 encoding UTF 8 gt lt Comment gt tr lt rLss A t g gt lt rtss B tag gt lt rtss C tag gt lt rtss B tag gt lt rtss D tag name D distance 1 0 gt lt rtss E tag name E gt lt rtss F tag gt lt rtss E tags lt rtss G tag name G gt lt rtss H tag distance 1 0 gt lt rtss H tag distance 2 0 gt lt rtss G tag gt lt rtss A tag gt Here line 1 is the XML declaration An XML file must have this at the begi
15. d 1 conges station This attribute is given a boolean value true or false If true congestion can be specified individually for each nextsta data set 2 ontprec delay set This attribute is given a double precision value in s If the delay of a train is found to have exceeded this value during simulation despite the use of precise start to stop time simulation algorithm the number of free run cycles will be incremented by one and the use of approximate start to stop time estimation routine will be suppressed in the subsequent simulation The default value of ontprec_delay_set is 0 6 seconds 3 ontprec This attribute is given a boolean value true or false If true the use of approximate start to stop time estimation routine will be suppressed This will result in longer calculation time If the number of free run cycles is set to zero it is recommended that this attribute be given the value true 4 initialdeparturetime This attribute is given a boolean value true or false If true all the lt pattern gt elements within this N File must have attribute initial_train_departure_time This is used to tweak the schedule data more details can be found in the author s PhD thesis 5 startstop_parameter This attribute is given a double precision value in s The value will be subtracted from the start to stop time specified in all nextsta data sets in this N File At the s
16. e no lt three_data gt element within the same lt gradcrv_data_set gt element This element can have one attribute called ref When this attribute is specified the element must be empty 1 ref This attribute is given the name in string of another lt graderv data set gt element from which the gradient data is copied If there is no attributes then there must be one or more lt data gt child elements within this element The lt data gt child elements must be continuous 1 e the position 4 Preparing Data Files 10 specified by the attribute to of a lt data gt child element must be equal to the position specified by the attribute from of the lt data gt child element which comes next to the one in question 445 lt curvature gt This element is the child of lt gradcrv_data_set gt element There can be only one lt curvature gt element within the lt gradcrv_data_set gt element If this element is present then there must be no lt three_data gt element within the same lt gradcrv_data_set gt element This element can have one attribute called ref When this attribute is specified the element must be empty 1 ref This attribute is given the name in string of another lt gradcrv data set gt element from which the curvature data is copied If there is no attributes then there must be one or more lt data gt child elements within this element The lt data gt child elements must be continuous 1 e the position spec
17. editor look through it and make necessary changes If you are to use Makefile MinGW change the line defining HOME macro to the correct home directory of yours When you have done the edits save the makefile 5 Go down to the directory where you have unpacked the tarball RTSS x y z and type make f NAME OF YOUR MAKEFILE Here NAME OF YOUR MAKEFILE depends on your choice of makefile in step 3 6 RTSS binary executable file will be generated in the directory called obj RTSS x y z which is located in the same directory as the one RTSS x y z resides You can move RTSS executable file to wherever you want provided the PCRE shared library resides in the place that the executable can find If you are using Microsoft Windows you may want to copy libpcre 0 dll together with the executable 3 Compiling and Installing RTSS 3 3 2 Installing using the Windows installer In the RTSS distribution website an installer for the Microsoft Windows environment probably usable only in Windows XP and newer versions is provided Just download the file and execute it the result is that the binary executable file together with the necessary libpcre 0 dll will be installed to wherever directory you want C Yrtss by default The binary executable file that will be installed by this installer is compiled using the 32 bit version of MinGW You may have trouble downloading the installer sin
18. ee eee ee eee ee AAA 14 G File element COUPE verre RE 11 PE EE EE EEE EE NE SES ERE BEDE FEED SESS 12 lt graderv data set suser 10 gradient uses 10 lt rtss g file eet ent eee 9 lt speed restriction gt suse seeren 11 lt speed restriction margin cree eee 9 three data o reen nr rer reen nerne teen nere reeks kernen 11 graderv data setos 10 lt gradcrv gt N File element A EEE ATAR A EE EE 17 lt gradcrv data set gt G File element ute ede vr Mele Obata AR ed eek A ARA IA e GA DERES ke r 10 lt gradient gt G File element EEE EEE A e TARA SRR E A Al NERE 10 Index 22 L File Peer rere rere Terre eee ree eee rer eee rer eee ere eee eee eee eee ee ee eer eee eee eee eee eee eee ee eee eee ee eee eee ee reer ee ee ee errr 7 N N File AAA Ta 13 N File element lt accompanying_file gt EA A dre EERE RA A latexes AA AE E EE A NERE A EERS 13 14 lt gradcrv gt Feet E AR A AA USET O AA ATAR RR NS NS ARS 17 lt n_flags gt Dd a a eee haha are Te aria ae Se eae A ll en AAA ra a AS BESES SEES faren da 13 15 17 lt NEextSta gt rn 15 17 lt pattern gt AO 13 14 15 lt rtss_n file gt NAAS TA TE TNA AE NS Ter 13 lt n flags gt N File element a ENS KN rele A veteran arp uer JERES SIGES a A A A ed EROS SENDENET BE KS T 13 15 17 nextsta data set AAA 14 15 17 lt nextsta gt N File element EN ENN ME NEA SES TOEREN ENE SEERE 15 17 EF P File 00000 nro nr 7 16 19 pattern multiplier VEA AA AS EEE EE EE we c
19. ified by the attribute to of a lt data gt child element must be equal to the position specified by the attribute from of the lt data gt child element which comes next to the one in question 44 6 lt speed restriction gt This element is the child of lt gradcrv data set gt element There can be only one lt speed_restriction gt element within the lt gradcrv data set gt element If this element is present then there must be no lt three data gt element within the same lt gradcrv data set gt element This element can have one attribute called ref When this attribute is specified the element must be empty 1 ref This attribute is given the name in string of another lt gradcrv data set gt element from which the speed restriction data is copied If there is no attributes then there must be one or more lt data gt child elements within this element The lt data gt child elements must be continuous 1 e the position specified by the attribute to of a lt data gt child element must be equal to the position specified by the attribute from of the lt data gt child element which comes next to the one in question 4 4 7 lt three_data gt This element is the child of lt gradcrv data set gt element There can be only one lt three data gt element within the lt gradcrv data set gt element If this element is present then there must be no lt gradient gt lt curvature gt or lt speed restriction gt elements within the same
20. n s Note that the 4 Preparing Data Files 16 non zero value given to this attribute makes sense only when the initial state of the train is set to Stn stop dwelling at station This data can be set to whatever value regardless of the dwell time specified by the nextsta data sets 4 5 5 lt nextsta gt This element is the child element of the lt pattern gt element Any number of lt nextsta gt elements can appear within lt pattern gt however at least one appearance 1s required lt nextsta gt element will represent a nextsta data set nextsta data set contains the data required to run a train between two stations This element must contain the following elements shown below I One or more lt gradcrv gt elements This element can have the attributes listed hereunder Among these attributes 1 through 9 are required and cannot be omitted If attribute conges_station is set to true in the lt n_flags gt element then attribute 10 is also required If attribute station_object_validis set to true in the lt n flags gt element then attribute 11 is also required Attributes 12 and 13 are optional and can be omitted 1 start point This attribute is given a double precision value which represents the position in km at which this nextsta data set will start Generally this point is the position of the origin starting station 2 end_point This attribute is given a double precision value which
21. nformation can be given through input XML files For the grammar of the input files and how you can use them see Chapter 4 of this manual 2 5 Invoking the program To be completed 2 6 Looking into the simulation results To be completed 2 Steps to Use RTSS 2 3 Compiling and Installing RTSS 3 1 Compiling from source tarball If you want to compile RTSS from the source tarball source distribution you will need a C compiler and the environment that supports it You will also need the PCRE library which should be precompiled installed and ready to use The author is using the latest MinGW MSYS package installed on a personal computer running Microsoft Windows Vista both 32 bit and 64 bit versions 1 Unpack the source tarball Using the tar command All files in the distribution will be unpacked into a single directory called RTSS x y z where x y z is the version number of RTSS 2 Create a directory called 1ib under the home directory if it is nonexistent 3 In the source distribution locate the makefile to be used during compilation There are several makefiles in the source distribution Makefile and Makefile MinGW are the choices XMakefile will be called during compilation using either of these makefiles If you are using MinGW MSYS Makefile MinGw is the one for you If you are using Unix or Linux systems use Makefile instead 4 Open the appropriate makefile using your favourite
22. nning of it In the lines that follow this XML declaration line the strings surrounded by angle brackets are called tags On line 3 of List 4 1 you can find tag lt rtss A tag gt which is called the start tag This corresponds to the end tag which is lt rtss A tag gt on line 8 Note that end tags start with beginning angle bracket followed by a slash The combination of a start tag and an end tag is called an element Between the start tag and the end tag there may be contents of the element The 4 Preparing Data Files 5 contents can either be any text strings comments and child elements or the combination of these For example lt rtss B tag gt on line 4 of List 4 1 is another start tag which corresponds to the end tag on line 6 This element is the child element of lt rtss_A tag gt If there are no contents in the element you can simplify the expression by using the empty element tag instead of a pair of start and end tags An empty element tag can be found in line 5 of List 4 1 Note the slash before the ending angle bracket in line 5 This expression is equal to lt rtss C tag gt lt rtss C tag gt An element can have one or more attributes An empty element tag with two attributes can be found on line 7 of List 4 1 Here element lt rtss D tag gt has two attributes name and distance s shown here each attribute will be given a value which is a text string surrounded by single or double quotes Similarly a st
23. nnrnnenrnnr 4 4 Preparing Data FileS cari iia ia tin entra oa 5 4 1 General information on the XML format srerannrnnannvnnrnrvnrnrrrnnnrnnnnnnnnenrennsrrennnnnnennnnnennn 5 11 4 2 Types of input and output data files onooncinninnindn iciccnnnnccccnnnoncnnnnnanannnn nano nc n rana 7 43 GontrolFileakiussasssnenu fakes cats S E isnende 7 4 8 1 STES SE COMETS ISS ean Sene 8 4 3 2 LEESSELVSS Mama vade entret 8 4 4 GR Gat ea 9 4 4 1 BP ESS GS Siesta O ea at 9 4 4 2 speed restriction MATO did tc aner 9 4 4 3 do loas o arty ere treater TR 10 4 4 4 lt gradr enes iii ert 10 4 4 5 SOUT W aU el gt a dais ibas 11 4 4 6 ESPESA TEStrictLon gt ia erre chase adeedaccenaancdeageces 11 4 4 7 o O aa FEE SMELTE SOSU SESSES SES 11 4 4 8 EAS es 12 45 Nile iaa a 13 4 5 1 ES A RR E RR NS 13 4 5 2 AA A das 13 4 5 3 RS ENA o NT 14 4 5 4 APACE STD cs A RA is 15 4 5 5 LLE ls ke SN eee AO OY ic 17 4 6 S File uta NN idear 19 4 7 Pr sia aa 19 4 8 Ellos teens nt 19 5 Invoking RTSS vredens it 20 DNS GER a ate a NN RE ERE 21 111 XML Data File List 4 1 An example XML file List 4 2 Control File List 4 3 G File ww List 4 4 N File Lists iv 1 Overview 1 1 What is RTSS RTSS is a flexible tool for the simulation and evaluation of the electric power feeding network for DC electric railways The name RTSS is short for Railway Total System Simulator intended to be a more comprehensive simulation tool of
24. oe aie 16 lt pattern gt N File element EN NN EN KK RES DN NG MN Nede 13 14 15 phase A A ee A AA A eee eee 15 R R File KEKEKEREKEREREEERERER ERR EKERE RER ERE KER KE KER ERE ERE KER ER ERE RER RE KEE RER ERE E KE RER ERERE REE ER ERERER ERE RER KER KERERRERERERKERKEER 7 lt rtss controls gt Control File element EITEL A A artenes artens 8 lt rtss g file gt G File element erre det E eten ae riter a ee Gra als a dia ale dade aleve riene alder tende er ts aie travels dla tee tele dea 9 lt rtss n file gt N File element IAS AA AAA EE EEE EE 13 lt rtssfile gt Control File element gd eee A uden Sage E ida 8 S G File eC rr nn 7 19 SOC curve data cr 19 Index 23 lt speed_restriction gt G File element A dere Ai A Py en RN A e eM ae tan 11 lt speed_restriction_margin gt G File element terterrercorrencnnnonnnnnannnnnnnnnnrnnnnnnannnnnanennneniannanies 9 T lt three_data gt G File element Jr td A IMSS od dam 11 train type eee nn 16 Index 24
25. radient gt element it represents the track gradient in o per mill 1 1 in 1000 between positions specified by attributes from and to If this element is the child of lt curvature gt element it represents the curve radius in m between positions specified by attributes from and to if the value is zero then it will mean the track is straight If this element is the child of lt speed_restriction gt element it represents the speed restriction in km h between positions specified by attributes from and to if the value is zero then it will mean there is no speed restriction 4 gradient This attribute is given a double precision value representing the track gradient in o per mill 1 o 1 in 1000 between positions specified by attributes from and to 5 curvature This attribute is given a double precision value representing the curve radius in m between positions specified by attributes from and to if the value is zero then it will mean the track is straight 4 Preparing Data Files 12 6 speed restriction This attribute is given a double precision value representing the speed restriction in km h between positions specified by attributes from and to if the value is zero then it will mean there is no speed restriction 45 NFile This file will specify the train schedule or more informally how trains run An example of the N File can be found in List 4 3 List 4 4 N File
26. represents the position in km at which this nextsta data set will end Generally this point is the position of the destination station 3 end_velocity This attribute is given a double precision value which represents the velocity in km h at the end position If this train is to call at the destination station this must be zero This attribute must be given a non zero value only when either Station pass or Pass pass is specified as the value of attribute nextsta pattern in this element When this is the case the train will apply brakes toward the last part of the inter station journey defined by this nextsta data set so that the train velocity does not exceed the value specified by this attribute at end position if the velocity at end position will not exceed the value specified by this attribute the train will simply coast without accelerating 4 start stop time This attribute is given a double precision value which represents the time in s seconds required for the inter station run defined by this nextsta data set If Station is specified as the value of attribute nextsta_pattern in this element then it is the start to stop time between the 4 Preparing Data Files 17 starting point and the end point Otherwise it represents the time required for this train to run between the starting point and the end point 5 dwell time This attribute is given a double precision value which represents the dwell time in s seconds a
27. s g file gt element This element will define one gradcrv data set a set of track profile information which includes gradient curvature and speed restriction data This element must have one attribute called name 1 name This attribute is given the name in string of this particular gradcrv data set If there are more than one lt gradcrv data set gt elements within the lt rtss g file gt element every lt gradcrv data set gt element must be given a unique name This element can contain one of the following sets of elements shown below I One lt gradient gt element one lt curvature gt element and one lt speed restriction gt element or II One lt three data gt element If I of the above sets is selected the three elements must cover the same section of track this means that 1 the position specified by the attribute from of the first lt data gt child elements within the three elements lt gradient gt lt curvature gt and speed restriction are equal and similarly 2 the position specified by the attribute to of the last lt data gt child elements within the three elements are equal The three elements lt gradient gt lt curvature gt and lt speed_restriction gt can appear in any order 444 lt gradient gt This element is the child of lt gradcrv_data_set gt element There can be only one lt gradient gt element within the lt gradcrv_data_set gt element If this element is present then there must b
28. t the destination station If either Station pass or Pass pass is specified as the value of attribute nextsta pattern in this element the value must be zero 6 notch off velocity This attribute must be given value 0 0 This is the dummy parameter that has no effect but cannot be omitted 7 direction This attribute shows the direction of the train and is given either 1 or 1 If 1 is given then the train will run in positive direction i e the position will increase when the train moves forward If 1 minus one is given then the train will run in negative direction 1 e the position will decrease when the train moves forward 8 feeder_name This attribute is given a string value which represents the name of the feedline object that this train will run under The named feedline object must be defined in F File otherwise it will cause an error 9 nextsta_pattern This attribute is given a string value representing the nature of this nextsta data set Its value must be chosen from the list below O Station In this data set the train will start from the origin station from zero velocity and arrive call at the destination station O Station pass In this data set the train will start from the origin station from zero velocity and pass the destination station without calling at it O Pass station In this data set the train will pass through the origin station without calling at it
29. the whole railway system The name RTSS is also known as the abbreviation of the authors names Dr Ryo Takagi who is now with Kogakuin University in Tokyo Japan as Associate Professor and Professor Satoru Sone Professor Emeritus of the University of Tokyo and a figure well known throughout the world in the field of electric railway engineering 1 2 What is the history of RTSS RTSS has been developed as part of the PhD project of Dr Ryo Takagi The PhD thesis was To be completed 1 3 What is the track record of RTSS To be completed 1 4 Who should read this manual To be completed 1 Overview 1 2 Steps to Use RTSS 2 1 Preparing the computer environment To be completed 2 2 Finding the distribution site You can find the newest distribution of RTSS at the following URI http www takagi ryo ac p railway rtss Here you can find the source and binary distributions of every RTSS release information on how RTSS has changed since the last release manuals and other useful information 2 3 Compiling and installing the program RTSS is written in standard C It will probably run on almost all platforms provided an ISO standard compliant C compiler is available thereon There is also a binary distribution for the Microsoft Windows environment For more information see Chapter 3 of this manual 2 4 Preparing data files RTSS requires a considerable amount of information to run a simulation Such i
30. triction gt lt data from 0 0 to 1 0 value 0 0 gt lt speed_restriction gt lt gradcrv data set gt lt gradcrv_data_set name G_02 gt lt three_data gt lt data from 1 0 to 2 0 gradient 10 0 curvature 800 0 speed restriction 70 0 lt three data gt lt gradcrv data set gt lt rtss g file gt 441 lt rtss_g_file gt This element is the root element of the G File This element can contain the following elements in the order shown below I Upto one lt speed restriction margin gt element and II One or more lt gradcrv data set gt elements This element must not have any attributes 4 42 lt speed restriction margin gt This element is the child of lt rtss g file gt element This element must be empty This element must have one attribute called value 1 value A double precision figure given here as value to this attribute will be subtracted from all speed restriction data given in G File This element is optional and can be omitted It must not appear after any one 4 Preparing Data Files 9 lt graderv data set gt element appears in the lt rtss g file gt element If two or more of lt speed restriction margin gt elements appear within the lt rtss g file gt element an error occurs and the program will terminate 4 43 lt gradcrv_data_set gt This element is the child of lt rtss g file gt element There can be any number of lt gradcrv data set gt elements within the lt rts
31. ver at least one appearance is required A lt pattern gt element will represent a diagram pattern which is actually the queue of nextsta data sets A nextsta data set contains the data required to run a train between two stations and therefore a diagram pattern is a set of data that determines how train s run in the railway network to be simulated In the simulation every train will belong to one of the diagram patterns In the diagram pattern trains run cyclically when a train finishes a run between two stations defined by a nextsta data set in the queue in the diagram pattern the next nextsta data set in the queue will be used to run the train When the train finishes the run defined by the last nextsta data set in the queue it will move back to the first data set and continue If there are two or more trains that belong to one diagram pattern they are initially positioned before the simulation starts so that the time distance between any two adjacent trains is uniform This element must contain the following elements shown below I One or more lt nextsta gt elements This element can have the attributes listed hereunder Among these attributes 1 through 9 are required and cannot be omitted If attribute initialdeparturetime is set to true in the lt n_flags gt element then attribute 10 is also required 1 cycletime This attribute is given a double precision value which represents the total time in s seconds for
Download Pdf Manuals
Related Search