Change Sm3 to standard cubic meter

conda/meta.yaml

@@ -18,23 +18,24 @@ requirements:
     - python
     - setuptools
   run:
+    - bottleneck
+    - bw2data
+    - bw2io >=0.8.10
+    - constructive_geometries>=0.8.2
+    - cryptography
+    - datapackage
     - numpy
-    - pandas==1.5.3
-    - bw2io==0.8.7
-    - bw2data==3.6.6
-    - wurst==0.3.3
-    - xarray
+    - pandas
+    - platformdirs
     - prettytable
+    - pyarrow
     - pycountry
-    - cryptography
     - pyYaml
-    - sparse
-    - schema
-    - datapackage
     - requests
-    - bottleneck
-    - constructive_geometries>=0.8.2
-    - pyarrow
+    - schema
+    - sparse>=0.14.0
+    - wurst
+    - xarray
 
 test:
   imports:

docs/conf.py

@@ -24,7 +24,7 @@
 author = "Romain Sacchi, Alois Dirnaichner, Chris Mutel"
 
 # The full version, including alpha/beta/rc tags
-release = "1.5.0-alpha"
+release = "1.7.2"
 
 # -- General configuration ---------------------------------------------------
 
@@ -34,28 +34,31 @@
 extensions = [
     "sphinx.ext.autodoc",  # Core library for html generation from docstrings
     "sphinx.ext.autosummary",  # Create neat summary tables
+    "sphinx_rtd_theme",
 ]
 autosummary_generate = True  # Turn on sphinx.ext.autosummary
 
 master_doc = "index"
 
 autodoc_mock_imports = [
     "numpy",
-    "wurst==0.3.3",
-    "bw2io==0.8.7",
     "pandas",
+    "bw2io >=0.8.10",
     "bw2data",
+    "wurst",
     "xarray",
     "prettytable",
     "pycountry",
     "cryptography",
     "premise_gwp",
     "pyYaml",
-    "sparse",
+    "sparse>=0.14.0",
     "schema",
     "datapackage",
     "requests",
     "bottleneck",
+    "constructive_geometries>=0.8.2",
+    "pyarrow",
     "premise",
 ]
 
@@ -77,6 +80,6 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+html_static_path = []
 
 # html_sidebars = { '**': ['globaltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html'] }

docs/consequential.rst

@@ -51,12 +51,14 @@ Range time
 
 Integer. Years. To measure the trend around the point where the additional
 capital will be installed, a range of n years before and after the point
-is taken as the time interval.
+is taken as the time interval. Note that if set to a value other than 0,
+the duration argument must be set to 0.
 
 Duration
 ^^^^^^^^
 
 Integer. Years. Duration over which the change in demand should be measured.
+Note that if set to a value other than 0, the range time argument must be set to 0.
 
 Foresight
 ^^^^^^^^^

docs/extract.rst

@@ -112,7 +112,9 @@ indicate the database name in `source_db` and its version in `source_version`:
             ],
         source_db="ecoinvent 3.7 cutoff", # <-- this is NEW.
         source_version="3.7.1", # <-- this is NEW
-        key='xxxxxxxxxxxxxxxxxxxxxxxxx'
+        key='xxxxxxxxxxxxxxxxxxxxxxxxx',
+        use_multiprocessing=True, # True by default, set to False if multiprocessing is causing troubles
+        keep_uncertainty_data=False # False by default, set to True if you want to keep ecoinvent's uncertainty data
     )
 
 Note that a cache of the database will be created the first time and
@@ -613,7 +615,7 @@ The datasets introduced are listed in the table below.
  ================================================================== ===========
   Hydrogen distribution                                              location
  ================================================================== ===========
-  Hydrogen refuelling station                                        GLO
+  hydrogen refuelling station                                        GLO
   high pressure hydrogen storage tank                                GLO
   distribution pipeline for hydrogen, dedicated hydrogen pipeline    RER
   transmission pipeline for hydrogen, dedicated hydrogen pipeline    RER
@@ -633,6 +635,19 @@ The datasets introduced are listed in the table below.
 .. _LCI_H2_distr: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-hydrogen-distribution.xlsx
 .. _Cerniauskas: https://doi.org/10.1016/j.ijhydene.2020.02.121
 
+
+Hydrogen turbine
+****************
+
+A dataset for a hydrogen turbine is also imported, to model the production of electricity
+from hydrogen, with an efficiency of 51%. The efficiency of the H2-fed gas turbine is based
+on the parameters of Ozawa_ et al. (2019), consulted here: LCI_H2_turbine_.
+
+.. _Ozawa: https://doi.org/10.1016/j.ijhydene.2019.02.230
+.. _LCI_H2_turbine: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-hydrogen-turbine.xlsx
+
+
+
 Biofuels
 --------
 
@@ -942,6 +957,41 @@ These inventories can be found here: LCI_lithium_.
 .. _LCI_cobalt: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-cobalt.xlsx
 .. _LCI_lithium: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-lithium.xlsx
 
+Vanadium Redox Flow Batteries
+-----------------------------
+
+*premise* imports inventories for the production of a vanadium redox flow battery, used
+for grid-balancing, from the work of Weber_ et al. 2021.
+It is available under the following dataset:
+
+* vanadium-redox flow battery system assembly, 8.3 megawatt hour
+
+The dataset providing electricity is the following:
+
+* electricity supply, high voltage, from vanadium-redox flow battery system
+
+The power capacity for this application is 1MW and the net storage capacity 6 MWh.
+The net capacity considers the internal inefficiencies of the batteries and the
+min Sate-of-Charge, requiring a certain oversizing of the batteries.
+For providing net 6 MWh, a nominal capacity of 8.3 MWh is required for the
+VRFB with the assumed operation parameters. The assumed lifetime of the stack
+is 10 years. The lifetime of the system is 20 years or 8176
+cycle-life (49,000 MWh).
+
+.. _Weber: https://doi.org/10.1021/acs.est.8b02073
+
+These inventories can be found here: LCI_vanadium_redox_flow_batteries_.
+
+.. _LCI_vanadium_redox_flow_batteries: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-vanadium-redox-flow-battery.xlsx
+
+This publication also provides LCIs for Vanadium mining and refining from iron ore.
+The end product is vanadium pentoxide, which is available under the following dataset:
+
+* vanadium pentoxide production
+
+These inventories can be found here: LCI_vanadium_.
+
+.. _LCI_vanadium: https://github.com/polca/premise/blob/master/premise/data/additional_inventories/lci-vanadium.xlsx
 
 Road vehicles
 -------------

docs/introduction.rst

@@ -74,9 +74,7 @@ Provided a decryption key (ask the maintainers_), the following IAM scenarios ar
 
 CarbonBrief_ wrote a good article explaining the meaning of the SSP/RCP system.
 
-Additionally, we provided a summary of the main characteristics of each scenario in a spreadsheet_.
-
-.. _spreadsheet: https://github.com/polca/premise/raw/master/docs/scenario_report_2023-05-02.xlsx
+Additionally, we provided a summary of the main characteristics of each scenario `here <https://premisedash-6f5a0259c487.herokuapp.com/>`_.
 
 
 .. _CarbonBrief: https://www.carbonbrief.org/explainer-how-shared-socioeconomic-pathways-explore-future-climate-change

docs/load.rst

@@ -162,9 +162,12 @@ This is done as follows:
     ndb.write_db_to_datapackage()
 
 This creates a zip file that contains the all the data necessary for
-other users to replicate teh databases, provided they have access
+other users to replicate the databases, provided they have access
 to the source database locally.
 
-See the library ``unfold`` for more information on data packages
-for sharing LCA databases.
+See the library <``unfold`` https://github.com/polca/unfold/tree/main>_ for more information on data packages
+for sharing LCA databases. ``unfold`` can read these data packages and create
+brightway2 databases (or superstructure databases) from them.
+``unfold`` can also fold premise databases registered in your brightway2 project
+into data packages, to be shared with and recreated by others.
 

docs/requirements.txt

@@ -0,0 +1 @@
+sphinx-rtd-theme

docs/transform.rst

@@ -41,7 +41,7 @@ power plants on the basis of the excellent work done by Oberschelp_ et al. (2019
 to update some datasets in ecoinvent, which are, for some of them, several decades
 old. More specifically, the data provides plant-specific efficiency
 and emissions factors. We average them by country and fuel type to obtain
-volume-weighted factors. Rhe efficiency of the following datasets is updated:
+volume-weighted factors. The efficiency of the following datasets is updated:
 
 * electricity production, hard coal
 * electricity production, lignite
@@ -416,6 +416,28 @@ IAM region with their respective current production volumes (also provided by
 ecoinvent). This is not ideal as it supposes that future country-specific
 production volumes will remain the same in respect to one another.
 
+Storage
+-------
+
+If the IAM scenario requires the use of storage, *premise* adds a storage
+dataset to the high voltage market. *premise* can add two types of storage:
+
+* storage via a large-scale flow battery (electricity supply, high voltage, from vanadium-redox flow battery system)
+* storage via the conversion of electricity to hydrogen and subsequent use in a gas turbine (electricity production, from hydrogen-fired one gigawatt gas turbine)
+
+The electricity storage via battery incurs a 33% loss. It is operated by a 8.3 MWh vanadium redox-based flow battery,
+with a lifetime of 20 years or 8176 cycle-lifes (i.e., 49,000 MWh).
+
+The storage of electricity via hydrogen is done in two steps: first, the electricity is converted to hydrogen
+via a 1MW PEM electrolyser, with an efficiency of 62%. The hydrogen is then stored in a geological cavity
+and used in a gas turbine, with an efficiency of 51%. Accounting for leakages and losses, the
+overall efficiency of the process is about 37% (i.e., 2.7 kWh necessary to deliver 1 kWh to the grid).
+
+The efficiency of the H2-fed gas turbine is based on the parameters of Ozawa_ et al. (2019).
+
+.. _Ozawa: https://doi.org/10.1016/j.ijhydene.2019.02.230
+
+
 Medium voltage regional markets
 _______________________________