Download Java Executable

Download jpiv.jar.

Launch Java Executable

  1. If not done already, install the Java Runtime Environment (JRE) from On 64 bit systems, make sure you are running a 64 bit JRE! Type java -version into your terminal to verify this.
  2. Run JPIV by double clicking on the file in your file manager or by typing java -jar jpiv.jar into your terminal. If you experience an out of memory error or poor performance, increase the avalable memory: To allow up to four gigabytes, type java -jar -Xmx4G jpiv.jar.

Command Line Options

Refer to the Scripting tutorial to learn using JPIV on the command line.

Additional packages

You may want to add some additional functionality, like scripts for batch processing, masking, synthetic image generation, joining and splitting images, directory processing, native libraries for reading LaVision IMX and IM7 image data, and offline documentation files. Click on the symbol below to download a zip-archive (18.4 MB), extract the files to your hard drive and tell JPIV where to find the unpacked directory, as explained in the documentation section. Restart JPIV to list the scripts of the jpivlib/jsc directory in the Scripts drop-down menu.
JPIV add-on resources (last update of library: September 24 2011)

Source code

The source code is available on the sourceforge subversion server:
JPIV source code
Additionally to the jpiv source files, the directory structure also contains the NetCDF Java Library for reading synthetic image generation parameter files, the BeanShell Core Interpreter Classes for executing scripts and the Free HEP library for vector graphics export. The source code documentation will be a good companion guiding you through the code.

Test images

For testing JPIV, you might find the following images useful (0.5 MB):
PIV test images

To try the reconstruction of the third velocity component, please use the images below (3 MB). Reference vector fields for comparison are included, as well as a data sheet with the synthetic image generation properties.
3D reconstruction test images

Find more challenging test images at