sddshist2d

**description:**`sddshist2d`makes two-dimensional histograms of data, producing output that is suitable for plotting with`sddscontour`. The two-dimensional histogram may include data from two columns, or may show the histograms of a single column versus page number.**examples:**Make a two-dimensional histogram of two PAR bpm readouts, then plot the result:`sddshist2d par.bpm par.bpm.h2d -column=P1P1x,P1P2x -xparam=50 -yparam=50 sddscontour -shade=32 par.bpm.h2d -quantity=frequency`**synopsis:**`sddshist2d [-pipe[=input][,output]] [`*inputfile*] [*outputfile*] -columns={*xName*,*yName*|*yName*} [-weights=*columnName*[,average]] [-xParameters=*bins*[,*lower*,*upper*]] [-yParameters=*bins*[,*lower*,*upper*]] [-outputName=*string*] [-sameScale] [-combine] [-normalize[=sum]] [-smooth[=*passes*]] [-verbose]**switches:**`-pipe[=input][,output]`-- The standard SDDS Toolkit pipe option.`-columns={`-- Specifies the data from the input to histogram. If both*xName*,*yName*|*yName*}*xName*and*yName*are given, then`sddshist2d`does a two-dimensional histogram of the values in the named columns. If only`yName`is given, then`sddshist2d`does a series of one-dimensional histograms of the named column, one for each data pages; these histograms are then assembled as a two-dimensional histogram with one axis being the page number.`-weights=`-- Specifies the name of a column of data with which to proportionally weight the count value of points in the histogram. If the*columnName*[,average]`average`qualifier is given, then each bin value is normalized to contain the average value of the weight for all points in the bin.`-xParameters=`-- Specifies the number of bins and optionally the histogrammed region for the x values. Ignored if only*bins*[,*lower*,*upper*]*yName*is given. By default, 21 bins are used encompassing all of the data points.`-yParameters=`-- Specifies the number of bins and optionally the histogrammed region for the y values. By default, 21 bins are used encompassing all of the data points.*bins*[,*lower*,*upper*]`-outputName=`-- Specifies the name of the histogram data. The default is*string*`frequency`.`-sameScale`-- Specifies that for multipage input files, the histogram region should be the same for all pages. The region is set to encompass all data points from all pages.`-combine`-- Specifies that for multipage input files, the data from all pages should be placed in a single histogram.`-normalize[=sum]`-- Specifies normalization of the histogram. If the`sum`qualifier is not given, the histogram is normalized to unit amplitude; otherwise, it is normalized so that the sum of all frequencies is unity.`-smooth[=`-- Specifies smoothing by nearest-neighbor-averaging. If*passes*]*passes*is omitted, only one pass is performed.`-verbose`-- Requests informational output during processing.

**see also:**- sddshist
`sddshist`()sddshist - sddscontour
`sddscontour`()sddscontour - sddscongen
`sddscongen`()sddscongen

- sddshist
**author:**M. Borland, ANL/APS.