Calculer l'ajustement de bloc (Gestion des données)

Résumé

Cet outil permet de calculer les ajustements apportés à la mosaïque. Cet outil créera une table de solutions pouvant être utilisée pour appliquer les ajustements réels.

Utilisation

  • Utilisez les points de contrôle en sortie de l'outil Calcul des points de rattachement comme points de contrôle en entrée pour cet outil.

  • La table de solutions en sortie de cet outil sera utilisée dans l'outil Appliquer l'ajustement de bloc.

  • L’outil exige la licence ArcGIS Desktop Advanced lorsque votre type de transformation est RPC ou Frame (Image).

Syntaxe

arcpy.management.ComputeBlockAdjustment(in_mosaic_dataset, in_control_points, transformation_type, out_solution_table, {out_solution_point_table}, {maximum_residual_value}, {adjustment_options}, {location_accuracy}, {out_quality_table})
ParamètreExplicationType de données
in_mosaic_dataset

Mosaïque en entrée qui sera ajustée.

Mosaic Layer; Mosaic Dataset
in_control_points

Table de points de contrôle qui inclut les points de rattachement et les points de contrôle au sol.

Elle est généralement générée par l'outil Calculer les points de rattachement.

Feature Layer
transformation_type

Type de transformation à utiliser lors de l'ajustement de la mosaïque.

  • POLYORDER0Une transformation polynomiale d'ordre nul est utilisée dans le calcul d'ajustement de bloc. Tel est généralement le cas lorsque vos données se trouvent sur une surface plane.
  • POLYORDER1Une transformation polynomiale de premier ordre (affine) est utilisée dans le calcul d'ajustement de bloc. Il s’agit de l’option par défaut.
  • RPCLes coefficients polynomiaux rationnels seront utilisés pour la transformation. Ils servent pour les images satellite qui contiennent les informations RPC dans les métadonnées. Cette option exige la licence ArcGIS Desktop Advanced.
  • FrameLe modèle de caméra full-frame sera utilisé pour la transformation. Il sert aux images aériennes qui contiennent les informations de caméra full-frame dans les métadonnées. Cette option exige la licence ArcGIS Desktop Advanced.
String
out_solution_table

Table de solutions en sortie contenant les ajustements.

Table
out_solution_point_table
(Facultatif)

Table des points de solution en sortie. Elle est enregistrée en tant que classe d'entités surfaciques. Cette sortie peut être très grande.

Feature Class
maximum_residual_value
(Facultatif)

Seuil utilisé dans le calcul de l'ajustement de bloc ; les points avec valeurs résiduelles dépassant le seuil ne seront pas utilisés. Ce paramètre s'applique lorsque le type de transformation est POLYORDER0, POLYORDER1 ou Frame. Si la transformation est RPC, le seuil correct pour éliminer les points non valides seront automatiquement déterminés.

Lorsque la transformation est POLYORDER0 ou POLYORDER1, les unités pour ce paramètre seront dans les unités de la carte et la valeur par défaut sera égale à 2.

Lorsque la transformation est Frame, les unités pour ce paramètre seront en pixels et la valeur par défaut sera égale à 5.

Double
adjustment_options
[[name, value],...]
(Facultatif)

Options supplémentaires pouvant optimiser le calcul d'ajustement.

  • MinResidualValeur résiduelle minimale, qui correspond à la valeur du seuil inférieur. Lorsque la transformation polynomiale est POLYORDER0 ou POLYORDER1, les unités sont identiques aux unités de la carte et la valeur résiduelle minimale par défaut est égale à 0. La valeur résiduelle minimale et le paramètre résiduel maximal sont utilisés pour détecter et supprimer des points pouvant générer des erreurs importantes à partir du calcul d'ajustement de bloc.
  • MaxResidualFactorLe facteur résiduel maximal est un facteur utilisé pour générer une valeur résiduelle maximale (seuil maximum). Si le paramètre Valeur résiduelle maximale n'est pas défini, il utilisera le
    MaxResidualFactor * RMS
    pour calculer la valeur de seuil maximale.La valeur résiduelle minimale et le paramètre résiduel maximal sont utilisés pour détecter et supprimer des points pouvant générer des erreurs importantes à partir du calcul d'ajustement de bloc.
Value Table
location_accuracy
(Facultatif)

Spécifie le niveau de précision géométrique des images.

  • HIGHLa précision est inférieure à 30 mètres.
  • MEDIUMLa précision est comprise entre 31 et 100 mètres.
  • LOWLa précision est supérieure à 100 mètres.

Si une précision LOW est spécifiée, les points de contrôle sont d’abord améliorés par une triangulation initiale pour être ensuite utilisés dans le calcul d’ajustement de bloc. La précision moyenne et élevée ne nécessite aucun traitement d’estimation supplémentaire.

String
out_quality_table
(Facultatif)

Table de sortie utilisée pour stocker les informations de qualité d'ajustement.

Ce paramètre n'est valide que si RPC a été spécifié comme transformation_type.

Table

Exemple de code

Exemple 1 d'utilisation de l'outil ComputeBlockAdjustment (fenêtre Python)

Il s’agit d'un exemple Python d'utilisation de l'outil ComputeBlockAdjustment.

import arcpy
arcpy.ComputeBlockAdjustment_management(
     "c:/BD/BD.gdb/redQB", "c:/BD/BD.gdb/redQB_tiePoints",
     "POLYORDER1", "c:/BD/BD.gdb/redQB_solution")
Exemple 2 d'utilisation de l'outil ComputeBlockAdjustment (script autonome)

Il s’agit d'un exemple de script Python d'utilisation de l'outil ComputeBlockAdjustment.

#compute block adjustment, case 2

import arcpy
arcpy.env.workspace = "c:/workspace"

#Compute block adjustment
mdName = "BD.gdb/redlandsQB"
in_controlPoint = "BD.gdb/redlandsQB_tiePoints"
out_solutionTable = "BD.gdb/redlandsQB_solution"

arcpy.ComputeBlockAdjustment_management(mdName, in_controlPoint, 
     "POLYORDER1", out_solutionTable)
Exemple 3 d'utilisation de l'outil ComputeBlockAdjustment (script autonome)

Il s’agit d'un exemple de script Python d'utilisation de l'outil ComputeBlockAdjustment.

#compute block adjustment, case 3

import arcpy
arcpy.env.workspace = "c:/workspace"

#Compute block adjustment specifying an output point table and 
#an setting an adjustment option
mdName = "BD.gdb/redlandsQB"
in_controlPoint = "BD.gdb/redlandsQB_tiePoints"
out_solutionTable = "BD.gdb/redlandsQB_solution"
out_solutionPoint = "BD.gdb/redlandsQB_solutionPoint"
engineOption = "_BAI c:/workspace/bai.txt; _BAO c:/workspace/bao.txt"

arcpy.ComputeBlockAdjustment_management(mdName, in_controlPoint, 
     "POLYORDER1", out_solutionTable, out_solutionPoint,"0.5", 
     engineOption)

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes