OpenPIV
OpenPIV consists in a Python and Cython modules for scripting and executing the analysis of a set of PIV image pairs. In addition, a Qt and Tk graphical user interfaces are in development, to ease the use for those users who don't have python skills.
Warning
The OpenPIV python version is still in its beta state. This means that it still might have some bugs and the API may change. However, testing and contributing is very welcome, especially if you can contribute with new algorithms and features.
Test it without installation
Click the link - thanks to BinderHub, Jupyter and Conda you can now get it in your browser with zero installation:
Installing
Recommended: Using uv (fastest)
uv is a fast Python package installer and resolver written in Rust:
pip install uv
uv pip install openpiv
Using pip (standard)
Use PyPI: https://pypi.python.org/pypi/OpenPIV:
pip install openpiv
Or Poetry
poetry add openpiv
Note on Conda/Anaconda
⚠️ Conda packages are no longer actively maintained. The conda-forge package may be outdated.
If you previously installed OpenPIV via conda, you can migrate to pip or uv:
# Remove the conda package
conda remove openpiv
# Install with pip or uv
pip install openpiv
# or
uv pip install openpiv
To build from source
Download the package from the Github: https://github.com/OpenPIV/openpiv-python/archive/master.zip or clone using git
git clone https://github.com/OpenPIV/openpiv-python.git
Using distutils create a local (in the same directory) compilation of the Cython files:
python setup.py build_ext --inplace
Or for the global installation, use:
python setup.py install
Documentation
The OpenPIV documentation is available on the project web page at http://openpiv.readthedocs.org
Demo notebooks
- Tutorial Notebook 1
- Tutorial notebook 2
- Dynamic masking tutorial
- Multipass with Windows Deformation
- Multiple sets in one notebook
- 3D PIV
These and many additional examples are in another repository: OpenPIV-Python-Examples
Contributors
- Alex Liberzon
- Roi Gurka
- Zachary J. Taylor
- David Lasagna
- Mathias Aubert
- Pete Bachant
- Cameron Dallas
- Cecyl Curry
- Theo Käufer
- Andreas Bauer
- David Bohringer
- Erich Zimmer
- Peter Vennemann
- Lento Manickathan
- Yuri Ishizawa
Copyright statement: smoothn.py is a Python version of smoothn.m originally created by D. Garcia [https://de.mathworks.com/matlabcentral/fileexchange/25634-smoothn], written by Prof. Lewis and available on Github [https://github.com/profLewis/geogg122/blob/master/Chapter5_Interpolation/python/smoothn.py]. We include a version of it in the openpiv folder for convenience and preservation. We are thankful to the original authors for releasing their work as an open source. OpenPIV license does not relate to this code. Please communicate with the authors regarding their license.
How to cite this work
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openpiv-0.26.0.tar.gz.
File metadata
- Download URL: openpiv-0.26.0.tar.gz
- Upload date:
- Size: 41.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1b3d3781981d2e1b44730167a1bb3066726a903a5342bcf89bdfe98459cdb519
|
|
| MD5 |
852c432b86ddda77f2b8151d83a5099c
|
|
| BLAKE2b-256 |
278941bb2cc3d2e26ade0b2146d409bad5bf6ef8c94e394ba421e8932a718435
|
File details
Details for the file openpiv-0.26.0-py3-none-any.whl.
File metadata
- Download URL: openpiv-0.26.0-py3-none-any.whl
- Upload date:
- Size: 41.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8207b65915989e7de412028cd9dcf162b1a9f215d38c3e7565ab1c87f18dd152
|
|
| MD5 |
715aae099d89014bfd835a436087896a
|
|
| BLAKE2b-256 |
128b99b0100d096795bf93fdb6f6480a1ca6362697d173cfb50358bd6a6c3369
|
