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)
[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
### Induced
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.
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.