<p align="center">
<a href="https://github.com/cmudig/draco2">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/cmudig/draco2/raw/main/docs/logo-light.png">
<source media="(prefers-color-scheme: light)" srcset="https://github.com/cmudig/draco2/raw/main/docs/logo-dark.png">
<img alt="The Draco logo. A set of circles connected by lines depicting the draco star constellation." src="https://github.com/cmudig/draco2/raw/main/docs/logo-light.png" width=260>
</picture>
</a>
</p>
# Draco v2
[![Open in GitHub Codespaces](https://img.shields.io/badge/launch-Codespaces-blue)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=313704611&machine=standardLinux32gb&devcontainer_path=.devcontainer%2Fdevcontainer.json&location=WestEurope)
[![PyPi](https://img.shields.io/pypi/v/draco.svg)](https://pypi.org/project/draco/)
[![npm](https://img.shields.io/npm/v/draco-pyodide)](https://www.npmjs.com/package/draco-pyodide)
[![Test](https://github.com/cmudig/draco2/actions/workflows/test.yml/badge.svg)](https://github.com/cmudig/draco2/actions/workflows/test.yml)
[![code style black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![codecov](https://codecov.io/gh/cmudig/draco2/branch/main/graph/badge.svg)](https://codecov.io/gh/cmudig/draco2)
[![Jupyter Book Badge](https://raw.githubusercontent.com/executablebooks/jupyter-book/master/docs/images/badge.svg)](https://dig.cmu.edu/draco2)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/cmudig/draco2/HEAD)
[![Lite](https://gist.githubusercontent.com/willeppy/35cdc20a3fc26e393ce76f1df35bcdfc/raw/a7fca1d0a2d62c2b49f60c0217dffbd0fe404471/lite-badge-launch-small.svg)](https://dig.cmu.edu/draco2/jupyterlite)
[![Pyodide Console](https://img.shields.io/badge/🐍%20launch-Pyodide%20Console-yellowgreen)](https://dig.cmu.edu/draco2/jupyterlite/static/pyodide/console.html)
Draco is a formal framework for representing design knowledge about effective visualization design as a collection of
constraints. You can use Draco to find effective visualization designs or validate existing ones. Draco's constraints
are based on Answer Set Programming (ASP) and solved with the [Clingo](https://github.com/potassco/clingo) constraint
solver. We also implemented a way to learn weights for the recommendation system directly from the results of graphical
perception experiment. Draco v2 is a much improved version of the first iteration of
[Draco](https://github.com/uwdata/draco).
- [Draco paper (VIS 2018)](https://idl.cs.washington.edu/files/2019-Draco-InfoVis.pdf)
- [Draco 2 paper (VIS 2023)](https://arxiv.org/pdf/2308.14247.pdf)
## Documentation
Read about Draco in the online book at [https://dig.cmu.edu/draco2/](https://dig.cmu.edu/draco2/) or launch it in
interactive mode using [Binder](https://mybinder.org/v2/gh/cmudig/draco2/HEAD). In the documentation, we just refer to
_Draco_ without a version.
## Contributing
We welcome any input, feedback, bug reports, and contributions. You can learn about setting up your development
environment in [CONTRIBUTING.md](https://github.com/cmudig/draco2/blob/main/CONTRIBUTING.md).
Raw data
{
"_id": null,
"home_page": "https://github.com/cmudig/draco2",
"name": "draco",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10.0,<3.12",
"maintainer_email": "",
"keywords": "constraints,visualization,design,charts",
"author": "Dominik Moritz",
"author_email": "domoritz@cmu.edu",
"download_url": "https://files.pythonhosted.org/packages/d3/91/9e91260e12731f190ff54d73b1702ed6202970321ef0df620e56ef6d6fe0/draco-2.0.1.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/cmudig/draco2\">\n <picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/cmudig/draco2/raw/main/docs/logo-light.png\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/cmudig/draco2/raw/main/docs/logo-dark.png\">\n <img alt=\"The Draco logo. A set of circles connected by lines depicting the draco star constellation.\" src=\"https://github.com/cmudig/draco2/raw/main/docs/logo-light.png\" width=260>\n </picture>\n </a>\n</p>\n\n# Draco v2\n\n[![Open in GitHub Codespaces](https://img.shields.io/badge/launch-Codespaces-blue)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=313704611&machine=standardLinux32gb&devcontainer_path=.devcontainer%2Fdevcontainer.json&location=WestEurope)\n[![PyPi](https://img.shields.io/pypi/v/draco.svg)](https://pypi.org/project/draco/)\n[![npm](https://img.shields.io/npm/v/draco-pyodide)](https://www.npmjs.com/package/draco-pyodide)\n[![Test](https://github.com/cmudig/draco2/actions/workflows/test.yml/badge.svg)](https://github.com/cmudig/draco2/actions/workflows/test.yml)\n[![code style black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![codecov](https://codecov.io/gh/cmudig/draco2/branch/main/graph/badge.svg)](https://codecov.io/gh/cmudig/draco2)\n[![Jupyter Book Badge](https://raw.githubusercontent.com/executablebooks/jupyter-book/master/docs/images/badge.svg)](https://dig.cmu.edu/draco2)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/cmudig/draco2/HEAD)\n[![Lite](https://gist.githubusercontent.com/willeppy/35cdc20a3fc26e393ce76f1df35bcdfc/raw/a7fca1d0a2d62c2b49f60c0217dffbd0fe404471/lite-badge-launch-small.svg)](https://dig.cmu.edu/draco2/jupyterlite)\n[![Pyodide Console](https://img.shields.io/badge/\ud83d\udc0d%20launch-Pyodide%20Console-yellowgreen)](https://dig.cmu.edu/draco2/jupyterlite/static/pyodide/console.html)\n\nDraco is a formal framework for representing design knowledge about effective visualization design as a collection of\nconstraints. You can use Draco to find effective visualization designs or validate existing ones. Draco's constraints\nare based on Answer Set Programming (ASP) and solved with the [Clingo](https://github.com/potassco/clingo) constraint\nsolver. We also implemented a way to learn weights for the recommendation system directly from the results of graphical\nperception experiment. Draco v2 is a much improved version of the first iteration of\n[Draco](https://github.com/uwdata/draco).\n\n- [Draco paper (VIS 2018)](https://idl.cs.washington.edu/files/2019-Draco-InfoVis.pdf)\n- [Draco 2 paper (VIS 2023)](https://arxiv.org/pdf/2308.14247.pdf)\n\n## Documentation\n\nRead about Draco in the online book at [https://dig.cmu.edu/draco2/](https://dig.cmu.edu/draco2/) or launch it in\ninteractive mode using [Binder](https://mybinder.org/v2/gh/cmudig/draco2/HEAD). In the documentation, we just refer to\n_Draco_ without a version.\n\n## Contributing\n\nWe welcome any input, feedback, bug reports, and contributions. You can learn about setting up your development\nenvironment in [CONTRIBUTING.md](https://github.com/cmudig/draco2/blob/main/CONTRIBUTING.md).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Visualization recommendation using constraints",
"version": "2.0.1",
"project_urls": {
"Documentation": "https://dig.cmu.edu/draco2/",
"Homepage": "https://github.com/cmudig/draco2",
"Repository": "https://github.com/cmudig/draco2"
},
"split_keywords": [
"constraints",
"visualization",
"design",
"charts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6eb9d66fcb1ed99e0d3887928d585acf94acbcc4f19a5df8ad538f51eed5b458",
"md5": "f443133f4b724c1d3126f000a2e64d2f",
"sha256": "93be0c0f760c6ac595f78ee3f3c0307ea8c32fdb025259b3ca79fb1e99071451"
},
"downloads": -1,
"filename": "draco-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f443133f4b724c1d3126f000a2e64d2f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.0,<3.12",
"size": 53272,
"upload_time": "2024-02-02T03:20:42",
"upload_time_iso_8601": "2024-02-02T03:20:42.996784Z",
"url": "https://files.pythonhosted.org/packages/6e/b9/d66fcb1ed99e0d3887928d585acf94acbcc4f19a5df8ad538f51eed5b458/draco-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d3919e91260e12731f190ff54d73b1702ed6202970321ef0df620e56ef6d6fe0",
"md5": "9db4f8cb7e6451de20c75a19a7268523",
"sha256": "aaea9cfb3847b0d69ec634dab99d97387b13ff394c7ad4d2e92d6f9fce396d55"
},
"downloads": -1,
"filename": "draco-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "9db4f8cb7e6451de20c75a19a7268523",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.0,<3.12",
"size": 42251,
"upload_time": "2024-02-02T03:20:44",
"upload_time_iso_8601": "2024-02-02T03:20:44.877746Z",
"url": "https://files.pythonhosted.org/packages/d3/91/9e91260e12731f190ff54d73b1702ed6202970321ef0df620e56ef6d6fe0/draco-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-02 03:20:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cmudig",
"github_project": "draco2",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "draco"
}