Supported domains

Raa Labs supports multiple domains for organizing and querying time series data. A domain defines how a time series is named and structured. Knowing the domains helps you form expressions for queries. The current supported domains include:

Domain	Description	Example Domain ID
id	The raw time series UUID. This is a unique identifier assigned by Raa Labs for each signal. Use this for a direct lookup if you know the UUID.	62e23903-9db5-43cc-949d-78452ffb81bc
jsmea	JSMEA (Japan Ship Machinery and Equipment Association) naming standard, based on ISO 19848 for ship sensor data. This is a hierarchical naming scheme with multiple levels (e.g., system, subsystem, component, parameter).	IMO1234567/jsmea_mac/MainEngine/DrivingShaft/Output//Power/
raalabs	Raa Labs flat tag schema. A simpler, flattened naming convention that usually includes just the IMO number and a short descriptive tag.	IMO1234567/ME ShaftPower
parameters	Parameter grouping schema. It includes the IMO number, a parameter group name, and a short name. This groups related signals under a category.	IMO1234567/ME Power/ME ShaftPower
maker	The name given to a tag by the maker of the machinery or equipment. Includes the maker name and a tag name.	IMO1234567/Maker/12345

Using wildcards in domains

All domains support wildcard queries to simplify data retrieval across multiple tags or levels.

Flat domains (e.g., raalabs)

In a flat domain like raalabs, you can query multiple vessels or tags:

• */ME ShaftPower Retrieves the Main Engine ShaftPower measurements for all vessels ( * in place of the IMO number matches every vessel).

• raalabs/IMO1000002/ME* Shaft* Retrieves all tags that Starts with ME and has the word Shaft in it.

Hierarchical domains (e.g., jsmea)

In a hierarchical domain like jsmea, you can use wildcards at various levels:

• IMO1234567/*/*/*/*/*/Power/ Retrieves all time series under vessel IMO1234567 whose final component is "Power" (regardless of which subsystem or component).

• IMO1234567/jsmea_mac/MainEngine/* Retrieves all Main Engine-related time series for vessel 1234567 (wildcard at the level below MainEngine to get everything under it).

• IMO1234567/jsmea_mac/MainEngine/Fuel* Retrieves all Main Engine with some kind of fuel component related time series for vessel 1234567 (wildcard at the level below MainEngine to get everything under it).

Wildcards provide a powerful way to fetch data without knowing exact full tag names, as long as you know part of the hierarchy or tag name.

Note: Wildcards are currently under development, not all functionality is available in all domains.

Finding domain mappings

If you are unsure how a time series ID appears in different domains, you can use the metadata endpoint on the id domain to see its mappings. For example, you can fetch all metadata using the raw iddomain and look at the mapsTo field in the response. The mapsTo object will show equivalent identifiers in other domains for each time series.

For instance, a metadata query like GET https://prism.raalabs.io/{ENVIRONMENT}/metadata/id/* might return:

{
  "220315da-0a1b-4fda-ab90-f76bea63d3e9": {
    "name": "Latitude",
    "description": "SHIP POSITION (LATITUDE)",
    "source": "FurunoVDR",
    "scale": 1.0,
    "uom": "deg",
    "mapsTo": {
      "jsmea": "IMO1000003/jsmea_nav/PositioningSystem/GPS///Latitude/",
      "raalabs": "IMO1000003/GPS_LAT"
    },
    "rangeHigh": null,
    "rangeLow": null,
    "timeSeriesId": "220315da-0a1b-4fda-ab90-f76bea63d3e9",
    "vesselImo": "1000003",
    "vesselName": "Flying Dutchman"
  }
}