Générer des anneaux de seuil (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Crée une classe d’entités de zones de chalandise en anneaux qui se développent autour d’entités ponctuelles jusqu’à ce que les critères soient atteints.

Utilisation

  • La taille des anneaux en sortie dépend de la valeur du paramètre Valeurs de seuil fournie pour une valeur de paramètre Variable de seuil sélectionnée du jeu de données Business Analyst actif.

  • Le paramètre Variable de seuil n’accepte que des variables de type Count. MedianImpossible d’utiliser Average, Percent ou Index.

  • Il est possible de créer plusieurs anneaux de seuil autour de chaque entrée en saisissant des valeurs individuelles dans des zones de texte distinctes de valeur de seuil.

  • La valeur du paramètre Champ d’ID identifie de manière unique l’emplacement de point autour duquel les anneaux de seuil sont créés.

Paramètres

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

Couche d’entités ponctuelles en entrée.

Feature Layer
Classe d’entités en sortie

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

Feature Class
Variable de seuil

Variable du jeu de données Business Analyst sélectionnée à laquelle la valeur de seuil sera appliquée.

Les variables de seuil doivent être numériques. Aucun autre type de statistiques n’est pris en charge.

String
Valeurs de seuil

Valeur de la variable de seuil qui détermine la taille des anneaux en sortie. Les anneaux se développent jusqu’à ce qu’ils contiennent la valeur de seuil de la variable sélectionnée.

Double
Unités de distance
(Facultatif)

Unités de distance utilisées avec les valeurs de seuil.

String
Champ d’ID
(Facultatif)

ID qui identifie de manière unique chaque point en entrée et qui est inclus dans la sortie sous forme d’attribut.

Field
Méthode en entrée
(Facultatif)

Spécifie le type de valeur qui sera utilisé pour chaque temps de trajet.

  • ValeursUne valeur constante sera utilisée (toutes les zones de chalandise seront de même taille). Il s’agit de l’option par défaut.
  • ExpressionLes valeurs d’un champ ou d’une expression sont utilisées (les zones de chalandise peuvent être de différentes tailles).
String
Expression
(Facultatif)

Expression basée sur les champs utilisés pour calculer les rayons.

SQL Expression
Pas minimal
(Facultatif)

Distance minimale entre un candidat de zone seuil et le suivant lorsque le modèle approche la valeur de seuil pour prévenir les itérations infinies.

Double
Différence du seuil en pourcentage
(Facultatif)

Différence maximale en pourcentage entre la valeur cible et la valeur seuil qui sera utilisée lors de la détermination du temps de trajet de seuil (5 % par exemple). La valeur par défaut est 5.

Double

arcpy.ba.GenerateThresholdRingTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, {units}, {id_field}, {input_method}, {expression}, {minimum_step}, {target_percent_diff})
NomExplicationType de données
in_features

Couche d’entités ponctuelles en entrée.

Feature Layer
out_feature_class

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

Feature Class
threshold_variable

Variable du jeu de données Business Analyst sélectionnée à laquelle la valeur de seuil sera appliquée.

Les variables de seuil doivent être numériques. Aucun autre type de statistiques n’est pris en charge.

String
threshold_values
[threshold_values,...]

Valeur de la variable de seuil qui détermine la taille des anneaux en sortie. Les anneaux se développent jusqu’à ce qu’ils contiennent la valeur de seuil de la variable sélectionnée.

Double
units
(Facultatif)

Unités de distance utilisées avec les valeurs de seuil.

String
id_field
(Facultatif)

ID qui identifie de manière unique chaque point en entrée et qui est inclus dans la sortie sous forme d’attribut.

Field
input_method
(Facultatif)

Spécifie le type de valeur qui sera utilisé pour chaque temps de trajet.

  • VALUESUne valeur constante sera utilisée (toutes les zones de chalandise seront de même taille). Il s’agit de l’option par défaut.
  • EXPRESSIONLes valeurs d’un champ ou d’une expression sont utilisées (les zones de chalandise peuvent être de différentes tailles).
String
expression
(Facultatif)

Expression basée sur les champs utilisés pour calculer les rayons.

SQL Expression
minimum_step
(Facultatif)

Distance minimale entre un candidat de zone seuil et le suivant lorsque le modèle approche la valeur de seuil pour prévenir les itérations infinies.

Double
target_percent_diff
(Facultatif)

Différence maximale en pourcentage entre la valeur cible et la valeur seuil qui sera utilisée lors de la détermination du temps de trajet de seuil (5 % par exemple). La valeur par défaut est 5.

Double

Exemple de code

Exemple d’utilisation de la fonction GenerateThresholdRingTradeArea (fenêtre Python)

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

import arcpy
arcpy.ba.GenerateThresholdRingTradeArea("SF_Custs",r"C:\Project1.gdb\SF_Custs_GenerateThresholdRingTradeArea","populationtotals.totpop_cy",[50000,
100000], "MILES", "STORE_ID", Values, None)

Informations de licence

  • Basic: Nécessite Business Analyst
  • Standard: Nécessite Business Analyst
  • Advanced: Nécessite Business Analyst

Rubriques connexes