HC3 Persistence forecast automatic access
|Last update: Jul. 2017|
- FOR PAY - Contact us to receive your_login and your_password
The hc3v4_persistence_forecast.php automatic access provides time series of HelioClim-3 version 4 data for today. It provides HelioClim-3 version 4 radiation values updated in real time, and forecasts until the end of the current day using a model of persistence. In brief, as soon as a new Meteosat image is available every 15 min, the HelioClim-3 database is updated in real time. To receive a time series covering the whole current day, we decided to complete the time series by applying a persistence model.
Please contact us for a quotation.
- Download wget.exe in a directory (on Windows - 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: first day and last day MUST BE SET TO 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".
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
NB: For the SoDa Customers who already exploit HC3 classic output format, it is possible to get back to this format by adding the following parameters "rely=0&header=0"
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" ...