Ligne de visée (3D Analyst)

Synthèse

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.

Pour en savoir plus sur l'outil Ligne de visée

Illustration

Illustration de l’outil 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 l’emplacement cible pour lequel la visibilité est déterminée.

  • Envisagez de créer des lignes de visée à l’aide de l’outil Construire des lignes de visée si les cibles de visibilité se trouvent dans une classe d’entités différente. 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 une seule 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

Paramètres

ÉtiquetteExplicationType de données
Surface en entrée

Surface de couche de scènes de maillage intégré, de jeu de données LAS, raster, TIN ou de terrain qui est utilisée 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. Utilisez un champ nommé OffsetA pour définir une hauteur de décalage personnalisé pour le point d’observation et utilisez un champ nommé OffsetB pour 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 l'emplacement de la première obstruction vers sa cible sur la ligne de visée du point d'observation.

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.

  • Désactivée - La courbure de la Terre n'est pas prise en compte. Il s’agit de l’option par défaut.
  • Activée - La courbure de la Terre est prise en compte.
Boolean
Utiliser la réfraction
(Facultatif)

Indique si la réfraction atmosphérique est être 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.

  • Désactivée - La réfraction atmosphérique n'est pas prise en compte. Il s’agit de l’option par défaut.
  • Activée - La réfraction atmosphérique est prise en compte.
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 des informations pour générer un diagramme de profil englobant une représentation du point d’observation, une obstruction potentielle et un 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é : les attributs de représentation graphique sont inclus dans la sortie. Il s’agit de l’option par défaut.
  • Désactivé : les attributs de représentation graphique ne sont pas inclus dans la sortie.
Boolean

arcpy.ddd.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})
NomExplicationType de données
in_surface

Surface de couche de scènes de maillage intégré, de jeu de données LAS, raster, TIN ou de terrain qui est utilisée 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. Utilisez un champ nommé OffsetA pour définir une hauteur de décalage personnalisé pour le point d’observation et utilisez un champ nommé OffsetB pour 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 l'emplacement de la première obstruction vers sa cible sur la ligne de visée du point d'observation.

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.

  • CURVATURELa courbure de la Terre est prise en compte.
  • NO_CURVATURELa courbure de la Terre n'est pas prise en compte. Il s’agit de l’option par défaut.
Boolean
use_refraction
(Facultatif)

Indique si la réfraction atmosphérique est être 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.

  • REFRACTIONLa réfraction atmosphérique est prise en compte.
  • NO_REFRACTIONLa réfraction atmosphérique n'est pas prise en compte. Il s’agit de l’option par défaut.
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 des informations pour générer un diagramme de profil englobant une représentation du point d’observation, une obstruction potentielle et un 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_ATTRIBUTESLes attributs de représentation graphique sont inclus dans la sortie. Il s’agit du paramètre par défaut.
  • NO_OUTPUT_GRAPHING_ATTRIBUTESLes attributs de représentation graphique ne sont pas inclus dans la sortie.
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")
2e exemple d'utilisation de l'outil 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)

Informations de licence

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

Rubriques connexes