Cortar/Rellenar (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con una licencia de 3D 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

OutRas = CutFill(Before_Ras, After_Ras)

Cuando se realiza la operación Cortar/Rellenar, se aplica por defecto un renderizador especializado a la capa que resalta las ubicaciones de corte y de relleno. El determinante es la tabla de atributos del ráster de salida, que considera que el volumen positivo está donde se cortó (quitó) material y el volumen negativo está donde se rellenó (agregó) material.

Uso

• La herramienta Cortar/Rellenar le permite crear un mapa basado en dos superficies de entrada (antes y después) que muestre las áreas y los volúmenes de los materiales de superficie que se modificaron al quitar o agregar material de superficie.

• Ambas superficies del ráster de entrada deben ser coincidentes. Es decir, deben tener un origen común, la misma cantidad de filas y columnas de celdas y el mismo tamaño de celda.

• Para obtener resultados exactos, las unidades z deben ser las mismas que las unidades x,y de terreno. Esto garantiza que los volúmenes resultantes sean medidas cúbicas significativas (por ejemplo, metros cúbicos). Si no son las mismas, utilice un factor z para convertir las unidades z en unidades x,y. Por ejemplo, si las unidades x,y son metros y las unidades z son pies, podría especificar un factor z de 0,3048 para convertir los pies a metros.

  Como alternativa, utilice la herramienta matemática Multiplicación para crear un ráster de superficie en el que los valores z se hayan ajustado para coincidir con las unidades de terreno.

• La tabla de atributos del ráster de salida presenta los cambios en los volúmenes de superficie tras la operación de corte/relleno. Los valores positivos de la diferencia de volumen indican las regiones del ráster de superficie previo que fueron recortadas (se quitó material). Los valores negativos indican las áreas que fueron rellenadas (se agregó material). Consulte Cómo funciona Cortar/Rellenar para obtener más detalles sobre cómo se calculan los resultados.

• Cuando la operación de corte/relleno se realiza desde la herramienta, se aplica un renderizador especializado por defecto que resalta las ubicaciones de corte y de relleno. El renderizador dibuja las áreas que se cortaron en color azul y las áreas que se rellenaron en rojo. Las áreas que no se modificaron se visualizan en gris.

• Cuando el ráster de entrada se deba remuestrear, se utilizará la técnica bilineal. Un ejemplo en el que se debe remuestrear un ráster de entrada se produce cuando el sistema de coordenadas de salida, la extensión o el tamaño de celda es diferente del de entrada.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Superficie de ráster anterior de entrada	La entrada que representa la superficie antes de la operación de corte o relleno.	Raster Layer
Superficie de ráster después de entrada	La entrada que representa la superficie después de la operación de corte o relleno.	Raster Layer
Factor z (Opcional)	El número de unidades x, y de suelo en una superficie de unidades z. 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 x,y y las unidades z 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

Etiqueta	Explicación	Tipo de datos
Ráster de salida	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

Python

CutFill(in_before_surface, in_after_surface, {z_factor})

Nombre	Explicación	Tipo 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)	El número de unidades x, y de suelo en una superficie de unidades z. 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 x,y y las unidades z 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

Nombre	Explicación	Tipo 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

Muestra 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 de cuadrícula.

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 (script 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 de cuadrícula.

# 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

# Execute CutFill
outCutFill = CutFill(inBeforeRaster, inAfterRaster, zFactor)

# Save the output 
outCutFill.save("C:/sapyexamples/output/outcutfill02")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

• Basic: Requiere Spatial Analyst o 3D Analyst
• Standard: Requiere Spatial Analyst o 3D Analyst
• Advanced: Requiere Spatial Analyst o 3D Analyst