Method fitsImageLabel

isis/src/base/objs/ProcessImportFits/ProcessImportFits.cpp:259–281

* Supplies the FITS image label corresponding to the given index. Zero * returns the first label that precedes actual image data. Extra labels that * have no data can be accessed by calling extraFitsLabel(). * * @see extraFitsLabel() * * @param labelNumber The index to the FITS header image label. * * @return PvlGroup version of a FITS label corresponding to reques

   * @return PvlGroup version of a FITS label corresponding to requested label number.
   */
  PvlGroup ProcessImportFits::fitsImageLabel(int labelNumber) const {

    if (labelNumber >= m_fitsImageLabels->size()) {
      QString msg = QObject::tr("The requested label number [%1], from file [%2] is "
                                "past the last image group found in this FITS file. "
                                "Image label count is [%3]").arg(labelNumber).
                                arg(m_name.expanded()).arg(m_fitsImageLabels->size()-1);
      throw IException(IException::User, msg, _FILEINFO_);
    }

    if (!m_fitsImageLabels) {
      QString msg = QObject::tr("The FITS label has not been initialized, "
                                "call setFitsFile first.");
      throw IException(IException::Programmer, msg, _FILEINFO_);
    }
    else if (m_fitsImageLabels->size() < labelNumber) {
      QString msg = QObject::tr("The requested FITS label number "
                                "was not found in file [%1].").arg(m_name.toString());
      throw IException(IException::Programmer, msg, _FILEINFO_);
    }

    return *(*m_fitsImageLabels)[labelNumber];
  }


  /**