Créer un champ de vision (Analyse raster)

Synthèse

Crée des surfaces dans lesquelles un observateur peut voir des objets au sol. Les points d'observation en entrée peuvent représenter soit des observateurs (par exemple, des personnes au sol ou des vigies dans une tour de guet) soit des objets observés (par exemple, des éoliennes, des châteaux d'eau, des véhicules ou d'autres personnes).

Les points d’observation et les objets observés peuvent se trouver à une certaine hauteur au-dessus du sol, laquelle permet de déterminer la visibilité. Par exemple, un champ de vision calculé pour des éoliennes de 90 mètres et des personnes mesurant 1,80 mètre au sol sera généralement plus important qu’un champ de vision calculé pour des éoliennes de 60 mètres et des personnes mesurant 1,50 mètre.

La couche de résultats enregistre le nombre de fois que chaque emplacement de cellule du raster de surface en entrée peut être vu par les points d’observation en entrée. Les cellules non visibles se voient attribuer des valeurs NoData.

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

  La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. La couche d’entités en entrée peut être une couche du portail, ou une URI ou une URL d’un service d’entités. Cet outil ne prend pas en charge les données raster ou les couches locales. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, il est recommandé d’utiliser les couches de votre portail en entrée.

• La visibilité du centre de chaque cellule est déterminée par un test de ligne de visée entre la cible et chaque point d’observation.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Surface d’altitude en entrée	Surface d’altitude qui sera utilisée pour calculer le champ de vision. Si l’unité verticale de la surface en entrée est différente de l’unité horizontale, lorsque les valeurs d’altitude sont représentées en pieds, par exemple, et que le système de coordonnées est en mètres, la surface doit présenter un système de coordonnées verticales défini. Cela s’explique par le fait que l’outil utilise les unités verticale (z) et horizontale (x,y) afin de calculer un facteur z pour l’analyse du champ de vision. Sans système de coordonnées verticales et en l’absence d’informations disponibles sur l’unité z, il est supposé que l’unité z est identique à l’unité x,y. Par conséquent, un facteur z interne équivalent à 1,0 sera utilisé pour l’analyse, ce qui risque de produire des résultats inattendus. La surface d’altitude peut être un entier ou une virgule flottante.	Raster Layer; Image Service; String
Entités points d’observation	Les entités ponctuelles qui représentent les emplacements des points d’observation lors du calcul des champs de vision.	Feature Set
Nom en sortie	Nom du service raster en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
Optimiser pour (Facultatif)	Spécifie la méthode d’optimisation qui sera utilisée pour calculer le champ de vision. Vitesse—La vitesse de traitement sera optimisée en compromettant légèrement la précision du résultat pour améliorer les performances. Il s’agit de l’option par défaut. Précision—La précision dans les résultats sera optimisée, mais la durée de traitement sera prolongée.	String
Type de distance de visualisation maximum (Facultatif)	Spécifie la manière dont la distance de visualisation maximale sera déterminée. Si vous changez le type de visualisation de Distance à Champ, le paramètre Distance de visualisation maximum est remplacé par Champ de distance de visualisation maximum. Distance—La distance maximale sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. Champ—La distance maximale pour chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
Distance de visualisation maximum (Facultatif)	Distance limite qui sera utilisée pour déterminer le point d’arrêt du calcul des zones visibles. Au-delà de cette distance, nul ne sait si les points d’observation et les autres objets peuvent se voir. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains). La valeur par défaut est 9 milles terrestres.	Linear Unit
Champ de distance de visualisation maximum (Facultatif)	Champ contenant la distance de visualisation maximale pour chaque point d’observation. Les valeurs contenues dans le champ doivent utiliser la même unité que la coordonnée x,y de la surface d’élévation en entrée. La distance de visualisation maximum est la distance limite où s’arrête le calcul de zones visibles. Au-delà de cette distance, nul ne sait si les points d’observation et les autres objets peuvent se voir.	Field
Type de distance de visualisation minimum (Facultatif)	Spécifie la manière dont la distance visible minimale sera déterminée. Si vous changez le type de visualisation de Distance à Champ, le paramètre Distance de visualisation minimum est remplacé par Champ de distance de visualisation minimum. Distance—La distance minimale sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. Champ—La distance minimale pour chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
Distance de visualisation minimum (Facultatif)	Distance qui sera utilisée pour déterminer le point de départ du calcul des zones visibles. Les cellules de la surface se trouvant à une distance inférieure à celle-ci ne sont pas visibles dans la sortie, mais peuvent toutefois bloquer la visibilité des cellules comprises entre les distances de visualisation minimum et maximum. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains).	Linear Unit
Champ de distance de visualisation minimum (Facultatif)	Champ contenant la distance de visualisation minimale pour chaque point d’observation. Les valeurs contenues dans le champ doivent utiliser la même unité que la coordonnée x,y de la surface d’élévation en entrée. La distance de visualisation minimum détermine le point de départ du calcul des surfaces visibles. Les cellules de la surface se trouvant à une distance inférieure à celle-ci ne sont pas visibles dans la sortie, mais peuvent toutefois bloquer la visibilité des cellules comprises entre les distances de visualisation minimum et maximum.	Field
Les distances de visualisation sont en 3D (Facultatif)	Spécifie si les valeurs des paramètres de distance de visualisation minimale et maximale seront mesurées en 3D ou en 2D. Une distance 2D représente la simple distance linéaire mesurée entre un point d’observation et une cible à l’aide de leurs emplacements projetés au niveau de la mer. Une distance 3D produit une valeur plus réaliste en tenant compte de leur hauteur relative. Activé : la distance de visualisation sera mesurée en 3D. Désactivé : la distance de visualisation sera mesurée en 2D. Il s’agit de l’option par défaut.	Boolean
Type d’altitude des points d’observation (Facultatif)	Spécifie la manière dont l’élévation des points d’observation sera déterminée. Si vous changez le type de visualisation d’Altitude à Champ, le paramètre Altitude des points d’observation est remplacé par Champ d’altitude des points d’observation. Élévation—L’élévation des points d’observation sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. Champ—L’élévation de chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
Altitude des points d’observation (Facultatif)	Élévation qui sera utilisée pour les positions d’observation. Si ce paramètre n’est pas spécifié, l’altitude du point d’observation s’obtient à partir du raster de surface à l’aide de l’interpolation bilinéaire. Si une valeur est attribuée à ce paramètre, elle est appliquée à tous les points d’observation. Pour spécifier des valeurs différentes pour chaque point d’observation, définissez ce paramètre sur un champ des entités des points d’observation en entrée. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains).	Linear Unit
Champ d’altitude des points d’observation (Facultatif)	Champ contenant l’élévation des points d’observation. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée. Si ce paramètre n’est pas spécifié, l’altitude du point d’observation s’obtient à partir du raster de surface à l’aide de l’interpolation bilinéaire.	Field
Type de hauteur des points d’observation (Facultatif)	Spécifie la manière dont la hauteur des points d’observation sera déterminée. Si vous changez le type de visualisation de Hauteur à Champ, le paramètre Hauteur des points d’observation est remplacé par Champ de hauteur des points d’observation. Hauteur—La hauteur des points d’observation sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. Champ—La hauteur de chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
Hauteur des points d’observation (Facultatif)	Hauteur qui sera utilisée pour les positions d’observation. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains). La valeur par défaut est 6 pieds internationaux.	Linear Unit
Champ de hauteur des points d’observation (Facultatif)	Champ contenant la hauteur des points d’observation. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée.	Field
Type de hauteur de la cible (Facultatif)	Spécifie la manière dont la hauteur cible sera déterminée. Si vous changez le type de visualisation de Hauteur à Champ, le paramètre Hauteur de cible est remplacé par Champ de hauteur cible. Hauteur—La hauteur cible sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. Champ—La hauteur de chaque cible sera déterminée par les valeurs d’un champ que vous spécifiez.	String
Hauteur de la cible (Facultatif)	Hauteur des structures ou des personnes au sol qui serviront à établir la visibilité. Le champ de vision résultant correspond aux zones dans lesquelles un point d’observation peut voir les autres objets. L’inverse est également vrai : les autres objets peuvent voir un point d’observation. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains).	Linear Unit
Champ de hauteur cible (Facultatif)	Champ contenant la hauteur des cibles. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée.	Field
Nom du raster au-dessus du niveau du sol en sortie (Facultatif)	Nom du raster au-dessus du niveau du sol (AGL) en sortie. Le raster AGL obtenu est un raster dans lequel la valeur de chaque cellule correspond à la hauteur minimale devant être ajoutée à une cellule (qui, sinon, ne serait pas visible) pour la rendre visible par au moins un point d’observation. La valeur 0 sera attribuée aux cellules qui étaient déjà visibles dans ce raster en sortie.	String

Sortie obtenue

Étiquette	Explication	Type de données
Raster en sortie	Raster de champ de vision en sortie.	Raster Layer
Raster au-dessus du niveau du sol en sortie	Raster au-dessus du niveau du sol en sortie.	Raster Layer

Python

arcpy.ra.CreateViewshed(inputElevationSurface, inputObserverFeatures, outputName, {optimizeFor}, {maximumViewingDistanceType}, {maximumViewingDistance}, {maximumViewingDistanceField}, {minimumViewingDistanceType}, {minimumViewingDistance}, {minimumViewingDistanceField}, {viewingDistanceIs3D}, {observersElevationType}, {observersElevation}, {observersElevationField}, {observersHeightType}, {observersHeight}, {observersHeightField}, {targetHeightType}, {targetHeight}, {targetHeightField}, {aboveGroundLevelOutputName})

Nom	Explication	Type de données
inputElevationSurface	Surface d’altitude qui sera utilisée pour calculer le champ de vision. Si l’unité verticale de la surface en entrée est différente de l’unité horizontale, lorsque les valeurs d’altitude sont représentées en pieds, par exemple, et que le système de coordonnées est en mètres, la surface doit présenter un système de coordonnées verticales défini. Cela s’explique par le fait que l’outil utilise les unités verticale (z) et horizontale (x,y) afin de calculer un facteur z pour l’analyse du champ de vision. Sans système de coordonnées verticales et en l’absence d’informations disponibles sur l’unité z, il est supposé que l’unité z est identique à l’unité x,y. Par conséquent, un facteur z interne équivalent à 1,0 sera utilisé pour l’analyse, ce qui risque de produire des résultats inattendus. La surface d’altitude peut être un entier ou une virgule flottante.	Raster Layer; Image Service; String
inputObserverFeatures	Les entités ponctuelles qui représentent les emplacements des points d’observation lors du calcul des champs de vision.	Feature Set
outputName	Nom du service raster en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
optimizeFor (Facultatif)	Spécifie la méthode d’optimisation qui sera utilisée pour calculer le champ de vision. SPEED—La vitesse de traitement sera optimisée en compromettant légèrement la précision du résultat pour améliorer les performances. Il s’agit de l’option par défaut. ACCURACY—La précision dans les résultats sera optimisée, mais la durée de traitement sera prolongée.	String
maximumViewingDistanceType (Facultatif)	Spécifie la manière dont la distance de visualisation maximale sera déterminée. DISTANCE—La distance maximale sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. FIELD—La distance maximale pour chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
maximumViewingDistance (Facultatif)	Distance limite qui sera utilisée pour déterminer le point d’arrêt du calcul des zones visibles. Au-delà de cette distance, nul ne sait si les points d’observation et les autres objets peuvent se voir. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet. La valeur par défaut est 9 milles terrestres.	Linear Unit
maximumViewingDistanceField (Facultatif)	Champ contenant la distance de visualisation maximale pour chaque point d’observation. Les valeurs contenues dans le champ doivent utiliser la même unité que la coordonnée x,y de la surface d’élévation en entrée. La distance de visualisation maximum est la distance limite où s’arrête le calcul de zones visibles. Au-delà de cette distance, nul ne sait si les points d’observation et les autres objets peuvent se voir.	Field
minimumViewingDistanceType (Facultatif)	Spécifie la manière dont la distance visible minimale sera déterminée. DISTANCE—La distance minimale sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. FIELD—La distance minimale pour chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
minimumViewingDistance (Facultatif)	Distance qui sera utilisée pour déterminer le point de départ du calcul des zones visibles. Les cellules de la surface se trouvant à une distance inférieure à celle-ci ne sont pas visibles dans la sortie, mais peuvent toutefois bloquer la visibilité des cellules comprises entre les distances de visualisation minimum et maximum. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet.	Linear Unit
minimumViewingDistanceField (Facultatif)	Champ contenant la distance de visualisation minimale pour chaque point d’observation. Les valeurs contenues dans le champ doivent utiliser la même unité que la coordonnée x,y de la surface d’élévation en entrée. La distance de visualisation minimum détermine le point de départ du calcul des surfaces visibles. Les cellules de la surface se trouvant à une distance inférieure à celle-ci ne sont pas visibles dans la sortie, mais peuvent toutefois bloquer la visibilité des cellules comprises entre les distances de visualisation minimum et maximum.	Field
viewingDistanceIs3D (Facultatif)	Spécifie si les valeurs des paramètres de distance de visualisation minimale et maximale seront mesurées en 3D ou en 2D. Une distance 2D représente la simple distance linéaire mesurée entre un point d’observation et une cible à l’aide de leurs emplacements projetés au niveau de la mer. Une distance 3D produit une valeur plus réaliste en tenant compte de leur hauteur relative. 2D—La distance de visualisation sera mesurée en 2D. Il s’agit de l’option par défaut. 3D—La distance de visualisation sera mesurée en 3D.	Boolean
observersElevationType (Facultatif)	Spécifie la manière dont l’élévation des points d’observation sera déterminée. ELEVATION—L’élévation des points d’observation sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. FIELD—L’élévation de chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
observersElevation (Facultatif)	Élévation qui sera utilisée pour les positions d’observation. Si ce paramètre n’est pas spécifié, l’altitude du point d’observation s’obtient à partir du raster de surface à l’aide de l’interpolation bilinéaire. Si une valeur est attribuée à ce paramètre, elle est appliquée à tous les points d’observation. Pour spécifier des valeurs différentes pour chaque point d’observation, définissez ce paramètre sur un champ des entités des points d’observation en entrée. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet.	Linear Unit
observersElevationField (Facultatif)	Champ contenant l’élévation des points d’observation. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée. Si ce paramètre n’est pas spécifié, l’altitude du point d’observation s’obtient à partir du raster de surface à l’aide de l’interpolation bilinéaire.	Field
observersHeightType (Facultatif)	Spécifie la manière dont la hauteur des points d’observation sera déterminée. HEIGHT—La hauteur des points d’observation sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. FIELD—La hauteur de chaque position d’observation sera déterminée par les valeurs d’un champ que vous spécifiez.	String
observersHeight (Facultatif)	Hauteur qui sera utilisée pour les positions d’observation. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet. La valeur par défaut est 6 pieds internationaux.	Linear Unit
observersHeightField (Facultatif)	Champ contenant la hauteur des points d’observation. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée.	Field
targetHeightType (Facultatif)	Spécifie la manière dont la hauteur cible sera déterminée. HEIGHT—La hauteur cible sera déterminée par la valeur que vous spécifiez. Il s’agit de la méthode par défaut. FIELD—La hauteur de chaque cible sera déterminée par les valeurs d’un champ que vous spécifiez.	String
targetHeight (Facultatif)	Hauteur des structures ou des personnes au sol qui serviront à établir la visibilité. Le champ de vision résultant correspond aux zones dans lesquelles un point d’observation peut voir les autres objets. L’inverse est également vrai : les autres objets peuvent voir un point d’observation. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet.	Linear Unit
targetHeightField (Facultatif)	Champ contenant la hauteur des cibles. La valeur contenue dans ce champ doit utiliser la même unité que la coordonnée z de la surface d’élévation en entrée.	Field
aboveGroundLevelOutputName (Facultatif)	Nom du raster au-dessus du niveau du sol (AGL) en sortie. Le raster AGL obtenu est un raster dans lequel la valeur de chaque cellule correspond à la hauteur minimale devant être ajoutée à une cellule (qui, sinon, ne serait pas visible) pour la rendre visible par au moins un point d’observation. La valeur 0 sera attribuée aux cellules qui étaient déjà visibles dans ce raster en sortie.	String

Sortie obtenue

Nom	Explication	Type de données
outputRaster	Raster de champ de vision en sortie.	Raster Layer
outputAboveGroundLevelRaster	Raster au-dessus du niveau du sol en sortie.	Raster Layer

Exemple de code

Exemple 1 d’utilisation de l’outil CreateViewshed (fenêtre Python)

Cet exemple crée un service d’imagerie de champ de vision à l’aide de points de surface et d’observation spécifiés.

import arcpy

arcpy.ra.CreateViewshed(
    "https://myserver/rest/services/elevation/ImageServer", 
    "https://myserver/rest/services/destination/FeatureServer/0", 
    "outview1", "SPEED", "DISTANCE", "9 Miles", "#", "DISTANCE",
    "0 Meters", "#", "2D", "ELEVATION", "#", "#", "HEIGHT",
    "6 Feet", "#", "HEIGHT", "3 Feet", "#", "outagl1")

Exemple 2 d’utilisation de l’outil CreateViewshed (script autonome)

Cet exemple crée un service d’imagerie de champ de vision à l’aide de points de surface et d’observation spécifiés.

#---------------------------------------------------------------------------
# Name: CreateViewshed_example02.py
# Description: Creates a viewshed image service raster from given surface
#   and observer points.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSurface = "https://myserver/rest/services/elevation/ImageServer"
inObservers = "https://myserver/rest/services/destination/FeatureServer/0"
outputViewshed = "outview1"
optimizeFor = "Speed"
maxDistType = "Distance"
maxDist = "9 Miles"
maxDistField = "#"
minDistType = "Distance"
minDist = "0 Miles"
minDistField = "#"
distanceIs3D = "2D"
obsElevationType = "Elevation"
obsElevation = "#"
obsElevationField = "#"
obsOffsetType = "Height"
obsOffset = "6 Feet"
obsOffsetField = "#"
surfOffsetType = "Height"
surfOffset = "3 Feet"
surfOffsetField = "#"
outputAgl = "outagl1"

# Execute Create Viewshed raster analysis tool
arcpy.ra.CreateViewshed(
    inSurface, inObservers, outputViewshed, optimizeFor,
    maxDistType, maxDist, maxDistField, minDistType, minDist,
    minDistField, distanceIs3D, obsElevationType, obsElevation,
    obsElevationField, obsOffsetType, obsOffset, obsOffsetField,
    surfOffsetType, surfOffset, surfOffsetField, outputAgl)

Environnements

Étendue, Taille de cellule, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Informations de licence

• Basic: Nécessite ArcGIS Image Server
• Standard: Nécessite ArcGIS Image Server
• Advanced: Nécessite ArcGIS Image Server