RPC Block Adjustment

RPC Block Adjustment calculates a correction to both model images' RPC coefficients from stereoscopically measured control points (RPCBA, RPC Block Adjustment). Compensates image coordinate shifts and affine deformations.
Select Photogrammetric window/RPC Block Adjustment. Requires:
- The active stereoscopic RPC Satellite sensor.
- No other RPC block adjustment command running.
- Different left and right model images.
Otherwise displays a message and ends.
On startup
- Clears both images' affine RPC corrections. Measurements use uncorrected RPCs even with a saved adjustment.
- Loads the last point file. If missing, requests one; cancellation ends the command.
- Loads previous measurements from
<directorio de trabajo>\<nombre del modelo>.rpcbaor, if that does not exist, from<directorio de trabajo>\<imagen izquierda>-<imagen derecha>.rpcba(image names without extension), if present.
Point file
Text file with one point per line: space-separated name, X, Y, Z and optional description. Ignores lines with fewer than four fields. Names are case-sensitive: P1 and p1 differ. Loads only points projected inside both images.
Point file shows the loaded path. ... selects another .xyz, .pnt, .ctl or .txt. Replaces the list while retaining same-name measurements. Measurements absent from the new file remain saved in .rpcba but do not participate in adjustment. An unreadable file leaves the previous one loaded.
Point list
One row per point file entry:
| Column | Contents |
|---|---|
| Point | Point name. |
| El(l), Es(l) | Left-image row and column residuals in pixels: adjusted computed position minus measured position. |
| El(r), Es(r) | Right-image row and column residuals in pixels. |
| Ex, Ey, Ez | Adjusted position minus point file coordinates, in sensor CRS units. |
| Description | Point file description. |
Residual columns remain empty until measurement and adjustment calculation. In each of the Ex, Ey and Ez columns, Digi3D.AI shows in red the cells whose absolute value, rounded to the six decimals the cell shows, is the largest in the column (all tied cells), unless that value is 0.
Extended view adds X, Y, Z (point file coordinates) and measured Line (left), Sample (left), Line (right) and Sample (right). The setting persists between sessions.
Measuring a point
- Click a listed point. Moves the cursor to its coordinates and displays Digitize point name stereoscopically in the status bar.
- Position stereoscopically and press the recording button. Saves row and column in both images and recalculates adjustment.
Calculation starts at Number of points to calculate. Only measured points present in the point file count and participate. Failure to converge within 100 iterations leaves RPCs unchanged and clears residual columns and residual statistics. Configure accuracies in RPCBA adjustment parameters.
Buttons
| Button | Action |
|---|---|
| Skip (Esc) | Deselects the point being measured. During Remove parallax, cancels that operation. Equivalent to Esc. |
| Remove parallax | Shifts right-image RPCs to remove parallax at one point. Digitize first in the left image, which locks there, then the same point in the right. Adds row and column differences between inputs to the right correction. The status bar identifies the required image. Persists until recalculation caused by measuring, unmeasuring, removing or skipping a point, or changing point files. OK before recalculation saves the correction with the adjustment. |
| Unmeasure | Clears selected point measurements and recalculates. Leaves the point listed. |
| Remove point | Removes selected point and measurements without changing the point file. Deselects it if currently being measured. |
| Worst 2D? | Selects the point with the largest absolute row or column residual in either image and moves there for remeasurement. |
| Worst 3D? | Selects the greatest X, Y or Z difference between adjusted position and point file coordinates, moving there. |
Residual statistics
Below the buttons, three statistics per residual column (El(l), Es(l), El(r), Es(r), Ex, Ey, Ez) are calculated from measured points:
| Row | Contents |
|---|---|
| Root mean square | Square root of the mean squared residuals. |
| Average | Signed sum divided by residual count. |
| Maximum absolute value | Largest absolute residual. |
Uncomputable residuals appear as nonnumeric values and are excluded from that column's statistics. El(l), Es(l), El(r) and Es(r) use pixels; Ex, Ey and Ez use sensor CRS units. Cells remain empty without a calculated adjustment.
Options
- Show the adjustment result in real time when re-measuring a point: with a selected point, cursor movement recalculates as though measured at that position, updating the list and statistics. Saves measurement only on recording input. Does not recalculate during Remove parallax or afterwards while that correction remains.
- Automatically select the next point: after measurement, selects the first unmeasured point by name and moves there.
OK and Cancel
OK saves a calculated adjustment:
- Corrected image RPCs to
<directorio de trabajo>\<nombre de la imagen>.digi3d_rpcba. Loaded by RPC Satellite when opening the model. - Measurements to
<directorio de trabajo>\<nombre del modelo>.rpcba. The model name is the name of the.d3dfile without extension. - Report to
<directorio de trabajo>\<nombre del modelo>.rpcba.txt. See Adjustment report. Results shows its path.
After saving with OK, displays measured control points. See Measured control points in the photogrammetric window.
Without a calculated adjustment, OK closes without saving.
Cancel, or any other termination without accepting an adjustment, restores both images' initial RPCs. Measurements are not saved.
Adjustment report
<nombre del modelo>.rpcba.txt is UTF-8 text in the interface language, containing:
Header titled “Digi3D.AI - Block adjustment report for rational polynomial coefficients (RPC)”, generation date and time, model and image names, point file path, ground and RPC reference systems, adjustment point count and column descriptions.
Per-image tables:
- Point, X, Y, Z: point file name and coordinates.
- Ef, Ec: adjusted computed row and column minus measured values, in pixels. Correspond to pane El(l) and Es(l) or El(r) and Es(r).
- DX, DY: X and Y of the intersection between the measured image ray and the constant-height surface at the point elevation, minus point file X and Y.
Image RPC correction coefficients (
IOCOEF_LINE,IOCOEF_SAMPLE) follow each table.Stereo model table with DX, DY, DZ: adjusted coordinates minus point file coordinates, matching pane Ex, Ey, Ez.
Each table is followed by root mean square, average and maximum absolute residuals. Uncomputable image DX or DY cells are blank and excluded from statistics. X, Y, Z, DX, DY and DZ use ground CRS units.
Report for a two-image Pléiades Neo model adjusted with 14 control points in WGS 84 / UTM zone 19N:
Digi3D.AI - Informe del ajuste en bloque de coeficientes polinómicos racionales (RPC)
Fecha: 2026-10-28 10:26:26
Modelo: IMG_PNEO4_202308011531456_PMS_SEN_PWOI_000126295_1_1_F_1_RGBN_R1C1-IMG_PNEO4_202308011531166_PMS_SEN_PWOI_000126295_2_1_F_1_RGBN_R1C1
Imagen izquierda: IMG_PNEO4_202308011531456_PMS_SEN_PWOI_000126295_1_1_F_1_RGBN_R1C1
Imagen derecha: IMG_PNEO4_202308011531166_PMS_SEN_PWOI_000126295_2_1_F_1_RGBN_R1C1
Archivo de puntos: D:\Proyecto\puntos_de_apoyo.txt
Sistema de referencia de coordenadas del terreno: WGS 84 / UTM zone 19N + Sistema de coordenadas vertical local
Sistema de referencia de coordenadas de los RPC: WGS 84
Puntos en el ajuste: 14
Ef, Ec: fila y columna calculadas con el ajuste menos fila y columna medidas, en píxeles. DX y DY de cada imagen: coordenadas X e Y, respectivamente, del punto donde el rayo correspondiente a la fila y la columna medidas en esa imagen interseca la superficie de altura constante situada a la cota del punto, menos las coordenadas X e Y del archivo de puntos. DX, DY, DZ del modelo estereoscópico: coordenadas ajustadas menos las coordenadas del archivo de puntos. X, Y, Z, DX, DY y DZ están en unidades del sistema de referencia de coordenadas del terreno.
Imagen izquierda: IMG_PNEO4_202308011531456_PMS_SEN_PWOI_000126295_1_1_F_1_RGBN_R1C1
------------------------------------------------------------------------------------------------------
Punto X Y Z Ef Ec DX DY
------------------------------------------------------------------------------------------------------
MAGP1A 262786.128 2080962.680 416.748 -0.260 0.459 -0.179 -0.189
MAGP1B 262781.429 2080966.421 416.695 -0.058 0.078 0.101 0.031
MAGP2A 259312.867 2078911.615 440.435 0.112 -0.540 0.228 0.093
MAGP2B 259310.070 2078910.502 440.494 0.277 -0.106 0.014 0.143
MAGP3A 266775.294 2079103.577 399.411 -0.065 0.749 -0.289 -0.137
MAGP3B 266583.041 2079251.360 398.342 -0.623 0.413 -0.303 -0.329
MAGP4A 269382.297 2080120.444 402.375 0.896 -0.533 0.330 0.530
MAGP4B 269379.576 2080120.930 402.459 -0.251 -0.403 0.112 -0.121
MAGP5A 264294.360 2083253.227 429.823 -0.412 -0.245 0.101 -0.181
MAGP5B 264296.714 2083245.947 429.815 0.505 0.367 -0.288 0.178
MAGP6A 264255.503 2079883.850 402.921 -0.010 0.035 -0.027 -0.010
MAGP6B 264341.770 2079882.778 402.017 0.003 0.023 -0.022 -0.002
MAGP7A 266179.534 2081572.112 413.299 -0.293 -0.181 0.152 -0.115
MAGP7B 266170.871 2081581.675 413.396 0.177 -0.103 0.051 0.104
------------------------------------------------------------------------------------------------------
Error medio cuadrático 0.374 0.372 0.191 0.203
Media 0.000 0.001 -0.001 0.000
Máximo valor absoluto 0.896 0.749 0.330 0.530
Corrección de los RPC de la imagen:
IOCOEF_LINE: 4.400929 0.000173 0.000103
IOCOEF_SAMPLE: -24.213050 -0.000201 -0.000093
Imagen derecha: IMG_PNEO4_202308011531166_PMS_SEN_PWOI_000126295_2_1_F_1_RGBN_R1C1
------------------------------------------------------------------------------------------------------
Punto X Y Z Ef Ec DX DY
------------------------------------------------------------------------------------------------------
MAGP1A 262786.128 2080962.680 416.748 -0.599 -0.161 0.018 -0.308
MAGP1B 262781.429 2080966.421 416.695 0.306 -0.701 0.337 0.071
MAGP2A 259312.867 2078911.615 440.435 0.229 0.369 -0.073 0.097
MAGP2B 259310.070 2078910.502 440.494 0.219 0.141 -0.060 0.151
MAGP3A 266775.294 2079103.577 399.411 -0.890 -0.225 0.019 -0.423
MAGP3B 266583.041 2079251.360 398.342 -0.027 -0.164 -0.076 0.014
MAGP4A 269382.297 2080120.444 402.375 0.828 -0.064 0.155 0.418
MAGP4B 269379.576 2080120.930 402.459 -0.087 0.517 -0.184 -0.057
MAGP5A 264294.360 2083253.227 429.823 -0.028 0.117 -0.016 -0.070
MAGP5B 264296.714 2083245.947 429.815 -0.058 0.276 -0.232 0.122
MAGP6A 264255.503 2079883.850 402.921 -0.011 0.011 -0.016 0.002
MAGP6B 264341.770 2079882.778 402.017 0.004 0.015 -0.017 0.010
MAGP7A 266179.534 2081572.112 413.299 -0.066 -0.116 0.115 -0.117
MAGP7B 266170.871 2081581.675 413.396 0.193 0.002 0.016 0.104
------------------------------------------------------------------------------------------------------
Error medio cuadrático 0.386 0.284 0.135 0.195
Media 0.001 0.001 -0.001 0.001
Máximo valor absoluto 0.890 0.701 0.337 0.423
Corrección de los RPC de la imagen:
IOCOEF_LINE: -19.434949 0.000004 0.000097
IOCOEF_SAMPLE: -26.033315 0.000399 -0.000058
Modelo estereoscópico
-------------------------------------------------------------------------------------------
Punto X Y Z DX DY DZ
-------------------------------------------------------------------------------------------
MAGP1A 262786.128 2080962.680 416.748 -0.037 -0.108 0.027
MAGP1B 262781.429 2080966.421 416.695 0.073 0.030 0.178
MAGP2A 259312.867 2078911.615 440.435 0.020 0.043 0.111
MAGP2B 259310.070 2078910.502 440.494 -0.003 0.063 -0.063
MAGP3A 266775.294 2079103.577 399.411 -0.064 -0.119 0.065
MAGP3B 266583.041 2079251.360 398.342 -0.026 -0.083 -0.456
MAGP4A 269382.297 2080120.444 402.375 0.071 0.218 0.265
MAGP4B 269379.576 2080120.930 402.459 -0.014 -0.043 -0.015
MAGP5A 264294.360 2083253.227 429.823 0.015 -0.057 0.028
MAGP5B 264296.714 2083245.947 429.815 -0.074 0.058 -0.321
MAGP6A 264255.503 2079883.850 402.921 -0.005 -0.003 -0.035
MAGP6B 264341.770 2079882.778 402.017 -0.004 0.001 -0.034
MAGP7A 266179.534 2081572.112 413.299 0.033 -0.046 0.200
MAGP7B 266170.871 2081581.675 413.396 0.012 0.047 0.016
-------------------------------------------------------------------------------------------
Error medio cuadrático 0.042 0.084 0.185
Media 0.000 0.000 -0.002
Máximo valor absoluto 0.074 0.218 0.456
Measured control points in the photogrammetric window
With <directorio de trabajo>\<nombre del modelo>.rpcba present or, if that does not exist, <directorio de trabajo>\<imagen izquierda>-<imagen derecha>.rpcba (image names without extension), each image displays measured points as circles at measured positions with point names. Reads the file on model opening and OK in this pane. Without either file, no measured control points appear, including after switching from another model in the same project.
- Circles use the conical camera sensor's control point color and size, adjustable in Configuration.
- The measured point checkbox in image properties shows or hides circles and names.
Projects with multiple pairs
Adjusts only the loaded pair's two images. For a project with multiple pairs, load, measure and accept OK for each pair separately.
Corrections are saved per image in <directorio de trabajo>\<nombre de la imagen>.digi3d_rpcba. Pairs sharing an image and work directory share that correction: accepting one replaces it, and the other uses the new correction when reloaded.