Ajouter une classe d’entités au MNT (Outils 3D Analyst)

Résumé

Ajoute une ou plusieurs classes d’entités à un jeu de données de MNT.

Utilisation

Les entités en entrée doivent résider dans le même jeu de classes d’entités que le jeu de données de MNT.
Un ou plusieurs niveaux de pyramide doivent déjà être définis pour le jeu de données de MNT.
Selon le type de surface associé aux entités ajoutées à un MNT, le jeu de données de MNT peut nécessiter une reconstruction à l’aide de Build Terrain (Générer un MNT). La boîte de dialogue Properties (Propriétés) du jeu de données de MNT dans ArcCatalog et la boîte de dialogue Properties (Propriétés) de la couche de MNT dans ArcMap indiquent toutes deux si le jeu de données doit être recréé.
Envisagez d’activer l’option d’aperçu pour les entités surfaciques de types ligne de fracture et polygone uniquement si ces entités contiennent une géométrie simplifiée et sont visuellement pertinentes pour l’échelle d’affichage anticipée. Par exemple, les lignes de fracture peuvent ne pas être suffisamment visibles pour avoir un impact sur un affichage d’aperçu, tandis qu’un polygone de découpage serait utile. Si l’entité limite est détaillée, vous pouvez la généraliser et utiliser la représentation la plus grossière pour l’aperçu. La version détaillée doit être utilisée à des échelles d’affichage plus adaptées à la résolution de son niveau de détail.
Pour les jeux de données de MNT stockés dans une géodatabase d’entreprise :
- Le MNT cible ne peut pas être inscrit comme versionné.
- La classe d’entités en entrée ne peut pas être inscrite comme versionnée.

Etiqueter	Explication	Type de données
MNT en entrée	MNT auquel sont ajoutées les classes d’entités. Un ou plusieurs niveaux de pyramide doivent déjà être créés pour le jeu de données de MNT.	Terrain Layer
Classe d’entités en entrée	Identifie les entités ajoutées au MNT. Chaque entité doit se trouver dans le même jeu de classes d’entités que le MNT et son rôle doit être défini via les propriétés suivantes : Colonnes de la table de valeurs : Input Features—Name of the feature class being added to the terrain. Height Field—Field containing the feature's height information. Type—The way the input future contributes to the terrain surface. Mass Points—Points that are used for triangulation. Hard Line—Linear features that represent sharp discontinuities in elevation. Soft Line—Linear features that represent a gradual discontinuity in elevation. Hard Clip—Polygon feature that defines the interpolation zone with sharp discontinuities at the edges. Soft Clip—Polygon feature that defines the interpolation zone with gradual discontinuities at the edges. Hard Erase—Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Erase—Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Hard Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Hard Value Fill—Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Value Fill—Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Group—Defines the group of each contributing feature. Min Resolution—The lowest resolution that the surface feature will be enforced. Max Resolution—The highest resolution that the surface feature will be enforced. Overview—Indicates whether the feature is enforced at the coarsest representation of the terrain dataset. Embed—Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain. Embed Name—Name of the embedded feature class. Embed Fields—Specifies Blob field attributes to be retained in the embedded feature class. Anchor—Specifies whether the point feature class will be anchored through all terrain pyramid levels.	Value Table

Etiqueter

Explication

Type de données

MNT en entrée

MNT auquel sont ajoutées les classes d’entités. Un ou plusieurs niveaux de pyramide doivent déjà être créés pour le jeu de données de MNT.

Terrain Layer

Classe d’entités en entrée

Identifie les entités ajoutées au MNT. Chaque entité doit se trouver dans le même jeu de classes d’entités que le MNT et son rôle doit être défini via les propriétés suivantes :

Colonnes de la table de valeurs :

Input Features—Name of the feature class being added to the terrain.
Height Field—Field containing the feature's height information.
Type—The way the input future contributes to the terrain surface.
- Mass Points—Points that are used for triangulation.
- Hard Line—Linear features that represent sharp discontinuities in elevation.
- Soft Line—Linear features that represent a gradual discontinuity in elevation.
- Hard Clip—Polygon feature that defines the interpolation zone with sharp discontinuities at the edges.
- Soft Clip—Polygon feature that defines the interpolation zone with gradual discontinuities at the edges.
- Hard Erase—Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Erase—Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard Value Fill—Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Value Fill—Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
Group—Defines the group of each contributing feature.
Min Resolution—The lowest resolution that the surface feature will be enforced.
Max Resolution—The highest resolution that the surface feature will be enforced.
Overview—Indicates whether the feature is enforced at the coarsest representation of the terrain dataset.
Embed—Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain.
Embed Name—Name of the embedded feature class.
Embed Fields—Specifies Blob field attributes to be retained in the embedded feature class.
Anchor—Specifies whether the point feature class will be anchored through all terrain pyramid levels.

Value Table

Sortie dérivée

Etiqueter	Explication	Type de données
MNT en entrée mis à jour	MNT mis à jour.	Terrain Layer

arcpy.3d.AddFeatureClassToTerrain(in_terrain, in_features)

Nom Explication Type de données

Nom	Explication	Type de données
in_terrain	MNT auquel sont ajoutées les classes d’entités. Un ou plusieurs niveaux de pyramide doivent déjà être créés pour le jeu de données de MNT.	Terrain Layer
in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...]	Identifie les entités ajoutées au MNT. Chaque entité doit se trouver dans le même jeu de classes d’entités que le MNT et son rôle doit être défini via les propriétés suivantes : Colonnes de la table de valeurs : `Input Features`—Name of the feature class being added to the terrain. `Height Field`—Field containing the feature's height information. `Type`—The way the input future contributes to the terrain surface. `Mass_Points`—Points that are used for triangulation. `Hard_Line`—Linear features that represent sharp discontinuities in elevation. `Soft_Line`—Linear features that represent a gradual discontinuity in elevation. `Hard_Clip`—Polygon feature that defines the interpolation zone with sharp discontinuities at the edges. `Soft_Clip`—Polygon feature that defines the interpolation zone with gradual discontinuities at the edges. `Hard_Erase`—Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Soft_Erase`—Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Hard_Replace`—Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Soft_Replace`—Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Hardvalue_Fill`—Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Softvalue_Fill`—Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Group`—Defines the group of each contributing feature. `Min Resolution`—The lowest resolution that the surface feature will be enforced. `Max Resolution`—The highest resolution that the surface feature will be enforced. `Overview`—Indicates whether the feature is enforced at the coarsest representation of the terrain dataset. `Embed`—Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain. `Embed Name`—Name of the embedded feature class. `Embed Fields`—Specifies Blob field attributes to be retained in the embedded feature class. `Anchor`—Specifies whether the point feature class will be anchored through all terrain pyramid levels.	Value Table

in_terrain

MNT auquel sont ajoutées les classes d’entités. Un ou plusieurs niveaux de pyramide doivent déjà être créés pour le jeu de données de MNT.

Terrain Layer

in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...]

Identifie les entités ajoutées au MNT. Chaque entité doit se trouver dans le même jeu de classes d’entités que le MNT et son rôle doit être défini via les propriétés suivantes :

Colonnes de la table de valeurs :

Input Features—Name of the feature class being added to the terrain.
Height Field—Field containing the feature's height information.
Type—The way the input future contributes to the terrain surface.
- Mass_Points—Points that are used for triangulation.
- Hard_Line—Linear features that represent sharp discontinuities in elevation.
- Soft_Line—Linear features that represent a gradual discontinuity in elevation.
- Hard_Clip—Polygon feature that defines the interpolation zone with sharp discontinuities at the edges.
- Soft_Clip—Polygon feature that defines the interpolation zone with gradual discontinuities at the edges.
- Hard_Erase—Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft_Erase—Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard_Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft_Replace—Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hardvalue_Fill—Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Softvalue_Fill—Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
Group—Defines the group of each contributing feature.
Min Resolution—The lowest resolution that the surface feature will be enforced.
Max Resolution—The highest resolution that the surface feature will be enforced.
Overview—Indicates whether the feature is enforced at the coarsest representation of the terrain dataset.
Embed—Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain.
Embed Name—Name of the embedded feature class.
Embed Fields—Specifies Blob field attributes to be retained in the embedded feature class.
Anchor—Specifies whether the point feature class will be anchored through all terrain pyramid levels.

Value Table

Sortie dérivée

Nom	Explication	Type de données
derived_out_terrain	MNT mis à jour.	Terrain Layer

Exemple de code

Exemple 1 d’utilisation de AddFeatureClassToTerrain (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = "C:/data"
terrain_data = ["terrain.gdb/terrainFDS/points2", "SHAPE", "masspoints", 2, 0,
                10, "true", "false", "points_embed", "<None>", "false"]
arcpy.ddd.AddFeatureClassToTerrain("test.gdb/featuredataset/terrain", terrain_data)

Exemple 2 d’utilisation de AddFeatureClassToTerrain (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
             features extracted from a TIN. It is particularly useful in
             situations where the source data used in the TIN is not available,
             and the amount of data stored in the TIN proves to be too large
             for the TIN. The terrain's scalability will allow improved
             display performance and faster analysis. The script is designed
             to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy

# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain

try:
    # Create the file gdb that will store the feature dataset
    arcpy.management.CreateFileGDB(gdbLocation, gdbName)
    gdb = '{0}/{1}'.format(gdbLocation, gdbName)
    # Obtain spatial reference from TIN
    SR = arcpy.Describe(tin).spatialReference
    # Create the feature dataset that will store the terrain
    arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
    fd = '{0}/{1}'.format(gdb, fdName)
    # Export TIN elements to feature classes for terrain
    arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
    boundary = "{0}/boundary".format(fd)
    # Run TinDomain
    arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
    arcpy.AddMessage("Exporting TIN breaklines...")
    breaklines = "{0}/breaklines".format(fd)
    # Run TinLine
    arcpy.ddd.TinLine(tin, breaklines, "Code")
    arcpy.AddMessage("Exporting TIN nodes...")
    masspoints = "{0}/masspoints".format(fd)
    # Run TinNode
    arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
    arcpy.AddMessage("Creating terrain dataset...")
    terrain = "terrain_from_tin"
    # Run CreateTerrain
    arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
                            "WINDOWSIZE", "ZMEAN", "NONE", 1)
    arcpy.AddMessage("Adding terrain pyramid levels...")
    terrain = "{0}/{1}".format(fd, terrainName)
    pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
    # Run AddTerrainPyramidLevel
    arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
    arcpy.AddMessage("Adding features to terrain...")
    inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
             "false; {1} Shape masspoints 1 0 50 true false points_embed "\
             "<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
             "<None> false".format(boundary, masspoints, breaklines)
    # Run AddFeatureClassToTerrain
    arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
    arcpy.AddMessage("Building terrain...")
    # Run BuildTerrain
    arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
    arcpy.GetMessages()

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Environnements

Espace de travail courant, Validation automatique

Informations de licence

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

Ajouter une classe d’entités au MNT (Outils 3D Analyst)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes