Merge pull request #905 from blue-marble/develop

GridPath v0.13

db/csvs_test_examples/csv_data_master.csv

@@ -23,6 +23,8 @@ project/project_variable_om_curves,data_dependent,variable_om_curves_scenario_id
 project/project_startup_chars,data_dependent,startup_chars_scenario_id,project_startup_chars,simple,,1,0,,,inputs_project_operational_chars,project_operational_chars_scenario_id
 project/project_hydro_operational_chars,data_dependent,hydro_operational_chars_scenario_id,project_hydro_operational_chars,simple,,1,0,,,inputs_project_operational_chars,project_operational_chars_scenario_id
 project/project_variable_generator_profiles,data_dependent,variable_generator_profile_scenario_id,project_variable_generator_profiles,simple,,1,0,,,inputs_project_operational_chars,project_operational_chars_scenario_id
+project/project_cycle_selection,data_dependent,cycle_selection_scenario_id,project_cycle_selection,simple,,1,0,,,inputs_project_operational_chars,project_operational_chars_scenario_id
+project/project_cap_factor_limits,data_dependent,cap_factor_limits_scenario_id,project_cap_factor_limits,simple,,1,0,,,inputs_project_operational_chars,project_operational_chars_scenario_id
 project/project_operational_chars,core,project_operational_chars_scenario_id,project_operational_chars,simple,,0,0,,,,
 ,data_dependent,supply_curve_scenario_id,project_shiftable_load_supply_curve,simple,,0,0,,,,
 project/project_availability/project_availability_types,data_dependent,project_availability_scenario_id,project_availability,simple,,0,0,,,,
@@ -39,38 +41,45 @@ transmission/availability,transmission,transmission_availability_scenario_id,tra
 transmission/availability/exogenous,transmission,exogenous_availability_scenario_id,transmission_availability_exogenous,simple,,1,1,,,inputs_transmission_availability,transmission_availability_scenario_id
 transmission/transmission_hurdle_rates,transmission_hurdle_rates,transmission_hurdle_rate_scenario_id,transmission_hurdle_rates,simple,,0,0,,,,
 transmission/transmission_new_potential,transmission,transmission_new_potential_scenario_id,transmission_new_potential,simple,,0,0,,,,
+transmission/transmission_flow,transmission,transmission_flow_scenario_id,transmission_flow,simple,,0,0,,,,
 transmission/simultaneous_flow_limits/limits,simultaneous_flow_limits,transmission_simultaneous_flow_limit_scenario_id,transmission_simultaneous_flow_limits,simple,,0,0,,,,
 transmission/simultaneous_flow_limits/line_groups,simultaneous_flow_limits,transmission_simultaneous_flow_limit_line_group_scenario_id,transmission_simultaneous_flow_limit_line_groups,simple,,0,0,,,,
 reserves/lf_reserves_up/geography_lf_reserves_up_bas,lf_reserves_up,lf_reserves_up_ba_scenario_id,geography_lf_reserves_up_bas,simple,,0,0,,,,
 reserves/lf_reserves_up/project_lf_reserves_up_bas,lf_reserves_up,project_lf_reserves_up_ba_scenario_id,project_lf_reserves_up_bas,simple,,0,0,,,,
 reserves/lf_reserves_up/req,lf_reserves_up,lf_reserves_up_scenario_id,system_lf_reserves_up,dir_main,,0,0,timepoint.csv,,,
 reserves/lf_reserves_up/req,lf_reserves_up,lf_reserves_up_scenario_id,system_lf_reserves_up_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/lf_reserves_up/req,lf_reserves_up,lf_reserves_up_scenario_id,system_lf_reserves_up_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/lf_reserves_up/req,lf_reserves_up,lf_reserves_up_scenario_id,system_lf_reserves_up_project,dir_aux,,0,0,project.csv,,,
 reserves/lf_reserves_down/geography_lf_reserves_down_bas,lf_reserves_down,lf_reserves_down_ba_scenario_id,geography_lf_reserves_down_bas,simple,,0,0,,,,
 reserves/lf_reserves_down/project_lf_reserves_down_bas,lf_reserves_down,project_lf_reserves_down_ba_scenario_id,project_lf_reserves_down_bas,simple,,0,0,,,,
 reserves/lf_reserves_down/req,lf_reserves_down,lf_reserves_down_scenario_id,system_lf_reserves_down,dir_main,,0,0,timepoint.csv,,,
 reserves/lf_reserves_down/req,lf_reserves_down,lf_reserves_down_scenario_id,system_lf_reserves_down_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/lf_reserves_down/req,lf_reserves_down,lf_reserves_down_scenario_id,system_lf_reserves_down_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/lf_reserves_down/req,lf_reserves_down,lf_reserves_down_scenario_id,system_lf_reserves_down_project,dir_aux,,0,0,project.csv,,,
 reserves/regulation_up/geography_regulation_up_bas,regulation_up,regulation_up_ba_scenario_id,geography_regulation_up_bas,simple,,0,0,,,,
 reserves/regulation_up/project_regulation_up_bas,regulation_up,project_regulation_up_ba_scenario_id,project_regulation_up_bas,simple,,0,0,,,,
 reserves/regulation_up/req,regulation_up,regulation_up_scenario_id,system_regulation_up,dir_main,,0,0,timepoint.csv,,,
 reserves/regulation_up/req,regulation_up,regulation_up_scenario_id,system_regulation_up_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/regulation_up/req,regulation_up,regulation_up_scenario_id,system_regulation_up_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/regulation_up/req,regulation_up,regulation_up_scenario_id,system_regulation_up_project,dir_aux,,0,0,project.csv,,,
 reserves/regulation_down/geography_regulation_down_bas,regulation_down,regulation_down_ba_scenario_id,geography_regulation_down_bas,simple,,0,0,,,,
 reserves/regulation_down/project_regulation_down_bas,regulation_down,project_regulation_down_ba_scenario_id,project_regulation_down_bas,simple,,0,0,,,,
 reserves/regulation_down/req,regulation_down,regulation_down_scenario_id,system_regulation_down,dir_main,,0,0,timepoint.csv,,,
 reserves/regulation_down/req,regulation_down,regulation_down_scenario_id,system_regulation_down_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/regulation_down/req,regulation_down,regulation_down_scenario_id,system_regulation_down_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/regulation_down/req,regulation_down,regulation_down_scenario_id,system_regulation_down_project,dir_aux,,0,0,project.csv,,,
 reserves/frequency_response/geography_frequency_response_bas,frequency_response,frequency_response_ba_scenario_id,geography_frequency_response_bas,simple,,0,0,,,,
 reserves/frequency_response/project_frequency_response_bas,frequency_response,project_frequency_response_ba_scenario_id,project_frequency_response_bas,simple,,0,0,,,,
 reserves/frequency_response/req,frequency_response,frequency_response_scenario_id,system_frequency_response,dir_main,,0,0,timepoint.csv,,,
 reserves/frequency_response/req,frequency_response,frequency_response_scenario_id,system_frequency_response_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/frequency_response/req,frequency_response,frequency_response_scenario_id,system_frequency_response_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/frequency_response/req,frequency_response,frequency_response_scenario_id,system_frequency_response_project,dir_aux,,0,0,project.csv,,,
 reserves/spinning_reserves/geography_spinning_reserves_bas,spinning_reserves,spinning_reserves_ba_scenario_id,geography_spinning_reserves_bas,simple,,0,0,,,,
 reserves/spinning_reserves/project_spinning_reserves_bas,spinning_reserves,project_spinning_reserves_ba_scenario_id,project_spinning_reserves_bas,simple,,0,0,,,,
 reserves/spinning_reserves/req,spinning_reserves,spinning_reserves_scenario_id,system_spinning_reserves,dir_main,,0,0,timepoint.csv,,,
 reserves/spinning_reserves/req,spinning_reserves,spinning_reserves_scenario_id,system_spinning_reserves_percent,dir_aux,,0,0,percentage.csv,,,
 reserves/spinning_reserves/req,spinning_reserves,spinning_reserves_scenario_id,system_spinning_reserves_percent_lz_map,dir_aux,,0,0,percentage_load_zone_map.csv,,,
+reserves/spinning_reserves/req,spinning_reserves,spinning_reserves_scenario_id,system_spinning_reserves_project,dir_aux,,0,0,project.csv,,,
 policy/energy_targets/zones,energy_target,energy_target_zone_scenario_id,geography_energy_target_zones,simple,,0,0,,,,
 policy/energy_targets/project_zones,energy_target,project_energy_target_zone_scenario_id,project_energy_target_zones,simple,,0,0,,,,
 policy/energy_targets/period_targets,energy_target,period_energy_target_scenario_id,system_period_energy_targets,dir_main,,0,0,targets.csv,,,
@@ -85,6 +94,12 @@ policy/carbon_tax/geography_carbon_tax_zones,carbon_tax,carbon_tax_zone_scenario
 policy/carbon_tax/project_carbon_tax_zones,carbon_tax,project_carbon_tax_zone_scenario_id,project_carbon_tax_zones,simple,,0,0,,,,
 policy/carbon_tax/system_carbon_tax,carbon_tax,carbon_tax_scenario_id,system_carbon_tax,simple,,0,0,,,,
 policy/carbon_tax/project_carbon_tax_allowance,carbon_tax,project_carbon_tax_allowance_scenario_id,project_carbon_tax_allowance,simple,,0,0,,,,
+policy/performance_standard/geography_performance_standard_zones,performance_standard,performance_standard_zone_scenario_id,geography_performance_standard_zones,simple,,0,0,,,,
+policy/performance_standard/project_performance_standard_zones,performance_standard,project_performance_standard_zone_scenario_id,project_performance_standard_zones,simple,,0,0,,,,
+policy/performance_standard/system_performance_standard,performance_standard,performance_standard_scenario_id,system_performance_standard,simple,,0,0,,,,
+policy/fuel_burn_limits/bas,fuel_burn_limit,fuel_burn_limit_ba_scenario_id,geography_fuel_burn_limit_balancing_areas,simple,,0,0,,,,
+policy/fuel_burn_limits/project_bas,fuel_burn_limit,project_fuel_burn_limit_ba_scenario_id,project_fuel_burn_limit_balancing_areas,simple,,0,0,,,,
+policy/fuel_burn_limits/limits,fuel_burn_limit,fuel_burn_limit_scenario_id,system_fuel_burn_limits,simple,,0,0,,,,
 reliability/prm/geography_prm_zones,prm,prm_zone_scenario_id,geography_prm_zones,simple,,0,0,,,,
 reliability/prm/project_prm_zones,prm,project_prm_zone_scenario_id,project_prm_zones,simple,,0,0,,,,
 reliability/prm/project_elcc_chars,prm,project_elcc_chars_scenario_id,project_elcc_chars,simple,,0,0,,,,
@@ -102,4 +117,4 @@ reliability/local_capacity/system_local_capacity_requirement,local_capacity,loca
 markets/geography_markets,markets,market_scenario_id,geography_markets,simple,,0,0,,,,
 markets/load_zone_markets,markets,load_zone_market_scenario_id,load_zone_markets,simple,,0,0,,,,
 markets/prices,markets,market_price_scenario_id,market_prices,simple,,0,0,,,,
-markets/volume,markets,market_volume_scenario_id,market_volume,simple,,0,0,,,,
+markets/volume,markets,market_volume_scenario_id,market_volume,simple,,0,0,,,,

db/csvs_test_examples/fuels/fuel_chars/1_base_fuel_chars.csv

@@ -1,6 +1,7 @@
-fuel,co2_intensity_tons_per_mmbtu
-Coal,0.09552
-Gas,0.05306
-Uranium,0
-Cheap_Fuel,0.05306
-Negative_Carbon_Fuel,-0.1
+fuel,co2_intensity_tons_per_mmbtu,fuel_group
+Coal,0.09552,Solid
+Gas,0.05306,Gas
+Uranium,0,Other
+Cheap_Fuel,0.05306,Blended
+Negative_Carbon_Fuel,-0.1,Gas
+Hydrogen,0,

db/csvs_test_examples/fuels/fuel_chars/2_base_fuel_chars_with_different_fuel_groups.csv

@@ -0,0 +1,6 @@
+fuel,co2_intensity_tons_per_mmbtu,fuel_group
+Coal,0.09552,Solid
+Gas,0.05306,Gas
+Uranium,0,Other
+Cheap_Fuel,0.05306,Gas
+Negative_Carbon_Fuel,-0.1,Gas

db/csvs_test_examples/fuels/fuel_prices/1_base_fuel_prices.csv

@@ -19,3 +19,7 @@ Negative_Carbon_Fuel,2020,1,6
 Negative_Carbon_Fuel,2020,2,6
 Negative_Carbon_Fuel,2030,1,6
 Negative_Carbon_Fuel,2030,2,6
+Hydrogen,2020,1,0.1
+Hydrogen,2020,2,0.1
+Hydrogen,2030,1,0.1
+Hydrogen,2030,2,0.1

db/csvs_test_examples/markets/geography_markets/2_two_markets.csv

@@ -0,0 +1,3 @@
+market
+Market_Hub
+Market_Hub2

db/csvs_test_examples/markets/load_zone_markets/1_default_market_participation.csv

@@ -1,2 +1,2 @@
-load_zone,market
-Zone1,Market_Hub
+load_zone,market,final_participation_stage
+Zone1,Market_Hub,

db/csvs_test_examples/markets/load_zone_markets/2_two_markets_different_stages.csv

@@ -0,0 +1,3 @@
+load_zone,market,final_participation_stage
+Zone1,Market_Hub,1
+Zone1,Market_Hub2,2

db/csvs_test_examples/markets/prices/1_base_prices.csv

@@ -1,3 +1,19 @@
-market,timepoint,market_price
-Market_Hub,20200101,10
-Market_Hub,20200102,-10
+market,stage_id,timepoint,market_price
+Market_Hub,1,20200101,10
+Market_Hub,1,20200102,-10
+Market_Hub,1,20200201,10
+Market_Hub,1,20200202,-10
+Market_Hub,1,20200301,10
+Market_Hub,1,20200302,-10
+Market_Hub2,1,20200101,1
+Market_Hub2,1,20200102,2
+Market_Hub2,1,20200201,3
+Market_Hub2,1,20200202,2
+Market_Hub2,1,20200301,1
+Market_Hub2,1,20200302,2
+Market_Hub2,2,20200101,3
+Market_Hub2,2,20200102,2
+Market_Hub2,2,20200201,1
+Market_Hub2,2,20200202,2
+Market_Hub2,2,20200301,3
+Market_Hub2,2,20200302,2

db/csvs_test_examples/markets/volume/1_base_volume.csv

@@ -1,3 +1,19 @@
-market,timepoint,max_market_sales,max_market_purchases
-Market_Hub,20200101,10,5
-Market_Hub,20200102,5,10
+market,stage_id,timepoint,max_market_sales,max_market_purchases
+Market_Hub,1,20200101,10,5
+Market_Hub,1,20200102,5,10
+Market_Hub,1,20200201,10,5
+Market_Hub,1,20200202,5,10
+Market_Hub,1,20200301,10,5
+Market_Hub,1,20200302,5,10
+Market_Hub2,1,20200101,10,5
+Market_Hub2,1,20200102,5,10
+Market_Hub2,1,20200201,10,5
+Market_Hub2,1,20200202,5,10
+Market_Hub2,1,20200301,10,5
+Market_Hub2,1,20200302,5,10
+Market_Hub2,2,20200101,5,5
+Market_Hub2,2,20200102,2,2
+Market_Hub2,2,20200201,5,5
+Market_Hub2,2,20200202,2,2
+Market_Hub2,2,20200301,5,5
+Market_Hub2,2,20200302,2,2

db/csvs_test_examples/policy/carbon_cap/project_carbon_cap_zones/1_project_carbon_cap_zones_1.csv

@@ -3,4 +3,5 @@ Coal,Zone1
 Gas_CCGT,Zone1
 Gas_CT,Zone1
 Gas_CCGT_new,Zone1
-Gas_CT_new,Zone1
+Gas_CT_new,Zone1
+DAC,Zone1

db/csvs_test_examples/policy/carbon_cap/system_carbon_cap_targets/2_no_carbon_allowed.csv

@@ -0,0 +1,3 @@
+carbon_cap_zone,period,subproblem_id,stage_id,carbon_cap
+Zone1,2020,1,1,0
+Zone1,2030,1,1,0

db/csvs_test_examples/policy/carbon_tax/project_carbon_tax_allowance/1_project_carbon_tax_allowance_1.csv

@@ -1,11 +1,13 @@
-project,period,carbon_tax_allowance_tco2_per_mwh
-Coal,2020,10
-Gas_CCGT,2020,5
-Gas_CT,2020,5
-Gas_CCGT_new,2020,5
-Gas_CT_new,2020,5
-Coal,2030,5
-Gas_CCGT,2030,3
-Gas_CT,2030,3
-Gas_CCGT_new,2030,3
-Gas_CT_new,2030,3
+project,period,fuel_group,carbon_tax_allowance_tco2_per_mwh
+Coal,2020,Solid,10
+Gas_CCGT,2020,Gas,5
+Gas_CCGT,2020,Blended,2
+Gas_CT,2020,Gas,5
+Gas_CCGT_new,2020,Gas,5
+Gas_CT_new,2020,Gas,5
+Coal,2030,Solid,5
+Gas_CCGT,2030,Gas,3
+Gas_CCGT,2030,Blended,2
+Gas_CT,2030,Gas,3
+Gas_CCGT_new,2030,Gas,3
+Gas_CT_new,2030,Gas,3

db/csvs_test_examples/policy/fuel_burn_limits/bas/1_base_fuel_burn_bas.csv

@@ -0,0 +1,4 @@
+fuel,fuel_burn_limit_ba,min_allow_violation,min_violation_penalty_per_unit,max_allow_violation,max_violation_penalty_per_unit,relative_max_allow_violation,relative_max_violation_penalty_per_unit
+Gas,Gas_Burn_BA,0,0,0,0,0,0
+Coal,Coal_Burn_BA,0,0,0,0,0,0
+Hydrogen,Hydrogen_Burn_BA,0,0,0,0,0,0

db/csvs_test_examples/policy/fuel_burn_limits/bas/doc.py

@@ -0,0 +1,32 @@
+# Copyright 2016-2022 Blue Marble Analytics LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" balancing_areasIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+
+**Relevant tables:**
+
++-------------------------------+----------------------------------------------------+
+|:code:`scenarios` table column |:code:`fuel_ba_scenario_id`                         |
++-------------------------------+----------------------------------------------------+
+|:code:`scenario` table feature |:code:`of_fuel_burn_limit`                          |
++-------------------------------+----------------------------------------------------+
+|:code:`subscenario_` table     |:code:`subscenarios_geography_fuel_balancing_areas` |
++-------------------------------+----------------------------------------------------+
+|:code:`input_` tables          |:code:`inputs_geography_fuel_balancing_areas`       |
++-------------------------------+----------------------------------------------------+
+
+"""
+
+if __name__ == "__main__":
+    print(__doc__)

db/csvs_test_examples/policy/fuel_burn_limits/limits/1_base_fuel_burn_limits.csv

@@ -0,0 +1,3 @@
+fuel,fuel_burn_limit_ba,subproblem_id,stage_id,balancing_type_horizon,horizon,fuel_burn_min_unit,fuel_burn_max_unit,relative_fuel_burn_max_fuel,relative_fuel_burn_max_ba,fraction_of_relative_fuel_burn_max_fuel_ba
+Gas,Gas_Burn_BA,1,1,day,202001,,5653.976611,,,
+Coal,Coal_Burn_BA,1,1,day,202001,,0,,,

db/csvs_test_examples/policy/fuel_burn_limits/limits/2_coal_as_fraction_of_gas.csv

@@ -0,0 +1,3 @@
+fuel,fuel_burn_limit_ba,subproblem_id,stage_id,balancing_type_horizon,horizon,fuel_burn_min_unit,fuel_burn_max_unit,relative_fuel_burn_max_fuel,relative_fuel_burn_max_ba,fraction_of_relative_fuel_burn_max_fuel_ba
+Gas,Gas_Burn_BA,1,1,day,202001,,5653.976611,,,
+Coal,Coal_Burn_BA,1,1,day,202001,,,Gas,Gas_Burn_BA,0

db/csvs_test_examples/policy/fuel_burn_limits/limits/3_hydrogen_wo_production.csv

@@ -0,0 +1,3 @@
+fuel,fuel_burn_limit_ba,subproblem_id,stage_id,balancing_type_horizon,horizon,fuel_burn_min_unit,fuel_burn_max_unit,relative_fuel_burn_max_fuel,relative_fuel_burn_max_ba,fraction_of_relative_fuel_burn_max_fuel_ba
+Hydrogen,Hydrogen_Burn_BA,1,1,timepoint,20200101,0,0,,,
+Hydrogen,Hydrogen_Burn_BA,1,1,timepoint,20200102,0,0,,,

db/csvs_test_examples/policy/fuel_burn_limits/limits/doc.py

@@ -0,0 +1,35 @@
+# Copyright 2016-2020 Blue Marble Analytics LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+
+**Relevant tables:**
+
++-------------------------------+---------------------------------------------+
+|:code:`scenarios` table column |:code:`fuel_burn_limit_scenario_id`          |
++-------------------------------+---------------------------------------------+
+|:code:`scenario` table feature |:code:`of_fuel_burn_limit`                   |
++-------------------------------+---------------------------------------------+
+|:code:`subscenario_` table     |:code:`subscenarios_system_fuel_burn_limits` |
++-------------------------------+---------------------------------------------+
+|:code:`inputs_` table          |:code:`inputs_system_fuel_burn_limits`       |
++-------------------------------+---------------------------------------------+
+
+"""
+
+# TODO: allow using 0 as to horizon to apply the same limit to all horizon in a
+#  balancing type
+
+if __name__ == "__main__":
+    print(__doc__)

db/csvs_test_examples/policy/fuel_burn_limits/project_bas/1_base_fuel_burn_limit_project_bas.csv

@@ -0,0 +1,8 @@
+project,fuel,fuel_burn_limit_ba
+Coal,Coal,Coal_Burn_BA
+Gas_CCGT,Gas,Gas_Burn_BA
+Gas_CT,Gas,Gas_Burn_BA
+Gas_CCGT_new,Gas,Gas_Burn_BA
+Gas_CT_new,Gas,Gas_Burn_BA
+Hydrogen_Prod,Hydrogen,Hydrogen_Burn_BA
+Hydrogen_Plant,Hydrogen,Hydrogen_Burn_BA

db/csvs_test_examples/policy/fuel_burn_limits/project_bas/doc.py

@@ -0,0 +1,32 @@
+# Copyright 2016-2020 Blue Marble Analytics LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+
+**Relevant tables:**
+
++-------------------------------+-------------------------------------------------------------+
+|:code:`scenarios` table column |:code:`project_fuel_burn_limit_ba_scenario_id`               |
++-------------------------------+-------------------------------------------------------------+
+|:code:`scenario` table feature |:code:`of_fuel_burn_limit`                                   |
++-------------------------------+-------------------------------------------------------------+
+|:code:`subscenario_` table     |:code:`subscenarios_project_fuel_burn_limit_balancing_areas` |
++-------------------------------+-------------------------------------------------------------+
+|:code:`input_` tables          |:code:`inputs_project_fuel_burn_limit_balancing_areas`       |
++-------------------------------+-------------------------------------------------------------+
+
+"""
+
+if __name__ == "__main__":
+    print(__doc__)

db/csvs_test_examples/policy/performance_standard/geography_performance_standard_zones/1_geography_performance_standard_zones_1.csv

@@ -0,0 +1,3 @@
+performance_standard_zone,allow_violation,violation_penalty_per_emission
+PS_Zone1,0,0
+PS_Zone2,0,0

db/csvs_test_examples/policy/performance_standard/project_performance_standard_zones/1_project_performance_standard_zones_1.csv

@@ -0,0 +1,3 @@
+project,performance_standard_zone
+Gas_CCGT,PS_Zone1
+Gas_CT,PS_Zone2