GRASS logo

NAME

r.modis.download - Download single or multiple tiles of MODIS products using pyModis.

KEYWORDS

raster, import, MODIS

SYNOPSIS

r.modis.download
r.modis.download --help
r.modis.download [-dgcl] [settings=name] [product=string[,string,...]] [tiles=string] [startday=string] [endday=string] [folder=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

-d
For debug mode, it will write more info in the log file
-g
Return the name of file containing the list of HDF tiles downloaded in shell script style
-c
Does not perform GDAL check on downloaded images
-l
List more info about the supported MODIS products
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

settings=name
Full path to settings file or '-' for standard input, empty for .netrc file
Name of input file
product=string[,string,...]
Name of MODIS product(s)
Options: lst_terra_daily_1000, lst_aqua_daily_1000, lst_terra_eight_1000, lst_aqua_eight_1000, lst_terra_daily_5600, lst_aqua_daily_5600, lst_terra_monthly_5600, lst_aqua_monthly_5600, ndvi_terra_sixteen_250, ndvi_aqua_sixteen_250, ndvi_terra_sixteen_500, ndvi_aqua_sixteen_500, ndvi_terra_sixteen_1000, ndvi_aqua_sixteen_1000, ndvi_terra_sixteen_5600, ndvi_aqua_sixteen_5600, snow_terra_daily_500, snow_aqua_daily_500, snow_terra_eight_500, snow_aqua_eight_500, surfreflec_terra_daily_500, surfreflec_aqua_daily_500, surfreflec_terra_eight_500, surfreflec_aqua_eight_500, water_terra_250
Default: lst_terra_daily_1000
tiles=string
The name(s) of tile(s) to download (comma separated). If not set, all available tiles are downloaded.
e.g.: h18v04
startday=string
First date to download
Format: YYYY-MM-DD. If not set the download starts from current date and goes back 10 days. If not endday is set, the download stops 10 days after the startday
endday=string
Last date to download
Format: YYYY-MM-DD. To use only with startday
folder=string
Folder to store the downloaded data
If not set, path to settings file is used

Table of contents

DESCRIPTION

r.modis.download downloads selected MODIS products (Moderate Resolution Imaging Spectroradiometer, flown on the two NASA spacecrafts Terra and Aqua). The module can download several tiles at once and also multiple observation dates for each MODIS product.

NOTES

The r.modis modules need the pyModis library. Please install it beforehand.

To be able to download data the user needs to obtain user and password for the NASA Earthdata Login:

In order to download the desired MODIS product(s), the username and password must be provided through the settings option. There are three ways:

Warning: As per NASA policy no more than ten simultaneous connections are permitted in parallel with their server. Hence, no more than ten processes of r.modis.download should run at the same time to avoid that user's actual IP address gets blacklisted.

By default, the downloaded files are stored in the path in which the settings file was saved. The user can change this directory with the folder option. The folder option is required when user and password are passed through the standard input.

The needed time for the download depends on the number of requested tiles, days and the type of MODIS product. For example, the NDVI product ranges from 5 MB to 270 MB and the LST product ranges from 2 MB to 21 MB.

EXAMPLES

Download of the daily MODIS LST product "lst_terra_daily_1000" from the Terra satellite using the default options (all available tiles from newest available date) and passing the user and password through standard input. Note that when settings is read from standard input, the option folder must be specified:
r.modis.download settings=- folder=/tmp

Reading the user and password options from a file (this will download by default the "lst_terra_daily_1000" product). MODIS data will be downloaded to the folder where the SETTING file is:

r.modis.download settings=$HOME/.grass7/r.modis/SETTING

Download of the LST Terra product using the default options and change of the starting and ending dates to custom values:

r.modis.download settings=$HOME/.grass7/r.modis/SETTING startday=2011-05-01 endday=2011-05-31

Download of a different product (here: Snow eight days 500 m), default options:

r.modis.download settings=$HOME/.grass7/r.modis/SETTING product=snow_terra_eight_500

Download of a global MODIS product (here: MOD13C1 - MODIS/Terra Vegetation Indices 16-Day L3 Global 0.05Deg CMG V006), of a specific month:

# note: provided in Geographic Lat/Long Grid
r.modis.download settings=$HOME/.grass7/r.modis/SETTING product=ndvi_terra_sixteen_5600 startday=2011-05-01 endday=2011-05-31

To use r.modis.download in a script and to concatenate it with another module, the user needs to set the -g flag to return the name of the file that contains the list of downloaded HDF files:

r.modis.download -g settings=$HOME/.grass7/r.modis/SETTING startday=2011-05-01 endday=2011-05-31

SEE ALSO

r.modis, r.modis.import

GRASS GIS Wiki: temporal data processing

Map of MODIS Land products' Sinusoidal grid tiling system

AUTHOR

Luca Delucchi, Google Summer of Code 2011; subsequently updated.

Last changed: $Date: 2017-07-14 11:09:00 +0200 (Fri, 14 Jul 2017) $

SOURCE CODE

Available at: r.modis.download source code (history)


Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2017 GRASS Development Team, GRASS GIS 7.2.3svn Reference Manual