Skip to content

Commit 1cca476

Browse files
committed
Initial port to v1a schema, minus sars-cov-2 varskip schemes
1 parent 056e8f5 commit 1cca476

File tree

181 files changed

+9409
-10055
lines changed

Some content is hidden

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

181 files changed

+9409
-10055
lines changed

.github/workflows/test.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,6 @@ jobs:
2020
python -m pip install ./primaschema
2121
- name: Validate all schemes
2222
run: |
23-
primaschema validate-recursive ./
23+
primaschema validate --recursive schemes
2424
env:
2525
PRIMER_SCHEMES_PATH: "./"

README.md

Lines changed: 30 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
# Primer schemes
44

5-
A versioned and schematised repository of tiling amplicon PCR primer scheme definitions (created with e.g. [Primal Scheme](https://primalscheme.com)) for pathogen sequencing, made with the objective of eliminating ambiguity in scheme naming and versioning in order to facilitate accurate analysis and reuse of amplicon sequence data.
5+
**🚨 Migration to v1 scheme specification in progress**
6+
7+
A versioned and schematised community repository of tiling amplicon PCR primer scheme definitions (created with e.g. [Primal Scheme](https://primalscheme.com)) for pathogen sequencing, made with the objective of eliminating ambiguity in scheme naming and versioning to facilitate accurate analysis and reuse of amplicon sequence data.
68

79

810

@@ -12,78 +14,49 @@ A scheme definition has three components:
1214

1315
1. A reference sequence ([`reference.fasta`](https://github.com/pha4ge/primer-schemes/blob/main/sars-cov-2/artic/v4.1/reference.fasta))
1416
2. A seven column BED file of primer sequences & positions in reference coordinates ([`primer.bed`](https://github.com/pha4ge/primer-schemes/blob/main/sars-cov-2/artic/v4.1/primer.bed))
15-
3. A metadata file in YAML format adhering to [this schema](https://github.com/pha4ge/primer-schemes/blob/main/schema/primer_scheme.yml) ([`info.yml`](https://github.com/pha4ge/primer-schemes/blob/main/sars-cov-2/artic/v4.1/info.yml))
17+
3. A metadata file in YAML format adhering to [this schema](https://github.com/pha4ge/primaschema/blob/main/src/primaschema/schema/info.yml) ([`info.yml`](https://github.com/pha4ge/primer-schemes/blob/main/schemes/sars-cov-2/artic/400/v4.1.0/info.yml))
1618

1719

1820

1921
## Contributing new schemes
2022

21-
We welcome contributions of new primer schemes! We're working to make this process easier, but in the meantime please either follow the instructions below and create a pull request, or else [open a GitHub issue](https://github.com/pha4ge/primer-schemes/issues) attaching or linking to a BED file so that we can help.
22-
23-
### Instructions
24-
25-
1. Choose an appropriate scheme name, e.g. `schemename-v1`, where `v1` indicates the version of the scheme. Avoid including the organism name in the scheme name if possible.
26-
27-
2. Create a directory named `schemename-v1` containing a text file `info.yml` containing:
28-
```yaml
29-
schema_version: 0.9.0
30-
name: schemename-v1
31-
organism: sars-cov-2
32-
developers:
33-
- person_name: Jane Doe
34-
orcid: 1234-5678-9876-5432
35-
amplicon_size: 1200
36-
repository_url: https://github.com/pha4ge/primer-schemes/tree/main/sars-cov-2/schemename/v1
37-
```
38-
39-
3. Copy your scheme's BED file into this directory, naming it `primer.bed`
40-
41-
4. Copy your scheme's reference sequence into this directory, naming it `reference.fasta`
42-
5. Optionally run `primaschema build schemename-v1/` to create a finished scheme bundle
43-
44-
5. Either **open a pull request** adding your scheme directory (e.g. inside `sars-cov-2/schemename/v1`), or else **open a GitHub issue** attaching a zip file containing your scheme.
23+
*Coming soon*
4524

4625

4726

4827
## Tooling
4928

50-
The companion tool [Primaschema](https://github.com/pha4ge/primaschema) can be used to validate scheme definitions and automatically checks and updates this repository via GitHub Actions. Primaschema adds primer and reference sequence checksums to `info.yml` at build time to help catch identical primer schemes. A six column scheme.bed file is also generated at build time for legacy compatibility.
51-
52-
29+
The repository's companion tool [Primaschema](https://github.com/pha4ge/primaschema) is used to automatically validate schemes in this repository and create plots, as well as generate a six column scheme.bed for legacy tool compatibility. It can also be installed standalone.
5330

54-
## Documented schemes (24)
5531

56-
### SARS-CoV-2 (22)
5732

58-
- `artic-v1`
59-
- `artic-v2`
60-
- `artic-v3`
61-
- `artic-v4`
62-
- `artic-v4.1`
63-
- `artic-v5.0.0_400`
64-
- `artic-v5.1.0_400`
65-
- `artic-v5.2.0_1200`
66-
- `artic-v5.2.0_400`
67-
- `artic-v5.3.2_400`
68-
- `eden-v1`
69-
- `midnight-bccdc-v1`
70-
- `midnight-bccdc-v2`
71-
- `midnight-bccdc-v3`
72-
- `midnight-bccdc-v4`
73-
- `midnight-ont-v3`
74-
- `midnight-v1`
75-
- `midnight-v2`
76-
- `varskip-vsl1a`
77-
- `varskip-vss1a`
78-
- `varskip-vss2a`
79-
- `varskip-vss2b`
33+
## Scheme definitions
8034

35+
### MPXV
8136

37+
- `mpxv/yale/2000/v1.0.0`
38+
- `mpxv/erasmus/2500/v1.0.0`
8239

83-
### MPXV (1)
40+
### NIV
8441

85-
- `yale-v3`
42+
- `niv/nipah/400/v1.0.0`
8643

87-
### NiV (1)
44+
### SARS-CoV-2
8845

89-
- `nipah-v1`
46+
- `sars-cov-2/eden/2500/v1.0.0`
47+
- `sars-cov-2/midnight/1200/bccdc-v1.0.0`
48+
- `sars-cov-2/midnight/1200/bccdc-v3.0.0`
49+
- `sars-cov-2/midnight/1200/bccdc-v2.0.0`
50+
- `sars-cov-2/midnight/1200/bccdc-v4.0.0`
51+
- `sars-cov-2/midnight/1200/v2.0.0`
52+
- `sars-cov-2/midnight/1200/v1.0.0`
53+
- `sars-cov-2/midnight/1200/ont-v3.0.0`
54+
- `sars-cov-2/artic/400/v3.0.0`
55+
- `sars-cov-2/artic/400/v2.0.0`
56+
- `sars-cov-2/artic/400/v1.0.0`
57+
- `sars-cov-2/artic/400/v5.0.0`
58+
- `sars-cov-2/artic/400/v4.0.0`
59+
- `sars-cov-2/artic/400/v4.1.0`
60+
- `sars-cov-2/artic/400/v5.3.2`
61+
- `sars-cov-2/artic/400/v5.4.2`
62+
- `sars-cov-2/artic/400/v5.2.0`

0 commit comments

Comments
 (0)