energy_methods.weather_risk#

Soiling and snow shading indicators from Ascencio Vasquez (2021).

Thesis equations 3.2-3.4 and Tables 6.6-6.7. These are empirical screening indicators, not event probabilities, structural snow loads or measured losses.

energy_methods.weather_risk.soiling_rate_from_aod(aod550)[source]#

Thesis Eq. 3.2: daily soiling-rate indicator in numerical %/day.

Use dimensionless, annual-mean total AOD at 550 nm. The underlying Chilean study relates annual averages, not individual dust events. For AOD <= 0.106 use 0.648*AOD; above it use 6.63*AOD-0.63. Zero and exact equality close gaps left in the printed inequalities. The small branch discontinuity is retained. This does not include rain/manual cleaning or estimate annual energy loss.

Parameters:

aod550 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[float64]]

energy_methods.weather_risk.snow_loss_from_exposure(snow_depth_sum_cm_hours)[source]#

Thesis Eqs. 3.3-3.4: annual snow energy-loss indicator, numerical percent.

Input is the annual sum of hourly PHYSICAL ground snow depths in cm, with each sample weighted by one hour (cm h). This is not snowfall, maximum depth, or snow water equivalent. Figure 3.4 supplies the cm convention and describes fixed modules at tilt equal to latitude. The log uses the numerical value relative to 1 cm h. For exposure <= 1 cm h return zero, an explicit extension of the unspecified low domain; log=5 belongs to the lower branch. Retain the published discontinuity and unbounded polynomial rather than silently clip extrapolations to 100%. NaN stays missing. No mounting-specific SAM simulation or independent global validation is implied.

Parameters:

snow_depth_sum_cm_hours (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[float64]]

energy_methods.weather_risk.soiling_risk_classes(rate_percent_day)[source]#

Table 6.7 classes 1-5 at 0.05, 0.10, 0.20, 0.40 %/day; 0 is missing.

Upper edges are inclusive, explicitly resolving omitted equalities.

Parameters:

rate_percent_day (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[uint8]]

energy_methods.weather_risk.snow_risk_classes(annual_loss_percent)[source]#

Table 6.6 classes 1-5 at 2, 4, 7, 10 percent; 0 is missing.

Upper edges are inclusive. Class 1 includes zero AND small nonzero loss.

Parameters:

annual_loss_percent (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[uint8]]