Generates alt text for UpSet plots
Project description
:sparkles: upset-alt-txt-gen 
Design experiments for generating semantically meaningful alt-text. This work is adapted from:
Alan Lundgard AND Arvind Satyanarayan (2022). Accessible Visualization via
Natural Language Descriptions: A Four-Level Model of Semantic Content. IEEE
Transactions on Visualization & Computer Graphics (Proc. IEEE VIS).
Local Deployment
- Clone the repository using
git cloneor download and extract the zip file. - Ensure you have python version >= 3.8.10 installed.
- Open a terminal in the repository directory and create and activate a python virtual environment running at least Python 3.8.10. For information on how to do this, navigate here.
- Install the required dependencies using
pip install -r requirements.txt. - (Optional) Install the required development dependencies using
pip install -r requirements-dev.txt. These are only required if you plan on running the tests or linting. - Install the alttxt module in development mode with
pip install -e .
To run the alt-text-gen program, run python3 [path/to/generator.py] --data [path/to/data] --grammar [path/to/grammar]. See Command Line Options for more information.
To run the program with the example data, run python [path/to/alttxt directory] --data ../../data/movie_data_card_sort.json --level 2 --verbosity medium while in the src/alttxt directory.
Level and granularity can be changed to any of the options listed in Command Line Options.
Local Testing
Local testing can be done using the tox command. Tests have not been updated to match the latest updates to the repository, and updating them is currently on hold, as deployment is a priority over robustness.
- Linting: To run the linting tests, run
tox -e lint - Type: To run the type tests, run
tox -e type - Tests: To run the python tests, run
tox -e test - Formatting: To automatically format the files to match the
flake8-blackstandards, runtox -e format
To run the entire suite of tests at once, use tox.
Command Line Options
| Command | Description |
|---|---|
-h, --help |
Show information on each command and exit. |
-V, --version |
Show the program version number and exit. |
-D, --data |
(Required) Relative path to data file. |
-l, --level |
Semantic level. Defaults to 1. Options are: 0, 1, and 2. 3 TBA. |
-v, --verbosity |
Alt-text verbosity. Defaults to medium. Options: low, medium, high. |
-e, --explain-upset |
Whether to explain UpSet plots generally. Defaults to none. Options: none, simple, full. |
-t, --title |
A title for the plot; used in some generations. Defaults to has no title. |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file upset-alttxt-0.1.8.tar.gz.
File metadata
- Download URL: upset-alttxt-0.1.8.tar.gz
- Upload date:
- Size: 16.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8ee91ae28e578cf6a961ed2a5aa0154934826af37182ad4682f58b1d6be8b299 |
|
| MD5 | c4dc8230ed30a1f6499cab1db7b25284 |
|
| BLAKE2b-256 | 6d3da47ea2dabb94d46ec9c14d2a38470bca0ef5e35899cdcf02ce8921f48289 |
File details
Details for the file upset_alttxt-0.1.8-py3-none-any.whl.
File metadata
- Download URL: upset_alttxt-0.1.8-py3-none-any.whl
- Upload date:
- Size: 16.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1a591f93d71ee0c320eb40b411c88f817a157782cc1c05e066c6aca73d3766b7 |
|
| MD5 | 18ccf89fcf1928ffee039cf7b872e474 |
|
| BLAKE2b-256 | b4c5aecc6d1ee07333f0132af8e713a960f1efb626b44d3eeba4e508b22589ae |
