| Name | upset-alttxt JSON |
| Version |
0.5.0
JSON |
| download |
| home_page | None |
| Summary | Generates alt text for UpSet plots |
| upload_time | 2025-01-29 19:00:20 |
| maintainer | None |
| docs_url | None |
| author | Visualization Design Lab |
| requires_python | >=3.8 |
| license | BSD3 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# :sparkles: upset-alt-txt-gen 
Design experiments for generating semantically meaningful alt-text for UpSet Plots.
## Local Deployment
1. Clone the repository using `git clone` or download and extract the zip file.
2. Ensure you have python version >= 3.8.10 installed.
3. 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](https://docs.python.org/3/library/venv.html).
4. Install the required dependencies using `pip install -r requirements.txt`.
5. (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.
6. 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](#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-black` standards, run `tox -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`. |
|------------------------| -------------------------------------------------------------------------------------------------|
Raw data
{
"_id": null,
"home_page": null,
"name": "upset-alttxt",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Visualization Design Lab",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c7/2c/0c29492c661f3b92032feebab6b3e90d7a3409aa5f867a5c4777a50554cf/upset-alttxt-0.5.0.tar.gz",
"platform": "unix",
"description": "# :sparkles: upset-alt-txt-gen \nDesign experiments for generating semantically meaningful alt-text for UpSet Plots.\n\n## Local Deployment\n\n1. Clone the repository using `git clone` or download and extract the zip file.\n2. Ensure you have python version >= 3.8.10 installed.\n3. 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](https://docs.python.org/3/library/venv.html).\n4. Install the required dependencies using `pip install -r requirements.txt`.\n5. (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.\n6. Install the alttxt module in development mode with `pip install -e .`\n\n\nTo run the program with the example data, run `python [path/to/alttxt directory] --data ../../data/movie_data_card_sort.json`\nLevel and granularity can be changed to any of the options listed in [Command Line Options](#command-line-options).\nHere is an example command:\n For unix/macOS: `python3 src/alttxt --data data/movie_data_dev_sort.json`\n For Windows: `python src/alttxt --data data/movie_data_dev_sort.json`\n\n## Local Testing\n\nLocal 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.\n\n- Linting: To run the linting tests, run `tox -e lint`\n- Type: To run the type tests, run `tox -e type`\n- Tests: To run the python tests, run `tox -e test`\n- Formatting: To automatically format the files to match the `flake8-black` standards, run `tox -e format`\n\nTo run the entire suite of tests at once, use `tox`.\n\n## Command Line Options\n\n| Command | Description |\n|------------------------|-------------------------------------------------------------------------------------------------|\n| `-h`, `--help` | Show information on each command and exit. |\n| `-V`, `--version` | Show the program version number and exit. |\n| `-D`, `--data` | (Required) Relative path to data file. |\n| `-l`, `--level` | Semantic level. Defaults to a combination of all levels. Options are: `1`, `2`. |\n| `-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 |\n| `-t`, `--title` | A title for the plot; used in some generations. Defaults to `has no title`. |\n|------------------------| -------------------------------------------------------------------------------------------------| \n",
"bugtrack_url": null,
"license": "BSD3",
"summary": "Generates alt text for UpSet plots",
"version": "0.5.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1925894751e929d01b93c6aa766998a4d7f1aa2a8fca60339eafa412edb1c3cc",
"md5": "a3d4c55d411e6beb38a3dfcaffdbbe3a",
"sha256": "2ee6bc49672df9ba7c94a1630320231591134229c03a7d0f82aa03cf736964d3"
},
"downloads": -1,
"filename": "upset_alttxt-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a3d4c55d411e6beb38a3dfcaffdbbe3a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 28232,
"upload_time": "2025-01-29T19:00:18",
"upload_time_iso_8601": "2025-01-29T19:00:18.451417Z",
"url": "https://files.pythonhosted.org/packages/19/25/894751e929d01b93c6aa766998a4d7f1aa2a8fca60339eafa412edb1c3cc/upset_alttxt-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c72c0c29492c661f3b92032feebab6b3e90d7a3409aa5f867a5c4777a50554cf",
"md5": "91cf0c047e2295317da4d8d626ccb5ad",
"sha256": "dd8f2489bcf243e716c99751926531e474c08fccb7544a8e8e55666feb0e8def"
},
"downloads": -1,
"filename": "upset-alttxt-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "91cf0c047e2295317da4d8d626ccb5ad",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 27611,
"upload_time": "2025-01-29T19:00:20",
"upload_time_iso_8601": "2025-01-29T19:00:20.529126Z",
"url": "https://files.pythonhosted.org/packages/c7/2c/0c29492c661f3b92032feebab6b3e90d7a3409aa5f867a5c4777a50554cf/upset-alttxt-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-29 19:00:20",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "upset-alttxt"
}
