VELD-HISTOGRAM(1)

NAME
veld-histogram - Plot a histogram of the values in the data stream

SYNOPSIS

veld histogram [-e ENCODING | --encoding=ENCODING] [-f | --flatten]
               [-i | --ignore] [-s SEPARATOR | --separator=SEPARATOR]
               [--xmin=XMIN] [--xmax=XMAX] [--ymin=YMIN] [--ymax=YMAX]
               [--xlabel=XLABEL] [--ylabel=YLABEL] [--title=TITLE]
               [-b BINS | --bins=BINS] [--density] [--cumulative] [--stacked]
               [file]

OPTIONS

-h, --help
    show this help message and exit

-e, --encoding
    Specify the encoding of the input stream.

-f, --flatten
    With multidimensional input (more than one value per line) the operation is normally conducted on each dimension independently. With the --flatten option, the input is flattened line-wise (RowMajor order) and the operation is conducted on the resulting one-dimensional stream.

-i, --ignore
    Ignore non-numeric values in the input stream

-s, --separator
    Some of the Veld commands have support for multidimensional input data. The values on each line of the input stream are expected to be separated by this separator. By default, the tab character will be used as a separator.

--xmin
    Lower limit of the horizontal axis

--xmax
    Upper limit of the horizontal axis

--ymin
    Lower limit of the vertical axis

--ymax
    Upper limit of the vertical axis

--xlabel
    Axis label for the horizontal axis

--ylabel
    Axis label for the vertical axis

--title
    Title for the plot

-b, --bins
    Number of bins in the histogram

--density
    Create a density plot such that the area under the histogram integrates to 1.

--cumulative
    In cumulative mode, the height of each bar corresponds to the number of values in that bin plus all of the preceding ones. This can be combined with the --density option such that the last bar will equal 1.

--stacked
    With multidimensional data, stack the bars on top of each other. This differs from the default behavior where the bars are arranged side by side.

[file]
    Veld is primarily designed for processing input streams, but it can also be applied on a file of data, which can be supplied with this argument. By default Veld will read the input data from stdin.