cldfviz 0.10.0

A cldfbench plugin to create vizualisations of CLDF datasets

cldfviz

Python library providing tools to visualize CLDF datasets.

Install

Run

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

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.

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

cldfbench -h

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.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/text.md.