Compute the heterotrait-monotrait ratio of correlations (HTMT) based on Henseler2015;textualcSEM. The HTMT is a consistent estimator for the construct correlations of tau-equivalent measurement model. It is used to assess discriminant validity.
calculateHTMT(
.object = NULL,
.absolute = TRUE,
.alpha = 0.05,
.handle_inadmissibles = c("drop", "ignore", "replace"),
.inference = FALSE,
.only_common_factors = TRUE,
.R = 499,
.seed = NULL
)An R object of class cSEMResults resulting from a call to csem().
Logical. Should the absolute HTMT values be returned?
Defaults to TRUE .
An integer or a numeric vector of significance levels.
Defaults to 0.05.
Character string. How should inadmissible results
be treated? One of "drop", "ignore", or "replace". If "drop", all
replications/resamples yielding an inadmissible result will be dropped
(i.e. the number of results returned will potentially be less than .R).
For "ignore" all results are returned even if all or some of the replications
yielded inadmissible results (i.e. number of results returned is equal to .R).
For "replace" resampling continues until there are exactly .R admissible solutions.
Depending on the frequency of inadmissible solutions this may significantly increase
computing time. Defaults to "drop".
Logical. Should critical values be computed? Defaults to FALSE.
Logical. Should only concepts modeled as common
factors be included when calculating one of the following quality critera:
AVE, the Fornell-Larcker criterion, HTMT, and all reliability estimates.
Defaults to TRUE.
Integer. The number of bootstrap replications. Defaults to 499.
Integer or NULL. The random seed to use. Defaults to NULL in which
case an arbitrary seed is chosen. Note that the scope of the seed is limited
to the body of the function it is used in. Hence, the global seed will
not be altered!
A lower tringular matrix of HTMT values. If .inference = TRUE
the upper tringular part is the .alpha%-quantile of the HTMT's bootstrap
distribution.
Computation of the HTMT assumes that all intra-block and inter-block
correlations between indicators are either all-positive or all-negative.
A warning is given if this is not the case. If all intra-block or inter-block
correlations are negative the absolute HTMT values are returned (.absolute = TRUE).
To obtain the alpha%-quantile of the bootstrap distribution for each HTMT
value set .inference = TRUE.
Since the HTMT is defined with respect to a classical true score measurement
model only concepts modeled as common factors are considered by default.
For concepts modeled as composites the HTMT may be computed by setting
.only_common_factors = FALSE, however, it is unclear how to
interpret values in this case.