TIN vers raster (3D Analyst)

Synthèse

Interpole un raster à l’aide des valeurs z du TIN en entrée.

En savoir plus sur le fonctionnement de l’outil TIN vers raster

Illustration

Illustration de l’outil de création d’un raster à partir d’un TIN

Utilisation

  • L’interpolation de la surface de TIN en entrée survenant à intervalles réguliers, il est possible que certaines informations soient perdues dans le raster en sortie. L’exactitude de la représentation du TIN par le raster dépend de la résolution du raster et du degré et de l’intervalle de variation de la surface TIN. En règle générale, le raster en sortie représente mieux la surface TIN lorsque la résolution augmente. Le raster étant une structure de cellule, il ne peut par conséquent pas conserver les tronçons des lignes de fracture strictes et malléables susceptibles d'être présents dans le TIN.

  • Lors de l’exportation d’un grand raster, spécifiez la valeur du paramètre Type de données en sortie en tant qu’entier pour économiser de l’espace disque si les exigences en termes de précision des valeurs z peuvent être représentées par des données de type entier.

Paramètres

ÉtiquetteExplicationType de données
TIN en entrée

Jeu de données TIN qui sera traité.

TIN Layer
Raster en sortie

Nom et emplacement du raster en sortie. Pour stocker un jeu de données raster dans une géodatabase ou dans un dossier tel que Esri Grid, n’ajoutez pas d’extension de fichier au nom du jeu de données raster. Une extension de fichier peut être fournie afin de définir le format du raster lorsque vous le stockez dans un dossier, par exemple .tif pour générer un GeoTIFF ou .img pour générer un fichier au format ERDAS IMAGINE.

Si le raster est stocké dans un fichier .tif ou dans une géodatabase, la qualité et le type de compression raster peuvent être spécifiés à l'aide de paramètres d'environnement de géotraitement.

Raster Dataset
Type de données en sortie
(Facultatif)

Détermine le type de valeurs numériques qui seront stockées dans le raster en sortie.

  • Virgule flottanteLe raster en sortie utilisera la virgule flottante 32 bits, qui prend en charge les valeurs comprises entre -3,402823466e+38 et 3,402823466e+38. Il s’agit de l’option par défaut.
  • EntierLe raster en sortie utilisera une profondeur de bit d’entiers appropriée. Cette option arrondit les valeurs z au nombre entier le plus proche et écrit un entier dans chaque valeur de cellule raster.
String
Méthode
(Facultatif)

Méthode d'interpolation utilisée pour créer le raster.

  • LinéaireCalcule les valeurs des cellules en appliquant une interpolation linéaire aux triangles TIN. Il s’agit de l’option par défaut.
  • Voisins naturelsCalcule les valeurs des cellules en utilisant une interpolation par voisins naturels des triangles TIN.
String
Distance d'échantillonnage
(Facultatif)

Méthode d'échantillonnage et distance utilisées pour définir la taille des cellules du raster en sortie.

  • ObservationsDéfinit le nombre de cellules qui divisent le plus long côté du raster en sortie. Cette méthode est utilisée par défaut avec la valeur 250.
  • Taille de celluleDéfinit la taille des cellules du raster en sortie.
String
Facteur Z
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z dont l’unité linéaire est spécifiée.

Double
Valeur d'échantillonnage

Valeur qui correspond à la distance d’échantillonnage (option Sampling Distance) pour spécifier la taille de cellule du raster en sortie.

Double

arcpy.ddd.TinRaster(in_tin, out_raster, {data_type}, {method}, {sample_distance}, {z_factor}, sample_value)
NomExplicationType de données
in_tin

Jeu de données TIN qui sera traité.

TIN Layer
out_raster

Nom et emplacement du raster en sortie. Pour stocker un jeu de données raster dans une géodatabase ou dans un dossier tel que Esri Grid, n’ajoutez pas d’extension de fichier au nom du jeu de données raster. Une extension de fichier peut être fournie afin de définir le format du raster lorsque vous le stockez dans un dossier, par exemple .tif pour générer un GeoTIFF ou .img pour générer un fichier au format ERDAS IMAGINE.

Si le raster est stocké dans un fichier .tif ou dans une géodatabase, la qualité et le type de compression raster peuvent être spécifiés à l'aide de paramètres d'environnement de géotraitement.

Raster Dataset
data_type
(Facultatif)

Détermine le type de valeurs numériques qui seront stockées dans le raster en sortie.

  • FLOATLe raster en sortie utilisera la virgule flottante 32 bits, qui prend en charge les valeurs comprises entre -3,402823466e+38 et 3,402823466e+38. Il s’agit de l’option par défaut.
  • INTLe raster en sortie utilisera une profondeur de bit d’entiers appropriée. Cette option arrondit les valeurs z au nombre entier le plus proche et écrit un entier dans chaque valeur de cellule raster.
String
method
(Facultatif)

Méthode d'interpolation utilisée pour créer le raster.

  • LINEARCalcule les valeurs des cellules en appliquant une interpolation linéaire aux triangles TIN. Il s’agit de l’option par défaut.
  • NATURAL_NEIGHBORSCalcule les valeurs des cellules en utilisant une interpolation par voisins naturels des triangles TIN.
String
sample_distance
sampling_method distance
(Facultatif)

Méthode d'échantillonnage et distance utilisées pour définir la taille des cellules du raster en sortie.

  • OBSERVATIONSDéfinit le nombre de cellules qui divisent le plus long côté du raster en sortie. Cette méthode est utilisée par défaut avec la valeur 250.
  • CELLSIZEDéfinit la taille des cellules du raster en sortie.
String
z_factor
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z dont l’unité linéaire est spécifiée.

Double
sample_value

Valeur qui correspond à la distance d’échantillonnage (option Sampling Distance) pour spécifier la taille de cellule du raster en sortie.

Double

Exemple de code

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.TinRaster("tin", "raster.tif", data_type="INT", method="LINEAR", 
                    sample_distance="OBSERVATIONS 3500", z_factor=1)
2e exemple d'utilisation de l'outil TinRaster (script autonome)

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

'''******************************************************************
Name: TinRaster Example
Description: This script demonstrates how to use the 
             TinRaster tool to create rasters from 
             each TIN in the target workspace.
******************************************************************'''
# Import system modules
import arcpy

# Set environment setting
arcpy.env.workspace = "C:/data"

# Set Local Variables
dataType = "INT"
method = "NATURAL_NEIGHBORS"
sampling = "CELLSIZE 10"
zfactor = "1"

# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")

# Verify the presence of TINs in the list
if TINList:
    # Iterate through the list of TINs
    for dataset in TINList:
        # Define the name of the output file
        outRaster = "{0}_natural.img".format(dataset)
        # Execute TinRaster
        arcpy.ddd.TinRaster(dataset, outRaster, dataType, 
                            method, sampling, zfactor)
    print("Finished.")
else:
    print("There are no TIN(s) in {0}.".format(env.workspace))

Informations de licence

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

Rubriques connexes