ReMoDe 0.2.0

Recursive Mode Detection for ordinal data

ReMoDe: a Python library for efficient mode detection in ordinal data distributions.

ReMoDe (Recursive Mode Detection) is a Python library designed for the robust detection of modes in ordinal data distributions. It uses statistical tests, including Fisher's exact test and binomial tests, to determine if a given maximum in a data distribution is a true local maximum.

Features

• Mode Detection: Identifies all potential local maxima in the dataset.
• Statistical Tests: Implements Fisher's exact test and binomial tests to validate modes.
• Mode Statistics: Returns per-mode p-values and approximate Bayes factors.
• Data Formatting: Converts raw data into histogram format for analysis.
• Stability Analysis: Includes functionality to assess the stability of detected modes using jackknife resampling.
• Visualization: Provides methods to plot the histogram of data along with identified modes.

Installation

pip install remode

Usage

Here is a simple example of how to use the ReMode library:

from remode import ReMoDe

# Sample data (histogram counts)
xt_count = [8, 20, 5, 2, 6, 2, 30]

# Create an instance of ReMoDe
detector = ReMoDe(alpha_correction="descriptive_peaks")  # default

# Fit model
results = detector.fit(xt_count)
# results contains:
# - nr_of_modes
# - modes
# - p_values
# - approx_bayes_factors

# Plot the results
detector.plot_maxima()

# Perform stability analysis
stability_info = detector.remode_stability(percentage_steps=50)

See also the tutorial here.

Citation

Please cite the following paper:

TBA

and the following software

Garcia-Bernardo, J., Hoffstadt, M., & van der Maas, H. L. J. (2025). ReMoDe: a Python library for efficient mode detection in ordinal data distributions. Zenodo. https://doi.org/10.5281/zenodo.15366121

Contributing

Contributions are what make the open source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please refer to the CONTRIBUTING file for more information on issues and pull requests.

License

This project is licensed under the GNU GPLv3. This allows you to do almost anything they want with this project, except distributing closed source versions.

Contact

This project is a port of the R version of ReMoDe. It is maintained by the ODISSEI Social Data Science (SoDa) team.

Do you have questions, suggestions, or remarks? File an issue in the issue tracker!