Type: Package
Title: Calculates Whisker Odds
Version: 0.1.0
Description: Descriptive statistics for large data tend to be low resolution on the tails. Whisker Odds generate a table of descriptive statistics for large data. This is the same as letter-values, but with an alternative naming of depths which allow for depths beyond 26. For a reference to letter-values see 'Heike Hofmann' and 'Hadley Wickham' and 'Karen Kafadar' (2017) <doi:10.1080/10618600.2017.1305277>.
License: MIT + file LICENSE
Encoding: UTF-8
RoxygenNote: 7.1.2
Imports: dplyr, stats, magrittr, tibble, glue, purrr
URL: https://github.com/alexhallam/wodds
BugReports: https://github.com/alexhallam/wodds/issues
Suggests: testthat (≥ 3.0.0)
Config/testthat/edition: 3
NeedsCompilation: no
Packaged: 2022-04-14 23:08:27 UTC; user
Author: Alex Hallam [aut, cre], R. Cody Heimberger [ctb]
Maintainer: Alex Hallam <alexhallam6.28@gmail.com>
Repository: CRAN
Date/Publication: 2022-04-15 10:50:02 UTC

Get depth from sample size

Description

Calculates the depth given a sample size and alpha level

Usage

get_depth_from_n(n, alpha = 0.05)

Arguments

n

an integer scalar sample size

alpha

alpha level such as 0.1, 0.05, 0.01. An alpha of 0.05 would be associated with a 95 percent confidence interval

Value

an integer depth

Examples

get_depth_from_n(1e4L, 0.05)

Get sample size from depth

Description

Calculates the sample size needed given an alpha level and depth

Usage

get_n_from_depth(d, alpha = 0.05, conservative = TRUE)

Arguments

d

an integer depth

alpha

alpha level such as 0.1, 0.05, 0.01. An alpha of 0.05 would be associated with a 95 percent confidence interval

conservative

a bool. default is FALSE. If TRUE then a conservative (larger) sample size is returned.

Value

a float sample size

Examples

get_n_from_depth(7L, 0.01)

make_wodd_name

Description

make_wodd_name a private function

Usage

make_wodd_name(index)

Arguments

index

int

Value

A vector


raw_wodd

Description

raw_wodd a private function

Usage

raw_wodd(index)

Arguments

index

int

Value

A vector


select_wodd_name_from_table

Description

select_wodd_name_from_table a private function

Usage

select_wodd_name_from_table(index)

Arguments

index

int

Value

A vector

Examples

select_wodd_name_from_table(1L)

wodd_format

Description

wodd_format a private function

Usage

wodd_format(wodd_name)

Arguments

wodd_name

string. "S0", "S1", "M". etc

Value

A string


Calculate whisker odds

Description

makes whisker odds

Usage

wodds(
  y,
  alpha = 0.05,
  include_tail_area = FALSE,
  include_outliers = FALSE,
  include_depth = FALSE
)

Arguments

y

A vector of values

alpha

the alpha level, such as 0.05 which is the compliment of the confidence interval, such as 0.95

include_tail_area

a binary. If true then include a column of tail area 2^(i)

include_outliers

a binary. If true include a column of outliers beyond the last wodd depth

include_depth

a binary. If true include a column indicating the depth of the letter value

Value

A dataframe of wodds

lower_value

lower value

wodd_name

Name of wodd

upper_value

upper value

Examples

set.seed(42)
wodds(rnorm(1e4, 0, 1))