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 visée peuvent être générées en échantillonnant une entité linéaire cible à un intervalle spécifique pour 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 table attributaire de l'entité linéaire en sortie contient les champs suivants :

    • SourceOID— ID unique de l’entité linéaire utilisée pour calculer la visibilité.
    • VisCode— Visibilité le long de la ligne. Une valeur de 1 indique que la cible est visible, tandis qu'une valeur de 2 indique qu'elle n'est pas visible. Ce champ existe seulement si la géométrie en sortie est une ligne.
    • TarIsVis— Visibilité cible le long de la ligne. Une valeur de 1 indique que la cible est visible, tandis qu’une valeur de 0 indique qu’elle n’est pas visible. Ce champ existe seulement si la géométrie en sortie est une ligne.
    • OBSTR_MPID— Obstacle qui bloque la visibilité du point cible. Une entité linéaire séparée 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 une valeur de -9999. La portion obstruée par une entité multipatch a l’ID unique de l’entité obstruante. Enfin, la portion obstruée par la surface a la valeur 1.

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 MNT 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 l’emplacement cible. Quand les lignes de visée sont des entités 2D, les hauteurs d’observation et cible sont dérivées de la surface en entrée. Quand les lignes de visée sont des entités 3D, les hauteurs d’observation et cible sont obtenues à partir des coordonnées z de l’entité.

Les lignes 2D sont évaluées comme un décalage de 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ée pour le point d’observation, 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é a été déterminée. Deux champs attributaires sont créés. Le champ VisCode indique la visibilité le long de la ligne, 1 signifiant visible et 2 non visible. Le champ TarIsVis indique la visibilité de la cible, 0 signifiant non visible et 1 signifiant visible.

Feature Class
Classe d’entités ponctuelles obstruantes 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 (ou résolution maximale).

Double
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

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})
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 MNT 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 l’emplacement cible. Quand les lignes de visée sont des entités 2D, les hauteurs d’observation et cible sont dérivées de la surface en entrée. Quand les lignes de visée sont des entités 3D, les hauteurs d’observation et cible sont obtenues à partir des coordonnées z de l’entité.

Les lignes 2D sont évaluées comme un décalage de 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ée pour le point d’observation, 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é a été déterminée. Deux champs attributaires sont créés. Le champ VisCode indique la visibilité le long de la ligne, 1 signifiant visible et 2 non visible. Le champ TarIsVis indique la visibilité de la cible, 0 signifiant non visible et 1 signifiant visible.

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 (ou 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

Exemple de code

Exemple 1 d’utilisation de l’outil 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)

Rubriques connexes