Les variables sont des éléments du modèle qui détiennent une valeur ou une référence aux données. Les variables peuvent être utilisées comme entrées dans un outil d’analyse. L’utilisation de variables peut accélérer l’itération sur les paramètres d’un outil, car vous pouvez changer les valeurs de variable spécifiques sans ouvrir la boîte de dialogue de l’outil complet. Les variables peuvent également être utilisées pour partager des valeurs en entrée pour plusieurs outils d’analyse.
Ajouter une variable
Les variables peuvent être ajoutées à un diagramme de modèle depuis le paramètre d’un outil ou en tant que variable autonome. L’ajout d’une variable depuis le paramètre d’un outil est recommandé dans la plupart des cas car cela permet de s’assurer que la variable correcte est utilisée pour le paramètre.
Ajouter une variable depuis le paramètre d’un outil
Une variable peut être ajoutée directement depuis le paramètre d’un outil. L’ajout d’une variable depuis le paramètre d’un outil permet de s’assurer que :
- La structure de la variable et le type de données sont compatibles avec le paramètre de l’outil choisi.
- La valeur par défaut ou spécifiée par l’utilisateur pour le paramètre de l’outil est automatiquement renseignée, le cas échéant.
- Les entrées définies pour le paramètre de l’outil (par exemple, un menu d’unités prises en charge) sont disponibles dans la variable, le cas échéant.
- La variable est automatiquement connectée à l’outil sans qu’il soit nécessaire d’effectuer des étapes supplémentaires.
Procédez comme suit pour ajouter une variable depuis le paramètre d’un outil :
- Si nécessaire, suivez la procédure d’ouverture d’un modèle et d’ajout de données et d’outils.
- Sélectionnez un élément d’outil et cliquez sur Add variable (Ajouter une variable)
dans la barre d’outils de l’élément.Le menu Select parameter... (Sélectionner un paramètre...) apparaît et répertorie les paramètres de l’outil.
Si Add variable (Ajouter une variable) n’est pas disponible, cela peut signifier que vous n’êtes pas connecté à une session d’analyse ou que le modèle n’est pas actif.
- Cliquez sur le nom d’un paramètre pour le sélectionner.
La variable est ajoutée au diagramme du modèle et est connectée à l’outil. Si le paramètre possède une valeur par défaut, la valeur est ajoutée automatiquement à la variable et la variable est prête pour l’exécution (elle apparaît en bleu). S’il n’existe pas de valeur par défaut ou spécifiée par l’utilisateur, la variable est vide et n’est pas prête pour l’exécution (elle apparaît en gris). Vous pouvez ouvrir l’élément pour mettre à jour la valeur de la variable.
Ajouter une variable autonome
Une variable autonome est ajoutée à un diagramme de modèle sans association à un paramètre de l’outil. Une fois la variable ajoutée, elle doit être connectée à un outil pour pouvoir être utilisée par un paramètre de l’outil.
Pour ajouter une variable autonome au diagramme du modèle, procédez comme suit :
- Si nécessaire, suivez la procédure d’ouverture d’un modèle, de connexion à une session d’analyse et d’activation du modèle.
- Cliquez sur Add variable (Ajouter une variable) dans la barre d’outils des actions.
La boîte de dialogue Add variable (Ajouter une variable), qui contient des options pour la structure et le type de données de la variable, s’ouvre. La structure de la variable par défaut est Single value (Valeur unique) et le type de données par défaut est String (Chaîne).
Si Add variable (Ajouter une variable) n’est pas disponible, cela peut signifier que vous n’êtes pas connecté à une session d’analyse ou que le modèle n’est pas actif.
- Pour Choose the variable structure (Sélectionner la structure de la variable), sélectionnez Multiple values (Plusieurs valeurs) si nécessaire.
- Pour Choose the variable data type (Sélectionner le type de données de la variable), développez le menu et sélectionnez une autre option si nécessaire.
- Cliquez sur Add (Ajouter).
La variable est ajoutée au diagramme du modèle. Vous pouvez ouvrir l’élément pour mettre à jour la valeur de la variable et tracer une connexion entre la variable et un élément de l’outil. Les variables peuvent uniquement être connectées à des paramètres d’outils compatibles.
Connecter des variables et des outils
Une fois qu’une variable a été ajoutée au diagramme du modèle, elle doit être connectée à un outil pour être utilisée pour le paramètre d’un outil. Vous pouvez ajouter des connecteurs en les dessinant directement sur le diagramme ou par le biais de la boîte de dialogue d’un outil.
Dessiner une connection
Pour dessiner une connexion entre les éléments de variable et d’outil, procédez comme suit :
- Suivez la procédure pour ouvrir un modèle et ajouter des données, des outils et des variables si nécessaire.
- Cliquez sur le port à droite d’un élément de variable et faites-le glisser sur le port à gauche d’un élément d’outil.
Le menu Select input... (Sélectionner une entrée...) apparaît et répertorie les paramètres des outils compatibles.
- Cliquez sur le nom du paramètre dans lequel la variable sera utilisée (par exemple, Input layer [Couche en entrée]).
Un connecteur apparaît entre l’élément de variable et l’élément d’outil, et l’outil est validé. La valeur de la variable apparaît pour le paramètre spécifié lorsque la boîte de dialogue de l’outil est ouverte.
Connecter des variables par le biais d’un outil d’analyse
Procédez comme suit pour connecter des variables par le biais d’un outil d’analyse :
- Suivez la procédure pour ouvrir un modèle et ajouter des données, des outils et des variables si nécessaire.
- Sélectionnez un élément d’outil et cliquez sur Open (Ouvrir)
dans la barre d’outils des éléments ou double-cliquez sur l’élément d’outil pour l’ouvrir. - Cliquez sur Select variable (Sélectionner une variable) en regard du paramètre pour lequel vous ajoutez la variable.
La boîte de dialogue Select variable (Sélectionner une variable), qui affiche la liste des variables du modèle compatibles avec le paramètre, s’ouvre. Si aucune variable n’est répertoriée, suivez les étapes d’ajout d’une variable pour le paramètre.
- Cliquez sur une variable pour la sélectionner.
La variable est ajoutée au paramètre.
- Mettez à jour les paramètres restants, puis cliquez sur Confirm (Confirmer) pour appliquer les modifications.
Un connecteur apparaît entre l’élément de variable et l’élément d’outil, et l’outil est validé.
Mettre à jour une variable
Vous pouvez ouvrir les éléments de variable pour ajouter, mettre à jour ou supprimer la valeur de la variable.
Procédez comme suit pour mettre à jour une variable de données en entrée :
- Ouvrez la fenêtre ModelBuilder et ajoutez une variable si nécessaire.
- Sélectionnez la variable, puis cliquez sur Open (Ouvrir) dans la barre d’outils de l’élément ou double-cliquez sur l’élément pour l’ouvrir.
Une boîte de dialogue affichant le type de variable s’ouvre.
- Effectuez l’une des opérations suivantes :
- Pour les variables de type unité surfacique, unité linéaire ou unité de temps, saisissez un nombre dans la zone de texte ou utilisez les flèches orientées vers le haut et vers le bas pour augmenter ou diminuer la valeur. Cliquez sur la valeur de l’unité pour ouvrir un menu et sélectionnez une autre unité dans la liste.
- Pour les variables de type booléen, cliquez sur la case d’option en regard de la valeur non sélectionnée.
- Pour les variables de type double ou entier, saisissez un nombre dans la zone de texte ou utilisez les flèches orientées vers le haut et vers le bas pour augmenter ou diminuer la valeur.
- Pour les variables de type double (plusieurs valeurs), saisissez un ou plusieurs nombres dans la zone de texte, puis cliquez sur Add (Ajouter) ou appuyez sur Entrée entre chaque nombre. Pour supprimer des nombres, cliquez sur le bouton de suppression
correspondant à la valeur. - Pour les variables d’enrichissement, cliquez sur Variable pour ouvrir la fenêtre Data Browser (Navigateur de données). Sélectionnez une ou plusieurs variables dans la fenêtre en utilisant les filtres de région, d’ensemble de données ou de catégorie si nécessaire.
- Pour les variables de couche ou table d’entités, cliquez sur le jeu de données en entrée ou sur le bouton Layer (Couche) et sélectionnez une couche dans la liste ou accédez à une couche prise en charge pour la sélectionner.
Remarque :
Si la variable de couche d’entités est déjà connectée à un ou plusieurs outils d’analyse, seuls les jeux de données compatibles avec les outils et les paramètres sont disponibles. Si les paramètres ne prennent pas en charge les mêmes entités (par exemple, un paramètre ne prenant en charge que les points et un autre uniquement les polygones), la variable ne sera pas capable de déterminer quelles couches sont compatibles et cela peut générer une erreur pour un ou plusieurs outils.
- Pour les variables de type chaîne, saisissez une valeur textuelle dans la zone de texte. Si la variable est déjà connectée à un outil d’analyse, la variable peut afficher un menu d’options.
- Cliquez sur Confirm (Confirmer).
La variable est mise à jour et validée.
Structures de variable
Les variables prennent en charge les structures suivantes :
- Single value (Valeur unique) : prend en charge l’ajout d’une valeur unique d’un type de données unique.
- Multiple value (Plusieurs valeurs) : prend en charge l’ajout de plusieurs valeurs d’un type de données unique. Actuellement, les structures à plusieurs valeurs prennent uniquement en charge les types de données Double. Par exemple, une variable de type double (plusieurs valeurs) peut être utilisée dans le paramètre Distance values (Valeurs de distance) pour l’outil Créer des zones tampons.
Remarque :
Les paramètres prenant en charge les variables doubles à plusieurs valeurs prennent également en charge une ou plusieurs variables doubles à valeur unique.
Types de données pris en charge
Les types de données suivants sont pris en charge :
- Unité surfacique : nombres et unités carrées.
- Booléen : True (Vrai) ou False (Faux). La valeur True (Vrai) équivaut à l’activation d’un bouton bascule ou à la sélection d’une case à cocher. La valeur False (Faux) équivaut à la désactivation d’un bouton bascule ou à la désélection d’une case à cocher. Pour les paramètres avec case d’option, connectez un paramètre d’outil afin d’afficher l’étiquette de la boîte de dialogue de l’outil.
- Double : nombres avec décimales. Ce type de données est pris en charge pour les structures à valeur unique et à plusieurs valeurs.
- Variables d’enrichissement : variables de données démographiques et de style de vie. Les variables d’enrichissement peuvent être ajoutées à partir du paramètre de l’outil uniquement pour Enrichir la couche.
- Feature layer (Couche d’entités) : élément de couche d’entités hébergée.
- Integer (Entier) : nombres sans décimales. Les valeurs négatives sont prises en charge dans la variable, mais ne sont pas prises en charge pour tous les paramètres de l’outil.
- Unité linéaire : nombres et unités de distance.
- String (Chaîne) : caractères alphanumériques et spéciaux. Lorsque la variable est connectée à un paramètre de l’outil, un menu des options prises en charge est disponible.
- Table : éléments de table hébergée.
- Unité de temps : nombres et unités de temps.
Limitations
Les paramètres des outils acceptant les variables de type chaîne possèdent des listes définies de valeurs en entrée acceptées (par exemple un menu d’unités prises en charge). Il est recommandé d’ajouter des variables de type chaîne à partir du paramètre d’un outil ou de connecter la variable au paramètre d’un outil avant de mettre à jour la valeur de la variable. Saisir une valeur dans une variable de type chaîne non connectée peut générer des erreurs.
Les paramètres des outils suivants ne permettent pas d’ajouter une variable à partir du paramètre, mais permettent de connecter une variable autonome :
| Outil | Paramètre | Type de variable |
|---|---|---|
Joindre les entités | Target layer (Couche cible) | Table ou couche d’entités |
Jointure de couche | ||
Calculer l’indice composite | Table ou entités en entrée | |
Filtrer par attributs | Jeu de données en entrée | |
Calculer un champ | Jeu de données en entrée | |
Agréger les points | Taille du groupe | Unité linéaire |
Synthétiser - À l’intérieur | Taille du groupe | |
Enrichir la couche | Valeur de mesure | |
Générer des tessellations | Taille du groupe | Unité surfacique ou unité linéaire |
Vous avez un commentaire à formuler concernant cette rubrique ?