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 1b. Make sure Anaconda Prompt is working in ../cmap_trip-based_model/ before the command in 1b 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) 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 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

6. 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.

7. Run Database\build_scenario_networks.bat to create all time-of-day networks. It runs the cleanup_for_rerun script, builds the highway and transit networks and checks the transit networks for errors.

8. Run Database\trip_gen.bat module 3

9. Run Database\Submit_Full_Regional_Model_SOLA.bat mode 2