| Etiqueta | Explicación | Tipo de datos |
Entidades de entrada |
Las entidades de punto, línea o polígono de entrada en las que se creará una zona de influencia. | Feature Layer |
Clase de entidad de salida |
La clase de entidad que contiene las áreas de influencia de salida. | Feature Class |
Distancia [valor o campo] |
La distancia alrededor de las entidades de entrada para la zona de influencia. Las distancias se pueden proporcionar como un valor que representa una distancia lineal o como un campo numérico de las entidades de entrada que contiene la distancia para la zona de influencia de cada entidad. Si las unidades lineales no se especifican o se escriben como Desconocido, se utilizará la unidad lineal de la referencia espacial de las entidades de entrada. | Linear Unit; Field |
Tipo de topes (Opcional) | Especifique el tipo de topes (extremos) de las entidades de entrada de los que se crearán zonas de influencia. Este parámetro solo es compatible con entidades poligonales y de puntos.
| String |
Tipo de unión (Opcional) | Especifica la forma de la zona de influencia en esquinas donde se unen dos segmentos. Este parámetro solo es compatible con entidades poligonales y de líneas.
| String |
Límite angular (Opcional) | En el punto donde los segmentos de línea se encuentran con un ángulo agudo y si se ha especificado el valor del parámetro Tipo de unión como Miter, este parámetro se puede utilizar para controlar cómo llegan a un punto las esquinas agudas en la salida de la zona de influencia. En algunos casos, el ángulo exterior en el que se unen dos líneas es muy grande al usar la opción Miter. Podría ocurrir que el punto de la esquina se extendiera más allá de lo previsto. | Double |
Desviación máxima de desplazamiento (Opcional) |
La distancia máxima que el límite del polígono de la zona de influencia de salida se desviará respecto al límite real e ideal de la zona de influencia. El límite real de la zona de influencia es una curva y el límite del polígono de salida es una polilínea densificada. Este parámetro permite controlar el grado de aproximación del límite del polígono de salida respecto al límite real de la zona de influencia. Si no se establece el parámetro o si se establece en 0, será la herramienta la que identifique la desviación máxima. Se recomienda utilizar el valor predeterminado. Una degradación de rendimiento, ya sea en la herramienta o en análisis posteriores, podría dar lugar a la utilización de un valor de desviación máxima de desplazamiento demasiado pequeño. | Linear Unit |
Resumen
Crea polígonos de zona de influencia alrededor de entidades de entrada a una distancia especificada. Hay varias formas cartográficas disponibles para los extremos de la zona de influencia (topes) y esquinas (uniones) cuando la zona de influencia se genera alrededor de la entidad.
Existen herramientas alternativas para operaciones de zona de influencia. Consulte la documentación de las herramientas Zona de influencia por pares y Zona de influencia para obtener más información.
Ilustración
Uso
Las entidades de entrada pueden ser de puntos, líneas o poligonales. Las opciones disponibles para los extremos de la salida de la zona de influencia (topes) y esquinas (uniones) dependen del tipo de entidad de entrada como sigue:
- Tipo de tope: solo puntos y líneas
- Tipo de unión: solo polígonos y líneas
La clase de entidad de salida incluirá un campo BUFF_DIST que contiene la distancia de zona de influencia utilizada para proteger cada entidad en la unidad lineal del sistema de coordenadas de las entidades de entrada.
Si ya existe un campo BUFF_DIST en la entrada, sus valores se sobrescribirán en la salida.
Las entidades de la zona de influencia de salida siempre serán euclidianas. Las entidades de la zona de influencia geodésica no son compatibles. Consulte Cómo funciona Zona de influencia (Análisis) para obtener información acerca de la diferencia entre zonas de influencia euclidianas y geodésicas.
La clase de entidad de salida incluirá un campo ORIG_FID que contiene el Id. de entidad de la entidad de entrada para la que se creó la zona de influencia. Si ya existe un campo ORIG_FID en la entrada, sus valores se sobrescribirán en la salida.
Cuando se crean zonas de influencia en entidades de polígono, las distancias de zona de influencia negativas se pueden utilizar para crear zonas de influencia dentro de las entidades de polígono. Si se utiliza una distancia de zona de influencia negativa se reducirán los límites del polígono a la distancia especificada.
Precaución:
Si la distancia de zona de influencia negativa es lo suficientemente grande para contraer el polígono a nada, se generará una geometría nula. Aparecerá un mensaje de advertencia y no se escribirá ninguna entidad de geometría nula en la clase de entidad de salida.
Puede utilizar un campo de la entrada para definir las distancias de zona de influencia. Se aceptan tanto campos numéricos como de texto. En un campo de texto, la distancia de la zona de influencia puede ser un número, como 5, o una unidad lineal válida, como 5 kilómetros.
Si se utiliza un número sin unidad lineal, la zona de influencia estará en las unidades lineales de la referencia espacial de la entrada. Si la entrada está en un sistema de coordenadas geográficas, la zona de influencia estará en metros.
Si no se reconoce la unidad lineal, la zona de influencia estará en las unidades lineales de la referencia espacial de la entrada. Para obtener más información sobre las unidades lineales válidas, consulte Unidades lineales.
Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Si el entorno se establece en 0, no se habilitará el procesamiento paralelo. Si se especifica un factor entre 1 y 99, la herramienta identificará el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.
Nota:
Cuando se utiliza la salida de una operación de zona de influencia para identificar entidades en un área determinada, las herramientas Zona de influencia por pares y Zona de influencia suelen ser las más adecuadas.
Parámetros
arcpy.analysis.GraphicBuffer(in_features, out_feature_class, buffer_distance_or_field, {line_caps}, {line_joins}, {miter_limit}, {max_deviation})| Nombre | Explicación | Tipo de datos |
in_features |
Las entidades de punto, línea o polígono de entrada en las que se creará una zona de influencia. | Feature Layer |
out_feature_class |
La clase de entidad que contiene las áreas de influencia de salida. | Feature Class |
buffer_distance_or_field |
La distancia alrededor de las entidades de entrada para la zona de influencia. Las distancias se pueden proporcionar como un valor que representa una distancia lineal o como un campo numérico de las entidades de entrada que contiene la distancia para la zona de influencia de cada entidad. Si las unidades lineales no se especifican o se escriben como Desconocido, se utilizará la unidad lineal de la referencia espacial de las entidades de entrada. Al especificar una distancia, si la unidad lineal tiene dos palabras, como Decimal Degrees, combine las dos palabras en una (por ejemplo, 20 DecimalDegrees). | Linear Unit; Field |
line_caps (Opcional) | Especifique el tipo de topes (extremos) de las entidades de entrada de los que se crearán zonas de influencia. Este parámetro solo es compatible con entidades poligonales y de puntos.
| String |
line_joins (Opcional) | Especifica la forma de la zona de influencia en esquinas donde se unen dos segmentos. Este parámetro solo es compatible con entidades poligonales y de líneas.
| String |
miter_limit (Opcional) | En el punto donde los segmentos de línea se encuentran con un ángulo agudo y el valor del parámetro line_joins se ha especificado como MITER, este parámetro se puede utilizar para controlar cómo llegan a un punto las esquinas agudas en la salida de la zona de influencia. En algunos casos, el ángulo exterior en el que se unen dos líneas es muy grande al usar la opción MITER. Podría ocurrir que el punto de la esquina se extendiera más allá de lo previsto. | Double |
max_deviation (Opcional) |
La distancia máxima que el límite del polígono de la zona de influencia de salida se desviará respecto al límite real e ideal de la zona de influencia. El límite real de la zona de influencia es una curva y el límite del polígono de salida es una polilínea densificada. Este parámetro permite controlar el grado de aproximación del límite del polígono de salida respecto al límite real de la zona de influencia. Si no se establece el parámetro o si se establece en 0, será la herramienta la que identifique la desviación máxima. Se recomienda utilizar el valor predeterminado. Una degradación de rendimiento, ya sea en la herramienta o en análisis posteriores, podría dar lugar a la utilización de un valor de desviación máxima de desplazamiento demasiado pequeño. | Linear Unit |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función GraphicBuffer.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.GraphicBuffer("roads", "C:/output/majorrdsBuffered", "100 Feet",
"SQUARE", "MITER")Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí