pendantdroppy 1.0.4

pendantdroppy - Tensiometry software for droplet shape analysis using Young-Laplace fitting

pendantdroppy - Tensiometry Analysis Software

A PyQt6-based GUI application for analyzing droplet shape using Young-Laplace equation fitting and Bond number calculation.

Installation

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)

From PyPI

pip install pendantdroppy

From Source

# Clone the repository
git clone https://github.com/pendantdroppy/pendantdroppy.git
cd pendantdroppy

# Install in development mode
pip install -e .

# Or install normally
pip install .

Manual Installation

# Install dependencies
pip install opencv-python PyQt6 numpy

# Run the GUI
python droppy.py

Usage

GUI Application

droppy

Or run directly:

python droppy.py

Workflow

1. Select Image - Browse for droplet image (PNG, JPG, etc.)
2. Draw Geometry - Interactive cv2 window to define:
   • ROI (Region of Interest)
   • Needle tip (for diameter calibration)
3. Configure Parameters - Adjust processing and analysis settings across tabs
4. Save Settings - Button to save current configuration to droppy.conf
5. Run Analysis - Click "RUN ANALYSIS"
6. View Results - See overlaid YL curve, plateau points, and extrema

Settings File

Configuration is automatically saved to droppy.conf.

On startup, the program loads from this file if it exists, otherwise uses defaults.

Example droppy.conf:

{
  "droplet_type": "rising",
  "needle_diameter_mm": 0.72,
  "sigma": 2.0,
  "canny1": 40,
  "canny2": 120,
  "plateau_width": 100,
  "lensing_factor": 1.0,
  "low_clarity_ratio": 0.1,
  "high_clarity_ratio": 0.01
}

Output Files

Analysis generates:

• result_yl_overlay.png - Young-Laplace curve fitted to droplet
• edges.png - Edge detection result
• summary.json - Numerical results (Bond numbers, calibration)

Parameters Explained

Image Processing

• Blur Sigma - Gaussian blur level for edge detection resolution
• Canny Low/High - Edge detection thresholds

Contour Analysis

• Num Points - Number of contour points to sample
• Direction - Traversal direction (+1 or -1)
• Min r', z' - Minimum thresholds to avoid numerical blowup

Analysis

• Plateau Width - Number of points centered on equator with lowest variance
• Lensing Factor - Optical correction (1.0 = no correction, <1 = correnting horizontal stretching, >1 = correcting vertical stretching)
• Clarity Ratios - Fractions of points used for low/high clarity image smoothing
• Bo Wiggle Room - Expansion of Bond number search range from pointwise estimates

Troubleshooting

"No contours found" - Adjust Canny thresholds or sigma

"Bo ~0 for rising droplets" - Ensure plateau is centered on equator, edit sigma, or redraw needle line, it honestly can be pixels in it.

Config not loading - Check droppy.conf is valid JSON in output directory

"The YL curve is visually off" - Use an image with sharp edges and a known IFT for your setup, keep all settings standard and adjust lensing factor until it fits. Use that lensing factor for all the other runs with your setup. If you are already doing that, increase sigma until it aligns.

More detailed manuals in the works :) open issue if help is needed.

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

Support

For issues, feature requests, or questions:

• Open an issue on GitHub
• Check existing documentation
• Review analysis parameters

Acknowledgments

Inspired by Krystyna Prochaska's work in interfacial tensiometry and absorption.