twilights-table-schema.json

{
  "name": "twilights",
  "title": "Twilights",
  "description": "Table containing twilight data inferred from light data for all tags. Twilight data is typically computed with [`GeoPressureR::twilight_create()`](https://geopressure.com/GeoPressureR/reference/twilight_create.html).",
  "$schema": "https://datapackage.org/profiles/2.0/tableschema.json",
  "fields": [
    {
      "name": "tag_id",
      "description": "Unique identifier of the tag. Foreign key to [`tags.tag_id`](/GeoLocator-DP/core/tags#tag_id).",
      "type": "string",
      "constraints": {
        "required": true
      },
      "example": "18LX"
    },
    {
      "name": "twilight",
      "description": "Date and time of the twilight event. Formatted as an ISO 8601 string with timezone designator `YYYY-MM-DDThh:mm:ssZ`.",
      "type": "datetime",
      "constraints": {
        "required": true
      },
      "example": "2020-04-01T22:00:00Z",
      "skos:closeMatch": "http://vocab.nerc.ac.uk/collection/MVB/current/MVB000200"
    },
    {
      "name": "rise",
      "description": "Boolean value to indicate if the twilight is a sunrise (true) or sunset (false).",
      "type": "boolean",
      "constraints": {
        "required": true
      },
      "example": "true"
    },
    {
      "name": "label",
      "description": "Labeling of twilight data according to the [GeoPressureManual](https://geopressure.com/GeoPressureManual/light-map.html#manual-labelling-of-twilight). The value `discard` indicates that the twilight should not be used for geopositioning. Any other value can be used without affecting the workflow; setting it to `stap_id` typically helps visualize which twilights belong to the same stationary period in the training set.",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "discard"
    }
  ],
  "missingValues": ["", "NA"],
  "foreignKeys": [
    {
      "fields": "tag_id",
      "reference": {
        "resource": "tags",
        "fields": "tag_id"
      }
    }
  ],
  "fieldsMatch": ["superset"]
}