Proche 3D (Outils 3D Analyst)

Résumé

Calcule la distance tridimensionnelle entre chaque entité en entrée et l’entité la plus proche résidant dans une ou plusieurs des classes d’entités de proximité.

Utilisation

Toutes les entités en entrée doivent posséder des valeurs Z et tous les types de géométrie sont pris en charge. Les entités en entrée peuvent également être spécifiées comme des entités de proximité pour déterminer les entités les plus proches à l’intérieur d’une même classe d’entités.
Les champs suivants peuvent être ajoutés à la table attributaire de l’entité en entrée :
- NEAR_FID—FID de l’entité la plus proche. La valeur -1 indique qu’aucune correspondance n’a été trouvée dans le rayon de recherche spécifié.
- NEAR_DIST—Distance 2D (distance horizontale) entre le point le plus proche sur une entité en entrée et le point le plus proche sur l’entité la plus proche.
- NEAR_DIST3—Distance 3D (distance de pente) entre le point le plus proche sur une entité en entrée et le point le plus proche sur l’entité la plus proche.
- NEAR_DELTX—Distance le long de l’axe des X entre le point le plus proche sur l’entité en entrée et le point le plus proche sur l’entité la plus proche.
- NEAR_DELTY—Distance le long de l’axe des Y entre le point le plus proche sur l’entité en entrée et le point le plus proche sur l’entité la plus proche.
- NEAR_DELTZ—Distance le long de l’axe des Z entre le point le plus proche sur l’entité en entrée et le point le plus proche sur l’entité la plus proche.
- NEAR_FROMX—Coordonnée X du point le plus proche sur l’entité en entrée par rapport à l’entité la plus proche.
- NEAR_FROMY—Coordonnée Y du point le plus proche sur l’entité en entrée par rapport à l’entité la plus proche.
- NEAR_FROMZ—Coordonnée Z du point le plus proche sur l’entité en entrée par rapport à l’entité la plus proche.
- NEAR_X—Coordonnée X du point le plus proche sur l’entité la plus proche.
- NEAR_Y—Coordonnée Y du point le plus proche sur l’entité la plus proche.
- NEAR_Z—Coordonnée Z du point le plus proche sur l’entité la plus proche.
- NEAR_ANG_H—Angle arithmétique horizontal par rapport au point le plus proche, exprimé en degrés.
- NEAR_ANG_V—Angle d’élévation par rapport au point le plus proche, exprimé en degrés. L’horizontale correspond à zéro, la verticale vers le haut, à 90, et la verticale vers le bas, à -90.
- NEAR_FC—Chemin d’accès de la classe d’entités contenant l’entité la plus proche. Ce champ n’est ajouté que si plusieurs entités de proximité sont spécifiées.
Remarque :

Si les champs mentionnés précédemment existent déjà, leurs valeurs sont mises à jour.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Classe d’entités en entrée dont les entités reçoivent les informations relatives à l’entité la plus proche.	Feature Layer
Entités de proximité	La ou les entités dont la proximité vis-à-vis des entités en entrée est calculée. Si plusieurs classes d’entités sont spécifiées, un champ supplémentaire nommé `NEAR_FC` est ajouté à la classe d’entités en entrée afin d’identifier la classe d’entités de proximité contenant l’entité la plus proche.	Feature Layer
Rayon de recherche (Facultatif)	Distance maximale pour laquelle les entités les plus proches d’une entrée donnée sont déterminées. Si aucune valeur n’est spécifiée, l’entité la plus proche est déterminée, quelle que soit la distance.	Linear Unit
Emplacement (Facultatif)	Détermine si les coordonnées du point le plus proche dans l’entité en entrée et l’entité de proximité sont ajoutées à la table attributaire de l’entrée. Activé—The coordinates are added to the input feature. Décoché—The coordinates are not added to the input feature. This is the default.	Boolean
Angle (Facultatif)	Détermine si l’angle arithmétique horizontal et l’angle vertical entre l’entité en entrée et l’entité la plus proche sont ajoutés à la table attributaire en entrée. Activé—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. Décoché—The angles will not be added to the input's attribute table. This is the default.	Boolean
Delta (Facultatif)	Détermine si les distances le long des axes X, Y et Z entre l’entité en entrée et l’entité la plus proche sont ajoutées à la table attributaire en entrée. Activé—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. Décoché—No distances will be added to the input attribute table. This is the default.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Entités en entrée mises à jour	Entités en entrée mises à jour.	Feature Layer

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

Nom	Explication	Type de données
in_features	Classe d’entités en entrée dont les entités reçoivent les informations relatives à l’entité la plus proche.	Feature Layer
near_features [near_features,...]	La ou les entités dont la proximité vis-à-vis des entités en entrée est calculée. Si plusieurs classes d’entités sont spécifiées, un champ supplémentaire nommé `NEAR_FC` est ajouté à la classe d’entités en entrée afin d’identifier la classe d’entités de proximité contenant l’entité la plus proche.	Feature Layer
search_radius (Facultatif)	Distance maximale pour laquelle les entités les plus proches d’une entrée donnée sont déterminées. Si aucune valeur n’est spécifiée, l’entité la plus proche est déterminée, quelle que soit la distance.	Linear Unit
location (Facultatif)	Détermine si les coordonnées du point le plus proche dans l’entité en entrée et l’entité de proximité sont ajoutées à la table attributaire de l’entrée. `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 (Facultatif)	Détermine si l’angle arithmétique horizontal et l’angle vertical entre l’entité en entrée et l’entité la plus proche sont ajoutés à la table attributaire en entrée. `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 (Facultatif)	Détermine si les distances le long des axes X, Y et Z entre l’entité en entrée et l’entité la plus proche sont ajoutées à la table attributaire en entrée. `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

Sortie dérivée

Nom	Explication	Type de données
out_feature_class	Entités en entrée mises à jour.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de l’outil Near3D (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

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

Exemple 2 d’utilisation de l’outil Near3D (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''****************************************************************************
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')

Environnements

Espace de travail courant, Etendue

Informations de licence

Basic: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst

Proche 3D (Outils 3D Analyst)

Résumé

Utilisation

Remarque :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes