Applying model transfer files

You can apply a model transfer file created beforehand to the currently opened version file. In doing so, you transfer the respective network and OD demand data and create a new model.

1.  Open the desired version file.

2.  From the File menu, choose Compare and transfer networks > Apply model transfer file.

The Open: Model transfer file window opens.

3.  Select the desired file.

4.  Click the Open button.

Note: Alternatively, you may enter path and file name.

A query opens.

5.  Confirm the query with OK.

The Apply model transfer file window opens.

6.  Make the desired changes.

Element

Description

Show warnings on screen

Select this option to show warnings when loading files.

If this option is not selected, no warnings are shown when you load files. This will speed up the reading process.

Note

If in the warning settings, you selected Save warnings and details to the message file and in the log files, you selected Message file: Create new file, warnings are saved to a message file (Specifying settings for protocol files).

Display error messages on screen

Select this option to show error messages when loading files.

If this option is not selected, no error messages are shown when you load files. This will speed up the reading process.

7.  Make the desired changes.

Element

Description

Determine existing tables in advance

If this option has been selected, the model transfer file is checked. Only the existing tables are displayed in the subsequent table selection.

If this option has not been selected, all tables will be provided for selection.

Create warnings for conflicts in mode "Ignore"

If this option has been selected and the Ignore mode (see next window) has been activated, warnings about existing network objects will be displayed on the screen during the reading process.

If this option is not selected, and you select the Ignore mode, no warnings about already existing network objects are displayed during the reading in process. This will speed up the reading process.

Note

To save warnings to a message file, in the warning settings, select Save warnings and details to the message file and in the log file settings, select Create new file (Specifying settings for protocol files).

Permit the deletion of objects

If this option has been selected, network objects in tables labeled $-<name of object type> will be deleted from the network (Creating a model transfer file).

If this option has not been selected, tables that are labeled $-<Object type name> will be ignored.

Show statistics of modifications

Select this option to have Visum create a model transfer file while reading in a new file. The model transfer file contains all changes that are made according to the new file.

The file is saved to the project directory specified for model transfer files, under the name <Current version name> - ReadNetwork.tra.

Polygon handling after import

Normalize created and modified polygons

Select this option to normalize all newly added polygons and all polygons changed through the import process.

8.  Confirm with OK.

The Apply model transfer file window opens.

Note: When selecting the network object types, make sure that the selected combination makes sense. If possible, use the Frequent cases button to have access to a number of useful combinations.

Note: The network file cannot be written in all languages the Visum program interface is available in. If you show the program interface in a language (e.g. Greek) that is not supported by the network file, the Display language section is displayed at the top of the window. Here you can select the language you want to show the texts of the column Network objects (table) in.

9.  Select the data tables you want to read additionally to your current network.

Element

Description

Column to the left

If this option has been selected, the particular table will be read additively to the given data.

If this option is not checked the particular table will be ignored.

Network objects (table)

List of data tables which are required for object description. Depending on the Determine existing tables in advance option, this list contains either any possible table or only those saved with the model transfer file.

Check all

Via this button, you may check all tables.

Uncheck all

Via this button, you may uncheck all tables.

Frequent cases

The data required for description of the objects of a particular network object type are stored in just a single or in multiple tables. All data of a link object, e.g., is listed in the $Links table. Links with an edited shape are additionally listed in the $LinkPoly block.

Via this button you can select all data tables required for description of certain network objects (so-called use cases) at the same time. Furthermore you can automatically set preventive options for conflict handling (Selecting data tables required to describe an object type for saving data to file).

10.  Decide for each data table, how network objects are to be read if the current network already contains a network object with an identical object key.

Note: Key attributes are attributes which serve for unique identification of network objects (Key attributes).

Element

Description

Conflict avoidance for new objects

If this option has been selected, you can - in the Conflict handling column - modify the value of the key attribute in a way that makes the value unique.

If this option has not been selected or if it is not provided, you can - in the Conflict handling column - choose how to handle network objects with identical keys.

Conflict handling for new objects (if Conflict avoidance has been selected)

According to the data type of the key attribute, enter an alphanumerical prefix value or a numerical offset value.

Prefix

To an alphanumerical key attribute, you can add an alphanumerical prefix in the first position.

Offset

To the value of a numerical key attribute you can add a constant value.

Conflict handling for new objects (if Conflict avoidance has not been selected or is not available)

From the selection list, select the appropriate option for handling of network objects with identical key.

Only check

Visum checks whether the network objects to be read already exist. If this is not the case, an error message is displayed and reading data from file is canceled. This option is provided for, for example, Transport Systems, Modes and Demand segments.

Ignore

Ignored are those network objects in the network file being read that have identical keys which are already in use in the currently open network file. The existing network objects and their attribute values remain unchanged.

Overwrite object/course

Existing network objects for which the network file contains network objects with identical keys, are replaced by the objects read from file. Attribute values of attributes which are not contained in the network file are set to a default value.

Overwrite attributes

Existing network objects for which the network file contains network objects with identical keys are kept but their attribute values are replaced. Attribute values of attributes which are not contained in the network file remain unchanged.

Overwrite structure

If the network file contains lanes for a leg, they are overwritten.

Cancel

Reading is canceled.

Tips: Alternatively you may specify the settings for multiple data tables at the same time by marking the tables and clicking the Edit button (Setting options for multiple data tables).

Alternatively you can read the settings from the parameter file for additive network reading (*.anrp) (Saving settings for the application of model transfer data files).

You may save these settings (Opening settings for the application of model transfer data files)

11.  Confirm with OK.

The network and OD demand data is read.

Tip: You can also open a network file by clicking the selected file in the list of recently opened files on the File menu.

Setting options for multiple data tables

1.  Make sure that the Apply model transfer file window is open (Applying model transfer files).

2.  Press the Ctrl key and keep it pressed.

3.  In the list of tables, mark the entries you would like to edit.

4.  Click the Edit button.

A window opens.

5.  Make the desired settings (Applying model transfer files).

6.  Confirm with OK.

The settings are used for the selected tables.

Saving settings for the application of model transfer data files

1.  Make sure that the Apply model transfer file window is open (Applying model transfer files).

2.  Make sure that the desired options have been set.

3.  Click the Save button.

The Save: Parameters for 'Read network additively' window opens.

4.  Enter the file name and the path, if required.

5.  Click the Save button.

The settings are saved as *.anrp file.

Opening settings for the application of model transfer data files

1.  Make sure that the Apply model transfer file window is open (Applying model transfer files).

2.  Click the Open button.

The Open: Parameters for 'Read network additively' window opens.

3.  Select the desired *.anrp file.

4.  Click the Open button.

The settings are read from file.