Helioclim-3 Archives - Web service USAGE

Introduction - Inputs - Outputs

Last update: July 2017

               

Back to Web service for free >>
Feb. 2004-2006

Back to Web service for pay >>
Feb. 2004 onwards

Introduction

The HelioClim-3 database provides from 1 min up to monthly time series of all the radiation components over the horizontal, fix-tilted and normal plane for the actual weather conditions. The Web service for free provides data from Feb. 2004 up to Dec. 2006, while the Web service restricted to registered users who purchased an annual subscription to HC3 can retrieve data up to yesterday.

Please note that McClear has been upgraded to version 3 during Oct. 2017 release. Validation results are now slightly different.

For more information, see:

Inputs

  • HelioClim-3 version: the most recent versions are version 4 (available at d-1 and in real time) and version 5 (d-2). Anterior versions are deprecated and should NOT be used. More information on the HelioClim-3 versions.
  • Add Meteo Data: include (or not) meteo data More information on meteo data
  • Latitude and longitude: enter the values in decimal degrees (we advise 3 or 4 digits after comma), or directly click on the map to select your point, or you can also use the "Search Address" tool on the top of the map.
  • Altitude: enter the altitude, or let us use our default high resolution elevation database SRTM (spatial resolution 90 m, uncertainty 10 m) by letting the default "Automatic" value.
  • Start date and End date: format yyyy-mm-dd.
    NB: Please pay attention to ask for complete months when asking for monthly values. If incomplete, the given monthly value results from an interpolation based on the selected days.
  • Time step: "1 min", "5 min", "10 min", "15 min", "30 min", "hour", "day", "week", or "month". NB: "1 min" and "5 min" time steps are limited to one month of data per delivery.
  • Time reference: UT or TST. More information on time references
  • Compute relief shadows: take into account (or not) the shadowing effect due to the far horizon.
  • Plane mode: "Horizontal Plane", "Fixed tilted plane", "2D Sun Tracking (DNI)", "1D Sun Tracking (North-South axis)", "1D Sun Tracking (East-West axis)", "1D Sun Tracking (Tilt tracking)", "1D Sun Tracking (Azimuth tracking)". For more details on how to set the tilt, azimuth and albedo parameters, please take a look to the plane mode table available below.
    If you need more information on the radiation components you need, please refer to the illustrations about plane orientations and radiation components. Please check also the azimuth convention adopted by SoDa
  • Output format: Classic CSV Format or Unified CSV Format More information on outputs

 

Meteo data

Meteo data can be retrieved. MERRA-2 (NASA) and GFS (NCEP) are the meteo providers.

Note: When meteo data are retrieved, the new Unified CSV Format is automatically selected.

Top of page

Plane mode               

(More information on plane orientations and radiation components)  

         Plane mode Tilt (degrees) Azimuth (degrees) Albedo Animations
June 21st Dec. 21st
Horizontal Plane 0 NA NA See animated GIF See animated GIF
Fixed tilted plane <user setting> <user setting> <user setting> See animated GIF See animated GIF
2D Sun Tracking (DNI) Sun Tracking Sun Tracking <user setting> See animated GIF See animated GIF
1D Sun Tracking (North-South axis) Sun Tracking 90° or 270° <user setting> See animated GIF See animated GIF
1D Sun Tracking (East-West axis) Sun Tracking 0° or 180° <user setting> See animated GIF See animated GIF
1D Sun Tracking (Tilt tracking) Sun Tracking <user setting> <user setting> See animated GIF See animated GIF
1D Sun Tracking (Azimuth tracking) <user setting> Sun Tracking <user setting> See animated GIF See animated GIF

Top of page

Azimuth convention adopted by SoDa

Firstly, the azimuth convention is:

   Azimuth (degrees) Orientation
North
90° East
180° South
270° West
    

So orientation checking is :

  • A tilted plane is north oriented if azimuth < 90° or azimuth > 270°
  • A tilted plane is south oriented if azimuth > 90° and azimuth < 270°

NB: A plane which is not facing the sun might either be a human error, or may also be due to infrastructure or environmental needs (e.g. part of the rooftop north oriented).

Top of page

Outputs

The output format for the HelioClim-3 files is CSV (common separated values). When pushing the "process" button, wait a while and right-click on the appeared link to retrieve your file.

Output format can be:

  • Classic CSV (common separated values) Format: the historical SoDa format which changes according to the time step.
  • Unified CSV Format: a new format, simpler, and that Excel can read seamlessly.
    The differences are :
    • field separator: fixed to ";" 
    • date: defined in one column for YYYY/MM/DD
    • hour: expressed for human reading (no more as decimal)
    • format is time step independent

Note: When meteo data are retrieved, the new Unified CSV Format is automatically selected.

Please pay attention that you don't receive the same columns if you select horizontal plane or if you select any other orientation. The description of the columns is described on this page by selecting the adequate service in terms of time step and plane orientation.

Other characteristics:

  • Missing data: -999
  • The hypothesis of integration is "end of interval": e.g. hourly data at 11:00 means data averaged over 10:00 to 11:00

Top of page