desc_stats: Descriptive statistics

In jinkim3/kim: A Toolkit for Behavioral Scientists

Descriptive statistics

Description

Returns descriptive statistics for a numeric vector.

Usage

desc_stats(
  vector = NULL,
  output_type = "vector",
  sigfigs = 3,
  se_of_mean = FALSE,
  ci = FALSE,
  pi = FALSE,
  skewness = FALSE,
  kurtosis = FALSE,
  notify_na_count = NULL,
  print_dt = FALSE
)

Arguments

vector	a numeric vector
output_type	if output_type = "vector", return a vector of descriptive statistics; if output_type = "dt", return a data.table of descriptive statistics (default = "vector")
sigfigs	number of significant digits to round to (default = 3)
se_of_mean	logical. Should the standard errors around the mean be included in the descriptive stats? (default = FALSE)
ci	logical. Should 95% CI be included in the descriptive stats? (default = FALSE)
pi	logical. Should 95% PI be included in the descriptive stats? (default = FALSE)
skewness	logical. Should the skewness statistic be included in the descriptive stats? (default = FALSE)
kurtosis	logical. Should the kurtosis statistic be included in the descriptive stats? (default = FALSE)
notify_na_count	if TRUE, notify how many observations were removed due to missing values. By default, NA count will be printed only if there are any NA values.
print_dt	if TRUE, print the descriptive stats data.table

Value

if output_type = "vector", the output will be a named numeric vector of descriptive statistics; if output_type = "dt", the output will be data.table of descriptive statistics.

Examples

desc_stats(1:100)
desc_stats(1:100, ci = TRUE, pi = TRUE, sigfigs = 2)
desc_stats(1:100, se_of_mean = TRUE,
ci = TRUE, pi = TRUE, sigfigs = 2,
skewness = TRUE, kurtosis = TRUE)
desc_stats(c(1:100, NA))
example_dt <- desc_stats(vector = c(1:100, NA), output_type = "dt")
example_dt

jinkim3/kim documentation built on July 17, 2025, 3:03 a.m.