SOsolcast
Soiling Losses

Get Monthly HSU Losses

Changed on

Get the monthly soiling-loss climatology for a site using the HSU model. Returns twelve monthly soiling loss fractions and precipitation totals, with optional fixed or optimised recurring wash schedules. The soiling climatology is calculated with data from 2007 to 2025.

get/data/monthly_averages/soiling/hsu

Request

  • Base URL
    https://api.solcast.com.au (the document declares no server; this is the origin it was published from)
  • URL
    https://api.solcast.com.au/data/monthly_averages/soiling/hsu
  • Auth
    none declared

Query parameters

latitudenumber double nullable required

The latitude of the location (EPSG:4326). Must be between -90 and 90.

longitudenumber double nullable required

The longitude of the location (EPSG:4326). Must be between -180 and 180.

tiltnumber double nullable

The angle (degrees) that the PV system is tilted off the horizontal. A tilt of 0 means the system faces directly upwards, and 90 means the system is vertical and facing the horizon. If you don't specify tilt, we use a default tilt angle based on the latitude you specify in your request. Must be between 0 and 90.

depo_veloc_pm10number double nullable

Deposition or settling velocity of PM10 particulates. [m/s]. Default is 0.004.

depo_veloc_pm2_5number double nullable

Deposition or settling velocity of PM2.5 particulates. [m/s]. Default is 0.0009.

cleaning_thresholdnumber double nullable

Amount of daily rainfall required to clean the panels (mm). Default is 1.0.

Optional. Omit to evaluate a no-wash climatology. For a fixed recurring wash schedule, specify wash dates as comma-separated MM-DD pairs (e.g. 05-01,09-15); the model applies those washes each year and the response echoes the same dates. For an optimized schedule, specify the number of washes per year as an integer (1-12). The service determines the wash schedule that minimizes annual soiling loss. The service evaluates schedules at monthly resolution with washes scheduled on the first day of each selected month. The response reports the selected month-day pairs.

format'json' | 'csv' nullable

Response format. Default is HTML if not supplied.

Response

OK

Changes