GIRAFFE Pipeline Reference Manual

Field of View Reconstruction

Functions

cxint giraffe_fov_build (GiFieldOfView *result, GiRebinning *rebinning, GiTable *fibers, GiTable *wsolution, GiTable *grating, GiTable *slitgeometry, GiFieldOfViewConfig *config)
 Create and image and a data cube from extracted and rebinned spectra.
GiFieldOfView * giraffe_fov_new (void)
 Create an empty container for the results of the field of view reconstruction.
void giraffe_fov_clear (GiFieldOfView *self)
 Delete the contents of a field of view object.
void giraffe_fov_delete (GiFieldOfView *self)
 Deallocate a field of view object and its contents.
cxint giraffe_fov_save_cubes (const GiFieldOfView *self, cpl_propertylist *properties, const cxchar *filename, cxptr data)
 Write the cube components of a field-of-view object to a file.
GiFieldOfViewConfig * giraffe_fov_config_create (cpl_parameterlist *list)
 Creates a setup structure for the field of view reconstruction.
void giraffe_fov_config_destroy (GiFieldOfViewConfig *config)
 Destroys a field of view setup structure.
void giraffe_fov_config_add (cpl_parameterlist *list)
 Adds parameters for the image and data cube construction.

Detailed Description

The module provides the functions to create data cubes and field of view images, which are constructed from the resampled spectra images.


Function Documentation

cxint giraffe_fov_build ( GiFieldOfView *  result,
GiRebinning *  rebinning,
GiTable *  fibers,
GiTable *  wsolution,
GiTable *  grating,
GiTable *  slitgeometry,
GiFieldOfViewConfig *  config 
)

Create and image and a data cube from extracted and rebinned spectra.

Parameters:
result The results of the image and data cube creation.
rebinning The extracted and rebinned spectra.
fibers The fiber setup
wsolution The dispersion solution
grating The grating table
slitgeometry The slit geometry
config Setup parameters for reconstruction task.
Returns:
The function returns 0 on success and a non-zero value otherwise.

The function creates an image from the extracted and rebinned spectra of an IFU or Argus observation. The rebinned spectra and errors are taken from the rebinning structure rebinning. The corresponding fiber setup is expected in the input table fibers. Configuration options are passed through the setup structure config.

Definition at line 434 of file gifov.c.

References giraffe_cube_delete(), giraffe_cube_sqrt(), giraffe_fiberlist_get_subslits(), giraffe_fov_clear(), giraffe_get_mode(), giraffe_image_delete(), giraffe_image_duplicate(), giraffe_image_get(), giraffe_image_get_properties(), giraffe_image_new(), giraffe_image_set(), giraffe_image_set_properties(), giraffe_range_delete(), giraffe_range_get_max(), giraffe_range_get_min(), giraffe_range_set_max(), giraffe_range_set_min(), giraffe_rebin_get_wavelength_range(), and giraffe_table_get().

void giraffe_fov_clear ( GiFieldOfView *  self  ) 

Delete the contents of a field of view object.

Parameters:
self The field of view object to be emptied.
Returns:
Nothing.

Definition at line 1199 of file gifov.c.

References giraffe_cube_delete(), and giraffe_image_delete().

Referenced by giraffe_fov_build(), and giraffe_fov_delete().

void giraffe_fov_config_add ( cpl_parameterlist *  list  ) 

Adds parameters for the image and data cube construction.

Parameters:
list Parameter list to which parameters are added.
Returns:
Nothing.

Definition at line 1502 of file gifov.c.

GiFieldOfViewConfig* giraffe_fov_config_create ( cpl_parameterlist *  list  ) 

Creates a setup structure for the field of view reconstruction.

Parameters:
list Parameter list from which the setup informations is read.
Returns:
A newly allocated and initialized setup structure if no errors occurred, or NULL otherwise.

Definition at line 1437 of file gifov.c.

void giraffe_fov_config_destroy ( GiFieldOfViewConfig *  config  ) 

Destroys a field of view setup structure.

Parameters:
config The setup structure to destroy.
Returns:
Nothing.

The function deallocates the memory used by the setup structure config.

Definition at line 1480 of file gifov.c.

void giraffe_fov_delete ( GiFieldOfView *  self  ) 

Deallocate a field of view object and its contents.

Parameters:
self The field of view object to destroy.
Returns:
Nothing.

The function the field-of-view container object self, and all data components it possibly contains.

Definition at line 1266 of file gifov.c.

References giraffe_fov_clear().

GiFieldOfView* giraffe_fov_new ( void   ) 

Create an empty container for the results of the field of view reconstruction.

Returns:
A newly allocated and empty field of view container.

The function allocates the memory for a field of view container and initializes the created object so that it is a valid empty container object.

Definition at line 1165 of file gifov.c.

cxint giraffe_fov_save_cubes ( const GiFieldOfView *  self,
cpl_propertylist *  properties,
const cxchar *  filename,
cxptr  data 
)

Write the cube components of a field-of-view object to a file.

Parameters:
self A field-of-view object
properties The property list to save with the object
filename The name of the output file
data Pointer to an integer which specifies which cube component will be saved.
Returns:
The function returns 0 on success, or a non-zero number in case an error occurred.

The function creates an a file filename for a cube component of an field-of-view object. The cube componentes are either the spectrum cube, or its associated error cube. Which component is written is determined by the value of an integer variable referenced by data. If the value is 0 the spectrum cube will be saved, and the error cube is saved in case of a non-zero value.

Definition at line 1302 of file gifov.c.

References giraffe_cube_save().


This file is part of the GIRAFFE Pipeline Reference Manual 2.8.8.
Documentation copyright © 2002-2006 European Southern Observatory.
Generated on Fri Mar 4 10:50:29 2011 by doxygen 1.6.3 written by Dimitri van Heesch, © 1997-2004