Skip to Content

VELA TOOLS / DATA PIPELINE

CASSIOPEIA

 AVAILABLE

ADAPTIVE PIPELINE THAT MAPS ANY SOURCE TO VALIDATED NGSI-LD SMART DATA MODELS - AUTOMATICALLY

LICENSE

FOSS · PRO · HUB

STANDARDS

NGSI-LD, Smart Data Models

TYPE

MAPPER + TRANSFORMER

CLUSTER

DATA PIPELINE

THE PROBLEM IT SOLVES ​

Every sensor vendor, every city department, every data feed speaks a different format. CSV, JSON, GeoJSON, GTFS, GBFS — none compatible with the next. Without a transformation layer, every new data source means weeks of custom integration code that breaks the moment a vendor updates their feed.

CASSIOPEIA replaces all of that with a single, repeatable pipeline. Map a source once, validate it against ETSI Smart Data Models, and run it continuously — as a CLI batch job, a server-mode stream processor, or a graphical mapping wizard. When sources change, you update a config, not your codebase.

try the foss version on github

WHAT YOU GET 
 Stop writing custom mappers
 Validate at the edge 
 Run anywhere
TECHNICAL DETAILS
  • Transforms multiple input formats: CSV, JSON, GeoJSON, GBFS, GTFS, and others.
  • Outputs NGSI-LD entities in different representation modes (normalized/concise/simplified).
  • Advanced mapping configuration: templates, conditional logic, nested objects, relationships, list relationships.
  • Synthetic entities: create referenced entities on-the-fly when source data only contains partial references.
  • Smart Data Model integration: download/search/list schemas and validate outputs when schemas exist.
  • Flexible writers: write to files (default) or push directly to a Context Broker via HTTP.
  • Standard feed shortcuts: pre-built configurations for common GTFS and GBFS entity types.

CASSIOPEIA is a focused mapping engine. It's designed to do one thing well and integrate cleanly with the rest of the Vela suite for everything else:

  • Mapping, validation, and output → CASSIOPEIA
  • Real-time context API → a Context Broker (protected by LIBRA)
  • Schema versioning and registry → LYNX
  • Workflow orchestration → Node-RED, or your existing orchestrator
  • Time-series storage and history queries → HOROLOGIUM
  • Anomaly detection and analytics → CENTAURUS, or your stack
  • Inputs
    • Source files or feeds: CSV / JSON / GeoJSON / GBFS / GTFS.
    • Mapping config files: JSON5 (recommended) or JSON.
  • Processing
    • Applies mapping rules using Tera templates with support for conditionals, filters, and nested navigation.
    • Generates entity IDs using dataModel + entityName + optional URN parts (site/service/group).
    • Performs type transformations (string/int/float/bool/datetime/geo types).
    • Optionally validates against Smart Data Model schemas (downloaded via Cassiopeia download).
  • Outputs
    • NGSI-LD entities written as files, or pushed to a Context Broker (--writer-type context-broker --broker-url ...).
    • Output representation modes: normalized, concise (default), simplified.
    • Null handling: include or skip null values.

Cassiopeia provides five interfaces for different stages of the data integration workflow:

  • CLI - Command line: Batch jobs, CI/CD, one-off conversions
  • SERVER -   REST + WebSocket: Centralized hub, live data streams
  • EXPLORER -  Terminal (TUI): Schema discovery, model inspection
  • WIZARD -  Terminal (TUI):  Interactive mapping creation
  • CONFIGURATOR -   Web browser: Same as Wizard, graphical UI
  • Language: Rust, TypeScript
  • Config format: JSON5/JSON mapping configs
  • Templating: Tera template engine
  • Interfaces: CLI (cassiopeia ...) + server mode (cassiopeia server)
  • Outputs: File writer or Context Broker writer (HTTP)
  • Validation dependencies: Smart Data Model schemas downloaded by tool command​


SCREENSHOTS / UI


Data Model Selection

  

Attribute Mapping


Save Mapping Configuration

GET STARTED

Built for data engineers... 

Works with: all Vela Tools.

three ways to use cassiopeia

Open core. Pick the path that matches your stage — from free download to fully managed integration.


OPEN SOURCE

FOSS

Free

Self-hosted

get on github

Full mapping engine

All input formats

CLI + server mode

Community support

RECOMMENDED

COMMERCIAL

PRO

From €100/mo

Per instance

talk to sales

Everything in FOSS

Web Configurator UI

Pre-built starter mappings

Priority support, SLA

Commercial licence


FULL SUITE

hub

From €1.999/mo

Vela Context Data Hub

talk to​ sales

Everything in Pro

Fully managed

Integrated with broker, gateway, starter packs

10h/month consulting included

Vela Context Data Hub · ANY FORMAT IN, NGSI-LD OUT · EU OPEN STANDARDS · YOUR INFRASTRUCTURE, YOUR RULES