IDConflictResolverAlgorithm Class Reference

Resolves ambiguous annotations of features with peptide identifications. More...

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

Static Public Member Functions
static void	resolve (FeatureMap &features, bool keep_matching=false)
	Resolves ambiguous annotations of features with peptide identifications. The the filtered identifications are added to the vector of unassigned peptides and also reduced to a single best hit.
static void	resolve (ConsensusMap &features, bool keep_matching=false)
	Resolves ambiguous annotations of consensus features with peptide identifications. The the filtered identifications are added to the vector of unassigned peptides and also reduced to a single best hit.
static void	resolveAllHitRankAggregation (FeatureMap &features)
	Resolves ambiguous annotations of features with peptide identifications using rank aggregation.
static void	resolveAllHitRankAggregation (ConsensusMap &features)
	Resolves ambiguous annotations of consensus features with peptide identifications using rank aggregation.
static void	resolveBetweenFeatures (FeatureMap &features)
	In a single (feature/consensus) map, features with the same (possibly modified) sequence and charge state may appear. This filter removes the peptide sequence annotations from features, if a higher-intensity feature with the same (charge, sequence) combination exists in the map. The total number of features remains unchanged. In the final output, each (charge, sequence) combination appears only once, i.e. no multiplicities.
static void	resolveBetweenFeatures (ConsensusMap &features)
	In a single (feature/consensus) map, features with the same (possibly modified) sequence and charge state may appear. This filter removes the peptide sequence annotations from features, if a higher-intensity feature with the same (charge, sequence) combination exists in the map. The total number of features remains unchanged. In the final output, each (charge, sequence) combination appears only once, i.e. no multiplicities.

Static Protected Member Functions
template<class T >
static void	resolveConflict_ (T &map, bool keep_matching)
static bool	compareIDsSmallerScores_ (const PeptideIdentification &left, const PeptideIdentification &right)
static void	resolveConflict_ (PeptideIdentificationList &peptides, PeptideIdentificationList &removed, UInt64 uid)
static void	resolveConflictKeepMatching_ (PeptideIdentificationList &peptides, PeptideIdentificationList &removed, UInt64 uid)
static void	resolveAggregateConflict_ (PeptideIdentificationList &peptides, PeptideIdentificationList &removed, UInt64 uid)
template<class T >
static void	rankAggregation_ (T &map)
template<class T >
static void	resolveBetweenFeatures_ (T &map)

Detailed Description

Resolves ambiguous annotations of features with peptide identifications.

The peptide identifications are filtered so that only one identification with a single hit (with the best score) is associated to each feature. (If two IDs have the same best score, either one of them may be selected.)

Member Function Documentation

compareIDsSmallerScores_()

static bool compareIDsSmallerScores_ ( const PeptideIdentification &  left, const PeptideIdentification &  right  )

staticprotected

rankAggregation_()

template<class T >

static void rankAggregation_ ( T &  map )

inlinestaticprotected

resolve() [1/2]

static void resolve ( ConsensusMap &  features, bool  keep_matching = false  )

static

Resolves ambiguous annotations of consensus features with peptide identifications. The the filtered identifications are added to the vector of unassigned peptides and also reduced to a single best hit.

Parameters

[in]	features	Features to work on
[in,out]	keep_matching	Keeps all IDs that match the modified sequence of the best hit in the feature (e.g. keeps all IDs in a ConsensusMap if id'd same across multiple runs)

resolve() [2/2]

static void resolve ( FeatureMap &  features, bool  keep_matching = false  )

static

Resolves ambiguous annotations of features with peptide identifications. The the filtered identifications are added to the vector of unassigned peptides and also reduced to a single best hit.

Parameters

[in]	features	Features to work on
[in,out]	keep_matching	Keeps all IDs that match the modified sequence of the best hit in the feature (e.g. keeps all IDs in a ConsensusMap if id'd same across multiple runs)

resolveAggregateConflict_()

static void resolveAggregateConflict_ ( PeptideIdentificationList &  peptides, PeptideIdentificationList &  removed, UInt64  uid  )

staticprotected

resolveAllHitRankAggregation() [1/2]

static void resolveAllHitRankAggregation ( ConsensusMap &  features )

static

Resolves ambiguous annotations of consensus features with peptide identifications using rank aggregation.

For each consensus feature, peptide hits across all identifications are aggregated by rank. Each unique sequence is assigned a rank in every identification in which it appears (rank 0 = best hit, 1 = second best, etc.). Sequences not found in an identification receive a penalty rank equal to the maximum number of considered hits. The aggregate score for each sequence is computed as:

1.0 - (sum_of_ranks + penalty_for_missing_runs) / (max_hits * n_runs)

The sequence with the highest aggregate score is selected as the winner and the corresponding best-scoring identification is kept with only that hit. All other identifications are moved to the unassigned list.

Parameters

[in]

features

ConsensusMap to work on

resolveAllHitRankAggregation() [2/2]

static void resolveAllHitRankAggregation ( FeatureMap &  features )

static

Resolves ambiguous annotations of features with peptide identifications using rank aggregation.

For each feature, peptide hits across all identifications are aggregated by rank. Each unique sequence is assigned a rank in every identification in which it appears (rank 0 = best hit, 1 = second best, etc.). Sequences not found in an identification receive a penalty rank equal to the maximum number of considered hits. The aggregate score for each sequence is computed as:

1.0 - (sum_of_ranks + penalty_for_missing_runs) / (max_hits * n_runs)

The sequence with the highest aggregate score is selected as the winner and the corresponding best-scoring identification is kept with only that hit. All other identifications are moved to the unassigned list.

Parameters

[in]

features

FeatureMap to work on

resolveBetweenFeatures() [1/2]

static void resolveBetweenFeatures ( ConsensusMap &  features )

static

In a single (feature/consensus) map, features with the same (possibly modified) sequence and charge state may appear. This filter removes the peptide sequence annotations from features, if a higher-intensity feature with the same (charge, sequence) combination exists in the map. The total number of features remains unchanged. In the final output, each (charge, sequence) combination appears only once, i.e. no multiplicities.

resolveBetweenFeatures() [2/2]

static void resolveBetweenFeatures ( FeatureMap &  features )

static

In a single (feature/consensus) map, features with the same (possibly modified) sequence and charge state may appear. This filter removes the peptide sequence annotations from features, if a higher-intensity feature with the same (charge, sequence) combination exists in the map. The total number of features remains unchanged. In the final output, each (charge, sequence) combination appears only once, i.e. no multiplicities.

resolveBetweenFeatures_()

template<class T >

static void resolveBetweenFeatures_ ( T &  map )

inlinestaticprotected

References ExposedVector< VectorElement >::begin(), ExposedVector< VectorElement >::empty(), ExposedVector< VectorElement >::end(), ExposedVector< VectorElement >::front(), PeptideIdentification::getHits(), PeptideHit::getSequence(), ExposedVector< VectorElement >::insert(), ExposedVector< VectorElement >::size(), and PeptideIdentification::sort().

resolveConflict_() [1/2]

static void resolveConflict_ ( PeptideIdentificationList &  peptides, PeptideIdentificationList &  removed, UInt64  uid  )

staticprotected

resolveConflict_() [2/2]

template<class T >

static void resolveConflict_ ( T &  map, bool  keep_matching  )

inlinestaticprotected

resolveConflictKeepMatching_()

static void resolveConflictKeepMatching_ ( PeptideIdentificationList &  peptides, PeptideIdentificationList &  removed, UInt64  uid  )

staticprotected