Anexar

Resumen

Anexa múltiples datasets de entrada en un dataset de destino existente. Los datasets de entrada pueden ser clases de entidad de punto, de línea o de polígono, tablas, rásteres, catálogos de ráster, clases de entidad de anotación o clases de entidad de dimensión.

Para combinar datasets de entrada en un nuevo dataset de salida, utilice la herramienta Fusionar.

Ilustración

Uso

• Utilice esta herramienta para agregar nuevas entidades u otros datos de varios datasets a un dataset existente. Esta herramienta puede anexar clases de entidad de punto, de línea o de polígono, tablas, rásteres, catálogos de ráster, clases de entidad de anotación o clases de entidad de dimensión a un dataset existente del mismo tipo. Por ejemplo, se pueden anexar varias tablas a una tabla existente, o varios rásteres a un dataset ráster existente, pero una clase de entidad de línea no se puede anexar a una clase de entidad de punto.

• El control Mapa de campo de la herramienta Anexar se puede utilizar para controlar la forma en que se transfiere la información de atributo desde los campos del dataset de entrada hasta el dataset de destino. El control Mapa de campo solo se puede utilizar si está especificado el Tipo de esquema NO_TEST.

• Esta herramienta no segmentará las entidades cuando las agregue al dataset de destino. Todas las entidades tanto de la clase de entidad de entrada como de la clase de entidad de destino permanecerán intactas después de anexar, incluso si se superponen. Para combinar o segmentar geometrías de entidad, utilice la herramienta Combinación.

• Si está especificado el Tipo de esquema TEST, el esquema (definiciones de campo) de los datasets de entrada debe coincidir con el dataset de destino para que las entidades se puedan anexar. Si está especificado el Tipo de esquema NO_TEST, no es necesario que el esquema de dataset de entrada (definiciones de campo) coincida con el dataset de destino. Sin embargo, los campos de los datasets de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera explícita en el control Mapa de campo.

• Dado que los datos de los datasets de entrada se escriben en un dataset de destino existente que tiene un esquema predefinido (definiciones de campo), el control Mapa de campo no permite que se agreguen o se quiten campos del dataset de destino.

• Si las referencias espaciales de una clase de entidad de entrada y de destino no coinciden, la herramienta Anexar proyectará las entidades de la clase de entidad de entrada en el sistema de coordenadas que utiliza la clase de entidad de destino.

• Esta herramienta no realiza ajuste de bordes; no se ajustará a la geometría de las entidades.

• Las capas de mapa se pueden utilizar como Datasets de entrada. Si una capa tiene una selección, la herramienta Anexar utiliza únicamente los registros seleccionados (entidades o filas de tabla).

• Esta herramienta no puede utilizar varias capas de entrada con el mismo nombre. A pesar de que ArcMap permite la visualización de capas que tienen el mismo nombre, es probable que estas capas no se puedan utilizar. Para solucionar esta limitación, utilice el botón Examinar del cuadro de diálogo de la herramienta para examinar las rutas completas de cada uno de los Datasets de entrada.

• Para utilizar el parámetro Subtipo, el dataset de destino debe tener un campo de subtipo definido y códigos de subtipo asignados. En el parámetro Subtipo, proporcione una descripción del subtipo para asignar este subtipo a todos los datos nuevos que se anexan al dataset de destino.

Sintaxis

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})

Parámetro	Explicación	Tipo de datos
inputs [inputs,...]	Datasets de entrada cuyos datos se anexarán al dataset de destino. Los datasets de entrada pueden ser clases de entidad de punto, de línea o de polígono, tablas, rásteres, catálogos de ráster, clases de entidad de anotación o clases de entidad de dimensión. Cada dataset de entrada debe concordar con el tipo de datos del dataset de destino.	Table View; Raster Layer
target	Dataset existente en el que se anexarán los datos de los datasets de entrada. Cada dataset de entrada debe concordar con el tipo de datos del dataset de destino.	Table View; Raster Layer
schema_type (Opcional)	Especifica si el esquema (definiciones de campo) de los datasets de entrada debe coincidir con el esquema del dataset de destino para que se anexen los datos. TEST —El esquema del dataset de entrada (definiciones de campo) debe coincidir con el esquema del dataset de destino. Se devolverá un error si los esquemas no coinciden. NO_TEST —El esquema del dataset de entrada (definiciones de campo) no debe coincidir con el esquema del dataset de destino. Los campos de los datasets de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera explícita en el control Mapa de campo.	String
field_mapping (Opcional)	Controla la forma en que se transfiere la información de atributo en los campos de los datasets de entrada al dataset de destino. Este parámetro solo se puede utilizar si está especificado el Tipo de esquema NO_TEST. Dado que los datos de los datasets de entrada se anexan en un dataset de destino existente que tiene un esquema predefinido (definiciones de campo), los campos no se pueden agregar o quitar del dataset de destino. Las reglas de fusión le permiten especificar cómo los valores de dos o más campos de entrada se fusionan o se combinan en un único valor de salida. Hay varias reglas de fusión que determinan cómo se rellena con valores el campo de salida. Primero: utilizar el primer valor de los campos de entrada. Último: utilizar el último valor de los campos de entrada. Unir: concatenar (unir) los valores de los campos de entrada. Sumar: calcular el total de los valores de los campos de entrada. Valor medio: calcular el valor medio (promedio) de los valores de los campos de entrada. Mediana: calcular el valor de la mediana (mitad) de los valores de los campos de entrada. Modo: utilizar el valor con la mayor frecuencia. Mín.: usar el valor mínimo de todos los valores de los campos de entrada. Máx.: usar el valor máximo de todos los valores de los campos de entrada. Desviación estándar: utilizar el método de clasificación de la desviación estándar en todos los valores de campos de entrada. Conteo: buscar la cantidad de registros incluidos en los cálculos.	Field Mapping
subtype (Opcional)	Una descripción de subtipo para asignar ese subtipo a todos los datos nuevos anexados en el dataset de destino.	String

Ejemplo de código

Ejemplo 1 de Anexar (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta Anexar en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")

Ejemplo 2 de Anexar (secuencia de comandos de Python independiente)

La siguiente secuencia de comandos muestra cómo utilizar la herramienta Anexar.

# Name: Append.py
# Description: Use the Append tool to combine several shapefiles

# import system modules 
import arcpy
import os

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

# Set local variables
outLocation = "C:/Output"
emptyFC = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""

try:
    # Process:  Create a new empty feature class to append shapefiles into
    arcpy.CreateFeatureclass_management(outLocation, emptyFC, "POLYGON", "amherst.shp")

    # All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC
    fcList = arcpy.ListFeatureClasses("","POLYGON")
    # list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"] 

    # Process: Append the feature classes into the empty feature class
    arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)

except Exception as err:
    print(err.args[0])

Entornos

• Extensión
• Espacio de trabajo actual

Información sobre licencias

• ArcGIS for Desktop Basic: Sí
• ArcGIS for Desktop Standard: Sí
• ArcGIS for Desktop Advanced: Sí

¿Algún comentario sobre este tema?