Quick Start Guide

1. Clone the repository, or use an existing clone, and checkout the main branch. If using an existing clone, be sure to update your local main branch by pulling any new commits from the remote main branch.

2. Run Scripts\manage_envs\install_envs.ps1 to:

   • install Miniconda if it is not already installed.
   • install uv if it is not already installed.
   • create the tbm-r conda environment if it does not exist.
   • create the cmap-modedest conda environment if it does not exist.
   • sync the base uv environment with a lock file and link it to the EMME API.

3. Copy the repository to a folder using <model version>_<scenario code>_<run start date> (e.g, c26q2_100_20260430) as the naming convention.

4. Update configuration settings in Database\batch_file.yaml.

5. Update the similar_model_version setting in Scripts\prepare\conformity_scenario\hand\config.yaml.

6. Run Scripts\prepare\conformity_scenario\run.cmd to:

   • copy data from a similar run.
   • export warm start matrices from the copied data.
   • rename the project.

   After the script runs, follow the instructions in the console to:

   • set the trip growth factors.
   • set the TNC surcharge rates.

7. Run Database\build_scenario_networks.bat to:

   • clean up for a rerun.
   • build all time-of-day highway and transit networks.
   • check the transit networks for errors.

8. Run Database\trip_gen.bat module 3

9. Run Database\Submit_Full_Regional_Model_SOLA.bat mode 2

To run additional scenarios, repeat the steps above starting from step 3.