# vector-plot-extractor
tools for extracting data from vector plots
[](https://badge.fury.io/py/vector-plot-extractor) [](https://zenodo.org/doi/10.5281/zenodo.10588057)
This Python package has been tested on various PDF files, including [example.pdf](examples/example.pdf), under normal usage conditions. However, it has not undergone comprehensive testing and optimization yet. I will improve it in the future. Your suggestions and contributions are welcome.
A step-by-step [tutorial](docs/tutorial-en.md) is provided to demonstrate typical usage of the tool.
<!--**Notes: For those concerned about extraction accuracy, see the [error report](docs/Error_analysis.ipynb) for reference.**-->
## Dependencies
This package mainly depends on the following packages:
- matplotlib
- numpy
- pymupdf
These will be automatically installed when running `pip install`.
## Installation
To install this package, you can simply use `pip`:
```
pip install vector-plot-extractor
```
If you would like to try the latest development version, you may directly install from the project repository by:
```
pip install git+https://github.com/ycwang-astro/vector-plot-extractor.git
```
## Usage
To execute the main UI, run this in your terminal
```
vpextract path/to/figure/file
```
To import this package in a Python script:
```Python
import vpextractor
```
## Limitations/caveats
It can be tricky to decide the underlying data for scatter plots. For some markers, there can be systematic errors (within the size of the markers) in the extracted data. A future version will add a UI with which you may manually select the relative position of data points for each marker.
**It is at your discretion to verify the accuracy of the output results!**
## Notice
A bug in version 0.1.1 causes minor errors in the extracted scatter data. If you have used 0.1.1 version, follow the steps in the [changelog](CHANGELOG.md#012) ("Notes" under "0.1.2") to fix it.
Raw data
{
"_id": null,
"home_page": null,
"name": "vector-plot-extractor",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "vector graphic, vector plot, extractor, digitizer",
"author": null,
"author_email": "Yu-Chen Wang <ycwang-astro@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/9d/0a/17ee71d050a4c8dcf0d20921f4c94f49e9b01354affacda631af8ee6c33a/vector_plot_extractor-0.1.4.tar.gz",
"platform": null,
"description": "# vector-plot-extractor\ntools for extracting data from vector plots\n\n[](https://badge.fury.io/py/vector-plot-extractor) [](https://zenodo.org/doi/10.5281/zenodo.10588057)\n\nThis Python package has been tested on various PDF files, including [example.pdf](examples/example.pdf), under normal usage conditions. However, it has not undergone comprehensive testing and optimization yet. I will improve it in the future. Your suggestions and contributions are welcome.\n\nA step-by-step [tutorial](docs/tutorial-en.md) is provided to demonstrate typical usage of the tool.\n\n<!--**Notes: For those concerned about extraction accuracy, see the [error report](docs/Error_analysis.ipynb) for reference.**-->\n\n## Dependencies\nThis package mainly depends on the following packages:\n- matplotlib\n- numpy\n- pymupdf\n\nThese will be automatically installed when running `pip install`.\n\n## Installation\nTo install this package, you can simply use `pip`:\n```\npip install vector-plot-extractor\n```\n\nIf you would like to try the latest development version, you may directly install from the project repository by:\n```\npip install git+https://github.com/ycwang-astro/vector-plot-extractor.git\n```\n\n## Usage\nTo execute the main UI, run this in your terminal\n```\nvpextract path/to/figure/file\n```\nTo import this package in a Python script:\n```Python\nimport vpextractor\n```\n\n## Limitations/caveats\nIt can be tricky to decide the underlying data for scatter plots. For some markers, there can be systematic errors (within the size of the markers) in the extracted data. A future version will add a UI with which you may manually select the relative position of data points for each marker.\n\n**It is at your discretion to verify the accuracy of the output results!**\n\n## Notice\nA bug in version 0.1.1 causes minor errors in the extracted scatter data. If you have used 0.1.1 version, follow the steps in the [changelog](CHANGELOG.md#012) (\"Notes\" under \"0.1.2\") to fix it.\n",
"bugtrack_url": null,
"license": null,
"summary": "tools for extracting data from vector plots",
"version": "0.1.4",
"project_urls": {
"Changelog": "https://github.com/ycwang-astro/vector-plot-extractor/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/ycwang-astro/vector-plot-extractor",
"Homepage": "https://github.com/ycwang-astro/vector-plot-extractor",
"Issues": "https://github.com/ycwang-astro/vector-plot-extractor/issues",
"Repository": "https://github.com/ycwang-astro/vector-plot-extractor.git"
},
"split_keywords": [
"vector graphic",
" vector plot",
" extractor",
" digitizer"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "41339b4dc404558efe6f3c681221f84fb1bbfc8938b5e0a7c5afe852b1b94920",
"md5": "ac57f5f58c878e67ca1d42f80ebb1f2d",
"sha256": "b5076dea56ebf264b23e8ccee8c4df97b21d5136b1d3de6793a7111006240449"
},
"downloads": -1,
"filename": "vector_plot_extractor-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ac57f5f58c878e67ca1d42f80ebb1f2d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 35858,
"upload_time": "2025-07-20T09:09:33",
"upload_time_iso_8601": "2025-07-20T09:09:33.776676Z",
"url": "https://files.pythonhosted.org/packages/41/33/9b4dc404558efe6f3c681221f84fb1bbfc8938b5e0a7c5afe852b1b94920/vector_plot_extractor-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9d0a17ee71d050a4c8dcf0d20921f4c94f49e9b01354affacda631af8ee6c33a",
"md5": "08ce5c31c681600347fa8fd4674fad50",
"sha256": "e1e1223b9fe854936aeb4478339f5ca5fcebe2282d2f4540073677c11b8003cd"
},
"downloads": -1,
"filename": "vector_plot_extractor-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "08ce5c31c681600347fa8fd4674fad50",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 32244,
"upload_time": "2025-07-20T09:09:35",
"upload_time_iso_8601": "2025-07-20T09:09:35.322740Z",
"url": "https://files.pythonhosted.org/packages/9d/0a/17ee71d050a4c8dcf0d20921f4c94f49e9b01354affacda631af8ee6c33a/vector_plot_extractor-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-20 09:09:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ycwang-astro",
"github_project": "vector-plot-extractor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "vector-plot-extractor"
}
JSON
