← Digital Twin Engine

Digital Twin Engine

Sensor Mapping

Map raw source data from Modbus registers, OPC UA nodes, file records, and MQTT topics into a unified tag namespace. Bind tags to physics model input ports with automatic unit conversion, scaling, and quality validation.

PROTOCOL SOURCESModbus TCP40001-40008OPC UAns=2;s=Pump.FlowFile / CSVlab/results.csvMQTTsite/pump/sensorsGPIO/ADCADC0-ADC3OPC UA UNIFIED NAMESPACESite_01/Pump_001/pressure_in3.2barpressure_out8.5barflow_rate46.3L/spower_draw18.2kWspeed_rpm1461RPMNORMALIZATION PIPELINErawscaledeng. unitsCentrifugal Pump ModelMODEL INPUT PORTSP_in[bar] pressure_inP_out[bar] pressure_outQ[L/s] flow_rateP_elec[kW] power_drawN[RPM] speed_rpmOUTPUTSη78.0 %BEP%92 %NPSH_m4.3 mSE0.44 Wh/m³sensor-mapping@twinedge:~$mapping> bind "Site_01/Pump_001/pressure_in" → pump_model.P_in --unit=bar --scale=1.0mapping> bind "Site_01/Pump_001/flow_rate" → pump_model.Q --unit=L/s --scale=0.0015/5 ports mapped | All types valid | Ingestion rate: 10 Hz | Latency: <5ms

How Sensor Mapping Works

Three stages from raw protocol data to model input ports.

01

Protocol Abstraction

Supported source families are normalized into a unified tag namespace. The physics models never see raw protocol details.

02

Tag-to-Port Binding

Map any tag from the namespace to a model input port. The engine validates unit compatibility and applies scaling/offset transforms automatically.

03

Continuous Ingestion

Tags are polled or subscribed at configurable intervals. New values propagate into the model graph on the next evaluation tick.

Supported Protocols

Five industrial protocols normalized into a single tag namespace.

ProtocolTransportData TypesPolling/SubscribeMax TagsLatency
Modbus TCP/RTUTCP/SerialRegisters, CoilsPolling (10ms–60s)2,000<10ms
OPC UATCPAny (structured)Subscribe (pub/sub)10,000<5ms
File / CSVLocal filesystemRecordsWatch + batchScopedBatch
MQTTTCP/TLSJSONSubscribeScopedDeployment-scoped
GPIO/ADCLocalAnalog/DigitalPolling (1ms–1s)32<1ms

Mapping Features

Everything needed to connect physical sensors to digital twin model ports.

Auto-Discovery

Scan the network and browse available tags. The engine suggests mappings based on tag names and units.

Unit Conversion

Built-in unit library handles bar↔psi, L/s↔GPM, °C↔°F, and 200+ other conversions automatically.

Scale & Offset

Apply linear transforms (raw × scale + offset) for sensors that output raw counts or mA signals.

Quality Flags

Bad/stale sensor values are flagged and optionally replaced with last-known-good or model-predicted values.

Map Your First Sensor

Connect any industrial protocol to a physics model input port in minutes. Auto-discovery, unit conversion, and quality validation included.