Las herramientas que distinguen el entorno de Extensión solo procesarán las entidades o los rásteres que corresponden a 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 necesita procesar sólo 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. Tenga en cuenta que el rectángulo se utiliza sólo 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.
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
- Predeterminada: la herramienta que utiliza determina la extensión del procesamiento. Todas las herramientas tienen una extensión predeterminada que se calcula a partir de las entradas. Esta extensión predeterminada rara vez se documenta en la página de referencia de la herramienta pero generalmente es obvia. Por ejemplo, la herramienta Intersecar solo procesa las entidades que se intersecan entre sí, la herramienta Combinación procesa todas las entidades y la herramienta Recortar sólo procesa las entidades dentro de la extensión de las entidades recortadas.
- Combinación de entradas: la extensión combinada de todos los datos de entrada. Se procesarán todas las entidades o los rásteres.
- Intersección de entradas: la extensión en la que se superponen todas las entidades o los rásteres de entrada (se intersecan entre sí). Si ninguna de las entidades o celdas se solapa, podría generarse una extensión nula (ancho y altura de cero). Si este es el caso, no se procesa ninguna entidad.
- Extensión de visualización actual: se utilizará la extensión de la visualización actual. Por ejemplo, si se acerca a un área de estudio determinada, puede utilizar esta opción para procesar las entidades que corresponden a la extensión de la visualización actual.
- Como se especifica en la parte inferior: introduzca las coordenadas de los lados del rectángulo (izquierda, derecha, arriba y abajo).
- Examinar: busque un dataset. La extensión del dataset se utilizará para el entorno Extensión.
- Igual que la capa: se enumeran todas las capas del mapa activo, y puede elegir una como extensión.
Cuando se utiliza la opción Extensión de visualización actual, Como se especifica en la parte inferior o Igual que la capa, la extensión se lee y almacena. El entorno Extensión se muestra como Como se especifica en la parte inferior.
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ón | Explicació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í). Tenga en cuenta que es posible que no se superponga ninguna entidad y que se puede 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. |
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"