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 de localisations à 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 ou Allocation de distance.

• Utilisez la version coût des rasters d’accumulation de distance. Les unités des rasters peuvent être, sans s’y limiter, des dollars par mètre, une préférence par pied ou des minutes par mètre, selon 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 ne sont pas directionnels. En d’autres termes, voyager de la première source vers la seconde source coûte autant que voyager de la seconde source vers la première. Lorsque vous créez des rasters de distance de coût cumulée et de direction arrière, ne spécifiez de valeurs pour aucun paramètre qui dépend de la direction, à 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 lorsque vous créez les rasters de distance de coût cumulée et de direction arrière de la première source, ainsi que ceux de la seconde source.

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

• Si une valeur de seuil spécifiée est supérieure au coût cumulé maximum 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 cumulés en entrée.

• Si une valeur de seuil spécifiée est inférieure à la valeur minimum dans le raster de couloir, un message d’avertissement s’affiche et le raster en sortie est vide.

• Le raster de couloir en sortie peut contenir des cellules ayant des coûts cumulés légèrement supérieurs à la valeur de seuil. Ceci est dans le cas des rasters de direction arrière utilisant des cellules attribuées à des coûts légèrement supérieurs au seuil pour connecter des cellules déconnectées au couloir. Pour plus d’informations, reportez-vous à la rubrique Connecter des emplacements à des couloirs.

• Pour générer un couloir, le paramètre d’environnement 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 d’altérer la configuration des rasters en entrée si vous modifiez la résolution.

• 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

Boîte de dialogue

Étiquette	Explication	Type de données
Raster de distance de coût cumulée en entrée 1	Le raster en entrée représentant la distance de coût cumulée à partir 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	Le raster de direction arrière en entrée de la première source. Les unités sont des degrés identifiant la cellule suivante sur le chemin de moindre coût 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ée en entrée 2	Le raster en entrée représentant la distance de coût cumulée à partir de la seconde 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	Le raster de direction arrière en entrée de la seconde source. Les unités sont des degrés identifiant la cellule suivante sur le chemin de moindre coût vers la seconde 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 seuil—Aucun seuil n’est appliqué et le couloir résultant couvre l’étendue entière des rasters en entrée. Il s’agit de l’option par défaut. Pourcentage de moindre coût—Le seuil est défini en tant que pourcentage de la valeur minimum des rasters de distance de coût cumulée additionnés. Coût cumulé—Le seuil est défini en unités de distance de coût cumulée.	String
Seuil	Un pourcentage ou un seuil de coût cumulé allant déterminer si une cellule donnée est incluse 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 spécifiée indique l’augmentation de pourcentage à appliquer à partir de la valeur minimum des rasters de distance de coût cumulée additionnés. Lorsque le paramètre Threshold method (Méthode de seuil) est défini sur Accumulative cost (Coût cumulé), la valeur indique que les cellules dont le coût cumulé additionné est égal ou inférieur à la valeur seront incluses dans le couloir. Ce paramètre n’est actif que si 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

Étiquette	Explication	Type de données
Raster en sortie	Le raster de couloir en sortie contenant une cellule avec des valeurs inférieures au seuil dans les unités de distance de coût cumulée. Le raster en sortie est de type virgule flottante.	Raster

Python

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)

Nom	Explication	Type de données
in_accumulative_cost_distance_raster1	Le raster en entrée représentant la distance de coût cumulée à partir 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	Le raster de direction arrière en entrée de la première source. Les unités sont des degrés identifiant la cellule suivante sur le chemin de moindre coût 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	Le raster en entrée représentant la distance de coût cumulée à partir de la seconde source. Utilisez la sortie d’accumulation de distance de l’outil Accumulation de distance ou Allocation de distance.	Raster Layer
in_back_direction_raster2	Le raster de direction arrière en entrée de la seconde source. Les unités sont des degrés identifiant la cellule suivante sur le chemin de moindre coût vers la seconde 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_THRESHOLD—Aucun seuil n’est appliqué et le couloir résultant couvre l’étendue entière des rasters en entrée. Il s’agit de l’option par défaut. PERCENT_OF_LEAST_COST—Le seuil est défini en tant que pourcentage de la valeur minimum des rasters de distance de coût cumulée additionnés. ACCUMULATIVE_COST—Le seuil est défini en unités de distance de coût cumulée.	String
threshold	Un pourcentage ou un seuil de coût cumulé allant déterminer si une cellule donnée est incluse dans le raster de couloir en sortie. Lorsque le paramètre threshold_method est défini sur PERCENT_OF_LEAST_COST, la valeur spécifiée indique l’augmentation de pourcentage à appliquer à partir de la valeur minimum des rasters de distance de coût cumulée additionnés. Lorsque le paramètre threshold_method est défini sur ACCUMULATIVE_COST, la valeur indique que les cellules dont le coût cumulé additionné est égal ou inférieur à la valeur seront incluses dans le couloir. Ce paramètre n’est actif que si le paramètre threshold_method a la valeur PERCENT_OF_LEAST_COST ou ACCUMULATIVE_COST.	Double

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Le raster de couloir en sortie contenant une cellule avec des valeurs inférieures au seuil dans les unités de distance de coût cumulée. Le raster en sortie est de type virgule flottante.	Raster

Exemple de code

Exemple d’utilisation de l’outil Couloir de moindre coût 1 (fenêtre Python)

Le script ci-dessous de la fenêtre Python illustre l’utilisation de l’outil Couloir de moindre coût.

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 d’utilisation de l’outil Couloir de moindre coût 2 (script autonome)

Calculer un couloir entre deux espaces.

# 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")

Environnements

Validation automatique, Compression, Espace de travail courant, Mot-clé CONFIG en sortie, Facteur de traitement parallèle, Espace de travail temporaire, Taille de tuile

Informations de licence

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