.. datasets.load_earth_magnetic_anomaly:


pygmt.datasets.load_earth_magnetic_anomaly
==========================================


.. code::

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

.. code::

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