MVAUtils::ForestLGBMSimple Class Reference

Implement LGBM Forest without nan support. More...

#include <ForestLGBM.h>

Inheritance diagram for MVAUtils::ForestLGBMSimple:

Collaboration diagram for MVAUtils::ForestLGBMSimple:

Public Member Functions
	ForestLGBMSimple (TTree *tree)
	ForestLGBMSimple ()=default
	ForestLGBMSimple (const ForestLGBMSimple &)=default
ForestLGBMSimple &	operator= (const ForestLGBMSimple &)=default
	ForestLGBMSimple (ForestLGBMSimple &&)=default
ForestLGBMSimple &	operator= (ForestLGBMSimple &&)=default
	~ForestLGBMSimple ()=default
virtual TTree *	WriteTree (TString name) const override
	Return a TTree representing the BDT.
virtual void	PrintForest () const override
virtual int	GetNVars () const override
	Get the number of input variable to be passed with std::vector to Get* methods.
virtual float	GetClassification (const std::vector< float > &values) const final
	Compute the prediction of a classification.
virtual float	GetClassification (const std::vector< float * > &pointers) const=0
virtual float	GetTreeResponse (const std::vector< float > &values, unsigned int itree) const override final
	Return the response of one tree Must pass the features in a std::vector<float> values and the index of the tree.
virtual float	GetTreeResponse (const std::vector< float * > &pointers, unsigned int itree) const override final
virtual float	GetOffset () const override
	Return the offset of the forest.
virtual float	GetRawResponse (const std::vector< float > &values) const override final
	Return the response of the whole Forest.
virtual float	GetRawResponse (const std::vector< float * > &pointers) const override final
virtual float	GetResponse (const std::vector< float > &values) const override
	Compute the prediction for regression.
virtual float	GetResponse (const std::vector< float * > &pointers) const override
virtual std::vector< float >	GetMultiResponse (const std::vector< float > &values, unsigned int numClasses) const override
	Compute the prediction for multiclassification (a score for each class).
virtual std::vector< float >	GetMultiResponse (const std::vector< float * > &pointers, unsigned int numClasses) const override
virtual unsigned int	GetNTrees () const override final
virtual void	PrintTree (unsigned int itree) const override
std::vector< NodeLGBMSimple >	GetTree (unsigned int itree) const
	Return the vector of nodes for the tree itree.

Protected Member Functions
float	GetTreeResponseFromNode (const std::vector< float > &values, index_t index) const
	Get the response of a tree.
float	GetTreeResponseFromNode (const std::vector< float * > &pointers, index_t index) const
void	newTree (const std::vector< NodeLGBMSimple > &nodes)
	append a new tree (defined by a vector of nodes serialized in preorder) to the forest

Private Attributes
int	m_max_var =0
std::vector< index_t >	m_forest
	indices of the top-level nodes of each tree
std::vector< NodeLGBMSimple >	m_nodes
	where the nodes of the forest are stored

Detailed Description

Implement LGBM Forest without nan support.

Definition at line 42 of file ForestLGBM.h.

Constructor & Destructor Documentation

ForestLGBMSimple() [1/4]

ForestLGBMSimple::ForestLGBMSimple ( TTree * tree )

explicit

Definition at line 12 of file ForestLGBM.cxx.

  : ForestLGBMBase<NodeLGBMSimple>()
  , m_max_var(0)
{
    
 
    // variables read from the TTree
    std::vector<int> *vars = nullptr;
    std::vector<float> *values = nullptr;
 
    std::vector<NodeLGBMSimple> nodes;
 
    tree->SetBranchAddress("vars", &vars);
    tree->SetBranchAddress("values", &values);
 
    int numEntries = tree->GetEntries();
    for (int entry = 0; entry < numEntries; ++entry)
    {
        // each entry in the TTree is a decision tree
        tree->GetEntry(entry);
        if (!vars) {
          throw std::runtime_error(
            "vars pointer is null in ForestLGBMSimple constructor");
        }
        if (!values) {
          throw std::runtime_error(
            "values pointers is null in ForestLGBMSimple constructor");
        }
        if (vars->size() != values->size()) {
          throw std::runtime_error("inconsistent size for vars and values in "
                                   "ForestLGBMSimple constructor");
        }
 
        nodes.clear();
 
        std::vector<MVAUtils::index_t> right = detail::computeRight(*vars);
 
        for (size_t i = 0; i < vars->size(); ++i) {
            nodes.emplace_back(vars->at(i), values->at(i), right[i]);
            if (vars->at(i) > m_max_var) { m_max_var = vars->at(i); }
        }
        newTree(nodes);
    }  // end loop on TTree, all decision tree loaded
    delete vars;
    delete values;
}

ForestLGBMSimple() [2/4]

MVAUtils::ForestLGBMSimple::ForestLGBMSimple ( )

default

ForestLGBMSimple() [3/4]

MVAUtils::ForestLGBMSimple::ForestLGBMSimple ( const ForestLGBMSimple & )

default

ForestLGBMSimple() [4/4]

MVAUtils::ForestLGBMSimple::ForestLGBMSimple ( ForestLGBMSimple && )

default

~ForestLGBMSimple()

MVAUtils::ForestLGBMSimple::~ForestLGBMSimple ( )

default

Member Function Documentation

GetClassification() [1/2]

virtual float MVAUtils::IForest::GetClassification ( const std::vector< float * > & pointers ) const

pure virtualinherited

GetClassification() [2/2]

virtual float MVAUtils::ForestLGBMBase< NodeLGBMSimple >::GetClassification ( const std::vector< float > & values ) const

inlinefinalvirtualinherited

Compute the prediction of a classification.

Implements MVAUtils::IForest.

Definition at line 31 of file ForestLGBM.h.

        {
            return detail::sigmoid(GetResponse(values));
        }

GetMultiResponse() [1/2]

virtual std::vector< float > MVAUtils::Forest< NodeLGBMSimple >::GetMultiResponse ( const std::vector< float * > & pointers, unsigned int numClasses ) const

overridevirtualinherited

GetMultiResponse() [2/2]

virtual std::vector< float > MVAUtils::Forest< NodeLGBMSimple >::GetMultiResponse ( const std::vector< float > & values, unsigned int numClasses ) const

overridevirtualinherited

Compute the prediction for multiclassification (a score for each class).

In addition to the input values need to pass the number of classes

GetNTrees()

virtual unsigned int MVAUtils::Forest< NodeLGBMSimple >::GetNTrees ( ) const

inlinefinaloverridevirtualinherited

Definition at line 94 of file Forest.h.

      {
        return m_forest.size();
      }

GetNVars()

virtual int MVAUtils::ForestLGBMSimple::GetNVars ( ) const

inlineoverridevirtual

Get the number of input variable to be passed with std::vector to Get* methods.

Implements MVAUtils::IForest.

Definition at line 54 of file ForestLGBM.h.

{ return m_max_var + 1; }

GetOffset()

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetOffset ( ) const

inlineoverridevirtualinherited

Return the offset of the forest.

Since by default there is no offset, return 0

Definition at line 63 of file Forest.h.

{ return 0.; }

GetRawResponse() [1/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetRawResponse ( const std::vector< float * > & pointers ) const

finaloverridevirtualinherited

GetRawResponse() [2/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetRawResponse ( const std::vector< float > & values ) const

finaloverridevirtualinherited

Return the response of the whole Forest.

Raw is just the sum of all the trees

GetResponse() [1/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetResponse ( const std::vector< float * > & pointers ) const

overridevirtualinherited

GetResponse() [2/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetResponse ( const std::vector< float > & values ) const

overridevirtualinherited

Compute the prediction for regression.

GetTree()

std::vector< NodeLGBMSimple > MVAUtils::Forest< NodeLGBMSimple >::GetTree ( unsigned int itree ) const

inherited

Return the vector of nodes for the tree itree.

GetTreeResponse() [1/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetTreeResponse ( const std::vector< float * > & pointers, unsigned int itree ) const

finaloverridevirtualinherited

GetTreeResponse() [2/2]

virtual float MVAUtils::Forest< NodeLGBMSimple >::GetTreeResponse ( const std::vector< float > & values, unsigned int itree ) const

finaloverridevirtualinherited

Return the response of one tree Must pass the features in a std::vector<float> values and the index of the tree.

GetTreeResponseFromNode() [1/2]

float MVAUtils::Forest< NodeLGBMSimple >::GetTreeResponseFromNode ( const std::vector< float * > & pointers, index_t index ) const

protectedinherited

GetTreeResponseFromNode() [2/2]

float MVAUtils::Forest< NodeLGBMSimple >::GetTreeResponseFromNode ( const std::vector< float > & values, index_t index ) const

protectedinherited

Get the response of a tree.

Instead of specifying the index of the tree (as in GetTreeResponse) the index of the top node of the tree should be specified

newTree()

void MVAUtils::Forest< NodeLGBMSimple >::newTree ( const std::vector< NodeLGBMSimple > & nodes )

protectedinherited

append a new tree (defined by a vector of nodes serialized in preorder) to the forest

operator=() [1/2]

ForestLGBMSimple & MVAUtils::ForestLGBMSimple::operator= ( const ForestLGBMSimple & )

default

operator=() [2/2]

ForestLGBMSimple & MVAUtils::ForestLGBMSimple::operator= ( ForestLGBMSimple && )

default

PrintForest()

void ForestLGBMSimple::PrintForest ( ) const

overridevirtual

Reimplemented from MVAUtils::Forest< NodeLGBMSimple >.

Definition at line 82 of file ForestLGBM.cxx.

{
    std::cout << "***BDT LGBMSimple: Printing entire forest***" << std::endl;
    Forest::PrintForest();
}

PrintTree()

virtual void MVAUtils::Forest< NodeLGBMSimple >::PrintTree ( unsigned int itree ) const

overridevirtualinherited

WriteTree()

TTree * ForestLGBMSimple::WriteTree ( TString ) const

overridevirtual

Return a TTree representing the BDT.

The called is the owner of the returned TTree

Implements MVAUtils::IForest.

Definition at line 60 of file ForestLGBM.cxx.

{
    TTree *tree = new TTree(name.Data(), "creator=lgbm;node_type=lgbm_simple");
 
    std::vector<int> vars;
    std::vector<float> values;
 
    tree->Branch("vars", &vars);
    tree->Branch("values", &values);
 
    for (size_t itree = 0; itree < GetNTrees(); ++itree) {
        vars.clear();
        values.clear();
        for(const auto& node : GetTree(itree)) {
            vars.push_back(node.GetVar());
            values.push_back(node.GetVal());
        }
        tree->Fill();
    }
    return tree;
}

Member Data Documentation

m_forest

std::vector<index_t> MVAUtils::Forest< NodeLGBMSimple >::m_forest

privateinherited

indices of the top-level nodes of each tree

Definition at line 117 of file Forest.h.

m_max_var

int MVAUtils::ForestLGBMSimple::m_max_var =0

private

Definition at line 56 of file ForestLGBM.h.

m_nodes

std::vector<NodeLGBMSimple> MVAUtils::Forest< NodeLGBMSimple >::m_nodes

privateinherited

where the nodes of the forest are stored

Definition at line 118 of file Forest.h.

---

The documentation for this class was generated from the following files:

• ForestLGBM.h
• ForestLGBM.cxx