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) | 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 Tipo de unión 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 el Tipo de unió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. Consulte la información del parámetro Desviación máxima de desplazamiento que se incluye en la documentación de la herramienta Densificar para más información. | 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.
- 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 llamado 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 llamado 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.
Si se utiliza un campo de la entrada para obtener distancias de zona de influencia, los valores del campo pueden ser un número (5, por ejemplo) o un número con una unidad lineal válida (5 kilómetros, por ejemplo). Si el valor de campo es un número, se supone que la distancia está en la unidad lineal de la referencia espacial de la entrada (a menos que la entrada esté en un sistema de coordenadas geográficas, en cuyo caso se entiende que el valor está en metros). Si la unidad lineal especificada en los valores de campo no es válida o no se reconoce, se utilizará de manera predeterminada la unidad lineal de la referencia espacial de la entrada.
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. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta identifique 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:
La salida de esta herramienta está pensada solamente para su visualización cartográfica. No está pensada para utilizarla en análisis posteriores. Al utilizarlo como tal, se obtendrán resultados incorrectos.
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 deseada 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) | 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 en ángulo agudo y un line_joins de MITER se ha especificado, 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 line_joins de 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. Consulte la información del parámetro max_deviation que se incluye en la documentación de la herramienta Densificar para más información. | 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í