Résumé
Met à jour les coordonnées z de sommets d'entités 3D à l'aide d'une surface.
Utilisation
Seuls les sommets des entités recouvrant entièrement la surface en entrée seront mis à jour. Les entités ne recouvrant pas la surface seront ignorées.
Remarque :
Si la valeur z obtenue pour un sommet donné se trouve en dehors du domaine z de la référence spatiale d'une entité de géodatabase, la valeur z du sommet n'est pas mise à jour. Créez une copie des entités en entrée et indiquez un domaine z approprié pour traiter les entités concernées.
Syntaxe
UpdateFeatureZ(in_features, in_surface, {method}, {status_field})
Paramètre | Explication | Type de données |
in_features | Entités 3D dont les valeurs z de sommet seront modifiées. | Feature Layer |
in_surface | Surface qui servira à déterminer la nouvelle valeur z des sommets des entités 3D. | LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer |
method (Facultatif) | Méthode d'interpolation utilisée pour définir les informations sur la surface. Les options disponibles dépendent du type de données de la surface en entrée :
| String |
status_field (Facultatif) | Champ numérique dans lequel seront spécifiées des valeurs indiquant si les sommets d'une entité ont été mis à jour. Une valeur égale à 1 indique que les entités ont été mises à jour et une valeur nulle indique qu'elles n'ont pas été mises à jour. Les entités qui recouvrent partiellement la surface ne seront pas mises à jour. | Field |
Sortie dérivée
Nom | Explication | Type de données |
out_feature_class | Entités 3D mises à jour dont les valeurs z de sommet ont été modifiées. | Couche d'entités |
Exemple de code
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.
arcpy.env.workspace = 'C:/data'
arcpy.UpdateFeatureZ_3d('lines_3d.shp', 'dsm.tif', status_field='Updated')
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''****************************************************************************
Name: Update Antenna Positions
Description: Updates antenna positions based on elevations from a surface.
****************************************************************************'''
# Import system modules
import arcpy
in_fc = arcpy.GetParameterAsText(1) # pt features representing antenna locations
surface = arcpy.GetParameterAsText(2) # surface used to modify feature Z values
try:
if arcpy.Describe(surface).dataType in ('Raster', 'RasterLayer'):
method = 'BILINEAR'
else:
method = 'CONFLATE_ZMAX'
arcpy.ddd.UpdateFeatureZ(in_fc, surface, method)
except arcpy.ExecuteError:
print(arcpy.GetMessages())
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?