ads4MO - Added Download Services

I developed this software because motivated to improve my efficiency and productivity. It is just an attemp/idea/prototype and it is not fully optimased or considered stable.

This project gave me also ideas to develop other tools as tool4NC, JupLab4NetCDF and MerOC. To know more about them just visit the projects web pages which are hyperlinked above.

Many thanks to visit this page and try this software.

Carmelo Sammarco

Introduction:

It is possible download data by MONTH, DEPTH or DAY until a maximum of three selected variables(Planning to increase this number thought). It brings in a very intuitive scripting way what was already proposed with MerOC.

Be aware that:

The tool is in development so it can be possible find bugs, errors and imprecisions. Please to report them if you find one.

Dependencies:

The dependencies required which are not installed by default are listed below:

• motuclient>=1.8.1
• ftputil>=3.4

Installation and module usage

It is possible to install and then use in both UNIX and Windows operative systems following the below steps:

pip install ads4MO

we can import the module as:

from ads4MO import download

Once the module is imported we can call the interactive download process typing;

download()

At this point the system is going to ask:

• Username and password

• Type of the download which can be set typing one of the following:

  • MONTH: The entire period selected will be downloaded by months
  • DEPTH: The entire period selected will be downloaded by depth levels
  • DAY: The entire period selected will download as daily files
  • MONTH&DEPTH: The entire period selected will be downloaded by months and depth levels
  • YEAR: The entire period selected will be downloaded by years. Very usefull just when you want extract a grid point (The --longitude-min = --longitude-min and --latitude-min = --latitude-max).

• Starting/Ending Time: If not values as HH:MM:SS are typed then "12:00:00" is going to be used as default value.

• Motu client script which is generated by the CMEMS web portal. Please to copy and paste just from the "--motu" until the end. You can leave untouched "--out-dir <OUTPUT_DIR> --out-name <OUTPUT_FILENAME> --user <USERNAME.> --pwd <PASSWORD.>" because they were already set previously.

Following an example of the full script generted by the Web-portal:

python -m motuclient  --motu http://..... --service-id GLOBAL_ANALYSIS_FORECAST_PHY_001_024-TDS --product-id global-analysis-forecast-phy-001-024 --longitude-min -180 --longitude-max 179.9166717529297 --latitude-min -80 --latitude-max 90 --date-min "2019-04-19 12:00:00" --date-max "2019-04-19 12:00:00" --depth-min 0.493 --depth-max 0.4942 --variable thetao --variable bottomT  --out-dir <OUTPUT_DIR> --out-name <OUTPUT_FILENAME> --user <USERNAME> --pwd <PASSWORD>

What you need to use as module's input:

--motu http://nrt.cmems-du.eu/motu-web/Motu --service-id GLOBAL_ANALYSIS_FORECAST_PHY_001_024-TDS --product-id global-analysis-forecast-phy-001-024 --longitude-min -180 --longitude-max 179.9166717529297 --latitude-min -80 --latitude-max 90 --date-min "2019-04-19 12:00:00" --date-max "2019-04-19 12:00:00" --depth-min 0.493 --depth-max 0.4942 --variable thetao --variable bottomT  --out-dir <OUTPUT_DIR> --out-name <OUTPUT_FILENAME> --user <USERNAME> --pwd <PASSWORD>

The results are going to be downloaded in the file path in which the terminal/command-prompt was at the moment of the data request.