/**
 * @file gensvm_task.h
 * @author G.J.J. van den Burg
 * @date 2013-08-01
 * @brief Header file for gensvm_task.c
 *
 * @details
 * The grid search for the optimal parameters is done through a queue.
 * This file contains struct definitions for the tasks in the queue.
 * Initialization and free functions are also included.
 *
 * @copyright
 Copyright 2016, G.J.J. van den Burg.

 This file is part of GenSVM.

 GenSVM 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.

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

 You should have received a copy of the GNU General Public License
 along with GenSVM. If not, see <http://www.gnu.org/licenses/>.

 */

#ifndef GENSVM_TASK_H
#define GENSVM_TASK_H

#include "gensvm_base.h"

/**
 * @brief A structure for a single task in the queue.
 *
 * @param folds 	number of folds in cross validation
 * @param ID 		numeric id of the task in the queue
 * @param weight_idx 	parameter for the GenModel
 * @param p 		parameter for the GenModel
 * @param kappa 	parameter for the GenModel
 * @param lambda 	parameter for the GenModel
 * @param epsilon 	parameter for the GenModel
 * @param kerneltype 	parameter for the GenModel
 * @param kernelparam 	kernel parameters for the GenModel
 * @param train_data 	pointer to the training data
 * @param test_data 	pointer to the test data (if any)
 * @param performance 	performance after cross validation
 */
struct GenTask {
	KernelType kerneltype;
	///< kerneltype parameter for the GenModel
	int weight_idx;
	///< weight_idx parameter for the GenModel
	long folds;
	///< number of folds in cross validation
	long ID;
	///< numeric id of the task in the queue
	double p;
	///< p parameter for the GenModel
	double kappa;
	///< kappa parameter for the GenModel
	double lambda;
	///< lambda parameter for the GenModel
	double epsilon;
	///< epsilon parameter for the GenModel
	double *kernelparam;
	///< kernelparam parameters for the GenModel
	struct GenData *train_data;
	///< pointer to the training data
	struct GenData *test_data;
	///< pointer to the test data (if any)
	double performance;
	///< performance after cross validation
};

struct GenTask *gensvm_init_task();
struct GenTask *gensvm_copy_task(struct GenTask *t);
void gensvm_free_task(struct GenTask *t);
void gensvm_task_to_model(struct GenTask *task, struct GenModel *model);

#endif