This repo houses the Pteridophyte Phylogeny Group (PPG) taxonomic database for ferns and lycophytes.
Issues are used to discuss taxonomic proposals by the PPG community, which are voted on monthly. All proposals are relative to PPG I (2016). To propose a taxonomic change, use the taxonomic proposal template. Proposals that pass by a 2/3 majority will be implemented in the taxonomic database.
For more information about PPG, see the PPG webpage.
IMPORTANT: if you want to participate, please read the Project Guidelines first.
The database is provided as a CSV file in the Darwin Core (DwC) format for taxonomic data.
A human readable summary of the same data is available as a plain text file in Markdown format.
The data are currently being updated to reflect changes that have taken place since PPG I (2016). Once this is done, a version number starting with 2 (i.e., PPG II) will be assigned. Therefore, these data should not be taken as the official PPG II system until a version number is assigned >= 2.
All taxonomic decisions are made by the PPG community.
Taxonomic proposals should be submitted as issues, which will be voted on monthly. Proposals may be commented upon in the issue tracker. Voting is carried out separately via a Google Form survey circulated on the PPG mailing list. Any proposal receiving >2/3 support will be approved and implemented in the data.
Anybody is welcome to contribute. All participants must adhere to the Code of Conduct. Please read the Project Guidelines before contributing.
The data are refreshed daily by the Update PPG data GitHub Actions
workflow (.github/workflows/update-ppg.yml), which runs the targets
pipeline and commits any changed data files back to main. It can also be
triggered manually from the Actions tab, or via
gh workflow run update-ppg.yml.
The Docker image is only for local, interactive development; it is not used by the automated update.
Mount gitconfig and ssh for authentication:
docker run --rm -dt \
-v ${PWD}:/wd \
-v $HOME/.gitconfig:/home/user/.gitconfig:ro \
-v $HOME/.ssh:/home/user/.ssh:ro \
-w /wd \
joelnitta/ppg:latest bash
Then attach to the container:
docker exec -it $(docker ps -q --filter ancestor=joelnitta/ppg:latest) bash
Original data were kindly provided by Michael Hassler.
Pteridophyte Phylogeny Group I (2016) A community-derived classification for extant lycophytes and ferns. Journal of Systematics and Evolution 54:563–603. https://doi.org/10.1111/jse.12229
Data (files in data_raw/ and data/) are made available under the CC BY 4.0 license.
Code is under the MIT license.