Skip to content

ModelEarth/flowsa

 
 

Repository files navigation

flowsa

flowsa attributes resource use, waste, emissions, and loss to economic sectors. It produces standard tabular formats with sector attribution data using pandas dataframes.

Installation, Examples, Detailed Documentation

For installation instructions, example code, and further explanation of the code, see the wiki.

Terms

flows: represent the physical movement of material, energy, entities or money as input or output to or between activities. The terms flows comes from life cycle assessment (ISO 14044).

sectors: generally these are economic sectors generating economic activity, but are extended here to include households and institutional end users. Using the BEA definitions in input-output tables, these can be either industries or commodities.

attribution: The sectors through which activity uses, produces or receives the flows (input or output).

Flow Classes

Class Description FlowBySector Reference Unit Flow Types
Chemicals Chemicals and groups of chemicals as defined in the Federal Elementary Flow List kg Modeled as ELEMENTARY_FLOWS produced by sectors
Employment Jobs p Modeled as ELEMENTARY_FLOWS produced by sectors
Energy Energy consumption, transfer as electricity or waste heat MJ All types
Geological Mineral and metal use kg All types
Land Land area occupied m2 Modeled as ELEMENTARY_FLOWS consumed by sectors
Money Purchases USDyear* Modeled as TECHNOSPHERE_FLOWS with producing and consuming sectors
Water Water use and release data, including wastewater kg All types
Other Misc flows used for supporting data varies All types

*USD unit value varies by year and is reported like 'USD2012'

FlowByActivity Datasets

Source data are imported and formatted into FlowByActivity datasets. The source data are only modified to meet column formatting criteria, meaning units are not standardized across "Class" types.

Code Dataset Class Geographic Scale Description 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019
Blackhurst_IO Input-Output Vector of 2002 Water Withdrawals for the United States Water National
BLM_PLS Bureau of Land Management Public Land Statistics Land National X
BEA_GDP Bureau of Economic Analysis GDP Money National
BEA_GDP_GrossOutput Bureau of Economic Analysis GDP Gross Output Money National
BEA_Use Bureau of Economic Analysis Use Money National X X
BEA_Use_Detail_PRO_BeforeRedef Bureau of Economic Analysis Use Before Redefinitions Money National
BEA_Make_Detail_BeforeRedef Bureau of Economic Analysis Make Before Redefinitions Money National
BLS_QCEW Bureau of Labor Statistics Quarterly Census of Employment and Wages Employment, Money, Other County Number of employees per industry X X
Census_CBP Census Bureau County Business Patterns Employment, Money, Other County Number of employees per industry, Annual payroll per industry, Number of establishments per industry X
Census_PEP_Population Census Bureau Population Estimates Other County Population X X X X X X X X X X
EIA_CBECS_Land Energy Information Administration Commercial Buildings Energy Consumption Survey
EIA_CBECS_Water Energy Information Administration Commercial Buildings Energy Consumption Survey Water Country Water consumption in large buildings X
EIA_MECS_Energy Energy Information Administration Manufacturing Energy Consumption Survey Energy, Other Region Fuel and nonfuel consumption of energy flows by manufacturing industries X X
EIA_MECS_Land Energy Information Administration Manufacturing Energy Consumption Survey Land National, Regional
EIA_MER Energy Information Administration Monthly Energy Review Energy National
EPA_GHGI Inventory of U.S. Greenhouse Gas Emissions and Sinks Chemicals, Energy, Other National
EPA_NEI_Nonpoint Environmental Protection Agency National Emissions Inventory Nonpoint sources Chemicals County Air emissions of criteria pollutants, criteria precursors, and hazardous air pollutants X
EPA_NEI_Nonroad Environmental Protection Agency National Emissions Inventory Nonroad sources Chemicals County Air emissions of criteria pollutants, criteria precursors, and hazardous air pollutants X
EPA_NEI_Onroad Environmental Protection Agency National Emissions Inventory Onroad sources Chemicals County Air emissions of criteria pollutants, criteria precursors, and hazardous air pollutants X
NOAA_FisheryLandings National Oceanic and Atmospheric Administration Fisheries Money State Fishery landings X X X X X X X X X X
StatCan_GDP Statistics Canada Gross Domestic Product Money Canada
StatCan_IWS_MI Statistics Canada Industrial Water Survey Water Country Water use by NAICS X X X
StatCan_LFS Statistics Canada Labour Force Study Employment Canada
USDA_CoA_Cropland USDA Census of Agriculture Land, Other County Crop area by farm size and irrigation status X X
USDA_CoA_Cropland_NAICS USDA Census of Agriculture
USDA_CoA_Livestock USDA Census of Agriculture Other County Livestock count by farm size X X
USDA_ERS_FIWS USDA Farm Income and Wealth Statistics Money National
USDA_ERS_MLU USDA Major Land Use Land National
USDA_IWMS USDA Irrigation and Water Management Survey Water State Water application rate by state and crop X X
USGS_NWIS_WU US Geological Survey Water Use in the US Water County Annual national level water use by various activities X X
USGS_WU_Coef USDA Water Use Coefficients Water National

FlowByActivity Naming Convention

Source dataset names are consistent across (1) the FlowByActivity dataset 'SourceName' columns, (2) the parquet file names, (3) the Crosswalk file names, and (4) the Source Catalog information. Source names are comprised of two or three components. The first part of the name is the agency that published the data. The second component is the name or acronym of the published dataset. The third piece of the naming schema, if it exists, is the topic of data parsed from the original dataset. Of the four FlowByActivity datasets imported from the U.S. Department of Agriculture (USDA), three are data pulled from the same dataset, the Census of Agriculture (CoA). To make data easier to find, the CoA data is separated by topic (Cropland, Livestock, Product Market Value). As the FlowByActivity datasets are grouped by topic, some of the parquets contain multiple class types, meaning the Class type should be specified when calling on the data. The USDA_CoA_Cropland dataframe includes acreage information for crops (Class = Land) and the number of farms that grow a particular crop (Class = Other).

FlowBySector Datasets

Environmental data attributed to North American Industrial Classification (NAICS) Codes, formatted into standard FlowBySector datasets.

Description Code Years Number of methods of sector allocation
Criteria and hazardous air emissions CAP_HAP_national 2017 1
Employment Employment_national 2017 1
Land use Land_national 2012 1
Water withdrawal Water_national 2010, 2015 2
Water withdrawal Water_state 2015 1
Point source releases to water TRI_DMR_national 2017 1
Commercial RCRA-defined hazardous waste CRHW_national 2017 1
Point source industrial releases to ground GRDREL_national 2017 1

Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 95.1%
  • Jupyter Notebook 4.9%