GammaLib  2.1.0.dev
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
GFitsTableLongLongCol Class Reference

FITS table long long integer column. More...

#include <GFitsTableLongLongCol.hpp>

Inheritance diagram for GFitsTableLongLongCol:
GFitsTableCol GBase

Public Member Functions

 GFitsTableLongLongCol (void)
 Constructor. More...
 
 GFitsTableLongLongCol (const std::string &name, const int &nrows, const int &size=1)
 Constructor. More...
 
 GFitsTableLongLongCol (const GFitsTableLongLongCol &column)
 Copy constructor. More...
 
virtual ~GFitsTableLongLongCol (void)
 Destructor. More...
 
GFitsTableLongLongColoperator= (const GFitsTableLongLongCol &column)
 Assignment operator. More...
 
long long & operator() (const int &row, const int &inx=0)
 Column data access operator. More...
 
const long long & operator() (const int &row, const int &inx=0) const
 Column data access operator (const variant) More...
 
virtual void clear (void)
 Clear instance. More...
 
virtual GFitsTableLongLongColclone (void) const
 Clone column. More...
 
virtual std::string classname (void) const
 Return class name. More...
 
virtual std::string string (const int &row, const int &col=0) const
 Get string value. More...
 
virtual double real (const int &row, const int &col=0) const
 Get double precision value. More...
 
virtual int integer (const int &row, const int &col=0) const
 Get integer value. More...
 
virtual void insert (const int &row, const int &nrows)
 Insert rows in column. More...
 
virtual void remove (const int &row, const int &nrows)
 Remove rows from column. More...
 
virtual bool is_loaded (void) const
 Checks if column has been loaded. More...
 
long long * data (void)
 Returns pointer to column data. More...
 
long long * nulval (void)
 Returns pointer to nul value. More...
 
void nulval (const long long *value)
 Set nul value. More...
 
- Public Member Functions inherited from GFitsTableCol
 GFitsTableCol (void)
 Void constructor. More...
 
 GFitsTableCol (const std::string &name, const int &nrows, const int &number, const int &width)
 Column constructor. More...
 
 GFitsTableCol (const GFitsTableCol &column)
 Copy constructor. More...
 
virtual ~GFitsTableCol (void)
 Destructor. More...
 
GFitsTableColoperator= (const GFitsTableCol &column)
 Assignment operator. More...
 
void name (const std::string &name)
 Set column name. More...
 
const std::string & name (void) const
 Returns column name. More...
 
void unit (const std::string &unit)
 Set column unit. More...
 
const std::string & unit (void) const
 Returns column unit. More...
 
void dim (const std::vector< int > &dim)
 Set column dimension. More...
 
const std::vector< int > & dim (void) const
 Returns column dimension. More...
 
void colnum (const int &colnum)
 Set column number. More...
 
const int & colnum (void) const
 Returns column number in FITS file (starting from 1) More...
 
void type (const int &type)
 Set type code. More...
 
const int & type (void) const
 Returns CFITSIO column type. More...
 
void repeat (const int &repeat)
 Set repeat value. More...
 
const int & repeat (void) const
 Returns column repeat value (only used for binary tables) More...
 
void width (const int &width)
 Set width in Bytes of one column element. More...
 
const int & width (void) const
 Return width in Bytes of one column element. More...
 
void number (const int &number)
 Set number of elements in column. More...
 
const int & number (void) const
 Returns number of elements in column. More...
 
void elements (const int &row, const int &elements)
 Set number of column elements for specific row. More...
 
int elements (const int &row) const
 Returns number of elements in column for specific row. More...
 
void nrows (const int &nrows)
 Set number of rows in column. More...
 
const int & nrows (void) const
 Returns number of rows in column. More...
 
void is_variable (const bool &variable)
 Set variable-length flag. More...
 
const bool & is_variable (void) const
 Signals if column is of variable length. More...
 
void anynul (const int &anynul)
 Set number of NULLs encountered. More...
 
const int & anynul (void) const
 Return number of NULLs encountered. More...
 
void tscale (const double &tscale)
 Set TSCALE value. More...
 
const double & tscale (void) const
 Return TSCALE value. More...
 
std::string tform_binary (void) const
 Returns TFORM code for binary table column. More...
 
std::string print (const GChatter &chatter=NORMAL) const
 Print column information. More...
 
- Public Member Functions inherited from GBase
virtual ~GBase (void)
 Destructor. More...
 

Private Member Functions

void init_members (void)
 Initialise class members. More...
 
void copy_members (const GFitsTableLongLongCol &column)
 Copy class members. More...
 
void free_members (void)
 Delete class members. More...
 
void alloc_nulval (const long long *value)
 Allocates null value. More...
 
virtual void alloc_data (void)
 Allocates column data. More...
 
virtual void init_data (void)
 Initialise column data. More...
 
virtual void fetch_data (void) const
 Fetch column data. More...
 
virtual void resize_data (const int &index, const int &number)
 Resize column data. More...
 
virtual void release_data (void)
 Release column data. More...
 
virtual void * ptr_data (const int &index=0)
 Returns void pointer to column data. More...
 
virtual void * ptr_nulval (void)
 Returns void pointer to nul value. More...
 
virtual std::string ascii_format (void) const
 Returns format string of ASCII table. More...
 

Private Attributes

long long * m_data
 Data vector. More...
 
long long * m_nulval
 NULL value. More...
 

Additional Inherited Members

- Protected Member Functions inherited from GFitsTableCol
void init_members (void)
 Initialise class members. More...
 
void copy_members (const GFitsTableCol &column)
 Copy class members. More...
 
void free_members (void)
 Delete class members. More...
 
void connect (void *vptr)
 Connect table column to FITS file. More...
 
virtual void save (void)
 Save table column into FITS file. More...
 
virtual void load_column (void)
 Load table column from FITS file. More...
 
virtual void load_column_fixed (void)
 Load fixed-length column from FITS file. More...
 
virtual void load_column_variable (void)
 Load variable-length column from FITS file. More...
 
virtual void save_column (void)
 Save table column into FITS file. More...
 
virtual void save_column_fixed (void)
 Save table column into FITS file. More...
 
virtual void save_column_variable (void)
 Save table column into FITS file. More...
 
virtual int offset (const int &row, const int &inx) const
 Compute offset of column element in memory. More...
 
- Protected Attributes inherited from GFitsTableCol
std::string m_name
 Column name. More...
 
std::string m_unit
 Column unit. More...
 
std::vector< int > m_dim
 Column dimension. More...
 
int m_colnum
 Column number (starting from 1). This parameter is used to signal if a table column corresponds to a FITS file column. If it is set to 0 there is no correspondence. More...
 
int m_type
 Column type. More...
 
int m_repeat
 Repeat value of column. More...
 
int m_width
 Width in Bytes of single column element. More...
 
int m_number
 Number of elements in column. More...
 
int m_length
 Length of column (number of rows) More...
 
bool m_variable
 Signals if column is variable length. More...
 
int m_varlen
 Maximum number of elements in variable-length. More...
 
std::vector< int > m_rowstart
 Start index of each row. More...
 
int m_size
 Size of allocated data area (0 if not loaded) More...
 
int m_anynul
 Number of NULLs encountered. More...
 
void * m_fitsfile
 FITS file pointer associated with column. More...
 
double m_tscale
 Optional scaling factor (1 = no scaling) More...
 

Detailed Description

FITS table long long integer column.

This class implements a FITS table long long integer column.

Definition at line 42 of file GFitsTableLongLongCol.hpp.

Constructor & Destructor Documentation

GFitsTableLongLongCol::GFitsTableLongLongCol ( void  )

Constructor.

Definition at line 57 of file GFitsTableLongLongCol.cpp.

References init_members().

Referenced by clone().

GFitsTableLongLongCol::GFitsTableLongLongCol ( const std::string &  name,
const int &  nrows,
const int &  size = 1 
)

Constructor.

Parameters
[in]nameName of column.
[in]nrowsNumber of rows in column.
[in]sizeVector size of column.

Definition at line 74 of file GFitsTableLongLongCol.cpp.

References init_members().

GFitsTableLongLongCol::GFitsTableLongLongCol ( const GFitsTableLongLongCol column)

Copy constructor.

Parameters
[in]columnTable column.

Definition at line 92 of file GFitsTableLongLongCol.cpp.

References copy_members(), and init_members().

GFitsTableLongLongCol::~GFitsTableLongLongCol ( void  )
virtual

Destructor.

Definition at line 109 of file GFitsTableLongLongCol.cpp.

References free_members().

Member Function Documentation

void GFitsTableLongLongCol::alloc_data ( void  )
privatevirtual

Allocates column data.

Implements GFitsTableCol.

Definition at line 599 of file GFitsTableLongLongCol.cpp.

References m_data, and GFitsTableCol::m_size.

Referenced by copy_members(), and insert().

void GFitsTableLongLongCol::alloc_nulval ( const long long *  value)
private

Allocates null value.

Parameters
[in]valueNul value.

Definition at line 717 of file GFitsTableLongLongCol.cpp.

References m_nulval.

Referenced by copy_members(), and nulval().

std::string GFitsTableLongLongCol::ascii_format ( void  ) const
privatevirtual

Returns format string of ASCII table.

Implements GFitsTableCol.

Definition at line 580 of file GFitsTableLongLongCol.cpp.

std::string GFitsTableLongLongCol::classname ( void  ) const
inlinevirtual

Return class name.

Returns
String containing the class name ("GFitsTableLongLongCol").

Implements GFitsTableCol.

Definition at line 102 of file GFitsTableLongLongCol.hpp.

void GFitsTableLongLongCol::clear ( void  )
virtual

Clear instance.

This method properly resets the object to an initial state.

Implements GFitsTableCol.

Definition at line 202 of file GFitsTableLongLongCol.cpp.

References free_members(), GFitsTableCol::free_members(), init_members(), and GFitsTableCol::init_members().

GFitsTableLongLongCol * GFitsTableLongLongCol::clone ( void  ) const
virtual

Clone column.

Implements GFitsTableCol.

Definition at line 220 of file GFitsTableLongLongCol.cpp.

References GFitsTableLongLongCol().

void GFitsTableLongLongCol::copy_members ( const GFitsTableLongLongCol column)
private

Copy class members.

Parameters
[in]columnColumn.

Sets the content of the vector column by copying from another column. If the code is compiled with the small memory option, and if the source column has not yet been loaded, then we only load the column temporarily for copying purposes and release it again once copying is finished.

Definition at line 519 of file GFitsTableLongLongCol.cpp.

References alloc_data(), alloc_nulval(), fetch_data(), is_loaded(), m_data, m_nulval, GFitsTableCol::m_rowstart, GFitsTableCol::m_size, GFitsTableCol::m_type, GFitsTableCol::m_varlen, and release_data().

Referenced by GFitsTableLongLongCol(), and operator=().

long long * GFitsTableLongLongCol::data ( void  )
inline

Returns pointer to column data.

Returns
Pointer to column data.

Definition at line 126 of file GFitsTableLongLongCol.hpp.

References m_data.

void GFitsTableLongLongCol::fetch_data ( void  ) const
privatevirtual

Fetch column data.

Implements GFitsTableCol.

Definition at line 620 of file GFitsTableLongLongCol.cpp.

References GFitsTableCol::load_column().

Referenced by copy_members(), insert(), integer(), operator()(), real(), remove(), resize_data(), and string().

void GFitsTableLongLongCol::free_members ( void  )
private

Delete class members.

Definition at line 559 of file GFitsTableLongLongCol.cpp.

References m_data, m_nulval, and GFitsTableCol::m_size.

Referenced by clear(), operator=(), and ~GFitsTableLongLongCol().

void GFitsTableLongLongCol::init_data ( void  )
privatevirtual

Initialise column data.

Implements GFitsTableCol.

Definition at line 739 of file GFitsTableLongLongCol.cpp.

References m_data, and GFitsTableCol::m_size.

Referenced by insert().

void GFitsTableLongLongCol::init_members ( void  )
private

Initialise class members.

Definition at line 497 of file GFitsTableLongLongCol.cpp.

References __TLONGLONG, m_data, m_nulval, and GFitsTableCol::m_type.

Referenced by clear(), GFitsTableLongLongCol(), and operator=().

void GFitsTableLongLongCol::insert ( const int &  row,
const int &  nrows 
)
virtual

Insert rows in column.

Parameters
[in]rowRow after which rows should be inserted (0=first row).
[in]nrowsNumber of rows to be inserted.
Exceptions
GException::out_of_rangeSpecified row is invalid.

Inserts rows into a FITS table. This implies that all columns will be loaded into memory.

Implements GFitsTableCol.

Definition at line 298 of file GFitsTableLongLongCol.cpp.

References alloc_data(), fetch_data(), G_INSERT, init_data(), m_data, GFitsTableCol::m_length, GFitsTableCol::m_number, GFitsTableCol::m_size, and GFitsTableCol::nrows().

int GFitsTableLongLongCol::integer ( const int &  row,
const int &  inx = 0 
) const
virtual

Get integer value.

Parameters
[in]rowTable row.
[in]inxTable column vector index.

Returns value of specified row and vector index as integer.

Implements GFitsTableCol.

Definition at line 273 of file GFitsTableLongLongCol.cpp.

References fetch_data(), m_data, and GFitsTableCol::offset().

bool GFitsTableLongLongCol::is_loaded ( void  ) const
inlinevirtual

Checks if column has been loaded.

Returns
True if column has been loaded, false otherwise

Implements GFitsTableCol.

Definition at line 114 of file GFitsTableLongLongCol.hpp.

References m_data.

Referenced by copy_members().

long long * GFitsTableLongLongCol::nulval ( void  )
inline

Returns pointer to nul value.

Returns
Pointer to nul value.

Definition at line 138 of file GFitsTableLongLongCol.hpp.

References m_nulval.

void GFitsTableLongLongCol::nulval ( const long long *  value)

Set nul value.

Parameters
[in]valueNul value.
Todo:
To correctly reflect the nul value in the data, the column should be reloaded. However, the column may have been changed, so in principle saving is needed. However, we may not want to store the data, hence saving is also not desired. We thus have to develop a method to update the column information for a new nul value in place ...

Definition at line 472 of file GFitsTableLongLongCol.cpp.

References alloc_nulval().

long long & GFitsTableLongLongCol::operator() ( const int &  row,
const int &  inx = 0 
)

Column data access operator.

Parameters
[in]rowRow of column to access.
[in]inxVector index in column row to access.

Provides access to data in a column.

Definition at line 163 of file GFitsTableLongLongCol.cpp.

References fetch_data(), m_data, and GFitsTableCol::offset().

const long long & GFitsTableLongLongCol::operator() ( const int &  row,
const int &  inx = 0 
) const

Column data access operator (const variant)

Parameters
[in]rowRow of column to access.
[in]inxVector index in column row to access.

Provides access to data in a column.

Definition at line 181 of file GFitsTableLongLongCol.cpp.

References fetch_data(), m_data, and GFitsTableCol::offset().

GFitsTableLongLongCol & GFitsTableLongLongCol::operator= ( const GFitsTableLongLongCol column)

Assignment operator.

Parameters
[in]columnTable column.
Returns
Table column.

Definition at line 131 of file GFitsTableLongLongCol.cpp.

References copy_members(), free_members(), init_members(), and GFitsTableCol::operator=().

void * GFitsTableLongLongCol::ptr_data ( const int &  index = 0)
inlineprivatevirtual

Returns void pointer to column data.

Returns
Void pointer to column data.

Implements GFitsTableCol.

Definition at line 150 of file GFitsTableLongLongCol.hpp.

References m_data.

void * GFitsTableLongLongCol::ptr_nulval ( void  )
inlineprivatevirtual

Returns void pointer to nul value.

Returns
Void pointer to nul value.

Implements GFitsTableCol.

Definition at line 162 of file GFitsTableLongLongCol.hpp.

References m_nulval.

double GFitsTableLongLongCol::real ( const int &  row,
const int &  inx = 0 
) const
virtual

Get double precision value.

Parameters
[in]rowTable row.
[in]inxTable column vector index.

Returns value of specified row and vector index as double precision.

Implements GFitsTableCol.

Definition at line 252 of file GFitsTableLongLongCol.cpp.

References fetch_data(), m_data, and GFitsTableCol::offset().

void GFitsTableLongLongCol::release_data ( void  )
privatevirtual

Release column data.

Implements GFitsTableCol.

Definition at line 698 of file GFitsTableLongLongCol.cpp.

References m_data, and GFitsTableCol::m_size.

Referenced by copy_members(), and resize_data().

void GFitsTableLongLongCol::remove ( const int &  row,
const int &  nrows 
)
virtual

Remove rows from column.

Parameters
[in]rowRow after which rows should be removed (0=first row).
[in]nrowsNumber of rows to be removed.
Exceptions
GException::out_of_rangeSpecified row is invalid. Invalid number of rows specified.

This method removes rows from a FITS table. This implies that the column will be loaded into memory.

Implements GFitsTableCol.

Definition at line 383 of file GFitsTableLongLongCol.cpp.

References fetch_data(), G_REMOVE, m_data, GFitsTableCol::m_length, GFitsTableCol::m_number, GFitsTableCol::m_size, and GFitsTableCol::nrows().

void GFitsTableLongLongCol::resize_data ( const int &  index,
const int &  number 
)
privatevirtual

Resize column data.

Parameters
[in]indexStart index.
[in]numberNumber of elements to add/remove.

Adds or removes elements from specified index on. Adding is done if number is a positive number, removing if number is negative. Note that the method does not change the validity of the arguments. This needs to be done by the client.

Implements GFitsTableCol.

Definition at line 641 of file GFitsTableLongLongCol.cpp.

References fetch_data(), gammalib::left(), m_data, GFitsTableCol::m_size, GFitsTableCol::number(), and release_data().

std::string GFitsTableLongLongCol::string ( const int &  row,
const int &  inx = 0 
) const
virtual

Get string value.

Parameters
[in]rowTable row.
[in]inxTable column vector index.

Returns value of specified row and vector index as string.

Implements GFitsTableCol.

Definition at line 234 of file GFitsTableLongLongCol.cpp.

References fetch_data(), m_data, GFitsTableCol::offset(), and gammalib::str().

Member Data Documentation

long long* GFitsTableLongLongCol::m_data
private
long long* GFitsTableLongLongCol::m_nulval
private

NULL value.

Definition at line 92 of file GFitsTableLongLongCol.hpp.

Referenced by alloc_nulval(), copy_members(), free_members(), init_members(), nulval(), and ptr_nulval().


The documentation for this class was generated from the following files: