Home

Corelyzer

Corelyzer is a scalable, extensible visualization tool developed to enhance the study of geological cores. The strength of Corelyzer is the ability to display large sets of core imagery, with multi-sensor logs, annotations and plugin supported visuals alongside the core imagery. This document describes how to download, setup and use the software.

Building Corelyzer

Corelyzer consists of two pieces: the SceneGraph library and the Corelyzer application itself. The SceneGraph library uses native code and must be compiled for each platform Corelyzer runs on. The Corelyzer application itself is written in Java and can be built on any platform. To build the Corelyzer application use the provided Gradle tool:

    sh gradlew clean package

This will compile the application using a pre-built versions of the SceneGraph library. It will package Corelyzer up for Mac and Windows in the dist/ directory.

NOTE: Currently the build process does not generate a Windows .exe or a Windows installer. We hope to have this process documented soon.

Building the SceneGraph Library

Building the SceneGraph library is slightly more complicated as it needs to be built for each platform and architecture Corelyzer runs on. It only needs to be re-built if you change the native code or if you increment the version number.

These instructions assume you are building on a Mac OS X 10.5 or 10.6 machine with XCode / Developers Tools already installed.

Step i: Install MacPorts

The MingW cross compiler environment which we are using to generate Windows DLLs requires 'wget' and 'gsed' which are available from MacPorts.

Install MacPorts from http://www.macports.org/install.php

Install 'wget' and 'gsed' via the Terminal:

    sudo port install wget gsed

This step only needs to be performed once.

Step ii: Bootstrap MingW environment

To build the Windows DLL we will be using the MingW cross compiler. You will need to bootstrap it for your machine via the Terminal:

    cd scenegraph/deps/win32
    tar xzvf bootstrap.tar.gz
    cd bootstrap
    make libpng jpeg tiff glew pthreads freetype

This will take several minutes so be patient. but only needs to be performed once.

Step 1: Build the JNI library

The final step is to build the SceneGraph JNI Library. You can do this by invoking Gradle in the scenegraph/ directory via the Terminal:

    ../gradlew clean build-jni

The resulting JAR file, jnilib, and DLLs will be in scenegraph/dist. You only need to re-run this step when you change the native code or when you change the version number.