Natural Gas Upstream update - Addresses issue #260

electricitylci/data/process_metadata.yml

@@ -857,15 +857,16 @@ coal_upstream:
 gas_upstream:
 
   techno_intro: &gas_upstream_techno_intro
-    - 'The cradle-to-gate inventory for production of gas aggregated to basin. '
+    - 'The cradle-to-gate inventory for production of gas aggregated to basin or region, depending on the year selected in the model configuration. '
 
   techno_process: &gas_upstream_techno_process
-    - 'The NETL natural gas life cycle model includes parameters to generate inventories for natural gas extraction based on basin and geology which determines the gas extraction type (e.g., Appalachian Shale using hydraulic fracturing).
-      2016 natural gas production then informs the amount of each type of technology/region that form the mix in the regions.
+    - 'The NETL natural gas life cycle model includes parameters to generate inventories for natural gas extraction based on region or basin and geology which determines the gas extraction type (e.g., Appalachian Shale using hydraulic fracturing).
+      2016 or 2020 natural gas production then informs the amount of each type of technology/region that form the mix in the regions, depending on the year selected in the model configuration.
       These can be further aggregated to a US average.
-      More details are in the natural gas upstream report at the link below
-
-      https://www.netl.doe.gov/energy-analysis/details?id=3198'
+      More details are in the natural gas upstream report at the following links.
+      Link for 2016: https://www.netl.doe.gov/energy-analysis/details?id=4f43cb3f-c0d7-482e-bf01-39995a7c7497
+      Link for 2020: https://www.netl.doe.gov/energy-analysis/details?id=546d4009-c43b-43f5-bcc9-64d5e63fc8d5
+      '
 
   Description:
   - *gas_upstream_techno_intro

electricitylci/eia_trans_dist_grid_loss.py

@@ -82,7 +82,7 @@ def eia_trans_dist_download_extract(year):
     pandas.DataFrame
     """
     # check in case year is passed as an int
-    if isinstance(year,str)
+    if isinstance(year,int):
         year = str(year)
     eia_trans_dist_loss = pd.DataFrame()
     old_path = os.getcwd()

electricitylci/globals.py

@@ -233,6 +233,8 @@
 RENEWABLE_VINTAGES = [2016, 2020]
 '''list : The valid years for renewable inventories (i.e., 2016 and 2020).'''
 
+NG_MODEL_YEARS = [2016, 2020]
+'''list : The valid years for natural gas model (i.e., 2016 and 2020).'''
 
 ##############################################################################
 # FUNCTIONS

electricitylci/model_config.py

@@ -17,6 +17,7 @@
 from electricitylci.globals import output_dir
 from electricitylci.globals import COAL_MODEL_YEARS
 from electricitylci.globals import RENEWABLE_VINTAGES
+from electricitylci.globals import NG_MODEL_YEARS
 
 
 ##############################################################################
@@ -141,6 +142,8 @@ class ModelSpecs:
         Absolute path to JSON-LD zip output file.
         File name includes the model name and current time stamp and is
         located by default in the output directory (see globals.py).
+    ng_model_year : int
+        The natural gas model year (e.g., 2016 or 2020).
     """
     def __init__(self, model_specs, model_name):
         """Class initialization.
@@ -201,6 +204,7 @@ def __init__(self, model_specs, model_name):
             f"{output_dir}/{model_name}_jsonld_"
             f"{datetime.datetime.now().strftime('%Y%m%d_%H%M%S')}.zip"
         )
+        self.ng_model_year = model_specs["ng_model_year"]
 
 
 ##############################################################################
@@ -330,9 +334,18 @@ def check_model_specs(model_specs):
         err_str += " or ".join([str(x) for x in COAL_MODEL_YEARS])
         err_str += " not %s!" % model_specs['coal_model_year']
         raise ConfigurationError(err_str)
+
     if not model_specs['renewable_vintage'] in RENEWABLE_VINTAGES:
         err_str = "The renewable inventory vintage must be one of "
         err_str += " or ".join([str(x) for x in RENEWABLE_VINTAGES])
         err_str += " not %s!" % model_specs['renewable_vintage']
         raise ConfigurationError(err_str)
+
+    if not model_specs['ng_model_year'] in NG_MODEL_YEARS:
+        err_str = "The natural gas model year must be one of "
+        err_str += " or ".join([str(x) for x in NG_MODEL_YEARS])
+        err_str += " not %s!" % model_specs['ng_model_year']
+        raise ConfigurationError(err_str)
+
     logging.info("Checks passed!")
+

electricitylci/modelconfig/ELCI_1_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2020
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2016
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_2020_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2023
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2020
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_2021_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2023
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2020
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_2022_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2023
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2020
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_2023_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2023
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2020
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016
@@ -147,5 +154,4 @@ NETL_IO_trading_year: 2023
 # Product systems for the at-user consumption mixes are also generated.
 run_post_processes: true
 
-
 # OTHER PARAMETERS

electricitylci/modelconfig/ELCI_2024_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2023
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2020
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_2_config.yml

@@ -31,6 +31,13 @@ replace_egrid: true
 # construction LCI.
 coal_model_year: 2020
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2016
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016

electricitylci/modelconfig/ELCI_3_config.yml

@@ -31,6 +31,13 @@ replace_egrid: false
 # construction LCI.
 coal_model_year: 2020
 
+# NG baseline year
+# this is used to determine which NG inventory to use. 
+# this impacts the upstream ng emissions for production, gathering and boosting,
+# processing, transmission, storage, and distribution
+# Select between 2016 and 2020 model inventories.
+ng_model_year: 2016
+
 # NETL developed profiles for renewable generation to capture construction
 # and O&M impacts (e.g., solar PV manufacturing and power plant operations).
 # There are two vintages for renewable inventories: 2016 and 2020. The 2016