> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sensorup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Model: Emission Observation

> A complete data dictionary for the Emission Observation model, detailing each field.

This model is designed to capture all relevant information about a single, detected emission event. It tracks the event from initial detection through compliance and resolution, linking it to specific assets and supporting media.

**Naming Convention:** The prefix `eo_` is consistently used to denote that these fields belong to the **E**mission **O**bservation entity.

## Field Documentation

<AccordionGroup>
  <Accordion title="eo_id — Observation ID">
    * **Description**: The unique, system-generated primary key for each emission observation record.
    * **Data Type**: `UUID` or `Integer`
    * **Deprecated**: No
    * **Example**: `a1b2c3d4-e5f6-7890-1234-567890abcdef`
  </Accordion>

  <Accordion title="eo_shortId — Short ID">
    * **Description**: A concise, human-readable identifier for the observation, often used for quick reference in reports and UI.
    * **Data Type**: `String`
    * **Deprecated**: No
    * **Example**: `OBS-2025-00123`
  </Accordion>

  <Accordion title="eo_assetReference — Asset Reference">
    * **Description**: A reference to the asset associated with the emission. This link is either provided directly by a third-party data source or is programmatically inferred by the SensorUp platform based on the geographical proximity of the emission to a known asset during data ingestion.
    * **Data Type**: `String`
    * **Deprecated**: No
    * **Notes**: Foreign Key to an 'Assets' table. Can be an ID or name.
  </Accordion>

  <Accordion title="eo_sourceAssetReference — Source Asset Reference">
    * **Description**: A reference to the most finite (granular) source of the emission as provided during data ingestion. This is often a specific piece of equipment, component, or instrument identified by a third-party data source.
    * **Data Type**: `String`
    * **Deprecated**: No
    * **Notes**: Foreign Key to an 'Assets' or 'Components' table.
  </Accordion>

  <Accordion title="eo_screeningId — Screening ID">
    * **Description**: An identifier that links this observation to a broader screening or inspection event.
    * **Data Type**: `String` or `Integer`
    * **Deprecated**: No
    * **Notes**: Foreign Key, likely referencing a 'Screening Events' table.
  </Accordion>

  <Accordion title="eo_detectedAt — Detection Timestamp">
    * **Description**: The exact date and time when the emission was first detected by the source asset.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: No
    * **Example**: `2025-06-23T10:15:00Z`
  </Accordion>

  <Accordion title="eo_startTime — Event Start Time">
    * **Description**: The official start time of the emission event being observed.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: No
    * **Example**: `2025-06-23T10:14:30Z`
  </Accordion>

  <Accordion title="eo_endTime — Event End Time">
    * **Description**: The official end time of the emission event. This may be `null` if the emission is ongoing.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: No
    * **Example**: `2025-06-23T11:05:00Z` or `null`
  </Accordion>

  <Accordion title="eo_detectionType — Detection Type">
    * **Description**: The method or technology used to detect the emission.
    * **Data Type**: `Enum` / `String`
    * **Deprecated**: No
    * **Notes**: Recommended Enum: `['OGI', 'Sensor', 'Aerial', 'Manual', 'Auditory']`
  </Accordion>

  <Accordion title="eo_inputType — Input Type">
    * **Description**: Describes how the observation data was entered into the system.
    * **Data Type**: `Enum` / `String`
    * **Deprecated**: No
    * **Notes**: Recommended Enum: `['Automated Feed', 'Manual Entry', 'File Upload']`
  </Accordion>

  <Accordion title="eo_detectionSource — Detection Source Name">
    * **Description**: A descriptive name for the specific source of the detection (e.g., a sensor ID or operator's name).
    * **Data Type**: `String`
    * **Deprecated**: No
    * **Example**: `"Drone #A42-ZULU"`, `"Sensor #GH-5501"`
  </Accordion>

  <Accordion title="eo_emissionsRate — Emissions Rate">
    * **Description**: The quantified rate of the emission. Units should be standardized across the system.
    * **Data Type**: `Float` or `Decimal`
    * **Deprecated**: No
    * **Example**: `15.75` (Units like kg/hr or scfh should be explicit).
  </Accordion>

  <Accordion title="eo_status — Status">
    * **Description**: The current workflow status of the emission observation.
    * **Data Type**: `Enum` / `String`
    * **Deprecated**: No
    * **Notes**: Recommended Enum: `['New', 'Investigating', 'Resolved', 'Closed']`
  </Accordion>

  <Accordion title="eo_createdBy — Created By">
    * **Description**: The user ID or process that created the record in the system.
    * **Data Type**: `String` or `Integer`
    * **Deprecated**: No
    * **Notes**: Foreign Key to a 'Users' table or system process name.
  </Accordion>

  <Accordion title="eo_createdTime — Created Timestamp">
    * **Description**: The timestamp of when this observation record was created in the system.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: No
    * **Example**: `2025-06-23T14:35:00Z`
  </Accordion>

  <Accordion title="eo_updatedBy — Updated By">
    * **Description**: The last user or process that updated this record.
    * **Data Type**: `String` or `Integer`
    * **Deprecated**: No
    * **Notes**: Foreign Key to a 'Users' table.
  </Accordion>

  <Accordion title="eo_updatedTime — Updated Timestamp">
    * **Description**: The timestamp of the most recent update made to this record.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: No
    * **Example**: `2025-06-23T14:35:00Z`
  </Accordion>

  <Accordion title="eo_s3MediaUrls — Media URLs">
    * **Description**: A list of Uniform Resource Locators (URLs) pointing to supporting media files (e.g., images, videos) stored in an AWS S3 bucket.
    * **Data Type**: `Array` of `String` (URL)
    * **Deprecated**: No
    * **Example**: `["https://.../img1.jpg", "https://.../vid1.mp4"]`
  </Accordion>

  <Accordion title="eo_emissionEventId — Emission Event ID">
    * **Description**: An identifier used to group multiple, related observations into a single overarching emission event.
    * **Data Type**: `String` or `Integer`
    * **Deprecated**: No
    * **Example**: `EVT-LEAK-558`
  </Accordion>
</AccordionGroup>

### Deprecated Fields

The following fields are deprecated and should not be used for new development. They are maintained for historical data purposes only.

<AccordionGroup>
  <Accordion title="eo_lastComplianceActionAt — Last Compliance Action">
    * **Description**: The timestamp of the most recent compliance-related action taken for this observation.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: Yes
  </Accordion>

  <Accordion title="eo_complianceDeadline — Compliance Deadline">
    * **Description**: The regulatory or internal deadline by which compliance actions must be completed for this observation.
    * **Data Type**: `Date` or `Timestamp`
    * **Deprecated**: Yes
  </Accordion>

  <Accordion title="eo_acknowledged — Is Acknowledged?">
    * **Description**: A flag indicating whether a user has officially reviewed and acknowledged the observation.
    * **Data Type**: `Boolean`
    * **Deprecated**: Yes
  </Accordion>

  <Accordion title="eo_equipmentComponentName — Equipment Component">
    * **Description**: The specific name or identifier of the equipment component associated with the emission.
    * **Data Type**: `String`
    * **Deprecated**: Yes
  </Accordion>

  <Accordion title="eo_acknowledgedBy — Acknowledged By">
    * **Description**: The user ID or name of the person who acknowledged the emission observation.
    * **Data Type**: `String` or `Integer`
    * **Deprecated**: Yes
  </Accordion>

  <Accordion title="eo_acknowledgedTime — Acknowledged Timestamp">
    * **Description**: The date and time when the observation was acknowledged by a user.
    * **Data Type**: `Timestamp` (ISO 8601)
    * **Deprecated**: Yes
  </Accordion>
</AccordionGroup>