.. grdfill:


pygmt.grdfill
=============


.. code::

	pygmt.grdfill(grid, \*, mode=None, outgrid=None, region=None,
	verbose=None, \**kwargs)
	

Remplissez les zones vides à partir d'un fichier de grille.

Lire une grille qui a vraisemblablement des trous non remplis que l'utilisateur souhaite remplir d'une manière ou d'une autre. Les trous sont identifiés par des valeurs NaN mais ce critère peut être modifié. Plusieurs algorithmes différents peuvent être utilisés pour remplacer les valeurs de trou.

Paramètre
---------

* **grid** ( str ou xarray.DataArray ) – Le nom de fichier de la grille d'entrée ou de la grille chargée en tant que xarray.DataArray. C'est le seul paramètre obligatoire.

* **outgrid** ( str ou None ) – Le nom du fichier netCDF de sortie avec l'extension .nc dans lequel stocker la grille.

* **mode** ( str ) – Spécifiez l'algorithme de remplissage des trous à utiliser. Choisissez parmi c pour un remplissage constant et ajoutez la valeur constante, n pour le voisin le plus proche (et ajoutez éventuellement un rayon de recherche en pixels [le rayon par défaut est :math:`\sqrt{X² + Y²}`, où ( X,Y ) sont les dimensions du nœud de la grille]), ou s pour la spline bicubique (ajoutez éventuellement un paramètre de tension [par défaut, pas de tension]).

* **région** ( str ou liste ) – xmin/xmax/ymin/ymax [ **+r** ][ **+u** unité ]. Spécifiez la région d'intérêt. L'ajout `region` sélectionnera une sous-section de la grille. Si cette sous-section dépasse les limites de la grille, seule la région commune sera sortie.

* **verbose** ( bool ou str ) – Sélectionnez le niveau de verbosité [la valeur par défaut est w ], qui module les messages écrits sur stderr. Choisissez parmi 7 niveaux de verbosité :
	- **q** - Des messages d'erreur silencieux, même fatals, ne sont pas générés
	- **e** - Messages d'erreur uniquement
	- **w** - Avertissements [par défaut]
	- **t** - Timings (temps d'exécution des rapports pour les algorithmes chronophages)
	- **i** - Messages d'information (comme `verbose=True`)
	- **c** - Avertissements de compatibilité
	- **d** - Messages de débogage

Retour
------

* **ret** ( xarray.DataArray ou None ) – Le type de retour dépend si le `outgrid` paramètre est défini :
	- `xarray.DataArray` si `outgrid` n'est pas défini
	- Aucun si `outgrid` est défini (la sortie de la grille sera stockée dans le fichier défini par `outgrid`)


Exemple
-------

.. code ::

	import pygmt
	# Load a bathymetric grid with missing data
	earth_relief_holes = pygmt.datasets.load_sample_data(
	    name="earth_relief_holes"
	)
	# Perform grid filling operations on the sample grid
	# Set all empty values to "20"
	filled_grid = pygmt.grdfill(grid=earth_relief_holes, mode="c20")