Package: cldfviz
cldfvizPython library providing tools to visualizeCLDFdatasets.InstallRunpipinstallcldfvizIf you want to create maps in image formats (PNG, JPG, PDF), thecartopypackage is needed,
which will be installed withpipinstallcldfviz[cartopy]Note: Sincecartopyhas quite a few system-level requirements, installation may be somewhat tricky. Should
problems arise,https://scitools.org.uk/cartopy/docs/v0.15/installing.htmlmay help.If you want to create "treemaps" (i.e. use thelingreemapspackage for CLDF data), you need to install viapipinstallcldfviz[lingtreemaps]CLIcldfvizis implemented ascldfbenchplugin, i.e. it provides subcommands for thecldfbenchcommand.After installation you should see subcommands with acldfviz.prefix
listed when runningcldfbench-hHelp provided by the CLI is sometimes extensive and can be consulted viacldfbench<sucommand>-he.g.$cldfbenchcldfviz.map-h
usage:cldfbenchcldfviz.map[-h][--download-dirDOWNLOAD_DIR][--language-filtersLANGUAGE_FILTERS][--glottologGLOTTOLOG][--glottolog-versionGLOTTOLOG_VERSION]...CommandsA short description of thecldfvizsubcommands can be found below; for more documentation click on the images.Example dataExamples in this documentation sometimes use CLDF data stored in the local filesystem.
In particular, we'll use: WALS Online: Glottolog as CLDF dataset: APiCS OnlineIf you download these datasets using thecldfbenchplugincldfzenodocldfbenchzenodo.download10.5281/zenodo.7385533--full-deposit
cldfbenchzenodo.download10.5281/zenodo.7398887--full-deposit
cldfbenchzenodo.download10.5281/zenodo.7139937--full-deposityou should have the respective data in local directorieswals-2020.3/,glottolog-cldf-4.7/andcldf-datasets-apics-4ed59b5/.cldfviz.mapA common way to visualize data from a CLDF StructureDataset is as "dots on a map",
i.e. asWALS-like geographic maps, displaying typological variation.
Thecldfviz.mapsubcommand allows you to create such maps. For details seedocs/map.md.cldfviz.textA rather traditional visualization of linguistic data is the practice of interspersing bits of data
in descriptive texts, most obviously perhaps as examples formatted asInterlinearGlossedText.
Thecldfviz.textsubcommand allows you "render" documents written inCLDF markdown, i.e. converting
such documents to plain markdown by inserting suitable representations of the referenced data.
For details seedocs/text.md.cldfviz.examplesWhile it is possible to (selectively) include IGT formatted examples inCLDF Markdownviacldfviz.text,
often it is useful to just look at an HTML formatted list of all examples from a dataset. This can
be done viacldfviz.examples. For details seedocs/examples.md.cldfviz.treePhylogenetic (or classification) trees of languages are a "proper"CLDF componentsince CLDF 1.2 - and an obvious candidate for visualization (because noone likes to look atNewick).To provide a configurable visualization of trees inSVG format, thecldfviz.treecommand renders CLDF trees using the powerfultoytreepackage. For details seedocs/tree.md.cldfviz.treemapDisplaying maps and trees is nice, but visualizing how phylogeny relates to geography can also be done
in a more integrated way as demonstrated by thelingtreemapspackage.cldfviz.treemapprovides a front-end for this package, making it possible
to use its functionality with data and trees in CLDF datasets.cldfviz.audiowordlistAnother 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 runningcldfviz.audiowordlist.cldfviz.erdCLDF datasets typically contain multiple, related tables. The most common visualization of such a data model
are "entity-relationship diagrams", i.e. diagramy of theentitty-relationship modelof the dataset. Such a diagram can be created viacldfviz.erd(if a Java runtime is installed).
For details seedocs/erd.md.RelatedOther tools to convert CLDF data to "human-readable" formats:cldfofflinebrowserclld