mferreader.h

/******************************************************************************
*
*   This file is part of Cardio Curves.
*   Copyright (C) 2009 Jan Gunnar Andreassen
*   Copyright (C) 2009 Lars Magne Engedal
*
*   Cardio Curves is free software: you can redistribute it and/or modify
*   it under the terms of the GNU Lesser General Public License as published
*   by the Free Software Foundation, either version 2.1 of the License, or
*   (at your option) any later version.
*
*   Cardio Cruves 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 Lesser General Public License for more details.
*
*   You should have received a copy of the GNU Lesser General Public License
*   along with Cardio Curves.  If not, see <http://www.gnu.org/licenses/>.
*
*   Developer contact:
*       (janislazzaroni at users.sourceforge.net)
*       (engedal at users.sourceforge.net )
******************************************************************************/

#ifndef MFERREADER_H
#define MFERREADER_H

class MferReader
{
public:
    enum MFER_TAGS
    {
        //Level 1

        //Sampling attributes
        MWF_IVL = 0x0B, 
        MWF_SEN = 0x0C, 
        //Frame attributes
        MWF_BLK = 0x04, 
        MWF_CHN = 0x05, 
        MWF_SEQ = 0x06, 
        //Waveform
        MWF_WFM = 0x08, 
        MWF_LDN = 0x09, 
        MWF_WAV = 0x1E, 
        //Channel
        MWF_ATT = 0x3F, 
        //Data description
        MWF_DTP = 0x0A, 
        MWF_OFF = 0x0D, 
        MWF_NUL = 0x12, 
        MWF_CMP = 0x0E, 
        //Data alignment
        MWF_BLE = 0x01, 
        MWF_PNT = 0x07, 
        MWF_ZRO = 0x00, 
        //Explanation
        MWF_PRE = 0x40, 
        MWF_MAN = 0x17, 
        MWF_EVT = 0x41, 
        MWF_INF = 0x15, 
        MWF_CND = 0x44, 
        MWF_NTE = 0x16, 
        MWF_VER = 0x02, 
        MWF_TXC = 0x03, 
        MWF_FLT = 0x11, 
        MWF_IPD = 0x0F, 
        //Undefined invalid?
        MWF_INVALID = 0xFF 
    };

    enum SamplingRateUnit
    {
        Frequency_hz = 0, 
        Time_interval_sec = 1, 
        Distance_m = 2 
    };

    enum SamplingResolutionUnit
    {
        Volt = 0, 
        mmHg_Torr = 1, 
        Pa = 2, 
        cmH2O = 3, 
        mmHg_s = 4, 
        dyne = 5, 
        Newton = 6 
    };

    enum WaveformType
    {
        UNDEFINED = 0, 
        ECG_STD12 = 1, 
        ECG_LTERM = 2, 
        ECG_VECTR = 3, 
        ECG_EXCER = 4, 
        ECG_INTR = 5, 
        ECG_SURF = 6, 
        ECG_ILATE = 7, 
        ECG_LATE = 8 
    };

    enum WaveformCode
    {
        Lead_I = 1, 
        Lead_2 = 2, 
        Lead_V1 = 3, 
        Lead_V2 = 4, 
        Lead_V3 = 5, 
        Lead_V4 = 6, 
        Lead_V5 = 7, 
        Lead_V6 = 8, 
        Lead_V7 = 9 
    };

    typedef struct mfer_tags_t
    {
        qint64      offset; 
        MFER_TAGS type; 
        quint32   length; 
        char    *value; 
    } mfer_tags;

    /* TODO: template */
    // FRAME > SEQUENCE > CHANNEL > DATA BLOCK
    typedef qint16 mfer_data_block;
    typedef struct mfer_frame_t
    {
        //depends on waveform data length
        int numberOfSequences; 
        //default 1
        int numberOfChannels; 
        //default 1
        int dataBlockLength; 
        mfer_data_block *block; 
    } mfer_frame;

    typedef void(MferReader::*pt2mem)(char *, int);
    typedef std::map<MFER_TAGS, pt2mem> parseFuncMap;
    typedef std::map<MFER_TAGS, pt2mem>::const_iterator parseFuncMap_cit;

    MferReader(const QString &filename = "");

    bool readFile(const QString &filename);
    int fillData(QVector<QVector<double> > &pDest,
        int screennumber,
        int channel);

    bool isValid() const { return valid; }
    QPointF lineAxisBounds() const;
    int samplesprSecond() const;

    QVector<mfer_tags> tagsVector; 
    mfer_frame mferFrame; 
    QByteArray baTemp; 
private:
    void parseBlocks(void);
    void convertByteArray(int length);
    //TODO: handle channels MWF_ATT etc.
    //TODO: better handling of MWF_WAV.
    void parseBuffer(QDataStream &inputStream);
    void initParsetable(void);

    //Sampling attributes parsing
    void parse_MWF_IVL(char *, int);
    void parse_MWF_SEN(char *, int);

    //Frame attributes parsing
    void parse_MWF_BLK(char *, int);
    void parse_MWF_CHN(char *, int);
    void parse_MWF_SEQ(char *, int);

    //Waveform attributes parsing
    //TODO/PS: looks like it contains DATA + optional information
    //string, not either or...
    void parse_MWF_WFM(char *, int);
    //TODO: special cases, since these tags usually are per channel...
    void parse_MWF_LDN(char *, int);

    void parse_MWF_BLE(char *, int);

    void printHeader(void);

    SamplingRateUnit samplingRateUnit; 
    SamplingResolutionUnit samplingResolutionUnit;
    int samplingRateMantissa; 
    int samplingResolutionMantissa; 
    char samplingRateExponent; 
    char samplingResolutionExponent; 
    WaveformType waveformType; 
    //per channel
    WaveformCode waveformCode; 
    parseFuncMap parseFunctions;
    QString filename;

    bool noswap;
    QDataStream::ByteOrder byteorder;
    bool valid;

};
inline QPointF MferReader::lineAxisBounds() const
{ return QPointF(-2.0, 2.0); }

#endif // MFERREADER_H

---