odys.optimization.formulations.fixed_load¶

class FixedLoadFormulation(Formulation):
    """Fixed loads: inelastic demand that must be met, with no decision variables or constraints."""

    dimension = FIXED_LOAD
    entity_type = FixedLoad

    def __init__(self, fixed_loads: Sequence[FixedLoad], context: ModelContext) -> None:
        """Initialize with the fixed loads of the system.

        Args:
            fixed_loads: The fixed loads, at least one.
            context: The shared indexing of the problem.
        """
        super().__init__(fixed_loads, context)
        self.demand = context.profiles(LoadProfile, fixed_loads, self.coordinates, lambda profile: profile.values)

    @classmethod
    def build(cls, inputs: FormulationInputs) -> Self | None:
        """Return the formulation of the fixed loads, or None if there are none."""
        fixed_loads = inputs.of_type(FixedLoad)
        return cls(fixed_loads, inputs.context) if fixed_loads else None

    def power_injection(self) -> xr.DataArray:
        """Return minus the total fixed-load demand, per scenario and time."""
        injection: xr.DataArray = -self.demand.sum(FIXED_LOAD)
        return injection

    def dispatch(self, solution: xr.Dataset) -> None:
        """Return None: fixed loads have no decision variables, so no dispatch results."""