> ## 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. # Source Reconciliation Matrix > PDF vs current API/schema terminology and behavior alignment # Source Reconciliation Matrix | Canonical field/path | PDF term | Status | Notes | | ------------------------------------------ | --------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------- | | `AcLosses.acohmicLoss` | `acohmicLoss` | `current` | Direct match. | | `AcSystem.mpptFraction` | `mpptFraction` | `current` | Multi-MPPT power fraction allocation. | | `AcSystem.numberOfInverters` | `numberOfInverters` | `current` | Direct match. | | `ArraySingleLegacy.bifacial` | `bifacial` | `current` | Direct match. | | `ArraySingleLegacy.bifacialInputs` | `bifacialInputs` | `current` | Direct match. | | `ArraySingleLegacy.stringCount` | `stringCount` | `current` | Direct match. | | `ArraySingleLegacy.stringLength` | `stringLength` | `current` | Direct match. | | `BifacialInputs.height` | `height` | `current` | Tracker center of rotation height in meters. | | `BifacialInputs.irradianceMismatchLoss` | `irradianceMismatchLoss` | `current` | Direct match. | | `BifacialInputs.moduleTransparency` | `moduleTransparency` | `current` | Direct match. | | `BifacialInputs.rackingShading` | `rackingShading` | `current` | Direct match. | | `Block.acSystem` | `acSystem` | `current` | Direct match. | | `Block.albedo` | `albedo` | `current` | Direct match. | | `Block.aoi` | `aoi` | `current` | Custom angle-of-incidence transmission curve. | | `Block.array` | `array` | `current` | Direct match in legacy schema mode. | | `Block.dcInputs` | `array` | `legacy term` | v16 PDF centers on legacy array shape. Current schema adds dcInputs for multi-MPPT. | | `Block.inverterId` | `inverterId` | `current` | Direct match. | | `Block.layout` | `layout` | `current` | Direct match. | | `Block.layoutRef` | `layout` | `legacy term` | PDF assumes inline layout. Current API also supports external layoutRef. | | `Block.losses` | `losses` | `current` | Direct match. | | `Block.moduleId` | `moduleId` | `current` | Direct match for legacy array block form. | | `Block.shading` | `shading` | `current` | Direct match. | | `Block.shadingStringMap` | `shadingSceneId` | `legacy term` | PDF describes block-level shadingSceneId. Current API additionally supports per-dcInput shadingStringMap. | | `DcInputGroup.dcInputId` | `stringCount` | `legacy term` | Multi-MPPT identifiers are current-schema additions beyond the legacy single-array framing. | | `DcInputGroup.moduleId` | `moduleId` | `current` | Same semantic meaning, now per-DC-input in multi-MPPT mode. | | `DcInputGroup.mpptIndex` | `array` | `legacy term` | Current multi-MPPT control field. | | `DcInputGroup.stringCount` | `stringCount` | `current` | Same semantic meaning. | | `DcInputGroup.stringLength` | `stringLength` | `current` | Same semantic meaning. | | `EnergyModelInput.blocks` | `blocks` | `current` | Direct match. | | `EnergyModelInput.farShading` | `farShading` | `current` | Far shading profile override at root level. | | `EnergyModelInput.location` | `location` | `current` | Inline location for querying mode. | | `EnergyModelInput.locationId` | `locationId` | `current` | Direct match. | | `EnergyModelInput.output` | `output` | `current` | Direct match. | | `EnergyModelInput.plant` | `plant` | `current` | Direct match. | | `EnergyModelInput.projectId` | `projectId` | `current` | Direct match (optional location source). | | `EnergyModelInput.schemaVersion` | `schemaVersion` | `legacy term` | Not surfaced in v16 PDF page 7/8 structure diagram but supported in current API. | | `EnergyModelInput.settings` | `settings` | `current` | Direct match. | | `EnergyModelInput.soiling` | `soiling` | `current` | Direct match. | | `EnergyModelInput.weatherData` | `weatherData` | `current` | Supported inline weather override. | | `EnergyModelInput.weatherId` | `weatherId` | `current` | Direct match. | | `HvLosses.hvCollectionLossFraction` | `hvCollectionLossFraction` | `current` | Direct match. | | `Layout.arrayType` | `arrayType` | `current` | Direct match. | | `Layout.axisTilt` | `axisTilt` | `current` | Direct match. | | `Layout.azimuth` | `azimuth` | `current` | Direct match. | | `Layout.backTracking` | `backTracking` | `current` | Direct match. | | `Layout.gcr` | `gcr` | `conflict` | PDF cites 0.1-0.85; current validator enforces 0.15-0.90. | | `Layout.maxAngle` | `maxAngle` | `current` | Direct match. | | `Layout.numberOfRows` | `numberOfRows` | `current` | Direct match. | | `Layout.tilt` | `tilt` | `current` | Direct match. | | `LayoutRef.layoutId` | `layout` | `legacy term` | External layout reference not described in legacy PDF. | | `LayoutRef.layoutVersion` | `layout` | `legacy term` | External layout version pinning. | | `Losses.dcohmic` | `dcohmic` | `current` | Direct match. | | `Losses.degradation` | `degradation` | `current` | Optional. | | `Losses.degradationMismatch` | `degradationMismatch` | `current` | Optional. | | `Losses.invAuxLoss` | `invAuxLoss` | `current` | Direct match. | | `Losses.lid` | `lid` | `current` | Direct match. | | `Losses.mismatch` | `mismatch` | `current` | Direct match. | | `Losses.moduleQuality` | `moduleQuality` | `current` | Direct match. | | `Losses.stringVoltageMismatch` | `stringVoltageMismatch` | `current` | Direct match. | | `Losses.uC` | `uC` | `current` | Direct match. | | `Losses.uV` | `Uv` | `legacy term` | PDF casing varies; canonical payload key is uV. | | `MvLosses.mvOhmicLossFraction` | `mvOhmicLossFraction` | `current` | Direct match. | | `MvLosses.mvTransformerLossFraction` | `mvTransformerLossFraction` | `current` | Direct match. | | `Output.blockIndex` | `blockQuery + blockQueryIndex` | `legacy term` | Canonical zero-based selected-block response filter. Conflicting canonical and legacy values return 422. | | `Output.blockResults` | `blockresults` | `legacy term` | Canonical output field for blockTimeSeries visibility. Legacy query param blockresults still normalizes here. | | `Output.fullOutput` | `fullOutput` | `current` | Direct match. | | `Output.fullTimeSeries` | `fullTimeSeries` | `current` | Direct match. Mutually exclusive with blockResults. | | `Output.lossBreakdownTimestamps` | `lossBreakdownTimestamps` | `legacy term` | Top-level boolean request flag again. Implies block-level results are surfaced. | | `Output.name` | `name` | `current` | Optional simulation run label. | | `Output.save` | `save` | `legacy term` | Accepted only as a backward-compatible persistence hint; not the preferred contract. | | `Output.timeSeries` | `timeSeries` | `current` | Direct match. | | `Plant.contAuxLossThreshkW` | `contAuxLossThreshkW` | `current` | Direct match. | | `Plant.contAuxLosskW` | `contAuxLosskW` | `current` | Direct match. | | `Plant.hvLosses` | `hvLosses` | `current` | Direct match. | | `Plant.limitAtInverters` | `limitAtInverters` | `current` | Direct match. | | `Plant.nightAuxLoss` | `nightAuxLoss` | `current` | Direct match. | | `Plant.poiLimitMW` | `poiLimitMW` | `current` | Direct match. | | `Plant.powerFactor` | `powerFactor` | `current` | Direct match. | | `Plant.propAuxLossThreshkW` | `propAuxLossThreshkW` | `current` | Direct match. | | `Plant.propAuxLossWperkW` | `propAuxLossWperkW` | `current` | Direct match. | | `Settings.advancedNearShadingLosses` | `advancedNearShadingLosses` | `current` | Direct match. | | `Settings.circumsolarIncludedInDiffuse` | `circumsolarIncludedInDiffuse` | `current` | Direct match. | | `Settings.dcInputPowerSharingPolicy` | `dcInputPowerSharingPolicy` | `current` | Direct match. | | `Settings.ignoreSpectralCorrection` | `ignoreSpectralCorrection` | `current` | Direct match. | | `Settings.inverterAmbientTemperatureShift` | `inverterAmbientTemperatureShift` | `current` | Direct match. | | `Settings.irradianceOptimization` | `irradianceOptimization` | `current` | Direct match. | | `Settings.timeZoneOverride` | `timeZoneOverride` | `current` | Direct match. | | `Settings.windStow` | `windStow` | `current` | Direct match. | | `Shading.electricalImpact` | `electricalImpact` | `current` | Direct match. | | `Shading.electricalImpactFraction` | `electricalImpactFraction` | `current` | Direct match; defaults to 1.0 when electricalImpact=true. | | `Shading.farShading` | `farShading` | `current` | Direct match. | | `Shading.nearShading` | `nearShading` | `current` | Direct match. | | `Shading.shadingSceneId` | `shadingSceneId` | `current` | Direct match for octavia mode. | | `Shading.transverseDiodes` | `transverseDiodes` | `conflict` | PDF describes wider limits in some modes; current validator enforces 0-10 globally. | | `StringShadingMap.dcInputId` | `shadingSceneId` | `legacy term` | Per-dcInput shading mapping is current-schema behavior. | | `StringShadingMap.shadingSceneId` | `shadingSceneId` | `current` | Direct match at scene identifier level. | | `StringShadingMap.tableGroupId` | `shadingSceneId` | `legacy term` | Current schema adds table-group linkage controls. | | `StringShadingMap.tableIds` | `shadingSceneId` | `legacy term` | Current schema adds table-level linkage controls. | | `TransformerLosses.copperLoss` | `copperLoss` | `current` | Direct match. | | `TransformerLosses.ironLoss` | `ironLoss` | `current` | Direct match. | | `WeatherDataArrayInput.date` | `date` | `legacy term` | PDF overview does not detail auto-generated date behavior for exactly 8760 rows. | | `WeatherDataArrayInput.dhi` | `dhi` | `current` | Direct match. | | `WeatherDataArrayInput.dni` | `dni` | `current` | Direct match. | | `WeatherDataArrayInput.ghi` | `ghi` | `current` | Direct match. | | `WeatherDataArrayInput.poa` | `poa` | `current` | Optional POA irradiance override. | | `WeatherDataArrayInput.relativeHumidity` | `relativeHumidity` | `current` | Direct match. | | `WeatherDataArrayInput.temperature` | `temperature` | `current` | Direct match. | | `WeatherDataArrayInput.windSpeed` | `windSpeed` | `current` | Direct match. | | `WindStow.stowAngle` | `stowAngle` | `current` | Direct match. | | `WindStow.stowSpeedThreshold` | `stowSpeedThreshold` | `current` | Direct match. | ## Behavior Conflicts | Topic | PDF wording | Current behavior | Source | | -------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | POST /energymodels async default | Describes async query parameter but does not establish current default semantics used by API docs. | Route defaults to sync mode when async query is omitted; async queueing requires ?async=true. | packages/api/api/routes/energy\_models.py and packages/api/tests/test\_api/test\_energy\_models.py | | Run identifier naming | References runId. | API responses use taskId, energyModelId, runIndex, and revision. | packages/api/api/routes/energy\_models.py | | Selected-block request contract | Describes top-level blockQuery, blockQueryIndex, and lossBreakdownTimestamps as primary request fields. | The preferred contract uses top-level output.blockIndex plus output.blockResults or output.lossBreakdownTimestamps. Legacy blockQuery/blockQueryIndex are compatibility-only, and conflicting canonical and legacy values return 422. | packages/api/api/routes/energy\_models.py and packages/api/core/models/energy\_model.py | `conflict` entries are intentionally documented for migration clarity.