REGISTER NOW: Brightway Spring School! 🇨🇦 Québec City (Canada) 🗓️ 20.-24. May 2024

bw2io.modified_database#

Module Contents#

Classes#

ModifiedDatabase

Find relationships between foreground data data and background database named ref_database_name.

class bw2io.modified_database.ModifiedDatabase(data, ref_database_name, from_simapro=False)[source]#

Bases: object

Find relationships between foreground data data and background database named ref_database_name.

Each activity and exchange is summarized in a hash, a small set of letters that summarizes all relevant attributes.

Attributes#

foreground_activities_mappingdict

hash: dataset

foreground_exchanges_mappingdict

hash: exchange

foreground_activitiesdict

activity hash: set of (exchange hash, amount) exchange tuples.

background_activities_mappingdict

hash: Activity

background_exchanges_mappingdict

hash: Exchange

background_activitiesdict

activity hash: set of (Exchange hash, amount) exchange tuples

Methods#

assert_data_fully_linked()

Assert that all exchanges in data have an input key.

iterate_unmatched()

Return data on activities in data which can’t be found in ref_database_name.

get_reason(exc_tuple, data)

Get reason why exc_tuple not in data. Reasons are: 1) Changed amount 2) Missing

iterate_modified()

Return data on modified activities

load_datasets()

Determine which datasets are modified by comparing the exchanges values.

add_to_background_exchanges_mapping(exc)

Add exchange to background_exchanges_mapping.

hash_background_exchanges(activity)

Hash exchanges in activity and add to background_exchanges_mapping.

hash_foreground_exchanges(activity)

Hash exchanges in activity and add to foreground_exchanges_mapping.

prune()

Remove activities from data that are not in ref_database_name.

add_to_background_exchanges_mapping(exc)[source]#
assert_data_fully_linked()[source]#
get_reason(exc_tuple, data)[source]#

Get reason why exc_tuple not in data. Reasons are: 1) Changed amount 2) Missing

Parameters#
exc_tupletuple

(exchange hash, amount)

dataset

set of (exchange hash, amount) exchange tuples

Returns#
str

Reason why exc_tuple not in data

hash_background_exchanges(activity)[source]#
hash_foreground_exchanges(activity)[source]#
iterate_modified()[source]#

Return data on modified activities

Returns#
tuple

(key, value)

iterate_unmatched()[source]#

Return data on activities in data which can’t be found in ref_database_name.

Returns#
tuple

(key, value)

load_datasets()[source]#

Determine which datasets are modified by comparing the exchanges values.

Specifically, compare the set of (input activity hashes, amount_as_string) values.

If the name or other important attributes changed, then there won’t be a correspondence at all, so the dataset is treated as modified in any case.

prune()[source]#