.. x2sys_cross:


pygmt.x2sys_cross
=================


.. code::

	pygmt.x2sys_cross(tracks=None, outfile=None, *, combitable=None,
	runtimes=None, override=None, interpolation=None, region=None, 
	speed=None, tag=None, coe=None, verbose=None, numpoints=None,
	trackvalues=None, **kwargs)
	

Calculez les croisements entre les fichiers de données de piste.

Détermine toutes les intersections entre (« croisements externes ») ou à l'intérieur (« croisements internes ») des pistes (cartésiennes ou géographiques), et signale l'heure, la position, la distance le long de la piste, le cap et la vitesse le long de chaque segment de piste, et le erreur de croisement (COE) et valeurs moyennes pour tous les observables. Par défaut, pygmt.x2sys_crossrecherchera les COE externes et internes. En option, vous pouvez choisir de projeter toutes les données à l'aide de l'une des projections cartographiques avant de calculer le COE.

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

* **tracks** ( pandas.DataFrame ou str ou list ) – Un tableau ou une liste de tableaux avec des valeurs (x, y) ou (lon, lat) dans les deux premières colonnes. Les pistes peuvent être fournies sous forme de tables pandas DataFrame ou de noms de fichiers. Les formats de fichiers pris en charge sont ASCII, binaire natif ou données COARDS netCDF 1-D. Plus de colonnes peuvent également être présentes.

Si les noms de fichiers manquent leur extension de fichier, nous ajouterons le suffixe spécifié pour ce TAG. Les fichiers de suivi seront recherchés en premier dans le répertoire courant et ensuite dans tous les répertoires répertoriés dans $X2SYS_HOME/TAG/TAG_paths.txt (s'il existe). [Si $X2SYS_HOME n'est pas défini, il sera par défaut $GMT_SHAREDIR/x2sys]. ( **Remarque** : les fichiers MGD77 seront également recherchés via $MGD77_HOME/mgd77_paths.txt et les fichiers .gmt seront recherchés via $GMT_SHAREDIR/mgg/gmtfile_paths).

* **outfile** ( str ) – Le nom de fichier pour le fichier ASCII de sortie.

* **tag** ( str ) – Le nom unique de ce type de données x2sys TAG.

* **combitable** ( str ) – Ne traite que les combinaisons de paires trouvées dans le fichier combitable [traite par défaut toutes les combinaisons possibles parmi les fichiers spécifiés]. Le fichier combinable est créé par l'option -L de x2sys_get .

* **runtimes** ( bool ou str ) – Calcule et ajoute le temps d'exécution de traitement pour chaque paire au message de progression (utilisez `runtimes=True`). Passez un nom de fichier (par exemple `runtimes="file.txt"`) pour enregistrer ces temps d'exécution dans un fichier. L'idée ici est d'utiliser la connaissance des temps d'exécution pour diviser le processus principal en un certain nombre de sous-processus qui peuvent chacun être lancés dans un processeur différent de votre machine multicœur.

* **override** ( bool ou str ) – **S | N** . _ Contrôlez la manière dont les coordonnées géographiques sont gérées (les données cartésiennes ne sont pas affectées). Par défaut, nous déterminons si les données sont plus proches d'un pôle que de l'autre, puis nous utilisons une conversion polaire cylindrique pour éviter les problèmes de sauts de longitude. Vous pouvez le désactiver entièrement avec overrideet ensuite les calculs utilisent les données d'origine (nous avons des protections contre les sauts de longitude). Cependant, vous pouvez forcer la sélection du pôle pour la projection en ajoutant **S** ou **N** pour le pôle sud ou nord, respectivement. La conversion est utilisée parce que l'algorithme utilisé pour trouver les croisements est intrinsèquement un algorithme cartésien qui peut rencontrer des problèmes avec des données qui ont une grande plage longitudinale à des latitudes plus élevées.

* **interpolation** ( str ) – [**b|c|l|n**][**+a**][**+bBC**][**+c**][**+t** threshold]. Sélectionnez le mode d'interpolation pour les grilles. Vous pouvez sélectionner le type de spline utilisé :
	- b pour B-spline
	- c pour bicubique [Défaut]
	- l pour bilinéaire
	- n pour le plus proche voisin

* **coe** ( str ) – Utilisez **e** pour les COE externes uniquement et **i** pour les COE internes uniquement [la valeur par défaut est tous les COE].

* **région** ( str ou liste ) – xmin/xmax/ymin/ymax [ **+r** ][ **+u** unité ]. Spécifiez la région d'intérêt. 

* **speed** ( str ou liste ) – **l | tu | h** vitesse . Définit la fenêtre des vitesses de piste. Si les vitesses sont en dehors de cette fenêtre, nous ne calculons pas de COE. Spécifier:
	- **l** définit une vitesse inférieure [la valeur par défaut est 0].
	- **u** définit la vitesse supérieure [la valeur par défaut est l'infini].
	- **h** ne limite pas la vitesse mais définit une vitesse inférieure en dessous de laquelle les caps ne seront pas calculés (c'est-à-dire, réglé sur NaN) [Défaut calcule les caps quelle que soit la vitesse].

	Par exemple, vous pouvez utiliser pour définir une vitesse inférieure à 0, une vitesse supérieure à 10 et désactiver les calculs de cap pour les vitesses inférieures à 5.speed=["l0", "u10", "h5"]

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

* **nulpoints** ( int ) - Donne le nombre maximum de points de données de chaque côté du croisement à utiliser dans l'interpolation spline [la valeur par défaut est 3].

* **trackvalues** ​​( bool ) – Rapporte les valeurs de chaque piste au croisement [par défaut rapporte la valeur de croisement et la valeur moyenne].


Retour
-------

**crossover_errors** ( `pandas.DataFrame` ou None) – Table contenant des informations sur les erreurs de croisement. Le type de retour dépend si le `outfile` paramètre est défini :
	- `pandas.DataFrame` avec (x, y, …, etc) si `outfile` n'est pas défini

	- Aucun si `outfile` est défini (la sortie de la piste sera stockée dans l'ensemble dans `outfile`)

Exemple
-------

.. code ::

	?