BREAKING CHANGES

• data_read() now also returns Bayesian models from packagesbrms and
  rstanarm as original model objects, and no longer coerces them into data
  frames (#606).

• The output format ofdescribe_distribution() on grouped data has changed.
  Before, it printed one table per group combination. Now, it prints a single
  table with group columns at the start (#610).

• The output format ofdescribe_distribution() when confidence intervals are
  requested has changed. Now, for each centrality measure a confidence interval
  is calculated (#617).

• data_modify() now always uses values of a vector for a modified or newly
  created variable, and no longer tries to detect whether a character value
  possibly contains an expression. To allow expression provided as string (or
  character vectors), use the helper-functionas_expr(). Only literal
  expressions or strings wrapped inas_expr() will be evaluated as
  expressions, everything else will be treated as vector with values for new
  variables (#605).

CHANGES

• display() is now re-exported from packageinsight.

• data_read() anddata_write() now rely on base-R functions for files of
  type.rds,.rda or.rdata. Thus, packagerio is no longer required
  to be installed for these file types (#607).

• data_codebook() gives an informative warning when no column names matched
  the selection pattern (#601).

• data_to_long() now errors when columns selected to reshape do not exist in
  the data, to avoid nonsensical results that could be missed (#602).

• New argumentby indescribe_distribution() (#604).

• describe_distribution() now gives informative errors when column names
  in the input data frame conflict with column from the output table (#612).

• The methods forparameters_distribution objects are now defined in
  datawizard (they were previously inparameters) (#613).

BUG FIXES

• Fixed bug indata_to_wide(), where new column names innames_from were
  ignored when that column only contained one unique value.

• Fixed bug indescribe_distribution() when some group combinations
  didn't appear in the data (#609).

• Fixed bug indescribe_distribution() when more than one value for the
  centrality argument were specified (#617).

• Fixed bug indescribe_distribution() where settingverbose = FALSE
  didn't hide some warnings (#617).

• Fixed warning indata_summary() when a variable had the same name as
  another object in the global environment (#585).

BUG FIXES

• Fixed failing R CMD check on ATLAS, noLD, and OpenBLAS due to small numerical
  differences (#592).

BUG FIXES

• Fixed issue indata_arrange() for data frames that only had one column.
  Formerly, the data frame was coerced into a vector, now the data frame class
  is preserved.

• Fixed issue in R-devel (4.5.0) due to a change in howgrep() handles logical
  arguments with missing values (#588).

BREAKING CHANGES AND DEPRECATIONS

• datawizard now requires R >= 4.0 (#515).

• Argumentdrop_na indata_match() is deprecated now. Please use
  remove_na instead (#556).

• Indata_rename() (#567):

  • argumentpattern is deprecated. Useselect instead.
  • argumentsafe is deprecated. The function now errors whenselect
    contains unknown column names.
  • whenreplacement isNULL, an error is now thrown (previously, column
    indices were used as new names).
  • ifselect (previouslypattern) is a named vector, then all elements
    must be named, e.g.c(length = "Sepal.Length", "Sepal.Width") errors.

• Order of argumentsby andprobability_weights inrescale_weights() has
  changed, because formethod = "kish", theby argument is optional (#575).

• The name of the rescaled weights variables inrescale_weights() have been
  renamed.pweights_a andpweights_b are now namedrescaled_weights_a
  andrescaled_weights_b (#575).

• print() methods fordata_tabulate() with multiple sub-tables (i.e. when
  length ofby was > 1) were revised. Now, an integrated table instead of
  multiple tables is returned. Furthermore,print_html() did not work, which
  was also fixed now (#577).

• demean() (anddegroup()) gets anappend argument that defaults toTRUE,
  to append the centered variables to the original data frame, instead of
  returning the de- and group-meaned variables only. Useappend = FALSE to
  for the previous default behaviour (i.e. only returning the newly created
  variables) (#579).

CHANGES

• rescale_weights() gets amethod argument, to choose method to rescale
  weights. Options are"carle" (the default) and"kish" (#575).

• Theselect argument, which is available in different functions to select
  variables, can now also be a character vector with quoted variable names,
  including a colon to indicate a range of several variables (e.g."cyl:gear")
  (#551).

• New functionrow_sums(), to calculate row sums (optionally with minimum
  amount of valid values), as complement torow_means() (#552).

• New functionrow_count(), to count specific values row-wise (#553).

• data_read() no longer shows warning about forthcoming breaking changes
  in upstream packages when reading.RData files (#557).

• data_modify() now recognizesn(), for example to create an index for data
  groups with1:n() (#535).

• Thereplacement argument indata_rename() now supports glue-styled
  tokens (#563).

• data_summary() also accepts the results ofbayestestR::ci() as summary
  function (#483).

• ranktransform() has a new argumentzeros to determine how zeros should be
  handled whensign = TRUE (#573).

BUG FIXES

• describe_distribution() no longer errors if the sample was too sparse to compute
  CIs. Instead, it warns the user and returnsNA (#550).

• data_read() preserves variable types when importing files fromrds or
  rdata format (#558).

BREAKING CHANGES

• data_rename() now errors when thereplacement argument containsNA values
  or empty strings (#539).

• Removed deprecated functionsget_columns(),data_find(),format_text() (#546).

• Removed deprecated argumentsgroup andna.rm in multiple functions. Useby andremove_na instead (#546).

• The default value for the argumentdummy_factors into_numeric() has
  changed fromTRUE toFALSE (#544).

CHANGES

• Thepattern argument indata_rename() can also be a named vector. In this
  case, names are used as values for thereplacement argument (i.e.pattern
  can be a character vector using<new name> = "<old name>").

• categorize() gains a newbreaks argument, to decide whether breaks are
  inclusive or exclusive (#548).

• Thelabels argument incategorize() gets two new options,"range" and
  "observed", to use the range of categorized values as labels (i.e. factor
  levels) (#548).

• Minor additions toreshape_ci() to work with forthcoming changes in the
  {bayestestR} package.

CHANGES

• demean() (anddegroup()) now also work for nested designs, if argument
  nested = TRUE andby specifies more than one variable (#533).

• Vignettes are no longer provided in the package, they are now only available
  on the website. There is only one "Overview" vignette available in the package,
  it contains links to the other vignettes on the website. This is because there
  are CRAN errors occurring when building vignettes on macOS and we couldn't
  determine the cause after multiple patch releases (#534).

• Removehtmltools fromSuggests in an attempt of fixing an error in CRAN
  checks due to failures to build a vignette (#528).

BREAKING CHANGES

• The argumentinclude_na indata_tabulate() anddata_summary() has been
  renamed intoremove_na. Consequently, to mimic former behaviour,FALSE and
  TRUE need to be switched (i.e.remove_na = TRUE is equivalent to the former
  include_na = FALSE).

• Class names for objects returned bydata_tabulate() have been changed to
  datawizard_table anddatawizard_crosstable (resp. the plural forms,
  *_tables), to provide a clearer and more consistent naming scheme.

CHANGES

• data_select() can directly rename selected variables when a named vector
  is provided inselect, e.g.data_select(mtcars, c(new1 = "mpg", new2 = "cyl")).

• data_tabulate() gains anas.data.frame() method, to return the frequency
  table as a data frame. The structure of the returned object is a nested data
  frame, where the first column contains name of the variable for which
  frequencies were calculated, and the second column contains the frequency table.

• demean() (anddegroup()) now also work for cross-classified designs, or
  more generally, for data with multiple grouping or cluster variables (i.e.
  by can now specify more than one variable).

BREAKING CHANGES

• Arguments namedgroup orgroup_by are deprecated and will be removed
  in a future release. Please useby instead. This affects the following
  functions indatawizard (#502).

  • data_partition()
  • demean() anddegroup()
  • means_by_group()
  • rescale_weights()

• Following aliases are deprecated and will be removed in a future release (#504):

  • get_columns(), usedata_select() instead.
  • data_find() andfind_columns(), useextract_column_names() instead.
  • format_text(), usetext_format() instead.

CHANGES

• recode_into() is more relaxed regarding checking the type ofNA values.
  If you recode into a numeric variable, and one of the recode values isNA,
  you no longer need to useNA_real_ for numericNA values.

• Improved documentation for some functions.

BUG FIXES

• data_to_long() did not work for data frame where columns had attributes
  (like labelled data).

BREAKING CHANGES

• The following arguments were deprecated in 0.5.0 and are now removed:

  • indata_to_wide():colnames_from,rows_from,sep
  • indata_to_long():colnames_to
  • indata_partition():training_proportion

NEW FUNCTIONS

• data_summary(), to compute summary statistics of (grouped) data frames.

• data_replicate(), to expand a data frame by replicating rows based on another
  variable that contains the counts of replications per row.

CHANGES

• data_modify() gets three new arguments,.at,.if and.modify, to modify
  variables at specific positions or based on logical conditions.

• data_tabulate() was revised and gets several new arguments: aweights
  argument, to compute weighted frequency tables.include_na allows to include
  or omit missing values from the table. Furthermore, aby argument was added,
  to compute crosstables (#479,#481).