Learn R Programming

ordinalsimr

The {ordinalsimr} package assists in constructing simulation studies of ordinal data comparing two groups. It is intended to facilitate translation of methodological advances into practical settings for e.g. applied statisticians and data analysts who want to determine an appropriate statistical test to apply on their data or a proposed distribution of data.

This package is primarily developed as a Shiny application which abstracts away the heavier coding aspect of setting up simulation studies. Instead, users can simply enter parameters and data distributions into the application, and save the results as an .rds file. The structure of the Shiny application only allows for one simulation to be specified at a time as opposed to a grid of parameters. However, the underlying functions for running the simulations are accessible. See vignette("ordinalsimr") for template code on setting up your own simulations manually.

Installation

You can install the development version of ordinalsimr from GitHub with:

# install.packages("devtools")
devtools::install_github(
  "NeuroShepherd/ordinalsimr",
  build_vignettes = TRUE
)

Running the App

The app can be started with the following code:

ordinalsimr::run_app()

If using the app repeatedly, it may be useful to change some of the options in the application to suit your needs. See the vignette “ordinalsimr-options” for more information, vignette("ordinalsimr-options", package = "ordinalsimr").

Recommendations

Simulations with 1000s of iterations will take minutes to hours to run. This should generally be ok on the Shiny app, but if you encounter issues, consider running the simulations in a separate R session using the functions provided in this package (rather than the Shiny app). See the vignette “coding-simulations” for more information, vignette("coding-simulations", package = "ordinalsimr").

Copy Link

Version

Install

install.packages('ordinalsimr')

Monthly Downloads

128

Version

0.2.0

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Pat Callahan

Last Published

March 7th, 2025

Functions in ordinalsimr (0.2.0)

ordinal_tests

Ordinal outcome tests
.onLoad

.onLoad
get_ordinalsimr_options

Get ordinalsimr options
assign_groups

Randomly assign groups
parse_ratio_text

Parse Ratio Text
calculate_t1_error

Calculate Type 1 Error
calculate_power_t2error

Calculate Hypothesis Test Parameters
plot_power

Plot Test Power
run_app

Run the Shiny Application
plot_distribution_results

Plot Distribution
set_ordinalsimr_options

Set ordinalsimr Shiny App Default Values
run_simulations

Run Simulations
ordinalsimr-package

ordinalsimr: Compare Ordinal Endpoints Using Simulations
simulation_data_one_group

Simulation Data for One Group
simulation_data_two_groups

Simulation Data for Two Groups
.set_options_helper

Set Option Helper
%>%

Pipe operator