| Étiquette | Explication | Type 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 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 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. 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 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.
| 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.
| 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 |
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 avec des informations pouvant ê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.
| Boolean |
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.
Illustration
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 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 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 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.
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.
Paramètres
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})| Nom | Explication | Type 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 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 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. 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 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.
| 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.
| 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 avec des informations pouvant ê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.
| Boolean |
Exemple de code
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")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
Informations de licence
- Basic: Nécessite 3D Analyst
- Standard: Nécessite 3D Analyst
- Advanced: Nécessite 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?