CAMS McClear automatic access

1_ With the command WGET

Build your first WGET request in 5 minutes

The automatic access is for free. It is limited to registered users and the number of requests is limited to 15 per day.

Build your first request as follows, using the login that you entered for your registration to the SoDa website. Let's admit that you are in a Windows environment. Copy and paste the following line in a text file, and rename it with the .bat extension (request over the city of Carpentras, France (44.083°, 5.059°), from 2017-01-01 to 2017-01-05, 15 min time step, login address: myemailaddress@mycompany.fr):

Request (Windows, write the following command in a single line): wget -O CAMS-McClear_Carpentras_2017-01-01_2017-01-05.csv "http://www.soda-is.com/service/wps? ... Service=WPS&Request=Execute&Identifier=get_mcclear&version=1.0.0&DataInputs=latitude=44.083;longitude=5.059; altitude=-999;date_begin=2017-01-01;date_end=2017-01-05;time_ref=UT;summarization=PT15M; username=myemailaddress%%2540mycompany.com&RawDataOutput=irradiation"NB: you should use only one % on a Windows command terminal, an internet browser or on Unix, but use a double %% ... in a .bat executable file on Windows.

Download wget.exe in the same directory of your .bat file, and launch your command by double clicking on your .bat file.

For more details on Wget (Unix / Windows, automatic shift to the mirror website, retrieve automatically the data for the previous month / day...), please refer to the page dedicated to the automatic access to HelioClim-3.

email-address: your email address used to generate your SoDa account, by replacing the "@" by "%%2540" if this command is in a Windows executable .bat file, and by "%2540" if on a Windows command terminal, an internet browser or on Unix

For "summarization=PT01M" only, a verbose mode is available by adding "verbose=true" to the DataInputs. Example in a .bat file on Windows (write the command in a single line):wget -O CAMS-McClear_Carpentras_2017-01-01_2017-01-05.csv "http://www.soda-is.com/service/wps? Service=WPS&Request=Execute&Identifier=get_mcclear&version=1.0.0&DataInputs=latitude=44.083;longitude=5.059; altitude=-999;date_begin=2017-01-01;date_end=2017-01-05;time_ref=UT;summarization=PT01M; username=myemailaddress%%2540mycompagny.com;verbose=true&RawDataOutput=irradiation"

Warning! It is strongly recommanded to avoid the launch of parallel requests, using the "&" at the end of each wget request line. This would endanger our system.

2_ With a WPS

CAMS McClear may be accessed in an automated way. The WPS (Web Processing Service) is a means to invoke these services by a computer, without human-machine interface. This is the means that has been selected to fulfill the request for automated access. This way of doing is a standard in Earth Observation and digital geography and offers many other advantages than a text-interface linked to the SoDa web site. In particular, anyone can create a portal invoking these services by calling the WPS that we are offering. It greatly helps the dissemination.

How to do it by hand (or in an application not calling specific libraries)? The request will have the following form curl -o output.xml -v -d @test_mcclear_params.xml -H "Content-Type: text/xml" http://www.soda-is.com/service/wps where "output.xml" is the output file that contains the URL of the result (here a csv file) and "test_mcclear_params.xml" is the input file. The input file contains the inputs (obviously...). Most of them have clear names and are exactly those which are requested on the human interface at soda-pro.com. If choice is offered, e.g. "summarization", the various options are provided by the call to DescribeProcess. The "username" is the email registered in soda-pro.com.

- If this tutorial is not appropriate or incomplete, feel free to ** and contribute to the improvement of this page. Any feedback is welcome -