Optimization properties

Setting properties will influence the way the Optimizer is finding a solution to a problem set. By default, the optimization properties are tuned to solve most of the use-cases. It is recommended to keep the default properties as much as possible. However, some properties need to be set. Especially, properties that influence the runtime or the filtering ability of the Optimizer are set usually on startup and are adjusted to meet the user requirements.

Setting properties

Setting properties is done before the optimization starts, like:

  private static void addProperties(IOptimization opti) {

     // Create an empty properties object
    Properties props = new Properties();

    props.setProperty("JOpt.Algorithm.PreOptimization.SA.NumIterations", "10000");
    props.setProperty("JOptExitCondition.JOptGenerationCount", "2000");

    // Adding the properties to the optimization
    opti.addElement(props);
  }

Properties that should be adjusted

Key	Default Value	Allowed Values	Description
`JOpt.NumCPUCores`	4	> 0	NumCPUCores defines the number of cores JOpt will use.
`JOptExitCondition.JOptGenerationCount`	5000	> 0	After a certain number of generation JOpt terminates the Optimization
`JOpt.Algorithm.PreOptimization.SA.NumIterations`	150000	> 0	SA.NumIterations defines the number of iterations for simulated annealing.

Further, optimization weights might be tuned to achieve the desired outcome.

JOpt.TourOptimizer Optimization Properties

Generated from ReadOutDefaultPropertiesExample.java and its console output. Update date: 2026-02-06.

Source: ReadOutDefaultPropertiesExample.java

This document lists the current default optimization properties (key, default value, allowed values, and description) grouped by category.

CATEGORY OPTIMIZATION AUTOFILTER

Property Key	Default	Allowed Values	Description
`JOpt.Algorithm.tryUseCluster2Opt`	`FALSE`	`[TRUE, FALSE]`	In case joined-visit-nodes are in use, a special cluster2Opt Algorithm can be used. This algorithm gives better results but uses comparable high computational effort. However, if no joined-visit-nodes are present this Operator is deactivated automatically.
`JOpt.Algorithm.tryUseClusterInsertion`	`FALSE`	`[TRUE, FALSE]`	In case joined-visit-nodes are in use, a special cluster insertion Algorithm can be used. This algorithm gives better results but uses comparable high computational effort. . However, if no joined-visit-nodes are present this Operator is deactivated automatically.
`JOpt.AutoFilter`	`FALSE`	`[TRUE, FALSE]`	Turns on or off the AutoFilter. The AutoFilter is able to sort out nodes that are violating the optimization too often.
`JOpt.AutoFilter.afterFilteringResult`	`FALSE`	`[TRUE, FALSE]`	Throw a result after filtering nodes.
`JOpt.AutoFilter.beforeFilteringResult`	`FALSE`	`[TRUE, FALSE]`	Throw a result before attempting to filter nodes.
`JOpt.AutoFilter.canDisableNodeProtection`	`TRUE`	`[TRUE, FALSE]`	The AutoFitler is allowed to remove the AutoFilterProtection of the nodes after the number of protected exectuios is reached.
`JOpt.AutoFilter.collectivePenalization.maxImportance`	`5`	`[]`	In case of WorkingHours Exceedanceand MaxDistance Exceedance, all nodes of a route can be penalized, which leads to a higher probability of not being assigned. For nodes with Importance above collectivePenalization.maxImportance this penalty is not added..
`JOpt.AutoFilter.EarlyArrivalMargin`	`0`	`[]`	No description available
`JOpt.AutoFilter.LateArrivalMargin`	`0`	`[]`	No description available
`JOpt.AutoFilter.RouteDistanceExceedMargin`	`0`	`[]`	Margin for overdistance in meter
`JOpt.AutoFilter.tryAvoidSplittingJoinedClusters`	`FALSE`	`[TRUE, FALSE]`	The AutoFilter will try to keep nodes that are marked with joined visit duration, and part of a cluster, in the Optimization.
`JOpt.AutoFilter.tryGracefulNodeFiltering`	`TRUE`	`[TRUE, FALSE]`	After finding nodes to be filtered, the AutoFilter checks if already unassigning a subset is sufficient to solve a violation => this way, the number of nodes getting unassigned can be reduced.
`JOpt.AutoFilter.usePostOptimizationAfterStrictFiltering`	`TRUE`	`[TRUE, FALSE]`	When false, jumps to the end of the currently running optimization algorithm after strict filtering.
`JOpt.AutoFilter.useStrictFilterOnLastExecution`	`TRUE`	`[TRUE, FALSE]`	Enables the strict mode for the last execution of the autoFilter.
`JOpt.AutoFilter.WorkingHoursExceedMargin`	`0`	`[]`	Margin for overtime in seconds
`JOpt.AutoForceFilter.EarlyArrivalMargin`	`0`	`[]`	No description available
`JOpt.AutoForceFilter.LateArrivalMargin`	`0`	`[]`	No description available
`JOpt.AutoForceFilter.RouteDistanceExceedMargin`	`0`	`[]`	Margin for AutoForceFilter overdistance in meter
`JOpt.AutoForceFilter.WorkingHoursExceedMargin`	`0`	`[]`	Margin for AutoForceFilter overtime in seconds
`JOpt.SelectiveAutoFilter`	`FALSE`	`[TRUE, FALSE]`	Turns on or off the selective AutoFilter. The selective AutoFilter is able to sort out nodes that are violating the optimization to often. In addition to this property the desired violations that should be considered need to be defined.
`JOpt.SelectiveAutoFilter.AfterEndAnchor`	`FALSE`	`[TRUE, FALSE]`	Nodes which are positioned after an end anchor are filtered out.
`JOpt.SelectiveAutoFilter.CapacityOverload`	`FALSE`	`[TRUE, FALSE]`	Nodes that are causing an overload of the resources are filtered out.
`JOpt.SelectiveAutoFilter.DoubleBooking`	`FALSE`	`[TRUE, FALSE]`	Nodes that are potentially double booked in to many optimization steps are filtered out.
`JOpt.SelectiveAutoFilter.MaximalRouteDistanceExceeded`	`FALSE`	`[TRUE, FALSE]`	Nodes that are causing the maximal allowed route distace to be exceeded are filtered out.
`JOpt.SelectiveAutoFilter.NodeType`	`FALSE`	`[TRUE, FALSE]`	Nodes that are visited by the worng type of resource are filtered out.
`JOpt.SelectiveAutoFilter.RelationShip`	`FALSE`	`[TRUE, FALSE]`	Nodes that have wrong relations to other nodes.
`JOpt.SelectiveAutoFilter.ResourceMismatch`	`FALSE`	`[TRUE, FALSE]`	Nodes that are visited to often by wrong resources (either prefered or mandatory) are filtered out.
`JOpt.SelectiveAutoFilter.TimeWindow.Early`	`FALSE`	`[TRUE, FALSE]`	Nodes that are visited to early in too many optimization steps are filtered out.
`JOpt.SelectiveAutoFilter.TimeWindow.Late`	`FALSE`	`[TRUE, FALSE]`	Nodes that are visited to late in too many optimization steps are filtered out.
`JOpt.SelectiveAutoFilter.WorkingHoursExceeded`	`FALSE`	`[TRUE, FALSE]`	Nodes that are causing a working hours exceedance of a resource are filtered out.

CATEGORY OPTIMIZATION CONSTRUCTION

Property Key	Default	Allowed Values	Description
`JOpt.Assisted`	`TRUE`	`[TRUE, FALSE]`	Turns on or off the assisted constructor. The assisted construtor is creating a starting solution for JOPt.
`JOpt.Clustering.AutoZoneCodeClusters`	`FALSE`	`[TRUE, FALSE]`	When using Clustering algorithms for construction, found clusters are automatically transformed to Zones.
`JOpt.Clustering.AutoZoneCodeClusters.isHard`	`FALSE`	`[TRUE, FALSE]`	When using Clustering algorithms for construction, and automatically transformation to Zones is enabled, either Zones can be hard ord soft constrained.
`JOpt.Clustering.JointVisitDuration.doUseDistanceDivider`	`FALSE`	`[TRUE, FALSE]`	If true, nodes of a joint visit duration cluster are splitting their distances during clustering construction.
`JOpt.Clustering.MaxDistanceUtilization`	`200.0`	`[]`	During clustering, cluster refuse accepting new elements above this value.
`JOpt.Clustering.MaxDurationUtilization`	`80.0`	`[]`	During clustering, cluster refuse accepting new elements above this value.
`JOpt.Clustering.ReassignOrphanedNodes`	`TRUE`	`[TRUE, FALSE]`	When using Clustering algorithms for construction, nodes that are orphaned after construction are reassigned.
`JOpt.Clustering.ResourceDutyHoursSplitValue`	`10`	`[]`	The split value defines the maximal number of dutyhours that can be part of a single deputy resource inside a cluster during the clustering construction. This number should be as high as possible (default 10). If the clustering seems to be stuck, this number should be reduced (>0).
`JOpt.Clustering.ResourceSplitValue`	`30`	`[]`	The split value defines the maximal number of resources that can be part of a single cluster during the clustering construction. This number should be as high as possible (default 30). If the clustering seems to be stuck, this number should be reduced (>0).
`JOpt.Clustering.ShowDebugOutput`	`FALSE`	`[TRUE, FALSE]`	When using Clustering algorithms for construction, debug output will be show as status event when enabling with true.
`JOpt.PerformanceMode`	`FALSE`	`[TRUE, FALSE]`	Turns on or off the perfromance mode.
`JOpt.ReassignNodesOnStartup`	`FALSE`	`[TRUE, FALSE]`	True: If a snapshot/json with an existing solution is loaded, additional nodes in the json-node definition are reassigned.

CATEGORY OPTIMIZATION DEPRECATED

Property Key	Default	Allowed Values	Description
`JOpt.DEPRECATEDTESTPROP`	`1`	`[]`

CATEGORY OPTIMIZATION GENERAL SETUP

Property Key	Default	Allowed Values	Description
`JOpt.CapacityDegradation.TreatSameLocationsAsOne`	`FALSE`	`[TRUE, FALSE]`	TRUE: If multiple nodes are within the same route and sharing the same location (same matrix ID)
`JOpt.Clustering.PenlalizeZoneCodeCrossing`	`FALSE`	`[TRUE, FALSE]`	When nodes of different Zones are visited in direct succession are visited a penalty might be assigned.
`JOpt.Clustering.PenlalizeZoneCodeCrossingMultiplier`	`1.0`	`[]`	When nodes of different Zones are visited in direct succession are visited a penalty might be assigned. PenlalizeZoneCodeCrossingMultiplier acts as factor for the assigned penalty cost.
`JOpt.CostAssessment.useAverageCost`	`FALSE`	`[TRUE, FALSE]`	The fitness cost of the Optimization is based on the average cost of all routes, instead of the sum if true.
`JOpt.IntermediateStage.ThrowResults`	`FALSE`	`[TRUE, FALSE]`	Do we want to have a result after each optimization stage?
`JOpt.JointVisitDuration.maxRadiusMeter`	`10.0`	`[]`	Below the maxRadius a joint visitDuration is triggered if this concept is enabled for a Node.
`JOpt.JointVisitDuration.routeTimeBonusFactor`	`0.0`	`[]`	IIf a joint node is successfully scheduled, decrease usual RouteTimeCost by routeTimeFactor.
`JOpt.KeepZeroDriveForEventNodes`	`FALSE`	`[FALSE]`	True: When an EventNode is allowed to move, distance and drivingtime stays at the subsequent node.
`JOpt.MovingEventNodes`	`TRUE`	`[TRUE, FALSE]`	True: Any EventNode (a node without a geo location) can move between nodes to avoid latness and idle time.
`JOpt.Multicore`	`1`	`[0, 1]`	Enables or disables the JOPt multicore functionality. Enabling multicore only works if the used license is supporting this.
`JOpt.NumCPUCores`	`4`	`[]`	NumCPUCores defines the number of cores JOPT will use.
`JOpt.plausibility.doInputCheck`	`TRUE`	`[TRUE, FALSE]`	Property to turn on the structural integrity of the system created or user provided intial solution.
`JOpt.plausibility.doInputCheck.doCapacityCheck`	`TRUE`	`[TRUE, FALSE]`	In case doInputCheck is true this setting can disable the capactiy check of the available workingHours vs. the necessary total duration of all nodes.
`JOpt.PlausibilityGuard.PropertyChecker.Active`	`TRUE`	`[TRUE, FALSE]`	TRUE: The propertychecker is activated. This is the default behaviour.
`JOpt.PropertyChecker.ShowWarnings`	`TRUE`	`[TRUE, FALSE]`	Property for enabling and disabling the output of the propertyChecker.
`JOpt.UnlocatedIdleTime`	`FALSE`	`[TRUE, FALSE]`	True: Idlem time is not arising at particular node.

CATEGORY OPTIMIZATION GENETIC SETUP

Property Key	Default	Allowed Values	Description
`JOpt.JOptPopulationSize`	`100`	`[]`	PopulationSize defines the fixed number of individuums that will be used during the optimization.
`JOptExitCondition.JOptGenerationCount`	`5000`	`[]`	After a certain number of generation JOPT terminates the Optinization

CATEGORY OPTIMIZATION PRE-OPTIMIZATION SETUP

Property Key	Default	Allowed Values	Description
`JOpt.Algorithm.GE.OnProgressOutPercentage`	`1.0`	`[]`	By default the optimization reports an onProgress after 1.0% of progress. Setting this property to 0.1, will causethe optimizer to report at every 0.1% percentage of progress.
`JOpt.Algorithm.Operator.2Opt.Threshold`	`10`	`[]`	Defines the threshold for the 2Opt Operator. As the 2Opt Operator is quite performance hungry, the numberof elements that are invoked in a common execution is limited to the 'Threshold'. A higher value, is that the default of value of 10 is beneficial in problems where the average number of nodes in a route is high. For example, a lot of nodes with short durations and short driving times.
`JOpt.Algorithm.Operator.GE.doForceReselect`	`FALSE`	`[TRUE, FALSE]`	True: If an operator during GE phase does not modify an existing solution another operator will be selected additionally.
`JOpt.Algorithm.Operator.GE.numReselects`	`3`	`[]`	Number of operator reselects (if reselect is allowed) during GE phase.
`JOpt.Algorithm.Operator.RequireHoursOverlap`	`TRUE`	`[TRUE, FALSE]`	Operators only allow moves of nodes to different resources, if the workinghours of the target resource and the opening hours of the nodes is overlapping.
`JOpt.Algorithm.Operator.SA.doForceReselect`	`FALSE`	`[TRUE, FALSE]`	True: If an operator during SA phase does not modify an existing solution another operator will be selected additionally.
`JOpt.Algorithm.Operator.SA.numReselects`	`5`	`[]`	Number of operator reselects (if reselect is allowed) during SA phase.
`JOpt.Algorithm.PreOptimization.SA.CoolingRate`	`0.999985`	`[]`	SA.CoolingRate defines the cooling of simulated annealing after each iteration.
`JOpt.Algorithm.PreOptimization.SA.NumIterations`	`150000`	`[]`	SA.NumIterations defines the number of iterations for simulated annealing.
`JOpt.Algorithm.PreOptimization.SA.NumRepetions`	`1`	`[]`	SA.NumRepetions defines the number of cycles for simulated annealing.
`JOpt.Algorithm.PreOptimization.SA.OnProgressOutPercentage`	`1.0`	`[]`	By default the optimization reports an onProgress after 1.0% of progress. Setting this property to 0.1, will causethe optimizer to report at every 0.1% percentage of progress.
`JOpt.Algorithm.PreOptimization.SA.StartingTemperature`	`10.0`	`[]`	SA.StartingTemperature defines the starting temperature for simulated annealing.
`JOpt.Algorithm.PreOptimization.SA.StartingTemperatureLoadedSnapshot`	`0.1`	`[]`	SA.StartingTemperatureLoadedSnapshot defines the starting temperature for simulated annealing after snapshot loading.
`JOpt.Algorithm.Relation.NestingLimit`	`100`	`[]`	During the evaluation of Network relations, a maximal nesting limit can be set (default 100). In case an illegal cycle occurs, or the relation nesting is simply too deep, the limit kicks in.

CATEGORY OPTIMIZATION WEIGHTS

Property Key	Default	Allowed Values	Description
`JOptWeight.Capacity`	`50.0`	`[]`	JOPt weight for 'Capacity' during the optimization.
`JOptWeight.CO2Emission`	`0.0`	`[]`	JOPt weight for 'CO2Emission' during the optimization. A higher value results in a higher optimization cost penalty for using Resources with high CO2 emission.
`JOptWeight.ColorCapacity`	`10.0`	`[]`	JOPt weight for 'ColorCapacity' during the optimization.
`JOptWeight.CompactingFactor`	`1.0`	`[]`	JOPt weight for 'CompactingFactor' during the optimization.
`JOptWeight.DistanceExceeded`	`10.0`	`[]`	JOPt weight for exceedance of 'RouteDistance' during the optimization.
`JOptWeight.DistanceVariationPattern`	`0.0`	`[]`	JOpt weight for 'distance variation pattern'. A higher value, triggers a higher importance of matching a desired distance pattern of each individual route.
`JOptWeight.ExpertiseLevelPreference`	`1.0`	`[]`	JOPt weight for 'ExpertiseLevelPreference' during the optimization.
`JOptWeight.NodeCompactingFactor`	`0.0`	`[]`	JOPt weight for 'NodeCompactingFactor' during the optimization. In case a node is visited in time but not at the beginning of its opening hours a cost is arising the later it is visited.
`JOptWeight.NodeImportance`	`1.0`	`[]`	JOPt weight for nodeImportance during the optimization. A higher value results in a higher optimization cost penalty for violating nodes with higher importance.
`JOptWeight.NodeType`	`1.0`	`[]`	JOPt weight for 'NodeType' during the optimization.
`JOptWeight.PreferableResource`	`1.0`	`[]`	JOPt weight for 'PreferableResource' during the optimization.
`JOptWeight.Relationships`	`100.0`	`[]`	JOPt weight for 'Relationships' during the optimization.
`JOptWeight.ResourceActive`	`0.0`	`[]`	JOPt weight for 'ResourceActive' during the optimization.
`JOptWeight.ResourceLocationBias`	`0.0`	`[]`	JOPt weight for 'ResourceLocationBias' during the optimization. For, the last element of a previous route and the first element of the current route the distanceis extracted. The higher this distance is, the more cost will be assigned. Therefore,a global clustering (over different route of the same resource) is motivated.
`JOptWeight.ResourceRadiusDrivingDistance`	`1.0`	`[]`	JOPt weight for 'distance' radius during the optimization. If a maximal driving radius (distance) for a certain resource is defined as a soft constraint, a higher value of this property results in a higher cost penalty if the resource is violating its maximal allowed radius.
`JOptWeight.ResourceRadiusDrivingTime`	`1.0`	`[]`	JOPt weight for 'driving time' radius during the optimization.If a maximal driving radius (time) for a certain resource is defined as a soft constraint, a higher value of this property results in a higher cost penalty if the resource is violating its maximal allowed radius.
`JOptWeight.ResourceWorkingTimeBalance`	`0.0`	`[]`	JOpt weight for 'ResourceWorkingTimeBalance' during the optimization. A higher value will lead to a higher balance in terms of the working time for each route.
`JOptWeight.RouteDistance`	`1.0`	`[]`	JOPt weight for 'RouteDistance' during the optimization.
`JOptWeight.RouteTime`	`1.0`	`[]`	JOPt weight for 'RouteTime' during the optimization.
`JOptWeight.TimeExceeded`	`100.0`	`[]`	JOPt weight for exceedance of 'TimeExceeded' during the optimization.
`JOptWeight.TimeWindow`	`1.0`	`[]`	JOPt weight for 'timeWindow' during the optimization. A higher value results in a higher optimization cost penalty for violating a time window of a node.
`JOptWeight.TimeWindow.AfterEndPillarAnchor`	`1000.0`	`[]`	JOPt weight for preventing elements are place after an endanchor pillar.
`JOptWeight.TimeWindow.FlexTimePenalizeFactor`	`0.0`	`[]`	FlexTimePenalizeFactor during the optimization. Flex time will get penalized to motivate the Optimizer to start the route close to the official working hours start
`JOptWeight.TimeWindow.OfferedNodeCostMulitplier`	`2.0`	`[]`	JOPt global OfferedNodeCostMulitplier for TimeWindows. If an offered node's timewindow is violated the usual optimization cost is multiplied by this multiplier.
`JOptWeight.TimeWindow.ServiceHours`	`10.0`	`[]`	JOPt weight for meeting 'ServiceHours' during the optimization.
`JOptWeight.TimeWindow.TimeWindowEarlyFactor`	`10.0`	`[]`	JOPt weight for 'TimeWindowEarlyFactor' during the optimization. If a resource is early at a node (creating idle time) an optimzation cost is assgined taking this value as cost multiplier.
`JOptWeight.TimeWindow.TimeWindowEarlyFactorAtFirstNode`	`1.0`	`[]`	JOPt weight for 'TimeWindowEarlyFactorAtFirstNode' during the optimization.
`JOptWeight.TimeWindow.TimeWindowLateFactor`	`100.0`	`[]`	JOPt weight for 'TimeWindowLateFactor' during the optimization.
`JOptWeight.TotalDistance`	`1.0`	`[]`	JOPt weight for 'TotalDistance' during the optimization.
`JOptWeight.TotalTime`	`1.0`	`[]`	JOPt weight for 'TotalTime' during the optimization.
`JOptWeight.UnPreferableResource`	`1.0`	`[]`	JOPt weight for 'UnPreferableResource' during the optimization.
`JOptWeight.UselessUnloadAllVisitation`	`1.0`	`[]`	JOPt weight for 'UselessUnloadAllVisitation' during the optimization.
`JOptWeight.WorkingTime`	`5.0`	`[]`	JOPt weight for 'WorkingTime' during the optimization.
`JOptWeight.ZoneCode`	`10.0`	`[]`	JOPt weight for 'ZoneCode' during the optimization. A higher value results in a higher optimization cost penalty for violating a ZoneCode of a node.

Authors

Open Assessor

Overnight Stay