previous next Up Title Contents Index

get_hist routine

This routine retrieves the histogram characteristics for a given histogram number. The histogram number should refer to a valid number otherwise get_hist returns 0 for all the output variables. The standard use of this routine is to extract the mean of a variable over time. It has to be used in conjunction with the chart recorder histogram type.

Page: 19
can only be ?

In the UEOR routine, it can be used extensively for histrogam post-processing and generating a result file ready for a spreadsheet style program. In the example at the end of this section, the call to get_hist is made from user1 for mean variation display over a given number of events (kadc0, itstime). As long they have been defined in file.EQU, any variables used in the routine will be passed to the SusiQ test and histogram package where further processes can be applied to them.
call get_hist (Histo_number, Xlow, Xhigh, Ysum, Undf, Ovfl, Mean, Sigma)

Histo_number : Histogram number
Xlow : Low data limit of the histo (0 for full)
Xhigh : High data limit of the histo (0 for full)
Ysum : Total count content within Xlow & Xhigh
Undf : Total underflow count below Xlow
Ovfl : Total overflow count above Xhigh
Mean : weighted mean of the histo within the Xlow & Xhigh limits
Sigma : Standard deviation of the histo within Xlow & Xhigh limits


previous next Up Title Contents Index