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.

Pour en savoir plus sur la fonction Remblais/déblais

Illustration

Illustration de l'outil Remblais/déblais
OutRas = CutFill(Before_Ras, After_Ras)
Illustration des champs Remblais/déblais
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

Syntaxe

CutFill (in_before_surface, in_after_surface, {z_factor})
ParamètreExplicationType 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

NomExplicationType 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

1er exemple d'utilisation de l'outil Remblais/déblais (fenêtre Python)

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")
2e exemple d'utilisation de l'outil Remblais/déblais (script autonome)

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

Environnements

Rubriques connexes

Informations de licence

ArcView : Obligatoire Spatial Analyst ou 3D Analyst
ArcEditor : Obligatoire Spatial Analyst ou 3D Analyst
ArcInfo : Obligatoire Spatial Analyst ou 3D Analyst

7/10/2012