Skip to content

Remove stale emerging_lineage, immune_escape, and ace2_binding colorings#1213

Merged
trvrb merged 2 commits into
masterfrom
remove-stale-colorings
Jun 30, 2026
Merged

Remove stale emerging_lineage, immune_escape, and ace2_binding colorings#1213
trvrb merged 2 commits into
masterfrom
remove-stale-colorings

Conversation

@trvrb

@trvrb trvrb commented Jun 27, 2026

Copy link
Copy Markdown
Member

Removes three Auspice colorings that are no longer useful.

Motivation

  • emerging_lineage — the curated defaults/emerging_lineages.tsv list hasn't been maintained and won't be revived.
  • immune_escape / ace2_binding — computed from deep-mutational-scanning data against BA.2, so the "vs BA.2" colorings are inaccurate against today's circulating strains.

What's removed

emerging_lineage had real build machinery, all removed:

  • rule emerging_lineages (an augur clades run) + its node-data wiring in main_workflow.smk
  • the files.emerging_lineages config key in defaults/parameters.yaml
  • defaults/emerging_lineages.tsv (now orphaned)
  • the coloring + filter in both defaults/auspice_config.json and the dynamic auspice_config rule in export_for_nextstrain.smk
  • the 18 emerging_lineage rows in defaults/color_ordering.tsv
  • the config-reference docs section

immune_escape / ace2_binding are not produced by any rule here (the default sars-cov-2 Nextclade dataset doesn't emit them; they came from the 21L DMS dataset / upstream metadata), so removal is display-only:

  • the two coloring blocks in both auspice configs
  • their now-inert passthrough rename mappings in scripts/join-metadata-and-clades.py

Verification

  • grep for emerging_lineage|immune_escape|ace2_binding across the repo (excl. historical changelog) returns zero hits.
  • defaults/auspice_config.json remains valid JSON (23 colorings / 9 filters, down from 26 / 10).
  • snakemake --profile nextstrain_profiles/nextstrain-ci -n resolves with 36 jobs, down from 37 (only the emerging_lineages rule), no errors.

Test plan

  • CI green.
  • Trial build: confirm exported Auspice JSON colorings/filters no longer contain the three keys.

🤖 Generated with Claude Code

@joverlee521 joverlee521 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Seems reasonable to remove the outdated colorings, this opens the door to cleaning up ncov-ingest (nextstrain/ncov-ingest#504) as well.

Comment thread docs/src/reference/change_log.md Outdated
- 29 July 2025: Improved performance of calls to `augur filter`. This requires a minimum Augur version of 31.3.0. [PR 1178](https://github.com/nextstrain/ncov/pull/1178)
- 28 January 2026: Large JSON files are now automatically minified. This requires a minimum Augur version of 33.0.0. [PR 1194](https://github.com/nextstrain/ncov/pull/1194)
- 30 January 2026: Simplified code for reading metadata. This requires a minimum Augur version of 32.1.0. [PR 1195](https://github.com/nextstrain/ncov/pull/1195)
- 26 June 2026: Remove the stale `emerging_lineage`, `immune_escape`, and `ace2_binding` colorings. The latter two were computed from BA.2 deep-mutational-scanning data and are no longer accurate against current strains. [PR 1213](https://github.com/nextstrain/ncov/pull/1213)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I would also flag that the files.emerging_lineages config param has been removed.

This is technically a backwards incompatible change that warrants a new release. Perhaps batch all of the clean up PRs into a singe v18 release.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yeah, batching as v18 makes sense. We can merge these to master right and then tag master as v18?

@trvrb trvrb Jun 30, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I added

along with the now-unused files.emerging_lineages config parameter

to the changelog

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

yes, merge and then create a new release as per checklist

## Release checklist
If this pull request introduces backward incompatible changes, complete the following steps for a new release of the workflow:
- [ ] Determine the version number for the new release by incrementing [the most recent release](https://github.com/nextstrain/ncov/releases) (e.g., "v2" from "v1").
- [ ] Update `docs/src/reference/change_log.md` in this pull request to document these changes and the new version number.
- [ ] After merging, [create a new GitHub release](https://github.com/nextstrain/ncov/releases/new) with the new version number as the tag and release title.

trvrb and others added 2 commits June 30, 2026 15:12
These three Auspice colorings are no longer useful:
- emerging_lineage: the curated defaults/emerging_lineages.tsv list has not been
  maintained and won't be revived.
- immune_escape / ace2_binding: computed from deep-mutational-scanning data against
  BA.2, so they are inaccurate ("vs BA.2") against today's circulating strains.

emerging_lineage had real build machinery, all removed: the emerging_lineages rule
(augur clades over emerging_lineages.tsv) and its node-data wiring in
main_workflow.smk, the files.emerging_lineages config key, defaults/emerging_lineages.tsv
itself, the coloring + filter in both defaults/auspice_config.json and the dynamic
auspice_config rule in export_for_nextstrain.smk, the 18 emerging_lineage rows in
color_ordering.tsv, and the config-reference docs section.

immune_escape / ace2_binding are not produced by any rule here (the default
sars-cov-2 Nextclade dataset doesn't emit them; they came from the 21L DMS dataset /
upstream metadata). Removal is display-only: the two coloring blocks in both auspice
configs, plus their now-inert passthrough rename mappings in
scripts/join-metadata-and-clades.py.

A CI dry-run drops from 37 to 36 jobs (only the emerging_lineages rule) with no
errors, and defaults/auspice_config.json remains valid JSON.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@trvrb trvrb force-pushed the remove-stale-colorings branch from 8fcc7a1 to f899b71 Compare June 30, 2026 22:13
@trvrb trvrb merged commit f9c1522 into master Jun 30, 2026
6 checks passed
@trvrb trvrb deleted the remove-stale-colorings branch June 30, 2026 22:31
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