Écoulement vers entité (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Convertit un raster représentant un réseau linéaire en plusieurs entités représentant le réseau linéaire.

En savoir plus sur le fonctionnement de l’outil Écoulement vers entité

Utilisation

  • Le réseau linéaire raster d’écoulement en entrée doit être représenté sous forme de valeurs supérieures ou égales à un sur un arrière-plan de valeurs NoData.

  • Les résultats obtenus avec l'outil Accumulation de flux peuvent être utilisés pour créer un raster de réseau hydrographique en fixant un seuil pour sélectionner les cellules avec une accumulation de flux élevée. Par exemple, les cellules dans lesquelles plus de 100 cellules s'écoulent sont utilisées pour définir le réseau hydrographique. Utilisez l’outil Con ou SetNull pour créer un raster de réseau hydrographique dans lequel des valeurs d’accumulation de flux de 100 ou plus passent à 1, et le reste est mis à l’arrière-plan (NoData). Le réseau hydrographique obtenu peut être utilisé dans l'outil Liaison d'écoulement et Ecoulement vers entité.

  • Il doit exister des entités contigües de même valeur, comme les résultats de l’outil Ordre d’écoulement ou Liaison d’écoulement. L’outil Écoulement vers entité ne doit pas être utilisé sur un raster qui contient peu de cellules adjacentes de même valeur.

  • Les entités en sortie pointent en direction de l’aval.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

ÉtiquetteExplicationType de données
Raster d’écoulement en entrée

Raster en entrée représentant un réseau d'écoulement linéaire.

Raster Layer
Raster de direction de flux en entrée

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.

Raster Layer
Entités polylignes en sortie

Classe d’entités en sortie destinée à contenir les écoulements convertis.

Feature Class
Simplifier les polylignes
(Facultatif)

Indique si le rapprochement est utilisé.

  • Activé : l’entité est rapprochée pour réduire le nombre de sommets. L’algorithme de Douglas-Puecker pour la généralisation des lignes est utilisé avec une tolérance de sqrt(0.5) * cell size.
  • Désactivé : aucun rapprochement n’est appliqué.

Par défaut, le rapprochement est appliqué.

Boolean

StreamToFeature(in_stream_raster, in_flow_direction_raster, out_polyline_features, {simplify})
NomExplicationType de données
in_stream_raster

Raster en entrée représentant un réseau d'écoulement linéaire.

Raster Layer
in_flow_direction_raster

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.

Raster Layer
out_polyline_features

Classe d’entités en sortie destinée à contenir les écoulements convertis.

Feature Class
simplify
(Facultatif)

Indique si le rapprochement est utilisé.

  • SIMPLIFYL’entité est rapprochée pour réduire le nombre de sommets. L’algorithme de Douglas-Puecker pour la généralisation des lignes est utilisé avec une tolérance de sqrt(0.5) * cell size.
  • NO_SIMPLIFYAucun rapprochement n’est appliqué.

Par défaut, le rapprochement est appliqué.

Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction StreamToFeature (fenêtre Python)

Cet exemple convertit un raster représentant un réseau linéaire en entités.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
StreamToFeature("stream", "flowdir", "c:/sapyexamples/output/outstrm01.shp", 
                "NO_SIMPLIFY")
Exemple 2 d’utilisation de la fonction StreamToFeature (script autonome)

Cet exemple convertit un raster représentant un réseau linéaire en entités.

# Name: _Ex_02.py
# Description: 
# 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
inStreamRaster = "stream"
inFlowDir = "flowdir"
outStreamFeats = "c:/sapyexamples/output.gdb/outstrm02"


# Execute 
StreamToFeature(inStreamRaster, inFlowDir, outStreamFeats,
                 "NO_SIMPLIFY")

Rubriques connexes