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

Syntax of the command

The global syntax for GCPConvert is :

mm3d GCPConvert FormatSpecification GCPFile NamedArgs

Formatting the input GCP file

If, you don't use an AppXML formatted file (in fact a MicMac XML file), the input file has to be a space or tabulation separated values file (no comma or other symbols).

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.

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