OpenMS
MapAlignmentAlgorithmTreeGuided.h
Go to the documentation of this file.
1 // --------------------------------------------------------------------------
2 // OpenMS -- Open-Source Mass Spectrometry
3 // --------------------------------------------------------------------------
4 // Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
5 // ETH Zurich, and Freie Universitaet Berlin 2002-2023.
6 //
7 // This software is released under a three-clause BSD license:
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // * Neither the name of any author or any participating institution
14 // may be used to endorse or promote products derived from this software
15 // without specific prior written permission.
16 // For a full list of authors, refer to the file AUTHORS.
17 // --------------------------------------------------------------------------
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
22 // INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // --------------------------------------------------------------------------
31 // $Maintainer: Julia Thueringer$
32 // $Authors: Julia Thueringer $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
41 
42 namespace OpenMS
43 {
70  class OPENMS_DLLAPI MapAlignmentAlgorithmTreeGuided :
71  public DefaultParamHandler,
72  public ProgressLogger
73  {
74 public:
77 
80 
88  static void buildTree(std::vector<FeatureMap>& feature_maps, std::vector<BinaryTreeNode>& tree, std::vector<std::vector<double>>& maps_ranges);
89 
99  void treeGuidedAlignment(const std::vector<BinaryTreeNode>& tree, std::vector<FeatureMap>& feature_maps_transformed,
100  std::vector<std::vector<double>>& maps_ranges, FeatureMap& map_transformed,
101  std::vector<Size>& trafo_order);
102 
106  void align(std::vector<FeatureMap>& data,
107  std::vector<TransformationDescription>& transformations);
108 
117  void computeTrafosByOriginalRT(std::vector<FeatureMap>& feature_maps, FeatureMap& map_transformed,
118  std::vector<TransformationDescription>& transformations, const std::vector<Size>& trafo_order);
119 
126  static void computeTransformedFeatureMaps(std::vector<FeatureMap>& feature_maps, const std::vector<TransformationDescription>& transformations);
127 
128 protected:
130  typedef std::map<String, DoubleList> SeqAndRTList;
131 
132  // Update defaults model_type_, model_param_ and align_algorithm_
133  void updateMembers_() override;
134 
137 
140 
143 
151  class PeptideIdentificationsPearsonDistance_;
152 
161  static void addPeptideSequences_(const std::vector<PeptideIdentification>& peptides, SeqAndRTList& peptide_rts,
162  std::vector<double>& map_range, double feature_rt);
163 
171  static void extractSeqAndRt_(const std::vector<FeatureMap>& feature_maps, std::vector<SeqAndRTList>& maps_seq_and_rt,
172  std::vector<std::vector<double>>& maps_ranges);
173 
174 private:
177 
180  };
181 } // namespace OpenMS
A base class for all classes handling default parameters.
Definition: DefaultParamHandler.h:92
A container for features.
Definition: FeatureMap.h:106
A map alignment algorithm based on peptide identifications from MS2 spectra.
Definition: MapAlignmentAlgorithmIdentification.h:75
A map alignment algorithm based on peptide identifications from MS2 spectra.
Definition: MapAlignmentAlgorithmTreeGuided.h:73
MapAlignmentAlgorithmTreeGuided(const MapAlignmentAlgorithmTreeGuided &)
Copy constructor intentionally not implemented -> private.
static void addPeptideSequences_(const std::vector< PeptideIdentification > &peptides, SeqAndRTList &peptide_rts, std::vector< double > &map_range, double feature_rt)
For given peptide identifications extract sequences and store with associated feature RT.
static void computeTransformedFeatureMaps(std::vector< FeatureMap > &feature_maps, const std::vector< TransformationDescription > &transformations)
Apply transformations on input maps.
String model_type_
Type of transformation model.
Definition: MapAlignmentAlgorithmTreeGuided.h:136
~MapAlignmentAlgorithmTreeGuided() override
Destructor.
static void buildTree(std::vector< FeatureMap > &feature_maps, std::vector< BinaryTreeNode > &tree, std::vector< std::vector< double >> &maps_ranges)
Extract RTs given for individual features of each map, calculate distances for each pair of maps and ...
Param model_param_
Default params of transformation models linear, b_spline, lowess and interpolated.
Definition: MapAlignmentAlgorithmTreeGuided.h:139
void computeTrafosByOriginalRT(std::vector< FeatureMap > &feature_maps, FeatureMap &map_transformed, std::vector< TransformationDescription > &transformations, const std::vector< Size > &trafo_order)
Extract original RT ("original_RT" MetaInfo) and transformed RT for each feature to compute RT transf...
MapAlignmentAlgorithmTreeGuided()
Default constructor.
void updateMembers_() override
This method is used to update extra member variables at the end of the setParameters() method.
void treeGuidedAlignment(const std::vector< BinaryTreeNode > &tree, std::vector< FeatureMap > &feature_maps_transformed, std::vector< std::vector< double >> &maps_ranges, FeatureMap &map_transformed, std::vector< Size > &trafo_order)
Align feature maps tree guided using align() of OpenMS::MapAlignmentAlgorithmIdentification and use T...
MapAlignmentAlgorithmTreeGuided & operator=(const MapAlignmentAlgorithmTreeGuided &)
Assignment operator intentionally not implemented -> private.
MapAlignmentAlgorithmIdentification align_algorithm_
Instantiation of alignment algorithm.
Definition: MapAlignmentAlgorithmTreeGuided.h:142
std::map< String, DoubleList > SeqAndRTList
Type to store feature retention times given for individual peptide sequence.
Definition: MapAlignmentAlgorithmTreeGuided.h:130
static void extractSeqAndRt_(const std::vector< FeatureMap > &feature_maps, std::vector< SeqAndRTList > &maps_seq_and_rt, std::vector< std::vector< double >> &maps_ranges)
For each input map, extract peptide identifications (sequences) of existing features with associated ...
void align(std::vector< FeatureMap > &data, std::vector< TransformationDescription > &transformations)
Align feature maps tree guided using align() of OpenMS::MapAlignmentAlgorithmIdentification and use T...
Management and storage of parameters / INI files.
Definition: Param.h:70
Base class for all classes that want to report their progress.
Definition: ProgressLogger.h:53
A more convenient string class.
Definition: String.h:60
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48