ERROR Messages and FAQ

Last update: Sept. 2019


    Please find below the meaning of the error messages that you may receive using an automatic access to the following SoDa resources:

  • HelioClim-3 Archives + Meteo,
  • HC3 real time + Meteo,
  • HC3 forecasts + Meteo,
  • HelioClim-1,
  • CAMS radiation data,
  • CAMS McClear,
  • GFS,
  • MERRA-2

The second section lists the most Frequently Asked Questions.

Error messages

  • ERROR 1: No data available with these input parameters
    (generic message if the error is unknown)
  • ERROR -1: Incorrect tilted plane parameter
  • ERROR -2: Cannot open file
  • ERROR -3: Cannot write to file
  • ERROR -4: Cannot read file
  • ERROR -5: Not enough memory
  • ERROR -6: Cannot access remote data
  • ERROR -7: Helioclim service is corrupted
  • ERROR -8: Unregistered IP address
  • ERROR -9: Incorrect location parameter
  • ERROR -10: Incorrect time step parameter
  • ERROR -11: Incorrect date parameter
  • ERROR -12: Incorrect horizon parameter
  • ERROR -13: Incorrect elevation parameter
  • ERROR -14: Incorrect stations file
  • ERROR -15: Subprogram failed with no error message
  • ERROR -16: Incorrect calibration parameter
  • ERROR -17: Incorrect user/password parameters
  • ERROR -18: Incorrect albedo parameter
  • ERROR -19: Incorrect time reference parameter
  • ERROR -21: Incorrect rely parameter
  • ERROR -22: Incorrect header parameter
  • ERROR -23: HC3 database is not updated
  • ERROR -24: This service is out the scope of your SoDa subscription
  • ERROR -25: Incorrect gamma-sun-min parameter
  • ERROR -26: Mismatch dimensions of returned parameters
  • ERROR -27: Incorrect output format parameter
  • ERROR -28: Incorrect gfs grib parameter (internal error)
  • ERROR -29: Incorrect spectral band parameter
  • ERROR -30: Incorrect kato range
  • ERROR -31: Parameter does not exist or is not defined
  • ERROR -32: The date interval is too long for the specified time step parameter.

Top of page


I_ "I launched this example script, but I can't retrieve the output file!"

In this case, you probably receive a "time out message".

  1. Network shortage in OUR side: to check this point, try the mirror SoDa server ("" or "").
  2. Network shortage on YOUR side: just try to go on the internet.
  3. Problem of proxy: your internet browser knows which "door" (proxy, firewall...) to use to get out of your local network, but you need to tell wget the information relative to this proxy.
    For wget, you need to specify the proxy information in your .bat file by adding:
    set http_proxy=machine:port
    before the wget command. 1-2-3... launch!
    The proxy information (machine and port) are available:
        Internet Explorer: Tools / Options / Connections / Network parameters
        Firefox: Tools / Options / Advanced / Network / Parameters
    Alternatively, you may ask for the proxy information to your IT person.
  II_ "Why two requests inside the same pixel MSG return 2 different irradiation values?"

The HelioClim databases consist of Global Irradiance values over the horizontal plane. These values take into account the default elevation value from the SRTM database (if "elevation=-999"). Two requests made in the same pixel return different results due to a correction with respect to the elevation.

  III_ "How can I change the spaces by semi colons in my output file?"                              

Solution 1 "manual": in the top menu "Data" in Excel (Microsoft Office Excel 2007), select the sub-menu "convert". Select the "space" character and Excel will automatically display one figure per column.

Solution 2 "automatic":
In Windows: click here to download sed.exe + libraries. To replace automatically the " " by ";" in your test.txt file obtained using a wget command, you can use the following command:
sed "s/ /;/g" test.txt > test.csv
As a consequence, you can create a .bat file with the following command lines: wget -O test.txt ",5.059&elevation=-999& ...
sed "s/ /;/g" test.txt > test.csv
del test.txt

=> the file test.txt will be automatically deleted, and replaced by the test.csv file with ";" as separator.

In Unix, sed is a default tool, so you just have to copy and paste the previous example in a .sh file, by taking care of beginning the file by #!/bin/sh.

  IV_ "How to launch automatically my requests at night?";
In Unix, launch automatically your script with a "cron". In Windows, use the "scheduled tasks" to launch it automatically in a Windows environment.

  V_ "How can I introduce a delay between two successive wget requests?"               

In Unix: sleep [N]

In Windows: timeout [N]

...where "N" is the number of seconds to wait.

 VI_ "Why doesn't SoDa do the switch to the mirror website by itself? "
A few SoDa customers asked why we didn't opt for a solution could be based on DNS or IP Failover. The reason is that this type of solution doesn't work when the two servers are geographically far away from each other.

To handle this case, a third machine is required which would receive all the requests, and would send them to the two servers depending on their availability. This would lose the advantage of having two synchronized servers on which you can switch from one to the other in case of failure.

So far the only solution is that you code by yourself this switch, as given in the examples available for download on this page.

Top of page