CoCoCo: COndor Coordinates COnverter - Version 1.1 beta

CoCoCo is a basic tool to convert Latitude and Longitude to Condor XY coordinates
It handles both Condor 1 and Condor 2. 
It can detect and read most of Lat/Lon formats
The conversion accuracy is usually better than 1 metre.

INSTALLATION

CoCoCo can be installed anywhere (in a folder where the user has write access).
Uncompress the ZIP paackage in the desired folder
The folder should contain
CoCoCo.exe:     executable file
Navicon.dll:    coordinated conversion library
LISEZMOI.txt:   French version
README.txt:     this file
SampleBatch.txt sample batch file

USAGE

CoCoCo.exe runs only in CLI (Command Line Interface) mode for the time being.
If there are more than one waypoint to process, it can be used in batch mode.

It is also possible to drag-and-drop a batch file onto the CoCoCo icon (see below)

SINGLE-POINT MODE

The command line syntax is :

> CoCoCo.exe [-help] [-v] [-debug] [-clip] [-conv:THRESHOLD] Landscape Latitude Longitude

	all [-options] are optional

	-help : displays the command line syntax

	-v : verbose 

	-debug : debugging mode (if needed for support)

	-clip : the resulting XY coordinates will be copied to the clipboard in the .fpl 
	format

	-conv:THRESHOLD : change the convergence threshold (C1 ONLY, use with caution - see below)

	Landscape : the name of the landscape (both C1 & C2 can be searched)

	Latitude Longitude : supported formats are (examples are for TRAVNIK in Slovenia2) 

	- decimal degrees (negative values for S & W ):  46.4205513  14.8083334

	- sexagesimal degrees:                           46°25'13.98["]N 14°48'30.0["]E  
	  NOTE: " is a special character for DOS; it is recommended no to using it.

	- sexagesimal degrees (whitespace-separated):    46 25 13.98[ ]N 14 48 30.0[ ]E 

	- SEE YOU format (.cup) (leading zeros required): 4625.233N 01448.500E 

	- Condor "F2" format (leading zeros required):    46.25.233N 014.48.500E 

If you are pasting lat/lon from some websites, be aware that they may use some UNICODE 
characters for degrees, minutes and seconds. If it is the case you will have to replace 
them by the equivalent ASCII characters (the ones you get by typing °, ' and " on your 
keyboard) 

For Condor2 the conversion is made directly usinng the WGS-84 UTM formulas.

For Condor1, the conversion is made with a Newton-Raphson solver which uses the routines
from Navicon.dll. In some cases the convergence of the solver may fail. 
Should this happen, try running CoCoCo with the -debug option, and look for positive/negative 
oscillations in the "Lat/Lon errors" fields. If these happen, change the convergence threshold
to a value slightly above the positive value. 
e.g. if the error oscillates between -6.123456E-06 and 6.123456E-06, set the threshold to 8.0E-06

Note : the default value for the convergence threshold is 5.0E-06 degree (approx 0.5 m in distance)

BATCH MODE

The 2 possible batch mode syntaxes are:

> CoCoCo.exe -batch [-v] [-debug] [-conv:THRESHOLD] Landscape BatchFile [OutputFile]
	
BatchFile :  name of the text file from which coordinates will be read

OutputFile : name of the file to which the Condor coordinates will be written
             if omitted, same name as BatchFile with extension .fpl
	     You can then cut and paste from that file to the .fpl file	     

> CoCoCo.exe [-v] [-debug] [-conv:THRESHOLD] BatchFile 
             OutputFile will have the same name as BatchFile with extension .fpl

Batch file format:

first line :
Landscape=LandscapeName (ignored if Landscape is specified on the command line)
then, on each line : 
WPNumber WPName WPLatitude WPLongitude WPAltitude (whitespace- or comma-separated)
All Lat/Lon formats are supported except the whitespace-separated sexagesimal degrees

SUPPORT

Please report any bugs to: cotaco@marc-till.com

ACKNOWLEDGEMENTS

NaviCon.dll is provided courtesy of UBSoft, editor of Condor, who remains owner of the copyright

DISCLAIMER

Copyright (C) 2021 Marc TILL

This software is provided 'as-is', without any express or implied warranty.  
In no event will the authors be held liable for any damages arising from  the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to 
redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated.

  2. This notice may not be altered or removed from any distribution.