Haut

Horizon (3D Analyst)

Dans cette rubrique

  1. Synthèse
  2. Illustration
  3. Utilisation
  4. Paramètres
  5. Environnements
  6. Informations de licence

Synthèse

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.

En savoir plus sur le fonctionnement de l'outil Horizon

Illustration

Horizon

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).

Paramètres

Boîte de dialoguePython

ÉtiquetteExplicationType de données
Entités ponctuelles d’observation en entrée

Points 3D représentant les points d'observation. Chaque entité aura sa propre sortie.

Feature Layer
Classe d'entités en sortie

Entités 3D qui seront des lignes représentant l'horizon ou des multipatchs représentant les silhouettes.

Feature Class
Surface en entrée
(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 Rayon de surface virtuelle et Altitude de surface virtuelle.

LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer
Rayon de surface virtuelle
(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 :

  • Inconnu—Inconnu
  • Pouces—Pouces
  • Pieds—Pieds
  • Yards—Yards
  • Milles—Milles
  • Millimètres—Millimètres
  • Centimètres—Centimètres
  • Décimètres—Décimètres
  • Mètres—Mètres
  • Kilomètres—Kilomètres
Linear Unit
Altitude de surface virtuelle
(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 :

  • Inconnu—Inconnu
  • Pouces—Pouces
  • Pieds—Pieds
  • Yards—Yards
  • Milles—Milles
  • Millimètres—Millimètres
  • Centimètres—Centimètres
  • Décimètres—Décimètres
  • Mètres—Mètres
  • Kilomètres—Kilomètres
Linear Unit
Entités en entrée
(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
Niveau de détail de l'entité
(Facultatif)

Niveau de détail auquel chaque entité doit être examinée dans l'analyse d'horizon.

  • Détails complets—Chaque tronçon de l'entité est pris en compte dans l'analyse d'horizon (uniquement les limites des triangles et les boucles extérieures sont pris en compte). Cette opération, qui demande beaucoup de temps, est la plus précise et est également l'option par défaut.
  • Emprise convexe—L'analyse d'horizon utilise le périmètre supérieur de l'enveloppe convexe de l'emprise de chaque entité extrudée à l'altitude du plus haut sommet dans l'entité.
  • Enveloppe— L'analyse d'horizon utilise le périmètre de l'enveloppe de l'entité en 3 dimensions. Il s'agit de la technique la plus rapide.
String
Azimut de départ
(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
Azimut de destination
(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
Intervalle azimut
(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
Rayon de l'horizon maximal
(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 :

  • Inconnu—Inconnu
  • Pouces—Pouces
  • Pieds—Pieds
  • Yards—Yards
  • Milles—Milles
  • Millimètres—Millimètres
  • Centimètres—Centimètres
  • Décimètres—Décimètres
  • Mètres—Mètres
  • Kilomètres—Kilomètres
Linear Unit
Segmenter la ligne d'horizon
(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 aucun ou désactivé.

  • Désactivé : chaque entité de la ligne d'horizon représentera un point d'observation. Il s’agit de l’option par défaut.
  • Activé : la ligne d'horizon de chaque point d'observation sera segmentée par les éléments uniques qui constituent la ligne d'horizon.
Boolean
Pourcentage de mise à l'échelle
(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
Mettre à l'échelle en fonction de
(Facultatif)

Valeurs d'après lesquelles la mise à l'échelle doit être déterminée.

  • Angle vertical depuis le point d'observation—La mise à l'échelle est effectuée en prenant en compte l'angle vertical de chaque sommet par rapport au point d'observation. Il s’agit de l’option par défaut.
  • Altitude—La mise à l'échelle est effectuée en prenant en compte l'altitude de chaque sommet par rapport au point d'observation.
String
Méthode de mise à l'échelle
(Facultatif)

Sommet à utiliser pour effectuer le calcul.

  • Ligne d'horizon maximum—Les sommets seront mis à l'échelle par rapport à l'angle vertical (ou à l'altitude) du sommet ayant l'angle vertical le plus élevé (ou l'altitude la plus élevée). Il s’agit de l’option par défaut.
  • Chaque sommet—Les sommets seront mis à l'échelle par rapport à l'angle vertical original (ou à l'altitude originale) de chaque sommet.
String
Utiliser la courbure
(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.

  • 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 sera appliquée lors de la génération d'une crête à partir d'une surface fonctionnelle.

  • 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)

Coefficient de réfraction à utiliser si la réfraction atmosphérique est prise en compte. 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 par cet outil. La valeur par défaut est 0 (ou résolution maximale).

Double
Créer des silhouettes
(Facultatif)

Indique si les entités en sortie représenteront des lignes d'horizon ou des silhouettes.

  • Désactivé : la sortie sera créée en tant qu'entités polylinéaires représentant la ligne d'horizon. Il s’agit de l’option par défaut.
  • Activé : la sortie sera créée en tant qu'entités multipatch représentant les silhouettes.
Boolean

arcpy.ddd.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})
NomExplicationType 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 :

  • UNKNOWN—Inconnu
  • INCHES—Pouces
  • FEET—Pieds
  • YARDS—Yards
  • MILES—Milles
  • MILLIMETERS—Millimètres
  • CENTIMETERS—Centimètres
  • DECIMETERS—Décimètres
  • METERS—Mètres
  • KILOMETERS—Kilomètres
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 :

  • UNKNOWN—Inconnu
  • INCHES—Pouces
  • FEET—Pieds
  • YARDS—Yards
  • MILES—Milles
  • MILLIMETERS—Millimètres
  • CENTIMETERS—Centimètres
  • DECIMETERS—Décimètres
  • METERS—Mètres
  • KILOMETERS—Kilomètres
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.

  • FULL_DETAIL—Chaque tronçon de l'entité est pris en compte dans l'analyse d'horizon (uniquement les limites des triangles et les boucles extérieures sont pris en compte). Cette opération, qui demande beaucoup de temps, est la plus précise et est également l'option par défaut.
  • CONVEX_FOOTPRINT—L'analyse d'horizon utilise le périmètre supérieur de l'enveloppe convexe de l'emprise de chaque entité extrudée à l'altitude du plus haut sommet dans l'entité.
  • ENVELOPE— L'analyse d'horizon utilise le périmètre de l'enveloppe de l'entité en 3 dimensions. Il s'agit de la technique la plus rapide.
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 :

  • UNKNOWN—Inconnu
  • INCHES—Pouces
  • FEET—Pieds
  • YARDS—Yards
  • MILES—Milles
  • MILLIMETERS—Millimètres
  • CENTIMETERS—Centimètres
  • DECIMETERS—Décimètres
  • METERS—Mètres
  • KILOMETERS—Kilomètres
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

  • NO_SEGMENT_SKYLINE—Chaque entité de la ligne d'horizon représentera un point d'observation. Il s’agit de l’option par défaut.
  • SEGMENT_SKYLINE—La ligne d'horizon de chaque point d'observation sera segmentée par les éléments uniques qui constituent la ligne d'horizon.
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.

  • VERTICAL_ANGLE—La mise à l'échelle est effectuée en prenant en compte l'angle vertical de chaque sommet par rapport au point d'observation. Il s’agit de l’option par défaut.
  • ELEVATION—La mise à l'échelle est effectuée en prenant en compte l'altitude de chaque sommet par rapport au point d'observation.
String
scale_method
(Facultatif)

Sommet à utiliser pour effectuer le calcul.

  • SKYLINE_MAXIMUM—Les sommets seront mis à l'échelle par rapport à l'angle vertical (ou à l'altitude) du sommet ayant l'angle vertical le plus élevé (ou l'altitude la plus élevée). Il s’agit de l’option par défaut.
  • EACH_VERTEX—Les sommets seront mis à l'échelle par rapport à l'angle vertical original (ou à l'altitude originale) de chaque sommet.
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.

  • CURVATURE—La courbure de la Terre est prise en compte.
  • NO_CURVATURE—La 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 sera appliquée lors de la génération d'une crête à partir d'une surface fonctionnelle.

  • NO_REFRACTION— La réfraction atmosphérique n'est pas prise en compte. Il s’agit de l’option par défaut.
  • REFRACTION—La réfraction atmosphérique est prise en compte.
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.

  • NO_CREATE_SILHOUETTES—Les entités polylignes obtenues représentent l'horizon. Il s’agit de l’option par défaut.
  • CREATE_SILHOUETTES—Les entités multipatch obtenues représentent des silhouettes.
Boolean

Exemple de code

1er exemple d'utilisation de l'outil Skyline (fenêtre Python)

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")
2e exemple d'utilisation de l'outil Skyline (script autonome)

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

Espace de travail courant, 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, Utilisation de la mémoire de terrain

Cas particuliers

Informations de licence

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

Rubriques connexes

  • Vue d'ensemble du jeu d'outils Visibilité
  • Rechercher un outil de géotraitement
  • Analyser la visibilité

Vous avez un commentaire à formuler concernant cette rubrique ?

Dans cette rubrique
  1. Synthèse
  2. Illustration
  3. Utilisation
  4. Paramètres
  5. Environnements
  6. Informations de licence