APMC Documentation
Automatic Predictive Model Constructor (APMC) Documentation
SECTIONS
- INTRODUCTION
- GENERAL WORKFLOW
- DATA FORMAT T PREPARATION
- ACCURACY THRESHOLD
- NORMALIZATION
- EXTRAPOLATION RISK
- METRICS
- STATISTICAL REPORT
- EXAMPLE DATA SETS
1/ INTRODUCTION
APMC is a module of Gene-Calc application available from www.gene-calc.pl/apmc.
The aim of APMC is to automatic train, develop and evaluate supervised Machine Learning models for regression and / or classification purposes. An additional functionality is to generate a report containing descriptive statistics, correlation charts and incidentally a decision tree graph.
2/ GENERAL WORKFLOW
Technically workflow of module is splitted in two steps, in first step users need to upload data set [data set format requirements in section no. 3] and then select:
- type of model purposes [classification or regression]
- normalization [True or False] [more information in section no. 4]
Subsequently pre-models are parallel training. In case of classification models, these are algorithms:
- K-nearest neighbours
- Logistic regression
- Supported vector machines
- Random forest classification
whereas in case of regression models, these are algorithms:
- Simple linear regression
- Lasso linear regression
- Ridge linear regression
- Random forest regression
The last part of first step is model selection, users need to select one model from above-mentioned lists, the decision is based on models metrics, APMC suggests which model is the most accurate and should be chosen, based on CV-metric [more information about in section no. 6].
For classification models metrics contain:
- Mean of cross validation scores
- Accuracy
- Classification report
while for regression models metrics contain:
- Mean of cross validation scores
- R2
- Medium squared error (MSE)
- Medium absolute error (MAE)
While users select model considered as the best for their purposes the second step of workflow begins. Chosen model is introduced into SearchGrid for optimization of hyperparameters. Obtained best hyperparameters are used to train final model which is evaluate and then used to make prediction.
3/ DATA FORMAT AND PREPARATION
Uploaded data must have *.csv, *.xls or *.xlsx extensions, data in file [data set] need to be constructed as shown in the pictures below.
Predictors are values used to predict target value. Names of columns are required and used as predictors and target variables names. Only numbers are allowed as predictors, in case of categorical data users must convert them to corresponding numeric labels.
Target value in case of classification models may include strings, in case of regression only numbers are allowed.
Allowed number of predictors columns is 10, allowed number of target values column is 1, allowed number of rows/records is 5000.
If data construction and size is accurate according mentioned rules, data set is splitted into 2 parts: 70% is used to train models and obtain cross validation score, 30% is used as validation set used to calculate all metrics (excluding cross validation score).
4/ ACCURACY THRESHOLD WARING
When choosing the model entering to SearchGrid, APMC suggests which model is probably the most suitable. At the same time, it suggests which models are probably not acceptable. Models that have a lower cross-validation score than dummy models are considered as not useful.
5/ NORMALIZATION
In some cases normalization may have positive influence on model training, if normalization is True predictors data is transformed following formula:
z = (x - u) / s
z - normalized value
x - raw value
u - mean
s - standard deviation
6/ EXTRAPOLATION RISK
If predictor/s value/s used to predict target value is/are extrapolated warning information is displayed. Implemented extrapolation definition:
if x > m + 3 * s
or
if x < m - 3 * s
:
x is extrapolated
x - input predictor value
m - mean of predictor values in data set
s - standard deviation of predictor values in data set
7/ METRICS
Metrics are measures of the model prediction accuracy. Metrics definitions following scikit-learn documentation:
-> Accuracy
-> Cross validation score (CV, k=5)
This metric is the average accuracy of the k-times trained model on (k-1)-number of folds relative to one test fold.
-> Classification report
This metric contain couple of more important metrics for classification model evaluation, including: precision, recall and F1.
The precision is the ratio tp / (tp + fp) where tp is the number of true positives and fp the number of false positives. The precision is intuitively the ability of the classifier not to label as positive a sample that is negative.
The recall is the ratio tp / (tp + fn) where tp is the number of true positives and fn the number of false negatives. The recall is intuitively the ability of the classifier to find all the positive samples.
The F-beta (F-1) score weights recall more than precision by a factor of beta. Beta == 1.0 means recall and precision are equally important.
The support is the number of occurrences of each class in y_true.
-> R2
Is a regression score function. Best possible score is 1.0 and it can be negative (because the model can be arbitrarily worse). A constant model that always predicts the expected value of y, disregarding the input features, would get a R2 score of 0.0.
-> MAE - Mean absolute error
-> MSE - Mean squared error
8/ STATISTICAL REPORT
Statistical report may be generated after model training, it contains:
a) descriptive statistics tables with:
- Mean
- Standard deviation
- Quartile
- Min and Max values
b) Plots of correlation with Pearson correlation and p-value
c) In case of classification model categorical violin plots
d) Graph of decision trees in case of random forest models
e) Predictors coefficients in case of: random forest classification and regression models
Bellow examples:
descriptive statistics tables
Correlation plot
Violin plot - features a kernel density estimation [kde] of the underlying distribution
Tree graph
’
Coefficients of predictors
9/ EXAMPLE DATA SETS
Data used to generate examples [source Kaggle]:
for classification purposes:
--> Iris
for regression purposes:
--> USA Housing