Feature Selection Toolbox FST4
UTIA · Czech Academy of Sciences
Loading...
Searching...
No Matches
Public Types | Public Member Functions | List of all members
FST::Search_Ranking_BIF_Threaded< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > Class Template Reference

DEPRECATED shim: threaded Best Individual Features, i.e., individual feature ranking. More...

#include <search_ranking_bif_threaded.hpp>

Inheritance diagram for FST::Search_Ranking_BIF_Threaded< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >:
FST::Search_Ranking_BIF< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > FST::Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > FST::Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >

Public Types

typedef Search_Ranking_BIF< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > parent
 base class: the merged BIF ranking search this shim configures with a threaded engine
typedef parent::PEvaluatorEngine PEvaluatorEngine
Public Types inherited from FST::Search_Ranking_BIF< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
typedef Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > parent
 base class: the individual-ranking search skeleton (final best-dimensionality scan, feature-list bookkeeping)
typedef std::shared_ptr< CRITERION > PCriterion
 shared pointer to the criterion being optimized
typedef std::shared_ptr< SUBSET > PSubset
 shared pointer to a feature subset
typedef parent::PEvaluatorEngine PEvaluatorEngine
 the candidate-evaluation engine type, inherited from parent
Public Types inherited from FST::Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
typedef Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > parent
 the abstract Search interface this class implements
typedef std::shared_ptr< CRITERION > PCriterion
 shared pointer to the criterion the search optimizes
typedef std::shared_ptr< SUBSET > PSubset
 shared pointer to a feature subset
typedef Candidate_Evaluator< RETURNTYPE, DIMTYPE, SUBSET, CRITERION > EVALUATORENGINE
 the injected candidate-evaluation engine interface driving individual-feature evaluation
typedef std::shared_ptr< EVALUATORENGINE > PEvaluatorEngine
Public Types inherited from FST::Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 shared pointer to the criterion the search optimizes
 shared pointer to a feature subset
 shared pointer to the result tracker enabled via enable_result_tracking()
 the observer interface type this search reports through (see Search_Observer)
 shared pointer to an OBSERVER, as set via set_observer()

Public Member Functions

 Search_Ranking_BIF_Threaded (const unsigned int max_threads=2)
 Constructs a Search_Ranking_BIF configured with a Candidate_Evaluator_Threaded engine of max_threads workers.
Public Member Functions inherited from FST::Search_Ranking_BIF< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 Search_Ranking_BIF (PEvaluatorEngine engine=PEvaluatorEngine())
 Constructs the search with the given candidate-evaluation engine; a default-constructed engine falls back to sequential in-line evaluation.
virtual bool evaluate_individuals (const DIMTYPE n, const PCriterion crit, std::ostream &os=std::cout) override
 Scores every single feature individually under crit and ranks them into parent::bifs (descending), the BIF core step consumed by Search_Ranking::search().
virtual std::ostream & print (std::ostream &os) const override
 writes a human-readable identification of the search and its configuration; base default writes nothing
Public Member Functions inherited from FST::Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 Search_Ranking (PEvaluatorEngine engine=PEvaluatorEngine())
virtual bool search (const DIMTYPE target_d, RETURNTYPE &result, const PSubset sub, const PCriterion crit, std::ostream &os=std::cout) override
 ranks the features (evaluate_individuals()) and returns the target_d best-ranked ones, or - for target_d==0 - the best-valued prefix of the ranking; false if the ranking or one of the criterion evaluations failed. target_d must be smaller than the full feature count
bool getFirstFeature (RETURNTYPE &value, DIMTYPE &feature) const
 iterator over bifs (the ranking built by evaluate_individuals()), highest-ranked feature first; returns false if bifs is empty
bool getNextFeature (RETURNTYPE &value, DIMTYPE &feature) const
 continues the getFirstFeature() iteration; returns false once the ranking is exhausted. There is one cursor per object: it is protected against concurrent access in threaded builds, but two interleaved iterations of the same object still consume one another's positions
Public Member Functions inherited from FST::Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 assigns a result tracker to the search process, i.e., enables logging of all evaluated subsets for future reuse (re-evaluation, etc.)
 detaches any result tracker (result_tracker_active() then returns false)
 true if a result tracker was assigned via enable_result_tracking() and not since disabled
 sets the amount of information that is logged to output stream throughout the course of search
 the currently configured output detail level
 true unless output detail is SILENT
 true only at the DETAILED output level
 redirects search progress reporting away from the default syncout text output to observer

Additional Inherited Members

Protected Types inherited from FST::Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
typedef std::list< OneFeature > FEATURELIST
 the individual-feature ranking built by evaluate_individuals(), sorted descending by critval
Protected Member Functions inherited from FST::Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 delivers one pre-formatted progress message: to the observer if attached, otherwise as syncout text to os
 like report(), for sites announcing a new (sub-)solution; fires on_solution instead
Protected Attributes inherited from FST::Search_Ranking< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
PEvaluatorEngine _engine
FEATURELIST bifs
 the individual-feature ranking; empty until evaluate_individuals() is called
Protected Attributes inherited from FST::Search< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >
 the assigned result tracker, or null (see enable_result_tracking()/result_tracker_active())
 the output detail level set via set_output_detail(); read by output_normal()/output_detailed()
 the attached progress observer, or null (see set_observer(), report(), report_solution())

Detailed Description

template<class RETURNTYPE, typename DIMTYPE, class SUBSET, class CRITERION>
class FST::Search_Ranking_BIF_Threaded< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >

DEPRECATED shim: threaded Best Individual Features, i.e., individual feature ranking.

Deprecated
Deprecated since FST4 4.0; scheduled for removal in the next major release — construct the merged class with a Candidate_Evaluator_Threaded engine instead.

Kept for source compatibility with earlier FST4 sources, written when the threaded and the sequential variant were separate classes. This class is now nothing but a Search_Ranking_BIF constructed with a Candidate_Evaluator_Threaded engine; prefer doing that directly in new code. The final best-dimensionality scan in Search_Ranking::search() runs through the same engine.

Member Typedef Documentation

◆ PEvaluatorEngine

template<class RETURNTYPE, typename DIMTYPE, class SUBSET, class CRITERION>
typedef parent::PEvaluatorEngine FST::Search_Ranking_BIF_Threaded< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >::PEvaluatorEngine

the candidate-evaluation engine type, inherited from parent

Constructor & Destructor Documentation

◆ Search_Ranking_BIF_Threaded()

template<class RETURNTYPE, typename DIMTYPE, class SUBSET, class CRITERION>
FST::Search_Ranking_BIF_Threaded< RETURNTYPE, DIMTYPE, SUBSET, CRITERION >::Search_Ranking_BIF_Threaded ( const unsigned int max_threads = 2)
inlineexplicit

Constructs a Search_Ranking_BIF configured with a Candidate_Evaluator_Threaded engine of max_threads workers.

Parameters
max_threadspool capacity for the threaded engine (must be greater than zero, asserted)
The documentation for this class was generated from the following file:
Generated by doxygen 1.17.0
Copyright © 2000–present ÚTIA, Institute of Information Theory and Automation of the Czech Academy of Sciences · Contacts · This site sets no cookies and uses no analytics.