Update reference tables

[rouille]

Purpose

Update reference tables. Also, fix the notebook used to manually update the BA reference table.

What the code is doing

Regarding the notebook used to update the BA reference table, I did not have the "Allowable Entries for Balancing Authorities and Hubs" file from FERC so I could not run the notebook. After downloading the file, I preprocessed it and refactor the notebook to be able to updated the existing BA reference table. Existing and updated file are identical as the FERC data have not changed since last release.

Testing

Ran the notebook and then:

>>> import pandas as pd
>>> ba_reference = (
...     pd.read_csv("../../src/oge/reference_tables/ba_reference.csv")
...     .sort_values(by=["ba_code"])
... )
>>> ba_reference
    ba_code                                         ba_name      ba_category  ... retirement_date_ferc      source ba_number
0      AEBN                                AESC, LLC - AEBN              NaN  ...                  NaN        FERC         1
1       AEC                   PowerSouth Energy Cooperative              NaN  ...                  NaN  EIA & FERC         2
2      AECI           Associated Electric Cooperative, Inc.              NaN  ...                  NaN  EIA & FERC         3
3      AEGL                             AESC, LLC - Gleason              NaN  ...                  NaN        FERC         4
4      AELC                      AESC, LLC - Lincoln Center              NaN  ...                  NaN        FERC         5
..      ...                                             ...              ...  ...                  ...         ...       ...
206     WPS            Wisconsin Public Service Corporation              NaN  ...                  NaN        FERC       207
207      WR             Western Resources dba Westar Energy              NaN  ...                  NaN        FERC       208
208     WWA                       NaturEner Wind Watch, LLC  generation_only  ...                  NaN  EIA & FERC       209
209     YAD  Alcoa Power Generating, Inc. - Yadkin Division  generation_only  ...                  NaN  EIA & FERC       210
239     NaN                          No Balancing Authority    miscellaneous  ...                  NaN         NaN       999

[240 rows x 13 columns]
>>> ba_reference_updated = pd.read_csv(
...     "../../src/oge/reference_tables/ba_reference.csv"
... ).sort_values(by=["ba_code"])[ba_reference.columns]
ba_reference_updated>>> ba_reference_updated
    ba_code                                         ba_name      ba_category  ... retirement_date_ferc      source ba_number
0      AEBN                                AESC, LLC - AEBN              NaN  ...                  NaN        FERC         1
1       AEC                   PowerSouth Energy Cooperative              NaN  ...                  NaN  EIA & FERC         2
2      AECI           Associated Electric Cooperative, Inc.              NaN  ...                  NaN  EIA & FERC         3
3      AEGL                             AESC, LLC - Gleason              NaN  ...                  NaN        FERC         4
4      AELC                      AESC, LLC - Lincoln Center              NaN  ...                  NaN        FERC         5
..      ...                                             ...              ...  ...                  ...         ...       ...
206     WPS            Wisconsin Public Service Corporation              NaN  ...                  NaN        FERC       207
207      WR             Western Resources dba Westar Energy              NaN  ...                  NaN        FERC       208
208     WWA                       NaturEner Wind Watch, LLC  generation_only  ...                  NaN  EIA & FERC       209
209     YAD  Alcoa Power Generating, Inc. - Yadkin Division  generation_only  ...                  NaN  EIA & FERC       210
239     NaN                          No Balancing Authority    miscellaneous  ...                  NaN         NaN       999

[240 rows x 13 columns]
>>> ba_reference.equals(ba_reference_updated)
True 

Where to look

• In the ba_reference.csv file, several retirement dates have been updated using the EIA list of Balancing Authorities
• In the notebook used to update the BA reference table, add documentation and code to guide the user to process the FERC data before merging it to the existing BA reference table.
• Add one entry and delete 2 existing entries in eGRID_crosswalk_of_EIA_ID_to_EPA_ID.csv

Usage Example/Visuals

N/A

Review estimate

10min

Future work

Clear outputs of notebook after review

Checklist

• Update the documentation to reflect changes made in this PR
• Format all updated python files using ruff
• Clear outputs from all notebooks modified
• Add docstrings and type hints to any new functions created