Network settings to apply to the base network (i.e., all multinetwork timesteps, not a specific one), such as bus voltage bounds, load priorities, cold load pickup, and global settings such as maximum switch actions per timestep and time elapsed per time step.
Additional properties on each object are allowed, but the object types are restricted to those in the ONM model.
No Additional Properties{
"switch_close_actions_ub": [
1,
1,
1
],
"time_elapsed": [
0.1667,
0.1667,
0.1667
],
"load": {
"671": {
"clpu_factor": 2
}
}
}
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
generator objects indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
generator object
real power lower bounds in kW
No Additional Itemsreal power upper bounds in kW
No Additional Itemsreal power setpoint in kW
No Additional ItemsReactive power lower bounds in kVar
No Additional ItemsReactive power upper bounds in kVar
No Additional ItemsReactive power setpoint in kVar
No Additional ItemsThe control mode, i.e. FREQUENCYDROOP
(grid-following) or ISOCHRONOUS
(grid-forming)
The status of the generation object, i.e. enabled (1
) or disabled (0
)
Cost model polynomial or piecewise parameters
No Additional ItemsCost model type, 1 = piecewise-linear, 2 = polynomial
pv solar objects, indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
pv solar object
real power lower bounds in kW
No Additional Itemsreal power upper bounds in kW
No Additional Itemsreal power setpoint in kW
No Additional ItemsReactive power lower bounds in kVar
No Additional ItemsReactive power upper bounds in kVar
No Additional ItemsReactive power setpoint in kVar
No Additional ItemsThe control mode, i.e. FREQUENCYDROOP
(grid-following) or ISOCHRONOUS
(grid-forming)
The status of the generation object, i.e. enabled (1
) or disabled (0
)
Cost model polynomial or piecewise parameters
No Additional ItemsCost model type, 1 = piecewise-linear, 2 = polynomial
voltage source objects, indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
voltage source object
real power lower bounds in kW
No Additional Itemsreal power upper bounds in kW
No Additional Itemsreal power setpoint in kW
No Additional ItemsReactive power lower bounds in kVar
No Additional ItemsReactive power upper bounds in kVar
No Additional ItemsReactive power setpoint in kVar
No Additional ItemsThe control mode, i.e. FREQUENCYDROOP
(grid-following) or ISOCHRONOUS
(grid-forming)
The status of the generation object, i.e. enabled (1
) or disabled (0
)
Cost model polynomial or piecewise parameters
No Additional ItemsCost model type, 1 = piecewise-linear, 2 = polynomial
energy storage objects indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
energy storage object
upper bound of energy that can be stored in kWhrs
upper bound of energy that can be inserted into the battery kW
upper bound of energy that can be withdrawn from the battery in kW
upper bound on the power in or out of the battery
currently stored energy in the battery in kWh
lower bound of reactive power that can be outputted in kvar
upper bound of reactive power that can be outputted in kvar
real power losses
reactive power losses
the status of the asset, i.e. enabled (1
) or disabled (0
)
Percent within which power input/output must be on between phases on the storage object
bus objects indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
bus object
identifier for which microgrid the bus belongs
the voltage magnitude lower bounds in volts
No Additional Itemsthe voltage magnitude upper bounds in volts
No Additional Itemsthe voltage magnitude setpoint of the bus, useful in cases where the bus should act as a reference, e.g., because a grid-forming inverter is connected
No Additional Itemsthe voltage angle setpoint of the bus, useful in cases where the bus should act as a reference, e.g., because a grid-forming inverter is connected
No Additional Itemsthe status of the asset, i.e. enabled (1
) or disabled (0
)
load objects indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
load object
cold load pickup factor
cold load pickup duration in ms
Indicator for whether the load is individually dispatchable (i.e., can the load be shed autonomously, as opposed to only be sheddable via block isolation)
the status of the asset, i.e. enabled (1
) or disabled (0
)
The priority of the load, i.e. a numerical value to indicate how important it is that the load not be shed
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
line objects indexed by name
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
line object
voltage angle different lower bound in degrees
No Additional Itemsvoltage angle difference upper bound in degrees
No Additional Itemsupper bounds on line currents in Amps
No Additional Itemsthe status of the asset, i.e. enabled (1
) or disabled (0
)
switch objects indexed by
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
switch object
The default state of the switch, i.e., open
or closed
is the switch autonomously operable by the ONM algorithm, i.e., yes (1
) or no (2
)
the status of the asset, i.e. enabled (1
) or disabled (0
)
current magnitude upper bound (normamps)
No Additional ItemsAll properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
Flag to relax an integer (binary) variables to be continuous
Flag to disable the upper bounds on voltage. Voltage magnitudes will still have a lower bound of 0.0
Flag to disable bounds on line (branch) power variables
Flag to disable bounds on line (branch) current variables
Flag to disable bounds on switch power variables
Flag to disable bounds on transformer power variables
Flag to disable bounds on gen (generator, solar, voltage_source) power variables
Flag to disable bounds on storage variables, including power, charge, discharge, and energy
Flag to disable the grid-forming inverter constraint, which enforces that there be exactly one grid-forming inverter in each energized connected component
Flag to disable the block isolation constraint, which requires that switches between load blocks of differing status be open
Flag to disable the radiality constraint, which requires that each energized connected component be radial in its topology (no cycles)
Flag to disable microgrid networking. When enabled, microgrids are allowed to expand (pick up load), but may not network with one another
Flag to disable current limit constraints (ampacity) on lines and switches
Flag to disable thermal limit constraints (power) on lines, switches, and energy storage
Flag to disable the switch close-action limit, which limits the number of closing actions that may occur in a timestep
Flag to disable the storage unbalance constraint, which requires that grid-following storage devices output power within some factor of one another
Flag to disable microgrid expansion. When enabled, would prevent microgrids from growing any larger, but not prevent switching actions within the boundary of a microgrid
Flag to enable a constraint that requires that load restoration be strictly increasing, that is, load blocks once energized cannot be de-energized in a later timestep
Flag to disable a constraint that encourages voltages on either side of OPEN switches remain with some distance of each other
Flag to toggle between cuts specific for load block modeling or not
Flag to disable the cost term in the objective function related to change of state in switches (open-close, close-open)
Flag to enable the cost term that adds a cost for open switches based on how much load is between them and some source of energy
Flag to disable the generation cost term
Flag to disable the storage discharge cost term, which adds a penalty for storage that is not completely charged to its upper bound
Flag to disable the weight terms on the load-block cost term (i.e., make the cost of every shed load block be equal)
Flag to disable the cost of not energizing load blocks
Flag to disable the inclusion of voltage distance slack variables in the objective_mc_min_storage_utilization
objective function
Choice for operations optimization algorithm, 'rolling-horizon' or 'full-lookahead'
Choice for operations optimization formulation
Choice for operations optimization problem type, 'block' or 'traditional'
Choice for operations optimization solver
Choice for dispatch optimizatioin formulation
Choice for dispatch optimization solver
Choice for fault studies optimization solver
Choice for stability analysis optimization solver
Choice for stability analysis formulation
Flag to run the fault studies concurrently (in parallel, using Distributed)
Flag to run the stability studies concurrently (in parallel, using Distributed)
List of optimizations or studies to skip, when running using entrypoint
function
Setting to adjust the console log-level
Flag to enable 'pretty printing' of JSON output
Flag to disable the create of sparse fault studies (if no faults are specified, one of every type will be applied at every bus
Flag to enable debugging outputs (the full data structure), when used with entrypoint
Solver options
These are the options used for the HiGHS optimization solver. The options below are a set of sane defaults for this solver, but users are not restricted to these options, and may use any valid options for this solver
These are the options used for the Ipopt optimization solver. The options below are a set of sane defaults for this solver, but users are not restricted to these options, and may use any valid options for this solver
These are the options used for the Juniper optimization solver. The options below are a set of sane defaults for this solver, but users are not restricted to these options, and may use any valid options for this solver
These are the options used for the Gurobi optimization solver. The options below are a set of sane defaults for this solver, but users are not restricted to these options, and may use any valid options for this solver
Value must be greater or equal to -1
and lesser or equal to 1
Value must be greater or equal to -1
and lesser or equal to 2
These are the options used for the KNITRO optimization solver. The options below are a set of sane defaults for this solver, but users are not restricted to these options, and may use any valid options for this solver
Value must be greater or equal to 0
and lesser or equal to 6
Value must be greater or equal to 0
and lesser or equal to 3
Flag to enable the usage of the Gurobi commercial solver
Flag to enable the usage of the KNITRO commercial solver
All properties whose name matches the following regular expression must respect the following conditions
Property name regular expression:^.+$
deprecated: options/data/switch-close-actions-ub
No Additional Itemsdeprecated: options/constraints/disable-microgrid-networking
deprecated: options/constraints/disable-radiality-constraint
deprecated: options/constraints/disable-block-isolation-constraint
deprecated: options/constraints/disable-grid-forming-inverter-constraint
deprecated: options/objective/disable-switch-state-change-cost
deprecated: options/objective/enable-switch-state-open-cost
deprecated: {solvers/HiGHS/presolve,solvers/Gurobi/Presolve,solvers/KNITRO/presolve}
deprecated: options/data/time-elapsed
No Additional Itemsdeprecated: {solvers/Ipopt/tol,solvers/KNITRO/feastol}
deprecated: {solvers/HiGHS/primalfeasibilitytolerance,solvers/HiGHS/dualfeasibilitytolerance,solvers/Gurobi/FeasibilityTol,solvers/Juniper/atol}
deprecated: {solvers/HiGHS/miprelgap,solvers/Gurobi/MIPGap,solvers/Juniper/mip_gap}
Value must be strictly greater than 0