Configuration file

Top  Previous  Next

FleetEngine is being controlled by a configuration file, which is located in the same directory as the executable (fleetengine.exe or fleetengine.dll) and holds the information about which networks FleetEngine should load into memory and other settings.

 

Filename is the same as the executable, i.e. fleetengine.ini or fleetenginedesktop.ini. If you rename the executable, you will have to rename the ini file too.

 

0 / 1 settings always mean false / true.

 

[Server]

Address: This need to be specified, if you make calls to the server directly from clients on other computers. Default is localhost.

 

CPUAffinityMask: Controls which cores the server is allowed to use. Default 0 = all provided by OS. The numeric mask is a bit mask where each core is identified by a bit: bit 0 (value 1) identifies first core, bit 1 identifies second core etc. A mask of 6 (= 110 binary) thus means that core 2 and core 3 can be used by the server. Windows reports it as CPU's even though it is really cores.

 

Directory specifies which directory to use when connecting to the server.

 

MaxIdleTime specifies after how many seconds a task is deleted from the server, if it has not been queried. Default is 3600 sec = 1 hour.

 

MaxRunningTasks specifies the maximum number of tasks that can be started at one time. Default is 10.

 

Port specifies which port the server uses for communication with the client. Default is 1024.

 

[Optimizer]

WarningOnInfeasibleJobs: By setting this to 1, you will get a warning if some of the jobs do not match with any of the resources. Otherwise (0) the optimization stops with an error. Default = 0.

 

InitialSolutionGenerators: This can be used to specify which of the 4 initial solution generators should be used. By default all 4 are enabled and the best result is used for further improvements.

You should only change this, if you want to get an initial solution in shorter time.

 

[Log]

ChunkSize: The size (in bytes) of the chunks that the log file will be split into. Default is -1 = no splitting.

 

Filename: Has a default value of application name + ".log" as extension. Alternative is a specific filename. You can also use environment variables such as %TEMP% for the temporary folder.

 

LoggingLevel: Possible values are 0 - no logging, 1 - normal logging and 2 - debug logging (MANY details).

 

Path: Points to the folder where the log file is stored. Default value is directory of executable / COM dll.

 

If the log file cannot be created in a service application for any reason, a windows event log record is created instead. Do not start two applications that write to the same log file. It won't work. This error can easily be made, when the configuration file is shared between different versions of FleetEngine.

 

[Network]

Netmax defines the number of street networks defined in the next sections. If Netmax=3, the next sections should be "Net1", "Net2" and "Net3" (default 0).

 

[DrivingDirections] - Overview

TemplateString = {Roadname} for {Dist} km, then {Turn} onto

StraightOn = straight on

SlightLeft = slight turn to the left

Left = turn to the left

SharpLeft = sharp turn to the left

UTurn = make a u-turn

SharpRight = sharp turn to the right

Right = turn to the right

SlightRight = slight turn to the right

TakeExit = take {Exit} exit from roundabout

 

Settings for each network

 

[NetX]

Coord3: 0 / 1 for loading coord3.bin & coord3i.bin file into RAM, 0 for reading it from disk. Use 1 if you have enough RAM (default 0).

 

CoordinateWindow: This describes the allowed range for coordinates as input to functions. The number is an extra percentage around MBR (minimum bounding rectangle) of the street network (default 20). Use a negative value if you want to allow all values (not recommended).

 

EncryptionKey: Set if encryption was used during network creation (default 0)

 

ExternalID: 0 / 1 / 2 / 3 according to how and if external ID's should be loaded (default 0 = not loaded). 1 is sufficient for all normal purposes. 2 or 3 will make it cache more details in RAM, but without improving speed much. In any case this only applies to the network loading process.

 

IgnoreNoDriveThrough: 0 / 1 according to if NoDriveThrough information should be ignored (default 0).

 

IgnoreOneWay: 0 / 1 according to if one-way street information should be ignored. If you use a network for pedestrians you may prefer not to load one-way street information (default 0).

 

Limit1: 0, 1 or 2. If 0, no limit files are loaded. If 1, limits defined by limit1.bin is loaded into memory as a scalar. If 2, limits defined by limit1.bin is loaded into memory as a bit pattern (default 0). See RW Net 4 documentation for details on limits.

 

Limit2: Same as limit1, just for limit2.bin.

 

Limit3: Same as limit1, just for limit3.bin.

 

Path: Points to the folder with the network files. Required.

 

Roadname: Allows you to open a single set of roadname files for output of driving directions with Viewer. Default value is 0.

 

SpeedX: X is a value from 0 to 31, which is a road class. Defines the speed for that road class. If your network has road classes for which no speed information is defined, the default value is 60 km/h.

 

Time: 0 / 1 according to if it should look for a file called specialtime.txt in the same directory as the other network files, which contains information about time information for specific links. See details here (default 0).

 

Turn: 0 / 1 according to if it should work in turnmode and look for a file called turn.txt in the same directory as the other network files, which contains information on turn restrictions in RW Net 4 format (default 0).

 

UTurnAllowed: 0 / 1. Defined if U-turns are allowed or not (default 0 = not allowed). This refers to U-turns while driving from one job / depot to another. If you want to prevent U-turns at a job location, look at the Pickup node in the XML.