---
name: "gpiv_uhisto"
section: "1"
platform: "linux"
package: "gpivtools"
version: "0.6.0-3.1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/gpiv_uhisto"
---

# gpiv\_uhisto(1)

Tests PIV data by printing/displaying an histogram of the horizontal particle displacements.

## NAME

gpiv\_uhisto - Tests PIV data by printing/displaying an histogram of the horizontal particle displacements.

## SYNOPSIS

**gpiv\_uhisto** \[**-g**\]  \[**-h** \| **--help**\]  \[**-n** *N*\]  \[**-p** \| **--print**\]  \[**-v** \| **--version**\]  \[*filename*\]  \< *stdin* \> *stdout*

## DESCRIPTION

**Gpiv\_uhisto** *calculates the histogram of the horizontal particle* *displacement distribution between minimum and maximum values.*

*The parameters read from the configuration resources (containing the* *key* **VALID**) may be overruled by the command line options, as explained below.

## Options

- **-g**

  Graphical visualization of the histogram with gnuplot.

- **-h** \| **--help**

  On-line help

- **-n** *N*

  Override number of bins (default 10, hard coded).

- **-p** \| **--print**

  Print parameters, command line options and eventually used input and output filenames to stdout.  The output is  identic of *filename***.par**, in case **-f** is used.

- **-v** \| **--version**

  Print version information on standard output, then exit successfully.

- *filename*

  Input PIV file. Overrides stdin and stdout. Output will be written to *filename***.pdf**. The parameters will be written or appended to *filename***.par** and may be used for future use by including them  in *./gpivrc*.

## SEE ALSO

gpivtools

## NOTES

stdin and stdout has still to be implemented.  \[**-f** *filename* \] will be added.

## AUTHOR

Gerber Van der Graaf

## BUGS

The program seems to work fine with real PIV data.  So far, no serious bugs have been found.