All notable changes to this project are documented in this file.
- Preserved full non-empty activity and exchange metadata on the fast Brightway export path, so exported databases retain the same metadata fields that Premise keeps in its temporary scenario caches instead of dropping exchange browsing information such as
name,product,location,unit, comments, and other cached metadata.
- Refreshed solar PV module efficiency assumptions in
premise/data/renewables/efficiency_solar_PV.csvusing updated literature, recent record-module benchmarks, and tandem-module roadmap projections. - Added new PV efficiency anchor years (
2025,2027,2030,2035) and a dedicatedperovskite-Si tandemtrajectory for advanced future scenarios. - Expanded the PV efficiency reference table with traceability metadata (
source,metric_level,maturity,basis,use_for_projection,review_notes). - Expanded GCAM variable coverage across final energy, fuels, electricity, and heat mappings, including additional building, cement, CDR, transport, and biofuel aliases.
- Updated GCAM regional mapping assets and topology alignment, including explicit
Ukrainecoverage and revised GCAM biofuel/climate region mappings. - Reduced cold-cache memory pressure in
NewDatabase()by extracting Brightway source databases into a more compact in-memory representation and clearing importer-side cached state after inventory imports. - Reworked the Brightway 2.5 export path to write processed arrays and database rows directly, substantially reducing
write_db_to_brightway()runtime and peak memory usage on large scenario exports. - Restored standard Brightway database behavior on the fast export path, including searchable activity rows and normal exchange browsing without requiring
import premisefirst. - Streamed Brightway source-database extraction during cold
NewDatabase()initialization to avoid queryset caching overhead and reduce cold-start RSS.
- Improved IAM normalization for models that do not provide an exact 2020 datapoint by falling back to the nearest available year (notably relevant for GCAM inputs and emissions factors).
- Moved end-of-pipe emissions updates to the end of the
NewDatabase.update()workflow to avoid ordering issues (issue#285). - Improved electricity validation diagnostics by logging dropped electricity shares and missing supplier technologies when market shares do not sum correctly.
- Normalized the cold-cache
NewDatabase.update()path so the first scenario reloads the cached source-database representation instead of keeping a special cache-miss in-memory form. - Ensured fast Brightway exports set activity process types so exported databases open correctly in downstream Brightway tools such as Activity Browser.
- Fixed migrated default-inventory placeholders with
replacement ...metadata so one-to-many ecoinvent migration disaggregations (for examplemarket for cokeandmarket for hard coalin steel inventories) no longer duplicate the original exchange amount across every split target during gap filling.
-
Updated the transformation documentation for photovoltaic module efficiency assumptions and added a plot summarizing the trajectories used in
premise. -
Applied formatting cleanup in
premise/export.py.
- Allows creating a Simapro or OpenLCA-compatible database without needing a Brightway project or Biosphere database.
- Added new version of IMAGE scenarios.
Changes in this section summarize work since tag v.2.3.6 (including current local branch updates).
- Added MESSAGE scenarios.
- Region-to-feedstock mapping files for biofuels:
premise/iam_variables_mapping/iam_region_to_biodiesel_feedstock.yamlpremise/iam_variables_mapping/iam_region_to_bioethanol_feedstock.yaml
- Metals post-allocation correction files for newer ecoinvent versions:
premise/data/metals/post-allocation_correction/corrections_311.yamlpremise/data/metals/post-allocation_correction/corrections_312.yaml
- Expanded fuel regionalization, including higher-level fuel activities.
- Expanded biomass supply-chain regionalization.
- Updated IAM variable mappings across sectors (final energy, fuels, heat, transport, electricity, steel, CDR).
- Updated GCAM topology and related mapping assets.
- Updated Brightway export/import integration (
premise/brightway2.py,premise/brightway25.py). - Updated inventory assets:
premise/data/additional_inventories/lci-biofuels.xlsxpremise/data/additional_inventories/lci-final-energy.xlsxpremise/data/additional_inventories/lci-pass_cars.xlsx
- Updated SimaPro category and import classification mappings.
- Multiple MESSAGE mapping fixes (fuels, final energy, industrial heat).
- Duplicate regionalization / duplicate dataset creation issue.
- Improved missing-file error messages.
- Unit normalization for IAM inputs provided in
PJ/yr(conversion toEJ/yr). - Updated NOx and PM2.5 emission factors for diesel passenger cars.
- Reintroduced
SSP2-Baseas an accepted scenario.
- Removed obsolete fuel config files:
premise/data/fuels/fuel_efficiency_parameters.ymlpremise/data/fuels/fuel_markets.ymlpremise/data/fuels/hydrogen_supply_losses.ymlpremise/data/fuels/supply_chain_scenarios.yml
- Renamed metals correction file:
premise/data/metals/post-allocation_correction/corrections.yaml- to
premise/data/metals/post-allocation_correction/corrections_310.yaml
- Updated
README.md, multiple docs pages, and example notebooks.
- Maintenance/formatting release.
- Fixed issue preventing regionalization of CDR and fuel supply chains.
- Temporarily removed
SSP2-BasefromSUPPORTED_PATHWAYS.
- Validation robustness improvements (including missing-key handling).
- Compatibility fixes for
wurstand pandas. - UTF-8 decoding fix for migration JSON files.
- Security and dependency vulnerability fixes.
- Updated docs, examples, and notebooks.
- Added ecoinvent
3.12compatibility and updated default ecoinvent version. - Updated REMIND scenarios to
3.5.2. - Improved migration system using
ecoinvent_migrate. - Added headers to A and B matrix CSV exports for datapackage/raw matrix export paths.
- Updated PV inventories and diesel/biodiesel/methanol ship SOx/PM factors.
- Improved mapping generation robustness when candidate datasets are missing.
- Extended country-specific PV electricity inventories from 33 to 171 countries.
- Fixes in
external.pykey access. - Fixed biomass-market linking to synthetic gas / methanol chains.
- Prevented negative period-weighted electricity mix shares from being used.
- Preserved existing dataset comments when appending new comments.
- Fixed an error in PV farm transformer inventories (copper amount overestimated by a factor of 10).
- Fixed unspecified production volume issue in country-specific PV electricity inventories.
- Added geo-coverage information in dataset comments.
- Added/extended classifications in export paths.
- Updated REMIND fuel variables and notebooks.
- Fixed missing world electricity market.
- Fixed biosphere-name validation in
PathwaysDataPackage. - Fixed electricity validation and lower-casing of dataset keys.
- Fixed openpyxl
pd.NAhandling by passingNone.
- Added classifications to datapackages.
- Added README accessibility tests and alt text improvements.
- Added additional module documentation and typing/documentation improvements.
- Significant MESSAGE mapping expansion/updates for heat, fuels, final energy, biomass, steel, cement, carbon removal, and PV.
- Improved report generation and SimaPro export behavior.
- Updated migration map and docs/tests.
- Fixed tests and type-related edge cases.
- Added bypass for metals validation in consequential mode where marginal/average shares diverge.
- Connected biomass market to biogas and ethanol production.
- Renamed biomass market to
market for lignocellulosic biomass, used as fuel.
- Added GCAM variables, tests, and documentation.
- Added accessibility scanning in CI and improved datapackage variable export serialization.
- Updated Python requirement metadata.
- Updated notebooks and docs.
- Fixed low-temperature DAC end-of-life dataset issue.
- Cement mapping mask updates (
average) and minor test/doc fixes.
- Updated/additional IAM scenario support: REMIND v3.5, IMAGE v3.4, REMIND-EU, GCAM.
- Major sector updates:
- Transport (shipping, rail, road)
- Shipping inventories for marine oil, ammonia, methanol, and hydrogen powertrains
- Rail inventories for additional rail technologies
- Road inventories for ICEV/BEV/FCEV road technologies
- Carbon dioxide removal mixes
- Metals intensity updates
- Mining waste pathway updates
- Heat mixes (residential/industrial)
- Battery mix and energy-density evolution
- Additional technology representation for primary steel routes.
- Regionalization of biomass-producing forestry activities.
- Added
PathwaysDataPackageexport workflow.
- Broadened scenario and sector coverage for prospective database transformation.