/*--------------------------------------------------------------------*/
/*  Copyright (C) 2004-2015  Serge Iovleff, University Lille 1, Inria

    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 2 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 Lesser General Public License for more details.

    You should have received a copy of the GNU General Public
    License along with this program; if not, write to the
    Free Software Foundation, Inc.,
    59 Temple Place,
    Suite 330,
    Boston, MA 02111-1307
    USA

    Contact : S..._Dot_I..._At_stkpp_Dot_org (see copyright for ...)
*/

/*
 * Project:  MixAll
 * created on: 10 May 2016
 * Author:   Iovleff, serge.iovleff@stkpp.org
 **/

/** @file KmmLauncher.h
 *  @brief In this file we define the class forKmmLauncher
 **/


#ifndef STK_KMMLAUNCHER_H
#define STK_KMMLAUNCHER_H

#include "ILauncherBase.h"

namespace STK
{

/** KmmLauncher class is an interface class allowing to create composer or
 *  learner of mixture models with less efforts.
 **/
class KmmLauncher: public ILauncherBase
{
  public:
    typedef typename hidden::DataHandlerTraits< STK::RDataHandler, int>::Data DataInt;
    /** constructor for single data
     *  @param s4_model KmmModel S4 class
     *  @param nbCluster a vector with the number of clusters to test
     *  @param models a vector of string with the model names to try
     **/
    KmmLauncher( Rcpp::S4 s4_model
             , Rcpp::IntegerVector const& nbCluster
             , Rcpp::CharacterVector const& models
             );
    /** constructor for mixed data
     *  @param model ClusterMixedDataModel S4 class
     *  @param nbCluster a vector with the number of clusters to test
     **/
    KmmLauncher( Rcpp::S4 s4_model, Rcpp::IntegerVector const& nbCluster);

    /** destructor. */
    virtual ~KmmLauncher();

    /** run the estimation */
    bool run();

  protected:

    /** vector with the model names to try */
    Rcpp::CharacterVector v_models_;
    /** vector with the number of cluster to try */
    Rcpp::IntegerVector   v_nbCluster_;
    /** strategy from the R side */
    Rcpp::S4              s4_strategy_;
    /** character string with the model selection criterion name */
    std::string           criterion_;

    /** Is the model with mixed data ? */
    bool isMixedData_;

  private:
    /** Create kernels and add them to KernelHandler from facade
     *  @param s4_component component with the creation parameters
     *  @param idData  Id of the data set of the kernel
     *  @param manager manager storing the KmmBridge
     **/
    Kernel::IKernel* createKernel(Rcpp::S4 s4_component, std::string const& idData, KernelMixtureManager& manager);
    /** Select the best model among the models and nbCluster given.
     *  @return the value of the best criteria.
     **/
    Real selectBestSingleModel();
    /** Select the best model among the models and nbCluster given.
     *  @return the value of the best criteria.
     **/
    Real selectBestMixedModel();
    /** facade with the main composer */
    MixtureComposerFacade<RDataHandler> facade_;
};

} // namespace STK

#endif /* STK_IKMMLAUNCHER_H */
