5.2 General Object

The general object contains settings for optimiser Global Parameters (see Section  2.8). It has the following fields:

1. Field: name
   Required: No.
   Type: String.
   Description: A name for the scenario.
2. Field: iterations
   Required: No.
   Type: Number.
   Default: 3000.
   Description: The number of iterations that the optimiser runs for.
3. Field: iteration_scheme
   Required: No.
   Type: String.
   Default: null.
   Description: The identifier of the iteration scheme to be used by the optimiser.
   Note: If an iteration scheme is specified, this it will override the values of the iterations and
   maximum_neighbourhood_size fields if they are also present.
4. Field: maximum_neighbourhood_size
   Required: No.
   Type: Number.
   Default: 200.
   Description: The maximum size of a neighbourhood for the optimiser. (See Maximum Neighbourhood Size in Section  2.8.)
5. Field: unassigned_penalty_scheme
   Required: No.
   Type: String (one of the unassigned penalty scheme codes).
   Default: FIXED.
   Description: The unassigned penalty scheme to use.

6. Field: fixed_unassigned_penalty
   Required: No.
   Type: Number (positive integer).
   Default: 30000.
   Description: The value of the penalty used with the FIXED unassigned penalty scheme.

   7.Field: geofence_north
   Required: No.
   Type: Number in [-90, 90].
   Description: The latitude of the northern boundary for locations in scenario. Acts to enforce accuracy of geocodes.
   8.Field: geofence_east
   Required: No.
   Type: Number in [-180, 180].
   Description: The longitude of the eastern boundary for locations in scenario. Acts to enforce accuracy of geocodes.
   9.Field: geofence_south
   Required: No.
   Type: Number in [-90, 90].
   Description: The latitude of the southern boundary for locations in scenario. Acts to enforce accuracy of geocodes.
   10.Field: geofence_west
   Required: No.
   Type: Number in [-180, 180].
   Description: The longitude of the western boundary for locations in scenario. Acts to enforce accuracy of geocodes.
7. Field: hard_geofence_errors
   Required: No.
   Type: Boolean.
   Default: false.
   Description: If true, then treat any errors produced by geofence violations as being hard.
8. Field: colocated_pickups
   Required: No.
   Type: Boolean.
   Default: false.
   Description: If true, then enforce the colocated pickups constraint.
9. Field: batched_loads
   Required: No.
   Type: Boolean.
   Default: true.
   Description: If true, then enforce the batched loads constraint.

10. Field: use_miles
    Required: No.
    Type: Boolean.
    Default: false.
    Description: If true, then distance values in the solution will be in miles rather than kilometres.

    15.Field: preferred_vehicle_fixed_reward
    Required: No.
    Type: Number (positive).
    Default: 0.
    Description: If replanning, a fixed reward for assigning an order to its originally planned vehicle.
    16.Field: preferred_vehicle_weight_reward
    Required: No.
    Type: Number (positive).
    Default: 0.
    Description: If replanning, a weight scaled reward for assigning an order to its originally planned vehicle.
11. Field: preferred_vehicle_volume_reward
    Required: No.
    Type: Number (positive).
    Default: 0.
    Description: If replanning, a volume scaled reward for assigning an order to its originally planned vehicle.
12. Field: sticky_deliveries
    Required: No.
    Type: Boolean.
    Default: false.
    Description: If true, then enforce the Sticky Deliveries constraint.

13. Field: cost_scale
    Required: No.
    Type: Number.
    Default: 0 (Which means to not apply cost scaling.)
    Description: Scale costs by this amount before solving. (See Scaling Factors in Section  2.8).

    20.Field: weight_scale
    Required: No.
    Type: Number.
    Default: 0 (Which means to not apply weight scaling.)
    Description: Scale weights by this amount before solving. (See Scaling Factors in Section  2.8).
14. Field: volume_scale
    Required: No.
    Type: Number.
    Default: 0 (Which means to not apply volume scaling.)
    Description: Scale volumes by this amount before solving. (See Scaling Factors in Section  2.8).
15. Field: arrival_only_in_tw
    Required: No.
    Type: Boolean.
    Default: false.
    Description: Enables the Arrival Only in Time Window behaviour.
16. Field: order_splitting_strategy
    Required: No.
    Type: String (one of the order splitting strategy codes).
    Default: NONE.
    Description: The order splitting strategy to use.