Add Platform "MULTISAT" to download only L3B-SNOW products

README.md

@@ -4,7 +4,7 @@ This is a simple piece of code to automatically download the products provided b
 
 This code was written thanks to the precious help of one my colleague at CNES [Jérôme Gasperi](https://www.linkedin.com/pulse/rocket-earth-your-pocket-gasperi-jerome) who developped the "rocket" interface which is used by Theia, and the mechanism to get a token. It was then adapted by Dominique Clesse for the new Muscate interface to download Sentinel-2 products.
 
-This code relies on python 2.7 and on the curl utility. *Installing curl is therefore a prerequisite*. It has been developped and tested on Linux. It might work on windows, but I cannot test it. To use the code, you need to have an account and a password [at theia](http://theia.cnes.fr/atdistrib), and you need to add it to the config file as explaned in the authentification paragraph.
+This code has been tested with python 2.7 and python 3.6. It relies on the curl utility. *Installing curl is therefore a prerequisite*. It has been developped and tested on Linux. It might work on windows, but I cannot test it. To use the code, you need to have an account and a password [at theia](https://sso.theia-land.fr/theia/register/register.xhtml), and you need to add it to the config file as explained in the authentification paragraph.
 
 ## Examples for various sensors
 If you have an account at theia, you may download products using command lines like 
@@ -15,21 +15,42 @@ If you have an account at theia, you may download products using command lines l
 
  - `python ./theia_download.py -l 'Toulouse' -c SENTINEL2 -a config_theia.cfg -d 2016-09-01 -f 2016-10-01 -m  50`
 
- which downloads the SENTINEL-2 products above Toulouse, acquired in September 2016 with less tha 50% cloud cover
+ which downloads the SENTINEL-2 products above Toulouse, acquired in September 2016 with less than 50% cloud cover
 
-- `python ./theia_download.py -l 'Toulouse' -c Landsat -a config_landsat.cfg -d 2016-09-01 -f 2016-10-01`
+- `python ./theia_download.py -l 'Toulouse' -c LANDSAT -a config_theia.cfg -d 2019-01-01 -f 2019-02-01`
 
- which downloads the LANDSAT-8 products above Toulouse, acquired in September 2016.
+ which downloads the LANDSAT-8 products above Toulouse, acquired in January 2019.
+
+ - `python ./theia_download.py -l 'Toulouse' -c Landsat -a config_theia.cfg -d 2016-09-01 -f 2016-10-01`
+
+ which downloads the LANDSAT-8 products, with the old MUSCATE format above Toulouse, acquired in September 2016.
+
+- `python ./theia_download.py -l 'France' -c VENUS -a config_theia.cfg -d 2019-01-01 -f 2019-02-01`
+
+ which downloads the VENUS products from all sites in France, acquired in January 2019.
+
+ - `python ./theia_download.py -s 'KHUMBU' -c VENUS -a config_theia.cfg -d 2019-01-01 -f 2019-02-01`
+
+ which downloads the VENUS products above KHUMBU site, acquired in January 2019.
+
+ - `python ./theia_download.py -s 'HECHUAN' -c VENUSVM05 -a config_theia.cfg -d 2023-03-17 -f 2023-03-18`
 
-- `python ./theia_download.py -l 'Toulouse' -c SpotWorldHeritage -a config_landsat.cfg -d 2006-01-01 -f 2007-01-01`
+ which downloads the latest VENUS VM05 products above HECHUAN site, acquired in March 2023.
 
- which downloads the SPOT World Heritage products above Toulouse, acquired in 2006.
+- `python ./theia_download.py -l 'Yaounde' -c SPOTWORLDHERITAGE -a config_theia.cfg -d 2012-01-01 -f 2013-01-01`
+
+
+ - `python ./theia_download.py -l 'Toulouse' -c SWH1 -a config_theia.cfg -d 2006-01-01 -f 2007-01-01`
+
+ which downloads the SPOT World Heritage products old format above Toulouse, acquired in 2006.
 
  - `python ./theia_download.py -l 'Foix' -c Snow -a config_theia.cfg -d 2016-11-01 -f 2016-12-01`
 
  which downloads the Theia snow products above Foix (Pyrenees), acquired in November 2016. The collection option is case sensitive.
 
-As you must have noted, there are two different config files, depending on the whether you are using SENTINEL2 data (config_theia.cfg) , or Landsat or Spot world Heritage data (config_landsat.cfg). This is temporary, due to the start of MUSCATE ground segment, and soon, all the products will accessed with the config_theia.cfg authentification.
+ - `python ./theia_download.py -t 31TGK -a config_theia.cfg -c Snow -d 2015-01-01 --snow_level L3B-SNOW`
+
+ which downloads all available Level-3B Snow products (annual syntheses) of tile 31TGK.
 
 ## Other options
 
@@ -45,9 +66,9 @@ As you must have noted, there are two different config files, depending on the w
 
  which downloads the LANDSAT 8 products in latitude, longitude box around Toulouse, acquired in November 2015.
 
-- `python theia_download.py -l 'Toulouse' -a config_landsat.cfg -c SpotWorldHeritage -p SPOT4 -d 2005-11-01 -f 2006-12-01`
+- `python theia_download.py -l 'Toulouse' -a config_landsat.cfg -c SPOTWORLDHERITAGE -p SPOT4 -d 2005-11-01 -f 2006-12-01`
 
-which downloads the SpotWorldHeritage products acquired by SPOT5 in 2005-2006
+which downloads the SPOTWORLDHERITAGE products acquired by SPOT5 in 2005-2006
 
 - `python ./theia_download.py -c SENTINEL2 -t T31TCJ -r 51 d 2017-01-01 -f 2018-01-01`
 
@@ -60,5 +81,12 @@ The config file  config_landsat.cfg or  config_landsat.cfg  must contain your em
 
 If you need to go through a proxy, and if you have not configured your proxy variable (`export http_proxy=http://moi:[email protected]:8050`), you may also use one of the files like config_theia_proxy.cfg or config_landsat_proxy.cfg and add your passwords in them.
 
-The program first fetches a token using your email address and password, and then uses it to download the products. As the token is only valid for two hours, it is advised to request only a reasonable number of products. It is necessary to make a first download from the site manually in order to validate your accound and the licence in the case of SpotWorldHeritage.
+The program first fetches a token using your email address and password, and then uses it to download the products. As the token is only valid for two hours, it is advised to request only a reasonable number of products. It is necessary to make a first download from the site manually in order to validate your accound and the licence in the case of SPOTWORLDHERITAGE.
+
+## Alternatives
+
+The EODAG tool has an interface to download data from Theia, PEPS, and many others, and it is probably much more professional code. You might give it a try.
+
+https://eodag.readthedocs.io/en/latest/#
 
+https://github.com/CS-SI/eodag