HOMALS(BRM-A) BLSS Reference Manual Addenda NAME homals -- Homogeneity Analysis on an m x n frequency table SYNOPSIS homals _g {maxit=;eps=;p=;iterlin=} [ >> _x ] DESCRIPTION Homals performs a homogeneity analysis on an m x n frequency table. If an output dataset is specified, it will contain the m x p result. The user may specify the maximum number of iterations to be attempted, the precision required for convergence, the dimension p of the resulting matrix, and how often the error term will be printed. INPUTS g@ The m x n frequency table to be analyzed OPTIONS maxit - the integer maximum number of iterations. If convergence is not attained after maxit iterations, Homals will exit with the results of the most recent iteration. Default is 50 if not specified. eps - the double precision maximum allowable error for convergence. Homals will exit when either the error of the most recent iteration is less than eps, or when maxit iterations have been performed. Default is 1e-6 if not specified. p - the integer column dimension of the output matrix. Default is 2 if not specified iterlin - meaning iteration errors per line, is the integer number of iterations errors printed on a single line before starting a new line. A value of 1 will print the error after every iteration on a separate line, whereas a value of 7 will display the error after every 7 iterations on a separate line. Default is 10 if not specified. OUTPUTS x@ The m x p analysis of g. EXAMPLES A usage which utilizes all four optional parameters: BLSS Release 4.1. Type "help" for help; type "news" for news (last updated 10/5/1989). . load hartigan.dat Loaded "hartigan.dat" from the BLSS system data area. . hartigan.dat 2.000 1.000 1.000 1.000 1.000 2.000 2.000 1.000 1.000 1.000 4.000 2.000 2.000 1.000 1.000 1.000 2.000 2.000 2.000 1.000 1.000 1.000 2.000 2.000 2.000 1.000 1.000 1.000 2.000 2.000 2.000 1.000 1.000 1.000 2.000 2.000 2.000 2.000 1.000 1.000 5.000 2.000 2.000 2.000 1.000 1.000 3.000 2.000 2.000 2.000 1.000 1.000 3.000 2.000 1.000 3.000 2.000 1.000 5.000 2.000 1.000 4.000 3.000 1.000 4.000 2.000 1.000 5.000 3.000 1.000 4.000 2.000 1.000 4.000 3.000 1.000 2.000 2.000 1.000 5.000 3.000 1.000 2.000 2.000 1.000 4.000 3.000 2.000 4.000 2.000 1.000 3.000 3.000 2.000 1.000 2.000 1.000 5.000 3.000 2.000 1.000 2.000 1.000 5.000 3.000 2.000 1.000 2.000 1.000 5.000 3.000 2.000 1.000 2.000 1.000 5.000 3.000 2.000 1.000 2.000 2.000 1.000 1.000 1.000 1.000 1.000 2.000 1.000 1.000 1.000 1.000 1.000 2.000 1.000 1.000 1.000 1.000 1.000 1.000 3.000 3.000 1.000 1.000 1.000 . homals hartigan.dat {maxit=40;eps=1e-4;p=3;iterlin=7} > x iteration 7 error=2.859190e-03 iteration 14 error=2.242509e-03 iteration 21 error=2.681885e-03 iteration 28 error=4.880652e-04 iteration 34 error=7.369721e-05 . x -0.1535 -0.09585 0.1046 -0.1392 -0.09568 -0.06145 -0.1960 -0.1069 0.008860 -0.1960 -0.1069 0.008860 -0.1960 -0.1069 0.008860 -0.1960 -0.1069 0.008860 -0.2033 0.3485 -0.1570 -0.2550 0.1616 -0.3858 -0.2550 0.1616 -0.3858 0.07855 0.8007 0.2753 0.1740 -0.04399 -0.2430 0.1853 -0.05084 -0.1470 0.1172 -0.05522 -0.1727 0.1286 -0.06207 -0.07668 0.2674 -0.07382 -0.2460 0.2417 0.1007 0.1652 0.2645 -0.08083 0.01607 0.2645 -0.08083 0.01607 0.2645 -0.08083 0.01607 0.2645 -0.08083 0.01607 -0.1906 -0.1427 0.2918 -0.1906 -0.1427 0.2918 -0.1906 -0.1427 0.2918 0.1112 0.08365 0.3553 . exit AUTHOR Written for Jan deLeeuw by David Betz SEE ALSO BLSS 4.1 Printed 22-May-93