https://github.com/acclab/dabest-matlab
MATLAB package to generate contrast plots
https://github.com/acclab/dabest-matlab
Last synced: 5 months ago
JSON representation
MATLAB package to generate contrast plots
- Host: GitHub
- URL: https://github.com/acclab/dabest-matlab
- Owner: ACCLAB
- License: bsd-3-clause-clear
- Created: 2017-11-24T10:32:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-09-10T14:07:23.000Z (almost 6 years ago)
- Last Synced: 2025-09-08T23:17:37.426Z (9 months ago)
- Language: MATLAB
- Homepage:
- Size: 1.21 MB
- Stars: 35
- Watchers: 4
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# DABEST-Matlab
## About
DABEST is a data analysis tool that is intended to make estimation statistics more accessible to scientific communities. Estimation statistics is a superior alternative to null hypothesis significance testing (NHST), in which effect size and confidence intervals are used to interpret results as opposed to dichotomous significance testing.
This code allows the user to visualize the data as scatterplots; calculates the effect size and confidence intervals of the difference between multiple groups; and plots the results on the same figure. This figure design allows for a visual inspection of the observed values distribution, and displays the differences between multiple groups of data.
## Installation
DABEST-Matlab can be installed via MATLAB Central (https://www.mathworks.com/matlabcentral/fileexchange/65260-dabest-matlab) or GitHub (how to clone a repo: https://help.github.com/articles/cloning-a-repository/).
## How to cite
**Moving beyond P values: Everyday data analysis with estimation plots**
*Joses Ho, Tayfun Tumkaya, Sameer Aryal, Hyungwon Choi, Adam Claridge-Chang*
Nature Methods 2019, 1548-7105. [10.1038/s41592-019-0470-3](http://dx.doi.org/10.1038/s41592-019-0470-3)
[Paywalled publisher site](https://www.nature.com/articles/s41592-019-0470-3); [Free-to-view PDF](https://rdcu.be/bHhJ4)
## Bugs
Please report any bugs on the [Github issue tracker](https://github.com/ACCLAB/DABEST-Matlab/issues/new).
## Contributing
All contributions are welcome; please read the [Guidelines for contributing](https://github.com/ACCLAB/DABEST-Matlab/blob/master/CONTRIBUTING.md) first.
We also have a [Code of Conduct](https://github.com/ACCLAB/DABEST-Matlab/blob/master/CODE_OF_CONDUCT.md) to foster an inclusive and productive space.
## DABEST in other languages
DABEST is also available in R ([dabestr](https://github.com/ACCLAB/dabestr)) and Python ([DABEST-Python](https://github.com/ACCLAB/DABEST-Python)).
## Tutorial
### Data format
Data should be in *the csv file format* and contain two columns with the headers: *Identifiers* and *Values*.
*Identifiers* are the labels of each data point, and *Values* are the data points (see the example below).
*Note: All the sample data used in this tutorial are taken from S. Champely's [anscombe2](https://www.rdocumentation.org/packages/PairedData/versions/0.9.9/topics/anscombe2) dataset, and can be found in DABEST-Matlab/SampleData/*.
Depending on the number of groups the data contain, the main function *dabest* produces various plots, and returns the key
information as a table object.
### 1. Two groups
If the data have two different groups, `dabest('TwoGroups_sample.csv')` generates a *two groups* plot.
### 2. Paired
Running `dabest('TwoGroups_sample.csv','Paired')` generates a *paired* plot with the two groups data.
### 3. Multiple groups
If the number of groups is an **even number**, a *multiple groups* plot will be automatically generated by `dabest('MultipleGroups_sample.csv')` command.
### 4. Shared control
If there are more than two groups in the data, `dabest('MultipleGroups_sample.csv')` generates a *shared control* plot.
### 5. Merged groups
To combine two groups of data and compare to a third group, run `dabest('MergedGroups_sample.csv','mergeGroups')`.
### 6. Multiple merged groups
For the data that contain more than three groups -and a number that is divisible by 3, `dabest('MultipleMergedGroups_sample.csv','mergeGroups')` generates a *multiple merged groups* plot.
### 7. Merged shared control
If the data contain more than three groups, `dabest('MultipleMergedGroups_sample.csv','mergeGroups')` automatically generates a second plot in which all the groups are compared to the *merged shared control*.
