-
Notifications
You must be signed in to change notification settings - Fork 15
Setup
You can download the 2014 LODES based inputs here. This zip file (1.7 GB) in combination with the code in this repository has all the files needed to run the model. Extract the zip file to a desired workplace with at least 120 GB of free disk space. Check that the folder has full security control on your computer after unzipping, and update it to full control if not.
The primary control configuration for typical runs is the input_configuration.py file in the root directory of the Soundcast repository. This file should be updated to identify the location of model inputs prior to running.
Near the top of input_configuration.py, ensure that following parameters are accurate and point to the proper input set.
If you extracted the input file above to your C: drive (for example), the name of the main inputs folder should be 'C:\2014'
.
scenario_name = '2014'
model_year = '2014'
main_inputs_folder = 'C:\2014'
When running with the downloaded zip file (as linked above), confidential ESD employment data is unavailable, so trip generation for supplemental trips must be skipped. A previously-generated production-attraction matrix (non-confidential), is provided in the dataset as linked above. To ensure this matrix is used rather than attempting trip generation, confirm the following variable setting:
run_supplemental_generation = False
The default setting for Soundcast is to run all model components, including
- freeflow assignment and skimming
- Daysim choice models for all simulated person-days
- global iterations between assignment and choice modeling until convergence
- truck, bike, and external trip assignment
- summaries
These components may be run or skipped individually, as defined by parameters in input_configuration.py. The default settings should not be changed to run a standard full model run. If a run is interrupted or only assignment or summary scripts need to be run, True/False statements can be used to control whether model components are executed. The following table describes the configurable parameters in input_configuration.py.
Variable | Default Setting | Description |
---|---|---|
base_year | '2014' | Should be always be 2014 regardless of scenario, unless using another base year |
scenario_name | '2014' | Input folder name |
model_year | '2014 | Model year used to look up year-specific inputs |
daysim_code | 'R:/SoundCast/daysim_2016' | No longer used |
master_project | 'LoadTripTables' | Should never change |
main_inputs_folder | 'R:/SoundCast/Inputs' | Directory for main inputs; scenario inputs should be a folder titled consistent with variable scenario_name
|
base_inputs | os.path.join(main_inputs_folder, base_year) | Path to base inputs |
scenario_inputs | os.path.join(main_inputs_folder, scenario_name) | Path to scenario inputs |
run_convert_hhinc_2000_2010 | False | Default is to use 2014 base year |
add_distance_pricing | False | Apply per-mile pricing |
distance_rate_dict | {'am' : 13.5, 'md' : 8.5, 'pm' : 13.5, 'ev' : 8.5, 'ni' : 8.5} | Prices per mile applied when add_distance_pricing = True |
add_hot_lane_tolls | False | Include high-occupancy toll lane pricing |
hot_rate_dict | {'am' : 35, 'md' : 10, 'pm' : 35, 'ev' : 10, 'ni' : 10} | Price per mile (cents) by time of day |
min_hov_node | 199203 | May change based on network input |
run_accessibility_calcs | True | Calculate land-use and network accessibility measures from all-streets network; only needs to be performed once during model run |
run_copy_daysim_code | True | No longer used |
run_setup_emme_project_folders | True | Create empty (or overwrite existing) Emme projects at initial run setup |
run_setup_emme_bank_folders | True | Create empty emmebanks at initial setup |
run_copy_large_inputs | True | Move input files to model server for more efficient data transfer |
run_import_networks | True | Load networks to each time-of-day Emme project |
run_daysim_zone_inputs | True | |
run_copy_seed_skims | False | Seed skims are no longer tested in Soundcast; all assignments start from freeflow; always set False |
run_skims_and_paths_seed_trips | False | Seed trips are no long used and tested in Soundcast; always set False |
run_skims_and_paths_free_flow | True | Default for Soundcast is free-flow assignment |
should_build_shadow_price | False | Shadow prices are considered inputs to save run time |
run_skims_and_paths | True | Majority of trip assignment and skim building occurs when True |
run_truck_model | True | Separately generate trucks and add to network |
run_supplemental_trips | True | Separately consider external and special purpose trips not considered by Daysim |
run_daysim | True | Run the main activity-generation portion of the model |
run_supplemental_generation | True | Run if access to employment file is available; otherwise set to False and provide copy of supplemental trip productions |
should_run_reliability_skims | True | Produce extra set of skims used for link reliability analysis |
run_accessibility_summary | True | |
run_network_summary | True | |
run_grouped_summary | True | |
run_soundcast_summary | True | |
run_truck_summary | True | |
run_landuse_summary | False | |
run_daysim_report | True | |
run_day_pattern_report | True | |
run_mode_choice_report | True | |
run_dest_choice_report | True | |
run_long_term_report | True | |
run_time_choice_report | True | |
run_district_summary_report | True | |
pop_sample | [1, 1, 1, 1, 1, 1, 1, 1, 1] | Smaller population samples can be scaled for shorter run-times on initial iterations. The default and recommended setting is to run full populations each global iteration. |
max_iterations_list | [10, 100, 100, 100, 100, 100, 100, 100, 100] | List must be same length as pop_sample
|
min_pop_sample_convergence_test | 10 | |
shadow_work | [2,1,1,1] | |
shadow_con | 30 | % RMSE for shadow pricing convergence |
----> Next Step: Run
The wiki describes the basic theory and process to use Soundcast for travel modeling applications.
- Overview
- Daysim Person Trip Demand
- Network Assignment
- Submodels
- Other Documentation Resources