Requirements

Luiza is written in C++ and internal data structures are based on Standard Template Library (STL) containers. It was developed under gcc version 4.4.4, but is supposed to run in any modern C++ installation.

Additional packages and/or libraries which are required to build Luiza and its packages are:

CFITSIO library for reading and writing data files in FITS (Flexible Image Transport System) data format is obligatory. It is available as precompiled library in some linux distributions, can be also downloaded from CFITSIO web page.

Astrometry.net library is required to run luiza::Astrometry processor. Current implementation is based on version 0.38, which can be downloaded from here . Path to the catalogue where the library sources are downloaded and compiled (make) should be specified by ASTROMETRY_DIR environment variable. In addition, index files have to be downloaded from dedicated repository. Location of index files has to be specified in steering file.

CERN ROOT package is required to run processors stored in processors/luiza_root. It is used to provied graphic output from Luiza. The source and binaries can be downloaded from ROOT home page.

PYTHON libraries and the Mahotas packages are required to compile and use source finder processor from processors/image_python. Mahotas can be downloaded from here.

SOCI libraries are required to compile and use the SQL database interface. Please refer to SOCI documentation.

QT4 libraries are required to compile Luiza GUI interface

If you lack any of the required packages (but cfitsio), you can still compile and run Luiza (with reduced functionality): just delete catalogues with processors which can not be compiled (eg. processors/luiza_root or processors/image_python ).

Installation

Download archive with current luiza version: from Gloria SVN repository at Sourceforge or from here .

Create main destination folder and unpack the code there. You should then set the environment variable LUIZA_ROOT pointing to this location. For example:

setenv LUIZA_ROOT ${HOME}/astro/gloria/LuizaFramework

To create Luiza binary, shared libraries and documentation use 'make'. Current version of Makefile does not take all dependencies into account but it should work fine when building from scratch. Otherwise you should use 'make clean' and 'make' to be sure all cross-package dependencies are taken into account.

Luiza shared libraries will be built in a subfolder so you have to add it to library path before running Luiza:

setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${LUIZA_ROOT}/luiza/lib

Luiza itself is just a framework for I/O. The whole power of this solution is only visible when you consider additional processors, dedicated for special tasks. To make Luiza load different processor packages (stored and compiled in separate folders), one has to define LUIZA_DLL variable. To load all processors available in the current version:

setenv LUIZA_DLL ${LUIZA_ROOT}/processors/image_analysis/lib/libimageanalysis.so:${LUIZA_ROOT}/processors/luiza_example/lib/libexample.so:${LUIZA_ROOT}/processors/image_python/lib/libSimpleSourceFinder.so:${LUIZA_ROOT}/processors/luiza_root/lib/libluizaroot.so:${LUIZA_ROOT}/processors/astrometry/lib/libAstrometry.so

Python base processor requires also setting the variable pointing to the puthon sources:

setenv LUIZA_PYTHON ${LUIZA_ROOT}/processors/image_python/src

To run Luiza job:

${LUIZA_ROOT}/luiza/bin/Luiza {options} [steering file]

All required variables can be also set by using scripts env_tcsh or env_bash located in the main catalogue. You can modify these scripts to match your instalation.

You can test Luiza by running prepared test job (in the main catalog):

luiza/bin/Luiza test.xml

Small sample of fit files used in the test job should be stored in catalog linked as gloriadata. You can download these data here

Larger samples of fits images from different telescopes, sent by partners, which can be used for algorithm testing, are available from the dedicated web page .