GFitsTable.hpp

Go to the documentation of this file.

/***************************************************************************
 *             GFitsTable.hpp - FITS table abstract base class             *
 * ----------------------------------------------------------------------- *
 *  copyright (C) 2008-2026 by Juergen Knoedlseder                         *
 * ----------------------------------------------------------------------- *
 *                                                                         *
 *  This program is free software: you can redistribute it and/or modify   *
 *  it under the terms of the GNU General Public License as published by   *
 *  the Free Software Foundation, either version 3 of the License, or      *
 *  (at your option) any later version.                                    *
 *                                                                         *
 *  This program is distributed in the hope that it will be useful,        *
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of         *
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          *
 *  GNU General Public License for more details.                           *
 *                                                                         *
 *  You should have received a copy of the GNU General Public License      *
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.  *
 *                                                                         *
 ***************************************************************************/
/**
 * @file GFitsTable.hpp
 * @brief FITS table abstract base class interface definition
 * @author Juergen Knoedlseder
 */
 
#ifndef GFITSTABLE_HPP
#define GFITSTABLE_HPP
 
/* __ Includes ___________________________________________________________ */
#include "GFitsHDU.hpp"
#include "GFitsTableCol.hpp"
 
 
/***********************************************************************//**
 * @class GFitsTable
 *
 * @brief Abstract interface for FITS table
 *
 * This class defines the abstract interface for a FITS table. A FITS table
 * is a collection of columns with an identical number of rows. This class
 * provides high level access to table columns.
 ***************************************************************************/
class GFitsTable : public GFitsHDU {
 
public:
    // Constructors and destructors
    GFitsTable(void);
    explicit GFitsTable(const int& nrows);
    GFitsTable(const GFitsTable& table);
    virtual ~GFitsTable(void);
 
    // Operators
    GFitsTable&          operator=(const GFitsTable& table);
    GFitsTableCol*       operator[](const int& colnum);
    const GFitsTableCol* operator[](const int& colnum) const;
    GFitsTableCol*       operator[](const std::string& colname);
    const GFitsTableCol* operator[](const std::string& colname) const;
 
    // Pure virtual methods
    virtual void        clear(void) = 0;
    virtual GFitsTable* clone(void) const = 0;
    virtual std::string classname(void) const = 0;
    virtual HDUType     exttype(void) const = 0;
 
    // Implemented Methods
    bool           is_empty(void) const;
    GFitsTableCol* set(const int& colnum, const GFitsTableCol& column);
    GFitsTableCol* set(const std::string& colname, const GFitsTableCol& column);
    GFitsTableCol* append(const GFitsTableCol& column);
    GFitsTableCol* insert(int colnum, const GFitsTableCol& column);
    GFitsTableCol* insert(const std::string& colname, const GFitsTableCol& column);
    void           remove(const int& colnum);
    void           remove(const std::string& colname);
    void           append_rows(const int& nrows);
    void           insert_rows(const int& row, const int& nrows);
    void           remove_rows(const int& row, const int& nrows);
    const int&     nrows(void) const;
    const int&     ncols(void) const;
    bool           contains(const std::string& colname) const;
    std::string    print(const GChatter& chatter = NORMAL) const;
 
protected:
    // Protected methods
    void  init_members(void);
    void  copy_members(const GFitsTable& table);
    void  free_members(void);
    void  free_columns(void);
    void  update_header(void);
    void  data_open(void* vptr);
    void  data_save(void);
    void  data_close(void);
    void  data_connect(void* vptr);
    char* get_ttype(const int& colnum) const;
    char* get_tform(const int& colnum) const;
    char* get_tunit(const int& colnum) const;
 
    // Protected data area
    int             m_type;       //!< Table type (1=ASCII, 2=Binary)
    int             m_rows;       //!< Number of rows in table
    int             m_cols;       //!< Number of columns in table
    GFitsTableCol** m_columns;    //!< Array of table columns
 
private:
    // Private methods
    GFitsTableCol*  alloc_column(int typecode) const;
    GFitsTableCol*  ptr_column(const std::string& colname) const;
    int             colnum(const std::string& colname) const;
};
 
 
/***********************************************************************//**
 * @brief Signals if the FITS table has no row or columns
 *
 * @return True if FITS table has no row or columns.
 ***************************************************************************/
inline
bool GFitsTable::is_empty(void) const
{
    return ((m_rows == 0) || (m_cols == 0));
}
 
 
/***********************************************************************//**
 * @brief Return number of rows in table
 *
 * @return Number of rows in table
 *
 * Returns the number of rows in table.
 ***************************************************************************/
inline
const int& GFitsTable::nrows(void) const
{
    return (m_rows);
}
 
 
/***********************************************************************//**
 * @brief Return number of columns in table
 *
 * @return Number of columns in table
 *
 * Returns the number of columns in table. This method is equivalent to the
 * size() method.
 ***************************************************************************/
inline
const int& GFitsTable::ncols(void) const
{
    return (m_cols);
}
 
 
/***********************************************************************//**
 * @brief Append column to the table
 *
 * @param[in] column Table column.
 * @return Pointer to table column that has been appended
 ***************************************************************************/
inline
GFitsTableCol* GFitsTable::append(const GFitsTableCol& column)
{
    return (insert(m_cols, column));
}
 
#endif /* GFITSTABLE_HPP */