Générer les anneaux de portée à partir d’une table de correspondance (Défense)

Résumé

Crée un ensemble de cercles concentriques à partir d’un centre, en fonction de valeurs stockées dans une table de correspondance.

Utilisation

• Le paramètre Range Ring Type (Type d'anneau de portée) permet de déterminer si les anneaux sont créés à partir d’un intervalle et d’un nombre d’anneaux ou à partir de distances minimale et maximale. Ces deux types d’anneaux de portée sont décrits comme suit :

  • La génération d’anneaux de portée à partir d’un intervalle signifie que vous spécifiez le nombre d'anneaux à créer. Le premier anneau correspond à une distance depuis le centre que vous spécifiez et chaque anneau suivant est créé à cette même distance de l’anneau précédent.
  • La génération d’anneaux de portée à partir des distances minimale et maximale signifie que vous spécifiez deux valeurs : une valeur minimale et une valeur maximale. Un anneau est créé pour chaque valeur, à la distance spécifiée à partir du centre.

• Les valeurs des anneaux de portée, l’intervalle ou les distances minimale et maximale, doivent être stockées dans une table, comme suit :

  • La table permettant de créer des anneaux de portée à partir d’un intervalle doit contenir au moins une ligne avec les trois champs suivants :
    • Un champ de texte contenant un nom de recherche qui sera utilisé pour choisir la ligne contenant les valeurs de l’intervalle et le nombre d'anneaux à créer. Le nom de champ par défaut est Name.
    • Un champ long, court, double ou flottant contenant une valeur pour l’intervalle auquel les anneaux seront créés. Le nom de champ par défaut est Intervals.
    • Un champ long, court ou entier contenant une valeur pour le nombre d’anneaux à créer. Le nom de champ par défaut est Rings.
  • La table permettant de créer des anneaux de portée à partir des distances minimale et maximale doit contenir au moins une ligne avec les trois champs suivants :
    • Un champ de texte contenant un nom de recherche qui sera utilisé pour choisir la ligne contenant les valeurs des distances minimale et maximale auxquelles les anneaux seront créés. Le nom de champ par défaut est Name.
    • Un champ long, court, double ou flottant contenant une valeur pour la distance minimale à laquelle un anneau sera créé. Le nom de champ par défaut est Min.
    • Un champ long, court, double ou flottant contenant une valeur pour la distance maximale à laquelle un anneau sera créé. Le nom de champ par défaut est Max.

Syntaxe

arcpy.defense.GenerateRangeRingsFromTable(in_features, in_table, out_feature_class_rings, lookup_name, range_rings_type, {out_feature_class_radials}, {number_of_radials}, {distance_units}, {lookup_name_field}, {min_range_field}, {max_range_field}, {number_of_rings_field}, {ring_interval_field})

Paramètre	Explication	Type de données
in_features	Jeu d'entités ponctuelles qui identifie le centre de l’anneau de portée. L’entrée doit comporter au moins un point.	Feature Set
in_table	Table en entrée contenant des valeurs pour créer des anneaux.	Table
out_feature_class_rings	Classe d’entités en sortie contenant les entités d'anneaux.	Feature Class
lookup_name	Ligne de la in_table contenant les valeurs en entrée des distances minimale et maximale ou du nombre d’anneaux et de l’intervalle.	String
range_rings_type	Spécifie la méthode de création des anneaux de portée. INTERVAL —Des anneaux de portée sont générés en fonction du nombre d’anneaux et de la distance entre les anneaux. Il s’agit de l’option par défaut. MIN_MAX —Des anneaux de portée sont générés en fonction d’une distance minimale et maximale.	String
out_feature_class_radials (Facultatif)	Classe d’entités contenant les entités radiales en sortie.	Feature Class
number_of_radials (Facultatif)	Nombre de lignes radiales à créer.	Long
distance_units (Facultatif)	Spécifie l’unité de mesure linéaire du paramètre ring_interval_field ou des paramètres min_range_field et max_range_field. METERS —Les mètres sont l’unité. Il s’agit de l’option par défaut. KILOMETERS —Les kilomètres sont l’unité. MILES —Les milles sont l’unité. NAUTICAL_MILES —Les milles nautiques sont l’unité. FEET —Les pieds sont l’unité. US_SURVEY_FEET —Les pieds d’arpentage U.S sont l’unité.	String
lookup_name_field (Facultatif)	Champ de la table en entrée contenant la valeur lookup_name. Le nom de champ par défaut est Name.	Field
min_range_field (Facultatif)	Champ de la table en entrée contenant la valeur de plage minimale. Le nom de champ par défaut est Min.	Field
max_range_field (Facultatif)	Champ de la table en entrée contenant la valeur de plage maximale. Le nom de champ par défaut est Max.	Field
number_of_rings_field (Facultatif)	Champ de la table en entrée contenant la valeur du nombre d'anneaux. Le nom de champ par défaut est Rings.	Field
ring_interval_field (Facultatif)	Champ de la table en entrée contenant la valeur de l’intervalle entre les anneaux. Le nom de champ par défaut est Interval.	Field

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction GenerateRangeRingsFromTable.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.GenerateRangeRingsFromTable_defense("RLOS_Observers",
                                          "rrInputTable",
                                          "OutputRR",
                                          "M4",
                                          "MIN_MAX")

Exemple 2 d’utilisation de l’outil GenerateRangeRingsFromTable (script autonome)

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

# Description: Generate range rings around active airports
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\Data.gdb"
arcpy.env.overwriteOutput = True
# Select points from airports from input
airports = "Airports"
active = "Active_Airports"
whereClause = "Active = 'Yes'"
arcpy.Select_analysis(airports, active, whereClause)
# Generate Range Rings around selected airports
outputRings = "Rings"
outputRadials = "Radials"
ringType = "MIN_MAX"
distType = "KILOMETERS"
arcpy.GenerateRangeRingsFromTable_defense(active,
                                          "rrInputTable",
                                          outputRings,
                                          "M4",
                                          ringType,
                                          outputRadials,
                                          3,
                                          distType,
                                          "Name",
                                          "Min",
                                          "Max")

Environnements

Système de coordonnées en sortie, Espace de travail courant, Espace de travail temporaire

Informations de licence

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