spectral_epw
Generate spectral sky data from EPW files, enabling year-long or hourly spectral analysis with configurable aerosol, cloud, and ozone models.
Instructions
Emit spectral-sky artifacts from an EPW over the year (or hours). LONG-RUNNING for a full year.
forms ⊆ {spd_set, band_matrix, spectral_wea, sidecar} (default all). Writes into work_dir and
returns {files: {form: path}, n_records}. hours is a list of [month, day, hour] to subset.
engine: spectrl2 (default) | smarts (requires SMARTSPATH).
Opt-in refinements (defaults reproduce prior output): ozone_mode='climatology' computes ozone from the EPW LOCATION lat/lon + date (van Heuklon 1979); aerosol_g overrides the 0.65 asymmetry; aod_anchor_nm converts a declared-wavelength AOD (e.g. 550) to tau500 via the Angstrom exponent. smarts_aerosol (engine="smarts" only): None/"rural" (default) or "user" to make the Ångström exponent + asymmetry factor settable via the SMARTS Card 8 USER aerosol model. cloud_variant: which SEDES1 cloud CCM to apply to the sky-diffuse spectrum — 'reanchored' (default, byte-identical to omitting this arg) | 'verbatim' (faithful Fig.11 CCM) | 'seed' (legacy eyeballed 9-anchor seed) | 'local' (your own locally-fitted CCM, requires ccm_coeffs). ccm_coeffs: path to a fitted CCM CSV (from sedes1_fit) — required when cloud_variant='local'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| epw | Yes | ||
| forms | No | ||
| hours | No | ||
| engine | No | spectrl2 | |
| work_dir | No | ||
| aerosol_g | No | ||
| ccm_coeffs | No | ||
| ozone_mode | No | ||
| aod_anchor_nm | No | ||
| cloud_variant | No | ||
| smarts_aerosol | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||