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 neuf types d'entrée : isolignes, points, cuvettes, cours d'eau, lacs, limites, falaises, exclusion et polygones côtiers. 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> Falaise
Jeu de données linéaires des falaises. Il n'y a pas d'option de champ pour ce paramètre.
Cliff <chemin> Exclusion
Jeu de données surfaciques d'exclusion des zones dans lesquelles les données en entrée doivent être ignorées. Il n'y a pas d'option de champ pour ce paramètre.
Exclusion <chemin> Côte
Jeu de données de polygones côtiers contenant le contour d'une zone côtière. Il n'y a pas d'option de champ pour ce paramètre.
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 <#> Pénalité de rugosité de la courbure longitudinale
La pénalité de rugosité de la courbure longitudinale est une pénalité adaptative applicable localement qui peut être utilisée pour remplacer partiellement la courbure totale.
PROFILE_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> Entités ponctuelles résiduelles en sortie
Classe d'entités ponctuelles en sortie de toutes les valeurs résiduelles d'altitude élevées telles que mises à l'échelle par l'erreur de discrétisation locale.
OUT_RESIDUALS Entités ponctuelles d'écoulement et de falaise en sortie
Classe d'entités ponctuelles en sortie des emplacements où peuvent se produire des erreurs de cours d'eau et de falaise.
OUT_STREAM_CLIFF_ERRORS Entités ponctuelles d'erreur isolignes en sortie
Classe d'entités ponctuelles en sortie des erreurs possibles concernant les données d'isolignes en entrée.
OUT_CONTOUR_ERRORS -
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 Cliff D:\data\cliffs.shp ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.0 PROFILE_PENALTY 0.5 DISCRETE_ERROR_FACTOR 1.0 VERTICAL_STANDARD_ERROR 0.0 TOLERANCES 2.5 100.0 ZLIMITS -2000.0 13000.0 EXTENT -810480.625 8321785.0 810480.625 10140379.0 CELL_SIZE 1800.00000000000 MARGIN 20 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. Les entités polylignes sont codées comme suit :
| Feature Class |
out_sink_features (Facultatif) |
Classe d'entités en sortie des entités ponctuelles de cuvettes résiduelles. | Feature Class |
out_residual_feature (Facultatif) |
Classe d'entités ponctuelles en sortie de toutes les valeurs résiduelles d'altitude élevées telles que mises à l'échelle par l'erreur de discrétisation locale. Vous devez examiner toutes les valeurs résiduelles supérieures à 10 à la recherche d'éventuelles erreurs dans les données de cours d'eau et d'altitude en entrée. Les valeurs résiduelles élevées mises à l'échelle indiquent des conflits entre les données d'altitude et les données linéaires de cours d'eau en entrée. Cela peut également être dû à de mauvaises drainages automatiques. Pour résoudre ces conflits, commencez par rechercher des erreurs dans les données en entrée et, le cas échéant, corrigez-les, puis ajoutez des données linéaires de cours d'eau et/ou d'altitude de point. Les valeurs résiduelles élevées non mises à l'échelle signalent généralement des erreurs d'altitude en entrée. | Feature Class |
out_stream_cliff_error_feature (Facultatif) |
Classe d'entités ponctuelles en sortie des emplacements où peuvent se produire des erreurs de cours d'eau et de falaise. Il est possible d'identifier dans la classe d'entités ponctuelles les emplacements où les cours d'eau présentent des boucles fermées, les effluents et les cours d'eau au-dessus de falaises. Les falaises dont les cellules voisines sont incohérentes avec les côtés haut et bas de la falaise sont également identifiées. Cela permet d'identifier avec précision les falaises dont la direction est incorrecte. Les points sont codés comme suit :
| Feature Class |
out_contour_error_feature (Facultatif) |
Classe d'entités ponctuelles en sortie des erreurs possibles concernant les données d'isolignes en entrée. Les isolignes présentant une hauteur incorrecte cinq fois supérieure à l'écart type des valeurs d'isolignes représentées dans le raster en sortie sont signalées dans cette classe d'entités. Les isolignes qui rejoignent d'autres isolignes dont l'altitude est différente sont signalées dans cette classe d'entités par le code 1. Cela indique clairement une erreur d'étiquette d'isoligne. | 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", "#",
"C:/sapyexamples/output/out_resids.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, "#", "C:/sapyexamples/output/out_resids2.shp")
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")