Topo vers raster - fichier (Spatial Analyst)
Récapitulatif
Interpole une surface raster hydrologiquement correcte à partir de données ponctuelles, linéaires et surfaciques en utilisant les paramètres définis dans un fichier.
Utilisation
-
Le fichier de paramètres est structuré tout d'abord avec les jeux de données en entrée répertoriés, puis avec les différents paramètres, puis avec les options en sortie.
Les données en entrée identifient les jeux de données en entrée et, le cas échéant, les champs. Il existe six types d'entrée : isolignes, points, cuvettes, cours d'eau, lacs et limites. Vous pouvez utiliser autant d'entrées que vous le souhaitez, dans la limite du raisonnable. L'ordre de saisie des entrées n'a aucune incidence sur le résultat. Le <chemin> correspond à un chemin d'accès vers un jeu de données, l'<élément> indique un nom de champ et le paramètre <#> indique une valeur à entrer.
Le tableau suivant répertorie tous les paramètres et donne la définition de chacun d'eux et leur syntaxe.
Paramètre
Définition
Syntaxe
Jeux de données en entrée : Isolignes
Jeu de données d'isolignes avec un élément contenant des valeurs de hauteur.
Isoligne <chemin> <élément> Points
Jeu de données ponctuelles avec un élément contenant des valeurs de hauteur.
Point <chemin> <élément> Cuvettes
Jeu de données ponctuelles qui contient des emplacements de cuvette. Si le jeu de données comporte des valeurs d'altitude pour les cuvettes, spécifiez ce nom de champ comme un <élément>. Si seuls les emplacements des cuvettes doivent être utilisés, définissez <élément> sur AUCUN.
Cuvette <chemin> <élément> Cours d'eau
Jeu de données linéaires de cours d'eau. Les valeurs de hauteur ne sont pas nécessaires.
Cours d'eau <chemin> Lacs
Jeu de données surfaciques de lac. Les valeurs de hauteur ne sont pas nécessaires.
Lac <chemin> Limite
Jeu de données surfaciques de la limite. Les valeurs de hauteur ne sont pas nécessaires.
Limite <chemin> Valeurs des paramètres :
Appliquer
Détermine si le drainage est appliqué.
ENFORCE <ON | OFF | ON_WITH_SINK> Type de données
Type principal de données en entrée.
DATATYPE <CONTOUR | SPOT> Itérations
Nombre maximal d'itérations exécutées par l'algorithme.
ITERATIONS <#> Pénalité de rugosité
Mesure la rugosité de la surface.
ROUGHNESS_PENALTY <#> Facteur d'erreur de discrétisation
Montant permettant d'ajuster le lissage des données en entrée dans un raster.
DISCRETE_ERROR_FACTOR <#> Erreur verticale standard
Quantité d'erreurs aléatoires dans les valeurs z des données en entrée.
VERTICAL_STANDARD_ERROR <#> Tolérance
La première reflète la précision des données d'altitude par rapport à l'écoulement sur la surface ; l'autre évite tout problème lié à des hauteurs d'interruptions inappropriées.
TOLERANCES <#> <#> Limites Z
Limites inférieure et supérieure de la hauteur.
ZLIMITS <#> <#> Etendue
Limites des coordonnées X minimum, Y minimum, X maximum et Y maximum.
EXTENT <#> <#> <#> <#> Taille de cellule
Résolution du raster en sortie final.
CELL_SIZE <#> Marge
Distance dans les cellules à interpoler au-delà de l'étendue et de la limite en sortie spécifiées.
MARGIN <#> Sorties :
Entités d'écoulement en sortie
Classe d'entités linéaires en sortie des entités polylignes d'écoulement et des entités linéaires de crête.
OUT_STREAM Entités cuvettes en sortie
Classe d'entités points en sortie des entités ponctuelles de cuvettes résiduelles.
OUT_SINK Fichier de diagnostic en sortie
Emplacement et nom du fichier de diagnostic.
OUT_DIAGNOSTICS <chemin> -
Ne spécifiez pas les chemins d'accès des jeux de données d'entité en sortie facultatifs dans le fichier de paramètres. Pour identifier ces sorties, utilisez les options Entités polylignes d'écoulement en sortie et Entités ponctuelles de cuvettes résiduelles en sortie de la boîte de dialogue de l'outil.
-
Un exemple de fichier de paramètres contient les éléments suivants :
Contour D:\data\contours2\arc HEIGHT Point D:\data\points2\point SPOTS Sink D:\data\sinks_200.shp Stream D:\data\streams\arc Lake D:\data\lakes\polygon Boundary D:\data\clipcov\polygon ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.00000000000 DISCRETE_ERROR_FACTOR 1.00000000000 VERTICAL_STANDARD_ERROR 0.00000000000 TOLERANCES 2.50000000000 100.00000000000 ZLIMITS -2000.00000000000 13000.00000000000 EXTENT -810480.62500000000 8321785.00000000000 810480.62500000000 10140379.00000000000 CELL_SIZE 1800.00000000000 MARGIN 20 OUT_STREAM OUT_SINK OUT_DIAGNOSTICS D:\data\ttr_diag.txt
Syntaxe
| Paramètre | Explication | Type de données |
in_parameter_file |
Fichier texte ASCII en entrée qui contient les entrées et paramètres à utiliser pour l'interpolation. Le fichier est généralement créé à partir d'une exécution précédente de l'outil Topo vers raster avec le fichier de paramètres en sortie facultatif spécifié. Pour tester le résultat du changement des paramètres, il est plus facile de mettre à jour ce fichier et de ré-exécuter l'interpolation plutôt que d'utiliser correctement l'outil Topo vers raster à chaque fois. | File |
out_stream_features (Facultatif) |
Classe d'entités en sortie des entités de type polyligne d'écoulement. | Feature Class |
out_sink_features (Facultatif) |
Classe d'entités en sortie des entités ponctuelles de cuvettes résiduelles. | Feature Class |
Valeur renvoyée
| Nom | Explication | Type de données |
| out_surface_raster |
Raster de surface interpolé en sortie. | Raster |
Exemple de code
Cet exemple crée un raster de surface TIFF hydrologiquement correct à partir d'un fichier de paramètres définissant les données ponctuelles, linéaires et surfaciques en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt",
"C:/sapyexamples/output/out_streams.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")
Cet exemple crée un raster de surface Grid hydrologiquement correct à partir d'un fichier de paramètres définissant les données ponctuelles, linéaires et surfaciques en entrée.
# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct
# surface from point, line, and polygon data using
# parameters specified in a file.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inParameterFile = "topotorasterbyfile.txt"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile)
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")