Quick Start Guide

Requires Anaconda, git, and R (with all necessary R packages) to be installed on the machine. To run additional scenarios after setting up the first, copy the first scenario before submitting it and repeat the steps below starting from step 1c. Make sure Anaconda Prompt is working in ../cmap_trip-based_model/ before the command in 1c is used.

1. With Anaconda Prompt in the target directory on a modeling server's local drive:
   a) clone this repo and move to the development branch.

   git clone https://github.com/CMAP-REPOS/cmap_trip-based_model.git
   cd cmap_trip-based_model
   git checkout develop

   b) if a TBM conda environment already exists, reinstall local packages to use the latest source code.

   conda activate CMAP-TRIP2
   pip install -e src\Mode-Dest-TOD
   pip install -e src\Mode-Dest-TOD\sharrow

   c) copy data from a previous model run. (arguments for recent_conformity and scenario should match the previous model run)

   powershell -file copy_scenario_data.ps1 -recent_conformity c23q4 -scenario 100

2. Update the project name in Emme > File > Project Settings and rename the .emp and .emp.prj files to match.
3. Update "Database\batch_file.yaml"

	2019	2025	2030	2035	2040	2045	2050
usualwfhpct	0.0510*	0.0869	0.0875	0.0880	0.0884	0.0884	0.0882
tc14pct	0.1031	0.1257	0.1263	0.1270	0.1273	0.1272	0.1269

4. Update growth rate in "prep_macros\distribute.trucks" and "prep_macros\distribute.poes"
5. Update file location in "prep_macros\build_tod_transit" and "prep_macros\initialize.scenarios"
6. Update visitor_trips_growth_factor, tnc : surcharge_rates : downtown and tnc_pooled : surcharge_rates : downtown in "Database\cmap_trip_config.yaml". Downtown surcharge rates are both 0 in 2019 and 175 in 2020 or later.

Scenario year	Visitor trip growth factor
2019	1.00
2025	1.05
2030	1.18
2035	1.34
2040	1.51
2045	1.70
2050	1.92

7. Make a copy of the previous model run. Copy "useful_macros\input_data_mac.py" from the model run being set up to "useful_macros\" in the copy. Run the script in the previous run using Emme Python. TIP: Use EMME Shell and the python command to run the script - the prompt for "your project number" refers to the previous model run. Copy the resulting preload congested travel time files (those with preload or timau in the name) from "Database\default_base_year" in the copy to the same location in the model run being set up.
8. Run "trip_gen.bat" module 3
9. Run "run_cleanup_script.bat"
10. Run the following macros, in order, using Emme Prompt:
    "prep_macros\build_tod_transit"
    "useful_macros\delete.initial.batchin.scenarios"
    "prep_macros\initialize.scenarios"
11. Run "Submit_Full_Regional_Model_SOLA.bat mode 2