Résumé
Permet de générer une ligne ou une classe d'entités multipatch contenant les résultats d'une analyse de la silhouette ou de l'horizon.
Illustration
Utilisation
L'outil Horizon permet de créer des silhouettes d'entités qui peuvent être extrudées dans des volumes d'ombre avec l'outil Barrière d'horizon. Pour plus d'informations, consultez la rubrique Fonctionnement de l'outil Horizon.
Les champs suivants sont ajoutés à la classe d'entités en sortie qui contient les horizons :
- OBSV_PT_ID : FID du point d’observation utilisé pour créer cet horizon.
- ORIGFTR_ID : FID de l’entité (bâtiment, par exemple).
Les champs suivants sont ajoutés à la classe d'entités en sortie qui contient les silhouettes :
- OBSV_PT_ID : FID du point d’observation utilisé pour créer cette silhouette.
- ORIGFTR_ID : FID de l’entité d’origine (bâtiment, par exemple) représentée par cette silhouette.
- DIR_VECT_X : composant X du vecteur d’unité représentant la direction des rayons lumineux à partir du point d’observation.
- DIR_VECT_Y : composant Y du vecteur d’unité représentant la direction des rayons lumineux à partir du point d’observation.
- DIR_VECT_Z : composant Z du vecteur d’unité représentant la direction des rayons lumineux à partir du point d’observation.
- FEAT_CTR_X : composant X du centre de l’enveloppe de l’entité d’origine (par exemple, bâtiment).
- FEAT_CTR_Y : composant Y du centre de l’enveloppe de l’entité.
- FEAT_CTR_Z : composant Z du centre de l’enveloppe de l’entité.
- BHND_CTR_X : composant X du centre de l’enveloppe de l’entité, déplacé derrière l’entité.
- BHND_CTR_Y : composant Y du centre de l’enveloppe de l’entité, déplacé derrière l’entité.
- BHND_CTR_Z : composant Z du centre de l’enveloppe de l’entité, déplacé derrière l’entité.
- USED_PARLL : création ou non de la silhouette à l’aide de rayons lumineux parallèles (1 pour oui, 0 pour non).
- MADE_VERT : silhouette créée à la verticale ou non, plutôt que perpendiculaire aux rayons lumineux (1 pour oui, 0 pour non).
- MOVED_BHND : silhouette déplacée ou non derrière l’entité, plutôt que placée au centre (1 pour oui, 0 pour non).
Syntaxe
arcpy.3d.Skyline(in_observer_point_features, out_feature_class, {in_surface}, {virtual_surface_radius}, {virtual_surface_elevation}, {in_features}, {feature_lod}, {from_azimuth_value_or_field}, {to_azimuth_value_or_field}, {azimuth_increment_value_or_field}, {max_horizon_radius}, {segment_skyline}, {scale_to_percent}, {scale_according_to}, {scale_method}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {create_silhouettes})
Paramètre | Explication | Type de données |
in_observer_point_features | Points 3D représentant les points d'observation. Chaque entité aura sa propre sortie. | Feature Layer |
out_feature_class | Entités 3D qui seront des lignes représentant l'horizon ou des multipatchs représentant les silhouettes. | Feature Class |
in_surface (Facultatif) | Surface topographique qui permettra de définir l'horizon. Si aucune surface n'est fournie, une surface virtuelle est employée à l'aide des paramètres virtual_surface_radius et virtual_surface_elevation. | LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer |
virtual_surface_radius (Facultatif) | Rayon de la surface virtuelle qui servira à définir l'horizon si aucune surface topographique n'est fournie. La valeur par défaut est 1,000 mètres. Les unités suivantes sont prises en charge :
| Linear Unit |
virtual_surface_elevation (Facultatif) | Altitude de la surface virtuelle (au lieu d'une surface réelle) pour la définition de l'horizon. Ce paramètre est ignoré si une surface réelle est fournie. La valeur par défaut est 0. Les unités suivantes sont prises en charge :
| Linear Unit |
in_features [in_features,...] (Facultatif) | Entités utilisées pour déterminer l'horizon. Si aucune entité n'est spécifiée, l'horizon se compose uniquement de la ligne d'horizon, telle qu'elle est définie par la surface topographique ou virtuelle. | Feature Layer |
feature_lod (Facultatif) | Niveau de détail auquel chaque entité doit être examinée dans l'analyse d'horizon.
| String |
from_azimuth_value_or_field (Facultatif) | Azimut (en degrés) à partir duquel les analyses d'horizon doivent être lancées. L'analyse démarre au point d'observation et se poursuit vers la droite, à partir de l'azimut de départ jusqu'à atteindre l'azimut d'arrivée. Doit être supérieur à moins 360 et inférieur à 360. La valeur par défaut est 0. | Double; Field |
to_azimuth_value_or_field (Facultatif) | Direction (en degrés) dans laquelle les analyses d'horizon doivent être effectuées. L'analyse démarre au point d'observation et se poursuit vers la droite, à partir de l'azimut de départ jusqu'à atteindre l'azimut d'arrivée. Ne doit pas excéder 360 et être supérieur à l'azimut de départ. La valeur par défaut est 360. | Double; Field |
azimuth_increment_value_or_field (Facultatif) | Intervalle angulaire (en degrés) auquel l'horizon doit être évalué lors de l'analyse d'horizon entre l'azimut de départ et l'azimut d'arrivée. Ne doit pas excéder l'azimut de départ moins l'azimut d'arrivée. La valeur par défaut est 1. | Double; Field |
max_horizon_radius (Facultatif) | Distance maximale pour rechercher un horizon à partir de l'emplacement d'observation. Une valeur nulle indique qu'aucune limite ne doit être imposée. La valeur par défaut est 0. Les unités suivantes sont prises en charge :
| Linear Unit |
segment_skyline (Facultatif) | Détermine si la ligne d'horizon ainsi obtenue disposera d'une entité pour chaque point d'observation ou si la ligne d'horizon de chaque point d'observation sera segmentée par les éléments uniques qui constituent la ligne d'horizon. Si des silhouettes sont générées, ce paramètre indique alors si des rayons divergents doivent être utilisés. Pour les ombres, ce paramètre doit en général être défini sur NO_SEGMENT_SKYLINE
| Boolean |
scale_to_percent (Facultatif) | Indique à quel pourcentage de l'angle vertical (angle au-dessus de l'horizon, ou angle d'altitude) ou de l'altitude d'origine chaque sommet d'horizon doit être placé. Si la valeur 0 ou 100 est entrée, aucune mise à l'échelle n'est effectuée. La valeur par défaut est 100. | Double |
scale_according_to (Facultatif) | Valeurs d'après lesquelles la mise à l'échelle doit être déterminée.
| String |
scale_method (Facultatif) | Sommet à utiliser pour effectuer le calcul.
| String |
use_curvature (Facultatif) | Indique si la courbure de la Terre doit être prise en compte lors de la génération de la crête à partir d'une surface fonctionnelle.
| Boolean |
use_refraction (Facultatif) | Indique si la réfraction atmosphérique sera appliquée lors de la génération d'une crête à partir d'une surface fonctionnelle.
| Boolean |
refraction_factor (Facultatif) | Coefficient de réfraction à utiliser si la réfraction atmosphérique est prise en compte. 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 par cet outil. La valeur par défaut est 0 (ou résolution maximale). | Double |
create_silhouettes (Facultatif) | Indique si les entités en sortie représenteront des lignes d'horizon ou des silhouettes.
| Boolean |
Exemple de code
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.
arcpy.env.workspace = "C:/data"
arcpy.Skyline_3d("observers.shp", "skyline_output.shp", "sample.gdb/featuredataset/terrain")
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''****************************************************************************
Name: Skyline Example
Description: This script demonstrates how to use the
Skyline tool.
****************************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inPts = "observers.shp"
# Make sure output has a unique name
outFC = arcpy.CreateUniqueName("skyline_output.shp")
inSurface = "sample.gdb/featuredataset/terrain"
obstructionFCs = "buildings.shp; billboards.shp"
surfRad = "1000 meters"
surfElev = "100 meters"
LOD = "FULL_DETAIL"
fromAzim = 0
toAzim = 360
incAzim = 1
maxHorizRad = 0
segSky = "SEGMENT_SKYLINE"
scale = 100
scaleAcc = "ELEVATION"
scaleMethod = "SKYLINE_MAXIMUM"
# Execute Skyline
arcpy.Skyline_3d(inPts, outFC, inSurface, surfRad, surfElev,
obstructionFCs, LOD, fromAzim, toAzim, incAzim,
maxHorizRad, segSky, scale, scaleAcc, scaleMethod)
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?