Simple Hourly Resolution Electricity Consumption Calculation
SHRECC creates time-resolved electricity-consumption databases for Brightway. It uses measured Energy Charts data for historical years and ENTSO-E TYNDP scenario data for prospective years, while exposing the same workflow for both.
- Hourly production, trade, consumption-volume, and consumption-mix results.
- One reduced country-network solver shared by Energy Charts and TYNDP data.
- Historical ecoinvent allocation and prospective premise/IAM mapping.
- Annual or monthly Brightway inventories from range-based or explicit timestamp selections, plus hourly LCIA without hourly foreground activities.
- Inspectable intermediate results before any Brightway database is changed.
- Resumable source acquisition and compressed, time-chunked result caches.
- Brightway 2 and 2.5 database writing through
NewDatabase. - Multi-year runs with a separate, year-labelled foreground database for each requested year.
The full documentation is hosted at Read the Docs page for shrecc
The internal data flow and module responsibilities are summarized in docs/architecture.md.
shrecc can be installed from pypi or from source.
The package is published at pypi.org/projects/shrecc.
You can install it with pip (or any other pypi compatible util like uv or poetry as follows:
pip install shrecc
Install optional premise geography support or the notebook environment with:
pip install "shrecc[premise,notebooks]"
To install shrecc from source, clone the code and then install the package and if necessary the dependencies manually.
The repository contains a minimal getting-started notebook and a more detailed analysis notebook. Both are also available in the documentation (only for main releases) at read the docs.
The harmonized historical/prospective workflow is available through
NewDatabase:
from shrecc import NewDatabase
electricity = NewDatabase(
scenario="DE",
years=[2035, 2040, 2050],
climate_year=2009,
bg_db_name={
2035: "premise-remind-eu-2035",
2040: "premise-remind-eu-2040",
2050: "premise-remind-eu-2050",
},
my_db_name="shrecc_tyndp_DE_june_noon",
countries=["ES", "FR", "DE", "IT", "PT", "BE", "NL", "LU", "AT", "CH"],
time_range=["2040-06-01 00:00:00", "2040-06-30 23:00:00"],
hour_range=[10, 14],
project_name="SHRECCei311",
source="auto",
inventory_resolution="annual",
)
electricity.create()
electricity.write()For a multi-year run, the month/day/time selection is reused for each year and
write() creates one foreground database per year. A year suffix is added to
my_db_name automatically unless explicit year-specific names are supplied.
Foreground activity names and metadata also record their modeled period.
inventory_resolution controls how many foreground activities are written:
"annual" creates one activity per country and year, "monthly" creates one
per country and selected calendar month. Both resolutions apply
consumption_profile within each period. Hourly inventories are not written
as Brightway activities.
Hourly LCIA is calculated directly from the retained hourly mixes. By default, SHRECC selects every installed EF v3.1 impact category, scores each unique background input once, and combines those scores with the hourly coefficients:
lcia_results = electricity.lcia()
hourly_intensity = lcia_results.hourly(2040)["intensity"]
annual_intensity = lcia_results.annual()Use electricity.lcia(methods=..., engine="multilca") to validate the
optimized calculation with composite Brightway MultiLCA functional units.
Neither engine writes hourly foreground activities.
Intermediate canonical results and annual/monthly mapped tables remain
available on the class instance through results(year) and table(year). Use
mapping_report(year) to inspect any historical technologies assigned to a
country-specific high-voltage fallback activity.
Please take a look at the DEVELOPPING.md file for details on how to contribute code to the repository. Notably for the versioning.
Copyright © 2025 Luxembourg Institute of Science and Technology Licensed under the MIT License.
- Sabina Bednářová (sabina.bednarova@list.lu)
- Thomas Gibon (thomas.gibon@list.lu)
- Isabela PICHARDO VELAZQUEZ isabela.pichardo@list.lu
- Caipeng LIANG caipeng.liang@list.lu