Valeur égale à (ModelBuilder)

Résumé

Évalue une valeur en entrée par rapport à une valeur unique, une liste de valeurs ou une plage de valeurs à l’aide d’un opérateur de comparaison défini.

Pour en savoir plus sur le fonctionnement de l’outil Si Valeur égale à dans ModelBuilder

Utilisation

  • Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

  • L’outil possède deux sorties booléennes : True (vrai) et False (faux). Selon la condition en cours de vérification, une des deux sorties booléennes est vraie et l’autre est fausse après l’exécution de l’outil. Ces sorties booléennes doivent être définies comme condition préalable aux outils en aval à exécuter si une des conditions préalables est vraie.

  • Remarque :

    Dans ArcGIS, la plupart des outils sont vides (sans couleur) lorsqu’ils sont ajoutés à un modèle. Toutefois, ce n'est pas le cas des outils Si Valeur égale à, Données présentes, Recueillir des valeurs et Fusionner des branches. L’outil Si Valeur égale à est toujours prêt à être exécuté (avec couleur). En effet, l’entrée de l’outil, même vide, est considérée comme valide pour la comparaison.

Syntaxe

arcpy.mb.ValueIsIfThenElse({input_value}, {value_test}, {comparison_type}, {values}, {range_values}, {comparison_value})
ParamètreExplicationType de données
input_value
(Facultatif)

Valeur en entrée à évaluer.

Any Value
value_test
(Facultatif)

Spécifie le type de l’opérateur de comparaison à utiliser.

  • IS_EQUAL_TO_ANYDétermine si la valeur en entrée est égale à une des valeurs de comparaison. Il s’agit de l’option par défaut.
  • IS_NOT_EQUAL_TO_ANYDétermine si la valeur en entrée n’est pas égale à une des valeurs de comparaison.
  • IS_NOT_EQUAL_TO_ALLDétermine si la valeur en entrée n’est pas égale à toutes les valeurs de comparaison.
  • IS_BETWEEN_ANYDétermine si la valeur en entrée est comprise dans une plage de valeurs de comparaison.
  • IS_NOT_BETWEEN_ANY Détermine si la valeur en entrée n’est pas comprise dans une plage de valeurs de comparaison.
  • IS_LESS_THANDétermine si la valeur en entrée est inférieure à la valeur de comparaison.
  • IS_GREATER_THANDétermine si la valeur en entrée est supérieure à la valeur de comparaison.
  • IS_LESS_THAN_OR_EQUALDétermine si la valeur en entrée est inférieure ou égale à la valeur de comparaison.
  • IS_GREATER_THAN_OR_EQUALDétermine si la valeur en entrée est supérieure ou égale à la valeur de comparaison.
  • IS_EMPTYDétermine si la valeur en entrée est vide.
String
comparison_type
(Facultatif)

Spécifie le type de la comparaison de données à utiliser.

  • STRING_CASE_INSENSITIVELa valeur en entrée est comparée aux valeurs de comparaison en tant que chaîne ne respectant pas la casse. Il s’agit de l’option par défaut.
  • STRING_CASE_SENSITIVELa valeur en entrée est comparée aux valeurs de comparaison en tant que chaîne respectant la casse.
  • LONGLa valeur numérique en entrée est comparée aux valeurs de comparaison en tant qu’entier de type Long.
  • DOUBLE La valeur numérique en entrée est comparée aux valeurs de comparaison en tant qu’entier de type Double.
  • AUTOLe type de données en entrée est vérifié, puis une comparaison utilisant le type de données adéquat est effectuée. Par exemple, pour des valeurs en entrée et des valeurs de comparaison de type chaîne, la comparaison de chaînes est appliquée ; si ces valeurs sont des entiers de type Long, la comparaison d’entiers Long est appliquée et, pour des entiers de type Double, la comparaison d’entiers Double. Pour tous les autres types de données en entrée, la méthode de comparaison de chaînes est utilisée par défaut.
String
values
[values,...]
(Facultatif)

Liste des valeurs à comparer à la valeur en entrée.

Any Value
range_values
[[Any Value, Any Value],...]
(Facultatif)

Spécifie les valeurs de plage à comparer à la valeur en entrée.

  • Minimum : la valeur en entrée est comparée à la valeur minimale dans la plage.
  • Maximum : la valeur en entrée est comparée à la valeur maximale dans la plage.
Value Table
comparison_value
(Facultatif)

Valeur unique à comparer à la valeur en entrée.

Any Value

Sortie dérivée

NomExplicationType de données
true

Si le critère spécifié est rempli, ce paramètre est défini sur True (Vrai).

Booléen
false

Si le critère spécifié n’est pas rempli, ce paramètre est défini sur False (Vrai).

Booléen

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

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