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

Synthèse

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

Héritage :

Cet outil est obsolète. Cette fonctionnalité a été remplacée par l’outil Générer les anneaux de portée à partir d’entités.

Utilisation

  • Le paramètre Range Ring Type (Type d'anneau de plage) permet de déterminer si les anneaux sont créés à partir d’un intervalle et d’un nombre d’anneaux ou à partir d’une distance minimale et d’une distance 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.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée (Centres)

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
Input Lookup Table (Table de correspondance en entrée)

Table en entrée contenant des valeurs pour créer des anneaux.

Table
Classe d’entités en sortie (Anneaux)

Classe d’entités en sortie contenant les entités d'anneaux.

Feature Class
Selected Name (Nom sélectionné)

Ligne de la Input Lookup Table (Table de correspondance en entrée) contenant les valeurs en entrée des distances minimale et maximale ou du nombre d’anneaux et de l’intervalle.

String
Range Ring Type (Type d'anneau de portée)

Spécifie la méthode de création des anneaux de portée.

  • IntervalleDes 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.
  • Minimum et maximumDes anneaux de portée sont générés en fonction d’une distance minimale et maximale.
String
Classe d’entités en sortie (Ligne radiale)
(Facultatif)

Classe d’entités contenant les entités radiales en sortie.

Feature Class
Nombre de lignes radiales
(Facultatif)

Nombre de lignes radiales à créer.

Long
Unités de distance
(Facultatif)

Spécifie l’unité de mesure linéaire du paramètre Ring Interval Field (Champ de l’intervalle entre les anneaux) ou des paramètres Input Table Minimum Range (Plage minimale de la table en entrée) et Input Table Maximum Range (Plage maximale de la table en entrée).

  • MètresLes mètres sont l’unité. Il s’agit de l’option par défaut.
  • KilomètresLes kilomètres sont l’unité.
  • MilesLes milles sont l’unité.
  • Milles nautiquesLes milles nautiques sont l’unité.
  • PiedsLes pieds sont l’unité.
  • Pieds d'arpentage USLes pieds d’arpentage U.S sont l’unité.
String
Champ Selected Name (Nom sélectionné) de la table en entrée
(Facultatif)

Champ de la table en entrée contenant la valeur Selected Name (Nom sélectionné). Le nom de champ par défaut est Name.

Field
Input Table Minimum Range (Plage minimale de la table en entrée)
(Facultatif)

Champ de la table en entrée contenant la valeur de plage minimale. Le nom de champ par défaut est Min.

Field
Input Table Maximum Range (Plage maximale de la table en entrée)
(Facultatif)

Champ de la table en entrée contenant la valeur de plage maximale. Le nom de champ par défaut est Max.

Field
Champ Number of Rings (Nombre d’anneaux)
(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 (Champ de l’intervalle entre les anneaux)
(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

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})
NomExplicationType 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.

  • INTERVALDes 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_MAXDes 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.

  • METERSLes mètres sont l’unité. Il s’agit de l’option par défaut.
  • KILOMETERSLes kilomètres sont l’unité.
  • MILESLes milles sont l’unité.
  • NAUTICAL_MILESLes milles nautiques sont l’unité.
  • FEETLes pieds sont l’unité.
  • US_SURVEY_FEETLes 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 suivant pour la fenêtre Python 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")