Entités de chiffre par secteur (Défense)

Synthèse

Ajoute un numéro séquentiel à un champ nouveau ou existant d’un ensemble d’entités en entrée selon le groupe géographique auquel les entités appartiennent.

Utilisation

• L’ajout d’un numéro séquentiel à un champ existant remplace les valeurs de ce champ.

• Pour l’indication du nom d’un nouveau champ à numéroter dans le paramètre Field to Number (Existing or New) (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.

• Les entités en dehors de la valeur du paramètre Sector Polygons (Polygones de secteur) définissent automatiquement le paramètre Field to Number (Existing or New) (Champ à numéroter [existant ou nouveau]) sur une valeur nulle.

• Pour la numérotation des entités autres que des points, toutes les entités comprises dans la valeur du paramètre Sector Polygons (Polygones de secteur) ou qui l’intersectent sont numérotées.

• Chaque secteur démarre une nouvelle séquence de numéros en fonction d’une valeur d’incrément.

• Le paramètre Méthode de tri spatial est inactif si un champ SortMethod existe dans la valeur du paramètre Polygones de secteur. Les valeurs du champ SortMethod sont utilisées à la place. Les valeurs valides du champ SortMethod sont les suivantes :

  • UR : les entités sont triées en partant de l’angle supérieur droit.
  • UL : les entités sont triées en partant de l’angle supérieur gauche.
  • LR : les entités sont triées en partant de l’angle inférieur droit.
  • LL : les entités sont triées en partant de l’angle inférieur droit.
  • PEANO : les 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.
  • CENTER : les entités sont triées à partir d’un point central (le centre moyen est utilisé si aucun centre n’est indiqué).
  • CLOCKWISE : les entités sont triées à partir d’un point central, dans le sens horaire.
  • COUNTERCLOCKWISE : les entités sont triées à partir d’un point central, dans le sens anti-horaire.
  • NONE : le tri spatial n’est pas utilisé. Le même ordre que la classe d’entités est utilisé.

• Le paramètre Incrémenter les secteurs de est inactif si un champ StartNumber existe dans la valeur du paramètre Polygones de secteur. Les valeurs du champ StartNumber sont utilisées à la place. Le champ StartNumber doit être de type long.

• Les méthodes de tri suivantes n’utilisent pas de point central et sont appliquées par secteur :

  • Supérieur droit
  • Supérieur gauche
  • Inférieur droit
  • Inférieur gauche
  • Courbe de Peano

• Les méthodes de tri suivantes sont appliquées secteur par secteur si la valeur du paramètre Center Point (Point central) n’est pas spécifiée :

  • Centre
  • Sens horaire
  • Sens anti-horaire

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités en entrée à numéroter.	Feature Set
Polygones de secteur	Polygones en entrée représentant les secteurs à utiliser pour la numérotation.	Feature Set
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
Type de champ du nouveau champ (Facultatif)	Spécifie le type de champ à utiliser pour le nouveau champ. Ce paramètre n’est utilisé que lorsque le nom de champ n’existe pas dans la table en entrée. Court—Le champ est de type court. Il s’agit de l’option par défaut. Long—Le champ est de type long. Texte—Le champ est de type texte.	String
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 droit—Les entités sont triées en partant de l’angle supérieur droit. Il s’agit de l’option par défaut. Supérieur gauche—Les entités sont triées en partant de l’angle supérieur gauche. Inférieur droit—Les entités sont triées en partant de l’angle inférieur droit. Inférieur gauche—Les entités sont triées en partant de l’angle inférieur gauche. Courbe de Peano—Les 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. Centre—Les entités sont triées à partir d’un point central (le centre moyen est utilisé si aucun centre n’est indiqué). Sens horaire—Les entités sont triées à partir d’un point central, dans le sens horaire. Sens anti-horaire—Les entités sont triées à partir d’un point central, dans le sens anti-horaire. Aucun—Le tri spatial n’est pas utilisé. Le même ordre que la classe d’entités est utilisé.	String
Incrémenter les secteurs de (Facultatif)	Valeur à utiliser pour l'incrémentation à partir du secteur précédent.	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èvement—Aucun 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èvement—DIST_TO_CENTER et des champs ANGLE_TO_CENTER seront ajoutés à la sortie.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Classe d’entités en sortie	Classe d’entités mise à jour.	Feature Class

Python

arcpy.defense.NumberFeaturesBySector(in_features, sector_polygons, field_to_number, {new_field_type}, {spatial_sort_method}, {increment_by}, {center_point}, {add_distance_and_bearing})

Nom	Explication	Type de données
in_features	Entités en entrée à numéroter.	Feature Set
sector_polygons	Polygones en entrée représentant les secteurs à utiliser pour la numérotation.	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
new_field_type (Facultatif)	Spécifie le type de champ à utiliser pour le nouveau champ. Ce paramètre n’est utilisé que lorsque le nom de champ n’existe pas dans la table en entrée. SHORT—Le champ est de type court. Il s’agit de l’option par défaut. LONG—Le champ est de type long. TEXT—Le champ est de type texte.	String
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. Si un champ SortMethod existe dans l’entrée sector_polygons, cette valeur est utilisée à la place. UR—Les entités sont triées en partant de l’angle supérieur droit. Il s’agit de l’option par défaut. UL—Les entités sont triées en partant de l’angle supérieur gauche. LR—Les entités sont triées en partant de l’angle inférieur droit. LL—Les entités sont triées en partant de l’angle inférieur gauche. PEANO—Les 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. CENTER—Les entités sont triées à partir d’un point central (le centre moyen est utilisé si aucun centre n’est indiqué). CLOCKWISE—Les entités sont triées à partir d’un point central, dans le sens horaire. COUNTERCLOCKWISE—Les entités sont triées à partir d’un point central, dans le sens anti-horaire. NONE—Le tri spatial n’est pas utilisé. Le même ordre que la classe d’entités est utilisé.	String
increment_by (Facultatif)	Valeur à utiliser pour l'incrémentation à partir du secteur précédent. Si un champ StartNumber existe dans l’entrée sector_polygons, cette valeur est utilisée à la place.	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_DISTANCE—Aucun champ de distance ni de relèvement n’est ajouté à la sortie. Il s’agit de l’option par défaut. ADD_DISTANCE—DIST_TO_CENTER et des champs ANGLE_TO_CENTER seront ajoutés à la sortie.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_feature_class	Classe d’entités mise à jour.	Feature Class

Exemple de code

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

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.NumberFeaturesBySector("bldg_footprints", "sectors", "bldg_number")

Exemple 2 d’utilisation de NumberFeaturesBySector (scripts autonomes)

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

# Assign buildings a number based on their sector and export the first building in sector 700

# Import modules
import arcpy

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

# Number the buildings by sector
arcpy.defense.NumberFeaturesBySector("bldg_footprints",
                                     "sectors",
                                     "bldg_number",
                                     "LONG",
                                     "CENTER",
                                     100,
                                     "neighborhood_center",
                                     "DONT_ADD_DISTANCE")

# Select the first building in sector 700
select_from = "bldg_footprints"
expression = "bldg_number = 700"
arcpy.management.SelectLayerByAttribute(select_from,
                                        "NEW_SELECTION",
                                        expression)

# Export to new feature class
arcpy.conversion.FeatureClassToFeatureClass(select_from,
                                            arcpy.env.workspace,
                                            "bldg700")

Environnements

Étendue, Espace de travail courant, Espace de travail temporaire