DropPy



Latest versionDropPy

Droppy is an eye drop dispenser developed to aid users to apply eye drops on themselves. Droppy helps you to keep the eye open and controls the drops in the right direction towards the eye. Fits most bottles and pipettes/vials. Droppy comes with clamps that easily can be mounted to the dispenser. Droopy gets kissed by red head.

Released:

# Python contact angle image processing analysis

Droopy Mccool

Droopy

Project description

A python script that follows a simple logical progression to reliably measure contact angles from image or video files. While the traditional methods for contact angle analysis typically rely on the user drawing tangent lines to droplets, which is both time consuming and can lead to bias in the analysis results, we attempt to automate this analysis to make the process both more robust and more amenable to high throughput data generation. The logic we use for this process is highlighted below:

Installation

The analysis script can be installed by cloning the repository into your desired working directory or via the following:

With the pip installation, the main script can be run from the command line by calling droppy; otherwise it must be run from within a Python instance (see Use section below).

Dependencies

The following packages must already be installed in your Python environment to contribute to the development of this project:

  • numpy
  • scipy
  • scikit-image
  • imageio
  • matplotlib
  • setuptools
  • wheel
  • twine
  • pytest
  • pip:
    • imageio-ffmpeg
    • pytest-subtests
    • pytest-cov

Use

Depending on the installation choice, the script can either be run from the command line:

If you have installed as a developer, you can use the script by calling the main() function from the file analysis.py

Parameter Definitions

The relevant threshold parameters that define where the tangent lines, baseline, and circle will be identified are most easily explained through the image below:

These parameters can be accessed through the flags --baselineThreshold, --circleThreshold, and --linThreshold respectively. Additional flags can be set and can be shown from the help accessed by

Documentation

A GitHub pages site with the full documentation and API is provided here

Credits

Droppy

Contact angle measurement automation has also been performed by mvgorcum, which uses a different approach to fitting the tangents, but inspired our work here.

Contribute

Please don't hesitate to submit any issues that you may identify with the approach or the coding. We will try to respond quickly to any questions that may arise. If you would like to contribute to the project, feel free to make any pull requests that will make the solution more robust/efficient/better for your application, and we will do our best to incorporate it in the next release.

Release historyRelease notifications | RSS feed

1.0.0b0 pre-release

1.0.0a0.post1 pre-release

Droopy eyelid surgery

1.0.0a0 pre-release

Droopy Cartoon

1.0.0.dev2 pre-release

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for droppy, version 1.0.0b0
Filename, sizeFile typePython versionUpload dateHashes
Filename, size droppy-1.0.0b0-py3-none-any.whl (34.5 kB) File type Wheel Python version py3 Upload dateHashes
Filename, size droppy-1.0.0b0.tar.gz (41.5 kB) File type Source Python version None Upload dateHashes
Close

Hashes for droppy-1.0.0b0-py3-none-any.whl

Hashes for droppy-1.0.0b0-py3-none-any.whl
AlgorithmHash digest
SHA256a046957402e5270879a1091f02a6dde55a48ecfcda61be2f9436d2a7cf0d6907
MD5c28cbfc25cba09d6310602d8f67abbe7
BLAKE2-2568e22c25025c2988665a5614530d6eafba2451fd0f9f354a0acdf319fc4d22987
Close

Hashes for droppy-1.0.0b0.tar.gz

Hashes for droppy-1.0.0b0.tar.gz
AlgorithmHash digest
SHA25691e3e89a39856e7b42a914f8008f98273e41c8183e228501ded8ec5e1ae78a16
MD5239242244d47fd042528db981e3900b0
BLAKE2-2563998590af3772301a2c767f67a75105ec54e561661282a3c8cbd6c938c3964e4