Enregistrer le raster (Gestion des données)
Récapitulatif
Cet outil inscrit une image en calculant automatiquement les points de contrôle à partir d'une image de référence ou en utilisant un jeu de points de contrôle prédéfinis. La transformation géométrique calculée à partir des points de contrôle est enregistrée dans le jeu de données en entrée. Si le jeu de données en entrée est une mosaïque, l'outil s'exécute sur chaque élément de mosaïque.
Pour inscrire automatiquement l'image, le raster en entrée et le raster de référence doivent se trouver dans une zone géographique relativement proche. Vous devrez peut-être créer un fichier de liens avec quelques liens pour placer votre raster en entrée dans le même espace cartographique. Une table des liens peut être créée à l'aide de la barre d'outils Géoréférencement.
Utilisation
-
Les informations de géoréférencement du raster en entrée sont mises à jour.
Le mot-clé RESET vous permet de supprimer toute transformation géographique appliquée via cet outil.
Cet outil permet d'inscrire tous les éléments d'une mosaïque, un sous-ensemble d'éléments ou un seul élément d'une mosaïque. Si vous souhaitez uniquement inscrire un élément spécifique, vous devez saisir le chemin d'accès complet à la mosaïque et une requête unique pour l'élément que vous souhaitez mettre à jour.
Voici quelques exemples illustrant la sélection d'un élément au sein d'une mosaïque comme raster en entrée :
- \\Myserver\MyFolder\MyMosaicDataset\OBJECTID=1
- \\Myserver\MyFolder\MyMosaicDataset\NAME='tileName01'
Si vous le souhaitez, vous pouvez sélectionner un sous-ensemble d'éléments dans la couche de mosaïque.
Lorsque le raster en entrée est une mosaïque contenant des éléments améliorés, cet outil peut inscrire automatiquement le raster multispectral sur le raster panchromatique si vous laissez les paramètres Raster de référence et Fichier de lien en entrée vides.
Syntaxe
| Paramètre | Explication | Type de données |
in_raster |
Jeu de données raster en entrée. Après l'exécution de cet outil, la transformation géographique du raster en entrée est mise à jour. L'inscription d'un élément de mosaïque entraîne uniquement la mise à jour de cet élément particulier au sein de la mosaïque. Un élément de mosaïque se voit attribuer le chemin d'accès à la mosaïque, suivi de l'ID d'objet de l'élément. Pour exemple, le chemin d'accès suivant est attribué au premier élément de la mosaïque : .\mosaicDataset\objectid=1. Pour une mosaïque en entrée, chaque élément de mosaïque est inscrit en fonction des points de contrôle et du raster de référence. | Mosaic Layer; Raster Dataset; Raster Layer |
register_mode |
Choisissez le mode d'inscription. Vous pouvez inscrire le raster avec une transformation ou réinitialiser la transformation.
| String |
reference_raster (Facultatif) |
Choisissez le raster de référence avec lequel l'entrée sera appariée. Laissez ce paramètre vide si vous souhaitez inscrire vos éléments de mosaïque multispectraux sur leurs rasters panchromatiques associés. | Image Service; Internet Tiled Layer; Map Server Layer; MapServer; Mosaic Layer; Raster Dataset; Raster Layer; WMS Map |
input_link_file (Facultatif) |
Fichier de liens qui permettra de placer le raster en entrée dans le même espace cartographique que le raster de référence. Chaque ligne du fichier de liens en entrée peut être l'un des ensembles de valeurs suivants, chacun étant délimité par une tabulation :
La table de liens en entrée fonctionne avec une mosaïque dans la couche de mosaïque. L'entrée doit spécifier quel élément est en cours de traitement ; vous devez sélectionner l'élément ou spécifier la valeur ObjectID dans l'entrée. Laissez ce paramètre vide si vous souhaitez inscrire vos éléments de mosaïque multispectraux sur leurs rasters panchromatiques associés. | Text File |
transformation_type (Facultatif) | Type de transformation géométrique.
| String |
output_cpt_link_file (Facultatif) | Fichier de liens en sortie qui contient les liens d'inscription créés par cet outil. Vous pouvez utiliser la table de liens en sortie dans l'outil Déformer à partir du fichier : Chaque ligne du fichier de liens en sortie doit présenter les valeurs suivantes, chacune étant délimitée par une tabulation :
La table de liens en sortie fonctionne avec un élément de mosaïque dans la couche de mosaïque. L'entrée doit spécifier quel élément est en cours de traitement ; vous devez sélectionner l'élément ou spécifier la valeur ObjectID dans l'entrée. | Text File |
maximum_rms_value (Facultatif) |
L'erreur quadratique moyenne (EQM) maximale est l'erreur modélisée maximale autorisée pour la transformation en sortie. Lorsque vous définissez l'erreur quadratique moyenne maximale, les erreurs résiduelles élevées sont supprimées, ce qui permet de réduire l'erreur de la transformation. Par défaut, l'erreur quadratique moyenne maximale est égale à 0,5 fois la taille de cellule de votre raster en entrée. Elle ne doit pas être inférieure à 0,3 fois la taille de cellule de votre raster en entrée. | Double |
Exemple de code
Il s'agit d'un exemple Python d'utilisation de l'outil RegisterRaster.
import arcpy
arcpy.RegisterRaster_management(
"\\cpu\data\nonref.tif", "REGISTER", "\\cpu\data\yesref.tif",
"\\cpu\data\links.txt", "POLYORDER1", "#")
Il s'agit d'un exemple de script Python pour l'outil RegisterRaster.
# Register raster using only control points
import arcpy
arcpy.env.workspace = "C:/Workspace"
rdname = "irs_ps.img"
mode = "REGISTER"
refrd = ""
linkfile = "C:/Workspace/irs_controls_13.txt"
order = "POLYORDER2"
arcpy.RegisterRaster_management(
rdname, mode, refrd, linkfile, order)