.. pygmt:

sphdistance
===========

Ici vous aurez des explications sur la commande et ses différents paramètres.

.. code-block:: python 
					
	pygmt.sphdistance(data=None, x=None, y=None, \*, single_form=None,
	duplicate=None, quantity=None, outgrid=None, spacing=None,
	unit=None, node_table=None, voronoi=None, region=None, verbose=None,
	\**kwargs)
	
Utilité :
---------

Crée une grille de Voronoi de distance, de nœuds ou de voisins les plus proches sur une sphère.

Lit une table contenant des colonnes lon et lat et effectue la construction des polygones de Voronoi. Ces polygones sont ensuite traités pour calculer la distance la plus proche de chaque nœud de la grille, qui est ensuite écrite dans la grille spécifiée.

Paramètres :
------------

**data** (str or numpy.ndarray or pandas.DataFrame or xarray.Dataset or geopandas.GeoDataFrame) - Fournit des valeurs (x, y) ou (longitude, latitude) en fournissant un nom de fichier pour une table de données ASCII, un tableau numpy.ndarray 2D, un pandas.DataFrame, un xarray.Dataset composé de variables de données xarray.DataArray 1D, ou un geopandas.GeoDataFrame contenant les données tabulaires.

**x/y** (tableaux 1D) - Tableaux de coordonnées x et y.

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

**spacing** (str) -

x_inc[+e|n][/y_inc[+e|n]]. x_inc [et éventuellement y_inc] est l'espacement de la grille.

	**Coordonnées géographiques** (degrés) : Optionnellement, ajoutez une unité d'incrémentation. Choisissez parmi m pour indiquer les minutes d'arc ou s pour indiquer les secondes d'arc. Si l'une des unités e, f, k, M, n ou u est ajoutée, l'incrémentation est supposée être donnée en mètre, pied, kilomètre, mile, mille marin ou pied de l'enquête américaine, respectivement, et sera convertie en degrés de longitude équivalents à la latitude moyenne de la région (la conversion dépend de PROJ_ELLIPSOID). Si y_inc est donné mais défini sur 0, il sera réinitialisé égal à x_inc ; sinon, il sera converti en degrés de latitude.

	**Toutes les coordonnées** : Si +e est ajouté, alors x_max (est) ou y_max (nord) correspondant peut être légèrement ajusté pour correspondre exactement à l'incrément donné [par défaut, l'incrément peut être ajusté légèrement pour s'adapter au domaine donné]. Enfin, au lieu de donner un incrément, vous pouvez spécifier le nombre de nœuds souhaité en ajoutant +n à l'argument entier fourni ; l'incrément est alors recalculé à partir du nombre de nœuds, de l'enregistrement et du domaine. La valeur d'incrément résultante dépend de la grille enregistrée sur les lignes de grille ou enregistrée sur les pixels que vous avez sélectionnée ; voir les formats de fichier GMT pour plus de détails.

Note : Si la région=grdfile est utilisée, l'espacement de la grille et l'enregistrement ont déjà été initialisés ; utilisez spacing et registration pour remplacer ces valeurs.

**region** (str ou liste) - xmin/xmax/ymin/ymax[+r][+uunit]. Spécifie la région d'intérêt.

**verbose** (bool ou str) -

Sélectionne le niveau de verbosité [par défaut w], qui module les messages écrits dans stderr. Choisissez parmi 7 niveaux de verbosité :

q - Silencieux, aucun message d'erreur fatal n'est produit.

e - Messages d'erreur seulement.

w - Avertissements [par défaut].

t - Timing (rapporte les temps d'exécution pour les algorithmes gourmands en temps).

i - Messages informatifs (identique à verbose=True).

c - Avertissements de compatibilité.

d - Messages de débogage.

**single_form** (bool) - Pour les grands ensembles de données, vous pouvez économiser de la mémoire (au détriment d'un traitement supplémentaire) en ne stockant qu'une seule forme de coordonnées de localisation (vecteurs géographiques ou cartésiens 3D) à un moment donné, en traduisant d'une forme à l'autre lorsque nécessaire [par défaut, les deux tableaux sont conservés en mémoire]. Non applicable avec Voronoi.

**duplicate** (bool) - Utilisé pour ignorer les points en double car l'algorithme ne peut pas les traiter. [Par défaut, il suppose qu'il n'y a pas de doublons].

**quantity** (str) -

d|n|z[dist]. Spécifie la quantité qui doit être attribuée aux nœuds de la grille [par défaut, c'est d] :

d - calcul des distances jusqu'au point de données le plus proche

n - attribuer les numéros d'identification des polygones de Voronoi à chaque nœud de la grille

z - attribuer à tous les nœuds à l'intérieur du polygone la valeur z du nœud central pour une grille naturelle de voisinage le plus proche.

Optionnellement, ajoutez l'intervalle de rééchantillonnage le long des arcs de Voronoi en degrés sphériques.

**unit** (str) - Spécifie l'unité utilisée pour les calculs de distance. Choisissez parmi d (degrés sphériques), e (mètres), f (pieds), k (kilomètres), M (miles), n (milles nautiques) ou u (pieds d'enquête).

**node_table** (str) - Lit les informations relatives à chaque polygone de Voronoi (la longitude, la latitude des nœuds uniques et la superficie du polygone) à partir d'un fichier séparé [par défaut, il acquiert ces informations à partir des en-têtes de segment ASCII du fichier de sortie]. Requis si l'entrée binaire via voronoi est utilisée.

**voronoi** (str) - Ajoutez le nom d'un fichier avec les polygones de Voronoi précalculés [par défaut, effectue la construction de Voronoi sur les données d'entrée].