pygmt.datasets.load_earth_mask

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

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)