Volume de contour minimal (Outils 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

Volume de contour minimal

Utilisation

La méthode Sphere (Sphère) ou Envelope (Enveloppe) (geometry_type="SPHERE" ou geometry_type = "ENVELOPE" dans Python) fournit une représentation 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 plus de détails que la méthode Sphere (Sphère) ou Envelope (Enveloppe), mais elle ne capture pas les dépressions locales dans les entités en entrée.
L’option Concave hull (Enveloppe convexe) (geometry_type="CONCAVE_HULL" dans Python) fournit le plus de détails sur la forme du volume de contour, mais elle demande beaucoup de ressources de calcul et ne doit pas être utilisée avec des collections de données en entrée volumineuses.
Si le volume de contour minimal résultant représente des groupes d’entités en entrée, les champs utilisés pour séparer l’entrée sont ajoutés au multipatch résultant. Si les caractéristiques géométriques sont incluses dans le volume de contour minimal, les champs suivants sont ajoutés aux entités en sortie :
- MBV_Area—Superficie totale du volume de contour minimal
- MBV_Volume—Volume total de l’espace contenu par l’entité multipatch

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Jeu de données LAS ou entités 3D dont le volume de contour minimal est évalué.	LAS Dataset Layer; Feature Layer
Valeur Z	Source des valeurs z des données en entrée.	Field
Classe d’entités en sortie	Classe d’entités qui va être produite.	Feature Class
Type de classe d’entités en sortie (Facultatif)	Indique la méthode utilisée pour déterminer la géométrie du volume de contour minimal. Convex hull—The smallest convex region surrounding the input data. Sphere—The smallest sphere enclosing the input data. Envelope—The XYZ extent of the input data. Concave hull—The concave hull that encloses the input data.	String
Options de groupe (Facultatif)	Indique comment les entités en entrée seront groupées ; chaque groupe est délimité par une entité multipatch en sortie. None—Input features will not be grouped. This is the default. This option is not available for point input. All—All input features will be treated as one group. List—Input features will be grouped based on their common values in the specified field or fields in the group field parameter.	String
Grouper les champs (Facultatif)	Champ(s) dans les entités en entrée à utiliser pour regrouper des entités si l’option List (Liste) est spécifiée comme Group Option (Option de groupe). Au moins un champ de groupe est obligatoire pour l’option List (Liste). 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
Ajouter les caractéristiques géométriques sous forme d’attributs à la sortie (Facultatif)	Indique si les attributs géométriques sont ajoutés à la classe d’entités multipatch en sortie. Activé—Geometric attributes will be added to the output feature. Décoché—No geometric attributes will be added to the output feature. This is the default.	Boolean

arcpy.3d.MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})

Nom	Explication	Type de données
in_features	Jeu de données LAS ou entités 3D dont le volume de contour minimal est évalué.	LAS Dataset Layer; Feature Layer
z_value	Source des valeurs z des données en entrée.	Field
out_feature_class	Classe d’entités qui va être produite.	Feature Class
geometry_type (Facultatif)	Indique la méthode utilisée pour déterminer la géométrie du volume de contour minimal. `CONVEX_HULL`—The smallest convex region surrounding the input data. `SPHERE`—The smallest sphere enclosing the input data. `ENVELOPE`—The XYZ extent of the input data. `CONCAVE_HULL`—The concave hull that encloses the input data.	String
group (Facultatif)	Indique comment les entités en entrée seront groupées ; chaque groupe est délimité par une entité multipatch en sortie. `NONE`—Input features will not be grouped. This is the default. This option is not available for point input. `ALL`—All input features will be treated as one group. `LIST`—Input features will be grouped based on their common values in the specified field or fields in the group field parameter.	String
group_field [group_field,...] (Facultatif)	Champ(s) des entités en entrée à utiliser pour regrouper des entités si l’option `LIST` est spécifiée comme `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. `MBV_FIELDS`—Geometric attributes will be added to the output feature. `NO_MBV_FIELDS`—No geometric attributes will be added to the output feature. This is the default.	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 :

import arcpy
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.ddd.MinimumBoundingVolume(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: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst