3.8 Configuration

From visummodelwiki
Revision as of 21:29, 12 March 2023 by Bpaul (talk | contribs)

Jump to: navigation, search


Configuring NERPM-AB involves setting the procedure sequence properties, the general model settings, and DaySim properties. The following sections provide details on these. The settings specific to all tools are specified in each tool’s configuration/settings files. Please refer to the previous sections in this chapter to learn more about various tools used in NERPM-AB.

Procedure Sequence Properties

Visum-based models are run via procedure sequence which makes it possible to run multiple model steps successively. A procedure sequence includes several pre-defined procedures with specific user-defined procedures. A procedure sequence is generally organized by grouping similar procedures. A grouped procedure sequence looks as follows:

Grouped procedure sequence.png

Double-click the procedure group to expand it to view individual procedures inside a procedure group. To expand all groups, click the ‘Expand all groups’ button on the side bar as shown below:

Expand all groups.png

Activate/deactivate the procedures to be run by checking/unchecking the ‘Active’ check box next to each procedure group. To activate all procedures, click the ‘Set all active’ button in the ‘Operations’ sidebar as shown below:

Check all procedures.png

Individual procedures within a group can be set as active/inactive by checking/unchecking the ‘Active’ check box next to the procedure. For example, the initialization of assignment results can be skipped as follows:

Uncheck procedures.png

The settings specific to assignment and skimming are set in the procedure sequence settings. To view these settings, open the procedure sequence settings by clicking the ‘general procedure settings’ icon in the procedure sequence window:

General procedure settings.png

The general procedure settings window allows the configuration of link and node impedances, highway (PrT) and transit (PuT) assignment, and skimming settings.

Configure general procedure settings.png

To start the procedure sequence, left click the ‘Start procedure sequence' button on the menu bar of the procedure sequence window. This will run all active procedures in sequence.

Run procedure sequence.png

To run the procedures step by step, left-click the ‘Single-step’ button to step through the procedure sequence one step at a time.

Step procedure sequence.png

Once the procedure sequence has been configured for a specific modeling task, it can be exported as procedure parameter files (XML format) for reuse later. To export a procedure sequence, left-click the ‘save’ icon on the menu bar of the procedure sequence window and follow the prompts.

Save procedure sequence.png

To load a pre-saved procedure parameters file, left-click the ‘open file’ icon on the procedure sequence menu bar:

Load Procedure Seq.png

Next, select the appropriate procedure parameters file from the select file window and follow the prompts.

Select procedure sequence file.png

General NERPM-AB Settings

The general NERPM-AB settings, parameters, and auxiliary model data are specified in the version file as user-defined tables. A full list of user-defined tables is shown below:

Table definitions.png



DaySim Settings


The configuration file is the main control file for DaySim. The configuration file informs DaySim about inputs/outputs and various model settings. These settings include input/output file names, types and locations, sample rates, DaySim pathbuilding weights, and also allow users to specify which DaySim model components should be executed. A detailed description of the setting used in the NERPM-AB model is provided in section 4.3.

N Processors

Seed Shadow Price

Shadow prices are constants that are added to individual microzones during the simulation of work and school location choice models. This is done to result in a good match between the following:

  • Work locations of workers and employment
  • School locations of students and enrollment

In DaySim, the long-term models (work and school location choice) are run ten times while updating shadow prices for all microzones during every iteration to create a seed shadow price file to be used as input to the full model run. The intent is to make sure that there is a good match between the number of job available in a microzones and the number of workers choosing the microzones as their usual work location. The same applies for students and school locations.

When the user updates the employment and/or school enrollment data, the Shadow Price step should be rerun.