Metadata-Version: 2.2
Name: jale
Version: 0.1.36
Summary: Package allowing users to run Activation Likelihood Estimation Meta-Analysis
Home-page: https://github.com/LenFrahm/JALE
Author: Lennart Frahm
Author-email: l.frahm@mailbox.org
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9, <3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: customtkinter==5.2.2
Requires-Dist: joblib>=1.3.2
Requires-Dist: nibabel>=5.2.1
Requires-Dist: numpy==1.26.4
Requires-Dist: pandas>=2.0.3
Requires-Dist: PyYAML>=6.0.2
Requires-Dist: scipy>=1.10.1
Requires-Dist: xgboost>=2.1.2
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: scikit-learn==1.5.2
Requires-Dist: matplotlib>=3.7.1
Requires-Dist: seaborn>=0.12.2
Requires-Dist: nilearn>=0.10.4
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# JALE

![Python Versions](https://img.shields.io/badge/python-3.9%20|%203.10%20|%203.11%20|%203.12-blue)
![Ruff](https://img.shields.io/badge/code%20style-Ruff-blueviolet)
![PyPI Version](https://img.shields.io/pypi/v/jale.svg)
![License](https://img.shields.io/github/license/LenFrahm/JALE.svg)

A Python package for conducting ALE (Activation Likelihood Estimation) meta-analyses, supporting a range of analysis workflows: standard ALE, probabilistic or cross-validated ALE, standard ALE contrast, and balanced ALE contrast.

For more detailed information regarding installation, usage and features please visit the [Github Wiki](https://github.com/LenFrahm/JALE/wiki).

## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Features](#features)
- [Background and References](#background-and-references)
- [License](#license)

## Installation

To install the ALE Meta-Analysis Package, run:

```bash
pip install jale
```
## Usage

Here’s how to use the project:

JALE requires a project folder that contains 3 files:
1. Experiment Data (Author, Subjects, Coordinates, Tags)
2. Analysis Data (Type of ALE, Tags to be included)
3. Yaml config file (specifying project folder path, filenames and ALE parameters)

The format of these files is very important and you should check the wiki for instructions.

For example files click [here](https://raw.githubusercontent.com/LenFrahm/JALE/master/JALE/assets/examples.zip).

Running an ALE can be done in two ways:

1. via CLI: 

```bash
python -m jale /path/to/yaml/file
```

2. in Python:

```python
from jale.ale import run_ale

run_ale(yaml_path='/path/to/yaml/file')
```

## Features

- Standard ("Main Effect") ALE
- Probabilistic ("Cross-Validated") ALE
- Standard ALE Contrast
- Balanced ALE Contrast

## Background and References

This project is based on research by 
- [Eickhoff et al., 2012](https://doi.org/10.1016/j.neuroimage.2011.09.017).
- [Eickhoff et al., 2016](https://doi.org/10.1016/j.neuroimage.2016.04.072).
- [Frahm et al., 2022](https://doi.org/10.1002/hbm.25898).
- [Frahm et al., 2023](https://doi.org/10.1016/j.neuroimage.2023.120383).
