A tool for single-case design data managment, statistical analysis and visualization.
Project description
Single Case Research Package
The Single Case Research package is a Python library designed to assist in conducting single-case research studies. The package provides tools to analyze single-case data sets. It is designed for simplicity and ease of use, with a range of methods to calculate various statistical measures for single-case data sets. The package is perfect for analysts and researchers dealing with single-case designs, providing a framework to load, manage, and manipulate such data, along with robust statistical functions to interpret the data.
More functionality will be added as the package is further developed
Installation
You can install the package using pip:
pip install singlecase
Usage
To use singlecase
, first import the package into your Python environment:
from singlecase.data import Data
Then, create a Data
object with either a pandas DataFrame or a dictionary:
df = pd.DataFrame({...}) # Or load your data from a CSV, database, etc.
data = Data(df)
Now you're ready to perform single-case data analysis!
Core Features
Data Class
The Data
class provides an object-oriented interface to represent your single-case data. It assumes any variable with datatype of float as a dependent variable. The dependent and phase variables can be accessed and modified using properties. For example:
data.pvar = 'column_name' # Set the phase variable
Nonoverlap Pairs (NAP)
The nap
function computes the Nonoverlap Pairs between two phases in a single-case data frame. It returns a pandas Series containing the NAP values for each dependent variable in the data set.
from singlecase.effectsize import nap
nap_values = nap(data)
Percent Non-overlapping Data (PND)
The pnd
function computes the Percent Non-overlapping Data between two phases in a single-case data frame. It returns a pandas Series containing the PND values for each dependent variable in the data set.
from singlecase.effectsize import pnd
pnd_values = pnd(data)
Permutation Test
The permutation_test
function performs a permutation test between two phases in a single-case data frame. It returns a pandas Series containing the p-values for each dependent variable in the data set.
from singlecase.permtest import permutation_test
p_values = permutation_test(data)
Complete example
This complete example creates a new singlecase.Data
from a Python dictionary. The dataset has two dependent variables dvar1
and dvar2
. The phase variable is called phase
and consists of the two phases "A" and "B". Based on this data, the PND and NAP values are calculated and printed.
import pandas as pd
from singlecase.data import Data
from singlecase.effectsize import pnd, nap
# Create a sample data
data_dict = {
'dvar1': [1.0, 2.5, 3.2, 4.6, 2.8, 5.6, 3.7, 4.2, 5.5, 6.2, 7.3, 8.5],
'dvar2': [2.5, 3.2, 4.6, 5.1, 4.8, 5.2, 6.7, 5.6, 6.2, 7.8, 8.4, 7.2],
'phase': ['A', 'A', 'A', 'A', 'A', 'A', 'B', 'B', 'B', 'B', 'B', 'B']
}
df = pd.DataFrame(data_dict)
# Instantiate Data object
data = Data(df)
# Set phase variable
data.pvar = 'phase'
# Calculate PND
pnd_values = pnd(data)
print(f"PND values: \n{pnd_values}")
# Calculate NAP
nap_values = nap(data)
print(f"NAP values: \n{nap_values}")
License
This project is licensed under the BSD 3-clause license - see the LICENSE file for details.
Acknowledgments
- The Single Case Research package is being developed by Casper Wilstrup.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for singlecase-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f2dd6896472b4d8ab96476ba0506cdba913773c59e5abfad250f1fd213ad6743 |
|
MD5 | e82c32388aa8882920f46c2f51278da8 |
|
BLAKE2b-256 | 15fcd7bafb59de1e441e81c33dc0c5cabedf5db07ba612030bd503af63b68973 |