Remblais/déblais (Spatial Analyst)
Récapitulatif
Calcule la modification du volume entre deux surfaces. Cet outil est généralement utilisé pour les opérations de remblai et de déblai.
Illustration
 |
OutRas = CutFill(Before_Ras, After_Ras) |
 |
Lorsque l'opération Remblais/déblais a lieu, une représentation spécialisée est appliquée par défaut à la couche qui met en surbrillance les emplacements de remblai et de déblai. Le déterminant se trouve dans la table attributaire du raster en sortie, qui considère qu'un volume est positif à l'endroit où des matériaux ont été retirés (déblai) et négatif lorsque des matériaux ont été ajoutés (remblai). |
Utilisation
-
Grâce à l'outil Remblais/déblais, vous pouvez créer une carte à partir de deux surfaces en entrée (avant et après) représentant les surfaces et les volumes modifiés par l'ajout ou la suppression de matériau surfacique.
-
Les deux surfaces de raster en entrée doivent coïncider. En d'autres termes, elles doivent avoir une origine commune, le même nombre de lignes et de colonnes de cellules, ainsi que la même taille de cellule.
-
Pour obtenir des résultats précis, les unités z doivent être identiques aux unités terrestres x,y. Il en résulte ainsi des volumes avec des mesures cubiques significatives (c.-à-d., mètres cubiques). Si les unités diffèrent, utilisez un facteur z pour convertir les unités z en unités x,y. Par exemple, si les unités x,y sont exprimées en mètres, et que l'unité z est exprimée en pieds, vous pouvez indiquer un facteur z égal à 0,3048 pour convertir les pieds en mètres.
Vous pouvez également utiliser l'outil mathématique Multiplication afin de créer un raster de surface dans lequel les valeurs z ont été ajustées pour correspondre aux unités terrestres.
-
La table attributaire du raster en sortie présente les modifications des volumes de surface consécutives à l'opération Remblais/déblais. Les différences de volume positives correspondent à des régions de la surface raster initiale déblayée (matériau supprimé). Les différences négatives correspondent aux zones remblayées (matériau ajouté). Pour plus d'informations sur le calcul des résultats, reportez-vous à la rubrique Pour en savoir plus sur la fonction Remblais/déblais.
-
Lorsque l'opération de remblais/déblais a lieu à l'aide de l'outil, une représentation spécialisée est appliquée par défaut afin de mettre en surbrillance les emplacements de remblai et de déblai. Les zones déblayées sont en bleu, les zones remblayées sont en rouge. Les zones inchangées sont en gris.
Syntaxe
| Paramètre | Explication | Type de données |
in_before_surface |
Entrée qui représente la surface avant l'opération de remblai/déblai. | Raster Layer |
in_after_surface |
Entrée qui représente la surface après l'opération de remblai/déblai. | Raster Layer |
z_factor (Facultatif) | Nombre d'unités x, y au sol dans une unité z de surface. Le facteur z ajuste les unités de mesure des unités z lorsqu'elles sont différentes des unités x,y de la surface en entrée. Les valeurs z de la surface en entrée sont multipliées par le facteur z lors du calcul de la surface finale en sortie. Si les unités x,y et les unités z utilisent les mêmes unités de mesure, le facteur z est égal à 1. Il s'agit de la valeur par défaut. Si les valeurs x,y et les valeurs z sont exprimées dans des unités de mesure différentes, le facteur z doit être défini comme approprié, sinon les résultats sont incorrects. Par exemple, si les unités z sont des pieds et les unités x,y sont des mètres, vous devez utiliser un facteur z égal à 0,3048 pour convertir les unités z de pieds en mètres (1 pied = 0,3048 mètre). | Double |
Valeur renvoyée
| Nom | Explication | Type de données |
| out_raster |
Raster en sortie définissant les régions de remblais/déblais. Ces valeurs montrent les emplacements et les quantités pour lesquels une surface a été ajoutée ou retirée. | Raster |
Exemple de code
Cet exemple calcule le volume et la surface des emplacements de remblais et déblais, et génère le résultat sous forme d'un raster de grille.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCutFill = CutFill("elevation01", "elevation02", 1)
outCutFill.save("C:/sapyexamples/output/outcutfill01")
Cet exemple calcule le volume et la surface des emplacements de remblais et déblais, et génère le résultat sous forme d'un raster de grille.
# Name: Cutfill_Ex_02.py
# Description: Calculates the volume and area of cut and
# fill locations.
# 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
inBeforeRaster = "elevation01"
inAfterRaster = "elevation02"
zFactor = 0.5
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CutFill
outCutFill = CutFill(inBeforeRaster, inAfterRaster, zFactor)
# Save the output
outCutFill.save("C:/sapyexamples/output/outcutfill02")