Release notes CAMS radiation service & CAMS McClear

Last update: Sept. 2018

<< Back to CAMS Radiation Web service

<< Back to CAMS McClear Web service

The dates of these release notes concern maintenance operations on SoDa MINES ParisTech servers, i.e. on www.soda-pro.com for a few hours. Same maintenance operations are then carried out on the mirror website afterwards (www.tsv.soda-pro.com). Users who are using CAMS solar products database are informed by email a few days before, and also as soon as the SoDa Service is back to normal.

 

 

 

2018-09-26 Release  

Reference Title Description Impact for users
#435 McClear and CAMS Radiation WPS broken on www.tsv.soda-pro.com when www.soda-pro.com is down

www.tsv.soda-pro.com is a mirror of www.soda-pro.com.

We fixed a bug: McClear and CAMS Radiation WPS did not work on www.tsv.soda-pro.com when www.soda-pro.com is down.

-
#618 Error message not clear if wrong email encoding in CAMS Radiation and McClear services

A classic error when using CAMS Radiation and McClear WPS is to forget to encode the "@" character.

We detect now this error and return a proper error message.

-
#601 CAMS Radiation Service when no cloud data are available

Since 2018-06-20, CAMS Radiation Service notifies gaps in Apollo cloud data by:

  • large gaps (1 full day or more) are not filled and are notified with irradiation=NaN
  • gaps smaller than 1 day are filled and are notified with reliability=0

A side effect was that monthly irradiation are equal to NaN as soon as one day of Apollo data is missing.

As our users notified us that this behavior is not user-friendly, we restored the gap filling for monthly requests.

-

#635

Cloud coverage value in CAMS Radiation Service can be unspecified


In verbose mode, CAMS Radiation service outputs a Cloud coverage value.

It can be unspecified. Up to now, in such case CAMS Radiation Service returned 0. Now, "unspecified value" is -1.

So possible values for cloud coverage are :

  • [0; 100] : for valid value.
  • -1 : if not specified,
For CAMS Radiation users using "cloud coverage":
users should redo CAMS Radiation requests

Top of page

2018-06-20 Release  

Reference Title Description Impact for users
#595 Bug in Meteosat satellite projection of CAMS Radiation Service

We fixed a mathematical bug in the (latitude, longitude) position of the pixels of the Meteosat satellite images.

This fix changes (a little) the result of all CAMS Radiation requests.

CAMS Radiation Service version number is increased to 3.2.

If possible, users should redo all CAMS Radiation requests
#605 Apollo data missing partly since 2018-06-01

CAMS Radiation service uses a model named Apollo from the DLR to compute clouds. Since 2018-06-01, the DLR is experiencing problems to retrieve the Meteosat satellite images on time.

UPDATE: this problem is fixed since 2018-06-21.

Since 2018-06-01, CAMS Radiation service is available with a delay (d-3 instead of d-2)
#601 CAMS Radiation Service when no cloud data are available

So far, CAMS Radiation Service sometimes notified a gap with irradiation=NaN and sometimes with reliability=0.

This new version is more coherent:

  • large gaps (1 full day or more) are not filled and are notified with irradiation=NaN
  • gaps smaller than 1 day are filled and are notified with reliability=0
The new version of CAMS Radiation Service notifies large gaps (1 full day or more) with irradiation=NaN
#604 C-IFS meteorological model upgrade 45R1_CAMS on 2018-06-26

McClear, CAMS Radiation and Helioclim-3 version 5 use aerosols, ozone and water vapor computed by the C-IFS meteorological model from ECMWF.

This model will be updated on 2018-06-26.

This upgrade will be transparent to McClear, CAMS Radiation and hc3v5 users

Top of page

2018-03-27 Release  

Reference Title Description Impact for users
#370
#588
McClear v3.1

We fixed a few bugs in McClear clear sky model. The results are slightly modified in October 2012 and September-November 2015.
We increased McClear version number to 3.1.

This change in McClear modifies also CAMS Radiation and Helioclim-3 models.

This fix leads to a very small change in the values computed by McClear, CAMS Radiation and hc3v5 services
#544 Bug #544 Apollo slots are missing since 2017-10-21

CAMS Radiation service uses a model named Apollo from the DLR to compute clouds. On 2017-10-21, a fire occured in the DLR server room.

From this date to 2018-02-23, the DLR has ben able able to provide us cloud data with a delay (typically up to d-3 instead of d-2).

This problem is now fixed.

 

Top of page

2018-01-24 Release  

Reference Title Description Impact for users
#566

#566 Increase CAMS Radiation limit to 40 requests per day

CAMS  Radiation service was limited to 25 requests per day. This limit is raised to 40 requests per day. Enjoy!
#563 Fixed bug #563 "http://solar.atmosphere.copernicus.eu not available"

From 2018-01-10 to 2018-01-17, the web site http://solar.atmosphere.copernicus.eu was not available.

http://solar.atmosphere.copernicus.eu is a subset of www.soda-pro.com with only CAMS Radiation and McClear services.

From 2018-01-10 to 2018-01-17, CAMS Radiation and McClear services were available via www.soda-pro.com only
#555

Fixed bug #555 "Since 2017-11-22 update, CAMS and MERRA forms are not displayed in Chrome"

The 2017-11-22 update broke some CAMS and MERRA web services in www.soda-pro.com. This is now fixed. No impact
#544 Bug #544 Apollo slots are missing since 2017-10-21

CAMS Radiation service uses a model named Apollo from the DLR to compute clouds. On 2017-10-21, a fire occured in the DLR server room. Since this date, the DLR is able to provide us cloud data with a delay (typically up to d-3 instead of d-2).

This problem is not yet fixed.

Since 2017-10-21, CAMS Radiation service is available with a delay (typically up to d-3 instead of d-2)

Top of page

2017-11-22 Release  

Reference Title Description Impact for users
#547 Fixed bug #547 "McClear v3: assertion failure in compute_mcclear_kt_gc_analytics()" We fixed a small bug in McClear v3 in the computation of the irradiation at sunrise and sunset. This fix leads to a very small change in the values computed by McClear, CAMS Radiation and hc3v5 services
#548 Fixed bug #548 "McClear v3: assertion failure in summer_winter_split computation on December 21st" We fixed a small bug in McClear v3 in the computation of the irradiation on December 21st. This fix leads to a very small change in the values computed by McClear, CAMS Radiation and hc3v5 services
#552 Uniform handling of monthly requests when start and end dates do not define entire months

The handling of monthly requests was not uniform when start and end dates do not define entire months.
We modified Helioclim-3, Helioclim-1, MERRA-2 and GFS to enlarge partial months requests to entire months. For request overlapping current month, McClear and CAMS Radiation gave "nan" values. So for coherency purpose, the monthly requests are first cropped to full month, and the request is then run with those cropped months.

The new behavior is more user friendly

Top of page

2017-10-11 Release  

Reference Title Description Impact for users
#448 New version 3 of CAMS Radiation Service

CAMS Radiation Service features a new version 3 with:

  • McClear clear sky model v3  (see #494 below)
  • An empirical bias correction algorithm aiming at reducing errors in irradiation and clearness index. It has been created by fitting functions onto measurements performed at several BSRN stations taken globally.

Access:

No impact.

If possible, users should redo all past CAMS Radiation Service requests to enjoy the improvements of v3.

#494 New version 3 of CAMS McClear Service

McClear clear sky model features a new version 3 that fixes discontinuities in space and time (during day as well as seasons), uses less memory and reduces (a little) the error when compared to ground measurements.

Access:

Can potentially impact HelioClim-3 version 5 by 1 to 2%.

If possible, users should redo all past CAMS McClear Service requests to enjoy the improvements of v3.
#511 CAMS global forecasting system upgrade 43r3 on 2017-09-26

McClear, CAMS Radiation and HelioClim-3 version 5 services use a meteorological model from ECMWF to describe the atmosphere.
Since 2017-09-26, this model has been upgraded to version 43r3.

See https://atmosphere.copernicus.eu/implementation-ifs-cycle-43r3cams

No impact
#521 Fixed bug # 521 "ECMWF AOD error from 2017-08-27 to 2017-08-30"

McClear, CAMS Radiation and Helioclim-3 version 5 services use a meteorological model from ECMWF to describe the atmosphere.
This model is updated daily. This update has been broken from 2017-08-27 to 2017-08-30.

Users of McClear, CAMS Radiation and Helioclim-3 version 5 services that ran requests from 2017-08-27 to 2017-08-30 should redo them

Top of page

2017-03-29 Release 

Reference Title Description Impact for users

#434

Increment the max number of CAMS Radiation requests per day

Increment the max number of CAMS Radiation requests per day from 15 to 25.

See http://www.soda-pro.com/web-services/radiation/cams-radiation-service

CAMS Radiation users are allowed to run up to 25 requests per day :-)

#424

Create solar.atmosphere.copernicus.eu microsite

Create solar.atmosphere.copernicus.eu microsite with 2 pages:

http://solar.atmosphere.copernicus.eu/cams-radiation-service

http://solar.atmosphere.copernicus.eu/cams-mcclear.

No impact

#427 Fixed broken link for CAMS data license on www.soda-pro.com Fixed broken link for CAMS data license on www.soda-pro.com

No impact

#431 Fixed bug in McClear,  CAMS Radiation and hc3v5 Fixed bug #431 McClear,  CAMS Radiation and hc3v5 invalid from 2017-03-08 to 2017-03-11 on http://pro.soda-is.com server If possible, users should redo McClear,  CAMS Radiation and hc3v5 requests made from 2017-03-08 to 2017-03-11

Top of page

2017-02-13 Release

Reference Title Description Impact for users

#421

Upgrade of the CAMS (Copernicus Atmosphere Monitoring Service) real-time data assimilation and forecasting system on 2017-01-24

The CAMS numeric weather model that provides inputs to McClear, CAMS Radiation and Helioclim-3 version 5 irradiation models has been improved on 2017-01-24

No impact

#415 Missing data in CAMS Radiation service from 2016-12-24 to 2016-12-29 CAMS Radiation Service uses Apollo Cloud model from DLR. Apollo processing server at DLR experienced troubles from 2016-12-24 to 2016-12-29, leading to missing cloud data. Gaps were filled on 2017-01-17. If possible, users should redo CAMS Radiation Service requests made from 2016-12-24 to 2017-01-17

#416

#425

Bug fixes in CAMS Radiation service monitoring

Bug fixes in CAMS Radiation service monitoring

Restricted to CAMS project members

#344 The obsolete McClear and CAMS Radiation (ex MACC-RAD) web services on toolbox.webservice-energy.org have been removed today.

The McClear and CAMS Radiation (ex MACC-RAD) web services have been officially moved from toolbox.webservice-energy.org to www.soda-is.com on 2016-04-20.

We kept the old web services on toolbox.webservice-energy.org during a transition period. They have been removed today.

Users of the obsolete web services on toolbox.webservice-energy.org must upgrade their code.

See http://www.soda-pro.com/help/cams-services/cams-radiation-service/automatic-access

Top of page

2016-11-16 Release

Reference Title Description Impact for users

#191

Bug fixes in CAMS Radiation service monitoring when accessed from DLR

Bug fixes in CAMS Radiation service monitoring when accessed from DLR

Restricted to CAMS project members

Top of page

2016-10-18 Release

Reference Title Description Impact for users

#397

CAMS radiation gives different results on www.soda-is.com and pro.soda-is.com since 2016-10-05

CAMS radiation gives different results on www.soda-is.com and pro.soda-is.com since 2016-10-05

If possible, users should redo CAMS radiation requests computed by www.soda-is.com and pro.soda-is.com from 2016-10-05 to 2016-10-18

#390

Fixed McClear atmospheric profiles

Fixed weights > 1.0 and < 0.0 in McClear atmospheric profiles

No impact

#191

CAMS Radiation service monitoring works on www.soda-pro.com

CAMS Radiation service monitoring works on www.soda-pro.com

Restricted to CAMS project members

Top of page

2016-08-16 Release

Reference Title Description Impact for users

-

Changes in McClear and CAMS Radiation web pages

Added hyperlinks to https://atmosphere.copernicus.eu/user-support-0 in McClear and CAMS Radiation web pages

No impact

#381

 

Download errors after CAMS system upgrade on 2016-06-21

After CAMS system upgrade on 2016-06-21, we encountered download errors up to 2016-08-12.

No impact

#379

Fixed bug in Apollo Cloud monitoring

Fixed bug in Apollo Cloud monitoring

Restricted to CAMS project members

-

Upgrade of McClear WPS

Added verbose HDF5 output to McClear WPS

No impact

Top of page

2016-06-23 Release

Reference Title Description Impact for users

#369

Upgrade of the CAMS real-time data assimilation and forecasting system on 2016-06-21

The CAMS numeric weather model that provides inputs to McClear, CAMS Radiation and Helioclim-3 version 5 irradiation models has been improved on 2016-06-21. The new model uses a 0.4 degree grid (about 40 km) and computes now hourly previsions twice a day.

No impact

Top of page

2016-06-09 Release

Reference Title Description Impact for users

-

McClear and CAMS Radiation web pages have a new look & feel

http://www.soda-pro.com/web-services/radiation/cams-radiation-service and http://www.soda-pro.com/web-services/radiation/cams-mcclear use now the look & feel of the Copernicus Atmosphere Monitoring Service (http://atmosphere.copernicus.eu) that funded these services.

No impact

-

Change in McClear and CAMS Radiation requests header

Added link to release notes information on  www.soda-pro.com in McClear and CAMS Radiation .csv output files

No impact

Top of page

2016-04-19 Release

Reference Title Description Impact for users

#319

Increased CAMS Radiation Service limit

Increased CAMS Radiation Service limit from 5 to 15 requests per day

No impact

#319

McClear and CAMS Radiation WPS are moved to www.soda-is.com

McClear and CAMS Radiation WPS are moved from test server http://toolbox.webservice-energy.org to production servers www.soda-is.com and http://pro.soda-is.com

McClear and CAMS Radiation WPS users should update their code.

#319

MACC-RAD service is renamed CAMS Radiation

The MACC-III project (http://www.gmes-atmosphere.eu/) that funded MACC-RAD and McClear services is replaced by the Copernicus Atmosphere Monitoring Service (http://atmosphere.copernicus.eu). A consequence is that the MACC-RAD service is renamed CAMS Radiation.

The get_macc_rad WPS is renamed get_cams_radiation. Users should update their code.

#268

Fixed bug in McClear web form

Bug fix: sometimes, McClear web form http://www.soda-pro.com/web-services/radiation/cams-mcclear fails with a "Connection reset" error

No impact

Top of page

2015-12-15 Release

Reference Title Description Impact for users
#301 Upgrade of the CAMS real-time data assimilation and forecasting system on 2015-11-27 The CAMS numeric weather model that provides inputs to McClear, CAMS Radiation and Helioclim-3 version 5 irradiation models has been improved on 2015-11-27. The new model uses a 0.75 degree grid (about 75 km) and computes now hourly previsions. No impact of the model change
(see next line, though)
#301 Download errors after CAMS system upgrade on 2015-11-27 After CAMS system upgrade on 2015-11-27, we encountered download errors (due to a miscommunication with CAMS team).
We implemented a hack on 2015-12-09 to compute McClear, CAMS Radiation and Helioclim-3 version 5 using a persistence algorithm on McClear clear sky irradiation.
CAMS upgrade was properly implemented on 2015-12-15.
If possible, users should redo McClear, CAMS Radiation and Helioclim-3 version 5 requests computed from 2015-11-27 to 2015-12-15

Top of page