FlexMeasures / flexmeasures / 30217343487

83%

Build Type

push

github

Committed by web-flow

Commit Message

Confine device power to operation-mode power bands (#2278)

* feat: confine device power to operation-mode power bands (#2113)

New storage flex-model field "operation-modes" (S2 terminology): a list of
signed power ranges; the device must operate within one of them at every time
step. Adds one binary per device per band per time step to the device
scheduler, so devices that cannot modulate below a minimum power (or are
strictly on/off) no longer receive fractional schedules that their control
layer must round up, overshooting site capacity limits.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* docs: document the operation-modes storage flex-model field

Adds the field to the storage flex-model table (via a new OPERATION_MODES
MetaData entry, which the schema now also uses for its API docs), including
the sign convention, an on/off device example, the MILP note, and a reference
to the S2 standard's FRBC OperationMode concept. Also adds a changelog entry.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Address review: sign-explicit operation-mode ranges

Replace the single signed `power-range` on an operation mode with explicit
`consumption-range` (positive = consumption) and/or `production-range`
(positive = production). A mode may use either or both; combining both (each
starting at 0) forms one band through zero. Document that the S2 power-range
maps to the FM consumption-range (S2 fixes one sign convention; FM leaves it
to the user). Also update the changelog reference to PR #2278.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016MLCUiSdXDqDBmg8GbYp1B
Signed-off-by: F.N. Claessen <claessen@seita.nl>

* tests: cover StorageScheduler-level operation-modes wiring

Add integration-level tests that exercise StorageScheduler.compute()
end-to-end with "operation-modes" set in the flex-model, so that a
regression severing the plumbing that reads operation-modes and passes
devi... (continued)

Coverage Stats

54 of 61 new or added lines in 6 files covered. (88.52%)

170 existing lines in 5 files now uncovered.

15945 of 19229 relevant lines covered (82.92%)

0.83 hits per line