{"id":13734017,"url":"https://github.com/jgomezdans/get_modis","last_synced_at":"2025-04-25T17:17:52.624Z","repository":{"id":8992417,"uuid":"10741544","full_name":"jgomezdans/get_modis","owner":"jgomezdans","description":"Downloading MODIS data from the USGS repository","archived":false,"fork":false,"pushed_at":"2022-08-30T16:17:29.000Z","size":55,"stargazers_count":62,"open_issues_count":5,"forks_count":41,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-25T17:17:47.430Z","etag":null,"topics":["earth-observation","python","remote-sensing"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jgomezdans.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-06-17T16:17:13.000Z","updated_at":"2024-05-16T08:36:32.000Z","dependencies_parsed_at":"2023-01-11T17:31:24.612Z","dependency_job_id":null,"html_url":"https://github.com/jgomezdans/get_modis","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgomezdans%2Fget_modis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgomezdans%2Fget_modis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgomezdans%2Fget_modis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgomezdans%2Fget_modis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgomezdans","download_url":"https://codeload.github.com/jgomezdans/get_modis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250860493,"owners_count":21498945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["earth-observation","python","remote-sensing"],"created_at":"2024-08-03T03:00:51.751Z","updated_at":"2025-04-25T17:17:52.602Z","avatar_url":"https://github.com/jgomezdans.png","language":"Python","funding_links":[],"categories":["`Python` processing of optical imagery (non deep learning)","Python"],"sub_categories":["Download"],"readme":"get_modis\n==========\n:Info: MODIS data product granule downloader\n:Author: J Gomez-Dans \u003cj.gomez-dans@ucl.ac.uk\u003e\n:Date: $Date: 2013-06-17 17:00:00 +0000  $\n:Description: README file\n\nDescription\n--------------\n\nThis repository contains a Python script (and executable) that allows one to download MODIS data granules for different products and periods. \n\nThe code is quite simple and generic, and should work with most standard Python installations.\n\nSee more `here \u003chttp://jgomezdans.github.io/downloading-modis-data-with-python.html\u003e`_.\n\nUsage\n------\n\nThis is a command line tool. It has only been tested on Linux, but should also work with Windows. There are a number of options that can be used, and you can get a list of them issuing the ``-h`` or ``--help`` commands. Also note that as of summery 2016, you **must have a username and password** pair to access the server. If you haven't got one, you can get it `here \u003chttps://earthdata.nasa.gov/\u003e`_. You will also need to allow your user account to access the USGS MODIS archive (you only need to do this once).\n\n.. code-block: bash\n\n    $ ./get_modis.py -h\n    Usage\n    =====\n      \n    SYNOPSIS\n        \n    ./get_modis.py [-h,--help] [--username=USERNAME, -u USERNAME] [--password=PASSWORD, -P PASSWORD] \n    [--verbose, -v] [--platform=PLATFORM, -s PLATFORM]    [--proxy=PROXY -p PROXY]     \n    [--product=PRODUCT, -p PRODUCT] [--tile=TILE, -t TILE]     [--year=YEAR, -y YEAR] \n    [--output=DIR_OUT, -o DIR_OUT]     [--begin=DOY_START, -b DOY_START] [--end=DOY_END, -e DOY_END]\n\n    DESCRIPTION\n\n    A program to download MODIS data from the USGS website using the HTTP\n    transport. This program is able to download daily, monthly, 8-daily, etc \n    products for a given year, it only requires the product names (including the \n    collection number), the year, the MODIS reference tile and additionally, where\n    to save the data to, and whether to verbose. The user may also select a \n    temporal period in terms of days of year.  Note that as of summer 2016, NASA\n    requires that all downloads are identified with a username and password.\n\n    EXAMPLES\n\n        The following example downloads daily surface reflectance from the TERRA \n        platform for tile h17v04 for 2004, between DoY 153 and 243:\n        \n        $ ./get_modis.py -v -p MOD09GA.005 -s MOLT -y 2004 -t h17v04 -o /tmp/         -b 153 -e 243\n        \n        The script will also work with monthly or 8-daily composites. Here's how \n        you download the monthly MCD45A1 (burned area) product for the same period:\n        \n        $ ./get_modis.py -v -p MCD45A1.005 -s MOTA -y 2004 -t h17v04 -o /tmp/         -b 153 -e 243\n            \n\n    EXIT STATUS\n        No exit status yet, can't be bothered.\n\n    AUTHOR\n\n        J Gomez-Dans \u003cj.gomez-dans@ucl.ac.uk\u003e\n        See also http://github.com/jgomezdans/get_modis/\n\n\n\n    Options\n    =======\n    --help, -h              show this help message and exit\n    --verbose, -v           verbose output\n    --platform=PLATFORM, -s PLATFORM\n                            Platform type: MOLA, MOLT or MOTA\n    --product=PRODUCT, -p PRODUCT\n                            MODIS product name with collection tag at the end\n                            (e.g. MOD09GA.005)\n    --tile=TILE, -t TILE    Required tile (h17v04, for example)\n    --year=YEAR, -y YEAR    Year of interest\n    --output=DIR_OUT, -o DIR_OUT\n                            Output directory\n    --begin=DOY_START, -b DOY_START\n                            Starting day of year (DoY)\n    --end=DOY_END, -e DOY_END\n                            Ending day of year (DoY)\n    --proxy=PROXY, -r PROXY\n                            HTTP proxy URL\n    --quick, -q             Quick check to see whether files are present\n    \nUseful things to bear in mind:\n\n* The platform **MUST** be one of ``MOLA`` (Aqua), ``MOLT`` (Terra) or ``MOTA`` (Combined).\n* The product must have an indication of the collection follwing the product name. i.e. ``MCD45A1.005``)\n* The ``--begin`` and ``--end`` flags are optional, and yu can ignore them if you just want the complete year\n* Use the ``--proxy`` option to set the required proxy. It should be read from the environment variable, but this is added flexiblity\n\nThe code has some logic not to download files several times, and the overall behaviour rests on the ``--quick`` flag: if this flag is **not** set, then the program will look at the remote available files and skip any files that are present and have the same file size as the remote. In some cases, this could lead to duplicities are re-processing takes place. If the ``--quick`` flag is set, then when the remote list of available dates is created, any present files that match the requested product and year will be ignored, irrespective of file size. This can mean that files that failed to download half way through will not the downloaded, but it's an overall faster process if a download failed halfway through a year.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgomezdans%2Fget_modis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgomezdans%2Fget_modis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgomezdans%2Fget_modis/lists"}