Estimate gravitation parameters

KALIBRI: Utility definition

Element

Description

Utility U

Linear combination of matrices, attribute vectors and/or constants that describes the utility of OD pairs

Create

Insert row in list

Delete

Delete marked row from list

1st column

If the list contains more than one entry, the + sign indicates that the entries are added row by row.

Matrix / Attribute / Constant

This button opens the Select operand window, which allows you to select a Visum skim matrix, zone attribute or constant. You can use a function to convert the values of the object selected (Transformation column). You can further multiply them by a factor (Coefficient column).

Transformation column

In the list box, click the function of your choice to convert the values selected in the Matrix / Attribute / Constant column.

Transformation

In the list box, click the function of your choice to convert the values selected in the Matrix / Attribute / Constant column (Editing matrix values).

Coefficient

Factor by which the values are multiplied one element at a time

KALIBRI: Distribution

Here you specify the desired trip distribution with regard to the utility values.

Element

Description

Preset class limits and shares

If the option has been selected, you can specify intervals for the classes and values for the shares of the classes.

Interval type section

The interval type specifies whether the upper limit or the lower limit of the interval are included in the interval or not.

Note

This option is not available if you import classes and shares via the From interval file option.

[a,b[

If this option has been selected, the lower threshold is included in the interval while the upper threshold is not included.

]a,b]

If this option has been selected, the upper threshold is included in the intervals while the lower threshold is not included.

From

Lower threshold of the interval

The first interval must have an empty field as From value and an empty field as To value 0. The last interval must have the maximum value as From value and an empty field as To value.

To

Upper threshold of the interval

The first interval must have an empty field as From value and an empty field as To value 0. The last interval must have the maximum value as From value and an empty field as To value.

Share

Percentage of matrix values that belong to the interval

Note

The share of the intervals with empty fields must be 0.

Cumul. share

Percentage of matrix values accumulated from top to bottom

Number of trips

Number of matrix values covered by the interval [Lower limit, Upper limit[

Create

Use this button to add a new interval to the end.

Delete

Use this button to delete the selected intervals.

Read from file

Click this button to delete all existing classes and import new classes and shares from an interval file (*.att) into the list. The setting of the option Interval type is applied to the classes of the import file.

From interval file

Select this option to use an interval file with classes and shares. Click the button to choose a file.

Notes

This option allows you to use data that is not calculated until during the procedure sequence run.

Interval files have the file extension * .att .

Note

When you import an * .att file, the interval type is ]a,b].

KALIBRI: Function type

Element

Description

Function type

Utility function type for which you want to calibrate the parameters

f(U) = U^b e^(c U)

Select this option to calculate the parameters b and c.

f(U) = e^(c U)

If this option has been selected, the distribution parameter c is calculated, whereas parameter b remains constant = 0.

Weighted by the number of trips in each class

Select this option to weigh the utility function by the number of trips in each class.

Doubly constrained: Balancing by multi-procedure

If this option has been selected, matrix balancing by multi-procedure is calculated additionally after the first iteration (Fundamentals: Gravity model calculation).

If you do not select this option, trip distribution is calculated singly constrained for production.

Note

The origin demand (Production) value is regarded for each zone.

Multi parameters

Parameters for multi procedure calculation

Note

These options are only available for doubly constrained gravity model calculation.

Maximum number of iterations

After the user-defined number of iterations the internal iteration process is canceled though convergence has not been reached yet.

Quality factor

Criterion for termination of the multi procedure

Kalibri calculation: Max. number of iterations

Without reaching convergence, the calculation is canceled after the specified number of iterations.

Note

Due to inconsistent input data, the calculation might not converge. In this case, raising the number of iteration will not improve the convergence. Therefore, we recommend reducing the number of iterations to save calculation time.

KALIBRI: Outputs

Element

Description

Output

Store the calculated matrix in matrix

The result matrix calculated during calibration is saved to a Visum matrix. Click the Select output matrix button to select the matrix of your choice (Selecting matrices).

Do not save calculated matrix

The result matrix calculated during calibration is not saved.

Protocol

Protocol output to log file

A protocol of the calculation is output to a log file (Using protocol files).

Protocol output to file

A protocol of the calculation is output to a file. Click the button to choose a file.

No protocol output

Visum does not output a protocol.