CombinedKernel.h

Go to the documentation of this file.

/*
 * 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.
 *
 * Written (W) 1999-2009 Soeren Sonnenburg
 * Written (W) 1999-2008 Gunnar Raetsch
 * Copyright (C) 1999-2009 Fraunhofer Institute FIRST and Max-Planck-Society
 */

#ifndef _COMBINEDKERNEL_H___
#define _COMBINEDKERNEL_H___

#include <shogun/lib/List.h>
#include <shogun/io/SGIO.h>
#include <shogun/kernel/Kernel.h>

#include <shogun/features/Features.h>
#include <shogun/features/CombinedFeatures.h>

namespace shogun
{
class CFeatures;
class CCombinedFeatures;
class CList;
class CListElement;
class CCombinedKernel : public CKernel
{
    public:
        CCombinedKernel(int32_t size=10, bool append_subkernel_weights=false);

        virtual ~CCombinedKernel();

        virtual bool init(CFeatures* lhs, CFeatures* rhs);

        virtual void cleanup();

        virtual EKernelType get_kernel_type()
        {
            return K_COMBINED;
        }

        virtual EFeatureType get_feature_type()
        {
            return F_UNKNOWN;
        }

        virtual EFeatureClass get_feature_class()
        {
            return C_COMBINED;
        }

        virtual const char* get_name() const { return "CombinedKernel"; }

        void list_kernels();

        inline CKernel* get_first_kernel()
        {
            return (CKernel*) kernel_list->get_first_element();
        }

        inline CKernel* get_first_kernel(CListElement*& current)
        {
            return (CKernel*) kernel_list->get_first_element(current);
        }

        inline CKernel* get_kernel(int32_t idx)
        {
            CKernel * k = get_first_kernel();
            for (int32_t i=0; i<idx; i++)
            {
                SG_UNREF(k);
                k = get_next_kernel();
            }
            return k;
        }

        inline CKernel* get_last_kernel()
        {
            return (CKernel*) kernel_list->get_last_element();
        }

        inline CKernel* get_next_kernel()
        {
            return (CKernel*) kernel_list->get_next_element();
        }

        inline CKernel* get_next_kernel(CListElement*& current)
        {
            return (CKernel*) kernel_list->get_next_element(current);
        }

        inline bool insert_kernel(CKernel* k)
        {
            ASSERT(k);
            adjust_num_lhs_rhs_initialized(k);

            if (!(k->has_property(KP_LINADD)))
                unset_property(KP_LINADD);

            return kernel_list->insert_element(k);
        }

        inline bool append_kernel(CKernel* k)
        {
            ASSERT(k);
            adjust_num_lhs_rhs_initialized(k);

            if (!(k->has_property(KP_LINADD)))
                unset_property(KP_LINADD);

            return kernel_list->append_element(k);
        }


        inline bool delete_kernel()
        {
            CKernel* k=(CKernel*) kernel_list->delete_element();
            SG_UNREF(k);

            if (!k)
            {
                num_lhs=0;
                num_rhs=0;
            }

            return (k!=NULL);
        }

        inline bool get_append_subkernel_weights()
        {
            return append_subkernel_weights;
        }

        inline int32_t get_num_subkernels()
        {
            if (append_subkernel_weights)
            {
                int32_t num_subkernels = 0 ;
                CListElement* current = NULL ;
                CKernel * k = get_first_kernel(current) ;

                while(k)
                {
                    num_subkernels += k->get_num_subkernels() ;
                    SG_UNREF(k);
                    k = get_next_kernel(current) ;
                }
                return num_subkernels ;
            }
            else
                return kernel_list->get_num_elements();
        }

        virtual inline bool has_features()
        {
            return initialized;
        }

        virtual void remove_lhs();

        virtual void remove_rhs();

        virtual void remove_lhs_and_rhs();

        virtual bool init_optimization(
            int32_t count, int32_t *IDX, float64_t * weights);

        virtual bool delete_optimization();

        virtual float64_t compute_optimized(int32_t idx);

        virtual void compute_batch(
            int32_t num_vec, int32_t* vec_idx, float64_t* target,
            int32_t num_suppvec, int32_t* IDX, float64_t* alphas,
            float64_t factor=1.0);

        static void* compute_optimized_kernel_helper(void* p);

        static void* compute_kernel_helper(void* p);

        void emulate_compute_batch(
            CKernel* k, int32_t num_vec, int32_t* vec_idx, float64_t* target,
            int32_t num_suppvec, int32_t* IDX, float64_t* weights);

        virtual void add_to_normal(int32_t idx, float64_t weight);

        virtual void clear_normal();

        virtual void compute_by_subkernel(
            int32_t idx, float64_t * subkernel_contrib);

        virtual const float64_t* get_subkernel_weights(int32_t& num_weights);

        virtual SGVector<float64_t> get_subkernel_weights();

        virtual void set_subkernel_weights(SGVector<float64_t> weights);

        virtual void set_optimization_type(EOptimizationType t);

        bool precompute_subkernels();

        CCombinedKernel* KernelToCombinedKernel(shogun::CKernel* n)
        {
            return dynamic_cast<CCombinedKernel*>(n);
        }

        SGMatrix<float64_t> get_parameter_gradient(TParameter* param,
                CSGObject* obj, index_t index);

        inline CList* get_list() {SG_REF(kernel_list); return kernel_list;}

    protected:
        virtual float64_t compute(int32_t x, int32_t y);

        inline void adjust_num_lhs_rhs_initialized(CKernel* k)
        {
            ASSERT(k);

            if (k->get_num_vec_lhs())
            {
                if (num_lhs)
                    ASSERT(num_lhs==k->get_num_vec_lhs());
                num_lhs=k->get_num_vec_lhs();

                if (!get_num_subkernels())
                {
                    initialized=true;
#ifdef USE_SVMLIGHT
                    cache_reset();
#endif //USE_SVMLIGHT
                }
            }
            else
                initialized=false;

            if (k->get_num_vec_rhs())
            {
                if (num_rhs)
                    ASSERT(num_rhs==k->get_num_vec_rhs());
                num_rhs=k->get_num_vec_rhs();

                if (!get_num_subkernels())
                {
                    initialized=true;
#ifdef USE_SVMLIGHT
                    cache_reset();
#endif //USE_SVMLIGHT
                }
            }
            else
                initialized=false;
        }

    private:
        void init();

    protected:
        CList* kernel_list;
        int32_t   sv_count;
        int32_t*  sv_idx;
        float64_t* sv_weight;
        float64_t* subkernel_weights_buffer;
        bool append_subkernel_weights;
        bool initialized;
};
}
#endif /* _COMBINEDKERNEL_H__ */