.. datasets.load_earth_relief:


pygmt.datasets.load_earth_relief
================================


.. code::

	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
--------

.. code::

	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,
	)