-
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 you need to test a model. Extract the zip file to the location where you are going to the run the model. A full completed model run is around 120 GB, so you will need the location that has adequate space.
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 would be C:\2014_lodes.
scenario_name = '2014_lodes'
model_year = '2014'
main_inputs_folder = 'C:\2014_lodes'
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] | |
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 |
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