Dividir (Análisis)

Disponible con una licencia Advanced.

Resumen

Divide una entrada con entidades de superposición para crear un subconjunto de clases de entidad de salida.

Ilustración

Ilustración de la herramienta Dividir
Las entidades de entrada se dividen en cuatro clases de entidad de salida basándose en cuatro de las seis entidades divididas de superposición. Estas seis entidades divididas corresponden a seis valores únicos del campo de división.

Uso

  • Los valores únicos del parámetro Campo de división forman los nombres de las clases de entidad de salida. Se guardan en el espacio de trabajo de destino.

  • El dataset Entidades de división debe ser de polígonos.

  • El tipo de datos de Campo de División debe ser de carácter. Sus valores únicos forman los nombres de las clases de entidad de salida.

  • Los valores únicos del campo de división deben empezar por un carácter válido. Si el espacio de trabajo de destino es una geodatabase, los valores del campo deben empezar por una letra. Los valores del campo que comiencen por un número, como 350 grados, producirán un error. Sin embargo, los nombres de shapefile pueden comenzar por un número, y los espacios de trabajo objetivo de carpeta permiten que los valores de campo comiencen por un número.

  • El espacio de trabajo objetivo debe existir previamente.

  • El número total de clases de entidad de salida es igual al número de valores de Campo de división únicos y la extensión de superposición de los valore de Entidades de entrada con los valores de Entidades de división.

  • La tabla de atributos de entidades de cada clase de entidad de salida contiene los mismos campos que la tabla de atributos de las Entidades de Entrada.

  • Las entidades de anotación se dividen y se guardan en las entidades de salida basándose en el polígono de las Entidades de división en el que se incluye el punto inicial inferior izquierdo de la cadena de caracteres de anotación.

  • Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay capas creadas por la herramienta Crear capa de entidades y el campo Utilizar política de relación está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relación en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.

    Precaución:

    Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla o clases de entidad de geodatabase.

  • Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades que se van a dividir.

Feature Layer
Entidades de División

Entidades poligonales que contienen un campo tabular cuyos valores únicos se utilizan para dividir las entidades de entrada y proporcionar los nombres de las clases de entidad de salida.

Feature Layer
Campo de División

El campo de carácter utilizado para dividir las entidades de entrada. Los valores de este campo identifican las entidades de división utilizadas para crear cada clase de entidad de salida. Los valores únicos del campo de división proporcionan los nombres de las clases de entidad de salida.

Field
Espacio de trabajo de destino

Espacio de trabajo donde se almacenan las clases de entidad de salida.

Workspace ; Feature Dataset
Tolerancia XY
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Establezca un valor superior para los datos que tengan coordenadas menos precisas e inferior para los datasets de precisión extremadamente alta.

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit

Salida derivada

EtiquetaExplicaciónTipo de datos
Espacio de trabajo objetivo actualizado

El espacio de trabajo que contiene las clases de entidades creadas al dividir la entrada.

Workspace; Feature Dataset

arcpy.analysis.Split(in_features, split_features, split_field, out_workspace, {cluster_tolerance})
NombreExplicaciónTipo de datos
in_features

Las entidades que se van a dividir.

Feature Layer
split_features

Entidades poligonales que contienen un campo tabular cuyos valores únicos se utilizan para dividir las entidades de entrada y proporcionar los nombres de las clases de entidad de salida.

Feature Layer
split_field

El campo de carácter utilizado para dividir las entidades de entrada. Los valores de este campo identifican las entidades de división utilizadas para crear cada clase de entidad de salida. Los valores únicos del campo de división proporcionan los nombres de las clases de entidad de salida.

Field
out_workspace

Espacio de trabajo donde se almacenan las clases de entidad de salida.

Workspace ; Feature Dataset
cluster_tolerance
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Establezca un valor superior para los datos que tengan coordenadas menos precisas e inferior para los datasets de precisión extremadamente alta.

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit

Salida derivada

NombreExplicaciónTipo de datos
out_workspace2

El espacio de trabajo que contiene las clases de entidades creadas al dividir la entrada.

Workspace; Feature Dataset

Muestra de código

Ejemplo 1 de Dividir (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función Split.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Split("Habitat_Analysis.gdb/vegtype", "climate.shp", "Zone", 
                     "C:/output/Output.gdb", "1 Meters")
Ejemplo 2 de Dividir (script independiente)

Dividir una capa de vegetación en clases de entidad separadas para cada zona de clima.

# Name: Split.py
# Description: Split vegetation layer into separate feature classes 
# for each climate zone

# import system modules 
import arcpy 

# Set environment settings
arcpy.env.workspace = "C:/data"

# Split vegetation layer by climate zones, write to Output.gdb
veg = "Habitat_Analysis.gdb/vegtype"
splitFeatures = "climate.shp"
splitField = "Zone"
outWorkspace = "C:/output/Output.gdb"
clusterTol = "1 Meters"

arcpy.analysis.Split(veg, splitFeatures, splitField, outWorkspace, 
                     clusterTol)

Entornos

Casos especiales

Factor de procesamiento en paralelo

Esta herramienta respeta el entorno de Factor de procesamiento en paralelo. Si no se establece el entorno (valor predeterminado) o si se establece en 0, se desactivará el procesamiento en paralelo. El procesamiento paralelo no se utilizará y el procesamiento se hará de forma secuencial. Si se establece el entorno en 100, se habilitará el procesamiento en paralelo. Se utilizará el procesamiento paralelo y el procesamiento se hará en paralelo. Se utilizarán hasta 10 núcleos cuando se active el procesamiento en paralelo.

En estos momentos, procesamiento en paralelo es compatible con las operaciones de polígono sobre polígono, línea sobre polígono y punto sobre superposición poligonal.

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Sí

Temas relacionados