GML: Classes and Construction Functions from the GML Namespace

In sos4R: Client for OGC Sensor Observation Services

Description

Classes for GML elements and their respective construction functions. See the referenced specification for details.

Usage

GmlDirectPosition(pos, srsName = as.character(NA), srsDimension = NA_integer_,
                  axisLabels = as.character(NA), uomLabels = as.character(NA))
GmlDirectPositionLatLon(lat, lon, srsName = as.character(NA),
                        srsDimension = NA_integer_,
                        axisLabels = as.character(NA),
                        uomLabels = as.character(NA))
GmlEnvelope(lowerCorner, upperCorner, srsName = as.character(NA),
            srsDimension = NA_integer_, axisLabels = as.character(NA),
            uomLabels = as.character(NA))
GmlFeatureCollection(featureMembers, id = as.character(NA))
GmlPoint(pos, id = as.character(NA), srsName = as.character(NA),
         srsDimension = NA_integer_, axisLabels = as.character(NA),
         uomLabels = as.character(NA))
GmlPointProperty(href = as.character(NA), point = NULL)
GmlFeatureProperty(href = as.character(NA), feature = NULL)
GmlTimeInstant(timePosition, id = as.character(NA), relatedTimes = list(NA),
               frame = as.character(NA))
GmlTimeInstantProperty(href = as.character(NA), time = NULL)
GmlTimeInterval(interval, unit, radix = NA, factor = NA)
GmlTimePeriod(begin = NULL, beginPosition = NULL, end = NULL,
              endPosition = NULL, duration = as.character(NA),
              timeInterval = NULL, id = as.character(NA),
              relatedTimes = list(NA), frame = as.character(NA))
GmlTimePosition(time, frame = as.character(NA),
                calendarEraName = as.character(NA),
                indeterminatePosition = as.character(NA))
GmlMeasure(value, uom)

Arguments

axisLabels	See corresponding slot description.
begin	See corresponding slot description.
beginPosition	See corresponding slot description.
calendarEraName	See corresponding slot description.
duration	See corresponding slot description.
end	See corresponding slot description.
endPosition	See corresponding slot description.
factor	See corresponding slot description.
feature	See corresponding slot description.
featureMembers	See corresponding slot description.
frame	See corresponding slot description.
href	See corresponding slot description.
id	See corresponding slot description.
indeterminatePosition	See corresponding slot description.
interval	See corresponding slot description.
lat	Latitude coordinate parameter.
lon	Longitue coordinate parameter.
lowerCorner	See corresponding slot description.
point	See corresponding slot description.
pos	See corresponding slot description.
radix	See corresponding slot description.
relatedTimes	See corresponding slot description.
srsDimension	See corresponding slot description.
srsName	See corresponding slot description.
time	See corresponding slot description.
timeInterval	See corresponding slot description.
timePosition	See corresponding slot description.
unit	See corresponding slot description.
uomLabels	See corresponding slot description.
upperCorner	See corresponding slot description.
value	See slot description.
uom	See slot description.

Details

The "...OrNULL" classes are used to model optional slots.

Value

The construction functions return an object of the respective class.

Objects from this classes

Objects can be created by calling the according construction functions. e.g. in the form GmlPoint(...).

Extends

GmlFeature: Class "GmlFeatureOrNULL", directly.

GmlFeatureCollection: Class "GmlFeature", directly. Class "GmlFeatureOrNULL", by class "GmlFeature", distance 2.

GmlLineString: Class "GmlGeometry", directly.

GmlPoint: Class "GmlGeometry", directly.

GmlTimeGeometricPrimitive: Class "GmlTimePrimitive", directly. Class "GmlTimeObject", by class "GmlTimePrimitive", distance 2. Class "GmlTimeObjectOrNULL", by class "GmlTimePrimitive", distance 3.

GmlTimeInstant: Class "GmlTimeGeometricPrimitive", directly. Class "GmlTimeInstantOrNULL", directly. Class "GmlTimePrimitive", by class "GmlTimeGeometricPrimitive", distance 2. Class "GmlTimeObject", by class "GmlTimeGeometricPrimitive", distance 3. Class "GmlTimeObjectOrNULL", by class "GmlTimeGeometricPrimitive", distance 4.

GmlTimeInstantProperty: Class "GmlTimeGeometricPrimitive", directly. Class "GmlTimeInstantPropertyOrNULL", directly. Class "GmlTimePrimitive", by class "GmlTimeGeometricPrimitive", distance 2. Class "GmlTimeObject", by class "GmlTimeGeometricPrimitive", distance 3. Class "GmlTimeObjectOrNULL", by class "GmlTimeGeometricPrimitive", distance 4.

GmlTimeInterval: Class "GmlTimeIntervalOrNULL", directly.

GmlTimeObject: Class "GmlTimeObjectOrNULL", directly.

GmlTimePrimitive: Class "GmlTimeObject", directly. Class "GmlTimeObjectOrNULL", by class "GmlTimeObject", distance 2.

Virtual Classes

No objects may be created from the following virtual classes: GmlFeature, GmlTimeObject, GmlTimePrimitive, GmlTimeGeometricPrimitive, GmlGeometry, all ...OrNULL classes.

Slots

axisLabels:

Object of class "character": An character vector of labels for all the axes of this CRS.

begin:

Object of class "GmlTimeInstantPropertyOrNULL": An object of class GmlTimeInstantProperty-class, the start time of a GmlTimePeriod-class.

beginPosition:

Object of class "GmlTimePositionOrNULL": An object of class GmlTimePosition-class, the start time of a GmlTimePeriod-class.

calendarEraName:

Object of class "character": The name of the calendar era.

duration:

Object of class "character": Duration of an interval using ISO 8601 syntax for temporal length.

end:

Object of class "GmlTimeInstantPropertyOrNULL": An object of class GmlTimeInstantProperty-class, the end time of a GmlTimePeriod-class.

endPosition:

Object of class "GmlTimePositionOrNULL": An object of class GmlTimePosition-class, the end time of a GmlTimePeriod-class.

exterior:

Object of class "ANY" for future use in GmlPolygon.

factor:

Object of class "integer": Factor parameter for a GmlTimeInterval-class. The resolution of the time interval is to one radix ^(-factor) of the specified time unit.

feature:

Object of class "GmlFeatureOrNULL": The directly contained feature in a GmlFeature-class.

featureMembers:

Object of class "list": A list of GmlFeature-class in a GmlFeatureCollection-class.

frame:

Object of class "character": Provides a URI reference that identifies a description of the reference system.

href:

Object of class "character": Reference to a property.

id:

Object of class "character": The identifier/id attribute (gml:id).

indeterminatePosition:

Object of class "character": Inexact temporal positions may be expressed using the optional indeterminatePosition parameter. This takes one of the following values: after, before, now, unknown.

interior:

Object of class "ANY" for future use in GmlPolygon.

interval:

Object of class "character": Interval parameter for a GmlTimeInterval-class.

lowerCorner:

Object of class "GmlDirectPosition": Object of class GmlDirectPosition-class, the lower (left) corner of an GmlEnvelope-class.

point:

Object of class "ANY": An object of class GmlPoint in a GmlPointProperty-class.

points:

Object of class "list" A list of positions for future use in GmlLineString.

posList:

Object of class "ANY": A list of positions for future use in GmlLineString.

pos:

Object of class "character": Character string containing the coordinates in a GmlDirectPosition-class, or a GmlDirectPosition-class in a GmlPoint-class.

poss:

Object of class "list": A list of positions for future use in GmlLineString.

radix:

Object of class "integer": Radix parameter for a GmlTimeInterval-class. The resolution of the time interval is to one radix ^(-factor) of the specified time unit.

relatedTimes:

Object of class "list": List of related times.

srsDimension:

Object of class "integer": Dimensions of the coordinate reference system as stated in the coordinate reference system definition., e.g. 2.

srsName:

Object of class "character": Name of the spatial reference system for bounding box, e.g. "urn:ogc:def:crs:EPSG:4326".

timeInterval:

Object of class "GmlTimeIntervalOrNULL": Time interval element in a GmlTimePeriod-class, an object of class GmlTimeInterval-class.

time:

Object of class "GmlTimeInstantOrNULL": The actual time as an object of class POSIXt in a GmlTimePosition-class, or an object of class GmlTimeInstant-class in a GmlTimeInstantProperty-class.

timePosition:

Object of class "GmlTimePosition": An object of class GmlTimePosition-class in a GmlTimeInstant-class.

unit:

Object of class "character": Unit parameter for a GmlTimeInterval-class.

uomLabels:

Object of class "character": Unit of measurement labels as an ordered character vector for the axes in a bounding box, e.g. "deg".

upperCorner:

Object of class "GmlDirectPosition": Object of class GmlDirectPosition-class, the upper (right) corner of an GmlEnvelope-class.

uom:

Object of class "character": The unit of measurement in a OmMeasure object.

uom:

Object of class "character": The unit of measurement in a GmlMeasure object.

value:

Object of class "numeric": The actual value in a GmlMeasure object.

Methods

encodeXML

signature(obj = "GmlDirectPosition", sos = "SOS") or signature(obj = "GmlEnvelope", sos = "SOS") and more: Convert the given element to an XML respresentaion, and XML “encoding”.

Author(s)

Daniel Nuest [e-mail]

References

GML specification at https://www.opengeospatial.org/standards/gml.

Examples

showClass("GmlDirectPosition")
showClass("GmlEnvelope")
showClass("GmlFeature")
showClass("GmlFeatureCollection")
showClass("GmlFeatureOrNULL")
showClass("GmlFeatureProperty")
showClass("GmlGeometry")
showClass("GmlLineString")
showClass("GmlPoint")
showClass("GmlPointProperty")
showClass("GmlPolygon")
showClass("GmlTimeGeometricPrimitive")
showClass("GmlTimeInstant")
showClass("GmlTimeInstantOrNULL")
showClass("GmlTimeInstantProperty")
showClass("GmlTimeInstantPropertyOrNULL")
showClass("GmlTimeInterval")
showClass("GmlTimeIntervalOrNULL")
showClass("GmlTimeObject")
showClass("GmlTimeObjectOrNULL")
showClass("GmlTimePeriod")
showClass("GmlTimePosition")
showClass("GmlTimePositionOrNULL")
showClass("GmlTimePrimitive")

# create direct position
pos1 <- GmlDirectPosition(pos = "7.0 52.0")
show(pos1)

# create envelope
env1 <- GmlEnvelope(upperCorner = pos1,
                    lowerCorner = GmlDirectPosition("6.0 51.0"))
print(env1)

# create envelope with CRS and access it
env1 <- GmlEnvelope(upperCorner = pos1,
                    lowerCorner = GmlDirectPosition("6.0 51.0"),
                    srsName = "http://www.opengis.net/def/crs/EPSG/0/4326")
sosGetCRS(env1)

# wrap elements in feature collection
GmlFeatureCollection(id = "001", featureMembers=list(pos1, env1))

# create point with ID
point1 <- GmlPoint(pos = pos1, id = "002")

# create point properties
GmlPointProperty(href = "http://link.to/point")
GmlPointProperty(point = point1)

# time interval of one day
GmlTimeInterval(interval = "1", unit = "d")

# referenced feature
GmlFeatureProperty(href = "http://link.to/feature")

# create a time position and wrap it into a time instant
timePos1 <- GmlTimePosition(time = as.POSIXct("2010-01-01"))

# create direct or referenced time instant
timeInst1 <- GmlTimeInstant(timePosition = timePos1)
timeInst1

GmlTimeInstantProperty(href = "http://link.to/timeInstant")

# create different variants of time periods
# one hour with time positions
GmlTimePeriod(beginPosition = timePos1,
              endPosition = GmlTimePosition(time = timePos1@time+3600))

# one week backwards from now
timePos <- GmlTimePosition(time = Sys.time()-(3600*24*7))
aWeekAgo <- GmlTimeInstantProperty(time = GmlTimeInstant(time = timePos))
timePos <- GmlTimePosition(time = Sys.time())
now <- GmlTimeInstantProperty(time = GmlTimeInstant(time = timePos))
GmlTimePeriod(begin = aWeekAgo, end = now)

sos4R documentation built on July 9, 2020, 5:07 p.m.