drwnSegImageRegionFeatures.h

/*****************************************************************************
** DARWIN: A FRAMEWORK FOR MACHINE LEARNING RESEARCH AND DEVELOPMENT
** Distributed under the terms of the BSD license (see the LICENSE file)
** Copyright (c) 2007-2015, Stephen Gould
** All rights reserved.
**
******************************************************************************
** FILENAME:    drwnSegImageRegionFeatures.h
** AUTHOR(S):   Stephen Gould <stephen.gould@anu.edu.au>
**
*****************************************************************************/

#pragma once

#include <cstdlib>
#include <cassert>
#include <vector>
#include <list>

#include "Eigen/Core"

#include "drwnBase.h"
#include "drwnIO.h"
#include "drwnML.h"

using namespace std;
using namespace Eigen;

// forward declarations ----------------------------------------------------

class drwnSegImageInstance;

// drwnSegImageRegionFeatures class ----------------------------------------

class drwnSegImageRegionFeatures : public drwnCloneable {
 protected:
    string _instanceName; 
    int _instanceRegions; 

 public:
    drwnSegImageRegionFeatures() : _instanceRegions(0)
        { /* do nothing */ }
    drwnSegImageRegionFeatures(const drwnSegImageRegionFeatures& f) :
        _instanceName(f._instanceName), _instanceRegions(f._instanceRegions)
        { /* do nothing */ }
    virtual ~drwnSegImageRegionFeatures() { /* do nothing */ }

    drwnSegImageRegionFeatures *clone() const = 0;

    virtual int numFeatures() const = 0;

    virtual void cacheInstanceData(const drwnSegImageInstance& instance);
    virtual void clearInstanceData();

    virtual void appendRegionFeatures(int regId, vector<double>& phi) const = 0;
};

// drwnSegImageStdRegionFeatures class -------------------------------------

class drwnSegImageStdRegionFeatures : public drwnSegImageRegionFeatures {
 public:
    // configurable feature options
    static double FILTER_BANDWIDTH;        

 protected:
    drwnFilterBankResponse _filters;       

 public:
    drwnSegImageStdRegionFeatures() { /* do nothing */ }
    drwnSegImageStdRegionFeatures(const drwnSegImageStdRegionFeatures& f);
    virtual ~drwnSegImageStdRegionFeatures() { /* do nothing */ }

    drwnSegImageStdRegionFeatures *clone() const {
        return new drwnSegImageStdRegionFeatures(*this);
    }

    // data caching
    void cacheInstanceData(const drwnSegImageInstance& instance);
    void clearInstanceData();

    // feature computation
    int numFeatures() const;
    void appendRegionFeatures(int regId, vector<double>& phi) const;
};