esp_get_hypsobath: Hypsometry and bathymetry of Spain from SIANE

In mapSpain: Administrative Boundaries and Static Map Tiles for Spain

Hypsometry and bathymetry of Spain from SIANE

Description

This dataset represents the hypsometry and bathymetry of Spain.

• Hypsometry represents the elevation and depth of features of the Earth's surface relative to mean sea level.

• Bathymetry is the measurement of the depth of water in oceans, rivers or lakes.

Usage

esp_get_hypsobath(
  epsg = 4258,
  cache = TRUE,
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE,
  resolution = c(3, 6.5),
  spatialtype = c("area", "line")
)

Arguments

epsg	Character string or number. Projection of the map: 4-digit EPSG code. One of: "4258": ETRS89. "4326": WGS84. "3035": ETRS89 / ETRS-LAEA. "3857": Pseudo-Mercator.
cache	Logical. Whether to cache downloaded files. Defaults to TRUE. See Caching.
update_cache	Logical. If TRUE, refreshes the cached file and forces a new download. Defaults to FALSE.
cache_dir	Character string. A path to a cache directory. See Caching.
verbose	A logical value indicating whether to display informational messages.
resolution	Character string or number. Resolution of the geospatial data. One of: "6.5": 1:6.5 million. "3": 1:3 million.
spatialtype	Character string. Spatial type of the output. Use "area" for POLYGON or "line" for LINESTRING.

Details

Metadata available on https://github.com/rOpenSpain/mapSpain/tree/sianedata/.

Value

A sf object.

Caching

Functions that download data store files in cache_dir. When cache_dir is NULL, they use the active package cache, which defaults to a temporary directory. Set update_cache = TRUE to replace an existing cached file. See Caching strategies in esp_set_cache_dir() to configure a persistent cache.

Source

CartoBase ANE (Atlas Nacional de España) provided by Instituto Geográfico Nacional (IGN), https://www.ign.es/web/ign/portal. Data are available from 2005 to the present.

Copyright: https://centrodedescargas.cnig.es/CentroDescargas/cartobase-ane

Always acknowledge authorship using the following statements:

1. When the original digital product is not modified or altered, use one of the following statements:

   • CartoBase ANE 2006-2024 CC-BY 4.0 ign.es.

   • CartoBase ANE 2006-2024 CC-BY 4.0 Instituto Geográfico Nacional.

2. When a new product is generated:

   • Obra derivada de CartoBase ANE 2006-2024 CC-BY 4.0 ign.es.

Data distributed through the sianedata data branch, see https://github.com/rOpenSpain/mapSpain/tree/sianedata.

See Also

Natural feature datasets: esp_get_hydrobasin(), esp_get_landwater

Examples

# This code produces a plot and takes a few seconds to run.
library(ggplot2)

hypsobath <- esp_get_hypsobath()

# Tints from Wikipedia.
# https://en.wikipedia.org/wiki/Wikipedia:WikiProject_Maps/Conventions/
# Topographic_maps

levels <- sort(unique(hypsobath$val_inf))

# Create the manual palette.
br_bath <- length(levels[levels < 0])
br_terrain <- length(levels) - br_bath
pal <- c(
  tidyterra::hypso.colors(br_bath, "wiki-2.0_bathy"),
  tidyterra::hypso.colors(br_terrain, "wiki-2.0_hypso")
)

# Plot the Canary Islands.
ggplot(hypsobath) +
  geom_sf(aes(fill = as.factor(val_inf)),
    color = NA
  ) +
  coord_sf(
    xlim = c(-18.6, -13),
    ylim = c(27, 29.5)
  ) +
  scale_fill_manual(values = pal) +
  guides(fill = guide_legend(
    title = "Elevation",
    direction = "horizontal",
    label.position = "bottom",
    title.position = "top",
    nrow = 1
  )) +
  theme(legend.position = "bottom")

# Plot mainland Spain.
ggplot(hypsobath) +
  geom_sf(aes(fill = as.factor(val_inf)),
    color = NA
  ) +
  coord_sf(
    xlim = c(-9.5, 4.4),
    ylim = c(35.8, 44)
  ) +
  scale_fill_manual(values = pal) +
  guides(fill = guide_legend(
    title = "Elevation",
    reverse = TRUE,
    keyheight = 0.8
  ))

mapSpain documentation built on Aug. 31, 2026, 5:07 p.m.