wilcoxText: Generates strings of text for the use in markdown documents

Description Usage Arguments Value Examples

View source: R/wilcoxText.R

Description

This function takes as input one object containing the result of a one- and two-sample Wilcoxon tests on vectors of data (from a call to the wilcox.test function) and returns its most important informations. The exact information returned depends on the method used for the correlation: Pearson's correlation returns r, t and degrees of freedom, and P-value; Spearman returns rho, S, and P-value; and Kendall returns tau, z, and P-value. Function corText offers options to customize the output, like changing separators and decimal markers (helpful in case you are producing a manuscript in German or Portuguese), and choosing the number of digits to round numbers to.

Usage

1
wilcoxText(x, df = NULL, sep = "; ", dec = "default", digits = c(3, 3))

Arguments

x

Name of the object containing the result of the analysis from which stats should be extracted.

df

Allows to included the number of degrees of freedom there were in the data. This information cannot be retrieved from the object containing the result of a call to wilcox.test. For two-sample cells it seems to be n1+n2, but (n1+n2)/2 for a paired test.

sep

How to separate pieces of information displayed. Defaults to a semicolon followed by a space (sep = "; ").

dec

Which decimal separator should be used? Defaults to ".". Allows to quickly changing to a comma in case you are producing a manuscript in German or Portuguese.

digits

How many digits should be kept for each piece of numeric information? Defaults to c(3, 3). Importantly, when a P-value rounded to the number of digits hereby defined results in zero, the result is replaced by a more theoretically meaningful alternative (e.g. P < 0.001).

Value

A string of text to be included in a markdown object.

Examples

1
2
3
4
res <- wilcox.test(extra ~ group, data = sleep, paired=T)
wilcoxText(res)
# Changing decimal marker in case you are producing a manuscript in German or Portuguese 
wilcoxText(res, dec=",")

eduardohet/resulteR documentation built on Aug. 9, 2021, 3:02 a.m.