solarpy.plotting.multiplot

Contents

solarpy.plotting.multiplot#

solarpy.plotting.multiplot(times, data, meta, horizon=None, google_api_key=None, figsize=(24, 16))#

Create a multiplot for visual checking plausibility of irradiance data.

Produces a multi-panel figure combining time series, intraday heatmaps, scatter plots, sun-path shading heatmaps, histograms, maps, and station metadata for a single solar irradiance measurement site.

Parameters:

  • times (pandas.DatetimeIndex) – Timestamps of the measurements. Must have a consistent frequency. Consider using solarpy.processing.resample_to_freq()

  • data (pandas.DataFrame) –

    Measurement data. Required columns:

    • "ghi" — Global Horizontal Irradiance [W/m²]

    • "dni" — Direct Normal Irradiance [W/m²]

    • "dhi" — Diffuse Horizontal Irradiance [W/m²]

    • "solar_zenith" — Solar zenith angle [°]

    • "solar_azimuth" — Solar azimuth angle [°]

    "ghi_extra", "dni_extra", and "ghi_calc" are computed internally from times and the irradiance columns.

    Optional columns:

    • "ghi_clear" — Clearsky GHI [W/m²]; if present together with "is_clearsky", a clearsky-index time series panel is shown.

    • "is_clearsky" — Boolean mask for clearsky conditions; see "ghi_clear" above.

    • "flag" — Boolean quality flag; if present, flagged and unflagged data are shown separately in the clearness-index histograms.

  • meta (dict) – Station metadata. Required keys: "latitude", "longitude". Optional keys: "altitude", "name", "country", "climate".

  • horizon (pandas.Series, optional) – Horizon elevation profile indexed by azimuth angle [°]. Overlaid on the sun-path shading plots. See solarpy.horizon.get_horizon_mines().

  • google_api_key (str, optional) – Google Maps Static API key. If not specified, the map panels are replaced with a placeholder message.

  • figsize (tuple of (float, float), default (24, 16)) – Figure size in inches (width, height).

Returns:

  • fig (matplotlib.figure.Figure) – The multiplot figure.

  • axes (dict) – Dictionary of axes, with keys "line", "heatmap", "ts_scatter", "mid_l", "mid_r", "maps", "meta", "hist", "corr", "sun1", "sun2".

Contents