Extensión de salida (configuración del entorno)

Las herramientas que distinguen el entorno de Extensión solo procesarán las entidades o los rásteres que se encuentren dentro de la extensión especificada en esta configuración.

El entorno Extensión define qué entidades o rásteres se procesarán con una herramienta. Resulta útil cuando se está procesando solo una parte de un dataset más grande. Puede considerar a esta configuración como un rectángulo que se utiliza para seleccionar entidades y rásteres de entrada para el procesamiento. El rectángulo se utiliza solo para seleccionar entidades, no para recortarlas. La extensión del dataset de salida comúnmente será más grande que el entorno Extensión para representar las entidades o celdas que pasan por el rectángulo de extensión.

Se procesarán las entidades que pasan por la Extensión.

Notas de uso

  • Precaución:

    Se asume que la extensión introducida está en el sistema de coordenadas en el que se almacenan los datos de entrada, aun si se establece el entorno del Sistema de coordenadas de salida. Si la herramienta utiliza varios datasets de entrada, el primer dataset define el sistema de coordenadas de la extensión.

Sintaxis de cuadro de diálogo

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.
  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Intersección de entradas Intersección: la extensión se basará en la extensión mínima o en común de todas las entradas. Si ninguna de las entradas se solapa, podría generarse una extensión nula con todos los valores igual a cero.
  • Combinación de entradas Combinación: la extensión se basa en la extensión máxima o combinada de todas las entradas.
  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.

    Puede que el mapa esté utilizando unidades de visualización diferentes

Cuando se utiliza la opción Extensión de visualización actual, Extensión de un capa o Examinar, la extensión se lee y almacena.

Sintaxis de script

arcpy.env.extent = extent

Nota:

Cuando se establece la propiedad del entorno de la extensión, esta devuelve un objeto de Extent en Python.

extensiónExplicación

Objeto Extent

Se puede utilizar un objeto Extent para definir la extensión.

MINOF

La extensión donde se superponen todas las entidades o los rásteres de entrada (se intersecan entre sí). Es posible que no se superponga ninguna entidad y que se pueda generar una extensión nula (ancho y altura de cero). En estos casos, no se procesará ninguna entidad ni celda.

MAXOF

La extensión combinada de todos los datos de entrada. Se procesarán todas las entidades o las celdas.

"XMin, YMin, XMax, YMax"

Las coordenadas delimitadas por un espacio que definen la extensión, en el sistema de coordenadas en el que se almacenan los datos de entrada.

Nombre de la ruta

La ruta a un dataset. Se utilizará la extensión del dataset.

Sintaxis de extent

Ejemplo de script

import arcpy

# Set the extent environment using a keyword
arcpy.env.extent = "MAXOF"

# Set the extent environment using the Extent class
arcpy.env.extent = arcpy.Extent(-107.0, 38.0, -104.0, 40.0)

# Set the extent environment using a space-delimited string
arcpy.env.extent = "-107.0 38.0 -104.0 40.0"

# Set the extent environment using a feature class
arcpy.env.extent = "C:/data/StudyArea_perim.shp"

# Set the extent environment using a raster
arcpy.env.extent = "C:/data/StudyArea.tif"