Documentation

Fuel Report

The Fuel Report finds every refuel and drain recorded by your vehicles' fuel level sensors: when it happened, how much, the level before and after, and where. It also works out each vehicle's fuel balance and consumption for the period and for each day.

The report needs a fuel level sensor with a calibration set up for the vehicle (see the Sensors documentation). Vehicles without one are listed in the Not measured tab and left out of every total.

Running the Report

1. Open Reports and pick Fuel (in the Fuel & sensors section of the report list). Click the report name at the top to switch to another report at any time. Your vehicles and period are kept.
2. Vehicles: pick one or more vehicles.
3. Groups (optional): ticking a group adds every vehicle in it, subgroups included.
4. Period: pick a preset or choose dates on the calendar. A report covers up to 31 days at a time.
5. Click Show report.

Vehicles load one at a time and appear as they arrive (Loading fuel data · 3 of 10 vehicles). A vehicle that can't be loaded is listed with Retry. With many vehicles over a long period the page stops loading at a limit, so it stays fast, and shows how many vehicles it has; click Load the rest to load the others.

The line under the filters says how many vehicles are measured and how many have no fuel sensor.

Totals Cards

• Consumption — fuel the engines actually burned
• Filled — with the number of refuels
• Drained — with the number of drains
• Start balance and End balance — with the time of the first and last reading
• Mileage and Engine hours
• L/h and L/100 km — consumption ÷ engine hours, and consumption ÷ mileage

Click the pin on a card to keep it first. Consumption, Filled and Drained are pinned at the start.

Fills & Drains Tab

Every refuel and drain in the period, grouped by vehicle. Use All / Fills / Drains to show one kind. Each event shows:

• Date and Period — when it started and how long it took
• Sensor type
• Before, Change and After — the level before and after (in liters) and the amount added or lost
• Location — the nearest position to the event, as an address

Click any event (or an arrow on its vehicle's chart) to open its panel:

• How it was recorded — the fuel chart zoomed to 30 minutes either side of the event. The faint line is the raw sensor reading, the bold line the filtered level used for detection; the event is shaded with the vehicle's state behind it. Whole period zooms out, Back to the event zooms in again.
• Where it was recorded — the place on the map, or No position recorded for this event.
• Event details — exact times, levels and change.
• Previous and Next step through the events (Event 2 of 9).
• Open in Chart opens the Chart Report from an hour before the event to an hour after; Replay opens the Replay from ten minutes before to ten minutes after.

By Vehicle & Day Tab

One row per vehicle with the period totals, and its days underneath:

• Mileage and Engine hours — for days, taken from the device's own daily counters
• Start balance and End balance
• Filled and Drained
• Consumption — start balance + filled − drained − end balance
• L/h and L/100 km

Open a vehicle to chart its days above the table: the balance at the end of each day as a line, with that day's refuels and drains as bars. It shows at a glance on which day a slow leak or a series of top-ups happened.

A refuel or drain that starts just before midnight and ends just after counts entirely on the day it started.

Detection Settings Tab

The thresholds used to find refuels and drains for each vehicle in this report:

Vehicles using the standard values are marked default values. The settings can be changed per fuel sensor — click Edit in Sensors. That helps when one tank or sensor is noisier than the rest of the fleet. If a refuel or drain you expected is missing, check here which threshold it had to clear.

Not Measured Tab

Lists every selected vehicle that has no calibrated fuel sensor, which is why it has no fuel data. It's left out of every total in the report. Click Set up a fuel sensor, add a calibration, and run the report again to include it.

How Refuels and Drains Are Found

The detection works the same way as in common professional fleet-tracking systems, in three steps.

1. Filtering

The raw sensor readings are first smoothed with a centered median filter over time: for each reading, the readings within the filter window around it are sorted and the middle one is taken.

A median is used instead of an average because a single bad reading (for example a glitch that reports 0 L for one second) doesn't affect it — it's sorted to the edge and ignored. An average would pull the whole line toward the glitch.

2. Finding the events

The smoothed level is scanned reading by reading for a sustained rise (refuel) or fall (drain):

• Start: the last steady reading before the level begins to move. Starting there, rather than at the first step, captures the whole amount.
• Continuing: the event goes on while the level keeps moving the same way. One small step back (the sensor settling) doesn't end it; only a reversal larger than half the minimum volume does.
• Stops only: refuels and drains can each be limited to times the vehicle stands still (see Detection Settings).
• Events below the minimum volume are dropped as noise.

3. Measuring the amount

Smoothing blurs the edges of a fast event: at its start, the filter already includes some readings from during the refuel, so the smoothed level is a little too high; at its end, it still includes some readings from before, so it's a little too low.

To correct this, the raw reading at the exact start and end is checked. For a refuel, if the raw reading at the start is lower than the smoothed one, the raw reading is used as the true starting level; if the raw reading at the end is higher, it's used as the true final level. Drains work the other way round. The correction is capped at twice the filtered change, so one bad reading can't distort it.

Calibration accuracy

An event's amount is only as accurate as the sensor's calibration table (sensor value → liters). If the table is off at some fuel levels, the amounts will differ from what was actually pumped, whatever the detection does. If refuel amounts keep differing from fuel receipts, check the calibration and rebuild it with known amounts at several tank levels.

On a Phone

• The tabs are the same; events and days appear as cards.
• Tap an event to see how it was recorded on the chart and where on the map. Previous and Next move through the events, and Back to fills & drains returns to the list.
• The ⋯ menu holds Export to Excel and Schedule this report.

Export

Export to Excel downloads one file with five sheets: Fills and drains, Summary, Detailed (by vehicle and day), Parameters and Note (vehicles without a calibrated sensor).

Scheduling

Click Schedule (on a phone, ⋯ → Schedule this report) to have this report emailed automatically. A panel opens over the report, filled in with the vehicles and groups on screen. Choose how often it repeats, the send time, start and end dates and the recipients, then click Create schedule. You stay on the report.

Each run emails one Excel file with the same five sheets. See Scheduled Reports for all the options.

Use Cases

• Theft and leaks: spot drains while a vehicle was parked
• Refuel audit: compare refuels reported by drivers with the ones the sensor recorded
• Consumption: compare L/100 km across vehicles to find waste or a developing fault
• Daily check: use By vehicle & day to find the exact day something happened

No Data Found

If a vehicle has no fuel data:

• Check the Not measured tab — it probably has no calibrated fuel sensor
• Check that the vehicle was active (reporting positions) during the period
• A vehicle with steady fuel use and no refuels or drains still shows its totals in By vehicle & day — it just has no rows in Fills & drains