Skip to content

Class: Geolocation

A geographic location associated with a dataset: a single point, a bounding box, or a polygon. Coordinates are WGS 84 decimal degrees. This mirrors the OSTI E-Link 2.0 Geolocation structure, adding optional accuracy values. Many legacy coordinates were backfilled from place names or site descriptions, so leave the accuracy slots empty when the accuracy is not known rather than guessing.

URI: [dcterms:Location](http://purl.org/dc/terms/Location)
classDiagram class Geolocation click Geolocation href "../Geolocation/" Geolocation : geolocation_type Geolocation --> "0..1" GeolocationTypeEnum : geolocation_type click GeolocationTypeEnum href "../GeolocationTypeEnum/" Geolocation : horizontal_accuracy Geolocation : label Geolocation : points Geolocation --> "1..*" GeoPoint : points click GeoPoint href "../GeoPoint/" Geolocation : vertical_accuracy
## Class Properties | Property | Value | | --- | --- | | Class URI | [dcterms:Location](http://purl.org/dc/terms/Location) | ## Slots | Name | Cardinality and Range | Description | Inheritance | | --- | --- | --- | --- | | [geolocation_type](geolocation_type.md) | 0..1
[GeolocationTypeEnum](GeolocationTypeEnum.md) | The shape of this geolocation | direct | | [label](label.md) | 0..1
[String](String.md) | Place name for this location or set of points | direct | | [points](points.md) | 1..*
[GeoPoint](GeoPoint.md) | The points defining this location, in order | direct | | [horizontal_accuracy](horizontal_accuracy.md) | 0..1
[Float](Float.md) | Horizontal accuracy of the coordinates, in meters: the radius within which th... | direct | | [vertical_accuracy](vertical_accuracy.md) | 0..1
[Float](Float.md) | Vertical accuracy of the altitude values, in meters | direct | ## Usages | used by | used in | type | used | | --- | --- | --- | --- | | [Dataset](Dataset.md) | [geolocations](geolocations.md) | range | [Geolocation](Geolocation.md) | ## Rules ### | Rule Applied | Preconditions | Postconditions | Elseconditions | |--------------|---------------|----------------|----------------| | slot_conditions |```{'geolocation_type': {'equals_string': 'POINT'}}``` |```{'points': {'minimum_cardinality': 1, 'maximum_cardinality': 1}}``` | | ### | Rule Applied | Preconditions | Postconditions | Elseconditions | |--------------|---------------|----------------|----------------| | slot_conditions |```{'geolocation_type': {'equals_string': 'BOX'}}``` |```{'points': {'minimum_cardinality': 2, 'maximum_cardinality': 2}}``` | | ### | Rule Applied | Preconditions | Postconditions | Elseconditions | |--------------|---------------|----------------|----------------| | slot_conditions |```{'geolocation_type': {'equals_string': 'POLYGON'}}``` |```{'points': {'minimum_cardinality': 4}}``` | | ## Identifier and Mapping Information ### Schema Source * from schema: https://w3id.org/brc/brc_schema ## Mappings | Mapping Type | Mapped Value | | --- | --- | | self | dcterms:Location | | native | brc:Geolocation | | close | schema:Place, osti:Geolocation | ## LinkML Source ### Direct
name: Geolocation
description: 'A geographic location associated with a dataset: a single point, a bounding
  box, or a polygon. Coordinates are WGS 84 decimal degrees. This mirrors the OSTI
  E-Link 2.0 Geolocation structure, adding optional accuracy values. Many legacy coordinates
  were backfilled from place names or site descriptions, so leave the accuracy slots
  empty when the accuracy is not known rather than guessing.'
from_schema: https://w3id.org/brc/brc_schema
close_mappings:
- schema:Place
- osti:Geolocation
attributes:
  geolocation_type:
    name: geolocation_type
    description: 'The shape of this geolocation. Optional, as the shape can be determined
      from the points: one point is a POINT; two points, the northwest and southeast
      corners, are a BOX; four or more points are a POLYGON. A POLYGON should begin
      and end on the same point, so that the shape is closed.'
    examples:
    - value: POINT
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:type
    rank: 1000
    domain_of:
    - Geolocation
    range: GeolocationTypeEnum
  label:
    name: label
    description: Place name for this location or set of points.
    examples:
    - value: Kellogg Biological Station, Hickory Corners, Michigan
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:label
    rank: 1000
    slot_uri: rdfs:label
    domain_of:
    - Geolocation
    range: string
  points:
    name: points
    description: The points defining this location, in order. One point for a POINT,
      two (northwest corner, then southeast corner) for a BOX, and four or more for
      a POLYGON, with the first point repeated as the last.
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:points
    rank: 1000
    domain_of:
    - Geolocation
    range: GeoPoint
    required: true
    multivalued: true
    inlined: true
    inlined_as_list: true
  horizontal_accuracy:
    name: horizontal_accuracy
    description: 'Horizontal accuracy of the coordinates, in meters: the radius within
      which the true location is expected to lie. Applies to every point in this geolocation.
      Not part of the OSTI schema, so it is not carried over to OSTI records.'
    examples:
    - value: '30'
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - dwc:coordinateUncertaintyInMeters
    rank: 1000
    domain_of:
    - Geolocation
    range: float
    minimum_value: 0
    unit:
      ucum_code: m
  vertical_accuracy:
    name: vertical_accuracy
    description: Vertical accuracy of the altitude values, in meters. Applies to every
      point in this geolocation that has an altitude. Not part of the OSTI schema,
      so it is not carried over to OSTI records.
    examples:
    - value: '5'
    from_schema: https://w3id.org/brc/brc_schema
    rank: 1000
    domain_of:
    - Geolocation
    range: float
    minimum_value: 0
    unit:
      ucum_code: m
class_uri: dcterms:Location
rules:
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: POINT
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 1
        maximum_cardinality: 1
  description: A POINT has exactly one point.
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: BOX
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 2
        maximum_cardinality: 2
  description: A BOX has exactly two points, the northwest and southeast corners.
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: POLYGON
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 4
  description: A POLYGON has at least four points, as it must close on its first point.

### Induced
name: Geolocation
description: 'A geographic location associated with a dataset: a single point, a bounding
  box, or a polygon. Coordinates are WGS 84 decimal degrees. This mirrors the OSTI
  E-Link 2.0 Geolocation structure, adding optional accuracy values. Many legacy coordinates
  were backfilled from place names or site descriptions, so leave the accuracy slots
  empty when the accuracy is not known rather than guessing.'
from_schema: https://w3id.org/brc/brc_schema
close_mappings:
- schema:Place
- osti:Geolocation
attributes:
  geolocation_type:
    name: geolocation_type
    description: 'The shape of this geolocation. Optional, as the shape can be determined
      from the points: one point is a POINT; two points, the northwest and southeast
      corners, are a BOX; four or more points are a POLYGON. A POLYGON should begin
      and end on the same point, so that the shape is closed.'
    examples:
    - value: POINT
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:type
    rank: 1000
    alias: geolocation_type
    owner: Geolocation
    domain_of:
    - Geolocation
    range: GeolocationTypeEnum
  label:
    name: label
    description: Place name for this location or set of points.
    examples:
    - value: Kellogg Biological Station, Hickory Corners, Michigan
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:label
    rank: 1000
    slot_uri: rdfs:label
    alias: label
    owner: Geolocation
    domain_of:
    - Geolocation
    range: string
  points:
    name: points
    description: The points defining this location, in order. One point for a POINT,
      two (northwest corner, then southeast corner) for a BOX, and four or more for
      a POLYGON, with the first point repeated as the last.
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - osti:points
    rank: 1000
    alias: points
    owner: Geolocation
    domain_of:
    - Geolocation
    range: GeoPoint
    required: true
    multivalued: true
    inlined: true
    inlined_as_list: true
  horizontal_accuracy:
    name: horizontal_accuracy
    description: 'Horizontal accuracy of the coordinates, in meters: the radius within
      which the true location is expected to lie. Applies to every point in this geolocation.
      Not part of the OSTI schema, so it is not carried over to OSTI records.'
    examples:
    - value: '30'
    from_schema: https://w3id.org/brc/brc_schema
    exact_mappings:
    - dwc:coordinateUncertaintyInMeters
    rank: 1000
    alias: horizontal_accuracy
    owner: Geolocation
    domain_of:
    - Geolocation
    range: float
    minimum_value: 0
    unit:
      ucum_code: m
  vertical_accuracy:
    name: vertical_accuracy
    description: Vertical accuracy of the altitude values, in meters. Applies to every
      point in this geolocation that has an altitude. Not part of the OSTI schema,
      so it is not carried over to OSTI records.
    examples:
    - value: '5'
    from_schema: https://w3id.org/brc/brc_schema
    rank: 1000
    alias: vertical_accuracy
    owner: Geolocation
    domain_of:
    - Geolocation
    range: float
    minimum_value: 0
    unit:
      ucum_code: m
class_uri: dcterms:Location
rules:
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: POINT
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 1
        maximum_cardinality: 1
  description: A POINT has exactly one point.
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: BOX
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 2
        maximum_cardinality: 2
  description: A BOX has exactly two points, the northwest and southeast corners.
- preconditions:
    slot_conditions:
      geolocation_type:
        name: geolocation_type
        equals_string: POLYGON
  postconditions:
    slot_conditions:
      points:
        name: points
        minimum_cardinality: 4
  description: A POLYGON has at least four points, as it must close on its first point.