GCPConvert

List of commands

Description

The command GCPConvert is used to:

• transform a set of ground control points from most text format to MicMac’s Xml format.
• transform the ground control points into an euclidean coordinate system, suitable for MicMac.

Allowed commands

• AppEgels
• AppGeoCub
• AppInFile
• AppXML

Syntax

The global syntax for GCPConvert is :

mm3d GCPConvert FormatSpecification GCPFile NamedArgs

Help

You can access to the help by typing :

mm3d GCPConvert -help

Mandatory unnamed args :

• string :: {Format specification}
• string :: {GCP File}

Named args :

• [Name=Out] string :: {Xml Out File}
• [Name=ChSys] string :: {Change coordinate file}
• [Name=MulCo] REAL :: {Multiplier of result (for development and testing use)}
• [Name=MulInc] bool :: {Multiplier also incertitude ? (for development and testing use)}

Example

mm3d GCPConvert AppInFile CP3D_Format.txt

Formatting the input GCP file

If you don't use an AppXML formatted file (in fact a MicMac's XML file), the input file has to be a space or tabulation separated values file (no comma or other symbols). You can use 'Egels' or 'GeoCub' format, or describe your file as explained below.

AppGeoCub

Text file is formatted as:

PointNumber    X    Y    Z

Lines beginning with '%' are considered as comments.

AppEgels

Text file is formatted as:

PointNumber  VariableNonImported  X    Y    Z

Lines beginning with '#' are considered as comments.

This file format is used by some IGN/ENSG softwares developed by Yves Egels[1].

AppInFile

The first line describes name and position of the rows. It begins by '#F= ', where

• the first character '#' means that all line beginning by a # will be a comment;
• the two characters 'F=' mean that this is really a format specification;

'#F= ' followed by the format specification :

• 'N' means the name of the point;
• 'X', 'Y', 'Z' means the coordinates;
• 'Ix', 'Iy', 'Iz' means the accuracy (not mandatory);
• S means a string which has not to be interpreted;

separated by spaces.

You can reorder this format as you want.

Example 1:

#F= N X Y Z Ix Iy Iz
157 233.28 144.03 103.05 0.00332 0.0034 0.0039
158 317.011 -0.00000 0.0000 0.0053 0.0060 0.0071

• N means the first string of each line is the name of the point;
• X, Y, Z means that this strings number 2, 3 and 4 are the coordinates;
• Ix, Iy, Iz means that this strings number 5, 6 and 7 are the accuracy;

Example 2:

#F= N S X Y Z
300 3 94.208685 658.506787 42.39556
301 3 95.323427 656.409116 43.502239
302 3 97.008135 654.424482 45.084237

• N means the first string of each line is the name of the point;
• S means the 2nd string has not to be interpreted;
• X, Y, Z means that this strings number 3, 4 and 5 are the coordinates.

Known limitations

• As reported [[2]], GCPconvert alters slightly values during the conversion, by adding non significant decimals.