跳转到主要内容

A cldfbench插件,用于创建CLDF数据集的可视化

项目描述

cldfviz

Build Status PyPI

Python库,提供可视化CLDF数据集的工具。

安装

运行

pip install cldfviz

如果您想创建图像格式的地图(PNG、JPG、PDF),则需要安装cartopy包,它将随以下内容一起安装:

pip install cldfviz[cartopy]

注意:由于cartopy有许多系统级要求,因此安装可能有些棘手。如果出现问题,请参阅https://scitools.org.uk/cartopy/docs/v0.15/installing.html

如果您想创建“树状图”(即使用lingreemaps包处理CLDF数据),您需要通过以下方式安装:

pip install cldfviz[lingtreemaps]

命令行界面

cldfviz作为cldfbench插件实现,即它为cldfbench命令提供子命令。

安装后,您应在运行时看到带有cldfviz.前缀的子命令列表。

cldfbench -h

由CLI提供的帮助有时非常全面,可以通过以下方式查阅

cldfbench <sucommand> -h

例如:

$ cldfbench cldfviz.map -h
usage: cldfbench cldfviz.map [-h] [--download-dir DOWNLOAD_DIR] [--language-filters LANGUAGE_FILTERS]
                             [--glottolog GLOTTOLOG] [--glottolog-version GLOTTOLOG_VERSION]
...

命令

以下为对cldfviz子命令的简要描述;如需更多文档,请点击图片。

示例数据

本文档中的示例有时会使用存储在本地文件系统中的CLDF数据。特别是,我们将使用

  • DOI:WALS在线
  • DOI:作为CLDF数据集的Glottolog
  • DOI:APiCS在线

如果您使用cldfbench插件cldfzenodo下载这些数据集

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

您应该会在本地目录中有相应数据:wals-2020.3/glottolog-cldf-4.7/cldf-datasets-apics-4ed59b5/

cldfviz.map

将CLDF结构数据集中的数据可视化为“地图上的点”,即类似于WALS的地理地图,显示类型学变异,是一种常见的做法。cldfviz.map子命令允许您创建此类地图。详细信息请参阅docs/map.md

details

cldfviz.text

语言数据的一种相对传统的可视化方法是在描述性文本中穿插数据片段,最明显的情况可能是作为格式化为Interlinear Glossed Text的示例。cldfviz.text子命令允许您“渲染”以CLDF markdown编写的文档,即通过插入适当的引用数据表示将此类文档转换为纯markdown格式。详细信息请参阅docs/text.md

details

cldfviz.examples

虽然可以通过cldfviz.textCLDF Markdown中(选择性地)包含IGT格式化的示例,但通常只需查看数据集中所有示例的HTML格式列表就很有用。这可以通过cldfviz.examples来完成。详细信息请参阅docs/examples.md

details

cldfviz.tree

从CLDF 1.2开始,语言系统发育(或分类)树成为了一个“正式”的CLDF组件,并且显然是可视化的合适候选(因为没有人喜欢看Newick格式)。

为了提供可配置的树形图可视化(以SVG格式),cldfviz.tree命令使用强大的toytree包来渲染CLDF树。详细信息请参阅docs/tree.md

details

cldfviz.treemap

显示地图和树形图很棒,但可视化系统发育与地理位置之间的关系也可以通过lingtreemaps包以更集成的方式进行。提供cldfviz.treemap作为该包的前端,使得可以使用CLDF数据集中的数据和树形图来使用其功能。

details

cldfviz.audiowordlist

通常情况下,当需要检查来自不同CLDF组件的对象时,通常会聚合Wordlist及其相关音频文件。运行cldfviz.audiowordlist可以将指定概念的形式与音频一起显示为HTML页面。

details

cldfviz.erd

CLDF数据集通常包含多个相关表格。这种数据模型最常见的表现形式是“实体-关系图”,即数据集的实体-关系模型图。此类图可以通过cldfviz.erd创建(如果已安装Java运行时)。详细信息请参阅docs/erd.md

details

cldfviz.network

从版本1.3开始,CLDF中添加了参数网络组件,承认在类似于CLICS的数据集中,参数网络(通过CLICS中的同义词化建立)既作为同义词化算法的输出,也作为各种聚类方法的输入。由于有许多网络分析工具可用,基于CLDF的工具的主要任务是转换(过滤)ParameterNetwork的部分以供其他工具作为输入。这正是cldfviz.network的功能,并且由于cldfviz.network支持Graphviz的DOT格式之一,通过将输出管道输入到dot程序来创建网络可视化,支持探索性分析。

details

相关

其他将CLDF数据转换为“可读”格式的工具

项目详情


下载文件

下载适用于您平台的应用程序。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分发

cldfviz-1.3.0.tar.gz (1.9 MB 查看哈希值)

上传时间:

构建分发

cldfviz-1.3.0-py2.py3-none-any.whl (1.9 MB 查看哈希值)

上传时间: Python 2 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面