Reading OD demand data additively

You can choose data from an OD demand data file and add it to the current demand description.

1. Make sure that a version file or a network file has been opened.

1. Click the black triangle of the Open menu button.

2. Select the entry Open file > Demand data.

The Open: Demand data window opens.

3. Select the desired file.

4. Click the Open button.

The Read demand data window opens.

5. Decide whether warnings are to be displayed on screen during reading demand data from file.

Element	Description
Show warnings on screen	If this option has been checked, warnings are displayed during reading. If this option has not been checked, no warnings are displayed during reading. 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).
Show error messages on screen	If this option has been checked, error messages are displayed during reading. If this option has not been checked, no error messages are displayed during reading. This will speed up the reading process.

Element

Description

Show warnings on screen

If this option has been checked, warnings are displayed during reading.

If this option has not been checked, no warnings are displayed during reading. 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).

Show error messages on screen

If this option has been checked, error messages are displayed during reading.

If this option has not been checked, no error messages are displayed during reading. This will speed up the reading process.

6. Select the option Read demand file additively.

More options will be available.

7. Make the desired changes.

Element	Description
Determine existing tables in advance	If this option has been checked, the demand file tables are screened. Only available data tables will be listed for selection then. If this option has not been checked, all theoretically possible demand data tables will be provided for selection.
Create warnings for conflicts in the ‘Ignore’ mode	If this option has been selected, warning messages indicating existing network objects will be displayed on the screen during the reading process in the selected "Ignore" mode (see next window). If this option has not been selected, warnings about existing network objects will not be displayed on the screen during the reading process in the selected "Ignore" mode. 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, demand objects stored in tables with the flag $-<Name of the object type> are removed from the existing demand model (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. It is automatically opened when it is read in.

8. Confirm with OK.

The Read demand data additively window opens.

Note: Visum files cannot be written in all languages the Visum program interface is available in. (You can currently write the files in English, French, German, Italian, and Polish.) The language you show the program interface in is displayed in the Display language section. Here you can specify whether the text entries in the column Demand objects (Table) are to be displayed in the language you have chosen or in the language of the demand file which is to be read.

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

Element	Description
Column to the left	If this option is checked the particular table will be read additionally to the given demand data.
Demand objects (Table)	List of data tables required for demand description. Due to current option First of all, determine existing tables setting, this list contains either any possible table or only those stored with the demand data file to be read from file additionally.
Check all	Via this button, you may check all tables.
Uncheck all	Via this button, you may uncheck all tables.

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

Note: Key attributes are attributes which serve for unique identification of demand objects (Saving a list as an attribute file).

Element	Description
Conflict avoidance	If this option has been checked, 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 checked or if it is not provided, you can - in the Conflict handling column - choose how to handle demand objects with identical keys.
Conflict handling (if Conflict avoidance is checked)	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 (if Conflict avoidance is not checked or not provided)	From the selection list, select the appropriate option for handling of demand objects with identical key. Ignore Demand objects of the demand data file with identical keys will be ignored as the existing demand objects. The existing network objects and their attribute values remain unchanged. Overwrite object Existing demand objects for which the OD demand data file contains demand objects with identical keys, are replaced by the objects read from file. Attribute values of attributes which are not contained in the OD demand data file are set to a default value. Note When importing data tables of the demand objects Matrices, Standard time series and Demand time series the existing data will be deleted before reading the new data records: All matrix values are set to 0. Time series elements are deleted Zone type-based time series are deleted Overwrite attributes Existing demand objects for which the OD demand data file contains demand objects with identical keys are kept but their attribute values are replaced. Attribute values of attributes which are not contained in the OD demand data file are kept. Notes The same applies to the import of data tables of the demand objects matrices, standard time series and demand time series. The existing matrix values, time series elements or zone type-based time series are kept before reading the data. Attributes values can only be added to the current time series elements if the start time and the end time have not been changed. 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 may read the settings from a parameter file for additive demand data reading (*.adrp) (Opening settings for Read demand data additively).

You may save these settings (Saving settings for Read demand data additively)

Notes: The demand objects matrices, standard time series and demand time series (Managing demand objects) are described in two tables. The first table includes the so-called header data and the second table the actual OD demand data.

Matrices: Header data table matrix and data table matrix entries
Standard time series: Header data table time series and data table time series item
Demand time series: Header data table demand time series and data table zone type-based time series

Header data tables and data tables can be read separately. For example, if you read only the header data table of the matrices, the matrix values will not be read. If you only read the data table of the matrices, the values will be read according to the key of the current matrices without changing the header data.

11. Confirm with OK.

Demand data is read from file.

Tip: You can also open a demand data 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 Read demand data additively window is open (Reading OD demand data additively).

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 (Reading OD demand data additively).

6. Confirm with OK.

The settings are used for the selected tables.

Saving settings for Read demand data additively

1. Make sure that the Read demand data additively window is open (Reading OD demand data additively).

2. Make sure the desired options are set (Reading OD demand data additively).

3. Click the Save button.

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

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

5. Click the Save button.

The settings are saved to an *.adrp file.

Opening settings for Read demand data additively

1. Make sure that the Read demand data additively window is open (Reading OD demand data additively).

2. Click the Open button.

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

3. Select the desired file.

4. Click the Open button.

The settings are read from file.