This is a non-backwards-compatible update.
Major changes:
freqlist():
freqlist() is now an S3 generic. (#35)
The first argument to freqlist() has changed from tab= to object=, for S3 consistency. (#35)
freqlist.formula() was implemented, piggybacking off of stats::xtabs(). (#35)
The title= argument was added to summary.freqlist(). Passing caption= through the dots to knitr::kable() will now throw an error. (#34)
tableby():
as.data.frame.tableby() has been totally overhauled. It now uses list-columns to give exact values.
summary.tableby() has been totally overhauled.
Most arguments are no longer named, but passed through the dots.
It now returns an object, abusing in the process as.data.frame.tableby(). print.summary.tableby() prints the resulting object. (#8)
print.summary.tableby() now uses knitr::kable() to print results, instead of internal functions. As such, non-exported helper functions have all been removed.
The arguments to tableby.control() have changed. Warnings will be issued for using old arguments.
nsmall= has been removed. digits= takes its place.
nsmall.pct= and digits.test= have been renamed to digits.pct= and digits.p=, respectively.
There’s now an option for count digits (digits.count=).
format.p= has been added, to turn on formatting of p-values.
q1q3 is no longer a default continuous statistic.
NAs can be included in percents using includeNA().
Some additional survival summary functions are now available. (#32)
It is now possible to report row-percents using countrowpct(). (#9)
modelsum():
modelsum() has been totally overhauled:
It now uses stats::model.frame() and unevaluated calls instead of custom-creating data.frames.
It now allows for non-syntactic names (#44, #45).
as.data.frame.modelsum() has been totally overhauled. It now gives exact values instead of formatted values.
summary.modelsum() has been totally overhauled.
Most arguments are no longer named, but passed through the dots.
It now returns an object, abusing in the process as.data.frame.modelsum(). print.summary.modelsum() prints the resulting object. (#37)
print.summary.modelsum() now uses knitr::kable() to print results, instead of internal functions. As such, non-exported helper functions have all been removed.
print.summary.modelsum() now strips leading and trailing whitespace from labels to fix formatting with text=FALSE. (#48)
labelTranslations= no longer accepts labels for the statistics columns. Use modelsum.control(stat.labels=) for this instead.
The arguments to modelsum.control() have changed. Warnings will be issued for using old arguments.
nsmall= has been removed. digits= takes its place.
nsmall.ratio= and digits.test= have been renamed to digits.ratio= and digits.p=, respectively.
format.p= has been added, to turn off formatting of p-values.
stat.labels= has been added, to label the statistics columns.
"[.modelsum"() now has a named argument, and accepts character, numeric, and logical subscripts.
Smaller changes:
freqlist():
freqlist() will no longer issue a warning about using the deprecated varnames= argument.
print.freqlist() has been made slightly more concise. The only change to the printed output is making “variables” singular (“variable”) when only one variable is present.
tableby():
tableby() has also been made slightly more concise and easier to read.
A bug was fixed when trying to specify “stats” attributes for categorical variables. (#39)
A bug was fixed relating to unnamed passing of arguments for medianrange(). (#49)
as.data.frame.tableby() no longer breaks with date ranges. (#10)
as.data.frame.tableby() no longer breaks with both count() and countpct(). (#51)
labels<-.tableby() no longer breaks for unmatched variables. (#53)
labels<-.tableby() now accepts NULL to set all labels to NULL. (#52)
The function Nmiss2() is now exported for tableby(). Note that it is exactly the same as Nmiss(), but is interpreted differently in tableby().
modelsum():
modelsum() has been made slightly more concise.
“Nmiss2” has been added to the modelsum() object and no longer replaces “Nmiss”.
as.data.frame.modelsum() no longer turns “<0.001” into NA. (#31)
as.data.frame.modelsum() no longer breaks if there are too many adjustment variables. (#12)
summary.modelsum() now has working labels for factors. (#13)
"labels<-.modelsum"() has been tweaked slightly. The results shouldn’t change.
print.modelsum() has been fixed to show its y-variable. (#33)
Documentation and vignettes have been re-reviewed and updated where appropriate.
Tests have been updated to reflect major changes.
This is a patch to fix an error appearing with R-devel. We anticipate releasing v1.0.0 soon, which will not be backwards-compatible.
Updated freqlist() to be more efficient. (#20)
freqlist() now allows named labels.
Fixed one-sided formula detection in tableby() when used with formulize(). (#21)
Changed environment of formula returned by formulize().
Added variable-name subsetting to [.tableby(). One can now subset by logicals, numerics, or character vectors.
Fixed a bug in tableby() related to zero-length factor levels. (#22)
Fixed a bug in tableby() and modelsum() when calling them without loading the package. (#25)
Allowed nsmall = and digits = to be 0, for rounding to integers. (#23)
Added yaml() function to use with write2(). (#28)
Added the yaml package as a suggested package.
Added write2() methods for compare.data.frame() objects. (#27)
Updated documentation.
Code all now in GitHub; issues can now be submitted there. Checking is now performed automatically on Travis-CI.
Included documentation for getting a caption with write2() and freqlist(). (#16)
Fixed subsetting in modelsum(). (#14)
Fixed multiple class errors in tableby(). (#17)
Fixed subset dropping labels in tableby() and modelsum() with new function keep.labels() to make labels “stick”. (#1)
Added a vignette discussing labels.
Add compare.data.frame(), with an accompanying vignette.
Updated labelTranslation documentation
Changed format.translations list to defaultLabelTranslations() function, and removed labels for sex and age.
Tweaked labels<-.freqlist to allow for list input.
tableby() vignette.Tweaked freqlist() to behave better with data.frame subsetting and the infamous drop=TRUE.
Added dupLabels= argument to summary.freqlist(). (#6)
Added a label for medianq1q3() in tableby.control(). (#4)
Changed the ... vs. control= action in tableby() and modelsum() to fix which arguments are used over which other arguments. (#5)
Moved import broom and stringr to “Suggests”, adding magrittr for piping.
Added piping to write2*() vignette.
Several tableby() fixes for counts and percents.
New options in tableby.control() to modify the statistical tests performed. (#2)
Fixed trailing whitespace issue in tableby() (#3)
The CRAN release of the locally stable 0.2.3. For NEWS on this version, see below.
Tweaked the DESCRIPTION to include write2().
Fixed ordered stats in tableby().
Fixed a problem with as.data.frame.modelsum() introduced in v0.2.1.
Added count() function for tableby stats.
Two problems with survival models in modelsum() have been resolved.
write2.list() has been implemented, allowing multiple tables output into a single document. write2.verbatim() has been implemented, allowing monospaced output. The vignette has been updated along with all documentation.
The summary() output for tableby and modelsum objects now prints an extra blank header line, for better use inside R Markdown code chunks.
Two bugs in tableby() were corrected.
Vignettes have been updated.
write2() is now exported and supports all output formats supported by rmarkdown::render(). There is now a vignette for it and the S3 methods have been expanded to handle more inputs, including knitr::kable(), xtable::xtable(), and pander::pander_return().
Fixed a bug in summary.modelsum().
broom and stringr have been moved to imports instead of depends.
Several minor tweaks to freqlist for better readability and performance.
First release contains major functions tableby(), modelsum(), freqlist(), formulize(), and write2....
Vignettes are included for tableby(), modelsum(), and freqlist().