.-
help for ^z_r^                                                  (STB-32: sg51)
.-

Create a correlation matrix and its confidence limit matrix
-----------------------------------------------------------

   ^z_r^ varlist [weight] [^if^ exp] [^in^ range] [^,^ ^l^evel^(^cilevel^)^] ^noc^orr ^nol^imit


^aweights^ and ^fweights^ are allowed; see help @weights@.

^z_r^ typed without arguments redisplays previous results.
 

Description
-----------

^z_r^ calculates and stores, in the matrix S_1, a correlation matrix for the var-
iables in varlist.  It then uses the Fisher z-transform to construct a confi-
dence interval for each non-trivial correlation in S_1, and stores the lower
confidence limit below, and the upper confidence limit above the diagonal of
the matrix S_2.  An observation will be ignored if it has any missing values in
the varlist; ^if^ and ^in^ clauses may also be used to select observations.


Options
-------

^level(cilevel)^ sets the confidence level for the confidence interval requested.
    The default cilevel is 95%; values for cilevel may be specified as frac-
    tions, level(.975), or as percentages, level(97.5).

^nocorr^ suppresses the display of the correlation matrix; it is nevertheless
    stored, in the matrix S_1.  (Useful with commands @z_rci@ and @z_rplt@.)

^nolimit^ suppresses the display of the confidence limit matrix; it is neverthe-
    less stored, in the matrix S_2.  (Useful with commands @z_rci@ and @z_rplt@.)


Examples
--------

 . ^z_r height weight age systolic hrate^
   (create a 5x5 correlation matrix and store it in S_1; create a 5x5 matrix of
   95% confidence intervals from the elements of S_1, and store them in S_2)

 . ^z_r height weight age systolic hrate if !treat, l(.975)^
   (the same as the previous example, except use only those observations where
   treat==0, and create 97.5% confidence intervals)

 . ^z_r height weight age systolic hrate if !treat, l(97.5) noc nol^
   (exactly the same as the previous example, but don't display either matrix)


Author
------
        John R. Gleason                          
        Syracuse University
        73241.717@@compuserve.com


Also see
-------- 

 Manual:  [5s] correlate
On-line:  help for @pwcorr@, @z_rci@, @z_rcii@, @z_rplt@, @z_rvrfy@