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

# Input Nomenclature and Units

> Canonical API field naming, unit conventions, and PDF-to-current schema reconciliation

# Input Nomenclature and Units

## Naming Conventions

* API payloads use camelCase keys.
* Backend model attributes are snake\_case.
* Percent-style losses are represented as fractions (`0.028` means `2.8%`).

## Unit Conventions

| Input family                                       | Typical units     |
| -------------------------------------------------- | ----------------- |
| Irradiance (`ghi`, `dhi`, `dni`, `poa`)            | W/m2              |
| Wind speed (`windSpeed`)                           | m/s               |
| Temperature (`temperature`)                        | C                 |
| Angles (`azimuth`, `axisTilt`, `tilt`, `maxAngle`) | degrees           |
| Plant limits (`poiLimitMW`)                        | MWac              |
| Auxiliary thresholds (`*kW`)                       | kW                |
| Fractional losses (`mismatch`, `dcohmic`, etc.)    | decimal fractions |

## Reconciliation Status Labels

| Status        | Meaning                                                                  |
| ------------- | ------------------------------------------------------------------------ |
| `current`     | PDF term and current API field align directly                            |
| `legacy term` | PDF term reflects older framing; current API has evolved shape or naming |
| `conflict`    | PDF wording conflicts with current validators/behavior                   |

## Key Known Conflicts

| Topic                            | PDF wording                                                   | Current behavior                                       |
| -------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------ |
| `/energymodels` async semantics  | Legacy docs text does not match current API default semantics | Sync is default; async queueing requires `?async=true` |
| `layout.gcr` range               | 0.1 to 0.85                                                   | Validator enforces 0.15 to 0.90                        |
| `shading.transverseDiodes` range | Wider mode-specific limits described                          | Validator enforces 0 to 10                             |

## Full Source-Reconciliation Matrix

* [Rendered matrix page](/energy-models/_generated/source-reconciliation)
* Generated matrix file: `packages/docs/energy-models/_generated/source-reconciliation.mdx`

<Info>
  The reconciliation matrix is generated from `energy_input_nomenclature_map.yaml` and should be
  updated whenever terminology or validation behavior changes.
</Info>