TPC 2026
TPC 2026

 

 

Navigation: Calibrating Data >

Calibration File

 

 

 

 

TPC stores information about a calibration in a .cal file.


File Format

CAL files are ASCII text files that can be opened and edited in a word processor.

Here's an example of a .cal used to calibrate an imported group to a drawing.

#21.0

#Traverse PC Calibration

#

Name,Reference group to survey

Type,0,2D Conformal Coordinate Transformation

Parameters,0.353553391,0.353553391,766.945238131,1418.559939615,0.5000,0.785398163,0.0000

Created,11,13,2018

From Description,Imported CAD

To Description,Local, International Survey Foot, Ground

Author,John Doe

Survey,Job2019-12,X:\Surveys\2019\2019-12\2019-12.trv

Control,BLM17,754.746,3432.695,0.0,0.05,0.05,0.10,desc

Control,TNW1/16,760.907,2109.080,0.0,0.05,0.05,0.10,desc

Control,BLM18,767.073,784.144,0.0,0.05,0.05,0.10,desc

From,Block Reference: Circle,2831.166,2865.669,0.0,desc

From,Line (117A8EA8),968.003,985.082,0.0,desc 

From,Block Reference: Circle,-897.019,-897.381,0.0,desc 

To,Block Reference: Circle,754.746,3432.695,0.0,0.123,0.123,0.234 

To,Line (117A8EA8),760.907,2109.080,0.0,0.123,0.123,0.234 

To,Block Reference: Circle,767.073,784.144,0.0,0.123,0.123,0.234

# Comments

You can put anything in a comment line. TPC ignores them when it reads the .cal file.

Name

Name of the calibration. TPC includes this in any reports involving this calibration.

Type

Calibration type. -1=undefined, 0=2D Conformal, 1=3D Conformal, 2=2D Affine, 4=3D Affine

Parameters

The parameters vary based on the type. For the 2D Conformal shown here, the parameters are "a,b,c,d,horizontal scale,rotation (ccw radians),reference variance,precision XY, precision Z"

ParametersEx

Some calibrations store additional parameters, like the partial derivaties of rotation about the X, Y and Z axes for the 3D Conformal transformation.

Created

The date the calibration was created.

Author

The name of the person who created the calibration.

Survey

The path and filename of the survey that created the calibration.

From Description

The description of the original Coordinate Reference System (CRS).

To Description

The description of the target (calibrated) Coordinate Reference System (CRS).

The dialogs that edit a calibration have an Insert Survey CRS button you can use to create this description from the survey's CRS.

Control

These are the control points, in the calibrated CRS, that you used to compute the calibration parameters.

The format is label,x,y,z[,stderr x, stderr,y, stderr z]  where [estimates of standard error] are included only for weighted solutions.

From

These are Uncalibrated points that pair with the control points. If you have 5 Control points, you will have at least 5 From points. The first Control point pairs with the first From point and so on.

The format is label,x,y,z

To

Each Uncalibrated From point generates a calibrated To point, including the standard errors from the Least Squares solution.

The format is label,x,y,z,stderr x, stderr,y, stderr z

Wt

Control and From points can be followed by a Wt (weight) record, specifying standard error estimates and other data about the previous point..


File Location

By default, TPC stores .cal file in the same folder as the survey file. Each calibration stores the location of it's .cal file relative to the survey file location.  This allows you to move or rename the survey's file location without disrupting that survey's calibrations.

However, calibration files can be located anywhere. If you plan to share them with other surveys, consider placing them in the \Calibrations\ sub-folder of your TPC Program Data folder.

Note: If you rename sub-folders within a survey folder and calibration files are stored in those sub-folders, those calibrations will loose track of their files.  You will then need to re-establish the locations of their files.  See Updating a Calibration's File Location.


Related Topics

Calibrating Data
Updating a Calibration's File Location

Editions

Premium, Professional

 

 

 

Copyright © 2026 Traverse PC, Inc.