setObject
The set object configures global properties within Spiral during scheduling. It can be issued at various stages, though scheduling constraints apply once optimisation has begun.
{
"time": <integer>,
"costSensitivity": <real>,
"staticStart": <bool>,
"staticGears": <bool>,
"debug": <integer>,
"licence": <string> | null,
"testMode": <bool>,
"simulation": <bool>,
"fragile": <bool>,
"schedule": <bool>,
"gear": <integer>,
"hostMode": SEQUENCE | TIMES,
"ignore": { "<objectType>": [string] },
}
-
timeinteger - Set the internal UTC clock from a Unix timestamp (test scenarios).
-
costSensitivityrealdefault0.01 - Minimum value-gain threshold for optimisation.
-
staticStartbooldefaultfalse - Prevent pre-optimisation before the first host change.
-
staticGearsbooldefaultfalse - Disable automated gear changes.
-
clockIntervaltimeIntervaldefault1 s - Lowest granularity of the internal clock.
-
hostClockResolutiontimeIntervaldefault1 min - Schedule time resolution with the host.
-
hostClockSpreadtimeIntervaldefault10 s - Random event distribution period.
-
atResolutiondistancedefault5 km - Location accuracy.
-
debugintegerdefault0 - Diagnostic output level (0–4+).
-
responseLimittimeIntervaldefault2 s - Maximum optimisation response time.
-
licencestring - Licence key.
-
testModebooldefaultfalse - Rapid processing with time adjustment.
-
simulationbooldefaultfalse - Allow workload-scenario modelling.
-
fragilebooldefaultfalse - Halt on warnings during development.
-
schedulebooldefaultfalse - Initiate optimisation (issued once).
-
gearintegerdefault0 - Force a gear level for testing.
-
hostModeSEQUENCE | TIMESdefaultTIMES - Schedule communication style.
-
travelCalculatortravelCalculatorObject - External travel-calculator configuration.
-
ignore{ "<objectType>": [string] } - Attribute names Spiral should ignore (not echo back) per object type — keys are resource, project, desk, stop and responsePoint.