grdhisteqgmt - En ligne dans le Cloud

PROGRAMME:

Nom

grdhisteq - Effectue une égalisation d'histogramme pour une grille

SYNOPSIS

grdhisteq in_grdfile [ fichier_out_grd ] [ n_cellules ] [ [filet] ] [ [norme] ] [ ] région [niveau]

Remarque: Aucun espace n'est autorisé entre l'indicateur d'option et les arguments associés.

DESCRIPTION

grdhisteq permet à l'utilisateur de trouver les valeurs de données qui divisent un fichier de grille donné en
plaques de surface égale. Une utilisation courante de grdhisteq est dans une sorte d'égalisation d'histogramme
d'une image. Dans cette application, l'utilisateur peut avoir une grille de topographie plate avec un
montagne au milieu. Ombrage gris ordinaire de ce fichier (en utilisant grdimage/grdview) avec un
le mappage linéaire de la topographie aux tons de gris aura pour résultat que la majeure partie de l'image sera très
gris foncé, la montagne étant presque blanche. On pourrait utiliser grdhisteq écrire à
stdout ou déposer une liste ASCII de ces valeurs de données qui divisent la plage de données en
n_cellules segments, dont chacun a une surface égale dans l'image. À l'aide de awk or makecpt UN
peut prendre cette sortie et créer un fichier CPT ; l'utilisation du fichier CPT avec grdimage entraînera
une image avec tous les niveaux de gris se produisant de manière égale. Sinon, voir grd2cpt.

La deuxième utilisation courante de grdhisteq est en train d'écrire une grille avec des statistiques basées sur une sorte
de la fonction de distribution cumulative. Dans cette application, la sortie a des hauts relatifs
et bas dans les mêmes emplacements (x,y) que le fichier d'entrée, mais les valeurs sont modifiées en
reflètent leur place dans une distribution cumulative. Un exemple serait de trouver le
les 10 % les plus bas des données : prenez une grille, exécutez grdhisteq et faire une grille en utilisant n_cellules = 10, et
puis contournez le résultat pour tracer le 1 contour. Cela englobera les 10 % les plus bas de la
données, quelles que soient leurs valeurs d'origine. Un autre exemple est l'égalisation de la sortie de
dégradé. À des fins d'ombrage, il est souhaitable que les données aient une distribution régulière,
comme un gaussien. Si tu cours grdhisteq en sortie de dégradé et faire un fichier de grille
sortie avec l'option Gaussienne, vous aurez une grille dont les valeurs sont distribuées
selon une distribution gaussienne à moyenne nulle et à variance unitaire. Les emplacements de
ces valeurs correspondront aux emplacements de l'entrée ; c'est-à-dire le plus négatif
la valeur de sortie sera à l'emplacement (x,y) de la valeur d'entrée la plus négative, et ainsi de suite.

REQUIS ARGUMENTS

in_grdfile
Fichier de grille 2D à égaliser. (Voir FORMATS DE FICHIERS GRILLE ci-dessous).

EN OPTION ARGUMENTS

-Cn_cellules
Définit le nombre de cellules (ou divisions) de la plage de données à créer [16].

-D Transférer les informations de niveau vers filet, ou sortie standard si aucun fichier n'est fourni.

-Gfichier_out_grd
Nom du fichier de grille 2D de sortie. Utilisé avec -N seul. (Voir FORMATS DE FICHIERS GRILLE ci-dessous).

-N[norme]
sortie gaussienne. Utiliser avec -G pour créer une grille de sortie avec des scores normaux standard.
Ajouter norme pour forcer les scores à tomber dans la plage <-1,+1> [La valeur par défaut est standard
notes normales].

-Q Utilisez une échelle d'intensité quadratique. [La valeur par défaut est linéaire].

-R[unité]x min/xmax/ymin/ymax[r] (plus ...)
Spécifiez la région d'intérêt. En utilisant le -R L'option sélectionnera une sous-section de
in_grdfile la grille. Si cette sous-section dépasse les limites de la grille, seule la
région commune sera extraite.

-V[niveau] (plus ...)
Sélectionnez le niveau de verbosité [c].

-^ or juste -
Imprime un court message sur la syntaxe de la commande, puis quitte (REMARQUE : sous Windows
utiliser juste -).

-+ or juste +
Imprimez un message d'utilisation détaillé (aide), y compris l'explication de tout
option spécifique au module (mais pas les options communes GMT), puis se ferme.

-? or aucune arguments
Imprimez un message d'utilisation (aide) complet, y compris l'explication des options, puis
sorties.

--version
Imprimer la version GMT et quitter.

--show-datadir
Affichez le chemin complet vers le répertoire de partage GMT et quittez.

GRID DOSSIER FORMATS

Par défaut, GMT écrit la grille sous forme de flottants en simple précision dans un netCDF de plainte COARDS
format de fichier. Cependant, GMT est capable de produire des fichiers de grille dans de nombreux autres grilles couramment utilisées
formats de fichiers et facilite également ce que l'on appelle "l'emballage" des grilles, l'écriture en virgule flottante
les données sous forme d'entiers de 1 ou 2 octets. Pour spécifier la précision, l'échelle et le décalage, l'utilisateur doit
ajouter le suffixe =id[/en échelon/compenser[/nan]], où id est un identifiant à deux lettres de la grille
type et précision, et en échelon et compenser sont un facteur d'échelle et un décalage facultatifs à
appliqué à toutes les valeurs de la grille, et nan est la valeur utilisée pour indiquer les données manquantes. Au cas où
les deux personnages id n'est pas fourni, comme dans =/en échelon qu'un id=nf est assumé. Lorsque
grilles de lecture, le format est généralement reconnu automatiquement. Sinon, le même suffixe
peuvent être ajoutés aux noms de fichiers de grille d'entrée. Voir grdconvertir et Section grid-file-format du
Référence technique GMT et livre de recettes pour plus d'informations.

Lors de la lecture d'un fichier netCDF contenant plusieurs grilles, GMT lira, par défaut, le
première grille bidimensionnelle que l'on peut trouver dans ce fichier. Amener GMT à lire un autre
variable multidimensionnelle dans le fichier de grille, ajoutez ?varname au nom du fichier, où
varname est le nom de la variable. Notez que vous devrez peut-être échapper au sens spécial
of ? dans votre programme shell en plaçant une barre oblique inverse devant celui-ci, ou en plaçant le
nom de fichier et suffixe entre guillemets ou guillemets doubles. Les ?varname le suffixe peut également être utilisé
pour les grilles de sortie, spécifiez un nom de variable différent de la valeur par défaut : "z". Voir
grdconvertir et Sections modifiers-for-CF et grid-file-format du GMT Technical
Référence et livre de recettes pour plus d'informations, en particulier sur la façon de lire les épissures de 3-,
Grilles à 4 ou 5 dimensions.

EXEMPLES

Pour trouver les intervalles de hauteur qui divisent le fichier heights.nc en 16 divisions égales
région:

gmt grdhisteq hauteurs.nc -C16 -D > niveaux.d

Pour rendre les intensités mal réparties dans le fichier raw_intens.nc utilisables avec
grdimage or vue grd, courir

gmt grdhisteq raw_intens.nc -Gsmooth_intens.nc -N -V

RESTRICTIONS

Si vous utilisez grdhisteq pour créer une sortie gaussienne pour l'ombrage dégradé dans grdimage or
vue grd, vous devez être conscient de ce qui suit : la sortie sera dans la plage [-x, x],
où x est basé sur le nombre de données dans la grille d'entrée (nx * ny) et le cumulatif
Fonction de distribution gaussienne F(x). C'est-à-dire, soit N = nx * ny. Ensuite, x sera ajusté de sorte
que F(x) = (N - 1 + 0.5)/N. Étant donné qu'environ 68 % des valeurs d'une norme normale
distribution tombent dans +/- 1, ce sera vrai de la grille de sortie. Mais si N est très
grand, il est possible que x soit supérieur à 4. Par conséquent, avec le vue grd programme
en coupant les dégradés à la plage [-1, 1], vous obtiendrez un ombrage correct de 68% de vos données,
tandis que 16% d'entre eux seront écrêtés à -1 et 16% d'entre eux écrêtés à +1. Si cela fait aussi
une grande partie de l'image trop claire ou trop sombre, vous devriez prendre la sortie de grdhisteq et
redimensionner en utilisant mathmath et en multipliant par quelque chose de moins de 1.0, pour réduire la plage
des valeurs, ramenant ainsi plus de 68 % de l'image dans la plage [-1, 1].
Vous pouvez également fournir un facteur de normalisation avec -N.

Utilisez grdhisteqgmt en ligne à l'aide des services onworks.net