forked from AndriSignorell/DescTools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathNEWS
1764 lines (1411 loc) · 77.9 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
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
DescTools 0.99.55 (2024-03-17)
------------------------------
NEW FUNCTIONS ADDED:
*
UPDATED FUNCTIONS:
* MeanCIn() displays a warning if the required width of the confidence
interval exceeds the standard deviation.
* ToWrd.table() gets another default for row.names. It now is TRUE instead
of FALSE as before.
* OddsRatio.glm changes its argument use.profile's default from TRUE to FALSE.
* MedianCI() allows further bootstrap types, dots arguments are now passed on to the
bootstrap procedure. The argument R has been removed, but can still be
provided in the dots. Default type for boostrap is no longer 'basic' but
'perc', which seems better suited for the median.
(See discussion with MrJerryTAO in
https://github.com/AndriSignorell/DescTools/issues/109)
BUGFIXES:
* The text for prop.diff will be displayed in Desc.table().
DescTools 0.99.54 (2024-02-03)
------------------------------
NEW FUNCTIONS ADDED:
* as.ym() adds a yearmonth class for extracting dateparts and adding months.
* as.Date.ym() converts a yearmonth to a date.
* NALevel() allows to quickly define an alternative level for NAs in a factor.
* CutAge() is a convenient wrapper for cutting age variables in slices
of e.g. 10 years.
UPDATED FUNCTIONS:
* Year(), Month() now also extract the parts from a yearmonth representation.
* Hodges-Lehman now uses long-longs instead of integers, allowing larger vectors.
* AddMonthsYM() has been integrated in AddMonths(). Use AddMonths(as.ym(202402))
instead.
* The Desc() procedure now puts the response in columns instead in rows as up to now
in the case of two factor variables. So the resulting table is transposed compared
to before.
* The Desc() procedure for 2x2 tables includes a confidence interval for
the difference of proportions based on BinomDiffCI(..., method="mn").
BUGFIXES:
* The documentation of RelRisk() did not correspond to the code.
(Credits to martyoh, https://github.com/AndriSignorell/DescTools/issues/118)
DescTools 0.99.53 (2024-01-17)
------------------------------
NEW FUNCTIONS ADDED:
* New implementation of 2-sample HodgesLehmann estimator.
* Fade() combines ColToOpaque(SetAlpha(col))
UPDATED FUNCTIONS:
* pckg.yaml has a dTri entry now.
BUGFIXES:
* HodgesLehman() mixed up the one sample and two sample case.
DescTools 0.99.52 (2023-11-30)
------------------------------
NEW FUNCTIONS ADDED:
* dTri(), pTri(), qTri() and rTri() return the specific values for
a triangular distribution.
UPDATED FUNCTIONS:
* New C++ port of the Hodges-Lehman estimator following
Monahan's algorithm https://dl.acm.org/doi/10.1145/1271.319414.
(Credits go to Cyril Flurin Moser)
see: https://github.com/AndriSignorell/DescTools/issues/97
BUGFIXES:
* Dependency R>=4.3. for DescTools 0.99.51 has been fixed.
DescTools 0.99.51 (2023-11-19)
------------------------------
NEW FUNCTIONS ADDED:
* Labels() is a vectorized function for Label().
* SDN() and VarN() return the uncorrected (biased) estimators for
standard deviation and variance (sometimes needed for
didactical reasons).
* EX() and VarX() return the expected value and the variance for
the distribution of a discrete random variable.
* Mgsub() is a vectorized version for gsub, allowing to replace
multiple patterns at the same time.
* New function GiniDeltas() returns the Gini variant from Deltas.
(Credits to Wim Bernasco, https://github.com/AndriSignorell/DescTools/issues/120)
UPDATED FUNCTIONS:
* TwoGroups() gains a formula interface. plot(), print() and ToWrd()
routines have been better organized.
* Hardcoded ANSI colors have been replaced by their cli::variants.
* LCM() and GCD() no longer use the library BH, but rely on
standard C++ functions instead.
BUGFIXES:
* HunterGaston() now calculates what it always pretended to do.
(Credits to Wim Bernasco)
* Internal function NormWeights() does no more remove 0 values on the
value vector x.
* VonNeumannTest() uses the correct normal approximation now.
(Credits to LukeAFullard in https://github.com/AndriSignorell/DescTools/issues/126)
DescTools 0.99.50 (2023-09-02)
------------------------------
NEW FUNCTIONS ADDED:
* The confidence intervals for the coefficient of variation are calculated
by the new function CoefVarCI(). Additional methods have been implemented.
So far these are: "vangel","mckay","nct","naive".
UPDATED FUNCTIONS:
* Mode() returns NA for a vector of length = 1.
* CoefVar() confidence intervals have been organised in a new function.
* DFLOAT replaced by DBLE everywhere in Fortran code.
DescTools 0.99.49 (2023-05-14)
------------------------------
UPDATED FUNCTIONS:
* Better solution for the set.seed issue in DunnetTest
(Credits to Michael Chirico in
https://github.com/AndriSignorell/DescTools/pull/102)
* BoxedText() supports xy.coords now.
* Two new methods for MultinomCI() have been implemented
(Fitzpatrick-Scott and Quesensberry-Hurst).
* BinomCI() no longer reports p_tilde but the usual x/n as
p estimator for the Agresti-Coull confidence intervall.
As a replacement for this, there is a argument std_est with
which the method specific non-standard point estimator can be returned.
(Thanks to julienbio99, MrJerryTAO and Vilmantas for the
research and discussion)
* VarTest() gets a more exact calculation for twosided p values
in the case of the one sample test.
BUGFIXES:
* MultinomCI method goodman uses the correct chisquare quantile now.
(Credits to yanka3 and Vilmantas Gegzna)
* LogStInv() would not have used the correct base for the log.
(Credits to Martin Maechler)
DescTools 0.99.48 (2023-02-17)
------------------------------
NEW FUNCTIONS ADDED:
* Nf() shortcut for as.numeric(factor(x, ...)).
UPDATED FUNCTIONS:
* RndPairs() can deliver associated pairwise nominal random variables.
* WeekDay() and Month() will return an ordered factor instead of a factor.
* Recode() can recode NAs to a new code.
* TMod() can be given an order for the models.
* GTest gains a rescale.p argument.
BUGFIXES:
* DunnettTest will not use .Random.seed in background jobs.
DescTools 0.99.47 (2022-10-22)
------------------------------
UPDATED FUNCTIONS:
* Gini() has been recoded to gain better support for weights.
* PlotProbDist() gains a dots argument.
* BoxedText() has two renamed arguments old txt.col has be
renamed to col and old col has been renamed to bg.
* Set fixed global .RandomSeed for Dunnett-test in order to get
reproducible results.
BUGFIXES:
* Corrected a bug in confidence intervals for Cohen's D.
(Credits to Jerry Tao)
DescTools 0.99.46 (2022-08-30)
------------------------------
UPDATED FUNCTIONS:
* Append() gains a TOne interface, to be able to add rows to a Table 1 (TOne) object.
* BarText() internally uses the more flexible BoxedText() instead of text().
* DunnTest, ConoverTest, VanWaerdenTest, NemenyiTest, DunnettTest get new organizing
code analogue to kruskal.test in order to handle characters as factors correctly.
* DunnTest() returns the matrix of p-Values in addition.
* Format() gains a new interface for ftables.
BUGFIXES:
* IdentifyA() now reverses the coordinates in the attribute.
* Two changes in the helpfiles of BinomRatCI() ans StdCoef() which popped up
with R 4.2.
DescTools 0.99.45 (2022-05-09)
------------------------------
NEW FUNCTIONS ADDED:
* SplitToDummy() for splitting a string vector and create a dummy code matrix.
UPDATED FUNCTIONS:
* CochranArmitageTest has been updated to use scores instead of ordinal values only.
Further the alternatives have been reduced to c("two.sided", "one.sided")
instead of c("two.sided", "increasing", "decreasing"), which were poorly defined.
* BoxedText gains a formula interface.
* RevCode takes dots now, for reverse numeric codes.
* Gmean will now report NA whenever there is a negative value in vector x,
despite if x also contains zero (like SAS, unlike SPSS).
(Credits to Imanol Zubizarreta)
* Quantile() now uses the argument "names", which so far had no
meaning within the function body.
* PlotCorr() now displays the matrix in the same form, as it is defined.
x is internally transposed.
* In Desc.table() the Phi coefficient has been replaced by Kendall Tau-B.
Phi is only sensible in the case of two dichotomous variables, and then
CramerV, which is also reported by default, has the same value.
* CourseData() will open xl-datafiles containing a description tab and
define factors based on this information, as well as set labels.
* DunnetTest will no longer set.seed() within the function, which was used
to generate comparable results, but was a drawback for simulations.
(Credits to marcoegv on github)
BUGFIXES:
* JonckheereTest's formula interface will now also support additional
arguments.
* Bug in Cohen Kappa SE calculation fixed.
* Quantile's default type has been changed from type 5 to type 7,
which was documented, but not implemented.
* PlotCorr() mislabeled the legend when breaks were specified (Credits for the
fix to Duncan Murdoch).
* Several replacements of T with TRUE, which have apparently always
slipped through until now. (Again, the credit goes to Duncan Murdoch.)
DescTools 0.99.44 (2021-11-22)
------------------------------
NEW FUNCTIONS ADDED:
* PlotProbDist() is a convenience interface for plotting probability
distributions with shaded areas.
* rSum21() returns random numbers which sum to 1, allowing to define digits.
UPDATED FUNCTIONS:
* Recode() will accept characters and in this case also return a character vector.
* BarText() will also support stacked barplots for naming the groups.
BUGFIXES:
* AUC() did not handle missing values correctly. (Credits to Denise Horn-Oudshoorn)
DescTools 0.99.43 (2021-09-08)
------------------------------
UPDATED FUNCTIONS:
* An adaptation to a change in the function exact.test, used in
BarnardTest(). (Credits to Peter Calhoun)
BUGFIXES:
* Main title in PlotQQ was not updated correctly.
* Stuart-Maxwell test would not have stated the perfect agreement correctly.
(Credits to Yusef Al-Naher)
DescTools 0.99.42 (2021-06-16)
------------------------------
NEW FUNCTIONS ADDED:
* PlotDotCI() is a convenience interface for PlotDot() to plot group-wise
confidence intervals.
* Bg() paints the background of a base R plot.
* ABCCoords() returns the coordinates for literal positions as "bottomright",
"topleft", etc..
UPDATED FUNCTIONS:
* Freq will report the median class as attribute.
* Desc.numeric() and Desc.Date() get a new attribute include_x to prevent the
function to return the provided argument x.
BUGFIXES:
* PlotDot() did not calculate correctly the left margin. In this connection
two more arguments have been introduced: automar and gshift.
* StrExtractBetween() did not use the first match for the left boundary.
DescTools 0.99.41 (2021-04-09)
------------------------------
NEW FUNCTIONS ADDED:
* NAIf() replaces a vector of elements by NAs.
* MeanCIn() gives the required samplesize to obtain a confidence interval
of a given width.
* Rank() is added at the expense of DenseRank() using a fast implementation in
data.table, that allows ranking based on multiple columns.
* %::% does the same as %:% but in greedy mode, say using the last match instead
of the first one.
* For given dates, YearDays() and MonthDays() return the number of days in the
year, or in the month respectively.
UPDATED FUNCTIONS:
* RevCode() has been extended to process factors and logicals too.
* BarText() will support offset by now. It also gets a new argument pos,
which replaces the old one.
BUGFIXES:
* TMod() will not insert empty columns, when results are output to Word.
* Hmean() will return NA for the confidence intervals in case we encounter
negative values. This was promised so in the help file, but never delivered.
(Credits to David R. Weise)
* StrExtractBetween() would have rejected to extract parts between two identical
characters.
* Quantile(), and in consequence Median(), would not have treated missings correctly.
* QuantileCI() will handle multiple probs now and respect coverage for one
sided intervals (Credits to Alexander Ploner).
DescTools 0.99.40 (2021-02-03)
------------------------------
NEW FUNCTIONS ADDED:
* StrExtractBetween() returns the part of a string bounded by the expression
"left" on the left side and "right" on the right side.
* Some new checks have been added. We will continuously add more
in the near future.
* GenRandGroups() generates random groups for a vector.
* %:% is a "from-to" operator for elements in a vector using match criteria.
UPDATED FUNCTIONS:
* PasswordDlg() allows to add a checkbox option.
* BinomRatCI() has undergone some streamlining concerning input and output.
* AllIdentical() has been rewritten to run 4 times faster.
* BinomCI() gets new method "blaker".
* CombN() used an awkward definition of arguments, which was changed
from x to n.
* PlotDot() gets a better positioning algorithm for axes labels, when
cex is not 1. Further it's possible to change cex for group pch.
BUGFIXES:
* Classic confidence intervals for Skew() and Kurt() are now reported on
both sides.
DescTools 0.99.39 (2020-12-06)
------------------------------
NEW FUNCTIONS ADDED:
* GetCalls() returns the function calls used within a given function.
* BhapkarTest() is a more powerful alternative to StuartMaxwellTest().
UPDATED FUNCTIONS:
* MultMerge() offers an option to define a merging column.
* TextToTable() gets a new argument "check.names".
* Outlier() gets a new option "hampel".
* TOne() allows to omit test by setting TEST=NA.
* BinomCI() gets three more methods "waldcc", "midp" and "lik".
BUGFIXES:
* Bug in Zodiac() led to a wrong zodiac for June 21. (Credits to pmarkun)
* plot.Desc.numnum() will respect given xlab/ylab now.
* TOne() adapts the number of column names if the total sum is suppressed.
* Warning in print.Desc.numfact has been fixed.
* BinomCI for the method wilsoncc would not have returned the correct values
in cases the estimator was 0 or 1. (Credits to Martin Mayer)
* R reported a warning in CohenKappa as a cast form 1d array to vector had
not been done. (Credits to Chris Andrews)
DescTools 0.99.38 (2020-09-06)
------------------------------
NEW FUNCTIONS ADDED:
* ORToRelRisk.glm() converts odds ratios from a logistic regression
to relative risks.
* RevCode() reverses the codes of a numeric variable (e.g. a Likert
scale).
* MADCI() calculates confidence intervals for the median absolute deviation(s).
* QuantileCI() yields confidence intervals for any quantile.
* BinomCIn() returns the sample size which is necessary to obtain a confidence
interval with a given width, at a specified p and confidence level.
UPDATED FUNCTIONS:
* The Format() argument "leading" has been replaced by "ldigits". Leading zeros
can now be coded with the number of leading zeros instead of using
character coding like "000".
* BinomDiffCI() gets two further methods "haldane" and "jeffery perks".
* XLView() gets a new argument "sep" (implementing a request of Mahboob).
* CutQ() accepts integer number for breaks.
* ColorLegend() gets the option to add a title and silently returns the geometry
in the similar way to legend().
BUGFIXES:
* Bug in BinomDiffCI() for methods score and scorecc has been fixed.
(Credits to Meredith Peratikos)
DescTools 0.99.37 (2020-07-09)
------------------------------
NEW FUNCTIONS ADDED:
* PlotConDens() plots conditional densities using a grouping variable.
* StrSplit() is a convenience function with more defaults than strsplit.
* SplitToCol() splits columns of a data.frame using a split.
* WrdDeleteBookmark() extends the suite of WrdBookmark functions.
* CmykToRgb(), CmyToCmyk(), CmykToCmy() have been added to have a
color code conversion path from RGB to CMYK.
UPDATED FUNCTIONS:
* Append() for data.frames can also append rows now.
* PlotCashflow() gain some more arguments enhancing its flexibility.
* We switch to a more flexible implementation of Barnard test by
Peter Calhoun's Exact package.
* Minor changes to PlotLinesA() to be able to easier add lines.
* ToWrd.TMod() uses a more sophisticated export logic for splitting the
columns of a resulting data.frame to a Word table compatible
character matrix.
* Format() interpretes negative "digits" argument in the same manner as round.
* Format() accepts defined named templates with the argument fmt.
* MAE(), MSE(), RMSE() will pass on dots arguments to mean() allowing to
trim the data.
* WrdBookmark()'s argument "bookmark" has been renamed to name to
be consistent with the rest of the word bookmark functions.
* TOne()'s "fmt.pval" argument has been replaced with the more general
"fmt", which allows to define formats for counts, numbers, percentages
AND p-values.
* SplitPath() gets a further information "fullpath".
* StrTrunc() gets two new arguments "ellipsis" and can truncate strings
on word boundaries with "useWordBoundaries".
* as.fmt() will allow to set the label of the format template.
* We use a more flexible implementation of PseudoR2 (Credits to Ben Mainwaring).
BUGFIXES:
* Format() will respect eps if defined in a format template "fmt" now.
* StrExtract() does its job even with NAs.
DEPRECATED:
* CentralValue() did not survive the "general usefulness-checks".
DescTools 0.99.36 (2020-05-22)
------------------------------
UPDATED FUNCTIONS:
* Plot Desc.table object now reverses the default color for the second
mosaicplot to ensure the upper left cell has the same color in both
cases.
* Desc.table() will also report relative risks for rows when verbose is
set to 3.
* Documentation and github integration have been improved (thanks to
Vilmantas Gegzna).
* TMod() will report number of variables in the model and the
number of estimated coefficients.
* tol in UnirootAll has been substantially reduced as the default
was too coarse.
* Rev() gets a new interface for arrays.
* ScheffeTest() gets a formula interface.
* plot.Desc.numnum can insert a linear model and exponential line now.
* SpearmanRho() gets a new algorithm for tables and no longer crudely
inflates a frequency table to single case presentation.
BUGFIXES:
* PasswordDlg() gets all its required arguments back again.
DescTools 0.99.35 (2020-04-26)
------------------------------
NEW FUNCTIONS ADDED:
* HunterGaston() calculates the index of dicrimination for nominal data,
going back to Simpson, published by Hunter-Gaston.
* Desc interface for classes ts and xts has been added.
* New documentation to be published as a pkgdown website (Credits for that
go to Vilmantas Gegzna).
* The vignettes are built now by means of R.rsp
* StripAttr() removes attributes from an object.
UPDATED FUNCTIONS:
* PlotACF() gets some better defaults and new arguments.
* PlotECDF() loses its argument cex.axis, which is not necessary as we
should use the general par approach.
* PlotFdist() will support user defined ylims in the histogram now.
Moreover some internal arguments are handled more consistently.
* print.TMod() will accept argument "digits" now (as Beat Bruengger required)
* Desc.numeric will support conf.levels now instead of set fixed 95%-CI.
* ToWrdPlot() gains another argument "pointsize".
* Desc.formula() supports one sided formulas.
* Desc.formula() now propagates arguments for tables as rfrq and freq
(Credits to Sereina Graber).
* Desc() for numeric ~ categorical variables can report more descripitve
statistics by setting the verbose argument to 3.
BUGFIXES:
* Outlier() will now use the third quartile instead of NA.
* Cstat() did not respect ties correctly.
* Two errors due to archaic code in demo(describe) and demo(plots)
were spotted by V. Gegzna.
DescTools 0.99.34 (2020-03-12)
------------------------------
UPDATED FUNCTIONS:
* TextContrastColor() gets new options to choose white/black color.
* Some updates to helpfiles.
BUGFIXES:
* PlotArea() does no longer use dots arguments for the polygon function.
But they are still passed on to matplot().
* Corrected deparse1() bug causing a build error for all current versions
on CRAN.
DescTools 0.99.33 (2020-03-08)
------------------------------
NEW FUNCTIONS ADDED:
* AllIdentical() allows to check multiple objects to be exactly equal.
* CountWorkDays() return the number of workdays within a time period.
* VanWaerdenTest() completes the group of non-parametric (post hoc) tests.
* RSessionAlive() and RTempAlive() return the time since starting R, resp.
creating them temporary directory.
UPDATED FUNCTIONS:
* Conf() is extended by Matthew's correlation coefficient.
* Pal() gets the new palette "Helsana2"
* MeanAD()'s argument FUN has been renamed to center to be
consistent with MAD().
* MeanAD(), MAD(), CoefVar(), Skew(), Kurt() support weights now.
* Mar() and Mgp() will return visible when all arguments are NULL.
Both get a new argument reset for reset sets to their defaults.
BUGFIXES:
* SetNames() will now do what was promised in the helptext and
delete names if NULL is provided as argument.
DescTools 0.99.32 (2020-01-17)
------------------------------
NEW FUNCTIONS ADDED:
* ColToOpaque(), RgbToHex() are two new color converter functions.
* ImputeKnn() and CentralValue() have been borrowed from the
DMwR package.
UPDATED FUNCTIONS:
* WrdCellRange's arguments have been renamed from old: rstart, rend to
new: from, to.
* WrdTableBorders() loses its wrd argument, the information is now
extracted directly from wtab.
* Untable() will by default replace NAs by 0 in a table and display a
warning if there are NAs.
* plot.TMod() allows to provide a terms list for plotting.
BUGFIXES:
* Cramer's V bias correction is corrected (hmm...).
* TMod() supports single models now.
DescTools 0.99.31 (2019-12-21)
------------------------------
NEW FUNCTIONS ADDED:
* WrdUpdateFields() can be used to update fields in a Word document.
* Mgp() does the same for axis title, labels and line as Mar() does
for the margins.
* PlotPairs() is a more specific pairs() variant.
* IQRw() supports weights for calculating the interquartile range.
UPDATED FUNCTIONS:
* ToXL() uses a faster create function for XL column names.
* ToXL() will use a more elaborated export for tables, matrices and arrays.
* GetNewWrd() will insert a title at the bookmark "Main" in the document.
* CramerV() and TschuprowT() get a bias correction option.
* Recycle uses an optimised "getmaxdim" logic (thanks to moodymudskipper
for the suggestion).
* Mode() gets a more elaborated interface and returns all modes if there
are several.
* SetNames() will recycle provided names and supports abbreviations.
BUGFIXES:
* ToWrd() for characters works again after an error crept into v. 0.99.30
(due to insufficient testing).
* TTestA() did not exclude the paired option, which should have been the case.
(Credits to Vilmantas Gegzna)
* Dummy() will always return a matrix instead of dropping dimensions which
have only one level. (Credits to Daniel Wollschlaeger)
* XLGetrange() will not refuse to import areas with XLErrors now, cells formatted
as dates will be recognised and empty areas will not cause an error
anymore.
* MedianCI will now correctly use conf.level for method="exact" and also
return the realised conf.level.
* Corrected predict call for vglm in PseudoR2. (Thnks to Daniel Wollschlaeger)
DEPRECATED:
* PlotDev() X was both a desperate and unsuccessful attempt to rid the analysis
code of superfluous technical reporting code. The new approach uses meta-code
together with ToWrdWithBookmark(), which does not require any changes to
the original code. As a result, PlotDev() has been removed.
DescTools 0.99.30 (2019-10-21)
------------------------------
NEW FUNCTIONS ADDED:
* CompleteColumns() will return the names of complete columns of a data frame.
* ToWrdB() sends the output of a code chunk to Word and tags it with
a bookmark.
* ToWrdPlot() does the same with a code chunk producing a plot. It plots to
a tiff device and imports the graphic in MS-Word. These two functions allow
to dynamically update word documents with new R-results.
* WrdOpenFile() is used to open Word documents.
* CmToPts() and PtsToCm() convert between centimeters and points.
UPDATED FUNCTIONS:
* Mode() gets a real fast Rcpp implementation. (Credits to Ralf Stubner
and Joseph Wood)
* Desc.numeric() will notify when the mode has higher frequency than 5%
(which is likely to be remarkable for a numeric variable).
BUGFIXES:
* PseudoR2() will work with negative binomial models again.
* Untable would not have returned the expected results in some combinations
of column names. (Credits to Vilmantas Gegzna for detecting this issue)
* Desc() would not have handled unnamed lists. (Again Vilmantas noticed this)
DescTools 0.99.29 (2019-09-26)
------------------------------
NEW FUNCTIONS ADDED:
* StrSpell() can translate a string to NATO phonetic alphabet or Morse codes.
* XLNamedReg() can be used to import named regions in Excel by giving the
name or the sequence number. This can be used in connection with XLGetRange().
* WithOptions() is an interesting approach to evaluate expressions under
temporarily set options.
* With SaveAs() it's possible to save an R object under a different name.
* Quot() calculates successive divisions in the same way as diff() does with
successive differences.
* XLSaveAs() is a wrapper for saving the active workbook in MSExcel.
* SendOutlookMail() allows to easily send mails via MS Outlook.
* MultMerge() can merge multiple data frames using the rownames as key.
UPDATED FUNCTIONS:
* PlotCandlestick() gets a more appropriate x-axis algorithm.
* XLGetRange() is given a new argument "skip" in order to be able to skip a
given number of heading rows in a selected range.
* YearDay will start with 1 on the first of January instead of 0 as so far.
* Several corrections in help texts.
* roulette, cards, tarot have been extended
* Format() will ignore scipen=0 by default, use scipen=1 in future.
* Format() will pass through the digits argument for formatting p-values
(fmt="p").
* SetNames() will use "names" for unnamed arguments as default instead of
returning the unchanged input vector.
* BlankIfNA() gets a new argument for defining what is meant with "blank".
* PseudoR2() is using reformulate() instead of update() in order to improve
interoperability within the tidyverse, especially support tibbles created
by purr::map. (Credits to Inferrator)
* ConvUnit() will now convert time units to weeks and vice versa.
* AUC() gains new arguments according to its original version in package MESS.
(Credits to Claus Ekstrom and Tatiana Lust)
BUGFIXES:
* plot(Desc()) for xtabs will work now.
* OddsRatio for glms would have misplaced confidence intervals, if
a coefficient in the model could not be estimated and was set to NA.
* Calculation of AldrichNelson Pseudo R2 has been corrected
(credits to Chirok Han).
DEPRECATED:
* FileOpenCmd(), SaveAsDlg(), ModelDlg(), ColPicker(), ColorDlg(),
ImportFileDlg(), PlotPar(), PlotMar(), PlotPch(), SelectVarDlg(), Xplore()
have been transferred to the package DescToolsAddIns, as these functions
presumably only make sense in a GUI context.
* IsValidWrd() has been replaced by IsValidHwnd(), which can be used to
generally check Windows handles (at least for Office applications).
DescTools 0.99.28 (2019-03-17)
------------------------------
NEW FUNCTIONS ADDED:
* Freq2D() calculates a frequency distribution for two continuous variables.
* BlankIfNA() and NAIfBlank() do for characters what ZeroIfNA() does for
numeric values.
UPDATED FUNCTIONS:
* TMod() uses a new order for the coefficients. They are returned in
sequence of their first appearance in the provided models.
* ModelDlg() supports sorting and filtering of the variables now.
* Lc() gains a predict() interface to estimate Lorenz curves for new percentages.
* PlotQQ() gets a better algorithm for calculating confidence interval bands.
* SplitPath gets a more general regex pattern to separate the extension from
the filename.
* StrExtract allows for Perl-like regex patterns now.
BUGFIXES:
* BarText() will handle vectors and 1d arrays correctly now.
* ModSummary() for lms did not handle NAs in coefficient list correctly.
DescTools 0.99.27 (2019-01-19)
------------------------------
NEW FUNCTIONS ADDED:
* Divisors() returns the divisors of an integer.
* ConvUnit() converts non-SI units and SI units supporting prefixes.
* WrdSaveAs() is a wrapper for saving documents in MS-Word.
UPDATED FUNCTIONS:
* MeanDiffCI() gets a new argument sides for one sided confidence intervals.
And so do BinomCI(), BinomDiffCI(), MultinomCI(), PoissonCI().
* PlotDot will use slightly different defaults.
* The legend in PlotLinesA can have a title now.
* ToWrd() gets an argument "bullet" in order to insert a bullet list.
* CollapseTable() will accept missing names now.
* HexToRgb() will accept RRGGBBAA (containing an alpha channel) definitions now.
BUGFIXES:
* ZeroIfNa() will not coerce an integer to numeric anymore.
* WrdCaption() will not insert superfluous NAs anymore.
* Hmean()'s one sided confidence intervals are no longer reversed.
* PlotLinesA() will respect x and y arguments now.
* PlotMiss() had a suboptimal handling of marginal texts.
* McKelveyZavoina's pseudo R2 would not have been correctly calculated when
using a factor as reponse variable.
DEFUNCT:
* UnitConv() has been replaced by ConvUnit().
* Lookup() failed the functionality test. Nothing more than match().
DescTools 0.99.26 (2018-11-13)
------------------------------
NEW FUNCTIONS ADDED:
* ToXL() allows to export data.frames to XL more easily and flexibly.
* dir.choose() does for directories what file.choose() does for files.
* xlConst is a list of a few useful Excel VBA constants.
* SMAPE() has been around for quite a while. It also is exported now.
* Sample() is a wrapper for sample(), adding an option to sample from data.frames.
SampleTwins() will be integrated in Sample() in near future.
* DoBy() is a more flexible replacement for PartitionBy().
* Dot(), Cross() and CrossN() can be used for vector geometry tasks.
UPDATED FUNCTIONS:
* Outliers() gets a new argument value allowing to return the indices of the
outliers.
* TOne() looses its NUMTEST argument and gets a new TEST argument in order to
make the definition of tests more flexible. The p-value can now be formatted
with fmt.pval.
* TMod() and OddsRatio() get a plot function to compare coefficients and
confidence intervals.
* GetNewXL() will start with a new workbook now.
* Format() accepts functions as argument "fmt" from now on.
* Format() will recyle arguments when formatting data.frames, allowing to have
different formats for different columns.
* PlotQQ() gets an argument datax to flip the x and y axis - as qqplot() also has.
* OddsRatio.glm() gets an argument "use.profile" in order to skip profiling when
calculating confidence intervals (which can take very long time to complete).
* BinomDiffCI() gets new methods for calculating confidence intervals for a
difference of proportions ("mee", "mn", "ha", "scorecc"). At the same time
BinomCI() has been extended by the needed method "wilsoncc" (Wilson with
continuity correction).
BUGFIXES:
* Desc() will not show an error for variables of class Date containing just one
unique value.
* TMod() did not parse the model labels correctly.
* BinomDiffCI() would not have returned correct results for a difference of 0.
(Thanks to Stephen Roberts, who with his enquiry brought about the completion
of the function.)
DEFUNCT:
* PartitionBy() has been replaced by DoBy().
DescTools 0.99.25 (2018-08-14)
------------------------------
NEW FUNCTIONS ADDED:
* GeomSn() calculates the elements of a geometric series.
* UnirootAll() is a simple extension of uniroot which extracts many
(presumably all) roots in an interval.
* A handful new financial functions have been included: PMT(), IPMT(),
PPMT(), RBAL() for periodic payment for an annuity, SLN(), DB(), SYD()
for calculating depreciation.
* XLCurrReg() can be used to import current regions in Excel with only
a left upper cell address.
* TwoGroups() describes a numeric variable by a factor with two levels.
* PlotCashFlow() creates a simple depiction for the timing of cash flows.
* WrdPageBreak() inserts a page break at the cursor position.
UPDATED FUNCTIONS:
* Winsorize() gains an argument "type" to choose the quantile algorithm.
* NPV() has been vectorized for the argument i.
* IRR() allows to enter the interval for the solutions being searched in and
uses UnirootAll() to find all the solutions.
* OddRatio() gets an interface for glms to produce an odds ratio result table for
logistic regression objects.
* ModSummary() gets an interface for OddsRatio produced by OddsRatio() and TMod()
supports the comparison of OddsRatios.
* PoissonCI() gets a new method "byar" for confidence intervals.
* VarCI() gains a new method "bonett" giving intervals with improved coverage in
nonnormal distributions.
* StrVal() gets an optimized regex (Credits to Markus Naepflin)
* plot.desc() for numeric ~ factor offers another plot type consisting of a density
plot and a boxplot.
* Phrase() can remove NAs now.
* Bivariate Desc() for numeric ~ factor allows to freely choose the test to be used.
* XLView() gains an argument "preserveStrings", to prevent factors or characters
to be converted to numeric when imported in Excel.
* "Additional_repositories" has been changed from http://www.stats.ox.ac.uk/pub/RWin/
to http://www.omegahat.net/R, as the service in Oxford is no longer provided.
BUGFIXES:
* TOne() will display the legend also when marginal results are omitted.
DescTools 0.99.24 (2018-03-19)
------------------------------
NEW FUNCTIONS ADDED:
* CountCompCases() returns the number of complete cases in a data frame and
a table with all the missing of the single variables, as well as the number
of complete cases we would receive, if the variable was omitted.
* SplitAt() splits a vector at given positions.
* Append() is used to append elements to a vector, rows/columns to a matrix
and columns to a data.frame in the in the same sense as append().
* Add some new univariate parametric extreme value distributions with their
distribution, quantile and density functions.
UPDATED FUNCTIONS:
* Wald-Wolfowitz-test may produce inconsistent results if ties exist between
two samples. A warning will now be displayed for such cases.
(Credits to Vilmantas Gegzna)
* PlotCorr() gets a main argument, which places the main title in a better
position.
* Recode() will accept integer definitions for the groups of levels to collapse.
A new argument num will return numeric values.
* Shade() gets a upgrade on the expression interface again. It now uses the
same logic as is implemented in curve().
* PlotFaces() receives a face lifting.
* PercTable() will break long tables into multiple rows the same way
as table() does when it's printed.
* ModelDlg() will edit an already existing formula when selected.
* TOne() gains a new argument "intref" defining the values to be reported for
dichotomous numeric and boolean variables.
* StrVal() gets an additional argument "dec" allowing to use a userdefined
decimal point when parsing the text.
* XLGetRange() gains a "na.strings" argument for replacing NA characters by real NAs.
BUGFIXES:
* identify.formula() would have omitted NAs while preparing the model.frame
and so might have returned wrong rownumbers. It will now by default pass
NAs if the argument has not been set.
* Gmean will return 0 if any element of x is zero now.
* Desc.character would not have passed the plots when output to MS-Word.
DEFUNCT:
* InsCol() and InsRow() have been condensed into Append(), which is more
general and more flexible.
* PlotMatrix() has not been used and was obsolete.
DescTools 0.99.23 (2017-12-11)
------------------------------
NEW FUNCTIONS ADDED:
* TTestA() will calculate a Student t-test using given sample statistics
rather than actual data.
* NAIfZero is defined to revert ZeroIfNA().
UPDATED FUNCTIONS:
* FixToTab() has been renamed to FixToTable() due to naming consistency
reasons
* ChooseColorDlg() has been renamed to ColDlg()
* The names for StuartTauC(), GoodmanGamma() results have been
consequently set to lwr.ci and upr.ci.
* Shade loses the argument xlim for the new one named breaks and can
now shade multiple areas.
* A Rev interface for data.frames has been added.
* PlotPyramid() gets a new argument rev and does return the result invisibly.
* SortMixed() and OrderMixed have been updated with newest gtools version.
* TOne() will consequently report the reference level for dichotomic factors.
* TMod() will use modelnames for the table now.
* BinomCI() will finally use rownames for a resulting matrix.
* Between and Outside functions (%[]%, %)[%, ...) accept dates now.
BUGFIXES:
* Trim() mixed up the order of the response vector and did not return
correct results. (Credits to Bastien Ferland-Raymond)
* Conf() did not return the correct detection prevalence.
* PlotBinTree() would not have placed the text correctly in the horizontal
representation.
* Str() would not have passed ... args to str, as stated in help.
* PlotLinesA() would not have set supplied margins.
* IsZero() would mistakenly have returned TRUE for negative values.
* ToWrd.table will place the title right behind the table instead at the
end of the document.
DescTools 0.99.22 (2017-09-13)
------------------------------
NEW FUNCTIONS ADDED:
* Timezone() extracts the timezone from a POSIXct object.
* SetNames() can set rownames, columnnames or simply names.
* PercentRank() calculates percent ranks.
UPDATED FUNCTIONS:
* PlotCorr() gets a new argument "mincor" for preventing small
correlations from being displayed.
* PlotBubble() would use better graphical functions to display the bubbles.
* BubbleLegend() offers some more arguments.
* LogSt() can now do what LogLin could.
* PolarGrid() offers more control for axis labels.
* WrdTableBorders() gets arguments for width and color of the borders.
BUGFIXES:
* ModelDlg() would not have returned long data.frames correctly.
* Freq() would not have calculated percentages, when NAs were to be included
and a userdefined order was desired.
DEFUNCT:
* Date() was needless, as ISODate does the same job.
* Exec(x), consisting out of eval(parse(text=x)) did not contain enough
functionality to justify an own function.
* Same applies to AddClass() and RemoveClass().