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.
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 requérir d’é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.
Procédez comme suit pour ajouter une variable autonome au diagramme du modèle :
- 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
Procédez comme suit pour dessiner une connexion entre les éléments de variable et d’outil :
- 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 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 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. Les variables de valeur unique sont prises en charge pour les types de données couche d’entités, table, double, entier, chaîne et unité linéaire.
- 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 :
- Double : nombres avec décimales. Ce type de données est pris en charge pour les structures à valeur unique et à plusieurs valeurs.
- 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.
- String (Chaîne) : caractères alphanumériques et spéciaux.
- Table : éléments de table hébergée.
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 |
Vous avez un commentaire à formuler concernant cette rubrique ?