Recent Releases of flowsa

flowsa - v2.0.5

What's Changed

New FBAs

  • stateio_use_summary (2012 - 2023)
  • EPA_StateGHGI (2012 - 2022)

New FBSs

  • GHG_state_m1 (2012 - 2022)

Full Changelog: https://github.com/USEPA/flowsa/compare/v2.0.4...v2.0.5

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young 8 days ago

flowsa - v2.0.4

What's Changed

New FBAs

  • Personal consumption expenditures by state (BEA_PCE)
  • BLS Consumer Expenditures Survey (BLS_CES)
  • Census American Community Survey (Census_ACS)
  • Census County Business Patterns (Census_CBP), revised
  • Census Economic Census, Class of Customer Statistics (Census_EC)
  • Census Service Annual Survey (Census_SAS)
  • State Inventory Tool (EPA_SIT); requires state data
  • GHG Inventory data for select states to support EPAs Consumption Based Emissions Inventories
  • Updated USDA ERS Farm Income and Wealth Statistics (USDA_ERS_FIWS)
  • Updated USDA ERS Farm Income and Wealth Statistics (NOAA_FisheriesLandings)

New FBSs

  • State_employment_m1 (added 2021-2023, updated all other years)
  • National_employment_m1 (added 2023, updated all other years)

Full Changelog: https://github.com/USEPA/flowsa/compare/v2.0.3...v2.0.4

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young 4 months ago

flowsa - v2.0.3

Flow By Activity

Flow By Sector

  • BEA_Detail FBS for 2013-2016, 2018-2022
  • Updated GHG national FBS (m1 and m2) 2012-2022

Full Changelog: https://github.com/USEPA/flowsa/compare/v2.0.2...v2.0.3

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young 10 months ago

flowsa - v2.0.2

What's Changed

Flow-by-Activity

  • Substantial updates to IEA Monthly Energy Review (EIA_MER)
  • Adds UNEP Global Materials Flow Database (UNEP_IRP_GMFD)

Flow-by-Sector

  • Updates Employment_national to 2017 NAICS schema, and adds 2021 and 2022 (#410)
  • Updates CRHW_national to 2017 NAICS schema, and adds 2021 (#414)
  • Adds Energy_fossil_national
  • Adds Raw_Material_Extraction_national

Full Changelog: https://github.com/USEPA/flowsa/compare/v2.0.1...v2.0.2

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young 11 months ago

flowsa - v2.0.1

  • new USEEIOv2 detail target schema
  • fix broken FBAs (changed urls, changed excel tab names) for EIA_AEO, NOAA_FisheriesLandings, EIA_SEDS, EPA_CDDPath, USGS_MYB, EPA_WARMer
  • reassign USDA_IWMS '111333' NAICS code to Berry Totals (from Orchards) to align with USDA_CoA_Cropland assignment c7c4c4f
  • assign USGS_WU_Coef "Beef and other cattle" to "11213" in addition to "11212" a9c01c4
  • update method_status.md to reflect current status of FBA/FBS errors when generating
  • updates to stackedBarChart() to work in situations where df is already a collapsed FBS and where there are unique input parameters
  • updates to FBSscatterplot() - add boxplot option
  • update sector_aggregation() to work for collapsed FBS df
  • generalize return_primary_activity_column() to return_primary_flow_column() so function works for both FBA and FBS 46ddf48
  • new proxy_sector_data() to enable substituting an FBS sector value for a missing sector
  • correct zenodo authorship
  • update links to new data commons server
  • rename "foss_landings.csv" to "NOAA_FisheriesLandings.csv" in external data folder
  • update waste sector names, add 2 additional waste sectors 854eab3
  • add warning when an FBS method uses "direct" when it should use "equal"
  • update Land and Water FBS to use "equal" over "direct"
  • edit log statements to make more concise

Changes to FBS

  • Water_national_2015_m1, Water_national_2010_m1, Water_state_2015_m1 have new results to do reassigned activity to sector mapping for USGS_IWMS and USGS_WU_Coef

Full Changelog: https://github.com/USEPA/flowsa/compare/v2.0.0...v2.0.1

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 1 year ago

flowsa - v2.0.0

Major updates:

  • Turn FlowByActivity and FlowBySector into classes
  • Create FlowBy class for functions used in both FBA and FBS classes
  • FBS yamls revised to work for unlimited recursive and sequential attribution methods
  • Update how suppressed data and parent sectors are equally attributed to child sectors, by equally attributing parent values to the next level of child values, rather than equally attributing parent values to target-level child sectors
  • Ability to attribute dfs on non-sector columns
  • Option to fill in primary source data columns with attribution columns
  • Add support for 2017 NAICS codes
  • Add mappings for 2017 BEA codes to 2017 NAICS
  • All state FBS model results sum to national FBS model results

Minor Updates:

  • Updates to Paths, which require most up-to-date versions of fedefelmflowlist, esupy, stewi
  • Source_catalog.yaml updated - 'activity_schema' can be year-dependent
  • New function compare_national_state_fbs() which compares aggregated results of state vs land FBS
  • New github action to generate a single FBA
  • Change BEA FBA names to align with useeior naming schema
  • Updates to BLM FBAs - adds previously dropped state and national data for select activities
  • Rename "CAP_HAP_national_2017" to "CAP_HAP_national_2017_m1"
  • Add D.C. data to ERS MLU and NWIS WU
  • Drop support for Python 3.8, add support for Python 3.11
  • Rename sector_aggregation_levels from "aggregated" and "disaggregated" to "flat" and "Parent-completeChild" and "parent-incompleteChild"

New Flow-By-Sector Models

  • CAP_HAP_Nonpoint 2014, 2017, 2020
  • CAP_HAP_Nonroad 2014, 2017, 2020
  • CAP_HAP_Onroad 2014, 2017, 2020
  • CAP_HAP_national m1 and m2 2014, 2017, 2020
  • CAP_HAP_state m1 2014, 2017, 2020
  • CRHW_state 2013, 2015, 2019
  • Detail Make, Supply, and Use tables
  • Employment national 2002, 2016, 2019, 2020
  • GHG national m1 and m2, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020
  • GHG state m1 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020
  • GRDREL national 2020
  • GRDREL state 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020
  • Land_state_2012
  • TRI_DMR_state 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020

New Flow-By-Activity Models

  • Annual BEA summary make and use tables
  • Bureau of Transportation Statistics Airline fuel cost and consumption (BTS_Airlines) 2000-2021
  • EPA State Inventory Tool (EPA_SIT) 2018-2019
  • EPA State GHG Inventories (EPA_StateGHGI) 2020
  • State GHGI for Maine (1990-2019), New York (2017-2019), Vermont (1990-2019)

Justifications for changes in FBS model results

  • All FBS models have revised results
  • Updates to how suppressed data are estimated and to how parent sector values are equally attributed to child sectors impacted all FBS models
  • CNHW_national_2018, CNHW_state_2014 - changes due to employment FBS; fix error in missing F01000
  • Food_waste_national_2018_m2 - changes due to new CNHW 2018 as primary data source
  • Water_national_2015_m1 - Use state employment data for attribution instead of national employment data and reassigned an "Orchard" code to "Berry Totals"

Features removed:

  • Generating Sankey diagrams (will be re-added in future version)
  • Producing .bib files (will be re-added in future version)
  • Appending material codes to sector codes (will be re-added in future version)
  • Drop support for Water_national_m2 FBS
  • Drop support for Electricity_gen_emissions FBS

What's Changed

New Contributors

v2.0.0 reviewers

Thanks to David Graham and Justin Bousquin for reviewing FLOWSA for the v2.0.0 release.

Full Changelog: https://github.com/USEPA/flowsa/compare/v1.3.2...v2.0.0

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 1 year ago

flowsa - v1.3.2

Pins final release supported by esupy<=0.2.2

Full Changelog: https://github.com/USEPA/flowsa/compare/v1.3.1...v1.3.2

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young almost 2 years ago

flowsa - v1.3.1

FLOWSA v1.3.1 release coincides with supply-chain-factors v1.2 release

Greenhouse Gas (GHG) Flow-By-Sector (FBS) Method changes:

  • Updates GHG FBS m1 to equally allocate BEA and EIA MECS to sectors rather than use employment for attribution
  • Updates GHG FBS m1 for 2016, 2017, 2018, and 2019 with latest inventory
  • Use a common GHG FBS m1 yaml file as basis for all years
  • Update some GHG FBS attribution source data years (MECS)
  • Updates to GHGI activity names and activity to sector mapping

New Flow-By-Activity and Flow-By-Sector datasets:

  • Adds 2020 GHGI FBA and GHG national FBS

Additional, minor changes:

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney about 2 years ago

flowsa - v1.3.0

Major Updates:

  • Option to append material codes to end of sector code in FBS
  • New waste-related FBAs/FBSs, and 7/8 digit sector codes
  • New food waste and concrete waste specific FBS
  • New data visualization functions: Sankey, stackedBarChart
  • Updates to methodology since v1.2.4 release changed the results for: CAP_HAP_national_2017, CNHW_national_2014, Land_national_2012, Water_national_2010_m2, Water_national_2015_m2, Water_national_2015_m3
  • option to return an FBS with any mix of sector lengths, SPB and SCB columns no longer need to have matching sector lengths
  • option for multiplication as allocation method
  • update allocation methodology so if the allocation dataset is at a more aggregated geoscale than the primary FBA, that the primary df is not aggregated to match the allocation geoscale. Instead the more aggregated allocation dataset merges with the primary FBA on all related less aggregated geoscales
  • Changes to github actions to address memory issues
  • in equal_allocation() aggregate column before allocating to child naics - this impacts some NAICS6 results
  • option to retain activity names in a primary data source after calling on those activities in an FBS, so the activity names can be used again
  • requires plotly, kaleido

Minor Updates:

  • new external_paths.env file to store local file paths
  • rename load_api_key to load_env_file_key(), used for api keys and external_paths.env
  • getFlowByActivity accepts flowclass of class or list
  • new sector codes: S00203 - other state and local government enterprises, F040 - exports of goods and services, F050 - imports of goods and services, new 7/8 digit sectors for waste sectors (5622121, 5622191, 5622192, 5629201, 5629202, 5629203)
  • New required columns in FBS: ProducedBySectorType, ConsumedBySectorType, AttributionSources (primary attribution source name)
  • new selection_fields FBS parameter to subset FBA using column names/values
  • new VisualizationEssentials.csv with standard colors for graphing sectors
  • new csv "sector_2012_names" which includes additional names beyond official NAICS

New/Modified FBA:

  • expand epa_cddpath sector mapping
  • EPA_FactsAndFigures, EPA_REI, EPA_WARMer, EPA_WFR, Census_ASM, EPA_CDDPath (2018), EIA_AEO, EIA_SEDS

New/Modified FBS:

  • CNHW_national_2018, Employment_national (2012, 2014, 2015), Food_waste_national_2018 (m1, m2), GHG_national_m1 (2016, 2017, 2018, 2019), REI_waste_national_2012

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 2 years ago

flowsa - v1.2.4

FBA Updates

  • USDA_ERS_FIWS through 2020
  • NOAA_FisheriesLandings through 2021
  • BLS_QCEW data through 2021

FBS Updates #255

  • Move most employment FBS text to Employment_common.yaml
  • New Employment_national_2018
  • New Employment_state_2020

BEA updates from useeiorv1.1.0 #230

  • Updates 2012 Make and Use tables to use latest BEA release in Fall of 2021 (see https://github.com/USEPA/useeior/pull/221)
  • Updates industry gross output data from same release, and expands to include 2019 and 2020 data years
  • Removed deprecated BEA_2012_Detail_Use_Industry_Transactions.csv
  • Changes to BEA data modify results of CAP_HAP_national_2017, Water_national_2010_m2, and Water_national_2015_m2

Other updates

  • Correct metadata URLs for FBA and FBS YAMLs #262
    • Old metadata URLs can be corrected by replacing "data" with "methods"

Full Changelog: https://github.com/USEPA/flowsa/compare/v1.2.3...v1.2.4

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 2 years ago

flowsa - v1.2.3

Flow-By-Activity Updates

  1. Fixed broken link for USGS_MYB_Copper #252
  2. Add BLS_QCEW 2019 FBA #248
  3. Add method_status.yaml to document list of known inactive method files #251
  4. New Census_QWI FBAs for 2002, 2010 - 2020 #242

Flow-By-Sector Updates

  1. Add state employment FBS for 2018/2019 #248

Requirement Updates

  1. Update to pandas 1.4.0 #238
  2. Drop support for Python 3.7 (due to pandas update) #237

GitHub Actions

  1. Separate actions for FBA config and FBS method testing #251
  2. In FBA testing, skip inactive FBA methods identified in method_status.yaml #251

Full Changelog: https://github.com/USEPA/flowsa/compare/v1.2.2...v1.2.3

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney almost 3 years ago

flowsa - v1.2.2

Flow-By-Sector Updates

  • Use useeio summary sector target levels for Water_state_2015_m1 and CNHW_state_2014 (#226), disaggregates utilities sector (221)
  • Fixes error in CNHW_state and CNHW_national introduced by change in BLS allocation data

Flow-By-Activity Updates

New FBA:

  • EPA_StateGHG (#231) (source data file not yet available publicly)
  • EPA_SIT (#231)
  • stateior (#231)

Other Updates:

  • Added years 2018-2020, and fixed missing data for Census_CBP (#223, #229)

Functionality Additions

  • new BEA summary crosswalks and functions to support analysis including map_to_BEA_sectors() and calculate_industry_coefficients()
  • improved error handling and custom exceptions (#216)

Full Changelog: https://github.com/USEPA/flowsa/compare/v1.2.1...v1.2.2

Industrial Ecology - Life Cycle Assessment - Python
Published by bl-young almost 3 years ago

flowsa - v1.2.1

Minor updates from v1.2:

  1. Addition of missing !script_function tags in Water_national_2010_m1 and CNHWC_national_2014 FBS YAML methods
  2. Updated broken USGS MYB urls
  3. Simplified USDA_ACUP Fertilizer and Pesticide FBA url calls

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney almost 3 years ago

flowsa - v1.2

Flow-By-Sector Updates

New FBS:

  1. CNHW_state_2014
  2. CRHW_state_2017
  3. Employment_state 2012-2017
  4. GRDREL_state_2017
  5. TRI_DMR_state_2017

FBS Updates/Changes to methodology:

  1. Addressed errors in the Water_national FBS methodology
    a. The USGS_NWIS_WU data is modified to distinguish between crop and golf irrigation. The function check_golf_and_crop_irrigation_totals() checks if a state distinguishes between crop/golf irrigation and if not, assigns all flows to crop irrigation. An error in the function resulted in several states not having total irrigation water assigned to irrigation crop water withdrawals. The correction increased the total amount of water withdrawn for crop irrigation and resulted in a redistribution of water by sectors.
    b. Previous versions allocated "Livestock" water use to aquaculture sectors, resulting in double counting of water use for aquaculture, as aquaculture is a separate water use category. The updated methodology drops aquaculture from USDA CoA cropland data before allocating to sectors, removing the double counting.

  2. Addressed error in Land_national_2012 methodology. In the previous version, land use for aquaculture was only accounted for in 2 states. This version accounts for land use in all states, resulting in an increase in land use for aquaculture and a decrease in land use for other sectors in the animal land use category.

  3. Refactors CAP_HAP_national_2017.yaml to split activity set 3 into separate activity sets, such that the subsetting columns from the NEI_Nonpoint_2017_asets.csv file are no longer necessary. Removes the subsetting columns from NEI_Nonpoint_2017_asets.csv (#213)

  4. Adjust assignment of NAICS to facilities for stewicombo data: use NAICS from FRS list only if a single NAICS is provided, else use the NAICS assigned by the inventory; reduces risk of inconsistent NAICS application (#151)

Changes to FBS method YAML file setup:

  1. Added a flowsa_yaml module including a custom yaml loader called FlowsaLoader which implements 4 tags that can be used in FBA and FBS method yaml files.
    a. !include: allows inheriting arbitrary nodes from other yaml files
    b. !external_config: adds additional target paths to search for included files (#207)
    c. !from_index: specifies the activity set file to load (#210)
    d. !script_function: specifies the python file and function name to load in FBA and FBS yaml files (#214)

  2. Refactors FBA method yamls, along with their associated csvs, to use descriptive activity set names, rather than just activity_set_1, etc.

  3. Add a NAICS dictionary relevant for BEA Summary level models which can be accessed using !include:BEA_summary_target.yaml in any FBS method (#197)

  4. New parameter activity_to_sector_mapping to specify the name of the sector mapping file to use, rather than loading a mapping file that matches the source name (#186)

Flow-By-Activity Updates

New FBA:

  1. BTS TSA FBA (Transportation Satellite Account data)
  2. USGS MYB Lead 2018/19
  3. EPA EQUATES FBA

FBA Updates/Changes to Methodology:

  1. BLS_QCEW: updated the FBA FlowNames to distinguish ownership (e.g., federal government). This change enables better estimates of suppressed data, which impacts results of all FBS methods that use employment as an allocation source.
  2. USDA_CoA_Cropland: updated the FlowName for irrigated, harvested cropland (111) to match the FlowNames that aggregate to that value. This change does not impact FBS results.
  3. Updated GHGI FBA column assignments for flows and activities in some tables.
  4. Fixed broken Census PEP Population links and added data for 2018-21
  5. Condensed all USGS_MYB python scripts into single file, USGS_MYB.py
  6. Fixed misaligned coordinates for EIA_MECS_Energy_2018

Updates to Crosswalks/Mapping Activities to Sectors:

  1. Expand NAICS_2012_Crosswalk and NAICS_Crosswalk_TimeSeries to include 7-digit NAICS
  2. Removed NAICS_Crosswalk_EPA_GHGI.csv file. Will re-add to master branch once the crosswalk is finalized.
  3. Updated NAICS_Crosswalk_USDA_CoA_Livestock.csv to drop unused NAICS8 for cow categories and correct the "Pheasants" sector assignment
  4. Update NAICS_Crosswalk_eLCI.csv to modify electricity sector assignments from NAICS6 to NAICS7

Functionality Additions:

  1. Option to allow Flow-By-Sector method YAMLs (and crosswalks and activity set files) to be kept outside of the FLOWSA package in a local directory and passed for processing in a getFlowBySector() call. This will allow development of FBS methods outside of the main flowsa repo. (#172, #178)
  2. Ability to include multiple sector levels within a single FBS dataset, see "flowbysectormethods/BEA_summary_target.yaml" for an example. (#181)
  3. Option to split data into rural/urban classification by FIPS (#173)
  4. Modify method of reading sector crosswalks to use the sector length identified in the column header rather than the length of the text string. This change enables flexible assignments to each sector length (e.g., 2-digit government sector is F010)
  5. New functionality "Process adjustments" which allow for adjustments to the "SectorProducedBy" field for data obtained from stewicombo. Records are reassigned to the "target_naics." (#190)

Notable Modifications to Functions:

  1. Updates equally_allocate_suppressed_parent_to_child_naics() to allocate data from the nearest unsuppressed parent sector rather than allocating from the nearest parent sector level that contained no suppressed data. This change results in more accurate data allocation, where child sectors do not sum to be greater than parent sectors (unless the way data was rounded in the original df results in some minor differences). Also add validation checks within the function to compare original flow amounts at each sector level to the flow amounts in the revised df. A second validation check compares summed child sectors to parent sector values.
  2. Updates disaggregate_pastureland() and disaggregate_cropland() so when a parameter is indicated to be dropped (like 1125 (aquaculture) in the water FBS method), that any parent sectors are also dropped, so the df is re-aggregated and outputs more accurate allocation ratios.

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney almost 3 years ago

flowsa - v1.1

New Features:

  • Data visualization functions
  • GitHub actions testing for python 3.7
  • Allow for .yaml files to recursively inherit other .yaml files. Keys in children will overwrite the same key from a parent.
  • Incorporate yaml anchors to simplify yamls method files by reducing duplicated information
  • Expand functionality of the FBA .yaml files to read in dictionary of relevant data table information to reduce hard coding in source.py files or requiring additional .yaml files with year-specific information
  • Add additional BEA government codes to stand in as sectors (S00101 - Federal electric utilities, S00202 - State and local government electric utilities)

Changes to functions:

  • Simplified all functions that load a specific dictionary into one function
  • Remove the duplicated information in function convert_fba_unit() and instead use standardize_units()
  • Rename find_true_file_path() to get_flowsa_base_name()
  • url_replace_fxn(), call_response_fxn(), and parse_response_fxn() now accept only keyword arguments, removing need for particular order for passing arguments
  • The subset of functions that begin with (url_replace_, call_response_, and parse_response_) now accept any number of keyword arguments, so now list only the set of argument that they actually need
  • move make_url_request() to EPA's esupy repository for use in other EPA LCIA tools

Minor Modifications:

  • Moved FBA/FBS methods out of data/ to separate methods/ directory
  • Modified code to PEP 8 styling
  • Remove memory cache when running FBAs
  • Rename all activity to sector mapping files to standardized naming convention NAICS_Crosswalk_DATASOURCE.csv
  • Update broken USGS links for MYB Zeolites and Gallium

New Contributors:
@matthewlchambers

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v1.0.1

This update addresses activity to sector mapping discrepancies that impact three FBS:

Water_national_20XX_m1:

  • addresses dropped sector in crop irrigation allocation (111940)
  • removes thermoelectric allocation to wind (221115)
  • drops allocation of crop irrigation for pastureland to aquaculture (1125) because aquaculture attributed separately

Water_national_20XX_m1 and Land_national_2012

  • adds orange groves and noncitrus groves to CoA and IWMS crosswalk for orchards (11131 and 11132)

Water_national_20XX_m2:

  • adds additional NAICS to Blackhurst IO crosswalk (21232 and 21239) and modifies activity to sector mapping for sectors 212210 and 213112

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v1.0.0

  1. Address duplication in USDA_ERS_MLU (changes results of Land_national_2012 FBS)
  2. Use a .env file to hold the API_Keys instead of .txt files (add .env to .gitignore), add an example .env file to 'examples' directory
  3. Use git describe to return package version number for use in meta and filename instead of manually updating a version number in common.py
  4. Adds a memory cache using 'joblib' so can quickly regenerate FBAs if url has already been called
  5. Two new package requirements joblib (for url memory cache) and python-dotenv (Reads .env files)
  6. New function "equal_allocation" that is called on in the "direct_allocation" method which will check if an Activity is being allocated to more than one sector and if so, will equally allocate the Activity FlowAmount to all sectors
  7. Add additional unit conversions in standardize_units()
  8. Address changes in USGS MYB urls

New Contributors:
Thanks to Andy Chase and David Graham for reviewing FLOWSA for the v1 release.

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.4.1

Changes from v0.4.1:

  1. Modified the NETL_EIA_PlantWater crosswalk sector assignments for "Municipal Solid Waste" (now NAICS 221117) and "Other Gases" (now 221112) (Changes results for FBS Water_national_2015_m3)
  2. Modified the USGS_NWIS_WU crosswalk sector assignment for "Thermoelectric Power". Assignment was to NAICS 2211, assignment changed to 221112, 221113, 221114, 221115, 221116, 221117, and 221118, so Thermoelectric water no longer allocated to hydroelectric or Electric Power Transmission, Control, and Distribution ((Changes results for FBS Water_national_2015_m1)

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.4.0

New Flow-By-Sectors:

  1. CNHW_CA_2014: Commercial non-hazardous waste, excluding construction activities for state of California
  2. CNHW_national_2014 (and 2017): Commercial non-hazardous waste, excluding construction activities
  3. CNHWC_national_2014: Commercial non-hazardous waste from construction activities
  4. Electricity_gen_emissions_national_2016: Import and format data from ElectricityLCI
  5. Water_national_2015_m3: Modified version of m1 where thermoelectric water use is allocated to NAICS6 using EIA Thermoelectric data modified by NETL (and used in electricityLCI) rather than equally allocating 4-digit NAICS to all 6-digit NAICS
  6. Water_state_2015_m1: Initial version of state level water withdrawal (not finalized)

Changes to Water_national_2015_m1:

  • drop consumptive water use for thermoelectric and irrigation due to limited data

New FBAs:

  1. USGS Minerals Yearbook
  2. NETL_EIA_PlantWater: thermoelectric plant water withdrawal/use
  3. EIA_MECS 2018 data
  4. EPA_CDDPath: Construction debris
  5. EPA Nitrogen and Phosphorus Inventories
  6. USDA_ACUP: Agricultural Chemical Program (Fertilizer and Pesticides)
  7. USGS_SPARROW data
  8. Census_VIP (Value of Construction)
  9. CalRecycle_WasteCharacterization (finalized version)

Other changes:

  • Implemented GitHub actions, auto test example builds for FBA and FBS
  • Implemented option to download missing local FBAs from Data Commons when generating a FBS
  • Option to map allocation source data to federal elementary flow list to standardize flowable/context columns for merging purposes
  • Add automated method of checking for and dropping duplicated information across activity sets during FBS creation
  • Moved functions from common.py to new settings.py

New Contributors:
Andrew Beck

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.3.2

Address import error:
ModuleNotFoundError: No module named 'flowsa.data_source_scripts'
that occurred with pip install of flowsa

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.3.1

  • convert NEI units to match those in fed mapping file
  • update assignment of PM overlap to include UUID and Flowable since it occurs after mapping
  • modify allocation of public supply deliveries to domestic in water methodology to correctly allocate to ground/surface water
  • address dropped Flowable for Employment FBS
  • new default column groupings for a FBA df mapped to fed flow list that include sector cols
  • update sourcename for "BEA_Use_Detail_PRO_BeforeRedef" FBA
  • modify usgs sodaash parsing to address error in 2017 data
  • option to ignore meta column in compare_FBS_results() fxn

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.3

Major changes:

  • Address esupy dependency conflict between stewi and flowsa
  • add function seeAvailableModels() to intit.py for use in the examples folder so users can find existing models
  • updates to Census PEP and Census CBP FBA addressing errors in creating FBAs for certain years (existing url calls overloaded the API and some years of data were not available)
  • within USDA_CoA_Cropland data, equally allocate parent NAICS to child NAICS when can't use 'Land in Farms' data. Reduces data loss for water methodology 'crop irrigation'
  • correct allocation error within Land_national_2012: area for urban land for residential housing should have been assigned a value from the American Housing Survey. Instead, the AHS value was subtracted from the total MLU activity. Correction results in reduction of 11.5% land assigned to urban residential housing
  • updates pandas and xlrd requirements to address any possible errors with loading xlsx and xls files

Minor changes:

  • modify FBS yaml to drop unnecessary parameters
  • moved some functions to new allocation.py file
  • renamed "mapping.py" to "sectormapping.py" to clarify sector mapping from fedefelm mapping
  • add explanations throughout water and land FBS for why FlowAmounts are modified
  • incorporate more validation checks within FBS.py

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.2.1

  • FBS includes FlowUUID column
  • All relevant files (json metadata and log) are also downloaded from Data Commons when downloading a parquet
  • New log file for code validation
  • No units are modified for any imported Flow-By-Activity
  • Addressed the Census_CBP FBA generation errors for 2010 and 2011

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.2

  • Generate Flow-By-Activity (FBA) metadata, store in user's local directory
  • Generate Flow-By-Sector (FBS) metadata by calling on previously generated FBA meta, store in user's local directory
  • Remove "date_generated" parameter from FBA method yaml, instead capture the date a dataset is generated in the meta
  • Add option to download FBA from Data Commons remote repository rather than running the FBA
  • Ensure all FBAs called on within a function for allocation purposes are captured within metadata and bibliography files
  • Dynamically import functions required to generate a FBA or FBS rather than importing all possible functions within flowbyactivity.py or flowbysector.py

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney over 3 years ago

flowsa - v0.1.1

Update to methodology in Land_national_2012 Flow-By-Sector for USDA_ERS_MLU Activity Set 3 ('Cropland used for pasture', 'Forest-use land grazed', 'Grassland pasture and range') :

  • Estimate suppressed data in USDA_CoA_Cropland_NAICS by equally allocating parent NAICS to child NAICS, reduces data loss from ~1% to 0%

Update to methodology in Land_national_2012 Flow-By-Sector for USDA_ERS_MLU Activity Set 1 and 2 (Cropland) :

  • Adds 'Berry Totals' and 'Orchards'

Update to methodology in Employment_national_2017 Flow-By-Sector to ensure all sectors are NAICS_2012_Code

Create Flow-By-Activity method yamls for FBAs previously created in the 'Scripts' directory to streamline FBA generation

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney about 4 years ago

flowsa - v0.1

Produces FlowBySector datasets for use in USEEIOv2.0.

  • Revised methodology for CAP_HAP_national_2017 and Land_national_2012
  • FLOWSA package restructured

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney about 4 years ago

flowsa - v0.0.2

Produces flowbysector datasets for use in USEEIOR0.2.0-v2a.
FlowBySector datasets:

  1. CAP_HAP_national_2017
  2. CRHW_national_2017
  3. Employment_national_2017
  4. GRDREL_national_2017
  5. Land_national_2012
  6. TRI_DMR_national_2017
  7. Water_national_2015_m1

Industrial Ecology - Life Cycle Assessment - Python
Published by catherinebirney about 4 years ago

flowsa - v0.0.1

Produces flowbyactivity datasets for four sources and six flowbyactivity file types for 1-2 years for each source.
See README for details.

Industrial Ecology - Life Cycle Assessment - Python
Published by WesIngwersen about 5 years ago