# Warming Flights

Warming Flights is a flight emissions calculator. It estimates per-passenger
emissions for a flight between two airports and presents results by cabin class
and trip type.

## Purpose
- Provide easy-to-read emissions estimates for routes between airports.
- Support lookup by IATA airport codes.

## Key URLs
- Home: https://warmingflights.com/
- Sitemap index (if present): https://warmingflights.com/sitemap_index.xml

## Query Parameters
The homepage supports query parameters for direct calculation:
- from: IATA code (e.g. HEL)
- to: IATA code (e.g. JFK)
- trip: one-way | round-trip
- cabin: economy | premium-economy | business | first

Example:
https://warmingflights.com/?from=HEL&to=JFK&trip=one-way&cabin=economy

## Machine-Readable LLM Data
- Index file: https://warmingflights.com/calculations/index.json
- Chunk files: https://warmingflights.com/calculations/routes/{FROM}.json
- Data is chunked by origin IATA code (`FROM`) for smaller fetches.
- Use `index.json` to discover airports, scenarios, and each airport chunk URL.
- Distances are intentionally omitted to keep files smaller.
- Reconstruct calculator links with:
  - `/?from={FROM}&to={TO}&trip={TRIP}&cabin={CABIN}`

### Index Structure
- `version`, `generatedAt`, `assumptions`
- `scenarios`: list of all trip/cabin combinations
- `resultValueOrder`: order of values in each result tuple
- `resultUnits`: units for each value in `resultValueOrder`
- `valueSemantics`: interpretation notes (for example how percentage values are encoded)
- `aircraft`: aircraft ids used in calculations
- `airports`: each airport includes `iata`, metadata, and `chunk`

### Chunk Structure
- Top-level: `version`, `generatedAt`, `from`, `assumptions`, `routes`
- Each route:
  - `to`: destination IATA code
  - `aircraft`: aircraft id for this `from -> to` pair
  - `results`: array of tuples ordered by `scenarios` from `index.json`
  - Tuple value order follows `resultValueOrder` from `index.json`:
    - `[emissionsTonnes, emissionsWithWarmingEffectTonnes, annualBudgetUsedPercent]`
  - `annualBudgetUsedPercent` uses whole percent points:
    - `100` means `100%`
    - `205` means `205%`

## Method Notes
- Emissions are based on Travel Impact Model 3.0.0 factors.
- Results are adjusted by a radiative forcing factor of 3.0.
- Output is CO2e and should be interpreted as an estimate.