Skip to main content

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.

​
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.
  • cii-emissions-microapp-data — pulls validated data into the emissions microapp
  • voyage-analyzer — paired voyage performance review