sph2grd¶

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

pygmt.sph2grd(data, \*, outgrid=None, spacing=None, region=None,
verbose=None, binary=None, header=None, incols=None,
registration=None, cores=None, \**kwargs)

Utilité :¶

Crée des fichiers de grille sphérique tendue à partir de données.

Lit une table de coefficients de harmoniques sphériques avec des enregistrements de L, M, C[L,M], S[L,M] et évalue le modèle d’harmoniques sphériques sur la grille spécifiée.

Paramètres :¶

data (str ou numpy.ndarray ou pandas.DataFrame ou xarray.Dataset ou geopandas.GeoDataFrame) : Fournissez les données avec les valeurs L, M, C[L,M], S[L,M] en spécifiant le nom d’un fichier contenant 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.

outgrid (str ou None) : Nom du fichier de sortie netCDF avec l’extension .nc pour enregistrer la grille.

spacing (str) : Espacement de la grille. 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) : En option, 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 d’étalon américain, 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 à 0, il sera réinitialisé à la même valeur que x_inc ; sinon, il sera converti en degrés de latitude.

Toutes les coordonnées : Si +e est ajouté, alors la valeur maximale correspondante x (est) ou y (nord) peut être légèrement ajustée pour correspondre exactement à l’incrémentation donnée [par défaut, l’incrémentation peut être ajustée légèrement pour s’adapter au domaine donné]. Enfin, au lieu de donner une incrémentation, vous pouvez spécifier le nombre de nœuds souhaité en ajoutant +n à l’argument entier fourni ; l’incrémentation est alors recalculée à partir du nombre de nœuds, de l’enregistrement et du domaine. La valeur d’incrémentation résultante dépend de la sélection d’une grille enregistrée en ligne de grille ou enregistrée en pixel ; consultez la documentation GMT File Formats 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.

region (str ou liste) : xmin/xmax/ymin/ymax[+r][+uunit]. Spécifiez la région d’intérêt.

verbose (bool ou str) : Niveau de verbosité [Par défaut, w], qui module les messages écrits dans stderr. Choisissez parmi 7 niveaux de verbosité :

q - Silencieux,- e - Seulement les messages d’erreur

w - Avertissements [Par défaut]
t - Durées (rapporte les temps d’exécution pour les algorithmes longs)
i - Messages informatifs (identique à verbose=True)
c - Avertissements de compatibilité
d - Messages de débogage

binary (bool ou str) : i|o[ncols][type][w][+l|b]. Sélectionne l’entrée binaire native (en utilisant binary= »i ») ou la sortie binaire (en utilisant binary= »o »), où ncols est le nombre de colonnes de données de type, qui doit être l’un des suivants :

c - int8_t (1 octet char signé) u - uint8_t (1 octet char non signé) h - int16_t (entier signé sur 2 octets) H - uint16_t (entier non signé sur 2 octets) i - int32_t (entier signé sur 4 octets) I - uint32_t (entier non signé sur 4 octets) l - int64_t (entier signé sur 8 octets) L - uint64_t (entier non signé sur 8 octets) f - Flottant sur 4 octets d - Flottant sur 8 octets x - Utilisé pour sauter ncols n’importe où dans l’enregistrement

Pour des enregistrements avec des types mixtes, ajoutez des combinaisons supplémentaires de ncols type séparées par des virgules. Les modificateurs suivants sont pris en charge :

w après n’importe quel élément pour effectuer un échange d’octets. +l|b pour indiquer que l’ensemble du fichier de données doit être lu en tant que petit ou gros boutisme. Par défaut, les données sont lues avec le même boutisme que le système. La documentation complète se trouve à l’adresse https://docs.generic-mapping-tools.org/latest/gmt.html#bi-full.

header (str) : [i|o][n][+c][+d][+msegheader][+rremark][+ttitle]. Spécifie le nombre de records d’en-tête dans le fichier d’entrée et/ou de sortie [Par défaut, 0]. Préfixez i si seules les données d’entrée principales doivent avoir des enregistrements d’en-tête. Préfixez o pour contrôler l’écriture des enregistrements d’en-tête, avec les modificateurs suivants pris en charge :

+d pour supprimer les enregistrements d’en-tête existants. +c pour ajouter un commentaire d’en-tête avec les noms des colonnes à la sortie [Par défaut, pas de noms de colonnes]. +m pour ajouter un en-tête de segment segheader à la sortie après le bloc d’en-tête [Par défaut, pas d’en-tête de segment]. +r pour ajouter un commentaire remarque à la sortie [Par défaut, pas de commentaire]. La chaîne de remarque peut contenir n pour indiquer des sauts de ligne. +t pour ajouter un commentaire de titre à la sortie [Par défaut, pas de titre]. La chaîne de titre peut contenir n pour indiquer des sauts de ligne.

incols (str ou tableau 1D) : Spécifie les colonnes de données pour l’entrée principale dans un ordre arbitraire. Les colonnes peuvent être répétées et les colonnes non répertoriées seront ignorées [Par défaut, lit toutes les colonnes dans l’ordre, en commençant par la première (c’est-à-dire la colonne 0)].

Pour un tableau 1D : spécifiez les colonnes individuelles dans l’ordre d’entrée (par exemple, incols=[1,0] pour la 2e colonne suivie de la 1ère colonne).

Pour une chaîne de caractères : spécifiez les colonnes individuelles ou les plages de colonnes dans le format start[:inc]:stop, où inc est par défaut à 1 s’il n’est pas spécifié, avec les colonnes et/ou les plages de colonnes séparées par des virgules (par exemple, incols= »0:2,4+l » pour lire les trois premières colonnes suivies de la colonne 5e transformée en logarithme). Pour lire à partir d’une colonne donnée jusqu’à la fin de l’enregistrement, omettez stop lors de la spécification de la plage de colonnes. Pour lire le texte final, ajoutez la colonne t. Ajoutez le mot number à t pour lire seulement un mot du texte final. Au lieu de spécifier les colonnes, utilisez incols= »n » pour simplement lire l’entrée numérique et ignorer le texte final. En option, ajoutez l’un des modificateurs suivants à n’importe quelle colonne ou plage de colonnes pour transformer les colonnes d’entrée :

+l pour prendre le logarithme base 10 des valeurs d’entrée. +d pour diviser les valeurs d’entrée par le diviseur [Par défaut, 1]. +s pour multiplier les valeurs d’entrée par l’échelle [Par défaut, 1]. +o pour ajouter le décalage donné aux valeurs d’entrée [Par défaut, 0].

registration (str) : g|p. Force l’enregistrement des nœuds de la grille en grille (g) ou en pixel (p) [Par défaut, grille].

cores (bool ou int) : [[-]n]. Limite le nombre de cœurs à utiliser dans les algorithmes multi-threaded activés par OpenMP. Par défaut, nous essayons d’utiliser tous les cœurs disponibles. Définissez un nombre n pour n’utiliser que n cœurs (s’il est trop élevé, il sera tronqué au maximum de cœurs disponibles). Enfin, donnez un nombre négatif -n pour sélectionner (tout - n) cœurs (ou au moins 1 si n est supérieur ou égal à tous les cœurs disponibles).