.. datasets.load_earth_mask:


pygmt.datasets.load_earth_mask
==============================


.. code::

	pygmt.datasets.load_earth_mask(resolution='01d', 
	region=None, registration=None)
	

Chargez une grille Earth Free-Air Anomaly 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_mask/`) 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.

Ces grilles sont également accessibles en transmettant le nom de fichier **@earth_mask** _ res [_ reg ] à n'importe quelle fonction de traçage/traitement de grille. 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"`.

* **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"`.


Retour
------

**grid** ( xarray.DataArray) – La grille du masque de la Terre. Les coordonnées sont la latitude et la longitude en degrés. Les valeurs de nœud dans les grilles de masque sont toutes comprises entre 0 et 4 et reflètent différents types de surface :
	- 0 : Zones océaniques au-delà du littoral
	- 1 : Zones terrestres à l'intérieur du littoral
	- 2: Lacs à l'intérieur des terres
	- 3 : Îles dans les lacs des terres émergées
	- 4 : Petits lacs dans les îles qui se trouvent dans les lacs à l'intérieur de la zone terrestre

Exemples
--------

.. code::

	from pygmt.datasets import load_earth_mask
	# load the default grid (gridline-registered 1 arc-degree grid)
	grid = load_earth_mask()
	# location (120°E, 50°N) is in land area (1)
	grid.sel(lon=120, lat=50).values
	array(1, dtype=int8)
	# location (170°E, 50°N) is in oceanic area (0)
	grid.sel(lon=170, lat=50).values
	array(0, dtype=int8)