Ligne de visée (Outils 3D Analyst)

Résumé

Détermine la visibilité des lignes de visée sur les obstructions constituées d'une surface fonctionnelle et d'un jeu de données multipatch facultatif.

En savoir plus sur le fonctionnement de l’outil Line Of Sight (Ligne de visée)

Illustration

Illustration de l’outil Line Of Sight (Ligne de visée)

Utilisation

Seules les extrémités de la ligne en entrée sont utilisées pour définir le point d’observation et la cible. Les lignes de visée doivent être des lignes droites composées de deux sommets représentant le point d’observation et la localisation cible pour lesquels la visibilité est déterminée.
Envisagez de créer des lignes de visée à l’aide de l’outil Construct Sight Lines (Générer des lignes de visée) si les cibles de visibilité se trouvent dans une autre classe d’entités. Par exemple, les lignes de visibilité peuvent être générées en échantillonnant une entité linéaire cible à un intervalle donné en vue de tester la visibilité le long d’une trajectoire.
Les lignes en sortie sont divisées le long des parties visibles et invisibles de la ligne de visée en entrée. Si seule une surface est utilisée pour déterminer la visibilité de la ligne de visée, les lignes en sortie suivent le profil de la surface. Si une entité multipatch est fournie lors du calcul de la ligne de visée, les lignes en sortie suivent la trajectoire des lignes de visée en sortie.
La classe d’entités linéaires en sortie comprend les champs suivants :
- SourceOID—ID unique de l’entité linéaire en entrée utilisée pour calculer la visibilité.
- VisCode—Indique si la ligne en sortie représente une portion visible ou invisible de la ligne de visée. Chaque ligne de visée peut potentiellement être divisée en plusieurs entités, selon qu’elle est partiellement obstruée ou non. Cet attribut identifie l’état de visibilité de chaque portion de ces lignes de visée. La valeur 1 indique que la cible est visible, tandis que la valeur 2 indique qu’elle n’est pas visible. Ce champ n’est présent que dans les entités linéaires en sortie.
- TarIsVis—Indique si le point cible est visible depuis le point d’observation. La valeur 1 indique que la cible est visible, tandis que la valeur 0 indique qu’elle n’est pas visible. Ce champ n’est présent que dans les entités linéaires en sortie.
- OBSTR_MPID—Obstacle qui masque la visibilité du point cible. Une entité linéaire distincte est créée pour les portions visibles et obstruées de chaque ligne de visée en entrée. La portion qui n’est pas obstruée a la valeur -9999, la portion qui est obstruée par un multipatch a l’ID unique de l’entité d’obstacle et la portion qui est obstruée par la surface a la valeur -1.
Si le paramètre Output graphing attributes (Attributs de représentation graphique en sortie) est activé, la classe d’entités linéaires en sortie comporte les champs supplémentaires suivants :
- OBSERVERZ—Élévation du point d’observation, qui inclut tout décalage vertical susceptible d’être appliqué.
- TARGETZ—Élévation du point cible, qui inclut tout décalage vertical susceptible d’être appliqué.
- OBSTR_DIST—Distance horizontale entre le point d’observation et le point qui obstrue la visibilité de la cible. Lorsque la ligne de visée n’est pas obstruée, cette valeur est de -1,0.
En savoir plus sur la création d’un diagramme de profil

Etiqueter	Explication	Type de données
Surface en entrée	Couche de scène de maillage intégré, jeu de données LAS, raster, TIN ou surface de MNT à utiliser pour définir la visibilité.	TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File
Entités linéaires en entrée	Entités de ligne de visée dont le premier sommet définit le point d’observation et le dernier sommet identifie la localisation cible. Lorsque les lignes de visée sont des entités 2D, les hauteurs du point d’observation et du point cible découlent de la surface en entrée. Lorsque les lignes de visée sont des entités 3D, les hauteurs du point d’observation et du point cible sont obtenues à partir des coordonnées z des entités. Les lignes 2D sont évaluées selon un décalage par rapport à la surface sous-jacente. Un décalage par défaut de 1 est appliqué pour élever les points au-dessus de la surface. Pour les lignes en entrée 2D ou 3D, utilisez un champ nommé `OffsetA` afin de définir une hauteur de décalage personnalisée pour le point d’observation ; utilisez un champ nommé `OffsetB` afin de définir un décalage personnalisé pour la cible.	Feature Layer
Classe d’entités en sortie	Classe d’entités linéaires en sortie sur laquelle la visibilité est déterminée.	Feature Class
Classe d’entités ponctuelles d’obstruction en sortie (Facultatif)	Classe d’entités ponctuelles facultative identifiant la localisation du premier obstacle sur la ligne de visée entre le point d’observation et la cible.	Feature Class
Utiliser la courbure (Facultatif)	Indique si la courbure de la Terre est prise en compte lors de l’analyse de la ligne de visée. Pour que cet paramètre soit activé, la surface doit avoir une référence spatiale définie dans des coordonnées projetées avec des unités z définies. Activé—The earth's curvature will be taken into consideration. Décoché—The earth's curvature will not be taken into consideration. This is the default.	Boolean
Utiliser la réfraction (Facultatif)	Indique si la réfraction atmosphérique est prise en compte lors de la génération d’une ligne de visée à partir d’une surface fonctionnelle. Ce paramètre ne s’applique pas si des entités multipatch sont utilisées. Activé—Atmospheric refraction will be taken into consideration. Décoché—Atmospheric refraction will not be taken into consideration. This is the default.	Boolean
Facteur de réfraction (Facultatif)	Valeur à utiliser comme facteur de réfraction. La valeur par défaut est 0,13.	Double
Résolution des niveaux de pyramide (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut valeur est 0, ce qui est la résolution maximale.	Double
Input Features (Entités en entrée) (Facultatif)	Une entité multipatch qui peut définir des éléments obstruants supplémentaires, tels que des bâtiments. Les options de réfraction ne sont pas respectées pour cette entrée.	Feature Layer
Attributs de représentation graphique en sortie (Facultatif)	Indique si les attributs de ligne de visée en sortie incluent des champs supplémentaires comportant des informations qui peuvent être utilisées dans un diagramme de profil. Les valeurs de ces champs fournissent les informations permettant de générer un diagramme de profil englobant une représentation du point d’observation, un obstacle potentiel et le point cible de chaque ligne de visée, ainsi que la visibilité de la ligne de visée directe qui relie le point d’observation à la cible. Activé—Graphing attributes will be included in the output. This is the default. Décoché—Graphing attributes will not be included in the output.	Boolean

arcpy.3d.LineOfSight(in_surface, in_line_feature_class, out_los_feature_class, {out_obstruction_feature_class}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {in_features}, {output_graphing_attributes})

Nom	Explication	Type de données
in_surface	Couche de scène de maillage intégré, jeu de données LAS, raster, TIN ou surface de MNT à utiliser pour définir la visibilité.	TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File
in_line_feature_class	Entités de ligne de visée dont le premier sommet définit le point d’observation et le dernier sommet identifie la localisation cible. Lorsque les lignes de visée sont des entités 2D, les hauteurs du point d’observation et du point cible découlent de la surface en entrée. Lorsque les lignes de visée sont des entités 3D, les hauteurs du point d’observation et du point cible sont obtenues à partir des coordonnées z des entités. Les lignes 2D sont évaluées selon un décalage par rapport à la surface sous-jacente. Un décalage par défaut de 1 est appliqué pour élever les points au-dessus de la surface. Pour les lignes en entrée 2D ou 3D, utilisez un champ nommé `OffsetA` afin de définir une hauteur de décalage personnalisée pour le point d’observation ; utilisez un champ nommé `OffsetB` afin de définir un décalage personnalisé pour la cible.	Feature Layer
out_los_feature_class	Classe d’entités linéaires en sortie sur laquelle la visibilité est déterminée.	Feature Class
out_obstruction_feature_class (Facultatif)	Classe d’entités ponctuelles facultative identifiant la localisation du premier obstacle sur la ligne de visée entre le point d’observation et la cible.	Feature Class
use_curvature (Facultatif)	Indique si la courbure de la Terre est prise en compte lors de l’analyse de la ligne de visée. Pour que cet paramètre soit activé, la surface doit avoir une référence spatiale définie dans des coordonnées projetées avec des unités z définies. `CURVATURE`—The earth's curvature will be taken into consideration. `NO_CURVATURE`—The earth's curvature will not be taken into consideration. This is the default.	Boolean
use_refraction (Facultatif)	Indique si la réfraction atmosphérique est prise en compte lors de la génération d’une ligne de visée à partir d’une surface fonctionnelle. Ce paramètre ne s’applique pas si des entités multipatch sont utilisées. `REFRACTION`—Atmospheric refraction will be taken into consideration. `NO_REFRACTION`—Atmospheric refraction will not be taken into consideration. This is the default.	Boolean
refraction_factor (Facultatif)	Valeur à utiliser comme facteur de réfraction. La valeur par défaut est 0,13.	Double
pyramid_level_resolution (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut valeur est 0, ce qui est la résolution maximale.	Double
in_features (Facultatif)	Une entité multipatch qui peut définir des éléments obstruants supplémentaires, tels que des bâtiments. Les options de réfraction ne sont pas respectées pour cette entrée.	Feature Layer
output_graphing_attributes (Facultatif)	Indique si les attributs de ligne de visée en sortie incluent des champs supplémentaires comportant des informations qui peuvent être utilisées dans un diagramme de profil. Les valeurs de ces champs fournissent les informations permettant de générer un diagramme de profil englobant une représentation du point d’observation, un obstacle potentiel et le point cible de chaque ligne de visée, ainsi que la visibilité de la ligne de visée directe qui relie le point d’observation à la cible. `OUTPUT_GRAPHING_ATTRIBUTES`—Graphing attributes will be included in the output. This is the default. `NO_OUTPUT_GRAPHING_ATTRIBUTES`—Graphing attributes will not be included in the output.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction LineOfSight (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = "C:/data"
arcpy.ddd.LineOfSight("tin", "line.shp", "los.shp", "buldings_multipatch.shp",
                    "obstruction.shp")

Exemple 2 d’utilisation de la fonction LineOfSight (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''*********************************************************************
Name: Sight Line Visibility of Parade Path
Description: This script demonstrates how to create a sight line feature class
             from a pair of observer and target points.
*********************************************************************'''
# Import system modules
import arcpy

# Set Local Variables:
arcpy.env.workspace = 'C:/data'

# Setting up input and output variables:
obs = "observer_pts.shp"
tar = "parade_path.shp"
sightlines = "output_sightlines.shp"
height = "<None>"
join_field = "#"
sampling = 0.5
direction = "OUTPUT_THE_DIRECTION"
surface = 'elevation.tif'
bldgs = 'buildings.shp'

arcpy.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
                              join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
                      "Obstructions.shp", in_features=bldgs)

Environnements

Espace de travail courant, Etendue, Système de coordonnées en sortie, Transformations géographiques, Résolution XY, Tolérance XY, Domaine XY en sortie, Résolution Z, Tolérance Z, Domaine Z en sortie, Mot-clé CONFIG en sortie, Validation automatique, Réduire l’utilisation de la mémoire pendant l’analyse sur les MNT

Informations de licence

Basic: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst