Read me

Package maintainer

Andrew Penn (andy.c.penn@gmail.com)

Package contributors

Andrew Penn
(More contributors are welcome!)

Citations

If you use this package, please include the following citation(s):

(Note that package versions 5.4.3 and below were named the ‘statistics-bootstrap’ package. The ‘statistics-resampling’ package is a more developed version of the older ‘iboot’ package).

Description

The statistics-resampling package is an Octave package and Matlab toolbox that can be used to overcome a wide variety of statistics problems using non-parametric resampling methods. In particular, the functions included can be used to estimate bias, uncertainty (standard errors and confidence intervals), prediction error, and test hypotheses (p-values). Variations of the resampling methods are included that improve the accuracy of the statistics for small samples and samples with complex dependence structures.

Requirements and dependencies

Core functions in this package are known to be compatible with versions of Octave 4.4.0+ and Matlab R2007a 7.4.0+. Some features of this package have specific dependencies:

Installation

To install (or test) the statistics-resampling package at a location of your choice for either Matlab or Octave, follow these steps:

If you want or need to uninstall the package, change directory (cd) into the package folder and type uninstall.

Alternatively, Octave users can install the latest release of the package just like any other Octave package by typing:

pkg install -forge statistics-resampling

Or for the most recent developmental version of the package:

pkg install "https://github.com/gnu-octave/statistics-resampling/archive/refs/heads/master.zip"

The package can then be loaded on demand in Octave with the following commmand:

pkg load statistics-resampling

(Note that this isn’t necessary if you used the local installation instructions first described in this section)

Alternatively, MATLAB users can conveniently install the package functions as a toolbox by double-clicking the ‘statistics-resampling.mltbx’ file in the matlab subdirectory. The toolbox installed in this way can be disabled or uninstalled via MATLAB’s Add-On manager. Currently, MEX files are included with the toolbox installation for Windows (32- or 64-bit), MacOS (Intel 64-bit) and Linux (64-bit). Without the MEX files, all functionality of the package is available, but some of the functions run slower.

N.B. The package does not yet include any MEX files (for Octave or Matlab) precompiled for macOS with Apple silicon processors, since the package developers do not have access to this computer platform. If you used this package on macOS with an Apple silicon processor (M1-3 chip), please consider contacting the package maintainer to contribute the MEX files to this project.

Usage

All help and demos are documented on the ‘Function Reference’ page in the manual. If you do not see the navigation pane on the manual web pages, please enable javascript in your browser. If you need help with using any of the functions in this package, please post your questions on the discussions page.

Function help can also be requested directly from the Octave/MATLAB command prompt, by typing help function-name - substituting in the actual function name.

In Octave only, you can get a basic overview of the package and it’s functions by typing: pkg describe -verbose statistics-resampling, or request demonstrations of function usage by typing demo function-name. Users can also request help with using functions and programming in Octave at the discourse group.

Quick start

Below are some links to demonstrations of how the bootstrap or randomization functions from this package can be used to perform variants of commonly used statistical tests, but without the Normality assumption:

Issues

If you find bugs or have any suggestions, please raise an issue on GitHub here. Please, make sure that when reporting a bug you provide as much information as possible for other users to be able to replicate it.

Package: statistics-resampling