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