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

Copy three matrices output by the command ^z_r^
---------------------------------------------

   ^z_rcopy^ ^,^ { ^from(^m1 m2 m3^)^ | ^to(^m1 m2 m3^)^ }


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

^z_rcopy^ copies three matrices, previously created by the command ^z_r^, from one
location to another.  Exactly one of the options ^from()^ or ^to()^ must be given;
the result is equivalent to one of the sets of commands in the table below:

                ^to(m1 m2 m3)^                ^from(m1 m2 m3)^
               ---------------             ---------------
               matrix m1 = S_1             matrix S_1 = m1
               matrix m2 = S_2             matrix S_2 = m2
               matrix m3 = S_3             matrix S_3 = m3

@z_r@ stores a correlation matrix in the matrix S_1, its associated matrix of
confidence limits in the matrix S_2, and the working sample size (n), dimension
(p) of matrix S_1, and confidence level in the matrix S_3.  Other commands (for
example, @z_rci@ and @z_rplt@) expect to find output from ^z_r^ in matrices S_1, S_2,
and S_3. ^z_rcopy^ copies ^z_r^ output from one set of matrices to another so that,
for instance, more than one set of output can be available at the same time.


Examples
--------

 . ^global first "fff ffci ffp"^
 . ^z_rcopy, to($first)^
   (copy matrices S_1, S_2, and S_3 to matrices fff, ffci, and ffp)

 . ^z_rcopy, from(mat1 mat2 mat3)^
   (assign mat1, mat2, mat3 to S_1, S_2, S_3, respectively)

 . ^z_rcopy, from($first)^
   (restore the three matrices saved in the first example)


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


Also see
-------- 

 Manual:  [5s] correlate, [6m] intro
On-line:  help for @z_r@, @z_rci@, @z_rplt@, @z_rvrfy@