gtopt/volume_right.hpp file

Volume-based water right (derechos de volumen)

Defines the VolumeRight structure representing a volume-based water right. This is an accounting entity — it tracks accumulated right volumes (hm³) like Tilmant's "dummy reservoir" for SDDP state coupling, but it is NOT part of the hydrological topology: it does not connect to junctions or participate in the physical water mass balance.

The right references a physical reservoir from which the right is sourced, but the coupling to the physical hydro system is handled through separate constraints, not through the junction balance.

A purpose field indicates the right's use case (irrigation, generation, environmental, etc.) — all share the same LP structure.

Unit conventions

  • Volume fields (emin, emax, eini, efin, demand): hm³
  • Flow fields (max_rate): m³/s
  • Cost fields (fail_cost): $/hm³
  • flow_conversion_rate = 0.0036 converts m³/s × h → hm³

JSON Example

{
  "uid": 1,
  "name": "laja_irrigation_vol",
  "purpose": "irrigation",
  "reservoir": "laguna_laja",
  "demand": [0, 0, 0, 0, 100, 200, 300, 300, 200, 100, 50, 0],
  "fail_cost": 5000,
  "emax": 500
}

Namespaces

namespace gtopt

Classes

struct gtopt::VolumeRight
Volume-based water right (derechos de volumen)