Topo vers raster - fichier (3D Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Synthèse

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ètreDéfinitionSyntaxe

    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
  • Pour les formats de données prenant en charge les valeurs nulles, par exemple les classes d’entités d’une géodatabase fichier, une valeur nulle est ignorée si elle est utilisée en entrée.

  • 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

Paramètres

ÉtiquetteExplicationType de données
Fichier de paramètres en entrée

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
Raster de surface en sortie

Raster de surface interpolé en sortie.

Il s'agit toujours d'un raster à virgule flottante.

Raster Dataset
Entités polylignes d'écoulement en sortie
(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
Entités ponctuelles de cuvettes résiduelles en sortie
(Facultatif)

Classe d'entités en sortie des entités ponctuelles de cuvettes résiduelles.

Feature Class
Entités ponctuelles résiduelles en sortie
(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
Entités ponctuelles d’erreurs de flux et d’escarpement en sortie
(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
Entités ponctuelles d'erreurs d'isoligne en sortie
(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

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})
NomExplicationType 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"

# Execute TopoToRasterByFile
arcpy.ddd.TopoToRasterByFile(inParameterFile, outRaster)

Rubriques connexes