Cercano a 3D (Herramientas de 3D Analyst)

Resumen

Calcula la distancia tridimensional desde cada entidad de entrada hasta la entidad más próximas que resida en una o más clases de entidad cercanas.

Uso

Todas las entidades de entrada deben tener valores Z y se soportan todos los tipos de geometría. Las entidades de entrada también pueden especificarse como las entidades próximas para determinar las entidades más cercanas dentro de la misma clase de entidad.
Los siguientes campos pueden añadirse a la tabla de atributos de la entidad de entrada:
- NEAR_FID—FID de la entidad más cercana Un valor de -1 indica que no se encontró coincidencia dentro del radio de búsqueda especificado
- NEAR_DIST—La distancia 2D (distancia horizontal) entre el punto más cercano en una entidad de entrada y el punto más cercano en la entidad más cercana.
- NEAR_DIST3—La distancia 3D (distancia de pendiente) entre el punto más cercano en una entidad de entrada y el punto más cercano en la entidad más cercana.
- NEAR_DELTX—La distancia a lo largo del eje X desde el punto más cercano en la entidad de entrada hasta el punto más cercano en la entidad más cercana.
- NEAR_DELTY—La distancia a lo largo del eje Y desde el punto más cercano en la entidad de entrada hasta el punto más cercano en la entidad más cercana.
- NEAR_DELTZ—La distancia a lo largo del eje Z desde el punto más cercano en la entidad de entrada hasta el punto más cercano en la entidad más cercana.
- NEAR_FROMX—La coordenada X del punto más cercano en la entidad de entrada a la entidad más cercana.
- NEAR_FROMY—La coordenada Y del punto más cercano en la entidad de entrada a la entidad más cercana.
- NEAR_FROMZ—La coordenada Z del punto más cercano en la entidad de entrada a la entidad más cercana.
- NEAR_X—La coordenada X del punto más cercano en la entidad más cercana.
- NEAR_Y—La coordenada Y del punto más cercano en la entidad más cercana.
- NEAR_Z—La coordenada Z del punto más cercano en la entidad más cercana.
- NEAR_ANG_H—El ángulo aritmético horizontal hacia el punto más cercano expresado en grados.
- NEAR_ANG_V—El ángulo de elevación al punto más cercano expresado en grados. Horizontal es cero, recto hacia arriba es 90, recto hacia abajo es -90.
- NEAR_FC—La ruta de la clase de entidad que contiene la entidad más cercana. Este campo solo se agrega cuando se especifican varias entidades próximas.
Nota:

Si los campos mencionados ya existen, sus valores se actualizarán.

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Las clase de entidad de entrada cuyas entidades se atribuirán con la información sobre la entidad más cercana.	Feature Layer
Entidades próximas	La entidad o entidades cuya proximidad a las entidades de entrada se calculará. Si se especifican varias clases de entidad, se agregará un campo adicional denominado `NEAR_FC` a la clase de entidad de entrada para identificar qué clase de entidad próxima contiene la entidad más próxima.	Feature Layer
Radio de Búsqueda (Opcional)	La distancia máxima con respecto a la cual se determinarán las entidades más cercanas a partir de una entrada concreta. Si no se especifica ningún valor, se determinará la entidad más cercana a cualquier distancia.	Linear Unit
Ubicación (Opcional)	Determina si las coordenadas del punto más cercano en la entidad de entrada y cercana se añadirán a la tabla de atributos de la entrada. Activado—The coordinates are added to the input feature. Desactivado—The coordinates are not added to the input feature. This is the default.	Boolean
Ángulo (Opcional)	Determina si el ángulo aritmético horizontal y el ángulo vertical entre la entidad de entrada y la entidad más cercana se añadirán a la tabla de atributos de entrada. Activado—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. Desactivado—The angles will not be added to the input's attribute table. This is the default.	Boolean
Triángulo (Opcional)	Determina si las distancias a lo largo de los ejes X, Y y Z entre la entidad de entrada y la entidad más cercana se agregarán a la tabla de atributos de entrada. Activado—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. Desactivado—No distances will be added to the input attribute table. This is the default.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de entrada actualizadas	Las entidades de entrada actualizadas.	Feature Layer

arcpy.3d.Near3D(in_features, near_features, {search_radius}, {location}, {angle}, {delta})

Nombre	Explicación	Tipo de datos
in_features	Las clase de entidad de entrada cuyas entidades se atribuirán con la información sobre la entidad más cercana.	Feature Layer
near_features [near_features,...]	La entidad o entidades cuya proximidad a las entidades de entrada se calculará. Si se especifican varias clases de entidad, se agregará un campo adicional denominado `NEAR_FC` a la clase de entidad de entrada para identificar qué clase de entidad próxima contiene la entidad más próxima.	Feature Layer
search_radius (Opcional)	La distancia máxima con respecto a la cual se determinarán las entidades más cercanas a partir de una entrada concreta. Si no se especifica ningún valor, se determinará la entidad más cercana a cualquier distancia.	Linear Unit
location (Opcional)	Determina si las coordenadas del punto más cercano en la entidad de entrada y cercana se añadirán a la tabla de atributos de la entrada. `LOCATION`—The coordinates are added to the input feature. `NO_LOCATION`—The coordinates are not added to the input feature. This is the default.	Boolean
angle (Opcional)	Determina si el ángulo aritmético horizontal y el ángulo vertical entre la entidad de entrada y la entidad más cercana se añadirán a la tabla de atributos de entrada. `ANGLE`—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. `NO_ANGLE`—The angles will not be added to the input's attribute table. This is the default.	Boolean
delta (Opcional)	Determina si las distancias a lo largo de los ejes X, Y y Z entre la entidad de entrada y la entidad más cercana se agregarán a la tabla de atributos de entrada. `DELTA`—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. `NO_DELTA`—No distances will be added to the input attribute table. This is the default.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Las entidades de entrada actualizadas.	Feature Layer

Muestra de código

Ejemplo 1 de Near3D (ventana de Python)

En el siguiente ejemplo, se muestra cómo usar esta herramienta en la ventana de Python:

arcpy.env.workspace = "C:/data"
arcpy.ddd.Near3D("points_3D.shp", "buildings_multipatch.shp", "30", "LOCATION", "ANGLE", "DELTA")

Ejemplo 2 de Near3D (secuencia de comandos independiente)

El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:

'''****************************************************************************
Name: Near 3D Example
Description: This script demonstrates how to use
             the Near 3D tool to identify the nearest z-aware features
             that satisfy the results from a queried feature.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inFC = 'homes.shp'
nearFC = 'radiotowers.shp'
# See the 'Building an SQL expression' topic for more information
# Query the field 'MATERIAL' for the string 'Reinforced Concrete'
SQL_Expression = "'"'MATERIAL'"' = 'Reinforced Concrete'"
# Run Make Feature Layer
arcpy.management.MakeFeatureLayer(nearFC, 'Near Layer', SQL_Expression)
result = arcpy.management.GetCount('Near Layer')
if int(result.getOutput(0)) == 0:
    arcpy.AddMessage('{0} has no features that satisfy the query: {1}'\
         .format(nearFC, SQL_Expression))
else:
    # Run Near3D
    arcpy.ddd.Near3D(inFC, 'nearLayer', '', 'LOCATION', 'ANGLE')

Entornos

Espacio de trabajo actual, Extensión

Información de licenciamiento

Basic: Requiere 3D Analyst
Standard: Requiere 3D Analyst
Avanzado: Requiere 3D Analyst

Cercano a 3D (Herramientas de 3D Analyst)

Resumen

Uso

Nota:

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados