Créer un MNT (Outils 3D Analyst)

Résumé

Crée un jeu de données de MNT.

Utilisation

La valeur du paramètre Average Point Spacing (Espacement moyen des points) doit refléter une approximation valable des données qui seront utilisées dans le MNT, car elle servira à définir la taille des tuiles internes du MNT qui sont utilisées pour optimiser l’analyse des données et les performances d’affichage. Chaque tuile est censée ne pas contenir plus de 200 000 points d’élévation de source. Si les données ont été rassemblées à des densités considérablement différentes d’une localisation à une autre, la valeur spécifiée doit favoriser le plus petit espacement.
Une fois l’outil exécuté, utilisez l’outil Add Terrain Pyramid Level (Ajouter un niveau de pyramide au MNT) pour spécifier la définition de pyramide, l’outil Add Feature Class To Terrain (Ajouter une classe d’entités au MNT) pour référencer les sources de données qui participent à la surface, et l’outil Build Terrain (Générer un MNT) (dans l’ordre) pour achever la construction du MNT.

Etiqueter	Explication	Type de données
Jeu de classes d’entités en entrée	Jeu de classes d’entités qui contiendra le jeu de données de MNT.	Feature Dataset
MNT en sortie	Nom du jeu de données de MNT.	String
Espacement moyen des points	Distance horizontale moyenne entre les points de données utilisés pour la modélisation du MNT. Les mesures reposant sur des capteurs, telles que les relevés photogrammétriques, de radar optique (LIDAR) et sonar, possèdent généralement un espacement connu qui doit être utilisé. Utilisez les unités horizontales du système de coordonnées du jeu de classes d’entités pour l’espacement.	Double
Taille maximale de l’aperçu (Facultatif)	La vue d’ensemble du MNT ressemble au concept de miniature d’image. Il s’agit de la représentation la plus grossière du jeu de données de MNT. La taille maximale représente la limite supérieure du nombre de points de mesure pouvant être échantillonnés pour créer la vue d’ensemble.	Long
Mot-clé de configuration (Facultatif)	Mot-clé de configuration permettant d’optimiser le stockage du MNT dans une base de données d’entreprise.	String
Type de pyramide (Facultatif)	Spécifie la méthode d’affinage de points utilisée pour construire les erreurs systématiques. Window Size—Data points in the area defined by a given window size for each pyramid level will be selected using the Window Size Method parameter value. This is the default. Z Tolerance—The vertical accuracy of each pyramid level relative to the full resolution of the data points will be specified.	String
Méthode de la taille de fenêtre (Facultatif)	Indique comment les points de la surface définie par la taille de fenêtre seront sélectionnés. Ce paramètre s’applique uniquement lorsque le filtre Window Size (Taille de fenêtre) est spécifié dans le paramètre Pyramid Type (Type de pyramide). Minimum Z—The point with the smallest elevation value will be selected. This is the default. Maximum Z—The point with the largest elevation value will be selected. Closest To Mean Z—The point with the elevation value closest to the average of all values will be selected. Minimum and Maximum Z—The points with the smallest and largest elevation values will be selected.	String
Méthode d’affinage secondaire (Facultatif)	Spécifie l’affinage supplémentaire qui sera appliqué pour réduire le nombre de points utilisés sur des surfaces planes lorsque les pyramides de taille de fenêtre sont utilisées. Une surface est considérée comme plane si les hauteurs des points de cette surface sont conformes à la valeur du paramètre Secondary Thinning Threshold (Seuil d’affinage secondaire). Ses répercussions sont plus notables à des niveaux de pyramide de résolution plus élevée, car les petites surfaces ont plus de chances d'être planes que les grandes. None—No secondary thinning will be performed. This is the default. Mild—Mild thinning will be performed to preserve linear discontinuities (for example, building sides and forest boundaries). This method is recommended for lidar that includes both ground and nonground points. It will thin the fewest points. Moderate—Moderate thinning will be performed, which provides a balance between performance and accuracy. This method does not preserve as much detail as mild thinning but comes close while eliminating more points overall. Strong—Strong thinning will be performed, which removes the most points but is less likely to preserve sharply delineated features. Limit its use to surfaces where slope tends to change gradually. For example, strong thinning is efficient for bare-earth lidar and bathymetry.	String
Seuil d’affinage secondaire (Facultatif)	Le seuil vertical utilisé pour activer l’affinage secondaire lorsque le paramètre Pyramid Type (Type de pyramide) est défini sur Window Size (Taille de fenêtre). La valeur doit être supérieure ou égale à la précision verticale des données.	Double
Méthode de triangulation (Facultatif)	Indique si les entités de lignes de fracture seront intégrées dans la surface du MNT en densifiant leurs segments conformément aux règles de triangulation de Delaunay afin de construire une surface TIN. La triangulation de Delaunay va densifier les entités de lignes de fracture pour accueillir les points qui les entourent de façon à éviter la création de longs triangles fin qui occasionnent généralement des résultats indésirables lors de l’analyse d’une surface TIN. En outre, l’interpolation des voisins naturels et la génération des polygones de Thiessen (Voronoi) peuvent uniquement s’effectuer sur des triangulations de Delaunay conformes. Une triangulation de Delaunay sous contraintes évite la densification des entités de lignes de fracture, en intégrant les segments de lignes de fracture sous forme de tronçons dans la surface TIN. Envisagez cette option lorsque vous devez explicitement définir certains tronçons dont vous êtes certain qu’ils ne seront pas modifiés (c’est-à-dire fractionnés en plusieurs tronçons) par le triangulateur. Delaunay—Breaklines will be densified to construct Delaunay triangles that accommodate the points surrounding them. This is the default. Constrained Delaunay—Breaklines will not be densified.	String

Sortie dérivée

Etiqueter	Explication	Type de données
MNT en sortie	Nouveau jeu de données de MNT.	Terrain

arcpy.3d.CreateTerrain(in_feature_dataset, out_terrain_name, average_point_spacing, {max_overview_size}, {config_keyword}, {pyramid_type}, {windowsize_method}, {secondary_thinning_method}, {secondary_thinning_threshold}, {triangulation_method})

Nom	Explication	Type de données
in_feature_dataset	Jeu de classes d’entités qui contiendra le jeu de données de MNT.	Feature Dataset
out_terrain_name	Nom du jeu de données de MNT.	String
average_point_spacing	Distance horizontale moyenne entre les points de données utilisés pour la modélisation du MNT. Les mesures reposant sur des capteurs, telles que les relevés photogrammétriques, de radar optique (LIDAR) et sonar, possèdent généralement un espacement connu qui doit être utilisé. Utilisez les unités horizontales du système de coordonnées du jeu de classes d’entités pour l’espacement.	Double
max_overview_size (Facultatif)	La vue d’ensemble du MNT ressemble au concept de miniature d’image. Il s’agit de la représentation la plus grossière du jeu de données de MNT. La taille maximale représente la limite supérieure du nombre de points de mesure pouvant être échantillonnés pour créer la vue d’ensemble.	Long
config_keyword (Facultatif)	Mot-clé de configuration permettant d’optimiser le stockage du MNT dans une base de données d’entreprise.	String
pyramid_type (Facultatif)	Spécifie la méthode d’affinage de points utilisée pour construire les erreurs systématiques. `WINDOWSIZE`—Data points in the area defined by a given window size for each pyramid level will be selected using the `windowsize_method` parameter value. This is the default. `ZTOLERANCE`—The vertical accuracy of each pyramid level relative to the full resolution of the data points will be specified.	String
windowsize_method (Facultatif)	Indique comment les points de la surface définie par la taille de fenêtre seront sélectionnés. Ce paramètre s’applique uniquement lorsque `WINDOWSIZE` est spécifié dans le paramètre `pyramid_type`. `ZMIN`—The point with the smallest elevation value will be selected. This is the default. `ZMAX`—The point with the largest elevation value will be selected. `ZMEAN`—The point with the elevation value closest to the average of all values will be selected. `ZMINMAX`—The points with the smallest and largest elevation values will be selected.	String
secondary_thinning_method (Facultatif)	Spécifie l’affinage supplémentaire qui sera appliqué pour réduire le nombre de points utilisés sur des surfaces planes lorsque les pyramides de taille de fenêtre sont utilisées. Une surface est considérée comme plane si les hauteurs des points de cette surface sont conformes à la valeur du paramètre `secondary_thinning_threshold`. Ses répercussions sont plus notables à des niveaux de pyramide de résolution plus élevée, car les petites surfaces ont plus de chances d'être planes que les grandes. `NONE`—No secondary thinning will be performed. This is the default. `MILD`—Mild thinning will be performed to preserve linear discontinuities (for example, building sides and forest boundaries). This method is recommended for lidar that includes both ground and nonground points. It will thin the fewest points. `MODERATE`—Moderate thinning will be performed, which provides a balance between performance and accuracy. This method does not preserve as much detail as mild thinning but comes close while eliminating more points overall. `STRONG`—Strong thinning will be performed, which removes the most points but is less likely to preserve sharply delineated features. Limit its use to surfaces where slope tends to change gradually. For example, strong thinning is efficient for bare-earth lidar and bathymetry.	String
secondary_thinning_threshold (Facultatif)	Le seuil vertical utilisé pour activer l’affinage secondaire lorsque le paramètre `pyramid_type` est défini sur `WINDOWSIZE`. La valeur doit être supérieure ou égale à la précision verticale des données.	Double
triangulation_method (Facultatif)	Indique si les entités de lignes de fracture seront intégrées dans la surface du MNT en densifiant leurs segments conformément aux règles de triangulation de Delaunay afin de construire une surface TIN. La triangulation de Delaunay va densifier les entités de lignes de fracture pour accueillir les points qui les entourent de façon à éviter la création de longs triangles fin qui occasionnent généralement des résultats indésirables lors de l’analyse d’une surface TIN. En outre, l’interpolation des voisins naturels et la génération des polygones de Thiessen (Voronoi) peuvent uniquement s’effectuer sur des triangulations de Delaunay conformes. Une triangulation de Delaunay sous contraintes évite la densification des entités de lignes de fracture, en intégrant les segments de lignes de fracture sous forme de tronçons dans la surface TIN. Envisagez cette option lorsque vous devez explicitement définir certains tronçons dont vous êtes certain qu’ils ne seront pas modifiés (c’est-à-dire fractionnés en plusieurs tronçons) par le triangulateur. `DELAUNAY`—Breaklines will be densified to construct Delaunay triangles that accommodate the points surrounding them. This is the default. `CONSTRAINED_DELAUNAY`—Breaklines will not be densified.	String

Sortie dérivée

Nom	Explication	Type de données
derived_out_terrain	Nouveau jeu de données de MNT.	Terrain

Exemple de code

Exemple 1 d’utilisation de la fonction CreateTerrain (fenêtre Python)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.CreateTerrain('source.gdb/Redlands', 'Redlands_terrain',  5,
                      50000, '', 'WINDOWSIZE', 'ZMIN', 'NONE', 1)

Exemple 2 d’utilisation de la fonction CreateTerrain (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, Mot-clé CONFIG en sortie

Informations de licence

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

Créer un MNT (Outils 3D Analyst)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes