معرفی شرکت ها
cldfviz-0.9.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A cldfbench plugin to create vizualisations of CLDF datasets
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cldfviz-0.9.0 |
| نام | cldfviz |
| نسخه کتابخانه | 0.9.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Robert Forkel |
| ایمیل نویسنده | dlce.rdm@eva.mpg.de |
| آدرس صفحه اصلی | https://github.com/cldf/cldfviz |
| آدرس اینترنتی | https://pypi.org/project/cldfviz/ |
| مجوز | Apache 2.0 |
# cldfviz
[](https://github.com/cldf/cldfviz/actions?query=workflow%3Atests)
[](https://pypi.org/project/cldfviz)
Python library providing tools to visualize [CLDF](https://cldf.clld.org) 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](https://lingtreemaps.readthedocs.io/en/latest/?badge=latest)
package for CLDF data), you need to install via
```shell
pip install cldfviz[lingtreemaps]
```
## CLI
`cldfviz` is implemented as [`cldfbench`](https://github.com/cldf/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
- [](https://doi.org/10.5281/zenodo.7385533): WALS Online
- [](https://doi.org/10.5281/zenodo.7398887): Glottolog as CLDF dataset
- [](https://doi.org/10.5281/zenodo.7139937): APiCS Online
If you download these datasets using the `cldfbench` plugin [cldfzenodo](https://github.com/cldf/cldfzenodo/#cli)
```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](https://wals.info)-like geographic maps, displaying typological variation.
The `cldfviz.map` subcommand allows you to create such maps. For details see [docs/map.md](docs/map.md).
> [<img alt="details" width="350" src="docs/output/wals_10B.png" />](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 **I**nterlinear **G**lossed **T**ext.
The `cldfviz.text` subcommand allows you "render" documents written in [CLDF markdown](https://github.com/cldf/cldf/blob/master/extensions/markdown.md), i.e. converting
such documents to plain markdown by inserting suitable representations of the referenced data.
For details see [docs/text.md](docs/text.md).
> [<img alt="details" width="350" src="docs/output/wals_exponence.png" />](docs/text.md)
### `cldfviz.examples`
While it is possible to (selectively) include IGT formatted examples in [CLDF Markdown](https://github.com/cldf/cldf/blob/master/extensions/markdown.md) 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](docs/examples.md).
> [<img alt="details" width="350" src="docs/output/lgr_html.png" />](docs/examples.md)
### `cldfviz.tree`
Phylogenetic (or classification) trees of languages are a "proper" [CLDF component](https://github.com/cldf/cldf/tree/master/components/trees)
since CLDF 1.2 - and an obvious candidate for visualization (because noone likes to look at [Newick](https://en.wikipedia.org/wiki/Newick_format)).
To provide a configurable visualization of trees in [SVG format](https://en.wikipedia.org/wiki/SVG), the
`cldfviz.tree` command renders CLDF trees using the powerful [toytree](https://toytree.readthedocs.io/en/latest/)
package. For details see [docs/tree.md](docs/tree.md).
> [<img alt="details" width="350" src="docs/output/wals-omotic.svg" />](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](https://lingtreemaps.readthedocs.io/en/latest/examples.html)
package. [cldfviz.treemap](docs/treemap.md) provides a front-end for this package, making it possible
to use its functionality with data and trees in CLDF datasets.
> [<img alt="details" width="350" src="docs/output/treemap_wals88A.svg" />](docs/treemap.md)
### `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](docs/audiowordlist.md).
> [<img alt="details" width="350" src="docs/output/awl_hindukush.png" />](docs/audiowordlist.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](https://en.wikipedia.org/wiki/Entity%E2%80%93relationship_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](docs/erd.md).
> [<img alt="details" width="350" src="docs/output/wacl.svg" />](docs/erd.md)
## Related
Other tools to convert CLDF data to "human-readable" formats:
- [cldfofflinebrowser](https://github.com/cldf/cldfofflinebrowser)
- [clld](https://github.com/clld/clld)
نیازمندی
| مقدار | نام |
|---|---|
| - | attrs |
| >=1.11.0 | cldfbench |
| >=3.17 | clldutils |
| - | jinja2 |
| - | matplotlib |
| >=1.6 | newick |
| - | numpy |
| >=1.32.0 | pycldf |
| - | pyglottolog |
| - | termcolor |
| >=2.0.1 | toytree |
| - | tqdm |
| - | cartopy |
| - | scipy |
| - | shapely |
| - | build |
| - | flake8 |
| - | twine |
| - | wheel |
| - | biopython |
| - | lingtreemaps |
| - | pandas |
| - | pyyaml |
| - | shapely |
| >=4.2 | coverage |
| - | pytest-cov |
| - | pytest-mock |
| >=5 | pytest |
| - | requests-mock |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7 | Python |
نحوه نصب
نصب پکیج whl cldfviz-0.9.0:
pip install cldfviz-0.9.0.whl
نصب پکیج tar.gz cldfviz-0.9.0:
pip install cldfviz-0.9.0.tar.gz