Changes in version 1.2.2 (2024-02-17) - Fix un-escaped brackets in bandingEst() and taperingEst() documentation. - Argument documentation now matches argument names in cvRiskPlot() and matrixMetrics(). Changes in version 1.2.1 (2023-06-23) - Removing superfluous test that messes with CRAN's MKL checks (tests with alternative BLAS/LAPACK implementations) - Add doi of Journal of Computational and Graphical Statistics article to description. Changes in version 1.2.0 (2022-12-07) - cvCovEst() no longer accepts center and scale arguments. Data centering is now handled within each estimator function. Users no longer have an option to scale their data. If they'd like to produce a correlation matrix, they must scale the cvCovEst() estimate using cov2cor(). Changes in version 1.1.1 (2022-09-23) - Using strings of variable names instead of prefixing them with .data$ in dplyr::select() statements. Changes in version 1.1.0 (2022-05-04) - This minor release sees the addition of three new estimators for Gaussian spiked covariance models. These estimators are spikedOperatorShrinkEst(), spikedFrobeniusShrinkEst() and spikedSteinShrinkEst(), and apply the asymptotically optimal amount of shrinkage on the sample covariance matrix's eigenvalues with respect to their respective loss functions. For more information on these estimators, see Donoho et al.'s Annals of Statistics article "Optimal Shrinkage of Eigenvalues in the Spiked Covariance Model". Changes in version 1.0.2 (2022-01-19) - summary() now reports metrics about the candidate estimators' estimates, like their condition numbers, signe, and sparsity levels. Changes in version 1.0.1 (2021-10-14) - scadEst() and adaptiveLassoEst() are now vectorized, greatly improving their computational efficiency. Thanks, Brian! Changes in version 1.0.0 (2021-07-25) - cvCovEst() no longer accepts the true_cov_mat argument. - cvCovEst is now ready for publication through JOSS. Changes in version 0.3.8 - Fixing formatting errors in inst/REFERENCES.bib - Addressing typos and bibliography errors in JOSS paper draft - Updating pkgdown documentation - Creating a GitHub release. Subsequent versions of the package won't accept "true" covariance matrices as an argument to cvCovEst(). This is the last version of cvCovEst that can be used to reproduce the simulation results of the accompanying manuscript, "Cross-Validated Loss-Based Covariance Matrix Estimator Selection in High Dimensions". Changes in version 0.3.7 - Calling summary.cvCovEst() when a single summary function is specified now immediately returns a table instead of a list of length 1 that contains said table. - Tables returned by summary.cvCovEst() no longer have dplyr groups. - Fixed typo in Toy Dataset Example section of paper. Changes in version 0.3.6 - Renamed empirical_risk column in risk_df table output by cvCovEst() to cv_risk. - Added additional citations of existing R packages for covariance matrix estimation in our JOSS submission. - Added more comprehensive tests for the available loss functions. Changes in version 0.3.5 (2021-04-18) - Setting 'LazyLoad' to 'false' in DESCRIPTION to address CRAN checks notes. Changes in version 0.3.4 (2021-03-06) - Fixing plotting labels and table column names, along with associated documentation. - Fixing links to pass CRAN checks - Reducing size of toy datasets to increase testing speed Changes in version 0.3.3 - Adding note to robustPoetEst() warning again its use for correlation matrix estimation. - Fixing bug in robustPoetEst plots. Changes in version 0.3.2 - Adding preprint citation information. Changes in version 0.3.1 (2021-02-14) - Edited documentation to meet CRAN specifications. Changes in version 0.3.0 - Added information and simulated data examples of plotting and summary functions. - Made the cvCovEst R package a public repository GitHub. Changes in version 0.2.0 - cvCovEst now possesses a slew of diagnostic and visualization tools. A detailed description of these functions will be added to the vignette in the near future. Changes in version 0.1.7 - Minor clarifying updates to the documentation and the vignette. - Updates to NEWS.md, adding consistency in bullet point indicator and enforcing the 80-column rule. - Tweaks to dependencies, removing reliance on stringi since only invoked in a single pipe call in checkArgs. Changes in version 0.1.6 - Added basic examples to all exported functions. Changes in version 0.1.5 - Made cvMatrixFrobeniusLoss the default loss function. Changes in version 0.1.4 - Added cvScaledMatrixFrobeniusLoss, a new matrix-based loss function that scales squared error calculations associated with each entry of a covariance matrix estimate by the sample variances of the entry's row and column variables. This is particularly useful if the features of your dataset are of different magnitude. It's approximately equivalent to estimating the correlation matrix, but without the need to re-scale the estimated correlation matrix to be an estimated covariance matrix. Changes in version 0.1.3 - Fixed error with denseLinearShrinkEst: the shrinkage parameter was often selected such that the dense target was returned as the estimate. Changes in version 0.1.2 - Completed vignette. Changes in version 0.1.1 - robustPoetEst has been added to the library of candidate estimators. Changes in version 0.1.0 - cvCovEst version 0.1.0 is used in the accompanying manuscript to generate all results. - It is stored as a separate branch called 'preprint'. Changes in version 0.0.18 - cvCovEst now accepts cvMatrixFrobeniusLoss as a loss function. This loss function is a matrix-based alternative to the standard loss function. Through Proposition 1 of the method's manuscript the resulting selections of each loss are identical for any fixed cross-validation scheme. However, the matrix-based loss is more computationally efficient. Other minor tweaks to testing procedures. Changes in version 0.0.17 - cvCovEst can now be run in parallel using future. Changes in version 0.0.16 - When provided with the true covariance matrix, cvCovEst now outputs the conditional cross-validated risk differences of the cross-validation selection and the oracle selections. Changes in version 0.0.15 - Fixing a minor dimension error in nlShrinkLWEst by changing a conditional, as per https://github.com/PhilBoileau/cvCovEst/issues/23. - Enforcing the tidyverse code style via the first call to styler in this codebase (via make style). - Enforcing 80-columns in NEWS.md. Changes in version 0.0.14 - Replacing stats::cov with coop::covar after resolving the issue on Linux machines, as per https://github.com/PhilBoileau/cvCovEst/issues/18. - Removed calculation of spurious risk ratios from cvCovEst and from cvFrobeniusLoss when the true covariance matrix is passed in. Changes in version 0.0.13 - Changing loss function computation so that it is more computationally efficient. Changes in version 0.0.12 - Removing coop::covar due to strange parallelization issue on Linux machines. Hopefully we can use it again one day. - Prevent users from including a lone estimator as input to cvCovEst if the estimator in questions doesn't have any hyperparameters. - Coerce sparse, true covariance matrices to regular matrix objects if and when input to cvCovEst. Changes in version 0.0.11 - Adding additional risk difference ratio calculations when the true covariance matrix of Gaussian Multivariate data is provided. Changes in version 0.0.10 - Added adaptive LASSO estimator. - Users now have the option to include the true covariance matrix of their multivariate Gaussian data, allowing them to compare cvCovEst's selection versus that of the cross-validated oracle. Changes in version 0.0.9 - Adding POET estimator - Estimators can now take multiple hyperparameter arguments. Changes in version 0.0.8 - Adding smoothly clipped absolute deviation thresholding estimator. Changes in version 0.0.7 - Updated the loss computation; it now patches the formula used in the draft. Note that it vastly overestimates the true risk of an estimator, but that it provides an equivalent decision rule compared to a matrix-based loss. Perhaps we're missing a scaling factor in our calculations? - Moved Frobenius loss calculations to cv fold loss function. - Removed the penalized cross-validation loss. Doesn't make sense to include. - Included check for centered data matrix. Changes in version 0.0.6 - Adding dense covariance matrix linear shrinkage estimator. - Updating citations in estimators docs. Changes in version 0.0.5 - Adding analytical nonlinear shrinkage estimator. Changes in version 0.0.4 - Adding tapering estimator. - Adding argument checker for cvCovEst function. Changes in version 0.0.3 - Adding banding estimator. Changes in version 0.0.2 - Added unpenalized frobenius matrix loss. - cvCovEst() now requires a vector of candidate estimator functions be passed to he estimators argument, instead of a vector of characters corresponding to these candidates' names. Changes in version 0.0.1 - Minor changes to core routines, including changes to use of origami. - Updates to documentation, including Roxygen styling. - Addition of templates for vignette and JOSS paper. Changes in version 0.0.0.9000 - Added a NEWS.md file to track changes to the package.