:sparkles: upset-alt-txt-gen 
Design experiments for generating semantically meaningful alt-text for UpSet Plots.
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 program with the example data, run python [path/to/alttxt directory] --data ../../data/movie_data_card_sort.json
Level and granularity can be changed to any of the options listed in Command Line Options.
Here is an example command:
For unix/macOS: python3 src/alttxt --data data/movie_data_dev_sort.json
For Windows: python src/alttxt --data data/movie_data_dev_sort.json
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 a combination of all levels. Options are: 1, 2. |
-st, --structured |
Returns information in JSON format that contains structured text (long description), alt-txt (short description), and technical description of the plot making strategy |
-t, --title |
A title for the plot; used in some generations. Defaults to has no title. |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
1 maintainer
Metadata
1 maintainer
Release files for upset-alttxt 0.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| upset-alttxt-0.5.2.tar.gz | 28.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| upset_alttxt-0.5.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.9 kB
Release files / upset-alttxt-0.5.2.tar.gz
| Download URL | upset-alttxt-0.5.2.tar.gz |
|---|---|
| Size | 28.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
79a7279b44a47c5c14015caf2e36589ef976c5920ec0ca44dd996f96e0bc238f
|
|
BLAKE2b-256 checksum How to use checksums |
6f3c804fff6ea3890512d81cb0c439632d1febf110d3f6879c10b95dae3e9bdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / upset_alttxt-0.5.2-py3-none-any.whl
| Download URL | upset_alttxt-0.5.2-py3-none-any.whl |
|---|---|
| Size | 29.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
55178e14983376c19ec4eb7fa3afd4c287b4abc3d595140858faa174eee7bb33
|
|
BLAKE2b-256 checksum How to use checksums |
58a0e48a5befc1ea3c520d3cce766024527d86f852d80ac7783e085f6a2c1bb7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
