Classification et régression basées sur une forêt (Outils de serveur GeoAnalytics)

Résumé

Crée des modèles et génère des prévisions à l’aide d’une adaptation de l’algorithme de forêt aléatoire développé, qui est une méthode de Machine Learning supervisée développée par Leo Breiman et Adele Cutler. Les prédictions peuvent être réalisées sur des variables catégorielles (classification) ou des variables continues (régression). Les variables explicatives sont des champs de la table attributaire des entités d’entraînement. Outre la validation des performances du modèle en fonction des données d’entraînement, vous pouvez aussi réaliser des prévisions sur des entités.

Héritage :

L’extension ArcGIS GeoAnalytics Server devient obsolète dans ArcGIS Enterprise. La version finale de GeoAnalytics‏ Server a été incluse avec ArcGIS Enterprise 11.3. Cet outil de géotraitement est accessible via ArcGIS Enterprise 11.3 et versions antérieures.

Utilisation

Cet outil permet de créer des centaines d’arbres, regroupés sous le nom d’ensemble d’arbres décisionnels, en vue de créer un modèle à utiliser par la suite pour la prévision. Chaque arbre décisionnel est créé à partir de portions des données d'origine (entraînement) générées de manière aléatoire. Chaque arbre génère sa propre prévision et ses votes relatifs à un résultat. Le modèle de forêt tient compte des votes de tous les arbres décisionnels dans la prévision ou le classement du résultat d’un échantillon inconnu. Cela est important, car les arbres individuels peuvent avoir des problèmes de sur-ajustement à un modèle ; cependant, l’association de plusieurs arbres dans une forêt pour prévision règle le problème de sur-ajustement associé à un seul arbre.
Cet outil peut être utilisé en deux modes opératoires. Avec le mode Train (Entraîner), vous pouvez évaluer les performances de différents modèles et examiner une diversité de variables explicatives et de paramètres d’outil. Lorsque vous avez trouvé un modèle adéquat, vous pouvez utiliser le mode Train and Predict (Entraîner et prévoir).
Cet outil ne prend pas en charge les entrées avec des champs de type date uniquement ou heure uniquement.
Cet outil dynamique convient parfaitement aux jeux de données volumineux. Pour un entraînement optimal, il est recommandé d'exécuter l’outil sur plusieurs centaines d'entités au minimum. Il n’est pas approprié pour les jeux de données très peu volumineux.
Input Training Features (Entités d’entraînement en entrée) peuvent être des tables, des points, des lignes ou des entités surfaciques. L'outil ne fonctionne pas avec les données multi-parties.
Les entités qui comportent une ou plusieurs valeurs nulles ou encore des valeurs de chaîne vide dans les champs de prévision ou explicatifs seront exclues de la sortie. Vous pouvez modifier les valeurs à l’aide de l’outil Calculate Field (Calculer un champ), si nécessaire.
Cet outil produit une variété de sorties selon les modes de fonctionnement suivants :
- Train (Entraîner) produit les deux sorties suivantes :
  - Output trained features—Contient toutes les entités Input Training Features (Entités d’entraînement en entrée) utilisées dans le modèle créé, ainsi que toutes les variables explicatives utilisées dans le modèle. Elle contient également les prévisions pour toutes les entités utilisées pour entraîner le modèle, ce qui peut être utile lors de l’évaluation des performances du modèle créé.
  - Tool summary messages—Messages pour vous aider à comprendre les performances du modèle créé. Les messages contiennent des informations sur les caractéristiques du modèle, l’importance des variables et les diagnostics de validation.
- Train and Predict (Entraîner et prévoir) produit les trois sorties suivantes :
  - Output trained features—Contient toutes les entités Input Training Features (Entités d’entraînement en entrée) utilisées dans le modèle créé, ainsi que toutes les variables explicatives utilisées dans le modèle. Elle contient également les prévisions pour toutes les entités utilisées pour entraîner le modèle, ce qui peut être utile lors de l’évaluation des performances du modèle créé.
  - Output predicted features—Couche des résultats prévus. Les prévisions sont appliquées à la couche à prévoir (avec l’option Input Prediction Features (Entités de prévision en entrée)) à l’aide du modèle généré via la couche d’entraînement.
  - Tool summary messages—Messages pour vous aider à comprendre les performances du modèle créé. Les messages contiennent des informations sur les caractéristiques du modèle, l’importance des variables et les diagnostics de validation.
Vous pouvez utiliser le paramètre Create Variable Importance Table (Créer une table de l’importance des variables) pour créer une table affichant l’importance des variables pour l’évaluation. Les valeurs des 20 variables les plus importantes sont également indiquées dans la fenêtre de messages.
Les variables explicatives peuvent provenir des champs et doivent contenir une variété de valeurs. Si la variable explicative est catégorielle, la case à cocher Categorical (Catégoriel) doit être sélectionnée (les variables de type chaîne sont automatiquement sélectionnées). Les variables explicatives catégorielles sont limitées à 60 valeurs uniques, sachant que les performances du modèle sont améliorées si le nombre de catégories est restreint. Pour une taille de données indiquée, plus une variable contient de catégories, plus elle sera susceptible de monopoliser le modèle et d’entraîner des résultats prévisionnels moins efficaces.
Lors de l’appariement de variables explicatives, Training Field (Champ d’entraînement) et Prediction Field (Champ de prévision) doivent comporter des champs du même type (par exemple, un champ double dans Training Field (Champ d’entraînement) doit être apparié à un champ double dans Prediction Field (Champ de prévision)).
Les modèles de forêt n’extrapolent pas. Ils peuvent seulement classer ou effectuer une prédiction en fonction de la plage de valeurs avec laquelle le modèle a été préparé. Entraînez le modèle avec des entités d’entraînement et des variables explicatives qui figurent dans la plage de vos entités et variables cibles. L’exécution de l’outil échoue si les variables explicatives de la prévision possèdent des catégories qui n’existent pas dans les entités d’entraînement.
La valeur par défaut du paramètre Number of Trees (Nombre d’arbres) est 100. L’augmentation du nombre d’arbres dans le modèle de forêt permet d’obtenir une prévision plus précise, mais son calcul est plus long.
Prise en charge d’une seule couche pour l’entraînement et d’une seule couche pour la prévision. Pour combiner plusieurs jeux de données en un seul, utilisez les outils Build Multi-Variable Grid (Construire une grille à variables multiples) et Enrich from Multi-Variable Grid (Enrichir à l’aide d’une grille à variables multiples) afin de générer les données en entrée.
Cet outil de géotraitement est mis en œuvre par ArcGIS GeoAnalytics Server. L’analyse est réalisée dans GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.
Lorsque vous exécutez des outils GeoAnalytics Server, l’analyse est effectuée dans GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne se trouvent pas en local sur GeoAnalytics Server sont transférées sur GeoAnalytics Server avant l’analyse. Autrement dit, l’exécution d’un outil prend plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

En savoir plus sur le partage des données dans votre portail.

En savoir plus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager

Etiqueter	Explication	Type de données
Type de prédiction	Spécifie le mode opératoire de l’outil. Vous pouvez exécuter l’outil pour entraîner un modèle dédié à l’évaluation des performances, à la prévision d'entités ou à la création d'une surface de prévision, entraînement uniquement—Un modèle est formé, sans génération de prédictions. Cette option permet d’évaluer la précision de votre modèle avant de générer des prévisions. Elle génère des diagnostics relatifs au modèle dans la fenêtre de messages, ainsi qu’un diagramme sur l’importance des variables. Il s'agit du paramètre par défaut. Entraîner et prévoir—Les prévisions ou les classifications seront générées pour les entités. Des variables explicatives doivent être fournies pour les entités d’entraînement et les entités à prévoir. Cette option génère une classe d’entités, des diagnostics relatifs au modèle dans la fenêtre de messages, ainsi qu’une table facultative sur l’importance des variables.	String
Entités d’entraînement en entrée	Couche contenant le paramètre Variable to Predict (Variable à prévoir) et les champs des variables d’entraînement explicatives.	Record Set
Nom des entités en sortie (Facultatif)	Nom de la couche d’entités en sortie.	String
Variable à prévoir (Facultatif)	Variable du paramètre Input Training Features (Entités d’entraînement en entrée) contenant les valeurs à utiliser pour entraîner le modèle. Ce champ contient des valeurs (d'entraînement) connues de la variable qui sera utilisée pour réaliser des prévisions à des emplacements inconnus.	Field
Traiter les variables comme catégorielles (Facultatif)	Indique si la valeur du paramètre Variable to Predict (Variable à prévoir) est une variable catégorielle. Activé—La valeur du paramètre Variable to Predict (Variable à prévoir) est une variable catégorielle et l’outil exécute une classification. Décoché—La valeur du paramètre Variable to Predict (Variable à prévoir) est continue et l’outil exécute une régression. Il s’agit de l’option par défaut.	Boolean
Variables explicatives (Facultatif)	Liste des champs qui représentent les variables explicatives utilisées pour prévoir la valeur ou la catégorie de Variable to Predict (Variable à prévoir). Cochez la case Categorical (Catégoriel) des variables qui représentent des classes ou des catégories (comme l’occupation du sol, la présence ou l’absence). Colonnes de la table de valeurs : Variable—A list of fields representing the explanatory variables that help predict the value of the variable to predict. Categorical—Specifies whether the variable is categorical. Categorical—The explanatory field is a categorical variable. Numeric—The explanatory field is a continuous variable.	Value Table
Créer une table de l’importance des variable (Facultatif)	Indique si la table en sortie contient des informations décrivant l’importance de chaque variable explicative utilisée dans le modèle. Activé—La table en sortie contient des informations pour chaque variable explicative. Décoché—La table en sortie ne contient pas d’informations pour chaque variable explicative. Il s’agit de l’option par défaut.	Boolean
Entités de prédiction en entrée (Facultatif)	Couche d’entités représentant les emplacements où se produisent les prévisions. Cette couche d’entités doit également comporter toutes les variables explicatives fournies en tant que champs et correspondant aux champs utilisés issus des données d’entraînement.	Record Set
Apparier les variables explicatives (Facultatif)	Liste des Explanatory Variables (Variables explicatives) spécifiées dans les Input Training Features (Entités d’entraînement en entrée) à droite et de leurs champs correspondants dans Input Prediction Features (Entités de prévision en entrée) à gauche. Colonnes de la table de valeurs : Training Field—A list of variables that correspond to the training variables that will be made to make predictions. Prediction Field—The list of variables from the input training features that were used to train the model.	Value Table
Nombre d'arbres (Facultatif)	Nombre d'arbres à créer dans le modèle de forêt. Un grand nombre d’arbres produit habituellement des résultats plus précis, mais le calcul du modèle prend davantage de temps. Le nombre d’arbres par défaut est défini sur 100.	Long
Taille minimale des feuilles (Facultatif)	Nombre minimal d’observations requises pour conserver une feuille (c’est-à-dire le nœud terminal d’un arbre sans fractionnements supplémentaires). La valeur minimale par défaut pour une régression est 5 ; la valeur par défaut est 1 pour une classification. Pour les jeux de données très volumineux, l’augmentation de ces nombres aura pour effet de réduire le temps d’exécution de l’outil.	Long
Profondeur d’arbre maximale (Facultatif)	Nombre maximum de fractionnements pouvant être effectués pour un arbre. Si la profondeur maximum est élevée, le nombre de fractionnements créés augmente, ce qui accroît les risques de sur-ajustement du modèle. La valeur par défaut est dynamique ; elle dépend du nombre d'arbres créés et du nombre de variables incluses.	Long
Données disponibles par arbre (%) (Facultatif)	Pourcentage d’éléments Input Training Features (Entités d’entraînement en entrée) utilisés pour chaque arbre décisionnel. La valeur par défaut est 100 pour cent des données. Les échantillons de chaque arbre sont sélectionnés de manière aléatoire dans les deux tiers des données spécifiées. Chaque arbre décisionnel de la forêt est créé à partir d’un échantillon aléatoire ou d’un sous-ensemble (équivalant approximativement aux deux tiers) des données d’entraînement disponibles. Si un pourcentage plus faible de données est utilisé en entrée pour chaque arbre décisionnel, l’outil s’exécute plus rapidement sur les jeux de données très volumineux.	Long
Nombre de variables échantillonnées de manière aléatoire (Facultatif)	Nombre de variables explicatives utilisées pour créer chaque arbre décisionnel. Chaque arbre décisionnel de la forêt est créé à l'aide d’un sous-ensemble aléatoire des variables explicatives spécifiées. Une augmentation du nombre de variables utilisées dans chaque arbre décisionnel accroît les risques de sur-ajustement de votre modèle, notamment s’il comporte au moins une variable dominante. Si Variable to Predict (Variable à prévoir) est numérique, il est courant d’utiliser la racine carrée du nombre total de variables explicatives ou, si Variable to Predict (Variable à prévoir) est catégorielle, de diviser le nombre total de variables explicatives par 3.	Long
Données d’entraînement exclues pour la validation (%) (Facultatif)	Pourcentage (entre 10 pour cent et 50 pour cent) des Input Training Features (Entités d’entraînement en entrée) à réserver en guise de jeu de données de test pour la validation. Le modèle sera formé sans ce sous-ensemble aléatoire de données et les valeurs observées pour ces entités seront comparées aux valeurs prévues. La valeur par défaut est 10 pour cent.	Long
Stockage des données (Facultatif)	Indique l’instance ArcGIS Data Store dans laquelle la sortie sera stockée. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. Stockage de Big Data spatio-temporelles—La sortie sera stockée dans un spatiotemporal Big Data store. Il s’agit de l’option par défaut. Relational data store—La sortie sera stockée dans un data store relationnel.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Entités formées en sortie	La sortie contenant les variables en entrée utilisées pour l’entraînement, ainsi que la variable observée pour prévoir le paramètre, et les prévisions associées pouvant être utilisées pour évaluer davantage les performances du modèle.	Record Set
Table de l’importance des variables	Table contenant des informations décrivant l’importance de chaque variable explicative à utiliser dans le modèle créé.	Record Set
Entités prévues en sortie	Couche qui recevra les prévisions du modèle.	Record Set

arcpy.geoanalytics.Forest(prediction_type, in_features, {output_trained_name}, {variable_predict}, {treat_variable_as_categorical}, {explanatory_variables}, {create_variable_importance_table}, {features_to_predict}, {explanatory_variable_matching}, {number_of_trees}, {minimum_leaf_size}, {maximum_tree_depth}, {sample_size}, {random_variables}, {percentage_for_validation}, {data_store})

Nom	Explication	Type de données
prediction_type	Spécifie le mode opératoire de l’outil. Vous pouvez exécuter l’outil pour entraîner un modèle dédié à l’évaluation des performances, à la prévision d'entités ou à la création d'une surface de prévision, `TRAIN`—Un modèle est formé, sans génération de prédictions. Cette option permet d’évaluer la précision de votre modèle avant de générer des prévisions. Elle génère des diagnostics relatifs au modèle dans la fenêtre de messages, ainsi qu’un diagramme sur l’importance des variables. Il s'agit du paramètre par défaut. `TRAIN_AND_PREDICT`—Les prévisions ou les classifications seront générées pour les entités. Des variables explicatives doivent être fournies pour les entités d’entraînement et les entités à prévoir. Cette option génère une classe d’entités, des diagnostics relatifs au modèle dans la fenêtre de messages, ainsi qu’une table facultative sur l’importance des variables.	String
in_features	Classe d’entités contenant le paramètre `variable_predict` et les champs des variables d’entraînement explicatives.	Record Set
output_trained_name (Facultatif)	Nom de la couche d’entités en sortie.	String
variable_predict (Facultatif)	Variable du paramètre `in_features` contenant les valeurs à utiliser pour entraîner le modèle. Ce champ contient des valeurs (d'entraînement) connues de la variable qui sera utilisée pour réaliser des prévisions à des emplacements inconnus.	Field
treat_variable_as_categorical (Facultatif)	Indique si la valeur du paramètre `variable_predict` est traitée comme une variable catégorielle. `CATEGORICAL`—La valeur `variable_predict` est une variable catégorielle et l’outil exécute une classification. `NUMERIC`—La valeur `variable_predict` est continue et l’outil exécute une régression. Il s’agit de l’option par défaut.	Boolean
explanatory_variables [[Variable, Categorical],...] (Facultatif)	Liste des champs qui représentent les variables explicatives utilisées pour prévoir la valeur ou la catégorie de `variable_predict`. Utilisez le paramètre `treat_variable_as_categorical` des variables qui représentent des classes ou des catégories (comme l’occupation du sol, la présence ou l’absence). Affectez au paramètre la valeur `true` si la variable représente des classes ou des catégories telles que l’occupation du sol, la présence ou l’absence, et la valeur `false` si la variable est continue. Colonnes de la table de valeurs : `Variable`—A list of fields representing the explanatory variables that help predict the value of the variable to predict. `Categorical`—Specifies whether the variable is categorical. `CATEGORICAL`—The explanatory field is a categorical variable. `NUMERIC`—The explanatory field is a continuous variable.	Value Table
create_variable_importance_table (Facultatif)	Indique si la table en sortie contient des informations décrivant l’importance de chaque variable explicative utilisée dans le modèle. `CREATE_TABLE`—La table en sortie contient des informations pour chaque variable explicative. `NO_TABLE`—La table en sortie ne contient pas d’informations pour chaque variable explicative. Il s’agit de l’option par défaut.	Boolean
features_to_predict (Facultatif)	Couche d’entités représentant les emplacements où se produisent les prévisions. Cette couche d’entités doit également comporter toutes les variables explicatives fournies en tant que champs et correspondant aux champs utilisés issus des données d’entraînement.	Record Set
explanatory_variable_matching [[Prediction, Training],...] (Facultatif)	Liste des `explanatory_variables` spécifiées dans les `in_features` à droite et de leurs champs correspondants dans les `features_to_predict` à gauche ; par exemple, `[["LandCover2000", "LandCover2010"], ["Income", "PerCapitaIncome"]]`. Colonnes de la table de valeurs : `Training Field`—A list of variables that correspond to the training variables that will be made to make predictions. `Prediction Field`—The list of variables from the input training features that were used to train the model.	Value Table
number_of_trees (Facultatif)	Nombre d'arbres à créer dans le modèle de forêt. Un grand nombre d’arbres produit habituellement des résultats plus précis, mais le calcul du modèle prend davantage de temps. Le nombre d’arbres par défaut est défini sur 100.	Long
minimum_leaf_size (Facultatif)	Nombre minimal d’observations requises pour conserver une feuille (c’est-à-dire le nœud terminal d’un arbre sans fractionnements supplémentaires). La valeur minimale par défaut pour une régression est 5 ; la valeur par défaut est 1 pour une classification. Pour les jeux de données très volumineux, l’augmentation de ces nombres aura pour effet de réduire le temps d’exécution de l’outil.	Long
maximum_tree_depth (Facultatif)	Nombre maximum de fractionnements pouvant être effectués pour un arbre. Si la profondeur maximum est élevée, le nombre de fractionnements créés augmente, ce qui accroît les risques de sur-ajustement du modèle. La valeur par défaut est dynamique ; elle dépend du nombre d'arbres créés et du nombre de variables incluses.	Long
sample_size (Facultatif)	Pourcentage d’éléments `in_features` utilisés pour chaque arbre décisionnel. La valeur par défaut est 100 pour cent des données. Les échantillons de chaque arbre sont sélectionnés de manière aléatoire dans les deux tiers des données spécifiées. Chaque arbre décisionnel de la forêt est créé à partir d’un échantillon aléatoire ou d’un sous-ensemble (équivalant approximativement aux deux tiers) des données d’entraînement disponibles. Si un pourcentage plus faible de données est utilisé en entrée pour chaque arbre décisionnel, l’outil s’exécute plus rapidement sur les jeux de données très volumineux.	Long
random_variables (Facultatif)	Nombre de variables explicatives utilisées pour créer chaque arbre décisionnel. Chaque arbre décisionnel de la forêt est créé à l'aide d’un sous-ensemble aléatoire des variables explicatives spécifiées. Une augmentation du nombre de variables utilisées dans chaque arbre décisionnel accroît les risques de sur-ajustement de votre modèle, notamment s’il comporte au moins une variable dominante. Si la variable `variable_predict` est numérique, il est courant d’utiliser la racine carrée du nombre total de variables explicatives ou, si la variable `variable_predict` est catégorielle, de diviser le nombre total de variables explicatives par 3.	Long
percentage_for_validation (Facultatif)	Pourcentage (entre 10 pour cent et 50 pour cent) des `in_features` à réserver en guise de jeu de données de test pour la validation. Le modèle est préparé (entraîné) sans ce sous-ensemble aléatoire de données, et les valeurs observées pour ces entités sont comparées aux valeurs prévues. La valeur par défaut est 10 pour cent.	Long
data_store (Facultatif)	Indique l’instance ArcGIS Data Store dans laquelle la sortie sera stockée. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. `SPATIOTEMPORAL_DATA_STORE`—La sortie sera stockée dans un spatiotemporal Big Data store. Il s’agit de l’option par défaut. `RELATIONAL_DATA_STORE`—La sortie sera stockée dans un data store relationnel.	String

Sortie dérivée

Nom	Explication	Type de données
output_trained	La sortie contenant les variables en entrée utilisées pour l’entraînement, ainsi que la variable observée pour prévoir le paramètre, et les prévisions associées pouvant être utilisées pour évaluer davantage les performances du modèle.	Record Set
variable_of_importance	Table contenant des informations décrivant l’importance de chaque variable explicative à utiliser dans le modèle créé.	Record Set
output_predicted	Couche qui recevra les prévisions du modèle.	Record Set

Exemple de code

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

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction Forest.

Dans ce script, des entités de réseau sont décrites et une couche d’échantillon de 2 500 entités est créée.

#-------------------------------------------------------------------------------
# Name: Forest.py
# Description: Run Forest on sales data from 1980 and predict for sales in 1981
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy
arcpy.env.workspace = "c:/data/commercial.gdb"
# Set local variables
trainingDataset = "https://analysis.org.com/server/rest/services/Hosted/sales/FeatureServer/0"
predictionDataset = "https://analysis.org.com/server/rest/services/Hosted/next_year/FeatureServer/0"
outputName = "training"
outputPredictedName = "predicted"

# Run Forest
arcpy.geoanalytics.Forest(
    "TRAIN_AND_PREDICT", inputDataset, outputName, "PERIMETER", None,
    "STORE_CATEGORY true;AVG_INCOME false;POPULATION false", None,
    predictionDataset,
    "STORE_CATEGORY STORE_CATEGORY;AVG_INCOME MEAN_INCOME; POPULATION POPULATION",
    100, None, None, 120, None, 10, "SPATIOTEMPORAL_DATA_STORE")

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant

Cas particuliers

Système de coordonnées en sortie: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

Informations de licence

Basic: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.7
Standard: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.7
Advanced: Requiert ArcGIS GeoAnalytics Server
Disponible avec ArcGIS Enterprise 10.7

Classification et régression basées sur une forêt (Outils de serveur GeoAnalytics)

Résumé

Héritage :

Utilisation

Paramètres

Sortie dérivée

Environnements

Cas particuliers

Informations de licence

Rubriques connexes