Skip to content

Importing GHGSat Data

Used for importing GHGSat emission data.

CSV Format

The following headers must be present in the CSV file, even though some of them can be blank:

HeaderTypeBlankHelp
Plume imageStringYESEach file referenced in this column must exist in the --data_path folder
Emission detectedBooleanNO(Yes/No) or (True, False)
LongitudeNumberNO
LatitudeNumberNO
Detection timestampDateNOISO format
Detected rateDecimalYESg/hr
Detected rate uncertaintyDecimalYESg/hr
Detection limitPositiveIntegerNOg/hr

Notes:

  • Owner column is required for self-reported emissions, but is optional for third party. If owner is present, any company found in the file must exist in the platform, or the import script will fail.
  • Any additional fields will be stored as extra data object.

Script Arguments

In addition to the common arguments (environment, api_key, data_path), the GHGSat script requires:

  • --data_source - Source of the data: SELF_REPORTED, THIRD_PARTY, or EPA
  • --contains_no_detects - Whether the data contains non-detects: 1 or 0

The following import parameters are set by the import script:

  • data_provider: "GHGSat"

Example

Example of calling the GHGSat script on dev environment:

bash
python -m importers.emissions.ghgsat --environment dev --api_key {API_KEY_VALUE} --data_path {PATH_TO_FOLDER} --data_source SELF_REPORTED --contains_no_detects 0