FlexMeasures / flexmeasures / 30712612355

83%

Build Type

push

github

Committed by web-flow

Commit Message

Commitments can be scoped to specific sensors, binding their aggregate flow (#2295)

* feat: commitments can be scoped to specific sensors, binding their aggregate flow

A flex-context commitment gains an optional 'sensors' field: instead of
binding each device of the matching commodity separately, the commitment
binds the aggregate flow of the devices whose power sensors are listed,
as one grouped commitment (device_group machinery). Useful to commit a
band on a subset of devices, e.g. an aFRR upward-regulation band on a
site's e-heaters (aggregate consumption >= band, deviation penalized).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016MLCUiSdXDqDBmg8GbYp1B

* docs: changelog entry for sensor-scoped commitments (#2295)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015qxM7UZ5wHTz3ftz1Mf9yy
Signed-off-by: F.N. Claessen <felix@seita.nl>

* feat: allow scoping a commitment to a group (alongside the sensor list)

Follow-up on #2295. A commitment's scope can now be given as a 'group' reference
(the members of an electrical group, reusing group_to_devices) in addition to the
raw 'sensors' list; at most one of the two (schema-validated). A group scope
includes the group's inflexible members (total node flow), whereas a sensors
scope binds the listed flexible devices only -- documented on the schema field and
the resolver. Also: validate that a scoped set shares one commodity, tag scoped
commitments with provenance='custom' (was missing), and give each a unique
device_group label so same-named commitments never merge.

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

* fix: pin a scoped commitment's commodity to its scoped devices; tests + comment tidy

Addresses Copilot's review on #2295:
- A scoped commitment now takes... (continued)

Coverage Stats

37 of 38 new or added lines in 3 files covered. (97.37%)

128 existing lines in 2 files now uncovered.

16343 of 19620 relevant lines covered (83.3%)

0.83 hits per line