Skip to main content

OpenPIV

Python package DOI PyPI

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: Binder

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

  1. Tutorial Notebook 1
  2. Tutorial notebook 2
  3. Dynamic masking tutorial
  4. Multipass with Windows Deformation
  5. Multiple sets in one notebook
  6. 3D PIV

These and many additional examples are in another repository: OpenPIV-Python-Examples

Contributors

  1. Alex Liberzon
  2. Roi Gurka
  3. Zachary J. Taylor
  4. David Lasagna
  5. Mathias Aubert
  6. Pete Bachant
  7. Cameron Dallas
  8. Cecyl Curry
  9. Theo Käufer
  10. Andreas Bauer
  11. David Bohringer
  12. Erich Zimmer
  13. Peter Vennemann
  14. Lento Manickathan
  15. 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

DOI

Download files

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

Source Distribution

openpiv-0.25.5.tar.gz (41.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openpiv-0.25.5-py3-none-any.whl (41.4 MB view details)

Uploaded Python 3

File details

Details for the file openpiv-0.25.5.tar.gz.

File metadata

  • Download URL: openpiv-0.25.5.tar.gz
  • Upload date:
  • Size: 41.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.0 CPython/3.12.3 Linux/6.17.0-1022-azure

File hashes

Hashes for openpiv-0.25.5.tar.gz
Algorithm Hash digest
SHA256 732b30267ccbc6e53c1f8adbbfcdded9895109d40b2f6f45f30d3a471fb1c546
MD5 8b23293e8ffb3440d405f4a06c9d6468
BLAKE2b-256 134d761d1a77b72a874fb3a798f5bc361abf4c7ae9c1511b7e81841eebe752ba

See more details on using hashes here.

File details

Details for the file openpiv-0.25.5-py3-none-any.whl.

File metadata

  • Download URL: openpiv-0.25.5-py3-none-any.whl
  • Upload date:
  • Size: 41.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.0 CPython/3.12.3 Linux/6.17.0-1022-azure

File hashes

Hashes for openpiv-0.25.5-py3-none-any.whl
Algorithm Hash digest
SHA256 9eb534adf23e5e2157eed8ffe3a0502b6fd04d5a3ee1632313e121f250279452
MD5 4e80957bfe338e39232a95937d22b166
BLAKE2b-256 ca90c42614eaac9f167144f1703e293792b51de27b616c5ca6e703ed10f77f10

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.25.5 This release

2 files

0.25.4

2 files

0.25.3

2 files

0.25.2

2 files

0.25.1

3 files

0.25.0

2 files

0.24.2

2 files

0.24.1

2 files

0.24.0

2 files

0.23.9

2 files

0.23.8

2 files

0.23.6

2 files

0.23.5

2 files

0.23.4

15 files

0.23.3

15 files

0.23.2

15 files

0.23.1

15 files

0.23.0

21 files

0.22.3

1 file

0.22.2

22 files

0.22.0

22 files

0.21.9

2 files

0.21.8

1 file

0.21.7

2 files

0.21.6

2 files

0.21.5

2 files

0.21.4

1 file

0.21.3

1 file

0.20.9

2 files

0.20.8

3 files

0.20.7

1 file

0.20.6

2 files

0.20.5

1 file

0.20.3

1 file

0.20.2

1 file

0.20.1

4 files

0.20

1 file

0.19

2 files

0.18

1 file

0.17

1 file

0.16

1 file

0.15

1 file

0.14

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page