GeoLocator-DP/staps-table-schema.json at main · GeoPressure/GeoLocator-DP · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
{
  "name": "staps",
  "title": "Stationary periods",
  "description": "A stationary period (`stap`) is [a key concept in the GeoPressureR workflow](https://geopressure.com/GeoPressureManual/tag-object#label-tag-into-stationary-periods) that discretizes a bird trajectory in time and space. During a single `stap`, the bird is assumed to remain at the same location (+/- tens of kilometers). [`flight`](https://geopressure.com/GeoPressureR/reference/stap2flight) is the converse of `stap`, with `flight.start` corresponding to a `stap.end`, and vice versa.\n\n{:.alert .alert-info}\n`stap_id` is indexed within each `tag_id` (it is not globally unique), so the table key is the composite pair (`tag_id`, `stap_id`). `staps` are typically estimated by [`GeoPressureR::tag_label_stap()`](https://geopressure.com/GeoPressureR/reference/tag_label_stap) based on the `'flight'` labels assigned to pressure or acceleration measurements ([`measurements.label`](/GeoLocator-DP/core/measurements#label)). See the [GeoPressureManual](https://geopressure.com/GeoPressureManual/labelling-tracks) for more details.",
  "$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": "stap_id",
      "description": "Identifier of the stationary period for a given `tag_id`.",
      "type": "number",
      "constraints": {
        "required": true,
        "minimum": 1
      },
      "example": "3"
    },
    {
      "name": "start",
      "description": "Date and time of the start of the stationary period. Formatted as an ISO 8601 string with timezone designator `YYYY-MM-DDThh:mm:ssZ`.",
      "type": "datetime",
      "constraints": {
        "required": true
      },
      "example": "2020-04-01T05:50:00Z",
      "skos:closeMatch": "http://vocab.nerc.ac.uk/collection/MVB/current/MVB000200"
    },
    {
      "name": "end",
      "description": "Date and time of the end of the stationary period. Formatted as an ISO 8601 string with timezone designator `YYYY-MM-DDThh:mm:ssZ`.",
      "type": "datetime",
      "constraints": {
        "required": true
      },
      "example": "2020-04-02T21:18:00Z",
      "skos:closeMatch": "http://vocab.nerc.ac.uk/collection/MVB/current/MVB000200"
    },
    {
      "name": "known_lat",
      "description": "Latitude of the known stationary period. This value is typically assigned by [`GeoPressureR::tag_set_map()`](https://geopressure.com/GeoPressureR/reference/tag_set_map).",
      "type": "number",
      "constraints": {
        "required": false,
        "minimum": -90,
        "maximum": 90
      },
      "example": "52.70442",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/decimalLatitude"
    },
    {
      "name": "known_lon",
      "description": "Longitude of the known stationary period. This value is typically assigned by [`GeoPressureR::tag_set_map()`](https://geopressure.com/GeoPressureR/reference/tag_set_map).",
      "type": "number",
      "constraints": {
        "required": false,
        "minimum": -180,
        "maximum": 180
      },
      "example": "23.84995",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/decimalLongitude"
    }
  ],
  "missingValues": ["", "NA"],
  "foreignKeys": [
    {
      "fields": "tag_id",
      "reference": {
        "resource": "tags",
        "fields": "tag_id"
      }
    }
  ],
  "primaryKey": ["tag_id", "stap_id"],
  "fieldsMatch": ["superset"]
}