Usage Guide for download_topobathymap_geojson.py and download_topobathymap_geotiff.py

This script downloads topobathymetric data using the bathyreq package. Currently only digital elevation model (DEM) data from the NOAA National Centers for Environmental Information (NCEI) database is supported.

There are two scripts, one based on defining the spatial extent with a geoJSON file, and the other defines the spatial region using a geoTIFF, for example one downloaded by CoastSeg.

Need Help?

To view the help documentation for the script, use the following command:

python download_topobathymap_geojson.py --help

or

python download_topobathymap_geotiff.py --help

Common command line arguments

• -f: Sets the file that defines spatial extents

More details

The file should be geotiff when using `download_topobathymap_geotiff.py` and a geojson polygon when using `download_topobathymap_geojson.py`

• -s: Sets the file prefix to use for output data files

More details

A string that typically represents the name of the place where the data come from

• -p: If 1, make a plot

More details

A flag to make (or suppress) a plot

Examples

Example #1: Basic Usage with geojson

This example downloads topobathy data according to a geoJSON file

python download_topobathymap_geojson.py -s "LongIsland" -f "/path/to/SDStools/example_data/longisland_example.geojson" -p 1

Here's an example screenshot

The (optional) plot is created. This is not intended to be a publication ready figure. This merely shows the data, as a convenience:

Example #2: Basic Usage with geotiff

This example downloads topobathy data according to a geoTIFF file

python download_topobathymap_geotiff.py -s "Klamath" -f "/path/to/SDStools/example_data/2017-10-02-18-57-29_L8_GREATER_KLAMATH_ms.tif" -p 1 

The (optional) plot is created. This is not intended to be a publication ready figure. This merely shows the data, as a convenience: