Volume de contour minimum (3D Analyst)

Résumé

Crée des entités multipatch représentant le volume d'espace occupé par un jeu d'entités 3D.

Illustration

Utilisation

• Les méthodes Sphere (Sphère) ou Envelope (Enveloppe) (geometry_type="SPHERE" ou geometry_type = "ENVELOPE" dans Python) offre une représentation rapide du volume d’espace occupé par un jeu d’entités 3D.

• L’option Convex hull (Enveloppe convexe) (geometry_type="CONVEX_HULL" dans Python) offre un niveau de détails plus élevé que la méthode Sphere (Sphère) ou Envelope (Enveloppe) mais ne permet pas de capturer les dépressions locales dans les entités en entrée.

• L’option Concave hull (Enveloppe concave) (geometry_type="CONCAVE_HULL" dans Python) fournit un niveau de détails plus élevé en ce qui concerne la forme du volume de contour mais sollicite de nombreuses ressources de calcul et ne doit pas être utilisée pour des ensembles importants de données en entrée.

• Lorsque le volume de contour minimum obtenu représente des groupes d’entités en entrée, les champs utilisés pour séparer l’entrée seront ajoutés au multipatch final. Si les caractéristiques géométriques sont incluses dans le volume de contour minimum, les champs suivants seront ajoutés aux entités en sortie :

  • MBV_Area : superficie totale du volume de contour minimum
  • MBV_Volume : volume total de l’espace que contient l’entité multipatch

Syntaxe

MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})

Paramètre	Explication	Type de données
in_features	Jeu de données LAS ou entités 3D dont le volume de contour minimum sera évalué.	LAS Dataset Layer; Feature Layer
z_value	Source des valeurs z pour les données en entrée.	Field
out_feature_class	Classe d'entités qui va être produite par cet outil.	Feature Class
geometry_type (Facultatif)	Spécifié la méthode utilisée pour déterminer la géométrie du volume de contour minimum. CONVEX_HULL —Région convexe la plus petite entourant les données en entrée. SPHERE —Plus petite sphère délimitant les données en entrée. ENVELOPE —Étendue XYZ des données en entrée. CONCAVE_HULL —Enveloppe concave qui délimite les données en entrée.	String
group (Facultatif)	Spécifie le mode de regroupement des entités en entrée ; chaque groupe sera délimité par un multipatch en sortie. NONE —Les entités en entrée ne seront pas groupées. Il s’agit de l'option par défaut. Cette option n'est pas disponible pour le point en entrée. ALL —Toutes les entités en entrée seront traitées comme un groupe. LIST —Les entités en entrée seront groupées en fonction de leurs valeurs communes dans le champ spécifié ou des champs du paramètre champ de groupe.	String
group_field [group_field,...] (Facultatif)	Champ(s) dans les entités en entrée qui sera/seront utilisé(s) pour grouper des entités lorsque LIST est spécifié en tant que group_option. Au moins un champ de groupe est obligatoire pour l'option LIST. Toutes les entités qui ont la même valeur dans le ou les champs spécifiés seront traités comme un groupe.	Field
mbv_fields (Facultatif)	Indique si les attributs géométriques sont ajoutés à la classe d’entités multipatch en sortie. NO_MBV_FIELDS —Aucun attribut géométrique n’est ajouté à l’entité en sortie. Il s’agit de l’option par défaut. MBV_FIELDS —Les attributs géométriques sont ajoutés à l’entité en sortie.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil MinimumBoundingVolume (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

arcpy.env.workspace = 'C:/data'
arcpy.ddd.MinimumBoundingVolume('tree_canopy.shp', 'Shape.Z', 
                                'canopy_volume.shp', 'CONCAVE_HULL',
                                group='List', group_field='Season'
                                mbv_fields='MBV_FIELDS')

Exemple 2 d'utilisation de l'outil MinimumBoundingVolume (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
Name: Detect Periods of Activity
Description: 
****************************************************************************'''
# Import system modules
import arcpy
import tempfile
import math

in_features = arcpy.GetParameterAsText(0)
out_volume = arcpy.GetParameterAsText(1)
grouping_field = arcpy.GetParameterAsText(2)


try:
    arcpy.MinimumBoundingVolume_3d(in_features, 'Shape.Z', out_volume, 
                                   'CONCAVE_HULL','LIST', group_field)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Environnements

Espace de travail courant, Etendue, Système de coordonnées en sortie, Transformations géographiques

Informations de licence

• Basic: Requiert 3D Analyst
• Standard: Requiert 3D Analyst
• Advanced: Requiert 3D Analyst