Cortar/Rellenar (Spatial Analyst)

Resumen

Calcula el cambio de volumen entre dos superficies. Se utiliza comúnmente para las operaciones de corte y relleno.

Más información sobre cómo funciona Cortar/Rellenar

Ilustración

Cut Fill illustration
OutRas = CutFill(Before_Ras, After_Ras)
Cut Fill fields illustration
When the Cut Fill operation is performed, by default, a specialized renderer is applied to the layer that highlights the locations of cut and of fill. The determinant is in the attribute table of the output raster, which considers positive volume to be where material was cut (removed), and negative volume where material was filled (added).

Uso

Sintaxis

CutFill (in_before_surface, in_after_surface, {z_factor})
ParámetroExplicaciónTipo de datos
in_before_surface

La entrada que representa la superficie antes de la operación de corte o relleno.

Raster Layer
in_after_surface

La entrada que representa la superficie después de la operación de corte o relleno.

Raster Layer
z_factor
(Opcional)

Cantidad de unidades x,y de suelo en una unidad z de superficie.

El factor z ajusta las unidades de medida para las unidades z cuando son diferentes de las unidades x, y de la superficie de entrada. Los valores z de la superficie de entrada se multiplican por el factor z al calcular la superficie de salida final.

Si las unidades z y las unidades x,y están en las mismas unidades de medida, el factor z es 1. Esta es la opción predeterminada.

Si las unidades z y las unidades x,y están en diferentes unidades de medida, el factor z se debe establecer en el factor adecuado o los resultados serán incorrectos. Por ejemplo, si las unidades z son pies y las unidades x, y son metros, debe utilizar un factor z de 0,3048 para convertir las unidades z de pies a metros (1 pie = 0,3048 metros).

Double

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida que define las regiones de corte y de relleno.

Los valores muestran las ubicaciones y las cantidades desde donde se ha agregado o quitado la superficie.

Raster

Ejemplo de código

Ejemplo 1 de Corte/relleno (ventana de Python)

En este ejemplo se calcula el volumen y el área de las ubicaciones de corte y relleno y se genera como resultado un ráster Grid.

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")
Ejemplo 2 de Corte/relleno (secuencia de comandos independiente)

En este ejemplo se calcula el volumen y el área de las ubicaciones de corte y relleno y se genera como resultado un ráster Grid.

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

Entornos

Temas relacionados

Información de licencia

ArcView: Requiere Spatial Analyst o 3D Analyst
ArcEditor: Requiere Spatial Analyst o 3D Analyst
ArcInfo: Requiere Spatial Analyst o 3D Analyst

7/11/2012