| Name | upset-alttxt JSON |
| Version |
0.4.9
JSON |
| download |
| home_page | None |
| Summary | Generates alt text for UpSet plots |
| upload_time | 2024-12-19 19:27:27 |
| 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/a3/e7/f93d72811496bb35e3466107f7b3073e17828d02df0a177d4f6c86d22e99/upset-alttxt-0.4.9.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.4.9",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d36058e0aa2bd56f82c0de1ae79fa8bf273576de611dddf7799736839368ae4",
"md5": "5692cec04fd93eef9b0681e9e37d0ca3",
"sha256": "4865fc8741fc3e3dfbcc1e00e5017b7ca1815365807094069b1eabaf53a6c7ba"
},
"downloads": -1,
"filename": "upset_alttxt-0.4.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5692cec04fd93eef9b0681e9e37d0ca3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 28226,
"upload_time": "2024-12-19T19:27:25",
"upload_time_iso_8601": "2024-12-19T19:27:25.781903Z",
"url": "https://files.pythonhosted.org/packages/4d/36/058e0aa2bd56f82c0de1ae79fa8bf273576de611dddf7799736839368ae4/upset_alttxt-0.4.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a3e7f93d72811496bb35e3466107f7b3073e17828d02df0a177d4f6c86d22e99",
"md5": "ac323aaf4c00c3edd87bbac09cba5421",
"sha256": "0aa49707e197bef70093fc6fcec15e751ea442668f365411b3e436b4c259f622"
},
"downloads": -1,
"filename": "upset-alttxt-0.4.9.tar.gz",
"has_sig": false,
"md5_digest": "ac323aaf4c00c3edd87bbac09cba5421",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 27597,
"upload_time": "2024-12-19T19:27:27",
"upload_time_iso_8601": "2024-12-19T19:27:27.758472Z",
"url": "https://files.pythonhosted.org/packages/a3/e7/f93d72811496bb35e3466107f7b3073e17828d02df0a177d4f6c86d22e99/upset-alttxt-0.4.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-19 19:27:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "upset-alttxt"
}
