Specifying the Short Term demand - smart-fm/simmobility-prod GitHub Wiki

SimMobilityST requires trip chains as input in order to simulate the agents at a microscopic level. The trip chains can be supplied using one of the following two sources:

1. Database
2. XML file

1. Run SimMobility mid-term with trip_chain_output setting enabled to get trip_activities.csv and sub_trips.csv
2. Import the trip_activities.csv and sub_trips.csv into trip_activities and sub_trips table in demand schema

   Note: load_factor is not part of trip_activities.csv and sub_trips.csv, so the user has to take care of it while importing the trip_chain to database

1. Open the common settings configuration file

2. Ensure that the databases and credentials sections contain the necessary information to connect to the database containing the road network components.

   Note: Information on the databases and credentials section can be found here

3. Open the short-term specific configuration file

4. Set <load_agents order = “database”>

5. Go to the definition of the proc_map that you wish to use and set the procedure field of the mapping <mapping name = "trip_chains" procedure = "get_trip_chains"/> with the name of the stored procedure that returns the trip chains

   Note: If the mapping name does not exist, add it with in the proc_map tag

1. Open the short-term specific configuration file

2. Set <load_agents order = “drivers”>

3. Define the trip chains in a separate XML file in the following format.

   <?xml version="1.0" encoding="UTF-8"?>   
   <trips>
        <trip>   
             <!--mode: 'Car' or 'Taxi'-->
             <!--originNode/destNode: node ids within the selected network-->
             <!--time: start time in milliseconds after the simulation start time-->
             <subTrip mode = "Car" originNode = "20017" destNode = "14470" time = "10"/>   
        </trip>   
        .
        .
        .
   </trips>

4. Specify the name of this file in the tripFiles tag of the short-term specific configuration file as follows

   <tripFiles>     
        <tripFile name = “CarTrips” fileName = "<file-path>" />         
        <tripFile name = “TruckTrips” fileName = "<file-path>" />         
   </tripFiles>