OpenMS  2.5.0
Protected Member Functions | Private Member Functions | List of all members
ConsensusIDAlgorithmIdentity Class Referenceabstract

Abstract base class for ConsensusID algorithms that compare only identical sequences. More...

#include <OpenMS/ANALYSIS/ID/ConsensusIDAlgorithmIdentity.h>

Inheritance diagram for ConsensusIDAlgorithmIdentity:
ConsensusIDAlgorithm DefaultParamHandler ConsensusIDAlgorithmAverage ConsensusIDAlgorithmBest ConsensusIDAlgorithmRanks ConsensusIDAlgorithmWorst

Protected Member Functions

 ConsensusIDAlgorithmIdentity ()
 Default constructor. More...
 
virtual void preprocess_ (std::vector< PeptideIdentification > &ids)
 Preprocessing of peptide IDs (in the beginning of "apply_"). More...
 
virtual double getAggregateScore_ (std::vector< double > &scores, bool higher_better)=0
 Aggregate peptide scores into one final score (to be implemented by subclasses). More...
 
- Protected Member Functions inherited from ConsensusIDAlgorithm
 ConsensusIDAlgorithm ()
 Default constructor. More...
 
void updateMembers_ () override
 Docu in base class. More...
 
void compareChargeStates_ (Int &recorded_charge, Int new_charge, const AASequence &peptide)
 Compare (and possibly update) charge state information. More...
 
- Protected Member Functions inherited from DefaultParamHandler
void defaultsToParam_ ()
 Updates the parameters after the defaults have been set in the constructor. More...
 

Private Member Functions

 ConsensusIDAlgorithmIdentity (const ConsensusIDAlgorithmIdentity &)
 Not implemented. More...
 
ConsensusIDAlgorithmIdentityoperator= (const ConsensusIDAlgorithmIdentity &)
 Not implemented. More...
 
void apply_ (std::vector< PeptideIdentification > &ids, SequenceGrouping &results) override
 Consensus scoring. More...
 

Additional Inherited Members

- Public Member Functions inherited from ConsensusIDAlgorithm
void apply (std::vector< PeptideIdentification > &ids, Size number_of_runs=0)
 Calculates the consensus ID for a set of peptide identifications of one spectrum or (consensus) feature. More...
 
 ~ConsensusIDAlgorithm () override
 Virtual destructor. More...
 
- Public Member Functions inherited from DefaultParamHandler
 DefaultParamHandler (const String &name)
 Constructor with name that is displayed in error messages. More...
 
 DefaultParamHandler (const DefaultParamHandler &rhs)
 Copy constructor. More...
 
virtual ~DefaultParamHandler ()
 Destructor. More...
 
virtual DefaultParamHandleroperator= (const DefaultParamHandler &rhs)
 Assignment operator. More...
 
virtual bool operator== (const DefaultParamHandler &rhs) const
 Equality operator. More...
 
void setParameters (const Param &param)
 Sets the parameters. More...
 
const ParamgetParameters () const
 Non-mutable access to the parameters. More...
 
const ParamgetDefaults () const
 Non-mutable access to the default parameters. More...
 
const StringgetName () const
 Non-mutable access to the name. More...
 
void setName (const String &name)
 Mutable access to the name. More...
 
const std::vector< String > & getSubsections () const
 Non-mutable access to the registered subsections. More...
 
- Protected Types inherited from ConsensusIDAlgorithm
typedef std::map< AASequence, std::pair< Int, std::vector< double > > > SequenceGrouping
 Mapping: peptide sequence -> (charge, scores) More...
 
- Protected Attributes inherited from ConsensusIDAlgorithm
Size considered_hits_
 Number of peptide hits considered per ID run (input parameter) More...
 
Size number_of_runs_
 Number of ID runs. More...
 
double min_support_
 Fraction of required support by other ID runs (input parameter) More...
 
bool count_empty_
 Count empty runs in "min_support" calculation? (input parameter) More...
 
- Protected Attributes inherited from DefaultParamHandler
Param param_
 Container for current parameters. More...
 
Param defaults_
 Container for default parameters. This member should be filled in the constructor of derived classes! More...
 
std::vector< Stringsubsections_
 Container for registered subsections. This member should be filled in the constructor of derived classes! More...
 
String error_name_
 Name that is displayed in error messages during the parameter checking. More...
 
bool check_defaults_
 If this member is set to false no checking if parameters in done;. More...
 
bool warn_empty_defaults_
 If this member is set to false no warning is emitted when defaults are empty;. More...
 

Detailed Description

Abstract base class for ConsensusID algorithms that compare only identical sequences.

Search engine scores are grouped by peptide sequence in apply_(). For each sequence, getAggregateScore_() is called to produce a consensus score from the list of search engine scores.

All derived classes should implement getAggregateScore_(). They may re-implement preprocess_() if required.

Parameters of this class are:

NameTypeDefaultRestrictionsDescription
filter:considered_hits int0 min: 0The number of top hits in each ID run that are considered for consensus scoring ('0' for all hits).
filter:min_support float0.0 min: 0.0 max: 1.0For each peptide hit from an ID run, the fraction of other ID runs that must support that hit (otherwise it is removed).
filter:count_empty stringfalse true, falseCount empty ID runs (i.e. those containing no peptide hit for the current spectrum) when calculating 'min_support'?

Note:

Constructor & Destructor Documentation

◆ ConsensusIDAlgorithmIdentity() [1/2]

Default constructor.

◆ ConsensusIDAlgorithmIdentity() [2/2]

Not implemented.

Member Function Documentation

◆ apply_()

void apply_ ( std::vector< PeptideIdentification > &  ids,
SequenceGrouping results 
)
overrideprivatevirtual

Consensus scoring.

Implements ConsensusIDAlgorithm.

◆ getAggregateScore_()

virtual double getAggregateScore_ ( std::vector< double > &  scores,
bool  higher_better 
)
protectedpure virtual

Aggregate peptide scores into one final score (to be implemented by subclasses).

Parameters
scoresList of scores for the same peptide by different search engines
higher_betterWhether higher or lower scores are better
Returns
Final score for the respective peptide

Implemented in ConsensusIDAlgorithmRanks, ConsensusIDAlgorithmAverage, ConsensusIDAlgorithmBest, and ConsensusIDAlgorithmWorst.

◆ operator=()

Not implemented.

◆ preprocess_()

virtual void preprocess_ ( std::vector< PeptideIdentification > &  ids)
protectedvirtual

Preprocessing of peptide IDs (in the beginning of "apply_").

Checks whether the score types are the same (warns if not) and whether the score orientations agree (error if not).

Parameters
idsInput/output peptide identifications
Exceptions
Exception::InvalidValueScore orientations do not agree

Reimplemented in ConsensusIDAlgorithmRanks.