PARAMETERS Subcommand (POWER PROPORTIONS RELATED command)
PARAMETERS
controls the test assumptions. The keywords specify the sample size,test
values for proportions or counts, marginal test values, estimation method, test direction, and
significance level.
- POWER = value(s)
- Optional keyword that specifies the desired power level(s). There is no
default. Multiple values can be specified with each value separated by a blank space (or blank
spaces). A grid of power values from
value1
tovalue2
with the increment ofvalue3
, connected by the keywords TO and BY, can also be specified. When a grid of power values is specified, only one valid set of[value1 TO value2 BY value3]
is allowed.Value1
andvalue2
must satisfy the condition0 < value1 ≤ value2 < 1
. The case wherevalue1 = value2
is equivalent to specifying a singlevalue1
, regardless ofvalue3
. In order to restrict the number of power values,value3
must satisfy the condition0.01 ≤ value3 < 1
. The grid can be mixed with other power values, and can be placed anywhere.Notes:- All specified values must be in the range
[0,1]
. - In cases where duplicate values are specified, only unique values are used, and a warning message is generated to indicate that all duplicate values are excluded from the analysis.
- All specified values must be in the range
- TEST = {NONDIRECTIONAL}{DIRECTIONAL}
- An optional keyword that determines whether the test is one or two-sided. NONDIRECTIONAL, or a two-sided test, is the default setting. When DIRECTIONAL is specified, power is computed for a one-sided test.
- ESTIMATE = {NORMAL} {BINOMIAL}
- An optional keyword that determines the power estimation method, if the
total sample size specified for /
PARAMETERS N
does not exceed500
. NORMAL calls for the normal approximation (the default setting). BINOMIAL calls for the binomial enumeration method. The keyword has no effect when the specified/PARAMETERS N
value exceeds500
(normal approximation is used). - TIMER = {value}
- An optional keyword to specify the maximum number of minutes allowed to
estimate the sample size. If specified, the value must be a single positive integer to denote the
number of minutes. The keyword takes effect when
ESTIMATE = BINOMIAL
and POWER is specified. The keyword is not pasted by default, which turns the timer off completely. When the time limit is reached, the analysis is terminated and a warning message is displayed (no results are provided). - SIGNIFICANCE = value
- An optional keyword that specifies the significance level of the Type I
error rate for the test. The value must be a single double value
∈(0,1)
. The default level is0.05
. - NPAIRS = integer
- A required keyword that specifies the total number of the matched pairs. Must be a positive integer ≥ 2. NPAIRS and POWER cannot be specified simultaneously.
- VALUES = {PROPORTIONS({value1 value2 })} {COUNTS({integer1 integer2 })}
- A required keyword that specifies the proportions or counts. Only PROPORTIONS is supported when POWER is specified.
- MARGINAL = boolean
- An optional keyword that controls whether or not the proportions or the counts specified for VALUES are marginal. FALSE is the default setting, which denotes the discordant proportions or counts. When TRUE is specified, it denotes the marginal proportions or counts.
- CORRELATION = value
- A required keyword that specifies the correlation between matched pairs,
which takes effect when
MARGINAL = TRUE
. The keyword is ignored when MARGINAL = FALSE. Must be a single value∈(-1,1)
.