-
Notifications
You must be signed in to change notification settings - Fork 31
/
NEWS
528 lines (300 loc) · 14.5 KB
/
NEWS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
Version 1.5.1.1
------------------------------
MINOR CHANGES
- Minimal changes to comply with CRAN requirements, specially dealing with
M1mac architecture.
- Remove suggested packages: rstan and nimble.
- Vignette minimal changes to comply with CRAN.
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