Installation

Building CS-MAP on Windows and Linux

The CS-MAP distribution will produce a series of five directories:

• Include: Contains all header files referenced the source code in the Source directory.
• Source: Contains all the source code for the CS-MAP library itself.
• Dictionaries: Contains the coordinate system dictionaries in source form, and the source code for a compiler which will convert the dictionary source to the operational binary form.
• Test: Contains the source code for a console type test program and the test data which it uses.
• Data: Contains a series of data files used to construct name mapping files.

Building the entire product is a series of five steps:

1. Build the CS-MAP library.
2. Build the dictionary compiler.
3. Run the dictionary compiler.
4. Build the console test program.
5. Execute the console test program.

After installation, and before building, it will be best to obtain a copy of the Canadian National Transformation file (NTV2_0.gsb) and copy it to the Dictionaries/Canada directory. This data file may not be distributed by OSGeo. Geomatics Canada reserves the right to distribute this file and maintain a list of those using it. Therefore, since we do not distribute the file as part of this open source distribution, we recommend strongly that you simply obtain a copy, even if for testing purposes only. Chances are very good you already have a copy of this file on your system already. If not, you can obtain one (no fee) at: http://www.geod.nrcan.gc.ca

The TEST.DAT data file in the Test directory contains several hundred test points which are directly related to the above mentioned grid shift data file. To prevent confusion and unnecessary technical support, tests related to the Canadian National Transformation data file are commented out in the distribution. After obtaining a copy of the above mentioned data file, these test should be "uncommented" back in, so that the test program will test this feature.

OK. Now for building on your system:

Windows

1. Build the CS-MAP Library:

   • Make the Source directory your current working directory.
   • Use the MSVC set variables script to set the environmental variables correctly.
   • Use the nmake command and supply it with the Library.nmk make file. E.g. nmake /fLibrary.nmk

2. Build the Dictionary Compiler (CS_comp)

   • Make the 'Dictionaries' directory your current working directory.
   • Use the MSVC set variables script to set the environmental variables correctly.
   • Use the nmake command and supply it with the Compiler.nmk make file. E.g. nmake /fCompiler.nmk

3. Run the Dictionary Compiler

   • Make the Dictionaries directory your current working directory.
   • Execute the CS_comp program. E.g. CS_Comp . .
   • Note that the first argument to this command is the folder containing the dictionary source, the second argument is the directory to which the binary dictionary files are to be written.

4. Build the Console Test program (CS_Test)

   • Make the Test directory your current working directory.
   • Use the MSVC set variables script to set the environmental variables correctly.
   • Use the nmake command and supply it with the Test.nmk make file. E.g. nmake /fTest.nmk
5. Execute the console test program
   • Make the Test directory your current working directory.
   • Execute the CS_Test program. E.g. CS_Test /d..\Dictionaries
   • Note that the /d argument is the directory which the test program is to look to for the dictionaries and related data files.

Linux

1. Build the CS-MAP Library:
   • Make the Source directory your current working directory.
   • Use the make command and supply it with the Library.mak make file. E.g. make -fLibrary.mak
2. Build the Dictionary Compiler (CS_Comp)
   • Make the Dictionaries directory your current working directory.
   • Use the make command and supply it with the Compiler.mak make file. E.g. make -f Compiler.mak
3. Run the Dictionary Compiler
   • Make the Dictionaries directory your current working directory.
   • Execute the CS_Comp program. E.g. ./CS_Comp . .
   • Note that the first argument is the directory containing the dictionary source, the second argument is the directory to which the binary dictionary files are written.
4. Build the Console Test program (CS_Test)
   • Make the Test directory your current working directory.
   • Use the make command and supply it with the Test.mak make file. E.g. make -fTest.mak
5. Execute the console test program
   • Make the Test directory your current working directory.
   • Execute the CS_Test program. E.g. ./CS_Test -d../Dictionaries
   • Note that the /d argument is the directory which the test program is to look to for the dictionaries and related data files.

MS VC++ 2005 (Version 8):

The CS-MAP Open Source distribution will deposit in the primary directory a Microsoft Visual C++ Version 8.0 (VC2005) solution file. This file references project files in the Source, Dictionaries, and Test directories. This solution file and its related project files can be used to manufacture the library, dictionary compiler, and the test module. No provisions have been made for executing the dictionary compiler or the test module.