NAME

read_fluorescent_database - Reads a fluorescent database

SYNOPSIS

#include "s2/s2_fluorescence.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int read_fluorescent_database
(
	Fluorescent_database **fl_db_ptr_ptr,
	char *file_name
);

DESCRIPTION

This routine reads a fluorescent database from a file. The flourescent database *fl_db_ptr is created or resized as necessary.

RETURNS

Either NO_ERROR, or ERROR, with an appropriate error message being set.

NOTE

The form of the flourescent database file is a header of the form:

        #! t=fluorescent_db c=<num_fluorescent_surfaces>

Followed by <num_fluorescent_surfaces> groups of spectra. Each group of spectra must be started with the spectra header, and end with the special soft end of file:

        #! eof

(Note that the "#" is resettable by the user option "comment-char", and the "!" is resettable by the user option "header-char"). Each group of spectra must contain an even number of spectra which are the spectra of an illuminant, followed by a spectra of the response of the given fluorescent surface to that illuminant. A reasonable number of relatively different illuminat spectra are required to adequately characterize a fluorescent surface.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER