# Formualizer Public Workbook Catalog

# CMS Actuarial Value (AV) Calculator 2025 (2025)

> Estimates the share of essential health benefit costs paid by a health plan using the CMS 2025 continuance distributions. Experimental integrated medical/drug plan port with metal-tier and CSR scenario workflows.

- **Model ID**: `cms-av-calculator@2025` (Package `2025.1.0`)
- **Publisher**: [Centers for Medicare & Medicaid Services (CMS / CCIIO)](https://www.cms.gov/cciio/resources/regulations-and-guidance)
- **Source Workbook**: `final-2025-av-calculator.xlsm` (`sha256:93c56e9baba96405aee456de47ea33b383ddc46db9436c23f580bb6c598e65a4`)
- **Cadence**: annual | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression. JavaScript port of the publisher's VBA macros; the publisher's VBA macro does not run. Independent Excel/VBA scenario parity remains unchecked.
- **Workbook Download**: `catalog-bytes`; source: https://www.cms.gov/files/document/final-2025-av-calculator.xlsm; upstreamArtifact: null; catalog file size: 2153394 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_metal_check`

## Flows

### `quick_metal_check` — Quick metal check (single)
Evaluate an integrated plan. Copay flags retain source checked defaults unless explicitly overridden (see presets).
- **Inputs**: `desired_metal_tier`, `deductible`, `moop`, `coinsurance`, `hsa_contribution`, `pcp_copay`, `specialist_copay`, `er_copay`, `inpatient_copay`, `generic_rx_copay`, `preferred_brand_rx_copay`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`

### `full_plan_design` — Full plan design (single)
Full mapped input contract including service flags and reserved separate-Rx/tiered/limit ports. This edition rejects unported branches instead of ignoring inputs.
- **Inputs**: `desired_metal_tier`, `deductible`, `coinsurance`, `moop`, `hsa_contribution`, `medical_deductible`, `medical_coinsurance`, `medical_moop`, `combined_moop_separate_deductibles`, `separate_rx_deductible`, `rx_coinsurance`, `rx_moop`, `tier2_deductible`, `tier2_coinsurance`, `tier2_moop`, `medical_tier2_deductible`, `medical_tier2_coinsurance`, `medical_tier2_moop`, `combined_moop_separate_deductibles_tier2`, `rx_tier2_deductible`, `rx_tier2_coinsurance`, `rx_tier2_moop`, `integrated_deductible`, `hsa_enabled`, `tiered_network`, `separate_moop`, `inpatient_per_diem`, `skilled_nursing_per_diem`, `specialty_rx_cap_enabled`, `inpatient_day_limit_enabled`, `pcp_free_visits_enabled`, `pcp_copay_visits_enabled`, `specialty_rx_coinsurance_max`, `inpatient_copay_day_limit`, `pcp_free_visit_limit`, `pcp_copay_visit_limit`, `tier1_utilization`, `tier2_utilization`, `csr_target`, `er_copay`, `er_coinsurance`, `er_subject_to_deductible`, `er_subject_to_coinsurance`, `er_copay_after_deductible`, `er_copay_tier2`, `er_coinsurance_tier2`, `er_subject_to_deductible_tier2`, `er_subject_to_coinsurance_tier2`, `er_copay_after_deductible_tier2`, `inpatient_copay`, `inpatient_coinsurance`, `inpatient_subject_to_deductible`, `inpatient_subject_to_coinsurance`, `inpatient_copay_after_deductible`, `inpatient_copay_tier2`, `inpatient_coinsurance_tier2`, `inpatient_subject_to_deductible_tier2`, `inpatient_subject_to_coinsurance_tier2`, `inpatient_copay_after_deductible_tier2`, `pcp_copay`, `pcp_coinsurance`, `pcp_subject_to_deductible`, `pcp_subject_to_coinsurance`, `pcp_copay_after_deductible`, `pcp_copay_tier2`, `pcp_coinsurance_tier2`, `pcp_subject_to_deductible_tier2`, `pcp_subject_to_coinsurance_tier2`, `pcp_copay_after_deductible_tier2`, `specialist_copay`, `specialist_coinsurance`, `specialist_subject_to_deductible`, `specialist_subject_to_coinsurance`, `specialist_copay_after_deductible`, `specialist_copay_tier2`, `specialist_coinsurance_tier2`, `specialist_subject_to_deductible_tier2`, `specialist_subject_to_coinsurance_tier2`, `specialist_copay_after_deductible_tier2`, `mental_health_copay`, `mental_health_coinsurance`, `mental_health_subject_to_deductible`, `mental_health_subject_to_coinsurance`, `mental_health_copay_after_deductible`, `mental_health_copay_tier2`, `mental_health_coinsurance_tier2`, `mental_health_subject_to_deductible_tier2`, `mental_health_subject_to_coinsurance_tier2`, `mental_health_copay_after_deductible_tier2`, `imaging_copay`, `imaging_coinsurance`, `imaging_subject_to_deductible`, `imaging_subject_to_coinsurance`, `imaging_copay_after_deductible`, `imaging_copay_tier2`, `imaging_coinsurance_tier2`, `imaging_subject_to_deductible_tier2`, `imaging_subject_to_coinsurance_tier2`, `imaging_copay_after_deductible_tier2`, `speech_therapy_copay`, `speech_therapy_coinsurance`, `speech_therapy_subject_to_deductible`, `speech_therapy_subject_to_coinsurance`, `speech_therapy_copay_after_deductible`, `speech_therapy_copay_tier2`, `speech_therapy_coinsurance_tier2`, `speech_therapy_subject_to_deductible_tier2`, `speech_therapy_subject_to_coinsurance_tier2`, `speech_therapy_copay_after_deductible_tier2`, `rehab_copay`, `rehab_coinsurance`, `rehab_subject_to_deductible`, `rehab_subject_to_coinsurance`, `rehab_copay_after_deductible`, `rehab_copay_tier2`, `rehab_coinsurance_tier2`, `rehab_subject_to_deductible_tier2`, `rehab_subject_to_coinsurance_tier2`, `rehab_copay_after_deductible_tier2`, `preventive_copay`, `preventive_coinsurance`, `preventive_subject_to_deductible`, `preventive_subject_to_coinsurance`, `preventive_copay_tier2`, `preventive_coinsurance_tier2`, `preventive_subject_to_deductible_tier2`, `preventive_subject_to_coinsurance_tier2`, `lab_copay`, `lab_coinsurance`, `lab_subject_to_deductible`, `lab_subject_to_coinsurance`, `lab_copay_after_deductible`, `lab_copay_tier2`, `lab_coinsurance_tier2`, `lab_subject_to_deductible_tier2`, `lab_subject_to_coinsurance_tier2`, `lab_copay_after_deductible_tier2`, `xray_copay`, `xray_coinsurance`, `xray_subject_to_deductible`, `xray_subject_to_coinsurance`, `xray_copay_after_deductible`, `xray_copay_tier2`, `xray_coinsurance_tier2`, `xray_subject_to_deductible_tier2`, `xray_subject_to_coinsurance_tier2`, `xray_copay_after_deductible_tier2`, `skilled_nursing_copay`, `skilled_nursing_coinsurance`, `skilled_nursing_subject_to_deductible`, `skilled_nursing_subject_to_coinsurance`, `skilled_nursing_copay_after_deductible`, `skilled_nursing_copay_tier2`, `skilled_nursing_coinsurance_tier2`, `skilled_nursing_subject_to_deductible_tier2`, `skilled_nursing_subject_to_coinsurance_tier2`, `skilled_nursing_copay_after_deductible_tier2`, `outpatient_facility_copay`, `outpatient_facility_coinsurance`, `outpatient_facility_subject_to_deductible`, `outpatient_facility_subject_to_coinsurance`, `outpatient_facility_copay_after_deductible`, `outpatient_facility_copay_tier2`, `outpatient_facility_coinsurance_tier2`, `outpatient_facility_subject_to_deductible_tier2`, `outpatient_facility_subject_to_coinsurance_tier2`, `outpatient_facility_copay_after_deductible_tier2`, `outpatient_professional_copay`, `outpatient_professional_coinsurance`, `outpatient_professional_subject_to_deductible`, `outpatient_professional_subject_to_coinsurance`, `outpatient_professional_copay_after_deductible`, `outpatient_professional_copay_tier2`, `outpatient_professional_coinsurance_tier2`, `outpatient_professional_subject_to_deductible_tier2`, `outpatient_professional_subject_to_coinsurance_tier2`, `outpatient_professional_copay_after_deductible_tier2`, `generic_rx_copay`, `generic_rx_coinsurance`, `generic_rx_subject_to_deductible`, `generic_rx_subject_to_coinsurance`, `generic_rx_copay_after_deductible`, `generic_rx_copay_tier2`, `generic_rx_coinsurance_tier2`, `generic_rx_subject_to_deductible_tier2`, `generic_rx_subject_to_coinsurance_tier2`, `generic_rx_copay_after_deductible_tier2`, `preferred_brand_rx_copay`, `preferred_brand_rx_coinsurance`, `preferred_brand_rx_subject_to_deductible`, `preferred_brand_rx_subject_to_coinsurance`, `preferred_brand_rx_copay_after_deductible`, `preferred_brand_rx_copay_tier2`, `preferred_brand_rx_coinsurance_tier2`, `preferred_brand_rx_subject_to_deductible_tier2`, `preferred_brand_rx_subject_to_coinsurance_tier2`, `preferred_brand_rx_copay_after_deductible_tier2`, `nonpreferred_brand_rx_copay`, `nonpreferred_brand_rx_coinsurance`, `nonpreferred_brand_rx_subject_to_deductible`, `nonpreferred_brand_rx_subject_to_coinsurance`, `nonpreferred_brand_rx_copay_after_deductible`, `nonpreferred_brand_rx_copay_tier2`, `nonpreferred_brand_rx_coinsurance_tier2`, `nonpreferred_brand_rx_subject_to_deductible_tier2`, `nonpreferred_brand_rx_subject_to_coinsurance_tier2`, `nonpreferred_brand_rx_copay_after_deductible_tier2`, `specialty_rx_copay`, `specialty_rx_coinsurance`, `specialty_rx_subject_to_deductible`, `specialty_rx_subject_to_coinsurance`, `specialty_rx_copay_after_deductible`, `specialty_rx_copay_tier2`, `specialty_rx_coinsurance_tier2`, `specialty_rx_subject_to_deductible_tier2`, `specialty_rx_subject_to_coinsurance_tier2`, `specialty_rx_copay_after_deductible_tier2`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`, `effective_coin_num`, `adj_deductible`, `adj_moop`

### `csr_variant_matrix` — Silver CSR variant matrix (preset_matrix)
One call evaluates four independently reset scenario presets. Each variant overrides its benefit parameters and uses Silver/Gold/Platinum continuance distributions for 73/87/94. These are sample plan designs, not automatic CSR benefit derivation.
- **Inputs**: `desired_metal_tier`, `deductible`, `moop`, `coinsurance`, `hsa_contribution`, `pcp_copay`, `specialist_copay`, `er_copay`, `inpatient_copay`, `generic_rx_copay`, `preferred_brand_rx_copay`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`, `effective_coin_num`, `adj_deductible`, `adj_moop`

## SheetPort Ports (`fio.yaml`)

- **`desired_metal_tier`** (`in`, `scalar`): Adapter mirror of native HelperTab!D2: 1 Platinum, 2 Gold, 3 Silver, 4 Bronze. Source dropdown baseline is 3.
- **`deductible`** (`in`, `scalar`): USD per year.
- **`coinsurance`** (`in`, `scalar`): Insurer share, fraction 0–1; 0.8 means 80% plan-paid.
- **`moop`** (`in`, `scalar`): USD per year.
- **`hsa_contribution`** (`in`, `scalar`): USD per year.
- **`medical_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`medical_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`combined_moop_separate_deductibles`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`separate_rx_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`rx_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`medical_tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`combined_moop_separate_deductibles_tier2`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`rx_tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`integrated_deductible`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control Checkbox_Int. Hook fallback uses source checked state.
- **`hsa_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control hsa. Hook fallback uses source checked state.
- **`tiered_network`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control MULTITIER_PLAN. Hook fallback uses source checked state.
- **`separate_moop`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control Checkbox_Sep. Hook fallback uses source checked state.
- **`inpatient_per_diem`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ip_per_diem. Hook fallback uses source checked state.
- **`skilled_nursing_per_diem`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control snf_per_diem. Hook fallback uses source checked state.
- **`specialty_rx_cap_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control specrx_coins_max. Hook fallback uses source checked state.
- **`inpatient_day_limit_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ip_copay_limit. Hook fallback uses source checked state.
- **`pcp_free_visits_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ofv_limit. Hook fallback uses source checked state.
- **`pcp_copay_visits_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ofv_copay_limit. Hook fallback uses source checked state.
- **`specialty_rx_coinsurance_max`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`inpatient_copay_day_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`pcp_free_visit_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`pcp_copay_visit_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`tier1_utilization`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`tier2_utilization`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`csr_target`** (`in`, `scalar`): Adapter mirror for optional standards form: 0 standard, 73, 87, 94 CSR, 60 expanded Bronze.
- **`er_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`er_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`er_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_er (source cell blank).
- **`er_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_er (source cell blank).
- **`er_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_er (source cell blank).
- **`er_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`er_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`er_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_er2 (source cell blank).
- **`er_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_er2 (source cell blank).
- **`er_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_er2 (source cell blank).
- **`inpatient_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`inpatient_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`inpatient_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ip (source cell blank).
- **`inpatient_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ip (source cell blank).
- **`inpatient_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ip (source cell blank).
- **`inpatient_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`inpatient_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`inpatient_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ip2 (source cell blank).
- **`inpatient_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ip2 (source cell blank).
- **`inpatient_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ip2 (source cell blank).
- **`pcp_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`pcp_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`pcp_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_pc (source cell blank).
- **`pcp_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_pc (source cell blank).
- **`pcp_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_pc (source cell blank).
- **`pcp_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`pcp_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`pcp_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_pc2 (source cell blank).
- **`pcp_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_pc2 (source cell blank).
- **`pcp_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_pc2 (source cell blank).
- **`specialist_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialist_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialist_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_sp (source cell blank).
- **`specialist_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_sp (source cell blank).
- **`specialist_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_sp (source cell blank).
- **`specialist_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialist_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialist_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_sp2 (source cell blank).
- **`specialist_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_sp2 (source cell blank).
- **`specialist_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_sp2 (source cell blank).
- **`mental_health_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`mental_health_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`mental_health_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_psy (source cell blank).
- **`mental_health_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_psy (source cell blank).
- **`mental_health_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_psy (source cell blank).
- **`mental_health_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`mental_health_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`mental_health_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_psy2 (source cell blank).
- **`mental_health_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_psy2 (source cell blank).
- **`mental_health_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_psy2 (source cell blank).
- **`imaging_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`imaging_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`imaging_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_img (source cell blank).
- **`imaging_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_img (source cell blank).
- **`imaging_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_img (source cell blank).
- **`imaging_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`imaging_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`imaging_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_img2 (source cell blank).
- **`imaging_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_img2 (source cell blank).
- **`imaging_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_img2 (source cell blank).
- **`speech_therapy_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`speech_therapy_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`speech_therapy_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_st (source cell blank).
- **`speech_therapy_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_st (source cell blank).
- **`speech_therapy_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_st (source cell blank).
- **`speech_therapy_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`speech_therapy_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`speech_therapy_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_st2 (source cell blank).
- **`speech_therapy_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_st2 (source cell blank).
- **`speech_therapy_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_st2 (source cell blank).
- **`rehab_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`rehab_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`rehab_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ot (source cell blank).
- **`rehab_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ot (source cell blank).
- **`rehab_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ot (source cell blank).
- **`rehab_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`rehab_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`rehab_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ot2 (source cell blank).
- **`rehab_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ot2 (source cell blank).
- **`rehab_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ot2 (source cell blank).
- **`preventive_copay`** (`in`, `scalar`): Preventive must remain zero.
- **`preventive_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preventive_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_prev (source cell blank).
- **`preventive_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_prev (source cell blank).
- **`preventive_copay_tier2`** (`in`, `scalar`): Preventive must remain zero.
- **`preventive_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preventive_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_prev2 (source cell blank).
- **`preventive_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_prev2 (source cell blank).
- **`lab_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`lab_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`lab_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_lab (source cell blank).
- **`lab_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_lab (source cell blank).
- **`lab_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_lab (source cell blank).
- **`lab_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`lab_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`lab_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_lab2 (source cell blank).
- **`lab_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_lab2 (source cell blank).
- **`lab_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_lab2 (source cell blank).
- **`xray_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`xray_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`xray_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_xray (source cell blank).
- **`xray_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_xray (source cell blank).
- **`xray_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_xray (source cell blank).
- **`xray_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`xray_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`xray_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_xray2 (source cell blank).
- **`xray_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_xray2 (source cell blank).
- **`xray_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_xray2 (source cell blank).
- **`skilled_nursing_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`skilled_nursing_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`skilled_nursing_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_snf (source cell blank).
- **`skilled_nursing_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_snf (source cell blank).
- **`skilled_nursing_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_snf (source cell blank).
- **`skilled_nursing_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`skilled_nursing_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`skilled_nursing_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_snf2 (source cell blank).
- **`skilled_nursing_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_snf2 (source cell blank).
- **`skilled_nursing_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_snf2 (source cell blank).
- **`outpatient_facility_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_facility_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_facility_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opfac (source cell blank).
- **`outpatient_facility_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opfac (source cell blank).
- **`outpatient_facility_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opfac (source cell blank).
- **`outpatient_facility_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_facility_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_facility_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opfac2 (source cell blank).
- **`outpatient_facility_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opfac2 (source cell blank).
- **`outpatient_facility_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opfac2 (source cell blank).
- **`outpatient_professional_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_professional_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_professional_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opprof (source cell blank).
- **`outpatient_professional_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opprof (source cell blank).
- **`outpatient_professional_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opprof (source cell blank).
- **`outpatient_professional_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_professional_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_professional_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opprof2 (source cell blank).
- **`outpatient_professional_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opprof2 (source cell blank).
- **`outpatient_professional_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opprof2 (source cell blank).
- **`generic_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`generic_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`generic_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxgen (source cell blank).
- **`generic_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxgen (source cell blank).
- **`generic_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxgen (source cell blank).
- **`generic_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`generic_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`generic_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxgen2 (source cell blank).
- **`generic_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxgen2 (source cell blank).
- **`generic_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxgen2 (source cell blank).
- **`preferred_brand_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`preferred_brand_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preferred_brand_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxform (source cell blank).
- **`preferred_brand_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxform (source cell blank).
- **`preferred_brand_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxform (source cell blank).
- **`preferred_brand_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`preferred_brand_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preferred_brand_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxform2 (source cell blank).
- **`preferred_brand_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxform2 (source cell blank).
- **`preferred_brand_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxform2 (source cell blank).
- **`nonpreferred_brand_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`nonpreferred_brand_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`nonpreferred_brand_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`nonpreferred_brand_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`nonpreferred_brand_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxnonform2 (source cell blank).
- **`nonpreferred_brand_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxnonform2 (source cell blank).
- **`nonpreferred_brand_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxnonform2 (source cell blank).
- **`specialty_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialty_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialty_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxspclty (source cell blank).
- **`specialty_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxspclty (source cell blank).
- **`specialty_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxspclty (source cell blank).
- **`specialty_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialty_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialty_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxspclty2 (source cell blank).
- **`specialty_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxspclty2 (source cell blank).
- **`specialty_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxspclty2 (source cell blank).
- **`av_percent`** (`out`, `scalar`): Percentage points, 0–100, four-decimal AV ratio rounded then multiplied by 100.
- **`metal_tier`** (`out`, `scalar`): Metal label; Out of Range if outside selected standard.
- **`status_notes`** (`out`, `scalar`): Calculation status and experimental implementation notice.
- **`effective_coin_num`** (`out`, `scalar`): Effective coinsurance numerator in USD per enrollee, not a rate.
- **`adj_deductible`** (`out`, `scalar`): Adjusted spending-level deductible, USD.
- **`adj_moop`** (`out`, `scalar`): Modified MOOP, USD.

## Editorial & Version Notes

The 2025 workbook identifies itself as 2025_1a; 2027 is 2027_1b. AV Calculator coordinates and all twelve continuance headers/data row bounds are unchanged (header row 4, data rows 5–170). The 2025 tables use 2021 EDGE claims projected to 2025; 2027 equally blends 2021–2023 EDGE claims projected to 2027, with 6.7% medical and 10.7% drug trends for 2026–2027 and a simple-average annualization method. The 2027 VBA MOOP input guard rises from $9,200 to $2,000,000; this removes the regulatory-limit check and does not mean a $2,000,000 MOOP complies with ACA limits. Outpatient cost-sharing override detection and notes also changed. This package uses each workbook’s own tables, preserves edition-specific validation, and remains an experimental integrated-plan port pending Excel oracle comparison and remaining macro branches.

---

# CMS Actuarial Value (AV) Calculator 2027 (2027)

> Estimates the share of essential health benefit costs paid by a health plan using the CMS 2027 continuance distributions. Experimental integrated medical/drug plan port with metal-tier and CSR scenario workflows.

- **Model ID**: `cms-av-calculator@2027` (Package `2027.1.0`)
- **Publisher**: [Centers for Medicare & Medicaid Services (CMS / CCIIO)](https://www.cms.gov/cciio/resources/regulations-and-guidance)
- **Source Workbook**: `final-2027-av-calculator.xlsm` (`sha256:8ac193a227a3ed47ed800c3f7079597434a56ca8e33262d2fbe4a8012a31590c`)
- **Cadence**: annual | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression. JavaScript port of the publisher's VBA macros; the publisher's VBA macro does not run. Independent Excel/VBA scenario parity remains unchecked.
- **Workbook Download**: `catalog-bytes`; source: https://www.cms.gov/files/document/final-2027-av-calculator.xlsm; upstreamArtifact: null; catalog file size: 2167950 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_metal_check`

## Flows

### `quick_metal_check` — Quick metal check (single)
Evaluate an integrated plan. Copay flags retain source checked defaults unless explicitly overridden (see presets).
- **Inputs**: `desired_metal_tier`, `deductible`, `moop`, `coinsurance`, `hsa_contribution`, `pcp_copay`, `specialist_copay`, `er_copay`, `inpatient_copay`, `generic_rx_copay`, `preferred_brand_rx_copay`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`

### `full_plan_design` — Full plan design (single)
Full mapped input contract including service flags and reserved separate-Rx/tiered/limit ports. This edition rejects unported branches instead of ignoring inputs.
- **Inputs**: `desired_metal_tier`, `deductible`, `coinsurance`, `moop`, `hsa_contribution`, `medical_deductible`, `medical_coinsurance`, `medical_moop`, `combined_moop_separate_deductibles`, `separate_rx_deductible`, `rx_coinsurance`, `rx_moop`, `tier2_deductible`, `tier2_coinsurance`, `tier2_moop`, `medical_tier2_deductible`, `medical_tier2_coinsurance`, `medical_tier2_moop`, `combined_moop_separate_deductibles_tier2`, `rx_tier2_deductible`, `rx_tier2_coinsurance`, `rx_tier2_moop`, `integrated_deductible`, `hsa_enabled`, `tiered_network`, `separate_moop`, `inpatient_per_diem`, `skilled_nursing_per_diem`, `specialty_rx_cap_enabled`, `inpatient_day_limit_enabled`, `pcp_free_visits_enabled`, `pcp_copay_visits_enabled`, `specialty_rx_coinsurance_max`, `inpatient_copay_day_limit`, `pcp_free_visit_limit`, `pcp_copay_visit_limit`, `tier1_utilization`, `tier2_utilization`, `csr_target`, `er_copay`, `er_coinsurance`, `er_subject_to_deductible`, `er_subject_to_coinsurance`, `er_copay_after_deductible`, `er_copay_tier2`, `er_coinsurance_tier2`, `er_subject_to_deductible_tier2`, `er_subject_to_coinsurance_tier2`, `er_copay_after_deductible_tier2`, `inpatient_copay`, `inpatient_coinsurance`, `inpatient_subject_to_deductible`, `inpatient_subject_to_coinsurance`, `inpatient_copay_after_deductible`, `inpatient_copay_tier2`, `inpatient_coinsurance_tier2`, `inpatient_subject_to_deductible_tier2`, `inpatient_subject_to_coinsurance_tier2`, `inpatient_copay_after_deductible_tier2`, `pcp_copay`, `pcp_coinsurance`, `pcp_subject_to_deductible`, `pcp_subject_to_coinsurance`, `pcp_copay_after_deductible`, `pcp_copay_tier2`, `pcp_coinsurance_tier2`, `pcp_subject_to_deductible_tier2`, `pcp_subject_to_coinsurance_tier2`, `pcp_copay_after_deductible_tier2`, `specialist_copay`, `specialist_coinsurance`, `specialist_subject_to_deductible`, `specialist_subject_to_coinsurance`, `specialist_copay_after_deductible`, `specialist_copay_tier2`, `specialist_coinsurance_tier2`, `specialist_subject_to_deductible_tier2`, `specialist_subject_to_coinsurance_tier2`, `specialist_copay_after_deductible_tier2`, `mental_health_copay`, `mental_health_coinsurance`, `mental_health_subject_to_deductible`, `mental_health_subject_to_coinsurance`, `mental_health_copay_after_deductible`, `mental_health_copay_tier2`, `mental_health_coinsurance_tier2`, `mental_health_subject_to_deductible_tier2`, `mental_health_subject_to_coinsurance_tier2`, `mental_health_copay_after_deductible_tier2`, `imaging_copay`, `imaging_coinsurance`, `imaging_subject_to_deductible`, `imaging_subject_to_coinsurance`, `imaging_copay_after_deductible`, `imaging_copay_tier2`, `imaging_coinsurance_tier2`, `imaging_subject_to_deductible_tier2`, `imaging_subject_to_coinsurance_tier2`, `imaging_copay_after_deductible_tier2`, `speech_therapy_copay`, `speech_therapy_coinsurance`, `speech_therapy_subject_to_deductible`, `speech_therapy_subject_to_coinsurance`, `speech_therapy_copay_after_deductible`, `speech_therapy_copay_tier2`, `speech_therapy_coinsurance_tier2`, `speech_therapy_subject_to_deductible_tier2`, `speech_therapy_subject_to_coinsurance_tier2`, `speech_therapy_copay_after_deductible_tier2`, `rehab_copay`, `rehab_coinsurance`, `rehab_subject_to_deductible`, `rehab_subject_to_coinsurance`, `rehab_copay_after_deductible`, `rehab_copay_tier2`, `rehab_coinsurance_tier2`, `rehab_subject_to_deductible_tier2`, `rehab_subject_to_coinsurance_tier2`, `rehab_copay_after_deductible_tier2`, `preventive_copay`, `preventive_coinsurance`, `preventive_subject_to_deductible`, `preventive_subject_to_coinsurance`, `preventive_copay_tier2`, `preventive_coinsurance_tier2`, `preventive_subject_to_deductible_tier2`, `preventive_subject_to_coinsurance_tier2`, `lab_copay`, `lab_coinsurance`, `lab_subject_to_deductible`, `lab_subject_to_coinsurance`, `lab_copay_after_deductible`, `lab_copay_tier2`, `lab_coinsurance_tier2`, `lab_subject_to_deductible_tier2`, `lab_subject_to_coinsurance_tier2`, `lab_copay_after_deductible_tier2`, `xray_copay`, `xray_coinsurance`, `xray_subject_to_deductible`, `xray_subject_to_coinsurance`, `xray_copay_after_deductible`, `xray_copay_tier2`, `xray_coinsurance_tier2`, `xray_subject_to_deductible_tier2`, `xray_subject_to_coinsurance_tier2`, `xray_copay_after_deductible_tier2`, `skilled_nursing_copay`, `skilled_nursing_coinsurance`, `skilled_nursing_subject_to_deductible`, `skilled_nursing_subject_to_coinsurance`, `skilled_nursing_copay_after_deductible`, `skilled_nursing_copay_tier2`, `skilled_nursing_coinsurance_tier2`, `skilled_nursing_subject_to_deductible_tier2`, `skilled_nursing_subject_to_coinsurance_tier2`, `skilled_nursing_copay_after_deductible_tier2`, `outpatient_facility_copay`, `outpatient_facility_coinsurance`, `outpatient_facility_subject_to_deductible`, `outpatient_facility_subject_to_coinsurance`, `outpatient_facility_copay_after_deductible`, `outpatient_facility_copay_tier2`, `outpatient_facility_coinsurance_tier2`, `outpatient_facility_subject_to_deductible_tier2`, `outpatient_facility_subject_to_coinsurance_tier2`, `outpatient_facility_copay_after_deductible_tier2`, `outpatient_professional_copay`, `outpatient_professional_coinsurance`, `outpatient_professional_subject_to_deductible`, `outpatient_professional_subject_to_coinsurance`, `outpatient_professional_copay_after_deductible`, `outpatient_professional_copay_tier2`, `outpatient_professional_coinsurance_tier2`, `outpatient_professional_subject_to_deductible_tier2`, `outpatient_professional_subject_to_coinsurance_tier2`, `outpatient_professional_copay_after_deductible_tier2`, `generic_rx_copay`, `generic_rx_coinsurance`, `generic_rx_subject_to_deductible`, `generic_rx_subject_to_coinsurance`, `generic_rx_copay_after_deductible`, `generic_rx_copay_tier2`, `generic_rx_coinsurance_tier2`, `generic_rx_subject_to_deductible_tier2`, `generic_rx_subject_to_coinsurance_tier2`, `generic_rx_copay_after_deductible_tier2`, `preferred_brand_rx_copay`, `preferred_brand_rx_coinsurance`, `preferred_brand_rx_subject_to_deductible`, `preferred_brand_rx_subject_to_coinsurance`, `preferred_brand_rx_copay_after_deductible`, `preferred_brand_rx_copay_tier2`, `preferred_brand_rx_coinsurance_tier2`, `preferred_brand_rx_subject_to_deductible_tier2`, `preferred_brand_rx_subject_to_coinsurance_tier2`, `preferred_brand_rx_copay_after_deductible_tier2`, `nonpreferred_brand_rx_copay`, `nonpreferred_brand_rx_coinsurance`, `nonpreferred_brand_rx_subject_to_deductible`, `nonpreferred_brand_rx_subject_to_coinsurance`, `nonpreferred_brand_rx_copay_after_deductible`, `nonpreferred_brand_rx_copay_tier2`, `nonpreferred_brand_rx_coinsurance_tier2`, `nonpreferred_brand_rx_subject_to_deductible_tier2`, `nonpreferred_brand_rx_subject_to_coinsurance_tier2`, `nonpreferred_brand_rx_copay_after_deductible_tier2`, `specialty_rx_copay`, `specialty_rx_coinsurance`, `specialty_rx_subject_to_deductible`, `specialty_rx_subject_to_coinsurance`, `specialty_rx_copay_after_deductible`, `specialty_rx_copay_tier2`, `specialty_rx_coinsurance_tier2`, `specialty_rx_subject_to_deductible_tier2`, `specialty_rx_subject_to_coinsurance_tier2`, `specialty_rx_copay_after_deductible_tier2`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`, `effective_coin_num`, `adj_deductible`, `adj_moop`

### `csr_variant_matrix` — Silver CSR variant matrix (preset_matrix)
One call evaluates four independently reset scenario presets. Each variant overrides its benefit parameters and uses Silver/Gold/Platinum continuance distributions for 73/87/94. These are sample plan designs, not automatic CSR benefit derivation.
- **Inputs**: `desired_metal_tier`, `deductible`, `moop`, `coinsurance`, `hsa_contribution`, `pcp_copay`, `specialist_copay`, `er_copay`, `inpatient_copay`, `generic_rx_copay`, `preferred_brand_rx_copay`
- **Outputs**: `av_percent`, `metal_tier`, `status_notes`, `effective_coin_num`, `adj_deductible`, `adj_moop`

## SheetPort Ports (`fio.yaml`)

- **`desired_metal_tier`** (`in`, `scalar`): Adapter mirror of native HelperTab!D2: 1 Platinum, 2 Gold, 3 Silver, 4 Bronze. Source dropdown baseline is 3.
- **`deductible`** (`in`, `scalar`): USD per year.
- **`coinsurance`** (`in`, `scalar`): Insurer share, fraction 0–1; 0.8 means 80% plan-paid.
- **`moop`** (`in`, `scalar`): USD per year.
- **`hsa_contribution`** (`in`, `scalar`): USD per year.
- **`medical_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`medical_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`combined_moop_separate_deductibles`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`separate_rx_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`rx_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`medical_tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`medical_tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`combined_moop_separate_deductibles_tier2`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_tier2_deductible`** (`in`, `scalar`): Reserved for unported separate-deductible/tiered-network branch; nonblank values rejected.
- **`rx_tier2_coinsurance`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`rx_tier2_moop`** (`in`, `scalar`): Reserved branch; nonblank values rejected.
- **`integrated_deductible`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control Checkbox_Int. Hook fallback uses source checked state.
- **`hsa_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control hsa. Hook fallback uses source checked state.
- **`tiered_network`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control MULTITIER_PLAN. Hook fallback uses source checked state.
- **`separate_moop`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control Checkbox_Sep. Hook fallback uses source checked state.
- **`inpatient_per_diem`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ip_per_diem. Hook fallback uses source checked state.
- **`skilled_nursing_per_diem`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control snf_per_diem. Hook fallback uses source checked state.
- **`specialty_rx_cap_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control specrx_coins_max. Hook fallback uses source checked state.
- **`inpatient_day_limit_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ip_copay_limit. Hook fallback uses source checked state.
- **`pcp_free_visits_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ofv_limit. Hook fallback uses source checked state.
- **`pcp_copay_visits_enabled`** (`in`, `scalar`): Adapter mirror of unlinked Excel Form Control ofv_copay_limit. Hook fallback uses source checked state.
- **`specialty_rx_coinsurance_max`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`inpatient_copay_day_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`pcp_free_visit_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`pcp_copay_visit_limit`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`tier1_utilization`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`tier2_utilization`** (`in`, `scalar`): Reserved benefit-limit/tier branch; nonblank values rejected.
- **`csr_target`** (`in`, `scalar`): Adapter mirror for optional standards form: 0 standard, 73, 87, 94 CSR, 60 expanded Bronze.
- **`er_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`er_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`er_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_er (source cell blank).
- **`er_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_er (source cell blank).
- **`er_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_er (source cell blank).
- **`er_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`er_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`er_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_er2 (source cell blank).
- **`er_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_er2 (source cell blank).
- **`er_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_er2 (source cell blank).
- **`inpatient_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`inpatient_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`inpatient_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ip (source cell blank).
- **`inpatient_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ip (source cell blank).
- **`inpatient_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ip (source cell blank).
- **`inpatient_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`inpatient_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`inpatient_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ip2 (source cell blank).
- **`inpatient_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ip2 (source cell blank).
- **`inpatient_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ip2 (source cell blank).
- **`pcp_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`pcp_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`pcp_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_pc (source cell blank).
- **`pcp_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_pc (source cell blank).
- **`pcp_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_pc (source cell blank).
- **`pcp_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`pcp_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`pcp_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_pc2 (source cell blank).
- **`pcp_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_pc2 (source cell blank).
- **`pcp_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_pc2 (source cell blank).
- **`specialist_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialist_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialist_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_sp (source cell blank).
- **`specialist_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_sp (source cell blank).
- **`specialist_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_sp (source cell blank).
- **`specialist_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialist_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialist_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_sp2 (source cell blank).
- **`specialist_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_sp2 (source cell blank).
- **`specialist_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_sp2 (source cell blank).
- **`mental_health_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`mental_health_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`mental_health_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_psy (source cell blank).
- **`mental_health_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_psy (source cell blank).
- **`mental_health_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_psy (source cell blank).
- **`mental_health_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`mental_health_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`mental_health_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_psy2 (source cell blank).
- **`mental_health_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_psy2 (source cell blank).
- **`mental_health_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_psy2 (source cell blank).
- **`imaging_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`imaging_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`imaging_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_img (source cell blank).
- **`imaging_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_img (source cell blank).
- **`imaging_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_img (source cell blank).
- **`imaging_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`imaging_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`imaging_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_img2 (source cell blank).
- **`imaging_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_img2 (source cell blank).
- **`imaging_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_img2 (source cell blank).
- **`speech_therapy_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`speech_therapy_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`speech_therapy_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_st (source cell blank).
- **`speech_therapy_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_st (source cell blank).
- **`speech_therapy_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_st (source cell blank).
- **`speech_therapy_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`speech_therapy_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`speech_therapy_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_st2 (source cell blank).
- **`speech_therapy_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_st2 (source cell blank).
- **`speech_therapy_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_st2 (source cell blank).
- **`rehab_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`rehab_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`rehab_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ot (source cell blank).
- **`rehab_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ot (source cell blank).
- **`rehab_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ot (source cell blank).
- **`rehab_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`rehab_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`rehab_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_ot2 (source cell blank).
- **`rehab_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_ot2 (source cell blank).
- **`rehab_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_ot2 (source cell blank).
- **`preventive_copay`** (`in`, `scalar`): Preventive must remain zero.
- **`preventive_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preventive_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_prev (source cell blank).
- **`preventive_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_prev (source cell blank).
- **`preventive_copay_tier2`** (`in`, `scalar`): Preventive must remain zero.
- **`preventive_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preventive_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_prev2 (source cell blank).
- **`preventive_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_prev2 (source cell blank).
- **`lab_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`lab_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`lab_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_lab (source cell blank).
- **`lab_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_lab (source cell blank).
- **`lab_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_lab (source cell blank).
- **`lab_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`lab_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`lab_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_lab2 (source cell blank).
- **`lab_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_lab2 (source cell blank).
- **`lab_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_lab2 (source cell blank).
- **`xray_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`xray_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`xray_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_xray (source cell blank).
- **`xray_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_xray (source cell blank).
- **`xray_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_xray (source cell blank).
- **`xray_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`xray_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`xray_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_xray2 (source cell blank).
- **`xray_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_xray2 (source cell blank).
- **`xray_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_xray2 (source cell blank).
- **`skilled_nursing_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`skilled_nursing_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`skilled_nursing_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_snf (source cell blank).
- **`skilled_nursing_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_snf (source cell blank).
- **`skilled_nursing_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_snf (source cell blank).
- **`skilled_nursing_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`skilled_nursing_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`skilled_nursing_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_snf2 (source cell blank).
- **`skilled_nursing_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_snf2 (source cell blank).
- **`skilled_nursing_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_snf2 (source cell blank).
- **`outpatient_facility_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_facility_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_facility_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opfac (source cell blank).
- **`outpatient_facility_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opfac (source cell blank).
- **`outpatient_facility_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opfac (source cell blank).
- **`outpatient_facility_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_facility_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_facility_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opfac2 (source cell blank).
- **`outpatient_facility_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opfac2 (source cell blank).
- **`outpatient_facility_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opfac2 (source cell blank).
- **`outpatient_professional_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_professional_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_professional_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opprof (source cell blank).
- **`outpatient_professional_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opprof (source cell blank).
- **`outpatient_professional_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opprof (source cell blank).
- **`outpatient_professional_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`outpatient_professional_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`outpatient_professional_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_opprof2 (source cell blank).
- **`outpatient_professional_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_opprof2 (source cell blank).
- **`outpatient_professional_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_opprof2 (source cell blank).
- **`generic_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`generic_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`generic_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxgen (source cell blank).
- **`generic_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxgen (source cell blank).
- **`generic_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxgen (source cell blank).
- **`generic_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`generic_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`generic_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxgen2 (source cell blank).
- **`generic_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxgen2 (source cell blank).
- **`generic_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxgen2 (source cell blank).
- **`preferred_brand_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`preferred_brand_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preferred_brand_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxform (source cell blank).
- **`preferred_brand_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxform (source cell blank).
- **`preferred_brand_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxform (source cell blank).
- **`preferred_brand_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`preferred_brand_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`preferred_brand_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxform2 (source cell blank).
- **`preferred_brand_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxform2 (source cell blank).
- **`preferred_brand_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxform2 (source cell blank).
- **`nonpreferred_brand_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`nonpreferred_brand_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`nonpreferred_brand_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxnonform (source cell blank).
- **`nonpreferred_brand_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`nonpreferred_brand_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`nonpreferred_brand_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxnonform2 (source cell blank).
- **`nonpreferred_brand_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxnonform2 (source cell blank).
- **`nonpreferred_brand_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxnonform2 (source cell blank).
- **`specialty_rx_copay`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialty_rx_coinsurance`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialty_rx_subject_to_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxspclty (source cell blank).
- **`specialty_rx_subject_to_coinsurance`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxspclty (source cell blank).
- **`specialty_rx_copay_after_deductible`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxspclty (source cell blank).
- **`specialty_rx_copay_tier2`** (`in`, `scalar`): USD per service; cost sharing flags are independent.
- **`specialty_rx_coinsurance_tier2`** (`in`, `scalar`): Blank inherits general insurer coinsurance.
- **`specialty_rx_subject_to_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control ded_rxspclty2 (source cell blank).
- **`specialty_rx_subject_to_coinsurance_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control coins_rxspclty2 (source cell blank).
- **`specialty_rx_copay_after_deductible_tier2`** (`in`, `scalar`): Adapter mirror of Excel Form Control omit_rxspclty2 (source cell blank).
- **`av_percent`** (`out`, `scalar`): Percentage points, 0–100, four-decimal AV ratio rounded then multiplied by 100.
- **`metal_tier`** (`out`, `scalar`): Metal label; Out of Range if outside selected standard.
- **`status_notes`** (`out`, `scalar`): Calculation status and experimental implementation notice.
- **`effective_coin_num`** (`out`, `scalar`): Effective coinsurance numerator in USD per enrollee, not a rate.
- **`adj_deductible`** (`out`, `scalar`): Adjusted spending-level deductible, USD.
- **`adj_moop`** (`out`, `scalar`): Modified MOOP, USD.

## Editorial & Version Notes

The 2025 workbook identifies itself as 2025_1a; 2027 is 2027_1b. AV Calculator coordinates and all twelve continuance headers/data row bounds are unchanged (header row 4, data rows 5–170). The 2025 tables use 2021 EDGE claims projected to 2025; 2027 equally blends 2021–2023 EDGE claims projected to 2027, with 6.7% medical and 10.7% drug trends for 2026–2027 and a simple-average annualization method. The 2027 VBA MOOP input guard rises from $9,200 to $2,000,000; this removes the regulatory-limit check and does not mean a $2,000,000 MOOP complies with ACA limits. Outpatient cost-sharing override detection and notes also changed. This package uses each workbook’s own tables, preserves edition-specific validation, and remains an experimental integrated-plan port pending Excel oracle comparison and remaining macro branches.

---

# Damodaran Full FCFF Ginzu DCF Valuation (2026)

> NYU Stern multi-sheet discounted FCFF valuation with cost of capital, R&D capitalization, operating leases, country risk and equity dilution. Pinned 2026 catalog snapshot; source example dates and data are preserved.

- **Model ID**: `damodaran-fcff-full-ginzu@2026` (Package `2026.1.0`)
- **Publisher**: [Aswath Damodaran (NYU Stern School of Business)](https://pages.stern.nyu.edu/~adamodar/New_Home_Page/spreadsh.htm)
- **Source Workbook**: `damodaran-fcff-full-ginzu.xlsx` (`sha256:df8f9e91cc53afe2bdb33cf39b8f2719206ac03b6a5031f1858f82235ea944c9`)
- **Cadence**: annual | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression.
- **Workbook Download**: `catalog-bytes`; source: https://pages.stern.nyu.edu/~adamodar/pc/fcffginzu.xlsx; upstreamArtifact: null; catalog file size: 172200 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_dcf_valuation`

## Flows

### `quick_dcf_valuation` — Quick DCF valuation (single)
Growth and discount-rate sensitivities. All unprovided assumptions retain source values/formulas. Amounts and shares use consistent reporting scale; rates are decimals.
- **Inputs**: `operating_income`, `growth_from_fundamentals`, `operating_income_growth`, `high_growth_years`, `risk_free_rate`, `equity_risk_premium`, `high_growth_beta`, `synthetic_rating`, `synthetic_firm_type`, `direct_cost_of_debt`, `stable_growth`, `stable_reinvestment_fundamental`, `stable_return_on_capital`, `keep_current_debt_ratio`, `high_growth_debt_ratio`, `stable_debt_ratio`, `stable_cost_of_debt`
- **Outputs**: `value_per_share`, `operating_asset_value`, `equity_value`, `initial_wacc`, `terminal_fcff`, `terminal_value`

### `full_fcff_ginzu_model` — Full FCFF Ginzu model (single)
All mapped assumptions, R&D history, lease schedule, geography and segment schedules, mode switches and valuation diagnostics. Defaults retain source formulas. Further uncurated chart/lookup cells are accessible through cellOverrides.
- **Inputs**: `company_name`, `capitalize_rd`, `capitalize_leases`, `normalize_earnings`, `country`, `operating_income`, `interest_expense`, `capital_spending`, `depreciation`, `effective_tax_rate`, `marginal_tax_rate`, `revenues`, `noncash_working_capital`, `change_working_capital`, `book_debt`, `book_equity`, `cash`, `non_operating_assets`, `minority_interests`, `stock_traded`, `stock_price`, `shares_outstanding`, `market_debt`, `use_book_debt_ratio`, `private_debt_ratio`, `risk_free_rate`, `equity_risk_premium`, `synthetic_rating`, `actual_credit_rating`, `direct_cost_of_debt`, `options_outstanding`, `option_count`, `option_strike`, `option_maturity`, `option_volatility`, `option_price_basis`, `high_growth_years`, `high_growth_beta`, `keep_current_debt_ratio`, `high_growth_debt_ratio`, `keep_working_capital_ratio`, `working_capital_ratio`, `growth_from_fundamentals`, `operating_income_growth`, `override_growth_fundamentals`, `high_growth_roc`, `high_growth_reinvestment`, `fade_high_growth_inputs`, `stable_growth`, `stable_beta`, `stable_erp`, `stable_debt_ratio`, `stable_cost_of_debt`, `stable_tax_rate`, `stable_reinvestment_fundamental`, `stable_return_on_capital`, `stable_capex_depreciation_ratio`, `rd_amortization_years`, `rd_current_expense`, `rd_expense_year_minus_1`, `rd_expense_year_minus_2`, `rd_expense_year_minus_3`, `rd_expense_year_minus_4`, `rd_expense_year_minus_5`, `rd_expense_year_minus_6`, `rd_expense_year_minus_7`, `rd_expense_year_minus_8`, `rd_expense_year_minus_9`, `rd_expense_year_minus_10`, `lease_current_expense`, `lease_commitment_year_1`, `lease_commitment_year_2`, `lease_commitment_year_3`, `lease_commitment_year_4`, `lease_commitment_year_5`, `lease_commitment_years_six_plus`, `synthetic_firm_type`, `normalizer_approach`, `normalizer_ebit`, `normalizer_roc`, `normalizer_margin`, `prior_revenues`, `prior_working_capital`, `prior_book_debt`, `prior_book_equity`, `prior_cash`, `prior_non_operating_assets`, `prior_minority_interests`, `debt_maturity`, `worksheet_cost_of_debt`, `erp_country_1`, `erp_country_revenue_1`, `erp_country_2`, `erp_country_revenue_2`, `erp_country_3`, `erp_country_revenue_3`, `erp_country_4`, `erp_country_revenue_4`, `erp_country_5`, `erp_country_revenue_5`, `erp_country_6`, `erp_country_revenue_6`, `erp_country_7`, `erp_country_revenue_7`, `erp_country_8`, `erp_country_revenue_8`, `erp_country_9`, `erp_country_revenue_9`, `erp_country_10`, `erp_country_revenue_10`, `erp_country_11`, `erp_country_revenue_11`, `erp_country_12`, `erp_country_revenue_12`, `erp_country_13`, `erp_country_revenue_13`, `erp_region_revenue_1`, `erp_region_revenue_2`, `erp_region_revenue_3`, `erp_region_revenue_4`, `erp_region_revenue_5`, `erp_region_revenue_6`, `erp_region_revenue_7`, `erp_region_revenue_8`, `erp_region_revenue_9`, `erp_region_revenue_10`, `erp_region_revenue_11`, `us_segment_industry_1`, `us_segment_revenue_1`, `us_segment_industry_2`, `us_segment_revenue_2`, `us_segment_industry_3`, `us_segment_revenue_3`, `us_segment_industry_4`, `us_segment_revenue_4`, `us_segment_industry_5`, `us_segment_revenue_5`, `us_segment_industry_6`, `us_segment_revenue_6`, `us_segment_industry_7`, `us_segment_revenue_7`, `us_segment_industry_8`, `us_segment_revenue_8`, `us_segment_industry_9`, `us_segment_revenue_9`, `us_segment_industry_10`, `us_segment_revenue_10`, `us_segment_industry_11`, `us_segment_revenue_11`, `us_segment_industry_12`, `us_segment_revenue_12`, `global_segment_industry_1`, `global_segment_revenue_1`, `global_segment_industry_2`, `global_segment_revenue_2`, `global_segment_industry_3`, `global_segment_revenue_3`, `global_segment_industry_4`, `global_segment_revenue_4`, `global_segment_industry_5`, `global_segment_revenue_5`, `global_segment_industry_6`, `global_segment_revenue_6`, `global_segment_industry_7`, `global_segment_revenue_7`, `global_segment_industry_8`, `global_segment_revenue_8`, `global_segment_industry_9`, `global_segment_revenue_9`, `global_segment_industry_10`, `global_segment_revenue_10`, `global_segment_industry_11`, `global_segment_revenue_11`, `global_segment_industry_12`, `global_segment_revenue_12`
- **Outputs**: `value_per_share`, `operating_asset_value`, `equity_value`, `initial_wacc`, `terminal_fcff`, `terminal_value`, `pv_forecast_fcff`, `pv_terminal_value`, `terminal_wacc`, `market_price_premium`, `rd_asset`, `lease_debt`, `cost_of_equity`, `pretax_cost_of_debt`, `high_growth_rate`, `reinvestment_rate`

## SheetPort Ports (`fio.yaml`)

- **`company_name`** (`in`, `scalar`): Company name; text Default: "Eli Lilly ". Omitted ports preserve the source cell, including its formula.
- **`capitalize_rd`** (`in`, `scalar`): Yes activates rd_* capitalization inputs Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`capitalize_leases`** (`in`, `scalar`): Yes activates lease_* inputs; avoid double counting leases already in debt Default: "No". Omitted ports preserve the source cell, including its formula.
- **`normalize_earnings`** (`in`, `scalar`): Yes activates normalizer_* inputs Default: "No". Omitted ports preserve the source cell, including its formula.
- **`country`** (`in`, `scalar`): Country of incorporation; exact lookup label Default: "United States". Omitted ports preserve the source cell, including its formula.
- **`operating_income`** (`in`, `scalar`): Reported EBIT; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 7040. Omitted ports preserve the source cell, including its formula.
- **`interest_expense`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 486. Omitted ports preserve the source cell, including its formula.
- **`capital_spending`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 3448. Omitted ports preserve the source cell, including its formula.
- **`depreciation`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 1527. Omitted ports preserve the source cell, including its formula.
- **`effective_tax_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.20050041192445. Omitted ports preserve the source cell, including its formula.
- **`marginal_tax_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.25. Omitted ports preserve the source cell, including its formula.
- **`revenues`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 34124. Omitted ports preserve the source cell, including its formula.
- **`noncash_working_capital`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 2411. Omitted ports preserve the source cell, including its formula.
- **`change_working_capital`** (`in`, `scalar`): Increase consumes cash; decrease releases cash; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 2225. Omitted ports preserve the source cell, including its formula.
- **`book_debt`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 25226. Omitted ports preserve the source cell, including its formula.
- **`book_equity`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 10864. Omitted ports preserve the source cell, including its formula.
- **`cash`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 2928. Omitted ports preserve the source cell, including its formula.
- **`non_operating_assets`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 3052. Omitted ports preserve the source cell, including its formula.
- **`minority_interests`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 92. Omitted ports preserve the source cell, including its formula.
- **`stock_traded`** (`in`, `scalar`): Yes uses market debt/equity values; No uses private-company leverage inputs Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`stock_price`** (`in`, `scalar`): Currency per share Default: 804.14. Omitted ports preserve the source cell, including its formula.
- **`shares_outstanding`** (`in`, `scalar`): Shares in same scale as amounts (millions for baseline) Default: 950.41. Omitted ports preserve the source cell, including its formula.
- **`market_debt`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 25226. Omitted ports preserve the source cell, including its formula.
- **`use_book_debt_ratio`** (`in`, `scalar`): For stock_traded=No, Yes uses book debt ratio; No activates private_debt_ratio Default: "No". Omitted ports preserve the source cell, including its formula.
- **`private_debt_ratio`** (`in`, `scalar`): Active when stock_traded=No and use_book_debt_ratio=No; decimal fraction (0.05 = 5%) Default: 0.35. Omitted ports preserve the source cell, including its formula.
- **`risk_free_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.045. Omitted ports preserve the source cell, including its formula.
- **`equity_risk_premium`** (`in`, `scalar`): Direct ERP override, replaces source regional-ERP formula; decimal fraction (0.05 = 5%) Default: 0.04921860682334804. Omitted ports preserve the source cell, including its formula.
- **`synthetic_rating`** (`in`, `scalar`): Yes activates synthetic_firm_type; No activates direct_cost_of_debt Default: "No". Omitted ports preserve the source cell, including its formula.
- **`actual_credit_rating`** (`in`, `scalar`): Descriptive rating label; direct_cost_of_debt controls valuation when synthetic_rating=No Default: "AAA". Omitted ports preserve the source cell, including its formula.
- **`direct_cost_of_debt`** (`in`, `scalar`): Pretax debt cost when synthetic_rating=No; decimal fraction (0.05 = 5%) Default: 0.0509. Omitted ports preserve the source cell, including its formula.
- **`options_outstanding`** (`in`, `scalar`): Yes activates option_* dilution inputs Default: "No". Omitted ports preserve the source cell, including its formula.
- **`option_count`** (`in`, `scalar`): Count in same scale as shares Default: 50.998. Omitted ports preserve the source cell, including its formula.
- **`option_strike`** (`in`, `scalar`): Currency per share Default: 40.35. Omitted ports preserve the source cell, including its formula.
- **`option_maturity`** (`in`, `scalar`): Years Default: 8.3. Omitted ports preserve the source cell, including its formula.
- **`option_volatility`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.25. Omitted ports preserve the source cell, including its formula.
- **`option_price_basis`** (`in`, `scalar`): Current Price uses stock_price; Estimated Value uses valuation Default: "Current Price". Omitted ports preserve the source cell, including its formula.
- **`high_growth_years`** (`in`, `scalar`): Years, integer 1–15 supported by source projection columns Default: 10. Omitted ports preserve the source cell, including its formula.
- **`high_growth_beta`** (`in`, `scalar`): Levered equity beta; dimensionless direct override Default: 0.9366996608369831. Omitted ports preserve the source cell, including its formula.
- **`keep_current_debt_ratio`** (`in`, `scalar`): No activates high_growth_debt_ratio; Yes uses current market/book leverage Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`high_growth_debt_ratio`** (`in`, `scalar`): Active when keep_current_debt_ratio=No; decimal fraction (0.05 = 5%) Default: 0.07. Omitted ports preserve the source cell, including its formula.
- **`keep_working_capital_ratio`** (`in`, `scalar`): No activates working_capital_ratio Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`working_capital_ratio`** (`in`, `scalar`): Noncash working capital/revenue; active when keep_working_capital_ratio=No; decimal fraction (0.05 = 5%) Default: 0.12. Omitted ports preserve the source cell, including its formula.
- **`growth_from_fundamentals`** (`in`, `scalar`): No activates operating_income_growth; Yes uses ROC times reinvestment Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`operating_income_growth`** (`in`, `scalar`): Active when growth_from_fundamentals=No; decimal fraction (0.05 = 5%) Default: 0.15. Omitted ports preserve the source cell, including its formula.
- **`override_growth_fundamentals`** (`in`, `scalar`): Yes activates high_growth_roc and high_growth_reinvestment when growth_from_fundamentals=Yes Default: "No". Omitted ports preserve the source cell, including its formula.
- **`high_growth_roc`** (`in`, `scalar`): Active when override_growth_fundamentals=Yes; decimal fraction (0.05 = 5%) Default: 0.33. Omitted ports preserve the source cell, including its formula.
- **`high_growth_reinvestment`** (`in`, `scalar`): Active when override_growth_fundamentals=Yes; decimal fraction (0.05 = 5%) Default: 0.8811285024606358. Omitted ports preserve the source cell, including its formula.
- **`fade_high_growth_inputs`** (`in`, `scalar`): Yes gradually transitions growth, reinvestment and WACC in second half Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`stable_growth`** (`in`, `scalar`): Perpetual growth below stable WACC; decimal fraction (0.05 = 5%) Default: 0.04. Omitted ports preserve the source cell, including its formula.
- **`stable_beta`** (`in`, `scalar`): Levered beta; dimensionless Default: 1. Omitted ports preserve the source cell, including its formula.
- **`stable_erp`** (`in`, `scalar`): ERP in perpetuity; decimal fraction (0.05 = 5%) Default: 0.04921860682334804. Omitted ports preserve the source cell, including its formula.
- **`stable_debt_ratio`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.2. Omitted ports preserve the source cell, including its formula.
- **`stable_cost_of_debt`** (`in`, `scalar`): Pretax debt cost in perpetuity; decimal fraction (0.05 = 5%) Default: 0.0509. Omitted ports preserve the source cell, including its formula.
- **`stable_tax_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.25. Omitted ports preserve the source cell, including its formula.
- **`stable_reinvestment_fundamental`** (`in`, `scalar`): Yes activates stable_return_on_capital; No activates stable_capex_depreciation_ratio Default: "Yes". Omitted ports preserve the source cell, including its formula.
- **`stable_return_on_capital`** (`in`, `scalar`): Active when stable_reinvestment_fundamental=Yes; decimal fraction (0.05 = 5%) Default: 0.15. Omitted ports preserve the source cell, including its formula.
- **`stable_capex_depreciation_ratio`** (`in`, `scalar`): CapEx/Depreciation; active when stable_reinvestment_fundamental=No; dimensionless ratio Default: 1.2. Omitted ports preserve the source cell, including its formula.
- **`rd_amortization_years`** (`in`, `scalar`): Years, integer 1–10; active when capitalize_rd=Yes Default: 10. Omitted ports preserve the source cell, including its formula.
- **`rd_current_expense`** (`in`, `scalar`): Current R&D; active when capitalize_rd=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 13113. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_1`** (`in`, `scalar`): R&D 1 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 8099. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_2`** (`in`, `scalar`): R&D 2 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 7901. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_3`** (`in`, `scalar`): R&D 3 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 6746. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_4`** (`in`, `scalar`): R&D 4 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 5835. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_5`** (`in`, `scalar`): R&D 5 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 7035. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_6`** (`in`, `scalar`): R&D 6 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 6209. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_7`** (`in`, `scalar`): R&D 7 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 5340. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_8`** (`in`, `scalar`): R&D 8 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 5331. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_9`** (`in`, `scalar`): R&D 9 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 4934. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_10`** (`in`, `scalar`): R&D 10 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 5588. Omitted ports preserve the source cell, including its formula.
- **`lease_current_expense`** (`in`, `scalar`): Operating lease expense; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 504. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_1`** (`in`, `scalar`): Lease commitment year 1; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 453. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_2`** (`in`, `scalar`): Lease commitment year 2; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 371. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_3`** (`in`, `scalar`): Lease commitment year 3; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 265. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_4`** (`in`, `scalar`): Lease commitment year 4; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 180. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_5`** (`in`, `scalar`): Lease commitment year 5; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 122. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_years_six_plus`** (`in`, `scalar`): Lease commitment years 6 and beyond; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 259. Omitted ports preserve the source cell, including its formula.
- **`synthetic_firm_type`** (`in`, `scalar`): 1 large manufacturing; 2 small/risky nonfinancial; 3 financial. Actual operative source cell; Master Inputs B44 is disconnected. Active when synthetic_rating=Yes Default: 1. Omitted ports preserve the source cell, including its formula.
- **`normalizer_approach`** (`in`, `scalar`): Active when normalize_earnings=Yes; 1 historical EBIT; 2 historical ROC; 3 sector margin Default: 3. Omitted ports preserve the source cell, including its formula.
- **`normalizer_ebit`** (`in`, `scalar`): Active when normalize_earnings=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 3500. Omitted ports preserve the source cell, including its formula.
- **`normalizer_roc`** (`in`, `scalar`): Active when normalize_earnings=Yes; decimal fraction (0.05 = 5%) Default: 0.22. Omitted ports preserve the source cell, including its formula.
- **`normalizer_margin`** (`in`, `scalar`): Active when normalize_earnings=Yes; decimal fraction (0.05 = 5%) Default: 0.14716703458425312. Omitted ports preserve the source cell, including its formula.
- **`prior_revenues`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 28541. Omitted ports preserve the source cell, including its formula.
- **`prior_working_capital`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`prior_book_debt`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 16239. Omitted ports preserve the source cell, including its formula.
- **`prior_book_equity`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 10775. Omitted ports preserve the source cell, including its formula.
- **`prior_cash`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 2212. Omitted ports preserve the source cell, including its formula.
- **`prior_non_operating_assets`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 2902. Omitted ports preserve the source cell, including its formula.
- **`prior_minority_interests`** (`in`, `scalar`): Previous year-end; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 126. Omitted ports preserve the source cell, including its formula.
- **`debt_maturity`** (`in`, `scalar`): Years; ancillary market debt calculation Default: 3. Omitted ports preserve the source cell, including its formula.
- **`worksheet_cost_of_debt`** (`in`, `scalar`): Ancillary cost-of-capital debt rate; decimal fraction (0.05 = 5%) Default: 0.0365. Omitted ports preserve the source cell, including its formula.
- **`erp_country_1`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "China". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_1`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: 48421. Omitted ports preserve the source cell, including its formula.
- **`erp_country_2`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_2`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_3`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_3`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_4`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_4`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_5`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_5`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_6`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_6`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_7`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_7`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_8`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_8`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_9`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_9`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_10`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_10`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_11`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_11`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_12`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_12`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_13`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_13`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_1`** (`in`, `scalar`): Regional revenue (region label in workbook G21); same currency/scale as revenues; active for regional ERP calculation Default: 0. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_2`** (`in`, `scalar`): Regional revenue (region label in workbook G22); same currency/scale as revenues; active for regional ERP calculation Default: 7440. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_3`** (`in`, `scalar`): Regional revenue (region label in workbook G23); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_4`** (`in`, `scalar`): Regional revenue (region label in workbook G24); same currency/scale as revenues; active for regional ERP calculation Default: 0. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_5`** (`in`, `scalar`): Regional revenue (region label in workbook G25); same currency/scale as revenues; active for regional ERP calculation Default: 0. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_6`** (`in`, `scalar`): Regional revenue (region label in workbook G26); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_7`** (`in`, `scalar`): Regional revenue (region label in workbook G27); same currency/scale as revenues; active for regional ERP calculation Default: 0. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_8`** (`in`, `scalar`): Regional revenue (region label in workbook G28); same currency/scale as revenues; active for regional ERP calculation Default: 21791. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_9`** (`in`, `scalar`): Regional revenue (region label in workbook G29); same currency/scale as revenues; active for regional ERP calculation Default: 6175. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_10`** (`in`, `scalar`): Regional revenue (region label in workbook G30); same currency/scale as revenues; active for regional ERP calculation Default: 1673. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_11`** (`in`, `scalar`): Regional revenue (region label in workbook G31); same currency/scale as revenues; active for regional ERP calculation Default: 1540. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_1`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Drugs (Pharmaceutical)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_1`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 84. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_2`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_2`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_3`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_3`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_4`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_4`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_5`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_5`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_6`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_6`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_7`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_7`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_8`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_8`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_9`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_9`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_10`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_10`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_11`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_11`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_12`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_12`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_1`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Advertising". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_1`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 35538. Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_2`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_2`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_3`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_3`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_4`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_4`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_5`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_5`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_6`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_6`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_7`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_7`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_8`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_8`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_9`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_9`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_10`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_10`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_11`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_11`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_12`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_12`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`value_per_share`** (`out`, `scalar`): Intrinsic equity value; reporting currency per share
- **`operating_asset_value`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`equity_value`** (`out`, `scalar`): Common equity after debt, minority interests and options; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`initial_wacc`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`terminal_fcff`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`terminal_value`** (`out`, `scalar`): Value at end of forecast; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`pv_forecast_fcff`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`pv_terminal_value`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`terminal_wacc`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`market_price_premium`** (`out`, `scalar`): Market price / intrinsic value minus one; fraction
- **`rd_asset`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`lease_debt`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`cost_of_equity`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`pretax_cost_of_debt`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`high_growth_rate`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`reinvestment_rate`** (`out`, `scalar`): decimal fraction (0.05 = 5%)

## Editorial & Version Notes

Public academic source attribution is preserved. 2026 is a pinned catalog edition, not an assertion that historical example data are current. See source URL for publisher terms.

---

# Damodaran Simple FCFF Ginzu DCF Valuation (2026)

> NYU Stern multi-sheet discounted FCFF valuation with cost of capital, R&D capitalization, operating leases, country risk and equity dilution. Pinned 2026 catalog snapshot; source example dates and data are preserved.

- **Model ID**: `damodaran-fcff-simple-ginzu@2026` (Package `2026.1.0`)
- **Publisher**: [Aswath Damodaran (NYU Stern School of Business)](https://pages.stern.nyu.edu/~adamodar/New_Home_Page/spreadsh.htm)
- **Source Workbook**: `damodaran-fcff-simple-ginzu.xlsx` (`sha256:d6ffb67d965dc22463e4d013636befab3da431e7fc608936a82612fa73198e72`)
- **Cadence**: annual | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression.
- **Workbook Download**: `catalog-bytes`; source: https://pages.stern.nyu.edu/~adamodar/pc/fcffsimpleginzu.xlsx; upstreamArtifact: null; catalog file size: 287995 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_dcf_valuation`

## Flows

### `quick_dcf_valuation` — Quick DCF valuation (single)
Growth and discount-rate sensitivities. All unprovided assumptions retain source values/formulas. Amounts and shares use consistent reporting scale; rates are decimals.
- **Inputs**: `revenues`, `operating_income`, `growth_year_one`, `margin_year_one`, `growth_years_two_five`, `target_margin`, `margin_convergence_year`, `sales_capital_years_one_five`, `sales_capital_years_six_ten`, `risk_free_rate`, `cost_of_capital_mode`, `direct_wacc`, `distribution_region`, `distribution_risk_group`, `override_terminal_growth`, `terminal_growth`
- **Outputs**: `value_per_share`, `operating_asset_value`, `equity_value`, `initial_wacc`, `terminal_fcff`, `terminal_value`

### `full_fcff_ginzu_model` — Full FCFF Ginzu model (single)
All mapped assumptions, R&D history, lease schedule, geography and segment schedules, mode switches and valuation diagnostics. Defaults retain source formulas. Further uncurated chart/lookup cells are accessible through cellOverrides.
- **Inputs**: `company_name`, `country`, `industry_us`, `industry_global`, `revenues`, `operating_income`, `interest_expense`, `book_equity`, `book_debt`, `capitalize_rd`, `capitalize_leases`, `cash`, `non_operating_assets`, `minority_interests`, `shares_outstanding`, `stock_price`, `effective_tax_rate`, `marginal_tax_rate`, `growth_year_one`, `margin_year_one`, `growth_years_two_five`, `target_margin`, `margin_convergence_year`, `sales_capital_years_one_five`, `sales_capital_years_six_ten`, `risk_free_rate`, `options_outstanding`, `option_count`, `option_strike`, `option_maturity`, `option_volatility`, `override_stable_wacc`, `stable_wacc`, `override_stable_roc`, `stable_roc`, `override_failure`, `failure_probability`, `failure_proceeds_basis`, `failure_recovery`, `override_reinvestment_lag`, `reinvestment_lag_years`, `keep_effective_tax_rate`, `override_nol`, `initial_nol`, `override_terminal_riskfree`, `terminal_riskfree_rate`, `override_terminal_growth`, `terminal_growth`, `override_trapped_cash`, `trapped_cash`, `trapped_cash_foreign_tax`, `rd_amortization_years`, `rd_current_expense`, `rd_expense_year_minus_1`, `rd_expense_year_minus_2`, `rd_expense_year_minus_3`, `rd_expense_year_minus_4`, `rd_expense_year_minus_5`, `rd_expense_year_minus_6`, `rd_expense_year_minus_7`, `rd_expense_year_minus_8`, `rd_expense_year_minus_9`, `rd_expense_year_minus_10`, `lease_current_expense`, `lease_commitment_year_1`, `lease_commitment_year_2`, `lease_commitment_year_3`, `lease_commitment_year_4`, `lease_commitment_year_5`, `lease_commitment_years_six_plus`, `cost_of_capital_mode`, `direct_wacc`, `beta_mode`, `direct_beta`, `erp_mode`, `direct_erp`, `debt_cost_mode`, `direct_cost_of_debt`, `actual_credit_rating`, `synthetic_firm_type`, `debt_maturity`, `industry_wacc_mode`, `distribution_region`, `distribution_risk_group`, `erp_country_1`, `erp_country_revenue_1`, `erp_country_2`, `erp_country_revenue_2`, `erp_country_3`, `erp_country_revenue_3`, `erp_country_4`, `erp_country_revenue_4`, `erp_country_5`, `erp_country_revenue_5`, `erp_country_6`, `erp_country_revenue_6`, `erp_country_7`, `erp_country_revenue_7`, `erp_country_8`, `erp_country_revenue_8`, `erp_country_9`, `erp_country_revenue_9`, `erp_country_10`, `erp_country_revenue_10`, `erp_country_11`, `erp_country_revenue_11`, `erp_country_12`, `erp_country_revenue_12`, `erp_country_13`, `erp_country_revenue_13`, `erp_region_revenue_1`, `erp_region_revenue_2`, `erp_region_revenue_3`, `erp_region_revenue_4`, `erp_region_revenue_5`, `erp_region_revenue_6`, `erp_region_revenue_7`, `erp_region_revenue_8`, `erp_region_revenue_9`, `erp_region_revenue_10`, `erp_region_revenue_11`, `us_segment_industry_1`, `us_segment_revenue_1`, `us_segment_industry_2`, `us_segment_revenue_2`, `us_segment_industry_3`, `us_segment_revenue_3`, `us_segment_industry_4`, `us_segment_revenue_4`, `us_segment_industry_5`, `us_segment_revenue_5`, `us_segment_industry_6`, `us_segment_revenue_6`, `us_segment_industry_7`, `us_segment_revenue_7`, `us_segment_industry_8`, `us_segment_revenue_8`, `us_segment_industry_9`, `us_segment_revenue_9`, `us_segment_industry_10`, `us_segment_revenue_10`, `us_segment_industry_11`, `us_segment_revenue_11`, `us_segment_industry_12`, `us_segment_revenue_12`, `global_segment_industry_1`, `global_segment_revenue_1`, `global_segment_industry_2`, `global_segment_revenue_2`, `global_segment_industry_3`, `global_segment_revenue_3`, `global_segment_industry_4`, `global_segment_revenue_4`, `global_segment_industry_5`, `global_segment_revenue_5`, `global_segment_industry_6`, `global_segment_revenue_6`, `global_segment_industry_7`, `global_segment_revenue_7`, `global_segment_industry_8`, `global_segment_revenue_8`, `global_segment_industry_9`, `global_segment_revenue_9`, `global_segment_industry_10`, `global_segment_revenue_10`, `global_segment_industry_11`, `global_segment_revenue_11`, `global_segment_industry_12`, `global_segment_revenue_12`
- **Outputs**: `value_per_share`, `operating_asset_value`, `equity_value`, `initial_wacc`, `terminal_fcff`, `terminal_value`, `pv_forecast_fcff`, `pv_terminal_value`, `terminal_wacc`, `price_to_value`, `rd_asset`, `lease_debt`, `cost_of_equity`, `pretax_cost_of_debt`

## SheetPort Ports (`fio.yaml`)

- **`company_name`** (`in`, `scalar`): Company name; text Default: "Almarai". Omitted ports preserve the source cell, including its formula.
- **`country`** (`in`, `scalar`): Country of incorporation; exact country lookup label Default: "Saudi Arabia". Omitted ports preserve the source cell, including its formula.
- **`industry_us`** (`in`, `scalar`): US industry; exact lookup label Default: "Food Processing". Omitted ports preserve the source cell, including its formula.
- **`industry_global`** (`in`, `scalar`): Global industry; exact lookup label Default: "Food Processing". Omitted ports preserve the source cell, including its formula.
- **`revenues`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 21765.4. Omitted ports preserve the source cell, including its formula.
- **`operating_income`** (`in`, `scalar`): Reported EBIT; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 3060.9. Omitted ports preserve the source cell, including its formula.
- **`interest_expense`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 493.4. Omitted ports preserve the source cell, including its formula.
- **`book_equity`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 10667.8. Omitted ports preserve the source cell, including its formula.
- **`book_debt`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 45063. Omitted ports preserve the source cell, including its formula.
- **`capitalize_rd`** (`in`, `scalar`): Capitalize R&D; Yes activates all rd_* inputs Default: "No". Omitted ports preserve the source cell, including its formula.
- **`capitalize_leases`** (`in`, `scalar`): Capitalize leases; Yes activates lease_* inputs. Avoid double counting leases already in reported debt Default: "No". Omitted ports preserve the source cell, including its formula.
- **`cash`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 19000. Omitted ports preserve the source cell, including its formula.
- **`non_operating_assets`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 21119. Omitted ports preserve the source cell, including its formula.
- **`minority_interests`** (`in`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 1558. Omitted ports preserve the source cell, including its formula.
- **`shares_outstanding`** (`in`, `scalar`): Share count in the same scale as amounts (millions of shares for baseline); positive Default: 4315. Omitted ports preserve the source cell, including its formula.
- **`stock_price`** (`in`, `scalar`): Currency per share; positive Default: 72.28. Omitted ports preserve the source cell, including its formula.
- **`effective_tax_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.175. Omitted ports preserve the source cell, including its formula.
- **`marginal_tax_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.25. Omitted ports preserve the source cell, including its formula.
- **`growth_year_one`** (`in`, `scalar`): Next-year revenue growth; decimal fraction (0.05 = 5%) Default: 0.05. Omitted ports preserve the source cell, including its formula.
- **`margin_year_one`** (`in`, `scalar`): Next-year pretax EBIT/revenue; decimal fraction (0.05 = 5%) Default: 0.14063146094259696. Omitted ports preserve the source cell, including its formula.
- **`growth_years_two_five`** (`in`, `scalar`): Revenue CAGR in years 2–5; decimal fraction (0.05 = 5%) Default: 0.05. Omitted ports preserve the source cell, including its formula.
- **`target_margin`** (`in`, `scalar`): Target pretax operating margin; decimal fraction (0.05 = 5%) Default: 0.14063146094259696. Omitted ports preserve the source cell, including its formula.
- **`margin_convergence_year`** (`in`, `scalar`): Year (1–10) at which target margin is reached Default: 5. Omitted ports preserve the source cell, including its formula.
- **`sales_capital_years_one_five`** (`in`, `scalar`): Revenue per unit of invested capital, ratio >0, years 1–5 Default: 1.708537671031893. Omitted ports preserve the source cell, including its formula.
- **`sales_capital_years_six_ten`** (`in`, `scalar`): Revenue per unit of invested capital, ratio >0, years 6–10 Default: 1.708537671031893. Omitted ports preserve the source cell, including its formula.
- **`risk_free_rate`** (`in`, `scalar`): decimal fraction (0.05 = 5%) Default: 0.0458. Omitted ports preserve the source cell, including its formula.
- **`options_outstanding`** (`in`, `scalar`): Yes activates option_* dilution inputs Default: "No". Omitted ports preserve the source cell, including its formula.
- **`option_count`** (`in`, `scalar`): Option count; same share scale as shares_outstanding Default: 7.72. Omitted ports preserve the source cell, including its formula.
- **`option_strike`** (`in`, `scalar`): Currency per share Default: 1.29. Omitted ports preserve the source cell, including its formula.
- **`option_maturity`** (`in`, `scalar`): Years Default: 7. Omitted ports preserve the source cell, including its formula.
- **`option_volatility`** (`in`, `scalar`): Annualized stock volatility; decimal fraction (0.05 = 5%) Default: 0.45. Omitted ports preserve the source cell, including its formula.
- **`override_stable_wacc`** (`in`, `scalar`): Yes activates stable_wacc Default: "No". Omitted ports preserve the source cell, including its formula.
- **`stable_wacc`** (`in`, `scalar`): WACC after year 10; active when override_stable_wacc=Yes; decimal fraction (0.05 = 5%) Default: 0.0705501574064654. Omitted ports preserve the source cell, including its formula.
- **`override_stable_roc`** (`in`, `scalar`): Yes activates stable_roc Default: "No". Omitted ports preserve the source cell, including its formula.
- **`stable_roc`** (`in`, `scalar`): Return on capital in perpetuity; active when override_stable_roc=Yes; decimal fraction (0.05 = 5%) Default: 0.15. Omitted ports preserve the source cell, including its formula.
- **`override_failure`** (`in`, `scalar`): Yes activates failure_probability Default: "No". Omitted ports preserve the source cell, including its formula.
- **`failure_probability`** (`in`, `scalar`): Active when override_failure=Yes; decimal fraction (0.05 = 5%) Default: 0.12. Omitted ports preserve the source cell, including its formula.
- **`failure_proceeds_basis`** (`in`, `scalar`): Distress proceeds base; B = book capital, V = estimated company value Default: "V". Omitted ports preserve the source cell, including its formula.
- **`failure_recovery`** (`in`, `scalar`): Proceeds as fraction of chosen basis; decimal fraction (0.05 = 5%) Default: 0.5. Omitted ports preserve the source cell, including its formula.
- **`override_reinvestment_lag`** (`in`, `scalar`): Yes activates reinvestment_lag_years Default: "No". Omitted ports preserve the source cell, including its formula.
- **`reinvestment_lag_years`** (`in`, `scalar`): Years, integer 0–3; active when override_reinvestment_lag=Yes Default: 1. Omitted ports preserve the source cell, including its formula.
- **`keep_effective_tax_rate`** (`in`, `scalar`): Yes holds effective tax rate through terminal year; No transitions to marginal tax rate Default: "No". Omitted ports preserve the source cell, including its formula.
- **`override_nol`** (`in`, `scalar`): Yes activates initial_nol Default: "No". Omitted ports preserve the source cell, including its formula.
- **`initial_nol`** (`in`, `scalar`): Prior loss carryforward; active when override_nol=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 731.4000000000001. Omitted ports preserve the source cell, including its formula.
- **`override_terminal_riskfree`** (`in`, `scalar`): Yes activates terminal_riskfree_rate Default: "No". Omitted ports preserve the source cell, including its formula.
- **`terminal_riskfree_rate`** (`in`, `scalar`): Active when override_terminal_riskfree=Yes; decimal fraction (0.05 = 5%) Default: 0.02. Omitted ports preserve the source cell, including its formula.
- **`override_terminal_growth`** (`in`, `scalar`): Yes activates terminal_growth Default: "No". Omitted ports preserve the source cell, including its formula.
- **`terminal_growth`** (`in`, `scalar`): Perpetual growth; below terminal WACC; active when override_terminal_growth=Yes; decimal fraction (0.05 = 5%) Default: -0.05. Omitted ports preserve the source cell, including its formula.
- **`override_trapped_cash`** (`in`, `scalar`): Yes activates trapped_cash and trapped_cash_foreign_tax Default: "No". Omitted ports preserve the source cell, including its formula.
- **`trapped_cash`** (`in`, `scalar`): Active when override_trapped_cash=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 140000. Omitted ports preserve the source cell, including its formula.
- **`trapped_cash_foreign_tax`** (`in`, `scalar`): Foreign tax rate or cash discount; active when override_trapped_cash=Yes; decimal fraction (0.05 = 5%) Default: 0.15. Omitted ports preserve the source cell, including its formula.
- **`rd_amortization_years`** (`in`, `scalar`): Years, integer 1–10; active when capitalize_rd=Yes Default: 3. Omitted ports preserve the source cell, including its formula.
- **`rd_current_expense`** (`in`, `scalar`): Current R&D; active when capitalize_rd=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 85622. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_1`** (`in`, `scalar`): R&D 1 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 73213. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_2`** (`in`, `scalar`): R&D 2 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 56052. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_3`** (`in`, `scalar`): R&D 3 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 42740. Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_4`** (`in`, `scalar`): R&D 4 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_5`** (`in`, `scalar`): R&D 5 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_6`** (`in`, `scalar`): R&D 6 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_7`** (`in`, `scalar`): R&D 7 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_8`** (`in`, `scalar`): R&D 8 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_9`** (`in`, `scalar`): R&D 9 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`rd_expense_year_minus_10`** (`in`, `scalar`): R&D 10 years before current year; active when capitalize_rd=Yes and within rd_amortization_years; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`lease_current_expense`** (`in`, `scalar`): Operating lease expense; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 295. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_1`** (`in`, `scalar`): Lease commitment year 1; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 287. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_2`** (`in`, `scalar`): Lease commitment year 2; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 235. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_3`** (`in`, `scalar`): Lease commitment year 3; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 194. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_4`** (`in`, `scalar`): Lease commitment year 4; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 151. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_year_5`** (`in`, `scalar`): Lease commitment year 5; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 98. Omitted ports preserve the source cell, including its formula.
- **`lease_commitment_years_six_plus`** (`in`, `scalar`): Lease commitment years 6 and beyond; active when capitalize_leases=Yes; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change Default: 605. Omitted ports preserve the source cell, including its formula.
- **`cost_of_capital_mode`** (`in`, `scalar`): Select WACC approach Default: "Detailed". Omitted ports preserve the source cell, including its formula.
- **`direct_wacc`** (`in`, `scalar`): Active when cost_of_capital_mode=I will input; decimal fraction (0.05 = 5%) Default: 0.09. Omitted ports preserve the source cell, including its formula.
- **`beta_mode`** (`in`, `scalar`): Active when cost_of_capital_mode=Detailed Default: "Single Business(US)". Omitted ports preserve the source cell, including its formula.
- **`direct_beta`** (`in`, `scalar`): Levered beta; active when beta_mode=Direct Input and cost_of_capital_mode=Detailed Default: 1.2. Omitted ports preserve the source cell, including its formula.
- **`erp_mode`** (`in`, `scalar`): ERP approach; active when cost_of_capital_mode=Detailed Default: "Operating regions". Omitted ports preserve the source cell, including its formula.
- **`direct_erp`** (`in`, `scalar`): Active when erp_mode=Will Input and cost_of_capital_mode=Detailed; decimal fraction (0.05 = 5%) Default: 0.06. Omitted ports preserve the source cell, including its formula.
- **`debt_cost_mode`** (`in`, `scalar`): Active when cost_of_capital_mode=Detailed Default: "Actual rating". Omitted ports preserve the source cell, including its formula.
- **`direct_cost_of_debt`** (`in`, `scalar`): Active when debt_cost_mode=Direct Input; decimal fraction (0.05 = 5%) Default: 0.04. Omitted ports preserve the source cell, including its formula.
- **`actual_credit_rating`** (`in`, `scalar`): Exact synthetic-rating table label; active when debt_cost_mode=Actual rating Default: "A1/A+". Omitted ports preserve the source cell, including its formula.
- **`synthetic_firm_type`** (`in`, `scalar`): 1 large manufacturing; 2 small/risky nonfinancial; 3 financial; active when debt_cost_mode=Synthetic Rating Default: 2. Omitted ports preserve the source cell, including its formula.
- **`debt_maturity`** (`in`, `scalar`): Straight debt maturity; years Default: 3. Omitted ports preserve the source cell, including its formula.
- **`industry_wacc_mode`** (`in`, `scalar`): Active when cost_of_capital_mode=Industry Average Default: "Multibusiness(US)". Omitted ports preserve the source cell, including its formula.
- **`distribution_region`** (`in`, `scalar`): Active when cost_of_capital_mode=Distribution Default: "US". Omitted ports preserve the source cell, including its formula.
- **`distribution_risk_group`** (`in`, `scalar`): Active when cost_of_capital_mode=Distribution Default: "Median". Omitted ports preserve the source cell, including its formula.
- **`erp_country_1`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "United States". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_1`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: 193636. Omitted ports preserve the source cell, including its formula.
- **`erp_country_2`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "China". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_2`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: 500. Omitted ports preserve the source cell, including its formula.
- **`erp_country_3`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_3`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_4`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_4`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_5`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_5`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_6`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_6`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_7`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_7`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_8`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_8`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_9`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_9`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_10`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_10`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_11`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_11`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_12`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "Rest of the World". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_12`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: 31335. Omitted ports preserve the source cell, including its formula.
- **`erp_country_13`** (`in`, `scalar`): Country lookup label; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_country_revenue_13`** (`in`, `scalar`): Country revenue; same positive currency/scale as revenues; active for operating-country ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_1`** (`in`, `scalar`): Regional revenue (region label in workbook G21); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_2`** (`in`, `scalar`): Regional revenue (region label in workbook G22); same currency/scale as revenues; active for regional ERP calculation Default: 5455. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_3`** (`in`, `scalar`): Regional revenue (region label in workbook G23); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_4`** (`in`, `scalar`): Regional revenue (region label in workbook G24); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_5`** (`in`, `scalar`): Regional revenue (region label in workbook G25); same currency/scale as revenues; active for regional ERP calculation Default: 5830. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_6`** (`in`, `scalar`): Regional revenue (region label in workbook G26); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_7`** (`in`, `scalar`): Regional revenue (region label in workbook G27); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_8`** (`in`, `scalar`): Regional revenue (region label in workbook G28); same currency/scale as revenues; active for regional ERP calculation Default: 16774. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_9`** (`in`, `scalar`): Regional revenue (region label in workbook G29); same currency/scale as revenues; active for regional ERP calculation Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_10`** (`in`, `scalar`): Regional revenue (region label in workbook G30); same currency/scale as revenues; active for regional ERP calculation Default: 8078. Omitted ports preserve the source cell, including its formula.
- **`erp_region_revenue_11`** (`in`, `scalar`): Regional revenue (region label in workbook G31); same currency/scale as revenues; active for regional ERP calculation Default: 10924. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_1`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Computers/Peripherals". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_1`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 195010. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_2`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Electronics (General)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_2`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 43000. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_3`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Entertainment". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_3`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 15000. Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_4`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_4`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_5`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_5`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_6`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_6`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_7`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_7`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_8`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_8`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_9`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_9`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_10`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_10`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_11`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_11`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_industry_12`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`us_segment_revenue_12`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_1`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "Electronics (General)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_1`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: 81363. Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_2`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_2`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_3`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_3`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_4`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_4`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_5`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_5`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_6`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_6`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_7`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_7`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_8`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_8`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_9`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_9`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_10`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_10`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_11`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_11`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_industry_12`** (`in`, `scalar`): Industry lookup label; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`global_segment_revenue_12`** (`in`, `scalar`): Segment revenue; same currency/scale as revenues; used by multibusiness beta/industry WACC calculations Default: "(blank)". Omitted ports preserve the source cell, including its formula.
- **`value_per_share`** (`out`, `scalar`): Intrinsic equity value; reporting currency per share
- **`operating_asset_value`** (`out`, `scalar`): Failure-adjusted value of operating assets; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`equity_value`** (`out`, `scalar`): Common equity value after debt, minority interests and options; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`initial_wacc`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`terminal_fcff`** (`out`, `scalar`): Terminal FCFF; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`terminal_value`** (`out`, `scalar`): Value at end of forecast; amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`pv_forecast_fcff`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`pv_terminal_value`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`terminal_wacc`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`price_to_value`** (`out`, `scalar`): Market price / intrinsic value; ratio
- **`rd_asset`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`lease_debt`** (`out`, `scalar`): amount in the workbook reporting currency and scale (millions for the supplied example); positive unless loss or cash-flow change
- **`cost_of_equity`** (`out`, `scalar`): decimal fraction (0.05 = 5%)
- **`pretax_cost_of_debt`** (`out`, `scalar`): decimal fraction (0.05 = 5%)

## Editorial & Version Notes

Public academic source attribution is preserved. 2026 is a pinned catalog edition, not an assertion that historical example data are current. See source URL for publisher terms.

---

# Damodaran Optimal Capital Structure and WACC (2026)

> Sweep debt ratios from 0% to 90% to compare WACC, credit ratings, debt capacity and enterprise value in Damodaran’s pinned capital structure workbook.

- **Model ID**: `damodaran-optimal-capital-structure@2026` (Package `2026.0.0`)
- **Publisher**: [Aswath Damodaran (NYU Stern School of Business)](https://pages.stern.nyu.edu/~adamodar/New_Home_Page/spreadsh.htm)
- **Source Workbook**: `damodaran-optimal-capital-structure.xlsx` (`sha256:32ccdad0e50d87226908162ab512e067a7614fbbe26b9291b7f0de155d2b7115`)
- **Cadence**: static | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://pages.stern.nyu.edu/~adamodar/pc/capstru.xlsx; upstreamArtifact: null; catalog file size: 100960 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_wacc_leverage_check`

## Flows

### `quick_wacc_leverage_check` — quick wacc leverage check (single)
13 main financial assumptions; source debt-estimation switches and No lease/No deduction-limit modes retain defaults. Rates are decimal fractions; currency amounts and shares are millions.
- **Inputs**: `ebitda`, `depreciation`, `interest_expense`, `tax_rate`, `shares_outstanding`, `share_price`, `equity_beta`, `book_debt`, `current_debt_rate`, `debt_maturity_years`, `riskfree_rate`, `equity_risk_premium`, `country_default_spread`
- **Outputs**: `current_wacc`, `optimal_wacc`, `optimal_debt_ratio`, `optimal_debt`, `optimal_enterprise_value`, `optimal_value_per_share`

### `full_capital_structure_schedule` — full capital structure schedule (single)
All mapped corporate assumptions and activation switches, six lease commitments (output years 1..5 are natively linked to these inputs), and all 0%..90% leverage outputs. Rates use decimal fractions, amounts currency millions, shares millions. Omitted inputs retain source defaults. Nonconvergent credit-rating scenarios are rejected.
- **Inputs**: `ebitda`, `depreciation`, `interest_expense`, `tax_rate`, `shares_outstanding`, `share_price`, `equity_beta`, `book_debt`, `current_debt_rate`, `debt_maturity_years`, `riskfree_rate`, `equity_risk_premium`, `country_default_spread`, `company_name`, `country`, `capital_spending`, `current_bond_rating`, `cash`, `known_market_debt`, `market_debt_value`, `estimate_market_debt`, `operating_leases`, `restrict_interest_deduction`, `deduction_basis`, `deduction_limit`, `indirect_bankruptcy_costs`, `bankruptcy_severity`, `spread_table`, `refinance_existing_debt`, `use_synthetic_current_rating`, `current_lease_expense`, `lease_commitment_1`, `lease_commitment_2`, `lease_commitment_3`, `lease_commitment_4`, `lease_commitment_5`, `lease_commitment_6`
- **Outputs**: `current_wacc`, `optimal_wacc`, `optimal_debt_ratio`, `optimal_debt`, `optimal_enterprise_value`, `optimal_value_per_share`, `leverage_0_beta`, `leverage_0_cost_equity`, `leverage_0_rating`, `leverage_0_pretax_debt_rate`, `leverage_0_tax_rate`, `leverage_0_aftertax_debt_rate`, `leverage_0_wacc`, `leverage_0_enterprise_value`, `leverage_10_beta`, `leverage_10_cost_equity`, `leverage_10_rating`, `leverage_10_pretax_debt_rate`, `leverage_10_tax_rate`, `leverage_10_aftertax_debt_rate`, `leverage_10_wacc`, `leverage_10_enterprise_value`, `leverage_20_beta`, `leverage_20_cost_equity`, `leverage_20_rating`, `leverage_20_pretax_debt_rate`, `leverage_20_tax_rate`, `leverage_20_aftertax_debt_rate`, `leverage_20_wacc`, `leverage_20_enterprise_value`, `leverage_30_beta`, `leverage_30_cost_equity`, `leverage_30_rating`, `leverage_30_pretax_debt_rate`, `leverage_30_tax_rate`, `leverage_30_aftertax_debt_rate`, `leverage_30_wacc`, `leverage_30_enterprise_value`, `leverage_40_beta`, `leverage_40_cost_equity`, `leverage_40_rating`, `leverage_40_pretax_debt_rate`, `leverage_40_tax_rate`, `leverage_40_aftertax_debt_rate`, `leverage_40_wacc`, `leverage_40_enterprise_value`, `leverage_50_beta`, `leverage_50_cost_equity`, `leverage_50_rating`, `leverage_50_pretax_debt_rate`, `leverage_50_tax_rate`, `leverage_50_aftertax_debt_rate`, `leverage_50_wacc`, `leverage_50_enterprise_value`, `leverage_60_beta`, `leverage_60_cost_equity`, `leverage_60_rating`, `leverage_60_pretax_debt_rate`, `leverage_60_tax_rate`, `leverage_60_aftertax_debt_rate`, `leverage_60_wacc`, `leverage_60_enterprise_value`, `leverage_70_beta`, `leverage_70_cost_equity`, `leverage_70_rating`, `leverage_70_pretax_debt_rate`, `leverage_70_tax_rate`, `leverage_70_aftertax_debt_rate`, `leverage_70_wacc`, `leverage_70_enterprise_value`, `leverage_80_beta`, `leverage_80_cost_equity`, `leverage_80_rating`, `leverage_80_pretax_debt_rate`, `leverage_80_tax_rate`, `leverage_80_aftertax_debt_rate`, `leverage_80_wacc`, `leverage_80_enterprise_value`, `leverage_90_beta`, `leverage_90_cost_equity`, `leverage_90_rating`, `leverage_90_pretax_debt_rate`, `leverage_90_tax_rate`, `leverage_90_aftertax_debt_rate`, `leverage_90_wacc`, `leverage_90_enterprise_value`

## SheetPort Ports (`fio.yaml`)

- **`ebitda`** (`in`, `scalar`): Currency millions/year, positive EBITDA before lease adjustment. Overrides the source arithmetic formula. Default: 11767.
- **`depreciation`** (`in`, `scalar`): Currency millions/year, nonnegative depreciation and amortization. Default: 5200.
- **`interest_expense`** (`in`, `scalar`): Currency millions/year, positive current debt interest expense. Default: 1653.
- **`tax_rate`** (`in`, `scalar`): Decimal fraction 0..1 marginal corporate tax rate; explicit override of country lookup. Default: 0.25.
- **`shares_outstanding`** (`in`, `scalar`): Millions of shares, positive. Explicit independent override of source illustrative share-count formula. Default: 1826.8195413758724.
- **`share_price`** (`in`, `scalar`): Currency/share, positive. Supply shares_outstanding together with share_price: when shares is omitted the source B19 formula 183230/share_price otherwise fixes equity capitalization. Default: 100.3.
- **`equity_beta`** (`in`, `scalar`): Dimensionless current levered equity beta, positive. Default: 1.02.
- **`book_debt`** (`in`, `scalar`): Currency millions, positive book debt; feeds market debt estimation. Default: 51608.
- **`current_debt_rate`** (`in`, `scalar`): Decimal fraction/year, positive current pre-tax debt rate. Default: 0.069.
- **`debt_maturity_years`** (`in`, `scalar`): Years, positive weighted average remaining maturity; used when estimate_market_debt=Yes. Default: 4.2.
- **`riskfree_rate`** (`in`, `scalar`): Decimal fraction/year, positive risk-free rate in analysis currency. Default: 0.039.
- **`equity_risk_premium`** (`in`, `scalar`): Decimal fraction/year, positive CAPM equity risk premium. Default: 0.0661.
- **`country_default_spread`** (`in`, `scalar`): Decimal fraction/year, nonnegative country credit spread. Default: 0.0181.
- **`company_name`** (`in`, `scalar`): Text label; no numeric effect. Default: Disney.
- **`country`** (`in`, `scalar`): Country name from source Country ERP table. When tax_rate is omitted, the original country-tax lookup recalculates; supply tax_rate for an explicit override. Default: United States.
- **`capital_spending`** (`in`, `scalar`): Currency millions/year, nonnegative capital expenditure. Default: 5313.
- **`current_bond_rating`** (`in`, `scalar`): Text rating, source nomenclature e.g. A3/A-. Default: A3/A-.
- **`cash`** (`in`, `scalar`): Currency millions, nonnegative cash and marketable securities. Default: 11615.
- **`known_market_debt`** (`in`, `scalar`): Enum Yes/No. Yes activates market_debt_value and takes priority over estimate_market_debt. Default: No.
- **`market_debt_value`** (`in`, `scalar`): Currency millions, nonnegative; active only when known_market_debt=Yes. Default: 0.
- **`estimate_market_debt`** (`in`, `scalar`): Enum Yes/No. When known_market_debt=No, Yes uses interest expense, current_debt_rate and debt_maturity_years; No uses book_debt. Default: Yes.
- **`operating_leases`** (`in`, `scalar`): Enum Yes/No; Yes activates the complete mapped lease schedule. Default: No.
- **`restrict_interest_deduction`** (`in`, `scalar`): Enum Yes/No; Yes activates deduction_basis and deduction_limit. Default: No.
- **`deduction_basis`** (`in`, `scalar`): Enum EBITDA/EBIT; active when restrict_interest_deduction=Yes. Default: EBITDA.
- **`deduction_limit`** (`in`, `scalar`): Decimal fraction 0..1 of deduction_basis deductible as interest. Default: 0.3.
- **`indirect_bankruptcy_costs`** (`in`, `scalar`): Enum Yes/No; Yes applies publisher rating-linked EBITDA reductions. Default: No.
- **`bankruptcy_severity`** (`in`, `scalar`): Enum Low/Medium/High used by publisher default spread tables. Default: Medium.
- **`spread_table`** (`in`, `scalar`): Integer enum 1=large safe nonfinancial, 2=small risky nonfinancial, 3=infrastructure/utility. Default: 1.
- **`refinance_existing_debt`** (`in`, `scalar`): Enum Yes/No; Yes reprices all debt at the scenario credit rate. Default: No.
- **`use_synthetic_current_rating`** (`in`, `scalar`): Enum Yes/No; Yes replaces current debt cost with coverage-derived synthetic rate. Default: No.
- **`current_lease_expense`** (`in`, `scalar`): Currency millions/year, positive current operating lease expense; active when operating_leases=Yes. Default: 269.
- **`lease_commitment_1`** (`in`, `scalar`): Currency millions, nonnegative lease commitment in year 1. Active when operating_leases=Yes. Default: 277.
- **`lease_commitment_2`** (`in`, `scalar`): Currency millions, nonnegative lease commitment in year 2. Active when operating_leases=Yes. Default: 284.
- **`lease_commitment_3`** (`in`, `scalar`): Currency millions, nonnegative lease commitment in year 3. Active when operating_leases=Yes. Default: 272.
- **`lease_commitment_4`** (`in`, `scalar`): Currency millions, nonnegative lease commitment in year 4. Active when operating_leases=Yes. Default: 256.
- **`lease_commitment_5`** (`in`, `scalar`): Currency millions, nonnegative lease commitment in year 5. Active when operating_leases=Yes. Default: 220.
- **`lease_commitment_6`** (`in`, `scalar`): Currency millions, nonnegative lease commitment all years 6 and beyond. Active when operating_leases=Yes. Default: 1131.
- **`current_wacc`** (`out`, `scalar`): Decimal fraction/year current WACC.
- **`optimal_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at enterprise-value maximizing grid ratio.
- **`optimal_debt_ratio`** (`out`, `scalar`): Decimal debt/(debt+equity) ratio; sweep grid 0..0.9 in 0.1 increments.
- **`optimal_debt`** (`out`, `scalar`): Currency millions optimal debt.
- **`optimal_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at optimal leverage.
- **`optimal_value_per_share`** (`out`, `scalar`): Currency/share implied value after leverage change.
- **`leverage_0_beta`** (`out`, `scalar`): Dimensionless levered beta at 0% debt ratio.
- **`leverage_0_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 0% debt ratio.
- **`leverage_0_rating`** (`out`, `scalar`): Text synthetic credit rating at 0% debt ratio.
- **`leverage_0_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 0% debt ratio.
- **`leverage_0_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 0% debt ratio.
- **`leverage_0_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 0% debt ratio.
- **`leverage_0_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 0% debt ratio.
- **`leverage_0_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 0% debt ratio.
- **`leverage_10_beta`** (`out`, `scalar`): Dimensionless levered beta at 10% debt ratio.
- **`leverage_10_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 10% debt ratio.
- **`leverage_10_rating`** (`out`, `scalar`): Text synthetic credit rating at 10% debt ratio.
- **`leverage_10_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 10% debt ratio.
- **`leverage_10_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 10% debt ratio.
- **`leverage_10_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 10% debt ratio.
- **`leverage_10_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 10% debt ratio.
- **`leverage_10_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 10% debt ratio.
- **`leverage_20_beta`** (`out`, `scalar`): Dimensionless levered beta at 20% debt ratio.
- **`leverage_20_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 20% debt ratio.
- **`leverage_20_rating`** (`out`, `scalar`): Text synthetic credit rating at 20% debt ratio.
- **`leverage_20_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 20% debt ratio.
- **`leverage_20_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 20% debt ratio.
- **`leverage_20_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 20% debt ratio.
- **`leverage_20_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 20% debt ratio.
- **`leverage_20_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 20% debt ratio.
- **`leverage_30_beta`** (`out`, `scalar`): Dimensionless levered beta at 30% debt ratio.
- **`leverage_30_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 30% debt ratio.
- **`leverage_30_rating`** (`out`, `scalar`): Text synthetic credit rating at 30% debt ratio.
- **`leverage_30_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 30% debt ratio.
- **`leverage_30_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 30% debt ratio.
- **`leverage_30_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 30% debt ratio.
- **`leverage_30_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 30% debt ratio.
- **`leverage_30_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 30% debt ratio.
- **`leverage_40_beta`** (`out`, `scalar`): Dimensionless levered beta at 40% debt ratio.
- **`leverage_40_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 40% debt ratio.
- **`leverage_40_rating`** (`out`, `scalar`): Text synthetic credit rating at 40% debt ratio.
- **`leverage_40_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 40% debt ratio.
- **`leverage_40_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 40% debt ratio.
- **`leverage_40_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 40% debt ratio.
- **`leverage_40_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 40% debt ratio.
- **`leverage_40_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 40% debt ratio.
- **`leverage_50_beta`** (`out`, `scalar`): Dimensionless levered beta at 50% debt ratio.
- **`leverage_50_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 50% debt ratio.
- **`leverage_50_rating`** (`out`, `scalar`): Text synthetic credit rating at 50% debt ratio.
- **`leverage_50_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 50% debt ratio.
- **`leverage_50_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 50% debt ratio.
- **`leverage_50_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 50% debt ratio.
- **`leverage_50_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 50% debt ratio.
- **`leverage_50_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 50% debt ratio.
- **`leverage_60_beta`** (`out`, `scalar`): Dimensionless levered beta at 60% debt ratio.
- **`leverage_60_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 60% debt ratio.
- **`leverage_60_rating`** (`out`, `scalar`): Text synthetic credit rating at 60% debt ratio.
- **`leverage_60_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 60% debt ratio.
- **`leverage_60_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 60% debt ratio.
- **`leverage_60_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 60% debt ratio.
- **`leverage_60_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 60% debt ratio.
- **`leverage_60_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 60% debt ratio.
- **`leverage_70_beta`** (`out`, `scalar`): Dimensionless levered beta at 70% debt ratio.
- **`leverage_70_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 70% debt ratio.
- **`leverage_70_rating`** (`out`, `scalar`): Text synthetic credit rating at 70% debt ratio.
- **`leverage_70_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 70% debt ratio.
- **`leverage_70_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 70% debt ratio.
- **`leverage_70_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 70% debt ratio.
- **`leverage_70_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 70% debt ratio.
- **`leverage_70_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 70% debt ratio.
- **`leverage_80_beta`** (`out`, `scalar`): Dimensionless levered beta at 80% debt ratio.
- **`leverage_80_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 80% debt ratio.
- **`leverage_80_rating`** (`out`, `scalar`): Text synthetic credit rating at 80% debt ratio.
- **`leverage_80_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 80% debt ratio.
- **`leverage_80_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 80% debt ratio.
- **`leverage_80_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 80% debt ratio.
- **`leverage_80_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 80% debt ratio.
- **`leverage_80_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 80% debt ratio.
- **`leverage_90_beta`** (`out`, `scalar`): Dimensionless levered beta at 90% debt ratio.
- **`leverage_90_cost_equity`** (`out`, `scalar`): Decimal fraction/year equity cost at 90% debt ratio.
- **`leverage_90_rating`** (`out`, `scalar`): Text synthetic credit rating at 90% debt ratio.
- **`leverage_90_pretax_debt_rate`** (`out`, `scalar`): Decimal fraction/year debt cost at 90% debt ratio.
- **`leverage_90_tax_rate`** (`out`, `scalar`): Decimal effective tax fraction at 90% debt ratio.
- **`leverage_90_aftertax_debt_rate`** (`out`, `scalar`): Decimal fraction/year after-tax debt cost at 90% debt ratio.
- **`leverage_90_wacc`** (`out`, `scalar`): Decimal fraction/year WACC at 90% debt ratio.
- **`leverage_90_enterprise_value`** (`out`, `scalar`): Currency millions enterprise value at 90% debt ratio.

## Editorial & Version Notes

2026 is the catalog acquisition edition, not a claim that the underlying Disney example was updated in 2026; source analysis date serial 43521 is in 2019. All currency amounts use the same currency and millions scale; source example uses USD. Shares are millions. No FX conversion. Optimal means maximum enterprise value on the original 10-point 0%..90% debt grid, not continuous optimization. Native iterative normalization seeds each debt column with its published cached rating spread and EBITDA drop, then applies 64 fixed-point steps. Multiple equilibria are possible; nonconvergence is rejected. Source lookup data and country equity-premium mix remain pinned. Full flow maps all corporate inputs and lease commitments; use cellOverrides for lookup-table research. Source publisher redistribution permission has not been established; reference-only provenance does not grant redistribution rights.

---

# EPA Simplified GHG Emissions Calculator (2026)

> Calculate annual Scope 1, location- and market-based Scope 2, and selected Scope 3 emissions using the pinned EPA source workbook with traceable fuel, eGRID and GWP factors.

- **Model ID**: `epa-simplified-ghg@2026` (Package `1.0.0`)
- **Publisher**: [U.S. Environmental Protection Agency (EPA — Center for Corporate Climate Leadership)](https://www.epa.gov/climateleadership/simplified-ghg-emissions-calculator)
- **Source Workbook**: `epa-simplified-ghg-sanitized.xlsx` (`sha256:fd8e112a31a9ce536d4826b771ae3af79e84378da18d7ef5fc8c403af59f237f`)
- **Cadence**: periodic | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://www.epa.gov/system/files/other-files/2022-09/calculator_tool.xlsm; upstreamArtifact: {"workbookFilename":"epa-simplified-ghg.xlsm","format":"xlsm","workbookSha256":"47bd1b100597d0972049425c3686a6edf50f6b7518de2551749363fef34fe8f9","workbookBytes":1554413,"sourceUrl":"https://www.epa.gov/system/files/other-files/2022-09/calculator_tool.xlsm"}; catalog file size: 1256760 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_scope_1_2_3_footprint`

## Flows

### `quick_scope_1_2_3_footprint` — Quick Scope 1, 2 and 3 footprint (single)
13 inputs for one stationary source, one owned fleet group, one electricity site, business vehicle travel and commuting. Annual therms/gallons/kWh/vehicle-miles; outputs metric tons CO2e. Provide each activity with all companion selectors; omitted active rows remain blank. Scope 3 covers selected categories only.
- **Inputs**: `stationary_fuel`, `stationary_quantity`, `stationary_unit`, `mobile_vehicle_type`, `mobile_model_year`, `mobile_fuel_gallons`, `mobile_vehicle_miles`, `electricity_subregion`, `electricity_kwh`, `business_vehicle_type`, `business_vehicle_miles`, `commuting_vehicle_type`, `commuting_vehicle_miles`
- **Outputs**: `scope_1_gross`, `scope_2_location_gross`, `scope_2_market_gross`, `scope_3_gross`, `organization_location_gross`, `organization_market_gross`

### `full_epa_ghg_inventory` — Full EPA GHG inventory (single)
Complete active source schedules as partial records keyed by Excel row, plus quick scalars. Includes stationary/mobile, refrigeration, fire, purchased gases, electricity/steam, business travel, commuting, upstream transportation, waste and offsets. Do not populate a quick scalar and record field targeting the same cell. Use one method per fugitive source. All outputs metric tons CO2e.
- **Inputs**: `stationary_fuel`, `stationary_quantity`, `stationary_unit`, `mobile_vehicle_type`, `mobile_model_year`, `mobile_fuel_gallons`, `mobile_vehicle_miles`, `electricity_subregion`, `electricity_kwh`, `business_vehicle_type`, `business_vehicle_miles`, `commuting_vehicle_type`, `commuting_vehicle_miles`, `stationary_sources`, `mobile_sources`, `biodiesel_percent`, `ethanol_percent`, `electricity_sources`, `steam_sources`, `refrigeration_material_balance`, `fire_material_balance`, `refrigeration_simplified_balance`, `fire_simplified_balance`, `refrigeration_screening`, `fire_screening`, `purchased_gases`, `business_vehicles`, `business_public_transport`, `business_air`, `commuting_vehicles`, `commuting_public_transport`, `upstream_vehicle_transport`, `upstream_ton_mile_transport`, `waste_sources`, `purchased_offsets`
- **Outputs**: `scope_1_gross`, `scope_2_location_gross`, `scope_2_market_gross`, `scope_3_gross`, `organization_location_gross`, `organization_market_gross`, `stationary_combustion`, `mobile_sources_emissions`, `refrigeration_ac`, `fire_suppression`, `purchased_gases_emissions`, `purchased_electricity_location`, `purchased_steam_location`, `purchased_electricity_market`, `purchased_steam_market`, `scope_1_net`, `scope_2_location_net`, `scope_2_market_net`, `business_travel`, `employee_commuting`, `upstream_transport`, `waste`, `stationary_biomass_co2`, `mobile_biomass_co2`, `organization_location_net`

## SheetPort Ports (`fio.yaml`)

- **`stationary_fuel`** (`in`, `scalar`): Fuel enum; stationary_quantity and stationary_unit must be supplied together. Natural Gas supports Therm, scf or MMBtu. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`stationary_quantity`** (`in`, `scalar`): Nonnegative annual fuel quantity in stationary_unit: therms (Therm), gallons, scf, short ton or MMBtu, depending on fuel. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`stationary_unit`** (`in`, `scalar`): Exact Excel unit spelling. Therm is therms; gallons is US gallons; scf is standard cubic feet; MMBtu is million Btu. Therm only applies to gaseous fuels. Solid fuels use short ton or MMBtu; liquid fuels use gallons or MMBtu. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`mobile_vehicle_type`** (`in`, `scalar`): On-road vehicle/fuel enum for the quick flow; mobile_fuel_gallons is gallons for these vehicles. Supply model year and vehicle-miles as well. CNG (scf) and non-road vehicles are available in mobile_sources record. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`mobile_model_year`** (`in`, `scalar`): Vehicle model year, 1984–2024 for the pinned factor tables. CH4/N2O factors depend on vehicle type and model year. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`mobile_fuel_gallons`** (`in`, `scalar`): Nonnegative US gallons consumed by the selected owned/leased fleet vehicle. Gallons determine CO2; mobile_vehicle_miles independently determines CH4 and N2O. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`mobile_vehicle_miles`** (`in`, `scalar`): Nonnegative vehicle-miles traveled by owned/leased vehicles; not passenger-miles. Required with fuel gallons for complete CH4/N2O accounting. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`electricity_subregion`** (`in`, `scalar`): Exact EPA eGRID subregion display-name enum (not abbreviation); select where electricity is consumed. Supply electricity_kwh. Factors are pinned workbook factors, not a 2026 refresh. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`electricity_kwh`** (`in`, `scalar`): Nonnegative annual purchased electricity, kWh. Supply electricity_subregion; market-based emissions default to location-based unless supplier factors are entered in full flow. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`business_vehicle_type`** (`in`, `scalar`): Vehicle enum for personal/rental/taxi business travel. Supply business_vehicle_miles; do not include vehicles owned/leased by the organization here. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`business_vehicle_miles`** (`in`, `scalar`): Nonnegative annual business vehicle-miles; supply business_vehicle_type. Air, rail and bus passenger-miles are separate full-flow schedules. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`commuting_vehicle_type`** (`in`, `scalar`): Employee personal-vehicle type enum. Supply commuting_vehicle_miles; avoid counting each carpool passenger as a whole vehicle. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`commuting_vehicle_miles`** (`in`, `scalar`): Nonnegative annual commuting vehicle-miles allocated to employees; supply commuting_vehicle_type. Full flow supports public-transport passenger-miles. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`stationary_sources`** (`in`, `record`): All 43 stationary source rows; fuel-specific units match the quick-flow documentation. Field units: fuel: categorical enum; quantity: Nonnegative quantity in unit; unit: categorical enum. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`mobile_sources`** (`in`, `record`): All 81 owned/leased mobile rows. Gasoline/diesel use gallons; CNG uses scf. Do not replace formula G (unit). Field units: road_category: categorical enum; vehicle_type: categorical enum; model_year: Year 1984–2024; fuel_quantity: US gallons, except CNG uses scf; vehicle_miles: Vehicle-miles; independently required for on-road CH4/N2O. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`biodiesel_percent`** (`in`, `scalar`): Biodiesel blend volume percent 0–100, source default 20; applies to vehicles labeled Biodiesel. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`ethanol_percent`** (`in`, `scalar`): Ethanol blend volume percent 0–100, source default 80; applies to vehicles labeled Ethanol. Omitted inputs retain the source blank entry; enter all companion selectors when providing activity.
- **`electricity_sources`** (`in`, `record`): All 37 purchased electricity rows. Market factors use lb/MWh, not kg/kWh; zero is a valid contractual factor. Omitted source <enter factor> placeholders retain eGRID fallback. Field units: subregion: categorical enum; kwh: Purchased electricity kWh; market_co2_lb_per_mwh: Supplier CO2 lb/MWh; null falls back to eGRID; market_ch4_lb_per_mwh: Supplier CH4 lb/MWh; null falls back to eGRID; market_n2o_lb_per_mwh: Supplier N2O lb/MWh; null falls back to eGRID. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`steam_sources`** (`in`, `record`): All active purchased steam rows, excluding both worked examples. Source divides factors by boiler efficiency for both supplied and default factors; retain this publisher behavior. Field units: fuel: categorical enum; boiler_efficiency_percent: Percent 0–100, source blank means 80%; must be >0 when supplied; mmbtu: Purchased steam million Btu; location_co2_kg_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams; location_ch4_g_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams; location_n2o_g_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams; market_co2_kg_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams; market_ch4_g_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams; market_n2o_g_per_mmbtu: Supplier factor per MMBtu; CO2 kg, CH4/N2O grams. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`refrigeration_material_balance`** (`in`, `record`): Material balance in kg. Use only one estimation method per physical source to avoid double counting. Field units: gas: categorical enum; inventory_change: kg beginning minus ending stored inventory, signed; transferred_amount: kg purchased minus sold/disposed, signed; capacity_change: kg beginning minus ending capacity, signed. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`fire_material_balance`** (`in`, `record`): Material balance in lb. Use only one estimation method per physical source to avoid double counting. Field units: gas: categorical enum; inventory_change: lb beginning minus ending stored inventory, signed; transferred_amount: lb purchased minus sold/disposed, signed; capacity_change: lb beginning minus ending capacity, signed. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`refrigeration_simplified_balance`** (`in`, `record`): Simplified material balance in kg. Do not duplicate sources already entered in another method. Field units: gas: categorical enum; new_charge: kg; new_capacity: kg; existing_recharge: kg; disposed_capacity: kg; recovered: kg. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`fire_simplified_balance`** (`in`, `record`): Simplified material balance in lb. Do not duplicate sources already entered in another method. Field units: gas: categorical enum; new_charge: lb; new_capacity: lb; existing_recharge: lb; disposed_capacity: lb; recovered: lb. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`refrigeration_screening`** (`in`, `record`): Refrigeration screening method; equipment determines leakage factors. Do not duplicate material balance sources. Field units: equipment: categorical enum; gas: categorical enum; new_charge_kg: kg; months: Months of operation 0–12; operating_capacity_kg: kg; disposed_capacity_kg: kg. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`fire_screening`** (`in`, `record`): Fire suppression screening method. Fixed/Portable equipment selects leakage rate; avoid duplicate sources. Field units: equipment: categorical enum; gas: categorical enum; capacity_lb: lb. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`purchased_gases`** (`in`, `record`): Purchased industrial gases, pounds; excludes refrigeration/fire gases already counted. Field units: gas: categorical enum; purchased_lb: lb of industrial gas released. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`business_vehicles`** (`in`, `record`): All active business vehicles rows; distance in vehicle-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: vehicle-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`business_public_transport`** (`in`, `record`): All active business public transport rows; distance in passenger-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: passenger-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`business_air`** (`in`, `record`): All active business air rows; distance in passenger-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: passenger-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`commuting_vehicles`** (`in`, `record`): All active commuting vehicles rows; distance in vehicle-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: vehicle-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`commuting_public_transport`** (`in`, `record`): All active commuting public transport rows; distance in passenger-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: passenger-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`upstream_vehicle_transport`** (`in`, `record`): All active upstream vehicle transport rows; distance in vehicle-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: vehicle-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`upstream_ton_mile_transport`** (`in`, `record`): All active upstream ton mile transport rows; distance in short ton-miles. Type selector must exactly match its enum. Field units: type: categorical enum; miles: short ton-miles. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`waste_sources`** (`in`, `record`): All waste rows; material spelling must match Emission Factors!B290:B350. Disposal must have a numeric factor for that material; use compatible material and disposal pairs from the workbook. Waste factors are those in the pinned EPA workbook. Field units: material: categorical enum; disposal_method: categorical enum; weight: Nonnegative weight in unit; unit: categorical enum. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`purchased_offsets`** (`in`, `record`): Purchased offsets reduce net emissions with zero floor; gross emissions remain unchanged. Do not combine location- and market-based Scope 2 totals. Field units: scope: categorical enum; metric_tons_co2e: Nonnegative metric tons CO2e. Partial record: row_N_name keys are exact Excel row coordinates; omitted fields retain source blanks/defaults. Provide complete activity and selector companions for each populated row. Do not provide overlapping quick scalar ports for the same cells.
- **`scope_1_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_2_location_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_2_market_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_3_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Catalog-added SUM of publisher category outputs; Scope 3 includes only travel, commuting, upstream transport and waste.
- **`organization_location_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Catalog-added SUM of publisher category outputs; Scope 3 includes only travel, commuting, upstream transport and waste.
- **`organization_market_gross`** (`out`, `scalar`): Metric tons CO2e per reporting year. Catalog-added SUM of publisher category outputs; Scope 3 includes only travel, commuting, upstream transport and waste.
- **`stationary_combustion`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`mobile_sources_emissions`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`refrigeration_ac`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`fire_suppression`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`purchased_gases_emissions`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`purchased_electricity_location`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`purchased_steam_location`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`purchased_electricity_market`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`purchased_steam_market`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_1_net`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_2_location_net`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`scope_2_market_net`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`business_travel`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`employee_commuting`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`upstream_transport`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`waste`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`stationary_biomass_co2`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`mobile_biomass_co2`** (`out`, `scalar`): Metric tons CO2e per reporting year. Original EPA Summary formula; biomass CO2 is supplemental and excluded from gross scope totals.
- **`organization_location_net`** (`out`, `scalar`): Metric tons CO2e per reporting year. Catalog-added SUM of publisher category outputs; Scope 3 includes only travel, commuting, upstream transport and waste.

## Editorial & Version Notes

Keep market- and location-based Scope 2 views separate. Use complete annual activity data and review organizational boundaries and factor vintage. Publisher example rows are excluded from totals.

---

# Federal Reserve SCALE CECL Calculator (2026)

> Estimate source-preserved seven-segment CECL allowances with qualitative, historical and individually assessed loan adjustments.

- **Model ID**: `fed-scale-cecl@2026` (Package `2026.1.0`)
- **Publisher**: [Federal Reserve System (Supervision Outreach — SCALE Method)](https://www.supervisionoutreach.org/cecl/scale)
- **Source Workbook**: `fed-scale-cecl.xlsx` (`sha256:8d2a6524fb5ad6e343b07e6edd883fdc0ea70cafa3a547f28a55df37f98e363f`)
- **Cadence**: periodic | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://www.supervisionoutreach.org/-/media/files/supervisionoutreach/cecl/scale_tool_blank.xlsx; upstreamArtifact: null; catalog file size: 44752 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_allowance`

## Flows

### `quick_allowance` — Quick SCALE allowance (single)
Twelve balance/rate/qualitative inputs for four main segments; all omitted assumptions retain source defaults. For credit cards, other consumer, history or individual loans use full_allowance.
- **Inputs**: `construction_balance`, `construction_proxy_rate`, `construction_q_adjustment`, `commercial_real_estate_balance`, `commercial_real_estate_proxy_rate`, `commercial_real_estate_q_adjustment`, `residential_real_estate_balance`, `residential_real_estate_proxy_rate`, `residential_real_estate_q_adjustment`, `commercial_balance`, `commercial_proxy_rate`, `commercial_q_adjustment`
- **Outputs**: `total_loans`, `pooled_balance`, `base_pooled_allowance`, `individual_allowance`, `total_allowance`, `reserve_ratio`

### `full_allowance` — Full SCALE allowance (single)
All numeric domain inputs: seven segments, 17 individual-loan rows and 14 institution/peer annual loss ratios. Text narrative and borrower labels do not change calculations. Outputs preserve all source formulas.
- **Inputs**: `construction_balance`, `construction_proxy_rate`, `construction_q_adjustment`, `commercial_real_estate_balance`, `commercial_real_estate_proxy_rate`, `commercial_real_estate_q_adjustment`, `residential_real_estate_balance`, `residential_real_estate_proxy_rate`, `residential_real_estate_q_adjustment`, `commercial_balance`, `commercial_proxy_rate`, `commercial_q_adjustment`, `credit_cards_balance`, `credit_cards_proxy_rate`, `credit_cards_q_adjustment`, `other_consumer_balance`, `other_consumer_proxy_rate`, `other_consumer_q_adjustment`, `additional_balance`, `additional_proxy_rate`, `additional_q_adjustment`, `institution_loss_2007`, `peer_loss_2007`, `institution_loss_2008`, `peer_loss_2008`, `institution_loss_2009`, `peer_loss_2009`, `institution_loss_2010`, `peer_loss_2010`, `institution_loss_2011`, `peer_loss_2011`, `institution_loss_2012`, `peer_loss_2012`, `institution_loss_2013`, `peer_loss_2013`, `institution_loss_2014`, `peer_loss_2014`, `institution_loss_2015`, `peer_loss_2015`, `institution_loss_2016`, `peer_loss_2016`, `institution_loss_2017`, `peer_loss_2017`, `institution_loss_2018`, `peer_loss_2018`, `institution_loss_2019`, `peer_loss_2019`, `institution_loss_2020`, `peer_loss_2020`, `loan_9_construction`, `loan_9_commercial_real_estate`, `loan_9_residential_real_estate`, `loan_9_commercial`, `loan_9_credit_cards`, `loan_9_other_consumer`, `loan_9_additional`, `loan_9_collections`, `loan_10_construction`, `loan_10_commercial_real_estate`, `loan_10_residential_real_estate`, `loan_10_commercial`, `loan_10_credit_cards`, `loan_10_other_consumer`, `loan_10_additional`, `loan_10_collections`, `loan_11_construction`, `loan_11_commercial_real_estate`, `loan_11_residential_real_estate`, `loan_11_commercial`, `loan_11_credit_cards`, `loan_11_other_consumer`, `loan_11_additional`, `loan_11_collections`, `loan_12_construction`, `loan_12_commercial_real_estate`, `loan_12_residential_real_estate`, `loan_12_commercial`, `loan_12_credit_cards`, `loan_12_other_consumer`, `loan_12_additional`, `loan_12_collections`, `loan_13_construction`, `loan_13_commercial_real_estate`, `loan_13_residential_real_estate`, `loan_13_commercial`, `loan_13_credit_cards`, `loan_13_other_consumer`, `loan_13_additional`, `loan_13_collections`, `loan_14_construction`, `loan_14_commercial_real_estate`, `loan_14_residential_real_estate`, `loan_14_commercial`, `loan_14_credit_cards`, `loan_14_other_consumer`, `loan_14_additional`, `loan_14_collections`, `loan_15_construction`, `loan_15_commercial_real_estate`, `loan_15_residential_real_estate`, `loan_15_commercial`, `loan_15_credit_cards`, `loan_15_other_consumer`, `loan_15_additional`, `loan_15_collections`, `loan_16_construction`, `loan_16_commercial_real_estate`, `loan_16_residential_real_estate`, `loan_16_commercial`, `loan_16_credit_cards`, `loan_16_other_consumer`, `loan_16_additional`, `loan_16_collections`, `loan_17_construction`, `loan_17_commercial_real_estate`, `loan_17_residential_real_estate`, `loan_17_commercial`, `loan_17_credit_cards`, `loan_17_other_consumer`, `loan_17_additional`, `loan_17_collections`, `loan_18_construction`, `loan_18_commercial_real_estate`, `loan_18_residential_real_estate`, `loan_18_commercial`, `loan_18_credit_cards`, `loan_18_other_consumer`, `loan_18_additional`, `loan_18_collections`, `loan_19_construction`, `loan_19_commercial_real_estate`, `loan_19_residential_real_estate`, `loan_19_commercial`, `loan_19_credit_cards`, `loan_19_other_consumer`, `loan_19_additional`, `loan_19_collections`, `loan_20_construction`, `loan_20_commercial_real_estate`, `loan_20_residential_real_estate`, `loan_20_commercial`, `loan_20_credit_cards`, `loan_20_other_consumer`, `loan_20_additional`, `loan_20_collections`, `loan_21_construction`, `loan_21_commercial_real_estate`, `loan_21_residential_real_estate`, `loan_21_commercial`, `loan_21_credit_cards`, `loan_21_other_consumer`, `loan_21_additional`, `loan_21_collections`, `loan_22_construction`, `loan_22_commercial_real_estate`, `loan_22_residential_real_estate`, `loan_22_commercial`, `loan_22_credit_cards`, `loan_22_other_consumer`, `loan_22_additional`, `loan_22_collections`, `loan_23_construction`, `loan_23_commercial_real_estate`, `loan_23_residential_real_estate`, `loan_23_commercial`, `loan_23_credit_cards`, `loan_23_other_consumer`, `loan_23_additional`, `loan_23_collections`, `loan_24_construction`, `loan_24_commercial_real_estate`, `loan_24_residential_real_estate`, `loan_24_commercial`, `loan_24_credit_cards`, `loan_24_other_consumer`, `loan_24_additional`, `loan_24_collections`, `loan_25_construction`, `loan_25_commercial_real_estate`, `loan_25_residential_real_estate`, `loan_25_commercial`, `loan_25_credit_cards`, `loan_25_other_consumer`, `loan_25_additional`, `loan_25_collections`
- **Outputs**: `total_loans`, `pooled_balance`, `base_pooled_allowance`, `historical_adjustment`, `individual_allowance`, `total_allowance`, `reserve_ratio`, `construction_pooled_allowance`, `commercial_real_estate_pooled_allowance`, `residential_real_estate_pooled_allowance`, `commercial_pooled_allowance`, `credit_cards_pooled_allowance`, `other_consumer_pooled_allowance`, `additional_pooled_allowance`, `institution_average_loss`, `peer_average_loss`, `historical_rate_difference`

## SheetPort Ports (`fio.yaml`)

- **`construction_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`construction_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`construction_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`commercial_real_estate_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`commercial_real_estate_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`commercial_real_estate_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`residential_real_estate_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`residential_real_estate_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`residential_real_estate_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`commercial_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`commercial_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`commercial_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`credit_cards_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`credit_cards_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`credit_cards_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`other_consumer_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`other_consumer_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`other_consumer_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`additional_balance`** (`in`, `scalar`): Nonnegative USD end-of-period loans; blank source default = zero. Individually assessed balances must not exceed this amount.
- **`additional_proxy_rate`** (`in`, `scalar`): Nonnegative decimal lifetime loss rate: 0.01 = 1%; source default 0. Not an annual rate.
- **`additional_q_adjustment`** (`in`, `scalar`): Signed additive decimal lifetime-rate adjustment: 0.005 = +0.5 percentage point; source default 0.
- **`institution_loss_2007`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2007; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2007`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2007; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2008`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2008; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2008`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2008; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2009`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2009; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2009`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2009; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2010`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2010; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2010`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2010; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2011`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2011; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2011`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2011; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2012`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2012; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2012`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2012; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2013`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2013; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2013`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2013; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2014`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2014; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2014`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2014; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2015`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2015; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2015`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2015; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2016`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2016; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2016`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2016; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2017`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2017; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2017`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2017; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2018`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2018; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2018`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2018; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2019`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2019; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2019`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2019; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`institution_loss_2020`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2020; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`peer_loss_2020`** (`in`, `scalar`): Signed decimal annual net charge-off ratio for 2020; 0.01 = 1%; source default 0. Fourteen annual ratios are averaged without weighting.
- **`loan_9_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 9; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_9_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 9; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_10_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 10; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_10_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 10; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_11_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 11; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_11_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 11; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_12_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 12; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_12_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 12; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_13_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 13; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_13_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 13; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_14_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 14; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_14_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 14; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_15_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 15; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_15_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 15; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_16_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 16; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_16_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 16; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_17_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 17; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_17_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 17; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_18_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 18; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_18_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 18; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_19_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 19; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_19_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 19; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_20_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 20; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_20_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 20; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_21_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 21; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_21_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 21; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_22_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 22; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_22_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 22; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_23_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 23; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_23_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 23; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_24_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 24; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_24_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 24; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`loan_25_construction`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_commercial_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_residential_real_estate`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_commercial`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_credit_cards`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_other_consumer`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_additional`** (`in`, `scalar`): Nonnegative USD individual-loan balance, source row 25; blank defaults to zero. Included in segment deductions; row 25 has no source allowance formula.
- **`loan_25_collections`** (`in`, `scalar`): Nonnegative USD expected collections for source row 25; blank defaults to zero. Loan allowance is max(sum of seven balances minus collections,0), except row 25 has no source formula.
- **`total_loans`** (`out`, `scalar`): Total end-of-period loans, USD.
- **`pooled_balance`** (`out`, `scalar`): Total pooled loans, USD; credit-card source H16 is a constant zero.
- **`base_pooled_allowance`** (`out`, `scalar`): USD pooled allowance before historical adjustment.
- **`historical_adjustment`** (`out`, `scalar`): Signed USD historical adjustment = pooled balance times institution-minus-peer mean annual loss ratio.
- **`individual_allowance`** (`out`, `scalar`): USD individual allowances for rows 9:24 only; source O25 is blank.
- **`total_allowance`** (`out`, `scalar`): Signed USD total allowance; source does not floor negative results.
- **`reserve_ratio`** (`out`, `scalar`): Decimal total allowance / total loans; 0.01 = 1%. Source returns zero when allowance is zero.
- **`construction_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`commercial_real_estate_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`residential_real_estate_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`commercial_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`credit_cards_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`other_consumer_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`additional_pooled_allowance`** (`out`, `scalar`): Signed USD source segment allowance. Credit-card pooled balance is hard-coded zero.
- **`institution_average_loss`** (`out`, `scalar`): Decimal annual net charge-off ratio or signed difference; 0.01 = 1%.
- **`peer_average_loss`** (`out`, `scalar`): Decimal annual net charge-off ratio or signed difference; 0.01 = 1%.
- **`historical_rate_difference`** (`out`, `scalar`): Decimal annual net charge-off ratio or signed difference; 0.01 = 1%.

## Editorial & Version Notes

2026 labels this catalog snapshot; the supplied blank workbook does not identify a 2026 publisher edition. No live check of the publisher's latest release was performed.

The source uses H16 = 0, not D16-F16: credit-card pooled losses are always zero even when balances and proxy rates are supplied. Preserved without formula correction.

Source O25 is blank although E25:K25 balances enter segment totals. Row 25 deducts individual balances from pools but contributes no individual allowance. Use rows 9:24 for calculated individual losses.

Historical performance adjustment is the difference of fourteen unweighted 2007–2020 annual net-loss ratios, applied once to pooled balance; it is not multiplied by remaining life.

Signed adjustments and pooled balances are not clamped by source formulas. Ensure individual balances do not exceed segment balances and review negative allowance outcomes.

The blank tool contains no embedded peer loss-rate dataset. Supply proxy lifetime loss rates and justified qualitative assumptions. Numerical inputs use decimal ratios, not displayed percentage points.

Quick-flow count is twelve inputs and six outputs. Full maps all numeric domain assumptions; presentation labels, years and narrative text are not mapped.

Publisher attribution does not establish reuse licensing or GAAP suitability. This entry is listed for reference only; no workbook redistribution permission is established.

---

# HUD CNA Reserve for Replacement Financial Factors (v30.3)

> Test reserve deposits and mortgage debt service against the pinned HUD CNA example, with annual reserve balances and minimum-balance diagnostics.

- **Model ID**: `hud-cna-reserve-factors@v30.3` (Package `30.3.0`)
- **Publisher**: [U.S. Department of Housing and Urban Development (HUD — Multifamily CNA e-Tool)](https://www.hud.gov/hud-partners/multifamily-cna)
- **Source Workbook**: `hud-cna-reserve-factors-v30-3.xlsx` (`sha256:ef9e2408e617820fa098fb719e5efe0389d11178e414223c30008b40af2b4348`)
- **Cadence**: periodic | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://www.hud.gov/sites/dfiles/Housing/documents/RfR_Financial_Factors_Analysis_Tool_v30_3.xlsx; upstreamArtifact: null; catalog file size: 745577 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_reserve_analysis`

## Flows

### `quick_reserve_analysis` — Quick reserve analysis (single)
Main decision inputs; omitted inputs retain the pinned source example defaults.
- **Inputs**: `initial_reserve`, `annual_deposit_per_unit`, `initial_deposit_escalation`, `deposit_change_year`, `new_deposit_escalation`, `mortgage_amount`, `mortgage_coupon`, `mortgage_years`, `annual_mip`, `assumed_dscr`
- **Outputs**: `year1_reserve`, `year10_reserve`, `year20_reserve`, `annual_debt_service`, `assumed_case_dscr`, `first10_result`

### `full_reserve_analysis` — Full reserve analysis (single)
USD unless labeled USD/unit/year; percentage inputs use decimal fractions. Fixed 456-unit, 20-year source example. Full flow adds annual inflated needs, minimum reserve and amortization mitigation.
- **Inputs**: `initial_reserve`, `annual_deposit_per_unit`, `initial_deposit_escalation`, `deposit_change_year`, `new_deposit_escalation`, `mortgage_amount`, `mortgage_coupon`, `mortgage_years`, `annual_mip`, `assumed_dscr`, `amortization_mitigation_fraction`, `required_minimum_year1`, `needs_year_1`, `needs_year_2`, `needs_year_3`, `needs_year_4`, `needs_year_5`, `needs_year_6`, `needs_year_7`, `needs_year_8`, `needs_year_9`, `needs_year_10`, `needs_year_11`, `needs_year_12`, `needs_year_13`, `needs_year_14`, `needs_year_15`, `needs_year_16`, `needs_year_17`, `needs_year_18`, `needs_year_19`, `needs_year_20`
- **Outputs**: `year1_reserve`, `year10_reserve`, `year20_reserve`, `annual_debt_service`, `assumed_case_dscr`, `first10_result`, `later_result`, `mitigation_result`, `monthly_payment`, `debt_service_per_unit`, `annual_deposit_total`, `risk_additional_deposit_per_unit`

## SheetPort Ports (`fio.yaml`)

- **`initial_reserve`** (`in`, `scalar`): USD, nonnegative initial reserve deposit. Default 466925. Replaces source formula with trial value. Source default: 466925.
- **`annual_deposit_per_unit`** (`in`, `scalar`): USD/unit/year, nonnegative first-year deposit. Default 556; source example has 456 units. Source default: 556.
- **`initial_deposit_escalation`** (`in`, `scalar`): Decimal fraction per year (0.02 = 2%). Default 0; first year uses this rate. Source default: 0.
- **`deposit_change_year`** (`in`, `scalar`): Relative year, integer 1..20. Default 1; from year 2, new rate applies when year >= this value. Source default: 1.
- **`new_deposit_escalation`** (`in`, `scalar`): Decimal fraction per year. Default 0.02; applies from change year, except year 1 uses initial rate. Source default: 0.02.
- **`mortgage_amount`** (`in`, `scalar`): USD principal, positive. Default 20000000. Affects amortization mitigation and debt service. Source default: 20000000.
- **`mortgage_coupon`** (`in`, `scalar`): Decimal annual coupon, 0.025 = 2.5%. Default 0.025. Source default: 0.025.
- **`mortgage_years`** (`in`, `scalar`): Years, positive amortizing mortgage term. Default 35. Source default: 35.
- **`annual_mip`** (`in`, `scalar`): Decimal annual mortgage insurance premium. Default 0.0065. Source default: 0.0065.
- **`assumed_dscr`** (`in`, `scalar`): Dimensionless assumed debt service coverage ratio. Default 1.2; this is an assumed NOI case, not an underwritten actual NOI. Source default: 1.2.
- **`amortization_mitigation_fraction`** (`in`, `scalar`): Decimal fraction 0..1 of cumulative principal allowed for mitigation. Default 0.5. Source default: 0.5.
- **`required_minimum_year1`** (`in`, `scalar`): USD, year-1 required minimum reserve. Default 335249.58; trial engine escalates this base with source capital-needs inflation. Source default: 335249.58.
- **`needs_year_1`** (`in`, `scalar`): USD positive inflated withdrawal in year 1. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 0.
- **`needs_year_2`** (`in`, `scalar`): USD positive inflated withdrawal in year 2. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 0.
- **`needs_year_3`** (`in`, `scalar`): USD positive inflated withdrawal in year 3. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 345094.42.
- **`needs_year_4`** (`in`, `scalar`): USD positive inflated withdrawal in year 4. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 287848.42.
- **`needs_year_5`** (`in`, `scalar`): USD positive inflated withdrawal in year 5. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 514096.82.
- **`needs_year_6`** (`in`, `scalar`): USD positive inflated withdrawal in year 6. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 473399.52.
- **`needs_year_7`** (`in`, `scalar`): USD positive inflated withdrawal in year 7. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 425964.13.
- **`needs_year_8`** (`in`, `scalar`): USD positive inflated withdrawal in year 8. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 273292.93.
- **`needs_year_9`** (`in`, `scalar`): USD positive inflated withdrawal in year 9. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 223601.16.
- **`needs_year_10`** (`in`, `scalar`): USD positive inflated withdrawal in year 10. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 357422.04.
- **`needs_year_11`** (`in`, `scalar`): USD positive inflated withdrawal in year 11. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 860042.46.
- **`needs_year_12`** (`in`, `scalar`): USD positive inflated withdrawal in year 12. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 815520.15.
- **`needs_year_13`** (`in`, `scalar`): USD positive inflated withdrawal in year 13. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 728117.64.
- **`needs_year_14`** (`in`, `scalar`): USD positive inflated withdrawal in year 14. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 276499.39.
- **`needs_year_15`** (`in`, `scalar`): USD positive inflated withdrawal in year 15. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 709668.05.
- **`needs_year_16`** (`in`, `scalar`): USD positive inflated withdrawal in year 16. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 670075.82.
- **`needs_year_17`** (`in`, `scalar`): USD positive inflated withdrawal in year 17. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 634855.55.
- **`needs_year_18`** (`in`, `scalar`): USD positive inflated withdrawal in year 18. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 308527.36.
- **`needs_year_19`** (`in`, `scalar`): USD positive inflated withdrawal in year 19. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 169510.22.
- **`needs_year_20`** (`in`, `scalar`): USD positive inflated withdrawal in year 20. Default is publisher example. This is the already inflated schedule; do not apply inflation twice. Source default: 154090.56.
- **`year1_reserve`** (`out`, `scalar`): USD end-year-1 reserve; signed, negative means deficit.
- **`year10_reserve`** (`out`, `scalar`): USD end-year-10 reserve; signed.
- **`year20_reserve`** (`out`, `scalar`): USD end-year-20 reserve; signed.
- **`annual_debt_service`** (`out`, `scalar`): USD/year principal and interest plus annual MIP.
- **`assumed_case_dscr`** (`out`, `scalar`): Dimensionless resulting coverage at assumed_dscr; DSC adjustment remains source zero.
- **`first10_result`** (`out`, `scalar`): Enum PASS or FAIL for first-ten-year required-minimum test.
- **`later_result`** (`out`, `scalar`): Enum PASS or FAIL for year-11+ required-minimum test.
- **`mitigation_result`** (`out`, `scalar`): Enum PASS or FAIL for amortization mitigation; source trial test references original eTool balances in C65:C74.
- **`monthly_payment`** (`out`, `scalar`): USD/month amortizing principal and interest.
- **`debt_service_per_unit`** (`out`, `scalar`): USD/unit/year debt service including MIP.
- **`annual_deposit_total`** (`out`, `scalar`): USD/year first-year trial reserve deposit, 456 times per-unit amount.
- **`risk_additional_deposit_per_unit`** (`out`, `scalar`): USD/unit/year approximate additional year-1 deposit to address later shortfall; retains publisher heuristic.

## Editorial & Version Notes

Pinned historic v30.3 example; latest publisher edition not checked. 456 units are derived from the original financial schedule; no unit-count input is exposed. This flow varies trial deposits and the fixed 20-year inflated-needs schedule, not a new CNA component inventory. Publisher trial amortization diagnostic C65:C74 references original eTool balances; preserve and interpret with care. Risk and DSC adjustment cells remain zero as instructed by the workbook. DSC output equals the assumed coverage without an NOI adjustment. Source diagnostic I65:J65 divides by zero for years with no needs; these error cells are excluded from outputs. MATCH shim supports exact matches only; all calls in the pinned source use 0 or FALSE.

---

# ILPA Reporting Template — LP Quarterly Reconciliation (v1.1)

> Reconcile quarterly LP capital, management fees, partnership expenses, offsets, commitments and accrued incentive allocations using ILPA v1.1 source formulas.

- **Model ID**: `ilpa-reporting-template@v1.1` (Package `1.1.0`)
- **Publisher**: [Institutional Limited Partners Association (ILPA)](https://ilpa.org/resource/ilpa-reporting-template-xlsx/)
- **Source Workbook**: `ilpa-reporting-v1-1.xlsx` (`sha256:b13cee7c41acc34f804ff0cb527e20dca637d68cff581a9cc001ce7078bdcf28`)
- **Cadence**: periodic | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://ilpa.org/wp-content/uploads/2019/08/ILPA-Reporting-Template-Version-1.1-with-Guidance-1.xlsx; upstreamArtifact: null; catalog file size: 799412 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_lp_quarter`

## Flows

### `quick_lp_quarter` — Quick lp quarter (single)
Main decision inputs; omitted inputs retain the pinned source example defaults.
- **Inputs**: `beginning_nav`, `contributions`, `distributions`, `gross_management_fees`, `fee_rebate`, `legal_expense`, `applied_offsets`, `interest_income`, `dividend_income`, `realized_gain`, `unrealized_gain_change`, `accrued_incentive_change`
- **Outputs**: `net_cash_flows`, `net_fees_expenses`, `net_operating_income`, `ending_nav`, `ending_accrued_incentive`, `gross_ending_nav`

### `full_lp_quarter` — Full lp quarter (single)
LP #5 quarterly E-column; USD with source signs. Full flow exposes all numeric nonformula E9:E90 statement entries and all mapped formula outputs; other periods and fund schedules stay at source defaults.
- **Inputs**: `beginning_nav`, `contributions`, `distributions`, `gross_management_fees`, `fee_rebate`, `accounting_expense`, `audit_expense`, `bank_expense`, `custody_expense`, `due_diligence_expense`, `legal_expense`, `organization_expense`, `travel_expense`, `other_expense`, `applied_offsets`, `advisory_offset`, `broken_deal_offset`, `transaction_offset`, `directors_offset`, `monitoring_offset`, `capital_markets_offset`, `organization_offset`, `placement_offset`, `other_offset`, `beginning_unapplied_offsets`, `fee_waiver`, `interest_income`, `dividend_income`, `interest_expense`, `other_income`, `placement_fees`, `realized_gain`, `unrealized_gain_change`, `beginning_accrued_incentive`, `incentive_paid`, `accrued_incentive_change`, `total_commitment`, `beginning_unfunded`, `commitment_contributions`, `recallable_distributions`, `released_commitments`, `other_unfunded_adjustment`, `earned_incentive`, `escrow_incentive`, `returned_clawback`, `capitalized_nonrelated_fees`, `distributions_for_fees`, `related_party_partnership_expense`, `capitalized_related_fees`, `portfolio_advisory_fees`, `portfolio_broken_deal_fees`, `portfolio_transaction_fees`, `portfolio_directors_fees`, `portfolio_monitoring_fees`, `portfolio_capital_markets_fees`, `portfolio_other_fees`, `portfolio_reimbursements`
- **Outputs**: `net_cash_flows`, `total_partnership_expense`, `recognized_offsets`, `offsets_applied_display`, `ending_unapplied_offsets`, `net_fees_expenses`, `net_operating_income`, `ending_nav`, `ending_accrued_incentive`, `gross_ending_nav`, `ending_unfunded`, `underlying_fund_fees`, `related_management_fees`, `related_offsets`, `related_incentive_change`, `portfolio_total_fees`, `total_received_related_parties`

## SheetPort Ports (`fio.yaml`)

- **`beginning_nav`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 45067000.
- **`contributions`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`distributions`** (`in`, `scalar`): USD for LP #5 QTD only. Enter distributions as positive; formula subtracts them. Default equals the source illustrative example.  Source default: 1250000.
- **`gross_management_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -187500.
- **`fee_rebate`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`accounting_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -1000.
- **`audit_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -2000.
- **`bank_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: 0.
- **`custody_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -12500.
- **`due_diligence_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -20000.
- **`legal_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: 0.
- **`organization_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -10000.
- **`travel_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -2500.
- **`other_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: 0.
- **`applied_offsets`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 82600.
- **`advisory_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 16000.
- **`broken_deal_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 8000.
- **`transaction_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 4000.
- **`directors_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 600.
- **`monitoring_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 30000.
- **`capital_markets_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 15000.
- **`organization_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 8000.
- **`placement_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 0.
- **`other_offset`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example. Already allocated offset USD; displayed D-column percentages are disclosures, not active calculation switches. Source default: 0.
- **`beginning_unapplied_offsets`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 1000.
- **`fee_waiver`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`interest_income`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 500.
- **`dividend_income`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 10000.
- **`interest_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -2000.
- **`other_income`** (`in`, `scalar`): USD for LP #5 QTD only. Signed amount; gains/increases positive. Default equals the source illustrative example.  Source default: 1000.
- **`placement_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: 0.
- **`realized_gain`** (`in`, `scalar`): USD for LP #5 QTD only. Signed amount; gains/increases positive. Default equals the source illustrative example.  Source default: 1000000.
- **`unrealized_gain_change`** (`in`, `scalar`): USD for LP #5 QTD only. Signed amount; gains/increases positive. Default equals the source illustrative example.  Source default: 1000000.
- **`beginning_accrued_incentive`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -4750000.
- **`incentive_paid`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 50000.
- **`accrued_incentive_change`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: -300000.
- **`total_commitment`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 50000000.
- **`beginning_unfunded`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 18500000.
- **`commitment_contributions`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example. Separate commitment deduction; enter negative contributions here as well as positive NAV contributions to keep both schedules consistent. Source default: 0.
- **`recallable_distributions`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`released_commitments`** (`in`, `scalar`): USD for LP #5 QTD only. Enter expenses, reductions or accrued carry as negative values. Default equals the source illustrative example.  Source default: 0.
- **`other_unfunded_adjustment`** (`in`, `scalar`): USD for LP #5 QTD only. Signed amount; gains/increases positive. Default equals the source illustrative example.  Source default: 0.
- **`earned_incentive`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 1250000.
- **`escrow_incentive`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 250000.
- **`returned_clawback`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`capitalized_nonrelated_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 50000.
- **`distributions_for_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 2500.
- **`related_party_partnership_expense`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 1000.
- **`capitalized_related_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`portfolio_advisory_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 20000.
- **`portfolio_broken_deal_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 10000.
- **`portfolio_transaction_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 5000.
- **`portfolio_directors_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 600.
- **`portfolio_monitoring_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 30000.
- **`portfolio_capital_markets_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 15000.
- **`portfolio_other_fees`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 0.
- **`portfolio_reimbursements`** (`in`, `scalar`): USD for LP #5 QTD only. Positive amount unless the source convention requires a signed adjustment. Default equals the source illustrative example.  Source default: 5000.
- **`net_cash_flows`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`total_partnership_expense`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`recognized_offsets`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`offsets_applied_display`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`ending_unapplied_offsets`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`net_fees_expenses`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Net expense is negative.
- **`net_operating_income`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`ending_nav`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Ending NAV net of incentive allocation.
- **`ending_accrued_incentive`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Accrued incentive liability is negative.
- **`gross_ending_nav`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. NAV before accrued incentive liability.
- **`ending_unfunded`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`underlying_fund_fees`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Pro rata underlying fund charges; underlying-fund schedule remains publisher example.
- **`related_management_fees`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`related_offsets`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`related_incentive_change`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`portfolio_total_fees`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.
- **`total_received_related_parties`** (`out`, `scalar`): USD LP #5 QTD, signed source convention. Calculated from source reconciliation formula.

## Editorial & Version Notes

Historical v1.1 packet last updated October 17, 2016; not the newer ILPA reporting standard. Mapped domain is LP #5 quarterly E-column statement only; YTD, inception, total-fund, GP and underlying-fund schedules retain example values. Underlying fund fees output is a source-example allocation, not recalculated from user-supplied underlying holdings. Offset percentages are disclosures. Input offset amounts are already LP allocated; no automatic multiplication by the displayed percentages. Contributions for NAV and commitment reconciliation are separate signed inputs; full flow exposes both. ILPA source is reference-only; no redistribution or endorsement rights are asserted.

---

# Christoph Janz SaaS Financial Plan 2.0 (v2.0)

> Forecast 24 months of Basic, Pro and Enterprise recurring revenue, operating cash flow, bank balances and staffing with Christoph Janz’s SaaS Financial Plan 2.0.

- **Model ID**: `janz-saas-financial-plan@v2.0` (Package `2.0.0`)
- **Publisher**: [Christoph Janz / Point Nine Capital](https://christophjanz.blogspot.com/2016/03/saas-financial-plan-20.html)
- **Source Workbook**: `janz-saas-financial-plan-2-0.xlsx` (`sha256:eb2b8dc13a822d0c12e63fdb8f1c269b2ffce53e131e379aab29a030f29340f4`)
- **Cadence**: static | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: baseline-excel-cache. Excel-cached baseline outputs are matched. Changed-input scenarios apply expense and cash deltas to Excel-cached revenue, collections, EBIT and cash values; core growth, churn, ARPA and revenue schedules are not independently recalculated. ARR annualizes cached MRR.
- **Workbook Download**: `publisher-redirect`; source: https://www.dropbox.com/s/1pbdqraz6tke84u/SaaSFinancialPlan2.0.xlsx?dl=1; upstreamArtifact: null; catalog file size: 343477 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_saas_arr_burn_forecast`

## Flows

### `quick_saas_arr_burn_forecast` — quick saas arr burn forecast (single)
13 inputs covering growth, churn, target-driven enterprise sales, marketing, ARPA, infrastructure/payment fees and opening funding. Six outputs report month-12/24 ARR, signed operating cash flow and ending cash.
- **Inputs**: `organic_growth_year1`, `basic_churn`, `pro_churn`, `enterprise_mrr_target_year1`, `enterprise_mrr_target_year2`, `marketing_spend_first_month`, `marketing_spend_monthly_increase`, `basic_arpa`, `pro_arpa`, `infrastructure_fraction`, `payment_fee_fraction`, `starting_cash`, `month1_financing`
- **Outputs**: `arr_month12`, `arr_month24`, `cash_month12`, `cash_month24`, `operating_cashflow_month12`, `operating_cashflow_month24`

### `full_saas_operating_plan` — full saas operating plan (single)
All mapped revenue assumptions, employee hire dates (Excel 1900 date serial), annual USD salaries and bonus fractions, sales quota/ramp, cost rates, and all 24 monthly financing inflows. Outputs include 24-month MRR, EBIT, cash flow, cash balances and customer/segment MRR schedules. Rates are decimal fractions, costs positive, cash flow signed. Unmapped cells retain source defaults.
- **Inputs**: `organic_growth_year1`, `basic_churn`, `pro_churn`, `enterprise_mrr_target_year1`, `enterprise_mrr_target_year2`, `marketing_spend_first_month`, `marketing_spend_monthly_increase`, `basic_arpa`, `pro_arpa`, `infrastructure_fraction`, `payment_fee_fraction`, `starting_cash`, `month1_financing`, `revenue_assumption_6`, `revenue_assumption_7`, `revenue_assumption_8`, `revenue_assumption_10`, `revenue_assumption_11`, `revenue_assumption_20`, `revenue_assumption_22`, `revenue_assumption_23`, `revenue_assumption_33`, `revenue_assumption_34`, `revenue_assumption_45`, `revenue_assumption_48`, `revenue_assumption_49`, `revenue_assumption_51`, `revenue_assumption_53`, `revenue_assumption_54`, `revenue_assumption_60`, `revenue_assumption_61`, `revenue_assumption_74`, `revenue_assumption_80`, `revenue_assumption_81`, `revenue_assumption_82`, `revenue_assumption_83`, `revenue_assumption_96`, `cost_e4`, `cost_c7`, `cost_d7`, `cost_e7`, `cost_c8`, `cost_d8`, `cost_e8`, `cost_c9`, `cost_d9`, `cost_e9`, `cost_c10`, `cost_d10`, `cost_e10`, `cost_c11`, `cost_d11`, `cost_e11`, `cost_c12`, `cost_d12`, `cost_e12`, `cost_c13`, `cost_d13`, `cost_e13`, `cost_c14`, `cost_d14`, `cost_e14`, `cost_c15`, `cost_d15`, `cost_e15`, `cost_c21`, `cost_d21`, `cost_e21`, `cost_c22`, `cost_d22`, `cost_e22`, `cost_c23`, `cost_d23`, `cost_e23`, `cost_c24`, `cost_d24`, `cost_e24`, `cost_c25`, `cost_d25`, `cost_e25`, `cost_c26`, `cost_d26`, `cost_e26`, `cost_c27`, `cost_d27`, `cost_e27`, `cost_c28`, `cost_d28`, `cost_e28`, `cost_c29`, `cost_d29`, `cost_e29`, `cost_c30`, `cost_d30`, `cost_e30`, `cost_c31`, `cost_d31`, `cost_e31`, `cost_c32`, `cost_d32`, `cost_e32`, `cost_c33`, `cost_d33`, `cost_e33`, `cost_c34`, `cost_d34`, `cost_e34`, `cost_c35`, `cost_d35`, `cost_e35`, `cost_c36`, `cost_d36`, `cost_e36`, `cost_c37`, `cost_d37`, `cost_e37`, `cost_c38`, `cost_d38`, `cost_e38`, `cost_c39`, `cost_d39`, `cost_e39`, `cost_c40`, `cost_d40`, `cost_e40`, `cost_c41`, `cost_d41`, `cost_e41`, `cost_c42`, `cost_d42`, `cost_e42`, `cost_c43`, `cost_d43`, `cost_e43`, `cost_c44`, `cost_d44`, `cost_e44`, `cost_c45`, `cost_d45`, `cost_e45`, `cost_c46`, `cost_d46`, `cost_e46`, `cost_c47`, `cost_d47`, `cost_e47`, `cost_c48`, `cost_d48`, `cost_e48`, `cost_c54`, `cost_d54`, `cost_e54`, `cost_c55`, `cost_d55`, `cost_e55`, `cost_c56`, `cost_d56`, `cost_e56`, `cost_c57`, `cost_d57`, `cost_e57`, `cost_c58`, `cost_d58`, `cost_e58`, `cost_c59`, `cost_d59`, `cost_e59`, `cost_c60`, `cost_d60`, `cost_e60`, `cost_c61`, `cost_d61`, `cost_e61`, `cost_c67`, `cost_d67`, `cost_e67`, `cost_d68`, `cost_e68`, `cost_d69`, `cost_e69`, `cost_d70`, `cost_e70`, `cost_d71`, `cost_e71`, `cost_c77`, `cost_d77`, `cost_e77`, `cost_c78`, `cost_d78`, `cost_e78`, `cost_c79`, `cost_d79`, `cost_e79`, `cost_c80`, `cost_d80`, `cost_e80`, `cost_e94`, `cost_e95`, `cost_e96`, `cost_e97`, `cost_e98`, `cost_e102`, `cost_e103`, `cost_e104`, `cost_e105`, `cost_e106`, `cost_e110`, `cost_e111`, `cost_e112`, `cost_e113`, `cost_e114`, `cost_d123`, `cost_e123`, `cost_e124`, `cost_d125`, `cost_e125`, `cost_e126`, `sales_d6`, `sales_d7`, `sales_d8`, `sales_d9`, `sales_d10`, `financing_month_2`, `financing_month_3`, `financing_month_4`, `financing_month_5`, `financing_month_6`, `financing_month_7`, `financing_month_8`, `financing_month_9`, `financing_month_10`, `financing_month_11`, `financing_month_12`, `financing_month_13`, `financing_month_14`, `financing_month_15`, `financing_month_16`, `financing_month_17`, `financing_month_18`, `financing_month_19`, `financing_month_20`, `financing_month_21`, `financing_month_22`, `financing_month_23`, `financing_month_24`
- **Outputs**: `arr_month12`, `arr_month24`, `cash_month12`, `cash_month24`, `operating_cashflow_month12`, `operating_cashflow_month24`, `month_1_mrr`, `month_1_ebit`, `month_1_operating_cashflow`, `month_1_cash`, `month_2_mrr`, `month_2_ebit`, `month_2_operating_cashflow`, `month_2_cash`, `month_3_mrr`, `month_3_ebit`, `month_3_operating_cashflow`, `month_3_cash`, `month_4_mrr`, `month_4_ebit`, `month_4_operating_cashflow`, `month_4_cash`, `month_5_mrr`, `month_5_ebit`, `month_5_operating_cashflow`, `month_5_cash`, `month_6_mrr`, `month_6_ebit`, `month_6_operating_cashflow`, `month_6_cash`, `month_7_mrr`, `month_7_ebit`, `month_7_operating_cashflow`, `month_7_cash`, `month_8_mrr`, `month_8_ebit`, `month_8_operating_cashflow`, `month_8_cash`, `month_9_mrr`, `month_9_ebit`, `month_9_operating_cashflow`, `month_9_cash`, `month_10_mrr`, `month_10_ebit`, `month_10_operating_cashflow`, `month_10_cash`, `month_11_mrr`, `month_11_ebit`, `month_11_operating_cashflow`, `month_11_cash`, `month_12_mrr`, `month_12_ebit`, `month_12_operating_cashflow`, `month_12_cash`, `month_13_mrr`, `month_13_ebit`, `month_13_operating_cashflow`, `month_13_cash`, `month_14_mrr`, `month_14_ebit`, `month_14_operating_cashflow`, `month_14_cash`, `month_15_mrr`, `month_15_ebit`, `month_15_operating_cashflow`, `month_15_cash`, `month_16_mrr`, `month_16_ebit`, `month_16_operating_cashflow`, `month_16_cash`, `month_17_mrr`, `month_17_ebit`, `month_17_operating_cashflow`, `month_17_cash`, `month_18_mrr`, `month_18_ebit`, `month_18_operating_cashflow`, `month_18_cash`, `month_19_mrr`, `month_19_ebit`, `month_19_operating_cashflow`, `month_19_cash`, `month_20_mrr`, `month_20_ebit`, `month_20_operating_cashflow`, `month_20_cash`, `month_21_mrr`, `month_21_ebit`, `month_21_operating_cashflow`, `month_21_cash`, `month_22_mrr`, `month_22_ebit`, `month_22_operating_cashflow`, `month_22_cash`, `month_23_mrr`, `month_23_ebit`, `month_23_operating_cashflow`, `month_23_cash`, `month_24_mrr`, `month_24_ebit`, `month_24_operating_cashflow`, `month_24_cash`, `month_1_customers`, `month_1_basic_mrr`, `month_1_pro_mrr`, `month_1_enterprise_mrr`, `month_2_customers`, `month_2_basic_mrr`, `month_2_pro_mrr`, `month_2_enterprise_mrr`, `month_3_customers`, `month_3_basic_mrr`, `month_3_pro_mrr`, `month_3_enterprise_mrr`, `month_4_customers`, `month_4_basic_mrr`, `month_4_pro_mrr`, `month_4_enterprise_mrr`, `month_5_customers`, `month_5_basic_mrr`, `month_5_pro_mrr`, `month_5_enterprise_mrr`, `month_6_customers`, `month_6_basic_mrr`, `month_6_pro_mrr`, `month_6_enterprise_mrr`, `month_7_customers`, `month_7_basic_mrr`, `month_7_pro_mrr`, `month_7_enterprise_mrr`, `month_8_customers`, `month_8_basic_mrr`, `month_8_pro_mrr`, `month_8_enterprise_mrr`, `month_9_customers`, `month_9_basic_mrr`, `month_9_pro_mrr`, `month_9_enterprise_mrr`, `month_10_customers`, `month_10_basic_mrr`, `month_10_pro_mrr`, `month_10_enterprise_mrr`, `month_11_customers`, `month_11_basic_mrr`, `month_11_pro_mrr`, `month_11_enterprise_mrr`, `month_12_customers`, `month_12_basic_mrr`, `month_12_pro_mrr`, `month_12_enterprise_mrr`, `month_13_customers`, `month_13_basic_mrr`, `month_13_pro_mrr`, `month_13_enterprise_mrr`, `month_14_customers`, `month_14_basic_mrr`, `month_14_pro_mrr`, `month_14_enterprise_mrr`, `month_15_customers`, `month_15_basic_mrr`, `month_15_pro_mrr`, `month_15_enterprise_mrr`, `month_16_customers`, `month_16_basic_mrr`, `month_16_pro_mrr`, `month_16_enterprise_mrr`, `month_17_customers`, `month_17_basic_mrr`, `month_17_pro_mrr`, `month_17_enterprise_mrr`, `month_18_customers`, `month_18_basic_mrr`, `month_18_pro_mrr`, `month_18_enterprise_mrr`, `month_19_customers`, `month_19_basic_mrr`, `month_19_pro_mrr`, `month_19_enterprise_mrr`, `month_20_customers`, `month_20_basic_mrr`, `month_20_pro_mrr`, `month_20_enterprise_mrr`, `month_21_customers`, `month_21_basic_mrr`, `month_21_pro_mrr`, `month_21_enterprise_mrr`, `month_22_customers`, `month_22_basic_mrr`, `month_22_pro_mrr`, `month_22_enterprise_mrr`, `month_23_customers`, `month_23_basic_mrr`, `month_23_pro_mrr`, `month_23_enterprise_mrr`, `month_24_customers`, `month_24_basic_mrr`, `month_24_pro_mrr`, `month_24_enterprise_mrr`

## SheetPort Ports (`fio.yaml`)

- **`organic_growth_year1`** (`in`, `scalar`): Decimal fraction/month organic signup growth year 1. Default: 0.12.
- **`basic_churn`** (`in`, `scalar`): Decimal fraction/month Basic customer churn. Default: 0.03.
- **`pro_churn`** (`in`, `scalar`): Decimal fraction/month Pro customer churn. Default: 0.02.
- **`enterprise_mrr_target_year1`** (`in`, `scalar`): USD/month target Enterprise MRR at month 12; sales hiring is driven by this target. Default: 400000.
- **`enterprise_mrr_target_year2`** (`in`, `scalar`): USD/month target Enterprise MRR at month 24; sales hiring is driven by this target. Default: 800000.
- **`marketing_spend_first_month`** (`in`, `scalar`): USD/month positive initial marketing spend. Default: 20000.
- **`marketing_spend_monthly_increase`** (`in`, `scalar`): USD/month incremental marketing spend each month. Default: 10000.
- **`basic_arpa`** (`in`, `scalar`): USD/customer/month starting Basic ARPA. Default: 50.
- **`pro_arpa`** (`in`, `scalar`): USD/customer/month starting Pro ARPA. Default: 250.
- **`infrastructure_fraction`** (`in`, `scalar`): Decimal fraction of MRR spent on server infrastructure; nonnegative expense. Default: 0.07.
- **`payment_fee_fraction`** (`in`, `scalar`): Decimal fraction of cash collections (including annual Enterprise prepayments) spent on payment processing; nonnegative expense. Default: 0.015.
- **`starting_cash`** (`in`, `scalar`): USD opening month-1 bank balance. Default: 500000.
- **`month1_financing`** (`in`, `scalar`): USD positive financing inflow in month 1. Default: 5000000.
- **`revenue_assumption_6`** (`in`, `scalar`): Signups beginning of 1st month:. Nonnegative customer/signup count. Default: 5000.
- **`revenue_assumption_7`** (`in`, `scalar`): New signups in month 0. Nonnegative customer/signup count. Default: 500.
- **`revenue_assumption_8`** (`in`, `scalar`): Organic signups 1st month:. Nonnegative customer/signup count. Default: 500.
- **`revenue_assumption_10`** (`in`, `scalar`): Organic signups growth rate p.m. in year 2. Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.09.
- **`revenue_assumption_11`** (`in`, `scalar`): Costs per signup ($). USD at stated monthly or annual frequency; positive. Default: 200.
- **`revenue_assumption_20`** (`in`, `scalar`): Basic customers beginning of 1st month. Nonnegative customer/signup count. Default: 100.
- **`revenue_assumption_22`** (`in`, `scalar`): Conversion rate (of previous month's signups). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.1.
- **`revenue_assumption_23`** (`in`, `scalar`): Conversion rate (of all older signups). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.0025.
- **`revenue_assumption_33`** (`in`, `scalar`): ARPA increase p.m.. Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.005.
- **`revenue_assumption_34`** (`in`, `scalar`): ARPA in month 0 ($). USD at stated monthly or annual frequency; positive. Default: 50.
- **`revenue_assumption_45`** (`in`, `scalar`): Pro customers beginning of 1st month. Nonnegative customer/signup count. Default: 30.
- **`revenue_assumption_48`** (`in`, `scalar`): Conversion rate (of previous month's signups). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.01.
- **`revenue_assumption_49`** (`in`, `scalar`): Conversion rate (of all older signups). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.001.
- **`revenue_assumption_51`** (`in`, `scalar`): Upgrade rate (Basic => Pro). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.005.
- **`revenue_assumption_53`** (`in`, `scalar`): Downgrade rate (Pro => Basic). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.05.
- **`revenue_assumption_54`** (`in`, `scalar`): Upgrade rate (Pro => Enterprise). Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.005.
- **`revenue_assumption_60`** (`in`, `scalar`): ARPA increase p.m.. Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.005.
- **`revenue_assumption_61`** (`in`, `scalar`): ARPA in month 0 ($). USD at stated monthly or annual frequency; positive. Default: 250.
- **`revenue_assumption_74`** (`in`, `scalar`): Enterprise customers beginning of 1st month. Nonnegative customer/signup count. Default: 30.
- **`revenue_assumption_80`** (`in`, `scalar`): ACV of existing customers ($). USD at stated monthly or annual frequency; positive. Default: 60000.
- **`revenue_assumption_81`** (`in`, `scalar`): ACV of new customers (and upgraders from Pro) ($). USD at stated monthly or annual frequency; positive. Default: 60000.
- **`revenue_assumption_82`** (`in`, `scalar`): ACV increase upon renewal. USD at stated monthly or annual frequency; positive. Default: 0.1.
- **`revenue_assumption_83`** (`in`, `scalar`): Churn rate p.y.. Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.2.
- **`revenue_assumption_96`** (`in`, `scalar`): Pipeline closing rate. Decimal fraction per stated month/year; 0.1 = 10%. Default: 0.3.
- **`cost_e4`** (`in`, `scalar`): SALARIES ($). Decimal fraction, nonnegative. Default: 0.2.
- **`cost_c7`** (`in`, `scalar`): Founder & CEO. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d7`** (`in`, `scalar`): Founder & CEO. USD/year positive base salary. Default: 100000.
- **`cost_e7`** (`in`, `scalar`): Founder & CEO. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c8`** (`in`, `scalar`): CFO. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42552.
- **`cost_d8`** (`in`, `scalar`): CFO. USD/year positive base salary. Default: 150000.
- **`cost_e8`** (`in`, `scalar`): CFO. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c9`** (`in`, `scalar`): Business Analyst. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42856.
- **`cost_d9`** (`in`, `scalar`): Business Analyst. USD/year positive base salary. Default: 70000.
- **`cost_e9`** (`in`, `scalar`): Business Analyst. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c10`** (`in`, `scalar`): Finance Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42675.
- **`cost_d10`** (`in`, `scalar`): Finance Manager. USD/year positive base salary. Default: 55000.
- **`cost_e10`** (`in`, `scalar`): Finance Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c11`** (`in`, `scalar`): Office Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d11`** (`in`, `scalar`): Office Manager. USD/year positive base salary. Default: 40000.
- **`cost_e11`** (`in`, `scalar`): Office Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c12`** (`in`, `scalar`): Team Assistant. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 43040.
- **`cost_d12`** (`in`, `scalar`): Team Assistant. USD/year positive base salary. Default: 40000.
- **`cost_e12`** (`in`, `scalar`): Team Assistant. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c13`** (`in`, `scalar`): Director of Recruiting. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42644.
- **`cost_d13`** (`in`, `scalar`): Director of Recruiting. USD/year positive base salary. Default: 110000.
- **`cost_e13`** (`in`, `scalar`): Director of Recruiting. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c14`** (`in`, `scalar`): Recruiter. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d14`** (`in`, `scalar`): Recruiter. USD/year positive base salary. Default: 60000.
- **`cost_e14`** (`in`, `scalar`): Recruiter. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c15`** (`in`, `scalar`): Recruiter. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42552.
- **`cost_d15`** (`in`, `scalar`): Recruiter. USD/year positive base salary. Default: 60000.
- **`cost_e15`** (`in`, `scalar`): Recruiter. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c21`** (`in`, `scalar`): Founder & CTO. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d21`** (`in`, `scalar`): Founder & CTO. USD/year positive base salary. Default: 100000.
- **`cost_e21`** (`in`, `scalar`): Founder & CTO. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c22`** (`in`, `scalar`): VP Engineering. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42552.
- **`cost_d22`** (`in`, `scalar`): VP Engineering. USD/year positive base salary. Default: 150000.
- **`cost_e22`** (`in`, `scalar`): VP Engineering. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c23`** (`in`, `scalar`): VP Product. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42736.
- **`cost_d23`** (`in`, `scalar`): VP Product. USD/year positive base salary. Default: 150000.
- **`cost_e23`** (`in`, `scalar`): VP Product. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c24`** (`in`, `scalar`): Product Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d24`** (`in`, `scalar`): Product Manager. USD/year positive base salary. Default: 80000.
- **`cost_e24`** (`in`, `scalar`): Product Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c25`** (`in`, `scalar`): Product Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42552.
- **`cost_d25`** (`in`, `scalar`): Product Manager. USD/year positive base salary. Default: 80000.
- **`cost_e25`** (`in`, `scalar`): Product Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c26`** (`in`, `scalar`): Product Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42917.
- **`cost_d26`** (`in`, `scalar`): Product Manager. USD/year positive base salary. Default: 80000.
- **`cost_e26`** (`in`, `scalar`): Product Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c27`** (`in`, `scalar`): Designer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d27`** (`in`, `scalar`): Designer. USD/year positive base salary. Default: 60000.
- **`cost_e27`** (`in`, `scalar`): Designer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c28`** (`in`, `scalar`): Designer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42736.
- **`cost_d28`** (`in`, `scalar`): Designer. USD/year positive base salary. Default: 60000.
- **`cost_e28`** (`in`, `scalar`): Designer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c29`** (`in`, `scalar`): Designer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42887.
- **`cost_d29`** (`in`, `scalar`): Designer. USD/year positive base salary. Default: 60000.
- **`cost_e29`** (`in`, `scalar`): Designer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c30`** (`in`, `scalar`): Sr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d30`** (`in`, `scalar`): Sr. Developer. USD/year positive base salary. Default: 70000.
- **`cost_e30`** (`in`, `scalar`): Sr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c31`** (`in`, `scalar`): Sr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42461.
- **`cost_d31`** (`in`, `scalar`): Sr. Developer. USD/year positive base salary. Default: 70000.
- **`cost_e31`** (`in`, `scalar`): Sr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c32`** (`in`, `scalar`): Sr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42583.
- **`cost_d32`** (`in`, `scalar`): Sr. Developer. USD/year positive base salary. Default: 70000.
- **`cost_e32`** (`in`, `scalar`): Sr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c33`** (`in`, `scalar`): Sr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42826.
- **`cost_d33`** (`in`, `scalar`): Sr. Developer. USD/year positive base salary. Default: 70000.
- **`cost_e33`** (`in`, `scalar`): Sr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c34`** (`in`, `scalar`): Sr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 43040.
- **`cost_d34`** (`in`, `scalar`): Sr. Developer. USD/year positive base salary. Default: 70000.
- **`cost_e34`** (`in`, `scalar`): Sr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c35`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d35`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e35`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c36`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d36`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e36`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c37`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42430.
- **`cost_d37`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e37`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c38`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42491.
- **`cost_d38`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e38`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c39`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42552.
- **`cost_d39`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e39`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c40`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42614.
- **`cost_d40`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e40`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c41`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42675.
- **`cost_d41`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e41`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c42`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42736.
- **`cost_d42`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e42`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c43`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42795.
- **`cost_d43`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e43`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c44`** (`in`, `scalar`): Jr. Developer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42856.
- **`cost_d44`** (`in`, `scalar`): Jr. Developer. USD/year positive base salary. Default: 55000.
- **`cost_e44`** (`in`, `scalar`): Jr. Developer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c45`** (`in`, `scalar`): QA Engineer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42430.
- **`cost_d45`** (`in`, `scalar`): QA Engineer. USD/year positive base salary. Default: 55000.
- **`cost_e45`** (`in`, `scalar`): QA Engineer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c46`** (`in`, `scalar`): QA Engineer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42705.
- **`cost_d46`** (`in`, `scalar`): QA Engineer. USD/year positive base salary. Default: 55000.
- **`cost_e46`** (`in`, `scalar`): QA Engineer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c47`** (`in`, `scalar`): QA Engineer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42887.
- **`cost_d47`** (`in`, `scalar`): QA Engineer. USD/year positive base salary. Default: 55000.
- **`cost_e47`** (`in`, `scalar`): QA Engineer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c48`** (`in`, `scalar`): Devops Engineer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42614.
- **`cost_d48`** (`in`, `scalar`): Devops Engineer. USD/year positive base salary. Default: 70000.
- **`cost_e48`** (`in`, `scalar`): Devops Engineer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c54`** (`in`, `scalar`): VP Marketing. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42491.
- **`cost_d54`** (`in`, `scalar`): VP Marketing. USD/year positive base salary. Default: 150000.
- **`cost_e54`** (`in`, `scalar`): VP Marketing. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c55`** (`in`, `scalar`): Product Marketing Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42767.
- **`cost_d55`** (`in`, `scalar`): Product Marketing Manager. USD/year positive base salary. Default: 80000.
- **`cost_e55`** (`in`, `scalar`): Product Marketing Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c56`** (`in`, `scalar`): Demand Gen Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42401.
- **`cost_d56`** (`in`, `scalar`): Demand Gen Manager. USD/year positive base salary. Default: 70000.
- **`cost_e56`** (`in`, `scalar`): Demand Gen Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c57`** (`in`, `scalar`): Designer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42522.
- **`cost_d57`** (`in`, `scalar`): Designer. USD/year positive base salary. Default: 60000.
- **`cost_e57`** (`in`, `scalar`): Designer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c58`** (`in`, `scalar`): Content Writer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42370.
- **`cost_d58`** (`in`, `scalar`): Content Writer. USD/year positive base salary. Default: 50000.
- **`cost_e58`** (`in`, `scalar`): Content Writer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c59`** (`in`, `scalar`): Content Writer. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42795.
- **`cost_d59`** (`in`, `scalar`): Content Writer. USD/year positive base salary. Default: 50000.
- **`cost_e59`** (`in`, `scalar`): Content Writer. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c60`** (`in`, `scalar`): Video Editor. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42887.
- **`cost_d60`** (`in`, `scalar`): Video Editor. USD/year positive base salary. Default: 50000.
- **`cost_e60`** (`in`, `scalar`): Video Editor. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c61`** (`in`, `scalar`): PR Manager. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 43009.
- **`cost_d61`** (`in`, `scalar`): PR Manager. USD/year positive base salary. Default: 70000.
- **`cost_e61`** (`in`, `scalar`): PR Manager. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c67`** (`in`, `scalar`): VP Sales. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42430.
- **`cost_d67`** (`in`, `scalar`): VP Sales. USD/year positive base salary. Default: 120000.
- **`cost_e67`** (`in`, `scalar`): VP Sales. Decimal fraction of salary paid as bonus. Default: 0.5.
- **`cost_d68`** (`in`, `scalar`): Sales Directors. USD/year positive base salary. Default: 70000.
- **`cost_e68`** (`in`, `scalar`): Sales Directors. Decimal fraction of salary paid as bonus. Default: 1.
- **`cost_d69`** (`in`, `scalar`): Account Executives. USD/year positive base salary. Default: 55000.
- **`cost_e69`** (`in`, `scalar`): Account Executives. Decimal fraction of salary paid as bonus. Default: 1.
- **`cost_d70`** (`in`, `scalar`): SDR Directors. USD/year positive base salary. Default: 60000.
- **`cost_e70`** (`in`, `scalar`): SDR Directors. Decimal fraction of salary paid as bonus. Default: 1.
- **`cost_d71`** (`in`, `scalar`): SDRs. USD/year positive base salary. Default: 35000.
- **`cost_e71`** (`in`, `scalar`): SDRs. Decimal fraction of salary paid as bonus. Default: 1.
- **`cost_c77`** (`in`, `scalar`): VP Customer Success. Excel 1900 date serial hire date; fixed historical month axis starts January 2016. Default: 42614.
- **`cost_d77`** (`in`, `scalar`): VP Customer Success. USD/year positive base salary. Default: 150000.
- **`cost_e77`** (`in`, `scalar`): VP Customer Success. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c78`** (`in`, `scalar`): Customer Success Managers (BASIC & PRO). Customers per employee (or CS managers per director at row 80), positive. Default: 200.
- **`cost_d78`** (`in`, `scalar`): Customer Success Managers (BASIC & PRO). USD/year positive base salary. Default: 40000.
- **`cost_e78`** (`in`, `scalar`): Customer Success Managers (BASIC & PRO). Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c79`** (`in`, `scalar`): Customer Success Manager (ENTERPRISE). Customers per employee (or CS managers per director at row 80), positive. Default: 40.
- **`cost_d79`** (`in`, `scalar`): Customer Success Manager (ENTERPRISE). USD/year positive base salary. Default: 50000.
- **`cost_e79`** (`in`, `scalar`): Customer Success Manager (ENTERPRISE). Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_c80`** (`in`, `scalar`): Customer Success Directors. Customers per employee (or CS managers per director at row 80), positive. Default: 8.
- **`cost_d80`** (`in`, `scalar`): Customer Success Directors. USD/year positive base salary. Default: 70000.
- **`cost_e80`** (`in`, `scalar`): Customer Success Directors. Decimal fraction of salary paid as bonus. Default: 0.2.
- **`cost_e94`** (`in`, `scalar`): G&A staff. USD per stated employee/month or new hire, positive. Default: 2000.
- **`cost_e95`** (`in`, `scalar`): R&D staff. USD per stated employee/month or new hire, positive. Default: 500.
- **`cost_e96`** (`in`, `scalar`): Marketing staff. USD per stated employee/month or new hire, positive. Default: 1000.
- **`cost_e97`** (`in`, `scalar`): Sales staff. USD per stated employee/month or new hire, positive. Default: 1000.
- **`cost_e98`** (`in`, `scalar`): Customer success staff. USD per stated employee/month or new hire, positive. Default: 500.
- **`cost_e102`** (`in`, `scalar`): G&A staff. USD per stated employee/month or new hire, positive. Default: 250.
- **`cost_e103`** (`in`, `scalar`): R&D staff. USD per stated employee/month or new hire, positive. Default: 250.
- **`cost_e104`** (`in`, `scalar`): Marketing staff. USD per stated employee/month or new hire, positive. Default: 250.
- **`cost_e105`** (`in`, `scalar`): Sales staff. USD per stated employee/month or new hire, positive. Default: 250.
- **`cost_e106`** (`in`, `scalar`): Customer success staff. USD per stated employee/month or new hire, positive. Default: 250.
- **`cost_e110`** (`in`, `scalar`): G&A staff. USD per stated employee/month or new hire, positive. Default: 4000.
- **`cost_e111`** (`in`, `scalar`): R&D staff. USD per stated employee/month or new hire, positive. Default: 4000.
- **`cost_e112`** (`in`, `scalar`): Marketing staff. USD per stated employee/month or new hire, positive. Default: 4000.
- **`cost_e113`** (`in`, `scalar`): Sales staff. USD per stated employee/month or new hire, positive. Default: 4000.
- **`cost_e114`** (`in`, `scalar`): Customer success staff. USD per stated employee/month or new hire, positive. Default: 4000.
- **`cost_d123`** (`in`, `scalar`): Office rent. USD per stated employee/month or new hire, positive. Default: 15000.
- **`cost_e123`** (`in`, `scalar`): Office rent. USD per stated employee/month or new hire, positive. Default: 30000.
- **`cost_e124`** (`in`, `scalar`): External recruiters. USD per stated employee/month or new hire, positive. Default: 15000.
- **`cost_d125`** (`in`, `scalar`): Service providers (lawyers, accountants, ...). USD per stated employee/month or new hire, positive. Default: 10000.
- **`cost_e125`** (`in`, `scalar`): Service providers (lawyers, accountants, ...). USD per stated employee/month or new hire, positive. Default: 15000.
- **`cost_e126`** (`in`, `scalar`): Other costs. Decimal fraction, nonnegative. Default: 0.05.
- **`sales_d6`** (`in`, `scalar`): New ARR per AE p.m.. USD new ARR per AE/month quota; positive. Default: 40000.
- **`sales_d7`** (`in`, `scalar`): Month 1:. Decimal quota ramp fraction. Source month 4+ factor D10 is retained although source formulas use full quota after ramp. Default: 0.25.
- **`sales_d8`** (`in`, `scalar`): Month 2:. Decimal quota ramp fraction. Source month 4+ factor D10 is retained although source formulas use full quota after ramp. Default: 0.5.
- **`sales_d9`** (`in`, `scalar`): Month 3:. Decimal quota ramp fraction. Source month 4+ factor D10 is retained although source formulas use full quota after ramp. Default: 0.75.
- **`sales_d10`** (`in`, `scalar`): Month 4+:. Decimal quota ramp fraction. Source month 4+ factor D10 is retained although source formulas use full quota after ramp. Default: 1.
- **`financing_month_2`** (`in`, `scalar`): USD positive financing inflow in month 2. Default: 0.
- **`financing_month_3`** (`in`, `scalar`): USD positive financing inflow in month 3. Default: 0.
- **`financing_month_4`** (`in`, `scalar`): USD positive financing inflow in month 4. Default: 0.
- **`financing_month_5`** (`in`, `scalar`): USD positive financing inflow in month 5. Default: 0.
- **`financing_month_6`** (`in`, `scalar`): USD positive financing inflow in month 6. Default: 0.
- **`financing_month_7`** (`in`, `scalar`): USD positive financing inflow in month 7. Default: 0.
- **`financing_month_8`** (`in`, `scalar`): USD positive financing inflow in month 8. Default: 0.
- **`financing_month_9`** (`in`, `scalar`): USD positive financing inflow in month 9. Default: 0.
- **`financing_month_10`** (`in`, `scalar`): USD positive financing inflow in month 10. Default: 0.
- **`financing_month_11`** (`in`, `scalar`): USD positive financing inflow in month 11. Default: 0.
- **`financing_month_12`** (`in`, `scalar`): USD positive financing inflow in month 12. Default: 0.
- **`financing_month_13`** (`in`, `scalar`): USD positive financing inflow in month 13. Default: 0.
- **`financing_month_14`** (`in`, `scalar`): USD positive financing inflow in month 14. Default: 0.
- **`financing_month_15`** (`in`, `scalar`): USD positive financing inflow in month 15. Default: 0.
- **`financing_month_16`** (`in`, `scalar`): USD positive financing inflow in month 16. Default: 0.
- **`financing_month_17`** (`in`, `scalar`): USD positive financing inflow in month 17. Default: 0.
- **`financing_month_18`** (`in`, `scalar`): USD positive financing inflow in month 18. Default: 0.
- **`financing_month_19`** (`in`, `scalar`): USD positive financing inflow in month 19. Default: 0.
- **`financing_month_20`** (`in`, `scalar`): USD positive financing inflow in month 20. Default: 0.
- **`financing_month_21`** (`in`, `scalar`): USD positive financing inflow in month 21. Default: 0.
- **`financing_month_22`** (`in`, `scalar`): USD positive financing inflow in month 22. Default: 0.
- **`financing_month_23`** (`in`, `scalar`): USD positive financing inflow in month 23. Default: 0.
- **`financing_month_24`** (`in`, `scalar`): USD positive financing inflow in month 24. Default: 0.
- **`arr_month12`** (`out`, `scalar`): USD/year ARR = 12 times month-12 MRR, not annual recognized revenue.
- **`arr_month24`** (`out`, `scalar`): USD/year ARR = 12 times month-24 MRR, not annual recognized revenue.
- **`cash_month12`** (`out`, `scalar`): USD ending bank balance month 12; negative indicates funding deficit.
- **`cash_month24`** (`out`, `scalar`): USD ending bank balance month 24; negative indicates funding deficit.
- **`operating_cashflow_month12`** (`out`, `scalar`): USD/month signed operating cash flow month 12; negative means cash burn.
- **`operating_cashflow_month24`** (`out`, `scalar`): USD/month signed operating cash flow month 24; negative means cash burn.
- **`month_1_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_1_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_1_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_1_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_2_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_2_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_2_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_2_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_3_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_3_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_3_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_3_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_4_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_4_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_4_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_4_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_5_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_5_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_5_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_5_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_6_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_6_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_6_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_6_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_7_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_7_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_7_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_7_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_8_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_8_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_8_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_8_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_9_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_9_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_9_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_9_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_10_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_10_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_10_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_10_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_11_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_11_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_11_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_11_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_12_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_12_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_12_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_12_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_13_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_13_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_13_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_13_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_14_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_14_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_14_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_14_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_15_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_15_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_15_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_15_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_16_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_16_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_16_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_16_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_17_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_17_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_17_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_17_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_18_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_18_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_18_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_18_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_19_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_19_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_19_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_19_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_20_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_20_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_20_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_20_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_21_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_21_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_21_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_21_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_22_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_22_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_22_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_22_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_23_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_23_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_23_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_23_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_24_mrr`** (`out`, `scalar`): USD/month recognized subscription revenue.
- **`month_24_ebit`** (`out`, `scalar`): USD/month signed operating profit.
- **`month_24_operating_cashflow`** (`out`, `scalar`): USD/month signed operating cash flow.
- **`month_24_cash`** (`out`, `scalar`): USD signed ending bank balance.
- **`month_1_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_1_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_1_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_1_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_2_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_2_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_2_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_2_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_3_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_3_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_3_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_3_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_4_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_4_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_4_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_4_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_5_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_5_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_5_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_5_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_6_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_6_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_6_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_6_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_7_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_7_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_7_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_7_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_8_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_8_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_8_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_8_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_9_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_9_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_9_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_9_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_10_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_10_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_10_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_10_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_11_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_11_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_11_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_11_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_12_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_12_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_12_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_12_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_13_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_13_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_13_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_13_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_14_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_14_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_14_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_14_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_15_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_15_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_15_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_15_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_16_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_16_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_16_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_16_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_17_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_17_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_17_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_17_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_18_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_18_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_18_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_18_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_19_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_19_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_19_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_19_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_20_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_20_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_20_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_20_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_21_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_21_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_21_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_21_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_22_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_22_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_22_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_22_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_23_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_23_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_23_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_23_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.
- **`month_24_customers`** (`out`, `scalar`): Customer count; fractional expected customers allowed.
- **`month_24_basic_mrr`** (`out`, `scalar`): USD/month Basic MRR.
- **`month_24_pro_mrr`** (`out`, `scalar`): USD/month Pro MRR.
- **`month_24_enterprise_mrr`** (`out`, `scalar`): USD/month Enterprise MRR.

## Editorial & Version Notes

Historical SaaS Financial Plan 2.0 from the 2016 publisher article; not a current benchmark or financial forecast. Fixed 24-month historical axis starts January 2016; hire dates are Excel 1900 serials. Fractional customer and headcount expectations follow the original workbook. Enterprise revenue is target driven: the model derives new enterprise customers and required sales hiring from MRR targets; it is not a pipeline-constrained sales simulation. ARR is annualized end-month MRR, not yearly recognized revenue. Signed cash flow is negative for burn; bank balances may be negative. Full flow maps every numeric assumption block, employee date/salary/bonus and monthly financing entry; source labels and lookup/chart data remain pinned. Publisher redistribution permission has not been established; reference-only provenance does not establish redistribution permission.

---

# Kansas State 2026 Crop Budgets and Flexible Leases (2026)

> Compare Kansas publisher crop budgets, cash/share returns and a deterministic price-flex lease scenario. Monte Carlo distributions and simulation summaries are excluded.

- **Model ID**: `ksu-crop-budgets-leasing@2026` (Package `1.0.0`)
- **Publisher**: [Kansas State University Department of Agricultural Economics (AgManager.info)](https://agmanager.info/farm-budgets/2026-farm-management-guides-non-irrigated-crops)
- **Source Workbook**: `ksu-crop-budgets-2026.xlsm` (`sha256:c0188129aa907b891d4a4bb9ae3eed1cbf996dee322bddf8680ac9f8a741661d`)
- **Cadence**: annual | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic. Legacy Table1 current-row references are rewritten to the identical current-row column A coordinate at runtime; inactive second-crop display blanks are normalized with N().
- **Workbook Download**: `catalog-bytes`; source: https://agmanager.info/sites/default/files/wysiwyg/Crop%20budgets%20and%20leasing%2010-26.xlsm; upstreamArtifact: null; catalog file size: 391788 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_crop_lease_return`

## Flows

### `quick_crop_lease_return` — Quick crop lease return (single)
Compare Kansas publisher crop budgets, cash/share returns and a deterministic price-flex lease scenario. Monte Carlo distributions and simulation summaries are excluded.
- **Inputs**: `crop_1`, `crop_1_acres`, `yield_1`, `price_1`, `cash_rent`, `operating_interest_rate`, `tenant_share`, `seed_cost_1`, `fertilizer_cost_1`, `lease_base_rent`, `lease_base_price`, `lease_actual_price`
- **Outputs**: `crop_1_revenue`, `crop_1_direct_cost`, `crop_1_total_cost`, `crop_1_net_return`, `crop_1_breakeven_price`, `price_flex_rent`

### `full_crop_budget_comparison` — Full crop budget comparison (single)
Compare Kansas publisher crop budgets, cash/share returns and a deterministic price-flex lease scenario. Monte Carlo distributions and simulation summaries are excluded.
- **Inputs**: `crop_1`, `crop_1_acres`, `yield_1`, `price_1`, `cash_rent`, `operating_interest_rate`, `tenant_share`, `seed_cost_1`, `fertilizer_cost_1`, `lease_base_rent`, `lease_base_price`, `lease_actual_price`, `lease_allow_downward_price`, `crop_2`, `crop_2_acres`, `yield_2`, `price_2`, `fallow_acres`
- **Outputs**: `crop_1_revenue`, `crop_1_direct_cost`, `crop_1_total_cost`, `crop_1_net_return`, `crop_1_breakeven_price`, `price_flex_rent`, `farm_cash_net_return`, `share_tenant_net_return`, `share_landlord_net_return`, `crop_2_revenue`, `crop_2_net_return`

## SheetPort Ports (`fio.yaml`)

- **`crop_1`** (`in`, `scalar`): Exact publisher budget name; trailing underscore is significant Default: Corn - North Central KS_.
- **`crop_1_acres`** (`in`, `scalar`): Planted acres, positive acreage required Default: 1.
- **`yield_1`** (`in`, `scalar`): Yield override in crop units per acre (corn: bushels/acre); null retains publisher budget Default: None.
- **`price_1`** (`in`, `scalar`): Selling price override in USD per crop unit; null retains budget Default: None.
- **`cash_rent`** (`in`, `scalar`): USD per acre cash rent Default: 70.
- **`operating_interest_rate`** (`in`, `scalar`): Annual decimal fraction applied to half direct costs Default: 0.076.
- **`tenant_share`** (`in`, `scalar`): Tenant crop share decimal fraction Default: 0.66.
- **`seed_cost_1`** (`in`, `scalar`): Seed expense override USD/acre; null retains budget Default: None.
- **`fertilizer_cost_1`** (`in`, `scalar`): Fertilizer expense override USD/acre; null retains budget Default: None.
- **`lease_base_rent`** (`in`, `scalar`): USD/acre base rent for price-flex contract Default: 70.
- **`lease_base_price`** (`in`, `scalar`): USD/unit base price, must be positive Default: 5.5.
- **`lease_actual_price`** (`in`, `scalar`): USD/unit actual scenario price; deterministic single draw replaces Monte Carlo Default: 3.
- **`lease_allow_downward_price`** (`in`, `scalar`): Exact y/n allowing price-flex rent below base Default: n.
- **`crop_2`** (`in`, `scalar`): Exact second publisher budget name or None Default: None.
- **`crop_2_acres`** (`in`, `scalar`): Planted acres for second crop; blank source treated as zero Default: None.
- **`yield_2`** (`in`, `scalar`): Second crop yield override in crop units/acre; null retains budget Default: None.
- **`price_2`** (`in`, `scalar`): Second crop price override USD/crop unit; null retains budget Default: None.
- **`fallow_acres`** (`in`, `scalar`): Fallow acres included in tillable denominator Default: 0.
- **`crop_1_revenue`** (`out`, `scalar`): Gross crop revenue USD/planted acre
- **`crop_1_direct_cost`** (`out`, `scalar`): Direct expenses including interest USD/planted acre
- **`crop_1_total_cost`** (`out`, `scalar`): Total specified costs USD/planted acre
- **`crop_1_net_return`** (`out`, `scalar`): Signed return above specified costs USD/planted acre
- **`crop_1_breakeven_price`** (`out`, `scalar`): Breakeven USD/crop unit
- **`price_flex_rent`** (`out`, `scalar`): Price-flex landlord rent USD/tillable acre for supplied deterministic actual price
- **`farm_cash_net_return`** (`out`, `scalar`): Cash-lease tenant signed return USD/tillable acre
- **`share_tenant_net_return`** (`out`, `scalar`): Share-lease tenant signed return USD/tillable acre
- **`share_landlord_net_return`** (`out`, `scalar`): Share-lease landlord signed return USD/tillable acre
- **`crop_2_revenue`** (`out`, `scalar`): Second crop gross revenue USD/planted acre; zero when inactive
- **`crop_2_net_return`** (`out`, `scalar`): Second crop signed net return USD/planted acre; zero when inactive

## Editorial & Version Notes

Compare Kansas publisher crop budgets, cash/share returns and a deterministic price-flex lease scenario. Monte Carlo distributions and simulation summaries are excluded. License class identifies academic provenance, not an independently confirmed redistribution license. Full flow maps the documented deterministic decision surface; Monte Carlo and solver sensitivity grids are excluded. Legacy Table1 current-row references are rewritten to the identical current-row column A coordinate at runtime; inactive second-crop output display blanks are normalized with N(). The source caches are stale: default corn price is now 4.72 rather than cached 4.57, and operating interest is 7.6% rather than cached 6.5%. Full mapping supports two crop slots; remaining slots and granular expense overrides are available only through cellOverrides. Historical stochastic simulation summaries are not recalculated.

---

# Kentucky Withholding Tax Calculator 2026 (2026)

> Calculate Kentucky 2026 employer withholding from taxable wages and exact pay-frequency selections using the publisher's workbook.

- **Model ID**: `ky-withholding-tax@2026` (Package `2026.1.0`)
- **Publisher**: [Kentucky Department of Revenue](https://revenue.ky.gov/Business/Pages/Employer-Payroll-Withholding.aspx)
- **Source Workbook**: `ky-withholding-2026.xlsx` (`sha256:a4a7d6bd5813c12e576ee498c3584e3c14198846ae83209fdab6b1656191fada`)
- **Cadence**: annual | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://revenue.ky.gov/Business/Documents/2026%20Withholding%20Tax%20Calculator.xlsx; upstreamArtifact: null; catalog file size: 115509 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_withholding`

## Flows

### `quick_withholding` — Quick Kentucky withholding (single)
The single-employee calculation has two inputs. Omitted inputs retain the source blank cells. Returns unrounded per-period tax. The mixed string/number Hidden Table!H7 pre-floor diagnostic is available through selectCells.
- **Inputs**: `pay_frequency`, `taxable_wages`
- **Outputs**: `withholding`

### `full_payroll` — Full Kentucky payroll schedule (single)
All 1994 source payroll rows can be populated through three column schedules. Scalar outputs trace the first, second and last employees; use selectCells for any other Calculation of Withholding!D row and an explicit trace coordinate for its lineage. Do not combine scalar row-7 inputs with overlapping schedule inputs.
- **Inputs**: `pay_frequency`, `taxable_wages`, `employee_names`, `frequency_schedule`, `wages_schedule`
- **Outputs**: `withholding`, `second_employee_withholding`, `last_employee_withholding`

## SheetPort Ports (`fio.yaml`)

- **`pay_frequency`** (`in`, `scalar`): Exact source enum: Monthly (12), Semi Monthly (24), Weekly (52), BI-Weekly (26), Daily (365), Annual (1). Source default blank/null; required with positive wages. No mode switch.
- **`taxable_wages`** (`in`, `scalar`): Nonnegative USD taxable wages for one pay period; source default blank/null treated as zero. Supply taxable wages after applicable payroll exclusions, not annual gross wages.
- **`employee_names`** (`in`, `range`): Optional 1994×1 employee labels; source blank. Labels have no tax effect. Row index 0 corresponds to Excel row 7.
- **`frequency_schedule`** (`in`, `range`): 1994×1 exact frequency strings or null, rows 7–2000. Allowed nonblank values: Monthly, Semi Monthly, Weekly, BI-Weekly, Daily, Annual. Source cells blank. Positive wages require a frequency in the same row. Do not also set overlapping scalar pay_frequency in the same request.
- **`wages_schedule`** (`in`, `range`): 1994×1 nonnegative USD per-period taxable wages or null, rows 7–2000; source blank. Do not also set overlapping scalar taxable_wages in the same request.
- **`withholding`** (`out`, `scalar`): Nonnegative USD withholding for row 7, unrounded source formula (display formats show cents). Runtime N(originalFormula) converts source display blanks to zero.
- **`second_employee_withholding`** (`out`, `scalar`): Nonnegative USD withholding for source row 8; full-flow diagnostic.
- **`last_employee_withholding`** (`out`, `scalar`): Nonnegative USD withholding for source row 2000; full-flow boundary diagnostic.

## Editorial & Version Notes

The workbook title identifies 2026. The source has no cached formula values for any of its 3988 formulas, so baseline Excel-cache parity cannot be claimed; independent arithmetic covers all six frequency factors, low wages, thresholds and final-row behavior.

The runtime adapter wraps only D7, D8 and D2000 in N(originalFormula), converting source empty-string display blanks to numeric zero at mapped outputs. Positive-wage numeric results are unchanged. Original XLSX bytes remain intact and traces expose N(). Other rows selected through selectCells retain source blank strings.

The workbook applies 3.5% to annualized taxable wages less $3,360, divides by frequency and floors negative withholding to zero. It does not round formulas to cents; retain returned precision or apply payroll-system rounding separately.

Exact lookup strings are Monthly, Semi Monthly, Weekly, BI-Weekly, Daily and Annual. Positive wages with blank or invalid frequency produce a source lookup error. Quick-flow enum enforces spelling; schedule enum conventions are documented and must be followed by callers.

Quick flow deliberately has two inputs and one output because that is the complete single-employee calculation. There are no filing-status, allowances or additional-withholding inputs in the publisher's source.

Full flow maps all 1994 source rows as 1994×1 column arrays. Source blank cells remain blank if omitted. Avoid overlapping scalar and schedule writes in the same request. Presentation headings and hidden lookup constants are not editable ports.

Full-flow mapped outputs are first, second and last employee diagnostics. For other employees request Calculation of Withholding!D<row> through selectCells and trace that cell explicitly. The runtime trace collector does not automatically expand range outputs, so outputs use scalar coordinates.

This is a version-pinned workbook mapping, not payroll advice or a Kentucky Department of Revenue endorsement. No live check of the publisher's latest release was performed.

---

# LBNL Electrical Power Chain Tool (v2.5)

> LBNL Electrical Power Chain Tool with version-pinned publisher workbook calculations, scenario inputs and formula-level audit traces.

- **Model ID**: `lbnl-power-chain@v2.5` (Package `2.5.0`)
- **Publisher**: [Lawrence Berkeley National Laboratory (LBNL — Center of Expertise for Energy Efficiency in Data Centers)](https://datacenters.lbl.gov/resources/electrical-power-chain-tool)
- **Source Workbook**: `lbnl-power-chain-v2-5.xlsx` (`sha256:33a5f97e931ea540ef4bf6c09bf0cdc13cde0c93b5199d4ed23e15eae9c1b596`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://datacenters.lbl.gov/sites/default/files/2023-07/Electrical%20Power%20Chain%20Tool%20v2.5%207-13-2023.xlsx; upstreamArtifact: null; catalog file size: 176422 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_power_chain_savings`

## Flows

### `quick_power_chain_savings` — Quick UPS and lighting savings (single)
UPS and occupancy-lighting retrofit; retains baseline active UPS, transformer/PDU measurements, Custom emissions selector and other diagnostic answers. Explicit action switches and caps control savings; costs must be reset when cancelling actions.
- **Inputs**: `ups_input_kw`, `ups_output_kw`, `it_equipment_kw`, `lighting_kw`, `electricity_cents_per_kwh`, `new_ups_load_factor`, `pursue_action_21`, `pursue_action_22`, `pursue_action_37`, `implementation_cost_18`, `implementation_cost_33`, `ups_savings_cap`, `lighting_savings_cap`, `custom_emissions_lb_per_kwh`, `transmission_loss_percent`
- **Outputs**: `annual_energy_savings_kwh`, `annual_cost_savings_usd`, `post_energy_kwh`, `implementation_cost_usd`, `simple_payback_years`, `annual_co2_savings_lb`

### `full_power_chain_assessment` — Full electrical power-chain assessment (single)
All numeric measurements, diagnostic source enums, pursuit switches, cost groups, savings caps and emissions list-box selection. Static reference tables stay source-pinned; selectCells/cellOverrides can inspect or override them.
- **Inputs**: `transformer_input_kw`, `transformer_output_kw`, `transformer_capacity_kw`, `ups_input_kw`, `ups_output_kw`, `ups_capacity_kw`, `ups_claimed_efficiency`, `pdu_input_kw`, `pdu_output_kw`, `pdu_capacity_kw`, `generator_heater_kw`, `floor_area_sqft`, `it_equipment_kw`, `lighting_kw`, `electricity_cents_per_kwh`, `building_power_factor`, `building_thd`, `phase_balance`, `transformer_type`, `active_ups`, `ups_eco_mode`, `ups_old_capacitors`, `noncritical_power_source`, `pdu_transformer_type`, `pdu_load_factor`, `it_power_factor`, `rack_power_source`, `heater_power_source`, `heater_thermostat`, `lighting_design`, `lighting_control`, `lamp_type`, `pursue_action_16`, `pursue_action_17`, `pursue_action_18`, `pursue_action_19`, `pursue_action_20`, `pursue_action_21`, `pursue_action_22`, `pursue_action_23`, `pursue_action_24`, `pursue_action_25`, `pursue_action_26`, `pursue_action_27`, `pursue_action_28`, `pursue_action_29`, `pursue_action_30`, `pursue_action_31`, `pursue_action_32`, `pursue_action_33`, `pursue_action_34`, `pursue_action_35`, `pursue_action_36`, `pursue_action_37`, `pursue_action_38`, `pursue_action_39`, `pursue_action_40`, `new_ups_load_factor`, `new_pdu_load_factor`, `implementation_cost_14`, `implementation_cost_15`, `implementation_cost_16`, `implementation_cost_17`, `implementation_cost_18`, `implementation_cost_22`, `implementation_cost_23`, `implementation_cost_24`, `implementation_cost_25`, `implementation_cost_26`, `implementation_cost_27`, `implementation_cost_28`, `implementation_cost_29`, `implementation_cost_30`, `implementation_cost_31`, `implementation_cost_33`, `implementation_cost_36`, `ups_savings_cap`, `lighting_savings_cap`, `emissions_region_index`, `custom_emissions_lb_per_kwh`, `transmission_loss_percent`
- **Outputs**: `annual_energy_kwh`, `annual_energy_savings_kwh`, `annual_cost_savings_usd`, `post_energy_kwh`, `implementation_cost_usd`, `simple_payback_years`, `annual_co2_savings_lb`, `effective_emissions_lb_per_kwh`, `it_systems_savings_kwh`, `lighting_savings_kwh`, `power_chain_loss_kw`, `transformer_efficiency`, `ups_efficiency`, `pdu_efficiency`, `ups_load_factor`, `current_pdu_load_factor`, `annual_power_chain_loss_kwh`

## SheetPort Ports (`fio.yaml`)

- **`transformer_input_kw`** (`in`, `scalar`): What is the annual average input power of the main IT transformer in kW? Units: kW. Omitted input retains publisher's source default 650.
- **`transformer_output_kw`** (`in`, `scalar`): What is the annual average output power of the main IT transformer in kW? Units: kW. Omitted input retains publisher's source default 620.
- **`transformer_capacity_kw`** (`in`, `scalar`): What is the nominal load capacity of the main IT transformer in kW? Units: kW. Omitted input retains publisher's source default 850.
- **`ups_input_kw`** (`in`, `scalar`): What is the annual average input power of the UPS system in kW? Zero activates claimed-efficiency fallback; savings formulas still use measured input minus output, so supply measured input for retrofit analysis. Units: kW. Omitted input retains publisher's source default 580.
- **`ups_output_kw`** (`in`, `scalar`): What is the annual average output power of the UPS system in kW? Units: kW. Omitted input retains publisher's source default 500.
- **`ups_capacity_kw`** (`in`, `scalar`): What is the total load capacity of all active UPS modules in kW? Units: kW. Omitted input retains publisher's source default 750.
- **`ups_claimed_efficiency`** (`in`, `scalar`): What is the UPS manufacturer's claimed efficiency at the calculated load factor shown at right? Used only when ups_input_kw is zero. Units: decimal fraction 0..1. Omitted input retains publisher's source default 0.
- **`pdu_input_kw`** (`in`, `scalar`): What is the annual average total PDU input power in kW? Units: kW. Omitted input retains publisher's source default 525.
- **`pdu_output_kw`** (`in`, `scalar`): What is the annual average total PDU output power in kW? Units: kW. Omitted input retains publisher's source default 500.
- **`pdu_capacity_kw`** (`in`, `scalar`): What is the total load capacity of all active PDUs in kW? Units: kW. Omitted input retains publisher's source default 600.
- **`generator_heater_kw`** (`in`, `scalar`): What is the annual average backup generator engine block heater power demand in kW? Units: kW. Omitted input retains publisher's source default 10.
- **`floor_area_sqft`** (`in`, `scalar`): What is the data center floor area in sq. ft.? Units: ft². Omitted input retains publisher's source default 10000.
- **`it_equipment_kw`** (`in`, `scalar`): What is the annual average IT equipment power demand in kW? Units: kW. Omitted input retains publisher's source default 515.
- **`lighting_kw`** (`in`, `scalar`): What is the annual average lighting power demand in kW for the data center? Units: kW. Omitted input retains publisher's source default 20.
- **`electricity_cents_per_kwh`** (`in`, `scalar`): What is the annual average unit cost of electricity in ¢/kWh? Units: cents/kWh. Omitted input retains publisher's source default 15.
- **`building_power_factor`** (`in`, `scalar`): What is the building power factor?  Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`building_thd`** (`in`, `scalar`): What is the building total harmonic current distortion (THD) at main feeder panel? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`phase_balance`** (`in`, `scalar`): Are the loads balanced between all phases for the transformers, UPSs, and PDUs? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`transformer_type`** (`in`, `scalar`): What is the age and type of the main transformer serving the IT power chain? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`active_ups`** (`in`, `scalar`): Is there an active UPS? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Yes.".
- **`ups_eco_mode`** (`in`, `scalar`): Is the UPS operating in eco-mode? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`ups_old_capacitors`** (`in`, `scalar`): Are the UPS DC capacitors >5 years old? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`noncritical_power_source`** (`in`, `scalar`): What is the power source for non-critical loads? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`pdu_transformer_type`** (`in`, `scalar`): What is the age and type of the transformers in the PDUs? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`pdu_load_factor`** (`in`, `scalar`): What is the average load factor for the active PDUs that contain transformers? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`it_power_factor`** (`in`, `scalar`): What is the IT equipment power factor? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`rack_power_source`** (`in`, `scalar`): What is the power source for the IT racks? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`heater_power_source`** (`in`, `scalar`): What is the power source for the emergency generator block heater(s)? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`heater_thermostat`** (`in`, `scalar`): Does the block heater(s)/heater water jacket for emergency generator(s) operate with thermostat control? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`lighting_design`** (`in`, `scalar`): Is the data center lighting well-designed? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`lighting_control`** (`in`, `scalar`): How are the lights controlled in the data center? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "No control (always on).".
- **`lamp_type`** (`in`, `scalar`): What type of lamps are installed in the data center? Exact source option including punctuation; recommended actions require corresponding pursue_* selection. Units: source enum. Omitted input retains publisher's source default "Do not know.".
- **`pursue_action_16`** (`in`, `scalar`): Pursue displayed action at row 16; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_17`** (`in`, `scalar`): Pursue displayed action at row 17; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_18`** (`in`, `scalar`): Pursue displayed action at row 18; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_19`** (`in`, `scalar`): Pursue displayed action at row 19; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_20`** (`in`, `scalar`): Pursue displayed action at row 20; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "No".
- **`pursue_action_21`** (`in`, `scalar`): Pursue displayed action at row 21; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "Yes".
- **`pursue_action_22`** (`in`, `scalar`): Pursue displayed action at row 22; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "Yes".
- **`pursue_action_23`** (`in`, `scalar`): Pursue displayed action at row 23; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "No".
- **`pursue_action_24`** (`in`, `scalar`): Pursue displayed action at row 24; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_25`** (`in`, `scalar`): Pursue displayed action at row 25; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_26`** (`in`, `scalar`): Pursue displayed action at row 26; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_27`** (`in`, `scalar`): Pursue displayed action at row 27; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_28`** (`in`, `scalar`): Pursue displayed action at row 28; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_29`** (`in`, `scalar`): Pursue displayed action at row 29; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_30`** (`in`, `scalar`): Pursue displayed action at row 30; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_31`** (`in`, `scalar`): Pursue displayed action at row 31; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_32`** (`in`, `scalar`): Pursue displayed action at row 32; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_33`** (`in`, `scalar`): Pursue displayed action at row 33; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_34`** (`in`, `scalar`): Pursue displayed action at row 34; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_35`** (`in`, `scalar`): Pursue displayed action at row 35; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "No".
- **`pursue_action_36`** (`in`, `scalar`): Pursue displayed action at row 36; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "No".
- **`pursue_action_37`** (`in`, `scalar`): Pursue displayed action at row 37; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "Yes".
- **`pursue_action_38`** (`in`, `scalar`): Pursue displayed action at row 38; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_39`** (`in`, `scalar`): Pursue displayed action at row 39; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`pursue_action_40`** (`in`, `scalar`): Pursue displayed action at row 40; requires a compatible question response. Yes selects it, No declines it, N/A means unavailable. Rows 21/22 are modular/right-size UPS; 37 is occupancy lighting. Units: source enum. Omitted input retains publisher's source default "N/A".
- **`new_ups_load_factor`** (`in`, `scalar`): Post-retrofit UPS load fraction. Active if any UPS row 20–23 action is pursued; exact tenth-step lookup, no interpolation. Units: decimal fraction. Omitted input retains publisher's source default 0.8.
- **`new_pdu_load_factor`** (`in`, `scalar`): Post-action PDU loading; active with PDU rightsizing action. Units: source enum. Omitted input retains publisher's source default ">50%".
- **`implementation_cost_14`** (`in`, `scalar`): Estimated cost for action group row 14. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_15`** (`in`, `scalar`): Estimated cost for action group row 15. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_16`** (`in`, `scalar`): Estimated cost for action group row 16. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_17`** (`in`, `scalar`): Estimated cost for action group row 17. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_18`** (`in`, `scalar`): Estimated cost for action group row 18. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 300000.
- **`implementation_cost_22`** (`in`, `scalar`): Estimated cost for action group row 22. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_23`** (`in`, `scalar`): Estimated cost for action group row 23. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_24`** (`in`, `scalar`): Estimated cost for action group row 24. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_25`** (`in`, `scalar`): Estimated cost for action group row 25. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_26`** (`in`, `scalar`): Estimated cost for action group row 26. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_27`** (`in`, `scalar`): Estimated cost for action group row 27. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_28`** (`in`, `scalar`): Estimated cost for action group row 28. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_29`** (`in`, `scalar`): Estimated cost for action group row 29. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_30`** (`in`, `scalar`): Estimated cost for action group row 30. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_31`** (`in`, `scalar`): Estimated cost for action group row 31. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`implementation_cost_33`** (`in`, `scalar`): Estimated cost for action group row 33. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 15000.
- **`implementation_cost_36`** (`in`, `scalar`): Estimated cost for action group row 36. Cost is counted by source even if pursuit is disabled; set cost to zero when cancelling an action. Rows 18 and 33 are UPS and lighting-control projects. Units: USD. Omitted input retains publisher's source default 0.
- **`ups_savings_cap`** (`in`, `scalar`): Maximum combined savings fraction of UPS losses; source omits interactive effects. Units: decimal fraction 0..1. Omitted input retains publisher's source default 0.8.
- **`lighting_savings_cap`** (`in`, `scalar`): Maximum combined savings fraction of lighting consumption. Units: decimal fraction 0..1. Omitted input retains publisher's source default 0.8.
- **`emissions_region_index`** (`in`, `scalar`): Source list-box linked row: 1=Custom, 2..51 follows P11:P60 state abbreviations. The visible F20 text is not the formula selector. State map: 1=Custom, 2=AL, 3=AK, 4=AZ, 5=AR, 6=CA, 7=CO, 8=CT, 9=DE, 10=FL, 11=GA, 12=HI, 13=ID, 14=IL, 15=IN, 16=IA, 17=KS, 18=KY, 19=LA, 20=ME, 21=MD, 22=MA, 23=MI, 24=MN, 25=MS, 26=MO, 27=MT, 28=NE, 29=NV, 30=NH, 31=NJ, 32=NM, 33=NY, 34=NC, 35=ND, 36=OH, 37=OK, 38=OR, 39=PA, 40=RI, 41=SC, 42=SD, 43=TN, 44=TX, 45=UT, 46=VT, 47=VA, 48=WA, 49=WV, 50=WI, 51=WY Units: integer lookup index. Omitted input retains publisher's source default 1.
- **`custom_emissions_lb_per_kwh`** (`in`, `scalar`): Plant emission rate, active only for emissions_region_index=1 (Custom). Units: lb CO2/kWh. Omitted input retains publisher's source default 1.1.
- **`transmission_loss_percent`** (`in`, `scalar`): Transmission and distribution loss percentage; rate is divided by 1-loss/100. Units: percent points 0..10. Omitted input retains publisher's source default 5.
- **`annual_energy_kwh`** (`out`, `scalar`): Baseline total annual electricity use Units: kWh/year. Positive unless stated otherwise.
- **`annual_energy_savings_kwh`** (`out`, `scalar`): Annual avoided electricity; excludes cooling and interactive effects Units: kWh/year. Positive unless stated otherwise.
- **`annual_cost_savings_usd`** (`out`, `scalar`): Annual avoided electricity cost Units: USD/year. Positive unless stated otherwise.
- **`post_energy_kwh`** (`out`, `scalar`): Annual electricity after selected actions Units: kWh/year. Positive unless stated otherwise.
- **`implementation_cost_usd`** (`out`, `scalar`): Total implementation cost Units: USD. Positive unless stated otherwise.
- **`simple_payback_years`** (`out`, `scalar`): Implementation cost divided by savings, source returns N/A for zero savings Units: years. Positive unless stated otherwise.
- **`annual_co2_savings_lb`** (`out`, `scalar`): Annual avoided CO2 with transmission-adjusted plant factor Units: lb CO2/year. Positive unless stated otherwise.
- **`effective_emissions_lb_per_kwh`** (`out`, `scalar`): Transmission-adjusted emissions rate Units: lb CO2/kWh. Positive unless stated otherwise.
- **`it_systems_savings_kwh`** (`out`, `scalar`): IT systems savings (includes UPS and other selected IT measures) Units: kWh/year. Positive unless stated otherwise.
- **`lighting_savings_kwh`** (`out`, `scalar`): Lighting electricity savings Units: kWh/year. Positive unless stated otherwise.
- **`power_chain_loss_kw`** (`out`, `scalar`): power chain loss kw Units: kW. Positive unless stated otherwise.
- **`transformer_efficiency`** (`out`, `scalar`): transformer efficiency Units: decimal fraction. Positive unless stated otherwise.
- **`ups_efficiency`** (`out`, `scalar`): ups efficiency Units: decimal fraction. Positive unless stated otherwise.
- **`pdu_efficiency`** (`out`, `scalar`): pdu efficiency Units: decimal fraction. Positive unless stated otherwise.
- **`ups_load_factor`** (`out`, `scalar`): ups load factor Units: decimal fraction. Positive unless stated otherwise.
- **`current_pdu_load_factor`** (`out`, `scalar`): current pdu load factor Units: decimal fraction. Positive unless stated otherwise.
- **`annual_power_chain_loss_kwh`** (`out`, `scalar`): annual power chain loss kwh Units: kWh/year. Positive unless stated otherwise.

## Editorial & Version Notes

Published source v2.5; historical UPS sampling and eGRID state factors remain pinned. No safety or equipment-sizing certification. F20 is display text; emissions selection uses source-linked T9. Workbook bytes and formulas are unchanged.

---

# MIT BuildVac Ventilation Requirements (v1.0)

> MIT BuildVac Ventilation Requirements with version-pinned publisher workbook calculations, scenario inputs and formula-level audit traces.

- **Model ID**: `mit-buildvac-ventilation@v1.0` (Package `1.0.0`)
- **Publisher**: [MIT Sustainable Design Lab](https://netzerobuildings.mit.edu/ventilation-requirements)
- **Source Workbook**: `mit-buildvac-ventilation.xlsx` (`sha256:be1459148cc1f737846112302d26f6a36ff7e254111b08c94175d7ff72dee1c9`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://raw.githubusercontent.com/MITSustainableDesignLab/buildvac/main/spreadsheet/Ventilation%20Requirements%20Spreadsheet.xlsx; upstreamArtifact: null; catalog file size: 35646 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_ventilation_shafts`

## Flows

### `quick_ventilation_shafts` — Quick ventilation and shaft comparison (single)
Compare DOAS and all-air shafts with coupled density/rate method switches. Supply all custom numeric ports when activating their methods. Baseline supply temperature 12.8°C and air properties remain pinned.
- **Inputs**: `program_area_m2`, `program`, `occupant_density_method`, `custom_occupant_density`, `flow_rate_method`, `custom_flow_per_area`, `custom_flow_per_person`, `doas_velocity_m_per_s`, `doas_safety_fraction`, `peak_heating_kw`, `peak_cooling_kw`, `cooling_setpoint_c`, `heating_setpoint_c`, `all_air_velocity_m_per_s`, `all_air_safety_fraction`
- **Outputs**: `people_count`, `outdoor_flow_l_per_s`, `doas_total_shaft_m2`, `all_air_total_shaft_m2`, `shaft_comparison`

### `full_ventilation_assessment` — Full ventilation and all-air assessment (single)
All source decision inputs including air properties and supply temperature, plus supply/return/exhaust diagnostics. Fixed return ratio 80%; source lookup table is pinned.
- **Inputs**: `program_area_m2`, `program`, `occupant_density_method`, `custom_occupant_density`, `flow_rate_method`, `custom_flow_per_area`, `custom_flow_per_person`, `doas_velocity_m_per_s`, `doas_safety_fraction`, `peak_heating_kw`, `peak_cooling_kw`, `cooling_setpoint_c`, `heating_setpoint_c`, `supply_air_temperature_c`, `air_specific_heat`, `air_density`, `all_air_velocity_m_per_s`, `all_air_safety_fraction`
- **Outputs**: `people_count`, `outdoor_flow_l_per_s`, `outdoor_flow_m3_per_s`, `doas_supply_shaft_m2`, `doas_exhaust_shaft_m2`, `doas_total_shaft_m2`, `heating_flow_m3_per_s`, `cooling_flow_m3_per_s`, `all_air_supply_shaft_m2`, `all_air_return_shaft_m2`, `all_air_total_shaft_m2`, `shaft_comparison`

## SheetPort Ports (`fio.yaml`)

- **`program_area_m2`** (`in`, `scalar`): Nonnegative floor program area. Units: m². Omitted input retains publisher's source default 5000.
- **`program`** (`in`, `scalar`): Exact source program label; preserve source spelling Buliding and double spaces. Three lookups use documented exact-match preparation for these labels. Units: source enum. Omitted input retains publisher's source default "Commercial - Office Buliding - Office Space".
- **`occupant_density_method`** (`in`, `scalar`): Select standard density or activate custom_occupant_density. Units: source enum. Omitted input retains publisher's source default "ASHRAE 62.1-2022 Occupant Density".
- **`custom_occupant_density`** (`in`, `scalar`): Active only in User-Defined Occupant Density mode; must supply nonnegative numeric value when activating. Omitted baseline is formula placeholder "-" and is not a numeric assumption. Units: persons/m². Omitted input retains publisher's source default "-".
- **`flow_rate_method`** (`in`, `scalar`): Select standard rates or activate both custom flow-rate ports. Units: source enum. Omitted input retains publisher's source default "ASHRAE 62.1-2022 Flow Rates".
- **`custom_flow_per_area`** (`in`, `scalar`): Active only in User-Defined Flow Rates mode; supply alongside custom_flow_per_person. Omitted baseline is formula placeholder "-". Units: L/s/m². Omitted input retains publisher's source default "-".
- **`custom_flow_per_person`** (`in`, `scalar`): Active only in User-Defined Flow Rates mode; supply alongside custom_flow_per_area. Omitted baseline is formula placeholder "-". Units: L/s/person. Omitted input retains publisher's source default "-".
- **`doas_velocity_m_per_s`** (`in`, `scalar`): Dedicated outdoor air shaft velocity Units: m/s. Omitted input retains publisher's source default 8.
- **`doas_safety_fraction`** (`in`, `scalar`): DOAS shaft oversizing margin (0.15 means 15%) Units: decimal fraction. Omitted input retains publisher's source default 0.15.
- **`peak_heating_kw`** (`in`, `scalar`): Peak sensible heating load Units: kW. Omitted input retains publisher's source default 170.
- **`peak_cooling_kw`** (`in`, `scalar`): Peak sensible cooling load Units: kW. Omitted input retains publisher's source default 240.
- **`cooling_setpoint_c`** (`in`, `scalar`): Cooling setpoint must exceed supply_air_temperature_c Units: °C. Omitted input retains publisher's source default 24.
- **`heating_setpoint_c`** (`in`, `scalar`): Heating setpoint must exceed supply_air_temperature_c for the source calculation Units: °C. Omitted input retains publisher's source default 18.
- **`supply_air_temperature_c`** (`in`, `scalar`): Common source supply temperature for heating and cooling; must be below both setpoints Units: °C. Omitted input retains publisher's source default 12.8.
- **`air_specific_heat`** (`in`, `scalar`): Air specific heat capacity Units: kJ/(kg·°C). Omitted input retains publisher's source default 1.006.
- **`air_density`** (`in`, `scalar`): Air density Units: kg/m³. Omitted input retains publisher's source default 1.202.
- **`all_air_velocity_m_per_s`** (`in`, `scalar`): All-air supply shaft velocity Units: m/s. Omitted input retains publisher's source default 8.
- **`all_air_safety_fraction`** (`in`, `scalar`): All-air shaft oversizing margin (0.15 means 15%) Units: decimal fraction. Omitted input retains publisher's source default 0.15.
- **`people_count`** (`out`, `scalar`): Occupant count Units: persons. Positive unless stated otherwise.
- **`outdoor_flow_l_per_s`** (`out`, `scalar`): Total ventilation outdoor airflow Units: L/s. Positive unless stated otherwise.
- **`outdoor_flow_m3_per_s`** (`out`, `scalar`): Total ventilation outdoor airflow Units: m³/s. Positive unless stated otherwise.
- **`doas_supply_shaft_m2`** (`out`, `scalar`): DOAS supply shaft area Units: m². Positive unless stated otherwise.
- **`doas_exhaust_shaft_m2`** (`out`, `scalar`): DOAS exhaust shaft area, equal to supply Units: m². Positive unless stated otherwise.
- **`doas_total_shaft_m2`** (`out`, `scalar`): Combined DOAS supply and exhaust shaft area Units: m². Positive unless stated otherwise.
- **`heating_flow_m3_per_s`** (`out`, `scalar`): All-air heating flow Units: m³/s. Positive unless stated otherwise.
- **`cooling_flow_m3_per_s`** (`out`, `scalar`): All-air cooling flow Units: m³/s. Positive unless stated otherwise.
- **`all_air_supply_shaft_m2`** (`out`, `scalar`): All-air supply shaft area from maximum heating/cooling flow Units: m². Positive unless stated otherwise.
- **`all_air_return_shaft_m2`** (`out`, `scalar`): All-air return shaft area at fixed 80% of supply Units: m². Positive unless stated otherwise.
- **`all_air_total_shaft_m2`** (`out`, `scalar`): Combined all-air supply and return shaft area Units: m². Positive unless stated otherwise.
- **`shaft_comparison`** (`out`, `scalar`): Source textual comparison of DOAS and all-air shafts Units: text. Positive unless stated otherwise.

## Editorial & Version Notes

Edition v1.0 is a catalog pin, not a separately established publisher release number. Source has 23 formula elements. A documented hook adds FALSE to three VLOOKUPs because the runtime fails approximate matching on its unsorted list. Cached numerical parity is checked after preparation. Heating uses the same cold supply temperature as cooling exactly as authored; this conceptual comparison is not full HVAC design.

---

# NCUA Simplified CECL WARM Tool (2026-Q3)

> Estimates credit-union allowance for credit losses using 13 portfolio segments, historical annual loss rates, peer weighted-average remaining maturity, qualitative adjustments and individually assessed loans.

- **Model ID**: `ncua-cecl-warm@2026-Q3` (Package `2026.3.0`)
- **Publisher**: [National Credit Union Administration (NCUA)](https://ncua.gov/regulation-supervision/regulatory-compliance-resources/cecl-accounting-standards/simplified-cecl-tool)
- **Source Workbook**: `Simplified CECL Model_V23a.xlsx` (`sha256:988e5110722ff92719e23fd778c15c7857e3395482fb19d067e29397a2bccd4e`)
- **Cadence**: quarterly | **License Class**: `public-domain-gov`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `catalog-bytes`; source: https://ncua.gov/files/publications/regulation-supervision/simplified-cecl-tool.zip; upstreamArtifact: null; catalog file size: 1189069 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_allowance_check`

## Flows

### `quick_allowance_check` — Quick allowance check (single)
Illustrative credit-card balance and annual loss-rate check; all omitted ports retain source baseline defaults. Select the full flow for other segments or individual loans.
- **Inputs**: `credit_union_number`, `credit_cards_balance`, `credit_cards_q_factor`, `credit_cards_warm_adjustment`
- **Outputs**: `allowance_summary`, `segment_summary`

### `full_portfolio_warm_schedule` — Full portfolio WARM schedule (single)
All 13 balances, qualitative rates, WARM adjustments, documentation and 66 individual-loan rows; reports segment and pooled loss schedules.
- **Inputs**: `credit_union_number`, `total_assets`, `credit_cards_balance`, `credit_cards_q_factor`, `credit_cards_warm_adjustment`, `credit_cards_q_justification`, `credit_cards_warm_justification`, `payday_alternative_balance`, `payday_alternative_q_factor`, `payday_alternative_warm_adjustment`, `payday_alternative_q_justification`, `payday_alternative_warm_justification`, `student_loans_balance`, `student_loans_q_factor`, `student_loans_warm_adjustment`, `student_loans_q_justification`, `student_loans_warm_justification`, `other_unsecured_balance`, `other_unsecured_q_factor`, `other_unsecured_warm_adjustment`, `other_unsecured_q_justification`, `other_unsecured_warm_justification`, `new_vehicle_balance`, `new_vehicle_q_factor`, `new_vehicle_warm_adjustment`, `new_vehicle_q_justification`, `new_vehicle_warm_justification`, `used_vehicle_balance`, `used_vehicle_q_factor`, `used_vehicle_warm_adjustment`, `used_vehicle_q_justification`, `used_vehicle_warm_justification`, `leases_balance`, `leases_q_factor`, `leases_warm_adjustment`, `leases_q_justification`, `leases_warm_justification`, `other_secured_balance`, `other_secured_q_factor`, `other_secured_warm_adjustment`, `other_secured_q_justification`, `other_secured_warm_justification`, `first_lien_residential_balance`, `first_lien_residential_q_factor`, `first_lien_residential_warm_adjustment`, `first_lien_residential_q_justification`, `first_lien_residential_warm_justification`, `junior_lien_residential_balance`, `junior_lien_residential_q_factor`, `junior_lien_residential_warm_adjustment`, `junior_lien_residential_q_justification`, `junior_lien_residential_warm_justification`, `other_real_estate_balance`, `other_real_estate_q_factor`, `other_real_estate_warm_adjustment`, `other_real_estate_q_justification`, `other_real_estate_warm_justification`, `commercial_real_estate_balance`, `commercial_real_estate_q_factor`, `commercial_real_estate_warm_adjustment`, `commercial_real_estate_q_justification`, `commercial_real_estate_warm_justification`, `commercial_other_balance`, `commercial_other_q_factor`, `commercial_other_warm_adjustment`, `commercial_other_q_justification`, `commercial_other_warm_justification`, `individual_loans`
- **Outputs**: `total_loan_balance`, `individual_allowance`, `pooled_allowance`, `total_allowance`, `reserve_ratio`, `allowance_summary`, `segment_summary`, `individual_summary`, `pooled_balances`, `loss_rates`, `warm_schedule`, `pooled_loss_components`

## SheetPort Ports (`fio.yaml`)

- **`credit_union_number`** (`in`, `scalar`): Baseline literal Blank selects externally supplied loss-rate assumptions. Numeric CU charter selection requires cellOverrides on Tab 0 - Input!C5; numeric strings do not match numeric Data keys.
- **`total_assets`** (`in`, `scalar`): No description
- **`credit_cards_balance`** (`in`, `scalar`): Unsecured Credit Card Loans
- **`credit_cards_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`credit_cards_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`credit_cards_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`credit_cards_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`payday_alternative_balance`** (`in`, `scalar`): Payday Alternative Loans (PALs I and PALs II) (FCU Only)
- **`payday_alternative_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`payday_alternative_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`payday_alternative_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`payday_alternative_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`student_loans_balance`** (`in`, `scalar`): Non-Federally Guaranteed Student Loans
- **`student_loans_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`student_loans_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`student_loans_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`student_loans_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_unsecured_balance`** (`in`, `scalar`): All Other Unsecured Loans/Lines of Credit
- **`other_unsecured_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`other_unsecured_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`other_unsecured_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_unsecured_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`new_vehicle_balance`** (`in`, `scalar`): New Vehicle Loans
- **`new_vehicle_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`new_vehicle_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`new_vehicle_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`new_vehicle_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`used_vehicle_balance`** (`in`, `scalar`): Used Vehicle Loans
- **`used_vehicle_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`used_vehicle_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`used_vehicle_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`used_vehicle_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`leases_balance`** (`in`, `scalar`): Leases Receivable
- **`leases_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`leases_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`leases_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`leases_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_secured_balance`** (`in`, `scalar`): All Other Secured Non-Real Estate Loans/Lines of Credit 
- **`other_secured_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`other_secured_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`other_secured_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_secured_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`first_lien_residential_balance`** (`in`, `scalar`): Secured by 1st Lien on a single 1- to 4-Family Residential Property
- **`first_lien_residential_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`first_lien_residential_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`first_lien_residential_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`first_lien_residential_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`junior_lien_residential_balance`** (`in`, `scalar`): Secured by Junior Lien on a single 1- to 4-Family Residential Property
- **`junior_lien_residential_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`junior_lien_residential_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`junior_lien_residential_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`junior_lien_residential_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_real_estate_balance`** (`in`, `scalar`): All Other (Non-Commercial) Real Estate Loans/Lines of Credit 
- **`other_real_estate_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`other_real_estate_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`other_real_estate_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`other_real_estate_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`commercial_real_estate_balance`** (`in`, `scalar`): Commercial Loans/Lines of Credit Real Estate Secured
- **`commercial_real_estate_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`commercial_real_estate_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`commercial_real_estate_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`commercial_real_estate_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`commercial_other_balance`** (`in`, `scalar`): Commercial Loans/Lines of Credit Not Real Estate Secured
- **`commercial_other_q_factor`** (`in`, `scalar`): Additive annual loss-rate adjustment as a decimal (0.01 = one percentage point). With Blank CU, this supplies the annual rate.
- **`commercial_other_warm_adjustment`** (`in`, `scalar`): Additive adjustment to peer WARM, in years; signed.
- **`commercial_other_q_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`commercial_other_warm_justification`** (`in`, `scalar`): Baseline is an empty source cell.
- **`individual_loans`** (`in`, `table`): Fixed 66-row table body, source Table5 input columns A:E. Supply all rows (pad unused rows with nulls); F remains the source formula. Exact segment text must match Tab 2 A6:A18. Note numbers are text. No resizing.
- **`total_loan_balance`** (`out`, `scalar`): No description
- **`individual_allowance`** (`out`, `scalar`): No description
- **`pooled_allowance`** (`out`, `scalar`): No description
- **`total_allowance`** (`out`, `scalar`): No description
- **`reserve_ratio`** (`out`, `scalar`): No description
- **`allowance_summary`** (`out`, `record`): No description
- **`segment_summary`** (`out`, `record`): 13 source portfolio segments; reserve ratio is a decimal. Field prefixes identify the 13 source segments. Fixed rows exclude total/check status/notes.
- **`individual_summary`** (`out`, `record`): Includes COUNTIF(Table5[Column6],segment); requires restoration of source Table5 metadata in this WASM build. Field prefixes identify the 13 source segments. Fixed rows exclude total/check status/notes.
- **`pooled_balances`** (`out`, `range`): Columns: total balance, individual balance, pooled balance.
- **`loss_rates`** (`out`, `range`): Columns: historical annual loss rate, Q adjustment, applicable annual rate.
- **`warm_schedule`** (`out`, `range`): Columns: peer WARM years, adjustment years, applicable WARM years.
- **`pooled_loss_components`** (`out`, `range`): Columns: quantitative, qualitative, combined lifetime loss.

## Editorial & Version Notes

## Methodology and edition
The source identifies September 30, 2026. WARM is a portfolio-level proxy, with peer maturity values converted from months to years. It is not simply contractual maturity. Historical loss rates are drawn from embedded Call Report data for the selected CU; qualitative factors adjust annual rates and remaining life. Quantitative pooled loss uses unadjusted historical rate and peer WARM; qualitative pooled loss is combined loss less quantitative loss. Individual allowances are added separately.

No previous edition was supplied, so no quarter-over-quarter rule or data changes are asserted. Signed adjustments can produce negative applicable rates or remaining life; the source flags potential recoveries and expects management review. The package preserves formulas and does not silently clamp those assumptions. The runtime restores Table5 metadata before calculation. This is a Formualizer mapping of a government workbook, not an NCUA-issued modified document.

---

# NDHFA Multifamily Exhibit A Operating Cashflow (2026)

> What first-year NOI and cash after debt service does a single rent cohort support? Selected expense categories only: all omitted expenses and other cohorts retain zero/blank defaults. Not a complete application or compliance analysis. Annual debt service is entered directly. Publisher vacancy is max(7%,1/units), with 7% fallback at zero units; reserves reduce NOI. Catalog calculations, not certification; no NDHFA endorsement.

- **Model ID**: `nd-multifamily-exhibit-a@2026` (Package `2026.1.0`)
- **Publisher**: [North Dakota Housing Finance Agency (NDHFA)](https://www.ndhousing.nd.gov/development)
- **Source Workbook**: `MultifamilyExhibitA05.11.2026.xlsx` (`sha256:0860def1c0924f26385138c91311b8f9c9994bce3d1dafbc72458b28fa2be503`)
- **Cadence**: periodic | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://www.ndhousing.nd.gov/sites/default/files/documents/Forms/MultifamilyExhibitA05.11.2026.xlsx; upstreamArtifact: null; catalog file size: 458301 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_operating_cashflow`

## Flows

### `quick_operating_cashflow` — Single-cohort operating cashflow (single)
What first-year NOI and cash after debt service does a single rent cohort support? Selected expense categories only: all omitted expenses and other cohorts retain zero/blank defaults. Not a complete application or compliance analysis. Annual debt service is entered directly. Publisher vacancy is max(7%,1/units), with 7% fallback at zero units; reserves reduce NOI. Catalog calculations, not certification; no NDHFA endorsement.
- **Inputs**: `units`, `monthly_rent`, `management`, `electricity`, `repairs`, `taxes`, `insurance`, `reserve_per_unit`, `annual_debt_service`
- **Outputs**: `effective_income`, `operating_expenses`, `noi`, `total_debt_service`, `cash_after_debt`

## SheetPort Ports (`fio.yaml`)

- **`units`** (`in`, `scalar`): Count, nonnegative whole units in a single non-staff rent cohort; other cohorts remain empty. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`monthly_rent`** (`in`, `scalar`): USD/unit/month, positive gross rent for the single cohort; vacancy is computed by the publisher as max(7%,1/units). Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`management`** (`in`, `scalar`): USD/year, positive management fees deducted from income. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`electricity`** (`in`, `scalar`): USD/year, positive electricity expense deducted from income. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`repairs`** (`in`, `scalar`): USD/year, positive repairs expense deducted from income. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`taxes`** (`in`, `scalar`): USD/year, positive real estate taxes deducted from income. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`insurance`** (`in`, `scalar`): USD/year, positive property hazard and liability insurance deducted from income. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`reserve_per_unit`** (`in`, `scalar`): USD/unit/year, positive replacement reserve contribution; publisher includes reserve in NOI deductions. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`annual_debt_service`** (`in`, `scalar`): USD/year, positive debt source 1 payment entered directly, not derived from the separate payment estimator. Other debt payments remain zero. Omitted expenses and other cohorts retain publisher zero/blank defaults.
- **`effective_income`** (`out`, `scalar`): USD/year, income after publisher vacancy deduction.
- **`operating_expenses`** (`out`, `scalar`): USD/year, expenses including replacement reserve contributions.
- **`noi`** (`out`, `scalar`): USD/year, income less expenses including reserves.
- **`total_debt_service`** (`out`, `scalar`): USD/year, total entered annual debt payments.
- **`cash_after_debt`** (`out`, `scalar`): USD/year, NOI less annual debt payments; negative means deficit.

## Editorial & Version Notes

Reference-only. No express redistribution grant found. Privacy policy is context only. Local workbook copy is for staging verification; public download must redirect to publisher. What first-year NOI and cash after debt service does a single rent cohort support? Selected expense categories only: all omitted expenses and other cohorts retain zero/blank defaults. Not a complete application or compliance analysis. Annual debt service is entered directly. Publisher vacancy is max(7%,1/units), with 7% fallback at zero units; reserves reduce NOI. Catalog calculations, not certification; no NDHFA endorsement.

---

# NREL CREST Anaerobic Digestion Cash-Flow Model (v1.4)

> CREST v1.4 anaerobic digestion required tariff, nominal LCOE, project finance and after-tax equity return calculator.

- **Model ID**: `nrel-crest-anaerobic-digestion@v1.4` (Package `1.4.0`)
- **Publisher**: [National Renewable Energy Laboratory (NREL / DOE)](https://www.nlr.gov/analysis/crest)
- **Source Workbook**: `nrel-crest-anaerobic-digestion.xlsx` (`sha256:ef7f0aa218fa9cd0ceca08b469a8fe4bdfa177593e293609eb418bc08152e4fb`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression.
- **Workbook Download**: `catalog-bytes`; source: https://www.nlr.gov/docs/libraries/analysis/nrel-crest-anaerobic-digestion.xlsx?sfvrsn=7b16f923_2; upstreamArtifact: null; catalog file size: 225556 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_biogas_lcoe_check`

## Flows

### `quick_biogas_lcoe_check` — Quick anaerobic digestion LCOE check (single)
Primary operating, capital, financing and revenue assumptions; omitted assumptions retain source defaults. Simple capex/O&M switches activate corresponding scalar costs. All percentages are decimal fractions.
- **Inputs**: `system_size_kw`, `electrical_efficiency`, `availability`, `parasitic_load`, `capital_cost_detail`, `installed_cost_per_kw`, `om_cost_detail`, `fixed_om_per_kw_year`, `variable_om_cents_per_kwh`, `feedstock_cost_per_ton`, `tipping_fee_per_ton`, `tipping_quantity_tons_year`, `debt_fraction`, `debt_interest_rate`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year20`

### `full_biogas_project_finance` — Full anaerobic digestion project finance (single)
All mapped scalar assumptions, incentives, reserves and depreciation allocations with finance diagnostics. Detailed year-by-year Complex schedules and formula-derived replacement years use cellOverrides; selectCells and trace expose additional diagnostics.
- **Inputs**: `system_size_kw`, `tipping_fee_per_ton`, `tipping_quantity_tons_year`, `tipping_fee_source_2`, `energy_content_per_cubic_foot`, `quantity_received_each_year`, `tipping_fee_source_3`, `electrical_efficiency`, `quantity_received_each_year_q12`, `digestate_if_merchantable_for_additional_revenue`, `availability`, `digestate_revenue_escalation_factor`, `parasitic_load`, `digestate_quantity`, `waste_heat_heat_capture_efficiency`, `annual_production_degradation`, `project_useful_life`, `waste_heat_selling_price_avoided_cost`, `waste_heat_selling_price_escalation_factor`, `capital_cost_detail`, `installed_cost_per_kw`, `payment_duration_for_cost_based_tariff`, `generation_equipment`, `of_year_one_tariff_rate_escalated`, `balance_of_plant`, `cost_based_tariff_escalation_rate`, `interconnection`, `development_costs_fee`, `select_market_value_forecast_methodology`, `value_of_energy_capacity_recs_yr_1`, `market_value_escalation_rate`, `om_cost_detail`, `select_form_of_federal_incentives`, `fixed_om_per_kw_year`, `investment_tax_credit_itc_or_cash_grant`, `variable_om_cents_per_kwh`, `itc_or_cash_grant_amount`, `o_m_cost_inflation_initial_period`, `itc_utilization_factor_if_applicable`, `initial_period_ends_last_day_of`, `o_m_cost_inflation_thereafter`, `is_pbi_tax_based_ptc_or_cash_based_repi`, `insurance_yr_1_of_total_cost`, `pbi_rate`, `pbi_utilization_or_availability_factor_if_applicable`, `project_management_yr_1`, `pbi_duration`, `feedstock_cost_per_ton`, `pbi_escalation_rate`, `feedstock_expense_escalation_factor`, `additional_federal_grants_other_than_section_1603`, `feedstock_quantity`, `federal_grants_treated_as_taxable_income`, `water_sewer_expenses`, `water_sewer_expense_escalation_factor`, `digestate_disposal_if_handled_as_an_expense`, `select_form_of_state_incentive`, `digestate_disposal_escalation_factor`, `itc_amount`, `digestate_quantity_g49`, `utilization_factor_if_applicable`, `property_tax_or_pilot_yr_1`, `state_itc_realization_period`, `annual_property_tax_adjustment_factor`, `land_lease`, `is_performance_based_incentive_tax_credit_or_cash_pmt`, `royalties_of_revenue`, `annual_cap_on_performance_based_incentive`, `if_cash_is_state_pbi_or_rec_taxable`, `pbi_or_rec_rate`, `pbi_utilization_factor_if_applicable`, `construction_period`, `pbi_or_rec_paymentduration`, `interest_rate_annual`, `pbi_or_rec_escalation_rate_pos_or_neg`, `additional_state_rebates_grants`, `total_cap_on_state_rebates_grants`, `state_grants_treated_as_taxable_income`, `debt_fraction`, `debt_term`, `debt_interest_rate`, `1st_equipment_replacement`, `lender_s_fee_of_total_borrowing`, `1st_replacement_cost_in_year_replaced`, `required_minimum_annual_dscr`, `2nd_equipment_replacement`, `2nd_replacement_cost_in_year_replaced`, `3rd_equipment_replacement`, `required_average_dscr`, `3rd_replacement_cost_in_year_replaced`, `4th_equipment_replacement`, `4th_replacement_cost_in_year_replaced`, `target_after_tax_equity_irr`, `other_closing_costs`, `fund_from_operations_or_salvage_value`, `reserve_requirement`, `of_months_of_debt_service`, `of_months_of_o_m_expense`, `is_owner_a_taxable_entity`, `federal_income_tax_rate`, `interest_on_all_reserves`, `federal_tax_benefits_used_as_generated_or_carried_forward`, `state_income_tax_rate`, `state_tax_benefits_used_as_generated_or_carried_forward`, `bonus_depreciation_enabled`, `bonus_depreciation_fraction`, `depreciation_total_installed_cost_5_year_macrs`, `depreciation_total_installed_cost_7_year_macrs`, `depreciation_total_installed_cost_15_year_macrs`, `depreciation_total_installed_cost_20_year_macrs`, `depreciation_total_installed_cost_5_year_sl`, `depreciation_total_installed_cost_15_year_sl`, `depreciation_total_installed_cost_20_year_sl`, `depreciation_generation_equipment_5_year_macrs`, `depreciation_generation_equipment_7_year_macrs`, `depreciation_generation_equipment_15_year_macrs`, `depreciation_generation_equipment_20_year_macrs`, `depreciation_generation_equipment_5_year_sl`, `depreciation_generation_equipment_15_year_sl`, `depreciation_generation_equipment_20_year_sl`, `depreciation_balance_of_plant_5_year_macrs`, `depreciation_balance_of_plant_7_year_macrs`, `depreciation_balance_of_plant_15_year_macrs`, `depreciation_balance_of_plant_20_year_macrs`, `depreciation_balance_of_plant_5_year_sl`, `depreciation_balance_of_plant_15_year_sl`, `depreciation_balance_of_plant_20_year_sl`, `depreciation_interconnection_5_year_macrs`, `depreciation_interconnection_7_year_macrs`, `depreciation_interconnection_15_year_macrs`, `depreciation_interconnection_20_year_macrs`, `depreciation_interconnection_5_year_sl`, `depreciation_interconnection_15_year_sl`, `depreciation_interconnection_20_year_sl`, `depreciation_development_costs_fee_5_year_macrs`, `depreciation_development_costs_fee_7_year_macrs`, `depreciation_development_costs_fee_15_year_macrs`, `depreciation_development_costs_fee_20_year_macrs`, `depreciation_development_costs_fee_5_year_sl`, `depreciation_development_costs_fee_15_year_sl`, `depreciation_development_costs_fee_20_year_sl`, `depreciation_reserves_financing_costs_5_year_macrs`, `depreciation_reserves_financing_costs_7_year_macrs`, `depreciation_reserves_financing_costs_15_year_macrs`, `depreciation_reserves_financing_costs_20_year_macrs`, `depreciation_reserves_financing_costs_5_year_sl`, `depreciation_reserves_financing_costs_15_year_sl`, `depreciation_reserves_financing_costs_20_year_sl`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year20`, `minimum_dscr_met`, `average_dscr_met`, `year_one_revenue`, `year_one_operating_expenses`, `year_one_after_tax_cash_flow`, `initial_equity_cash_flow`, `year_one_dscr`

## SheetPort Ports (`fio.yaml`)

- **`system_size_kw`** (`in`, `scalar`): Generator Nameplate Capacity; units: kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`tipping_fee_per_ton`** (`in`, `scalar`): Tipping Fee - Source #1; units: USD/ton. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`tipping_quantity_tons_year`** (`in`, `scalar`): Quantity Received Each Year; units: tons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`tipping_fee_source_2`** (`in`, `scalar`): Tipping Fee - Source #2; units: USD/ton. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`energy_content_per_cubic_foot`** (`in`, `scalar`): Energy Content per Cubic Foot; units: BTU/cubic foot. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`quantity_received_each_year`** (`in`, `scalar`): Quantity Received Each Year; units: tons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`tipping_fee_source_3`** (`in`, `scalar`): Tipping Fee - Source #3; units: USD/ton. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`electrical_efficiency`** (`in`, `scalar`): Electrical Conversion Efficiency; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`quantity_received_each_year_q12`** (`in`, `scalar`): Quantity Received Each Year; units: tons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`digestate_if_merchantable_for_additional_revenue`** (`in`, `scalar`): Digestate (if merchantable for additional revenue); units: USD/gallon. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`availability`** (`in`, `scalar`): Availability; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`digestate_revenue_escalation_factor`** (`in`, `scalar`): Digestate Revenue Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`parasitic_load`** (`in`, `scalar`): Station Service (Parasitic Load); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`digestate_quantity`** (`in`, `scalar`): Digestate - Quantity; units: gallons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_heat_capture_efficiency`** (`in`, `scalar`): Waste Heat -- Heat Capture Efficiency; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`annual_production_degradation`** (`in`, `scalar`): Annual Production Degradation; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`project_useful_life`** (`in`, `scalar`): Project Useful Life; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_selling_price_avoided_cost`** (`in`, `scalar`): Waste Heat -- Selling Price/Avoided Cost; units: USD/therm. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_selling_price_escalation_factor`** (`in`, `scalar`): Waste Heat -- Selling Price Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`capital_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Simple | Intermediate | Complex.
- **`installed_cost_per_kw`** (`in`, `scalar`): Total Installed Cost; units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when capital_cost_detail = Simple; USD/kW (not USD/W).
- **`payment_duration_for_cost_based_tariff`** (`in`, `scalar`): Payment Duration for Cost-Based Tariff; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`generation_equipment`** (`in`, `scalar`): Generation Equipment; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_year_one_tariff_rate_escalated`** (`in`, `scalar`): % of Year-One Tariff Rate Escalated; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`balance_of_plant`** (`in`, `scalar`): Balance of Plant; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`cost_based_tariff_escalation_rate`** (`in`, `scalar`): Cost-Based Tariff Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`interconnection`** (`in`, `scalar`): Interconnection; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`development_costs_fee`** (`in`, `scalar`): Development Costs & Fee; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`select_market_value_forecast_methodology`** (`in`, `scalar`): Select Market Value Forecast Methodology; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Year One | Year-by-Year.
- **`value_of_energy_capacity_recs_yr_1`** (`in`, `scalar`): Value of energy, capacity & RECs, Yr 1; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`market_value_escalation_rate`** (`in`, `scalar`): Market Value Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`om_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Simple | Intermediate.
- **`select_form_of_federal_incentives`** (`in`, `scalar`): Select Form of Federal Incentives; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cost-Based | Performance-Based | Neither.
- **`fixed_om_per_kw_year`** (`in`, `scalar`): Fixed O&M Expense, Yr 1; units: USD/kW-yr. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when om_cost_detail = Simple.
- **`investment_tax_credit_itc_or_cash_grant`** (`in`, `scalar`): Investment Tax Credit (ITC) or Cash Grant?; units: dimensionless or exact text enum. Case-sensitive source text.
- **`variable_om_cents_per_kwh`** (`in`, `scalar`): Variable O&M Expense, Yr 1; units: cents/kWh . Positive input unless explicitly an escalation factor; escalation may be negative. Active only when om_cost_detail = Simple.
- **`itc_or_cash_grant_amount`** (`in`, `scalar`): ITC or Cash Grant Amount ; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`o_m_cost_inflation_initial_period`** (`in`, `scalar`): O&M Cost Inflation, initial period; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`itc_utilization_factor_if_applicable`** (`in`, `scalar`): ITC utilization factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`initial_period_ends_last_day_of`** (`in`, `scalar`): Initial Period ends last day of:; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`o_m_cost_inflation_thereafter`** (`in`, `scalar`): O&M Cost Inflation, thereafter; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`is_pbi_tax_based_ptc_or_cash_based_repi`** (`in`, `scalar`): Is PBI Tax-Based (PTC) or Cash-Based (REPI)?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cash | Tax Credit.
- **`insurance_yr_1_of_total_cost`** (`in`, `scalar`): Insurance, Yr 1 (% of Total Cost); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_rate`** (`in`, `scalar`): PBI Rate; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_utilization_or_availability_factor_if_applicable`** (`in`, `scalar`): PBI Utilization or Availability Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`project_management_yr_1`** (`in`, `scalar`): Project Management Yr 1; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_duration`** (`in`, `scalar`): PBI Duration; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`feedstock_cost_per_ton`** (`in`, `scalar`): Feedstock Expense, if applicable; units: USD/ton. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when om_cost_detail = Intermediate; Simple O&M replaces the entire operating-cost schedule.
- **`pbi_escalation_rate`** (`in`, `scalar`): PBI Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`feedstock_expense_escalation_factor`** (`in`, `scalar`): Feedstock Expense Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`additional_federal_grants_other_than_section_1603`** (`in`, `scalar`): Additional Federal Grants (Other than Section 1603); units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`feedstock_quantity`** (`in`, `scalar`): Feedstock - Quantity; units: tons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`federal_grants_treated_as_taxable_income`** (`in`, `scalar`): Federal Grants Treated as Taxable Income?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`water_sewer_expenses`** (`in`, `scalar`): Water & Sewer Expenses; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`water_sewer_expense_escalation_factor`** (`in`, `scalar`): Water & Sewer Expense Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`digestate_disposal_if_handled_as_an_expense`** (`in`, `scalar`): Digestate Disposal (if handled as an expense); units: USD/gallon. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`select_form_of_state_incentive`** (`in`, `scalar`): Select Form of State Incentive; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cost-Based | Performance-Based | Neither.
- **`digestate_disposal_escalation_factor`** (`in`, `scalar`): Digestate Disposal Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`itc_amount`** (`in`, `scalar`): ITC Amount ; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`digestate_quantity_g49`** (`in`, `scalar`): Digestate - Quantity; units: gallons per year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`utilization_factor_if_applicable`** (`in`, `scalar`): Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`property_tax_or_pilot_yr_1`** (`in`, `scalar`): Property Tax or PILOT, Yr 1; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_itc_realization_period`** (`in`, `scalar`): State ITC realization period; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`annual_property_tax_adjustment_factor`** (`in`, `scalar`): Annual Property Tax Adjustment Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`land_lease`** (`in`, `scalar`): Land Lease; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`is_performance_based_incentive_tax_credit_or_cash_pmt`** (`in`, `scalar`): Is Performance-Based Incentive Tax Credit or Cash Pmt?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cash | Tax Credit.
- **`royalties_of_revenue`** (`in`, `scalar`): Royalties (% of revenue); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`annual_cap_on_performance_based_incentive`** (`in`, `scalar`): Annual $ Cap on Performance-Based Incentive; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`if_cash_is_state_pbi_or_rec_taxable`** (`in`, `scalar`): If cash, is state PBI or REC taxable?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`pbi_or_rec_rate`** (`in`, `scalar`): PBI or REC Rate; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_utilization_factor_if_applicable`** (`in`, `scalar`): PBI Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`construction_period`** (`in`, `scalar`): Construction Period; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_or_rec_paymentduration`** (`in`, `scalar`): PBI or REC PaymentDuration; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`interest_rate_annual`** (`in`, `scalar`): Interest Rate (Annual); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_or_rec_escalation_rate_pos_or_neg`** (`in`, `scalar`): PBI or REC Escalation Rate (pos. or neg.); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`additional_state_rebates_grants`** (`in`, `scalar`): Additional State Rebates/Grants; units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`total_cap_on_state_rebates_grants`** (`in`, `scalar`): Total $ Cap on State Rebates/Grants; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_grants_treated_as_taxable_income`** (`in`, `scalar`): State Grants Treated as Taxable Income?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`debt_fraction`** (`in`, `scalar`): % Debt (% of hard costs) (mortgage-style amort.); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`debt_term`** (`in`, `scalar`): Debt Term; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`debt_interest_rate`** (`in`, `scalar`): Interest Rate on Term Debt; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`1st_equipment_replacement`** (`in`, `scalar`): 1st Equipment Replacement; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`lender_s_fee_of_total_borrowing`** (`in`, `scalar`): Lender's Fee (% of total borrowing); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`1st_replacement_cost_in_year_replaced`** (`in`, `scalar`): 1st Replacement Cost  ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`required_minimum_annual_dscr`** (`in`, `scalar`): Required Minimum Annual DSCR; units: dimensionless or exact text enum. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`2nd_equipment_replacement`** (`in`, `scalar`): 2nd Equipment Replacement ; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`2nd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 2nd Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`3rd_equipment_replacement`** (`in`, `scalar`): 3rd Equipment Replacement ; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`required_average_dscr`** (`in`, `scalar`): Required Average DSCR; units: dimensionless or exact text enum. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`3rd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 3rd Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`4th_equipment_replacement`** (`in`, `scalar`): 4th Equipment Replacement ; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`4th_replacement_cost_in_year_replaced`** (`in`, `scalar`): 4th Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`target_after_tax_equity_irr`** (`in`, `scalar`): Target After-Tax Equity IRR; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`other_closing_costs`** (`in`, `scalar`): Other Closing Costs; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`fund_from_operations_or_salvage_value`** (`in`, `scalar`): Fund from Operations or Salvage Value?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Operations | Salvage.
- **`reserve_requirement`** (`in`, `scalar`): Reserve Requirement; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_months_of_debt_service`** (`in`, `scalar`): # of months of Debt Service; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_months_of_o_m_expense`** (`in`, `scalar`): # of months of O&M Expense; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`is_owner_a_taxable_entity`** (`in`, `scalar`): Is owner a taxable entity?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`federal_income_tax_rate`** (`in`, `scalar`): Federal Income Tax Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`interest_on_all_reserves`** (`in`, `scalar`): Interest on All Reserves; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`federal_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): Federal Tax Benefits used as generated or carried forward?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: As Generated | Carried Forward.
- **`state_income_tax_rate`** (`in`, `scalar`): State Income Tax Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): State Tax Benefits used as generated or carried forward?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: As Generated | Carried Forward.
- **`bonus_depreciation_enabled`** (`in`, `scalar`): Bonus depreciation enabled; units: enum Yes / No. Case-sensitive source text. Allowed values: Yes | No.
- **`bonus_depreciation_fraction`** (`in`, `scalar`): Fraction depreciated in year one; active when bonus_depreciation_enabled = Yes; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`year_one_coe_cents_per_kwh`** (`out`, `scalar`): Required first-year tariff; cents/kWh.
- **`nominal_lcoe_cents_per_kwh`** (`out`, `scalar`): Nominal levelized cost of energy; cents/kWh.
- **`year_one_energy_kwh`** (`out`, `scalar`): Net electricity after station service; kWh/year.
- **`net_installed_cost`** (`out`, `scalar`): Capital cost less grants; USD, positive cost.
- **`after_tax_equity_irr_year20`** (`out`, `scalar`): Actual cumulative equity IRR at year 20; decimal fraction, distinct from target.
- **`minimum_dscr_met`** (`out`, `scalar`): Minimum debt coverage covenant; Yes or No, see Inputs Worksheet.
- **`average_dscr_met`** (`out`, `scalar`): Average debt coverage covenant; Yes or No, see Inputs Worksheet.
- **`year_one_revenue`** (`out`, `scalar`): Revenue; USD/year, positive inflow.
- **`year_one_operating_expenses`** (`out`, `scalar`): Operating costs; USD/year, negative outflow.
- **`year_one_after_tax_cash_flow`** (`out`, `scalar`): Equity cash flow; USD, positive inflow / negative outflow.
- **`initial_equity_cash_flow`** (`out`, `scalar`): Initial equity investment; USD, negative outflow.
- **`year_one_dscr`** (`out`, `scalar`): Year-one debt service coverage; dimensionless ratio.

## Editorial & Version Notes

Three native What-If tables are recalculated at all 33 trial tariffs; midpoint rounding preserves 0.1-cent bracket resolution. Supported source tariff interval 0..100 cents/kWh. Complex year schedules can be edited with cellOverrides. Source edition metadata follows the supplied v1.4 catalog edition; source workbook does not establish current-law suitability.

---

# NREL CREST Fuel Cell Cash-Flow Model (v1.4)

> CREST v1.4 fuel cell required tariff, nominal LCOE, project finance and after-tax equity return calculator.

- **Model ID**: `nrel-crest-fuel-cell@v1.4` (Package `1.4.0`)
- **Publisher**: [National Renewable Energy Laboratory (NREL / DOE)](https://www.nlr.gov/analysis/crest)
- **Source Workbook**: `nrel-crest-fuel-cell.xlsx` (`sha256:2dd12a11ac2bb3730f73aa2ec4b3421e3fffcb7797fbe68ad9b5626adc5759df`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression.
- **Workbook Download**: `catalog-bytes`; source: https://www.nlr.gov/docs/libraries/analysis/nrel-crest-fuel-cell.xlsx?sfvrsn=7bc0462f_2; upstreamArtifact: null; catalog file size: 224359 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_fuelcell_lcoe_check`

## Flows

### `quick_fuelcell_lcoe_check` — Quick fuel cell LCOE check (single)
Primary operating, capital, financing and revenue assumptions; omitted assumptions retain source defaults. Simple capex/O&M switches activate corresponding scalar costs. All percentages are decimal fractions.
- **Inputs**: `unit_count`, `capacity_per_unit_kw`, `electrical_efficiency`, `availability`, `parasitic_load`, `capital_cost_detail`, `installed_cost_per_kw`, `om_cost_detail`, `fixed_om_per_kw_year`, `fuel_cost_per_mmbtu`, `debt_fraction`, `debt_interest_rate`, `federal_incentive_type`, `federal_cost_incentive_form`, `itc_fraction`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year20`

### `full_fuelcell_project_finance` — Full fuel cell project finance (single)
All mapped scalar assumptions, incentives, reserves and depreciation allocations with finance diagnostics. Detailed year-by-year Complex schedules and formula-derived replacement years use cellOverrides; selectCells and trace expose additional diagnostics.
- **Inputs**: `unit_count`, `waste_heat_heat_capture_efficiency`, `capacity_per_unit_kw`, `waste_heat_selling_price_avoided_cost`, `electrical_efficiency`, `waste_heat_selling_price_escalation_factor`, `energy_content_per_cubic_foot`, `payment_duration_for_cost_based_tariff`, `availability`, `of_year_one_tariff_rate_escalated`, `parasitic_load`, `cost_based_tariff_escalation_rate`, `annual_stack_degradation`, `stack_life`, `select_market_value_forecast_methodology`, `project_useful_life`, `value_of_energy_capacity_recs_yr_1`, `market_value_escalation_rate`, `capital_cost_detail`, `installed_cost_per_kw`, `generation_equipment`, `federal_incentive_type`, `balance_of_plant`, `federal_cost_incentive_form`, `interconnection`, `itc_fraction`, `development_costs_fee`, `itc_utilization_factor_if_applicable`, `is_pbi_tax_based_ptc_or_cash_based_repi`, `pbi_rate`, `pbi_utilization_or_availability_factor_if_applicable`, `pbi_duration`, `pbi_escalation_rate`, `om_cost_detail`, `additional_federal_grants_other_than_section_1603`, `fixed_om_per_kw_year`, `federal_grants_treated_as_taxable_income`, `variable_o_m_expense_yr_1`, `o_m_cost_inflation_initial_period`, `initial_period_ends_last_day_of`, `select_form_of_state_incentive`, `o_m_cost_inflation_thereafter`, `itc_amount`, `insurance_yr_1_of_total_cost`, `utilization_factor_if_applicable`, `state_itc_realization_period`, `project_management_yr_1`, `fuel_cost_per_mmbtu`, `is_performance_based_incentive_tax_credit_or_cash_pmt`, `fuel_cost_escalation_factor`, `annual_cap_on_performance_based_incentive`, `property_tax_or_pilot_yr_1`, `if_cash_is_state_pbi_or_rec_taxable`, `annual_property_tax_adjustment_factor`, `pbi_or_rec_rate`, `land_lease`, `pbi_utilization_factor_if_applicable`, `royalties_of_revenue`, `pbi_or_rec_paymentduration`, `pbi_or_rec_escalation_rate_pos_or_neg`, `additional_state_rebates_grants`, `total_cap_on_state_rebates_grants`, `construction_period`, `state_grants_treated_as_taxable_income`, `interest_rate_annual`, `1st_replacement_cost_in_year_replaced`, `debt_fraction`, `debt_term`, `2nd_replacement_cost_in_year_replaced`, `debt_interest_rate`, `lender_s_fee_of_total_borrowing`, `3rd_replacement_cost_in_year_replaced`, `required_minimum_annual_dscr`, `4th_replacement_cost_in_year_replaced`, `capacity_increase_due_to_re_stacking`, `required_average_dscr`, `fund_from_operations_or_salvage_value`, `target_after_tax_equity_irr`, `reserve_requirement`, `other_closing_costs`, `of_months_of_debt_service`, `of_months_of_o_m_expense`, `interest_on_all_reserves`, `is_owner_a_taxable_entity`, `federal_income_tax_rate`, `federal_tax_benefits_used_as_generated_or_carried_forward`, `state_income_tax_rate`, `state_tax_benefits_used_as_generated_or_carried_forward`, `bonus_depreciation_enabled`, `bonus_depreciation_fraction`, `depreciation_total_installed_cost_5_year_macrs`, `depreciation_total_installed_cost_7_year_macrs`, `depreciation_total_installed_cost_15_year_macrs`, `depreciation_total_installed_cost_20_year_macrs`, `depreciation_total_installed_cost_5_year_sl`, `depreciation_total_installed_cost_15_year_sl`, `depreciation_total_installed_cost_20_year_sl`, `depreciation_generation_equipment_5_year_macrs`, `depreciation_generation_equipment_7_year_macrs`, `depreciation_generation_equipment_15_year_macrs`, `depreciation_generation_equipment_20_year_macrs`, `depreciation_generation_equipment_5_year_sl`, `depreciation_generation_equipment_15_year_sl`, `depreciation_generation_equipment_20_year_sl`, `depreciation_balance_of_plant_5_year_macrs`, `depreciation_balance_of_plant_7_year_macrs`, `depreciation_balance_of_plant_15_year_macrs`, `depreciation_balance_of_plant_20_year_macrs`, `depreciation_balance_of_plant_5_year_sl`, `depreciation_balance_of_plant_15_year_sl`, `depreciation_balance_of_plant_20_year_sl`, `depreciation_interconnection_5_year_macrs`, `depreciation_interconnection_7_year_macrs`, `depreciation_interconnection_15_year_macrs`, `depreciation_interconnection_20_year_macrs`, `depreciation_interconnection_5_year_sl`, `depreciation_interconnection_15_year_sl`, `depreciation_interconnection_20_year_sl`, `depreciation_development_costs_fee_5_year_macrs`, `depreciation_development_costs_fee_7_year_macrs`, `depreciation_development_costs_fee_15_year_macrs`, `depreciation_development_costs_fee_20_year_macrs`, `depreciation_development_costs_fee_5_year_sl`, `depreciation_development_costs_fee_15_year_sl`, `depreciation_development_costs_fee_20_year_sl`, `depreciation_reserves_financing_costs_5_year_macrs`, `depreciation_reserves_financing_costs_7_year_macrs`, `depreciation_reserves_financing_costs_15_year_macrs`, `depreciation_reserves_financing_costs_20_year_macrs`, `depreciation_reserves_financing_costs_5_year_sl`, `depreciation_reserves_financing_costs_15_year_sl`, `depreciation_reserves_financing_costs_20_year_sl`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year20`, `minimum_dscr_met`, `average_dscr_met`, `year_one_revenue`, `year_one_operating_expenses`, `year_one_after_tax_cash_flow`, `initial_equity_cash_flow`, `year_one_dscr`

## SheetPort Ports (`fio.yaml`)

- **`unit_count`** (`in`, `scalar`): # of units; units: #. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_heat_capture_efficiency`** (`in`, `scalar`): Waste Heat -- Heat Capture Efficiency; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`capacity_per_unit_kw`** (`in`, `scalar`): Capacity per Unit; units: kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_selling_price_avoided_cost`** (`in`, `scalar`): Waste Heat -- Selling Price/Avoided Cost; units: USD/therm. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`electrical_efficiency`** (`in`, `scalar`): Initial Electrical Conversion Efficiency (Year 1); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`waste_heat_selling_price_escalation_factor`** (`in`, `scalar`): Waste Heat -- Selling Price Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`energy_content_per_cubic_foot`** (`in`, `scalar`): Energy Content per Cubic Foot; units: BTU/cubic foot. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`payment_duration_for_cost_based_tariff`** (`in`, `scalar`): Payment Duration for Cost-Based Tariff; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`availability`** (`in`, `scalar`): Availability; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_year_one_tariff_rate_escalated`** (`in`, `scalar`): % of Year-One Tariff Rate Escalated; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`parasitic_load`** (`in`, `scalar`): Station Service (Parasitic Load); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`cost_based_tariff_escalation_rate`** (`in`, `scalar`): Cost-Based Tariff Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`annual_stack_degradation`** (`in`, `scalar`): Annual Stack Degradation; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`stack_life`** (`in`, `scalar`): Stack Life; units: Hours. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`select_market_value_forecast_methodology`** (`in`, `scalar`): Select Market Value Forecast Methodology; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Year One | Year-by-Year.
- **`project_useful_life`** (`in`, `scalar`): Project Useful Life; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`value_of_energy_capacity_recs_yr_1`** (`in`, `scalar`): Value of energy, capacity & RECs, Yr 1; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`market_value_escalation_rate`** (`in`, `scalar`): Market Value Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`capital_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Simple | Intermediate | Complex.
- **`installed_cost_per_kw`** (`in`, `scalar`): Total Installed Cost; units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when capital_cost_detail = Simple; USD/kW (not USD/W).
- **`generation_equipment`** (`in`, `scalar`): Generation Equipment; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`federal_incentive_type`** (`in`, `scalar`): Select Form of Federal Incentives; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cost-Based | Performance-Based | Neither.
- **`balance_of_plant`** (`in`, `scalar`): Balance of Plant; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`federal_cost_incentive_form`** (`in`, `scalar`): Investment Tax Credit (ITC) or Cash Grant?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: ITC | Cash Grant.
- **`interconnection`** (`in`, `scalar`): Interconnection; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`itc_fraction`** (`in`, `scalar`): ITC or Cash Grant Amount ; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative. Active only when federal_incentive_type = Cost-Based and federal_cost_incentive_form = ITC.
- **`development_costs_fee`** (`in`, `scalar`): Development Costs & Fee; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`itc_utilization_factor_if_applicable`** (`in`, `scalar`): ITC utilization factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`is_pbi_tax_based_ptc_or_cash_based_repi`** (`in`, `scalar`): Is PBI Tax-Based (PTC) or Cash-Based (REPI)?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cash | Tax Credit.
- **`pbi_rate`** (`in`, `scalar`): PBI Rate; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_utilization_or_availability_factor_if_applicable`** (`in`, `scalar`): PBI Utilization or Availability Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_duration`** (`in`, `scalar`): PBI Duration; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_escalation_rate`** (`in`, `scalar`): PBI Escalation Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`om_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Simple | Intermediate.
- **`additional_federal_grants_other_than_section_1603`** (`in`, `scalar`): Additional Federal Grants (Other than Section 1603); units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`fixed_om_per_kw_year`** (`in`, `scalar`): Fixed O&M Expense, Yr 1; units: USD/kW-yr. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when om_cost_detail = Simple.
- **`federal_grants_treated_as_taxable_income`** (`in`, `scalar`): Federal Grants Treated as Taxable Income?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`variable_o_m_expense_yr_1`** (`in`, `scalar`): Variable O&M Expense, Yr 1; units: cents/kWh . Positive input unless explicitly an escalation factor; escalation may be negative.
- **`o_m_cost_inflation_initial_period`** (`in`, `scalar`): O&M Cost Inflation, initial period; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`initial_period_ends_last_day_of`** (`in`, `scalar`): Initial Period ends last day of:; units: year. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`select_form_of_state_incentive`** (`in`, `scalar`): Select Form of State Incentive; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cost-Based | Performance-Based | Neither.
- **`o_m_cost_inflation_thereafter`** (`in`, `scalar`): O&M Cost Inflation, thereafter; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`itc_amount`** (`in`, `scalar`): ITC Amount ; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`insurance_yr_1_of_total_cost`** (`in`, `scalar`): Insurance, Yr 1 (% of Total Cost); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`utilization_factor_if_applicable`** (`in`, `scalar`): Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_itc_realization_period`** (`in`, `scalar`): State ITC realization period; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`project_management_yr_1`** (`in`, `scalar`): Project Management Yr 1; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`fuel_cost_per_mmbtu`** (`in`, `scalar`): Fuel Cost  ; units: USD/MMBtu. Positive input unless explicitly an escalation factor; escalation may be negative. Active only when om_cost_detail = Intermediate; Simple O&M replaces the entire operating-cost schedule.
- **`is_performance_based_incentive_tax_credit_or_cash_pmt`** (`in`, `scalar`): Is Performance-Based Incentive Tax Credit or Cash Pmt?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Cash | Tax Credit.
- **`fuel_cost_escalation_factor`** (`in`, `scalar`): Fuel Cost Escalation Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`annual_cap_on_performance_based_incentive`** (`in`, `scalar`): Annual $ Cap on Performance-Based Incentive; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`property_tax_or_pilot_yr_1`** (`in`, `scalar`): Property Tax or PILOT, Yr 1; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`if_cash_is_state_pbi_or_rec_taxable`** (`in`, `scalar`): If cash, is state PBI or REC taxable?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`annual_property_tax_adjustment_factor`** (`in`, `scalar`): Annual Property Tax Adjustment Factor; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_or_rec_rate`** (`in`, `scalar`): PBI or REC Rate; units: cents/kWh. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`land_lease`** (`in`, `scalar`): Land Lease; units: USD/yr. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_utilization_factor_if_applicable`** (`in`, `scalar`): PBI Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`royalties_of_revenue`** (`in`, `scalar`): Royalties (% of revenue); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_or_rec_paymentduration`** (`in`, `scalar`): PBI or REC PaymentDuration; units: yrs. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`pbi_or_rec_escalation_rate_pos_or_neg`** (`in`, `scalar`): PBI or REC Escalation Rate (pos. or neg.); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`additional_state_rebates_grants`** (`in`, `scalar`): Additional State Rebates/Grants; units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`total_cap_on_state_rebates_grants`** (`in`, `scalar`): Total $ Cap on State Rebates/Grants; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`construction_period`** (`in`, `scalar`): Construction Period; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_grants_treated_as_taxable_income`** (`in`, `scalar`): State Grants Treated as Taxable Income?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`interest_rate_annual`** (`in`, `scalar`): Interest Rate (Annual); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`1st_replacement_cost_in_year_replaced`** (`in`, `scalar`): 1st Replacement Cost  ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`debt_fraction`** (`in`, `scalar`): % Debt (% of hard costs) (mortgage-style amort.); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`debt_term`** (`in`, `scalar`): Debt Term; units: years. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`2nd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 2nd Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`debt_interest_rate`** (`in`, `scalar`): Interest Rate on Term Debt; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`lender_s_fee_of_total_borrowing`** (`in`, `scalar`): Lender's Fee (% of total borrowing); units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`3rd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 3rd Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`required_minimum_annual_dscr`** (`in`, `scalar`): Required Minimum Annual DSCR; units: dimensionless or exact text enum. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`4th_replacement_cost_in_year_replaced`** (`in`, `scalar`): 4th Replacement Cost ($ in year replaced); units: USD/kW. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`capacity_increase_due_to_re_stacking`** (`in`, `scalar`): Capacity Increase Due To Re-Stacking; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`required_average_dscr`** (`in`, `scalar`): Required Average DSCR; units: dimensionless or exact text enum. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`fund_from_operations_or_salvage_value`** (`in`, `scalar`): Fund from Operations or Salvage Value?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Operations | Salvage.
- **`target_after_tax_equity_irr`** (`in`, `scalar`): Target After-Tax Equity IRR; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`reserve_requirement`** (`in`, `scalar`): Reserve Requirement; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`other_closing_costs`** (`in`, `scalar`): Other Closing Costs; units: USD. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_months_of_debt_service`** (`in`, `scalar`): # of months of Debt Service; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`of_months_of_o_m_expense`** (`in`, `scalar`): # of months of O&M Expense; units: months. Positive input unless explicitly an escalation factor; escalation may be negative.
- **`interest_on_all_reserves`** (`in`, `scalar`): Interest on All Reserves; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`is_owner_a_taxable_entity`** (`in`, `scalar`): Is owner a taxable entity?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: Yes | No.
- **`federal_income_tax_rate`** (`in`, `scalar`): Federal Income Tax Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`federal_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): Federal Tax Benefits used as generated or carried forward?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: As Generated | Carried Forward.
- **`state_income_tax_rate`** (`in`, `scalar`): State Income Tax Rate; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`state_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): State Tax Benefits used as generated or carried forward?; units: dimensionless or exact text enum. Case-sensitive source text. Allowed values: As Generated | Carried Forward.
- **`bonus_depreciation_enabled`** (`in`, `scalar`): Bonus depreciation enabled; units: enum Yes / No. Case-sensitive source text. Allowed values: Yes | No.
- **`bonus_depreciation_fraction`** (`in`, `scalar`): Fraction depreciated in year one; active when bonus_depreciation_enabled = Yes; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_total_installed_cost_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Total Installed Cost / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_generation_equipment_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Generation Equipment / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_balance_of_plant_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Balance of Plant / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Interconnection / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_interconnection_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Interconnection / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_development_costs_fee_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Development Costs & Fee / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_5_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 5-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_7_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 7-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_15_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 15-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_20_year_macrs`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 20-year MACRS; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_5_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 5-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_15_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 15-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`depreciation_reserves_financing_costs_20_year_sl`** (`in`, `scalar`): Depreciation allocation: Reserves & Financing Costs / 20-year SL; units: decimal fraction (0.30 = 30%). Positive input unless explicitly an escalation factor; escalation may be negative.
- **`year_one_coe_cents_per_kwh`** (`out`, `scalar`): Required first-year tariff; cents/kWh.
- **`nominal_lcoe_cents_per_kwh`** (`out`, `scalar`): Nominal levelized cost of energy; cents/kWh.
- **`year_one_energy_kwh`** (`out`, `scalar`): Net electricity after station service; kWh/year.
- **`net_installed_cost`** (`out`, `scalar`): Capital cost less grants; USD, positive cost.
- **`after_tax_equity_irr_year20`** (`out`, `scalar`): Actual cumulative equity IRR at year 20; decimal fraction, distinct from target.
- **`minimum_dscr_met`** (`out`, `scalar`): Minimum debt coverage covenant; Yes or No, see Inputs Worksheet.
- **`average_dscr_met`** (`out`, `scalar`): Average debt coverage covenant; Yes or No, see Inputs Worksheet.
- **`year_one_revenue`** (`out`, `scalar`): Revenue; USD/year, positive inflow.
- **`year_one_operating_expenses`** (`out`, `scalar`): Operating costs; USD/year, negative outflow.
- **`year_one_after_tax_cash_flow`** (`out`, `scalar`): Equity cash flow; USD, positive inflow / negative outflow.
- **`initial_equity_cash_flow`** (`out`, `scalar`): Initial equity investment; USD, negative outflow.
- **`year_one_dscr`** (`out`, `scalar`): Year-one debt service coverage; dimensionless ratio.

## Editorial & Version Notes

Three native What-If tables are recalculated at all 33 trial tariffs; midpoint rounding preserves 0.1-cent bracket resolution. Supported source tariff interval 0..100 cents/kWh. Complex year schedules can be edited with cellOverrides. Source edition metadata follows the supplied v1.4 catalog edition; source workbook does not establish current-law suitability.

---

# NREL CREST Geothermal Cash-Flow Model (v1.4)

> NREL CREST v1.4 geothermal cost-of-energy and project-finance model with tax incentives, debt service and after-tax equity returns.

- **Model ID**: `nrel-crest-geothermal@v1.4` (Package `1.4.0`)
- **Publisher**: [National Renewable Energy Laboratory (NREL / DOE)](https://www.nlr.gov/analysis/crest)
- **Source Workbook**: `nrel-crest-geothermal.xlsx` (`sha256:a2e19807723ad1d9c2b2818e268d48036529fede3a6532d0a65550e9553d6677`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression. Cascaded one-variable tariff tables are evaluated at each trial point; the final tariff uses the source 0.1-cent bracket midpoint, so target-return NPV need not be exactly zero.
- **Workbook Download**: `catalog-bytes`; source: https://www.nlr.gov/docs/libraries/analysis/nrel-crest-geothermal.xlsx?sfvrsn=983e9cd9_2; upstreamArtifact: null; catalog file size: 257243 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_geothermal_lcoe_check`

## Flows

### `quick_geothermal_lcoe_check` — Quick geothermal LCOE check (single)
Capacity, costs, O&M, debt and federal incentive sensitivity. Capacity factor is directly active in this edition. Simple cost modes activate the quick cost inputs; omitted inputs retain source defaults.
- **Inputs**: `system_size_mw`, `capacity_factor`, `capital_cost_detail`, `installed_cost_per_kw`, `om_cost_detail`, `fixed_om_per_kw_year`, `variable_om_cents_per_kwh`, `debt_fraction`, `debt_interest_rate`, `federal_incentive_type`, `federal_cost_incentive_form`, `itc_fraction`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year25`

### `full_geothermal_project_finance` — Full geothermal project finance (single)
All mapped Inputs assumptions and depreciation allocations, plus cash-flow and DSCR diagnostics. Complex Inputs schedules can be supplied through cellOverrides. Expenses and initial equity are negative USD; ratios and rates use decimal fractions.
- **Inputs**: `system_size_mw`, `payment_duration_for_cost_based_tariff`, `capacity_factor`, `of_year_one_tariff_rate_escalated`, `cost_based_tariff_escalation_rate`, `production_degradation_mode`, `annual_degradation`, `select_market_value_forecast_methodology`, `plant_to_thermal_ratio`, `value_of_energy_capacity_recs_yr_1`, `market_value_escalation_rate`, `thermal_degradation_mode`, `thermal_degradation`, `project_life_years`, `om_cost_detail`, `capital_cost_detail`, `o_m_cost_inflation_initial_period`, `installed_cost_per_kw`, `initial_period_ends_last_day_of`, `o_m_cost_inflation_thereafter`, `total_exploration_costs_before_time_value_of_investment`, `fixed_om_per_kw_year`, `exploration_well_drilling_success_rate`, `variable_om_cents_per_kwh`, `number_of_successful_exploration_wells_required`, `avg_cost_per_exploration_well`, `fixed_o_m_expense_yr_1`, `non_well_exploration_costs`, `variable_o_m_expense_yr_1`, `expected_return_on_exploration_capital_from_investment_to_cod`, `insurance_yr_1_of_total_cost`, `project_management_yr_1`, `property_tax_or_pilot_yr_1`, `annual_property_tax_adjustment_factor`, `confirmation_well_success_ratio`, `land_lease`, `number_of_successful_confirmation_wells_required`, `royalties_of_revenue`, `cost_per_confirmation_well`, `non_well_confirmation_costs`, `duration_of_confirmation_phase`, `of_confirmation_costs_financed_with_debt`, `1st_set_of_well_replacements`, `interest_rate_annual`, `of_wells_replaced`, `cost_per_replacement_well_in_year_replaced`, `annual_return_requirement_of_confirmation_stage_investors`, `resulting_increase_in_thermal_resource_potential`, `2nd_set_of_well_replacements`, `of_wells_replaced_q45`, `cost_per_replacement_well_in_year_replaced_q46`, `resulting_increase_in_thermal_resource_potential_q47`, `fund_from_operations_or_salvage_value`, `duration_of_construction_phase`, `reserve_requirement`, `of_construction_costs_financed_with_debt`, `interest_rate_annual_g54`, `federal_incentive_type`, `annual_return_requirement_of_construction_phase_equity_investors`, `federal_cost_incentive_form`, `itc_fraction`, `itc_utilization`, `total_production_wells_needed`, `ratio_of_injection_to_production_wells`, `is_pbi_tax_based_ptc_or_cash_based_repi`, `cost_per_production_well`, `pbi_rate`, `cost_per_injection_well`, `pbi_utilization_factor_if_applicable`, `non_drilling_wellfield_costs_excluding_confirmation_phase`, `pbi_duration`, `pbi_escalation_rate`, `power_plant_interconnection`, `additional_federal_grants_other_than_section_1603`, `federal_grants_treated_as_taxable_income`, `interconnection`, `select_form_of_state_incentive`, `itc_amount`, `utilization_factor_if_applicable`, `state_itc_realization_period`, `is_performance_based_incentive_tax_credit_or_cash_pmt`, `annual_cap_on_performance_based_incentive`, `if_cash_is_state_pbi_or_rec_taxable`, `pbi_or_rec_rate`, `pbi_utilization_factor_if_applicable_q78`, `debt_fraction`, `pbi_or_rec_paymentduration`, `debt_term_years`, `pbi_or_rec_escalation_rate_pos_or_neg`, `debt_interest_rate`, `additional_state_rebates_grants`, `lender_s_fee_of_total_borrowing`, `total_cap_on_state_rebates_grants`, `required_minimum_annual_dscr`, `state_grants_treated_as_taxable_income`, `required_average_dscr`, `bonus_depreciation_enabled`, `bonus_depreciation_fraction`, `target_after_tax_equity_irr`, `depreciation_total_installed_cost_p`, `depreciation_total_installed_cost_q`, `depreciation_total_installed_cost_r`, `depreciation_total_installed_cost_u`, `depreciation_total_installed_cost_v`, `depreciation_total_installed_cost_w`, `other_closing_costs`, `depreciation_exploration_costs_attributed_to_project_p`, `depreciation_exploration_costs_attributed_to_project_q`, `depreciation_exploration_costs_attributed_to_project_r`, `depreciation_exploration_costs_attributed_to_project_u`, `depreciation_exploration_costs_attributed_to_project_v`, `depreciation_exploration_costs_attributed_to_project_w`, `depreciation_confirmation_drilling_costs_p`, `depreciation_confirmation_drilling_costs_q`, `depreciation_confirmation_drilling_costs_r`, `depreciation_confirmation_drilling_costs_u`, `depreciation_confirmation_drilling_costs_v`, `depreciation_confirmation_drilling_costs_w`, `depreciation_power_plant_interconnection_p`, `depreciation_power_plant_interconnection_q`, `depreciation_power_plant_interconnection_r`, `depreciation_power_plant_interconnection_u`, `depreciation_power_plant_interconnection_v`, `depreciation_power_plant_interconnection_w`, `depreciation_interconnection_p`, `depreciation_interconnection_q`, `depreciation_interconnection_r`, `depreciation_interconnection_u`, `depreciation_interconnection_v`, `depreciation_interconnection_w`, `of_months_of_debt_service`, `depreciation_reserves_lender_fees_closing_costs_p`, `depreciation_reserves_lender_fees_closing_costs_q`, `depreciation_reserves_lender_fees_closing_costs_r`, `depreciation_reserves_lender_fees_closing_costs_u`, `depreciation_reserves_lender_fees_closing_costs_v`, `depreciation_reserves_lender_fees_closing_costs_w`, `of_months_of_o_m_expense`, `interest_on_all_reserves`, `is_owner_a_taxable_entity`, `federal_income_tax_rate`, `federal_tax_benefits_used_as_generated_or_carried_forward`, `state_income_tax_rate`, `state_tax_benefits_used_as_generated_or_carried_forward`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `effective_capacity_factor`, `minimum_dscr_met`, `average_dscr_met`, `target_equity_irr`, `target_return_equity_npv`, `minimum_dscr`, `average_dscr`, `year_one_revenue`, `year_one_operating_expenses`, `year_one_after_tax_cash_flow`, `initial_equity_cash_flow`, `after_tax_equity_irr_year20`, `after_tax_equity_irr_year25`

## SheetPort Ports (`fio.yaml`)

- **`system_size_mw`** (`in`, `scalar`): Generator Gross Nameplate Capacity; units: MW. Numeric costs are positive unless stated otherwise.
- **`payment_duration_for_cost_based_tariff`** (`in`, `scalar`): Payment Duration for Cost-Based Tariff; units: years. Numeric costs are positive unless stated otherwise.
- **`capacity_factor`** (`in`, `scalar`): Net Capacity Factor, Yr 1; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Directly active; this edition has no capacity-factor mode switch.
- **`of_year_one_tariff_rate_escalated`** (`in`, `scalar`): % of Year-One Tariff Rate Escalated; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`cost_based_tariff_escalation_rate`** (`in`, `scalar`): Cost-Based Tariff Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`production_degradation_mode`** (`in`, `scalar`): Select Production Degradation Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Annual, Year-by-Year.
- **`annual_degradation`** (`in`, `scalar`): Annual Plant Production Degradation; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when production_degradation_mode = Annual.
- **`select_market_value_forecast_methodology`** (`in`, `scalar`): Select Market Value Forecast Methodology; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Year One, Year-by-Year.
- **`plant_to_thermal_ratio`** (`in`, `scalar`): Ratio of Plant Capacity to Thermal Potential; units: ratio. Numeric costs are positive unless stated otherwise.
- **`value_of_energy_capacity_recs_yr_1`** (`in`, `scalar`): Value of energy, capacity & RECs, Yr 1; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`market_value_escalation_rate`** (`in`, `scalar`): Market Value Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`thermal_degradation_mode`** (`in`, `scalar`): Select Thermal Resource Degradation Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Annual, Year-by-Year.
- **`thermal_degradation`** (`in`, `scalar`): Annual Degradation of Thermal Resource; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when thermal_degradation_mode = Annual.
- **`project_life_years`** (`in`, `scalar`): Project Useful Life; units: years. Numeric costs are positive unless stated otherwise.
- **`om_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Simple, Intermediate.
- **`capital_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Simple, Intermediate, Complex.
- **`o_m_cost_inflation_initial_period`** (`in`, `scalar`): O&M Cost Inflation, initial period; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`installed_cost_per_kw`** (`in`, `scalar`): Installed Cost, excluding exploration costs; units: USD/kW. Numeric costs are positive unless stated otherwise. Active only when capital_cost_detail = Simple. Excludes exploration costs and retains workbook phase-finance uplift.
- **`initial_period_ends_last_day_of`** (`in`, `scalar`): Initial Period ends last day of:; units: year. Numeric costs are positive unless stated otherwise.
- **`o_m_cost_inflation_thereafter`** (`in`, `scalar`): O&M Cost Inflation, thereafter; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`total_exploration_costs_before_time_value_of_investment`** (`in`, `scalar`): Total Exploration Costs (before time-value of investment); units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`fixed_om_per_kw_year`** (`in`, `scalar`): Fixed O&M Expense, Yr 1; units: USD/kW/year. Numeric costs are positive unless stated otherwise. Active only when om_cost_detail = Simple.
- **`exploration_well_drilling_success_rate`** (`in`, `scalar`): Exploration Well Drilling Success Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`variable_om_cents_per_kwh`** (`in`, `scalar`): Variable O&M Expense, Yr 1; units: ¢/kWh . Numeric costs are positive unless stated otherwise. Active only when om_cost_detail = Simple.
- **`number_of_successful_exploration_wells_required`** (`in`, `scalar`): Number of Successful Exploration Wells Required; units: #. Numeric costs are positive unless stated otherwise.
- **`avg_cost_per_exploration_well`** (`in`, `scalar`): Avg cost per exploration well; units: $/Well. Numeric costs are positive unless stated otherwise.
- **`fixed_o_m_expense_yr_1`** (`in`, `scalar`): Fixed O&M Expense, Yr 1; units: USD/kW/year. Numeric costs are positive unless stated otherwise.
- **`non_well_exploration_costs`** (`in`, `scalar`): Non-well exploration costs; units: USD. Numeric costs are positive unless stated otherwise.
- **`variable_o_m_expense_yr_1`** (`in`, `scalar`): Variable O&M Expense, Yr 1; units: ¢/kWh . Numeric costs are positive unless stated otherwise.
- **`expected_return_on_exploration_capital_from_investment_to_cod`** (`in`, `scalar`): Expected Return on Exploration Capital (from investment to COD); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`insurance_yr_1_of_total_cost`** (`in`, `scalar`): Insurance, Yr 1 (% of Total Cost); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`project_management_yr_1`** (`in`, `scalar`): Project Management Yr 1; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`property_tax_or_pilot_yr_1`** (`in`, `scalar`): Property Tax or PILOT, Yr 1; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`annual_property_tax_adjustment_factor`** (`in`, `scalar`): Annual Property Tax Adjustment Factor; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`confirmation_well_success_ratio`** (`in`, `scalar`): Confirmation well success ratio; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`land_lease`** (`in`, `scalar`): Land Lease; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`number_of_successful_confirmation_wells_required`** (`in`, `scalar`): Number of successful confirmation wells required; units: #. Numeric costs are positive unless stated otherwise.
- **`royalties_of_revenue`** (`in`, `scalar`): Royalties (% of revenue); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`cost_per_confirmation_well`** (`in`, `scalar`): Cost per confirmation well; units: USD. Numeric costs are positive unless stated otherwise.
- **`non_well_confirmation_costs`** (`in`, `scalar`): Non-well confirmation costs; units: USD. Numeric costs are positive unless stated otherwise.
- **`duration_of_confirmation_phase`** (`in`, `scalar`): Duration of Confirmation Phase; units: years. Numeric costs are positive unless stated otherwise.
- **`of_confirmation_costs_financed_with_debt`** (`in`, `scalar`): % of Confirmation Costs Financed with Debt; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`1st_set_of_well_replacements`** (`in`, `scalar`): 1st Set of Well Replacements; units: year. Numeric costs are positive unless stated otherwise.
- **`interest_rate_annual`** (`in`, `scalar`): Interest Rate (Annual); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`of_wells_replaced`** (`in`, `scalar`): # of Wells Replaced; units: #. Numeric costs are positive unless stated otherwise.
- **`cost_per_replacement_well_in_year_replaced`** (`in`, `scalar`): Cost per Replacement Well  ($ in year replaced); units: USD. Numeric costs are positive unless stated otherwise.
- **`annual_return_requirement_of_confirmation_stage_investors`** (`in`, `scalar`): Annual Return Requirement of Confirmation Stage Investors; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`resulting_increase_in_thermal_resource_potential`** (`in`, `scalar`): Resulting Increase in Thermal Resource Potential; units: % of initial. Numeric costs are positive unless stated otherwise.
- **`2nd_set_of_well_replacements`** (`in`, `scalar`): 2nd Set of Well Replacements; units: year. Numeric costs are positive unless stated otherwise.
- **`of_wells_replaced_q45`** (`in`, `scalar`): # of Wells Replaced; units: #. Numeric costs are positive unless stated otherwise.
- **`cost_per_replacement_well_in_year_replaced_q46`** (`in`, `scalar`): Cost per Replacement Well  ($ in year replaced); units: USD. Numeric costs are positive unless stated otherwise.
- **`resulting_increase_in_thermal_resource_potential_q47`** (`in`, `scalar`): Resulting Increase in Thermal Resource Potential; units: % of initial. Numeric costs are positive unless stated otherwise.
- **`fund_from_operations_or_salvage_value`** (`in`, `scalar`): Fund from Operations or Salvage Value?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Operations, Salvage.
- **`duration_of_construction_phase`** (`in`, `scalar`): Duration of Construction Phase; units: years. Numeric costs are positive unless stated otherwise.
- **`reserve_requirement`** (`in`, `scalar`): Reserve Requirement; units: USD. Numeric costs are positive unless stated otherwise.
- **`of_construction_costs_financed_with_debt`** (`in`, `scalar`): % of Construction Costs Financed with Debt; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`interest_rate_annual_g54`** (`in`, `scalar`): Interest Rate (Annual); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`federal_incentive_type`** (`in`, `scalar`): Select Form of Federal Incentive; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cost-Based, Performance-Based, Neither.
- **`annual_return_requirement_of_construction_phase_equity_investors`** (`in`, `scalar`): Annual Return Requirement of Construction Phase Equity Investors; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`federal_cost_incentive_form`** (`in`, `scalar`): Investment Tax Credit (ITC) or Cash Grant?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: ITC, Cash Grant.
- **`itc_fraction`** (`in`, `scalar`): ITC or Cash Grant Amount ; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when federal_incentive_type = Cost-Based; federal_cost_incentive_form selects ITC or Cash Grant.
- **`itc_utilization`** (`in`, `scalar`): ITC utilization factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`total_production_wells_needed`** (`in`, `scalar`): Total Production Wells Needed; units: #. Numeric costs are positive unless stated otherwise.
- **`ratio_of_injection_to_production_wells`** (`in`, `scalar`): Ratio of Injection to Production Wells; units: ratio. Numeric costs are positive unless stated otherwise.
- **`is_pbi_tax_based_ptc_or_cash_based_repi`** (`in`, `scalar`): Is PBI Tax-Based (PTC) or Cash-Based (REPI)?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cash, Tax Credit.
- **`cost_per_production_well`** (`in`, `scalar`): Cost per production well; units: USD. Numeric costs are positive unless stated otherwise.
- **`pbi_rate`** (`in`, `scalar`): PBI Rate; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`cost_per_injection_well`** (`in`, `scalar`): Cost per injection well; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise.
- **`pbi_utilization_factor_if_applicable`** (`in`, `scalar`): PBI Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`non_drilling_wellfield_costs_excluding_confirmation_phase`** (`in`, `scalar`): Non-Drilling Wellfield Costs (excluding confirmation phase); units: USD. Numeric costs are positive unless stated otherwise.
- **`pbi_duration`** (`in`, `scalar`): PBI Duration; units: yrs. Numeric costs are positive unless stated otherwise.
- **`pbi_escalation_rate`** (`in`, `scalar`): PBI Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`power_plant_interconnection`** (`in`, `scalar`): Power Plant & Interconnection; units: USD. Numeric costs are positive unless stated otherwise.
- **`additional_federal_grants_other_than_section_1603`** (`in`, `scalar`): Additional Federal Grants (Other than Section 1603); units: USD. Numeric costs are positive unless stated otherwise.
- **`federal_grants_treated_as_taxable_income`** (`in`, `scalar`): Federal Grants Treated as Taxable Income?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`interconnection`** (`in`, `scalar`): Interconnection; units: USD. Numeric costs are positive unless stated otherwise.
- **`select_form_of_state_incentive`** (`in`, `scalar`): Select Form of State Incentive; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cost-Based, Performance-Based, Neither.
- **`itc_amount`** (`in`, `scalar`): ITC Amount ; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`utilization_factor_if_applicable`** (`in`, `scalar`): Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`state_itc_realization_period`** (`in`, `scalar`): State ITC realization period; units: yrs. Numeric costs are positive unless stated otherwise.
- **`is_performance_based_incentive_tax_credit_or_cash_pmt`** (`in`, `scalar`): Is Performance-Based Incentive Tax Credit or Cash Pmt?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cash, Tax Credit.
- **`annual_cap_on_performance_based_incentive`** (`in`, `scalar`): Annual $ Cap on Performance-Based Incentive; units: USD. Numeric costs are positive unless stated otherwise.
- **`if_cash_is_state_pbi_or_rec_taxable`** (`in`, `scalar`): If cash, is state PBI or REC taxable?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`pbi_or_rec_rate`** (`in`, `scalar`): PBI or REC Rate; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`pbi_utilization_factor_if_applicable_q78`** (`in`, `scalar`): PBI Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`debt_fraction`** (`in`, `scalar`): % Debt (% of hard costs) (mortgage-style amort.); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`pbi_or_rec_paymentduration`** (`in`, `scalar`): PBI or REC PaymentDuration; units: yrs. Numeric costs are positive unless stated otherwise.
- **`debt_term_years`** (`in`, `scalar`): Debt Term; units: years. Numeric costs are positive unless stated otherwise.
- **`pbi_or_rec_escalation_rate_pos_or_neg`** (`in`, `scalar`): PBI or REC Escalation Rate (pos. or neg.); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`debt_interest_rate`** (`in`, `scalar`): Interest Rate on Term Debt; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`additional_state_rebates_grants`** (`in`, `scalar`): Additional State Rebates/Grants; units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`lender_s_fee_of_total_borrowing`** (`in`, `scalar`): Lender's Fee (% of total borrowing); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`total_cap_on_state_rebates_grants`** (`in`, `scalar`): Total $ Cap on State Rebates/Grants; units: USD. Numeric costs are positive unless stated otherwise.
- **`required_minimum_annual_dscr`** (`in`, `scalar`): Required Minimum Annual DSCR; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise.
- **`state_grants_treated_as_taxable_income`** (`in`, `scalar`): State Grants Treated as Taxable Income?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`required_average_dscr`** (`in`, `scalar`): Required Average DSCR; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise.
- **`bonus_depreciation_enabled`** (`in`, `scalar`): Bonus depreciation switch. Allowed values: Yes, No.
- **`bonus_depreciation_fraction`** (`in`, `scalar`): % Bonus Depreciation, Yr 1, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when bonus_depreciation_enabled = Yes and owner is taxable.
- **`target_after_tax_equity_irr`** (`in`, `scalar`): Target After-Tax Equity IRR; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`depreciation_total_installed_cost_p`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_q`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_r`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_u`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_v`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_w`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`other_closing_costs`** (`in`, `scalar`): Other Closing Costs; units: USD. Numeric costs are positive unless stated otherwise.
- **`depreciation_exploration_costs_attributed_to_project_p`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_exploration_costs_attributed_to_project_q`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_exploration_costs_attributed_to_project_r`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_exploration_costs_attributed_to_project_u`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_exploration_costs_attributed_to_project_v`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_exploration_costs_attributed_to_project_w`** (`in`, `scalar`): Exploration Costs Attributed to Project; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_p`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_q`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_r`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_u`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_v`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_confirmation_drilling_costs_w`** (`in`, `scalar`): Confirmation Drilling Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_p`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_q`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_r`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_u`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_v`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_power_plant_interconnection_w`** (`in`, `scalar`): Power Plant & Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_p`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_q`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_r`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_u`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_v`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_w`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`of_months_of_debt_service`** (`in`, `scalar`): # of months of Debt Service; units: months. Numeric costs are positive unless stated otherwise.
- **`depreciation_reserves_lender_fees_closing_costs_p`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_lender_fees_closing_costs_q`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_lender_fees_closing_costs_r`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_lender_fees_closing_costs_u`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_lender_fees_closing_costs_v`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Depletion; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_lender_fees_closing_costs_w`** (`in`, `scalar`): Reserves, Lender Fees & Closing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Yr 1 Expensing; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`of_months_of_o_m_expense`** (`in`, `scalar`): # of months of O&M Expense; units: months. Numeric costs are positive unless stated otherwise.
- **`interest_on_all_reserves`** (`in`, `scalar`): Interest on All Reserves; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`is_owner_a_taxable_entity`** (`in`, `scalar`): Is owner a taxable entity?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`federal_income_tax_rate`** (`in`, `scalar`): Federal Income Tax Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`federal_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): Federal Tax Benefits used as generated or carried forward?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: As Generated, Carried Forward.
- **`state_income_tax_rate`** (`in`, `scalar`): State Income Tax Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`state_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): State Tax Benefits used as generated or carried forward?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: As Generated, Carried Forward.
- **`year_one_coe_cents_per_kwh`** (`out`, `scalar`): cents/kWh; year-one tariff, rounded to the midpoint of the 0.1-cent CREST bracket
- **`nominal_lcoe_cents_per_kwh`** (`out`, `scalar`): cents/kWh; nominal levelized cost of energy
- **`year_one_energy_kwh`** (`out`, `scalar`): kWh/year; positive generation
- **`net_installed_cost`** (`out`, `scalar`): USD; positive net capital cost
- **`effective_capacity_factor`** (`out`, `scalar`): decimal fraction
- **`minimum_dscr_met`** (`out`, `scalar`): Yes or failure message; lender minimum DSCR test
- **`average_dscr_met`** (`out`, `scalar`): Yes or failure message; lender average DSCR test
- **`target_equity_irr`** (`out`, `scalar`): decimal fraction; target assumption, not the achieved IRR
- **`target_return_equity_npv`** (`out`, `scalar`): USD; target-return NPV at the solved tariff, residual remains because the tariff uses a 0.1-cent bracket
- **`minimum_dscr`** (`out`, `scalar`): ratio; minimum annual debt service coverage
- **`average_dscr`** (`out`, `scalar`): ratio; average annual debt service coverage
- **`year_one_revenue`** (`out`, `scalar`): USD; positive revenue
- **`year_one_operating_expenses`** (`out`, `scalar`): USD; expenses are negative
- **`year_one_after_tax_cash_flow`** (`out`, `scalar`): USD; positive inflow, negative outflow
- **`initial_equity_cash_flow`** (`out`, `scalar`): USD; negative initial equity investment
- **`after_tax_equity_irr_year20`** (`out`, `scalar`): decimal fraction; cumulative equity IRR through year 20
- **`after_tax_equity_irr_year25`** (`out`, `scalar`): decimal fraction; cumulative equity IRR through year 25

## Editorial & Version Notes

Historical CREST v1.4 assumptions retain the source tax and incentive defaults. Tariff is the source 0.1-cent bracket midpoint, so target-return NPV need not be exactly zero. Perturbed scenarios are WASM regression vectors; only baseline values have an independent original Excel cache oracle. Cash flows with multiple sign changes may have multiple IRR roots.

---

# NREL CREST Solar Cash-Flow Model (v1.4)

> NREL/DOE Cost of Renewable Energy Spreadsheet Tool (CREST v1.4) for solar PV cost of energy (COE/LCOE), project finance debt sizing, MACRS/ITC tax credits, and 25-year after-tax equity IRR.

- **Model ID**: `nrel-crest-solar@v1.4` (Package `1.4.0`)
- **Publisher**: [National Renewable Energy Laboratory (NREL / DOE)](https://www.nlr.gov/analysis/crest)
- **Source Workbook**: `nrel-crest-solar.xlsx` (`sha256:9169f5cf975e798f791b08d3d55b9a91642d7719414e7f8bbc6325e6372f5f73`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression. Uses a JavaScript 33-trial What-If data-table solver with the Formualizer WASM engine. Baseline outputs match source Excel caches; changed-input expectations are engine-generated regression vectors, not independent Excel recalculations.
- **Workbook Download**: `catalog-bytes`; source: https://www.nlr.gov/docs/libraries/analysis/nrel-crest-solar.xlsx?sfvrsn=3cdfaa3b_2; upstreamArtifact: null; catalog file size: 217501 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_solar_lcoe_check`

## Flows

### `quick_solar_lcoe_check` — Quick solar LCOE check (single)
Curated solar sizing, capex/O&M, debt, and ITC sensitivity returning Year-1 COE, Nominal LCOE, Year-1 generation, Net Installed Cost, and Year-25 After-Tax Equity IRR.
- **Inputs**: `system_size_kw`, `capacity_factor_mode`, `capacity_factor`, `capital_cost_detail`, `installed_cost_per_watt`, `om_cost_detail`, `fixed_om_per_kw_year`, `debt_fraction`, `debt_interest_rate`, `federal_incentive_type`, `federal_cost_incentive_form`, `itc_fraction`
- **Outputs**: `nominal_lcoe_cents_per_kwh`, `year_one_coe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year25`

### `full_project_finance_model` — Full project finance model (single)
All mapped Inputs assumptions including financing, taxes, incentive modes, reserves and depreciation. Complex Inputs year-by-year tables require cellOverrides. Finance results use the JavaScript What-If solver and scenario-engine-regression evidence.
- **Inputs**: `technology`, `system_size_kw`, `capacity_factor_mode`, `state`, `capacity_factor`, `annual_degradation`, `project_life_years`, `capital_cost_detail`, `installed_cost_per_watt`, `generation_equipment_cost`, `balance_of_plant_cost`, `interconnection_cost`, `development_cost`, `om_cost_detail`, `fixed_om_per_kw_year`, `variable_om_cents_per_kwh`, `om_inflation_initial`, `om_initial_period_years`, `om_inflation_later`, `insurance_fraction`, `project_management_annual`, `property_tax_annual`, `property_tax_adjustment`, `land_lease_annual`, `royalties_fraction`, `construction_months`, `construction_interest_rate`, `debt_fraction`, `debt_term_years`, `debt_interest_rate`, `lender_fee_fraction`, `minimum_dscr_required`, `average_dscr_required`, `target_after_tax_equity_irr`, `other_closing_costs`, `taxable_owner`, `federal_tax_rate`, `federal_tax_benefit_timing`, `state_tax_rate`, `state_tax_benefit_timing`, `tariff_duration_years`, `tariff_escalated_fraction`, `tariff_escalation_rate`, `market_value_mode`, `market_value_cents_per_kwh`, `market_value_escalation`, `federal_incentive_type`, `federal_cost_incentive_form`, `itc_fraction`, `itc_utilization`, `federal_pbi_form`, `federal_pbi_cents_per_kwh`, `federal_pbi_utilization`, `federal_pbi_years`, `federal_pbi_escalation`, `federal_grants`, `federal_grants_taxable`, `state_incentive_type`, `state_itc_fraction`, `state_itc_utilization`, `state_itc_years`, `state_pbi_form`, `state_pbi_annual_cap`, `state_pbi_taxable`, `state_pbi_cents_per_kwh`, `state_pbi_utilization`, `state_pbi_years`, `state_pbi_escalation`, `state_grants_per_watt`, `state_grants_cap`, `state_grants_taxable`, `first_inverter_replacement_year`, `first_inverter_replacement_per_watt`, `second_inverter_replacement_year`, `second_inverter_replacement_per_watt`, `decommissioning_funding`, `decommissioning_reserve`, `debt_reserve_months`, `om_reserve_months`, `reserve_interest_rate`, `bonus_depreciation_enabled`, `bonus_depreciation_fraction`, `depreciation_simple_total_macrs5`, `depreciation_simple_total_macrs7`, `depreciation_simple_total_macrs15`, `depreciation_simple_total_macrs20`, `depreciation_simple_total_sl5`, `depreciation_simple_total_sl15`, `depreciation_simple_total_sl20`, `depreciation_simple_total_sl39`, `depreciation_simple_total_nondepreciable`, `depreciation_generation_macrs5`, `depreciation_generation_macrs7`, `depreciation_generation_macrs15`, `depreciation_generation_macrs20`, `depreciation_generation_sl5`, `depreciation_generation_sl15`, `depreciation_generation_sl20`, `depreciation_generation_sl39`, `depreciation_generation_nondepreciable`, `depreciation_balance_of_plant_macrs5`, `depreciation_balance_of_plant_macrs7`, `depreciation_balance_of_plant_macrs15`, `depreciation_balance_of_plant_macrs20`, `depreciation_balance_of_plant_sl5`, `depreciation_balance_of_plant_sl15`, `depreciation_balance_of_plant_sl20`, `depreciation_balance_of_plant_sl39`, `depreciation_balance_of_plant_nondepreciable`, `depreciation_interconnection_macrs5`, `depreciation_interconnection_macrs7`, `depreciation_interconnection_macrs15`, `depreciation_interconnection_macrs20`, `depreciation_interconnection_sl5`, `depreciation_interconnection_sl15`, `depreciation_interconnection_sl20`, `depreciation_interconnection_sl39`, `depreciation_interconnection_nondepreciable`, `depreciation_development_macrs5`, `depreciation_development_macrs7`, `depreciation_development_macrs15`, `depreciation_development_macrs20`, `depreciation_development_sl5`, `depreciation_development_sl15`, `depreciation_development_sl20`, `depreciation_development_sl39`, `depreciation_development_nondepreciable`, `depreciation_soft_costs_macrs5`, `depreciation_soft_costs_macrs7`, `depreciation_soft_costs_macrs15`, `depreciation_soft_costs_macrs20`, `depreciation_soft_costs_sl5`, `depreciation_soft_costs_sl15`, `depreciation_soft_costs_sl20`, `depreciation_soft_costs_sl39`, `depreciation_soft_costs_nondepreciable`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `effective_capacity_factor`, `net_installed_cost`, `net_installed_cost_per_watt`, `minimum_dscr_met`, `average_dscr_met`, `target_equity_irr`, `after_tax_equity_irr_year25`, `year_one_revenue`, `year_one_operating_expenses`, `year_one_after_tax_cash_flow`, `initial_equity_cash_flow`, `installed_cost_total`, `minimum_dscr`, `average_dscr`

## SheetPort Ports (`fio.yaml`)

- **`technology`** (`in`, `scalar`): Selected Technology
- **`system_size_kw`** (`in`, `scalar`): Generator Nameplate Capacity
- **`capacity_factor_mode`** (`in`, `scalar`): Net Capacity Factor: Select "State Average" or "Custom" →
- **`state`** (`in`, `scalar`): Net C.F.: If "State Average" method, then select state →
- **`capacity_factor`** (`in`, `scalar`): Net C.F.: If "Custom" method, then enter Net C.F. →; decimal fraction (0.30 = 30%). Active only when capacity_factor_mode is Custom.
- **`annual_degradation`** (`in`, `scalar`): Annual Production Degradation
- **`project_life_years`** (`in`, `scalar`): Project Useful Life
- **`capital_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail
- **`installed_cost_per_watt`** (`in`, `scalar`): Total Installed Cost Active only when capital_cost_detail is Simple.
- **`generation_equipment_cost`** (`in`, `scalar`): Generation Equipment
- **`balance_of_plant_cost`** (`in`, `scalar`): Balance of Plant
- **`interconnection_cost`** (`in`, `scalar`): Interconnection
- **`development_cost`** (`in`, `scalar`): Development Costs & Fee
- **`om_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail
- **`fixed_om_per_kw_year`** (`in`, `scalar`): Fixed O&M Expense, Yr 1
- **`variable_om_cents_per_kwh`** (`in`, `scalar`): Variable O&M Expense, Yr 1
- **`om_inflation_initial`** (`in`, `scalar`): O&M Cost Inflation, initial period
- **`om_initial_period_years`** (`in`, `scalar`): Initial Period ends last day of:
- **`om_inflation_later`** (`in`, `scalar`): O&M Cost Inflation, thereafter
- **`insurance_fraction`** (`in`, `scalar`): Insurance, Yr 1 (% of Total Cost)
- **`project_management_annual`** (`in`, `scalar`): Project Management Yr 1
- **`property_tax_annual`** (`in`, `scalar`): Property Tax or PILOT, Yr 1
- **`property_tax_adjustment`** (`in`, `scalar`): Annual Property Tax Adjustment Factor
- **`land_lease_annual`** (`in`, `scalar`): Land Lease
- **`royalties_fraction`** (`in`, `scalar`): Royalties (% of revenue)
- **`construction_months`** (`in`, `scalar`): Construction Period
- **`construction_interest_rate`** (`in`, `scalar`): Interest Rate (Annual)
- **`debt_fraction`** (`in`, `scalar`): % Debt (% of hard costs) (mortgage-style amort.); decimal fraction (0.30 = 30%).
- **`debt_term_years`** (`in`, `scalar`): Debt Term
- **`debt_interest_rate`** (`in`, `scalar`): Interest Rate on Term Debt; decimal fraction (0.30 = 30%).
- **`lender_fee_fraction`** (`in`, `scalar`): Lender's Fee (% of total borrowing)
- **`minimum_dscr_required`** (`in`, `scalar`): Required Minimum Annual DSCR
- **`average_dscr_required`** (`in`, `scalar`): Required Average DSCR
- **`target_after_tax_equity_irr`** (`in`, `scalar`): Target After-Tax Equity IRR
- **`other_closing_costs`** (`in`, `scalar`): Other Closing Costs
- **`taxable_owner`** (`in`, `scalar`): Is owner a taxable entity?
- **`federal_tax_rate`** (`in`, `scalar`): Federal Income Tax Rate
- **`federal_tax_benefit_timing`** (`in`, `scalar`): Federal Tax Benefits used as generated or carried forward?
- **`state_tax_rate`** (`in`, `scalar`): State Income Tax Rate
- **`state_tax_benefit_timing`** (`in`, `scalar`): State Tax Benefits used as generated or carried forward?
- **`tariff_duration_years`** (`in`, `scalar`): Payment Duration for Cost-Based Tariff
- **`tariff_escalated_fraction`** (`in`, `scalar`): % of Year-One Tariff Rate Escalated
- **`tariff_escalation_rate`** (`in`, `scalar`): Cost-Based Tariff Escalation Rate
- **`market_value_mode`** (`in`, `scalar`): Select Market Value Forecast Methodology
- **`market_value_cents_per_kwh`** (`in`, `scalar`): Value of energy, capacity & RECs, Yr 1
- **`market_value_escalation`** (`in`, `scalar`): Market Value Escalation Rate
- **`federal_incentive_type`** (`in`, `scalar`): Select Form of Federal Incentive
- **`federal_cost_incentive_form`** (`in`, `scalar`): Investment Tax Credit (ITC) or Cash Grant?
- **`itc_fraction`** (`in`, `scalar`): ITC or Cash Grant Amount ; decimal fraction (0.30 = 30%). Select federal_incentive_type Cost-Based and federal_cost_incentive_form ITC to activate tax credit.
- **`itc_utilization`** (`in`, `scalar`): ITC utilization factor, if applicable
- **`federal_pbi_form`** (`in`, `scalar`): Is PBI Tax-Based (PTC) or Cash-Based (REPI)?
- **`federal_pbi_cents_per_kwh`** (`in`, `scalar`): PBI Rate
- **`federal_pbi_utilization`** (`in`, `scalar`): PBI Utilization or Availability Factor, if applicable
- **`federal_pbi_years`** (`in`, `scalar`): PBI Duration
- **`federal_pbi_escalation`** (`in`, `scalar`): PBI Escalation Rate
- **`federal_grants`** (`in`, `scalar`): Additional Federal Grants (Other than Section 1603)
- **`federal_grants_taxable`** (`in`, `scalar`): Federal Grants Treated as Taxable Income?
- **`state_incentive_type`** (`in`, `scalar`): Select Form of State Incentive
- **`state_itc_fraction`** (`in`, `scalar`): ITC Amount 
- **`state_itc_utilization`** (`in`, `scalar`): Utilization Factor, if applicable
- **`state_itc_years`** (`in`, `scalar`): State ITC realization period
- **`state_pbi_form`** (`in`, `scalar`): Is Performance-Based Incentive Tax Credit or Cash Pmt?
- **`state_pbi_annual_cap`** (`in`, `scalar`): Annual $ Cap on Performance-Based Incentive
- **`state_pbi_taxable`** (`in`, `scalar`): If cash, is state PBI or REC taxable?
- **`state_pbi_cents_per_kwh`** (`in`, `scalar`): PBI or REC Rate
- **`state_pbi_utilization`** (`in`, `scalar`): PBI Utilization Factor, if applicable
- **`state_pbi_years`** (`in`, `scalar`): PBI or REC Payment Duration
- **`state_pbi_escalation`** (`in`, `scalar`): PBI or REC Escalation Rate (pos. or neg.)
- **`state_grants_per_watt`** (`in`, `scalar`): Additional State Rebates/Grants
- **`state_grants_cap`** (`in`, `scalar`): Total $ Cap on State Rebates/Grants
- **`state_grants_taxable`** (`in`, `scalar`): State Rebates/Grants Treated as Taxable Income?
- **`first_inverter_replacement_year`** (`in`, `scalar`): 1st Equipment Replacement
- **`first_inverter_replacement_per_watt`** (`in`, `scalar`): 1st Replacement Cost  ($ in year replaced)
- **`second_inverter_replacement_year`** (`in`, `scalar`): 2nd Equipment Replacement 
- **`second_inverter_replacement_per_watt`** (`in`, `scalar`): 2nd Replacement Cost ($ in year replaced)
- **`decommissioning_funding`** (`in`, `scalar`): Fund from Operations or Salvage Value?
- **`decommissioning_reserve`** (`in`, `scalar`): Reserve Requirement
- **`debt_reserve_months`** (`in`, `scalar`): # of months of Debt Service
- **`om_reserve_months`** (`in`, `scalar`): # of months of O&M Expense
- **`reserve_interest_rate`** (`in`, `scalar`): Interest on All Reserves
- **`bonus_depreciation_enabled`** (`in`, `scalar`): Bonus Depreciation
- **`bonus_depreciation_fraction`** (`in`, `scalar`): % of Bonus Depreciation applied in Year 1
- **`depreciation_simple_total_macrs5`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_macrs7`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_macrs15`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_macrs20`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_sl5`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_sl15`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_sl20`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_sl39`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_simple_total_nondepreciable`** (`in`, `scalar`): Total Installed Cost
- **`depreciation_generation_macrs5`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_macrs7`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_macrs15`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_macrs20`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_sl5`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_sl15`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_sl20`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_sl39`** (`in`, `scalar`): Generation Equipment
- **`depreciation_generation_nondepreciable`** (`in`, `scalar`): Generation Equipment
- **`depreciation_balance_of_plant_macrs5`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_macrs7`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_macrs15`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_macrs20`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_sl5`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_sl15`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_sl20`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_sl39`** (`in`, `scalar`): Balance of Plant
- **`depreciation_balance_of_plant_nondepreciable`** (`in`, `scalar`): Balance of Plant
- **`depreciation_interconnection_macrs5`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_macrs7`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_macrs15`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_macrs20`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_sl5`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_sl15`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_sl20`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_sl39`** (`in`, `scalar`): Interconnection
- **`depreciation_interconnection_nondepreciable`** (`in`, `scalar`): Interconnection
- **`depreciation_development_macrs5`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_macrs7`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_macrs15`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_macrs20`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_sl5`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_sl15`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_sl20`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_sl39`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_development_nondepreciable`** (`in`, `scalar`): Development Costs & Fee
- **`depreciation_soft_costs_macrs5`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_macrs7`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_macrs15`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_macrs20`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_sl5`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_sl15`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_sl20`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_sl39`** (`in`, `scalar`): Reserves & Financing Costs
- **`depreciation_soft_costs_nondepreciable`** (`in`, `scalar`): Reserves & Financing Costs
- **`year_one_coe_cents_per_kwh`** (`out`, `scalar`): Year one coe cents per kwh.
- **`nominal_lcoe_cents_per_kwh`** (`out`, `scalar`): Nominal lcoe cents per kwh.
- **`year_one_energy_kwh`** (`out`, `scalar`): Year one energy kwh.
- **`effective_capacity_factor`** (`out`, `scalar`): Effective capacity factor.
- **`net_installed_cost`** (`out`, `scalar`): Net installed cost.
- **`net_installed_cost_per_watt`** (`out`, `scalar`): Net installed cost per watt.
- **`minimum_dscr_met`** (`out`, `scalar`): Minimum dscr met.
- **`average_dscr_met`** (`out`, `scalar`): Average dscr met.
- **`target_equity_irr`** (`out`, `scalar`): Target equity irr.
- **`after_tax_equity_irr_year25`** (`out`, `scalar`): Actual cumulative after-tax equity IRR at fixed year 25; use selectCells for other project lives.
- **`year_one_revenue`** (`out`, `scalar`): Year one revenue.
- **`year_one_operating_expenses`** (`out`, `scalar`): Year one operating expenses.
- **`year_one_after_tax_cash_flow`** (`out`, `scalar`): Year one after tax cash flow.
- **`initial_equity_cash_flow`** (`out`, `scalar`): Initial equity cash flow.
- **`installed_cost_total`** (`out`, `scalar`): Installed cost total.
- **`minimum_dscr`** (`out`, `scalar`): Minimum dscr.
- **`average_dscr`** (`out`, `scalar`): Average dscr.

## Editorial & Version Notes

Historical tax and incentive defaults are model assumptions, not current-law guidance. LCOE is nominal cents/kWh. A JavaScript 33-trial What-If solver supports the finance outputs. Evidence level: scenario-engine-regression; changed-input expectations are engine-generated, with source Excel caches checking the baseline. Edition differences were not independently established.

---

# NREL CREST Wind Cash-Flow Model (v1.4)

> NREL CREST v1.4 wind cost-of-energy and project-finance model with tax incentives, debt service and after-tax equity returns.

- **Model ID**: `nrel-crest-wind@v1.4` (Package `1.4.0`)
- **Publisher**: [National Renewable Energy Laboratory (NREL / DOE)](https://www.nlr.gov/analysis/crest)
- **Source Workbook**: `nrel-crest-wind.xlsx` (`sha256:14568501ee0a2afb8647f601c89f1866e2424822b028fe6ffd98c8d5923bc339`)
- **Cadence**: periodic | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-engine-regression. Cascaded one-variable tariff tables are evaluated at each trial point; the final tariff uses the source 0.1-cent bracket midpoint, so target-return NPV need not be exactly zero.
- **Workbook Download**: `catalog-bytes`; source: https://www.nlr.gov/docs/libraries/analysis/nrel-crest-wind.xlsx?sfvrsn=37cc2b0e_2; upstreamArtifact: null; catalog file size: 215969 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_wind_lcoe_check`

## Flows

### `quick_wind_lcoe_check` — Quick wind LCOE check (single)
Capacity, costs, O&M, debt and federal incentive sensitivity. Capacity factor is directly active in this edition. Simple cost modes activate the quick cost inputs; omitted inputs retain source defaults.
- **Inputs**: `system_size_kw`, `capacity_factor`, `capital_cost_detail`, `installed_cost_per_kw`, `om_cost_detail`, `fixed_om_per_kw_year`, `variable_om_cents_per_kwh`, `debt_fraction`, `debt_interest_rate`, `federal_incentive_type`, `federal_cost_incentive_form`, `itc_fraction`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `after_tax_equity_irr_year20`

### `full_wind_project_finance` — Full wind project finance (single)
All mapped Inputs assumptions and depreciation allocations, plus cash-flow and DSCR diagnostics. Complex Inputs schedules can be supplied through cellOverrides. Expenses and initial equity are negative USD; ratios and rates use decimal fractions.
- **Inputs**: `system_size_kw`, `payment_duration_for_cost_based_tariff`, `capacity_factor`, `of_year_one_tariff_rate_escalated`, `cost_based_tariff_escalation_rate`, `annual_degradation`, `project_life_years`, `select_market_value_forecast_methodology`, `value_of_energy_capacity_recs_yr_1`, `capital_cost_detail`, `market_value_escalation_rate`, `installed_cost_per_kw`, `generation_equipment_cost`, `balance_of_plant_cost`, `interconnection_cost`, `federal_incentive_type`, `development_cost`, `federal_cost_incentive_form`, `itc_fraction`, `itc_utilization`, `is_pbi_tax_based_ptc_or_cash_based_repi`, `pbi_rate`, `pbi_utilization_or_availability_factor_if_applicable`, `om_cost_detail`, `pbi_duration`, `fixed_om_per_kw_year`, `pbi_escalation_rate`, `variable_om_cents_per_kwh`, `additional_federal_grants_other_than_section_1603`, `o_m_cost_inflation_initial_period`, `federal_grants_treated_as_taxable_income`, `initial_period_ends_last_day_of`, `o_m_cost_inflation_thereafter`, `insurance_yr_1_of_total_cost`, `select_form_of_state_incentive`, `itc_amount`, `project_management_yr_1`, `utilization_factor_if_applicable`, `property_tax_or_pilot_yr_1`, `state_itc_realization_period`, `annual_property_tax_adjustment_factor`, `land_lease`, `is_performance_based_incentive_tax_credit_or_cash_pmt`, `royalties_of_revenue`, `annual_cap_on_performance_based_incentive`, `if_cash_is_state_pbi_or_rec_taxable`, `pbi_or_rec_rate`, `pbi_utilization_factor_if_applicable`, `construction_period`, `pbi_or_rec_paymentduration`, `interest_rate_annual`, `pbi_or_rec_escalation_rate_pos_or_neg`, `additional_state_rebates_grants`, `total_cap_on_state_rebates_grants`, `state_grants_treated_as_taxable_income`, `debt_fraction`, `debt_term_years`, `debt_interest_rate`, `1st_equipment_replacement`, `lender_s_fee_of_total_borrowing`, `1st_replacement_cost_in_year_replaced`, `required_minimum_annual_dscr`, `2nd_equipment_replacement`, `2nd_replacement_cost_in_year_replaced`, `3rd_equipment_replacement`, `required_average_dscr`, `3rd_replacement_cost_in_year_replaced`, `4th_equipment_replacement`, `4th_replacement_cost_in_year_replaced`, `target_after_tax_equity_irr`, `other_closing_costs`, `fund_from_operations_or_salvage_value`, `reserve_requirement`, `of_months_of_debt_service`, `of_months_of_o_m_expense`, `is_owner_a_taxable_entity`, `federal_income_tax_rate`, `interest_on_all_reserves`, `federal_tax_benefits_used_as_generated_or_carried_forward`, `state_income_tax_rate`, `state_tax_benefits_used_as_generated_or_carried_forward`, `bonus_depreciation_enabled`, `bonus_depreciation_fraction`, `depreciation_total_installed_cost_p`, `depreciation_total_installed_cost_q`, `depreciation_total_installed_cost_r`, `depreciation_total_installed_cost_u`, `depreciation_total_installed_cost_v`, `depreciation_total_installed_cost_w`, `depreciation_total_installed_cost_x`, `depreciation_total_installed_cost_y`, `depreciation_total_installed_cost_z`, `depreciation_generation_equipment_p`, `depreciation_generation_equipment_q`, `depreciation_generation_equipment_r`, `depreciation_generation_equipment_u`, `depreciation_generation_equipment_v`, `depreciation_generation_equipment_w`, `depreciation_generation_equipment_x`, `depreciation_generation_equipment_y`, `depreciation_generation_equipment_z`, `depreciation_balance_of_plant_p`, `depreciation_balance_of_plant_q`, `depreciation_balance_of_plant_r`, `depreciation_balance_of_plant_u`, `depreciation_balance_of_plant_v`, `depreciation_balance_of_plant_w`, `depreciation_balance_of_plant_x`, `depreciation_balance_of_plant_y`, `depreciation_balance_of_plant_z`, `depreciation_interconnection_p`, `depreciation_interconnection_q`, `depreciation_interconnection_r`, `depreciation_interconnection_u`, `depreciation_interconnection_v`, `depreciation_interconnection_w`, `depreciation_interconnection_x`, `depreciation_interconnection_y`, `depreciation_interconnection_z`, `depreciation_development_costs_fee_p`, `depreciation_development_costs_fee_q`, `depreciation_development_costs_fee_r`, `depreciation_development_costs_fee_u`, `depreciation_development_costs_fee_v`, `depreciation_development_costs_fee_w`, `depreciation_development_costs_fee_x`, `depreciation_development_costs_fee_y`, `depreciation_development_costs_fee_z`, `depreciation_reserves_financing_costs_p`, `depreciation_reserves_financing_costs_q`, `depreciation_reserves_financing_costs_r`, `depreciation_reserves_financing_costs_u`, `depreciation_reserves_financing_costs_v`, `depreciation_reserves_financing_costs_w`, `depreciation_reserves_financing_costs_x`, `depreciation_reserves_financing_costs_y`, `depreciation_reserves_financing_costs_z`
- **Outputs**: `year_one_coe_cents_per_kwh`, `nominal_lcoe_cents_per_kwh`, `year_one_energy_kwh`, `net_installed_cost`, `effective_capacity_factor`, `minimum_dscr_met`, `average_dscr_met`, `target_equity_irr`, `target_return_equity_npv`, `minimum_dscr`, `average_dscr`, `year_one_revenue`, `year_one_operating_expenses`, `year_one_after_tax_cash_flow`, `initial_equity_cash_flow`, `after_tax_equity_irr_year20`

## SheetPort Ports (`fio.yaml`)

- **`system_size_kw`** (`in`, `scalar`): Generator Nameplate Capacity; units: kW. Numeric costs are positive unless stated otherwise.
- **`payment_duration_for_cost_based_tariff`** (`in`, `scalar`): Payment Duration for Cost-Based Tariff; units: years. Numeric costs are positive unless stated otherwise.
- **`capacity_factor`** (`in`, `scalar`): Net Capacity Factor, Yr 1; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Directly active; this edition has no capacity-factor mode switch.
- **`of_year_one_tariff_rate_escalated`** (`in`, `scalar`): % of Year-One Tariff Rate Escalated; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`cost_based_tariff_escalation_rate`** (`in`, `scalar`): Cost-Based Tariff Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`annual_degradation`** (`in`, `scalar`): Annual Production Degradation; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`project_life_years`** (`in`, `scalar`): Project Useful Life; units: years. Numeric costs are positive unless stated otherwise.
- **`select_market_value_forecast_methodology`** (`in`, `scalar`): Select Market Value Forecast Methodology; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Year One, Year-by-Year.
- **`value_of_energy_capacity_recs_yr_1`** (`in`, `scalar`): Value of energy, capacity & RECs, Yr 1; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`capital_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Simple, Intermediate, Complex.
- **`market_value_escalation_rate`** (`in`, `scalar`): Market Value Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`installed_cost_per_kw`** (`in`, `scalar`): Total Installed Cost; units: USD/kW. Numeric costs are positive unless stated otherwise. Active only when capital_cost_detail = Simple.
- **`generation_equipment_cost`** (`in`, `scalar`): Generation Equipment; units: USD. Numeric costs are positive unless stated otherwise.
- **`balance_of_plant_cost`** (`in`, `scalar`): Balance of Plant; units: USD. Numeric costs are positive unless stated otherwise.
- **`interconnection_cost`** (`in`, `scalar`): Interconnection; units: USD. Numeric costs are positive unless stated otherwise.
- **`federal_incentive_type`** (`in`, `scalar`): Select Form of Federal Incentives; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cost-Based, Performance-Based, Neither.
- **`development_cost`** (`in`, `scalar`): Development Costs & Fee; units: USD. Numeric costs are positive unless stated otherwise.
- **`federal_cost_incentive_form`** (`in`, `scalar`): Investment Tax Credit (ITC) or Cash Grant?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: ITC, Cash Grant.
- **`itc_fraction`** (`in`, `scalar`): ITC or Cash Grant Amount ; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when federal_incentive_type = Cost-Based; federal_cost_incentive_form selects ITC or Cash Grant.
- **`itc_utilization`** (`in`, `scalar`): ITC utilization factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`is_pbi_tax_based_ptc_or_cash_based_repi`** (`in`, `scalar`): Is PBI Tax-Based (PTC) or Cash-Based (REPI)?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cash, Tax Credit.
- **`pbi_rate`** (`in`, `scalar`): PBI Rate; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`pbi_utilization_or_availability_factor_if_applicable`** (`in`, `scalar`): PBI Utilization or Availability Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`om_cost_detail`** (`in`, `scalar`): Select Cost Level of Detail; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Simple, Intermediate.
- **`pbi_duration`** (`in`, `scalar`): PBI Duration; units: yrs. Numeric costs are positive unless stated otherwise.
- **`fixed_om_per_kw_year`** (`in`, `scalar`): Fixed O&M Expense, Yr 1; units: USD/kW/year. Numeric costs are positive unless stated otherwise. Active only when om_cost_detail = Simple.
- **`pbi_escalation_rate`** (`in`, `scalar`): PBI Escalation Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`variable_om_cents_per_kwh`** (`in`, `scalar`): Variable O&M Expense, Yr 1; units: ¢/kWh . Numeric costs are positive unless stated otherwise. Active only when om_cost_detail = Simple.
- **`additional_federal_grants_other_than_section_1603`** (`in`, `scalar`): Additional Federal Grants (Other than Section 1603); units: USD. Numeric costs are positive unless stated otherwise.
- **`o_m_cost_inflation_initial_period`** (`in`, `scalar`): O&M Cost Inflation, initial period; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`federal_grants_treated_as_taxable_income`** (`in`, `scalar`): Federal Grants Treated as Taxable Income?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`initial_period_ends_last_day_of`** (`in`, `scalar`): Initial Period ends last day of:; units: year. Numeric costs are positive unless stated otherwise.
- **`o_m_cost_inflation_thereafter`** (`in`, `scalar`): O&M Cost Inflation, thereafter; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`insurance_yr_1_of_total_cost`** (`in`, `scalar`): Insurance, Yr 1 (% of Total Cost); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`select_form_of_state_incentive`** (`in`, `scalar`): Select Form of State Incentive; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cost-Based, Performance-Based, Neither.
- **`itc_amount`** (`in`, `scalar`): ITC Amount ; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`project_management_yr_1`** (`in`, `scalar`): Project Management Yr 1; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`utilization_factor_if_applicable`** (`in`, `scalar`): Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`property_tax_or_pilot_yr_1`** (`in`, `scalar`): Property Tax or PILOT, Yr 1; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`state_itc_realization_period`** (`in`, `scalar`): State ITC realization period; units: yrs. Numeric costs are positive unless stated otherwise.
- **`annual_property_tax_adjustment_factor`** (`in`, `scalar`): Annual Property Tax Adjustment Factor; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`land_lease`** (`in`, `scalar`): Land Lease; units: $/yr. Numeric costs are positive unless stated otherwise.
- **`is_performance_based_incentive_tax_credit_or_cash_pmt`** (`in`, `scalar`): Is Performance-Based Incentive Tax Credit or Cash Pmt?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Cash, Tax Credit.
- **`royalties_of_revenue`** (`in`, `scalar`): Royalties (% of revenue); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`annual_cap_on_performance_based_incentive`** (`in`, `scalar`): Annual $ Cap on Performance-Based Incentive; units: USD. Numeric costs are positive unless stated otherwise.
- **`if_cash_is_state_pbi_or_rec_taxable`** (`in`, `scalar`): If cash, is state PBI or REC taxable?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`pbi_or_rec_rate`** (`in`, `scalar`): PBI or REC Rate; units: cents/kWh. Numeric costs are positive unless stated otherwise.
- **`pbi_utilization_factor_if_applicable`** (`in`, `scalar`): PBI Utilization Factor, if applicable; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`construction_period`** (`in`, `scalar`): Construction Period; units: months. Numeric costs are positive unless stated otherwise.
- **`pbi_or_rec_paymentduration`** (`in`, `scalar`): PBI or REC PaymentDuration; units: yrs. Numeric costs are positive unless stated otherwise.
- **`interest_rate_annual`** (`in`, `scalar`): Interest Rate (Annual); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`pbi_or_rec_escalation_rate_pos_or_neg`** (`in`, `scalar`): PBI or REC Escalation Rate (pos. or neg.); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`additional_state_rebates_grants`** (`in`, `scalar`): Additional State Rebates/Grants; units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`total_cap_on_state_rebates_grants`** (`in`, `scalar`): Total $ Cap on State Rebates/Grants; units: USD. Numeric costs are positive unless stated otherwise.
- **`state_grants_treated_as_taxable_income`** (`in`, `scalar`): State Grants Treated as Taxable Income?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`debt_fraction`** (`in`, `scalar`): % Debt (% of hard costs) (mortgage-style amort.); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`debt_term_years`** (`in`, `scalar`): Debt Term; units: years. Numeric costs are positive unless stated otherwise.
- **`debt_interest_rate`** (`in`, `scalar`): Interest Rate on Term Debt; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`1st_equipment_replacement`** (`in`, `scalar`): 1st Equipment Replacement; units: year. Numeric costs are positive unless stated otherwise.
- **`lender_s_fee_of_total_borrowing`** (`in`, `scalar`): Lender's Fee (% of total borrowing); units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`1st_replacement_cost_in_year_replaced`** (`in`, `scalar`): 1st Replacement Cost  ($ in year replaced); units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`required_minimum_annual_dscr`** (`in`, `scalar`): Required Minimum Annual DSCR; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise.
- **`2nd_equipment_replacement`** (`in`, `scalar`): 2nd Equipment Replacement ; units: year. Numeric costs are positive unless stated otherwise.
- **`2nd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 2nd Replacement Cost ($ in year replaced); units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`3rd_equipment_replacement`** (`in`, `scalar`): 3rd Equipment Replacement ; units: year. Numeric costs are positive unless stated otherwise.
- **`required_average_dscr`** (`in`, `scalar`): Required Average DSCR; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise.
- **`3rd_replacement_cost_in_year_replaced`** (`in`, `scalar`): 3rd Replacement Cost ($ in year replaced); units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`4th_equipment_replacement`** (`in`, `scalar`): 4th Equipment Replacement ; units: year. Numeric costs are positive unless stated otherwise.
- **`4th_replacement_cost_in_year_replaced`** (`in`, `scalar`): 4th Replacement Cost ($ in year replaced); units: USD/kW. Numeric costs are positive unless stated otherwise.
- **`target_after_tax_equity_irr`** (`in`, `scalar`): Target After-Tax Equity IRR; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`other_closing_costs`** (`in`, `scalar`): Other Closing Costs; units: USD. Numeric costs are positive unless stated otherwise.
- **`fund_from_operations_or_salvage_value`** (`in`, `scalar`): Fund from Operations or Salvage Value?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Operations, Salvage.
- **`reserve_requirement`** (`in`, `scalar`): Reserve Requirement; units: USD. Numeric costs are positive unless stated otherwise.
- **`of_months_of_debt_service`** (`in`, `scalar`): # of months of Debt Service; units: months. Numeric costs are positive unless stated otherwise.
- **`of_months_of_o_m_expense`** (`in`, `scalar`): # of months of O&M Expense; units: months. Numeric costs are positive unless stated otherwise.
- **`is_owner_a_taxable_entity`** (`in`, `scalar`): Is owner a taxable entity?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: Yes, No.
- **`federal_income_tax_rate`** (`in`, `scalar`): Federal Income Tax Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`interest_on_all_reserves`** (`in`, `scalar`): Interest on All Reserves; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`federal_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): Federal Tax Benefits used as generated or carried forward?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: As Generated, Carried Forward.
- **`state_income_tax_rate`** (`in`, `scalar`): State Income Tax Rate; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise.
- **`state_tax_benefits_used_as_generated_or_carried_forward`** (`in`, `scalar`): State Tax Benefits used as generated or carried forward?; units: workbook selection or ratio/count as labeled. Numeric costs are positive unless stated otherwise. Allowed values: As Generated, Carried Forward.
- **`bonus_depreciation_enabled`** (`in`, `scalar`): Bonus depreciation switch. Allowed values: Yes, No.
- **`bonus_depreciation_fraction`** (`in`, `scalar`): % of Bonus Depreciation applied in Year 1; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Active when bonus_depreciation_enabled = Yes and owner is taxable.
- **`depreciation_total_installed_cost_p`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_q`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_r`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_u`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_v`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_w`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_x`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_y`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_total_installed_cost_z`** (`in`, `scalar`): Total Installed Cost; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_p`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_q`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_r`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_u`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_v`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_w`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_x`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_y`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_generation_equipment_z`** (`in`, `scalar`): Generation Equipment; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_p`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_q`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_r`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_u`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_v`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_w`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_x`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_y`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_balance_of_plant_z`** (`in`, `scalar`): Balance of Plant; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_p`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_q`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_r`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_u`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_v`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_w`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_x`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_y`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_interconnection_z`** (`in`, `scalar`): Interconnection; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_p`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_q`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_r`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_u`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_v`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_w`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_x`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_y`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_development_costs_fee_z`** (`in`, `scalar`): Development Costs & Fee; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_p`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_q`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 7-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_r`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_u`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year MACRS; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_v`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 5-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_w`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 15-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_x`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 20-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_y`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to 39-year SL; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`depreciation_reserves_financing_costs_z`** (`in`, `scalar`): Reserves & Financing Costs; units: decimal fraction (0.30 = 30%). Numeric costs are positive unless stated otherwise. Allocation to Non-Depreciable; allocations across the category must sum to 1. Active category follows capital_cost_detail.
- **`year_one_coe_cents_per_kwh`** (`out`, `scalar`): cents/kWh; year-one tariff, rounded to the midpoint of the 0.1-cent CREST bracket
- **`nominal_lcoe_cents_per_kwh`** (`out`, `scalar`): cents/kWh; nominal levelized cost of energy
- **`year_one_energy_kwh`** (`out`, `scalar`): kWh/year; positive generation
- **`net_installed_cost`** (`out`, `scalar`): USD; positive net capital cost
- **`effective_capacity_factor`** (`out`, `scalar`): decimal fraction
- **`minimum_dscr_met`** (`out`, `scalar`): Yes or failure message; lender minimum DSCR test
- **`average_dscr_met`** (`out`, `scalar`): Yes or failure message; lender average DSCR test
- **`target_equity_irr`** (`out`, `scalar`): decimal fraction; target assumption, not the achieved IRR
- **`target_return_equity_npv`** (`out`, `scalar`): USD; target-return NPV at the solved tariff, residual remains because the tariff uses a 0.1-cent bracket
- **`minimum_dscr`** (`out`, `scalar`): ratio; minimum annual debt service coverage
- **`average_dscr`** (`out`, `scalar`): ratio; average annual debt service coverage
- **`year_one_revenue`** (`out`, `scalar`): USD; positive revenue
- **`year_one_operating_expenses`** (`out`, `scalar`): USD; expenses are negative
- **`year_one_after_tax_cash_flow`** (`out`, `scalar`): USD; positive inflow, negative outflow
- **`initial_equity_cash_flow`** (`out`, `scalar`): USD; negative initial equity investment
- **`after_tax_equity_irr_year20`** (`out`, `scalar`): decimal fraction; cumulative equity IRR through year 20

## Editorial & Version Notes

Historical CREST v1.4 assumptions retain the source tax and incentive defaults. Tariff is the source 0.1-cent bracket midpoint, so target-return NPV need not be exactly zero. Perturbed scenarios are WASM regression vectors; only baseline values have an independent original Excel cache oracle. Cash flows with multiple sign changes may have multiple IRR roots.

---

# OHFA 2023 4% LIHTC Underwriting Model (2023)

> Ohio Housing Finance Agency 2023 4% LIHTC eligible credit sizing, operating budget and cashflow sensitivity from the AHFA source application.

- **Model ID**: `ohfa-lihtc-4pct@2023` (Package `2023.1.0`)
- **Publisher**: [Ohio Housing Finance Agency (OHFA)](https://ohiohome.org/ppd/resources.aspx)
- **Source Workbook**: `ohfa-lihtc-4pct-2023.xlsx` (`sha256:58435470f4a734061f1e8028ec7125f42c5f9f0c84e5d7fecac81c5a2018b007`)
- **Cadence**: annual | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://ohiohome.org/ppd/documents/2023-4-LIHTC-AHFA.xlsx; upstreamArtifact: null; catalog file size: 651440 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_lihtc_credit_sizing`

## Flows

### `quick_lihtc_credit_sizing` — Quick LIHTC credit sizing (single)
Eligible basis, applicable fractions, credit rates and boost activation; single low-income rent cohort, acquisition/rehab/new construction allocations. Annual credit ceiling is distinct from requested credits and equity. Other competitive pool boosts use full cellOverrides.
- **Inputs**: `units`, `monthly_tenant_rent`, `low_income_floor_area`, `market_floor_area`, `acquisition_basis`, `rehabilitation_basis`, `new_construction_basis`, `rehab_qct_fraction`, `new_qct_fraction`, `rehab_credit_rate`, `new_credit_rate`, `program`, `rent_limit_ami_fraction`, `first_year_vacancy`, `vacancy`
- **Outputs**: `annual_credit_eligible`, `acquisition_credit`, `rehabilitation_credit`, `new_construction_credit`, `applicable_fraction`

### `full_underwriting_budget_cashflow` — Full underwriting budget and cashflow (single)
Eligible basis, applicable fractions, credit rates and boost activation; all mapped rent, operating expense, senior debt and annual cashflow assumptions. Additional rent cohorts, detailed cost rows and competitive pool switches use cellOverrides. Not an award or compliance determination.
- **Inputs**: `units`, `monthly_tenant_rent`, `low_income_floor_area`, `market_floor_area`, `acquisition_basis`, `rehabilitation_basis`, `new_construction_basis`, `rehab_qct_fraction`, `new_qct_fraction`, `rehab_credit_rate`, `new_credit_rate`, `program`, `rent_limit_ami_fraction`, `first_year_vacancy`, `vacancy`, `monthly_rental_subsidy`, `unit_square_feet`, `annual_residential_fees`, `annual_other_income`, `annual_commercial_income`, `annual_interest_income`, `annual_laundry_income`, `annual_office_expense`, `annual_electricity`, `annual_maintenance_supplies`, `annual_insurance`, `annual_replacement_reserve`, `senior_loan_amount`, `senior_loan_rate`, `senior_loan_amortization`, `income_escalation`, `expense_escalation`, `acquisition_credit_rate`, `acquisition_credit_reduction`, `rehabilitation_credit_reduction`, `new_construction_credit_reduction`, `gross_equity`, `equity_bridge_interest`, `equity_other_deductions`
- **Outputs**: `annual_credit_eligible`, `acquisition_credit`, `rehabilitation_credit`, `new_construction_credit`, `applicable_fraction`, `effective_gross_income`, `operating_expenses`, `budget_noi`, `year_one_noi`, `year_one_cashflow`, `year_two_cashflow`, `senior_debt_service`, `year_one_dscr`, `net_equity`

## SheetPort Ports (`fio.yaml`)

- **`units`** (`in`, `scalar`): Residential units, count; first rent-roll cohort; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!C9; effective default 0.
- **`monthly_tenant_rent`** (`in`, `scalar`): USD per unit per month, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!I9; effective default 0.
- **`low_income_floor_area`** (`in`, `scalar`): Square feet, low-income rental area; paired with market floor area; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C230; effective default 0.
- **`market_floor_area`** (`in`, `scalar`): Square feet, market rental area; applicable fraction is lesser of unit and floor fractions; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C229; effective default 0.
- **`acquisition_basis`** (`in`, `scalar`): USD, building acquisition eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F253; effective default 0.
- **`rehabilitation_basis`** (`in`, `scalar`): USD, residential rehabilitation eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G279; effective default 0.
- **`new_construction_basis`** (`in`, `scalar`): USD, residential new construction eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!H278; effective default 0.
- **`rehab_qct_fraction`** (`in`, `scalar`): Decimal fraction 0..1 of rehabilitation qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!D13; effective default 0.0.
- **`new_qct_fraction`** (`in`, `scalar`): Decimal fraction 0..1 of new construction qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!E13; effective default 0.0.
- **`rehab_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!D31; effective default 0.04.
- **`new_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!E31; effective default 0.04.
- **`program`** (`in`, `scalar`): Text program switch: 4% LIHTC or 9% Competitive; activates competitive basis boost tests. Source default 4% LIHTC. Source location Project Details!C20; effective default 4% LIHTC.
- **`rent_limit_ami_fraction`** (`in`, `scalar`): Decimal fraction 0..1, rent affordability AMI; does not override rent-limit compliance; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G9; effective default 0.
- **`first_year_vacancy`** (`in`, `scalar`): Decimal fraction 0..1, first-year cashflow vacancy; nonnegative unless stated. Default 0.07 (blank numeric source cells act as zero).  Source location Budget & Costs!E83; effective default 0.07.
- **`vacancy`** (`in`, `scalar`): Decimal fraction 0..1, annual operating budget vacancy; nonnegative unless stated. Default 0.07 (blank numeric source cells act as zero).  Source location Budget & Costs!E82; effective default 0.07.
- **`monthly_rental_subsidy`** (`in`, `scalar`): USD per unit per month; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!M9; effective default 0.
- **`unit_square_feet`** (`in`, `scalar`): Square feet per cohort unit; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F9; effective default 0.
- **`annual_residential_fees`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F91; effective default 0.0.
- **`annual_other_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F92; effective default 0.0.
- **`annual_commercial_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F93; effective default 0.0.
- **`annual_interest_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F98; effective default 0.
- **`annual_laundry_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F103; effective default 0.0.
- **`annual_office_expense`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F116; effective default 0.0.
- **`annual_electricity`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F132; effective default 0.0.
- **`annual_maintenance_supplies`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F147; effective default 0.0.
- **`annual_insurance`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F162; effective default 0.0.
- **`annual_replacement_reserve`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F172; effective default 0.0.
- **`senior_loan_amount`** (`in`, `scalar`): USD, positive principal; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G240; effective default 0.0.
- **`senior_loan_rate`** (`in`, `scalar`): Decimal fraction 0..1, annual interest; nonnegative unless stated. Default 0.06 (blank numeric source cells act as zero).  Source location Budget & Costs!H240; effective default 0.0.
- **`senior_loan_amortization`** (`in`, `scalar`): Years, positive amortization term when loan amount >0; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!K240; effective default 0.
- **`income_escalation`** (`in`, `scalar`): Decimal annual fraction; nonnegative unless stated. Default 0.02 (blank numeric source cells act as zero).  Source location Cashflow!J25; effective default 0.02.
- **`expense_escalation`** (`in`, `scalar`): Decimal annual fraction; nonnegative unless stated. Default 0.03 (blank numeric source cells act as zero).  Source location Cashflow!J26; effective default 0.03.
- **`acquisition_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location LIHTCs!C31; effective default 0.04.
- **`acquisition_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C37; effective default 0.0.
- **`rehabilitation_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!D37; effective default 0.0.
- **`new_construction_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!E37; effective default 0.0.
- **`gross_equity`** (`in`, `scalar`): USD, positive equity proceeds; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C48; effective default 0.
- **`equity_bridge_interest`** (`in`, `scalar`): USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C49; effective default 0.
- **`equity_other_deductions`** (`in`, `scalar`): USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location LIHTCs!C52; effective default 0.
- **`annual_credit_eligible`** (`out`, `scalar`): USD per year, eligible ceiling before a separate requested amount; calculated from publisher's workbook formulas.
- **`acquisition_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`rehabilitation_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`new_construction_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`applicable_fraction`** (`out`, `scalar`): Decimal fraction 0..1, rounded to four decimal places; calculated from publisher's workbook formulas.
- **`effective_gross_income`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`operating_expenses`** (`out`, `scalar`): USD per year, includes replacement reserve; calculated from publisher's workbook formulas.
- **`budget_noi`** (`out`, `scalar`): USD per year, signed net income; calculated from publisher's workbook formulas.
- **`year_one_noi`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`year_one_cashflow`** (`out`, `scalar`): USD per year, after hard debt and mortgage insurance; calculated from publisher's workbook formulas.
- **`year_two_cashflow`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`senior_debt_service`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`year_one_dscr`** (`out`, `scalar`): Ratio; source returns zero if no hard debt; calculated from publisher's workbook formulas.
- **`net_equity`** (`out`, `scalar`): USD, signed; calculated from publisher's workbook formulas.

---

# OHFA 2023 9% LIHTC Underwriting Model (2023)

> Ohio Housing Finance Agency 2023 9% LIHTC eligible credit sizing, operating budget and cashflow sensitivity from the AHFA source application.

- **Model ID**: `ohfa-lihtc-9pct@2023` (Package `2023.1.0`)
- **Publisher**: [Ohio Housing Finance Agency (OHFA)](https://ohiohome.org/ppd/resources.aspx)
- **Source Workbook**: `ohfa-lihtc-9pct-2023.xlsx` (`sha256:7088743093d34febea9256435f67c5d8171fd22892e096882c1be061e0430011`)
- **Cadence**: annual | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://ohiohome.org/ppd/documents/2023-AHFA-V1.xlsx; upstreamArtifact: null; catalog file size: 752648 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_lihtc_credit_sizing`

## Flows

### `quick_lihtc_credit_sizing` — Quick LIHTC credit sizing (single)
Eligible basis, applicable fractions, credit rates and boost activation; single low-income rent cohort, acquisition/rehab/new construction allocations. Annual credit ceiling is distinct from requested credits and equity. Other competitive pool boosts use full cellOverrides.
- **Inputs**: `units`, `monthly_tenant_rent`, `low_income_floor_area`, `market_floor_area`, `acquisition_basis`, `rehabilitation_basis`, `new_construction_basis`, `rehab_qct_fraction`, `new_qct_fraction`, `rehab_credit_rate`, `new_credit_rate`, `program`, `rent_limit_ami_fraction`, `vacancy`, `mbe_wbe_developer`
- **Outputs**: `annual_credit_eligible`, `acquisition_credit`, `rehabilitation_credit`, `new_construction_credit`, `applicable_fraction`

### `full_underwriting_budget_cashflow` — Full underwriting budget and cashflow (single)
Eligible basis, applicable fractions, credit rates and boost activation; all mapped rent, operating expense, senior debt and annual cashflow assumptions. Additional rent cohorts, detailed cost rows and competitive pool switches use cellOverrides. Not an award or compliance determination.
- **Inputs**: `units`, `monthly_tenant_rent`, `low_income_floor_area`, `market_floor_area`, `acquisition_basis`, `rehabilitation_basis`, `new_construction_basis`, `rehab_qct_fraction`, `new_qct_fraction`, `rehab_credit_rate`, `new_credit_rate`, `program`, `rent_limit_ami_fraction`, `first_year_vacancy`, `vacancy`, `mbe_wbe_developer`, `monthly_rental_subsidy`, `unit_square_feet`, `annual_residential_fees`, `annual_other_income`, `annual_commercial_income`, `annual_interest_income`, `annual_laundry_income`, `annual_office_expense`, `annual_electricity`, `annual_maintenance_supplies`, `annual_insurance`, `annual_replacement_reserve`, `senior_loan_amount`, `senior_loan_rate`, `senior_loan_amortization`, `income_escalation`, `expense_escalation`, `acquisition_credit_rate`, `acquisition_credit_reduction`, `rehabilitation_credit_reduction`, `new_construction_credit_reduction`, `gross_equity`, `equity_bridge_interest`, `equity_other_deductions`, `annual_credit_requested`
- **Outputs**: `annual_credit_eligible`, `acquisition_credit`, `rehabilitation_credit`, `new_construction_credit`, `applicable_fraction`, `effective_gross_income`, `operating_expenses`, `budget_noi`, `year_one_noi`, `year_one_cashflow`, `year_two_cashflow`, `senior_debt_service`, `year_one_dscr`, `net_equity`

## SheetPort Ports (`fio.yaml`)

- **`units`** (`in`, `scalar`): Residential units, count; first rent-roll cohort; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!C9; effective default 0.
- **`monthly_tenant_rent`** (`in`, `scalar`): USD per unit per month, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!I9; effective default 0.
- **`low_income_floor_area`** (`in`, `scalar`): Square feet, low-income rental area; paired with market floor area; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C244; effective default 0.0.
- **`market_floor_area`** (`in`, `scalar`): Square feet, market rental area; applicable fraction is lesser of unit and floor fractions; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Project Details!C243; effective default 0.0.
- **`acquisition_basis`** (`in`, `scalar`): USD, building acquisition eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F256; effective default 0.
- **`rehabilitation_basis`** (`in`, `scalar`): USD, residential rehabilitation eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G282; effective default 0.
- **`new_construction_basis`** (`in`, `scalar`): USD, residential new construction eligible basis allocation; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!H281; effective default 0.
- **`rehab_qct_fraction`** (`in`, `scalar`): Decimal fraction 0..1 of rehabilitation qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!D13; effective default 0.0.
- **`new_qct_fraction`** (`in`, `scalar`): Decimal fraction 0..1 of new construction qualifying for 30% QCT/DDA boost; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!E13; effective default 0.0.
- **`rehab_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.09 (blank numeric source cells act as zero).  Source location Housing Credits!D31; effective default 0.09.
- **`new_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.09 (blank numeric source cells act as zero).  Source location Housing Credits!E31; effective default 0.09.
- **`program`** (`in`, `scalar`): Text program switch: 4% LIHTC or 9% Competitive; activates competitive basis boost tests. Source default blank. Source location Project Details!C20; effective default .
- **`rent_limit_ami_fraction`** (`in`, `scalar`): Decimal fraction 0..1, rent affordability AMI; does not override rent-limit compliance; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G9; effective default 0.
- **`first_year_vacancy`** (`in`, `scalar`): Decimal fraction 0..1, first-year cashflow vacancy; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!E83; effective default 0.
- **`vacancy`** (`in`, `scalar`): Decimal fraction 0..1, annual operating budget vacancy; nonnegative unless stated. Default 0.07 (blank numeric source cells act as zero).  Source location Budget & Costs!E82; effective default 0.07.
- **`mbe_wbe_developer`** (`in`, `scalar`): Text enum Yes / No; Yes activates a 15% rehabilitation/new-construction basis boost when program is 9% Competitive. Default Yes. Source location Development Team!D70; effective default Yes.
- **`monthly_rental_subsidy`** (`in`, `scalar`): USD per unit per month; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!M9; effective default 0.0.
- **`unit_square_feet`** (`in`, `scalar`): Square feet per cohort unit; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F9; effective default 0.
- **`annual_residential_fees`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F91; effective default 0.0.
- **`annual_other_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F92; effective default 0.0.
- **`annual_commercial_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F93; effective default 0.0.
- **`annual_interest_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F98; effective default 0.
- **`annual_laundry_income`** (`in`, `scalar`): USD per year, positive income; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F103; effective default 0.0.
- **`annual_office_expense`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F116; effective default 0.0.
- **`annual_electricity`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F132; effective default 0.0.
- **`annual_maintenance_supplies`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F147; effective default 0.0.
- **`annual_insurance`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F162; effective default 0.0.
- **`annual_replacement_reserve`** (`in`, `scalar`): USD per year, positive expense; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!F172; effective default 0.0.
- **`senior_loan_amount`** (`in`, `scalar`): USD, positive principal; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!G243; effective default 0.
- **`senior_loan_rate`** (`in`, `scalar`): Decimal fraction 0..1, annual interest; nonnegative unless stated. Default 0.06 (blank numeric source cells act as zero).  Source location Budget & Costs!H243; effective default 0.06.
- **`senior_loan_amortization`** (`in`, `scalar`): Years, positive amortization term when loan amount >0; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Budget & Costs!K243; effective default 0.
- **`income_escalation`** (`in`, `scalar`): Decimal annual fraction; nonnegative unless stated. Default 0.02 (blank numeric source cells act as zero).  Source location Cashflow!J29; effective default 0.02.
- **`expense_escalation`** (`in`, `scalar`): Decimal annual fraction; nonnegative unless stated. Default 0.03 (blank numeric source cells act as zero).  Source location Cashflow!J30; effective default 0.03.
- **`acquisition_credit_rate`** (`in`, `scalar`): Annual decimal credit rate 0..1; nonnegative unless stated. Default 0.04 (blank numeric source cells act as zero).  Source location Housing Credits!C31; effective default 0.04.
- **`acquisition_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C37; effective default 0.0.
- **`rehabilitation_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!D37; effective default 0.0.
- **`new_construction_credit_reduction`** (`in`, `scalar`): USD per year, positive credit reduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!E37; effective default 0.0.
- **`gross_equity`** (`in`, `scalar`): USD, positive equity proceeds; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C48; effective default 0.
- **`equity_bridge_interest`** (`in`, `scalar`): USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C49; effective default 0.
- **`equity_other_deductions`** (`in`, `scalar`): USD, positive deduction; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C52; effective default 0.
- **`annual_credit_requested`** (`in`, `scalar`): USD per year, request is separate from eligible ceiling; nonnegative unless stated. Default 0 (blank numeric source cells act as zero).  Source location Housing Credits!C43; effective default 0.0.
- **`annual_credit_eligible`** (`out`, `scalar`): USD per year, eligible ceiling before a separate requested amount; calculated from publisher's workbook formulas.
- **`acquisition_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`rehabilitation_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`new_construction_credit`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`applicable_fraction`** (`out`, `scalar`): Decimal fraction 0..1, rounded to four decimal places; calculated from publisher's workbook formulas.
- **`effective_gross_income`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`operating_expenses`** (`out`, `scalar`): USD per year, includes replacement reserve; calculated from publisher's workbook formulas.
- **`budget_noi`** (`out`, `scalar`): USD per year, signed net income; calculated from publisher's workbook formulas.
- **`year_one_noi`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`year_one_cashflow`** (`out`, `scalar`): USD per year, after hard debt and mortgage insurance; calculated from publisher's workbook formulas.
- **`year_two_cashflow`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`senior_debt_service`** (`out`, `scalar`): USD per year; calculated from publisher's workbook formulas.
- **`year_one_dscr`** (`out`, `scalar`): Ratio; source returns zero if no hard debt; calculated from publisher's workbook formulas.
- **`net_equity`** (`out`, `scalar`): USD, signed; calculated from publisher's workbook formulas.

---

# PHFA 2025 Core Application Operating Underwriting (2025)

> Pennsylvania Housing Finance Agency application operating budget and first-two-year proforma sensitivities. Catalog calculations, not certification; no PHFA endorsement.

- **Model ID**: `phfa-core-application@2025` (Package `2025.1.0`)
- **Publisher**: [Pennsylvania Housing Finance Agency (PHFA)](https://www.phfa.org/mhp/developers/housingapplication.aspx)
- **Source Workbook**: `core_application-vba-free.xlsx` (`sha256:8b442662c95ae9fd4b41488e29b3d27a506e8998c4b050bf7270343b2d3ac3ec`)
- **Cadence**: periodic | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://www.phfa.org/files/mf_application/core_application.zip; upstreamArtifact: {"sourceUrl":"https://www.phfa.org/files/mf_application/core_application.zip","workbookFilename":"core_application.zip","workbookSha256":"60a4467472d7cd68ade1dc673c4a81c4570df1e7fc668e6f6775e03421d4d013","workbookBytes":316259,"format":"zip"}; catalog file size: 310350 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_operating_budget`

## Flows

### `quick_operating_budget` — Quick annual operating budget (single)
What NOI, debt coverage and residual cash does this operating budget support? Annual income and debt service are direct inputs, not amortization or rent-roll derivations. All expenses/debt are positive deductions; cash may be negative.  Aggregate annual USD assumptions and ratios only; unit mix and per-unit outputs are outside this contract. Catalog calculations, not certification. No PHFA endorsement.
- **Inputs**: `gross_residential`, `gross_commercial`, `residential_vacancy`, `commercial_vacancy_amount`, `laundry`, `management`, `electricity`, `maintenance_contracts`, `office_salaries`, `real_estate_tax`, `insurance`, `replacement_reserve`, `primary_debt`, `pennhomes_debt`
- **Outputs**: `effective_gross_income`, `operating_disbursements`, `budget_noi`, `budget_dscr`, `secondary_cashflow`

### `full_underwriting_budget_proforma` — Full annual budget and first two proforma years (single)
How do the detailed operating expenses, debt fees and independent proforma vacancy/escalation controls change NOI and first-two-year cash? Includes all mapped budget lines. First year is 12 months; no operating-month scaling.  Aggregate annual USD assumptions and ratios only; unit mix and per-unit outputs are outside this contract. Catalog calculations, not certification. No PHFA endorsement.
- **Inputs**: `gross_residential`, `gross_commercial`, `other_rental`, `residential_vacancy`, `commercial_vacancy_amount`, `laundry`, `advertising`, `office_telephone`, `management`, `legal`, `audit`, `misc_admin`, `fuel_oil`, `electricity`, `water`, `gas`, `sewer`, `maintenance_supplies`, `maintenance_contracts`, `rubbish`, `security`, `repairs`, `elevator`, `hvac`, `grounds`, `painting`, `vehicles`, `misc_maintenance`, `office_salaries`, `manager_salaries`, `employee_free_rent`, `maintenance_salaries`, `payroll_tax`, `workers_comp`, `benefits`, `real_estate_tax`, `insurance`, `misc_tax`, `supportive_services`, `replacement_reserve`, `investor_fee`, `broadband`, `other_expense`, `primary_debt`, `service_fee`, `credit_enhancement`, `other_service_fee`, `pennhomes_debt`, `secondary_other_1`, `secondary_other_2`, `residential_growth`, `commercial_growth`, `expense_growth`, `proforma_residential_vacancy`, `proforma_commercial_vacancy`
- **Outputs**: `effective_gross_income`, `operating_disbursements`, `budget_noi`, `primary_debt_total`, `initial_cashflow`, `budget_dscr`, `secondary_cashflow`, `year1_noi`, `year1_dscr`, `year1_secondary_cashflow`, `year2_noi`, `year2_secondary_cashflow`, `year2_dscr`

## SheetPort Ports (`fio.yaml`)

- **`gross_residential`** (`in`, `scalar`): USD/year, positive gross residential income entered directly; independent of unit rent-roll entries. Publisher baseline 0.
- **`gross_commercial`** (`in`, `scalar`): USD/year, positive gross commercial income. Publisher baseline 0.
- **`other_rental`** (`in`, `scalar`): USD/year, positive other rental income. Publisher baseline 0.
- **`residential_vacancy`** (`in`, `scalar`): Decimal fraction 0..1, residential vacancy deduction applied to gross residential. Publisher baseline 0.05.
- **`commercial_vacancy_amount`** (`in`, `scalar`): USD/year, positive commercial vacancy deduction; independent of the separate proforma commercial vacancy fraction. Publisher baseline 0.
- **`laundry`** (`in`, `scalar`): USD/year, positive laundry income. Publisher baseline 0.
- **`advertising`** (`in`, `scalar`): USD/year, positive advertising operating disbursement deducted from income. Publisher baseline 0.
- **`office_telephone`** (`in`, `scalar`): USD/year, positive office telephone operating disbursement deducted from income. Publisher baseline 0.
- **`management`** (`in`, `scalar`): USD/year, positive management operating disbursement deducted from income. Publisher baseline 0.
- **`legal`** (`in`, `scalar`): USD/year, positive legal operating disbursement deducted from income. Publisher baseline 0.
- **`audit`** (`in`, `scalar`): USD/year, positive audit operating disbursement deducted from income. Publisher baseline 0.
- **`misc_admin`** (`in`, `scalar`): USD/year, positive misc admin operating disbursement deducted from income. Publisher baseline 0.
- **`fuel_oil`** (`in`, `scalar`): USD/year, positive fuel oil operating disbursement deducted from income. Publisher baseline 0.
- **`electricity`** (`in`, `scalar`): USD/year, positive electricity operating disbursement deducted from income. Publisher baseline 0.
- **`water`** (`in`, `scalar`): USD/year, positive water operating disbursement deducted from income. Publisher baseline 0.
- **`gas`** (`in`, `scalar`): USD/year, positive gas operating disbursement deducted from income. Publisher baseline 0.
- **`sewer`** (`in`, `scalar`): USD/year, positive sewer operating disbursement deducted from income. Publisher baseline 0.
- **`maintenance_supplies`** (`in`, `scalar`): USD/year, positive maintenance supplies operating disbursement deducted from income. Publisher baseline 0.
- **`maintenance_contracts`** (`in`, `scalar`): USD/year, positive maintenance contracts operating disbursement deducted from income. Publisher baseline 0.
- **`rubbish`** (`in`, `scalar`): USD/year, positive rubbish operating disbursement deducted from income. Publisher baseline 0.
- **`security`** (`in`, `scalar`): USD/year, positive security operating disbursement deducted from income. Publisher baseline 0.
- **`repairs`** (`in`, `scalar`): USD/year, positive repairs operating disbursement deducted from income. Publisher baseline 0.
- **`elevator`** (`in`, `scalar`): USD/year, positive elevator operating disbursement deducted from income. Publisher baseline 0.
- **`hvac`** (`in`, `scalar`): USD/year, positive hvac operating disbursement deducted from income. Publisher baseline 0.
- **`grounds`** (`in`, `scalar`): USD/year, positive grounds operating disbursement deducted from income. Publisher baseline 0.
- **`painting`** (`in`, `scalar`): USD/year, positive painting operating disbursement deducted from income. Publisher baseline 0.
- **`vehicles`** (`in`, `scalar`): USD/year, positive vehicles operating disbursement deducted from income. Publisher baseline 0.
- **`misc_maintenance`** (`in`, `scalar`): USD/year, positive misc maintenance operating disbursement deducted from income. Publisher baseline 0.
- **`office_salaries`** (`in`, `scalar`): USD/year, positive office salaries operating disbursement deducted from income. Publisher baseline 0.
- **`manager_salaries`** (`in`, `scalar`): USD/year, positive manager salaries operating disbursement deducted from income. Publisher baseline 0.
- **`employee_free_rent`** (`in`, `scalar`): USD/year, positive employee free rent operating disbursement deducted from income. Publisher baseline 0.
- **`maintenance_salaries`** (`in`, `scalar`): USD/year, positive maintenance salaries operating disbursement deducted from income. Publisher baseline 0.
- **`payroll_tax`** (`in`, `scalar`): USD/year, positive payroll tax operating disbursement deducted from income. Publisher baseline 0.
- **`workers_comp`** (`in`, `scalar`): USD/year, positive workers comp operating disbursement deducted from income. Publisher baseline 0.
- **`benefits`** (`in`, `scalar`): USD/year, positive benefits operating disbursement deducted from income. Publisher baseline 0.
- **`real_estate_tax`** (`in`, `scalar`): USD/year, positive real estate tax operating disbursement deducted from income. Publisher baseline 0.
- **`insurance`** (`in`, `scalar`): USD/year, positive insurance operating disbursement deducted from income. Publisher baseline 0.
- **`misc_tax`** (`in`, `scalar`): USD/year, positive misc tax operating disbursement deducted from income. Publisher baseline 0.
- **`supportive_services`** (`in`, `scalar`): USD/year, positive supportive services operating disbursement deducted from income. Publisher baseline 0.
- **`replacement_reserve`** (`in`, `scalar`): USD/year, positive replacement reserve operating disbursement deducted from income; reserve is included in publisher NOI. Publisher baseline 0.
- **`investor_fee`** (`in`, `scalar`): USD/year, positive investor fee operating disbursement deducted from income. Publisher baseline 0.
- **`broadband`** (`in`, `scalar`): USD/year, positive broadband operating disbursement deducted from income. Publisher baseline 0.
- **`other_expense`** (`in`, `scalar`): USD/year, positive other expense operating disbursement deducted from income. Publisher baseline 0.
- **`primary_debt`** (`in`, `scalar`): USD/year, positive primary debt service disbursement deducted after NOI. Publisher baseline 0.
- **`service_fee`** (`in`, `scalar`): USD/year, positive service fee debt/service disbursement deducted after NOI. Publisher baseline 0.
- **`credit_enhancement`** (`in`, `scalar`): USD/year, positive credit enhancement debt/service disbursement deducted after NOI. Publisher baseline 0.
- **`other_service_fee`** (`in`, `scalar`): USD/year, positive other service fee debt/service disbursement deducted after NOI. Publisher baseline 0.
- **`pennhomes_debt`** (`in`, `scalar`): USD/year, positive PennHOMES secondary debt service disbursement deducted after NOI. Publisher baseline 0.
- **`secondary_other_1`** (`in`, `scalar`): USD/year, positive secondary other 1 debt/service disbursement deducted after NOI. Publisher baseline 0.
- **`secondary_other_2`** (`in`, `scalar`): USD/year, positive secondary other 2 debt/service disbursement deducted after NOI. Publisher baseline 0.
- **`residential_growth`** (`in`, `scalar`): Decimal fraction 0..1 per year, residential/laundry and management-fee escalation. Publisher baseline 0.02.
- **`commercial_growth`** (`in`, `scalar`): Decimal fraction 0..1 per year, commercial/other rental escalation. Publisher baseline 0.02.
- **`expense_growth`** (`in`, `scalar`): Decimal fraction 0..1 per year, operating expense escalation excluding management and replacement reserve. Publisher baseline 0.03.
- **`proforma_residential_vacancy`** (`in`, `scalar`): Decimal fraction 0..1, independent proforma residential vacancy control; set alongside budget vacancy to align. Publisher baseline 0.05.
- **`proforma_commercial_vacancy`** (`in`, `scalar`): Decimal fraction 0..1, independent proforma commercial vacancy control; does not update budget commercial vacancy amount. Publisher baseline 0.1.
- **`effective_gross_income`** (`out`, `scalar`): USD/year after budget vacancy plus laundry
- **`operating_disbursements`** (`out`, `scalar`): USD/year positive, includes replacement reserve and investor fees
- **`budget_noi`** (`out`, `scalar`): USD/year, effective income less all operating disbursements
- **`primary_debt_total`** (`out`, `scalar`): USD/year positive primary debt and service fees
- **`initial_cashflow`** (`out`, `scalar`): USD/year signed cash after primary debt
- **`budget_dscr`** (`out`, `scalar`): Ratio NOI / total primary debt; publisher returns zero if denominator zero
- **`secondary_cashflow`** (`out`, `scalar`): USD/year signed cash after primary and secondary debt
- **`year1_noi`** (`out`, `scalar`): USD/year, first 12-month proforma NOI using independent proforma vacancy controls
- **`year1_dscr`** (`out`, `scalar`): Ratio first-year NOI / total primary debt; publisher returns zero if primary_debt alone is zero
- **`year1_secondary_cashflow`** (`out`, `scalar`): USD/year signed first-year cash after all debt
- **`year2_noi`** (`out`, `scalar`): USD/year second-year NOI; replacement reserve grows by fixed 3 percent regardless of expense_growth
- **`year2_secondary_cashflow`** (`out`, `scalar`): USD/year signed second-year cash after all debt
- **`year2_dscr`** (`out`, `scalar`): Ratio second-year NOI / total primary debt; publisher returns zero if primary_debt alone is zero

---

# RIHousing ELI One-Bedroom Subsidy Projection (2026)

> Fixed first-year, 5-year and 15-year horizons; requested-years selector is outside this flow. One-bedroom units only, with and without CES referrals; all other bedrooms retain blank source defaults. Supply current location-appropriate rent limits; no rent-limit lookup or eligibility certification. Source uploaded under 2026/01, filename says 2025 RFP; edition 2026 identifies that handbook artifact, not an asserted publisher edition or publication date. Catalog calculations, not certification; no RIHousing endorsement.

- **Model ID**: `ri-eli-subsidy-projection@2026` (Package `2026.1.0`)
- **Publisher**: [Rhode Island Housing (RIHousing)](https://www.rihousing.com/partners/builders-developers/developers-handbook/)
- **Source Workbook**: `2026-Section-14.b-RIH-ELI-projection-grid-for-2025-RFP.xlsx` (`sha256:c46b6d6ace2f50ab70c16103730621f45ff7596851ea76ee7c0e3dc179d02f52`)
- **Cadence**: periodic | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://www.rihousing.com/wp-content/uploads/2026/01/2026-Section-14.b-RIH-ELI-projection-grid-for-2025-RFP.xlsx; upstreamArtifact: null; catalog file size: 43911 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_one_bedroom_projection`

## Flows

### `quick_one_bedroom_projection` — One-bedroom ELI subsidy projection (single)
Fixed first-year, 5-year and 15-year horizons; requested-years selector is outside this flow. One-bedroom units only, with and without CES referrals; all other bedrooms retain blank source defaults. Supply current location-appropriate rent limits; no rent-limit lookup or eligibility certification. Source uploaded under 2026/01, filename says 2025 RFP; edition 2026 identifies that handbook artifact, not an asserted publisher edition or publication date. Catalog calculations, not certification; no RIHousing endorsement. All inputs contribute to the projected deficit in populated scenarios. Higher AMI limits should be at least the corresponding 30% limits; reversed rents yield signed negative gaps, not a funding recommendation.
- **Inputs**: `ces_units`, `ces_rent_30`, `ces_rent_60`, `nonces_units`, `nonces_rent_30`, `nonces_rent_50`
- **Outputs**: `total_units`, `deficit_year1`, `deficit_5_years`, `deficit_15_years`

## SheetPort Ports (`fio.yaml`)

- **`ces_units`** (`in`, `scalar`): Count of one-bedroom units with Coordinated Entry System referrals, nonnegative integer. Other bedroom sizes remain publisher blank.
- **`ces_rent_30`** (`in`, `scalar`): USD per unit per month: current local 30% AMI rent limit for CES one-bedroom units, nonnegative. Supply with ces_units and ces_rent_60.
- **`ces_rent_60`** (`in`, `scalar`): USD per unit per month: current local 60% AMI rent limit for CES one-bedroom units, nonnegative. Supply with ces_units and ces_rent_30.
- **`nonces_units`** (`in`, `scalar`): Count of one-bedroom units without CES referrals, nonnegative integer. Other bedroom sizes remain publisher blank.
- **`nonces_rent_30`** (`in`, `scalar`): USD per unit per month: current local 30% AMI rent limit for non-CES one-bedroom units, nonnegative. Supply with nonces_units and nonces_rent_50.
- **`nonces_rent_50`** (`in`, `scalar`): USD per unit per month: current local 50% AMI rent limit for non-CES one-bedroom units, nonnegative. Supply with nonces_units and nonces_rent_30.
- **`total_units`** (`out`, `scalar`): Count of requested one-bedroom units; all other bedroom rows remain blank.
- **`deficit_year1`** (`out`, `scalar`): USD first-year rent deficit, positive when higher AMI rents exceed 30% rents.
- **`deficit_5_years`** (`out`, `scalar`): USD cumulative nominal rent deficit over 5 years, 3% annual escalation after year 1, no discounting.
- **`deficit_15_years`** (`out`, `scalar`): USD cumulative nominal rent deficit over 15 years, 3% annual escalation after year 1, no discounting.

---

# UIUC farmdoc Farmland Maximum Bid and Purchase Cashflow (v1.0)

> Evaluate 5-, 10- and 30-year farmland maximum bid prices, after-tax NPV, and 30-year debt cash flows using the UIUC farmdoc FAST model.

- **Model ID**: `uiuc-farmdoc-land-bid@v1.0` (Package `1.0.0`)
- **Publisher**: [University of Illinois Urbana-Champaign (farmdoc FAST Tools)](https://farmdoc.illinois.edu/decision-tools/land-purchase-evaluation-tool)
- **Source Workbook**: `uiuc-farmdoc-land-bid-sanitized.xlsx` (`sha256:48f10a753125621e3dbf1e0604519aced4f7b8ec42cffc51eb5e0f8b53126572`)
- **Cadence**: static | **License Class**: `open-academic`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic. Runs a JavaScript port of the publisher's Module1.Main VBA GoalSeek macro for max_bid_5y, max_bid_10y and max_bid_30y using affine zero-NPV solving. The publisher's VBA macro does not run. Scenario expectations use independent Python arithmetic, not Excel macro execution.
- **Workbook Download**: `catalog-bytes`; source: https://farmdoc.illinois.edu/assets/management/farmland-values/LandPurchase-Utility-Center.xlsm; upstreamArtifact: {"workbookFilename":"LandPurchase-Utility-Center.xlsm","workbookSha256":"2b16e52fde534682da7ce064c1af20b35c910646bd367600513801e4af1379b4","workbookBytes":603330,"format":"xlsm"}; catalog file size: 443123 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_land_max_bid_price`

## Flows

### `quick_land_max_bid_price` — Quick land max bid price (single)
Evaluate 5-, 10- and 30-year farmland bid prices, after-tax NPV and debt cash flow. Depreciable improvements remain at the source zero default. Legacy sensitivity-grid GoalSeek outputs are excluded. Pinned ActiveX source fails the security gate.
- **Inputs**: `analysis_price`, `annual_cashflow`, `property_tax`, `cashflow_growth`, `land_appreciation`, `down_payment_fraction`, `loan_interest_rate`, `loan_term_years`, `income_tax_rate`, `capital_gains_tax_rate`, `discount_rate`, `closing_fee_fraction`
- **Outputs**: `max_bid_5y`, `max_bid_10y`, `max_bid_30y`, `npv_5y`, `npv_10y`, `npv_30y`

### `full_farmland_purchase_cashflow` — Full farmland purchase cashflow (single)
Evaluate 5-, 10- and 30-year farmland bid prices, after-tax NPV and debt cash flow. Depreciable improvements remain at the source zero default. Legacy sensitivity-grid GoalSeek outputs are excluded. Pinned ActiveX source fails the security gate.
- **Inputs**: `analysis_price`, `annual_cashflow`, `property_tax`, `cashflow_growth`, `land_appreciation`, `down_payment_fraction`, `loan_interest_rate`, `loan_term_years`, `income_tax_rate`, `capital_gains_tax_rate`, `discount_rate`, `closing_fee_fraction`, `selling_fee_fraction`, `farm_acres`, `existing_gross_revenue`, `existing_operating_expenses`
- **Outputs**: `max_bid_5y`, `max_bid_10y`, `max_bid_30y`, `npv_5y`, `npv_10y`, `npv_30y`, `year_one_debt_payment`, `preinvestment_farm_income`, `cashflow_30y_year_1`, `cashflow_30y_year_2`, `cashflow_30y_year_3`, `cashflow_30y_year_4`, `cashflow_30y_year_5`, `cashflow_30y_year_6`, `cashflow_30y_year_7`, `cashflow_30y_year_8`, `cashflow_30y_year_9`, `cashflow_30y_year_10`, `cashflow_30y_year_11`, `cashflow_30y_year_12`, `cashflow_30y_year_13`, `cashflow_30y_year_14`, `cashflow_30y_year_15`, `cashflow_30y_year_16`, `cashflow_30y_year_17`, `cashflow_30y_year_18`, `cashflow_30y_year_19`, `cashflow_30y_year_20`, `cashflow_30y_year_21`, `cashflow_30y_year_22`, `cashflow_30y_year_23`, `cashflow_30y_year_24`, `cashflow_30y_year_25`, `cashflow_30y_year_26`, `cashflow_30y_year_27`, `cashflow_30y_year_28`, `cashflow_30y_year_29`, `cashflow_30y_year_30`

## SheetPort Ports (`fio.yaml`)

- **`analysis_price`** (`in`, `scalar`): Analysis price USD/acre Default: 8000.
- **`annual_cashflow`** (`in`, `scalar`): Year-one incremental income USD/acre before property tax Default: 350.
- **`property_tax`** (`in`, `scalar`): Year-one property tax USD/acre Default: 30.
- **`cashflow_growth`** (`in`, `scalar`): Annual income and property-tax growth decimal fraction Default: 0.02.
- **`land_appreciation`** (`in`, `scalar`): Annual land appreciation decimal fraction Default: 0.02.
- **`down_payment_fraction`** (`in`, `scalar`): Down payment decimal fraction Default: 0.25.
- **`loan_interest_rate`** (`in`, `scalar`): Annual loan interest decimal fraction; positive for amortization Default: 0.06.
- **`loan_term_years`** (`in`, `scalar`): Loan term integer years Default: 20.
- **`income_tax_rate`** (`in`, `scalar`): Marginal income tax decimal fraction Default: 0.28.
- **`capital_gains_tax_rate`** (`in`, `scalar`): Capital gains tax decimal fraction Default: 0.15.
- **`discount_rate`** (`in`, `scalar`): After-tax annual discount decimal fraction Default: 0.04.
- **`closing_fee_fraction`** (`in`, `scalar`): Initial closing fee decimal fraction of purchase Default: 0.01.
- **`selling_fee_fraction`** (`in`, `scalar`): Terminal selling fee decimal fraction of land value Default: 0.04.
- **`farm_acres`** (`in`, `scalar`): Acres purchased for whole-farm feasibility; valuation outputs stay per-acre Default: 80.
- **`existing_gross_revenue`** (`in`, `scalar`): Pre-investment whole-farm gross annual revenue USD Default: 478000.
- **`existing_operating_expenses`** (`in`, `scalar`): Pre-investment whole-farm annual operating expenses USD Default: 313000.
- **`max_bid_5y`** (`out`, `scalar`): Maximum zero-NPV bid USD/acre; deterministic affine GoalSeek equivalent, no sensitivity-grid macros
- **`max_bid_10y`** (`out`, `scalar`): Maximum zero-NPV bid USD/acre; deterministic affine GoalSeek equivalent, no sensitivity-grid macros
- **`max_bid_30y`** (`out`, `scalar`): Maximum zero-NPV bid USD/acre; deterministic affine GoalSeek equivalent, no sensitivity-grid macros
- **`npv_5y`** (`out`, `scalar`): Signed after-tax net present value USD/acre at analysis price
- **`npv_10y`** (`out`, `scalar`): Signed after-tax net present value USD/acre at analysis price
- **`npv_30y`** (`out`, `scalar`): Signed after-tax net present value USD/acre at analysis price
- **`year_one_debt_payment`** (`out`, `scalar`): Annual debt payment USD/acre
- **`preinvestment_farm_income`** (`out`, `scalar`): Whole-farm net operating income USD
- **`cashflow_30y_year_1`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 1 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_2`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 2 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_3`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 3 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_4`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 4 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_5`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 5 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_6`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 6 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_7`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 7 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_8`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 8 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_9`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 9 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_10`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 10 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_11`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 11 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_12`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 12 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_13`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 13 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_14`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 14 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_15`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 15 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_16`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 16 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_17`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 17 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_18`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 18 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_19`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 19 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_20`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 20 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_21`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 21 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_22`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 22 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_23`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 23 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_24`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 24 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_25`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 25 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_26`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 26 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_27`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 27 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_28`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 28 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_29`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 29 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.
- **`cashflow_30y_year_30`** (`out`, `scalar`): Signed after-tax cash flow USD/acre in year 30 of the 30-year holding horizon; year 30 includes terminal sale, capital gains tax and debt payoff.

## Editorial & Version Notes

Evaluate 5-, 10- and 30-year farmland bid prices, after-tax NPV and debt cash flow. Depreciable improvements remain at the source zero default. Legacy sensitivity-grid GoalSeek outputs are excluded. Pinned ActiveX source fails the security gate. License class identifies academic provenance, not an independently confirmed redistribution license. Macros and source caches are retained in source-inspection.json. Full flow maps the documented deterministic decision surface; Monte Carlo and solver sensitivity grids are excluded. afterSheetPortWrite replaces maximum bid outputs with live unrounded NPV divided by a source-derived price slope, recomputed on every invocation. Bids retain more precision than VBA GoalSeek caches. Full flow exposes each of the 30 annual cash flows as a scalar for trace support. Depreciation and section 179 overrides are rejected because MACRS VBA is not ported. Valuation acreage remains one; whole-farm feasibility acreage is separate. Legacy TRANSPOSE spill errors and macroCheck UI errors remain outside the mapped output graph. This candidate is blocked and must not be deployed.

---

# WHEDA 2027 Project Concept Multifamily Operating Cashflow (2027)

> First-year residential NOI, debt coverage and cash after debt for one 60%-CMI rent cohort with selected annual expenses. Set income_tier=0.6 to route rents into the publisher summary. All omitted expenses, other income and cohorts remain blank/zero. First-loan debt service uses monthly level payments and requires payment_schedule=Must Pay/Hard Debt; reserves reduce NOI. This bounded calculation uses the 2027 Project Concept Multifamily Application; it does not validate rents, complete underwriting, credit eligibility or approval. Catalog calculations, not certification; no WHEDA endorsement.

- **Model ID**: `wi-multifamily-application@2027` (Package `2027.1.0`)
- **Publisher**: [Wisconsin Housing and Economic Development Authority (WHEDA)](https://www.wheda.com/developers-and-property-managers/tax-credits/htc/allocating/2027/2027-program)
- **Source Workbook**: `2027-multifamily-application.xlsx` (`sha256:ce066131c25fb5f9e962809958b5f8ce6b7e620231a0dfccb149331349dd8662`)
- **Cadence**: annual | **License Class**: `reference-only`
- **Verification**: selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.
- **Workbook Download**: `publisher-redirect`; source: https://www.wheda.com/globalassets/documents/tax-credits/htc/2027/2027-multifamily-application.xlsx; upstreamArtifact: null; catalog file size: 2618604 bytes. Reference-only workbooks redirect to the publisher; verify the fetched bytes against the SHA-256 and size above. `fio.yaml` remains downloadable.
- **Default Flow**: `quick_operating_cashflow`

## Flows

### `quick_operating_cashflow` — Single-cohort first-year operating cashflow (single)
First-year residential NOI, debt coverage and cash after debt for one 60%-CMI rent cohort with selected annual expenses. Set income_tier=0.6 to route rents into the publisher summary. All omitted expenses, other income and cohorts remain blank/zero. First-loan debt service uses monthly level payments and requires payment_schedule=Must Pay/Hard Debt; reserves reduce NOI. This bounded calculation uses the 2027 Project Concept Multifamily Application; it does not validate rents, complete underwriting, credit eligibility or approval. Catalog calculations, not certification; no WHEDA endorsement.
- **Inputs**: `units`, `monthly_rent`, `income_tier`, `vacancy`, `management`, `electricity`, `maintenance`, `taxes`, `insurance`, `annual_reserve`, `loan_principal`, `loan_rate`, `amortization_years`, `payment_schedule`
- **Outputs**: `effective_income`, `operating_expenses`, `noi`, `total_debt_service`, `cash_after_debt`, `dscr`

## SheetPort Ports (`fio.yaml`)

- **`units`** (`in`, `scalar`): Whole units in a single cohort; all other cohorts remain empty. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`monthly_rent`** (`in`, `scalar`): USD/unit/month, positive monthly net rent; no utility allowance is added to income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`income_tier`** (`in`, `scalar`): Decimal fraction. Set 0.6 to activate this cohort in the 60% CMI rent summary. Baseline 0 represents blank/unclassified; rent does not flow into income until a recognized tier is selected. This is a routing assumption, not rent-limit validation. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`vacancy`** (`in`, `scalar`): Decimal fraction 0..1 of gross residential rent deducted for vacancy. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`management`** (`in`, `scalar`): USD/year, positive residential management expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`electricity`** (`in`, `scalar`): USD/year, positive electricity expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`maintenance`** (`in`, `scalar`): USD/year, positive maintenance contract expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`taxes`** (`in`, `scalar`): USD/year, positive real estate and personal property taxes deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`insurance`** (`in`, `scalar`): USD/year, positive property/liability insurance deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`annual_reserve`** (`in`, `scalar`): USD/year, positive annual replacement reserve; publisher deducts this in operating expenses before NOI. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`loan_principal`** (`in`, `scalar`): USD, positive first permanent loan principal. Other loans remain zero. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`loan_rate`** (`in`, `scalar`): Decimal fraction annual interest rate; monthly level payments are assumed. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`amortization_years`** (`in`, `scalar`): Years, monthly amortization period; zero retains blank-baseline debt service. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`payment_schedule`** (`in`, `scalar`): Set Must Pay/Hard Debt to activate annual first-loan debt service. Blank baseline produces zero service. All omitted costs, other income and cohorts retain publisher blank/zero defaults.
- **`effective_income`** (`out`, `scalar`): USD/year, residential income after vacancy.
- **`operating_expenses`** (`out`, `scalar`): USD/year, selected operating expenses plus replacement reserve.
- **`noi`** (`out`, `scalar`): USD/year, income minus operating expenses including reserve.
- **`total_debt_service`** (`out`, `scalar`): USD/year, annual debt payments excluding TIF.
- **`cash_after_debt`** (`out`, `scalar`): USD/year, NOI minus annual debt; negative is a shortfall.
- **`dscr`** (`out`, `scalar`): Ratio, NOI divided by debt rounded to three decimals; publisher returns zero at zero debt.

## Editorial & Version Notes

Reference-only: source workbook download redirects to WHEDA. First-year residential NOI, debt coverage and cash after debt for one 60%-CMI rent cohort with selected annual expenses. Set income_tier=0.6 to route rents into the publisher summary. All omitted expenses, other income and cohorts remain blank/zero. First-loan debt service uses monthly level payments and requires payment_schedule=Must Pay/Hard Debt; reserves reduce NOI. This bounded calculation uses the 2027 Project Concept Multifamily Application; it does not validate rents, complete underwriting, credit eligibility or approval. Catalog calculations, not certification; no WHEDA endorsement.
