"Fossies" - the Fresh Open Source Software Archive

Member "dx-4.4.4/help/dxall859" (5 Feb 2002, 6675 Bytes) of package /linux/misc/old/dx-4.4.4.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 #!F-adobe-helvetica-medium-r-normal--18*
    2 #!N 
    3 #!N  #!Rhistogr Histogram #!N #!N Category #!N #!N  #!Lcattrn,dxall763 h Transformation  #!EL  #!N #!N 
    4 Function #!N #!N Constructs a histogram from input data and computes 
    5 the median. #!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N  #!F-adobe-times-bold-r-normal--18*   
    6 histogram, median #!EF = Histogram(  #!F-adobe-times-bold-r-normal--18*   data, bins, min, max, out); 
    7 #!EF #!EF #!N #!N #!EC #!N #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   
    8 #!N TAB Name TAB Type TAB Default TAB Description #!EF #!N 
    9 TAB data TAB scalar list or vector list or TAB none 
   10 TAB field to be operated on #!N TAB - TAB scalar 
   11 field or vector field or TAB - TAB #!N TAB - 
   12 TAB series TAB - TAB #!N TAB bins TAB integer or 
   13 vector TAB 256 for bytes, 100 otherwise TAB number of bins 
   14 in histogram #!N TAB min TAB scalar or vector or field 
   15 TAB min. of data TAB minimum value to operate on #!N 
   16 TAB max TAB scalar or vector or field TAB max. of 
   17 data TAB maximum value to operate on #!N TAB out TAB 
   18 flag or vector TAB 0 TAB 0: exclude out-of-range values #!N 
   19 TAB - TAB - TAB - TAB 1: include out-of-range values 
   20 #!N TAB - TAB - TAB - TAB #!EF #!N #!N 
   21 Outputs #!N #!N #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type 
   22 TAB Description #!EF #!N TAB histogram TAB field or series TAB 
   23 the histogram #!N TAB median TAB scalar TAB median of the 
   24 input data #!N TAB - TAB - TAB #!EF #!N #!N 
   25 Functional Details #!N #!N The median is determined from an interpolation 
   26 performed in the bin containing the median element (or elements, if 
   27 there are an even number of samples). #!N #!I0 #!N #!N 
   28 #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   data #!EF #!EF #!I50 #!N is the 
   29 data whose frequency distribution is to be computed and then represented 
   30 in a histogram.  #!F-adobe-times-bold-r-normal--18*   data #!EF can consist of scalars, 2-vectors, 
   31 or 3-vectors, with resulting one-dimensional, two-dimensional, or three-dimensional histograms, respectively. #!N 
   32 #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   bins #!EF #!EF #!I50 #!N specifies the 
   33 number of bins into which the range from  #!F-adobe-times-bold-r-normal--18*   min #!EF 
   34 to  #!F-adobe-times-bold-r-normal--18*   max #!EF will be divided. If  #!F-adobe-times-bold-r-normal--18*   data #!EF 
   35 consists of vectors, then  #!F-adobe-times-bold-r-normal--18*   bins #!EF can be a vector 
   36 of the same length specifying the number of bins in each 
   37 dimension. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   min #!EF  #!F-adobe-times-medium-r-normal--18*   and #!EF 
   38  #!F-adobe-times-bold-r-normal--18*   max #!EF #!EF #!I50 #!N specify the range of values 
   39 for which the histogram is computed. #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N 
   40 #!N #!I30 #!N o If neither parameter is specified, the values 
   41 used are the minimum and maximum of the input data values. 
   42 #!N #!I30 #!N o If  #!F-adobe-times-bold-r-normal--18*   min #!EF is a scalar 
   43 value, it is the value used. #!N #!I30 #!N o If 
   44  #!F-adobe-times-bold-r-normal--18*   min #!EF is a data field, the minimum data value 
   45 of that field is used. #!N #!I30 #!N o  #!F-adobe-times-bold-r-normal--18*   max 
   46 #!EF is similarly interpreted. #!N #!I30 #!N o If  #!F-adobe-times-bold-r-normal--18*   min 
   47 #!EF is a data field and  #!F-adobe-times-bold-r-normal--18*   max #!EF is unspecified, 
   48 the module uses the minimum and maximum values of that field. 
   49 #!N #!I30 #!N o If  #!F-adobe-times-bold-r-normal--18*   data #!EF consists of vectors, 
   50 then  #!F-adobe-times-bold-r-normal--18*   min #!EF and  #!F-adobe-times-bold-r-normal--18*   max #!EF may also consist 
   51 of vectors of the same length to specify the range in 
   52 each dimension. Otherwise, the values given for  #!F-adobe-times-bold-r-normal--18*   min #!EF and 
   53  #!F-adobe-times-bold-r-normal--18*   max #!EF will apply to each dimension. #!N #!I0 #!N 
   54 #!EF #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   out #!EF #!EF #!I50 
   55 #!N specifies whether the module ignores data values outside the range 
   56 of  #!F-adobe-times-bold-r-normal--18*   min #!EF and  #!F-adobe-times-bold-r-normal--18*   max #!EF or includes them 
   57 in the first and last bins respectively. If  #!F-adobe-times-bold-r-normal--18*   data #!EF 
   58 consists of vectors, then  #!F-adobe-times-bold-r-normal--18*   out #!EF may be a vector 
   59 of the same length specifying how to treat each dimension. #!I0 
   60 #!N #!N #!N #!N #!I0 #!N Notes: #!N #!I30 #!N 1. 
   61 For the output, a "positions" component is constructed that consists of 
   62  #!F-adobe-times-bold-r-normal--18*   bins #!EF +1 points, corresponding to the boundaries between bins. 
   63 #!N #!I30 #!N 2. A regular "connections" component is constructed that 
   64 consists of a set of line segments connecting the end points. 
   65 #!N #!I30 #!N 3. The "data" component, which is connection dependent, 
   66 contains the counts for the corresponding bin. #!N #!I30 #!N 4. 
   67 The interval for each bin is closed on the  #!F-adobe-times-bold-r-normal--18*   min 
   68 #!EF side and open on the  #!F-adobe-times-bold-r-normal--18*   max #!EF side. To 
   69 include the maximum data value: #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N 
   70 #!I30 #!N o set  #!F-adobe-times-bold-r-normal--18*   out #!EF to include outlying values 
   71 #!N #!N  #!F-adobe-times-medium-i-normal--18*   or #!EF #!N #!I30 #!N o set  #!F-adobe-times-bold-r-normal--18*   
   72 max #!EF to a value slightly larger than the maximum data 
   73 value. #!N #!I0 #!N #!EF #!N #!I0 #!N #!N #!N #!N 
   74 To see the results of Histogram for scalar data, pass its 
   75 output to the Plot module. For 2-vector data, pass its output 
   76 to the RubberSheet module with a scale factor of 1. For 
   77 3-vector data, use either the Isolate module or use Include followed 
   78 by ShowBoundary. #!N #!N Components #!N #!N Creates new "positions," "connections," 
   79 and "data" components. The data, representing the number of items in 
   80 each bin, is connections dependent. #!N #!N Example Visual Program #!CForestGreen 
   81 #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N UsingEqualize.net #!N SIMPLE/Histogram.net #!EF #!N #!N #!EC 
   82 #!N #!N See Also #!N #!N  #!Lequaliz,dxall831 h Equalize  #!EL  ,  #!Lplot,dxall904 h Plot  #!EL  ,  #!Lscale,dxall934 h Scale  #!EL  
   83 #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Limage,dxall860 h Image  #!EL  #!N 
   84  #!F-adobe-times-medium-i-normal--18*   #!N