pygmt.x2sys_init

pygmt.x2sys_init(tag, *, fmtfile=None, suffix=None, force=None,
discontinuity=None, spacing=None, units=None, region=None,
verbose=None, gap=None, distcalc=None, **kwargs)

Initialisez une nouvelle base de données de pistes x2sys.

Sert de point de départ pour x2sys et initialise un ensemble de bases de données spécifiques à un type de données de piste. Ces données, leurs bases de données associées et les paramètres clés reçoivent une notation abrégée appelée x2sys TAG. Le TAG conserve une trace des paramètres tels que le format de fichier, si les données sont géographiques ou non, et la résolution de regroupement pour les indices de piste.

Avant de pouvoir exécuter, pygmt.x2sys_initvous devez définir le paramètre environnemental X2SYS_HOME sur un répertoire dans lequel vous disposez d’une autorisation d’écriture, c’est là que x2sys peut suivre vos paramètres.

Paramètre

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

  • fmtfile ( str ) – Préfixe du fichier de définition de format pour cet ensemble de données. Spécifiez le chemin complet si le fichier n’est pas dans le répertoire courant.

    Certains formats de fichiers ont déjà des fichiers de définition prédéfinis. Ceux-ci inclus: - mgd77 (pour les fichiers de données ASCII MGD77 simples) - mgd77+ (pour les fichiers netCDF MGD77+ améliorés) - gmt (pour les anciens fichiers binaires du supplément mgg) - xy (pour les tables ASCII simples x, y) - xyz (identique, avec une colonne z) - geo (pour les fichiers de longitude ASCII simple, latitude) - geoz (identique, avec une colonne z).

  • suffix ( str ) – Spécifiez l’extension de fichier (suffixe) pour ces fichiers de données. S’il n’est pas indiqué, nous utilisons le préfixe du fichier de définition de format comme suffixe (voir fmtfile).

  • discontinuity ( str ) – d | g . Sélectionnez les coordonnées géographiques. Ajoutez d pour la discontinuité à la ligne de date (fait passer la longitude de -180° à +180°) ou g pour la discontinuité à Greenwich (fait passer la longitude de 0° à 360° [par défaut]). Si elles ne sont pas fournies, nous supposons que les données sont cartésiennes.

  • 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) : ajoutez éventuellement une unité d’incrémentation. Choisissez parmi m pour indiquer les arc-minutes ou s pour indiquer les arc-secondes. Si l’une des unités e , f , k , M , n ou u est ajoutée à la place, l’incrément est supposé être donné en mètre, pied, km, mile, mile nautique ou US survey foot, respectivement, et sera converti en les 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é, le max correspondant x ( est ) ou y ( nord ) peut être légèrement ajusté pour s’adapter exactement à l’incrément donné [par défaut, l’incrément peut être légèrement ajusté pour s’adapter au domaine donné]. Enfin, au lieu de donner un incrément, vous pouvez spécifier le nombre de nœuds souhaités en ajoutant +n à l’argument entier fourni ; l’incrément est alors recalculé à partir du nombre de nœuds, du registration et du domaine. La valeur d’incrément résultante varie selon que vous avez sélectionné une grille enregistrée sur la grille ou enregistrée sur les pixels ; voir Formats de fichier GMT pour plus de détails.

    Remarque : Si region=grdfile est utilisé alors l’espacement de la grille et l’enregistrement ont déjà été initialisés ; utilisez spacing et registration pour remplacer ces valeurs.

  • units (str or list) – d|s unit. Set the units used for distance and speed when requested by other programs. Append d for distance or s for speed, then give the desired unit as:

    • c - Cartesian userdist or userdist/usertime

    • e - meters or m/s

    • f - feet or ft/s

    • k - kilometers or km/hr

    • m - miles or mi/hr

    • n - nautical miles or knots

    • u - survey feet or sft/s

    [Default is units=[« dk », « se »] (km and m/s) if discontinuity is set, and units=[« dc », « sc »] otherwise (e.g., for Cartesian units)].

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

  • 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

  • gap ( chaîne ou liste ) – t | d écart . Donnez t ou d et ajoutez l’écart de temps maximum correspondant (en unités utilisateur ; il s’agit généralement de secondes [la valeur par défaut est l’infini]) ou la distance (pour les unités, voir units ) l’écart [la valeur par défaut est l’infini]) autorisé entre les deux points de données immédiatement sur de part et d’autre d’un croisement. Si ces limites sont dépassées, une lacune dans les données est supposée et aucun COE ne sera déterminé.

  • distcalc ( str ) – e | f | g . Déterminez comment les distances sphériques sont calculées.

    • e - Mode ellipsoïdal (ou géodésique)

    • f - Mode Terre plate

    • g - Distance orthodromique [Défaut]

    Tous les calculs de distance sphérique dépendent de l’ellipsoïde courant ( PROJ_ELLIPSOID ), de la définition du rayon moyen ( PROJ_MEAN_RADIUS ) et de la spécification du type de latitude ( PROJ_AUX_LATITUDE ). Les calculs de distance géodésique sont également pilotés par la méthode ( PROJ_GEODESIC ).

Exemple

?