Fusionar capas (Geoanálisis)

Resumen

Combina capas de entidades para crear una única capa de salida.

Heredado:

La extensión de ArcGIS GeoAnalytics Server quedará obsoleta en ArcGIS Enterprise. La versión final de GeoAnalytics Server se incluyó con ArcGIS Enterprise 11.3. Esta herramienta de geoprocesamiento está disponible a través de ArcGIS Enterprise 11.3 y versiones anteriores.

La herramienta requiere que ambas entradas tengan el mismo tipo de geometría (punto, línea o polígono) o que sean tablas. Si el tiempo está habilitado en una capa, la otra también debe tenerlo habilitado, además de tener el mismo tipo de tiempo (instante o intervalo). El resultado siempre contendrá todos los campos de la capa de entrada. Todos los campos de la capa de fusión se incluirán de forma predeterminada; también puede especificar reglas de fusión personalizadas para definir el esquema resultante. A continuación, se muestran algunos ejemplos:

  • Tiene tres capas que representan los límites administrativos de Inglaterra, Gales y Escocia, y quiere obtener una sola capa de Gran Bretaña. Es posible usar Fusionar capas para combinar las áreas y mantener todos los campos de cada área.
  • Tiene dos capas con información de parcelas de términos municipales contiguos. Desea fusionarlas en una sola capa y conservar únicamente los campos que tengan el mismo nombre y el mismo tipo en las dos capas.

Ilustración

Ilustración de la herramienta Fusionar capas
Se muestra el diagrama del flujo de trabajo de Fusionar capas.

Uso

  • Ambas entradas deben tener el mismo tipo de geometría (punto, línea o polígono) o ser tablas.

  • Ambas entradas deben tener el mismo tipo de tiempo (instante o intervalo) o no tener el tiempo habilitado.

  • De forma predeterminada, todos los campos de ambas entradas se copiarán en la salida. Opcionalmente, puede cambiar el nombre, eliminar o hacer coincidir los campos de la capa de fusión con la capa de entrada.

    OperaciónDescripciónEjemplo

    Cambiar nombre

    El nombre del campo cambiará en la salida. Aparecerá un cuadro de texto en el que puede especificar el nombre nuevo.

    Desea fusionar dos capas, cada una con un campo llamado COUNT. Este campo representa un recuento de personas en una capa y un recuento de familias en la otra. Los dos campos COUNT se fusionarán de forma predeterminada porque el nombre de los campos coincide. Utilice Cambiar nombre para cambiar el nombre del campo de la capa de fusión a MERGE_COUNT para mantener ambos campos separados en la capa de resultados.

    Eliminar

    El campo se eliminará de la salida.

    Desea fusionar dos capas, pero no quiere conservar determinados campos en la capa de fusión, por ejemplo, OBJECTID. Utilice Eliminar para evitar que dichos campos se escriban en la capa de resultados y conservar únicamente los campos de interés.

    Coincidencia

    Los nombres de campos serán equivalentes. Los valores del campo de la capa que se va a fusionar se copiarán al campo de salida equivalente.

    Desea fusionar dos capas tabulares de resultados de una encuesta. La capa de entrada tiene un campo llamado Name que contiene los nombres de los participantes de la encuesta. Un campo equivalente en la capa de fusión se llama Participant. Utilice Coincidencia para indicar que estos campos son equivalentes, y ambos se fusionarán en un único campo llamado Name en la capa de resultados.

  • Si la capa de entrada y la capa de fusión contienen campos que nombres coincidentes, pero tipos de campo no coincidentes, la herramienta fallará a menos que los dos tipos de campo se puedan fusionar correctamente. Si el campo de entrada es una cadena de caracteres y el campo de fusión es numérico, los campos se fusionarán en un solo campo de cadena de caracteres en la capa de salida. Si el campo de entrada es doble y el campo de fusión es numérico, los campos se fusionarán en un solo campo doble en la capa de salida. Para el resto de casos, debe utilizar Atributos de fusión para cambiar el nombre o eliminar uno de los campos coincidentes para ejecutar la herramienta.

  • Es posible mejorar el rendimiento de la herramienta Fusionar capas realizando una de las siguientes acciones o ambas:

    • Defina el entorno de extensión para analizar únicamente datos de interés.
    • Utilice datos locales en los que se ejecute el análisis.

  • Esta herramienta de geoprocesamiento se basa en ArcGIS GeoAnalytics Server. El análisis se completa en GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

  • Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

    Más información acerca del uso compartido de datos en el portal

    Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

Las entidades de punto, línea o poligonales o la tabla que se fusionarán con la capa de fusión.

Record Set
Capa de fusión

Las entidades de punto, línea o poligonales o la tabla que se fusionarán con la capa de entrada. La capa de fusión debe contener el mismo tipo de entidades y tipo de tiempo que la capa de entrada.

Record Set
Nombre de salida

El nombre del servicio de entidades de salida.

String
Atributos de fusión
(Opcional)

Una lista de valores que describe cómo se deben modificar los campos de la capa de fusión y cómo se deben hacer coincidir con los campos de la capa de entrada. Todos los campos de la capa de entrada se escribirán en la capa de salida. Si no se define ningún atributo de fusión, todos los campos de la capa de fusión se escribirán en la capa de salida.

Si un campo existe en una capa, pero no en la otra, la capa de salida seguirá conteniendo dos campos. El campo de salida contendrá valores nulos para las entidades de entrada que no tenían el campo. Por ejemplo, si la capa de entrada contiene un campo denominado TYPE, pero la capa de fusión no contiene TYPE, la salida contendrá TYPE, pero sus valores serán nulos para todas las entidades copiadas de la capa de fusión.

Es posible controlar cómo se escriben los campos de la capa de fusión en la capa de salida con los siguientes tipos de fusión:

  • Eliminar: el campo de la capa de fusión se eliminará de la capa de salida.
  • Cambiar nombre: el campo de la capa de fusión se renombrará en la salida. No puede cambiar el nombre de un campo de la capa de fusión al de un campo de la capa de entrada. Para que los nombres de campo sean equivalentes, use la opción de coincidencia.
  • Coincidencia: se cambia el nombre del campo de la capa de fusión y se hace coincidir con un campo de la capa de entrada. Por ejemplo, la capa de entrada tiene un campo denominado CODE y la capa de fusión tiene un campo denominado STATUS. Puede hacer coincidir STATUS con CODE, y la salida contendrá el campo CODE con los valores del campo STATUS para las entidades copiadas desde la capa de fusión. La transformación de tipos se admite para los valores numéricos. No se admite hacer coincidir los campos numéricos con campos de cadena de caracteres.

Value Table
Data store
(Opcional)

Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • Big data store espaciotemporalLa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • Data store relacionalLa salida se almacenará en un data store relacional.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Salida

La capa de salida que contiene las entidades y los atributos combinados de las capas de entrada y de fusión.

Record Set

arcpy.geoanalytics.MergeLayers(input_layer, merge_layer, output_name, {merging_attributes}, {data_store})
NombreExplicaciónTipo de datos
input_layer

Las entidades de punto, línea o poligonales o la tabla que se fusionarán con la capa de fusión.

Record Set
merge_layer

Las entidades de punto, línea o poligonales o la tabla que se fusionarán con la capa de entrada. La capa de fusión debe contener el mismo tipo de entidades y tipo de tiempo que la capa de entrada.

Record Set
output_name

El nombre del servicio de entidades de salida.

String
merging_attributes
[[Merge Field, Action, Input Field],...]
(Opcional)

Una lista de valores que describe cómo se deben modificar los campos de la capa de fusión y cómo se deben hacer coincidir con los campos de la capa de entrada. Todos los campos de la capa de entrada se escribirán en la capa de salida. Si no se define ningún atributo de fusión, todos los campos de la capa de fusión se escribirán en la capa de salida.

Si un campo existe en una capa, pero no en la otra, la capa de salida seguirá conteniendo dos campos. El campo de salida contendrá valores nulos para las entidades de entrada que no tenían el campo. Por ejemplo, si la capa de entrada contiene un campo denominado TYPE, pero la capa de fusión no contiene TYPE, la salida contendrá TYPE, pero sus valores serán nulos para todas las entidades copiadas de la capa de fusión.

Es posible controlar cómo se escriben los campos de la capa de fusión en la capa de salida con los siguientes tipos de fusión:

  • Eliminar: el campo de la capa de fusión se eliminará de la capa de salida.
  • Cambiar nombre: el campo de la capa de fusión se renombrará en la salida. No puede cambiar el nombre de un campo de la capa de fusión al de un campo de la capa de entrada. Para que los nombres de campo sean equivalentes, use la opción de coincidencia.
  • Coincidencia: se cambia el nombre del campo de la capa de fusión y se hace coincidir con un campo de la capa de entrada. Por ejemplo, la capa de entrada tiene un campo denominado CODE y la capa de fusión tiene un campo denominado STATUS. Puede hacer coincidir STATUS con CODE, y la salida contendrá el campo CODE con los valores del campo STATUS para las entidades copiadas desde la capa de fusión. La transformación de tipos se admite para los valores numéricos. No se admite hacer coincidir los campos numéricos con campos de cadena de caracteres.

Value Table
data_store
(Opcional)

Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • SPATIOTEMPORAL_DATA_STORELa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • RELATIONAL_DATA_STORELa salida se almacenará en un data store relacional.
String

Salida derivada

NombreExplicaciónTipo de datos
output

La capa de salida que contiene las entidades y los atributos combinados de las capas de entrada y de fusión.

Record Set

Muestra de código

Ejemplo de MergeLayers (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta MergeLayers.

#-------------------------------------------------------------------------------
# Name: MergeLayers.py
# Description: Merge two layers containing parcel information.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inputFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/parcels_west/FeatureServer/0"
mergeFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/east_parcels/FeatureServer/0"
mergingAttributes = [["CODE", "MATCH", "ID"], ["globalid", "REMOVE"]]
outFS = "all_parcels"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Merge Layers
arcpy.geoanalytics.MergeLayers(inputFeatures, mergeFeatures, outFS, 
                               mergingAttributes, dataStore)

Entornos

Casos especiales

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. En GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

  • Basic: Requiere ArcGIS GeoAnalytics Server
  • Standard: Requiere ArcGIS GeoAnalytics Server
  • Advanced: Requiere ArcGIS GeoAnalytics Server

Temas relacionados