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.

Notas de uso

• Las herramientas utilizan el sistema de coordenadas que figura en la sección plegable Sistema de coordenadas de extensión para interpretar la ubicación de las coordenadas de extensión; el sistema de coordenadas no se ve afectado por el entorno del sistema de coordenadas de salida.
• Las opciones Extensión de visualización actual , Extensión de dibujo y Extensión de una capa usan el sistema de coordenadas del mapa activo.
• Las opciones Examinar y Portapapeles utilizan el sistema de coordenadas pegado o del dataset.
• Las opciones Intersección de entradas y Unión de entradas determinan el sistema de coordenadas en el tiempo de ejecución de la herramienta y utilizan el sistema de coordenadas del primer dataset de entrada.
• Cuando se especifica una extensión sin un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del primer adataset de entrada que emplee una herramienta.

Sintaxis de cuadro de diálogo

• Extensión de visualización actual : 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 dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.

  Nota:

  Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

  Nota:

  Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

• Extensión de mapa : 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.

  Cada capa de mapas tiene las opciones siguientes:

  • Todas las entidades : extensión de todas las entidades en una capa.
  • Entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
  • Entidades visibles : extensión de las entidades visibles en la capa.

    Nota:

    Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades.

• Examinar : la extensión se basará en un dataset existente.
• Intersección de entradas : 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 : la extensión se basa en la extensión máxima o combinada de todas las entradas.
• Portapapeles : la extensión puede copiarse en y desde el portapapeles.
  • Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
  • Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.

  Nota:

  Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

• Restablecer extensión : 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.

  Precaución:

  El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Cuando se utiliza la opción Extensión de visualización actual , Extensión de dibujo , Extensión de una capa o Examinar , la extensión se lee y almacena en ese momento; la extensión nos e actualizará después si se realiza un cambio en el mapa, la capa o el dataset. Las opciones Intersección de entradas y Unión de entradas determinarán las coordenadas de la extensión y el sistema de coordenadas en tiempo de ejecución de la herramienta.

Sintaxis de script

arcpy.env.extent = extent

Nota:

Cuando se establece, la propiedad del entorno de extent devuelve un objeto de Extent en Python.

Sintaxis de extent

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í). 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.

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"