Changelog
Source:NEWS.md
nomologR (development version)
These changes lead to 1.0.0, the stable release planned jointly with contentvalidR (#53). Its first release candidate, v1.0.0-rc.1 (version 0.99.0), is planned for 2026-10-17, after the feature freeze on 2026-10-13.
- New methods. The gap review (#129) added the methods social-science scale developers were missing, each taken from its literature.
- Fixes. A verified audit of every module (#145) found about 110 distinct defects, none critical. The fixes are listed by area: returned values, documented defaults, input checks, decision logs, APA tables, and the report.
-
One output style. Printed output, plots, APA tables, and the report follow one style, shared with
contentvalidR(#144). - The CRAN review. CRAN returned 0.3.0 with two requests. Both are met: no function writes a file unless it is given the path, and no code in the package writes to the global environment.
-
The 1.0 contract. The contract is now settled: the stability policy covers every exported function and documented field except
nomo_method_variance()andnomo_power_simulate(), which stay experimental into 1.x.
Calls whose results or behavior change are listed first. A function that is new since 0.9.0 is described once, as it is now, under “New methods” or “Invariance across groups and occasions”.
Calls that now behave differently
This section lists what a call written for 0.9.0 can run into. The sections after it give the details.
Errors where calls used to be accepted
These calls ran in 0.9.0. Most of them returned a result that was wrong, or one that had ignored the argument.
-
nomo_report()requiresfile. It no longer writesnomologR-report.htmlto the working directory by default. -
guidancewithauto_deleteorauto_respecifyset toTRUEis refused by the 13 functions that tookguidancein 0.9.0:nomo_screen(),nomo_factors(),nomo_efa(),nomo_cfa(),nomo_compare(),nomo_split(),nomo_reliability(),nomo_validity(),nomo_hierarchical(),nomo_scores(),nomo_invariance(),nomo_network(), andnomo_run(). The two settings record that nomologR never deletes an item or respecifies a model. Set toTRUE, they had been accepted and ignored. The newnomo_esem()andnomo_invariance_longitudinal()refuse it too. -
Columns stored as ordered factors are treated as ordered indicators, whether or not
orderednames them, because lavaan already fitted them that way. This applies innomo_cfa(),nomo_invariance(),nomo_network(),nomo_reliability(),nomo_validity(), andnomo_hierarchical(). The calls that newly stop arenomo_invariance()calls written for continuous indicators:levelsfrom the continuous sequence,ID.fac = "UL", an ML-familyestimator, ormissing = "fiml". Innomo_cfa()andnomo_network(), an ML-family estimator or FIML with such columns already stopped, with lavaan’s error; the message now names the columns. -
nomo_invariance():- A partial-invariance release that matches no parameter, that the model already fixes, or that would break nesting is an error.
-
ID.cataccepts only Wu and Estabrook’s identification.
-
nomo_efa()andnomo_factors()no longer acceptfm = "minrank". psych needs theRcsdppackage for it, which nomologR does not declare, so the call ran only where that package was installed. -
nomo_efa()refusesrotation = "targetQ", for which psych had silently used"Promax". -
nomo_factors()refuses anfmit does not know. An unknown value had been accepted and recorded, and psych ranminresin its place. -
nomo_hypotheses()andnomo_network()refuse a directed path and an association for the same pair.nomo_network()also refuses a hypothesis that adds a path opposite to another, and an ordered-factor covariate. -
nomo_screen()checksreverseandscale_rangein every mode. Witheffort = TRUEit refuses a reverse-keyed item whose responses fall outsidescale_range.nomo_run()refuses an unknownreverseitem. - The content-review reader refuses a handoff whose schema version is not one whole number, whose keying is not 1 or -1, or that lists an item twice.
-
nomo_compare()refuses the model labelsfactoranditem. -
nomo_model()refuses a factor, indicator, or general-factor name that lavaan would rename or cannot read. -
nomo_reliability()refuses aci_level,ci_boot, orci_seedthat is not one valid value. -
nomo_scores()refuses aguidancethat is not a list. -
nomo_run()refuses at the start what used to surface at a later stage: a scale with fewer than three items, an invariancegroupthat is not a column, and a missing-data strategy lavaan does not have. When a run is resumed, it refuses two kinds of settings it used to store unused: those for an invariance or network branch that a complete run marked not requested, and those forscoresormissingonce the CFA is fitted. Settings for a completed or blocked stage were already refused. -
nomo_revise()refusescfa_modelinsidedecisions. -
nomo_apa_table()refuses atypefor a result that has one table and atitlethat is not one string.nomo_apa_table(x, "factor_correlations")stops for a model that fixes every factor correlation, such as a bifactor model; it had tabled the fixed zeros as estimates.nomo_table()refuses atypefor anomo_hypothesesobject.
Results that change
-
Item screening.
- The careless-responding indices of
nomo_screen(effort = TRUE)on short item sets. -
floor_propandceiling_propwhenscale_rangeis given. - Which items of a declared scale are reviewed on an item-rest correlation.
- The careless-responding indices of
-
Factor retention and EFA.
fm = "minchi"innomo_efa()andnomo_factors(), andnomo_efa()’s cases per item when item values are missing. -
CFA and model comparison.
-
nomo_cfa()’sfit_evidencewhen lavaan cannot compute a scaled test, and itsordered. -
nomo_compare()’srelationwhen nesting cannot be checked,models$dffor adjusted tests, and the pair names inevidence. Models whose missing-data handling lavaan applied alike are now compared.
-
-
Reliability and validity.
-
nomo_reliability()for a multi-group fit and beside a single-indicator factor. -
nomo_validity()’s HTMT cases under FIML, itsavewhen indicators cross-load, and the flag of a construct pair that has no HTMT.
-
-
Hierarchical models.
nomo_hierarchical()under the theta parameterization, and with a negative variance. -
Scores.
nomo_scores()’s parallel-model test, when its univocality note appears, and the class of itssummary(). -
Invariance. In
nomo_invariance(): the sequence for ordered-factor columns, the level a release applies from,completed_levels, and the version of the fit statistics under a robust estimator. -
Nomological network.
nomo_network()’s concordance values, what its measurement context is judged on, theestimatorit records and, for some networks, the fitted model. -
Missing data. The label of a
nomo_missing()strategy when lavaan ran another method than the one requested. -
Guided workflow. The settings the downstream stages of
nomo_run()are fitted with, the keying a run takes from acontentvalidRhandoff, and whatnomo_revise()keeps of that handoff. -
Methods. What
nomo_methods(x)credits, and the text, dates, and references of the registry. -
Tables. The headings and cells of
nomo_apa_table(), and the columns of an emptynomo_table(). - Printed numbers. Display rounds half away from zero. Returned values are unchanged.
New refusals
Input that used to fail inside lavaan, psych, or nomologR, with an error that named neither the function nor the argument, now stops early with a message that does. A call that worked is not affected.
-
nomo_screen(): data with two columns of one name, and a handoff that carries no items or is not a list. -
nomo_factors()andnomo_efa():fm = "alpha"where psych cannot fit it (innomo_factors(), and with one factor innomo_efa()),fm = "minrank"without theRcsdppackage, a misspelledrotation,"bifactor"and"biquartimin", an ordinal item with more than 8 categories under polychoric or mixed correlations, and atypesvector with a missing name. -
nomo_cfa(),nomo_split(), andnomo_compare(): anmi_top,seed, orreferencebeyond R’s integer range. -
nomo_invariance(): an unknownID.fac. -
nomo_network(): a hypothesis that names a variable lavaan cannot read. -
nomo_scores(): a factor with no observed indicators, a path from an observed covariate to a factor, and a covariance between a factor and an observed variable. -
nomo_table(): an object that has no tables. -
nomo_apa_table(): factor correlations for a higher-order model. The error had said that the model has one factor.
Fixes from the audit, by area (#145)
Item screening and careless responding
-
nomo_screen(effort = TRUE)no longer produces careless-responding flags or values by arithmetic (#145).-
Antonym and synonym correlations. A respondent needs at least three usable pairs, as the help page said. One who left a pair member unanswered had been given a correlation over two pairs, which is exactly +1 or -1, and could be flagged on it.
antonym_randsynonym_rare nowNAfor that respondent. -
Even-odd consistency.
even_oddis bounded at -1, ascareless::evenodd()bounds it. The Spearman-Brown correction passes -1 at a within-person correlation of -1/3 and diverges below it, and had returned values such as -482. A within-person correlation of exactly -1, which wasNA, is now -1. Values above -1 are unchanged. -
Long-string. The half-length rule is flagged only when at least
long_string_min_itemsitems are screened, a new setting innomo_defaults()(20). With fewer items, each case’s run is still reported inlong_string, no case is flagged on it, and the decision log states the number of items and the share of cases that reached half the length. Before, the rule flagged every case at one or two items and about a third of attentive respondents at six.effort_settingsgainslong_string_min_itemsandlong_string_rule_applied, and the print reads “Long-string: not applied”. Results are unchanged at 20 or more items; setguidance$long_string_min_itemslower to apply the rule to a shorter set. -
An index without a value. The decision log says why: the
mahalanobisandper_scale_indicesrows, andeven_oddwhen it is not computed.
-
Antonym and synonym correlations. A respondent needs at least three usable pairs, as the help page said. One who left a pair member unanswered had been given a correlation over two pairs, which is exactly +1 or -1, and could be flagged on it.
-
nomo_screen()checks the declared response scale and keying (#145).-
In both modes. With
effort = FALSE, areversenaming an item that is not screened, areversethat is not character, and ascale_rangethat is notc(min, max)with min below max were accepted silently, although both arguments feed the item audit’s keying explanation. They are now errors, as witheffort = TRUE. A non-finitescale_rangeis refused in both modes. -
Keying without a range. Naming reverse-keyed items without
scale_rangeis still refused witheffort = TRUE. Witheffort = FALSEthe audit runs, and akeying_not_usedrow says the declared keying was not used. -
Responses outside the range. They get an
out_of_rangerow, a concern. Witheffort = TRUE, a reverse-keyed item with such responses is refused; it had been recoded on the wrong scale. -
Floor and ceiling.
floor_propandceiling_propof a numeric-discrete item use the ends ofscale_rangewhen it is given. The row for a concentrated item suggestsscale_rangeonly for a numeric-discrete item.
-
In both modes. With
- The item audit within declared scales (#145).
- An item that is the only one of its declared scale, or is in a scale with too few complete cases, is no longer reviewed on the pooled item-rest correlation. An
item_rest_not_computedrow says so. - A forward-keyed item whose rest score holds a declared reverse-keyed item not yet recoded says so, and gives the item-rest value with exactly those items recoded. So does the row for negative inter-item correlations.
- A negative pair with an item outside every declared scale is named as such.
-
non_finite_scoresis one row per item, named by the item, so the item review flags it.
- An item that is the only one of its declared scale, or is in a scale with too few complete cases, is no longer reviewed on the pooled item-rest correlation. An
-
response_distributioncounts numeric values that differ only past 15 digits once (#145). - The content-review reader says what it took from a
contentvalidRhandoff (#145).-
Decision-log rows.
keying_completedandscales_overrideare new.keying_overrideappears only when the call replaced declared keying. The provenance row credits construct membership to content review only when the review made one, and a held-back item with no recommendation is no longer quoted as “NA”. - A handoff without items. The error gives the review’s status counts and its carry rule.
-
Decision-log rows.
Factor retention and EFA
-
nomo_efa()andnomo_factors()report the minimum pairwise N beside the case count (#145). Under the defaultmissing = "pairwise",n_casescounts every row, including rows with no item data, so it can overstate the information in the correlations. Both now print “Cases: 500 (minimum pairwise N: 473)” when the two differ, andnomo_factors()returnsmin_pairwise_n, asnomo_efa()already did;n_caseskeeps its meaning.nomo_efa()’ssample_adequacy$cases_per_itemand its small-sample review row now use the minimum pairwise N, asnomo_factors()’s prompt already did, so the two functions agree on whether a sample is small. Nothing changes without missing item values or withmissing = "complete". - Every
fmvaluenomo_efa()andnomo_factors()document now runs as documented (#145).-
"minrank".nomo_efa()no longer lists or accepts it: psych needs theRcsdppackage for it, which nomologR does not declare, so it failed on a default install. -
"alpha".nomo_efa(fm = "alpha")with one factor stops with a clear message, because psych cannot fit a one-factor alpha solution. -
nomo_factors(). It now checksfmand lists the values that work for parallel analysis;"alpha"and"minrank"stop with that list. So does a value it does not know, for which psych had runminreswhile the result recorded the value as given. -
"minchi". It now runsminchiin both functions. psych had quietly fittedminresinstead, because nomologR did not pass the pairwise sample sizesminchineeds. Results withfm = "minchi"change.
-
-
nomo_efa()records a solution that is improper or did not converge; it had discarded psych’s warnings (#145).- Heywood cases. An item with a communality of .995 or more gets a concern row in the decision log, which states the item’s unique variance, because psych’s extractions often stop just short of 1. A communality above 1 is reported as an ultra-Heywood case.
- Convergence and identification. An extraction that stops at its iteration limit gets a concern row, and so does a model with more factors than its items can identify (negative degrees of freedom). Zero degrees of freedom is a prompt for review.
- Other messages. Any other psych warning or message is recorded in the decision log for review.
-
Display.
print()lists these under “Solution checks” and counts a Heywood item among the item flags.summary()and the items plot show it as a concern. Stored item flags are unchanged.
-
nomo_efa()checksrotation(#145).- A misspelled name stops with the list of accepted rotations.
- A target rotation stops with the reason:
nomo_efa()passes no target matrix, and psych had silently used"Promax"for"targetQ". -
"bifactor"and"biquartimin"also stop with the reason: psych runs them throughGPArotationonly when psych is attached, and only for three or more factors. - The decision log describes the solution that was fitted. A one-factor solution is not rotated, and
"none"and orthogonal rotations are prompts for review. Only an oblique solution asks for its factor correlations.
-
nomo_efa(factors = <nomo_factors>, factor_count = k)runs when parallel analysis suggested 0 factors (#145). Withoutfactor_count, the error says that parallel analysis suggested 0 and gives an example. -
nomo_efa()completes a partialguidancelist fromnomo_defaults(); it had failed with “argument is of length zero” (#145). - For polychoric and mixed correlations,
nomo_factors()andnomo_efa()score ordinal items by the rank of their observed values (#145). Items coded 0/25/50/75/100 or 1/3/5, and factors with a level nobody chose, no longer fail in psych. Items coded 1, 2, 3, … give the same results as before, and Pearson correlations still use the values as coded. - With tetrachoric or mixed correlations,
nomo_factors()andnomo_efa()no longer print a blank line for every simulated data set (#145). psych’s warning for each smoothed matrix is replaced by one decision-log row. -
nomo_factors(criterion_set = "minimal")no longer prints, plots, defines, or logs revised MAP, which that set does not include (#145).
CFA, model comparison, model syntax, and sample splitting
-
nomo_cfa()treats model indicators stored as ordered factors as declared, whether or notorderednames them (#145). lavaan already fitted such columns as categorical. The result, though, recorded no ordered indicators, gave the estimator asDWLS, and logged that lavaan’s continuous-data default was retained. As a resultnomo_methods(x)credited ML,nomo_reliability()stopped with a semTools error, andnomo_compare()refused the same model fitted withordered. WLSMV is now requested explicitly, the indicators are recorded inorderedand the print, and the decision log flags them for review. Onnomo_demo_ordinalthe fit is unchanged, and a guided run withoutorderedno longer stops at the reliability stage. With an ML-family estimator or FIML, such columns stop the fit with a message that names them, where lavaan’s error used to appear. -
nomo_cfa()counts only the model’s own variables inordered(#145). Declared names that are not in the model are left out ofordered, the print, and the count, and the decision log lists them. -
nomo_cfa()’sfit_evidenceno longer mixes versions of a fit when lavaan cannot compute a requested scaled test statistic (#145). lavaan can then still report a scaled RMSEA, such as 0 for a model whose standard RMSEA is 0.22, and that value had been shown beside the standard chi-square and CFI. In that case every value is now the standard one, and the decision log says so for review. Otherwise the order is unchanged (robust, then scaled, then standard values), so ML with FIML still reports lavaan’s robust CFI, TLI, and RMSEA beside the standard chi-square. The RMSEA interval is always the one around the RMSEA reported. - In a higher-order model,
nomo_cfa()reports a negative first-order disturbance once, as a negative latent variance; it had also been reported as a negative observed residual variance (#145). A weak second-order loading now asks for the first-order factor’s definition to be inspected, not item content. -
nomo_compare()(#145):-
Nesting. When the nesting check cannot run and nesting was not declared,
relationis"undetermined", printed “nesting not determined”, and the comparison is logged for review. Before, it read “not nested” at severity info. The help lists everyrelationandnesting_checkvalue. -
Degrees of freedom.
models$dfis the degrees of freedom of the chi-square beside it. For mean-and-variance adjusted tests such asMLMVS, it had paired the scaled chi-square with the model’s degrees of freedom. Nesting anddf_differencestill count the models’ degrees of freedom. -
Pairs. HTMT2 rows of
evidencename a pair in model order (“A vs B”), asnomo_validity()does. -
Missing data. Models are compared by the missing-data handling lavaan applied, so
missing = "fiml"against"ml", or the default against"listwise", is no longer refused as different handling. -
Improper solutions. An
improper_solutionrow, a concern, names each compared model that has one. -
Warnings. The help says what
engine_warningsholds: the warnings from the nesting check and the difference test for each compared model. Each fit keeps its own lavaan warnings infits.
-
Nesting. When the nesting check cannot run and nesting was not declared,
-
nomo_model()(#145):-
Bifactor structures that are not identified. Two structures it accepts are not identified without an added constraint. One is a group factor with two indicators, whose loadings enter the covariances only through their product. The other is two group factors with no more than three indicators each. The help and notes had called them weakly identified or possibly unstable. The notes now say they are not identified, at severity concern; lavaan may still report convergence, but the loadings are arbitrary.
notesis named by severity (“review” or “concern”), and the print prefixes each note with it. These structures are still accepted, and no constraint is added. -
Names. A name lavaan would rename or cannot read stops with a suggested replacement. lavaan had fitted “self-efficacy” as a factor called
efficacy.
-
Bifactor structures that are not identified. Two structures it accepts are not identified without an added constraint. One is a group factor with two indicators, whose loadings enter the covariances only through their product. The other is two group factors with no more than three indicators each. The help and notes had called them weakly identified or possibly unstable. The notes now say they are not identified, at severity concern; lavaan may still report convergence, but the loadings are arbitrary.
-
nomo_split()records the random-number generator its seed depends on, in a newrng_kindfield, the decision log, and the print (#145). The same seed under anotherRNGkind()gives a different split.
Reliability, validity, and hierarchical models
- Reliability and validity now read semTools’ results by construct and group (#145).
-
Multi-group fits.
nomo_reliability()had given every coefficient of a multi-group CFA the block “overall”. The summary then paired one group’s omega with another group’s alpha, and bootstrap intervals landed on the wrong group.blocknow names each coefficient’s group, andsummary(),nomo_table(), the bootstrap intervals, andnomo_apa_table()follow it; the APA table has one row per construct and group. -
Single-indicator factors. In a model with a single-indicator factor beside one scale, the scale’s omega and alpha were filed under the invented name “construct_1”. They now keep the scale’s name. The single-indicator factor’s
alpha_statusand a decision-log entry say that no reliability is estimated for it. -
Cross-loaded indicators. When every factor had a cross-loaded indicator,
nomo_validity()’savewas empty andprint(),summary(), andnomo_table()failed. Each factor now keeps its row. An AVE that a cross-loading leaves undefined isNAwith attention “unavailable”, and the log records it as information.
-
Multi-group fits.
-
nomo_reliability(),nomo_validity(), andnomo_hierarchical()treat columns stored as ordered factors as ordered indicators, as lavaan fitted them, even whenordereddoes not name them (#145).nomo_reliability()had treated them as continuous and failed at the alpha step. -
nomo_validity()flags a latent correlation against the HTMT-family reference, reading the limit of its interval farthest from zero (Rönkkö & Cho, 2022) (#145).latent_correlationsgainsreferenceandattention, and the decision log gainslatent_correlationrows.-
Pairs with HTMT. The
signalofnomo_table(x, "discriminant")is still the HTMT2 (or HTMT) flag where one was computed. When the latent correlation’s interval reaches past the reference but HTMT2 does not, the pair is not flagged: the log records it as information, and the summary names the pair. -
Pairs without HTMT. Where neither was computed (several groups, a cross-loading, a covariance-matrix fit, or
htmt = "none"),signalcomes from the latent correlation; it used to be “unavailable”. A latent correlation near 1 is therefore flagged in those cases too, andplot(x, type = "discriminant")draws the latent correlation with its interval; it had stopped. - Beyond 1. A latent correlation beyond 1 is a concern either way.
- An HTMT that cannot exist. With one construct, or for a construct with one indicator, it is logged as information, not as a review or concern flag.
-
Pairs with HTMT. The
-
nomo_validity()’shtmt_missing = "default"follows the fitted model’s missing-data handling: FIML when the CFA used it, pairwise deletion when it used that, and listwise deletion otherwise (#145). Despite its help page, it had always used listwise deletion, so on a FIML CFA, HTMT rested on fewer cases than the CFA.htmt_statusgainsmissingandn, and a decision-log entry records the cases HTMT used. The entry is for review only when a different handling leaves HTMT with fewer cases than the CFA. -
nomo_reliability()checksci_level,ci_boot, andci_seedbefore using them (#145). It had cut a vector to its first element and truncated a fraction. A bootstrap request for a model fitted from a covariance matrix says that raw data are needed, and requested intervals that are not available get a review row. -
nomo_hierarchical()(#145):- Theta parameterization. It gives the same indices for an ordered model fitted with lavaan’s theta parameterization as with delta. Under theta, omega had exceeded 1, and every index except PUC was wrong.
-
Negative variances. It no longer fails with “missing value where TRUE/FALSE needed” on a negative disturbance or factor variance. The indices that depend on it are
NA, and a concern note names the variance. - Plots. The caption names any composite or loading a plot leaves out.
- With lavaan’s theta parameterization and ordered indicators,
nomo_validity()adds a review row that gives the mean squared standardized loading, the AVE of the delta fit, andnomo_reliability(ordinal_scale = FALSE)adds one for the latent-response omega and alpha (#145). -
plot()for anomo_reliabilityobject takestype, as the other plot methods do;"coefficients"is the one type (#145).
Measurement invariance
-
nomo_invariance()models indicators stored as ordered factors as ordered, whether or notorderednames them (#145). lavaan already fitted such columns as categorical, but nomologR recorded them as continuous and used the continuous sequence. The scalar model was then unidentified, and a population latent difference of .50 SD was reported as 0.00. They now get the threshold-aware sequence, WLSMV, and the theta parameterization.orderedincludes them, a newordered_detectedfield lists them, and the decision log flags them for review. Calls written for continuous indicators can therefore stop:levelsfrom the continuous sequence (such asc("configural", "metric", "scalar"), where the ordered sequence adds"thresholds"),ID.fac = "UL", an ML-familyestimator, ormissing = "fiml". Each such error names the detected indicators and says to convert them to numeric to model them as continuous. - A partial-invariance release must name a loading, intercept, threshold, or residual variance of an indicator in the model, and must free it (#145). semTools ignores a release it cannot match. A misspelled item (
"ag9 ~ 1") or a factor name with the wrong case had left the model fully constrained while the fit table, summary, and decision log reported the release. Such releases are now errors, as is one the generated model fixes, such as a marker loading underID.fac = "UL". - A release applies from the level that first holds its parameter type equal (#145). Declared earlier, such as an intercept at
metric, it is moved to that level:partialand the summary show the level it applies from, and the log records the declared one. Declared later, such as a loading atscalar, it is an error. The metric model had held that loading equal and the scalar model freed it, so the two were not nested, yet their likelihood-ratio test and fit changes were reported as usual. -
ID.cataccepts only Wu and Estabrook’s (2016) identification,"Wu.Estabrook.2016", or a semTools alias for it (#145). Under"millsap"or"mplus", the levels kept the Wu-Estabrook sequence and notes. The thresholds step then also constrained the intercepts, and the scalar step added nothing. -
ID.facaccepts semTools’ spellings (“UV”, “fixed.factor”, …) as the method they name, so ordered indicators accept them (#145). An unknown spelling is refused with the choices. -
completed_levelsholds only the levels that were estimated and converged (#145). A level that failed stays infit_evidence. When the first level failed,print(),summary(), and the invariance line ofnomo_run()’s key evidence say “none”; the output has no empty fit table and points to the decision log. - The analyzed sample is reported (#145). New fields
n_usedandgroup_nhold it, andprint()andsummary()show it, such as “Cases: 447 of 800 used (A n = 232, B n = 215)”. When lavaan’s listwise deletion leaves cases out, the decision log gets a review row. - Every level shows one version of each fit statistic (#145). The chi-square is scaled, and CFI and RMSEA are robust, where every level has those versions. A new
fit_variantsfield names the version, and the output says which is shown. - Engine problems are flagged (#145). lavaan’s warnings at each level, and a level that fails or does not converge, become decision-log rows and appear under “Flagged”. lavaan’s messages are quoted as sentences in plain words, such as “observed-variable variances” where lavaan abbreviates.
- With three or more groups, each score diagnostic frees one group’s parameter from the value the others share (#145). It is labeled by the group it frees, as in “Intercept: y3 (three vs. others)”, no longer “(one vs. three)”, which read as a comparison of two groups. The first group, the reference, is never freed on its own: when it alone differs, every other group shows similar strain. A note and the help say so.
-
plot(x, type = "local_strain")without diagnostics no longer warns, andsummary()has no empty section of changes (#145).
Nomological network
-
nomo_network()judges associations against the model that is fitted (#145).-
Associations. An
A <-> Bhypothesis was called “already in model” frommodelalone, where lavaan covaries exogenous factors by itself. When another hypothesis made A or B an outcome, lavaan no longer added that covariance, so the hypothesis ended “Not evaluable” whilemodel_relationssaid the relation was in the model. The hypothesized directed paths are now put in place first, and each association is added when the model to be fitted lacks it. For such networks the fitted model changes, and a hypothesis that could not be evaluated is now estimated. -
A directed path or an association, not both.
nomo_hypotheses()refuses a set that gives the same two variables both a directed path and an association, andnomo_network()stops when an association hypothesis names a pair the model joins with a directed path. These calls ran before and returned a hypothesis without an estimate.nomo_network()also stops when a hypothesis would add a path opposite to another, because a reciprocal pair is not identified without further restrictions; before, it fitted that model. A reciprocal pair thatmodelitself writes is fitted as before, and hypotheses about both directions are evaluated. -
Residual associations are labeled. When the fitted model also predicts an endpoint of
A <-> B, by a directed path or because the endpoint is an indicator of a factor, the covarianceA ~~ Bis between residuals, so the estimate is the association left after those predictors. Onnomo_demo_network, with Agency predicting both,Persistence <-> Performanceis estimated at -.06 where the model-implied correlation is .13. The estimate is unchanged. Itsevidence_scopeis now"residual_association", its interpretation says so, and the decision log has aresidual_associationrow for review.
-
Associations. An
-
nomo_network()records the relations that the hypothesized paths change (#145). The new fieldmodel_changeslists three kinds of change, the decision log records each one (relation_constrainedfor review,relation_auto_freedfor information), and?nomo_networkstates lavaan’s rule.- A path that makes a variable an outcome fixes to zero its covariances with exogenous variables other than its predictors (
"fixed_to_zero"). - A variable that only the hypotheses bring into the model is related only as lavaan’s defaults allow: an observed predictor of a factor is uncorrelated with the exogenous factors (
"not_estimated", with the variable innew_variable). - Two outcomes gain a residual covariance nobody wrote (
"added_by_lavaan").
- A path that makes a variable an outcome fixes to zero its covariances with exogenous variables other than its predictors (
-
nomo_network()judges the measurement context on the fit of the measurement model alone, which is the network with its structural part saturated (#145). It had used the fit of the whole network.- The network’s own fit is a separate
model_fitrow of the decision log. It reports the Delta chi-square test of the structural restrictions (measurement_context$fit,measurement_context$structural_test). - The row calls misfit strain on the theory’s structure only when the measurement model alone meets the references. Otherwise it points to the measurement context.
- A network whose structural restrictions misfit no longer marks its measurement context, or each hypothesis’s
measurement_attention, for review.
- The network’s own fit is a separate
- Concordance values (#145).
- New value
"direction_concordant_above_magnitude": an estimate with the predicted sign that is larger than the region allows had been labeled “below magnitude”. - An estimate whose whole interval lies outside the region is now
"inconsistent"even when its sign is as predicted; before, a prediction with a magnitude could fail only on sign. The below- and above-magnitude values now apply only when the interval still reaches the region. - An estimate without a standard error is
"not_evaluable", and the measurement context is a concern when no standard error could be computed. - In replication, the above-magnitude value counts as compatible with the prediction, as the below-magnitude value does. A direction that both samples share against the prediction is described as such and logged as a concern.
- New value
- Ordered factors (#145). Variables of the fitted model stored as ordered factors, in
dataorvalidation_data, are treated as declared inordered. The result’sorderedlists them, the log has anordered_detectedrow for review, WLSMV is recorded as the estimator, and the ML-family and FIML checks apply. Estimates are unchanged when the sample’s own columns are ordered factors. When a column is an ordered factor in only one ofdataandvalidation_data, both samples are now fitted with it declared ordered, which changes the other sample’s estimator and estimates. An exogenous covariate stored as an ordered factor is refused, with a message asking for a numeric or dummy-coded column: lavaan does not model a covariate as ordered-categorical. -
nomo_network()reports what was analyzed (#145).-
Cases.
n_usedandvalidation_n_usedhold the cases each sample analyzed. Output reads “Cases: 479 of 800”, and acases_usedrow flags rows dropped by listwise deletion for review. -
Estimator.
estimatorholds the estimator lavaan used, such as"ML", when none was requested; it had beenNA. -
Fit statistics.
fit_evidencenames the version of its statistics (chisq_version,index_version), andsummary()prints it with the estimator. -
The validation sample. Its decision-log rows have the stage
"network_validation". -
Unstandardized bounds. An
unstandardized_metricrow names the identification behind an unstandardized bound on a latent variable, which?nomo_expectationsand?nomo_networknow explain.
-
Cases.
Scores and missing data
-
nomo_scores()tests the parallel model that unit weighting assumes against a model it is nested in (#145). The parallel model is now the fitted model with equal loadings and equal residual variances added and nothing else changed. It is refitted with the fit’s own estimator, missing-data handling, and cases. It had been written from the loadings alone and refitted with lavaan’s defaults. Results for a default correlated-factor model fitted by maximum likelihood are unchanged.-
Fixed factor covariances. With uncorrelated factors (
orthogonal = TRUEorA ~~ 0*B), the parallel model freed the covariances and could fit better than the fitted model. A negative chi-square difference with p = 1 was then reported as “consistent with these data”. For the Holzinger and Swineford three-factor model the difference was -24.95 on 9 df; it is now 36.36 on 12 df, p < .001. -
Residual covariances. A residual covariance was dropped from the parallel model, and so tested together with the parallel constraints (75.3 on 13 df with
x7 ~~ x8). It is now kept, and only the constraints are tested (69.53 on 12 df). -
Robust and FIML fits. With
estimator = "MLR"ormissing = "ml", the test was reported as “could not be computed”. It is now computed, as lavaan’s scaled difference under a robust estimator. -
When there is no test. In each of these cases
parallel_test$availableisFALSE: a negative or missing difference, a fitted model that is already parallel, loadings fixed at different values, or a fit without a test statistic (test = "none").parallel_test$notegives the reason, with lavaan’s message where it gave one.
-
Fixed factor covariances. With uncorrelated factors (
-
nomo_scores()says what the scores are (#145).-
Which case. Results gain
rows, the row of the fitted data each score belongs to. After listwise deletionscoreshas fewer rows than the data, and nothing said which cases were missing from it.scoresitself is unchanged:data[x$rows, names(x$scores)] <- x$scoresjoins the scores to the data. -
Cases with no score. Under FIML a case the model used can lack an item, and its sum or mean is
NA. A review note now gives the cases scored on each factor, and the print adds a Scored column. -
Ordered indicators. lavaan’s
"regression"scores are then empirical Bayes modal scores and its"bartlett"scores are maximum-likelihood scores from the categorical model, while"sum"and"mean"add category numbers. The note had said the scores treat the latent responses as continuous. Values are unchanged. - Fits it cannot score. Three kinds of fit are refused with the reason: a factor with no observed indicators, such as a second-order factor; a path from an observed covariate to a factor; and a covariance between a factor and an observed variable. They had stopped with an internal error.
-
Which case. Results gain
-
nomo_scores()’s notes (#145).-
Univocality. A score correlates with another factor through its own, by the factor correlation times its validity. The note had fired whenever a score correlated .30 or more with another factor, so it flagged every correlated-factor model. It now fires when the correlation departs from the factor correlation times the validity by .05 or more, and it names both values. The
univocalitycolumn is unchanged. - Opposite signs. A concern is raised when a unit-weighted score adds an item whose standardized loading has the opposite sign to its factor’s strongest loading, and it names the item.
- Reliability. The note points a sum score to omega from the fitted model; alpha equals omega only under essential tau-equivalence.
-
Univocality. A score correlates with another factor through its own, by the factor correlation times its validity. The note had fired whenever a score correlated .30 or more with another factor, so it flagged every correlated-factor model. It now fires when the correlation departs from the factor correlation times the validity by .05 or more, and it names both values. The
-
summary()of anomo_scoresobject has classsummary_nomo_scores, matching the other summary classes (#145). It wassummary.nomo_scores, which is kept as a second class for one release and then removed. -
nomo_missing()(#145):-
Strategy labels. A strategy is labeled by the method lavaan used. When lavaan runs two-stage ML where FIML was requested, as with ULS, the strategy reads “Two-stage ML (requested FIML)” in
strategies$label, the print, and the decision log. - The flagging rule. The half-standard-error flag is described as adapted from Schafer and Graham (2002), who judged bias over simulated samples. Applied to a difference within one sample, it marks a difference to review; sampling variability alone can exceed it. The rule is unchanged.
-
summary(). It prints missing values by variable, fit and reliability by strategy, every difference from the reference, and each decision’s recommendation. It had printed base R’s listing. - Several strategies. With more than one comparison strategy, the print and summary give each strategy’s differences a table of its own. A narrow console had dropped the Strategy column and left rows that could not be told apart.
-
Help.
?nomo_missinggives its result in the “fields to read” form the other result pages use.referenceandfitted_asare now documented, and so covered by the stability policy.fits, the refitted models, is named withcall,object, andorderedas outside the stable interface.
-
Strategy labels. A strategy is labeled by the method lavaan used. When lavaan runs two-stage ML where FIML was requested, as with ULS, the strategy reads “Two-stage ML (requested FIML)” in
- New
plot()methods, each takingtype(#145): fornomo_scores, each score’s validity against Gorsuch’s references; fornomo_missing, each difference from the reference, in reference standard errors.
Guided workflow
- The stages of
nomo_run()agree with one another (#145).-
Estimation settings. The invariance and network stages refit the measurement model with the CFA stage’s
ordered,estimator, andmissingfromsettings$cfa, unless their own settings name them. A CFA estimated with FIML, a robust estimator, or ordinal indicators used to be refitted downstream as listwise, normal-theory, continuous ML, on a different N, with nothing in the log. Anestimation_settings:<stage>row records what was inherited and any setting of the stage’s own that differs from the CFA’s; naming one asNULLin a stage’s settings asks for the default. -
Item sets and item types. Once the CFA is fitted, a
cfa_item_setrow says when the measurement model’s items differ from the screened scales. Anitem_typesrow says when the exploratory stages treated items as categorical and the CFA treats them as continuous.
-
Estimation settings. The invariance and network stages refit the measurement model with the CFA stage’s
-
nomo_run()and acontentvalidRhandoff (#145).-
Keying.
settings$screen$reverseandscale_rangeare resolved one at a time, asnomo_screen()does. Giving either one used to replace the handoff’s declared keying entirely. Supplying the response scale a handoff had not recorded, which the run asks for, silently dropped the handoff’s reverse-keyed items, and supplyingreversealone blocked the run for want of a range the handoff had. Now each comes from the settings if given there, else from the handoff, and akeyingrow records a declared value replaced or a response scale supplied. -
Unknown items. A
settings$screen$reversethat names an item outside the run’s scales is refused in both effort modes. Witheffort = FALSE, the per-scale item audits used to drop a misspelled name without a word.
-
Keying.
-
nomo_run()checks what it is given before any stage runs (#145): a scale with fewer than three items, an invariancegroupthat is not a column of the confirmatory data, and asettings$missing$strategiesname that is not a lavaanmissingoption. - Resuming a run (#145).
-
Settings. Settings given when resuming are merged argument by argument, and a
settings:<stage>row records the change. Settings for a completed or blocked stage were already refused. The refusal now also covers an invariance or network branch that a complete run marked not requested, andscoresormissingonce the CFA is fitted; those settings had been stored unused. At the pause after a"revise"decision, settings for evidence the run has not computed are accepted, sincenomo_revise()carries them into the revision. -
Guidance. Resuming with
guidance = nomo_defaults()no longer fails becausenomo_defaults()has gained an element since the run was saved; only a changed value stops the resume.
-
Settings. Settings given when resuming are merged argument by argument, and a
-
nomo_revise()(#145):-
The handoff is kept. A revision of a run whose scales came from content review keeps the
contentvalidRhandoff. The revised run was built from the plain scale list, so it lost the handoff’s declared reverse keying, the content-review and held-back rows of the decision log, and the report’s content-review section, and relabeled item membership as researcher input. The revised run now carries all of these, and declared keying follows its items. -
Departures from content review. A scale whose items differ from those content review carried is recorded as the researcher’s definition. Each held-back item a revision reinstates, or carried item it removes, gets its own row (
reinstated:<item>,removed:<item>) with the rationale of the revision that made the change. -
Decisions. A
factor_countgiven indecisionsis used; the revision had been refused when the inherited count no longer fitted the revised items.cfa_modelinsidedecisionsis refused, since the fitted model is the one thecfa_modelargument gives and the lineage records.decisionsis validated before it is merged, and each scale keeps its own inherited rationale. -
A priori revisions. The
revisionrow of the log no longer says that an a priori revision was evaluated on the sample that motivated it. It says that the parent and the revision are evaluated on the same sample, or on the same validation rows, so the model that is retained still needs confirming in independent data.
-
The handoff is kept. A revision of a run whose scales came from content review keeps the
-
nomo_table()for a guided run (#145).nomo_table(run, "settings")gains rows forscoresandmissingand avaluescolumn.nomo_table(run, "recipe")namesnomo_scores(),nomo_missing(), and the careless-responding screen when they were requested. - The run’s own decision log (#145). The missing-data row names only the strategies that were fitted, a held-back item’s missing status or recommendation is no longer quoted as “NA”, and a parallel-analysis count of 0 gets its own request with a usable example.
?nomo_runlists the log’s columns and the values ofsource.
Report
-
Breaking:
nomo_report()requiresfile(#145). It used to default to"nomologR-report.html"in the working directory, and CRAN policy asks packages not to write to the user’s file space by default. A call withoutfilenow stops with an error that names the argument and suggests a path, before anything is written. Calls that givefileare unchanged; to keep the old behavior, passfile = "nomologR-report.html". -
nomo_report()writes the report and nothing else (#145). It renders in a scratch directory undertempdir(), which holds the copy of the template, the intermediate files, and the figures and is removed when the call returns; the finished report is then copied tofile. A render that stopped part-way had left a directory of figures besidefile, and every call left a copy of the template intempdir(). The report’s code runs in an environment whose parent is the base environment, so objects in the workspace are neither read nor changed. The working directory, options, and graphics device are left as they were. -
nomo_report()shows what the run holds, as written (#145).-
Model syntax and quotes. Pandoc reads Markdown inside table cells, so lavaan’s
~~vanished from the modification-index, network, and decision tables,a*x1 + a*x2lost its asterisks, and straight quotes became typographic. Cells, headings, and notes built from data are now escaped, including the content-review table of acontentvalidRhandoff. - Text that starts like a list. A rationale beginning “1) …” or “(a) …” became a numbered list in the HTML report, which lost the typed marker and ran on through the rows after it. Such cells are shown as typed.
- Call history. The workflow’s calls are printed as R code, so a copied call parses.
-
Numbers. p values read “< .001” where they read 0, counts and degrees of freedom are whole numbers, and each statistic has the precision and leading zero printed output gives it. Proportions stored as
pct_*are shown as percentages: 3% missing had read 0.03. Residual correlations have three decimals; with two, every row of the EFA residual table read 0.00. -
Deviations. A scale whose name contains “post”, “partial”, “deviation”, or “revision”, such as
PostpartumDepression, no longer has its scale definition and factor count listed under “Deviations and post hoc decisions”. -
Missing data. With complete data the section says the reference strategy was not fitted; it had said “No comparison strategy was fitted” under a table showing one. Strategies are named (“FIML”, not
ml) in every table. - Title. The title is shown as given. Inline R code in it had been run, backslashes dropped, and HTML interpreted.
-
Software citations. Each DOI is given once, as its
https://doi.org/address. - Careless responding. The evidence table keeps the rows that say why an index has no value.
-
Model syntax and quotes. Pandoc reads Markdown inside table cells, so lavaan’s
APA tables and nomo_table()
-
nomo_apa_table()no longer misreports what a table shows (#145).-
Reliability. The interval heading carries the level the intervals were computed at, such as
ω [90% CI], and the note gives the method and the number of bootstrap draws. The alpha column and its sentence are left out when no alpha was computed. Omega for ordered indicators is named: categorical omega for the observed ordinal scores (Green & Yang, 2009), or omega for the latent responses. - Invariance. A level fitted with releases is labeled “Partial scalar”, and a specific note names the freed parameters. The note gives the group sizes, N, and the estimator, and says when the chi-squares are scaled statistics and CFI and RMSEA robust values. The first model’s change cells are blank, because no model precedes it.
- Fit. The note spells out the estimator, such as “maximum likelihood with robust standard errors and a scaled test statistic (MLR)”. The network fit table reports the cases analyzed, not the rows supplied, and mentions the validation sample when there is one. Degrees of freedom that are not whole keep two decimals.
-
Hypotheses. Each prediction is given with its region, such as “Negligible, [-.15, .15]”. A
negligible()prediction shows the equivalence interval its concordance is judged on. The evidence labels are the ones the console prints, such as “In region, imprecise”, and the note defines each label the table shows. -
Factor correlations. A correlation the model fixes, such as one set by
A ~~ 0*B, is no longer tabled as an estimate with a [.00, .00] interval; the note lists the pairs left out. A model that estimates no factor correlation stops with the reason. For a bifactor model, which fixes every one, the call had returned a table of zeros; for a higher-order model, the error had said that the model has one factor.
-
Reliability. The interval heading carries the level the intervals were computed at, such as
-
nomo_apa_table()notes and layout follow APA style more closely (#145). Some headings and cells change, so code that readsbodyby column name may need updating.- Every abbreviation in a heading is defined in the note, CI and r among them, and an em dash is explained wherever one appears.
- Without
number, the number line is left out; it had been printed as a bare “Table”. - Knitted, the general, specific, and probability notes are separate paragraphs, and each column’s share of the width follows its widest entry.
- Knitted to PDF, Greek letters and math symbols are written as TeX math, so the default
pdflatexengine compiles the tables. It used to stop at the firstχ.
-
nomo_apa_table()refuses invalid arguments it used to ignore (#145): atypefor a result that has one table (nomo_reliability(),nomo_invariance()), and atitlethat is not a single string, which was pasted together. -
nomo_table()(#145):- Other objects. An object without tables is refused with the list of supported classes; the error had been base R’s “no applicable method”.
-
Hypotheses. A
nomo_hypothesesobject has one table, so atypeis an error; it used to be ignored. -
Empty tables.
"partial"for an invariance analysis without releases and"replication"for a network without validation data return a tibble with no rows and the table’s usual columns. They had returned a tibble with no columns.
Methods registry
-
nomo_methods(x), and so the methods section ofnomo_report(), credits what ran (#145).-
Estimator. A CFA is credited from the estimator the result records. ML and its robust forms are maximum likelihood, and WLSMV is credited only for ordered indicators.
ULS,GLS,WLS,DWLS, andULSMVhad been credited as maximum likelihood, or as WLSMV when indicators were ordered; a new registry entry,cfa_other_estimator, now credits them. -
Extraction and rotation. An EFA is credited with its extraction for every
fm: MINRES forminres,uls,ols, andold.min, and a new entry,common_factor_extraction, forml,pa,wls,gls,minchi, andalpha, which had been credited with none. Any oblique rotation is credited as “Oblique rotation”, varimax as before, another orthogonal rotation by a new entry,orthogonal_rotation_other, and a solution that was not rotated with no rotation; it had been credited with varimax. -
Equivalence testing. It is credited only where a test could run: in
nomo_network(), when a hypothesis has an equivalence interval; innomo_hypotheses(), when a negligible prediction states its region. A barenegligible()had credited it.
-
Estimator. A CFA is credited from the estimator the result records. ML and its robust forms are maximum likelihood, and WLSMV is credited only for ordered indicators.
- The registry’s text, dates, and references are corrected (#145). Values in
nomo_methods()change; its columns do not.- What each method estimates. Revised MAP is the trace of the fourth power of the partial-correlation matrix, not a mean of fourth-power correlations. Coefficient alpha equals reliability under essential tau-equivalence and is a lower bound when loadings differ. KMO is the sum of squared correlations divided by that sum plus the squared partial correlations. The scaled-and-shifted difference test is shifted to match a chi-square’s mean and variance, not to stay positive.
-
Dates. Change-in-fit evidence for invariance cites Cheung and Rensvold (2002) and is dated 2002, not 2007. Bootstrap intervals for reliability are no longer dated 2016 from a later evaluation;
introducedisNA. - References. Short citations follow APA 7, with “et al.” for three or more authors. Rönkkö and Cho (2022) has its pages, Satorra (2000) its editors, and Fokkema and Greiff (2017) its subtitle.
- A wrong
stageorlineageinnomo_methods()is reported in the package’s form for a wrong choice, “stagemust be one or more of …” (#144).
Output style shared with contentvalidR (#144)
nomologR and contentvalidR now print, plot, and tabulate in one style, so a project that uses both reads as one. The changes are to what is shown. No field, argument, nomo_table() type, or decision-log column changes for it; the observations in decision logs follow the same number rules.
-
Headers. Every
print()andsummary()begins with its class and a title, such as<nomo_cfa> Confirmatory factor analysisand<nomo_cfa summary> Confirmatory factor analysis. A technique taken from one source names it on the next line. -
Numbers by kind. Each statistic has one precision and one leading-zero rule wherever it is printed.
- Leading zeros. A statistic bounded by 1 drops the zero, such as “CFI .973”, a factor correlation, omega, AVE, power, or a p value. One that can exceed 1 keeps it, such as “TLI 0.965”, RMSEA, HTMT, or a loading.
- References. A reference is written like the value it is compared with (“.950” beside CFI). A flagged value shows the decimals that tell it from its reference: “The communality, .3997, is below the .40 teaching reference.”
-
Rounding. Display rounds half away from zero, as
contentvalidRdoes, so .625 prints .63. A value that rounds to zero never prints with a sign. -
Tests. A test reads “chi-square(34) = 75.83, p < .001”, and a difference test “Delta chi-square(1) = 46.91, p < .001”. A p value that would round to 1.000 prints “p > .999”, in the console, in
nomo_apa_table()cells, and in decision-log observations. - Missing values. A missing value prints “–” in console tables; APA tables keep the em dash. An interval with a missing bound prints “–”, never half of it.
- Width. Prose stops at 79 columns on a wide console, and wrapped text never breaks inside a statistical clause such as “p < .001” or “[0.28, 0.51]”. On a narrow console a table first narrows the space between its columns, then drops columns from the right. It never drops a status or p column, and a line beneath it names each dropped column and the call that shows it.
- Flagged sections. Each output has one “Flagged” section, with concern before review. A bullet names the unit and its status, as in “- b5 (Review): …”, and units with the same explanation are listed together.
- Status words. A flag reads “Review”, “Concern”, or “Not computed” in a table and at the start of a line, and a cell without a flag is blank. Other statuses are in sentence case (“Converged: yes”, “Origin: a priori”), and “a priori” and “post hoc” take no hyphen.
- Abbreviation keys. Every abbreviation an output shows is defined in it, under “What these columns mean” or “Abbreviations”.
-
Pointer lines. Each
print()ends with a line that names where the rest is, such assummary(x)ornomo_table(x, "fit"). - Plot symbols. A plot draws a status by shape, and repeats it in color: a filled circle for no flag, an open circle for review (it was a triangle), a filled square for concern, and a cross for not computed. A legend appears whenever a point is flagged. Reference lines are dashed and named, an axis for a statistic that cannot exceed 1 drops the leading zero, and captions wrap to the plot.
-
APA tables.
print()of an APA table opens with the<nomo_apa_table>header and fits the console: a table too wide wraps its long headings and text cells, then drops columns from the right and names them. A note marker prints as “(a)” in the cell and before its note. In the HTML report, the manuscript tables have APA rules (above the table, beneath the headings, below the table) and no rule under each row. - The report. Flags, statuses, and origins use the words above. A note at the top says how values are rounded and what the dash and the flag words mean, and a closing “Abbreviations” table defines every abbreviation the report shows. Evidence flagged for review or concern is under “Flagged”, concern first. Columns with no value in any row are left out, and a note names them. Component summaries are printed at 80 columns whatever the width of the console that rendered the report.
Where one class changes more than that:
-
nomo_screen(). “Items in correlation diagnostics” replaces “Relationship eligible”, and one line says why category items have no correlations. The item-rest plot is now a dot plot. The evidence map and the item-rest plot no longer have a “note” level or green bars. -
nomo_factors()andnomo_efa(). Agreement between two criteria is no longer called “strong converging evidence”, and zero factors has its own text. Bartlett’s test is written as other tests are, and is marked approximate for non-Pearson correlations. Percentiles read as ordinals (“93rd”). -
nomo_cfa()andnomo_compare(). The chi-square line says which test it is, such as the Yuan-Bentler scaled test statistic. The summary of a CFA that did not converge shows no loadings, correlations, or fit. Correlations a model fixes, such as a bifactor model’s zeros, are named as fixed. Pairs read “A vs. B”. -
nomo_model().print()starts with a<nomo_model>header and wraps its identification notes. -
nomo_reliability(),nomo_validity(), andnomo_hierarchical(). Intervals are in a column of their own. The validity print counts flags by name (“Separation flags: none (1 pair)”). The hierarchical model-choice caution is information shown in the summary, not a review flag on every model, andsummary()includes the factor-score table. -
nomo_invariance(). The tables are headed “Fit by level”, “CFI change”, and “Delta chi-square”. The fit table has no cumulative “Constraints” column, which had pushed RMSEA and SRMR out at 80 columns; a line beneath it says what each level adds, such asHeld equal: loadings from metric; intercepts from scalar, except ag3 ~ 1.The fit and change plots angle the level names, and the local-strain plot gives each level its own panel. -
nomo_network()andnomo_hypotheses(). Shorter status words, such as “In region, imprecise” and “Replicated”, keep the status columns on an 80-column console. Anegligible()prediction shows the equivalence interval its concordance is judged on, post hoc predictions are marked “(post hoc)”, and a barenegligible()draws no theory-compatible band. -
nomo_scores()andnomo_missing(). The parallel-model test is printed once, as in “Delta chi-square(16) = 171.84, p < .001”, and each note is one bullet per factor under “Flagged”. -
nomo_run(). Statuses are in sentence case and stages in words. A blocked run is shown as one block that says what failed and what to do.summary()lists each component flag under “Flagged”, where it was raised, and names each fit index’s version.
Additions to the documented interface
Everything below is new since 0.9.0. The stability policy covers the functions, arguments, fields, and table types as it covers the rest of the interface. The exception is the two experimental functions, nomo_method_variance() and nomo_power_simulate(), whose output may change during 1.x without a deprecation period.
-
New functions.
nomo_esem(),nomo_invariance_longitudinal(),nomo_method_variance()(experimental),nomo_power_rmsea(),nomo_power_simulate()(experimental),nomo_retest(), andnomo_single_indicator(). Each hasprint(), and each but the last hassummary(),nomo_table(), andnomo_methods(). New datasetnomo_demo_longitudinal. -
New arguments.
single_indicatorsinnomo_network(), andtypeinplot()for anomo_reliabilityobject.fileinnomo_report()has no default. -
New settings.
long_string_min_itemsinnomo_defaults(). -
New result fields.
-
nomo_screen():long_string_min_itemsandlong_string_rule_appliedineffort_settings. -
nomo_factors():min_pairwise_n. -
nomo_split():rng_kind. -
nomo_validity():referenceandattentioninlatent_correlations;missingandninhtmt_status. -
nomo_hierarchical():briefinnotes, a one-sentence version of each note. -
nomo_scores():rows. -
nomo_invariance():n_used,group_n,ordered_detected,fit_variants, andlatent_means. -
nomo_network():model_changes,n_used,validation_n_used,single_indicators, andsingle_indicator_sensitivity;chisq_versionandindex_versioninfit_evidence;fitandstructural_testinmeasurement_context.
-
-
New values.
"undetermined"innomo_compare()’srelation;"direction_concordant_above_magnitude"innomo_network()’sconcordance;"residual_association"in itsevidence_scope;"network_validation"in thestageof its decision log. -
New
nomo_table()types and columns."latent_means"fornomo_invariance();"single_indicators"and"sensitivity"fornomo_network(), whose"fit"table gainschisq_versionandindex_version;missingandnin"htmt_status"fornomo_validity();briefin"notes"fornomo_hierarchical().nomo_table()has a method for every other object, which stops with the supported classes. -
New
nomo_apa_table()method. Fornomo_retest()results. -
New
plot()andsummary()methods.plot()fornomo_scores,nomo_missing, andnomo_powerobjects, andsummary()fornomo_missingobjects.summary()of anomo_scoresobject has classsummary_nomo_scores. -
New decision-log rows, named by their
metric, or by theiridin a guided run’s own log.-
nomo_screen():keying_not_used,out_of_range,item_rest_not_computed,mahalanobis,per_scale_indices,keying_completed, andscales_override. -
nomo_compare():improper_solution. -
nomo_validity():latent_correlationandhtmt_missing_data. -
nomo_cfa(),nomo_invariance(), andnomo_network():ordered_detected;nomo_network()alsocases_used,model_fit,relation_constrained,relation_auto_freed,residual_association, andunstandardized_metric. -
nomo_run():keying,estimation_settings:<stage>,settings:<stage>,cfa_item_set, anditem_types;nomo_revise():reinstated:<item>andremoved:<item>.
-
-
Conventions in returned tables. A new section of
?nomologRrecords three differences between tables that are kept as they are (#145).-
Proportions. Columns named
pct_*(pct_missinginnomo_screen()andnomo_missing(),pct_incomplete,pct_dropped) hold proportions from 0 to 1, as do*_propandproportion_*columns.percent_uniqueinnomo_screen(), and its reference innomo_defaults(), are percentages. -
Flags. Stored flags use three vocabularies:
KEEP,REVIEW, andSTRONG REVIEWin the loading tables ofnomo_efa(),nomo_cfa(), andnomo_validity();none,review, andconcernin the item review ofsummary()fornomo_screen(); andinfo,review, andconcernin decision logs and the other evidence tables, which may also mark a value that could not be computed asunavailable. The section gives the one wording that printed output, plots, and reports use for each. -
P-values. A p-value is
p_value, with two exceptions that keeppvalue: lavaan’s parameter tables, and the fit tables that keeplavaan::fitMeasures()names (chisq,pvalue,cfi, …). These are themodelsofnomo_esem(),nomo_method_variance(), andnomo_compare(), and the fit ofnomo_invariance()andnomo_network(). The fit tables ofnomo_cfa()(long by design) andnomo_missing()usechi_square,p_value,CFI, ….
-
Proportions. Columns named
The CRAN review and a new lavaan
CRAN returned 0.3.0 with two requests: not to write to the user’s file space by default, and not to modify the global environment.
-
No default write path.
nomo_report()requiresfile, and writes the report and nothing else (see “Report”). -
Random-number state.
nomo_factors(),nomo_split(),nomo_power_simulate(), andnomo_reliability()set their seed withwithr::with_seed(). The checknomo_power_simulate()makes of the population’s variances understandardized = TRUEdraws its data insidewithr::with_preserve_seed(). Results for a given seed are unchanged, and the caller’s random-number state is left as it was. No code in the package assigns or removes.Random.seedin the global environment any more, or writes anything else there;withrsaves and restores the state.withr(>= 3.0.2) joinsImports; ggplot2 already imports it, so it is not a new package among the dependencies. -
nomo_reliability(ci_seed = ). lavaan still seeds the bootstrap draws, so intervals for a given seed and worker count are the same. Two cases are fixed. A seeded bootstrap on more than one worker (ci_ncpus), in a session that had not yet drawn a random number, left the session on the"L'Ecuyer-CMRG"generator. A bootstrap that failed part-way could leave the session on the bootstrap’s seed. -
Examples. Every exported function has examples that run in the ordinary check, except
nomo_report()andnomo_revise(), whose examples stay in\donttest{}. -
Suggested packages. The examples and tests that need
rmarkdownare skipped without it, andcovr, which no package code uses, is no longer inSuggests.
lavaan 0.7-3 changed the default generator of lavaan::simulateData(), so the same seed gives other data than under earlier versions. Estimation is not affected.
-
Examples and articles. None draws data with
lavaan::simulateData()any more. The example ofnomo_method_variance()uses the social-desirability items ofnomo_demo_networkas the marker, and the measurement-evidence article simulates its marker example with base R, so both give the same output under every lavaan version. The test fixtures are drawn with base R too. -
nomo_power_simulate(). It still generates its samples withlavaan::simulateData(), so aseedreproduces a study only under the same lavaan version. Its help page says so.
New methods (#129)
- Sample-size planning (#129).
-
nomo_power_rmsea()gives the power of MacCallum, Browne, and Sugawara’s (1996) RMSEA tests of close, not-close, and exact fit, or the smallest N reaching a target power. It reproduces their sample sizes (for example, 132 for close fit and 178 for not-close fit at 100 df). The degrees of freedom come from a model string,nomo_model(),nomo_cfa(), or a single-group lavaan fit. A multi-group fit is refused, because lavaan’s RMSEA for several groups carries a factor of the square root of their number. So is armsea_nullthat contradictstest: the test of exact fit needs a null of 0. -
nomo_power_simulate()is Muthén and Muthén’s (2002) Monte Carlo approach. It generates data from a population model with values, fits the analysis model at each N, and reports convergence, improper solutions (Wolf et al., 2013), parameter and standard-error bias, coverage, and power. It also gives the smallest simulated N meeting their references: biases within 10%, coverage .91 to .98, and power .80 for the focus parameters. The references hold for every parameter given a population value. The result records theseedand the call. Estimates are in the metriclavaan::sem(std.lv = TRUE)sets, so a latent regression is not a standardized coefficient; the help page shows how the two differ. It warns whenstandardized = TRUEcannot give the observed variables unit variance, and names the variances the population implies.nomo_power_simulate()is experimental: it may change during 1.x without a deprecation period. -
Other outputs.
summary(),plot()(the RMSEA power curve, or a simulation’s power by sample size for each focus parameter), andnomo_table():"power"fornomo_power_rmsea(), and"summary"or"parameters"fornomo_power_simulate().
-
- New
nomo_esem()fits a measurement model as exploratory structural equation modeling (ESEM) beside its CFA (#129). Every item may load on every factor, so the cross-loadings a CFA fixes at zero are estimated, and the model still gives fit and standard errors (Asparouhov & Muthén, 2009).- Rotation. By default it uses the target rotation Marsh, Morin, Parker, and Kaur (2014) recommend for an a priori structure (Browne, 2001): each item’s own loading is free and its cross-loadings are rotated towards zero. Geomin is available too.
-
The comparison. It reports both models’ fit (
models), their factor correlations and the change between them (factor_correlations), and their difference test (comparisons); the two lavaan fits are infits. The ESEM is flagged for review when it fits better on TLI and RMSEA, which penalize its extra parameters; lower ESEM factor correlations then show that the CFA’s zero cross-loadings are inflating them. Cross-loadings at or aboveefa_crossloading_referenceand main loadings belowefa_loading_referenceare flagged as evidence about items, not instructions. -
Problems are kept. lavaan’s warnings are in
engine_warnings(a list withESEM,CFA, andcomparison) and in the decision log. A negative variance, a standardized loading above 1, or a latent correlation above 1 in either model is logged as a concern and shown under “Flagged”. A model that does not converge stops the call with a message that names it and quotes lavaan. Cases lavaan did not use are reported:data_n, a line such as “Cases: 473 of 500 used” in the print and summary, and acases_usedrow for review. -
Other outputs.
print(),summary(),nomo_table(),nomo_methods()(which credits WLSMV for ordered indicators and FIML when it was requested, as fornomo_cfa()), and a section in the measurement-evidence article, where ESEM finds both features built intonomo_demo_continuous.
- New
nomo_method_variance()for common method variance, following Williams, Hartman, and Cavazotte’s (2010) comprehensive CFA marker technique (#129). Given a measurement model and the indicators of a marker variable, it runs the three phases the authors specify:-
Model comparisons. It fits the CFA, Baseline, Method-C, Method-U, and Method-R models (
models, with the scaled chi-square and robust indices under a robust estimator, asnomo_cfa()reports them), and compares them (comparisons) to test whether marker-based method variance is present, whether its effects are equal, and whether it biases the substantive correlations. With Method-U retained, a presence test that is not significant under equal effects is qualified, flagged for review, and reported with its test against Method-U. -
Reliability decomposition. It splits each factor’s reliability into substantive and method parts (
reliability). -
Sensitivity. It fits the Method-S(.05) and Method-S(.01) models, with each method loading fixed at the end of its interval farther from zero.
correlationsgives each pair of factors’ correlation in every model, with p-values namedretained_p_value,method_s_05_p_value, andmethod_s_01_p_value. -
Problems are kept. lavaan’s warnings are in
engine_warningsand logged for review, and an improper solution is a concern. A model that does not converge, and a CFA that gives the marker a negative error variance or no standard errors, stop the analysis with the reason. A two-indicator marker is flagged for review, and cases left out are counted.
nomo_method_variance()is experimental: its output may change during 1.x without a deprecation period. -
Model comparisons. It fits the CFA, Baseline, Method-C, Method-U, and Method-R models (
- New
nomo_retest()for test-retest reliability (#129).-
The intraclass correlations. For
scores, the columns holding a composite on two or more occasions (or a named list of them, one per composite), it estimates ICC(A,1), the two-way mixed-effects, absolute-agreement, single-measurement form Koo and Li (2016) recommend for test-retest data, with its 95% interval. Beside it are the consistency form ICC(C,1) (McGraw & Wong, 1996) and the mean change between occasions. A systematic shift is flagged, because ICC(A,1) counts it as disagreement. - Koo and Li’s description. The reliability is described in Koo and Li’s terms (poor, moderate, good, excellent), read from the interval as they ask, and an interval that reaches “poor” is flagged.
- Measurement error. It reports the standard error of measurement, the square root of the residual mean square, which leaves out any shift between occasions, and the smallest detectable change, 1.96 x sqrt(2) x SEM (Weir, 2005).
- Reliable change. Each person’s reliable change index follows Jacobson and Truax (1991); it exceeds 1.96 exactly when the change exceeds the smallest detectable change.
- Input. An infinite score is refused with a message naming the column, and cases left out by listwise deletion are recorded in the decision log and the print.
-
Other outputs.
nomo_table(),nomo_apa_table(),nomo_methods(), and the measurement-evidence article cover it.
-
The intraclass correlations. For
-
nomo_network()can model an observed composite, such as a scale mean, as a single-indicator latent variable, correcting the relations it enters for its unreliability (#129). Name it insingle_indicatorswith its reliability, as a number or anomo_single_indicator()record. The record can take omega and its bootstrap uncertainty from anomo_reliability()result; it warns when that omega is a latent-response omega for an ordered composite, and records the scale insource. The composite becomes the one indicator of a latent variable of the same name, so the model syntax and hypotheses are unchanged. Its error variance is fixed at (1 - reliability) x its variance on the rows lavaan analyzes, so the fitted model’s reliability is the one supplied. The method goes back to Spearman’s (1904) correction for attenuation and the SEM textbooks (Hayduk, 1987; Bollen, 1989), and Savalei (2019) found it the most accurate option in samples of 30 to 200 when the reliability is close to its true value. So nomologR:- refits each hypothesis with each reliability .05 and .10 lower and higher, records the result in
single_indicator_sensitivity, and flags any hypothesis whose concordance changes across that range; - adds the reliability’s uncertainty to the standard errors, intervals, and concordance when its standard error is known, as Oberski and Satorra (2013) derive; otherwise the log says the standard errors treat it as known;
- flags coefficient alpha for review, since it understates reliability when loadings differ and so overcorrects.
nomo_table()gains the"single_indicators"and"sensitivity"types, and the APA hypotheses table notes the correction. The nomological-network article shows the correction recovering the population path (.45) from the Persistence mean (.41 uncorrected, .46 corrected). - refits each hypothesis with each reliability .05 and .10 lower and higher, records the result in
Invariance across groups and occasions (#129)
-
nomo_invariance()reports latent means, which are known-groups evidence in structured-means form (#129). At each level that holds intercepts equal,latent_meansgives each group’s latent means relative to the reference group. Under the defaultID.fac = "std.lv"they are in the reference group’s latent standard deviations (Hancock, 2001), with intervals. The summary shows them,nomo_table(x, "latent_means")returns them, and the log says they are comparable only with invariant intercepts, fully or partially (Byrne, Shavelson, & Muthén, 1989). Onnomo_demo_network, holding the biasedag3intercept equal inflates the Agency difference between modes to .44 SD. Releasing it gives .33 [.17, .49], which covers the population’s .25. The measurement-invariance article walks through this.-
Which means are reported. The table is decided from the fitted model. It reports only factors whose reference latent mean is fixed at 0 and variance at 1, and only estimated means. For a model with higher-order factors, semTools uses unit loadings whatever
ID.facasks for, so the table is empty, andID.facand the log record"ul". A mean fixed at 0 because every intercept of a factor was released is left out, and the log says why.
-
Which means are reported. The table is decided from the fitted model. It reports only factors whose reference latent mean is fixed at 0 and variance at 1, and only estimated means. For a model with higher-order factors, semTools uses unit loadings whatever
- New
nomo_invariance_longitudinal()for measurement invariance across occasions (#129). It asks whether the same items mean the same thing each time the same people answer them, so that a change in scores can be read as a change in the construct (Widaman, Ferrer, & Conger, 2010).-
The model. The model is written for one occasion, in the items’ own names.
columns(default"{item}_{occasion}") maps each item and occasion to a column. Each item’s unique factors are correlated across occasions, over all lags or up toauto. -
The sequence. The configural, metric, scalar, and strict levels, the ordered-item sequences and identification (with Liu et al., 2017, for Millsap and Tein’s conditions over time), researcher-specified partial releases, and score diagnostics are those of
nomo_invariance(), applied across occasions through semTools’ longitudinal arguments. A release names the item as in the one-occasion model, such as"w3 ~ 1", and the diagnostics are labeled by item and occasions, such asIntercept: w3 (t1 vs. t3). An item whose columns are ordered factors is ordered on every occasion. -
Latent change. Once intercepts are invariant, fully or partially,
latent_meansgives each later occasion’s latent mean in the first occasion’s latent standard deviations, with intervals. -
Other outputs. The result is also a
nomo_invarianceobject, soprint(),summary(),nomo_table(),nomo_apa_table(), andplot()work as they do across groups.nomo_methods()gainslongitudinal_invariance.
-
The model. The model is written for one occasion, in the items’ own names.
- New teaching dataset
nomo_demo_longitudinal: four Wellbeing items answered on three occasions, with a latent mean rising .30 and then .50 SD and thew3intercept drifting .40 after the first occasion. In the measurement-invariance article, holding that intercept equal inflates the change at the third occasion to .66 SD. Releasing it gives .55 [.43, .67], which covers the population’s .50.
The stability contract (#113)
-
nomo_missing()andnomo_apa_table()leave the experimental list and are covered by the stability policy (#113).nomo_missing()’s flagging rule is adapted from Schafer and Graham (2002, p. 157), who judged a bias beyond about half a standard error practically important, because it degrades interval coverage. Separating sampling variability from bias would be new output, added alongside the rule.nomo_apa_table()’stypevalues and returned structure are covered. A table’s formatting (headings, number formats, notes) may still be corrected where it departs from APA style, with the correction described in NEWS.
The contentvalidR handoff (#53)
- The content-review reader is tested against
contentvalidR0.10.0 and 0.10.1 output too (#53). Their handoffs are identical to 0.9.0’s apart from the producer version and date, and the reader needed no change. - A handoff that lists an item more than once is still refused, but the message no longer says that
content_handoff()cannot produce such an object (#46, #53).contentvalidR0.10.1 and earlier wrote one row per objective for a congruence fit without a target mapping. The message now says that a handoff has one row per reviewed item, names the items listed more than once, and says that such a congruence handoff has to be made again from a new fit withcontentvalidR1.0 or later. The reader takes each decision as its producer recorded it and does not branch on the producer’s version, so a congruence handoff written before 1.0 with a target mapping is read as before. - The refusal of a handoff that carries no items names the statuses its items have, which are the ones
keepwould have to name, and writes the carry rule as it is typed (#53). A review that applies no decision rule, such as a congruence fit without a target mapping, gives every item the status “Descriptive only”, andcontent_handoff()’s defaultkeep = "Supported"then carries none. - The fixture generator writes three item-objective congruence handoffs from
contentvalidR0.99.0 on, and the reader’s tests for them are in place for the release candidate’s fixtures (#53). The stored fixtures are now checked against the version list and their manifest.
Documentation (#129, #138, #144, #145)
- Documentation for 1.0 (#129, #138). Get started and the research-basis article say that every analysis assumes reflective measurement, why the tools do not apply to formative measures, and where the criteria for choosing between the two are. The research-basis article places each method added in #129 between historical and contemporary practice, and gains the McGraw and Wong (1996) entry its test-retest paragraph cites. The README walks through the new functions stage by stage, lists
nomo_demo_longitudinal, says what 1.0.0 contains, and notes thatnomo_method_variance()andnomo_power_simulate()stay experimental after 1.0.0; its license note now says that releases from 0.2.0 on are GPL-3. Get started adds the new functions and dataset to its workflow and dataset tables and its learning path, and the package description names the new methods. ROADMAP lists the gap review in the 1.0.0 scope, names 0.9.0 as the current release, and records the feature freeze on 2026-10-13. The README and the exploratory-workflow article read the documentedcorrelation_methodanditem_typesofnomo_factors(), not their undocumented aliases. - The interface frozen at 1.0 is written down where it was missing (#145). No value, name, or behavior changes for it.
-
Help pages. The pages of
nomo_screen(),nomo_cfa(),nomo_efa(),nomo_validity(),nomo_reliability(),nomo_network(), andnomo_missing()name the units and flag values of their own tables. The stability policy lists the columns of each analysis’s decision log, and?nomo_runthose of the run’s own log. -
nomo_table(). Its help page lists the"factors"type ofnomo_hierarchical, and a new “Fit tables” section names the index columns of each fit table. -
nomo_apa_table(). Its help page lists the fields of the returned table (number,title,body,stub,notes,source) and says that headings, cells, and notes are written in Markdown. -
nomo_network().?nomo_networkdefines everyconcordance,evidence_scope, andreplication_statusvalue, with its rule and the interval it uses, and spells out SESOI (smallest effect size of interest). -
nomo_defaults(). It documentsauto_deleteandauto_respecifyas fixed safeguards, and the comparison-data settings and how they differ from theEFAtoolsdefaults. -
Other pages.
?nomo_factorsdefines the three parallel-analysis rules and TR2 and TR4, and?nomo_efalists the rotations it accepts.?nomo_invariancesays that the reference group is the one that appears first indata.?nomo_hierarchicalsays that H equals the squared determinacy for unidimensional data.?nomo_methodslists"scores"among its stages and says that the result is an ordinary tibble.
-
Help pages. The pages of
-
?nomologRgains “Status words shared with contentvalidR” (#144): how nomologR’s flags correspond tocontentvalidR’s statuses, that “review” never means delete, and thatrecommendationis prose advice in nomologR’s decision logs and a decision word incontentvalidR. - The dataset help pages and the articles write population values as the output prints them (#144): a loading, a path, or a difference in means keeps its leading zero (0.45), and a correlation drops it (.40).
- Articles (#144, #145).
- Wording. Numbers in the prose are rounded and written as the printed output is. Tests read “Delta chi-square(df) = x, p = .xxx”. Three or more authors are cited with “et al.”.
- Hierarchical models lists Beauducel (2011), Gorsuch (1983), and Hancock and Mueller (2001), which it cites, and shows H beside the squared determinacy.
- Nomological network shows each prediction’s classification, its equivalence interval, and its replication status, which had been hidden at 80 columns. It credits the “total aggregation” name to Bagozzi and Heatherton (1994).
- Research basis gives Koo and Li’s (2016) recommendation as a two-way mixed-effects model with absolute agreement.
nomologR 0.9.0
nomologR 0.9.0 is the last minor release before 1.0.0, the stable release planned jointly with contentvalidR (#53). It carries the 1.0 scope selected so far (#113); what is added before the release candidate on 2026-10-17 is recorded there. It is about how the package presents itself and what it teaches:
-
Output that reads well. Every
print()andsummary()is redesigned (#89): aligned tables with the columns that matter, explanations in full, APA-style numbers, and one flag wording (“review”, “concern”) in the console, plots, and reports. -
A record of how practice changed.
nomo_methods()gives the year each method entered the literature and, for a historical method, the contemporary methods that took over its question. The research-basis article draws them into a timeline. -
Teaching, and the bridge from content review. “Teaching with nomologR” collects exercises whose answers are known from the population model. “From content review to empirical screening” carries a
contentvalidRreview’s items through the screen, on the joint walkthrough’s data, now shipped asnomo_demo_walkthrough(#60). -
Manuscript tables for validity evidence.
nomo_apa_table()formatsnomo_validity()results: each construct pair’s latent correlation with its interval beside HTMT2, and a table of AVE. - The 1.0 contract. Every help page names the fields of the object it returns (#114).
No computed estimate changes. Compared value by value with 0.3.0 across 22 analyses spanning every stage, every estimate is identical. What differs:
- With two or more declared scales,
nomo_screen()reviews each item within its own scale: its item-rest correlation against the rest of that scale (scale,scale_item_rest_r,scale_item_rest_n), and its negative inter-item correlations only with items of the same scale (scale_negative_interitem_n). Which items are flagged can change.corrected_item_rest_randnegative_interitem_nare unchanged. - In a multi-group
nomo_validity()result,latent_correlations$blocknames the groups by label rather than by number. - A CFA that is not identified (negative degrees of freedom) is logged as a concern rather than a review.
- Wording: counts agree with their nouns, some decision-log observations read differently, and the invariance summary lists the largest diagnostics rather than the first.
Breaking changes.
-
nomo_missing()takes the fitted model asfitrather thanx(#114). Calls that pass the model first without naming it are unaffected. The function was marked experimental, so there is no deprecation period. -
nomo_screen()checksscaleswheneffort = FALSEtoo, since the within-scale correlations use it. Ascalesthat names items not being screened now stops with an error instead of being ignored. -
nomo_report(apa_tables = TRUE)adds the validity tables, and when the run has a validity stage, its construct-pair table takes the place of the CFA factor correlations. - An invalid choice stops with a message that names the argument, such as “
methodmust be one of …”, instead of base R’s “‘arg’ should be one of”. Only code that matches the old message text would notice.
nomologR 0.3.0 is still in CRAN’s queue for new submissions (#39); until CRAN accepts it, install from R-universe or GitHub.
- With two or more declared scales, the item audit reviews negative inter-item correlations only within a scale (#113), as it does item-rest correlations. Two items of one scale should correlate positively, so a negative pair there is a keying or wording clue. Items of different constructs need not correlate at all, and a correlation near zero is negative about half the time. In
nomo_demo_network, social desirability is uncorrelated with the other two constructs by design, and its near-zero negative correlations with their items had flagged all eight Agency and Persistence items.relationship_summarygainsscale_negative_interitem_n.negative_interitem_nandinter_item_correlationsare unchanged. Negative correlations between scales are logged as information (negative_pairs_between_scales). The log entry for negative pairs now agrees in number: “1 estimable inter-item correlation is negative”. -
nomo_apa_table()formats anomo_validity()result (#113).type = "discriminant", the default, gives each pair of constructs one row: its latent correlation with a 95% confidence interval (Rönkkö & Cho, 2022), beside HTMT2 (Roemer et al., 2021) and HTMT (Henseler et al., 2015) when they were computed.type = "convergent"gives each construct’s number of indicators and AVE. The pair table is deliberately not the Fornell-Larcker matrix with the square root of AVE on its diagonal, the comparison thatnomo_methods()records as historical because it often misses constructs that are not distinct. Correlations and AVE lose their leading zero; the ratios, which can exceed 1, keep it. A multi-group model’s tables add a Group column.nomo_report(apa_tables = TRUE)adds both tables after reliability, and the pair table takes the place of the CFA factor correlations, which it repeats. - In a multi-group
nomo_validity()result,latent_correlationsnames its groups (block) by their labels, asavedoes, rather than by number.lavaan::standardizedSolution()numbers the groups, so the two tables of one result had disagreed, for example “1” and “2” against “Pasteur” and “Grant-White”. - When two or more scales are declared, through
scalesor acontentvalidRhandoff, the item audit reads each item’s corrected item-rest correlation within its own scale (#113). An item is scored on its scale’s total, so the rest of that scale is what it has to agree with (Nunnally & Bernstein, 1994; Clark & Watson, 2019). Pooled across constructs, the items of a distinct scale look weak: innomo_demo_network, the three social-desirability items correlate .15 to .17 with the rest of all eleven items and were flagged, and .52 to .57 with the rest of their own scale. The relationship summary gainsscale,scale_item_rest_r, andscale_item_rest_n, andcorrected_item_rest_rkeeps the pooled value. The flag, the decision-log entry (which names the scale), the summary table, and the item-rest plot use the within-scale value. A guided run’s per-scale audits were already within-scale; the instrument-wide audit thatsettings$screen$effort = TRUEadds now agrees with them.scalesis checked wheneffort = FALSEtoo, since it now matters there. - The item-rest plot draws its values in a column past the bars and the reference line (#89). A flagged item sits just below the reference, so its value, drawn beside the bar, had crossed the dashed line.
-
nomo_missing()takes the fitted model asfit, asnomo_reliability(),nomo_validity(),nomo_scores(), andnomo_hierarchical()do (#114). It had beenx. The function is experimental until 1.0.0, so the name changes without a deprecation period. Calls that pass the model first, without naming it, are unaffected. - A guided run or validity result with a single construct no longer warns “Unknown or uninitialised column” when printed. With one construct there are no pairs, and the pair tables have no columns; the ordering and key-evidence code read them with
$, which warns on a tibble. - A new article, “Teaching with nomologR”, collects exercises built on the teaching datasets’ known answers. Students find the weak and cross-loading items, check whether the factor-retention criteria agree, compare alpha with omega, handle ordered categories, and tell a structural path from a correlation (including why a path that is not significant does not show that it is negligible). They also find the non-invariant intercept, see where content review and the empirical screen disagree, and see why an item-total correlation depends on which total it is computed against. Each answer is stated from the population model, not from one run. The article also suggests how to use teaching and research modes, decision logs, reports, and
nomo_methods()in a course. -
nomo_methods()records how practice changed (#113).introducedis the year a method entered the literature, taken from the publication that introduced it, and given only when the registry cites that publication (46 of 89 methods so far).contemporary_practicenames, for a historical method, the contemporary methods that now answer its question: parallel analysis for the eigenvalue-greater-than-one rule, omega for coefficient alpha, HTMT2 and latent-correlation intervals for the Fornell-Larcker comparison, FIML for listwise deletion. The research-basis article gains a section, “How practice changed”, with a timeline from 1937 to 2022 and a table of what took over from each historical method, both drawn from the registry. The KMO entry now cites Kaiser (1970), which introduced the index. The methods table innomo_report()shows the year each method was introduced, so an archived report carries the same record. - Every function’s help page now names the fields of the object it returns (#114). The stability policy covers “the documented fields of the objects they return”, but the Value sections had described contents in prose without naming fields, so most fields users read, such as
standardized_loadingsandfit_evidenceon anomo_cfa, were not named in the contract. Each Value section now lists the fields to read, one line each, and says that the remaining fields (the call, settings, and engine intermediates) are not part of the stable interface. This changes documentation only.?nomo_efano longer explainsfactor_countwith an internal milestone label. - A new article, “From content review to empirical screening”, carries the items a
contentvalidRreview carried forward through the empirical screen, on the shared teaching data of the joint walkthrough (#60, #53). It shows the two stages disagreeing, which is the reason the pair exists.EF4passes content review and carries almost no common variance.EF3is flagged empirically but is the only item covering part of the domain.TF4loads on both facets, andTF6is not invariant across cohorts. The article builds withoutcontentvalidRinstalled. - New teaching data
nomo_demo_walkthroughandnomo_demo_walkthrough_items: 400 simulated responses to twelve Study Persistence items in two cohorts, with each item’s built-in role (#60). They arecontentvalidR’s walkthrough files, copied unchanged from its v0.9.0 release with their git blob hashes.contentvalidR’s generator is indata-raw/walkthrough/. - The item audit explains a negative item-rest correlation for an item declared reverse-keyed, by a
contentvalidRhandoff or byreverse(#60). It says the sign is what such an item shows before recoding, and gives the item-rest correlation computed on a copy recoded as declared. If the recoded correlation is still negative, it says the keying does not explain it.nomo_run()passes a handoff’s declared keying to each scale’s audit for this. The data, the returned correlation, and the flag are unchanged; nomologR never recodes data. - The measurement-invariance summary lists the ten largest equality-constraint diagnostics across all levels. It had listed the first ten in level order, so the metric level filled the table, and a scalar-level strain such as an intercept never appeared. On
nomo_demo_network, the knownag3intercept (score 61) had been hidden behind a metric loading (score 5). - Three edge cases read better (#89). The CFA summary of a model that did not converge says “No fit index is available: the model did not converge.” It had listed the reference values with nothing beside them. The item-audit summary shows a column with one observed value as “constant” rather than “binary”. The returned
item_typeis unchanged. The missing-data print says why a strategy was not fitted, such as “FIML: Not fitted: no modeled variable has missing values.” for complete data, and shows its N as “-” rather thanNA. - An invalid choice names the argument it was given for (#89):
nomo_scores(fit, method = "eap")now stops with “methodmust be one of”sum”, “mean”, “regression”, or “bartlett”, not “eap”.” instead of base R’s “‘arg’ should be one of …”. This applies to every argument with a fixed set of values, such astypeinplot(),nomo_table(), andnomo_apa_table(). Partial matching (type = "load") works as before. -
nomo_cfa()says when its fit indices cannot test the model (#89). A one-factor model with three indicators is just identified (df = 0): it reproduces the covariances by construction, and its print had shown “RMSEA 0.000 | SRMR 0.000” like a well-fitting model. A model with negative degrees of freedom, such as a factor with two indicators, is not identified. The print now reads “Fit: not testable (df = 0, just identified)”, the summary explains why, and the guided run’s key evidence says the same. The decision log’s degrees-of-freedom entry, which was already recorded, now names the case, and a model that is not identified is a concern rather than a review. Warnings that lavaan raises while nomologR reads the results, such as “Could not compute standard errors”, are kept with the model’s engine warnings instead of printing at the console. The “NaNs produced” warnings thatlavaan::fitMeasures()raises for negative degrees of freedom are no longer shown. - Counts in printed output agree with their nouns (#89): “2 factors”, “1 pair”, “1 more degree of freedom”, rather than “2 factor(s)”. This covers the printed counts in scores, reliability, validity, hypotheses, and partial releases, and the notes in comparisons and bifactor models. Counted phrases in decision-log observations and report summaries agree too, with their verbs: “1 indicator was declared ordered”, “10 of 12 reviewed items were carried”.
- Plot legends use the display flag wording too (#89). The CFA loading and fit plots and the AVE and HTMT plots label their points “none”, “review”, or “concern” under “Flag”. The loading plot had shown the recorded values
KEEPandREVIEWunder “Review”, and the validity plotsinfoandreviewunder “Signal”. The item evidence map calls an informational signal a “note”, which is how the console shows it. Each flag level keeps the same point shape from plot to plot. - The redesigned console output extends to the guided workflow:
print()andsummary()fornomo_run()(#89). The print opens with the run’s status, mode, sample design, and scales, then lists what the run found so far as “Key evidence” (item flags, suggested factors, CFA fit, the omega range, validity and invariance results). A request repeated for several scales, such as a factor-count decision for each of three scales, is shown once with the scales it applies to, rather than once per scale. Research mode leaves out the teaching-mode reason, options, and consequences, and keeps what each scale showed and an example. The summary is about a third of its former length: a stage table, recorded decisions as bullets, the component recipe, and a count of the methods used with the primary method of each stage, pointing tonomo_methods()andnomo_table()for the full entries. The gallery indev/output-gallery.Rnow reports no presentation faults. -
nomo_report()tables are easier to read (#89). Column headings are words, not code names: “Omega CI lower” foromega_ci_lower, “Change in CFI” fordelta_cfi, “Corrected item-rest r” forcorrected_item_rest_r. Flags use the console’s wording (“review”, “concern”). A missing or empty cell is an em dash rather thanNAor nothing, and TRUE/FALSE is yes/no. Item, scale, and factor names are left as written. The values are otherwise unchanged, andnomo_table()still returns the code’s column names and flag values. The citations table gives each package’s reference as text. It had held R’s wholeprint(citation())output, including a BibTeX entry whose@Manual{pandoc turned into a stray citation, and LaTeX such as\texttt{semTools}. - The redesigned console output extends to comparisons, invariance, partial releases, hypotheses, networks, splits, and the notes of
nomo_apa_table()(#89).- Wide tables are split: model fit apart from information criteria, difference tests apart from changes in fit, and fit by level apart from changes between levels.
- Levels that failed or raised warnings are listed with what went wrong.
- Measurement evidence in a comparison reads one column per model.
- A hypothesis table states once that every relation is on the standardized scale, rather than repeating it in each row.
- The redesigned console output extends to reliability, validity, scores, missing-data sensitivity, and hierarchical models (#89). Tables replace wrapped tibbles. Severity-tagged notes print as
review:andconcern:bullets. Index names read as written in the literature (“omega hierarchical”, “ECV”). A column that holds one value throughout, such as a block column that always says “overall”, is left out. The note on correlational accuracy names the pair of factors whose score correlation strays furthest from the factor correlation. It had named one of the two, and which one depended on rounding, so it differed between platforms. - The content-review reader is now tested against
contentvalidR0.8.0 and 0.9.0 output as well as 0.6.0 and 0.7.0 (#53). The added fixtures include a nine-expert panel whose carry decision changed between producers. Seven of nine experts rate item N7 relevant, which is what Lynn (1986) requires.contentvalidR0.7.0 compared the I-CVI with a rounded .78 and held N7 back; 0.8.0 compares counts and carries it. The test confirms thatnomo_screen()follows the decision the handoff records rather than inferring one from the producer version. The reader needed no change: 0.8.0 and 0.9.0 keep schema version 1 with the same fields and columns. - The redesigned console output extends to the item audit, factor retention, and EFA (#89):
print()andsummary()fornomo_screen(),nomo_factors(), andnomo_efa(). The screen summary lists each flagged item with the decision log’s own explanation rather than internal metric names. The factor-retention summary prints the reason a criterion was not run, and the Bartlett result, in full rather than cut off in a table cell. The EFA summary no longer hides the item flags behind “2 more variables”. - Plot titles, subtitles, and captions are wrapped to fit the plot (#89). ggplot2 does not wrap them, and ten plots had text long enough to run off the edge at 7 × 5 inches: four CFA plots, three EFA plots, two network plots, and the hierarchical variance plot. The CFA fit plot now draws CFI and TLI, which sit near 1, and RMSEA and SRMR, which sit near 0, in separate panels with their own scales, and a legend with one entry is no longer drawn.
- Console output begins a redesign for readability (#89), starting with
nomo_cfa()’sprint()andsummary(). Tables are aligned text with the columns that matter and no type rows. A flagged loading’s explanation is printed in full rather than cut off inside a table cell. Numbers have fixed decimals, p-values follow APA style, and prose wraps to the console width. Flags are shown in one wording across the package: nothing for no flag, then “review”, then “concern”. This is display only: returned objects,nomo_table()types, and decision-log values keep their values.dev/output-gallery.Rregenerates every print, summary, and plot and reports the remaining presentation faults. -
nomo_cfa(),nomo_invariance(), andnomo_network()name any variable the model uses that the data lack, before fitting (#89): “modelnames variable(s) not found indata: agX. Check the spelling against names(data).” A misspelled item had reached lavaan, and the error named lavaan’s internal step (lavaan->lav_step02_options()) rather than the item. The more specific argument checks, such as forordered, still come first, and model syntax that lavaan cannot parse is still reported by lavaan. -
nomo_table()works on every measurement-stage result:nomo_factors,nomo_efa,nomo_cfa,nomo_reliability, andnomo_validity(#89). They had no method, so the documented way to extract a table failed for five of the package’s main results. Each returns the tables its report section shows.nomo_report()now gets them throughnomo_table(), so the two cannot drift apart.?nomo_tablelists every supported object and type, includingnomo_screenandnomo_scores, which were missing from it. -
plot(<nomo_screen>, type = "responses")draws a histogram for a continuous item (#89). It drew a bar for every distinct value, which for continuous responses means one bar per respondent: an unreadable plot, with a percentage label on each bar. Categorical items keep their bars. When the selected items mix the two, the categorical items are drawn and the caption names the continuous ones and how to plot them. -
nomo_validity()lists each construct pair once in its print, summary, and report section, with the latent correlation and HTMT-family values in the same row (#89). Latent correlations name a pair in model order and HTMT names it the other way round, so the two never merged. Each pair appeared twice, once with its correlation but a signal of “unavailable” and once with its HTMT values, and the print counted twice as many pairs as there are. Pairs are now shown in model order, including in the HTMT plot. The returned tables and every computed value are unchanged. -
nomo_report()headings are rendered for every scale of a multi-scale run (#89). A heading that followed a plot, which is every scale after the first in the item audit and factor retention, plus “Careless responding”, was run into the plot’s paragraph. It appeared as literal## Scale: ...text in HTML and Word, and the table of contents filed every scale’s tables under the first. The report tests had rendered only single-scale runs or had turned plots off; a two-scale report with plots is now tested in both formats. - The reproducible-report article’s overwrite example shows the refusal message with its temporary directory as
<report_dir>. It had printed the full temporary path of the computer that built the article, including a user name, and the path changed on every build. The message still comes fromnomo_report(), and the example still shows that an existing report is refused unlessoverwrite = TRUEis given.
nomologR 0.3.0
nomologR 0.3.0 is the first release submitted to CRAN (#39), and its scope was kept deliberately lean for that reason (#38). It does three things:
-
Connects content review to empirical validation. A handoff from
contentvalidRnow flows intonomo_screen()andnomo_run(), and the reasons for each item’s carry decision travel with it (#46). - Folds the v0.2.1 tools into the guided workflow and its report. These are careless-responding screens, scores, missing-data sensitivity, and manuscript tables (#73).
-
Starts the public interface’s stability promise. From this release the interface changes only after a deprecation period, under the policy written on
?nomologR(#74).
Test coverage is back to every executable line (#72). Reviewing each uncovered line found four defects, now fixed. Certification is recorded in #75. Distribution is R-universe until CRAN accepts the submission. The joint 1.0.0 release with contentvalidR is tracked in #53.
-
CRAN preparation for the first submission (#39).
-
Spelling.
DESCRIPTIONdeclaresLanguage: en-US, and the package’s text uses American spelling throughout. About 40 British spellings (analysed,modelled,behaviour) are changed in messages, help pages, articles, and NEWS; only wording changes, not code.spelling::spell_check_package()now finds nothing, with author names and technical terms listed ininst/WORDLIST. -
URLs.
urlchecker::url_check()finds all 131 URLs correct. -
Build.
.gitand.gitignoreare excluded from the build. A git worktree has a.gitfile, and a hidden file in the tarball is what CRAN returnedcontentvalidR0.3.1 for. - Test time. Under CRAN conditions the tests took about 15 minutes on a slow Windows machine; they now take about 3. The 117 tests that took 2 seconds or more are skipped on CRAN: simulations, full guided runs, and rendered reports. Two stay on CRAN because they check that nomologR reproduces lavaan’s own estimates, so a lavaan change that alters them is caught there. Continuous integration still runs every test, and coverage is unchanged.
-
Examples.
nomo_scores()andnomo_apa_table()gain runnable examples, so every exported function now has one. -
Description. The
DESCRIPTIONcites the two works that frame the package, Cronbach and Meehl (1955) and Flake, Pek, and Hehman (2017), with their DOIs. -
References. The research-basis article’s reference list gains the APA Publication Manual, which
?nomo_apa_tablealready cited. Its “Planned” notes now say that longitudinal invariance and multiple imputation are candidates for v0.4, not v0.3.
-
Spelling.
nomo_report(apa_tables = TRUE)appends a Manuscript tables appendix (#73, last of three parts). It holds thenomo_apa_table()tables for the results a run holds: CFA loadings, fit, and factor correlations; reliability; and, when present, invariance and the network’s hypotheses and fit. They are numbered in the order the report presents them. A table that does not apply is left out rather than failing the report. The default,FALSE, leaves reports unchanged.-
nomo_run()can score the measurement model and compare missing-data strategies, and its report shows both (#73, second of three parts).-
Scores.
settings = list(scores = list(method = "sum"))scores the model withnomo_scores(). The researcher must name the method; a request without one, includingscores = list(), is refused, because nomologR does not choose a scoring method. -
Missing-data sensitivity.
settings = list(missing = list())compares strategies withnomo_missing()for the measurement model, and for the network too when one is requested. - When they run. Both run after convergent and discriminant evidence, so they are in view when the researcher decides whether to carry the model forward. Each matches the standalone call.
- Not stages. Neither is a stage, so the stage table keeps its shape, and a run that requests neither is unchanged.
- If they cannot be computed. Requested evidence that cannot be computed is recorded in the design log and the run continues, since no later stage depends on it.
- Resuming. Both can be requested when resuming before the CFA, and are locked once computed.
- Where they appear. Their evidence joins the component log, their methods are credited to the run, and the report gains “Scores” and “Missing-data sensitivity” sections.
-
Scores.
-
A written stability and deprecation policy, on the package help page (
?nomologR) and in the README (#74). From 0.3.0, the first CRAN release, the public interface changes only after a deprecation period.-
Covered: exported functions, documented arguments and defaults, documented fields of returned objects,
nomo_table()types, and decision-log columns. - Breaking changes: any change that breaks the interface, including a changed default that changes results, is deprecated for at least one minor release first.
-
Experimental until 1.0.0:
nomo_missing(), whose flagging rule may be refined, and the layout ofnomo_apa_table()tables. Both are marked in their help pages. -
Required by the joint release: #53 requires this policy for the joint 1.0 release with
contentvalidR.
-
Covered: exported functions, documented arguments and defaults, documented fields of returned objects,
-
nomo_run()computes careless-responding indices whensettings = list(screen = list(effort = TRUE))is given (#73, first of three parts).-
Once, across the instrument. The indices describe a respondent across the whole instrument, and several cannot be computed within one scale. Even-odd consistency correlates across at least three scales, and psychometric pairs can span scales. So they are computed once, over every item in the run with the run’s scales, and the per-scale item audits are unchanged. The result matches a standalone
nomo_screen(effort = TRUE)call exactly. -
Keying.
reverse,scale_range,pair_magnitude, andscalescan be set alongsideeffort. When the scales came from acontentvalidRhandoff that declares keying, that keying is used unless the settings give their own, and the design log records which applied. - Where it appears. The indices’ log rows join the run’s component log, and the methods are credited to the run. The report gains a “Careless responding” section after the item audits: a summary, one row per index with the rule a source states for it or “none stated”, and the evidence rows.
-
Refusals. An unreadable
effortvalue is refused before any stage runs.
-
Once, across the instrument. The indices describe a respondent across the whole instrument, and several cannot be computed within one scale. Even-odd consistency correlates across at least three scales, and psychometric pairs can span scales. So they are computed once, over every item in the run with the run’s scales, and the per-scale item audits are unchanged. The result matches a standalone
-
nomo_screen()andnomo_run()accept a handoff fromcontentvalidR’scontent_handoff(), so items move from content review to empirical screening with their reasons intact (#46). The interface is schema version 1, agreed with thecontentvalidRmaintainer and documented identically in both packages.-
What is analyzed.
nomo_screen(data, items = handoff)screens only the items content review carried. Every held-back item is listed in the decision log with its status and recommendation quoted incontentvalidR’s own words, and is never analyzed or reinstated. -
Guided runs.
nomo_run(data, scales = handoff)takes its scales from the review, and its design log records that item membership came from content review rather than from these data. A review with no construct mapping, such as an expert relevance panel, is refused bynomo_run()with the carried items listed, because a guided run needs scales and nomologR does not invent them. It can still be screened. -
Keying. Declared keying and the response scale fill
reverseandscale_rangefor the careless-responding indices, exactly as agreed. An undeclared item is never treated as forward keyed, a response scale is never inferred from the data, and arguments given in the call take precedence, with a note in the log. -
Refusals. A carried item missing from the data is refused, never dropped. A handoff with a schema version this release does not read is refused, naming both package versions. Fields this release does not know are ignored, so
contentvalidRcan add fields within a schema version. An objectcontent_handoff()could not have produced, such as keying missing for some items but not others, is refused as malformed. -
Report.
nomo_report()gains a content-review section for runs that came from a handoff, so the archive starts where the validity argument starts. Reports of other runs are unchanged. -
Testing.
contentvalidRis not a dependency. The reader is tested against genuine output fromcontentvalidR0.6.0 and 0.7.0, stored intests/testthat/fixtureswith their generator and checksums. The guided-workflow article gains a runnable section built on the example handoff ininst/extdata.
-
What is analyzed.
The research-basis article describes the careless-responding indices that shipped in 0.2.1. It had still listed them as planned.
-
Test coverage is back to full executable-line coverage after v0.2.1 (#72). Reviewing each uncovered line found four defects, now fixed:
-
Network fit in
nomo_missing(). For anomo_network, the fit comparison listed every fit index as missing. A network’s fit evidence is one wide row, while a CFA’s is a long table, and only the long form was read. Every strategy’s chi-square, CFI, TLI, RMSEA, and SRMR now appear. -
nomo_scores()with ordered indicators. The parallel-model test that unit weighting implies was written for continuous indicators. With ordered indicators it was fitted by maximum likelihood against a categorical model, failed, and reported only that the comparison “could not be computed”. It is now not run for ordered indicators, and the note says why. -
RMSEA interval in the network fit table. The APA fit table for a
nomo_networkhad an “RMSEA [90% CI]” column but printed no interval. The interval is now read from the fit, using the robust, scaled, or plain RMSEA that the evidence reports. -
Long-string with no usable scale. The mean within-scale long-string returned
NaNwhen no scale had two items. It now returnsNA, as the inter-item SD already did.
-
Network fit in
-
Lines that no input can reach were removed rather than tested. Examples are the empty-row checks in the careless-responding indices and the guards for fitted models that are always present. The remaining guards are tested against real fitted objects:
- models that did not converge, have several groups, or were fitted from a covariance matrix;
- single-indicator and cross-loaded factors;
- small and degenerate response sets.
Failures that only lavaan can produce are simulated.
nomologR 0.2.1
nomologR 0.2.1 completes the six workstreams that moved out of v0.2.0 at certification (#37). It also carries three workstreams opened during the cycle (#54, #56, #62). Together they cover what happens after a measurement model is established:
- scoring it, with the evidence for the scoring choice (#33);
- screening for careless responding (#34);
- checking whether results depend on missing-data handling (#32);
- judging factor-score quality (#56);
- carrying scores into a network honestly (#62);
- reporting in manuscript-ready form (#35), including from inside a thesis document (#40).
Where a published worked example exists, the package reproduces it exactly: Curran’s (2016) examples for the careless-responding indices, and Rodriguez, Reise, and Haviland’s (2016) MASC values for factor determinacy and construct replicability. Skrondal and Laake’s (2001) factor-score regression design and the missing-data comparison are checked against known population values. Every source cited is in the research-basis reference list, with its DOI checked against the registry. Certification is recorded in #70. Distribution remains R-universe; the first CRAN submission is targeted for v0.3.0 (#39).
nomo_report()now works from inside a knitted R Markdown or Quarto document, such as a thesis chapter, with no workaround in the calling document (#40). A nested render shares knitr’s state with the document that started it, which previously stopped the report with a duplicate chunk label, and which silently dropped every figure from the report when the calling document set a graphics device its template did not expect. The report is now rendered with knitr’s default chunk options, which its own template then sets for itself, and the calling document’s chunk options and duplicate-label setting are restored afterwards. A report therefore renders the same from the console, a script, or a chunk, and rendering one does not change the document that asked for it.Restored full executable-line coverage by testing every
nomo_compare()failure guard (#54). These branches handle a failure inside lavaan or semTools rather than a researcher-facing input, and several of them produce the explanation a researcher reads when a check cannot be run, such as why a nesting check was skipped or why a difference test is unavailable. Wording that has never executed can be wrong without anyone noticing, so those sentences are now asserted against real fitted objects.nomo_hierarchical()now reports factor determinacy and construct replicability for the general factor and each group factor, in a newfactorstable reachable withnomo_table(x, "factors")(#56). Both reproduce the published values for the MASC example in Rodriguez, Reise, and Haviland (2016) exactly. The two indices are the same quantity only when a construct is unidimensional: under a bifactor model, determinacy uses the whole reproduced correlation matrix while H sees one factor’s loadings alone, and Rodriguez et al. decline to prefer either, so both are reported and each is labeled with the question it answers. Gorsuch’s (1983) and Hancock and Mueller’s (2001) thresholds appear as their authors’ recommendations where a value falls below them, never as rules.-
Added
nomo_scores(), which computes sum, mean, regression, or Bartlett scores from a fitted measurement model and reports what those scores are and are not (#33). Unit weighting is treated as the model it is: McNeish and Wolf- show that adding items assumes a parallel model, with equal unstandardized loadings and equal residual variances, so for
"sum"and"mean"that constrained model is fitted and compared with the model supplied. Every method reports Grice’s (2001) three criteria, computed from the fitted model: validity, univocality, and correlational accuracy. Validity for regression scores is the factor determinacy coefficient reported bynomo_hierarchical(), since that method maximizes it. Correlational accuracy is the one to read before using scores in a later analysis: correlations among scores do not reproduce correlations among the factors, the discrepancy is substantial, and its direction depends on the method and the model rather than being a constant that could be corrected for, so it is reported and left visible. Gorsuch’s (1983) thresholds appear as his recommendations where a value falls below them, never as rules. The supplied data is never modified, and only the cases the model used are scored. Includes the Scoring a measurement model article.
- show that adding items assumes a parallel model, with equal unstandardized loadings and equal residual variances, so for
nomo_screen()gainseffort = TRUE, which adds case-level indices of careless or insufficient-effort responding (#34): long-string, inter-item standard deviation, Mahalanobis distance, even-odd consistency, and psychometric antonym and synonym correlations, following Meade and Craig (2012), Huang et al. (2012), Curran (2016), and Marjanovic et al. (2015). Curran’s published worked examples are reproduced exactly and used as tests. The indices are reported side by side rather than combined, because they detect different failures: inter-item standard deviation detects random responding and gives a respondent who answers every item identically the best possible score, which is exactly the case long-string flags. The decision log reports that disagreement when it occurs. A case is flagged only where a source states a rule, with the source’s own qualification attached; the rest are reported without a flag. Inter-item standard deviation is averaged within scales, as Marjanovic et al. computed it, since one value across every item rates a respondent who is high on one construct and low on another as more erratic than a random responder. Within-person correlations over fewer than three pairs or scales are never reported, because with two every value is exactly +1 or -1. Reverse keying and the response range are declared, never inferred, and recoding happens on an internal copy only. Cases are flagged, never removed, and a screen that does not request these indices is unchanged.nomo_table()now supportsnomo_screenobjects.nomo_network()now discloses relationships estimated between observed variables (#62). When an endpoint is observed rather than latent, its measurement error enters unmodeled, and if it is a composite of several items (a sum, mean, or factor score) the relationship carries the discrepancynomo_scores()reports as correlational accuracy. The network cannot tell a composite from a single measured variable, so it does not guess: it classifies each hypothesis by its endpoints and discloses observed ones in the decision log, for review when both ends are observed and for information when one is, saying plainly that a single measured variable is not a composite. The disclosure points to modeling the items as indicators, tolavaan::sam()(Rosseel & Loh, 2024), and, for a linear regression among factor scores, to the design Skrondal and Laake (2001) proved consistent: regression-method scores for the predictors and Bartlett scores for the outcome, each block scored from a measurement model of its own. The second condition is easy to miss. In reproducing their result, scoring both factors from one joint model biased the estimate by about +.10 in the same check that recovered the latent value with separate models. No correction is applied automatically.nomo_scores()and the scoring article now describe that design (#62). The note on correlational accuracy says that scores from one model containing every factor are not it, and the article applies it to its own data next to the two ways of getting it wrong: the same method for both blocks falls well short of the latent slope, and scoring both factors jointly overshoots it.nomo_reliability()gainsci_ncpus, which runs the bootstrap on several worker processes through lavaan’ssnowbackend (#42). The default,1, keeps the bootstrap serial and unchanged.snowis used everywhere rather than forking, which is unavailable on Windows, so results are comparable across platforms. The draws depend on the worker count as well as the seed, so a result is reproducible for a given seed and worker count: both are recorded in the bootstrap status table and, newly, in the decision log that reaches reports, which previously carried neither. An unseeded bootstrap is flagged for review as not reproducible. Verified against an installed package: the same seed and worker count give identical intervals, and serial and two-worker runs differ by under .01, as the draws should. More workers are not always faster, since each must start and load its packages; in the evaluation recorded on the issue, eight workers were slower than four. Tests use at most two workers, following CRAN policy.Added
nomo_apa_table(), which formats the evidence in a result as an APA 7 table ready for a thesis, dissertation, or manuscript (#35): standardized loadings, factor correlations, and model fit fromnomo_cfa(); reliability fromnomo_reliability(); the invariance sequence fromnomo_invariance(); and hypothesis evidence and model fit fromnomo_network(). Tables carry a bold number, an italic title, no vertical rules, and notes below in APA’s order, and they knit directly into R Markdown or Quarto. Leading zeros follow the statistic rather than its value, as APA 7 specifies: statistics that cannot exceed 1 (reliability, correlations, CFI, p) lose the zero, and those that can (TLI, RMSEA, SRMR, standardized loadings) keep it. A value that rounds to zero is never printed with a sign, and an estimate the model could not produce is shown as an em dash. The hypotheses table reports each estimate’s evidence against its prediction, and marks a hypothesis specified after the data were seen as exploratory. No cell reads pass or fail. Word output fornomo_report()follows separately.nomo_report()now writes Word documents: afileending in.docxproduces one, alongside the existing HTML report (#35). Pandoc drops raw HTML when it writes Word, and the report template wrote its tables, notes, and its interpretation contract as raw HTML, so a Word report would have lost all of them, including the statement that the report does not turn review references into pass/fail rules. Each part of the template now writes HTML for an HTML report and markdown for a Word one, and the HTML report is unchanged. The Word report was checked against the HTML one: the same 37 data tables with the same header rows in the same order, the interpretation contract, the figures, and no raw HTML or escaped entities in its text. Collapsible sections are shown expanded, and the document uses Word’s default styles. Section numbering is used where the installed rmarkdown supports it for Word.-
Added
nomo_missing(), which refits anomo_cfaornomo_networkunder alternative missing-data strategies and reports whether the cases used, the estimates, fit, reliability, or theory evidence change (#32).- Strategies compared. Continuous indicators are compared under listwise deletion and FIML, with FIML as the reference. Ordered indicators, for which lavaan offers no FIML, are compared under listwise and pairwise deletion.
- Assumptions and the flag. Each strategy is labeled with the mechanism it requires, following Enders and Bandalos (2001). A difference larger than half the reference standard error is flagged for review, following Schafer and Graham’s (2002) rule for when bias becomes practically important. The flag says that the difference estimates bias only if the data are missing at random and the model is correct, and how many cases listwise deletion discarded. The count matters because, in checks under MCAR, differences from sampling alone grew with the share of cases discarded.
- Hypotheses. A hypothesis whose concordance changes between strategies is flagged for review.
- What agreement means. Whether data are missing at random cannot in general be tested from the data at hand, so agreement is reported as insensitivity to the choice, not as evidence that either strategy is unbiased.
- What lavaan actually did. Each strategy records what lavaan estimated, not only what was requested. When FIML is requested with ULS, lavaan 0.7 runs its two-stage method instead (as it does with GLS), while lavaan 0.6-21 refuses. With MLM, FIML is refused. Each of these is reported, not hidden, and the tests accept either lavaan behavior. The data supplied must reproduce the fitted model when refitted with its original strategy, so a comparison cannot silently run on different data.
- Validation. Tests reproduce lavaan’s estimates for each strategy and use simulations with a known factor correlation of .50. Under MAR, FIML is within sampling error of it while listwise deletion is attenuated and flagged. Under MCAR, both are unbiased, and FIML’s standard errors are smaller where it keeps cases listwise deletion discards.
- Not offered. Mean substitution is explained and not implemented.
-
Documentation. The measurement-model article gains a section applying the comparison to
nomo_demo_continuous, whose missing values are MCAR by construction, and to a simulated MAR sample.
nomologR 0.2.0
nomologR 0.2.0 makes the workflow research-backed from historical to contemporary practice and more useful to graduate students and researchers. Every method is placed in its literature and cited in reports; researchers can compare competing models, revise a model with its lineage recorded, and evaluate total and subscale scores; and replication language no longer reads noise as a finding. Scope was selected in #22.
Six Planned workstreams moved to v0.2.1 at release certification (#37), each with its reason recorded: missing-data sensitivity (#32), score guidance (#33), insufficient-effort responding screens (#34), manuscript-ready tables (#35), rendering reports inside R Markdown or Quarto (#40), and optional parallel bootstrap intervals (#42). The license is GPL-3.0-only; the published 0.1.0 release keeps its original MIT license. Distribution remains R-universe; the first CRAN submission is targeted for v0.3.0 (#39).
Release certification (#37)
- README links to files excluded from the built package (
ROADMAP.md,LICENSE.md) now use absolute URLs, so they resolve for readers of the package tarball as well as on GitHub (#48). - The default-run part of the
nomo_compare()example now skips the side-by-side evidence, which moved to\donttest{}, keeping every default-run example within CRAN’s time expectations. - Added the R-hub v2 GitHub Actions workflow (run on demand) for multi-platform CRAN-style checks.
- Certification tests of every
nomo_methods()crediting rule against real objects found, and fixed, methods that reports would have mis-cited: WLSMV comparisons were credited with the Satorra-Bentler scaled test instead of the scaled-and-shifted test; AIC and BIC were never credited; FIML requested asmissing = "ml"or"direct"was not credited; a requested Fornell-Larcker comparison was not credited; and anomo_partial()release specification was credited with a multiple-group fit it does not perform. A registry entry for a fixed change-in-CFI rule that no function displays was removed. -
nomo_revise()now refuses an item revision whose measurement model disagrees with the revised items. Previously, dropping an item without supplying a revisedcfa_modelscreened and explored the reduced item set but still fitted the dropped item in the CFA, while the lineage recorded it as removed.
Bifactor and higher-order models (#29)
-
nomo_model()gainsstructure = c("correlated", "higher_order", "bifactor")andgeneral. Bifactor syntax writes its identification and orthogonality explicitly, so it is identified the same way whateverstd.lvis used. Higher-order models need at least three first-order factors; with exactly three the model is noted as fitting exactly as well as correlated factors. Impossible configurations are refused and fragile ones noted. - Added
nomo_hierarchical(), which reads a fitted bifactor or higher-order model and reports omega total, omega hierarchical, their ratio, explained common variance (ECV), the percentage of uncontaminated correlations (PUC), and, per subscale, omega and omega hierarchical subscale, with item-level general and group loadings. For higher-order models these are the exact Schmid-Leiman decomposition. - Indices match analytic population values and
semTools::compRelSEM()under both observed and model-implied denominators. Ordered indicators report the latent-response estimand, labeled as an upper bound on observed ordinal sum-score reliability. - No index is treated as a pass/fail threshold, following Reise (2012), who notes that no benchmark value of ECV establishes unidimensionality. The output discloses that a bifactor model usually fits at least as well as the alternatives even when it did not generate the data.
- Models whose general and group factors correlate, multi-group and multilevel models, and non-hierarchical models are refused with an explanation. The higher-order refusal shared by
nomo_reliability()andnomo_validity(), andnomo_reliability()’s cross-loading refusal, now point tonomo_hierarchical(). - Added
print(),summary(),plot(), andnomo_table()methods, seven methods-registry entries, and the Total and subscale scores article.
Replication-status language (#30)
- A change in sign between primary and validation estimates is no longer labeled
"sign_reversal"from the point estimates alone. Estimates scattered around a null relation differ in sign about half the time, and the previous label called that “a substantively important replication discrepancy.” - For directional predictions, a sign change is now classified from the two 95 percent confidence intervals:
"sign_reversal"when both exclude zero on opposite sides,"direction_not_replicated"when exactly one excludes zero, and"sign_change_within_uncertainty"when neither does or an interval is unavailable. The first two are recorded as concerns and the third for review. - The rule and its rationale are documented in
?nomo_network, the nomological-network vignette, and the research-basis article. It does not treat a non-significant path as evidence of no relation; that still requires anegligible(within = ...)prediction.
Methods registry (#26)
- Added
nomo_methods(), a machine-readable registry of every method the package implements. Each entry records its workflow stage; its lineage (historical,contemporary, oremerging); its role (primary,supporting, orcontext); its estimand and key assumptions; the function and computational engine that implement it; and its references. -
role = "context"marks methods displayed only so readers can recognize them in published work, such as the eigenvalue-greater-than-one rule and fixed fit-index cutoffs. They take no part in any synthesis or decision. - The registry lists only what the package computes. Planned methods stay in the research-basis article and the issue tracker.
-
nomo_methods(x)returns only the methods a result object actually used, read from what each component recorded: a skipped retention criterion, alpha that was not computed, or a comparison that was not run is not credited. A one-factor solution is credited with no rotation method, since none was applied. -
references = TRUEexpands the result into a reference list with full citations and DOIs. - The “Methods and citations” section of
nomo_report()now lists the methods the run used and a deduplicated reference list for them, ahead of the software citations it already contained.summary()of anomo_runandnomo_table(run, "methods")show the same methods. - Every reference is in a single bibliography that the tests keep consistent with the registry in both directions.
dev/verify-method-dois.Rresolves each DOI and checks that the registered first author, year, and title match the citation; all 79 DOIs pass.
Revision lineage (#28)
- Added
nomo_revise(), which creates a child workflow from a parentnomo_run()with a revised measurement model, a revised item set, or both. The parent workflow is never modified. - Each revision records what changed (model, items, or both), the required researcher rationale, and whether the change was prespecified or post hoc. Post-hoc revisions are labeled, and the decision log recommends confirming the revised model in independent data.
- Parent and revised measurement models are compared with
nomo_compare()(#27), so a revision carries its own evidence. Item changes alter the observed variables, so those comparisons are descriptive, as documented. - The factor-count decision is inherited from the parent unless the researcher supplies a new one, so a revision changes only what was intended.
- Revisions chain:
$lineageaccumulates one row per revision and is available throughnomo_table(run, "lineage"), inprint()output, and in a new “Revision lineage” section ofnomo_report(). - The
measurement_model = "revise"decision now points tonomo_revise()instead of only advising a fresh workflow.
Model comparison (#27)
- Added
nomo_compare()for comparing two or more fittednomo_cfa()models. A researcher rationale is required and recorded, the comparison can be labeled a priori or post hoc, and no model is ever selected automatically. - Nested models receive the difference test that matches the estimator, computed by
lavaan::lavTestLRT(): the ordinary chi-square difference test for ML, the scaled difference test for robust ML (Satorra & Bentler, 2001), and the scaled-and-shifted test for WLSMV (Satorra, 2000). A test lavaan cannot compute, or a negative scaled statistic, is reported as unavailable with lavaan’s message rather than replaced by another method. - Nesting is checked from the models’ implied moments with
semTools::net()(Bentler & Satorra, 2010). Researchers can declare nesting when the check cannot run, and a declaration the check contradicts is recorded as a concern. - Each comparison reports changes in CFI, TLI, RMSEA, and SRMR without cutoffs, AIC and BIC when they are defined, and a plain-language interpretation.
- Side-by-side standardized loadings, reliability, AVE, and HTMT2 are reported for each model. Reliability for a model with loadings fixed to zero is labeled as describing a composite that still includes those items.
- Comparisons are refused, with an explanation, when models use different estimators, missing-data handling, cases, or data. Models with different observed variables receive descriptive evidence only.
- Added
print(),summary(),plot(), andnomo_table()methods.
Maintenance (#36)
- Split the guided-workflow implementation (
R/nomo_run.R, 2,066 lines) intonomo_run_state.R(state and input validation),nomo_run_decisions.R(researcher decisions),nomo_run_stages.R(stage execution and blocking),nomo_run_provenance.R(provenance, recipe, and settings tables), andnomo_run.R(entry point). Every function body and signature is unchanged, verified by comparing the parsed functions with the previous source, and the generated documentation is identical. - Redistributed the 102 tests in
tests/testthat/test-regressions.R, which were consolidated during pre-v0.1 hardening, into the per-module test files. Test names, the number of tests (464), and expectation calls are unchanged. - Raised the declared minimum for
EFAtoolsfrom 0.8.0 to 1.0.0. WithEFAtools0.8.0,nomo_factors()could not run the empirical Kaiser criterion, NEST, Hull, or comparison-data criteria, and 22 factor-retention tests failed. The full test suite passes with the declared minimumslavaan0.6-21,semTools0.5-9, andEFAtools1.0.0. - Added a CI job that installs the minimum versions declared in
DESCRIPTIONImports, confirms they are the versions installed, and runsR CMD check, so a declared minimum is never an untested promise. - Evaluated parallel execution for bootstrap reliability intervals. Four
snowworkers were about 3.5 times faster than serial refitting, and results are reproducible for a given seed and worker count but differ across worker counts. Because an opt-in option adds a user-facing argument and provenance fields, it is tracked separately (#42); bootstrap behavior is unchanged here. - Recorded the distribution plan: R-universe through
v0.2.x, a CRAN-readiness gate inv0.2.0certification (#37), and the first CRAN submission targeted forv0.3.0(#39).
Learning foundations toward v0.2.0
- Set the
v0.2.0direction: research-backed, usable scale-development and construct-validation workflows for graduate students and researchers, spanning historical to contemporary methods. Scope, priorities, and exit criteria were recorded in #22 and the linked workstream issues (#25–#37); v0.3 candidates are tracked in #38. Distribution remains R-universe; CRAN submission is deferred (#39). - Added three simulated teaching datasets with documented population models and fixed-seed generation code in
data-raw/nomo_demo.R:nomo_demo_continuous(two correlated factors with a cross-loading item, a weak item, and MCAR missingness),nomo_demo_ordinal(five-category ordered version), andnomo_demo_network(three constructs, an observed outcome, and two administration groups with a known source of scalar non-invariance) (#25). - All workflow vignettes now evaluate against the teaching datasets, so the guided workflow, measurement-invariance, nomological-network, and reproducible-report articles show real output (#25).
- Replaced the stale overview article with Get started, including a learning path for graduate students and researchers, and added a Research basis article mapping each workflow stage from historical to contemporary practice (#25, #26).
- Added DOI-verified references to every exported analysis function (#26).
- Replaced
\dontrun{}examples with runnable examples and added examples tonomo_network(),nomo_invariance(),nomo_table(), andnomo_defaults()(#25). -
nomo_table(<nomo_invariance>, "local_strain")now adds aconstraint_displaycolumn with human-readable parameter labels (for exampleIntercept: ag3 (online vs. paper)); the raw lavaanconstraintlabel is retained (#31). No statistical behavior changed. - Fixed invariance figures and constraint labels that used non-ASCII symbols (Greek capital delta and arrows). On the default
pdf()device these symbols were dropped or mangled, and running the vignette code underR CMD checkfailed. Labels now readDelta CFI,Delta RMSEA,Delta SRMR,->, and<->, matching the hypothesis syntax. - Documented the table types available from
nomo_table(). - Grouped the pkgdown reference index by workflow stage and articles by learning path, with a redirect from the former overview URL (#25).
- Archived the completed v0.1 roadmap specification in
dev/roadmap-v0.1-record.mdand refocusedROADMAP.mdon v0.2 and later.
Post-v0.1 development
- Changed the current development source to GNU GPL version 3 only (
GPL-3.0-only;GPL-3in R metadata), retaining the historical MIT notice. Previously published releases retain their original licenses. - Aligned source citation metadata with development version
0.1.0.9000; release tags retain their release-specific citation metadata. - Reconciled README, roadmap, issue navigation, historical checkpoint wording, and the documentation/planning workflow. Candidate methods remain proposals until their scope is accepted; no analytical behavior changes in this update.
- Opened development toward
v0.2.0. -
v0.1.0remains the current stable public release.
nomologR 0.1.0
First stable public release
- First stable public release of the guided empirical scale-development and construct-validation workflow.
- Includes the complete v0.1 workflow from item screening through reproducible reporting.
- Release certification includes a clean test suite, R CMD check, coverage audit, installed-package smoke test, and public pkgdown documentation.
Milestone 9 closeout — reproducible reporting and v0.1 release hardening
- Completed
nomo_report()as the archival reporting layer for guidednomo_run()workflows. - Added self-contained HTML reporting across item screening, factor retention, EFA, CFA, reliability, convergent/discriminant evidence, invariance, and theory-specified nomological networks.
- Added researcher inputs, data characteristics, decision provenance, deviations/post-hoc decisions, methods/citations, reproducibility information, and a full evidence trace linking recommendations back to their source evidence.
- Added report-render regression tests covering the core workflow and optional invariance/network branches.
- Completed pre-v0.1 engineering hardening with the full test suite passing, R CMD check at 0 errors / 0 warnings / 0 notes, executable-line coverage at 100%, and an empty
covr::zero_coverage()result. - Finalized
v0.1.0as the first stable public release after release-readiness review and certification.
Milestone 8 closeout — guided workflow and decision provenance
- Replaced the
nomo_run()development stub with a resumable guided workflow spanning screening, factor-retention evidence, EFA, CFA, reliability, convergent/discriminant evidence, optional invariance, and optional theory-specified nomological-network analysis. - Added explicit researcher handoffs for EFA factor count, CFA model specification, and downstream continuation after measurement evidence.
- Preserved completed component results across resume calls; future-stage settings can be added without silently recomputing completed work.
- Added teaching and research presentation modes that change presentation, not statistical behavior.
- Added
nomo_split-aware sample roles and exact-model network replication. - Added stage maps, decision/rationale provenance, component evidence logs, reproducibility recipes, and the guided-workflow vignette.
- Optional invariance/network branches remain researcher configured; no automatic parameter freeing, respecification, item deletion, or one-number validity score is introduced.
- M8 closeout coverage reached 94.07% package-wide and 93.16% for
R/nomo_run.R; the full test suite and R CMD check were clean. - Milestone 8 is complete. Milestone 9 was subsequently completed in this development version; see the closeout above.
Milestones 6–7 closeout — theory-specified networks, invariance, and Checkpoint C
- Added
positive(),negative(), andnegligible()expectation helpers plusnomo_hypotheses()for machine-readable a-priori and post-hoc theory specifications. Quantified negligible predictions use researcher-specified SESOI/equivalence regions; bare negligible predictions remain qualitative and are never confirmed merely becausep > .05. - Added
nomo_network()for theory-specified latent SEM with transparent addition of missing prespecified theory paths, observed external criteria/outcomes, standardized or explicitly unstandardized hypothesis evaluation, measurement-context propagation, and calibration/validation replication of the exact same prespecified fitted model. - Kept theory concordance, uncertainty, measurement quality, confirmatory status, and replication as distinct evidence streams rather than collapsing them into a single validity score.
- Added
nomo_invariance()using currentsemTools::measEq.syntax()andlavaaninfrastructure with identification-aware sequences for continuous, ordered 4+ category, three-category, and binary indicators. - Added diagnostic-only localized equality-constraint score tests and
nomo_partial()for explicitly researcher-specified partial-invariance releases with required rationale and cumulative provenance. The package never searches until it finds a partial-invariance model that passes. - Added
nomo_table()methods plus researcher-facing network and invariance figures, including theory-compatible regions, replication comparison, fit/change evidence, and human-readable localized equality constraints. - Added the “Nomological network” and “Measurement invariance” vignettes plus truth simulations, edge/failure hardening, and presentation regression tests.
- Final Checkpoint C coverage audit reached 94.19% package-wide. Core M6/M7 modules:
R/nomo_hypotheses.R94.33%,R/nomo_network.R89.95%,R/nomo_network_presentation.R91.49%,R/nomo_invariance.R92.04%,R/nomo_invariance_presentation.R93.27%,R/nomo_partial.R90.57%, andR/nomo_table.R100.00%. - Advanced the development version to
0.1.0.9003, marking Checkpoint C: Generalizability and Nomological Evidence Complete. Milestone 8,nomo_run(), is the next active development target.
Milestone 5 closeout — reliability, convergent/discriminant evidence, and Checkpoint B
- Replaced the
nomo_reliability()development stub with a model-based reliability workflow using currentsemTools::compRelSEM()infrastructure. - Made omega/composite reliability the primary coefficient for the general congeneric CFA workflow while retaining coefficient alpha as an explicitly qualified secondary statistic.
- Added ordered-indicator reliability guidance that distinguishes observed ordinal-score reliability from latent-response-scale coefficients and refuses to silently substitute a different alpha estimand.
- Added optional nonparametric bootstrap confidence intervals for reliability estimates through repeated refitting of the same lavaan CFA. Point estimates remain unchanged; uncertainty is additive and explicit.
- Replaced the
nomo_validity()development stub with convergent and construct-separation evidence including standardized loadings, AVE, latent correlations, HTMT2, original HTMT, and optional legacy/supporting Fornell-Larcker output. - Kept AVE in the validity layer rather than mislabeling it as reliability.
- Prioritized HTMT2 for congeneric measurement models while retaining original HTMT as comparison evidence.
- Added explicit guards for ambiguous or unsupported simple-structure reliability/validity estimands, including mixed ordered/continuous composites, cross-loaded first-order structures, and silent multi-group/multilevel HTMT pooling.
- Added compact
print()/summary()methods and nonredundant reliability, AVE, and construct-separation plots. Coefficient plots use the conceptual 0-to-1 scale by default and expand only when empirical estimates or intervals require it. - User-facing audits confirmed two key teaching cases: excellent global CFA fit can coexist with weak reliability/AVE, and strong reliability/AVE can coexist with poor construct separation.
- Added the Checkpoint B vignette, “From CFA to a defensible measurement model,” integrating CFA, reliability, convergent evidence, discriminant evidence, uncertainty, and decision guidance.
- Added direct regression tests against
semTools::compRelSEM(),semTools::AVE(), andsemTools::htmt(), plus ordinal, redundant-construct, weak-measurement, bootstrap-uncertainty, failure-disclosure, and presentation hardening tests. - Final M5 coverage audit reached 95.13% package-wide. Key M5 modules:
R/nomo_reliability.R90.26%,R/nomo_validity.R92.56%,R/nomo_measurement_helpers.R92.70%,R/nomo_reliability_uncertainty.R89.33%,R/nomo_reliability_presentation.R88.93%, andR/nomo_validity_presentation.R81.20%. Coverage hardening targeted consequential branches rather than artificial 100% execution of low-value presentation/failure paths. - Advanced the development version to
0.1.0.9002, marking Checkpoint B: Measurement Model Complete. Milestone 6, theory-specified nomological networks, is next.
Milestone 4 closeout — confirmatory factor analysis
- Replaced the
nomo_cfa()development stub with a production CFA workflow aroundlavaan::cfa()while retaining the underlying lavaan fit unchanged. - Added
nomo_model()for simple reflective CFA syntax generation without automatically adding cross-loadings, residual covariances, or other post-hoc parameters. - Added explicit estimator provenance and guidance for continuous ML, researcher-selected robust ML estimators such as MLR, and declared ordered-indicator WLSMV workflows.
- Added early guardrails for estimator/missing-data combinations incompatible with declared ordered indicators.
- Added convergence status, captured engine warnings, case-retention reporting, standardized loadings with uncertainty, latent-factor correlations, and global-fit evidence including chi-square, CFI, TLI, RMSEA with confidence interval, and SRMR.
- Added localized residual-correlation diagnostics and Heywood/improper-solution diagnostics.
- Added modification indices as quarantined post-hoc diagnostics; they never free parameters or trigger automatic model respecification.
- Added
print(),summary(), and four CFA plot views for standardized loadings, global fit, localized residuals, and modification indices. - Added
nomo_split()for reproducible calibration/validation splitting, including the independence-versus-precision tradeoff and restoration of the caller RNG state. - Added direct regression tests against
lavaan::cfa()plus stress tests for correctly specified and misspecified CFA, omitted cross-loading, omitted correlated residual, ordinal CFA, robust ML, FIML, nonconvergence, improper solutions, modification-index quarantine, and split-sample reproducibility. - Final M4 coverage audit reached 96.69% package-wide:
R/nomo_cfa.R97.37%,R/nomo_cfa_presentation.R99.58%,R/nomo_model.R97.73%, andR/nomo_split.R98.31%. - User-facing audit confirmed that well-specified, deliberately poor, and independent holdout CFA results are clearly differentiated without pass/fail validity language or hidden respecification.
- Local tests/checks and GitHub Actions passed; the Milestone 4 PR was squash merged before Milestone 5 development began.
Milestone 3 closeout — exploratory factor analysis and Checkpoint A
- Replaced the
nomo_efa()development stub with a production common-factor EFA workflow usingpsych::fa()as the statistical engine andnomologRas the guidance, diagnostics, logging, and presentation layer. - Added researcher-controlled factor counts and direct handoff from
nomo_factors(), including inherited item sets, modeling types, correlation models, missing-data decisions, and explicit smoothing choices. - Preserved M2 retention ambiguity in the EFA decision log so a handoff is not misrepresented as proof of dimensionality.
- Added MINRES + oblimin defaults, while keeping extraction and rotation choices explicit and validating supported extraction methods before calling the engine.
- Added tidy pattern/structure matrices, communalities, uniquenesses, loading complexity, factor correlations, reproduced correlations, residual matrices, localized residual pairs, and off-diagonal RMSR.
- Added
KEEP,REVIEW, andSTRONG REVIEWitem guidance based on configurable loading, cross-loading, and communality teaching references without automatic deletion, reverse scoring, factor-count changes, rotation hunting, or hidden model refitting. - Added KMO/Bartlett supporting evidence, descriptive sample-adequacy context, small-sample review behavior, and explicit non-positive-definite/smoothing handling.
- Added neutral public factor labels (
F1,F2, …) while retaining the full underlyingpsychfit object for advanced inspection. - Added
summary.nomo_efa()and four teaching-oriented plot views for pattern loadings, primary/secondary loadings, unique residual pairs, and unique interfactor correlations. - Corrected modeling-decision provenance so types inherited from a
nomo_factors()object are distinguished from new researcher overrides made at the EFA stage. - Added known-structure, cross-loading, weak-item, ordinal, redundancy, missingness, orthogonal-rotation, smoothing, validation, handoff, provenance, presentation, and failure-mode regression tests.
- Added the Checkpoint A vignette, “From item audit to exploratory structure,” demonstrating
nomo_screen()->nomo_factors()->nomo_efa(). - Milestone 3 coverage closeout reached 97.78% for
R/nomo_efa.R, 98.70% forR/nomo_efa_presentation.R, and 96.52% package-wide in the final pre-closeout audit. - Advanced the development version to
0.1.0.9001, marking Checkpoint A: the exploratory measurement workflow is complete and Milestone 4 (CFA) is next.
Milestone 2 closeout — researcher control and hardening
- Changed modeling-type override precedence so an explicit, valid
typesdeclaration can rescue otherwise ambiguous storage before default-type rejection, while storage-compatibility checks still block unsafe coercions. - Added decision-log entries for researcher-specified modeling-type overrides.
- Improved error ordering so constant and all-missing items are diagnosed as hard data failures before modeling-type inference.
- Expanded README guidance and examples showing when and how to use
types, including ordered interpretation of factor levels and the limits of overrides. - Added ordinal one- and two-factor regression simulations plus targeted coverage hardening for validation, criterion, presentation, and failure paths.
- Milestone 2 core computational files exceed the v0.1 >=90% coverage gate; presentation coverage reached 100% in the closeout audit.
Milestone 2B — retention triangulation and sensitivity
- Refined concordance to group closely related methods into criterion families, so original/revised MAP variants do not behave like independent votes. Internally split families remain explicit and are not forced into one bar.
- Added convenient
correlationandmodeling_typesfields alongside the existing internal-detail names for easier inspection of automatic choices. - Surface EKC’s non-Pearson approximation directly in criterion status and summary output rather than leaving that qualification only in the decision log.
- Polished evidence/concordance plots for longer criterion sets and wrapped captions to remain readable at ordinary RStudio plot-device sizes.
- Expanded
nomo_factors()from a two-criterion workflow into configurable retention bundles:minimal,core,extended, andall. - Added revised Velicer MAP (TR4) alongside original MAP (TR2), with both minima and criterion curves retained as sensitivity evidence.
- Added the empirical Kaiser criterion (EKC) to the default
corebundle. - Added optional NEST and Hull (CAF) criteria for supported continuous/Pearson analyses, with explicit skip reasons when their reference machinery is not compatible with ordinal, binary, mixed, or varying-N pairwise analyses.
- Added optional comparison-data retention and a clearly labeled legacy Kaiser-Guttman (> 1) rule in the
allbundle; the legacy rule is excluded from the evidence synthesis. - Parallel analysis now reports percentile, mean, and Crawford stopping-rule suggestions from the same null simulations while preserving one explicit selected rule for the primary recommendation.
- Added criterion-status and concordance tables so unavailable methods are never silently substituted and agreement is summarized without majority-vote logic.
- Expanded
plot.nomo_factors()with parallel-rule sensitivity, MAP curves, multi-method evidence, and retention-concordance views. - Added
EFAtools (>= 0.8.0)as the runtime engine for modern optional retention criteria while preservingnomologR’s interpretation and decision-log layer.
Milestone 2A — factor-retention evidence
- Replaced the
nomo_factors()development stub with a production factor-retention engine. - Added explicit correlation-model selection for Pearson, polychoric, tetrachoric, and mixed indicator sets, with conservative handling of numeric-discrete items and user overrides for intended measurement level.
- Added reproducible common-factor parallel analysis using independently permuted null data and a configurable null-eigenvalue quantile.
- Added Velicer MAP as complementary retention evidence, plus observed scree information.
- Added KMO/item-level MSA and Bartlett diagnostics as supporting evidence rather than factor-count decision rules.
- Added explicit non-positive-definite matrix handling: no silent smoothing; optional smoothing must be user-requested and is recorded in the decision log.
- Added
summary.nomo_factors()andplot.nomo_factors()views for retention, scree, method-concordance, and KMO evidence. - Promoted
psychto a runtime dependency because factor-retention methods now use its established factor/correlation engines directly.
Milestone 1C — integrated review and visualization
- Added
summary.nomo_screen()with an integrated item-review table that combines descriptive, relationship, response-category, and decision-log evidence. - Added
plot.nomo_screen()with evidence-map, item-rest, inter-item, response-profile, and missingness views. - Added explicit visibility for declared-but-unused ordered response categories without silently collapsing or recoding them.
- Added an item-level attention summary (
none,review,concern) that remains deliberately non-prescriptive about item retention. - Added
ggplot2as a core visualization dependency and expanded regression tests for presentation behavior.
Milestone 1B — psychometric screening
- Added corrected item-rest and inter-item relationship diagnostics for explicitly scored numeric/logical candidate items.
- Added review guidance for negative and weak item-rest relationships without automatic reverse-scoring or deletion.
- Added configurable response-concentration and near-zero-variance screening.
- Added descriptive floor/ceiling concentration for ordered and numeric-discrete items where those boundaries are meaningful.
- Added descriptive skewness and excess kurtosis for continuous-like numeric indicators without normality pass/fail declarations.
- Expanded
nomo_screen()printing and tests for the psychometric screening layer. - Refocused the README on the
contentvalidR->nomologRmeasurement workflow and the active v0.1 development path. - Added a GitHub issue form for roadmap-milestone tracking.
Milestone 1 — item/data screening
- Implemented the first production slice of
nomo_screen(). - Added conservative item-type descriptions, item-level missingness and response summaries, response distributions, case-level completeness diagnostics, and explicit zero-variance/all-missing flags.
- Added an evidence-guided decision log for screening observations without automatically deleting items or cases.
- Added a concise
print.nomo_screen()method. - Added focused tests for input validation, type classification, missingness, response distributions, case completeness, decision logging, and the non-destructive workflow.
- Updated GitHub Actions checkout steps to
actions/checkout@v5for the Node 24 runtime.
Foundation milestone
- Defined
nomologRas a guided workflow for empirical scale development and construct-validity evidence rather than a replacement forpsych,lavaan, orsemTools. - Clarified the package boundary relative to
contentvalidRandsolomonR. - Standardized package naming and the planned public API on the
nomo_*prefix. - Reframed common numerical cutoffs as teaching/reference values rather than automatic pass/fail rules.
- Established the principle that the package flags, explains, and documents but never silently deletes items or respecifies models.
- Updated planned reliability methods to current
semToolsinfrastructure such ascompRelSEM(). - Updated planned measurement-invariance methods to current
semToolsinfrastructure such asmeasEq.syntax(). - Separated AVE/convergent evidence from reliability.
- Added a testable internal decision-log scaffold.
- Cleaned development and continuous-integration scaffolding for the public GitHub repository.