Transform FERC-714 load forecast table

.github/workflows/release.yml

@@ -6,7 +6,6 @@ on: push
 jobs:
   build-distribution:
     name: Build catalystcoop.pudl distribution for PyPI
-    if: github.repository == ‘catalyst-cooperative/pudl’
     runs-on: ubuntu-latest
     steps:
       - name: Checkout source

docs/release_notes.rst

@@ -41,6 +41,13 @@ EIA 860
   regarding energy storage and solar generators. See issue :issue:`3676` and PR
   :pr:`3681`.
 
+FERC 714
+~~~~~~~~
+
+* Added :ref:`core_ferc714__yearly_planning_area_demand_forecast` based on FERC
+  Form 714, Part III, Schedule 2b. Data includes forecasted demand and net energy load.
+  See issue :issue:`3519` and PR :pr:`3670`.
+
 NREL ATB
 ~~~~~~~~
 * Added 2024 NREL ATB data. This includes adding a new tax credit case,

migrations/versions/0f594b84fbe7_.py

@@ -0,0 +1,24 @@
+"""empty message
+
+Revision ID: 0f594b84fbe7
+Revises: 2c52a938f5cc, c4e8e24d4a98
+Create Date: 2024-07-18 19:06:38.337919
+
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision = '0f594b84fbe7'
+down_revision = ('2c52a938f5cc', 'c4e8e24d4a98')
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    pass
+
+
+def downgrade() -> None:
+    pass

migrations/versions/c4e8e24d4a98_updated_yearly_planning_area_demand_.py

@@ -0,0 +1,37 @@
+"""Updated yearly_planning_area_demand_forecast schema
+
+Revision ID: c4e8e24d4a98
+Revises: b9b6cb1a5405
+Create Date: 2024-07-10 12:57:31.753979
+
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision = 'c4e8e24d4a98'
+down_revision = 'b9b6cb1a5405'
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('core_ferc714__yearly_planning_area_demand_forecast',
+    sa.Column('respondent_id_ferc714', sa.Integer(), nullable=False, comment='FERC Form 714 respondent ID. Note that this ID does not correspond to FERC respondent IDs from other forms.'),
+    sa.Column('report_year', sa.Integer(), nullable=False, comment='Four-digit year in which the data was reported.'),
+    sa.Column('forecast_year', sa.Integer(), nullable=False, comment='Four-digit year that applies to a particular forecasted value.'),
+    sa.Column('summer_peak_demand_mw', sa.Float(), nullable=True, comment='The maximum hourly summer load (for the months of June through September) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.'),
+    sa.Column('winter_peak_demand_mw', sa.Float(), nullable=True, comment='The maximum hourly winter load (for the months of January through March) based on net energy for the system during the reporting year. Net energy for the system is the sum of energy an electric utility needs to satisfy their service area and includes full and partial wholesale requirements customers, and the losses experienced in delivery. The maximum hourly load is determined by the interval in which the 60-minute integrated demand is the greatest.'),
+    sa.Column('net_demand_mwh', sa.Float(), nullable=True, comment='Net electricity demand for the specified period in megawatt-hours (MWh).'),
+    sa.ForeignKeyConstraint(['respondent_id_ferc714'], ['core_ferc714__respondent_id.respondent_id_ferc714'], name=op.f('fk_core_ferc714__yearly_planning_area_demand_forecast_respondent_id_ferc714_core_ferc714__respondent_id')),
+    sa.PrimaryKeyConstraint('respondent_id_ferc714', 'report_year', 'forecast_year', name=op.f('pk_core_ferc714__yearly_planning_area_demand_forecast'))
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_table('core_ferc714__yearly_planning_area_demand_forecast')
+    # ### end Alembic commands ###