Deformation Monitoring Entities
The data structures of DMPACK are based on the following entities. The
date and time format used internally is a 32-characters long ISO 8601 time stamp
in microsecond resolution, with time separator T
and mandatory GMT offset, for
example, 1970-01-01T00:00:00.000000+00:00
. The human-readable output format
1970-01-01 00:00:00 +00:00
is used where reasonable. Global coordinates are in
longitude/latitude order (east-west/north-south order).
Observation Entities
- Node
-
A unique sensor node within a sensor network. Contains id, name, description, and optional position.
- Sensor
-
A unique sensor attached to a node, with id, name, description, and optional position.
- Target
-
A unique measurement target (point of interest, location) with id, name, description, and optional position. Multiple nodes and sensors may share a single target.
- Observation
-
A single measurement identified by name and unique UUID identifier that contains requests to and responses from a sensor, referencing a node, a sensor, and a target. An observation can contain up to 8 requests which will be sent to the sensor in sequential order.
- Request
-
Command to send to the sensor, referencing an observation and ordered by index. A request can contain up to 16 responses.
- Response
-
Floating-point values in the raw response of a sensor can be matched by regular expression groups. Each matched group is stored as a response. Responses reference a request, and are ordered by index. They contain name, type, value, unit, and an optional error code.
Log Entities
- Log
-
Log message of a sensor node, either of level debug, info, warning, error, critical, or user, and optionally related to a sensor, a target, and an observation.
Beat Entities
- Beat
-
Short status message (heartbeat, handshake) that contains node id, client address, client version, time stamp, system uptime, and last connection error, sent periodically from client to server.
RPC Entities
- API Status
-
Short key–value response of the HTTP-RPC API service in plain-text format.