|
|
NAG[g03zac] NAG[nag_mv_z_scores] - Standardize values of a data matrix
|
|
Calling Sequence
g03zac(x, isx, s, e, z, 'n'=n, 'm'=m, 'tdx'=tdx, 'nvar'=nvar, 'tdz'=tdz, 'fail'=fail)
nag_mv_z_scores(. . .)
Parameters
|
|
x - Matrix(1..n, 1..tdx, datatype=float[8], order=C_order);
|
|
|
|
|
s - Vector(1..m, datatype=float[8]);
|
|
|
|
If ![isx[j] = 0](/support/helpjp/helpview.aspx?si=10509/file08458/math95.png) , then ![s[j]](/support/helpjp/helpview.aspx?si=10509/file08458/math97.png) is not referenced.
|
|
|
|
e - Vector(1..m, datatype=float[8]);
|
|
|
|
If ![isx[j] = 0](/support/helpjp/helpview.aspx?si=10509/file08458/math126.png) , then ![e[j]](/support/helpjp/helpview.aspx?si=10509/file08458/math128.png) is not referenced.
|
|
|
|
z - Matrix(1..n, 1..tdz, datatype=float[8], order=C_order);
|
|
|
|
On exit: the matrix of standardized values ( -scores),  .
|
|
|
|
'n'=n - integer; (optional)
|
|
|
|
Default value: the first dimension of the arrays x, z.
|
|
|
On entry: the number of observations in the data matrix,  .
|
|
|
Constraint:  . .
|
|
|
|
'm'=m - integer; (optional)
|
|
|
|
Default value: the first dimension of the arrays isx, s, e and the second dimension of the arrays isx, s, ethe array x.
|
|
|
On entry: the number of variables in the data array x.
|
|
|
Constraint:  . .
|
|
|
|
'tdx'=tdx - integer; (optional)
|
|
|
|
On entry: the second dimension of the array x as declared in the function from which nag_mv_z_scores (g03zac) is called.
|
|
|
Constraint:  . .
|
|
|
|
'nvar'=nvar - integer; (optional)
|
|
|
|
Default value: the second dimension of the array z.
|
|
|
On entry: the number of variables to be standardized,  .
|
|
|
Constraint:  . .
|
|
|
|
'tdz'=tdz - integer; (optional)
|
|
|
|
On entry: the second dimension of the array z as declared in the function from which nag_mv_z_scores (g03zac) is called.
|
|
|
Constraint:  . .
|
|
|
|
'fail'=fail - table; (optional)
|
|
|
|
The NAG error argument, see the documentation for NagError.
|
|
|
|
|
Description
|
|
|
|
Purpose
|
|
nag_mv_z_scores (g03zac) produces standardized values ( -scores) for a data matrix.
|
|
|
Error Indicators and Warnings
|
|
"NE_2_INT_ARG_LT"
On entry,  while  . These arguments must satisfy  .
"NE_INT_ARG_LT"
On entry, n must not be less than 1:  .
"NE_INTARR_REALARR"
On entry, ![isx[< >+1]=< >](/support/helpjp/helpview.aspx?si=10509/file08458/math323.png) , ![s[< >+1]=< >](/support/helpjp/helpview.aspx?si=10509/file08458/math325.png) . Constraint: if ![isx[j] = 0](/support/helpjp/helpview.aspx?si=10509/file08458/math327.png) then ![s[j] > 0.](/support/helpjp/helpview.aspx?si=10509/file08458/math329.png) , 
"NE_INTERNAL_ERROR"
An internal error has occurred in this function. Check the function call and any array sizes. If the call is correct then please consult NAG for assistance.
"NE_VAR_INCL_INDICATED"
The number of variables, nvar in the analysis  , while number of variables included in the analysis via array  . Constraint: these two numbers must be the same.
|
|
|
Accuracy
|
|
Standard accuracy is achieved.
|
|
|
|
Examples
|
|
|
>
|
n := 4:
m := 3:
tdx := 3:
nvar := 2:
tdz := 2:
x := Matrix(4, 3, datatype=float[8], order='C_order'):
isx := Vector([1, 0, 1], datatype=integer[kernelopts('wordsize')/8]):
s := Vector([2.5, 0, 420.3], datatype=float[8]):
e := Vector([14.75, 0, 1050], datatype=float[8]):
z := Matrix(4, 2, datatype=float[8], order='C_order'):
NAG:-g03zac(x, isx, s, e, z, 'n' = n, 'm' = m, 'tdx' = tdx, 'nvar' = nvar, 'tdz' = tdz):
|
|
|
