diffnovo-dia 0.1.2

Transformer-diffusion de novo peptide sequencing for data-independent acquisition mass spectrometry

DiffNovo_DIA

Transformer-Diffusion de novo peptide sequencing for data-independent acquisition mass spectrometry.

DiffNovo_DIA is an extension of the Transformer_DIA model that integrates a transformer architecture with a diffusion model to improve de novo peptide sequencing from data-independent acquisition (DIA) mass spectrometry.

---

Installation

To manage dependencies efficiently, we recommend using conda. Start by creating a dedicated conda environment:

conda create --name diffnovo-dia python=3.10

Activate the environment:

conda activate diffnovo-dia

Install DiffNovo_DIA and its dependencies via pip:

pip install diffnovo-dia

To verify a successful installation, check the command-line interface:

diffnovo-dia --help

---

Data Preprocessing

Feature Extraction

To use DiffNovo_DIA, you must first generate a feature file that serves as structured input to the model. We provide a script which takes your spectrum and feature files as input and produces a pickle file containing the formatted features. The generated features include:

• Keys: Peptide sequences
• Values: List containing the following attributes:
  • precursor_mz
  • precursor_charge
  • scan_list_middle
  • ms1
  • mz_list
  • int_list
  • neighbor_right_count
  • neighbor_size_half

To run the script, use the provided script feature_extractor.py to generate feature file required by Transformer_DIA and DiffNovo_DIA models. The script takes the following inputs:

• A feature CSV file
• An MGF spectrum file It will generate a pickled feature file compatible with both diffnovo_dia and transformer_dia models.

python feature_extractor.py --feature_file your_feature.csv --spectrum_file your_spectra.mgf --output_file output_features.pkl

MGF Annotation

Use this script to annotate .mgf files with peptide sequences for models like PepNet, DiffNovo, Transformer-DIA and DiffNovo_DIA. The annotation process links each precursor ion in feature file to spectra in the MGF file.

For Transformer-DIA and DiffNovo_DIA, the recommended selection mode is five_rt, which automatically selects the top five spectra whose retention times are closest to the mean retention time of the corresponding precursor ion. The selection spectra for annotation should be aligned with spectra selection in feature extraction — for example, we used five_rt for both.

You can run the script using:

For annotating with PepNet, set the model_name to pepnet. For other models, leave the model_name empty.

python annotate_mgf.py --model_name pepnet --spectrum_file input.mgf --feature_file features.csv --selection five_rt

If you're not using PepNet, simply leave model_name empty:

python annotate_mgf.py --model_name "" --spectrum_file input.mgf --feature_file features.csv --selection five_rt

---

Both feature_extractor.py and annotate_mgf.py are located in the data_utils/ directory.

Usage

Predict Peptide Sequences

DiffNovo_DIA predicts peptide sequences from MS/MS spectra stored in MGF files. Predictions are saved as a CSV file:

diffnovo-dia --mode=denovo --model=pretrained_checkpoint.ckpt --peak_path=path/to/spectra.mgf --peak_feature=path/to/precursor_feature.pkl

---

Evaluate de novo Sequencing Performance

To assess the performance of de novo sequencing against known annotations:

diffnovo-dia --mode=eval --model=pretrained_checkpoint.ckpt --peak_path=path/to/spectra.mgf --peak_feature=path/to/precursor_feature.pkl

Annotations in the MGF file must include peptide sequences in the SEQ field.

---

Train a New Model

To train a new Transformer model from scratch, provide labeled training and validation datasets in MGF format:

diffnovo-dia --mode=train --peak_path=path/to/train/annotated_spectra.mgf \ 
--peak_feature=path/to/train/precursor_feature.pkl \
--peak_path_val=path/to/validation/annotated_spectra.mgf \
--peak_feature_val==path/to/validation/precursor_feature.pkl

MGF files must include peptide sequences in the SEQ field.

---

Fine-Tune an Existing Model

To fine-tune a pretrained Transformer-DIA model, set the --train_from_scratch parameter to false:

diffnovo-dia --mode=train --model=pretrained_checkpoint.ckpt \
--peak_feature=path/to/train/precursor_feature.pkl \
--peak_path_val=path/to/validation/annotated_spectra.mgf \
--peak_feature_val==path/to/validation/precursor_feature.pkl

---