Skip to content

Commit

Permalink
template for requesting addition of a new species
Browse files Browse the repository at this point in the history
  • Loading branch information
petrelharp committed Mar 2, 2021
1 parent e88fb3d commit 9505453
Showing 1 changed file with 61 additions and 0 deletions.
61 changes: 61 additions & 0 deletions .github/ISSUE_TEMPLATE/new-species-issue-template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
name: New species
about: Adding a new species to the stdpopsim catalogue.
title:
labels: enhancement
assignees: ''

---

- **Name:** scientific name of the species
- **Common name:**

**Description:** any other discussion or useful background? (optional)

*Note: Maybe you don't know a lot of the things below - but, that's OK!
The criteria are that (a) the choice is reasonable, and (b) the rationale is clear.
What we want is a "reasonable estimate" (or, "best guess") - if you were to use a number in a paper,
what would you use and how would you justify it to your collaborators?
For instance, for "generation time", best would be to cite a paper that actually measures
or estimates generation time. But most species don't have this;
next best would be to give a number used in the literature, and provide a citation that used it
(and hopefully the publication gives a justification also).
Lacking this, you might provide a number from a related species (and a citation for this).*

*Here is the checklist of things that we need to add a species to the catalogue.
Each thing should be provided, with a justification (maybe short) and a citation.*

**Demographic information:**

- [] generation time in years
- [] "default" population size


**Chromosome structure:**

- [] list of chromosomes with *name* and *length* (in bp)


**Recombination rates:**

- [] genetic map (as a .csv) of recombination rates **(optional)**
- [] genome-wide mean recombination rate (which will be used as the default)


**Mutation rate:**

- [] genome-wide mean mutation rate


**Demographic model:**

- [] as a list of population sizes, growth rates, migration rates, etcetera. **(optional)**
- [] citation


**Other information:**

These are things we don't currently use, but will want to use in the future:

- [] sex determination system, and which chromosomes are the sex chromosome(s)
- [] ploidy

0 comments on commit 9505453

Please sign in to comment.