Skip to content

Commit 261cff9

Browse files
committed
updating documentation
1 parent 442164a commit 261cff9

File tree

84 files changed

+16044
-11145
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

84 files changed

+16044
-11145
lines changed

.github/404.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Page not found (404)
2+
3+
Please use the links in the navigation bar.

NEWS.md

Lines changed: 59 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,59 @@
1-
2-
# MIRA 2.0.0
3-
* Github Repo: https://github.com/CDCgov/MIRA
4-
* Documentation: https://cdcgov.github.io/MIRA
5-
6-
### v2.0.0
7-
- Single container distribution (previously 4 docker images)
8-
- RSV Illumina module
9-
- RSV Nanopore module
10-
- Alternative Command-line interface running of MIRA
11-
- Associated .html result files generated from command-line pipeline
12-
- Documentation overhaul
13-
14-
15-
### v1.1.4
16-
- Empty Illumina fastq error-handling
17-
- Illumina fastq reads less than 70 bases error-handling
18-
19-
### v1.1.3
20-
- MIRA version displayed in app and in IRMA summary table (along with config)
21-
- IRMA version bump 1.1.4
22-
- fixed pulp version
23-
- Turn off padding for S gene module
24-
- Packaged fastq in irma .tar.gz
25-
- Error fixes for single-sample runs
26-
27-
### v1.1.2
28-
- Whole-Genome SC2 Nanopore module
29-
- Illumina 2x75 support for Flu and SC2 whole-genome modules
30-
- Java instability fixed
31-
- New Version Checking
32-
- Lab protocols published on documentation website
33-
- Docker compose steps added to quickstart on documentation website
34-
- Quality control checks for S-gene specific metrics added to Whole-Genome SC2 modules
35-
- IRMA container V1.1.1
36-
- [Final sorted, amended .bams](https://wonder.cdc.gov/amd/flu/irma/output.html) included in tarball. This is in addition to the F1 .bam, which is the first iteration of alignment before reference editing.
37-
38-
#### v1.1.1
39-
- Pandas version --> 1.1.0
40-
- Mac docs updated to show Rosetta usage in Docker Desktop
41-
- More thorough error and status messaging during assembly
42-
43-
#### v1.1.0
44-
- Illumina sequencing for WGS SC2 and Flu
45-
- Auto-samplesheet building
46-
- Samplesheet download/upload functionality
47-
- Button added to refresh run listing
48-
- Button added to download failed fastas
49-
- Downloaded fasta for FLU now changes the flu segment numbers to the gene name
50-
- Allow numeric samplenames, and allow "-" in sample names
51-
- Toss broken reads for ONT fastqs
52-
- Return only closer Flu B reference in amino acid variants table
53-
- Better error handling for empty/failed nanopore barcodes
54-
- Indel table filtered to >20%, Minor variant table filtered to >5%
55-
- Archive previous run logs in the even of a re-run
56-
1+
2+
# MIRA 2.0.0
3+
4+
* Github Repo: https://github.com/CDCgov/MIRA
5+
* Documentation: https://cdcgov.github.io/MIRA
6+
7+
### v2.0.0
8+
- Single container distribution (previously 4 docker images)
9+
- RSV Illumina module
10+
- RSV Nanopore module
11+
- Alternative Command-line interface running of MIRA
12+
- Associated .html result files generated from command-line pipeline
13+
- Documentation overhaul
14+
15+
16+
# MIRA 1.0.0
17+
18+
### v1.1.4
19+
- Empty Illumina fastq error-handling
20+
- Illumina fastq reads less than 70 bases error-handling
21+
22+
### v1.1.3
23+
- MIRA version displayed in app and in IRMA summary table (along with config)
24+
- IRMA version bump 1.1.4
25+
- fixed pulp version
26+
- Turn off padding for S gene module
27+
- Packaged fastq in irma .tar.gz
28+
- Error fixes for single-sample runs
29+
30+
### v1.1.2
31+
- Whole-Genome SC2 Nanopore module
32+
- Illumina 2x75 support for Flu and SC2 whole-genome modules
33+
- Java instability fixed
34+
- New Version Checking
35+
- Lab protocols published on documentation website
36+
- Docker compose steps added to quickstart on documentation website
37+
- Quality control checks for S-gene specific metrics added to Whole-Genome SC2 modules
38+
- IRMA container V1.1.1
39+
- [Final sorted, amended .bams](https://wonder.cdc.gov/amd/flu/irma/output.html) included in tarball. This is in addition to the F1 .bam, which is the first iteration of alignment before reference editing.
40+
41+
#### v1.1.1
42+
- Pandas version --> 1.1.0
43+
- Mac docs updated to show Rosetta usage in Docker Desktop
44+
- More thorough error and status messaging during assembly
45+
46+
#### v1.1.0
47+
- Illumina sequencing for WGS SC2 and Flu
48+
- Auto-samplesheet building
49+
- Samplesheet download/upload functionality
50+
- Button added to refresh run listing
51+
- Button added to download failed fastas
52+
- Downloaded fasta for FLU now changes the flu segment numbers to the gene name
53+
- Allow numeric samplenames, and allow "-" in sample names
54+
- Toss broken reads for ONT fastqs
55+
- Return only closer Flu B reference in amino acid variants table
56+
- Better error handling for empty/failed nanopore barcodes
57+
- Indel table filtered to >20%, Minor variant table filtered to >5%
58+
- Archive previous run logs in the even of a re-run
59+

_pkgdown.yml

Lines changed: 47 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,42 @@
1-
url: https://github.com/CDCgov/MIRA/, https://cdcgov.github.io/MIRA/
1+
url: https://github.com/CDCgov/MIRA/
22

33
template:
4-
params:
5-
bootstrap: 5
6-
bootswatch: cosmo
4+
bootstrap: 5
5+
light-switch: true
76

87
authors:
8+
Ben Rambo-Martin:
9+
href: https://github.com/nbx0
910
Kristine Lacek:
1011
href: https://github.com/kristinelacek
1112
Reina Chau:
1213
href: https://github.com/rchau88
1314
Amanda Sullivan:
1415
href: https://github.com/mandysulli
15-
Ben Rambo-Martin:
16-
href: https://github.com/nbx0
1716

1817
news:
1918
one_page: false
2019

2120
home:
21+
title: MIRA Documentation
2222
sidebar:
23-
structure: [license, citation, authors]
24-
23+
structure: [license, citation, authors, resources]
24+
components:
25+
resources:
26+
title: "Resources"
27+
text: "<a href='mailto:[email protected]'><span class='fa fa-envelope'></span> Contact Us</a>"
28+
2529
navbar:
2630
title: "MIRA"
27-
left:
28-
- icon: fa-home
31+
structure:
32+
left: [home, mira_desktop, mira_cli, lab_protocols, help, legacy]
33+
right: [search, change_log, issue, github, lightswitch]
34+
components:
35+
home:
36+
icon: fa-home
2937
href: index.html
30-
- text: "MIRA in Docker Desktop"
38+
mira_desktop:
39+
text: "MIRA in Docker Desktop"
3140
menu:
3241
- text: Getting Started and Installation
3342
href: articles/mira-dd-getting-started.html
@@ -39,7 +48,8 @@ navbar:
3948
href: articles/data-transfer.html
4049
- text: Upgrading MIRA Docker Desktop
4150
href: articles/upgrading-mira-dd.html
42-
- text: "MIRA-CLI"
51+
mira_cli:
52+
text: "MIRA-CLI"
4353
menu:
4454
- text: Quick Start in Ubuntu
4555
href: articles/quick-start-ubuntu.html
@@ -55,7 +65,8 @@ navbar:
5565
href: articles/running-mira-cli-illumina.html
5666
- text: Upgrading MIRA-CLI
5767
href: articles/upgrading-mira-cli.html
58-
- text: "Lab Protocols"
68+
lab_protocols:
69+
text: "Lab Protocols"
5970
menu:
6071
- text: Sequencing Template Generation
6172
- text: Automated RNA Extraction using QIAcube HT
@@ -84,20 +95,23 @@ navbar:
8495
- text: Oxford Nanopore Library Preparation and Sequencing
8596
- text: Library Preparation and Nanopore Sequencing of Influenza and SARS-COV-2 S-gene Amplicons
8697
icon: fa-star
87-
href: articles/influenza-sars-cov-2-s-gene-amplicons-nanopore.html
88-
- text: Help
98+
href: articles/influenza-sars-cov-2-s-gene-amplicons-nanopore.html
99+
100+
help:
101+
text: "Help"
89102
menu:
90-
- text: FAQs
91-
href: articles/FAQs.html
92-
- text: Troubleshooting
93-
href: articles/troubleshooting.html
94-
- text: QC Standards
95-
href: articles/sequence-qc.html
96-
- text: Development Tips
97-
href: articles/development-tips.html
98-
- text: Nanopore Frameshift Correction
99-
href: articles/nanopore-frameshift-correction.html
100-
- text: Legacy
103+
- text: FAQs
104+
href: articles/FAQs.html
105+
- text: Troubleshooting
106+
href: articles/troubleshooting.html
107+
- text: QC Standards
108+
href: articles/sequence-qc.html
109+
- text: Development Tips
110+
href: articles/development-tips.html
111+
- text: Nanopore Frameshift Correction
112+
href: articles/nanopore-frameshift-correction.html
113+
legacy:
114+
text: "Legacy"
101115
menu:
102116
- text: Retired PC Getting Started
103117
href: articles/getting-started.html
@@ -113,17 +127,16 @@ navbar:
113127
href: articles/running-mira-illumina.html
114128
- text: Retired Post MIRA sequence analysis with Nextclade
115129
href: articles/training-post-mira.html
116-
search:
117-
exclude: ['news/index.html']
118-
right:
119-
- text: "Change Log"
130+
change_log:
131+
text: "Change Log"
120132
href: news/index.html
121-
- icon: fa-envelope
122-
href: "mailto:[email protected]"
123-
- icon: fa-comments
133+
issue:
134+
icon: fa-comments
124135
href: https://github.com/CDCgov/MIRA/issues
125-
- icon: fa-github
136+
github:
137+
icon: fa-github
126138
href: https://github.com/CDCgov/MIRA
139+
127140
footer:
128141
structure:
129142
left: developed_by

docker-compose-dev.yml

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
version: "3.9"
2+
3+
x-spyne-image:
4+
&spyne-image
5+
spyne_image: cdcgov/spyne-dev:v2.0.0
6+
7+
x-mira-volume:
8+
&mira-volume
9+
type: bind
10+
source: /home/snu3/Github/MIRA
11+
target: /MIRA
12+
13+
x-spyne-volume:
14+
&spyne-volume
15+
type: bind
16+
source: /home/snu3/Github/spyne
17+
target: /spyne
18+
19+
x-data-volume:
20+
&data-volume
21+
type: bind
22+
source: /home/snu3/Github/FLU_SC2_SEQUENCING
23+
target: /data
24+
25+
services:
26+
mira:
27+
container_name: mira
28+
image: mira:latest
29+
build:
30+
context: .
31+
dockerfile: Dockerfile
32+
args:
33+
<< : [*spyne-image]
34+
restart: always
35+
ports:
36+
- 8020:8050
37+
volumes:
38+
- *data-volume
39+
- *mira-volume
40+
- *spyne-volume

0 commit comments

Comments
 (0)