TRABI

Transform photo coordinates to a fiducial reference system

This program transforms measured photo coordinates to a reference coordinate system. The following transformation types are available:

Transformation types and related parameters

Type	Transformation and parameters
3	Rotation and shift
4	Rotation, shift, and common scale
5	Rotation, shift, scale in x, and scale in y
6	Affine transformation: rotation, shift, scales in x and y, and shear
8	Projective transformation
0	No transformation; copy data, for example, to eliminate fiducials

The reference coordinates for the camera must be given in a file. (See example data below.)

Output fiducial coordinates

Option	Result
Yes	Write transformed fiducial coordinates to the output file
No	Do not write fiducials

Append data to a file

The New/Overwrite and Append options control output to the image coordinate file. With New/Overwrite, the output file may or may not already exist; it is created or overwritten from the beginning. With Append, the file must already exist, and all output is appended to it.

To write a file from the beginning, select New/Overwrite. To add more data to the output file, select Append, even within the same session.

Regardless of this option, the TRABI list file is overwritten from the beginning during each transformation unless its filename has been changed.

Input data

The input file must contain photo measurements. The first line contains the photo name and, optionally, the camera name. Two dummy photo coordinates may also be included.

For example: Ph4711 [0.145 -115.145] [Cam1]

Value	Meaning
Ph4711	Photo name
0.145 -115.145	Dummy photo coordinates
Cam1	Camera name

Each following line must contain a point name and two photo coordinates. The end of a photo is recognized by a point name with a preceding minus sign, such as -99. Data for subsequent photos may follow this line.

In all BINGO files, one or more lines can be made inactive by placing * in column 1.

Example fiducial.dat input file containing the fiducial reference coordinates for cameras Cam1 and Cam3:

Cam1
   Fid1    100.08    80.06
   Fid2   -100.08    80.06
   Fid3   -100.08   -80.06
   Fid4    100.08   -80.06
    -99
Cam3
   Fid1    100.12    80.11
   Fid2   -100.12    80.11
   Fid3   -100.12   -80.11
   Fid4    100.12   -80.11
    -99

Example carriage.dat input file containing two photos:

10    Cam1
   Fid1  1169.663  1189.306
   Fid2   969.514  1188.041
   Fid3   970.535  1027.861
   Fid4  1170.683  1029.226
     22  1151.372  1045.653
     23  1148.272  1065.910
     24  1150.562  1091.369
      :      :         :
     38  1180.061  1164.536
    100  1030.988  1107.844
    -99
11    Cam3
   Fid1  1422.631  1187.054
   Fid2  1222.429  1186.780
   Fid3  1222.639  1026.526
   Fid4  1422.924  1026.864
     22  1400.710  1026.343
     23  1393.769  1050.630
     24  1397.168  1079.464
      :      :         :
     36  1353.027  1138.403
     37  1394.920  1154.969
    -99

Default values

To reset all parameters, select Settings > Set Parameter Defaults.