Générer des échantillons d’entraînement à partir de points d’origine (Outils Image Analyst)

Résumé

Génère des échantillons d’entraînement à partir de points d’origine, tels que des points d’évaluation de la précision ou des points d’échantillon d’entraînement. Cet outil sert généralement à générer des échantillons d’entraînement à partir d’une source existante, telle qu’un raster thématique ou une classe d’entités.

Utilisation

Cet outil accepte les sources de données tierces dans le jeu d'outils de classification ArcGIS. Les entrées qui identifient la structure des classes pour guider la génération des échantillons d’entraînement comprend des jeux de données thématiques ou des polygones, tels que les classifications précédentes, les emprises de bâtiments, les routes ou d’autres données SIG.
Pour les rasters en entrée, l'outil étend la région à partir des points d'origine, à la condition que tous les pixels aient la même valeur. L’étendue de la région est contrôlée par Max Sample Radius (Rayon d’échantillonnage maximal) (max_radius dans Python). Dans le domaine de la télédétection, il est conseillé que les échantillons d’entraînement soient homogènes et que la taille de l’échantillon soit représentative de l’entité cible. Si l’étendue de la région à partir de certains points d’origine ne peut pas atteindre une surface supérieure à Min Sample Area (Surface d’échantillonnage minimale) (min_area dans Python), le point d’origine n’est pas utilisé.
Pour les classes d'entités en entrée, l'outil sélectionne les entités à partir des données en entrée qui intersectent la classe d'entités points, au lieu d'utiliser l'étendue de la région.
Vous pouvez utiliser l’outil Create Accuracy Assessment Points (Créer des points d’évaluation de la précision) pour générer les points des échantillons d’entraînement. Il présente des options pour le nombre de points à utiliser et quelques stratégies d'échantillonnage pour générer les points aléatoires.
Si vous possédez déjà les points d’origine des échantillons d’entraînement ou une méthode pour les générer, il peut être facile de les utiliser, car l’outil recourt uniquement aux coordonnées x et y d’un fichier de classe d’entités ponctuelles, et non à la table associée.

Etiqueter	Explication	Type de données
Données raster ou de classe d’entités en entrée	Source de données qui étiquette les échantillons d’entraînement.	Mosaic Layer; Raster Layer; Feature Layer; Image Service; String
Points d'origine en entrée	Shapefile de points ou classe d’entités ponctuelles qui doit fournir les centres des polygones des échantillons d’entraînement.	Feature Layer
Classe d’entités d’échantillon d’entraînement en sortie	La classe d’entités de l’échantillon d’entraînement en sortie dans le format pouvant être utilisé dans les outils d’entraînement, notamment les shapefiles. La classe d’entités en sortie peut être de type surfacique ou ponctuel.	Feature Class
Surface d’échantillonnage minimale (Facultatif)	Surface minimale requise pour chaque échantillon d’entraînement, en mètres carrés. La valeur minimum doit être supérieure ou égale à 0.	Double
Rayon d’échantillonnage maximal (Facultatif)	La plus longue distance (en mètres) à partir d’un point au sein de l’échantillon d’entraînement vers son point d’origine central. Si elle est définie sur 0, l’échantillon d’entraînement en sortie est constitué de points et non de polygones. La valeur minimum doit être supérieure ou égale à 0.	Double

GenerateTrainingSamplesFromSeedPoints(in_class_data, in_seed_points, out_training_feature_class, {min_sample_area}, {max_sample_radius})

Nom	Explication	Type de données
in_class_data	Source de données qui étiquette les échantillons d’entraînement.	Mosaic Layer; Raster Layer; Feature Layer; Image Service; String
in_seed_points	Shapefile de points ou classe d’entités ponctuelles qui doit fournir les centres des polygones des échantillons d’entraînement.	Feature Layer
out_training_feature_class	La classe d’entités de l’échantillon d’entraînement en sortie dans le format pouvant être utilisé dans les outils d’entraînement, notamment les shapefiles. La classe d’entités en sortie peut être de type surfacique ou ponctuel.	Feature Class
min_sample_area (Facultatif)	Surface minimale requise pour chaque échantillon d’entraînement, en mètres carrés. La valeur minimum doit être supérieure ou égale à 0.	Double
max_sample_radius (Facultatif)	La plus longue distance (en mètres) à partir d’un point au sein de l’échantillon d’entraînement vers son point d’origine central. Si elle est définie sur 0, l’échantillon d’entraînement en sortie est constitué de points et non de polygones. La valeur minimum doit être supérieure ou égale à 0.	Double

Exemple de code

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

Créer des échantillons d’entraînement à partir des points d’origine

import arcpy
from arcpy.ia import *

GenerateTrainingSamplesFromSeedPoints("c:/test/amberg_3band_classified_ISO.tif",
                                      "c:/input/seed_points",
                                      "c:/test/out/training_samples.gdb\out_training_sample",
                                      30, 50)

Exemple 2 d’utilisation de la fonction GenerateTrainingSamplesFromSeedPoints (script autonome)

Créer des échantillons d’entraînement à partir des points d’origine

# Import system modules
import arcpy
from arcpy.ia import *

# Set local variables
inclassified_raster = "c:/test/landuse.tif"
in_seed_points = "c:/test/seed_points.shp"
output_trainingsamples = "c:/test/output/training.gdb/trainingsamples"
maxSampleArea = 30
minSampleRadius = 50

#Run
GenerateTrainingSamplesFromSeedPoints(inclassified_raster, in_seed_points,
                   output_trainingsamples, maxSampleArea, minSampleRadius)

Environnements

Espace de travail courant, Étendue, Espace de travail temporaire

Informations de licence