# predict-peptide-ions

## Usage:

crux predict-peptide-ions [options] <peptide sequence> <charge state>

## Description:

Given a peptide and a charge state, predict the corresponding fragment ions according to the provided options.

## Input:

• peptide sequence – The peptide sequence.
• charge state – The charge state of the peptide.

## Output:

• stdout – a series of lines, describing how the ions were predicted.
# PEPTIDE: <peptide sequence>
# CHARGE: <peptide charge>
The program then prints a one-line header that labels the tab-delimited columns, followed by one line per ion:
m/z mass charge ion-series peptide-bond-index nh3 h2o isotope flank

The columns contain the following values:

• <m/z> is the ion's mass-to-charge
• <mass> is the ion's (charged) mass
• <charge> is the ion's charge e.g. 1,2,3
• <ion-type> is a string representing the series 'a', 'b', 'c', 'x', 'y', 'z', and 'p'
• <peptide-bond-index> is in [1...n), where n is peptide-length. Consistent with standard mass spec terminology, b-1 corresponds to a prefix ion of a single amino acid, and y-1 corresponds to a suffix ion of a single amino acid.
• <nh3> is the number of NH3 modifications
• <h2o> is the number of H2O Modifications
• <isotope> is the number of adjacent isotopic peaks
• <flank> is the number of flanking ions

## Options:

• ### predict-peptide-ions options

• --primary-ions a|b|y|by|bya – Predict the specified primary ion series. 'a' indicates a-ions only, 'b' indicates b-ions only, 'y' indicates y-ions only, 'by' indicates both b and y, 'bya' indicates b, y, and a. Default = by.
• --precursor-ions T|F – Predict the precursor ions, and all associated ions (neutral losses, multiple charge states) consistent with the other specified options. Default = false.
• --isotope <integer> – Predict the given number of isotope peaks (0|1|2). Default = 0.
• --flanking T|F – Predict flanking peaks for b- and y ions. Default = false.
• --nh3 <integer> – Include among the predicted peaks b/y ions with up to n losses of nh3. For example, for --nh3 2, predict a peak for each b- and y-ion with the loss of one nh3 group and predict a second peak for each b- and y-ion with the loss of two nh3 groups. These peaks will have 1 and 2, respectively, in the NH3 column of the output. Default = 0.
• --h2o <integer> – Include in the predicted peaks, b/y ions with the loss of 1 to n water molecules. See --nh3 for an example. Default = 0.
• ### Search parameters

• --max-ion-charge <string> – Predict theoretical ions up to max charge state (1, 2, ... ,6) or up to the charge state of the peptide ("peptide"). If the max-ion-charge is greater than the charge state of the peptide, then the maximum is the peptide charge. Default = peptide.
• --fragment-mass average|mono – Specify which isotopes to use in calculating fragment ion mass. Default = mono.