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.

Physical Model

​Source Reconciliation Matrix

​Behavior Conflicts

Source Reconciliation Matrix

Behavior Conflicts