OpenMS
Loading...
Searching...
No Matches
MultiplexResolver

Completes peptide multiplets and resolves conflicts within them.

pot. predecessor tools → MultiplexResolver → pot. successor tools
IDMapper ProteinQuantifier
IDConflictResolver

Tools such as FeatureFinderMultiplex can detect peptide feature multiplets in labeled experimental data. The multiplets can then be annotated with peptide sequences using the IDMapper tool (*). The MultiplexResolver tool is consolidating these results in two steps.

  • Any multiplets with conflicting quantitative and sequence information are filtered out. As example, let us consider a triple SILAC analyis. Let us assume a sequence "LDNLVAIFDINR(Label:13C(6)15N(4))" with a single Arg10 label is mapped to the light feature in a SILAC triplet. Either peptide feature detection or sequence information must be incorrect und the triplet is removed.
  • In a second step, any incomplete peptide feature groups are completed with dummy features of zero intensity. As example, let us stay with the triple SILAC analysis. But let us now assume the sequence "LDNLVAIFDINR(Label:13C(6)15N(4))" is mapped to the heavy partner of a peptide feature pair. This is no conflict. Medium and heavy peptides have been correctly detected. The MultiplexResolver adds a dummy peptide feature of zero intensity at the light position and thereby completes the triplet.

(*) Note that the MultiplexResolver tool takes only a single (the first) peptide sequence annotation into account. By running IDConflictResolver first, it is assured that each multiplet has only one peptide sequence annotation, the best one. Multiplets without sequence annotation are passed to the optional out_conflicts output.

The same steps are available as a library class (OpenMS::MultiplexResolverAlgorithm), which the MS1LabeledWorkflow tool uses to run the complete MS1-labeled quantification in one go.

The command line parameters of this tool are:

MultiplexResolver -- Completes peptide multiplets and resolves conflicts within them.
Full documentation: http://www.openms.de/doxygen/nightly/html/TOPP_MultiplexResolver.html
Version: 3.6.0-pre-nightly-2026-09-29 Sep 30 2026, 01:45:35, Revision: 55f7bdb
To cite OpenMS:
 + Pfeuffer, J., Bielow, C., Wein, S. et al.. OpenMS 3 enables reproducible analysis of large-scale mass spec
   trometry data. Nat Methods (2024). doi:10.1038/s41592-024-02197-7.

Usage:
  MultiplexResolver <options>

Options (mandatory options marked with '*'):
  -in <file>*                              Peptide multiplets with assigned sequence information (valid forma
                                           ts: 'consensusXML')
  -in_blacklist <file>                     Optional input containing spectral peaks blacklisted during featur
                                           e detection. Needed for generation of dummy features. (valid forma
                                           ts: 'mzML')
  -out <file>*                             Complete peptide multiplets. (valid formats: 'consensusXML')
  -out_conflicts <file>                    Optional output containing peptide multiplets without ID annotatio
                                           n or with conflicting quant/ID information. (valid formats: 'conse
                                           nsusXML')

Parameters for the algorithm.:
  -algorithm:labels <text>                 Labels used for labelling the samples. [...] specifies the labels 
                                           for a single sample. For example
                                           
                                           [][Lys8,Arg10]        ... SILAC
                                           [][Lys4,Arg6][Lys8,Arg10]        ... triple-SILAC
                                           [Dimethyl0][Dimethyl6]        ... Dimethyl
                                           [Dimethyl0][Dimethyl4][Dimethyl8]        ... triple Dimethyl
                                           [ICPL0][ICPL4][ICPL6][ICPL10]        ... ICPL (default: '[][Lys8,A
                                           rg10]')
  -algorithm:max_nr_labelled_aas <number>  Maximum number of labelled amino acids per peptide, minus one. 
                                           The algorithm searches for peptides with up to (this value + 1) 
                                           labelled amino acids. For SILAC with trypsin digestion, this param
                                           eter corresponds to the maximum number of missed cleavages. (defau
                                           lt: '0') (min: '0')

                                           
Common TOPP options:
  -ini <file>                              Use the given TOPP INI file
  -threads <n>                             Sets the number of threads allowed to be used by the TOPP tool (0 
                                           = all available cores) (default: '1')
  -write_ini <file>                        Writes the default configuration file
  --help                                   Shows options
  --helphelp                               Shows all options (including advanced)

INI file documentation of this tool:

Legend:
required parameter
advanced parameter

This section lists all parameters supported by the tool. Parameters are organized into hierarchical subsections that group related settings together. Subsections may contain further subsections or individual parameters.

Each parameter entry contains the following information:

  • Name The identifier used in configuration files and on the command line.
  • Default value The value used if the parameter is not explicitly specified.
  • Description A short explanation describing the purpose and behavior of the parameter.
  • Tags Additional metadata associated with the parameter.
  • Restrictions Allowed value ranges for numeric parameters or valid options for string parameters.

Parameter tags provide additional information about how a parameter is used. Some tags indicate whether a parameter is required or intended for advanced configuration, while others may be used internally by OpenMS or workflow tools.

Parameters highlighted as required must be specified for the tool to run successfully. Parameters marked as advanced allow fine-tuning of algorithm behavior and are typically not needed for standard workflows.

+MultiplexResolverCompletes peptide multiplets and resolves conflicts within them.
version3.6.0-pre-nightly-2026-09-29 Version of the tool that generated this parameters file.
++1Instance '1' section for 'MultiplexResolver'
in Peptide multiplets with assigned sequence informationinput file*.consensusXML
in_blacklist Optional input containing spectral peaks blacklisted during feature detection. Needed for generation of dummy features.input file*.mzML
out Complete peptide multiplets.output file*.consensusXML
out_conflicts Optional output containing peptide multiplets without ID annotation or with conflicting quant/ID information.output file*.consensusXML
log Name of log file (created only when specified)
debug0 Sets the debug level
threads1 Sets the number of threads allowed to be used by the TOPP tool (0 = all available cores)
no_progressfalse Disables progress logging to command linetrue, false
forcefalse Overrides tool-specific checkstrue, false
testfalse Enables the test mode (needed for internal use only)true, false
+++algorithmParameters for the algorithm.
labels[][Lys8,Arg10] Labels used for labelling the samples. [...] specifies the labels for a single sample. For example

[][Lys8,Arg10] ... SILAC
[][Lys4,Arg6][Lys8,Arg10] ... triple-SILAC
[Dimethyl0][Dimethyl6] ... Dimethyl
[Dimethyl0][Dimethyl4][Dimethyl8] ... triple Dimethyl
[ICPL0][ICPL4][ICPL6][ICPL10] ... ICPL
max_nr_labelled_aas0 Maximum number of labelled amino acids per peptide, minus one. The algorithm searches for peptides with up to (this value + 1) labelled amino acids. For SILAC with trypsin digestion, this parameter corresponds to the maximum number of missed cleavages.0:∞
mass_tolerance0.1 Mass tolerance in Da for matching the mass shifts in the detected peptide multiplet to the theoretical mass shift pattern.
mz_tolerance10.0 m/z tolerance in ppm for checking if dummy feature vicinity was blacklisted.0.0:∞
rt_tolerance5.0 Retention time tolerance in seconds for checking if dummy feature vicinity was blacklisted.0.0:∞
+++labelsIsotopic labels that can be specified in section 'algorithm:labels'.
Arg66.0201290268 Label:13C(6) | C(-6) 13C(6) | unimod #1880.0:∞
Arg1010.008268599999999 Label:13C(6)15N(4) | C(-6) 13C(6) N(-4) 15N(4) | unimod #2670.0:∞
Lys44.0251069836 Label:2H(4) | H(-4) 2H(4) | unimod #4810.0:∞
Lys66.0201290268 Label:13C(6) | C(-6) 13C(6) | unimod #1880.0:∞
Lys88.0141988132 Label:13C(6)15N(2) | C(-6) 13C(6) N(-2) 15N(2) | unimod #2590.0:∞
Leu33.01883 Label:2H(3) | H(-3) 2H(3) | unimod #2620.0:∞
Dimethyl028.031300000000002 Dimethyl | H(4) C(2) | unimod #360.0:∞
Dimethyl432.056407 Dimethyl:2H(4) | 2H(4) C(2) | unimod #1990.0:∞
Dimethyl634.063116999999998 Dimethyl:2H(4)13C(2) | 2H(4) 13C(2) | unimod #5100.0:∞
Dimethyl836.075670000000002 Dimethyl:2H(6)13C(2) | H(-2) 2H(6) 13C(2) | unimod #3300.0:∞
ICPL0105.021463999999995 ICPL | H(3) C(6) N O | unimod #3650.0:∞
ICPL4109.046571 ICPL:2H(4) | H(-1) 2H(4) C(6) N O | unimod #6870.0:∞
ICPL6111.041593000000006 ICPL:13C(6) | H(3) 13C(6) N O | unimod #3640.0:∞
ICPL10115.066699999999997 ICPL:13C(6)2H(4) | H(-1) 2H(4) 13C(6) N O | unimod #8660.0:∞