Luiza

Welcome to the Luiza documentation page. This is the place where you can find some explanation and examples of how to run GLORIA analysis programs within Luiza.

If you use Luiza in your analysis, please acknowledge it by using the reference to:
A.F. Zarnecki et al., Analysis framework for GLORIA, Proc. SPIE 8454, 845408, 2012.

Luiza framework was based on the Marlin package developed by Frank Gaede and Jan Engels from DESY for the ILC data analysis.
Please acknowledge their effort by refering to:
F. Gaede, Marlin and LCCD: Software tools for the ILC, Nucl.Instrum.Meth.A559:177-180,2006.

The idea (and large parts of code) taken from Marlin is that every computing task is implemented as a processor (module) that analyzes the data stored in a gloria::GloriaDataContainer structure and created additional output is also added to that collection. The advantage of such a modular approach is to keep things as simple as possible. Every single step of the full analysis chain that goes eg. from raw images to light curves can be processed step by step and the output of each step is still self consistent and can be fed in to the next step without any manipulation. Dedicated processors can also be included to read data from local file or external file server, access databases as well as to store analysis results. FIT image collections as well as tabular data collections can be stored. The framework allows to define the processors (and their order) that are executed at runtime in a simple XML steering file. Via the steering file you can also define named parameters (as a string, float, int - single and arrays) for every processor as well as for the global scope. By using the framework users don't have to write any code that deals with the IO they simply write processors with defined callbacks, i.e. init(), processData(), check(), end().

More information is available at the following pages:

• How to install Luiza frmework
• How Luiza processes data
• How to prepare steering file
• Image analysis chain
• Object analysis chain
• Database access
• More examples
• Network configuration
• Writing your own processor
• GLORIA Sample Data
• Graphic User Interface for Luiza
• Development plans

Last versions release info:

Version v03-01
New features and improvements

• selection by header keywords possible when calculating average and median frame
• dark matching by header keywords and exposure time
• reading of raw Pi of the Sky frames (nonstandard file structure)
• returne values for processors reading input files implemented

Version v03-00
New features and improvements

• SQL database interface implemented
• processor for searching new objects
• code restructuring

Version v02-00
Final version for GLORIA

• improved aperture photometry implemented
• processor for matching image object with sky catalog
• frame calibration based on matched reference stars
• storing tables in root TTree format

Version v01-01
Development Version with improvements based on feedback and test results

• dedicated background map calculation and interpolation class implemented
• pixel cluster shape analysis methods implemented
• processors for data table reading and writting in FITS format
• data table sorting implemented
• analysis of compressed FITS images possible

Version v01-00
Final version for demonstrator experiment

• processor for light curve reconstruction implemented
• improved background estimate in clustering algorithm
• aperture photometry implemented
• Laplace transformation for image "sharpening" added

Version v00-06

• astrometry processor based on Astrometry.Net added
• XML file for storing network configuration and telescope specific analysis parameters
• extended options for image manipulation
• weighted subtraction of dark and bias frames based on exposure times

Version v00-05

• First version stored in Gloria SVN
• GUI for steering file editing added, based on QT4
• Processor for writing tables to text files added
• Image viewer processor based on CERN root libraries
• Exceptions allowing for job control from processor level implemented

Version v00-04

• First public version
• Processors for image normalization and object finding added
• Directories structure modified to reflect code modularity better
• Processors for image analysis built as a separate module

Version v00-03

• Processors for adding/averaging images and for writing images to output FITS file added.

Version v00-02

• Makefile added. Not all dependencies properly included, but it should help anyway
• ExampleProcessor added, linked as shared library - example for users to start developing their own processors
• Still no time for proper cleaning of the code...

Version v00-01

• Class for handling FITS tables added
• More documentation added
• Still a lot of cleaning needed in the code...

Version v00-00

• First running version
• Includes only basic functionality
• Under heavy development: version not stable