# Trackunit Data Model

Trackunit's data model is semantically defined datapoints called machine insights, each of them capturing some insight into a machine or asset. This means that no matter the connectivity of the machine (be it directly through Trackunit or e.g. an ISO feed) the data model is the same, whereas the datapoints available for each machine may vary.

Each machine insight has a distinct definition, such that machine insights can be used across an entire fleet. Each machine insight is always normalised to a specific unit of measurement, typically an SI-unit.

## Machine Insights

### CumulativeOperatingHours

The cumulative operating hours of the asset. For machines this corresponds to the engine hour meter.

Unit of measurement: *hours.*

### EngineFuelRate

Fuel rate of engine fuel consumption.

Unit of measurement: *litres per hour.*

### EngineSpeed

Engine speed as measured in revolutions per minute of the engine crankshaft.

Unit of measurement: *revolutions per minute.*

### EngineOilPressure

The pressure of the oil inside the engine.

Unit of measurement: *kilopascal.*

### EngineOilTemperature

The temperature of the oil inside the engine.

Unit of measurement: *degrees Celsius.*

### EngineCoolantTemperature

The temperature of the coolant fluid inside the engine.

Unit of measurement: *degrees Celsius.*

### EngineCoolantLevel

The relative fill level of the coolant fluid used in the engine.

Unit of measurement: *percent.*

### EngineExhaustTemperature

The temperature of the exhaust as measured inside the engine.

Unit of measurement: *degrees Celsius.*

### FuelLevel

The relative fill level of the fuel tank of the machine.

Unit of measurement: *percent.*

### WaterInFuelIndicator

Whether water is present in the fuel or not.

Unit of measurement: *Boolean.*

### HydraulicTemperature

The temperature of the hydraulic system.

Unit of measurement: *degrees Celsius.*

### HydraulicOilLevel

The relative fill level of the oil used in the hydraulic system.

Unit of measurement: *percent.*

### BatteryPotential

The electric potential available in the machine's battery, typically the starter battery.

Unit of measurement: *volt.*

### SeatBeltSwitch

Whether the seat belt is buckled in or not.

Unit of measurement: *Boolean.*

### EnginepercentLoadAtCurrentSpeed

The relative load of the engine at the current engine speed.

Unit of measurement: *percent.*

### PitchAngle

The pitch angle of the asset, typically as measured from front to back of the asset. Perpendicular to the roll angle.

Unit of measurement: *degrees.*

### RollAngle

The roll angle of the asset, typically as measured from side to side of the asset. Perpendicular to the pitch angle.

Unit of measurement: *degrees.*

### EngineTotalFuelUsed

The total amount of fuel used by the machine's engine in its lifetime.

Unit of measurement: *litres.*

### AfterTreatmentDieselParticulateFilterSootLoadpercent

The relative load of soot in the machine's diesel particulate filter.

Unit of measurement: *percent.*

### AfterTreatmentDieselParticulateFilterAshLoadpercent

The relative load of ash in the machine's diesel particulate filter.

Unit of measurement: *percent.*

### AfterTreatmentDieselParticulateFilterTimeSinceLastActiveRegeneration

The time since the last active regeneration of the machine's diesel particulate filter.

Unit of measurement: *seconds.*

### AfterTreatmentDieselParticulateFilterPassiveRegenerationStatus

Whether passive regeneration of the machine's diesel particulate filter is happening, or not.

Unit of measurement: *Boolean.*

### AfterTreatmentDieselParticulateFilterActiveRegenerationStatus

Whether active regeneration of the machine's diesel particulate filter is happening (or possibly inhibited), or not.

Unit of measurement: *Boolean.*

### AfterTreatmentDieselParticulateFilterStatus

Whether regeneration of the machine's diesel particulate filter is needed, or not.

Unit of measurement: *Boolean.*

### AfterTreatmentDieselExhaustFluidTankLevel

The relative fill level of the machine's diesel exhaust fluid tank.

Unit of measurement: *percent.*

### AfterTreatmentDieselExhaustFluidTankTemperature

The temperature of the machine's diesel exhaust fluid tank.

Unit of measurement: *degrees Celsius.*

### AfterTreatmentDieselExhaustFluidConcentration

The relative concentration of the fluid in the machine's diesel exhaust fluid tank.

Unit of measurement: *percent.*

### DieselParticulateFilterActiveRegenerationInhibitedDueToInhibitSwitch

Whether regeneration of the machine's diesel particulate filter is being inhibited by an operator switch.

Unit of measurement: *Boolean.*

### Payloadpercentage

The relative payload of the machine, relative to the rated limit.

Unit of measurement: *percent.*

### GeneratorTotalKwHoursExport

Cumulative exported energy of a generator.

Unit of measurement: *kilowatt-hours.*

### HydraulicOilFilterRestrictionSwitch

Whether the flow of oil in the hydraulic system is restricted by a clogged oil filter.

Unit of measurement: *Boolean.*

### TotalVehicleDistance

The total distance travelled by the machine.

Unit of measurement: *Kilometre.*

### TotalPowerTakeOffHours

The cumulative time the machine has been driving an implement through a power take-off.

Unit of measurement: *seconds.*

### Altitude

The altitude of the asset above mean sea level.

Unit of measurement: *metres.*

### EngineFuelDeliveryPressure

The pressure with which fuel is being delivered to the engine.

Unit of measurement: *kilopascal.*

### EngineCoolantPressure

The pressure of coolant fluid inside the engine.

Unit of measurement: *kilopascal.*

### WheelBasedVehicleSpeed

The speed of the machine as calculated at the wheels.

Unit of measurement: *kilometres per hour.*

### BarometricPressure

The pressure of the ambient atmosphere.

Unit of measurement: *kilopascal.*

### AmbientAirTemperature

The temperature of the ambient atmosphere.

Unit of measurement: *degrees Celsius.*

### EngineIntakeAirTemperature

The temperature of the air as measured at the engine intake.

Unit of measurement: *degrees Celsius.*

### RoadSurfaceTemperature

The temperature of the road surface.

Unit of measurement: *degrees Celsius.*

### EngineIntakeManifoldTemperature

The temperature of the air as measured at the engine intake manifold.

Unit of measurement: *degrees Celsius.*

### EngineAirFilterDifferentialPressure

The difference in air pressure as measured across the engine air filter.

Unit of measurement: *kilopascal.*

### CumulativeIdleHours

The cumulative hours hours the machine has been idle.

Unit of measurement: *hours.*

### BatteryChargerState

Whether the battery charger is charging the machine's battery or not.

Unit of measurement: *Boolean.*

### BatteryChargerPowerLineState

Whether the battery charger is connected to a powerline or not.

Unit of measurement: *Boolean.*

### BatteryChargerOutputvoltage

The output voltage of the battery charger.

Unit of measurement: *volt.*

### BatteryChargerOutputCurrent

The output current of the battery charger.

Unit of measurement: *ampere.*

### EngineTripFuel

Fuel consumed by the engine since last trip reset.

Unit of measurement: *litres.*

### AfterTreatmentDieselParticulateFilterDifferentialPressure

The difference in air pressure as measured across the machine's diesel particulate filter.

Unit of measurement: *kilopascal.*

### AfterTreatmentDieselParticulateFilterIntakeTemperature

The temperature of the air as measured at the intake of the machine's diesel particulate filter.

Unit of measurement: *degrees Celsius.*

### AfterTreatmentExhaustTemperature

The temperature of the exhaust air of the machine's diesel particulate filter.

Unit of measurement: *degrees Celsius.*

### EngineFuelTemperature

The temperature of the fuel inside the engine.

Unit of measurement: *degrees Celsius.*

### EngineIntakeAirPressure

The pressure of the air as measured at the engine intake.

Unit of measurement: *kilopascal.*

### EngineIntakeManifoldPressure

The pressure of the air as measured at the engine intake manifold.

Unit of measurement: *kilopascal.*

### EngineIntercoolerTemperature

The temperature of the engine intercooler.

Unit of measurement: *degrees Celsius.*

### EngineOilLevel

The relative fill level of the oil used in the engine.

Unit of measurement: *percent.*

### EngineTotalIdleFuelUsed

The total amount of fuel used by the machine while idling.

Unit of measurement: *litres.*

### ExhaustSystemHighTemperatureLampCommand

Whether the exhaust temperature is too high.

Unit of measurement: *Boolean.*

### HydraulicPressure

The pressure delivered by the hydraulic system.

Unit of measurement: *kilopascal.*

### TransmissionOilTemperature

The temperature of the oil inside the transmission.

Unit of measurement: *degrees Celsius.*

### AverageLoadFactorLast_24Hours

The average load factor of the asset over the last 24 hours, compared to the rated output.

Unit of measurement: *percent.*

### CumulativeActiveRegenerationHours

The cumulative hours the machine has spent actively regenerating the machine's diesel particulate filter from soot particles.

Unit of measurement: *hours.*

### CumulativeIdleNonOperatingHours

The cumulative hours the machine has spent with the engine running, but without any operator inputs.

Unit of measurement: *hours.*

### CumulativeLoadCount

The cumulative number of loads the machine has performed.

Unit of measurement: *count.*

### CumulativePayloadTotals

The cumulative total of all payloads the machine has performed.

Unit of measurement: *kilogram.*

### EngineStatus

Whether the engine is running, or not.

Unit of measurement: *Boolean.*

### FuelUsedLast_24Hours

The total amount of fuel used by the machine in the last 24 hours.

Unit of measurement: *litres.*

### MaximumSpeedLast_24Hours

The maximum speed the machine attained in the last 24 hours.

Unit of measurement: *kilometres per hour.*

### FuelTankCapacity

The total capacity of the machine's fuel tank.

Unit of measurement: *litres.*

### CumulativeProductiveHours

Cumulative number of hours the Machine has been productive.

Unit of measurement: *hours.*

### CumulativeMovingHours

Cumulative number of hours where the Equipment has been moving/driving, e.g. as registered by the Gps unit.

Unit of measurement: *hours.*

### Speed

Speed of the machine (car/vehicle,equipment,boat,etc) regardless of moving by its own power or something else is moving it.

Unit of measurement: *kilometres per hour.*

### OperationStatus

Whether the machine/asset is operating, or not.

Unit of measurement: *Boolean*.

### CumulativeEngineHours

The cumulative hours the engine of the asset has been running.

Unit of measurement: *hours*.

### PlatformHeightPercent

The relative height of the platform or implement of the machine.

Unit of measurement: *percent*.

### PlatformHeight

The absolute height of the platform or implement of the machine.

Unit of measurement: *metres*.

### PlatformElevated

Whether the platform or implement of the machine is up from the bottom-most position or not.

Unit of measurement: *Boolean*.

### Payload

The absolute payload weight on the platform or implement of the machine.

Unit of measurement: *kilogram*.

### BatteryStateOfChargePercent

The relative state of charge of the battery.

Unit of measurement: *percent*.

### BatteryCurrent

The amount of charge going into (if positive) or out of (if negative) the battery.

Unit of measurement: *ampere*.

### BatteryTemperature

The temperature of the battery.

Unit of measurement: *degrees Celcius*.

### AcPhaseL1NeturalRMSVoltage

The root mean square (RMS) Voltage measured between phase L1 and neutral.

Unit of measurement: *volt*.

### AcPhaseL2NeturalRMSVoltage

The root mean square (RMS) Voltage measured between phase L2 and neutral.

Unit of measurement: *volt*.

### AcPhaseL3NeturalRMSVoltage

The root mean square (RMS) Voltage measured between phase L3 and neutral.

Unit of measurement: *volt*.

### AcPhaseL1Frequency

The frequency of L1.

Unit of measurement: *hertz*.

### AcPhaseL2Frequency

The frequency of L2.

Unit of measurement: *hertz*.

### AcPhaseL3Frequency

The frequency of L3.

Unit of measurement: *hertz*.

### AcPhaseL1RMSCurrent

The root mean square (RMS) current of L1.

Unit of measurement: *ampere*.

### AcPhaseL2RMSCurrent

The root mean square (RMS) current of L2.

Unit of measurement: *ampere*.

### AcPhaseL3RMSCurrent

The root mean square (RMS) current of L3.

Unit of measurement: *ampere*.

### AcPhaseL1L2RMSVoltage

The root mean square (RMS) Voltage measured between phase L1 and L2.

Unit of measurement: *volt*.

### AcPhaseL2L3RMSVoltage

The root mean square (RMS) Voltage measured between phase L2 and L3.

Unit of measurement: *volt*.

### AcPhaseL3L1RMSVoltage

The root mean square (RMS) Voltage measured between phase L3 and L1.

Unit of measurement: *volt*.

### AcTotalActivePower

The actual total Active Power (W) output on all 3 phases. Active Power (a.k.a. Real Power) is measured (not calculated) and reflects the actual energy consumption per time unit (1W = 1Joule/s), for a purely resistive load it is the same as Volt * Amp, but for many AC systems it is NOT.

Unit of measurement: *watt*.

### AcPhaseL1ActivePower

The Active Power (W) output on phase L1. Active Power (a.k.a. Real Power) is measured (not calculated) and reflects the actual energy consumption per time unit (1W = 1Joule/s), for a purely resistive load it is the same as Volt * Amp, but for many AC systems it is NOT.

Unit of measurement: *watt*.

### AcPhaseL2ActivePower

The Active Power (W) output on phase L2. Active Power (a.k.a. Real Power) is measured (not calculated) and reflects the actual energy consumption per time unit (1W = 1Joule/s), for a purely resistive load it is the same as Volt * Amp, but for many AC systems it is NOT.

Unit of measurement: *watt*.

### AcPhaseL3ActivePower

The Active Power (W) output on phase L3. Active Power (a.k.a. Real Power) is measured (not calculated) and reflects the actual energy consumption per time unit (1W = 1Joule/s), for a purely resistive load it is the same as Volt * Amp, but for many AC systems it is NOT.

Unit of measurement: *watt*.

### AcTotalApparentPower

The actual total apparent power (VA) output on all 3 phases. Apparent Power is calculated by multiplying phase-to-neutral-Voltage by Current, and if the load is NOT purely resistive the result will be larger than the actual power (W)

Unit of measurement: *volt-ampere*.

### AcTotalPowerFactor

The power factor of the total output across all 3 power phases, is typically calculated as total-active-power/total-apparent-power. Power Factor is the relation between Active Power (W) and Apparent Power (VA). For a purely resistive load it is 1, otherwise it is less than 1, but larger than zero.

Unit of measurement: *not applicable*.

### AcTotalReactivePower

The actual total Reactive Power (VAr) output on all 3 phases. Is an imaginary number representing then part of Apparent power which does not do any work, or more precisely VAr = sqrt(sqr(VA) - sqr(W)).

Unit of measurement: *volt-ampere reactive*.

### PayloadTemperature

The temperature of the payload, e.g. in a cargo compartment.

Unit of measurement: *degrees Celcius*.

Updated about 1 year ago