A cldfbench plugin to curate language phylogenies
Project description
phlorest
A cldfbench plugin to curate language phylogenies.
Install
pip install phlorest
Usage
Bootstrapping a phlorest
-curated dataset
phlorest
provides a cldfbench
dataset template to create the skeleton of files and directories for a
phlorest
-curated dataset, to be run with cldfbench new.
Running
cldfbench new --template phlorest
will create a dataset skeleton looking as follows
$ tree testtree/
testtree/
├── cldf
│ └── README.md
├── cldfbench_testtree.py
├── etc
│ ├── characters.csv
│ └── taxa.csv
├── metadata.json
├── raw
│ └── README.md
├── setup.cfg
├── setup.py
└── test.py
Implementing CLDF creation
Implementing CLDF creation means - as for any other cldfbench
-curated dataset - filling in the
cmd_makecldf
method of the Dataset
subclass in cldfbench_<id>.py
.
The CLDF writer which can be accessed as args.writer
within cmd_makecldf
is an instance of
phlorest.CLDFWriter
, which has convenience methods to add summary- or posterior trees to the CLDF
dataset. At least a summary is needed to make a dataset valid. Adding one looks as follows
args.writer.add_summary(
self.raw_dir.read_tree(...),
self.metadata,
args.log)
Running CLDF creation
With cmd_makecldf
implemented, CLDF creation can be triggered running
cldfbench makecldf cldfbench_<id>.py
The resulting CLDF dataset can be validated running
pytest
Release workflow
cldfbench makecldf --glottolog-version vX.Y --with-zenodo --with-cldfreadme cldfbench_<id>.py
pytest
cldfbench readme cldfbench_<id>.py
Dependencies
The run_treeannotator
method of Dataset
requires the treeannotator
command from BEAST to be
installed. For details on how to install treeannotator
(and BEAST
), see https://beast.community/index.html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for phlorest-1.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | adf9ff263009937ccddc96dbd752e1f0bef5ca8ae30bf4423f78e3ebcb6a49bc |
|
MD5 | 5b4393b0a289b339358de9f1dcff941d |
|
BLAKE2b-256 | 5b63f978bb035c22a56f498995fbad6d994622f8d64b98e2b5b5b327a06fc675 |