Log Message:
(math/R-psych) Updated 2.3.3 to 2.3.6

Changes in psych version 2.3.6 (2023-06-21):

  Introduction:

         * The psych package includes functions and data sets to do
           classic and modern psychometrics and to analyze personality
           and experimental psychological data sets. The psych package
           has been developed as a supplement to courses in research
           methods in psychology, personality research, and graduate
           level psychometric theory courses. The functions are a
           supplement to the text (in progress): An introduction to
           psychometric theory with applications in R. The functions
           are also written to further research in the
           Personality-Motivation-Cognition Laboratory at Northwestern
           University.

         * Additional functions are added sporadically.

         * This news file reports changes that have been made as the
           package has been developed.

         * To report bugs, send email to
           <mailto:revelle@northwestern.edu> using bug.report.

         * Version 2.3.7 is the development release of the psych
           package. It is available as a source file for Macs or PCs in
           the repository at <https://personality-project.org/r/>. The
           released version on CRAN is 2.3.6 (Added June 21, 2023). The
           second digit reflects the year (i.e., 2023), the third set
           the month (i.e., 2.2.5 was released in May of 2022) the last
           two digits of development versions reflect either an minor
           change or the day of any modifications, e.g. 1.8.3.3 was the
           third attempt to get 1.8.3 released.  1.7.8 was released in
           August, 2017.

         * To install this development version, use the command:
           install.packages("psych",
           repos="https://personality-project.org/r", \ 
type="source").
           Remember to restart R and library(psych) to make the new
           version active.  It is also useful to check the date of the
           development package, as I will use the same version number
           but change the dates (e.g., packageDate("psych")).

To do version 2.3.7:

        * Suggestions are welcome, but the current list includes the
          following (and has included for a long time, so lets be
          patient):

        * Add confirmatory clustering to ICLUST

        * Get cluster scores in ICLUST -- analogous to factor scores
          (requested by Ben Shalet)

        * Add the ability to create multiple groups in sim.irt
          functions

        * Find canonical loadings in lmCor

        * Add omega factor extension figure option (requested by Sylia
          Wilson)

        * Add option to do subject density and item density plot to IRT
          plot.

        * add the ability to scale radar plots of raw data from min to
          max, and add a scale to radar and spider plots (e.g. circular
          histograms)

        * add the ability to add labels to lavaan.diagram

        * To help those who want to simulate a bifactor model, make it
          explicit.

        * Check the bias in bootstrap resampling using cor.ci

        * add symmetric=TRUE to eigen calls, think about
          only.values=TRUE for some cases

        * Add an analysis of DIF to the irt functions (requested by
          David Condon)

        * Add some power functions.

        * Add CIs for means and skews as an option (for describe as
          well as describeBy) Requested by Aaron Wichman

        * Add a function for the Meng, Rosenthal, Rubin tests for
          multiple comparisons of correlations.

        * Add complexity to omega solution

        * Add statistic to fa to report max fa. (partly done with fm =
          minrank)

        * Parallize iterations for confidence intervals in omega

        * Probably should drop much of the stats when doing iterations
          with fa or omega

        * Find unbiased cis when doing bootstrap

        * Allow the choice between regression vs. correlation in esem
          between X and Y sets.

        * Improve documentation for esem and cosinor

        * Add interbattery diagram to the structure diagram function.

        * Add Krippendorf's alpha?

        * Add the ability to weight factor residuals to allow WLMS

        * Add the Hull method for number of factors

        * Add an option for the correlation type in bestScales
          (requested by Lorien Elleman).

        * Change help file examples so they are cleaner for people who
          example(fn)

        * Make the main functions more "tidy" in terms of their output

        * Add testthat functionality

        * Add parse capabilities to error.bars, error.dots, spider,
          etc. so that grouping variables can be specified in formula
          mode.  Partially done (not yet for spider)

        * Possible bug in cohen.kappa confidence intervals (reported by
          Marco Fornili)

        * Need to add documentation to mediate/moderate/setCor for what
          dfs are used and why.

        * Add an n.iter option to pca (requested by Michael Wood, but I
          am not sure why)

        * There is a bug in bestItems for the case of no iterations and
          dictionary = something

        * Fix bug in fa.lookup for omega g values that are negative

        * Fix bug in bestScales that does not report items if not
          iterating

        * Adjust stats in fa.extend to report the raw and then the
          extended values

        * Improve documentation for extension diagram to clarify that
          it works with fa.results

        * Add just check variables specified for being numeric (instead
          of entire data.frame) (suggested by Fransisco Wilheim)

        * Pretty up the output from mediate (perhaps make a
          mediate2latex function)

        * Improve the print function for bassAckwards

  Still to do:

         * Change examples to dontrun rather than commented out

         * Need to fix bug in alpha where it finds R from cov2cor
           instead of directly (reported by Karl Ove Hufthammer )

         * Add the ability to get factor scores for higher order
           factors (requested by Brandon Vaughn). Partly done in omega,
           but there are problems associated with the entire problem of
           factor scores.

         * Fix a bug in alpha when finding average R (need to use cor
           rather than cov2cor when treating missing data)

         * Add weight option to statsBy (but the question is how to
           handle missing data)

         * Modify lavaan.diagram so that it handles cfa output better

         * Adjust the se for correlations (in bestScales) to take into
           account the pairwise count, rather than the n.obs

         * Give model fit in lmCor?  -- what would this be?

         * Improve documentation for thurstone.  Would help if we had
           an example of scaling.

         * scoreIrt.2pl needs to be able to adjust for group
           differences correctly

         * Possible problem in pooled correlations for statsBy

         * Think about improvements in itemLookup to show means if
           desired

         * Fix bug in polychoric where it doesn't handle empty cells
           very well. (reported by Bj<c3><b6>rn \ 
B<c3><bc>denbender).
           Or at least improve the documentation about why this is a
           problem.

         * Fix bug in mediate for multiple dependent variables
           (reported by Martin Zeschke)

         * scoreItem should find the mean item correlation with
           na.rm=TRUE (Liz D)

         * create a scoreFastBy

         * improve the help menu for sim.multi and return the latent
           values

         * think about linking person scores to item difficulty scores
           in IRT

         * Left justify content in lookupItems (not sure how to do
           this)

         * Consider using the Jennrich approach to standard errors of
           rotated loadings

         * Still need to fix mediate to handle more than 1 DVs

         * Possible problem with the use of try in several functions.

         * Need to fix omega so that alpha is correctly calculated in
           case of no general factor

         * It would be nice to add an option to display confidence
           intervals of correlations in error.dots

         * allow omega style hierarchical structure for x (and y) in
           esem

Changes in psych version 2.3.6 (2023-06-21):

  Additions:

         * Added a threshold parameter to sim.hierarchical and sim.item
           to allow for conversion to binary data.

         * Added a n.small parameter to sim.minor to limit the number
           of small factors.

         * Added mean imputation to omega (for scoring scales)

         * Replaced solve(r,f ) with Pinv(r)

         * Added type option to mlPLot to allow for more control

         * Changed setCor.diagram to lmDiagram and added the ability to
           plot lm output.

         * Minor tweak to extension.diagram to allow the causal arrows
           to come from rather than to the extension variables.

         * Added rain as an option to violin to show rain cloud plots

         * Add the ability to slant labels in plots

         * Added a sort option to corPlot (sorts by cluster order)

         * Added RMSEA function to allow easy calculation of RMSEA
           given chisq, dof, n.obs (requested by requested by Gabe
           Orona)

         * Added RMSEA, but not yet TFI, etc. to esem (equested by Gabe
           Orona several years ago.

         * Cleaned up the various sim functions so that they are better
           documented.

         * Allow for different rotation options in X and Y sets in esem

         * Added the ability to return the true scores for subjects
           when simulating structures.  This will help fitting
           reliability models This is now done for sim and sim.minor,
           sim.hierarchical, others are in process.

         * Changed a number of local functions in the form print.x to
           print_x format to comply with overly aggressive R
           development checks.

  Bugs Fixed:

         * Fixed a very rare case in describeBy for the case of two
           categorical variables measuring exactly the same thing.
           Added char2numeric before the by(describe,group) call.

         * Fixed a bug in bestScales for the case of no items for
           replications (still in progress).

         * Fixed lmCor so that the degrees of freedom for the case of
           use="complete" is correct.

         * Dropped a redundant check in factor.scores for non-positive
           definite matrices.  Pointed out by Chandler McClellan.

         * scoreIrt does not work unless keys are specified for nf > 1
           (reported by Andrew Olney) -- not sure of the problem.  What
           ever it is, I think I fixed it.

         * Fixed a typo in the mlr rd file for the RkR equation.
           (reported by Sebastian Castro-Alvarez)