MARADONER

MARADONER: Motif Activity Response Analysis Done Right

MARADONER is a tool for analyzing motif activities using promoter expression data. It provides a streamlined workflow to estimate parameters, predict deviations, and export results in a tabular form.

Basic Workflow

A typical MARADONER analysis session involves running commands sequentially for a given project:

create: Initialize the project. This step parses your input files (promoter expression, motif loadings, optional motif expression, and sample groupings), performs initial filtering, and sets up the project's internal data structures.
```
# Example: Initialize a project named 'my_project'
maradoner create my_project path/to/expression.tsv path/to/loadings.tsv --sample-groups path/to/groups.json [other options...]
```
- Input files are typically tabular (.tsv, .csv), potentially compressed.
- You only need to provide input data files at this stage.
fit: Estimate the model's variance parameters and mean motif activities using the data prepared by create.
```
maradoner fit my_project [options...]
```
predict: Estimate the deviations of motif activities from their means for each sample or group, based on the parameters estimated by fit.
```
maradoner predict my_project [options...]
```
export: Save the final results, including estimated motif activities (mean + deviations), parameter estimates, goodness-of-fit statistics, and potentially statistical test results (like ANOVA) to a specified output folder.
```
maradoner export my_project path/to/output_folder [options...]
```

Other Useful Commands

gof: After fit, calculate Goodness-of-Fit statistics (like Fraction of Variance Explained or Correlation) to evaluate how well the model components explain the observed expression data.
```
maradoner gof my_project [options...]
```
select-motifs: If you provided multiple loading matrices in create (e.g., from different databases) with unique postfixes, this command helps select the single "best" variant for each motif based on statistical criteria. The output is a list of motif names intended to be used with the --motif-filename option in a subsequent create run.
```
maradoner select-motifs my_project best_motifs.txt
# Then, potentially re-run create using the generated list:
# maradoner create my_project_filtered ... --motif-filename best_motifs.txt
```
generate: Create a synthetic dataset with known properties for testing or demonstration purposes.
```
maradoner generate path/to/synthetic_data_output [options...]
```

Getting Help

Each command has various options for customization. To see the full list of commands and their detailed options, use the --help flag:

maradoner --help
maradoner create --help
maradoner fit --help
# and so on for each command

Cite

For the time being, you can cite our technical arXiv paper that explains MARADONER's inner clockworks in a great detail:

@misc{meshcheryakov2026,
      title={MARADONER: Motif Activity Response Analysis Done Right}, 
      author={Georgy Meshcheryakov and Andrey I. Buyan},
      year={2026},
      eprint={2602.03343},
      archivePrefix={arXiv},
      primaryClass={stat.CO},
      url={https://arxiv.org/abs/2602.03343}, 
}

Metadata

Release files for maradoner 0.30.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for maradoner 0.30.3
File	Size	Uploaded
maradoner-0.30.3.tar.gz	100.3 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for maradoner 0.30.3
File	Interpreter	ABI	Platform	Reset
maradoner-0.30.3-py3-none-any.whl 108.1 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 208.4 kB

Release files / maradoner-0.30.3.tar.gz

Download URL	maradoner-0.30.3.tar.gz
Size	100.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`220fd4e3fbdade65d2045b55c4bc09ae28b6e409d41fa4ab5136e5a4336ad4d9`
BLAKE2b-256 checksum How to use checksums	`6c0e3510c0d7703db40f9c21d1268da524d2a0253e9ed3d03208b58c67d531a2`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / maradoner-0.30.3-py3-none-any.whl

Download URL	maradoner-0.30.3-py3-none-any.whl
Size	108.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9fd885fac225223057cc256ec32b1dbdd5fe292a38b5108b5c0963caa594eded`
BLAKE2b-256 checksum How to use checksums	`0c0fe5a37132c1a654582282428c28ae70560afea5a97aed3a3d3f55bcc71bc1`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`