Unión espacial (Análisis)

Nivel de licencia:BasicStandardAdvanced

Resumen

Une los atributos de una entidad con otra basada en la relación espacial. Las entidades de destino y los atributos unidos de las entidades de unión se escriben en la clase de entidad de salida.

Vea los ejemplos gráficos que explican las relaciones espaciales

Uso

Sintaxis

SpatialJoin_analysis (target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name})
ParámetroExplicaciónTipo de datos
target_features

Los atributos de las entidades de destino y los atributos de las entidades unidas se transfieren a la clase de entidad de salida. Sin embargo, se puede definir un subconjunto de atributos en el parámetro del mapa de campo. Las entidades de destino pueden ser cualquier fuente de datos espaciales compatible con ArcGIS.

Feature Layer
join_features

Los atributos de las entidades de unión se unen a los atributos de las entidades de destino. Consulte la explicación del parámetro Operación de unión para obtener detalles sobre cómo la agregación de atributos unidos se ve afectada por el tipo de operación de unión.

Feature Layer
out_feature_class

Una nueva clase de entidad que contiene los atributos de las entidades de unión y de destino. Por defecto, todos los atributos de las entidades de destino y los atributos de las entidades unidas se escriben en la salida. Sin embargo, el conjunto de atributos que se transferirá se puede controlar mediante el parámetro del mapa de campo.

Feature Class
join_operation
(Opcional)

Determina cómo se manejarán las uniones entre las entidades de destino y las entidades de unión en la clase de entidad de salida si se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino.

  • JOIN_ONE_TO_ONESi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, se agregarán los atributos de las múltiples entidades de unión mediante una regla de fusión de asignación de campos. Por ejemplo, si se encuentra una entidad de destino de punto dentro de dos entidades de unión de polígono separadas, se agregarán los atributos de los dos polígonos antes de que se transfieran a la clase de entidad de puntos de salida. Si un polígono tiene un valor de atributo de 3 y el otro tiene un valor de 7 y se especifica una regla de fusión de Suma, el valor que se agregará en la clase de entidad de salida será 10. La opción JOIN_ONE_TO_ONE es el valor predeterminado.
  • JOIN_ONE_TO_MANYSi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, la clase de entidad de salida contendrá varias copias (registros) de la entidad de destino. Por ejemplo, si se encuentra una única entidad objetivo de punto dentro de dos entidades de unión de polígonos independientes, la clase de entidad de salida contendrá dos copias de la entidad objetivo: un registro con los atributos de un polígono y otro registro con los atributos del otro polígono.
String
join_type
(Opcional)

Determina si todas las entidades de destino se mantendrán en la clase de entidad de salida (conocida como "unión externa") o solo se mantendrán aquellas que tengan la relación espacial especificada con las entidades de unión ("unión interna").

  • KEEP_ALLTodas las entidades de destino se mantendrán en la salida (unión externa). Esta es la opción predeterminada.
  • KEEP_COMMON Solo se mantendrán en la clase de entidad de salida aquellas entidades de destino que tengan la relación espacial especificada con las entidades de unión (unión interna). Por ejemplo, si se especifica una clase de entidad de puntos para las entidades objetivo y una clase de entidad poligonal para las entidades de unión, con una Opción de correspondencia de WITHIN, la clase de entidad de salida solo contendrá aquellas entidades objetivo que se encuentren dentro de una entidad de unión de polígono; las entidades objetivo que no estén dentro de una entidad de unión se excluirán de la salida.
Boolean
field_mapping
(Opcional)

Controla qué campos de atributos estarán en la clase de entidad de salida. La lista inicial contiene todos los campos tanto de las entidades objetivo como de las entidades de unión. Los campos se pueden agregar, eliminar, se les puede cambiar el nombre o las propiedades. Los campos seleccionados de las entidades de destino se transfieren como están, pero los campos seleccionados de las entidades de unión se pueden agregar mediante una regla de fusión. Para obtener detalles sobre la asignación de campos, consulte Utilizar el control de asignación de campos y Asignar campos de entrada a campos de salida. Se pueden especificar varios campos y una combinación estadística.

Field Mappings
match_option
(Opcional)

Define los criterios que se utilizan para hacer que concuerden las filas. Las opciones de correspondencia son:

  • INTERSECTLas entidades de las entidades de unión se harán coincidir si se intersecan con una entidad objetivo. Esta es la opción predeterminada. Especifique una distancia en el parámetro Radio de búsqueda.
  • INTERSECT_3D Las entidades de las entidades de unión se ajustarán si se intersecan con una entidad objetivo en el espacio tridimensional (x, y, z). Especifique una distancia en el parámetro Radio de búsqueda.
  • WITHIN_A_DISTANCELas entidades en las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad objetivo. Especifique una distancia en el parámetro Radio de búsqueda.
  • WITHIN_A_DISTANCE_3DLas entidades en las entidades de unión se harán coincidir si están dentro a una distancia especificada de una entidad de destino en espacio tridimensional. Especifique una distancia en el parámetro Radio de búsqueda.
  • CONTAINSlas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene. Las entidades objetivo deben ser polilíneas o polígonos. Para esta opción, las entidades de destino no pueden ser puntos y las entidades de unión solo pueden ser polígonos cuando las entidades de destino también son polígonos.
  • COMPLETELY_CONTAINSLas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene completamente. El polígono puede contener completamente cualquier entidad. El punto no puede contener completamente cualquier entidad, ni siquiera un punto. La polilínea puede contener completamente solo polilínea y punto.
  • CONTAINS_CLEMENTINIEsta relación espacial proporciona los mismos resultados que COMPLETELY_CONTAINS con la excepción de que si la entidad de unión está completamente sobre el límite de la entidad objetivo (ninguna parte se encuentra correctamente dentro o fuera), la entidad no se hará coincidir. CLEMENTINI define el polígono de límite como la línea que separa el interior del exterior, el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • WITHINlas entidades en las entidades de unión se harán coincidir si una entidad de destino está dentro de ellas. Es contrario a CONTAINS. Para esta opción, las entidades de destino solo pueden ser polígonos cuando las entidades de unión también son polígonos. El punto solo puede ser entidad de unión si el punto es el objetivo.
  • COMPLETELY_WITHINLas entidades en las entidades de unión se harán coincidir si una entidad objetivo las contiene completamente. Esto es contrario a COMPLETELY_CONTAINS.
  • WITHIN_CLEMENTINIEl resultado será idéntico a WITHIN excepto si la totalidad de la entidad de las entidades de unión está sobre el límite de la entidad objetivo, la entidad no se hará coincidir. CLEMENTINI define el polígono de límite como la línea que separa el interior del exterior, el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • ARE_IDENTICAL_TOLas entidades en las entidades de unión se harán coincidir si son idénticas a una entidad objetivo. Tanto la entidad de unión como la de destino deben ser del mismo tipo de forma, punto a punto, línea a línea y polígono a polígono.
  • BOUNDARY_TOUCHESLas entidades de las entidades de unión se harán coincidir si tienen un límite que toca a una entidad objetivo. Las entidades de unión y de destino deben ser líneas o polígonos. Además, la entidad en las entidades de unión debe estar afuera o completamente adentro del polígono de destino.
  • SHARE_A_LINE_SEGMENT_WITHLas entidades de las entidades de unión se harán coincidir si comparten un segmento de línea con una entidad objetivo. Las entidades de unión y de destino deben ser líneas o polígonos.
  • CROSSED_BY_THE_OUTLINE_OFLas entidades en las entidades de unión se harán coincidir si una entidad de destino está cruzada por su contorno. Las entidades de unión y de destino deben ser líneas o polígonos. Si se utilizan polígonos para las entidades objetivo o de unión, se utilizarán los límites (las líneas) del polígono. Se harán coincidir las líneas que se cruzan en un punto, no las que comparten un segmento de línea.
  • HAVE_THEIR_CENTER_INLas entidades en las entidades de unión se harán coincidir si el centro de una entidad objetivo está dentro de las mismas. El centro de la entidad se calcula del modo siguiente: para los polígonos y los multipuntos se utiliza el centroide de la geometría y para la entrada de línea se utiliza el punto medio de la geometría. Especifique una distancia en el parámetro Radio de búsqueda.
  • CLOSESTse hace coincidir la entidad en las entidades de unión que está más cerca de una entidad de destino. Consulte la sugerencia de uso para obtener más información. Especifique una distancia en el parámetro Radio de búsqueda.
String
search_radius
(Opcional)

Las entidades de unión que se encuentren dentro de esta distancia de una entidad de destino se considerarán para la unión espacial. Un radio de búsqueda solo es válido cuando se especifica la relación espacial (Opción de correspondencia) INTERSECT, WITHIN_A_DISTANCE, HAVE_THEIR_CENTER_IN o CLOSEST. Utilizar un radio de búsqueda de 100 metros con la relación espacial INTERSECT equivale a decir: si una entidad de unión está a menos de 100 metros de una entidad objetivo, se considerará que hay una correspondencia con la entidad de unión.

Linear unit
distance_field_name
(Opcional)

El nombre de un campo que se va a agregar a la clase de entidad de salida, que contiene la distancia entre la entidad objetivo y la entidad de unión más cercana. Esta opción solo es válida cuando la relación espacial (Opción de correspondencia) se especifica en CLOSEST. El valor de este campo es -1 si no coincide ninguna entidad dentro de un radio de búsqueda. Si no se especifica ningún nombre de campo, el campo no se agregará a la clase de entidad de salida.

String

Ejemplo de código

Ejemplo 1 de SpatialJoin (ventana de Python)

La siguiente secuencia de comandos muestra cómo utilizar la función SpatialJoin en una ventana de Python.

import arcpy

target_features = "C:/data/usa.gdb/states"
join_features = "C:/data/usa.gdb/cities"
out_feature_class = "C:/data/usa.gdb/states_cities"

arcpy.SpatialJoin_analysis(target_features, join_features, out_feature_class)
Ejemplo 2 de SpatialJoin (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la función SpatialJoin para unir los atributos de las ciudades a los estados.

# Name: SpatialJoin_Example2.py
# Description: Join attributes of cities to states based on spatial relationships.
# Requirements: os module

# Import system modules
import arcpy
import os

# Set local variables
workspace = r"C:\gpqa\mytools\spatialjoin\usa.gdb"
outWorkspace = r"C:\gpqa\mytools\spatialjoin\output.gdb"
 
# Want to join USA cities to states and calculate the mean city population
# for each state
targetFeatures = os.path.join(workspace, "states")
joinFeatures = os.path.join(workspace, "cities")
 
# Output will be the target features, states, with a mean city population field (mcp)
outfc = os.path.join(outWorkspace, "states_mcp2")
 
# Create a new fieldmappings and add the two input feature classes.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(targetFeatures)
fieldmappings.addTable(joinFeatures)
 
# First get the POP1990 fieldmap. POP1990 is a field in the cities feature class.
# The output will have the states with the attributes of the cities. Setting the
# field's merge rule to mean will aggregate the values for all of the cities for
# each state into an average value. The field is also renamed to be more appropriate
# for the output.
pop1990FieldIndex = fieldmappings.findFieldMapIndex("POP1990")
fieldmap = fieldmappings.getFieldMap(pop1990FieldIndex)
 
# Get the output field's properties as a field object
field = fieldmap.outputField
 
# Rename the field and pass the updated field object back into the field map
field.name = "mean_city_pop"
field.aliasName = "mean_city_pop"
fieldmap.outputField = field
 
# Set the merge rule to mean and then replace the old fieldmap in the mappings object
# with the updated one
fieldmap.mergeRule = "mean"
fieldmappings.replaceFieldMap(pop1990FieldIndex, fieldmap)
 
# Delete fields that are no longer applicable, such as city CITY_NAME and CITY_FIPS
# as only the first value will be used by default
x = fieldmappings.findFieldMapIndex("CITY_NAME")
fieldmappings.removeFieldMap(x)
y = fieldmappings.findFieldMapIndex("CITY_FIPS")
fieldmappings.removeFieldMap(y)
 
#Run the Spatial Join tool, using the defaults for the join operation and join type
arcpy.SpatialJoin_analysis(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/9/2014