GRASS logo

NAME

r.in.etopo - Downloads NOAA ETOPO 2022 global topography and bathymetry (15, 30 or 60 arc-second) for an area and imports it.

KEYWORDS

raster, import, bathymetry, elevation, ETOPO

SYNOPSIS

r.in.etopo
r.in.etopo --help
r.in.etopo [-bnl] output=name [resolution=string] [layer=string] [area=north,west,south,east[,north,west,south,east,...]] [resample=string] [cache_dir=name] [max_cells=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-b
Bathymetry only: set cells above sea level (0 m) to null
-n
Import at the native ETOPO resolution and extent of the area instead of the current region
-l
List the files and window sizes for the area, then exit
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

output=name [required]
Name for output raster map
resolution=string
ETOPO 2022 grid
Options: auto, 15s, 30s, 60s
Default: auto
auto: Coarsest grid whose cells are not larger than the region's
15s: 15 arc-second (about 450 m), 15 degree tiles
30s: 30 arc-second (about 900 m), one global file
60s: 60 arc-second (about 1.8 km), one global file
layer=string
ETOPO 2022 layer
Options: surface, bed, geoid
Default: surface
surface: Elevation of the surface: ice top, land and sea floor (m, EGM2008)
bed: Elevation of the bedrock below the ice sheets (m, EGM2008), equal to surface elsewhere
geoid: EGM2008 geoid height above the WGS84 ellipsoid (m)
area=north,west,south,east[,north,west,south,east,...]
Bounding box in WGS84 degrees (default the current region, plus one grid cell)
resample=string
Resampling method of r.import
Options: nearest, bilinear, bicubic, lanczos
Default: bilinear
cache_dir=name
Directory to keep the downloaded windows in (GeoTIFF), reused by later runs
max_cells=integer
Largest window, in grid cells, that the module downloads
Default: 200000000

Table of contents

DESCRIPTION

r.in.etopo downloads the NOAA ETOPO 2022 global relief model (land topography and ocean bathymetry, NOAA NCEI) for an area and imports it as a raster map. ETOPO 2022 merges GEBCO, multibeam surveys, Copernicus and other land models into seamless grids at 15, 30 and 60 arc-seconds (about 450 m, 900 m and 1.8 km), with heights in metres above the EGM2008 geoid (negative below sea level).

Only the cells of the area are transferred: the module reads index windows of the NCEI THREDDS server through OPeNDAP (no account needed). At 15 arc-seconds the grid is split in 15 x 15 degree tiles, and an area across tile edges is read from each tile and mosaicked.

Resolution and layers

resolution=auto (default) picks the coarsest grid whose cells are not larger than those of the current region. layer chooses between:

Layer Content
surface Elevation of the surface: top of the ice sheets, land, sea floor
bed Elevation of the bedrock below the ice sheets (equal to surface outside them)
geoid EGM2008 geoid height above the WGS84 ellipsoid

At 15 arc-seconds the bed tiles exist only where ice makes the bed differ from the surface (62 of 288 tiles); elsewhere the module reads the surface tile, which is the bed there.

Import

By default the window is imported on the current region (extent and resolution) with r.import, as r.in.dem does. With -n, it is imported at the native ETOPO resolution over the area. -b keeps the bathymetry only (cells above 0 m set to null). The map gets the etopo2 colour table, its units and vertical datum.

NOTES

The area defaults to the current region plus one grid cell. Areas crossing the antimeridian are not supported; import the two sides separately. max_cells (200 million by default) stops a request that would be very large (the whole world at 15 arc-seconds is 3.7 billion cells): use a coarser resolution or a smaller area. Downloaded windows are kept in cache_dir as GeoTIFF and reused.

ETOPO 2022 is a relief model, not a navigation chart: in shallow coastal waters its 450 m cells smooth channels, reefs and dredged areas.

EXAMPLES

Bathymetry of the southern Arabian Gulf at native 15 arc-second resolution, land removed:

r.in.etopo -n -b output=bathy15 resolution=15s area=26.8,54.0,24.8,57.0
r.univar bathy15

Relief on the current region at the matching resolution:

g.region n=2965000 s=2745000 w=200000 e=500000 res=1000
r.in.etopo output=relief

SEE ALSO

r.import, r.in.dem, r.in.srtm.region, t.in.hycom

REFERENCES

AUTHORS

Yann Chemin

SOURCE CODE

Available at: r.in.etopo source code (history)

Accessed: Sunday Nov 15 11:07:38 2026


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

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual