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:

Header	Type	Blank	Help
Plume image	String	YES	Each file referenced in this column must exist in the --data_path folder
Emission detected	Boolean	NO	(Yes/No) or (True, False)
Longitude	Number	NO
Latitude	Number	NO
Detection timestamp	Date	NO	ISO format
Detected rate	Decimal	YES	g/hr
Detected rate uncertainty	Decimal	YES	g/hr
Detection limit	PositiveInteger	NO	g/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:

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

Related documentation

• Troubleshooting — common errors and solutions
• Matching — how imported emissions are matched to infrastructure