Metadata-Version: 2.3
Name: pypendentdrop
Version: 0.0.1.dev8
Summary: Python scripts (GUI and command line) to measure surface tension from images of pendent drops.
Project-URL: Homepage, https://github.com/Moryavendil/pypendentdrop
Project-URL: Issues, https://github.com/Moryavendil/pypendentdrop/issues
Author-email: G2L <GDoubleL@proton.me>
License-File: LICENSE
Keywords: analysis,drop,image,measure,pendant,pendent,surface,tension
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: contourpy
Requires-Dist: pillow
Requires-Dist: scipy
Provides-Extra: cli
Requires-Dist: matplotlib; extra == 'cli'
Provides-Extra: gui
Requires-Dist: pyqt5; extra == 'gui'
Requires-Dist: pyqtgraph; extra == 'gui'
Description-Content-Type: text/markdown

# PyPendentDrop

Python scripts (GUI and/or command line) to measure surface tension from images of pendent drops.

Install with

    pip install pypendentdrop


### Dependencies

All versions of PypendentDrop rely on

* `numpy` (for algebra)
* `pillow` (for image reading)
* `contourpy` (for contour detection)
* `scipy` (for parameters optimization)

Additionnaly, the GUI version relies on

* `pyqtgraph` (fast responsive graphs)
* Any Qt distribution for Python supported by PyQtGraph: `PyQt6`, `PySide6`, `PyQt5` or `PySide2`

The command-line version does not require Qt but relies on `matplotlib` for plotting the results when using the `-o` option.

### Use the GUI version

From a console, run 

    ppd-gui

or

    python -m pypendentdrop.gui

### Use the command-line version

From a console, run 

    ppd-cli

or

    python -m pypendentdrop

Use the `-h` option to list the availables options. If you use the `-o` option (graph generation), ensure that you have matplotlib installed.

to test the module, you can run (from the main directory)

    python -m pypendentdrop -n src/pypendentdrop/tests/testdata/water_2.tif -p 57 -g 9.81 -v


### Without installing

    python3.10 -m src.pypendentdrop.gui
    
    python3.10 -m src.pypendentdrop.tests.findsymmetryangle

if needed: contact me at: `pypendentdrop@protonmail.com`