Entités de lettre (Défense)

Synthèse

Ajoute une lettre séquentielle à un champ nouveau ou existant d’un ensemble d’entités.

Utilisation

  • L’ajout d’une lettre séquentielle à un champ existant remplace les valeurs de ce champ.

  • Les entités en dehors de la valeur du paramètre Zone en entrée à lettrer définissent automatiquement le paramètre Champ à lettrer (existant ou nouveau) sur la valeur nulle.

  • Pour l’indication du nom d’un nouveau champ à lettrer avec le paramètre Champ à lettrer (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.

  • Lorsque vous lettrez des entités autres que des points, toutes les entités qui sont comprises dans la valeur Zone en entrée à lettrer ou qui l’intersectent sont lettrées.

Paramètres

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

Entités en entrée à lettrer.

Feature Set
Champ à lettrer (existant ou nouveau)

Champ en entrée à lettrer. Ce champ doit être un champ de texte nouveau ou existant.

Field
Zone en entrée à lettrer
(Facultatif)

Zone qui limite les entités à lettrer ; seules les entités dans cette zone seront lettrées.

Feature Set
Méthode de tri spatial
(Facultatif)

Spécifie comment le tri spatial des entités sera effectué pour le lettrage. 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.
  • Courbe de 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.
  • 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
Format de lettrage
(Facultatif)

Spécifie le format d’étiquetage utilisé pour chaque entité.

  • Excel (A, B, C...)Un caractère alphabétique (par exemple, A, B, C) est utilisé. Il s’agit de l’option par défaut.
  • Grille (AA, AB, AC...)Un caractère alphabétique constant avec un second caractère alphabétique incrémentiel (par exemple, AA, AB, AC) sont utilisés.
  • Grille alternée (AA, BB, CC...)Un caractère alphabétique double incrémenté pour chaque entité (par exemple, AA, BB, CC) est utilisé.
String
Première lettre
(Facultatif)

Valeur utilisée pour démarrer le lettrage.

String
Ignorer des lettres
(Facultatif)

Valeurs à omettre de la séquence de lettrage.

String
Point central
(Facultatif)

Point central à utiliser pour le tri et le lettrage 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.LetterFeatures(in_features, field_to_letter, {in_area}, {spatial_sort_method}, {lettering_format}, {starting_letter}, {omit_letters}, {center_point}, {add_distance_and_bearing})
NomExplicationType de données
in_features

Entités en entrée à lettrer.

Feature Set
field_to_letter

Champ en entrée à lettrer. Ce champ doit être un champ de texte nouveau ou existant.

Field
in_area
(Facultatif)

Zone qui limite les entités à lettrer ; seules les entités dans cette zone seront lettrées.

Feature Set
spatial_sort_method
(Facultatif)

Spécifie comment le tri spatial des entités sera effectué pour le lettrage. 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
lettering_format
(Facultatif)

Spécifie le format d’étiquetage utilisé pour chaque entité.

  • A_B_CUn caractère alphabétique (par exemple, A, B, C) est utilisé. Il s’agit de l’option par défaut.
  • AA_AB_ACUn caractère alphabétique constant avec un second caractère alphabétique incrémentiel (par exemple, AA, AB, AC) sont utilisés.
  • AA_BB_CCUn caractère alphabétique double incrémenté pour chaque entité (par exemple, AA, BB, CC) est utilisé.
String
starting_letter
(Facultatif)

Valeur utilisée pour démarrer le lettrage.

String
omit_letters
[omit_letters,...]
(Facultatif)

Valeurs à omettre de la séquence de lettrage.

String
center_point
(Facultatif)

Point central à utiliser pour le tri et le lettrage 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 LetterFeatures (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction LetterFeatures.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.LetterFeatures("bldg_footprints", "bldg_letter")
Exemple 2 d’utilisation de LetterFeatures (script autonome)

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

# Select buildings with a footprint over 5000 square feet and assign a letter

# Import system modules
import arcpy

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

# Project data
out_coordinate_system = arcpy.SpatialReference(3395)
proj_bldg = "bldg_footprint_proj"
arcpy.management.Project("Buildings",
                         proj_bldg,
                         out_coordinate_system)

# Calculate area
arcpy.management.CalculateGeometryAttributes(proj_bldg,
                                             "area AREA",
                                             '',
                                             "SQUARE_FEET_US")

# Export to a new feature class
expression = "area >= 5000"
arcpy.conversion.FeatureClassToFeatureClass(proj_bldg,
                                            arcpy.env.workspace,
                                            "bldg_over_5000",
                                            expression)

# Letter the buildings
arcpy.defense.LetterFeatures("bldg_over_5000",
                             "bldg_letter",
                              None,
                              "CENTER",
                              "A_B_C",
                              "A",
                              "D",
                              "neighborhood_center",
                              "ADD_DISTANCE")