Obtaining It

It comes as a single zip file. Unpacking it will yield installers for Boost, for the Lggm libraries, for the test cases, the source code, and the documentation. The Boost code, the Lggm libraries, and the Lggm sources are required; the rest is optional.

Download it from http://gis.leica-geosystems.com/isg/rit/downloads/WASP_Distribution.zip

A general walk through of the installation and package, including the download link above, can be found at http://gis.leica-geosystems.com/isg/rit/documentation/

Installing It

1. Unpack

I usually unpack the zip file under e:/tmp You'll then have a directory, typically named WASP_Distribution In there you'll find the aforementioned installers.

2. Install Boost

Run the Boost installer. When it prompts you for the installation path, use C:/Program Files/Imagine 8.7

3. Install Lggm

Run the Lggm Components installer. When it prompts you for the installation path, use the same path you entered in the previous step.

Run the Lggm Source installer. You need this in order to get the header files. It doesn't matter where you install this to; use e:/tmp/lggmsrc if you can't think of something better.

4. Generate Library Files

You thought you were done, didn't you? The installer distributes DLL files, which are great at runtime. However, you can't link executables against them. So, we need to create the LIB files they forgot to give us.

Open a Cygwin terminal. Then get into the Imagine installation directory.

cd 'c:/Program Files/Imagine 8.7/'

Look in the usr/lib/ntx86 subdirectory. Do you see these files? LggmIGM.lib LggmIMFM.lib LggmIMWM.lib LggmIRSM.lib LggmIsgBlockSupportLib.lib LggmIsgOrthoResampleLib.lib LggmWaspCommonClasses.lib

If you do, go ahead and move to the next step. Otherwise, you've got to manually generate the LIB files that go with these DLLs. sigh

You need this perl script: libfromdll.pl Install it where ever you want.

Get into the bin directory, where the DLLs are. Create a little subdirectory to work in. Copy all the Lggm DLLs into it.

cd bin/ntx86
mkdir hack
cp Lggm*dll hack
cd hack

Create the LIB files. I don't know where you put the perl script, so replace the ... accordingly.

for f in *.dll; do .../libfromdll.pl $f; done

Now you've got a directory full of DLL and EXP and DEF and LIB files. Copy the LIB files into the place where we expect to find them.

cp *.lib ../../../usr/lib/ntx86

Copy Header Files

The header files they distribute are also spread all over the place. This step consolidates them into a single useful place. Copy the component headers into place.

cd e:/tmp/lggmsrc
find Wasp_Components -name '*.h' -print \
    -exec cp '{}' 'c:/Program Files/Imagine 8.7/usr/include/ntx86' ';'

That's it. You're done.