ArcGIS for Desktop

  • Documentation
  • Tarification
  • Support

  • My Profile
  • Aide
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

La plateforme cartographique de votre organisation

ArcGIS for Desktop

Un SIG professionnel complet

ArcGIS for Server

SIG dans votre entreprise

ArcGIS for Developers

Outils de création d'applications de localisation

ArcGIS Solutions

Modèles d'applications et de cartes gratuits pour votre secteur d'activité

ArcGIS Marketplace

Téléchargez des applications et des données pour votre organisation.

  • Documentation
  • Tarification
  • Support
Esri
  • Se connecter
user
  • Mon profil
  • Déconnexion

Aide

  • Accueil
  • Commencer
  • Carte
  • Analyser
  • Gérer les données
  • Outils
  • Plus...

Distance de coût

Disponible avec une licence Spatial Analyst.

  • Récapitulatif
  • Illustration
  • Utilisation
  • Syntaxe
  • Exemple de code
  • Environnements
  • Informations de licence

Récapitulatif

Calcule pour chaque cellule la distance de plus faible coût cumulé vers la source la plus proche sur une surface de coût.

Pour en savoir plus sur le fonctionnement des outils de distance de coût

Illustration

Illustration de l'outil Distance de coût
Cost_Dist = CostDistance(Source_Ras, Cost_Ras)

Utilisation

  • Les données source en entrée peuvent être une classe d'entités ou un raster.

  • Lorsque les données source en entrée correspondent à un raster, l'ensemble des cellules source englobe toutes les cellules du raster source comprenant des valeurs valides. Les cellules associées à la valeur NoData ne figurent pas dans la source. La valeur 0 est considérée comme une source normale. Vous pouvez facilement créer un raster source à l'aide des outils d'extraction.

  • Lorsque les données source en entrée correspondent à une classe d'entités, les emplacements source sont convertis en interne en raster avant l'analyse. La résolution du raster peut être contrôlée à l'aide du paramètre d'environnement Taille de cellule. Par défaut, la résolution est définie sur la résolution du raster de coût en entrée.

  • Lorsque vous utilisez des données d'entité surfacique pour les données source en entrée, vous devez traiter la taille de cellule en sortie avec prudence si elle est grossière par rapport au détail dans l'entrée. Le processus de tramage interne utilise la même méthode par défaut Type d'attribution de cellule que l'outil Polygone vers raster, à savoir CELL_CENTER. Cela signifie que les données ne figurant pas au centre de la cellule ne seront pas incluses dans la sortie source tramée intermédiaire ; elles ne seront donc pas représentées dans les calculs de distance. Par exemple, si vos sources sont représentées par une série de petits polygones, tels que des emprises de bâtiments, dont la taille est petite par rapport à la taille de cellule en sortie, il se peut que quelques-uns d'entre eux seulement apparaissent aux centres des cellules raster en sortie et que, vraisemblablement, la plupart des autres polygones soient perdus et exclus de l'analyse.

    Pour éviter cette situation, vous pouvez entre-temps effectuer le tramage des entités en entrée directement avec l'outil Polygone vers raster et définir un champ Priorité, puis utiliser le résultat obtenu en entrée dans l'outil Distance. Vous pouvez également sélectionner une taille de cellule suffisamment petite pour capturer le nombre de détails approprié à partir des entités en entrée.

  • Lorsque l'entrée source est une entité, par défaut, le premier champ disponible valide est utilisé. Si aucun champ valide n'existe, le champ ObjectID (par exemple, OID ou FID, selon le type de l'entité entrée) est utilisé.

  • Les emplacements de cellule ayant la valeur NoData dans le raster de coût en entrée agissent comme des barrières dans les outils de surface de coût. Tout emplacement de cellule auquel la valeur NoData est attribuée sur la surface de coût en entrée recevra la valeur NoData sur tous les rasters en sortie (distance de coût, allocation et antécédence).

  • Si les données source en entrée et le raster de coût sont des étendues différentes, l'étendue en sortie par défaut correspond à l'intersection des deux. Pour obtenir une surface de distance de coût pour l'étendue entière, choisissez l'option Union des entrées sur les paramètres d'environnement Etendue en sortie.

  • Si un masque a été défini dans l'environnement, toutes les cellules masquées sont traitées en tant que valeurs NoData.

    Lorsqu'un masque a été défini dans la fenêtre Analyseur raster et que les cellules à masquer masqueront une source, les calculs surviendront sur les cellules source restantes. Les cellules source qui sont masquées ne seront pas prises en compte dans les calculs. Ces emplacements de cellule se verront attribuer la valeur NoData sur tous les rasters en sortie (distance, allocation et antécédence).

  • La distance maximale est spécifiée dans les mêmes unités de coût que celles sur le raster de coût.

  • Pour le raster de distance en sortie, la distance de plus faible coût (ou distance de coût cumulée minimale) d'une cellule à un ensemble d'emplacements source correspond à la limite inférieure des distances de plus faible coût de la cellule à tous les emplacements source.

  • Le raster de coût ne peut pas contenir de valeurs nulles, puisque l'algorithme est un processus multiplicatif. Si un raster contient des valeurs nulles et que ces valeurs représentent des superficies de plus faible coût, choisissez une petite valeur positive (par exemple, 0,01) avant d'utiliser l'outil Distance de coût. Commencez par utiliser l'outil Con. Si les surfaces dotées d'une valeur nulle représentent des surfaces à exclure de l'analyse, vous devez remplacer ces valeurs par la valeur NoData avant d'utiliser l'outil Distance de coût. Commencez par utiliser l'outil SetNull.

  • 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.

Syntaxe

CostDistance (in_source_data, in_cost_raster, {maximum_distance}, {out_backlink_raster})
ParamètreExplicationType de données
in_source_data

Emplacement des sources en entrée.

Un jeu de données raster ou un jeu de classes d'entités identifie les cellules ou les emplacements par rapport auxquels la distance de plus faible coût cumulé est calculée pour chaque emplacement de cellule en sortie.

Pour les rasters, le type d'entrée peut être entier ou à virgule flottante.

Raster Layer | Feature Layer
in_cost_raster

Raster définissant l'impédance ou le coût de déplacement planimétrique à travers chaque cellule.

La valeur à chaque emplacement de cellule représente le coût par unité de distance pour le déplacement à travers chaque cellule. Chaque valeur d'emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d'obtenir le coût total du passage à travers la cellule.

Les valeurs du raster de coût peuvent être des entiers ou valeurs à virgule flottante, mais elles ne peuvent pas être négatives ni nulles (un coût ne peut pas être négatif ou nul).

Raster Layer
maximum_distance
(Facultatif)

Définit le seuil que les valeurs de coût cumulé ne peuvent pas dépasser.

Si une valeur de distance de coût cumulé dépasse cette valeur, la valeur en sortie de l'emplacement de cellule est NoData. La distance maximale définit l'étendue pour laquelle les distances de coût cumulé sont calculées.

La distance par défaut va jusqu'à la bordure du raster en sortie.

Double
out_backlink_raster
(Facultatif)

Raster d'antécédence de coût en sortie.

Le raster d'antécédence contient des valeurs de 0 à 8 qui définissent la direction ou identifient la cellule voisine suivante (la cellule suivante) le long du chemin de plus faible coût cumulé à partir d'une cellule pour atteindre sa source de plus faible coût.

Si le chemin doit passer à l'intérieur du voisin de droite, la cellule se voit attribuer la valeur 1, 2 pour la cellule dans la diagonale inférieure droite et ainsi de suite dans le sens des aiguilles d'une montre. La valeur 0 est réservée aux cellules sources.

Positions d'antécédence
Raster Dataset

Valeur renvoyée

NomExplicationType de données
out_distance_raster

Raster de distance de coût en sortie.

Le raster de distance de coût identifie, pour chaque cellule, la distance du plus faible coût cumulé sur une surface de coût vers le(s) emplacement(s) source(s) identifié(s).

Une source peut être une cellule, un jeu de cellules voire un ou plusieurs emplacements d'entités.

Le raster en sortie est de type virgule flottante.

Raster

Exemple de code

Exemple d'utilisation de l'outil CostDistance (fenêtre Python)

Le script dans la fenêtre Python ci-après explique comment utiliser l'outil CostDistance.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCostDist = CostDistance("source.shp", "elevation", 200000, "backlink")
outCostDist.save("C:/sapyexamples/output/costdist")
Deuxième exemple d'utilisation de l'outil CostDistance (script autonome)

Calculez le raster de distance de plus faible coût cumulé à partir d'emplacements sources du fichier de formes.

# Name: CostDistance_Ex_02.py
# Description: Calculates for each cell the least accumulative cost distance
#    to the nearest source over a cost  surface. 
# 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
inSourceData = "source.shp"
inCostRaster = "elevation"
maxDistance = 20000000   
outBkLinkRaster = "C:/sapyexamples/output/outbklink"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute CostDistance
outCostDistance = CostDistance(inSourceData, inCostRaster, maxDistance, outBkLinkRaster)

# Save the output 
outCostDistance.save("C:/sapyexamples/output/outcostdist")

Environnements

  • Validation automatique
  • Taille de cellule
  • Compression
  • Espace de travail courant
  • Etendue
  • Transformations géographiques
  • Masque
  • Mot-clé CONFIG en sortie
  • Système de coordonnées en sortie
  • Statistiques raster
  • Espace de travail temporaire
  • Raster de capture
  • Taille de tuile

Informations de licence

  • ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
  • ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
  • ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst

Thèmes connexes

  • Vue d'ensemble du jeu d'outils Distance
  • Allocation de coût
  • Antécédence de coût
  • Présentation de l'analyse de la distance de coût
Vous avez un commentaire à formuler concernant cette rubrique ?

ArcGIS for Desktop

  • Accueil
  • Documentation
  • Tarification
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

A propos d'Esri

  • A propos de la société
  • Carrières
  • Blog des initiés
  • Conférence des utilisateurs
  • Sommet des développeurs
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Confidentialité | Légal