ppforest2 v0.1.0
Projection Pursuit Decision Trees and Random Forests
Loading...
Searching...
No Matches
ppforest2::binarize::LargestGap Class Reference

Binarization by largest gap between sorted projected group means. More...

#include <LargestGap.hpp>

Public Member Functions

std::string display_name () const override
 Human-readable name for display in summaries.
 
std::set< types::Modesupported_modes () const override
 Training modes this strategy supports.
 
nlohmann::json to_json () const override
 Serialize this strategy's configuration to JSON.
 
- Public Member Functions inherited from ppforest2::binarize::Binarization
void regroup (NodeContext &ctx, stats::RNG &rng) const
 Reduce a multiclass partition to binary and store in context.
 
- Public Member Functions inherited from Strategy< Binarization >
virtual ~Strategy ()=default
 

Static Public Member Functions

static Binarization::Ptr from_json (nlohmann::json const &j)
 
- Static Public Member Functions inherited from Strategy< Binarization >
static Ptr from_json (nlohmann::json const &j)
 Construct a strategy from its JSON representation.
 
static bool register_strategy (std::string const &name, Factory factory)
 Register a concrete strategy for JSON deserialization.
 

Protected Member Functions

void compute (NodeContext &ctx, stats::RNG &rng) const override
 Subclass implementation of binarization.
 

Additional Inherited Members

- Public Types inherited from Strategy< Binarization >
using Factory
 Factory function type for deserializing a strategy from JSON.
 
using Ptr
 

Detailed Description

Binarization by largest gap between sorted projected group means.

Projects group means onto 1D via the projector, sorts by projected mean, and finds the largest gap between consecutive means. Groups below the gap become binary group 0, groups above become binary group 1. This is the default PPtree binarization method.

Member Function Documentation

◆ compute()

void ppforest2::binarize::LargestGap::compute ( NodeContext & ctx,
stats::RNG & rng ) const
overrideprotectedvirtual

Subclass implementation of binarization.

Implements ppforest2::binarize::Binarization.

◆ display_name()

std::string ppforest2::binarize::LargestGap::display_name ( ) const
inlineoverridevirtual

Human-readable name for display in summaries.

Implements Strategy< Binarization >.

◆ from_json()

static Binarization::Ptr ppforest2::binarize::LargestGap::from_json ( nlohmann::json const & j)
static

◆ supported_modes()

std::set< types::Mode > ppforest2::binarize::LargestGap::supported_modes ( ) const
inlineoverridevirtual

Training modes this strategy supports.

Every concrete strategy MUST explicitly declare which modes it supports — there is no default. This forces implementers to think about mode compatibility rather than silently inheriting both modes and triggering runtime surprises.

Used by TrainingSpec to validate that every selected strategy is compatible with the configured training mode. Fails fast at build time instead of silently misbehaving at train time.

Implements Strategy< Binarization >.

◆ to_json()

nlohmann::json ppforest2::binarize::LargestGap::to_json ( ) const
overridevirtual

Serialize this strategy's configuration to JSON.

Must include a "name" field identifying the strategy type, plus any strategy-specific parameters.

Implements Strategy< Binarization >.


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