Copyright for portions of project CombineML.jl are held by Samuel Jenkins, 2014 as part of project Orchestra.jl. All other copyright for project CombineML.jl are held by Paulito Palmes, 2016.
The CombineML.jl package is licensed under the MIT "Expat" License:
CombineML is a heterogeneous ensemble learning package for the Julia programming language. It is driven by a uniform machine learner API designed for learner composition.
See the notebook for demo: MetaModeling.ipnyb
We will cover how to predict on a dataset using CombineML.
A tabular dataset will be used to obtain our features and labels.
This will be split it into a training and test set using holdout method.
import RDatasets using CombineML.Util using CombineML.Transformers # Obtain features and labels dataset = RDatasets.dataset("datasets", "iris") features = Array(dataset[:, 1:(end-1)]) labels = Array(dataset[:, end]) # Split into training and test sets (train_ind, test_ind) = holdout(size(features, 1), 0.3)
Create a Learner
A transformer processes features in some form. Coincidentally, a learner is a subtype of transformer.
A transformer can be created by instantiating it, taking an options dictionary as an optional argument.
All transformers, including learners are called in the same way.
# Learner with default settings learner = PrunedTree() # Learner with some of the default settings overriden learner = PrunedTree(Dict( :impl_options => Dict( :purity_threshold => 0.5 ) )) # All learners are called in the same way. learner = StackEnsemble(Dict( :learners => [ PrunedTree(), RandomForest(), DecisionStumpAdaboost() ], :stacker => RandomForest() ))
Create a Pipeline
Normally we may require the use of data pre-processing before the features are passed to the learner.
We shall use a pipeline transformer to chain many transformers in sequence.
In this case we shall one hot encode categorical features, impute NA values and numerically standardize before we call the learner.
# Create pipeline pipeline = Pipeline(Dict( :transformers => [ OneHotEncoder(), # Encodes nominal features into numeric Imputer(), # Imputes NA values StandardScaler(), # Standardizes features PCA(), learner # Predicts labels on features ] ))
Train and Predict
Training is done via the
fit! function, predicton via
All transformers, provide these two functions. They are always called the same way.
# Train fit!(pipeline, features[train_ind, :], labels[train_ind]) # Predict predictions = transform!(pipeline, features[test_ind, :])
Finally we assess how well our learner performed.
# Assess predictions result = score(:accuracy, labels[test_ind], predictions)
Outlined are all the transformers currently available via CombineML.
Baseline (CombineML.jl Learner)
Baseline learner that by default assigns the most frequent label.
learner = Baseline(Dict( # Output to train against # (:class). :output => :class, # Label assignment strategy. # Function that takes a label vector and returns the required output. :strategy => StatsBase.mode ))
Identity (CombineML.jl Transformer)
Identity transformer passes the features as is.
transformer = Identity()
VoteEnsemble (CombineML.jl Learner)
Set of machine learners that majority vote to decide prediction.
learner = VoteEnsemble(Dict( # Output to train against # (:class). :output => :class, # Learners in voting committee. :learners => [PrunedTree(), DecisionStumpAdaboost(), RandomForest()] ))
StackEnsemble (CombineML.jl Learner)
Ensemble where a 'stack' learner learns on a set of learners' predictions.
learner = StackEnsemble(Dict( # Output to train against # (:class). :output => :class, # Set of learners that produce feature space for stacker. :learners => [PrunedTree(), DecisionStumpAdaboost(), RandomForest()], # Machine learner that trains on set of learners' outputs. :stacker => RandomForest(), # Proportion of training set left to train stacker itself. :stacker_training_proportion => 0.3, # Provide original features on top of learner outputs to stacker. :keep_original_features => false ))
BestLearner (CombineML.jl Learner)
Selects best learner out of set. Will perform a grid search on learners if options grid is provided.
learner = BestLearner(Dict( # Output to train against # (:class). :output => :class, # Function to return partitions of instance indices. :partition_generator => (features, labels) -> kfold(size(features, 1), 5), # Function that selects the best learner by index. # Arg learner_partition_scores is a (learner, partition) score matrix. :selection_function => (learner_partition_scores) -> findmax(mean(learner_partition_scores, 2)), # Score type returned by score() using respective output. :score_type => Real, # Candidate learners. :learners => [PrunedTree(), DecisionStumpAdaboost(), RandomForest()], # Options grid for learners, to search through by BestLearner. # Format is [learner_1_options, learner_2_options, ...] # where learner_options is same as a learner's options but # with a list of values instead of scalar. :learner_options_grid => nothing ))
OneHotEncoder (CombineML.jl Transformer)
Transforms nominal features into one-hot form and coerces the instance matrix to be of element type Float64.
transformer = OneHotEncoder(Dict( # Nominal columns :nominal_columns => nothing, # Nominal column values map. Key is column index, value is list of # possible values for that column. :nominal_column_values_map => nothing ))
Imputer (CombineML.jl Transformer)
Imputes NaN values from Float64 features.
transformer = Imputer(Dict( # Imputation strategy. # Statistic that takes a vector such as mean or median. :strategy => mean ))
Pipeline (CombineML.jl Transformer)
Chains multiple transformers in sequence.
transformer = Pipeline(Dict( # Transformers as list to chain in sequence. :transformers => [OneHotEncoder(), Imputer()], # Transformer options as list applied to same index transformer. :transformer_options => nothing ))
Wrapper (CombineML.jl Transformer)
Wraps around an CombineML transformer.
transformer = Wrapper(Dict( # Transformer to call. :transformer => OneHotEncoder(), # Transformer options. :transformer_options => nothing ))
PrunedTree (DecisionTree.jl Learner)
Pruned CART decision tree.
learner = PrunedTree(Dict( # Output to train against # (:class). :output => :class, # Options specific to this implementation. :impl_options => Dict( # Merge leaves having >= purity_threshold combined purity. :purity_threshold => 1.0, # Maximum depth of the decision tree (default: no maximum). :max_depth => -1, # Minimum number of samples each leaf needs to have. :min_samples_leaf => 1, # Minimum number of samples in needed for a split. :min_samples_split => 2, # Minimum purity increase needed for a split. :min_purity_increase => 0.0 ) ))
RandomForest (DecisionTree.jl Learner)
Random forest (CART).
learner = RandomForest(Dict( # Output to train against # (:class). :output => :class, # Options specific to this implementation. :impl_options => Dict( # Number of features to train on with trees (default: 0, keep all). # Good values are square root or log2 of total number of features, rounded. :num_subfeatures => 0, # Number of trees in forest. :num_trees => 10, # Proportion of trainingset to be used for trees. :partial_sampling => 0.7, # Maximum depth of each decision tree (default: no maximum). :max_depth => -1 ) ))
DecisionStumpAdaboost (DecisionTree.jl Learner)
Adaboosted decision stumps.
learner = DecisionStumpAdaboost(Dict( # Output to train against # (:class). :output => :class, # Options specific to this implementation. :impl_options => Dict( # Number of boosting iterations. :num_iterations => 7 ) ))
PCA (DimensionalityReduction.jl Transformer)
Principal Component Analysis rotation on features. Features ordered by maximal variance descending.
Fails if zero-variance feature exists. Based on MultivariateStats PCA
transformer = PCA(Dict( :pratio => 1.0, :maxoutdim => 5 ))
StandardScaler (MLBase.jl Transformer)
Standardizes each feature using (X - mean) / stddev. Will produce NaN if standard deviation is zero.
transformer = StandardScaler(Dict( # Center features :center => true, # Scale features :scale => true ))
See the scikit-learn API for what options are available per learner.
SKLLearner (scikit-learn 0.15 Learner)
Wrapper for scikit-learn that provides access to most learners.
Options for the specific scikit-learn learner is to be passed
learner = SKLLearner(Dict( # Output to train against # (:class). :output => :class, :learner => "LinearSVC", # Options specific to this implementation. :impl_options => Dict() ))
Python library 'rpy2' is required to interface with R.
R library 'caret' offers more than 100 learners. See here for more details.
CRTLearner (caret 6.0 Learner)
CARET wrapper that provides access to all learners.
Options for the specific CARET learner is to be passed
learner = CRTLearner(Dict( # Output to train against # (:class). :output => :class, :learner => "svmLinear", :impl_options => Dict() ))
Learners have only been tested on numeric features.
Inconsistencies may result in using nominal features directly without a numeric transformation (i.e. OneHotEncoder).
The links provided below will only work if you are viewing this in the GitHub repository.
MIT "Expat" License. See LICENSE.md.