energy_methods.jrc_climate#

JRC parametric PV climates: annual POA irradiation and weighted module temperature.

Independent implementation of the published clustering workflow. A fit creates a new numerical model; the model’s source, scaling and seed identify its map.

energy_methods.jrc_climate.performance_features(poa_wm2, module_temperature_c, *, duration_hours=1.0)[source]#

Integrate POA and compute sum(G*T*dt)/sum(G*dt), over the final time axis.

Supply one complete year or divide a complete multi-year irradiation total by its year count before fitting. The function does not invent chronology. Missing intervals propagate. No irradiation means undefined temperature.

Parameters:
  • poa_wm2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

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

  • duration_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.jrc_climate.fit_jrc_climate(values, *, provenance, latitude=None, n_clusters=10, random_seed=10, n_init=100, max_iter=20)[source]#

Fit JRC’s two-feature workflow to an explicitly selected training grid.

Publication settings: global 0.5° subsample, population standard deviations, cosine-latitude centroid weights, 100 random starts, 20 Lloyd iterations, best unweighted squared distance, and centers ordered by [1, 1.5]. The sklearn solver’s early-convergence/empty-cluster handling is an adaptation.

Parameters:
  • values (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • provenance (ClimateProvenance)

  • latitude (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str] | None)

  • n_clusters (int)

  • random_seed (int)

  • n_init (int)

  • max_iter (int)

Return type:

ClimateClusterModel