Transformation Top-Hat (Outils Spatial Analyst)

Résumé

Détecte les structures spatiales sur une surface raster en calculant les transformations Top-Hat.

En savoir plus sur le fonctionnement de l’outil Transformation Top-Hat

Utilisation

Le raster de sortie représente la hauteur ou la profondeur des structures spatiales détectées à chaque localisation de cellule.
La valeur du paramètre Analysis Type (Type d’analyse) spécifie le type de structures spatiales à détecter. Ses deux options sont Ridge (Crête) ou Valley (Vallée). Le type d’analyse Ridge (Crête) détecte des structures spatiales plus hautes que leur environnement. Le type d’analyse Valley (Vallée) détecte des structures spatiales situées plus basses que leur environnement.
La valeur du paramètre Neighborhood (Voisinage) détermine la forme et la taille de la fenêtre utilisée pour l’analyse. Les structures spatiales dont la taille ou la largeur sont inférieures à ce voisinage sont généralement détectées.
Les formes de voisinage disponibles sont le cercle, le rectangle et les formes irrégulières. L’option de voisinage irrégulier est un voisinage personnalisé défini à l’aide d’un fichier de noyau.

Le fichier de noyau est un fichier texte ASCII qui définit les valeurs et la forme du voisinage. Le fichier peut être créé à l’aide de n’importe quel éditeur de texte brut. Le fichier doit avoir l’extension .txt et son nom ne doit comporter aucun espace.
Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.
Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Etiqueter	Explication	Type de données
Raster de surface en entrée	Raster de surface en entrée.	Raster Layer
Quartier (Facultatif)	Cellules entourant une cellule de traitement qui seront utilisées dans le calcul de la transformation Top-Hat. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un cercle d’un rayon de 3 cellules. Voici les formes des types de voisinage pris en charge : Circle (Cercle), Radius (Rayon), Units (Type d’unité) Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules. Rectangle, Height (Hauteur), Width (Largeur), Units (Type d’unité) Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules. Irregular (Irrégulier), Kernel file (Fichier de noyau) Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules. Pour les voisinages de type circulaire ou rectangulaire, les unités de distance des paramètres peuvent être spécifiées en unités de cellule (Cell [Cellule]) ou de carte (Map [Carte]). Les unités de cellule sont privilégiées par défaut. Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. La valeur 1 indique que la cellule en entrée correspondante sera incluse.	Neighborhood
Type d’analyse (Facultatif)	Indique le type d’objets à détecter. Crête—Les objets qui sont plus hauts que leur environnement (comme les ponts, les barrages et les crêtes de montagnes) seront détectés. Il s’agit de l’option par défaut. Vallée—Les objets situés plus bas que leur environnement (comme les canaux et les vallées) seront détectés.	String

Etiqueter

Explication

Type de données

Raster de surface en entrée

Raster de surface en entrée.

Raster Layer

Quartier

(Facultatif)

Cellules entourant une cellule de traitement qui seront utilisées dans le calcul de la transformation Top-Hat. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé.

Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un cercle d’un rayon de 3 cellules.

Voici les formes des types de voisinage pris en charge :

Circle (Cercle), Radius (Rayon), Units (Type d’unité)

Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.
Rectangle, Height (Hauteur), Width (Largeur), Units (Type d’unité)

Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.
Irregular (Irrégulier), Kernel file (Fichier de noyau)

Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules.

Pour les voisinages de type circulaire ou rectangulaire, les unités de distance des paramètres peuvent être spécifiées en unités de cellule (Cell [Cellule]) ou de carte (Map [Carte]). Les unités de cellule sont privilégiées par défaut.

Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. La valeur 1 indique que la cellule en entrée correspondante sera incluse.

Neighborhood

Type d’analyse

(Facultatif)

Indique le type d’objets à détecter.

Crête—Les objets qui sont plus hauts que leur environnement (comme les ponts, les barrages et les crêtes de montagnes) seront détectés. Il s’agit de l’option par défaut.
Vallée—Les objets situés plus bas que leur environnement (comme les canaux et les vallées) seront détectés.

String

Valeur de retour

Etiqueter	Explication	Type de données
Raster en sortie	Raster en sortie. Les valeurs de cellule du raster en sortie représentent la hauteur ou la profondeur des objets détectés à chaque localisation de cellule, selon le type d’analyse. Lorsque l’option Ridge (Crête) est spécifiée pour le paramètre Analysis Type (Type d’analyse), les valeurs en sortie représentent la hauteur des objets détectés à chaque localisation de cellule. Lorsque l’option Valley (Vallée) est spécifiée pour le paramètre Analysis Type (Type d’analyse), les valeurs en sortie représentent la profondeur des objets détectés à chaque localisation de cellule.	Raster

Etiqueter

Explication

Type de données

Raster en sortie

Raster en sortie.

Les valeurs de cellule du raster en sortie représentent la hauteur ou la profondeur des objets détectés à chaque localisation de cellule, selon le type d’analyse. Lorsque l’option Ridge (Crête) est spécifiée pour le paramètre Analysis Type (Type d’analyse), les valeurs en sortie représentent la hauteur des objets détectés à chaque localisation de cellule. Lorsque l’option Valley (Vallée) est spécifiée pour le paramètre Analysis Type (Type d’analyse), les valeurs en sortie représentent la profondeur des objets détectés à chaque localisation de cellule.

Raster

TopHatTransform(in_raster, {neighborhood}, {analysis_type})

Nom Explication Type de données

Nom	Explication	Type de données
in_raster	Raster de surface en entrée.	Raster Layer
neighborhood (Facultatif)	Cellules entourant une cellule de traitement qui seront utilisées dans le calcul de la transformation Top-Hat. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un cercle d’un rayon de 3 cellules. La forme des voisinages est définie par la classe `Neighborhood`. Les types de voisinage disponibles sont `NbrCircle`, `NbrRectangle` et `NbrIrregular`. Voici les formes des types de voisinage pris en charge : `NbrCircle({radius}, {units}` Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules. `NbrRectangle({width}, {height}, {units})` Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules. `NbrIrregular(inKernelFile)` Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules. Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. La valeur 1 indique que la cellule en entrée correspondante sera incluse.	Neighborhood
analysis_type (Facultatif)	Indique le type d’objets à détecter. `RIDGE`—Les objets qui sont plus hauts que leur environnement (comme les ponts, les barrages et les crêtes de montagnes) seront détectés. Il s’agit de l’option par défaut. `VALLEY`—Les objets situés plus bas que leur environnement (comme les canaux et les vallées) seront détectés.	String

in_raster

Raster de surface en entrée.

Raster Layer

neighborhood

(Facultatif)

La forme des voisinages est définie par la classe Neighborhood. Les types de voisinage disponibles sont NbrCircle, NbrRectangle et NbrIrregular.

Voici les formes des types de voisinage pris en charge :

NbrCircle({radius}, {units}

Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.
NbrRectangle({width}, {height}, {units})

Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.
NbrIrregular(inKernelFile)

Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules.

Neighborhood

analysis_type

(Facultatif)

Indique le type d’objets à détecter.

RIDGE—Les objets qui sont plus hauts que leur environnement (comme les ponts, les barrages et les crêtes de montagnes) seront détectés. Il s’agit de l’option par défaut.
VALLEY—Les objets situés plus bas que leur environnement (comme les canaux et les vallées) seront détectés.

String

Valeur de retour

Nom Explication Type de données

Nom	Explication	Type de données
out_raster	Raster en sortie. Les valeurs de cellule du raster en sortie représentent la hauteur ou la profondeur des objets détectés à chaque localisation de cellule, selon le type d’analyse. Lorsque l’option `RIDGE` est spécifiée pour le paramètre `analysis_type`, les valeurs en sortie représentent la hauteur des objets détectés à chaque localisation de cellule. Lorsque l’option `VALLEY` est spécifiée pour le paramètre `analysis_type`, les valeurs en sortie représentent la profondeur des objets détectés à chaque localisation de cellule.	Raster

out_raster

Raster en sortie.

Les valeurs de cellule du raster en sortie représentent la hauteur ou la profondeur des objets détectés à chaque localisation de cellule, selon le type d’analyse. Lorsque l’option RIDGE est spécifiée pour le paramètre analysis_type, les valeurs en sortie représentent la hauteur des objets détectés à chaque localisation de cellule. Lorsque l’option VALLEY est spécifiée pour le paramètre analysis_type, les valeurs en sortie représentent la profondeur des objets détectés à chaque localisation de cellule.

Raster

Exemple de code

TopHatTransform Exemple 1 (fenêtre Python)

Cet exemple calcule la transformation Top-Hat pour un raster en entrée à l’aide du type d’analyse Vallée.

from arcpy.sa import *
outRas = TopHatTransform('elevation.tif', "Circle 3 CELL", 'VALLEY')
outRas.save("C:/sapyexamples/output/thtout01.tif")

TopHatTransform Exemple 2 (script autonome)

Cet exemple calcule la transformation Top-Hat pour un raster en entrée à l’aide du type d’analyse Crête.

# Name: TopHatTransform_standalone.py
# Description: Calculates the top hat transform.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"
inAnalysisType = "RIDGE"

# Run the tool
outRas = TopHatTransform(inRaster, inNeighborhood, inAnalysisType)

# Save the output
outRas.save("C:/sapyexamples/output/thtout02.tif")

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Transformation Top-Hat (Outils Spatial Analyst)

Résumé

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes