/usr/include/BALL/QSAR/validation.h is in libball1.4-dev 1.4.3~beta1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | // -*- Mode: C++; tab-width: 2; -*-
// vi: set ts=2:
//
//
#ifndef VALIDATION
#define VALIDATION
#ifndef QSARDATA
#include <BALL/QSAR/QSARData.h>
#endif
#include <iterator>
namespace BALL
{
namespace QSAR
{
class Model;
/** interface class for validation of QSAR-models */
class BALL_EXPORT Validation
{
public:
/** @name Constructors and Destructors
*/
//@{
Validation(Model* m);
virtual ~Validation();
EIGEN_MAKE_ALIGNED_OPERATOR_NEW
//@}
/** @name Accessors
*/
//@{
/** Starts cross-validation with k steps. \n
Data is taken from QSARData.descriptor_matrix and is in each step divided into training- and test-data. \n
(Data having already been copied into Model.descriptor_matrix will be deleted) */
virtual void crossValidation(int k, bool restore=1) = 0;
/** fetches the result of cross-validation */
virtual double getCVRes() = 0;
/** fetches the quality of fit to the input data, as calculated by testInputData() */
virtual double getFitRes() = 0;
/** set the result of cross-validation to the given value */
virtual void setCVRes(double d) = 0;
/** return the result of the previous response permutation test .\n
The return matrix is empty if no such test has been run yet */
const Eigen::MatrixXd& getYRandResults() const;
/** Fetches input data from QSARData and tests the current (unchanged) model with all these new substances (without cross-validation!). \n
@param transform if transform==1, the test data is transformed in the same way that the training data was transformed before predicting activities. \n
If training and test substances are taken from the same input file, set transform to 0 */
virtual void testInputData(bool transform=0) = 0;
virtual void bootstrap(int k, bool restore=1) = 0;
virtual const Eigen::MatrixXd& yRandomizationTest(int runs, int k) = 0;
/** select the desired statistic to be used for validating the models
@param s if (s==1) R^2 and Q^2 are used \n
if(s==2) F_regr and F_cv are used. */
virtual void selectStat(int s) = 0;
/** return the ID of selected validation statistic */
int getStat() const;
/** save the result of the applied validation methods to a file */
virtual void saveToFile(string filename) const = 0;
/** restore validation-results from a file */
virtual void readFromFile(string filename) = 0;
//@}
protected:
/** @name Accessors
*/
//@{
/** copies one substance (=one line from class QSARData) and its activity into the training data set */
void setTrainingLine(int train_line, int current_line);
/** copies one substance (=one line from class QSARData) and its activity into the test data set
@param back_transform descriptor values are transformed back to in order to un-do centering */
void setTestLine(int test_line, int current_line, bool back_transform=0);
/** randomizes all columns of Model.Y_ */
void yRand();
//@}
/** @name Attributes
*/
//@{
/** contains all substances whose activities are to be predicted by the next call of testAllSubstances() */
vector<vector<double> > test_substances_;
/** contains the experimentally determined results (activities) for all current test-substances in one column for each activity */
Eigen::MatrixXd test_Y_;
/** contains the names of all current test-substances */
vector<string> substances_names_;
/** pointer to the model, which the object of this class should test */
Model* model_;
/** the selected validation statistic */
int validation_statistic_;
Eigen::MatrixXd yRand_results_;
//@}
};
}
}
#endif // VALIDATION
|