Ajuster les valeurs Z 3D (Gestion des données)

Synthèse

Modifie les valeurs Z des entités 3D.

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

• Vous pouvez inverser les valeurs Z de la bathymétrie et d'autres mesures de sous-surfaces utilisant des valeurs positives pour représenter la profondeur.

• Utilisez les paramètres Conversion - unités de départ et Conversion - unités d'arrivée pour convertir les valeurs Z d'une unité de mesure commune en une autre.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités 3D dont les valeurs Z doivent être modifiées.	Feature Layer
Inverser le signe des valeurs Z (Facultatif)	Indique si les entités seront inversées le long de l'axe Z. REVERSE—Le signe des valeurs Z est inversé, ce qui provoque le retournement des entités. NO_REVERSE—Le signe des valeurs Z n'est pas inversé ; il est conservé. Il s’agit de l’option par défaut.	String
Ajuster la valeur Z (Facultatif)	Valeur numérique ou champ issu des entités en entrée à utiliser pour ajuster la valeur Z de chaque sommet dans les entités en entrée. Une valeur positive décale l'entité vers une position supérieure, tandis qu'un nombre négatif le décale vers une position inférieure le long de l'axe des Z.	Double; Field
Conversion - unités de départ (Facultatif)	Spécifie les unités existantes des valeurs Z. Ce paramètre est utilisé conjointement avec le paramètre Conversion - unités d'arrivée. Millimètres—Les unités sont les millimètres. Centimètres—Les unités sont les centimètres. Mètres—L’unité sera le mètre. Pouces—Les unités sont les pouces. Pieds—L’unité sera le pied. Yards—Les unités sont les yards. Brasses—Les unités sont les brasses.	String
Conversion - unités d'arrivée (Facultatif)	Spécifie les unités vers lesquelles les valeurs Z existantes seront converties. Millimètres—Les unités sont les millimètres. Centimètres—Les unités sont les centimètres. Mètres—L’unité sera le mètre. Pouces—Les unités sont les pouces. Pieds—L’unité sera le pied. Yards—Les unités sont les yards. Brasses—Les unités sont les brasses.	String

Sortie obtenue

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

Python

arcpy.management.Adjust3DZ(in_features, {reverse_sign}, {adjust_value}, {from_units}, {to_units})

Nom	Explication	Type de données
in_features	Entités 3D dont les valeurs Z doivent être modifiées.	Feature Layer
reverse_sign (Facultatif)	Indique si les entités seront inversées le long de l'axe Z. REVERSE—Le signe des valeurs Z est inversé, ce qui provoque le retournement des entités. NO_REVERSE—Le signe des valeurs Z n'est pas inversé ; il est conservé. Il s’agit de l’option par défaut.	String
adjust_value (Facultatif)	Valeur numérique ou champ issu des entités en entrée à utiliser pour ajuster la valeur Z de chaque sommet dans les entités en entrée. Une valeur positive décale l'entité vers une position supérieure, tandis qu'un nombre négatif le décale vers une position inférieure le long de l'axe des Z.	Double; Field
from_units (Facultatif)	Spécifie les unités existantes des valeurs Z. Ce paramètre est utilisé avec le paramètre to_units. MILLIMETERS—Les unités sont les millimètres. CENTIMETERS—Les unités sont les centimètres. METERS—L’unité sera le mètre. INCHES—Les unités sont les pouces. FEET—L’unité sera le pied. YARDS—Les unités sont les yards. FATHOMS—Les unités sont les brasses.	String
to_units (Facultatif)	Spécifie les unités vers lesquelles les valeurs Z existantes seront converties. MILLIMETERS—Les unités sont les millimètres. CENTIMETERS—Les unités sont les centimètres. METERS—L’unité sera le mètre. INCHES—Les unités sont les pouces. FEET—L’unité sera le pied. YARDS—Les unités sont les yards. FATHOMS—Les unités sont les brasses.	String

Sortie obtenue

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 Adjust3DZ (fenêtre Python)

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

arcpy.env.workspace = "C:/data"
arcpy.Adjust3DZ_management("subsurface_pts.shp", "REVERSE", 0, "METERS", "FEET")

Exemple 2 d'utilisation de l'outil Adjust3DZ (script autonome)

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

arcpy.env.workspace = "C:/data"
arcpy.Adjust3DZ_management("subsurface_pts.shp", "REVERSE", 0, "METERS", "FEET")

Environnements

Espace de travail courant, Étendue