DMAR 1.1.0

Breaking Changes in 1.1.0

DMAR 1.1.0 names the total sample size, the number of predictors, a planner’s planning value, and the desired width one way, and names an argument for the quantity it holds rather than for a symbol. The DMAR 1.0.x names listed here are not accepted: a call that gives one stops with R’s “unused argument” error. The exceptions, all of them, are listed under Old Names That R Still Matches, after the table. There is no deprecation period and no function that maps an old name to a new one. Change the call. Three functions are removed, with no alias; the call that replaces each is given under One Function for Each ANOVA Effect Size.

The Count in the Partial and Semipartial Correlation Functions Changed Meaning

var_partial_r(), var_semipartial_r(), expected_partial_r(), ss_aipe_partial_r(), ss_aipe_semipartial_r(), ss_aipe_partial_r_sensitivity(), and ss_aipe_semipartial_r_sensitivity() took J, the number of variables partialed out. They take p, the total number of predictors in the regression of Y on X and the variables partialed out, in the place J held, and p = J + 1. A DMAR 1.0.x call that gave the count by position still runs, and now describes one fewer variable partialed out. var_partial_r(.3, 100, 2) was a partial correlation given two other variables and is now a partial correlation given one; ss_aipe_partial_r(.3, 2, .2) planned for two variables partialed out and now plans for one. Add 1 to the count in every such call: var_partial_r(.3, 100, 3), ss_aipe_partial_r(.3, 3, .2). A call that named the count (J = 2) stops with “unused argument” and becomes p = 3. p must be a whole number of at least 2; with nothing partialed out the correlation is the simple correlation, which var_r(), expected_r(), ss_aipe_r(), and ss_aipe_r_sensitivity() cover.

One Function for Each ANOVA Effect Size

Renamed Arguments

An argument is named for the quantity it holds and for the role of the value. A population value that a planner or a sensitivity function takes begins with true_, as do those of the analysis of variance, analysis of covariance, and regression data generators; the value a sensitivity function plans the design from begins with supposed_ (estimated_ or est_ in DMAR 1.0.x, which suggested an estimate from data, where the value is a planning assumption); and a null value begins with null_. The quantity is named in words: a correlation is cor (true_cor, true_cor_YX, cor_lower), a contrast contrast and a standardized one std_contrast, a regression coefficient reg_coef and a standardized one std_reg_coef, a squared multiple correlation R2, a mean mean, a standard deviation sd (true_sd, and true_sd_X and true_sd_Y when the variable is named), a population variance true_var_ followed by what it is the variance of (true_var_within, true_var_error, true_var_trend), a covariance matrix cov_matrix, a factor loading factor_loading, and a residual variance residual_var. A function that computes the same quantity from population values or from estimates (cohen_f(), ci_srsnr(), covmat_from_cfa(), var_ete(), var_indirect_effect()) names its arguments without a role. A sample size given so that the power or the precision at that size is returned is specified_N (the total, or the one group) or specified_n_per_group. The table gives the name each argument had in DMAR 1.0.x.

family function DMAR 1.0.x now
the chi square statistic ci_nc_chisq(), convert_chisq_F() chi_square chisq (as in sem_fit_measures(), ecvi(), and equivalence_rmsea(); a row or column of a table is still chi_square)
a per-group sample size given for evaluation ss_power_contrast(), ss_aipe_c_sensitivity(), ss_aipe_sc_sensitivity(), ss_aipe_sc_ancova_sensitivity(), ss_aipe_smd_sensitivity(), ss_aipe_equivalence_smd_sensitivity(), ss_aipe_pcm_sensitivity() n_per_group specified_n_per_group (also in ss_power_c(), ss_power_c_ancova(), ss_power_sc(), ss_power_composite_ancova_2group(), and ss_power_split_plot_anova(), listed below)
a population standard deviation ss_seq_c_sensitivity() true_sigma true_sd
power_equivalence_md(), power_density_equivalence_md(), power_equivalence_md_plot() sigma; power_sigma in power_density_equivalence_md() true_sd; sd_values
a calculator given population values or sample summaries cohen_f() mu, sigma_squared, sigma_m, sigma means, var_within, sd_means, sd_within
ci_srsnr() sigma_squared var_within
covmat_from_cfa() lambda, psi_squared factor_loading, residual_var
var_ete() sigma2, sigma2_Z, beta_1, beta_2, mu_Z error_variance, var_Z (either may be a population value or an estimate, as type says, so neither is named true_), reg_coef_1, reg_coef_2, mean_Z
a size per cell or per arm given for evaluation ss_power_factorial_anova(), ss_power_factorial_ancova(), ss_power_composite_anova(), ss_power_composite_ancova(), ss_power_composite_factorial_anova(), ss_power_composite_factorial_ancova(), ss_power_composite_factorial_ancova_het() n_per_cell specified_n_per_cell
the estimated contrast and its equivalence bounds equivalence_c() psi_hat, delta_lower, delta_upper contrast, contrast_lower, contrast_upper
the variance of the predictor in a two-level model ss_aipe_mixed_effects_sensitivity() true_sigma2_x, estimated_sigma2_x true_var_X, supposed_var_X
partial and semipartial correlation var_partial_r(), var_semipartial_r(), expected_partial_r() n, J N, p (p = J + 1)
expected_partial_r() rho true_cor
ss_aipe_partial_r() rho, J true_cor, p (p = J + 1)
ss_aipe_semipartial_r() r_sp, J true_r_sp, p (p = J + 1)
ss_aipe_partial_r_sensitivity(), ss_aipe_semipartial_r_sensitivity() J p (p = J + 1)
ss_aipe_partial_r_sensitivity() true_rho, estimated_rho true_cor, supposed_cor
ss_aipe_semipartial_r_sensitivity() estimated_r_sp supposed_r_sp
correlation ci_r(), var_r(), expected_r(), equivalence_r() n N
var_r(), expected_r() rho true_cor
equivalence_r() rho_lower, rho_upper cor_lower, cor_upper
ss_aipe_r() rho true_cor
ss_aipe_r_sensitivity() true_rho, estimated_rho true_cor, supposed_cor
ss_power_r() rho, rho_0, N true_cor, null_cor, specified_N
ss_aipe_equivalence_r() population_r true_cor
ss_aipe_equivalence_r_sensitivity() true_r, estimated_r, rho_lower, rho_upper true_cor, supposed_cor, cor_lower, cor_upper
coefficient of variation ci_cv(), var_cv() n N
var_cv() cv true_cv, as in ss_aipe_cv()
ss_aipe_cv() C_of_V, mu, sigma true_cv, true_mean, true_sd
ss_aipe_cv_sensitivity() mean, estimated_cv true_mean, supposed_cv
squared multiple correlation ss_aipe_R2() population_R2, g true_R2, G_initial
ss_power_R2() population_R2, cohen_f2, print_progress true_R2, true_f2, print_iter
var_R2(), expected_R2() population_R2 true_R2, as in ss_aipe_R2() and ss_power_R2()
ss_aipe_R2_sensitivity() w, estimated_R2, rho_yx, rho_xx width, supposed_R2, true_cor_YX, true_cor_XX
ss_power_R2_sensitivity() estimated_R2, rho_yx, rho_xx supposed_R2, true_cor_YX, true_cor_XX
regression coefficient ss_aipe_reg_coef_sensitivity(), ss_aipe_rc_sensitivity(), ss_aipe_src_sensitivity() w, estimated_var_Y, estimated_cov_YX, estimated_cov_XX width, supposed_var_Y, supposed_cov_YX, supposed_cov_XX
ss_power_reg_coef_sensitivity() estimated_var_Y, estimated_cov_YX, estimated_cov_XX supposed_var_Y, supposed_cov_YX, supposed_cov_XX
ss_aipe_reg_coef_sensitivity(), ss_aipe_rc_sensitivity(), ss_power_reg_coef_sensitivity() standardize (default FALSE) removed: these report the unstandardized coefficient; ss_aipe_src_sensitivity() reports the standardized one
ss_aipe_src_sensitivity() standardize (default TRUE) removed: it reports the standardized coefficient
ci_reg_coef(), ci_rc() b_j, SE_b_j, s_Y, s_X reg_coef_j, se_reg_coef_j, sd_Y, sd_X
ci_src() beta_j, SE_beta_j, b_j, SE_b_j, s_Y, s_X std_reg_coef_j, se_std_reg_coef_j, reg_coef_j, se_reg_coef_j, sd_Y, sd_X
ss_aipe_reg_coef() b_j, rho2_Y_X, rho2_j_X_without_j, sigma_Y, sigma_X, rho_XX, rho_YX true_reg_coef_j, true_R2_Y_X, true_R2_j_X_without_j, true_sd_Y, true_sd_X, true_cor_XX, true_cor_YX
ss_aipe_rc() b_j, rho2_Y_X, Rho2_j_X_without_j, sigma_Y, sigma_X_j, rho_XX, rho_YX true_reg_coef_j, true_R2_Y_X, true_R2_j_X_without_j, true_sd_Y, true_sd_X, true_cor_XX, true_cor_YX
ss_aipe_src() beta_j, rho2_Y_X, Rho2_j_X_without_j, sigma_Y, sigma_X_j, rho_XX, rho_YX true_std_reg_coef_j, true_R2_Y_X, true_R2_j_X_without_j, true_sd_Y, true_sd_X, true_cor_XX, true_cor_YX
ss_power_reg_coef() beta_j, rho2_Y_X, rho2_Y_X_without_j, rho2_j_X_without_j, sigma_X, sigma_Y, rho_XX, rho_YX, cohen_f2, print_progress true_reg_coef_j (the coefficient on the scale true_sd_X and true_sd_Y describe), true_R2_Y_X, true_R2_Y_X_without_j, true_R2_j_X_without_j, true_sd_X, true_sd_Y, true_cor_XX, true_cor_YX, true_f2, print_iter
ss_power_rc() beta_j, rho2_Y_X, rho2_Y_X_without_j, Rho2_j_X_without_j, sigma_X, sigma_Y, rho_XX, rho_YX, cohen_f2, print_progress true_reg_coef_j, true_R2_Y_X, true_R2_Y_X_without_j, true_R2_j_X_without_j, true_sd_X, true_sd_Y, true_cor_XX, true_cor_YX, true_f2, print_iter
contrast among means ss_aipe_c() error_variance, MSwithin, SD true_var_error (the square of SD)
ss_aipe_c_ancova() error_var_ancova, error_var_anova, rho true_var_error_ancova, true_var_error_anova, true_cor
ss_aipe_c_ancova_sensitivity() true_error_var_ancova, true_error_var_anova, est_error_var_ancova, est_error_var_anova, rho, est_rho, mu_y, sigma_y, mu_x, sigma_x true_var_error_ancova, true_var_error_anova, supposed_var_error_ancova, supposed_var_error_anova, true_cor, supposed_cor, true_mean_Y, true_sd_Y, true_mean_X, true_sd_X
ss_aipe_c_sensitivity() true_error_variance, estimated_error_variance, true_psi true_var_error, supposed_var_error, true_contrast
ci_c(), ci_c_ancova(), ci_sc(), ci_sc_ancova() psi contrast (the estimate row is contrast in ci_c() and ci_c_ancova() and std_contrast in ci_sc() and ci_sc_ancova())
ss_power_c() psi, sigma, n true_contrast, true_sd, specified_n_per_group
ss_power_contrast() psi, mu, sigma_squared, print_progress true_contrast, true_means, true_var_error, print_iter
ci_c(), ci_c_ancova(), equivalence_c(), ss_seq_c() n n_per_group
ss_power_c_ancova() psi, sigma, rho, n true_contrast, true_sd, true_cor, specified_n_per_group
standardized contrast ss_aipe_sc() psi_standardized true_std_contrast
ss_power_sc() psi_standardized, n true_std_contrast, specified_n_per_group
ci_sc(), ci_sc_ancova() n n_per_group
ss_aipe_sc_ancova() psi_standardized, psi, rho, sigma_anova, sigma_ancova, ratio true_std_contrast, true_contrast, true_cor, true_sd_anova, true_sd_ancova, true_sd_ratio
ss_aipe_sc_sensitivity() true_psi, estimated_psi, desired_width true_std_contrast, supposed_std_contrast, width
ss_aipe_sc_ancova_sensitivity() true_psi, estimated_psi, desired_width, rho, mu_x, sigma_x true_std_contrast, supposed_std_contrast, width, true_cor, true_mean_X, true_sd_X
standardized mean difference ss_aipe_smd() delta true_smd
ss_aipe_smd_sensitivity() true_delta, estimated_delta, desired_width true_smd, supposed_smd, width
ss_power_smd() smd true_smd
ss_aipe_equivalence_smd() population_smd true_smd
ss_aipe_equivalence_smd_sensitivity() estimated_smd, delta_lower, delta_upper supposed_smd, smd_lower, smd_upper
equivalence_smd() delta_lower, delta_upper smd_lower, smd_upper
expected_smd(), var_smd() delta true_smd
var_smd_trimmed() population_smd_trimmed true_smd_trimmed, as var_smd() takes true_smd
convert_delta_lambda() delta smd (a population value or an estimate; the function name keeps delta)
cles(), nnt_from_smd(), proportion_of_superiority() smd_lower, smd_upper (confidence limits on d) smd_ci_lower, smd_ci_upper
ss_power_composite_ancova_2group() smd, rho, sigma, sd_cov, n true_smd, true_cor, true_sd, true_sd_X, specified_n_per_group
noncentral t and F convert_lambda_delta(), convert_lambda_R2() lambda ncp (the function names keep lambda)
ci_nc_t() t_value (a second name for ncp) ncp
analysis of variance ss_aipe_omega_squared() population_omega_squared true_omega_squared
ss_aipe_omega_squared_sensitivity() estimated_omega_squared supposed_omega_squared
var_omega_squared() population_omega_squared true_omega_squared, as in ss_aipe_omega_squared()
ss_power_one_way_anova() f, eta_squared, N true_f, true_eta_squared, specified_N
ss_power_rm_anova() f, eta_squared, rho, epsilon, n true_f, true_eta_squared, true_cor, true_epsilon, specified_N
ss_power_split_plot_anova() f, partial_eta_squared, rho, epsilon, n true_f, true_eta_squared_partial, true_cor, true_epsilon, specified_n_per_group
ss_power_factorial_anova() f, partial_eta_squared true_f, true_eta_squared_partial
ss_power_factorial_ancova() f, partial_eta_squared, covariate_R2 true_f, true_eta_squared_partial, true_covariate_R2
composite power in the analysis of variance and covariance ss_power_composite_anova(), ss_power_composite_factorial_anova() means, sigma true_means, true_sd
ss_power_composite_factorial_ancova() means, sigma, covariate_R2 true_means, true_sd, true_covariate_R2
ss_power_composite_factorial_ancova_het() means, correlations, sigma, sd_cov true_means, true_cor, true_sd, true_sd_X
ss_power_composite_ancova() means, sigma, covariate_R2, correlations, sd_cov true_means, true_sd, true_covariate_R2, true_cor, true_sd_X
cohen_f(), is_orthogonal_set(), variance_components_mls() n n_per_group
equivalence of a contrast and of a mean difference power_equivalence_c() n, sigma, delta_lower, delta_upper, true_psi n_per_group, true_sd, contrast_lower, contrast_upper, true_contrast
ss_power_equivalence_c() sigma, delta_lower, delta_upper, true_psi true_sd, contrast_lower, contrast_upper, true_contrast
power_equivalence_md(), power_density_equivalence_md(), power_equivalence_md_plot() n n_per_treatment
power_equivalence_md() ltheta1, ltheta2, ldiff, nu lower_bound, upper_bound, true_effect, df_error (ratios on the original scale when logscale = TRUE, differences otherwise, as before)
power_density_equivalence_md() theta1, theta2, diff, nu lower_bound, upper_bound, true_effect, df_error (on the analysis scale, as before)
power_equivalence_md_plot() theta1, theta2, nu lower_bound, upper_bound, df_error
plot_equivalence() delta_lower, delta_upper effect_lower, effect_upper (bounds on the scale of whatever estimates are drawn)
sequential estimation with minimum risk mr_smd() n n_per_group
intraclass correlation and coefficient alpha ss_aipe_icc() rho, k true_icc, n_raters
ss_aipe_icc_sensitivity() true_rho, estimated_rho, k true_icc, supposed_icc, n_raters
var_icc() rho, n, k icc, N, n_raters
var_alpha() n, p_items N, n_items
two-level models ss_aipe_mixed_effects() sigma2_y, sigma2_x, icc true_total_var, true_var_X, true_icc
ss_aipe_mixed_effects_sensitivity() true_sigma2_y, estimated_sigma2_y, estimated_icc, true_beta, specified_K true_total_var, supposed_total_var, supposed_icc, true_reg_coef, specified_n_clusters
ss_power_mixed_effects() d, n, rho, J true_smd, cluster_size, true_icc, specified_n_clusters_per_arm
polynomial change models ss_aipe_pcm() variance_trend, error_variance, variance_true_minus_estimated_trend true_var_trend, true_var_error, true_var_trend_error
ss_power_pcm() beta, tau, level_1_variance, N true_std_reg_coef (beta under the default standardized = TRUE) or true_reg_coef (beta with standardized = FALSE), true_var_trend, true_var_error, specified_n_per_group (the size of each group, half of the total that N held)
ss_power_pcm() standardized removed: the argument given, true_std_reg_coef or true_reg_coef, says the scale
ss_aipe_pcm_sensitivity() true_variance_trend, true_error_variance, estimated_variance_trend, estimated_error_variance true_var_trend, true_var_error, supposed_var_trend, supposed_var_error
cluster randomized designs ss_aipe_crd_both_fixed_budget(), ss_aipe_crd_both_fixed_width(), ss_aipe_crd_n_clusters_fixed_budget(), ss_aipe_crd_n_clusters_fixed_width(), ss_aipe_crd_n_individuals_fixed_budget(), ss_aipe_crd_n_individuals_fixed_width() tau_Y, sigma2_Y, total_var, icc_Y, R2_between, R2_within, num_predictors, clus_cost, indiv_cost true_var_between, true_var_within, true_total_var, true_icc, true_R2_between, true_R2_within, n_covariates, cluster_cost, individual_cost
ss_aipe_crd_es_both_fixed_budget(), ss_aipe_crd_es_both_fixed_width(), ss_aipe_crd_es_n_clusters_fixed_budget(), ss_aipe_crd_es_n_clusters_fixed_width(), ss_aipe_crd_es_n_individuals_fixed_budget(), ss_aipe_crd_es_n_individuals_fixed_width() es, icc_Y, icc_Z, R2_between, R2_within, num_predictors, nrep, clus_cost, indiv_cost, multicore, num_proc true_es, true_icc, true_icc_covariate, true_R2_between, true_R2_within, n_covariates, G, cluster_cost, individual_cost, ncpus (multicore = TRUE, num_proc = 4 is ncpus = 4)
ss_aipe_crd_n_clusters_fixed_budget(), ss_aipe_crd_n_clusters_fixed_width(), ss_aipe_crd_es_n_clusters_fixed_budget(), ss_aipe_crd_es_n_clusters_fixed_width() n_individuals cluster_size
indirect (mediated) effect ss_aipe_indirect_effect() a, b, n_max true_std_reg_coef_a, true_std_reg_coef_b, max_N
ss_aipe_indirect_effect_sensitivity() true_a, true_b, estimated_a, estimated_b true_std_reg_coef_a, true_std_reg_coef_b, supposed_std_reg_coef_a, supposed_std_reg_coef_b
ss_power_indirect_effect() a, b, c_prime, N true_std_reg_coef_a, true_std_reg_coef_b, true_std_reg_coef_direct, specified_N
var_indirect_effect() a, b, var_a, var_b, cov_ab reg_coef_a, reg_coef_b, var_reg_coef_a, var_reg_coef_b, cov_reg_coef_a_b (population values or estimates, raw or standardized, so neither true_ nor std_)
structural equation models ss_aipe_composite_sem() Sigma, pop_model, mu, desired_width, N true_cov_matrix, true_model, true_mean, width, specified_N
ss_power_composite_sem() Sigma, pop_model, mu, N true_cov_matrix, true_model, true_mean, specified_N
ss_aipe_sem_path() Sigma, desired_width true_cov_matrix, width
ss_aipe_sem_path_sensitivity() est_Sigma, true_Sigma, desired_width, N supposed_cov_matrix, true_cov_matrix, width, specified_N
ss_aipe_rmsea() RMSEA true_rmsea
ss_aipe_rmsea_sensitivity() Sigma, N true_cov_matrix, specified_N
ss_power_sem() RMSEA_null, RMSEA_true, F_ML, RMSEA_full, RMSEA_res, F_full, F_res, df_res null_rmsea, true_rmsea, true_F_ML, true_rmsea_full, true_rmsea_restricted, true_F_full, true_F_restricted, df_restricted
reliability ss_aipe_reliability() S, i, cor_est, lambda, psi_square, initial_iter, final_iter, start_ss true_cov_matrix, n_items, true_item_covariance, true_factor_loading, true_residual_var, G_initial, G, start_N
ss_aipe_reliability_sensitivity() estimated_reliability, i supposed_reliability, n_items
measurement models and item response theory dmacs() lambda_reference, lambda_focal, nu_reference, nu_focal factor_loading_reference, factor_loading_focal, intercept_reference, intercept_focal
simple_structure() Lambda factor_loading_matrix
irt_information() a, b, theta discrimination, threshold, trait_value (item and grm keep their names, and so do the columns a and b of an irt_grm() table given as grm)
standardized mean ss_aipe_sm() sm true_sm
ss_aipe_sm_sensitivity() estimated_sm, desired_width supposed_sm, width
Cliff’s delta ss_aipe_cliff_delta() delta true_delta
ss_aipe_cliff_delta_sensitivity() estimated_delta supposed_delta
Cohen’s h cohen_h() p1, p2 p_1, p_2
consequences of a design design_consequences() w width
one sample and paired data bayes_one_sample_t(), bayes_paired_t() n N
ci_proportion() n N
the null value of a mean or a mean difference bayes_one_sample_t(), ci_mahalanobis() mu_0 null_mean
welch_t(), summary_t_test() mu null_mean_diff
eigenvalue of a covariance matrix ci_eigenvalue() n, k N, which_eigenvalue
expected cross-validation index ecvi() n multiplier
critical values and simultaneous intervals dbryant_paulson(), pbryant_paulson(), qbryant_paulson() num_covariates, num_groups n_covariates, n_groups
cv_bryant_paulson() covariates, groups n_covariates, n_groups
cv_tukey_hsd() groups n_groups
ci_c_ancova_bp() n, num_covariates n_per_group, n_covariates
congruence of factor loadings procrustes_phi() n_perm n_resamples
data generators simulate_anova_data() mu, sigma, n true_mean, true_sd, n_per_group
simulate_ancova_data() mu_y, mu_x, sigma_y, sigma_x, rho, n true_mean_Y, true_mean_X, true_sd_Y, true_sd_X, true_cor, n_per_group
simulate_ancova_factorial_data() mu_y, mu_x, sigma_y, sigma_x, rho_y_x, rho_x_x, n true_mean_Y, true_mean_X, true_sd_Y, true_sd_X, true_cor_YX, true_cor_XX, n_per_cell
simulate_regression_data() rho_YX, rho_XX, mu_Y, mu_X, sigma_Y, sigma_X true_cor_YX, true_cor_XX, true_mean_Y, true_mean_X, true_sd_Y, true_sd_X
simulate_longitudinal_polynomial(), simulate_longitudinal_logistic(), simulate_longitudinal_gompertz(), simulate_longitudinal_negative_exponential(), simulate_longitudinal_richards() n, occasions n_per_group, n_occasions

Old Names That R Still Matches

R matches an argument name by its leading characters, and a function that passes ... to another program does not refuse a name itself. The table lists 602 old names, a name counted once for each function that had it. Of these, 536 stop with “unused argument”. These 66 do not:

ci_cv(), ss_aipe_c(), ss_aipe_cv(), ss_aipe_R2(), ss_aipe_sc(), ss_aipe_sc_ancova(), ss_aipe_sc_ancova_sensitivity(), ss_aipe_sm(), and ss_power_R2() took ... and used it for nothing, so a name they did not have was dropped without a word and the call ran on the default of the argument that was meant: ss_power_R2(true_R2 = .3, p = 3, N = 50) planned for the default power and returned 36. They no longer take ..., and any name they do not have, old or misspelled, is an “unused argument”. The two counts of the simulation that ss_aipe_R2(verify_ss = TRUE) runs, which were read from ... as g and G, are the arguments G_initial (the replications for each candidate N of the coarse search) and G (the replications of the final pass); g and G differed only in case. ci_c_ancova_bp() and the three Bryant-Paulson distribution functions took a ... they did not use and no longer take it, for the same reason: ci_c_ancova_bp(num_covariates = 2) would otherwise have been computed for the default of one covariate without a word. So did ci_c(), ci_reg_coef(), plot_randomization_test(), and R2_mixed_effects(), and ci_rc() and ci_src(), which passed theirs to ci_reg_coef(), where nothing read it; none of the six takes ... now. No exported function is left with a ... that its body does not use. covmat_from_cfa() read only tol_det from its ..., so a misspelled name, or a third value given by position, was dropped without a word; tol_det is now an argument of its own, after factor_loading and residual_var, and the function takes no ....

In ss_power_r() the name N is gone and no other argument took it: ss_power_r(true_cor = .3, N = 50) stops, and the call is ss_power_r(true_cor = .3, specified_N = 50). The null value was rho_0 and is null_cor, as the other null values are null_R2 and null_rmsea; the 1.0.x planning value rho then matches nothing and stops.

ss_aipe_c() takes the error variance one way, as true_var_error, the name in ss_aipe_c_sensitivity() and ss_power_contrast(). MSwithin was a second name for it and SD was its square root; both are gone, with the three checks that the values agreed, so a 1.0.x call that gave SD = s gives true_var_error = s^2. A population contrast is true_contrast in every planner and an observed one contrast; the standardized contrast is true_std_contrast, where the two standardized contrast sensitivity functions called it true_psi, the 1.0.x name of the unstandardized contrast elsewhere.

In the planners for the analysis of variance, Cohen’s f is a planning value and is true_f, beside true_eta_squared and true_eta_squared_partial, in ss_power_one_way_anova(), ss_power_rm_anova(), ss_power_split_plot_anova(), ss_power_factorial_anova(), and ss_power_factorial_ancova(); the row of ss_power_contrast() that holds the f of the contrast is true_f too (effect_size_f). Cohen’s f squared is true_f2 in ss_power_R2(), ss_power_R2_change(), ss_power_reg_coef(), and ss_power_rc(), the argument and the row. The correlation among the repeated measures and the sphericity value of ss_power_rm_anova() and ss_power_split_plot_anova() are true_cor and true_epsilon, and the proportion of within-cell variance the covariates explain in ss_power_factorial_ancova() is true_covariate_R2. The five planners report the noncentrality parameter in the row noncentral_f_parm, the name in ss_power_R2(), and the degrees of freedom in df_effect and df_error, the names in ss_aipe_omega_squared() and ci_eta_squared(). The number of subjects of ss_power_rm_anova(), each measured on every occasion, is the total sample size, so it is specified_N when given and the row necessary_N when planned.

cohen_f(), ci_srsnr(), and covmat_from_cfa() are calculators, not planners: each computes the same quantity from population values or from sample summaries and estimates, so their arguments carry plain quantity names without true_. cohen_f() takes means, var_within, n_per_group, eta_squared, sd_means, and sd_within (mu, sigma_squared, n, sigma_m, sigma); given population values it returns the population f, and given sample summaries it returns the plug-in value from the same calculation, which is not an unbiased estimate of f. ci_srsnr() takes the observed group means, var_within (the pooled within-group mean square; sigma_squared), and n_per_group as an alternative to F_value; with population values in their place, the interval is a hypothetical one, not an interval from observed data and not the expected interval of a planned study. covmat_from_cfa() takes the factor loadings and residual variances, population values or estimates from a fitted model, as factor_loading and residual_var (lambda, psi_squared), and returns its matrix as the element model_implied_cov (population_cov): the matrix is unchanged, and the new name says what it is whether the loadings and residual variances are population values or estimates. covmat_from_cfa(lambda = l, psi_squared = p)$population_cov is covmat_from_cfa(factor_loading = l, residual_var = p)$model_implied_cov.

The planners for composite power in the analysis of variance and covariance (ss_power_composite_anova(), ss_power_composite_factorial_anova(), ss_power_composite_ancova(), ss_power_composite_factorial_ancova(), ss_power_composite_factorial_ancova_het(), and ss_power_composite_ancova_2group()) name their population values as the single-effect planners do: true_means, true_sd, true_cor (the covariate correlations, correlations), true_covariate_R2, and true_sd_X, the standard deviation of the covariate (sd_cov), which is the name the two ANCOVA contrast sensitivity functions give the same quantity. The fields of each element of effects are renamed too: Cohen’s f is true_f and partial eta squared is true_eta_squared_partial (f, partial_eta_squared), so list(factors = 1, f = 0.25) becomes list(factors = 1, true_f = 0.25). A field is not an argument and R does not check it, so the planners now do: an element of effects with a field they do not read is refused (see Calls That Are Now Refused). The rows follow: true_f_<label>, noncentral_f_parm_<label>, and df_error, the names the single-effect planners use. The total sample size beside the per-cell or per-group answer is the row total_N in both branches, the rule for an implied total everywhere else in the package (it was necessary_N beside a planned size and specified_N beside a size that was given); when the correlations differ in absolute value and the size was planned, it is approximate_total_N beside approximate_n_per_cell or approximate_n_per_group (approximate_N). The attributes the plot() method reads from the tables of ss_power_composite_factorial_ancova_het() and of ss_power_composite_ancova(slopes = "heterogeneous") (means, correlations, sigma, sd_cov) are renamed with the arguments: true_means, true_cor, true_sd, and true_sd_X. ss_power_c_ancova() takes true_sd and specified_n_per_group (sigma, n), as ss_power_c() does.

A size per group is n_per_group and a size per cell is n_per_cell, in the estimators as in the planners: ci_c(), ci_sc(), ci_c_ancova(), ci_sc_ancova(), equivalence_c(), cohen_f(), is_orthogonal_set(), variance_components_mls(), ss_seq_c(), mr_smd(), simulate_anova_data(), and simulate_ancova_data() took n and take n_per_group (one number for equal groups, or one per group where the function allowed it); ss_power_c(), ss_power_sc(), and ss_power_split_plot_anova(), where the size is given so that the power at that size is returned, took n and take specified_n_per_group; simulate_ancova_factorial_data() takes n_per_cell. ci_c() and ci_sc() had n and N, a per-group size and the total, apart only by the case of one letter. In power_equivalence_md(), power_density_equivalence_md(), and power_equivalence_md_plot() the size is n_per_treatment: the number of subjects who receive each treatment, which is the size of each group in a parallel design and every subject in a crossover, the n of the standard error sigma * sqrt(2 / n) in both. The three functions take the equivalence bounds as lower_bound and upper_bound, the true difference or ratio as true_effect, and the error degrees of freedom as df_error (ltheta1, ltheta2, and ldiff in power_equivalence_md(), theta1, theta2, and diff in the other two, and nu in all three). The grid attached to the plot keeps its column labels (n=24); its first column, diff, is true_effect. power_equivalence_c() takes n_per_group for independent groups; the number of units of a paired design, new in this release, is N (see Equivalence and Noninferiority of a Contrast).

The contrast planners name their population values as the sensitivity functions do. The error standard deviation is true_sd in ss_power_c(), ss_power_equivalence_c(), and power_equivalence_c() (sigma), as in ss_seq_c_sensitivity(); ss_power_contrast() takes true_means and true_var_error (mu, sigma_squared); ss_aipe_sc_ancova() takes true_sd_anova, true_sd_ancova, and true_sd_ratio (ratio alone is an allocation ratio elsewhere); and the values the two ANCOVA contrast sensitivity functions generate their data from are true_mean_Y, true_sd_Y, true_mean_X, and true_sd_X. The data generators for the analysis of variance and covariance and for regression name their population values the same way: simulate_anova_data() takes true_mean and true_sd (mu, sigma); simulate_ancova_data() takes true_mean_Y, true_mean_X, true_sd_Y, true_sd_X, and true_cor (mu_y, mu_x, sigma_y, sigma_x, rho), and simulate_ancova_factorial_data() the same with true_cor_YX and true_cor_XX (rho_y_x, rho_x_x); and simulate_regression_data() takes true_cor_YX, true_cor_XX, true_mean_Y, true_mean_X, true_sd_Y, and true_sd_X (rho_YX, rho_XX, mu_Y, mu_X, sigma_Y, sigma_X). mr_smd() and mr_cv() keep the symbols of the published procedure (A, epsilon, gamma, m0); their rows now name the sizes they hold: n_1 and n_2 and pilot_n_per_group in mr_smd(), N and pilot_N in mr_cv(). var_omega_squared() takes the value its formula is evaluated at as true_omega_squared (population_omega_squared), the name in ss_aipe_omega_squared(). In the six ss_aipe_crd_es_*() functions write true_es =, and in ss_power_mixed_effects() true_smd =; what R does with es = and d = is under Old Names That R Still Matches.

ss_power_pcm() and ss_aipe_pcm() give the variance of the individuals’ change coefficients and the level one error variance the same names, true_var_trend and true_var_error (tau and level_1_variance in ss_power_pcm(), variance_trend and error_variance in ss_aipe_pcm()), and ss_aipe_pcm_sensitivity() plans from supposed_var_trend and supposed_var_error. ss_aipe_pcm() takes the sampling-error variance of one individual’s estimated change coefficient (Kelley & Rausch, 2011, Equation 19) as true_var_trend_error (variance_true_minus_estimated_trend), and ss_power_pcm() reports the same quantity in the row of that name (error_var_of_slopes). ss_power_pcm() took the group difference in the change coefficient as beta and a flag, standardized, that said whether beta was divided by the between-subject standard deviation of the change coefficient. It takes the difference under the name of its scale: true_std_reg_coef for the standardized difference (beta under the 1.0.x default) and true_reg_coef for the difference in the units of the change coefficient (beta with standardized = FALSE). Exactly one is given; both or neither is refused with a condition of class dmar_argument_invalid. ss_power_pcm(beta = -.4, tau = .003, level_1_variance = .0262, frequency = 1, duration = 4, N = 238) is ss_power_pcm(true_std_reg_coef = -.4, true_var_trend = .003, true_var_error = .0262, frequency = 1, duration = 4, specified_n_per_group = 119). The two come first among the arguments, so a 1.0.x call that gave beta, tau, and level_1_variance by position gives both and is refused rather than read on the other scale. The table reports the difference on both scales, in the rows true_reg_coef and true_std_reg_coef (unstd_coefficient, std_coefficient), whichever was given, and the power is unchanged. The help of ss_power_pcm() keeps the symbols of Raudenbush and Liu (2001) in its formulas and says which argument each one is.

In the planners for an indirect effect each path is a standardized regression coefficient of the population the plan is made for, so the paths are true_std_reg_coef_a, true_std_reg_coef_b, and true_std_reg_coef_direct, and the product of the two paths is the row true_std_indirect_effect. The power of the indirect effect in ss_power_indirect_effect() is the row power_ab (actual_power), followed by power_a and power_b, and tidy() and glance() read it as the power of the design. var_indirect_effect() computes the same variances from population values or from estimates, raw or standardized, so its arguments carry neither true_ nor std_; mediate() keeps its rows a and b, which are estimates.

In the planners for structural equation models a population covariance matrix is true_cov_matrix and the matrix a sensitivity study is planned from is supposed_cov_matrix; the rows of ss_power_composite_sem() that echo the population value of each parameter are true_<label>, as in ss_aipe_composite_sem(). In ss_power_sem() df and df_full keep their names.

In the functions for one sample and for paired data, the size of the one sample, the number of pairs, and the number of trials are each the total sample size, so bayes_one_sample_t(), bayes_paired_t(), ci_proportion(), and ci_eigenvalue() take N; a call that gave the size by position (ci_proportion(17, 50)) is unchanged. The eigenvalue that ci_eigenvalue() brackets was chosen with k and is chosen with which_eigenvalue, as which_predictor and which_path choose theirs. The per-group sizes of bayes_independent_t(), ci_ratio_of_means(), and design_consequences() keep n_1 and n_2. In ss_aipe_cliff_delta() ratio keeps its name (the allocation ratio is a constant of the design, not a planning value).

A null value is null_ followed by the quantity. bayes_one_sample_t() and ci_mahalanobis() take the comparison value of the mean as null_mean (mu_0), and welch_t() and summary_t_test() take the null value of the difference between the means as null_mean_diff (mu), beside null_cor in ss_power_r(), null_R2 in ss_power_R2(), and null_rmsea in ss_power_sem().

The proportion of intervals no wider than the desired width is the row pct_ci_less_width in every sensitivity function and in design_consequences() (pct_ci_less_w; every other name in the package spells the width out), and the rows of ss_aipe_composite_sem() that hold the same proportion for each parameter are pct_ci_less_width_<label> (width_within_desired_<label>).

A count is n_<things>. The number of groups is n_groups in cv_tukey_hsd(), cv_bryant_paulson(), and the three Bryant-Paulson distribution functions (groups, num_groups), and the number of random covariates is n_covariates there and in ci_c_ancova_bp() (covariates, num_covariates); covariates in ancova() and mediate() names columns and keeps its name. The per-group size of ci_c_ancova_bp() is n_per_group. The number of random permutations of procrustes_phi() is n_resamples, the name in randomization_test(), randomization_test_paired(), and vargha_delaney_A(). The five simulate_longitudinal_*() functions take n_per_group, the number of units in each population (one number, or one per population; never a total), and n_occasions, the number of measurement occasions per unit. In ecvi() the divisor is multiplier: it is the multiplier with which the chi square was formed from the fit function, the total sample size under the normal likelihood and the total less the number of groups under the Wishart likelihood, so n named it for one case only.

The number of items is n_items, the number of raters n_raters, the number of clusters n_clusters, and the number of level one units in a cluster cluster_size, in every function that takes or reports one. ss_aipe_reliability() and ss_aipe_reliability_sensitivity() took the number of items as i and var_alpha() as p_items; the row of reliability(), reliability_alpha(), reliability_omega(), reliability_omega_categorical(), and reliability_kr20() that holds it was J and is n_items, the name glance() already gave it, and the row of ss_aipe_reliability_sensitivity() was items. ss_aipe_icc(), ss_aipe_icc_sensitivity(), and var_icc() took the number of raters as k; the help keeps k in the formulas and in the names of the forms ("ICC(1,k)"). ss_power_mixed_effects() took n, rho, and J and takes cluster_size, true_icc, and specified_n_clusters_per_arm: the number of clusters in each arm, not the total n_clusters, so its rows are necessary_n_clusters_per_arm and specified_n_clusters_per_arm, and its noncentrality parameter is in the row noncentral_t_parm, as in ss_power_c() and ss_power_smd(). cluster_size has no default and is checked first.

An intraclass correlation that a planner takes as a planning value is true_icc: in ss_aipe_icc() (rho) and ss_aipe_icc_sensitivity() (true_rho; a correlation is true_cor everywhere else, and the value the sensitivity study is planned from is supposed_icc, which was estimated_rho), in ss_power_mixed_effects() (rho), in the twelve ss_aipe_crd_*() functions (icc_Y), and in ss_aipe_mixed_effects() (icc). var_icc() takes the intraclass correlation its variance is evaluated at as icc, as in design_effect().

The total variance of the outcome in a two-level plan is true_total_var: in ss_aipe_mixed_effects() (sigma2_y) and ss_aipe_mixed_effects_sensitivity() (true_sigma2_y, with supposed_total_var for estimated_sigma2_y), and in the ss_aipe_crd_*() functions (total_var), where true_var_within is the within-cluster variance alone. Two names that differed by one capital no longer hold two quantities. The sensitivity function also plans from supposed_var_X and supposed_icc (estimated_sigma2_x, estimated_icc) and takes the population slope as true_reg_coef (true_beta), whose simulated summaries are the rows mean_reg_coef, median_reg_coef, and sd_reg_coef.

The twelve planners for a cluster randomized design name every population value with true_: true_var_between, true_var_within, true_total_var, true_icc, true_R2_between, and true_R2_within, and in the six for the standardized effect size true_icc_covariate (icc_Z) beside true_es. The number of covariates beside the treatment indicator is n_covariates (num_predictors; the value is unchanged, and the total number of predictors is p = n_covariates + 1). The number of individuals in a cluster is the argument cluster_size of the four functions that take it (n_individuals); the functions that solve for it report it in the row necessary_cluster_size, beside necessary_n_clusters in the two that solve for both, and a size that was given is not repeated in the table. The function names keep n_individuals. The four functions that plan from a width echo it in the row width, as the other AIPE planners do, and the width column of tidy() and glance() is that desired width for every AIPE planner (NA for a plan made from a budget and for a planner that does not echo the request); the expected or assured width is the glance() column of that name. The number of processes of the six ss_aipe_crd_es_*() functions is ncpus (multicore, num_proc), the name in the bootstrap functions. The two costs are cluster_cost and individual_cost, and the number of simulated data sets of the six ss_aipe_crd_es_*() functions is G, as in every other function that simulates (nrep). The row that reports the width no longer carries the effect or the assurance in its name: it is expected_width without an assurance and assured_width with one, and the assurance is in a row of its own, assurance. In 1.0.x the row was, for example, width_of_unstd_conditions_diff_with_0.8_assurance, a name that changed with the value asked for.

ss_aipe_reliability() names its population as a planner does: true_cov_matrix (S, which is a sample covariance matrix in the estimators), true_factor_loading (lambda), true_residual_var (psi_square), and true_item_covariance (cor_est: the help defines it as the common covariance of every pair of items, which is their correlation only for standardized items, and it is a planning value, not an estimate). The replications of the two stages of its assurance search are G_initial and G (initial_iter, final_iter), the names in ss_aipe_R2(), and an assurance plan reports the rows assurance, assurance_attained, and G (specified_assurance, empirical_assurance, final_iter), the names in ss_aipe_partial_r() and ss_aipe_semipartial_r(). The estimators (reliability_alpha() and the rest) keep S, data, and items. The reliability ss_aipe_reliability_sensitivity() plans from is supposed_reliability (estimated_reliability): a planning assumption, not an estimate from data.

The measurement model and item response functions name their parameters for what they are (see the table). irt_information() reports the grid in the column trait_value and carries the attributes discrimination, threshold, and trait_value_max_information; the columns a and b of an irt_grm() table keep their names, and the help of irt_grm() and irt_information() says what they are. A call of irt_information() that gives the values by position is unaffected.

Every population value a planner for a regression coefficient takes carries true_ and is named for its quantity: the coefficient is true_reg_coef_j in the units of the data and true_std_reg_coef_j when it is standardized (DMAR 1.0.x used b_j for the first and beta_j for both), a squared multiple correlation is true_R2_ followed by its variables, and the standard deviations and correlations are true_sd_Y, true_sd_X, true_cor_XX, and true_cor_YX. The estimators name what they are given the same way, without true_ (reg_coef_j, se_reg_coef_j, sd_Y, sd_X, std_reg_coef_j).

The regression coefficient sensitivity functions lost standardize: the name of the function says the scale. ss_aipe_reg_coef_sensitivity(), ss_aipe_rc_sensitivity(), and ss_power_reg_coef_sensitivity() report the unstandardized coefficient, as their 1.0.x default did, and ss_aipe_src_sensitivity() reports the standardized one, as its 1.0.x default did. A call that gave standardize stops with “unused argument”. The default of noncentral is TRUE in ss_aipe_src_sensitivity() and FALSE in the other two, as in DMAR 1.0.x, so the call that replaces ss_aipe_reg_coef_sensitivity(standardize = TRUE) or ss_aipe_rc_sensitivity(standardize = TRUE) is ss_aipe_src_sensitivity(noncentral = FALSE), and the call that replaces ss_aipe_src_sensitivity(standardize = FALSE, noncentral = FALSE) is ss_aipe_rc_sensitivity(). ss_aipe_src_sensitivity(standardize = FALSE), with its default noncentral = TRUE, becomes ss_aipe_rc_sensitivity(noncentral = TRUE), which is refused when the sample size is planned from supposed variances that are not 1 (see Calls That Are Now Refused). With standardize = TRUE, ss_power_reg_coef_sensitivity() gave the same power (the t statistic does not depend on the scale), so such a call drops the argument.

One name has one meaning, and the bounds of an equivalence region are named for the quantity they bound: smd_lower and smd_upper, contrast_lower and contrast_upper, cor_lower and cor_upper, and prop_diff_lower and prop_diff_upper in equivalence_proportion_paired(), which is new; plot_equivalence(), which draws whatever estimates it is given, takes effect_lower and effect_upper. cles(), nnt_from_smd(), and proportion_of_superiority() used smd_lower and smd_upper for confidence limits on d, as arguments and as rows; those are now smd_ci_lower and smd_ci_upper, the names DMAR gives the limits of an interval named for its estimate, so cles(smd = .5, smd_lower = .2, smd_upper = .8) stops with “unused argument”. convert_delta_lambda() takes smd, and convert_lambda_delta() and convert_lambda_R2() take ncp; the function names keep their symbols.

Renamed Output Rows and Columns

A row or column that echoes a renamed argument is renamed with it, a row that summarizes simulated estimates is named for the quantity (mean_reg_coef_j, mean_contrast, mean_std_contrast), and the columns of the per-replication files that the sensitivity functions write with filename follow the rows they summarize. Code that looks a row or column up by its 1.0.x name must be changed, because an old name matches nothing and gives no error: x$value[x$term == "rho"] returns numeric(0). The columns of eta_squared(), omega_squared(), ci_eta_squared(), and ci_omega_squared() are under One Function for Each ANOVA Effect Size.

The limits of every confidence interval are ci_lower and ci_upper. DMAR 1.0.x named them lower_limit and upper_limit in most functions and ci_lower and ci_upper in the coefficient tables and the tidy() results. One pair is now used everywhere, as a row of a long table, a column of a wide one, and a suffix of a limit named for its estimate (rmsea_ci_lower, cles_ci_lower). x$value[x$term == "lower_limit"] becomes x$value[x$term == "ci_lower"], and x$lower_limit becomes x$ci_lower.

function DMAR 1.0.x now
every function that reports a confidence interval rows or columns lower_limit, upper_limit ci_lower, ci_upper
every function whose limits are named for their estimate <estimate>_lower_limit, <estimate>_upper_limit (for example cles_lower_limit, smd_upper_limit, shift_lower_limit, loa_upper_lower_limit, mean_lower_limit) or <estimate>_lower, <estimate>_upper (for example tau2_lower, indirect_upper, sigma2_b_lower, eta_squared_partial_upper) <estimate>_ci_lower, <estimate>_ci_upper (cles_ci_lower, smd_ci_upper, shift_ci_lower, loa_upper_ci_lower, mean_ci_lower, tau2_ci_lower, indirect_effect_ci_upper, sigma2_between_ci_lower, eta_squared_partial_ci_upper)
combine_p() row k row n_studies
welch_t(), summary_t_test() row t_statistic row t_value
pairwise_within(), ci_dunnett(), ci_dunnett_t3() column t_statistic column t_value
contrast_test() column t column t_value
contrast_adjusted(), bayes_one_sample_t(), bayes_paired_t(), bayes_independent_t() row t row t_value
ci_scheffe() columns contrast_value, F_statistic columns estimate, F_value
ci_c_ancova() row psi row contrast, as in ci_c()
ci_sc_ancova() row psi row std_contrast, as in ci_sc()
equivalence_c() rows psi_hat, delta_lower, delta_upper rows contrast, contrast_lower, contrast_upper (the lower bound is still signed); plot_equivalence() reads them
ci_rc() rows lower_limit, upper_limit only rows ci_lower, reg_coef, ci_upper: the coefficient sits between its limits, as in ci_reg_coef() and ci_src()
var_r() row var_r_bonett_wright removed with kurtosis_x and kurtosis_y (see Calls That Are Now Refused)
ss_aipe_partial_r(), ss_aipe_semipartial_r(), ss_aipe_partial_r_sensitivity(), ss_aipe_semipartial_r_sensitivity() row J row p, holding p
expected_partial_r() columns n, J, rho columns N, p, true_cor
expected_r() columns n, rho columns N, true_cor
equivalence_r() rows n, rho_lower, rho_upper rows N, cor_lower, cor_upper (the lower one still holds the negative bound)
ss_aipe_r(), ss_power_r(), ss_aipe_partial_r() row rho row true_cor
ss_power_r() row rho_0 row null_cor
ss_aipe_r_sensitivity(), ss_aipe_partial_r_sensitivity() rows true_rho, estimated_rho rows true_cor, supposed_cor
ss_aipe_semipartial_r() row r_sp row true_r_sp
ss_aipe_semipartial_r_sensitivity() row estimated_r_sp row supposed_r_sp (beside the new rows true_R2_full and supposed_R2_full)
ss_aipe_equivalence_r() row population_r row true_cor
ss_aipe_equivalence_r_sensitivity() rows true_r, estimated_r, rho_lower, rho_upper rows true_cor, supposed_cor, cor_lower, cor_upper
ss_aipe_R2_sensitivity(), ss_power_R2_sensitivity() row estimated_R2 row supposed_R2
ss_power_R2_sensitivity() rows mean_F, median_F, sd_F rows mean_F_value, median_F_value, sd_F_value
expected_R2() row expected_value_population_R2 row expected_R2, as var_R2() reports var_R2 (the value is unchanged)
ss_aipe_reg_coef_sensitivity(), ss_aipe_rc_sensitivity() rows mean_b_j, median_b_j, sd_b_j, true_b_j, estimated_b_j rows mean_reg_coef_j, median_reg_coef_j, sd_reg_coef_j, true_reg_coef_j, supposed_reg_coef_j
ss_aipe_src_sensitivity() rows mean_b_j, median_b_j, sd_b_j, true_b_j, estimated_b_j rows mean_std_reg_coef_j, median_std_reg_coef_j, sd_std_reg_coef_j, true_std_reg_coef_j, supposed_std_reg_coef_j (the standardized coefficient, as true_std_reg_coef_j in ss_aipe_src())
ss_power_reg_coef_sensitivity() rows mean_b_j, median_b_j, sd_b_j, mean_se_b_j, median_se_b_j, sd_se_b_j, true_b_j, estimated_b_j, mean_t, median_t, sd_t rows mean_reg_coef_j, median_reg_coef_j, sd_reg_coef_j, mean_se_reg_coef_j, median_se_reg_coef_j, sd_se_reg_coef_j, true_reg_coef_j, supposed_reg_coef_j, mean_t_value, median_t_value, sd_t_value
ci_cv() rows c_of_v, c_of_v_unbiased rows cv, cv_unbiased
ss_aipe_smd(), ss_power_smd(), ss_power_composite_ancova_2group() row supposed_smd row true_smd
ss_power_composite_ancova_2group() rows supposed_rho_group_1, supposed_rho_group_2 rows true_cor_group_1, true_cor_group_2
ss_aipe_equivalence_smd() row population_smd row true_smd
ss_aipe_smd_sensitivity() rows true_delta, estimated_delta rows true_smd, supposed_smd
ss_aipe_equivalence_smd_sensitivity() rows estimated_smd, delta_lower, delta_upper rows supposed_smd, smd_lower, smd_upper
equivalence_smd() rows delta_lower, delta_upper rows smd_lower (still the signed lower bound), smd_upper
expected_smd() column delta column true_smd
cles() rows cl, cl_lower, cl_upper, smd_lower, smd_upper rows cles, cles_ci_lower, cles_ci_upper, smd_ci_lower, smd_ci_upper
nnt_from_smd() rows nnt_lower, nnt_upper, smd_lower, smd_upper rows nnt_ci_lower, nnt_ci_upper, smd_ci_lower, smd_ci_upper
proportion_of_superiority() rows smd_lower, smd_upper rows smd_ci_lower, smd_ci_upper
ss_aipe_sc_sensitivity(), ss_aipe_sc_ancova_sensitivity() rows mean_psi, median_psi, sd_psi, true_psi, estimated_psi rows mean_std_contrast, median_std_contrast, sd_std_contrast, true_std_contrast, supposed_std_contrast
ss_aipe_sc_ancova_sensitivity() row rho row true_cor
ss_aipe_c_sensitivity() rows mean_psi, median_psi, sd_psi, true_psi, true_error_variance, estimated_error_variance rows mean_contrast, median_contrast, sd_contrast, true_contrast, true_var_error, supposed_var_error
ss_aipe_c_ancova_sensitivity() rows mean_psi, median_psi, sd_psi, true_psi, est_error_var_ancova, rho rows mean_contrast, median_contrast, sd_contrast, true_contrast, supposed_var_error_ancova, true_cor
ss_seq_c_sensitivity() row true_psi row true_contrast
ss_aipe_omega_squared() row population_omega_squared row true_omega_squared
ss_aipe_omega_squared_sensitivity() row estimated_omega_squared row supposed_omega_squared
ancova() rows eta_squared_partial_lower, eta_squared_partial_upper, omega_squared_partial_lower, omega_squared_partial_upper rows eta_squared_partial_ci_lower, eta_squared_partial_ci_upper, omega_squared_partial_ci_lower, omega_squared_partial_ci_upper
factorial_anova() columns eta_squared_partial_lower, eta_squared_partial_upper, omega_squared_partial_lower, omega_squared_partial_upper columns eta_squared_partial_ci_lower, eta_squared_partial_ci_upper, omega_squared_partial_ci_lower, omega_squared_partial_ci_upper
ss_power_rm_anova() rows necessary_n_subjects, specified_n_subjects rows necessary_N, specified_N
ss_power_one_way_anova(), ss_power_rm_anova(), ss_power_split_plot_anova(), ss_power_factorial_anova(), ss_power_factorial_ancova() row noncentrality row noncentral_f_parm
ss_power_rm_anova(), ss_power_split_plot_anova(), ss_power_factorial_anova() rows effect_df, error_df rows df_effect, df_error
ss_power_factorial_ancova() rows f, f_adjusted, covariate_R2 rows true_f, true_f_adjusted, true_covariate_R2
ss_power_contrast() row effect_size_f row true_f
variance_components_mls() rows sigma2_b_lower, sigma2_b_upper, sigma2_w_lower, sigma2_w_upper, icc_lower, icc_upper rows sigma2_between_ci_lower, sigma2_between_ci_upper, sigma2_within_ci_lower, sigma2_within_ci_upper, icc_ci_lower, icc_ci_upper
mr_smd() rows n1, n2, pilot_ss rows n_1, n_2, pilot_n_per_group
mr_cv() rows n, pilot_ss rows N, pilot_N
ss_aipe_icc() rows rho, k rows true_icc, n_raters
ss_aipe_icc_sensitivity() rows true_rho, estimated_rho, k rows true_icc, supposed_icc, n_raters
ss_power_mixed_effects() rows necessary_J_per_arm, specified_J_per_arm, noncentrality rows necessary_n_clusters_per_arm, specified_n_clusters_per_arm, noncentral_t_parm
the twelve ss_aipe_crd_*() and ss_aipe_crd_es_*() functions row exp_width_of_unstd_conditions_diff or exp_width_of_<level>_effect_size row expected_width
the twelve ss_aipe_crd_*() and ss_aipe_crd_es_*() functions row width_of_unstd_conditions_diff_with_<assurance>_assurance or width_of_<level>_effect_size_with_<assurance>_assurance rows assured_width and assurance
the eight ss_aipe_crd_*() and ss_aipe_crd_es_*() functions that solve for the cluster size (_n_individuals_ and _both_) row cluster_size row necessary_cluster_size
ss_aipe_reliability() rows specified_assurance, empirical_assurance, final_iter rows assurance, assurance_attained, G
ss_aipe_reliability_sensitivity() rows items, estimated_reliability rows n_items, supposed_reliability
reliability(), reliability_alpha(), reliability_omega(), reliability_omega_categorical(), reliability_kr20() row J row n_items
ss_aipe_mixed_effects() row icc row true_icc
ss_aipe_mixed_effects_sensitivity() rows true_sigma2_y, true_sigma2_x, estimated_sigma2_y, estimated_sigma2_x, estimated_icc, true_beta, mean_beta, median_beta, sd_beta; column beta of the file written with filename rows true_total_var, true_var_X, supposed_total_var, supposed_var_X, supposed_icc, true_reg_coef, mean_reg_coef, median_reg_coef, sd_reg_coef; column reg_coef
ss_power_pcm() rows unstd_coefficient, std_coefficient, true_var_of_slopes, l1_error_var, error_var_of_slopes rows true_reg_coef, true_std_reg_coef, true_var_trend, true_var_error, true_var_trend_error
ss_power_pcm() row freq row frequency
ss_power_pcm() row measurement_occasions row n_occasions
ss_aipe_pcm_sensitivity() rows true_variance_trend, true_error_variance, estimated_variance_trend, estimated_error_variance rows true_var_trend, true_var_error, supposed_var_trend, supposed_var_error
ss_aipe_pcm_sensitivity() row n_timepoints row n_occasions
ss_aipe_indirect_effect() rows a, b, ab rows true_std_reg_coef_a, true_std_reg_coef_b, true_std_indirect_effect
ss_power_indirect_effect() rows a, b, c_prime, indirect_effect, actual_power rows true_std_reg_coef_a, true_std_reg_coef_b, true_std_reg_coef_direct, true_std_indirect_effect, power_ab (the power to detect the indirect effect, followed by power_a and power_b as before; tidy() and glance() read it as the power of the design)
ss_aipe_indirect_effect_sensitivity() rows mean_ab, median_ab, sd_ab, true_a, true_b, true_ab, estimated_a, estimated_b; column ab of the file written with filename rows mean_std_indirect_effect, median_std_indirect_effect, sd_std_indirect_effect, true_std_reg_coef_a, true_std_reg_coef_b, true_std_indirect_effect, supposed_std_reg_coef_a, supposed_std_reg_coef_b; column std_indirect_effect
mediate() rows indirect_lower, indirect_upper, direct_lower, direct_upper, total_lower, total_upper rows indirect_effect_ci_lower, indirect_effect_ci_upper, direct_effect_ci_lower, direct_effect_ci_upper, total_effect_ci_lower, total_effect_ci_upper (the estimates are the rows indirect_effect, direct_effect, and total_effect)
ss_aipe_composite_sem() rows desired_width_<label>, population_<label>, width_within_desired_<label> rows width_<label>, true_<label>, pct_ci_less_width_<label>
ss_power_composite_sem() rows population_<label> rows true_<label>
ss_power_composite_anova(), ss_power_composite_factorial_anova(), ss_power_composite_ancova(), ss_power_composite_factorial_ancova(), ss_power_composite_factorial_ancova_het() rows f_<label>, noncentral_parm_<label>, residual_df rows true_f_<label>, noncentral_f_parm_<label>, df_error
the same five planners rows necessary_N, specified_N (beside the per-cell size); approximate_N row total_N; approximate_total_N
ss_power_composite_ancova(), ss_power_composite_factorial_ancova(), ss_power_composite_factorial_anova() row covariate_R2 row true_covariate_R2
ss_power_composite_factorial_ancova_het(), and ss_power_composite_ancova(slopes = "heterogeneous"), which returns its table attributes means, correlations, sigma, sd_cov attributes true_means, true_cor, true_sd, true_sd_X (read by the plot() method)
ss_power_composite_ancova_2group() rows sigma, sd_cov, residual_df rows true_sd, true_sd_X, df_error
ss_power_composite_ancova_2group() rows necessary_N, specified_N (beside the per-group size); approximate_N row total_N; approximate_total_N
ss_aipe_cliff_delta() row delta row true_delta
ss_aipe_cliff_delta_sensitivity() row estimated_delta row supposed_delta
ss_aipe_cv_sensitivity() row estimated_cv row supposed_cv
ss_aipe_sm_sensitivity() row estimated_sm row supposed_sm
design_consequences() row target_width row width
ss_aipe_r(), ss_aipe_partial_r(), ss_aipe_semipartial_r(), ss_aipe_icc(), ss_aipe_omega_squared(), ss_aipe_indirect_effect(), ss_aipe_cliff_delta() row width_target row width
ss_aipe_equivalence_r(), ss_aipe_equivalence_smd(), ss_aipe_mixed_effects() row ci_width_expected row expected_width
ss_power_R2() row effect_size row true_f2
ss_power_reg_coef(), ss_power_rc() row effect_size row true_f (Cohen’s f, the square root of true_f2)
meta_es(), meta_r(), meta_smd(), meta_contrast() row k row n_studies
meta_es(), meta_r(), meta_smd() rows tau2_lower, tau2_upper, I2_lower, I2_upper rows tau2_ci_lower, tau2_ci_upper, I2_ci_lower, I2_ci_upper (prediction_lower and prediction_upper, the limits of the prediction interval, keep their names)
meta_es(), meta_r(), meta_smd() row t under the Hartung-Knapp adjustment, z without it row test_statistic under either; the reference distribution is in the attributes test_distribution ("t" or "normal") and test_df (n_studies - 1, or NA), and a line under the printed table states it
meta_contrast() row z row test_statistic (the attribute test_distribution is "normal" and test_df is NA)
procrustes_phi() row n_perm row n_resamples
design_consequences() and the 25 ss_aipe_*_sensitivity() functions of DMAR 1.0.x row pct_ci_less_w row pct_ci_less_width
design_effect() row n_total row N
obrien_test() column n_total column N
contrast_adjusted() row p row p_value
anova_within_two_way(), simple_effects_AB() column partial_eta_squared column eta_squared_partial
anova_within() attribute partial_eta_squared attribute eta_squared_partial
R2_mixed_effects() (ci_method = "boot") rows R2_marginal_lower, R2_marginal_upper, R2_conditional_lower, R2_conditional_upper rows R2_marginal_ci_lower, R2_marginal_ci_upper, R2_conditional_ci_lower, R2_conditional_ci_upper (its tidy() still gives ci_lower and ci_upper columns)
bayes_one_sample_t(), bayes_paired_t() row n row N
ci_proportion() row n row N
cohen_kappa() column n column N
vargha_delaney_A() column z_value column test_statistic
mlmr(), mlmr_mv() (the coef_table); cfa_k(), cfa_1(), cfa_2() (the parameter table) column z_value column test_statistic
dmacs() columns lambda_reference, lambda_focal, nu_reference, nu_focal (and the same columns of tidy()) columns factor_loading_reference, factor_loading_focal, intercept_reference, intercept_focal
irt_information() column theta; attributes a, b, theta_max_information column trait_value; attributes discrimination, threshold, trait_value_max_information
covmat_from_cfa() element population_cov of the returned list element model_implied_cov
power_equivalence_md_plot() column diff of the power_grid attribute (and of the plotted data) column true_effect (ratios when logscale = TRUE, as before; the n=<size> columns keep their labels)
reliability_H() from loadings rows reliability_H, lower_limit, upper_limit, var_H the reliability family table: rows estimate, se, ci_lower, ci_upper, conf_level, N, N_complete, n_items (var_H is the square of se)
ss_aipe_rmsea_sensitivity(), ss_aipe_sem_path_sensitivity() row suc_rep removed; attr(x, "simulation")$returned
ss_aipe_R2_sensitivity() row num_probs_with_cis removed; attr(x, "simulation")$failed
ss_aipe_reg_coef_sensitivity(), ss_aipe_rc_sensitivity() columns b_j, ll_ci_beta_j, ul_ci_beta_j, r_2, se_b_j, t_for_b_j of the per-replication file written with filename columns reg_coef_j, ci_lower, ci_upper, R2, se_reg_coef_j, t_value
ss_aipe_src_sensitivity() the same six columns of its file columns std_reg_coef_j, ci_lower, ci_upper, R2, se_std_reg_coef_j, t_value
ss_power_reg_coef_sensitivity() columns b_j, se_b_j, t_stat, r_2 of its file columns reg_coef_j, se_reg_coef_j, t_value, R2
ss_power_R2_sensitivity() columns r2, f_stat of its file columns R2, F_value
ss_aipe_R2_sensitivity() columns r2, lower_width_ci, upper_width_ci, width_ci of its file columns R2, ci_width_lower, ci_width_upper, ci_width, the names of the rows that summarize them
ss_aipe_c_sensitivity() column psi_hat of its file column contrast
ss_aipe_c_ancova_sensitivity() columns psi_obs, se_psi, se_psi_restricted of its file columns contrast, se_contrast, se_contrast_restricted
ss_aipe_sc_sensitivity(), ss_aipe_sc_ancova_sensitivity() column psi_obs of the file column std_contrast
ss_aipe_rmsea_sensitivity(), ss_aipe_sem_path_sensitivity() columns ci_low, ci_up of the file columns ci_lower, ci_upper; a file begun by DMAR 1.0.x keeps its header when a run appends to it
var_cv() rows var_cv_mckay, var_cv_vangel row var_cv_normal, which holds the value that var_cv_mckay held; var_cv_vangel is removed (see Changes to Earlier Results)

The reasons for each name are in One Notation for the Regression and Correlation Functions, below.

The removed rows suc_rep and num_probs_with_cis held counts of replications, which every sensitivity function now reports one way, in the simulation attribute of its table (see Changes to Earlier Results): suc_rep was the number of replications that gave an interval, and num_probs_with_cis the number that did not. reliability_H() returns the same table for every kind of input; the table of DMAR 1.0.0 is not returned for any call, and there is no warning period (see Coefficient H From a Fitted Model).

The column that holds a test statistic is test_statistic wherever the reference distribution depends on an option: under test = "t" in vargha_delaney_A(), and under a finite wald_df in the multilevel and confirmatory factor analysis tables, the statistic is referred to Student’s t, so z_value named it wrongly. The meta-analysis functions named their statistic t under hartung_knapp = TRUE and z without it (z in meta_contrast()); it is test_statistic in all four, with the reference distribution in the attributes test_distribution and test_df and in a line under the printed table, and the table of meta_contrast() now has the class dmar_meta_contrast, a dmar_tbl. Otherwise a column whose name is always true keeps it (z_value in cohen_kappa() and fleiss_kappa(), t_value in welch_t() and its relatives).

The common language effect size is the row cles wherever it is reported: cles() named it cl, as randomization_test() did not, and results_sentence() on a cles() table begins “cles =” where it began “cl =”.

ss_power_R2_change() is new in this release, so its rows true_f2 and true_partial_R2 have no 1.0.x names; they are named as planning values like every other row that holds one. The same holds for the other functions new in this release: ss_aipe_two_phase(), ss_aipe_two_phase_cost(), and ss_aipe_two_phase_sensitivity() echo true_cor, and the sensitivity function supposed_sd_Y and supposed_cor; equivalence_proportion_paired() reports its bounds in the rows prop_diff_lower and prop_diff_upper; ss_aipe_mean_sensitivity() echoes supposed_sd; ss_aipe_crossed_sensitivity() echoes supposed_var_unit, supposed_var_rater, and supposed_var_residual; and ss_aipe_mixed_effects_sensitivity() echoes supposed_icc_X.

Calls That Are Now Refused

Conditions That Gained a Class

A condition with a class can be caught or muffled by name, whatever its wording. Every error and every warning DMAR signals on purpose now has a class. Every error is a dmar_refusal and carries a code, so tryCatch(expr, dmar_refusal = function(e) ...) catches whatever DMAR refused, and an error without that class came from R, from another package, or from match.arg(). The check of an argument (its type, length, or range, arguments that cannot be given together, a column that is not in the data, a model the function does not cover) is a dmar_argument_invalid, which carries the names of the arguments at issue as arg (NULL where the refusal is not about a named argument, and in some checks whose message names the argument only in running text). Three more general classes cover the errors that have no class of their own: dmar_package_required (a package the analysis needs is not installed; field package), dmar_computation_failed (the arguments were accepted and a search, a fit, a refit, or a bootstrap made with them gave no result), and dmar_internal_error (a state DMAR’s own code should not reach). Two cover the warnings that have none: dmar_result_qualified (the result is returned with something to know before using it) and dmar_argument_ignored (an argument given has no effect on the call). The more specific classes (dmar_not_converged, dmar_no_maximum, dmar_lavaan_error, dmar_inadmissible, and the others the sections below name) are dmar_refusals as well; dmar_bootstrap_cancelled and dmar_progress_error, which come from the caller’s progress function, are not. In 1.0.0 nearly every error was a plain error and no error was a dmar_refusal. Messages are worded as before, except that some of the oldest checks now name the argument and state the rule (for example “‘c_weights’ must sum to zero.” in place of “The sum of the coefficients must be zero”). The help of dmar_metadata() lists the classes.

ss_aipe_cv() and ss_aipe_sm() refuse an assurance that is not NULL or a single number strictly between 0 and 1 with dmar_assurance_invalid (the condition carries the value given; the message says why neither end is accepted). dmar_argument_invalid, which carries the name or names at issue as arg, is the class of the refusals of ss_power_R2_change() for a p_restricted not below p_full, for squared multiple correlations that cannot belong to nested models, and for an effect stated in more than one way; of the partial and semipartial correlation functions for a p below 2; and of smd() and smd_c() for unbiased = TRUE without the sample sizes. One warning joins a class its siblings already gave: ss_aipe_reliability_sensitivity() reports replications without an interval with dmar_replications_without_interval (fields n_without_interval and G). The count of noncentral F lower-limit clamps that ss_aipe_R2() reports after its search has the new class dmar_nc_F_clamp_search, with the field n_evaluations. The wording of each message is unchanged, except that the refusals of smd() and smd_c() now also say why the sizes are needed. The warnings about the accurate range of the noncentral t distribution that ci_nc_t() and the searches built on it gave in DMAR 1.0.x are gone, since every limit is now computed exactly (see Exact Noncentral t and Studentized Range Distributions).

Where a check’s message opens with the name of the argument and the check did not store it, arg is read from the message, so tryCatch(bayes_one_sample_t(mean = .5, sd = 1, N = 30, prior_location = NULL), dmar_refusal = function(e) e$arg) returns "prior_location" where it returned NULL.

A Two-Level Planner and a Sensitivity Function That Describe One Design

Overview

A minor release, and a large one. DMAR 1.0.1 was prepared but never submitted to CRAN; its changes are part of this release, and its section below is kept as the record of them.

Factor analysis gets its own names and new models. fa_confirmatory() is the 1.0.0 cfa_k() and fa_exploratory() its new exploratory partner, with cfa_k() and plot_cfa_k() kept as aliases, efa_k() a new alias of fa_exploratory(), and the 1.0.0 result class kept after the new one; fa_exploratory() fits incomplete items by FIML, gives rotation-aware intervals, and rotates to a target; factor_count() and parallel_analysis() compare numbers of factors; fa_bifactor() and fa_second_order() fit the bifactor and second-order models, with delta method intervals for their indices; factor_scores() gives per-case standard errors and the determinacy of each factor, beside 2 rho^2 - 1, the lowest correlation two equally consistent sets of scores can have; and factor_congruence() gives Tucker’s congruence between two solutions. Structural equation models get measures of fit, precision, and comparison (sem_fit_measures(), sem_residual_fit(), sem_information_criteria(), sem_exact_fit_bootstrap(), equivalence_rmsea(), compare_sem()) and sem_sam(), which estimates the structural relations after the measurement models.

A missing data family states what the missing values cost: the fraction of missing information for every parameter of a FIML fit, the patterns and coverage behind it, the maximum likelihood covariance matrix of incomplete data, and small-sample degrees of freedom with a t reference distribution for Wald intervals, taught in a new vignette. Two-stage maximum likelihood is a missing data option for the CFA family, measurement invariance, and coefficients alpha and omega, and sample size planning for a reliability coefficient can allow for the missing values it will be estimated from. The omega of reliability_omega(), reliability_omega_categorical(), and bifactor_indices() can take either the observed or the model implied variance as its denominator and says which it used; categorical omega no longer needs mvtnorm, no longer drops a correlation the data do not determine, and takes incomplete items; coefficient H is computed from a fitted model; the bifactor indices get bootstrap intervals; and the reliability bootstrap counts the fate of every replication, runs on several processes, refuses a solution that leaves no coefficient, and takes a progress callback that can cancel it.

New intervals, tests, and plans: Dunnett’s T3 (ci_dunnett_t3()); the difference between two proportions measured on the same units, with tests of noninferiority and equivalence (ci_proportion_paired(), equivalence_proportion_paired()); Fieller’s confidence set for the ratio of two means (ci_ratio_of_means(), ci_ratio_of_means_paired()); nonsuperiority in equivalence_c(); the marker variable adjustment for common method variance with its interval and test (common_method_adjusted_r()); planning the interval for a single mean (ss_aipe_mean()) and the assurance of a contrast’s interval when the errors are not normal (true_kurtosis in ss_aipe_c()); a crossed design of units and raters (ci_crossed(), ss_aipe_crossed()); and two-phase sampling, a costly measurement with an inexpensive proxy (ci_two_phase(), ss_aipe_two_phase(), ss_aipe_two_phase_cost(), ss_seq_two_phase()). A new vignette fits classical tests as path models in lavaan, and a knitted result table now carries every line the console prints under it. A result table prints its numbers to three decimal places, where 1.0.x printed three significant figures (see Changes to Earlier Results). eta_squared(), omega_squared(), and their intervals report the total and the partial value of each effect and take sums of squares from a published table; ss_aipe_smd(), ss_aipe_sc(), ss_aipe_sc_ancova(), ss_aipe_reg_coef(), ss_aipe_rc(), and ss_aipe_src() can find the sample size for assurance from the probability that the interval is no wider than asked for, computed exactly or simulated from the exact sampling distribution; ss_power_indirect_effect() takes its power from the joint sampling distribution of the two path tests, with the predictor measured or fixed by design; and the noncentral t distribution and the studentized range are computed exactly wherever R’s pt(), qt(), dt(), qtukey(), and ptukey() are not accurate.

Some defaults change results. DMAR 1.1.0 gives no warning when a result or a default differs from 1.0.x; these notes describe every such change. The changed defaults are described under Changes to Earlier Results, each with the argument that restores the 1.0.x analysis where there is one; ss_aipe_rmsea_sensitivity() also corrects how it forms its intervals, which no argument restores. fa_confirmatory() (with its alias cfa_k(), and with cfa_1() and cfa_2()) fits raw data by full information maximum likelihood and takes the standard errors that match the estimator (Huber-White under MLR, where 1.0.x took the standard ones), and reliability_omega(), reliability_alpha(), and measurement_invariance() fit incomplete data that way (as does reliability_H(), which takes data for the first time in this release); reliability_omega() forms the default interval of the model implied omega on the logit scale; and ci_rmsea(), ss_aipe_rmsea(), and ss_aipe_rmsea_sensitivity() form and plan a 90 percent RMSEA interval by default, where 1.0.x used 95 percent. ss_aipe_semipartial_r() without the new true_R2_full plans for the largest variance over every full-model R2, which raises the sample size when true_r_sp squared is above 1/2 (true_R2_full = true_r_sp^2 restores the 1.0.x plan), and ss_aipe_partial_r_sensitivity() and ss_aipe_semipartial_r_sensitivity() simulate one more variable partialed out than 1.0.x did for the same model, which no argument restores. ss_aipe_partial_r() and ss_aipe_semipartial_r() find the sample size for assurance from the sampling distribution of the estimate, where 1.0.x multiplied by a chi square factor that does not apply to these intervals, and ss_aipe_partial_r_sensitivity() simulates the raw-scale interval it plans, where 1.0.x simulated Fisher’s Z interval; no argument restores the first, and fisher_z = TRUE gives the Fisher interval, planned and simulated, for the second. Every function names the total sample size N, the number of predictors p, a planner’s planning value true_X, a sensitivity function’s planning value supposed_X, and the desired width width, and names an argument for the quantity it holds (true_cor, true_contrast, true_reg_coef_j, true_cov_matrix) rather than for a symbol; the 1.0.x names are not accepted, eta_squared_partial(), omega_squared_partial(), and ci_eta_squared_partial() are removed, and the count of the partial and semipartial correlation functions is the number of predictors, one more than the 1.0.x count of variables partialed out (see Breaking Changes in 1.1.0). vargha_delaney_A() refers its test statistic to Student’s t with Satterthwaite degrees of freedom, which gives a larger p-value than the standard normal reference of 1.0.x (test = "z" restores it). With assurance, ss_aipe_smd(), ss_aipe_sc(), ss_aipe_rc(), ss_aipe_reg_coef() with its default noncentral = FALSE, and their sensitivity functions return the smallest sample size, not below the plan without assurance, at which the exact probability that the interval is no wider than width reaches the request (the new argument assurance_method, "analytic" by default), where DMAR 1.0.x returned published approximations that could attain more or less than the request. ss_aipe_sc_ancova(), ss_aipe_reg_coef() with noncentral = TRUE, ss_aipe_src(), and their sensitivity functions return the published approximations by default, and assurance_method = "simulation" returns the smallest sample size at which a simulated estimate of that probability reaches the request. The four regression and ANCOVA planners without assurance return the smallest sample size that meets the width, where 1.0.x could return a case or more above it (a few more per group in ss_aipe_sc_ancova()), and the approximations, which start from that plan, move with it. No argument restores the plans of ss_aipe_r(), ss_aipe_smd(), and ss_aipe_sc() with assurance, the central plans of ss_aipe_reg_coef() and ss_aipe_rc() with assurance or with unequal tails, the plans without assurance of ss_aipe_reg_coef(), ss_aipe_rc(), ss_aipe_src(), and ss_aipe_sc_ancova(), which can be a case or more smaller, and the approximations that start from them, the plans and true values of ss_aipe_src_sensitivity() when the variances of Y and of the targeted predictor differ, the plans of ss_aipe_equivalence_smd() and its sensitivity function and of the standardized cluster randomized planners, the power and plans of ss_power_indirect_effect(), the rows of var_alpha(), or the simulated contrasts of ss_aipe_sc_sensitivity(), each corrected in this release. fa_confirmatory() on complete data gives the same estimates as 1.0.x, but under ML its standard errors come from the observed information, the item intercepts join the table, and AIC and BIC count them; and its omega, average variance extracted, and H rows get limits formed on the logit scale, as reliability_H()’s already were, as described under Exploratory Models and Structural Relations. Its RMSEA interval stays at the 90 percent of 1.0.0, now with an argument of its own, rmsea_conf_level: every RMSEA interval in the package, and the SRMR interval of sem_residual_fit(), defaults to 90 percent, whose limits decide the tests of close and not close fit at .05, while the other intervals keep 95 percent (see Every RMSEA Interval at 90 Percent by Default).

Every RMSEA Interval at 90 Percent by Default

Exploratory Models and Structural Relations

Estimation, Eligibility, and Inferential Records

Either Variance in the Denominator of Every Omega

One Bootstrap Engine for the Reliability Family

One Rule for Bootstrap Replications

Coefficient H From a Fitted Model

The Bifactor Model

The Second-Order Model

Intervals for the Bifactor Indices

Categorical Omega Without mvtnorm, and With Incomplete Items

Fit, Precision, and Comparison of Structural Equation Models

Missing Data: What the Missing Values Cost

Two-Stage Maximum Likelihood for Incomplete Data

Factor Scores

Planning Under Missing Data

Sample Size Planning for a Mean

Assurance When the Errors Are Not Normal

Common Method Variance: The Marker Adjustment With Its Interval

Multiple Comparisons

Two Proportions Measured on the Same Units

The Ratio of Two Means

Equivalence and Noninferiority of a Contrast

A Crossed Design of Units and Raters

Two-Phase Sampling: A Costly Measurement With an Inexpensive Proxy

One Notation for the Regression and Correlation Functions

The regression, correlation, and coefficient of variation functions now name the total sample size, the number of predictors, a planner’s planning values, and the desired width one way. No function is renamed and no result changes for a given model. The DMAR 1.0.x names are not accepted; Breaking Changes in 1.1.0, at the top of this section, lists every old and new name.

The row for the full-model planning value of ss_aipe_semipartial_r(), new in this release, is true_R2_full. A row that echoes an argument has the argument’s name, and one quantity has one row name: the desired width is the row width (seven planners and design_consequences() called it width_target or target_width), the expected width is expected_width (three planners called it ci_width_expected), and the null value of ss_power_r() is null_cor. necessary_N, specified_N, and total_N keep their names.

Power for the Change in R Squared When Predictors Are Added

The Semipartial Correlation: Its Variance, Its Plan, and the Check of the Plan

The Order-Based Effect Sizes Share One Contract

Mediation: Resamples in Which the Indirect Effect Is Defined

Total and Partial Eta Squared and Omega Squared

The Assurance Method of the Sample Size Planners

Calculators Given Population Values or Sample Summaries

Exact Noncentral t and Studentized Range Distributions

Teaching

Every Function That Draws Random Numbers Takes a Seed

Tests and Maintainer Tools

References in the Help

Bug Fixes

Changes to Earlier Results

DMAR 1.0.1

Never submitted to CRAN: these changes were released in DMAR 1.1.0. The section is kept as the record of the patch as it was prepared.

A patch release for the bootstrap intervals of the reliability family, prompted by a report from an analysis of the Big Five Inventory constructs (2026-10-14), in which every BCa interval for categorical omega failed with “estimated adjustment ‘a’ is NA” and no interval said how many replications it rested on.

The Reliability Bootstrap Counts Its Replications

DMAR 1.0.0

First public release of DMAR (pronounced “Dee-Mar,” for “Design, Measurement, and Analysis in R”), a greatly expanded reimagining of the MBESS package, published on CRAN on 2026-09-21.

Every Example Runs, and Nothing Writes or Seeds Behind the User’s Back

An Adversarial Quality Control Pass

One Prefix for Every Confidence Interval

Fitting Change Models, Linear and Nonlinear

Nonlinear Growth Curve Simulators

One Word for the Equivalence Family

Sample Size Planning for Correlation Equivalence

The Examples Teach From the Package’s Own Data

A Quieter, Faster Test Suite and ggplot2 4.0 Compatibility

One Return Schema Across the Sensitivity Family

The ICC Sample Size Planner Now Plans the Average-of-k Forms

The Noncentral F Clamp Warning Speaks the Caller’s Language

design_consequences() Now Uses the Exact Noncentral t When df Is Finite

The Robust Standardized Mean Difference Scales Correctly at Every Trim

The Robust Standardized Mean Difference Interval Now Uses the Yuen-Welch Degrees of Freedom

A Consistent Confidence Interval for Lin’s CCC

The Fleiss Kappa Test Uses the Corrected Null Variance

One-Sided Dunnett Intervals Now Contain Their Point Estimates

anova_within_two_way() Declines to Estimate an Inestimable Epsilon

ci_r() Now Requires at Least Four Observations

The AIPE Sensitivity Family Reports Coverage as Proportions

The MBCO Likelihood Ratio Is Now Branch-Deterministic

tidy() and glance() Speak DMAR’s Names, on Every Table

One Bootstrap Vocabulary, Three New Bootstrap Intervals

The CFA Family: One General Function, Two Convenience Wrappers

Measurement Invariance Beyond the Exact-Invariance Ladder

Item Response Theory, as the Categorical Factor Model

Content Validity

Mediation inference via model-based constrained optimization

API and Documentation Consistency

Ten Help Pages Now State Exactly What the Code Computes

A numerical audit compared every displayed formula and quoted magnitude on these pages against the quantity the function computes. In each case the computation was correct and the page was not, so no returned value changes; the documentation now matches the code, and new tests recompute each corrected expression independently and assert agreement with the function output.

A Second Documentation Pass: Quoted Values Now Match What Runs

A continuation of the audit above, covering another two dozen help pages. As before, the computations were correct and the pages were not; no returned value changes, and where a corrected number is load-bearing a test now recomputes it independently.

Equivalence and noninferiority for linear contrasts

Mixed-effects R-squared

Output, tidiers, and contrasts

Correctness

DMAR is the modern, more general reimplementation of MBESS that reflects how the methods are now used across quantitative psychology, sociology, education, management, marketing, and information systems. MBESS remains stable on CRAN; DMAR is the recommended path forward for new users.

New measurement functions

ANCOVA multiple comparisons

The remaining textbook critical-value tables

Pairwise comparisons without the usual assumptions

API and Documentation Consistency

Multiple-comparison critical values computed exactly

Bug fixes

Highlight features

Data sets

Migrating from MBESS

The largest visible change is a uniform snake_case interface for both function names and argument names.

There are no deprecation shims. Old MBESS argument names will throw “unused argument” errors at the call site, which is intentional; the fix is mechanical, and a silent-forwarding shim would hide it.

What is new in DMAR (beyond MBESS)

DMAR adds 40+ functions across families that were absent or under-developed in MBESS. New families include:

Internal changes

Authorship

Ken Kelley (Department of Information Technology, Analytics, and Operations; Mendoza College of Business; University of Notre Dame) is the package author and maintainer. Bug reports and feature requests are welcomed by email to kkelley@nd.edu; please put “DMAR” in the subject line.