pygmt.datasets.load_earth_relief

pygmt.datasets.load_earth_relief(resolution='01d',
region=None, registration=None, data_source='igpp', use_srtm=False)

Charger les grilles de relief terrestre (topographie et bathymétrie) dans différentes résolutions.

Les grilles sont téléchargées dans un répertoire de données utilisateur (généralement ~/.gmt/server/earth/earth_relief, ~/.gmt/server/earth/earth_gebco, ~/.gmt/server/earth/earth_gebcosi ou ~/.gmt/server/earth/earth_synbath) la première fois que vous appelez cette fonction. Ensuite, il chargera la grille à partir du répertoire de données. Vous aurez donc besoin d’une connexion Internet la première fois.

Ce module télécharge les grilles qui sont également accessibles en transmettant le nom de fichier @ earth_relief_type _ res [_ reg ] à n’importe quelle fonction de traçage/traitement de grille. earth_relief_type est le nom GMT du jeu de données. Les options disponibles sont earth_relief , earth_gebco, earth_gebcosi et earth_synbath . res est la résolution de la grille (voir ci-dessous) et reg est le type d’enregistrement de la grille ( p pour l’enregistrement des pixels ou g pour l’enregistrement de la grille).

Paramètres

• resolution ( str ) – La résolution de la grille. Le suffixe d et m représentent les degrés d’arc et les minutes d’arc. Il peut s’agir de « 01d », « 30m », « 20m », « 15m », « 10m », « 06m », « 05m », « 04m », « 03m », « 02m », ou « 01m », « 30s », « 15s », « 03s », ou « 01s ».

• region ( str or list ) – La sous-région de la grille à charger, sous la forme d’une liste [ xmin , xmax , ymin , ymax ] ou d’une chaîne xmin/xmax/ymin/ymax . Requis pour les grilles avec des résolutions supérieures à 5 minutes d’arc (c’est-à-dire « 05m »).

• registration ( str ) – Type d’enregistrement de grille. Soit « pixel » pour l’enregistrement des pixels, soit « gridline » pour l’enregistrement du quadrillage. La valeur par défaut est « gridline » pour toutes les résolutions sauf « 15s » la « pixel » seule..

• data_source ( str ) – Sélectionnez la source des données de relief de la Terre. Les options disponibles sont :

  • « igpp » : IGPP Global Earth Relief [Option par défaut].

  • « synbath » : Ensemble de données IGPP Global Earth Relief qui utilise les propriétés statistiques du jeune fond marin pour fournir un relief plus réaliste des jeunes zones avec de petits monts sous-marins.

  • « gebco » : GEBCO Global Earth Relief avec uniquement le relief observé et le relief déduit via la gravité altimétrique.

  • « gebcosi » : GEBCO Global Earth Relief qui donne les altitudes sous-glaciaires (si).

• use_srtm ( bool ) - Par défaut, les tuiles SRTM terrestres uniquement de la NASA sont utilisées pour générer les grilles « 03s » et « 01s », et les valeurs océaniques manquantes sont remplies en sur-échantillonnant les tuiles SRTM15 qui ont une résolution de 15 secondes d’arc (c’est-à-dire, « 15s »). Si True, ne chargera que les tuiles SRTM terrestres d’origine. Ne fonctionne que lorsque data_source= »igpp ».

Retour

grid (xarray.DataArray) – La grille de relief de la Terre. Les coordonnées sont la latitude et la longitude en degrés. Le relief est en mètres.

Exemples

from pygmt.datasets import load_earth_relief
# load the default grid (gridline-registered 1 arc-degree grid)
grid = load_earth_relief()
# load the 30 arc-minutes grid with "gridline" registration
grid = load_earth_relief(resolution="30m", registration="gridline")
# load high-resolution (5 arc-minutes) grid for a specific region
grid = load_earth_relief(
    resolution="05m",
    region=[120, 160, 30, 60],
    registration="gridline",
)
# load the original 3 arc-seconds land-only SRTM tiles from NASA
grid = load_earth_relief(
    resolution="03s",
    region=[135, 136, 35, 36],
    registration="gridline",
    use_srtm=True,
)