pygmt.datasets.load_earth_magnetic_anomaly

pygmt.datasets.load_earth_magnetic_anomaly(resolution='01d',
region=None, registration=None, data_source='emag2')

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_mag/, ~/.gmt/server/earth/earth_mag4km/ ou ~/.gmt/server/earth/earth_wdmam/) 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 passant le nom de fichier @ earth_mag_type _ res [_ reg ] à n’importe quelle fonction de traçage/traitement de grille. earth_mag_type est le nom GMT du jeu de données. Les options disponibles sont earth_mag , earth_mag4km et earth_wdmam . 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 », ou « 01m ». La « 02m »résolution n’est pas disponible pour data_source= »wdmam ».

• 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 « 02m » pour data_source= »emag2 » ou data_source= »emag2_4km », qui sont « pixel » uniquement.

• data_source ( str ) – Sélectionnez la source des données d’anomalie magnétique. Les options disponibles sont :

  • « emag2 »: EMAG2 Global Earth Magnetic Anomaly Model [Option par défaut]. Il ne comprend que les données observées au niveau de la mer sur les régions océaniques.

  • « emag2_4km »: Utilisez une version d’EMAG2 où toutes les observations sont relatives à une altitude de 4 km au-dessus du géoïde et incluent des données terrestres.

  • « wdmam »: Carte mondiale des anomalies magnétiques numériques (WDMAM).

Retour

grid ( xarray.DataArray) – Grille des anomalies magnétiques terrestres. Les coordonnées sont la latitude et la longitude en degrés. Les unités sont en nano Tesla (nT).

Exemples

from pygmt.datasets import load_earth_magnetic_anomaly
# load the default grid (gridline-registered 1 arc-degree grid)
grid = load_earth_magnetic_anomaly()
# load the 30 arc-minutes grid with "gridline" registration
grid = load_earth_magnetic_anomaly(
    resolution="30m", registration="gridline"
)
# load high-resolution (5 arc-minutes) grid for a specific region
grid = load_earth_magnetic_anomaly(
    resolution="05m",
    region=[120, 160, 30, 60],
    registration="gridline",
)
# load the 20 arc-minutes grid of the emag2_4km dataset
grid = load_earth_magnetic_anomaly(
    resolution="20m", registration="gridline", data_source="emag2_4km"
)
# load the 20 arc-minutes grid of the WDMAM dataset
grid = load_earth_magnetic_anomaly(
    resolution="20m", registration="gridline", data_source="wdmam"
)