Topo vers raster - fichier (3D Analyst)

Niveau de licence :De baseStandardAvancé

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.

Pour en savoir plus sur la fonction Topo vers raster

Utilisation

Syntaxe

TopoToRasterByFile_3d (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ètreExplicationType 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.

Raster Layer
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, 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 :

  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)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic : Requis 3D Analyst ou ArcGIS Spatial Analyst
ArcGIS for Desktop Standard : Requis 3D Analyst ou ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced : Requis 3D Analyst ou ArcGIS Spatial Analyst
9/12/2013