# py-droplets
[![Build Status](https://github.com/zwicker-group/py-droplets/actions/workflows/python_tests.yml/badge.svg)](https://github.com/zwicker-group/py-droplets/actions/workflows/python_tests.yml)
[![Documentation Status](https://readthedocs.org/projects/py-droplets/badge/?version=latest)](https://py-droplets.readthedocs.io/en/latest/?badge=latest)
[![PyPI version](https://badge.fury.io/py/py-droplets.svg)](https://badge.fury.io/py/py-droplets)
[![Conda Version](https://img.shields.io/conda/vn/conda-forge/py-droplets.svg)](https://anaconda.org/conda-forge/py-droplets)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![codecov](https://codecov.io/gh/zwicker-group/py-droplets/branch/master/graph/badge.svg)](https://codecov.io/gh/zwicker-group/py-droplets)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
`py-droplets` provides python code for representing physical droplets using
key parameters like position, size, or shape.
These droplets can also be represented as collections (emulsions) and over time.
Moreover, the package provides methods for locating droplets in microscope
images or phase field data from simulations.
Installation
------------
`py-droplets` is available on `pypi`, so you should be able to install it
through `pip`:
```bash
pip install py-droplets
```
As an alternative, you can install `py-droplets` through [conda](https://docs.conda.io/en/latest/)
using the [conda-forge](https://conda-forge.org/) channel:
```bash
conda install -c conda-forge py-droplets
```
Usage
-----
More information
----------------
* Tutorial notebook in the [tutorials folder](https://github.com/zwicker-group/py-droplets/tree/master/examples/tutorial)
* Examples in the [examples folder](https://github.com/zwicker-group/py-droplets/tree/master/examples)
* [Full documentation on readthedocs](https://py-droplets.readthedocs.io/)
or as [a single PDF file](https://py-droplets.readthedocs.io/_/downloads/en/latest/pdf/).
Raw data
{
"_id": null,
"home_page": null,
"name": "py-droplets",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "emulsions, image-analysis",
"author": null,
"author_email": "David Zwicker <david.zwicker@ds.mpg.de>",
"download_url": "https://files.pythonhosted.org/packages/b0/c5/1d824364f0f7e65fc50dc65a2b3e9814ad0e0a07db684a92ce91c48408b7/py_droplets-0.21.0.tar.gz",
"platform": null,
"description": "# py-droplets\n\n[![Build Status](https://github.com/zwicker-group/py-droplets/actions/workflows/python_tests.yml/badge.svg)](https://github.com/zwicker-group/py-droplets/actions/workflows/python_tests.yml)\n[![Documentation Status](https://readthedocs.org/projects/py-droplets/badge/?version=latest)](https://py-droplets.readthedocs.io/en/latest/?badge=latest)\n[![PyPI version](https://badge.fury.io/py/py-droplets.svg)](https://badge.fury.io/py/py-droplets)\n[![Conda Version](https://img.shields.io/conda/vn/conda-forge/py-droplets.svg)](https://anaconda.org/conda-forge/py-droplets)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![codecov](https://codecov.io/gh/zwicker-group/py-droplets/branch/master/graph/badge.svg)](https://codecov.io/gh/zwicker-group/py-droplets)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n`py-droplets` provides python code for representing physical droplets using\nkey parameters like position, size, or shape.\nThese droplets can also be represented as collections (emulsions) and over time.\nMoreover, the package provides methods for locating droplets in microscope\nimages or phase field data from simulations.\n\n\nInstallation\n------------\n\n`py-droplets` is available on `pypi`, so you should be able to install it\nthrough `pip`:\n\n```bash\npip install py-droplets\n```\n\nAs an alternative, you can install `py-droplets` through [conda](https://docs.conda.io/en/latest/)\nusing the [conda-forge](https://conda-forge.org/) channel:\n\n```bash\nconda install -c conda-forge py-droplets\n```\n\n\nUsage\n-----\n\nMore information\n----------------\n* Tutorial notebook in the [tutorials folder](https://github.com/zwicker-group/py-droplets/tree/master/examples/tutorial)\n* Examples in the [examples folder](https://github.com/zwicker-group/py-droplets/tree/master/examples)\n* [Full documentation on readthedocs](https://py-droplets.readthedocs.io/)\n or as [a single PDF file](https://py-droplets.readthedocs.io/_/downloads/en/latest/pdf/).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python package for describing and analyzing droplets in experiments and simulations",
"version": "0.21.0",
"project_urls": {
"documentation": "http://py-droplets.readthedocs.io",
"homepage": "https://github.com/zwicker-group/py-droplets",
"repository": "https://github.com/zwicker-group/py-droplets"
},
"split_keywords": [
"emulsions",
" image-analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "19ec68792957ee021d308bcf6374d720d85db251ced0e3c38b2dd841c643845c",
"md5": "b1bdd47b2f2f12aa3cd1bf206ef9d4b9",
"sha256": "f2293474e3c019dfc84319e89438d1afc4ea9771be46e578a4a957c12376109f"
},
"downloads": -1,
"filename": "py_droplets-0.21.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1bdd47b2f2f12aa3cd1bf206ef9d4b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 172092,
"upload_time": "2024-06-20T19:40:10",
"upload_time_iso_8601": "2024-06-20T19:40:10.514668Z",
"url": "https://files.pythonhosted.org/packages/19/ec/68792957ee021d308bcf6374d720d85db251ced0e3c38b2dd841c643845c/py_droplets-0.21.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b0c51d824364f0f7e65fc50dc65a2b3e9814ad0e0a07db684a92ce91c48408b7",
"md5": "9a27b9d934858b854a18429992c63b88",
"sha256": "2f5a9c6efec20a2a75c93e3612a05bf26c39dcd65c2012d3d82350e924a1dea6"
},
"downloads": -1,
"filename": "py_droplets-0.21.0.tar.gz",
"has_sig": false,
"md5_digest": "9a27b9d934858b854a18429992c63b88",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 209606,
"upload_time": "2024-06-20T19:40:12",
"upload_time_iso_8601": "2024-06-20T19:40:12.717767Z",
"url": "https://files.pythonhosted.org/packages/b0/c5/1d824364f0f7e65fc50dc65a2b3e9814ad0e0a07db684a92ce91c48408b7/py_droplets-0.21.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-20 19:40:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zwicker-group",
"github_project": "py-droplets",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "h5py",
"specs": [
[
">=",
"2.10"
]
]
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.1"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.22"
]
]
},
{
"name": "numba",
"specs": [
[
">=",
"0.59"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"1.4"
]
]
},
{
"name": "py-pde",
"specs": [
[
">=",
"0.39"
]
]
}
],
"lcname": "py-droplets"
}