https://github.com/cldf/cldfviz
A python library providing tools to visualize data from CLDF datasets.
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 12 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (16.2%) to scientific vocabulary
Keywords from Contributors
Repository
A python library providing tools to visualize data from CLDF datasets.
Basic Info
Statistics
- Stars: 6
- Watchers: 7
- Forks: 2
- Open Issues: 7
- Releases: 3
Metadata Files
README.md
cldfviz
Python library providing tools to visualize CLDF datasets.
Install
Run
shell
pip install cldfviz
If you want to create maps in image formats (PNG, JPG, PDF), the cartopy package is needed,
which will be installed with
shell
pip install cldfviz[cartopy]
Note: Since cartopy has quite a few system-level requirements, installation may be somewhat tricky. Should
problems arise, https://scitools.org.uk/cartopy/docs/v0.15/installing.html may help.
If you want to create "treemaps" (i.e. use the lingreemaps
package for CLDF data), you need to install via
shell
pip install cldfviz[lingtreemaps]
CLI
cldfviz is implemented as cldfbench
plugin, i.e. it provides subcommands for the cldfbench command.
After installation you should see subcommands with a cldfviz. prefix
listed when running
shell
cldfbench -h
Help provided by the CLI is sometimes extensive and can be consulted via
shell
cldfbench <sucommand> -h
e.g.
shell
$ cldfbench cldfviz.map -h
usage: cldfbench cldfviz.map [-h] [--download-dir DOWNLOAD_DIR] [--language-filters LANGUAGE_FILTERS]
[--glottolog GLOTTOLOG] [--glottolog-version GLOTTOLOG_VERSION]
...
Commands
A short description of the cldfviz subcommands can be found below; for more documentation click on the images.
Example data
Examples in this documentation sometimes use CLDF data stored in the local filesystem.
In particular, we'll use
- 
: WALS Online
- 
: Glottolog as CLDF dataset
- 
: APiCS Online
If you download these datasets using the cldfbench plugin cldfzenodo
shell
cldfbench zenodo.download 10.5281/zenodo.7385533 --full-deposit
cldfbench zenodo.download 10.5281/zenodo.7398887 --full-deposit
cldfbench zenodo.download 10.5281/zenodo.7139937 --full-deposit
you should have the respective data in local directories wals-2020.3/, glottolog-cldf-4.7/ and cldf-datasets-apics-4ed59b5/.
cldfviz.map
A common way to visualize data from a CLDF StructureDataset is as "dots on a map",
i.e. as WALS-like geographic maps, displaying typological variation.
The cldfviz.map subcommand allows you to create such maps. For details see docs/map.md.
cldfviz.text
A rather traditional visualization of linguistic data is the practice of interspersing bits of data
in descriptive texts, most obviously perhaps as examples formatted as Interlinear Glossed Text.
The cldfviz.text subcommand allows you "render" documents written in CLDF markdown, i.e. converting
such documents to plain markdown by inserting suitable representations of the referenced data.
For details see docs/text.md.
cldfviz.examples
While it is possible to (selectively) include IGT formatted examples in CLDF Markdown via cldfviz.text,
often it is useful to just look at an HTML formatted list of all examples from a dataset. This can
be done via cldfviz.examples. For details see docs/examples.md.
cldfviz.tree
Phylogenetic (or classification) trees of languages are a "proper" CLDF component since CLDF 1.2 - and an obvious candidate for visualization (because noone likes to look at Newick).
To provide a configurable visualization of trees in SVG format, the
cldfviz.tree command renders CLDF trees using the powerful toytree
package. For details see docs/tree.md.
cldfviz.treemap
Displaying maps and trees is nice, but visualizing how phylogeny relates to geography can also be done in a more integrated way as demonstrated by the lingtreemaps package. cldfviz.treemap provides a front-end for this package, making it possible to use its functionality with data and trees in CLDF datasets.
cldfviz.audiowordlist
Another case where it is often desirable to aggregate objects from different CLDF components for inspection are Wordlists with associated audio files. Displaying forms for a specified concept together with the audio as HTML page can be done running cldfviz.audiowordlist.
cldfviz.erd
CLDF datasets typically contain multiple, related tables. The most common visualization of such a data model
are "entity-relationship diagrams", i.e. diagramy of the entitty-relationship model
of the dataset. Such a diagram can be created via cldfviz.erd (if a Java runtime is installed).
For details see docs/erd.md.
cldfviz.network
A ParameterNetwork component
was added to CLDF with version 1.3, acknowledging that in datasets like CLICS
a network of parameters (established through colexifications in CLICS) acted as both, output of the
colexification algorithm, but also as input for various cluster methods. Since there are many tools
for network analysis available, the main task for a CLDF-based tool is to convert (filtered) parts
of a ParameterNetwork to a format that can serve as input for other tools. This is what cldfviz.network
does and since Graphviz' DOT format is one of the target
formats supported by cldfviz.network, exploratory analysis is supported by just piping the output
into the dot program to create a network visualization.
Related
Other tools to convert CLDF data to "human-readable" formats: - cldfofflinebrowser - clld
Owner
- Name: Cross-Linguistic Data Formats
- Login: cldf
- Kind: organization
- Website: https://cldf.clld.org
- Repositories: 15
- Profile: https://github.com/cldf
GitHub Events
Total
- Issues event: 2
- Watch event: 1
- Push event: 1
Last Year
- Issues event: 2
- Watch event: 1
- Push event: 1
Committers
Last synced: about 3 years ago
All Time
- Total Commits: 133
- Total Committers: 7
- Avg Commits per committer: 19.0
- Development Distribution Score (DDS): 0.113
Top Committers
| Name | Commits | |
|---|---|---|
| Robert Forkel | x****g@g****m | 118 |
| Florian Matter | f****r@g****m | 7 |
| lingulist | m****t@l****g | 4 |
| Isaac | 3****e@u****m | 1 |
| lingulist | m****t@l****e | 1 |
| Johann-Mattis List | L****t@u****m | 1 |
| Sunkulp Ananthanarayan | s****h@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 8 months ago
All Time
- Total issues: 44
- Total pull requests: 12
- Average time to close issues: about 1 month
- Average time to close pull requests: 7 days
- Total issue authors: 9
- Total pull request authors: 6
- Average comments per issue: 1.73
- Average comments per pull request: 4.0
- Merged pull requests: 12
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 4
- Pull requests: 0
- Average time to close issues: about 1 month
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 0.25
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- xrotwang (34)
- fmatter (3)
- antipodite (1)
- eva-dlce-zenodo (1)
- lemontree210 (1)
- fractaldragonflies (1)
- FredericBlum (1)
- AnnikaTjuka (1)
- Tarotis (1)
Pull Request Authors
- fmatter (6)
- LinguList (2)
- sunmuffin42 (1)
- xrotwang (1)
- johenglisch (1)
- antipodite (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 170 last-month
- Total dependent packages: 4
- Total dependent repositories: 10
- Total versions: 18
- Total maintainers: 2
pypi.org: cldfviz
A cldfbench plugin to create vizualisations of CLDF datasets
- Homepage: https://github.com/cldf/cldfviz
- Documentation: https://cldfviz.readthedocs.io/
- License: Apache 2.0
-
Latest release: 1.3.0
published over 1 year ago
Rankings
Dependencies
- actions/checkout v2 composite
- actions/setup-python v2 composite