> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appliedaifoundation.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Consumption Log Validator

> Validates vessel noon report and consumption log data before submission to CII, EU MRV, IMO DCS, and FuelEU calculation tools.

## What it does

The **Consumption Log Validator** checks vessel noon report and consumption log exports for the data-quality issues that cause CII, EU MRV, IMO DCS, and FuelEU submissions to fail or under-report. It runs structural and value-range checks, flags missing or implausible numbers, and produces a report that tells the operator exactly what to fix before upload.

## When to use it

* "Validate consumption data"
* "Pre-upload data check"
* "Check noon reports for AQUILA"
* "Quality-check this annual export"
* "Review fleet consumption logs for compliance"

## What it validates

* **Structural** — required columns present, expected sheet structure
* **Completeness** — no missing days in the reporting window, no null values in required fields
* **Value ranges** — fuel consumption, distance, and time values within physically plausible bounds for the vessel type
* **Internal consistency** — sea time + port time matches calendar period; distance plausible vs reported speed
* **Sequence integrity** — voyage transitions and port calls match across rows
* **Vessel-type rules** — additional checks specific to vessel type (e.g. container, tanker, bulker)

## How it works

1. Reads the noon-report or consumption-log export (Excel or CSV).
2. Detects the vessel type if not provided.
3. Runs each validator against the dataset, collecting issues with row references.
4. Produces a categorised report — errors that will block submission vs warnings that operators should review.
5. Optionally writes a summary-only output for quick triage.

## What it produces

* Detailed validation report with each issue, the row affected, and the rule that flagged it
* Summary view counting errors and warnings by category
* Pass / fail verdict for the export as a whole

## Why pre-upload validation matters

CII, EU MRV, and FuelEU calculators don't tell you what's wrong — they fail or produce bad numbers. Catching issues before upload saves a re-submission cycle and protects against incorrect CII rating, MRV under-reporting fines, and FuelEU compliance disputes.

## Related skills

* **cii-emissions-microapp-data** — pulls validated data into the emissions microapp
* **voyage-analyzer** — paired voyage performance review