Metadata-Version: 2.4
Name: vector-plot-extractor
Version: 0.1.4
Summary: tools for extracting data from vector plots
Author-email: Yu-Chen Wang <ycwang-astro@users.noreply.github.com>
Project-URL: Homepage, https://github.com/ycwang-astro/vector-plot-extractor
Project-URL: Documentation, https://github.com/ycwang-astro/vector-plot-extractor
Project-URL: Repository, https://github.com/ycwang-astro/vector-plot-extractor.git
Project-URL: Issues, https://github.com/ycwang-astro/vector-plot-extractor/issues
Project-URL: Changelog, https://github.com/ycwang-astro/vector-plot-extractor/blob/main/CHANGELOG.md
Keywords: vector graphic,vector plot,extractor,digitizer
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Intended Audience :: Science/Research
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pymupdf
Dynamic: license-file

# vector-plot-extractor
tools for extracting data from vector plots

[![PyPI version](https://badge.fury.io/py/vector-plot-extractor.svg)](https://badge.fury.io/py/vector-plot-extractor) [![DOI:10.5281/zenodo.10588057](https://zenodo.org/badge/DOI/10.5281/zenodo.10588057.svg)](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.
