Skip to content

Add HUMAnN 4 database generation protocols - #1

Open
lwaldron wants to merge 2 commits into
mainfrom
humann4-protocols
Open

Add HUMAnN 4 database generation protocols#1
lwaldron wants to merge 2 commits into
mainfrom
humann4-protocols

Conversation

@lwaldron

@lwaldron lwaldron commented Aug 8, 2026

Copy link
Copy Markdown
Member

Drafts the 5 ai-agent-compatible protocols required to generate HUMAnN 4 databases.

Copilot AI lite review requested due to automatic review settings August 8, 2026 16:52

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a set of draft, AI-agent-compatible protocols documenting the end-to-end workflow for generating HUMAnN 4 databases (SGB aggregation → augmented clustering → ChocoPhlAn build → translated search build → utility mapping).

Changes:

  • Adds a protocol for aggregating and subsampling MetaPhlAn 4.2 SGB genomes/MAGs.
  • Adds a protocol for augmented UniRef-compatible ORF clustering and ORF→cluster mapping generation.
  • Adds protocols for building ChocoPhlAn nucleotide pangenomes, a DIAMOND translated-search database, and functional utility mapping TSVs.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
protocols/humann4-sgb-aggregation/protocol.md Defines the SGB genome retrieval and subsampling step that seeds the HUMAnN 4 DB build pipeline.
protocols/humann4-augmented-clustering/protocol.md Documents ORF prediction, UniRef alignment, de novo clustering, and ORF mapping generation for novel clusters.
protocols/humann4-chocophlan-build/protocol.md Describes constructing per-SGB nucleotide pangenomes and Bowtie2 indexes for ChocoPhlAn.
protocols/humann4-translated-search-build/protocol.md Documents building the merged UniRef90 + novel-cluster protein database and DIAMOND index.
protocols/humann4-utility-mapping/protocol.md Describes generating HUMAnN mapping TSVs by combining UniProt cross-references and eggNOG-mapper outputs.
Suppressed comments (4)

protocols/humann4-utility-mapping/protocol.md:32

  • Remove trailing whitespace from the Markdown heading to avoid markdownlint/formatting noise.
## Materials 

protocols/humann4-translated-search-build/protocol.md:32

  • Remove trailing whitespace from the Markdown heading to avoid markdownlint/formatting noise.
## Materials 

protocols/humann4-chocophlan-build/protocol.md:32

  • Remove trailing whitespace from the Markdown heading to avoid markdownlint/formatting noise.
## Materials 

protocols/humann4-augmented-clustering/protocol.md:32

  • Remove trailing whitespace from the Markdown heading to avoid markdownlint/formatting noise.
## Materials 

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread protocols/humann4-utility-mapping/protocol.md Outdated
Comment thread protocols/humann4-translated-search-build/protocol.md Outdated
Comment thread protocols/humann4-chocophlan-build/protocol.md Outdated
Comment thread protocols/humann4-augmented-clustering/protocol.md Outdated
Comment thread protocols/humann4-sgb-aggregation/protocol.md Outdated
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.

2 participants