This util provides an interface to the 'SEARCH' mode of the SpectraST program. All non-advanced parameters of the executable of SpectraST were translated into parameters of this util.

SpectraST: Version: 5

The command line parameters of this tool are:

SpectraSTSearchAdapter -- Interface to the SEARCH Mode of the SpectraST executable
Full documentation: http://www.openms.de/doxygen/nightly/html/TOPP_SpectraSTSearchAdapter.html
Version: 3.6.0-pre-nightly-2026-03-06 Mar  7 2026, 01:46:19, Revision: c92c980
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:
  SpectraSTSearchAdapter <options>

Options (mandatory options marked with '*'):
  -executable <path>*                                                            Path to the SpectraST execut
                                                                                 able to use; may be empty 
                                                                                 if the executable is globall
                                                                                 y available.
  -spectra_files <SearchFileName1> [ <SearchFileName2> ... <SearchFileNameN> ]*  File names(s) of spectra to 
                                                                                 be searched. (valid formats:
                                                                                  'mzML', 'mzXML', 'mzData', 
                                                                                 'mgf', 'dta', 'msp')
  -output_files <OutputFile1> [ <OutputFileName2> ... <OutputFileNameN> ]*       Output files. Make sure to 
                                                                                 specify one output file for 
                                                                                 each input file (valid forma
                                                                                 ts: 'txt', 'tsv', 'xml', 
                                                                                 'pepXML', 'html')
  -library_file <lib_file>.splib*                                                Specify library file. (valid
                                                                                  formats: 'splib')
  -sequence_database_file <sequencedb_file>.fasta                                The sequence database. (vali
                                                                                 d formats: 'fasta')
  -sequence_database_type <sequencedb_type>                                      Specify type of sequence 
                                                                                 database (default: 'AA') 
                                                                                 (valid: 'DNA', 'AA')
  -search_file <search_file>                                                     Only search a subset of the 
                                                                                 query spectra in the search 
                                                                                 file (valid formats: 'txt', 
                                                                                 ' dat')
  -params_file <params_file>                                                     Read search options from 
                                                                                 file. All options set in 
                                                                                 the file will be overridden 
                                                                                 by command-line options, if 
                                                                                 specified. (valid formats: 
                                                                                 'params')
  -precursor_mz_tolerance <precursor_mz_tolerance>                               M/z (in Th) tolerance within
                                                                                  which candidate entries 
                                                                                 are compared to the query. 
                                                                                 Monoisotopic mass is assumed
                                                                                 . (default: '3.0') (min: 
                                                                                 '0.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 (default: '1')
  -write_ini <file>                                                              Writes the default configura
                                                                                 tion 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.

+SpectraSTSearchAdapterInterface to the SEARCH Mode of the SpectraST executable

version3.6.0-pre-nightly-2026-03-06 Version of the tool that generated this parameters file.

++1Instance '1' section for 'SpectraSTSearchAdapter'

executablespectrast Path to the SpectraST executable to use; may be empty if the executable is globally available.input file

spectra_files[] File names(s) of spectra to be searched.input file*.mzML, *.mzXML, *.mzData, *.mgf, *.dta, *.msp

output_files[] Output files. Make sure to specify one output file for each input fileoutput file*.txt, *.tsv, *.xml, *.pepXML, *.html

library_file Specify library file.input file*.splib

sequence_database_file The sequence database.input file*.fasta

sequence_database_typeAA Specify type of sequence databaseDNA, AA

search_file Only search a subset of the query spectra in the search fileinput file*.txt, *. dat

params_file Read search options from file. All options set in the file will be overridden by command-line options, if specified.input file*.params

precursor_mz_tolerance3.0 m/z (in Th) tolerance within which candidate entries are compared to the query. Monoisotopic mass is assumed.0.0:∞

use_isotopically_averaged_massfalse Use isotopically averaged mass instead of monoisotopic masstrue, false

use_all_charge_statesfalse Search library spectra of all charge states, i.e., ignore specified charge state (if any) of the query spectrumtrue, false

user_mod_file Specify name of user-defined modifications file. Default is "spectrast.usermods".input file

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

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