PuTUpdater configuration

All the configuration parameters involved in the PuTUpdater process (→ PuTUpdater methodology) are described here.

These parameters are set in the appsettings.xml file, stored in the config-template directory inside the the PuTUpdater package.

Parameter Description

AutomaticProcess

Data type: Boolean

Determines whether or not the process should be completely automatic.

Values:

  • true: automatic process

  • false: a Visum version file is stored int the directory given by the option ToBeValidatedModelDirectory and a manual validation is required by the operator.

    Once the operator has validated the model, they can complete the process by copying it in the directory set in ValidatedModelDirectory.

PollingIntervalInSeconds

Data type: Integer

The amount of seconds between each check of the GTFS .zip file. When a new version of the GTFS feed is available, the process starts.

Default value: 21600

GTFSFilePath

Data type: String

The path where the GTFS .zip file is stored.

Example: PutUpdaterIntegrationRieti/GTFS/gtfs.zip

ToBeValidatedModelDirectory

Data type: String

Directory where the new Optima model is stored, waiting for the operator's validation.

The validation may be required either if:

  • AutomaticProcess=false

  • If the model quality is below the thresholds

Example: D:\Projects\PutUpdaterIntegrationCosenza\ToBeValidated

PuTSupplyDataDirectory

Data type: String

Directory where the Visum model produced by the GTFS import is stored.

Example: D:\Projects\PutUpdaterIntegrationLatina\PuTSupplyData

ValidatedModelDirectory

Data type: String

Directory where the operator must copy the Visum model after the validation (in case of a semi- automatic process)

Example: D:\Projects\PutUpdaterIntegrationSiracusa\Validated

OptimaBaseModelPath

Data type: String

The path of the Optima base Visum transportation model.

Example:D:\Projects\PutUpdaterIntegrationJaffa\ModelDirectory\OptimaBaseModel.ver

ModelHistoryDirectory

Data type: String

Directory where all the optima models produced by the update process are stored.

Example: D:\Projects\PutUpdaterIntegrationJaffa\ModelHistory

PsqlPath

Data type: String

Directory where the psql.exe file is stored.

Default value: C:\Program Files\PostgreSQL\14\bin

DBName

Data type: String

Name of the Optima DB.

Default value: optima

DBUser

Data type: String

User name to access the Optima DB.

Default value: postgres

DBPassword

Data type: String

User password to access the Optima DB.

Default value: postgres

DBHost

Data type: String

The host address of the Optima DB.

DBPort

Data type: Integer

The host port of the Optima DB.

Default value: 5432

OptimaBaseAddress

Data type: String

Base URL of the Optima AS.

Example:

OPTUSER

Data type: String

Name of a valid Optima user.

Example:

OPTPASWD

Data type: String

Password of the Optima user (in clear text).

The password cannot contain the special characters '=' and '&'.

THRESHOLDS

STOPPOINT_MAX_DISTANCE

Maximum desired value for the STOPPOINT_DISTANCE KPI.

The quality assessment fails if any values are above this threshold.

The suggested value is 150 (meters).

LINEROUTE_MAX_LENGTHRATIO

Maximum relative error between:

  • The Merged Model line route length A

  • The GTFS Model line route length B

The quality assessment succeeds if:

1/LINEROUTE_MAX_LENGTHRATIO < A/B < LINEROUTE_MAX_LENGTHRATIO.

The suggested value is 1.1 (10% error).

LINEROUTE_MAXNUM_FALSENEGATIVE_STOPS

A "false negative stop" is a stop where the line route is not stopping, although it should.

LINEROUTE_MAXNUM_FALSENEGATIVE_STOPS is the maximum accepted value for the LINEROUTE_NUMFALSENEGATIVESTOPS.

The quality assessment fails if any line route has a value greater than the threshold.

The suggested value is 0.

LINEROUTE_MAXNUM_FALSEPOSITIVE_STOPS

A "false positive stop" is a stop the line where the route is stopping, although it shouldn't.

LINEROUTE_MAXNUM_FALSEPOSITIVE_STOPS is the maximum accepted value for the LINEROUTE_NUMFALSEPOSITIVESTOPS.

The quality assessment fails if any line route has a value greater than the threshold.

The suggested value is 0.

LINEROUTEITEM_MAX_DISTANCE

Maximum desired value for the LINEROUTEITEM_DISTANCE KPI

The quality assessment fails if any values are above this threshold.

The suggested value is 300 (meters).

LINEROUTEITEM_MAX_LENGTHRATIO

Maximum relative error between:

  • The Merged Model line route item length A

  • The GTFS Model line route item length B

The quality assessment succeeds if:

1/LINEROUTEITEM_MAX_LENGTHRATIO < A/B < LINEROUTEITEM_MAX_LENGTHRATIO.

The suggested value is 1.1 (10% error).

LINEROUTEITEM_MAXNUM_FALSENEGATIVE

Maximum desired number of line route items having LINEROUTEITEM_ISFALSENEGATIVE=true.

The quality assessment fails if this number is exceeded.

The suggested value is 0.

LINEROUTEITEM_MAXNUM_FALSEPOSITIVE

Maximum desired number of line route items having LINEROUTEITEM_ISFALSEPOSITIVE=true.

The quality assessment fails if this number is exceeded.

The suggested value is 0.