{
"info": {
"author": "Carmelo Sammarco",
"author_email": "sammarcocarmelo@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 3 - Alpha",
"Intended Audience :: Science/Research",
"Programming Language :: Python :: 3.6",
"Topic :: Scientific/Engineering"
],
"description": "# ads4MO - Added Download Services for Mercator-Ocean\n\n[](https://travis-ci.com/carmelosammarco/ads4mo) [](https://ci.appveyor.com/project/carmelosammarco/ads4mo) [](https://pypi.org/project/ads4MO/) [](https://gitter.im/ads4mo/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) \n\nI developed this software while working as [AKKA](https://www.akka-technologies.com) consultant engeneer for the [CMEMS's Service Desk (Copernicus Marine Environment Monitoring Service)](http://marine.copernicus.eu). I was and I am inspired by the Mercator-Ocean's community (users, co-workers, web-forum discussions and many more) which gave me ideas and the motivational power to build this tool. It is the first python application of its kind created inside the CMEMS environment and I hope that with time it will became an ufficial CMEMS tool. The main goals that I wanted to adress were solving the most common user problems as the data-download requests and the netCDF file manipulations.\n\n**This project gave me also ideas to develop other tools** as [tool4NC](https://github.com/carmelosammarco/tool4NC), [MerocENV](https://github.com/carmelosammarco/MerocENV) and [MerOC](https://github.com/carmelosammarco/MerOC). To know more about them just visit the projects web pages which are hyperlinked above.\n\nI created also a **chat-community** powered by \"Gitter\" where is possible have an exchange of ideas,functionalities,bugs and many more. Just click  to acces the chat room.\n\nMany thanks to visit this page and try this software.\n\n**Carmelo Sammarco**\n\n## Introduction:\nPython module containing added downloads services for download the netCDF files from the CMEMS's catalogue and especially usefull for big data requests. It is possible download data by MONTH, DEPTH or DAY until a maximum of three selected variables(Planning to increase this number thought).\nIt brings in a very intuitive scripting way what was already proposed with [MerOC](https://github.com/carmelosammarco/MerOC).\n\n
\n \n
\n\n## Be aware that:\n\nThe tool is in development so it can be possible find bugs, errors and imprecisions. Please to report them if you find one.\n\n## Dependencies:\n\nThe dependencies required which are not installed by default are listed below:\n\n- [x] motuclient>=1.8.1\n- [x] ftputil>=3.4\n\n## Installation and module usage\n\nIt is possible to install and then use in both UNIX and Windows operative systems following the below steps:\n\n```\npip install ads4MO\n```\nwe can import the module as:\n\n```\nfrom ads4MO import download\n```\nOnce the module is imported we can call the interactive download process typing;\n\n```\ndownload()\n```\n\nAt this point the system is going to ask:\n\n- **Username and password**\n\n- **Type of the download** which can be set typing one of the following:\n\n - **MONTH**: The entire period selected will be downloaded by months\n - **DEPTH**: The entire period selected will be downloaded by depth levels\n - **DAY**: The entire period selected will download as daily files\n - **MONTH&DEPTH**: The entire period selected will be downloaded by months and depth levels\n - **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).\n\n- **Starting/Ending Time**: If not values as HH:MM:SS are typed then \"12:00:00\" is going to be used as default value.\n\n- **Motu client script** which is generated by the CMEMS web portal.\nPlease to copy and paste just from the \"--motu\" until the end. You can leave untouched \"--out-dir --out-name --user --pwd \" because they were already set previously.\n\nFollowing an example of the full script generted by the Web-portal:\n\n```\npython -m motuclient --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 --out-name --user --pwd \n```\n\nWhat you need to use as module's input:\n\n```\n--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 --out-name --user --pwd \n```\n\nThe results are going to be downloaded in the file path in which the terminal/command-prompt was at the moment of the data request.\n\n## Stand-alone applications (No Python installation required):\n\n---------\n\n**The stand-alone App for Windows OS can be downloaded from [HERE](https://www.dropbox.com/s/e5ilv9x84m4m0gk/ads4mo-win.exe?dl=0).**\n\nThe APP was developed, compiled and tested in Windows 10 environment. As soon as I have time I will try to test it in other Windows environments. It will generate a folder called \"CMEMS_DATA\" in which all the data downloaded are going to be stored. This folder will be stored in the same system path where the executable \"ads4mo-win.exe\" is located.\n\n---------\n\n**The stand-alone App for macOS can be downloaded from [HERE](https://www.dropbox.com/s/vimrdqhcri5tevm/ads4mo-macOS.zip?dl=0).**\n\nIf the APP doesn't start because of \"unidentified developer\" message then you need to give the system the permission to run it. In more details, please to go in **Security & Privacy** (Tab \"General\") and then click on the button which will allows the execution of the tool. It will create a Desktop folder called \"CMEMS_DATA\" which will store all the data downloaded.\n\n---------",
"description_content_type": "text/markdown",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/carmelosammarco/d4mo",
"keywords": "",
"license": "gpl-3.0",
"maintainer": "",
"maintainer_email": "",
"name": "ads4MO",
"package_url": "https://pypi.org/project/ads4MO/",
"platform": "",
"project_url": "https://pypi.org/project/ads4MO/",
"project_urls": {
"Homepage": "https://github.com/carmelosammarco/d4mo"
},
"release_url": "https://pypi.org/project/ads4MO/0.0.3/",
"requires_dist": null,
"requires_python": "~=3.6",
"summary": "Python module which adds new CMEMS downloads services (applied mainly to big data requests)",
"version": "0.0.3"
},
"last_serial": 5782390,
"releases": {
"0.0.3": [
{
"comment_text": "",
"digests": {
"md5": "feb92c0d09b8b0a6dd5d4a1f81c8c10e",
"sha256": "6c56392ab70a1f9abf2c0073cee52b53fc67f6fad853ddb4b643ad1def4dc826"
},
"downloads": -1,
"filename": "ads4MO-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "feb92c0d09b8b0a6dd5d4a1f81c8c10e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.6",
"size": 11947,
"upload_time": "2019-09-04T16:42:48",
"url": "https://files.pythonhosted.org/packages/e1/fc/1760be79f213dac29b74c2a13e863b0e3278fc8b5239a617ca6286bce0e4/ads4MO-0.0.3.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "feb92c0d09b8b0a6dd5d4a1f81c8c10e",
"sha256": "6c56392ab70a1f9abf2c0073cee52b53fc67f6fad853ddb4b643ad1def4dc826"
},
"downloads": -1,
"filename": "ads4MO-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "feb92c0d09b8b0a6dd5d4a1f81c8c10e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.6",
"size": 11947,
"upload_time": "2019-09-04T16:42:48",
"url": "https://files.pythonhosted.org/packages/e1/fc/1760be79f213dac29b74c2a13e863b0e3278fc8b5239a617ca6286bce0e4/ads4MO-0.0.3.tar.gz"
}
]
}
![](\"DATA/FILE.gif\")
\n