Data Model
Trackunit's data model is semantically defined data points 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 data points 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
AcAverageFrequency
Average of the individual phase frequencies. This is an average of actual values and not an average over time. Unit of measurement: hertz.
AcAveragePhaseToNeutralRmsVoltage
Average of the 3 phase-to-neutral voltages. This is an average of actual values and not an average over time. Unit of measurement: volt.
AcAveragePhaseToPhaseRmsVoltage
Average of the 3 phase-to-phase voltages. This is an average of actual values and not an average over time. Unit of measurement: volt.
AcAverageRmsCurrent
Average of the 3 individual phase (L1, L2, and L3) currents. This is an average of actual values and not an average over time. Unit of measurement: ampere.
Accelerometer_X_Axis
Acceleration (or g-force) measured on the x-axis of an accelerometer (typically placed inside a telematics device). Notice: The direction/axis relates to the accelerometer and not the machine, that is, the x-axis of the machine could be something different. Unit of measurement: g-force.
Accelerometer_Y_Axis
Acceleration (or g-force) measured on the y-axis of an accelerometer (typically placed inside a telematics device). Notice: The direction/axis relates to the accelerometer and not the machine, that is, the y-axis of the machine could be something different. Unit of measurement: g-force.
Accelerometer_Z_Axis
Acceleration (or g-force) measured on the z-axis of an accelerometer (typically placed inside a telematics device). Notice: The direction/axis relates to the accelerometer and not the machine, that is, the z-axis of the machine could be something different. Unit of measurement: g-force.
AcPhaseL1ActivePower
The Active Power 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.
AcPhaseL1Frequency
The frequency of L1. Unit of measurement: hertz.
AcPhaseL1L2RMSVoltage
The root mean square (RMS) Voltage measured between phase L1 and L2. Unit of measurement: volt.
AcPhaseL1NeturalRMSVoltage
This insight is deprecated. Please use AcPhaseL1NeutralRMSVoltage.
The root mean square (RMS) Voltage measured between phase L1 and neutral. Unit of measurement: volt.
AcPhaseL1NeutralRMSVoltage
The root mean square (RMS) Voltage measured between phase L1 and neutral. Unit of measurement: volt.
AcPhaseL1RMSCurrent
The root mean square (RMS) current of L1. Unit of measurement: ampere.
AcPhaseL2ActivePower
The Active Power 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.
AcPhaseL2Frequency
The frequency of L2. Unit of measurement: hertz.
AcPhaseL2L3RMSVoltage
The root mean square (RMS) Voltage measured between phase L2 and L3. Unit of measurement: volt.
AcPhaseL2NeturalRMSVoltage
This insight is deprecated. Please use AcPhaseL2NeutralRMSVoltage.
The root mean square (RMS) Voltage measured between phase L2 and neutral. Unit of measurement: volt.
AcPhaseL2NeutralRMSVoltage
The root mean square (RMS) Voltage measured between phase L2 and neutral. Unit of measurement: volt.
AcPhaseL2RMSCurrent
The root mean square (RMS) current of L2. Unit of measurement: ampere.
AcPhaseL3ActivePower
The Active Power 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.
AcPhaseL3Frequency
The frequency of L3. Unit of measurement: hertz.
AcPhaseL3L1RMSVoltage
The root mean square (RMS) Voltage measured between phase L3 and L1. Unit of measurement: volt.
AcPhaseL3NeturalRMSVoltage
This insight is deprecated. Please use AcPhaseL3NeutralRMSVoltage.
The root mean square (RMS) Voltage measured between phase L3 and neutral. Unit of measurement: volt.
AcPhaseL3NeutralRMSVoltage
The root mean square (RMS) Voltage measured between phase L3 and neutral. Unit of measurement: volt.
AcPhaseL3RMSCurrent
The root mean square (RMS) current of L3. Unit of measurement: ampere.
AcTotalActivePower
The actual total Active Power 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.
AcTotalApparentPower
The actual total apparent power 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 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.
AcTotalRelativeActivePowerLoadPercentage
Total active power (W) consumption (of the connected load) as a percentage of the rated active power output capability. Unit of measurement: percent,
AcTotalRelativeApparentPowerLoadPercentage
Total apparent power (VA) consumption (of the connected load) as a percentage of the rated apparent output capability. E.g. a generator is rated to a max continuous power delivery of 120kVA and the actual load is 45kVA then this percentage is 37.5. Unit of measurement: percent.
AcTotalRelativeLoadPercentage
Total power load (taking both Actual (W) and Apparent (VA) consumption into consideration) as a percentage of the rated output capability.
Maximum of AcTotalRelativeApparentPowerLoadPercentage and AcTotalRelativeActivePowerLoadPercentage, which might not be available when this parameter is available. E.g. a generator is rated to a max continuous power delivery of 100kW/120kVA and the actual load is 40kW/45VA then this percentage is 40.
Unit of measurement: percent.
ActualEnginePercentTorque
The engine torque as a percent of reference engine torque (Nm). The engine percent torque value will not be less than zero and it includes the torque developed in the cylinders required to overcome friction. Unit of measurement: percent,
AfterTreatmentDieselExhaustFluidConcentration
The relative concentration of the fluid in the machine's diesel exhaust fluid tank. Unit of measurement: percent.
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.
AfterTreatmentDieselParticulateFilterActiveRegenerationState
Indicates the status of diesel particulate filter(s) active regeneration, is a system status and not individual bank status.
NOT_ACTIVE- not activeACTIVE- activeREGENERATION_NEEDED- regeneration needed - automatically initiated active regeneration imminent
AfterTreatmentDieselParticulateFilterActiveRegenerationStatus
This insight is deprecated and will not be populated soon. Please use AfterTreatmentDieselParticulateFilterActiveRegenerationState.
Whether active regeneration of the machine's diesel particulate filter is happening (or possibly inhibited), or not. Unit of measurement: boolean.
AfterTreatmentDieselParticulateFilterAshLoadPercent
The relative load of ash in the machine's diesel particulate filter. Unit of measurement: percent.
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.
AfterTreatmentDieselParticulateFilterPassiveRegenerationStatus
Whether passive regeneration of the machine's diesel particulate filter is happening, or not. Unit of measurement: boolean.
AfterTreatmentDieselParticulateFilterSootLoadPercent
The relative load of soot in the machine's diesel particulate filter. Unit of measurement: percent.
AfterTreatmentDieselParticulateFilterState
Indicates the state of the diesel particulate filter(s) regeneration need and urgency, is a system status and not individual bank status.
Enumeration:
REGENERATION_NOT_NEEDED- regeneration not neededREGENERATION_NEEDED_LOWEST_LEVEL- regeneration needed - lowest levelREGENERATION_NEEDED_MODERATE_LEVEL- regeneration needed - moderate levelREGENERATION_NEEDED_HIGHEST_LEVEL- regeneration needed - highest levelSAE_SPECIFIC_1- reserved for SAE assignmentSAE_SPECIFIC_2- reserved for SAE assignmentSAE_SPECIFIC_3- reserved for SAE assignment
AfterTreatmentDieselParticulateFilterStatus
This insight is deprecated and will not be populated soon. Please use AfterTreatmentDieselParticulateFilterState.
Whether regeneration of the machine's diesel particulate filter is needed, or not. Unit of measurement: boolean.
AfterTreatmentDieselParticulateFilterTimeSinceLastActiveRegeneration
The time since the last active regeneration of the machine's diesel particulate filter. Unit of measurement: seconds.
AftertreatmentDieselParticulateFilterTimeToNextActiveRegeneration
Time until the next active regeneration of the machine's diesel particulate filter. Unit of measurement: seconds,
AfterTreatmentExhaustTemperature
The temperature of the exhaust air of the machine's diesel particulate filter. Unit of measurement: degrees Celsius.
AfterTreatmentSCROperatorInducementSeverity
A boolean flag indicating whether Selective Catalytic Reduction (SCR) operator inducement warnings are active. Despite the name, this is not a severity level — only whether inducement warnings are present or not. Unit of measurement: boolean.
AftertreatmentSCRTimeSinceLastCleaningEvent
The time since the last cleaning of the machine's Selective Catalytic Reduction unit (SCR). Unit of measurement: seconds.
Altitude
The altitude of the asset above mean sea level. Unit of measurement: metres.
AmbientAirTemperature
The temperature of the ambient atmosphere. Unit of measurement: degrees Celsius.
AverageLoadFactorLast24
The average load factor of the asset over the last 24 hours, compared to the rated output. Unit of measurement: percent.
BarometricPressure
The pressure of the ambient atmosphere. Unit of measurement: kilopascal.
BatteryChargeCyclesCount
The total number of charge cycles the battery has undergone. Unit of measurement: count.
BatteryChargerCumulativeInputEnergy
Total amount of energy delivered to the battery. Unit of measurement: kilowatt-hours.
BatteryChargerInputCurrent
The input current of the battery charger. Unit of measurement: ampere.
BatteryChargerInputCurrentLimit
Maximum allowed battery charger input current draw, based on actual operating condition. Unit of measurement: ampere.
BatteryChargerInputVoltage
The input voltage of the battery charger. Unit of measurement: volt.
BatteryChargerOutputCurrent
The output current of the battery charger. Unit of measurement: ampere.
BatteryChargerOutputCurrentLimit
Maximum allowed battery charging current, based on actual operating condition. Unit of measurement: ampere.
BatteryChargerOutputVoltage
The output voltage of the battery charger. Unit of measurement: volt.
BatteryChargerPowerLineState
Whether the battery charger is connected to a powerline or not. Unit of measurement: boolean.
BatteryChargerState
Whether the battery charger is charging the machine's battery or not. Unit of measurement: boolean.
BatteryCumulativeChargingHours
The cumulative number of hours spent charging the battery. Unit of measurement: hours.
BatteryCumulativeDischargedEnergy
Total amount of energy delivered by the battery. Unit of measurement: kilowatt-hours.
BatteryCurrent
The amount of charge going into (if positive) or out of (if negative) the battery. Unit of measurement: ampere.
BatteryPotential
The electric potential available in the machine's battery, typically the starter battery.
Please note: BatteryPotential is displayed as "Battery Voltage" in Manager. Unit of measurement: volt.
BatteryRemainingChargeTime
Estimate of how long it will take before the battery is fully charged. Unit of measurement: seconds.
BatteryRemainingRunTime
Estimated (actual) remaining run time on battery with respect to the actual charge level and load. Also known as "residual time of battery usage" Unit of measurement: seconds.
BatteryStateOfChargePercent
The relative state of charge of the battery. Unit of measurement: percent.
BatteryStateOfHealthPercent
The relative state of health (SOH) of the battery. Actual maximum capacity of the battery (when fully charged) as a percentage of the initial (nominal) capacity. Unit of measurement: percent.
BatteryTemperature
The temperature of the battery. Unit of measurement: degrees Celcius.
CumulativeActiveRegenerationHours
The cumulative hours the machine has spent actively regenerating the machine's diesel particulate filter from soot particles. Unit of measurement: hours.
CumulativeCO2Emissions
The cumulative CO2 emissions generated by the asset, either directly emissions by burning fuel or indirectly by consuming electricity (causing emission when generated). Unit of measurement: kilogram.
CumulativeEngineHours
The cumulative hours the engine of the asset has been running. Unit of measurement: hours.
CumulativeIdleEnergyUsed
The cumulative amount of energy consumed while the machine is idle. Unit of measurement: kilowatt-hours.
CumulativeIdleHours
The cumulative hours the machine has been idle. 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.
CumulativeMovingHours
Cumulative number of hours when the Equipment has been moving/driving, e.g. as registered by the GPS unit. Unit of measurement: hours.
CumulativeOperatingDistance
The cumulative distance of the operation (e.g., drilling, paving) performed by the machine. Unit of measurement: kilometre.
CumulativeOperatingHours
The cumulative operating hours of the asset. For machines this corresponds to the engine hour meter. Unit of measurement: hours.
CumulativeOperationCount
The cumulative number of operations (e.g., loads, drills, hits) performed by the machine. Unit of measurement: count.
CumulativePayloadTotals
The cumulative total of all payloads the machine has performed. Unit of measurement: kilogram.
CumulativeProductiveHours
Cumulative number of hours the Machine has been productive. Unit of measurement: hours.
CumulativeUtilizationHours
The cumulative utilization hours of the asset. Utilization hours represent the total time a machine has been actively utilized based on a more precise definition of machine usage. This insight is tailored to specific machine types and is defined in collaboration with manufacturers to reflect the work performed.
Please note: CumulativeUtilizationHours is displayed under "Precision Usage" in Manager. Unit of measurement: hours.
DieselParticulateFilterActiveRegenerationInhibitedDueToInhibitSwitch
Whether regeneration of the machine's diesel particulate filter is being inhibited by an operator switch. Unit of measurement: boolean.
EngineAirFilterDifferentialPressure
The difference in air pressure as measured across the engine air filter. Unit of measurement: kilopascal.
EngineCoolantLevel
The relative fill level of the coolant fluid used in the engine. Unit of measurement: percent.
EngineCoolantPressure
The pressure of coolant fluid inside the engine. Unit of measurement: kilopascal.
EngineCoolantTemperature
The temperature of the coolant fluid inside the engine. Unit of measurement: degrees Celsius.
EngineExhaustTemperature
The temperature of the exhaust as measured inside the engine. Unit of measurement: degrees Celsius.
EngineFuelDeliveryPressure
The pressure with which fuel is being delivered to the engine. Unit of measurement: kilopascal.
EngineFuelFilterDifferentialPressure
Pressure drop across the fuel filter, which affects the pressure with which fuel is being delivered to the engine. Unit of measurement: kilopascal.
EngineFuelRate
Fuel rate of engine fuel consumption. Unit of measurement: litres per hour.
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.
EngineIntakeAirTemperature
The temperature of the air as measured at the engine intake. Unit of measurement: degrees Celsius.
EngineIntakeManifoldPressure
The pressure of the air as measured at the engine intake manifold. Unit of measurement: kilopascal.
EngineIntakeManifoldTemperature
The temperature of the air as measured at the engine intake manifold. Unit of measurement: degrees Celsius.
EngineIntercoolerTemperature
The temperature of the engine intercooler. Unit of measurement: degrees Celsius.
EngineOilFilterDifferentialPressure
Pressure drop across the oil filter. Unit of measurement: kilopascal.
EngineOilLevel
The relative fill level of the oil used in the engine. Unit of measurement: percent.
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.
EnginePercentLoadAtCurrentSpeed
The relative load of the engine at the current engine speed. Unit of measurement: percent.
EngineSpeed
Engine speed as measured in revolutions per minute of the engine crankshaft. Unit of measurement: revolutions per minute.
EngineStatus
Whether the engine is running, or not. Unit of measurement: boolean.
EngineTotalFuelUsed
The total amount of fuel used by the machine's engine in its lifetime. Unit of measurement: litres.
EngineTotalIdleFuelUsed
The total amount of fuel used by the machine while idling. Unit of measurement: litres.
EngineTripFuel
Fuel consumed by the engine since last trip reset. Unit of measurement: litres.
ExhaustSystemHighTemperatureLampCommand
Whether the exhaust temperature is too high. Unit of measurement: boolean.
FuelLevel
The relative fill level of the fuel tank of the machine. Unit of measurement: percent.
FuelTankCapacity
The total capacity of the machine's fuel tank. Unit of measurement: litres.
FuelUsedLast24
The total amount of fuel used by the machine in the last 24 hours. Unit of measurement: litres.
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.
HydraulicOilLevel
The relative fill level of the oil used in the hydraulic system. Unit of measurement: percent.
HydraulicPressure
The pressure delivered by the hydraulic system. Unit of measurement: kilopascal.
HydraulicTemperature
The temperature of the hydraulic system. Unit of measurement: degrees Celsius.
Impact
Impact (g-force) - could be calculated as the vector length of the three axis accelerometer values (always a positive number), but might come from other sources. Unit of measurement: g-force.
MaximumSpeedLast24
The maximum speed the machine attained in the last 24 hours. Unit of measurement: kilometres per hour.
MovingStatus
Whether the asset is moving, or not. Unit of measurement: boolean.
OperationStatus
Whether the machine/asset is operating, or not. Unit of measurement: boolean.
ParticleVelocity
The velocity of a vibrating particle. Unit of measurement: millimetres per second.
ParticulateMatter10
The concentration of airborne particulate matter with a diameter of 10 micrometers or smaller. Unit of measurement: micrograms per cubic metre.
ParticulateMatter25
The concentration of airborne particulate matter with a diameter of 2.5 micrometers or smaller. Unit of measurement: micrograms per cubic metre.
Payload
The absolute payload weight on the platform or implement of the machine. Unit of measurement: kilogram.
PayloadPercentage
The relative payload of the machine, relative to the rated limit. Unit of measurement: percent.
PayloadTemperature
The temperature of the payload, e.g. in a cargo compartment. Unit of measurement: degrees Celcius.
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.
PlatformElevated
Whether the platform or implement of the machine is up from the bottom-most position or not. Unit of measurement: boolean.
PlatformHeight
The absolute height of the platform or implement of the machine. Unit of measurement: metres.
PlatformHeightPercent
The relative height of the platform or implement of the machine. Unit of measurement: percent.
PlatformStowed
Whether the platform or implement of the machine is stowed, for example, an articulated boom lift has both booms lowered and detracted. This is often seen as a safety feature, since some machines are only allowed to drive or transported when the platform is in a stowed position. Other machines has a "high speed" drive which is only enabled when the platform is stowed. Unit of measurement: boolean.
RescueModeActive
Whether the machine is operated in rescue mode or not. For instance, a boom lift is turned off but (in order to rescue an operator positioned on the platform) the platform is lowered using the ground control emergency rescue mode. Unit of measurement: boolean.
RoadSurfaceTemperature
The temperature of the road surface. Unit of measurement: degrees Celsius.
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.
SeatBeltSwitch
Whether the seat belt is buckled in or not. Unit of measurement: boolean.
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.
StabilizersDeployed
Whether stabilizing equipment of the machine is deployed or not, examples could be all outrigger legs is lowered to the point where they stabilize/levels the machine, or a pothole protection system is in place. Unit of measurement: boolean.
TotalPowerTakeOffHours
The cumulative time the machine has been driving an implement through a power take-off. Unit of measurement: seconds.
TotalVehicleDistance
The total distance travelled by the machine. Unit of measurement: kilometre.
TransmissionOilTemperature
The temperature of the oil inside the transmission. Unit of measurement: degrees Celsius.
WaterInFuelIndicator
Whether water is present in the fuel or not. Unit of measurement: boolean.
WheelBasedVehicleSpeed
The speed of the machine as calculated at the wheels. Unit of measurement: kilometres per hour.
WindDirection
The direction from which the wind is blowing, relative to true north. Unit of measurement: degrees.
WindSpeed
The speed of the wind. Unit of measurement: metres per second.