# Fuel Records

The Fuel tab keeps track of the fuel mileage for your vehicle.

![](/Records/Fuel%20Records/a/image-1726780458423.png)

LubeLogger supports fuel mileage calculation in the following formats:
- American Imperial (MPG)
- European/Asian Metric (L/100Km)
- British(Purchase Gas in Liters and calculate fuel mileage as Miles per Imperial UK Gallons)
- Electric Vehicles (mi./kWh or kWh/100Km)

## Initial Fuel Up
In order to calculate fuel mileage, you must first have an initial fuel entry with the current odometer reading. An odometer reading is needed so that the app can calculate the distance traveled between fuel ups. It is recommended that you fill it up to full for the first entry.

## Imperfect Fuel Ups
For the most accurate results it is recommended that you always fill your vehicle up to full and not miss any fuel ups, but sometimes things happen, which is why we provided the following:

### Partial Fuel Ups
On the occassions that you cannot fill your vehicle up to full, you can defer the fuel mileage calculation by unchecking the "Is Filled To Full" switch. Doing this tells the app to defer fuel mileage calculation until the next Full Fill Up.

![](/Records/Fuel%20Records/a/image-1726780463015.png)

### Missed Fuel Ups
Check this if you have missed a fuel up record prior to adding this fuel record. This effectively resets the fuel mileage calculation and will show up as $0 or "---" in the fuel records. Checking this ensures that the average fuel mileage calculation isn't skewed due to missed fuel ups.

## Calculation of Average Fuel Mileage
Average MPG is calculated by excluding the initial and missed fuel ups, then taking the difference between the min and max odometer reading and dividing it by total amount of gas consumed(if Metric then it is further divided by 1/100). This method will include all of the gas consumed by full and partial fuel ups.

### Fuel Mileage by Tags
To track fuel mileage across different fuel grades, gas stations, etc, you can either rely on the tagging functionality or add an extra field to the gas record. Filtering the records by tags or via searching the records will automatically update the average, min, and max fuel mileage labels.

![](/Records/Fuel%20Records/a/image-1726780562015.gif)

## Fuel Units
The consumption, fuel mileage, and odometer units are determined by two settings: "Use Imperial Calculation" and "Use UK MPG Calculation"

| Setting | Use UK MPG Calculation Checked | Use UK MPG Calculation Unchecked |
| -------- | -------- | -------- |
| Use Imperial Calculation Checked    | Distance: Miles, Consumption: Liters, Fuel Mileage: Miles per UK Gallons       | Distance: Miles, Consumption: Gallons, Fuel Mileage: MPG    |
| Use Imperial Calculation Unchecked     | Distance: Miles, Consumption: Liters, Fuel Mileage: l/100mi.    | Distance: Km, Consumption: Liters, Fuel Mileage: l/100km   |

### Alternate Fuel Units
If you wish to see alternate units which converts the calculated units within the Gas Tab, you can right click on the table headers for Consumption and Fuel Economy. These settings persists for the user, so the next time you login to LubeLogger it will automatically perform the conversion for you.

![](/Records/Fuel%20Records/a/image-1726780518163.gif)

#### Consumption
For consumption, the units are cycled between US gal, Liters, and Imp Gal(UK). Changing the consumption unit will also change the unit cost.

#### Fuel Economy
The units can only toggle between l/100km and km/l, which means that this unit cannot be converted if your fuel economy unit is not l/100km. Changing the fuel economy unit will also update the values in the Average, Min, and Max Fuel Economy labels as well as the Fuel Economy Unit in the Consolidated Report.

## Importing from CSV/Fuelly/SpiritMonitor.de
LubeLogger supports importing CSV exports from other apps, below lists the column names that are acceptable/mapped to our data points:

| LubeLogger Data Field                  | Imported CSV                                                   |
| -------------------------------------- | -------------------------------------------------------------- |
| date                                   | date, fuelup_date                                              |
| odometer                               | odometer                                                       |
| fuelconsumed                           | gallons, liters, litres, consumption, quantity,   fuelconsumed |
| cost                                   | cost, total cost, totalcost,  total price                      |
| notes                                  | notes, note                                                    |
| partialfuelup(inverse of isfilltofull) | partial_fuelup                                                 |
| isfilltofull                           | isfilltofull, filled up                                        |
| missedfuelup                           | missedfuelup, missed_fuelup                                    |
| tags                                   |        tags                                                    |
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9