Topo vers raster - fichier (3D Analyst)—ArcMap

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

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.

Pour en savoir plus sur la fonction Topo vers raster

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. <Path> indique un chemin d'accès à un jeu de données, <Item> indique un nom de champ et <#> indique une valeur à saisir.

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> <Elément>
Points	Jeu de données ponctuelles avec un élément contenant des valeurs de hauteur.	Point <Chemin> <Elé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 <Elément> sur AUCUN.	Cuvettes <Chemin> <Elément>
Cours d'eau	Jeu de données linéaires de cours d'eau. Les valeurs de hauteur ne sont pas nécessaires.	Ruisseau <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.	Falaise <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é des courbes du profil	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 <Path>
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'erreurs d'isoligne 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

arcpy.ddd.TopoToRasterByFile(in_parameter_file, out_surface_raster, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})

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_surface_raster	Raster de surface interpolé en sortie. Il s'agit toujours d'un raster à virgule flottante.	Raster Dataset
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 : 1. Ligne d'écoulement en entrée ne dépassant pas la falaise. 2. Ligne d'écoulement en entrée dépassant la falaise (cascade). 3. Application du drainage pour supprimer une cuvette fictive. 4. Ligne d'écoulement déterminée à partir de l'angle de l'isoligne. 5. Ligne de dorsale déterminée à partir de l'angle de l'isoligne. 6. Code inutilisé. 7. Data stream line side conditions. 8. Code inutilisé. 9. Ligne indiquant des marges élevées de données d'altitude.	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, des effluents et des 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 : 1. Circuit réel dans le réseau des données linéaires de cours d'eau des données. 2. Circuit dans le réseau de cours d'eau tel qu'il est codé dans le raster en sortie. 3. Circuit dans le réseau hydrographique via des lacs connectés. 4. Points des effluents. 5. Cours d'eau au-dessus d'une falaise (cascade). 6. Points indiquant plusieurs débordements de cours d'eau provenant de lacs. 7. Code inutilisé. 8. Points à proximité de falaises dont la hauteur ne correspond pas à la direction de la falaise. 9. Code inutilisé. 10. Effluent circulaire supprimé. 11. Effluent sans arrivée d'eau. 12. Effluent tramé de la cellule en sortie différent de l'endroit où commence l'effluent . 13. Erreur de traitement des conditions - indicateur de données de lignes d'écoulement très complexes.	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

Exemple de code

1er exemple de la commande TopoToRasterByFile (fenêtre Python)

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  
env.workspace = "C:/data"
arcpy.TopoToRasterByFile_3d("topotorasbyfile.txt", "c:/output/ttrbf_out.tif",
                            "c:/ouput/outstreams.shp", "#", "c:/ouput/outresid.shp")

2e exemple de la commande TopoToRasterByFile (script autonome)

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_3d_Ex_02.py
# Description: Interpolates a hydrologically correct surface from 
#    point, line, and polygon data using parameters specified in a file.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inParameterFile = "topotorasterbyfile.txt"
outRaster =  "C:/output/ttrbyfout02"
outResidFC = "C:/ouput/outresid.shp"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")

# Execute TopoToRasterByFile
arcpy.TopoToRasterByFile_3d(inParameterFile, outRaster, "#", "#", outResidFC)

Informations de licence

Basic: Requiert 3D Analyst ou Spatial Analyst
Standard: Requiert 3D Analyst ou Spatial Analyst
Advanced: Requiert 3D Analyst ou Spatial Analyst