Number Features (Nombre d’entités) (Defense)

Synthèse

Ajoute un numéro séquentiel à un champ nouveau ou existant d’un ensemble d’entités en entrée.

Utilisation

  • L’utilisation d’un champ existant pour la numérotation remplacera les valeurs de ce champ.

  • Pour les entités en dehors de la valeur Zone en entrée à numéroter, la valeur Champ à numéroter (existant ou nouveau) est nulle.

  • Pour l’indication du nom d’un nouveau champ à numéroter avec le paramètre Champ à numéroter (existant ou nouveau), le premier caractère doit être un caractère alphabétique et les autres doivent être des caractères alphanumériques ou des traits de soulignement.

  • Pour la numérotation des entités autres que des points, toutes les entités qui sont comprises dans la valeur Zone en entrée à numéroter ou qui l’intersectent sont numérotées.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Entités en entrée à numéroter.

Feature Set
Field to Number (Existing or New) (Champ à numéroter [existant ou nouveau])

Champ en entrée à numéroter. Le champ peut être un champ court, long ou de texte existant, ou un nouveau champ.

Field
Input Area to Number (Zone en entrée à numéroter)
(Facultatif)

Zone qui limite les entités à numéroter ; seules les entités dans cette zone seront numérotées.

Feature Set
Méthode de tri spatial
(Facultatif)

Spécifie comment le tri spatial des entités sera effectué pour la numérotation. Les entités ne sont pas retriées dans la table.

  • Supérieur droitLes entités sont triées en partant de l’angle supérieur droit. Il s’agit de l’option par défaut.
  • Supérieur gaucheLes entités sont triées en partant de l’angle supérieur gauche.
  • Inférieur droitLes entités sont triées en partant de l’angle inférieur droit.
  • Inférieur gaucheLes entités sont triées en partant de l’angle inférieur gauche.
  • Peano, courbeLes entités sont triées à l’aide d’un algorithme de courbe de remplissage d'espace, également connu sous le nom de courbe de Peano.
  • CentreLes entités sont triées à partir d’un point central (le centre moyen est utilisé si aucun centre n’est indiqué).
  • Sens horaireLes entités sont triées à partir d’un point central, dans le sens horaire.
  • Sens anti-horaireLes entités sont triées à partir d’un point central, dans le sens anti-horaire.
  • AucunLe tri spatial n’est pas utilisé. Le même ordre que la classe d’entités est utilisé.
String
Field Type For New Field (Type de champ du nouveau champ)
(Facultatif)

Spécifie le type de champ du nouveau champ. Ce paramètre n’est utilisé que lorsque le nom de champ n’existe pas dans la table en entrée.

  • CourtLe champ sera de type court. Il s’agit de l’option par défaut.
  • LongLe champ sera de type long.
  • TexteLe champ sera de type texte.
String
Commençant par
(Facultatif)

Valeur de début de la numérotation.

Long
Incrémenter de
(Facultatif)

Valeur d’incrémentation à partir de la valeur précédente.

Long
Point central
(Facultatif)

Point central à utiliser pour le tri et la numérotation des entités.

Feature Set
Ajouter la distance et le relèvement jusqu’au centre
(Facultatif)

Détermine l’ajout ou non de champs à la sortie pour la distance et le relèvement jusqu’à un point central.

  • Ne pas ajouter la distance et le relèvementAucun champ de distance ni de relèvement n’est ajouté à la sortie. Il s’agit de l’option par défaut.
  • Ajouter la distance et le relèvementDIST_TO_CENTER et des champs ANGLE_TO_CENTER seront ajoutés à la sortie.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Classe d’entités mise à jour.

Feature Class

arcpy.defense.NumberFeatures(in_features, field_to_number, {in_area}, {spatial_sort_method}, {new_field_type}, {starting_number}, {increment_by}, {center_point}, {add_distance_and_bearing})
NomExplicationType de données
in_features

Entités en entrée à numéroter.

Feature Set
field_to_number

Champ en entrée à numéroter. Le champ peut être un champ court, long ou de texte existant, ou un nouveau champ.

Field
in_area
(Facultatif)

Zone qui limite les entités à numéroter ; seules les entités dans cette zone seront numérotées.

Feature Set
spatial_sort_method
(Facultatif)

Spécifie comment le tri spatial des entités sera effectué pour la numérotation. Les entités ne sont pas retriées dans la table.

  • URLes entités sont triées en partant de l’angle supérieur droit. Il s’agit de l’option par défaut.
  • ULLes entités sont triées en partant de l’angle supérieur gauche.
  • LRLes entités sont triées en partant de l’angle inférieur droit.
  • LLLes entités sont triées en partant de l’angle inférieur gauche.
  • PEANOLes entités sont triées à l’aide d’un algorithme de courbe de remplissage d'espace, également connu sous le nom de courbe de Peano.
  • CENTERLes entités sont triées à partir d’un point central (le centre moyen est utilisé si aucun centre n’est indiqué).
  • CLOCKWISELes entités sont triées à partir d’un point central, dans le sens horaire.
  • COUNTERCLOCKWISELes entités sont triées à partir d’un point central, dans le sens anti-horaire.
  • NONELe tri spatial n’est pas utilisé. Le même ordre que la classe d’entités est utilisé.
String
new_field_type
(Facultatif)

Spécifie le type de champ du nouveau champ. Ce paramètre n’est utilisé que lorsque le nom de champ n’existe pas dans la table en entrée.

  • SHORTLe champ sera de type court. Il s’agit de l’option par défaut.
  • LONGLe champ sera de type long.
  • TEXTLe champ sera de type texte.
String
starting_number
(Facultatif)

Valeur de début de la numérotation.

Long
increment_by
(Facultatif)

Valeur d’incrémentation à partir de la valeur précédente.

Long
center_point
(Facultatif)

Point central à utiliser pour le tri et la numérotation des entités.

Feature Set
add_distance_and_bearing
(Facultatif)

Détermine l’ajout ou non de champs à la sortie pour la distance et le relèvement jusqu’à un point central.

  • DONT_ADD_DISTANCEAucun champ de distance ni de relèvement n’est ajouté à la sortie. Il s’agit de l’option par défaut.
  • ADD_DISTANCEDIST_TO_CENTER et des champs ANGLE_TO_CENTER seront ajoutés à la sortie.
Boolean

Sortie obtenue

NomExplicationType de données
out_feature_class

Classe d’entités mise à jour.

Feature Class

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction NumberFeatures.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.NumberFeatures_defense("Structures", "structure_number", None, "LL", 
                             "SHORT")
Exemple 2 d’utilisation de l’outil NumberFeatures (script autonome)

L’exemple suivant utilise la fonction NumberFeatures dans un script de processus d’exemple.

# Convert building footprints to points and number the points.

# Import modules
import arcpy

# Set workspace
arcpy.env.workspace = r"C:/Data.gdb"

# Get building center points
result_points = "Building_Points"
arcpy.FeatureToPoint_management("Buildings_1", result_points)

# Number the points that represent buildings
arcpy.NumberFeatures_defense(result_points,
                             "building_number",
                             None,
                             "CENTER",
                             "TEXT",
                             25,
                             5,
                             "center_bldg",
                             "ADD_DISTANCE")

Informations de licence

  • Basic: Non
  • Standard: Non
  • Advanced: Oui

Rubriques connexes