Merge pull request #1018 from EnergySystemsModellingLab/fix-availability-constraints-v2

Rework activity limits code (v2)

Author: tsmbland

examples/circularity/process_availabilities.csv

@@ -1,34 +1,24 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-GASDRV,all,all,annual,up,0.9
-OAGRSV,all,all,annual,up,0.9
-GASPRC,all,all,annual,up,0.9
-OILREF,all,all,annual,up,0.9
-OILRF2,all,all,annual,up,0.9
-GASCGT,all,all,annual,up,0.9
-TPETCR,all,all,annual,up,1
-TDIECR,all,all,annual,up,1
-TELCCR,all,all,annual,up,1
-THYBCR,all,all,annual,up,1
-RGASBR,all,all,annual,up,1
-RELCHP,all,all,annual,up,1
-WNDFRM,all,all,winter.night,up,0.486418015
-WNDFRM,all,all,winter.day,up,0.543166784
-WNDFRM,all,all,winter.peak,up,0.504433498
-WNDFRM,all,all,winter.evening,up,0.493173821
-WNDFRM,all,all,peak.night,up,0.312697296
-WNDFRM,all,all,peak.day,up,0.489120338
-WNDFRM,all,all,peak.peak,up,0.454890922
-WNDFRM,all,all,peak.evening,up,0.331034483
-WNDFRM,all,all,summer.night,up,0.17951141
-WNDFRM,all,all,summer.day,up,0.349950739
-WNDFRM,all,all,summer.peak,up,0.342294159
-WNDFRM,all,all,summer.evening,up,0.202674173
-WNDFRM,all,all,autumn.night,up,0.3513019
-WNDFRM,all,all,autumn.day,up,0.460745954
-WNDFRM,all,all,autumn.peak,up,0.396340605
-WNDFRM,all,all,autumn.evening,up,0.364813512
-H2YGEN,all,all,annual,up,1
-H2YPRO,all,all,annual,up,1
-BIOPRO,all,all,annual,up,1.0
-BIOPLL,all,all,annual,up,0.95
-RBIOBL,all,all,annual,up,1.0
+process_id,regions,commission_years,time_slice,limits
+GASDRV,all,all,annual,..0.9
+OAGRSV,all,all,annual,..0.9
+GASPRC,all,all,annual,..0.9
+OILREF,all,all,annual,..0.9
+OILRF2,all,all,annual,..0.9
+GASCGT,all,all,annual,..0.9
+WNDFRM,all,all,winter.night,..0.486418015
+WNDFRM,all,all,winter.day,..0.543166784
+WNDFRM,all,all,winter.peak,..0.504433498
+WNDFRM,all,all,winter.evening,..0.493173821
+WNDFRM,all,all,peak.night,..0.312697296
+WNDFRM,all,all,peak.day,..0.489120338
+WNDFRM,all,all,peak.peak,..0.454890922
+WNDFRM,all,all,peak.evening,..0.331034483
+WNDFRM,all,all,summer.night,..0.17951141
+WNDFRM,all,all,summer.day,..0.349950739
+WNDFRM,all,all,summer.peak,..0.342294159
+WNDFRM,all,all,summer.evening,..0.202674173
+WNDFRM,all,all,autumn.night,..0.3513019
+WNDFRM,all,all,autumn.day,..0.460745954
+WNDFRM,all,all,autumn.peak,..0.396340605
+WNDFRM,all,all,autumn.evening,..0.364813512
+BIOPLL,all,all,annual,..0.95

examples/missing_commodity/process_availabilities.csv

@@ -1,25 +1,21 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-GASDRV,all,all,annual,up,0.9
-GASPRC,all,all,annual,up,0.9
-BIOPRO,all,all,annual,up,1.0
-BIOPLL,all,all,annual,up,0.95
-GASCGT,all,all,annual,up,0.9
-RGASBR,all,all,annual,up,1.0
-RELCHP,all,all,annual,up,1.0
-RBIOBL,all,all,annual,up,1.0
-WNDFRM,all,all,winter.night,up,0.486418015
-WNDFRM,all,all,winter.day,up,0.543166784
-WNDFRM,all,all,winter.peak,up,0.504433498
-WNDFRM,all,all,winter.evening,up,0.493173821
-WNDFRM,all,all,peak.night,up,0.312697296
-WNDFRM,all,all,peak.day,up,0.489120338
-WNDFRM,all,all,peak.peak,up,0.454890922
-WNDFRM,all,all,peak.evening,up,0.331034483
-WNDFRM,all,all,summer.night,up,0.17951141
-WNDFRM,all,all,summer.day,up,0.349950739
-WNDFRM,all,all,summer.peak,up,0.342294159
-WNDFRM,all,all,summer.evening,up,0.202674173
-WNDFRM,all,all,autumn.night,up,0.3513019
-WNDFRM,all,all,autumn.day,up,0.460745954
-WNDFRM,all,all,autumn.peak,up,0.396340605
-WNDFRM,all,all,autumn.evening,up,0.364813512
+process_id,regions,commission_years,time_slice,limits
+GASDRV,all,all,annual,..0.9
+GASPRC,all,all,annual,..0.9
+BIOPLL,all,all,annual,..0.95
+GASCGT,all,all,annual,..0.9
+WNDFRM,all,all,winter.night,..0.486418015
+WNDFRM,all,all,winter.day,..0.543166784
+WNDFRM,all,all,winter.peak,..0.504433498
+WNDFRM,all,all,winter.evening,..0.493173821
+WNDFRM,all,all,peak.night,..0.312697296
+WNDFRM,all,all,peak.day,..0.489120338
+WNDFRM,all,all,peak.peak,..0.454890922
+WNDFRM,all,all,peak.evening,..0.331034483
+WNDFRM,all,all,summer.night,..0.17951141
+WNDFRM,all,all,summer.day,..0.349950739
+WNDFRM,all,all,summer.peak,..0.342294159
+WNDFRM,all,all,summer.evening,..0.202674173
+WNDFRM,all,all,autumn.night,..0.3513019
+WNDFRM,all,all,autumn.day,..0.460745954
+WNDFRM,all,all,autumn.peak,..0.396340605
+WNDFRM,all,all,autumn.evening,..0.364813512

examples/muse1_default/process_availabilities.csv

@@ -1,6 +1,4 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-gassupply1,R1,all,annual,up,0.9
-gasCCGT,R1,all,annual,up,0.9
-windturbine,R1,all,annual,up,0.4
-gasboiler,R1,all,annual,up,1.0
-heatpump,R1,all,annual,up,1.0
+process_id,regions,commission_years,time_slice,limits
+gassupply1,R1,all,annual,..0.9
+gasCCGT,R1,all,annual,..0.9
+windturbine,R1,all,annual,..0.4

examples/simple/process_availabilities.csv

@@ -1,22 +1,20 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-GASDRV,all,all,annual,up,0.9
-GASPRC,all,all,annual,up,0.9
-GASCGT,all,all,annual,up,0.9
-RGASBR,all,all,annual,up,1.0
-RELCHP,all,all,annual,up,1.0
-WNDFRM,all,all,winter.night,up,0.486418015
-WNDFRM,all,all,winter.day,up,0.543166784
-WNDFRM,all,all,winter.peak,up,0.504433498
-WNDFRM,all,all,winter.evening,up,0.493173821
-WNDFRM,all,all,peak.night,up,0.312697296
-WNDFRM,all,all,peak.day,up,0.489120338
-WNDFRM,all,all,peak.peak,up,0.454890922
-WNDFRM,all,all,peak.evening,up,0.331034483
-WNDFRM,all,all,summer.night,up,0.17951141
-WNDFRM,all,all,summer.day,up,0.349950739
-WNDFRM,all,all,summer.peak,up,0.342294159
-WNDFRM,all,all,summer.evening,up,0.202674173
-WNDFRM,all,all,autumn.night,up,0.3513019
-WNDFRM,all,all,autumn.day,up,0.460745954
-WNDFRM,all,all,autumn.peak,up,0.396340605
-WNDFRM,all,all,autumn.evening,up,0.364813512
+process_id,regions,commission_years,time_slice,limits
+GASDRV,all,all,annual,..0.9
+GASPRC,all,all,annual,..0.9
+GASCGT,all,all,annual,..0.9
+WNDFRM,all,all,winter.night,..0.486418015
+WNDFRM,all,all,winter.day,..0.543166784
+WNDFRM,all,all,winter.peak,..0.504433498
+WNDFRM,all,all,winter.evening,..0.493173821
+WNDFRM,all,all,peak.night,..0.312697296
+WNDFRM,all,all,peak.day,..0.489120338
+WNDFRM,all,all,peak.peak,..0.454890922
+WNDFRM,all,all,peak.evening,..0.331034483
+WNDFRM,all,all,summer.night,..0.17951141
+WNDFRM,all,all,summer.day,..0.349950739
+WNDFRM,all,all,summer.peak,..0.342294159
+WNDFRM,all,all,summer.evening,..0.202674173
+WNDFRM,all,all,autumn.night,..0.3513019
+WNDFRM,all,all,autumn.day,..0.460745954
+WNDFRM,all,all,autumn.peak,..0.396340605
+WNDFRM,all,all,autumn.evening,..0.364813512

examples/two_outputs/process_availabilities.csv

@@ -1,32 +1,24 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-GASDRV,all,all,annual,up,0.9
-OAGRSV,all,all,annual,up,0.9
-GASPRC,all,all,annual,up,0.9
-OILREF,all,all,annual,up,0.9
-OILRF2,all,all,annual,up,0.9
-GASCGT,all,all,annual,up,0.9
-TPETCR,all,all,annual,up,1
-TDIECR,all,all,annual,up,1
-TELCCR,all,all,annual,up,1
-THYBCR,all,all,annual,up,1
-RGASBR,all,all,annual,up,1
-RELCHP,all,all,annual,up,1
-WNDFRM,all,all,winter.night,up,0.486418015
-WNDFRM,all,all,winter.day,up,0.543166784
-WNDFRM,all,all,winter.peak,up,0.504433498
-WNDFRM,all,all,winter.evening,up,0.493173821
-WNDFRM,all,all,peak.night,up,0.312697296
-WNDFRM,all,all,peak.day,up,0.489120338
-WNDFRM,all,all,peak.peak,up,0.454890922
-WNDFRM,all,all,peak.evening,up,0.331034483
-WNDFRM,all,all,summer.night,up,0.17951141
-WNDFRM,all,all,summer.day,up,0.349950739
-WNDFRM,all,all,summer.peak,up,0.342294159
-WNDFRM,all,all,summer.evening,up,0.202674173
-WNDFRM,all,all,autumn.night,up,0.3513019
-WNDFRM,all,all,autumn.day,up,0.460745954
-WNDFRM,all,all,autumn.peak,up,0.396340605
-WNDFRM,all,all,autumn.evening,up,0.364813512
-BIOPRO,all,all,annual,up,1.0
-BIOPLL,all,all,annual,up,0.95
-RBIOBL,all,all,annual,up,1.0
+process_id,regions,commission_years,time_slice,limits
+GASDRV,all,all,annual,..0.9
+OAGRSV,all,all,annual,..0.9
+GASPRC,all,all,annual,..0.9
+OILREF,all,all,annual,..0.9
+OILRF2,all,all,annual,..0.9
+GASCGT,all,all,annual,..0.9
+WNDFRM,all,all,winter.night,..0.486418015
+WNDFRM,all,all,winter.day,..0.543166784
+WNDFRM,all,all,winter.peak,..0.504433498
+WNDFRM,all,all,winter.evening,..0.493173821
+WNDFRM,all,all,peak.night,..0.312697296
+WNDFRM,all,all,peak.day,..0.489120338
+WNDFRM,all,all,peak.peak,..0.454890922
+WNDFRM,all,all,peak.evening,..0.331034483
+WNDFRM,all,all,summer.night,..0.17951141
+WNDFRM,all,all,summer.day,..0.349950739
+WNDFRM,all,all,summer.peak,..0.342294159
+WNDFRM,all,all,summer.evening,..0.202674173
+WNDFRM,all,all,autumn.night,..0.3513019
+WNDFRM,all,all,autumn.day,..0.460745954
+WNDFRM,all,all,autumn.peak,..0.396340605
+WNDFRM,all,all,autumn.evening,..0.364813512
+BIOPLL,all,all,annual,..0.95

examples/two_regions/process_availabilities.csv

@@ -1,6 +1,4 @@
-process_id,regions,commission_years,time_slice,limit_type,value
-gassupply1,R1;R2,all,annual,up,0.9
-gasCCGT,R1;R2,all,annual,up,0.9
-windturbine,R1;R2,all,annual,up,0.4
-gasboiler,R1;R2,all,annual,up,1.0
-heatpump,R1;R2,all,annual,up,1.0
+process_id,regions,commission_years,time_slice,limits
+gassupply1,R1;R2,all,annual,..0.9
+gasCCGT,R1;R2,all,annual,..0.9
+windturbine,R1;R2,all,annual,..0.4

schemas/input/process_availabilities.yaml

@@ -1,10 +1,15 @@
 $schema: https://specs.frictionlessdata.io/schemas/table-schema.json
 description: |
-  Defines how much of a process's capacity is available throughout the year.
+  Defines constraints on process availabilities throughout the year.
 
 notes:
-  - Must be provided for every process.
-  - Only one type of limit can be supplied for each combination of process/region/year/time slice.
+  - Limits can be combined across multiple time periods. For example, users could provide a limit
+    of "..0.9" for "winter.day" and "..0.5" for "winter", indicating that the activity can reach
+    up to 90% during winter days, so long as activity does not exceed 50% across winter as a whole.
+  - Incompatible limits will be flagged at the input validation stage. For example, a limit of
+    "..0.01" for "winter" would likely be incompatible with a limit of "0.9.." for "winter.day".
+  - If a limit is provided for any time slice (or season) for a particular process/region/year, it
+    must be provided for all time slices (or seasons).
 
 fields:
   - name: process_id
@@ -25,15 +30,13 @@ fields:
     type: string
     description: The time slices(s) to which this entry applies
     notes: |
-      Can be a single time slice (e.g. `winter.day`), a whole season (e.g. `winter`) or `annual`,
-      representing the whole year
-  - name: limit_type
+      Can be a single time slice (e.g. `winter.day`), a season (e.g. `winter`) or `annual`. If a
+      season or `annual`, this means that limit will apply to the season/year as a whole.
+  - name: limits
     type: string
-    description: The type of limit
-    notes: |
-      Can be `lo` (a lower bound), `up` (an upper bound) or `fx` (indicating that the availability
-      is constant)
-  - name: value
-    type: number
-    description: The proportion of capacity which is available
-    notes: Must be >0 and <=1
+    description: Lower and upper limits on the availability of the process within the specified time slice(s)
+    notes:
+      A string in the format `min..max`, where `min` and `max` are decimal numbers between 0 and 1
+      inclusive (e.g. "0.2..0.9"). 0 represents no availability, and 1 represents full availability.
+      Either `min` or `max` can be omitted (e.g "0.2.." or "..0.9"), which will set the
+      corresponding limit to 0 or 1, respectively.