Skip to content

feat: add DIA-NN 2.5.0 support with model fine-tuning documentation#53

Merged
ypriverol merged 5 commits intodevfrom
feat/diann-2.5.0
Apr 14, 2026
Merged

feat: add DIA-NN 2.5.0 support with model fine-tuning documentation#53
ypriverol merged 5 commits intodevfrom
feat/diann-2.5.0

Conversation

@ypriverol
Copy link
Copy Markdown
Member

Summary

  • New diann_v2_5_0 version profile (ghcr.io/bigbio/diann:2.5.0)
  • Block --parent flag in BlockedFlags.groovy COMMON list (container-managed model path)
  • Document DIA-NN deep learning model fine-tuning workflow in docs/usage.md
  • Update version tables in docs/usage.md and AGENTS.md

DIA-NN 2.5.0 highlights

  • Up to 70% more protein IDs for low sample amounts
  • Deep learning model selection (--tokens, --rt-model, --fr-model, --im-model)
  • Model fine-tuning flags (--tune-lib, --tune-rt, --tune-im, --tune-fr)
  • --aa-eq for amino acid equivalence in reannotation (useful for entrapment FDR benchmarks)

Fine-tuning documentation

Added a complete section explaining:

  1. When to fine-tune (non-standard modifications)
  2. How to generate a tuning library (from the pipeline's empirical library)
  3. How to run fine-tuning outside the pipeline
  4. How to use fine-tuned models via --extra_args

A future PR will add an optional FINE_TUNE_MODELS pipeline step.

Container PR

Companion PR: bigbio/quantms-containers#11

🤖 Generated with Claude Code

- New v2_5_0.config version profile (ghcr.io/bigbio/diann:2.5.0)
- Add diann_v2_5_0 profile to nextflow.config
- Block --parent flag in BlockedFlags.groovy COMMON list
  (container-managed, overriding breaks model discovery)
- Document fine-tuning workflow in docs/usage.md:
  - How to generate tuning libraries
  - How to fine-tune RT/IM/fragment models
  - How to use fine-tuned models via --extra_args
- Update version tables in docs/usage.md and AGENTS.md

New DIA-NN 2.5.0 CLI flags (passable via --extra_args):
  --tokens, --rt-model, --fr-model, --im-model (model selection)
  --aa-eq (amino acid equivalence for reannotation)
  --tune-lib, --tune-rt, --tune-im, --tune-fr (fine-tuning)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 13, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: df9388c2-0934-4f94-a53f-bfa3c9113244

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/diann-2.5.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Document all new DIA-NN 2.5.0 flags available via --extra_args:
model selection (--tokens, --rt-model, --fr-model, --im-model),
fine-tuning (--tune-lib, --tune-rt, --tune-im, --tune-fr, etc.),
and --aa-eq for amino acid equivalence.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 13, 2026

nf-core pipelines lint overall result: Passed ✅ ⚠️

Posted for pipeline commit 51a3000

+| ✅ 106 tests passed       |+
#| ❔  19 tests were ignored |#
#| ❔   1 tests had warnings |#
!| ❗   4 tests had warnings |!
Details

❗ Test warnings:

  • files_exist - File not found: conf/igenomes.config
  • files_exist - File not found: conf/igenomes_ignored.config
  • files_exist - File not found: .github/workflows/awstest.yml
  • files_exist - File not found: .github/workflows/awsfulltest.yml

❔ Tests ignored:

❔ Tests fixed:

✅ Tests passed:

Run details

  • nf-core/tools version 3.5.2
  • Run at 2026-04-13 19:40:12

Add aa_eq param (default: false) that maps to DIA-NN's --aa-eq flag.
When enabled, I&L, Q&E, N&D are treated as equivalent amino acids
during reannotation — essential for entrapment FDR benchmarks.

- Added to nextflow.config, nextflow_schema.json, docs/parameters.md
- Passed to all 5 DIA-NN modules
- Added to BlockedFlags.groovy COMMON list (pipeline-managed)
- Moved from "via extra_args" to proper pipeline parameter in docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ypriverol ypriverol requested a review from yueqixuan April 13, 2026 16:04
ypriverol and others added 2 commits April 13, 2026 20:37
… for Vadim

Rewrite the fine-tuning documentation to:
- Explain what tokens/dict.txt are (neural network encoding of modifications)
- Clarify that --tune-lib cannot be combined with --gen-spec-lib
  (separate DIA-NN invocations, confirmed in DIA-NN #1499)
- Document the full two-run workflow with concrete commands
- Propose the future integrated FINE_TUNE_MODELS step with a
  question for @vdemichev about the right integration point

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ypriverol ypriverol merged commit a679dc3 into dev Apr 14, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant