Couloir de moindre coût (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule la somme de deux rasters de distance de coût cumulée avec l’option d’application d’un seuil basé sur un pourcentage ou un coût cumulé.

En savoir plus sur la connexion des emplacements avec des couloirs

Utilisation

  • Les rasters en entrée doivent être des rasters d’accumulation de distance et de direction arrière générés par les outils Accumulation de distance et Allocation de distance.

  • Utilisez la version de coût des rasters d’accumulation de distance. Les unités des rasters peuvent être, mais sans s’y limiter, des dollars par mètre, une préférence par pied ou des minutes par mètre en fonction de l’application. Ces unités de coût sont capturées dans la surface de coût. Pour plus d’informations, reportez-vous à la rubrique Ajuster la distance rencontrée à l’aide d’une surface de coût.

  • Les couloirs sont non directionnels, ce qui signifie que le déplacement de la première source vers la deuxième a le même coût que le déplacement de la deuxième source vers la première. Lors de la création des rasters de distance de coût cumulé et de direction arrière, n’indiquez pas de valeurs pour les paramètres subordonnés à la directionnalité, à savoir le facteur horizontal, le facteur vertical et le sens de déplacement.

  • Utilisez les mêmes paramètres pour l’outil Accumulation de distance ou Allocation de distance lors de la création des rasters de distance de coût cumulé et de direction arrière de la première source que pour ceux de la deuxième source.

  • Tous les rasters en entrée doivent être de type virgule flottante et doivent avoir les mêmes taille de cellule, étendue et référence spatiale.

  • Les valeurs du couloir en sortie représentent la somme du coût cumulé pour atteindre un emplacement donné avec les mêmes unités que les rasters de distance de coût cumulé en entrée.

  • Si une valeur de seuil définie est supérieure au coût cumulé maximal lorsque les deux rasters d’accumulation de distance sont additionnés, le raster de couloir en sortie couvre la même surface que les rasters de coût cumulé en entrée.

  • Si une valeur de seuil définie est inférieure à la valeur minimale pour le raster de couloir, un message d’avertissement est affiché, et le raster en sortie est vide.

  • Il est possible que le raster de couloir en sortie contienne des cellules avec des coûts cumulés légèrement supérieurs à la valeur de seuil. C’est le cas lorsque les rasters de direction arrière utilisent des cellules auxquelles des coûts quelque peu supérieurs au seuil ont été attribués pour connecter les cellules déconnectées au couloir. Pour plus d’informations, reportez-vous à la rubrique Connecter des emplacements par des couloirs.

  • Pour générer un couloir, le paramètre d’environnement Cell Size (Taille de cellule) est ignoré et la taille de cellule des rasters de coût cumulé en entrée est utilisée pour calculer le raster en sortie. Vous risquez de modifier la configuration des rasters en entrée si vous changez la résolution de la sortie.

  • Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

  • 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 de distance de coût cumulé en entrée 1

Raster en entrée représentant la distance de coût cumulé de la première source.

Utilisez la sortie d’accumulation de distance de l’outil Accumulation de distance ou Allocation de distance.

Raster Layer
Raster de direction arrière en entrée 1

Raster de direction arrière en entrée de la première source. Les unités sont des degrés qui identifient la cellule suivante sur le chemin de moindre coût de retour vers la première source.

Utilisez la sortie de direction arrière de l’outil Accumulation de distance ou Allocation de distance. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé aux cellules sources. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Raster Layer
Raster de distance de coût cumulé en entrée 2

Raster en entrée représentant la distance de coût cumulé de la deuxième source.

Utilisez la sortie d’accumulation de distance de l’outil Accumulation de distance ou Allocation de distance.

Raster Layer
Raster de direction arrière en entrée 2

Raster de direction arrière en entrée de la seconde source. Les unités sont des degrés qui identifient la cellule suivante sur le chemin de moindre coût de retour vers la deuxième source.

Utilisez la sortie de direction arrière de l’outil Accumulation de distance ou Allocation de distance. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé aux cellules sources. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Raster Layer
Méthode de seuil

Indique le mode de définition du seuil.

  • Aucun seuilAucun seuil n’est appliqué et le couloir généré couvre l’étendue entière des rasters en entrée. Il s’agit de l’option par défaut.
  • Pourcentage de moindre coûtLe seuil est exprimé en un pourcentage de la valeur minimale des rasters de distance de coût cumulé additionnés.
  • Coût cumuléLe seuil est exprimé en unités de distance de coût cumulé.
String
Seuil

Pourcentage ou seuil de coût cumulé qui détermine l’inclusion d’une cellule donnée dans le raster de couloir en sortie.

Lorsque le paramètre Threshold method (Méthode de seuil) est défini sur Percent of Least Cost (Pourcentage de moindre coût), la valeur définie indique le pourcentage de hausse à appliquer à partir de la valeur minimale des rasters de distance de coût cumulé additionnés. Lorsque le paramètre Threshold method (Méthode de seuil) est défini sur Accumulative Cost (Coût cumulé), la valeur indique les cellules dont la somme du coût cumulé est inférieure ou égale à la valeur à inclure dans le couloir.

Ce paramètre est actif uniquement lorsque le paramètre Threshold method (Méthode de seuil) est défini sur Percent of Least Cost (Pourcentage de moindre coût) ou Accumulative Cost (Coût cumulé).

Double

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster de couloir en sortie contenant des cellules dont les valeurs sont inférieures au seuil dans les unités de distance de coût cumulé.

Le raster en sortie est de type virgule flottante.

Raster

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)
NomExplicationType de données
in_accumulative_cost_distance_raster1

Raster en entrée représentant la distance de coût cumulé de la première source.

Utilisez la sortie d’accumulation de distance de l’outil Accumulation de distance ou Allocation de distance.

Raster Layer
in_back_direction_raster1

Raster de direction arrière en entrée de la première source. Les unités sont des degrés qui identifient la cellule suivante sur le chemin de moindre coût de retour vers la première source.

Utilisez la sortie de direction arrière de l’outil Accumulation de distance ou Allocation de distance. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé aux cellules sources. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Raster Layer
in_accumulative_cost_distance_raster2

Raster en entrée représentant la distance de coût cumulé de la deuxième source.

Utilisez la sortie d’accumulation de distance de l’outil Accumulation de distance ou Allocation de distance.

Raster Layer
in_back_direction_raster2

Raster de direction arrière en entrée de la seconde source. Les unités sont des degrés qui identifient la cellule suivante sur le chemin de moindre coût de retour vers la deuxième source.

Utilisez la sortie de direction arrière de l’outil Accumulation de distance ou Allocation de distance. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé aux cellules sources. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Raster Layer
threshold_method

Indique le mode de définition du seuil.

  • NO_THRESHOLDAucun seuil n’est appliqué et le couloir généré couvre l’étendue entière des rasters en entrée. Il s’agit de l’option par défaut.
  • PERCENT_OF_LEAST_COSTLe seuil est exprimé en un pourcentage de la valeur minimale des rasters de distance de coût cumulé additionnés.
  • ACCUMULATIVE_COSTLe seuil est exprimé en unités de distance de coût cumulé.
String
threshold

Pourcentage ou seuil de coût cumulé qui détermine l’inclusion d’une cellule donnée dans le raster de couloir en sortie.

Lorsque le paramètre threshold_method est défini sur PERCENT_OF_LEAST_COST, la valeur définie indique le pourcentage de hausse à appliquer à partir de la valeur minimale des rasters de distance de coût cumulé additionnés. Lorsque le paramètre threshold_method est défini sur ACCUMULATIVE_COST, la valeur indique les cellules dont la somme du coût cumulé est inférieure ou égale à la valeur à inclure dans le couloir.

Ce paramètre n’est actif que si le paramètre threshold_method est défini sur PERCENT_OF_LEAST_COST ou ACCUMULATIVE_COST.

Double

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de couloir en sortie contenant des cellules dont les valeurs sont inférieures au seuil dans les unités de distance de coût cumulé.

Le raster en sortie est de type virgule flottante.

Raster

Exemple de code

Exemple de couloir de moindre coût 1 (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction LeastCostCorridor.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data"
out_LCC_raster = LeastCostCorridor("DistAccumRaster1.tif", "BackDirRaster1.tif",
                                   "DistAccumRaster2.tif", "BackDirRaster2.tif") 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")
Exemple de couloir de moindre coût 2 (script autonome)

Calculer un couloir entre deux zones.

# Name: LeastCostCorridor_Ex_02.py
# Description: Calculates a potential wildlife corridor between two known 
#               protected areas.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

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

# Set local variables
in_accumulative_cost_distance_raster1 = "distaccum_s1.tif"
in_back_direction_raster1 = "backdir_s1.tif"
in_accumulative_cost_distance_raster2 = "distaccum_s2.tif"
in_back_direction_raster2 = "backdir_s2.tif"
threshold_method = "ACCUMULATIVE_COST" 
threshold = 500

# Run Least Cost Corridor
out_LCC_raster = LeastCostCorridor(
    in_accumulative_cost_distance_raster1, in_back_direction_raster1, 
    in_accumulative_cost_distance_raster2, in_back_direction_raster2, 
    "ACCUMULATIVE_COST", "500")

# Save the output 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes