earthexplorer_download: earthexplorer_download

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

Downloads from Earth Explorer.

Usage

1
2
3
earthexplorer_download(usgs_eros_username, usgs_eros_password,
  output_folder = getwd(), earthexplorer_search_results = NULL,
  quicklooks_only = F, ordernum = NULL, overwrite = F, verbose = F)

Arguments

usgs_eros_username

Character. Your USGS registration username. You can register for an account at https://espa.cr.usgs.gov

usgs_eros_password

Character. Your USGS registration password. WARNING: USING THIS WITH R IS NOT PARTICULARLY SECURE.

output_folder

Character. Folder to save results to.

earthexplorer_search_results

List. Output from earthexplorer_search or espa_inventory_search. Only used to download quicklooks.

quicklooks_only

Logical. If earthexplorer_search_results isn't NULL, will download the quicklooks of the search results.

ordernum

Character. An order number. See https://espa.cr.usgs.gov/ordering/order-status/ for the IDs.

overwrite

Logical. Overwrite existing results? Default is FALSE

verbose

Logical. Verbose execution? Default=F.

Details

This is esssentially the command line version of the bulk download application. Typically you submit a search using earthexplorer_search or just the Earth Explorer GUI, wait a bit for it to process, and when you get your notificaiton the order is complete, you submit the ordernum to this function for batch downloading.

Value

NULL and the files downloaded into the output_folder.

Author(s)

Jonathan A. Greenberg (espa-tools@estarcion.net)

References

https://earthexplorer.usgs.gov

See Also

espa_inventory_search,espa_ordering_order

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
## Not run:  
# Get a list of your orders, and choose the first order result:
my_orders <- espa_ordering_listorders(usgs_eros_username="myusername",
	usgs_eros_password="mypassword",ordernums_only=TRUE)
my_latest_order <- my_orders[1]
earthexplorer_download(usgs_eros_username="myusername",usgs_eros_password="mypassword",
	output_folder=getwd(),
	ordernum=my_latest_order)

## End(Not run)

espa.tools documentation built on May 2, 2019, 5:54 p.m.