Merge pull request #38 from USEPA/import_factors

Adding import factor format spec

import_factors_exio/README.md

@@ -1,6 +1,8 @@
 # Generating Import Emission Factors from Exiobase
 To generate import emission factors from exiobase, run the script [generate_import_factors.py](generate_import_factors.py) 
 
+An import factor is created for an environmental flow (e.g., Carbon dioxide) in units of that flow per USD (e.g., kg/USD).
+
 For each year, the following files are generated:
 
 - *US_detail_import_factors_exio_{year}.csv*: Single set of import factors for the US by detail sector.
@@ -12,6 +14,23 @@ For each year, the following files are generated:
 
 File names are appended with the BEA schema year, e.g., `_17sch`.
 
+The field in the *_import_factors* files are defined as
+
+| Field | Description | Example
+| --- | --- | ---
+| Sector | USEEIO sector code | `325111`
+| Year | Year of data | 2021
+| Unit | Numerator unit for Import factor | kg
+| ReferenceCurrency | Denominator unit for Import factor | USD
+| PriceType | Price type of ReferenceCurrency | Basic
+| Flowable | Name of substance | Carbon dioxide
+| Context | Environmental compartment to or from | air
+| FlowUUID | ID from FEDEFL | b6f010fb-a764-3063-af2d-bcb8309a97b7
+| FlowAmount | Import factor value | 0.57
+| BaseIOLevel | BEA IO table basis | Detail
+
+The environmental flows fields are the same as those used for USEEIO which are from the [Federal LCA Commons Elementary Flow List](https://github.com/USEPA/fedelemflowlist).
+
 ## BEA API Access
 To make calls to BEA for service imports data (by BEA service category, country, and year), users must first register at https://apps.bea.gov/api/signup/.
 After doing so, users will be provided with an API key to the provided email.

import_factors_exio/concordances/README.md

@@ -0,0 +1,29 @@
+# Concordance Files between databases
+
+## [BEA Services Sector Concordance](BEA_service_to_useeio2_sector_concordance.csv)
+
+| Field | Description
+| --- | --- 
+| BEA Service | Full name of the BEA Service category
+| API BEA Service | Short name of the BEA Service category returned by the API
+| BEA Detail 2012 | Assigned BEA sector code from the 2012 schema
+| BEA Detail 2017 | Assigned BEA sector code from the 2017 schema
+
+## [EXIOBASE to USEEIOv2.0 Commodity Concordance](exio_to_useeio2_commodity_concordance.csv)
+
+| Field | Description
+| --- | --- 
+| Exiobase Sector | Full name of the BEA Service category
+| USEEIO_Detail_2012 | Assigned USEEIO code from the 2012 schema
+| USEEIO_Detail_2017 | Assigned USEEIO code from the 2017 schema
+
+## [EXIOBASE Country/Region to BEA Service, Census Goods and TiVA trade region Concordance](exio_country_concordance.csv)
+
+| Field | Description
+| --- | ---
+| Country | Country name provided by BEA or Census
+| ISO Code | ISO code of the `Country`
+| Country Code | Code used to identify the country/region in EXIOBASE
+| Region | TiVA trade region for the Country Code
+
+