HC3 Similarity Forecast automatic access
|Last update: Jul. 2017|
- FOR PAY - Contact us to receive your_login and your_password
The hc3v4_similarity_forecast.php automatic access provides time series of HelioClim-3 version 4 data for the next day. The Similarity Forecast method explores the HelioClim-3 database to find similar meteorological events in the past in order to make an estimation of the next day irradiation values. We recommend to use this service after sunset today to retrieve the most pertinent data for tomorrow.
Please contact us for a quotation.
- Download wget.exe in a directory (Windows only - wget is available by default on Unix).
- In the same directory, create a text file in which you copy-paste the following command.
- Rename the text file with the .bat extension and double click on it to retrieve the output.csv file (Windows environment). Rename the text file with a .sh extension and run it using >my_script.sh in a Unix environment.
wget -O output.csv --header="soda-user: your_login" --header="soda-passwd: your_password" ...
your_password: this access is restricted to registered users, i.e. to users who purchased an automatic access to the data. Please contact us for a quotation or to receive your SoDa automatic access credentials
Server: "www.soda-is.com" (main server) or "pro.soda-is.com" (mirror server)
longitude: in degrees, with at least 3 digits after comma, e.g. "geopoint=45.563,7.25"
altitude: in meters. Set "elevation=-999" to let SoDa get the elevation from Nasa SRTM database
yyyy-mm-dd: we recommend to set first day and last day to tomorrow as soon as sun sets today
time_step: "1", "5", "10", "15" (minutes), "h" (hourly)
time_reference: "TU" (universal time) or "TST" (True Solar Time)
tilt_of_panels: from "0" (horizontal) to "90", or "-999" for sun tracking. For more information on plane orientations, please refer to http://www.soda-pro.com/help/general/plane-orientations-and-radiation-components
az_of_panels: from "0" (North), 90° (East), 180° (South) to 270° (West), or "-999" for sun tracking. For more information on plane orientations, please refer to http://www.soda-pro.com/help/general/plane-orientations-and-radiation-components
ground_albedo: from "0.0" to "1.0". A usual inland value is "0.2". Optional, if not set, default value is "0.2".
boolean_horizon: takes into account "1" or not "0" the far horizon. Optional, if not set, default value is "0".
- boolean_header: optional. Return ("1") or not ("0") the header of the file. If not set, default value is "1".
- boolean_code: optional. Return ("1") or not ("0") a code of error (0: no data, 1: sun below horizon, 2: satellite estimation=OK, 5: interpolation, 6: forecasts). If not set, default value is "1".
- hc3_format: optional. The recommended value is "unified". If not set, default is the "classic" HC3 format.
Compared to the output column content available in the classic HelioClim-3 services, two points differ:
- The header is by default available
- A reliability column is available before the last column of Top of Atmosphere irradiation values.
The reliability column has several forms depending of the time step:
- Code: 0: no data, 1: sun below horizon, 2: satellite assessment, 5: interpolation in time, 6: forecast
- Nb slots (%): ratio of the number of valid slots and the number of slots during the daylength in percent
- Nb valid days: number of valid days in the period
For more details on building your command in a Unix environment, Error messages, and FAQ, please refer to this page (Coming soon).
wget -O Carpentras.csv --header="soda-user: guest" --header="soda-passwd: guest" ...