Version 1.5.0 ------------------------------ MAJOR CHANGES - New function ggs_grb() to plot the shrinkage of Potential Scale Reduction Factor (Rhat) over batches of parameters. - New argument "keep_original_order" to ggs() that forces to keep the parameters in the order they are originally provided. MINOR CHANGES - Ready for dplyr-1.0. - New simplified way to draw histograms manually in ggs_histogram(), ggs_ppmean() and ggs_ppsd(). Version 1.4.1 ------------------------------ MINOR CHANGES - Improvements in the documentation of datasets provided by the package. Version 1.4 ------------------------------ MAJOR CHANGES - ggs_caterpillar() makes comparisons easier. In includes a new argument "comparison" that allows to specify the variable that sets the dodged parameters. - ggs_geweke(), ggs_Rhat() and ggs_effective() have a new argument "plot" that allows to return the plot (as always, and the default) but also the tidy dataframe containing the calculations of the diagnostics. - New function ggs_measures() that returns a tidy dataframe with the formal diagnostics of ggs_geweke(), ggs_Rhat() and ggs_effective(). - Improvements to ggs_effective(): A new version to calculate the number of effective draws is introduced, based on the steps followed by the coda package. Also the function now allows to report either the number of effective samples or its proportion. - ggmcmc() was not correctly handling parameter names when plotting caterpillar plots in functions that employ par_labels. - Several improvements in the documentation, including the datasets. MINOR CHANGES - Concrete "by" options in left_joins to avoid messages. - Minor bug in ggs_rocplot() needed to prepare for dplyr >= 1.0. - Include 'nimble' as a suggestion. Version 1.3 ------------------------------ MAJOR CHANGES - A new function ggs_pcp() displays the percent of correctly predicted outcomes in a binary model. - ggs_Rhat() now allows to select the Rhat specification. The "BG98" is the one used by the coda package, but the default is still the "BDA2". Check the documentation for more details. - A new function ggs_effective() displays the number of effective independent draws. - A new function plab() is included to help creating matching data frames for parameters and labels. - Following "Bayesian Data Analysis", v3 ggs() introduces the possibility of splitting the sequences into two chains. The new argument "splitting" is however FALSE by default. - ggs_caterpillar() now includes a new argument "label" that allows to specify the variable to be displayed in the labels, hence facilitating the combination with facet_*(). MINOR CHANGES - Adjust vertical size of facetted figure. - Improved way to calculate the Geweke diagnostic. - More informative error messages. - Updated list of contributors. - Improved documentation in the main github page. - Bug solving the management of families using stan. Version 1.2 ------------------------------ MAJOR CHANGES - Substantial performance improvement involving the treatment of families. - More control of aesthetics for ggs_caterpillar(). Thanks to Jonathan Gilligan. - Add HDP bands in ggs_density() and ggs_traceplot() with the argument (hdp = TRUE). MINOR CHANGES - Fixed a bug in sde0f when density is 0 or very close. Thanks to Brian Stock. - Vignettes (JSS and using ggmcmc) have been adapted to new requirements of R-development. - Minor bibliography issues solved in the vignettes. - Minor documentation issue with original s object being refered as D. - Using ggmcmc vignette improved with examples of how to combine ggs() objects with ggplot2 functions. Specifically, with facet_wrap() to accommodate several figures in a single display. Version 1.1 ------------------------------ MAJOR CHANGES - New argument ('sort') in ggs() that allows to control whether the custom sort of variables in family names first and numerical values later is passed (default) or the original order of parameter names is kept. MINOR CHANGES - New stan/rstan versions treat warmup differently and this is solved. - Solved a bug in ggs_caterpillar() when a list is passed. - par_labels argument in ggs() now allows also a tbl_df (in addition to a data frame). Version 1.0 ------------------------------ MAJOR CHANGES - Version 1.0 comes with the publication of the article at the Journal of Statistical Software. - ggmcmc() can produce reports in HTML format, when a file in HTML extension is given as argument. The figures can be in PNG or SVG formats. - 'stanreg' and 'brmsfit' objects from packages 'rstanarm' and 'brms', respectively, are supported by ggs(). - Improved documentation (HTML vignette) with the latest improvements (greek letters, rstararm/brms packages supported by ggs(), HTML report, acknowledgments). MINOR CHANGES - Normalize plural for all figure titles. - Warning messages from joins are not shows to the user. - stanfit objects correctly treat Parameter names. - Internal improvement of the function that does the custom sort of the parameter names, as well as their labels. - References to the JSS article have been incorporated in all functions that generate plots. - Improved documentation (JSS vignette) to accommodate last editorial changes. Version 0.8 ------------------------------ MAJOR CHANGES - Introduce the possibility to get Greek letters in the plots, as parameter names. - Vignettes are added, improving the package documentation. - ggs_separation() incorporates new arguments: uncertainty_band (to avoid the uncertainty band of the predicted values), show_labels (to add the Parameter as the label of the case in the x-axis. MINOR CHANGES - Solved a bug that passed thick_ci and thin_ci incorrectly in ggs_caterpillar(). - Parameters are sorted by their natural order following the numerical order inside the family. This helps ggs_separation() and ggs_rocplot(), as they expect observed values in numerical order. - Solved a bug with the calculation of the expected number of events in ggs_separation(). - Added some supressWarnings() to avoid annoying messages when doing some left_join() operations. - ggs_separation now plots the observed cases as proportional to the horizontal space, not as simple lines. This makes visualization clearer and more accurate to reality. Version 0.7.3 ------------------------------ MINOR CHANGES - Updated examples for ggs_pairs() to work with newer version of GGally. - GGally is imported instead of depends. - Specify a certain version of tidyr (0.3.1 needed) - Add a check that "Parameter" is a factor, which is not granted with the development version of tidyr as of 04/01/2016. Version 0.7.2 ------------------------------ MINOR CHANGES - Solve revdep issue with tidyr-0.3 due to unqualified imports of "%>%, and use explicit calls to dplyr and tidyr in all functions taken from those packages. - Improve citation. - Improve the text of the package description. - Add BugReports fields and include another URL. Version 0.7.1 ------------------------------ MINOR CHANGES - Minor changes to pass CRAN checks. Version 0.7 ------------------------------ MAJOR CHANGES - Added new function ggs_pairs() (thanks to Max Joseph) that produces scatterplot matrices of parameters, helping with posterior correlation. Library GGally is now a dependency. - ggs() is now able to process warmup (burnin) samples from stan, and so the argument "inc_warmup" now does something useful. MINOR CHANGES - ci() does not allow lists of data frames, so change it accordingly in the help file (thanks to Alex Zvoleff). - Solve minor issues with par_labels. - Solve minor issue with ggs_crosscorrelation not showing correctly par_labels (thanks to Juste). - Add a small example to the documentation about the use of the family argument in ggs(). - Better specify the origin of dplyr::* functions, to avoid collisions with other packages. Version 0.6 ------------------------------ MAJOR CHANGES - Include data and samples from models in order to facilitate examples linear: MCMC output from a linear regression model with dummy data. logit: MCMC output from a logit regression model with dummy data. radon: MCMC output and other description variables for a hierarchical / multilevel model based on radon example at Gelman & Hill. - Major revision of the code moving plyr to dplyr and reshape2 to tidyr The main object from ggs() is no more a data frame, but a tbl_df. Deleted the possibility of parallelization. It is not (yet) implemented in dplyr, but in any case, dplyr is clearly faster than plyr. - New function ci() that calculates credible intervals for a ggs() object. - When using par_labels, not only the columns "Parameter" and "Label" are considered, but also the resulting ggs() object contains other columns present in par_labels and the old Parameter name. This allows mainly ggs_caterpillar() (but also other functions) to use facets or colors, fills, etc. - New argument "simplify" in ggs_traceplot() or "simplify_traceplot" in ggmcmc() that allows to keep only a percentage of random chains, so that the size of the plot (and the time taken) is reduced considerably. But use it with care, because then the chain is no more complete. - Homogenize function names, using underscores "_" everywhere, instead of dots ".", in calc_bin(), gl_unq() and roc_calc(). MINOR CHANGES - When selecting a family of parameters, maintain parameter ordering for multipage outputs. - par_labels had a bug that produced wrong reordering of labels, and levels of parameters were incorrectly sorted. Although it is a minor change, the mistake was severe. - Labels in x-axis in crosscorrelation matrix are better aligned and more legible. - Solve scaling issues in Rhat. Introduce a meaningful default. - Better examples for ggs_separation() and ggs_rocplot(). - Documentation improved for internal functions. Version 0.5.1 ------------------------------ MINOR CHANGES - When the chain is stucked in the same value, the computation of the ar() for the spectral density needed by ggs_geweke() failed. It has been solved - When the range of a parameter is huge the calculation of the bins is approximate, and gave different number of bins. Now ggs_histogram takes care of different number of bins by each variable due to rounding. Version 0.5 ------------------------------ MAJOR CHANGES - ggmcmc() now allows the argument "plot" to select only some plots. - ggs_Rhat() now has scaling between 1 and 1.5 by default, so that perspective on real convergence is present. - ggs_geweke() includes anargument shadow_limit to highlight the -2+2 range - rugs in ggs_density() and ggs_compare_partial() are FALSE by default: rug it is only a visual improvement that really does not add too much information to the plot, but it takes a lot of resources. MINOR CHANGES - Old arguments "param.page" from ggmcmc() and "fully.bayesian" from ggs_rocplot() now use underscore to be systematic with the rest of the package. - Change default label for ggs_histogram(). - Rhat label now has a real hat. Version 0.4.2 ------------------------------ MINOR CHANGES - Bug in ggmcmc() related to ggs_histogram() and the division in pages relying on nParameters. Version 0.4.1 ------------------------------ MINOR CHANGES - Bug in export on ggs_rocplot. - Stan samples are imported without relying on coda. Version 0.4 ------------------------------ MAJOR CHANGES - Add the possibility to use different parameter names than the default ones provided by the MCMC software, using the argument "par_labels" in ggs(). - Move from reshape() to reshape2(). - geom_histogram() allows to specify a desired number of bins. - ROC plot (ggs_rocplot()) with code originally from Zachary M. Jones. - Separation plot (ggs_separation()) with code originally from Zachary M. Jones. - New plots ggs_ppmean() and ggs_ppsd() for posterior predictive checks. - Make parallel=FALSE the default in ggs(). - Consistency in names of the arguments achieved by moving all "." into "_". MINOR CHANGES - rstan is no more a suggested package, because it is not in CRAN, and it is not expected to be there in the near future. - Fix bugs in ggs_crosscorrelation when the number of parameters was 1 or 2. - In ggmcmc, do not plot Potential Scale Reduction Factor when there is a single chain. - Allow NULL as filename for the pdf file in ggmcmc. - argument "labels" in ggs_caterpillar() is renamed to "model_labols" avoid confusion with the parameter names - Adjust the defaults for the caterpillar plots, to remark the thick and thin segments Version 0.3 ------------------------------ MAJOR CHANGES - ggs() can import MCMCpack objects, stanfit objects and csv files from Stan running from the command line, in addition to the previous import of samples from mcmc.list() objects (from the coda package). - New functions ggs_Rhat() and ggs_geweke() that show graphically the results of the Rhat (potential scale reduction factor, by Gelman & Rubin), and the Geweke diagnostic (z-score). - ggs_caterpillar is able to plot against a continuous variable due to the addition of the 'X' argument - ggs_caterpillar() has the ability to plot two models, so that model comparison is easier. Thanks to Zachary M. Jones. - New parameter "family" that allows to select only certain parameters from the ggs object based on a regular expression (i.e., select all "beta" parameters, or all "theta", ones, or "alpha\\[1,.\\]", etc...) MINOR CHANGES - Traceplot now shows by default the burnin period and takes care of the thinning, used by ggs_traceplot() and ggs_running(). - New argument to have absolute colour scale in crosscorrelations. - ggs_caterpillar() is horizontal by default. - Documentation has been improved. Version 0.2 ------------------------------ MINOR CHANGES - opts() is replaced by theme() as it is deprecated in ggplot-0.9.2. - theme_text() is replaced by element_text() as it is deprecated in ggplot-0.9.2. - opts(title="") is replaced by labs(title="") as it is deprecated in ggplot-0.9.2. Version 0.1 ------------------------------ Initial version