Skip to content

Commit ac2d8e1

Browse files
Updated AUGUR_VER to 33.4.1. Added a version command for augur. Updated program-specific README.md with updated python packages. Added 33.4.1 to versions dropdown entry for Augur. The program license remains the same.
1 parent 6feed17 commit ac2d8e1

3 files changed

Lines changed: 212 additions & 1 deletion

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ To learn more about the docker pull rate limits and the open source software pro
121121
| [artic-ncov2019-nanopolish](https://hub.docker.com/r/staphb/artic-ncov2019-nanopolish) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/artic-ncov2019-nanopolish)](https://hub.docker.com/r/staphb/artic-ncov2019-nanopolish) | <details><summary>Click to see all versions</summary> <ul><li>[1.1.0](./build-files/artic-ncov2019-nanopolish/1.1.0/)</ul> </details> | https://github.com/artic-network/artic-ncov2019 |
122122
| [artic-tools](https://hub.docker.com/r/staphb/artic-tools) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/artic-tools)](https://hub.docker.com/r/staphb/artic-tools) | <details><summary> Click to see all versions</summary> <ul><li>[0.3.1](./build-files/artic-tools/0.3.1/)</ul></details> | https://github.com/will-rowe/artic-tools
123123
| [assembly_snptyper](https://hub.docker.com/r/staphb/assembly_snptyperh) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/assembly_snptyper)](https://hub.docker.com/r/staphb/assembly_snptyper) | <details><summary>Click to see all versions</summary> <ul><li>[0.1.1](./build-files/assembly_snptyper/0.1.1/)</li></ul> </details> | https://github.com/boasvdp/assembly_snptyper |
124-
| [Augur](https://hub.docker.com/r/staphb/augur) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/augur)](https://hub.docker.com/r/staphb/augur) | <details><summary>Click to see all versions</summary> <ul><li>[6.3.0](./build-files/augur/6.3.0/)</li><li>[7.0.2](./build-files/augur/7.0.2/)</li><li>[8.0.0](./build-files/augur/8.0.0/)</li><li>[9.0.0](./build-files/augur/9.0.0/)</li><li>[16.0.3](./build-files/augur/16.0.3/)</li><li>[24.2.2](./build-files/augur/24.2.2/)</li><li>[24.2.3](./build-files/augur/24.2.3/)</li><li>[24.3.0](./build-files/augur/24.3.0/)</li><li>[24.4.0](./build-files/augur/24.4.0/)</li><li>[26.0.0](./build-files/augur/26.0.0/)</li><li>[27.0.0](./build-files/augur/27.0.0/)</li><li>[28.0.1](./build-files/augur/28.0.1/)</li><li>[29.0.0](./build-files/augur/29.0.0/)</li><li>[30.0.0](./build-files/augur/30.0.0/)</li><li>[31.1.0](./build-files/augur/31.1.0/)</li><li>[31.3.0](./build-files/augur/31.3.0/)</li><li>[31.4.0](./build-files/augur/31.4.0/)</li><li>[31.5.0](./build-files/augur/31.5.0/)</li><li>[32.0.0](./build-files/augur/32.0.0/)</li><li>[32.1.0](./build-files/augur/32.1.0/)</li><li>[33.0.0](./build-files/augur/33.0.0/)</li><li>[33.0.1](./build-files/augur/33.0.1/)</li><li>[33.1.0](./build-files/augur/33.1.0/)</li><li>[33.2.0](./build-files/augur/33.2.0/)</li></ul> </details> | https://github.com/nextstrain/augur |
124+
| [Augur](https://hub.docker.com/r/staphb/augur) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/augur)](https://hub.docker.com/r/staphb/augur) | <details><summary>Click to see all versions</summary> <ul><li>[6.3.0](./build-files/augur/6.3.0/)</li><li>[7.0.2](./build-files/augur/7.0.2/)</li><li>[8.0.0](./build-files/augur/8.0.0/)</li><li>[9.0.0](./build-files/augur/9.0.0/)</li><li>[16.0.3](./build-files/augur/16.0.3/)</li><li>[24.2.2](./build-files/augur/24.2.2/)</li><li>[24.2.3](./build-files/augur/24.2.3/)</li><li>[24.3.0](./build-files/augur/24.3.0/)</li><li>[24.4.0](./build-files/augur/24.4.0/)</li><li>[26.0.0](./build-files/augur/26.0.0/)</li><li>[27.0.0](./build-files/augur/27.0.0/)</li><li>[28.0.1](./build-files/augur/28.0.1/)</li><li>[29.0.0](./build-files/augur/29.0.0/)</li><li>[30.0.0](./build-files/augur/30.0.0/)</li><li>[31.1.0](./build-files/augur/31.1.0/)</li><li>[31.3.0](./build-files/augur/31.3.0/)</li><li>[31.4.0](./build-files/augur/31.4.0/)</li><li>[31.5.0](./build-files/augur/31.5.0/)</li><li>[32.0.0](./build-files/augur/32.0.0/)</li><li>[32.1.0](./build-files/augur/32.1.0/)</li><li>[33.0.0](./build-files/augur/33.0.0/)</li><li>[33.0.1](./build-files/augur/33.0.1/)</li><li>[33.1.0](./build-files/augur/33.1.0/)</li><li>[33.2.0](./build-files/augur/33.2.0/)</li><li>[33.4.1](./build-files/augur/33.4.1/)</li></ul> </details> | https://github.com/nextstrain/augur |
125125
| [Auspice](https://hub.docker.com/r/staphb/auspice) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/auspice)](https://hub.docker.com/r/staphb/auspice) | <details><summary>Click to see all versions</summary> <ul><li>[2.12.0](./build-files/auspice/2.12.0/)</li><li>[2.68.0](./build-files/auspice/2.68.0/)</li></ul> </details> | https://github.com/nextstrain/auspice |
126126
| [Autocycler](https://hub.docker.com/r/staphb/autocycler) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/autocycler)](https://hub.docker.com/r/staphb/autocycler) | <details><summary>Click to see all versions</summary> <ul><li>[0.2.1](./build-files/autocycler/0.2.1/)</li><li>[0.2.1-tutorial](./build-files/autocycler/0.2.1-tutorial/)</li><li>[0.4.0](./build-files/autocycler/0.4.0/)</li><li>[0.4.0-tutorial](./build-files/autocycler/0.4.0-tutorial/)</li><li>[0.6.1](./build-files/autocycler/0.6.1/)</li><li>[0.6.1-tutorial](./build-files/autocycler/0.6.1-tutorial/)</li>li>[0.6.2](./build-files/autocycler/0.6.2/)</li><li>[0.6.2-tutorial](./build-files/autocycler/0.6.2-tutorial/)</li></ul> </details> | https://github.com/rrwick/Autocycler/ |
127127
| [bakta](https://hub.docker.com/r/staphb/bakta) <br/> [![docker pulls](https://badgen.net/docker/pulls/staphb/bakta)](https://hub.docker.com/r/staphb/bakta) | <details><summary>Click to see all versions</summary> <ul><li>[1.9.2](./build-files/bakta/1.9.2/)</li><li>[1.9.2-light](./build-files/bakta/1.9.2-5.1-light/)</li><li>[1.9.3](./build-files/bakta/1.9.3/)</li><li>[1.9.3-light](./build-files/bakta/1.9.3-5.1-light/)</li><li>[1.9.4](./build-files/bakta/1.9.4/)</li><li>[1.9.4-5.1-light](./build-files/bakta/1.9.4-5.1-light/)</li><li>[1.10.3](./build-files/bakta/1.10.3/)</li><li>[1.10.3-light](./build-files/bakta/1.10.3-5.1-light/)</li><li>[1.10.4](./build-files/bakta/1.10.4/)</li><li>[1.10.4-5.1-light](./build-files/bakta/1.10.4-5.1-light/)</li><li>[1.11.0](./build-files/bakta/1.11.0/)</li><li>[1.11.0-6.0-light](./build-files/bakta/1.11.0-6.0-light/)</li><li>[1.11.3](./build-files/bakta/1.11.3/)</li><li>[1.11.3-6.0-light](./build-files/bakta/1.11.3-6.0-light/)</li><li>[1.11.4](./build-files/bakta/1.11.4/)</li><li>[1.11.4-6.0-light](./build-files/bakta/1.11.4-6.0-light/)</li><li>[1.12.0](./build-files/bakta/1.12.0/)</li><li>[1.12.0-6.0-light](./build-files/bakta/1.12.0-6.0-light/)</li></ul> </details> | https://github.com/oschwengers/bakta |
Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
FROM python:3.12-slim AS app
2+
3+
ARG AUGUR_VER="33.4.1"
4+
ARG SEQKIT_VER="2.13.0"
5+
6+
# LABEL instructions tag the image with metadata that might be important to the user
7+
# Optional, but highly recommended
8+
LABEL base.image="python:3.12-slim"
9+
LABEL dockerfile.version="1"
10+
LABEL software="augur"
11+
LABEL software.version=${AUGUR_VER}
12+
LABEL description="Augur is the bioinformatics toolkit we use to track evolution from sequence and serological data.The output of augur is a series of JSONs that can be used to visualize your results using Auspice."
13+
LABEL website="https://github.com/nextstrain/augur"
14+
LABEL license="https://github.com/nextstrain/augur/blob/master/LICENSE.txt"
15+
LABEL maintainer="John Arnn"
16+
LABEL maintainer.email="jarnn@utah.gov"
17+
18+
# 'RUN' executes code during the build
19+
# Install dependencies via apt-get or yum if using a centos or fedora base
20+
RUN apt-get update && apt-get install -y --no-install-recommends \
21+
procps \
22+
ca-certificates \
23+
wget \
24+
mafft \
25+
iqtree \
26+
raxml \
27+
fasttree \
28+
vcftools && \
29+
apt-get autoclean && rm -rf /var/lib/apt/lists/*
30+
31+
# install seqkit
32+
RUN wget -q https://github.com/shenwei356/seqkit/releases/download/v${SEQKIT_VER}/seqkit_linux_amd64.tar.gz && \
33+
tar -xzf seqkit_linux_amd64.tar.gz && \
34+
mv seqkit /usr/local/bin/. && \
35+
rm seqkit_linux_amd64.tar.gz
36+
37+
# install augur
38+
RUN wget -q https://github.com/nextstrain/augur/archive/refs/tags/${AUGUR_VER}.tar.gz && \
39+
tar -xzf ${AUGUR_VER}.tar.gz && \
40+
pip install ${AUGUR_VER}.tar.gz --no-cache-dir && \
41+
rm -v ${AUGUR_VER}.tar.gz
42+
43+
# augur tree calls iqtree
44+
RUN ln -s /usr/bin/iqtree2 /usr/bin/iqtree
45+
46+
CMD [ "augur", "--help" ]
47+
48+
WORKDIR /data
49+
50+
FROM app AS test
51+
52+
RUN augur --help && augur version
53+
54+
WORKDIR /test
55+
56+
RUN apt-get update && apt-get install -y --no-install-recommends git
57+
58+
RUN git clone https://github.com/nextstrain/zika-tutorial && \
59+
cd zika-tutorial && \
60+
mkdir results && \
61+
augur index \
62+
--sequences data/sequences.fasta \
63+
--output results/sequence_index.tsv && \
64+
augur filter \
65+
--sequences data/sequences.fasta \
66+
--sequence-index results/sequence_index.tsv \
67+
--metadata data/metadata.tsv \
68+
--exclude config/dropped_strains.txt \
69+
--output-sequences results/filtered.fasta \
70+
--group-by country year month \
71+
--sequences-per-group 20 \
72+
--min-date 2012 && \
73+
augur align \
74+
--sequences results/filtered.fasta \
75+
--reference-sequence config/zika_outgroup.gb \
76+
--output results/aligned.fasta \
77+
--fill-gaps && \
78+
augur tree \
79+
--alignment results/aligned.fasta \
80+
--output results/tree_raw.nwk && \
81+
augur refine \
82+
--tree results/tree_raw.nwk \
83+
--alignment results/aligned.fasta \
84+
--metadata data/metadata.tsv \
85+
--output-tree results/tree.nwk \
86+
--output-node-data results/branch_lengths.json \
87+
--timetree \
88+
--coalescent opt \
89+
--date-confidence \
90+
--date-inference marginal \
91+
--clock-filter-iqd 4 && \
92+
augur traits \
93+
--tree results/tree.nwk \
94+
--metadata data/metadata.tsv \
95+
--output-node-data results/traits.json \
96+
--columns region country \
97+
--confidence && \
98+
augur ancestral \
99+
--tree results/tree.nwk \
100+
--alignment results/aligned.fasta \
101+
--output-node-data results/nt_muts.json \
102+
--inference joint && \
103+
augur translate \
104+
--tree results/tree.nwk \
105+
--ancestral-sequences results/nt_muts.json \
106+
--reference-sequence config/zika_outgroup.gb \
107+
--output-node-data results/aa_muts.json && \
108+
augur export v2 \
109+
--tree results/tree.nwk \
110+
--metadata data/metadata.tsv \
111+
--node-data results/branch_lengths.json \
112+
results/traits.json \
113+
results/nt_muts.json \
114+
results/aa_muts.json \
115+
--colors config/colors.tsv \
116+
--lat-longs config/lat_longs.tsv \
117+
--auspice-config config/auspice_config.json \
118+
--output auspice/zika.json && \
119+
head auspice/zika.json
120+
121+
RUN pip list

build-files/augur/33.4.1/README.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
# Augur Container
2+
3+
Main tool: [Augur](https://github.com/nextstrain/augur)
4+
5+
Definition: One held to foretell events by omens.
6+
7+
Augur is the bioinformatics toolkit we use to track evolution from sequence and serological data. It provides a collection of commands which are designed to be composable into larger processing pipelines.
8+
9+
The output of augur is a series of JSONs that can be used to visualize your results using Auspice.
10+
11+
Note: Auspice is a different tool.
12+
13+
## Additional dependencies
14+
15+
- fasttree 2.1.11-2
16+
- python 3.12.13
17+
- iqtree 2.0.7+dfsg-1+b2
18+
- mafft 7.505-1
19+
- raxml 8.2.13+dfsg-2+b1
20+
- vcftools 0.1.16-3+b1
21+
- seqkit 2.13.0
22+
23+
<details>
24+
25+
<summary>Additional tools installed via pip:</summary>
26+
27+
```
28+
Package Version
29+
------------------------- -----------
30+
attrs 26.1.0
31+
backports.zstd 1.6.0
32+
bcbio-gff 0.7.1
33+
biopython 1.87
34+
contourpy 1.3.3
35+
cvxopt 1.3.3
36+
cycler 0.12.1
37+
docutils 0.23
38+
fonttools 4.63.0
39+
isal 1.8.0
40+
isodate 0.7.2
41+
jsonschema 4.26.0
42+
jsonschema-specifications 2025.9.1
43+
kiwisolver 1.5.0
44+
matplotlib 3.11.0
45+
networkx 3.6.1
46+
nextstrain-augur 33.4.1
47+
numpy 2.5.0
48+
packaging 26.2
49+
pandas 2.3.3
50+
phylo-treetime 0.12.1
51+
pillow 12.2.0
52+
pip 25.0.1
53+
pyfastx 2.3.1
54+
pyparsing 3.3.2
55+
python-calamine 0.7.0
56+
python-dateutil 2.9.0.post0
57+
pytz 2026.2
58+
PyYAML 6.0.3
59+
referencing 0.37.0
60+
rpds-py 2026.5.1
61+
scipy 1.18.0
62+
six 1.17.0
63+
typing_extensions 4.15.0
64+
tzdata 2026.2
65+
xopen 2.1.0
66+
zlib-ng 1.0.0
67+
68+
```
69+
70+
</details>
71+
72+
## Example Usage
73+
74+
```bash
75+
augur index --sequences sequences.fasta --output sequence_index.tsv
76+
```
77+
78+
```bash
79+
augur filter \
80+
--sequences data/sequences.fasta \
81+
--sequence-index results/sequence_index.tsv \
82+
--metadata data/metadata.tsv \
83+
--exclude config/dropped_strains.txt \
84+
--output-sequences results/filtered.fasta \
85+
--group-by country year month \
86+
--sequences-per-group 20 \
87+
--min-date 2012
88+
```
89+
90+
Better documentation can be found [here.](https://docs.nextstrain.org/en/latest/tutorials/creating-a-workflow.html)

0 commit comments

Comments
 (0)