Spectral by SoDa
Spectral BY SODA automatic access: PAR, uv & kato bands |
|
Warning! It is strongly recommended to avoid the launch of parallel requests, using the "&" at the end of each wget request line. This would endanger our system.
I. Automatic access using WGET
- Subscribe an annual access to Spectral by SoDa service (Contact us)
- Download wget.exe in a directory (on Windows - wget is available by default on Unix)
- In the same directory, create a text file and copy-paste in a single line (discard dots and carriage return) the following instruction to test this permanent access to Carpentras, France:
|
- Rename the text file with the .bat extension and double click on it to retrieve the
output.csv
output file (Windows environment). Or, rename the text file with a .sh extension and run it using >my_script.sh in a Unix environment.
UV DATA
(Click on the following links to show the tutorials)
UV automatic command with inputs to fill in
(discard dots and place the following commands into a single line)
|
UV inputs details
login/password
authentication: login and password provided by the SoDa team to access Spectral by SoDa within the framework of your subscription. Note that a free permanent automatic access is set up for the site of Carpentras, France, with the login/password guest/guestserver
: "sodabdd3" (main server) or "pro.soda-is.com" (mirror server)latitude
andlongitude
: in degrees, with at least 4 digits after commaaltitude
: in meters. Set "elevation=-999" to let SoDa get the elevation from Nasa SRTM databaseyyyy-mm-dd
: set the first and the last days of the requesttime_step
: "1", "5", "10", "15" (minutes), "h" (hourly), "d" (daily), "m" (monthly)activate_horizon_computation
: "1" (or "0") to take into account (or not) the shadowing effect due to the far horizon.
UV example
(discard dots and place the following commands into a single line)
|
UV outputs
- Date: format DD-MM-YYYY
- Time: format hh:mm
- UVB GHI (Wh/m2): Irradiation in UV-B (280-315 nm) over the period on horizontal plane (-999 if no data or outside MSG coverage)
- UVB Gc clear-sky (Wh/m2): Irradiation in UV-B (280-315 nm) over the period on horizontal plane if the sky was clear (-999 if no data)
- UVB TOA (Wh/m2): Irradiation in UV-B (280-315 nm) over the period at the Top of the Atmosphere (-999 if no data)
- UVA GHI (Wh/m2): Irradiation in UV-A (315-400 nm) over the period on horizontal plane (-999 if no data or outside MSG coverage)
- UVA Gc clear-sky (Wh/m2): Irradiation in UV-A (315-400 nm) over the period on horizontal plane if the sky was clear (-999 if not data)
- UVA TOA (Wh/m2): Irradiation in UV-A (315-400 nm) over the period at the Top of the Atmosphere (-999 if not data)
- UV GHI (Wh/m2): Irradiation in UV (280-400 nm) over the period on horizontal plane (-999 if no data or outside MSG coverage)
- UV Gc clear-sky (Wh/m2): Irradiation in UV (280-400 nm) over the period on horizontal plane if the sky was clear (-999 if no data)
- UV TOA (Wh/m2): Irradiation in UV (280-400 nm) over the period at the Top of the Atmosphere (-999 if no data)
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
PAR DATA
(Click on the following links to show the tutorials)
PAR automatic command with inputs to fill in
(discard dots and place the following commands into a single line)
|
PAR inputs details
login
/
password
authentication: login and password provided by the SoDa team to access Spectral by SoDa within the framework of your subscription. Note that a free permanent automatic access is set up for the site of Carpentras, France, with the login/password guest/guestserver
: "sodabdd3" (main server) or "pro.soda-is.com" (mirror server)latitude
andlongitude
: in degrees, with at least 4 digits after commaaltitude
: in meters. Set "elevation=-999" to let SoDa get the elevation from Nasa SRTM databaseyyyy-mm-dd
: set the first and the last days of the requesttime_step
: "1", "5", "10", "15" (minutes), "h" (hourly), "d" (daily), "m" (monthly)- activate_horizon_computation: "1" (or "0") to take into account (or not) the shadowing effect due to the far horizon.
PAR example
(discard dots and place the following commands into a single line)
|
PAR outputs
- Date: format DD-MM-YYYY
- Time: format hh:mm
- PAR GHI (µmol/m2/s): PAR (400-700 nm) over the period on horizontal plane (-999 if no data or outside MSG coverage)
- PAR Gc clear-sky (µmol/m2/s): PAR (400-700 nm) over the period if the sky was clear (-999 if no data)
- PAR TOA (µmol/m2/s): PAR (400-700 nm) over the period at the Top of the Atmosphere (-999 if no data)
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
KATO BANDS
(Click on the following links to show the tutorials)
KATO automatic command with inputs to fill in
(discard dots and place the following commands into a single line)
|
KATO inputs details
login
/
password
authentication: login and password provided by the SoDa team to access Spectral by SoDa within the framework of your subscription. Note that a free permanent automatic access is set up for the site of Carpentras, France, with the login/password guest/guestserver
: "sodabdd3" (main server) or "pro.soda-is.com" (mirror server)latitude
andlongitude
: in degrees, with at least 4 digits after commaaltitude
: in meters. Set "elevation=-999" to let SoDa get the elevation from Nasa SRTM databaseyyyy-mm-dd
: set the first and the last days of the requesttime_step
: "1", "5", "10", "15", "30" (minutes), "h" (hourly), "d" (daily), "m" (monthly)- activate_horizon_computation: "1" (or "0") to take into account (or not) the shadowing effect due to the far horizon
KatoLowerBound and
KatoUpperBound
: the first and last band of Kato band interval.
KATO example
(discard dots and place the following commands into a single line)
|
KATO outputs
- Date: format DD-MM-YYYY
- Time: format hh:mm
- Kato[i] (Wh/m2): Irradiation over the period on horizontal plane for the ith Kato band (-999 if no data or outside MSG coverage)
- Kato[i] clear-sky (Wh/m2): Irradiation over the period if the sky was clear for the ith Kato band (-999 if no data)
- Kato[i] TOA (Wh/m2): Irradiation over the period at the Top of the Atmosphere for the ith Kato band (-999 if no data)
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
II. Automatic access using CURL
You can also automatically retrieve these data using the CURL command. The advantage is to fasten the requests by an approx. factor of 2. Note that all characteristics (inputs and outputs) described in the WGET section are valid for CURL, except that CURL outputs don't have any header.
Request (Windows):
curl -f -s -S -F stations=@stations.txt -o output.csv --header "soda-user: guest" ...
--header "soda-passwd: guest" http://www.soda-is.com/pub/spectral_by_soda_request.php
With the following stations.txt file format:
# Spectral by SoDa station file for curl. #id latitude longitude elevation duration firstday lastday spectral_band activate_horizon_computation UV-id1 47.41 8.53 450 h 2004-04-15 2004-04-15 UV 0
UV-id2 10 5 -999 h 2004-04-15 2004-04-15 uv 1
PAR-id3 0 0 0 h 2004-04-15 2004-04-15 par 0 PAR-id4 10 5 -999 h 2004-04-15 2004-04-15 par 1
KATO-id5 10 5 -999 h 2004-04-15 2004-04-15 KATO=3,5 0
KATO-singleband-id6 10 5 -999 h 2004-04-15 2004-04-15 KATO=8 0 |