Metadata-Version: 2.3
Name: robustipy
Version: 1.0b1
Summary: Multiversal estimation for robust inference.
Project-URL: Homepage, https://robustipy.github.io/
Project-URL: Repository, https://github.com/RobustiPy/robustipy
Project-URL: Issues, https://github.com/RobustiPy/robustipy/issues
Author-email: Daniel Valdenegro <daniel.valdenegro@demography.ox.ac.uk>, Charles Rahal <charles.rahal@demography.ox.ac.uk>, Jiani Yan <jiani.yan@sociology.ox.ac.uk>
Maintainer-email: Daniel Valdenegro <daniel.valdenegro@demography.ox.ac.uk>
License: GPLv3
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
Requires-Dist: joblib>=1.2.0
Requires-Dist: joypy>=0.2.6
Requires-Dist: linearmodels>=4.27
Requires-Dist: matplotlib>=3.6.1
Requires-Dist: numpy>=1.23.2
Requires-Dist: pandas>=1.4.3
Requires-Dist: rich
Requires-Dist: scikit-learn
Requires-Dist: scipy>=1.9.0
Requires-Dist: seaborn
Requires-Dist: statsmodels>=0.13.2
Description-Content-Type: text/markdown

<img src="https://github.com/RobustiPy/RobustiPy.github.io/blob/main/assets/robustipy_logo_transparent_large_trimmed.png?raw=true" width="700"/>

![coverage](https://img.shields.io/badge/Purpose-Research-yellow)
[![Generic badge](https://img.shields.io/badge/Python-3.11-red.svg)](https://shields.io/)
[![Generic badge](https://img.shields.io/badge/R-brightgreen.svg)](https://shields.io/)
[![Generic badge](https://img.shields.io/badge/License-GNU3.0-purple.svg)](https://shields.io/)

Welcome to the home of RobustiPy, a library for the creation of a more robust and stable model space. Kindly note: **this project is in early stages of development and its functionally and API might change without notice**!

## Installation

To install directly (in `Python`) from GitHub run:

```
git clone https://github.com/RobustiPy/robustipy.git
cd robustipy
pip install .
```

## Usage

In a Python script (or Jupyter Notebook), import the OLSRobust class running:

```python
from robustipy.models import OLSRobust
model_robust = OLSRobust(y=y, x=x, data=data)
model_robust.fit(controls=c,
	             draws=100,
                 sample_size=100)
model_results = model_robust.get_results()
```
Where `y` is a list of variables names used to create your dependent variable, and `x` is a list of variables names used as predictors.

## Example

A working usage example `replication_example.py` is provided at the root of this repository. You can also find a number of empirical examples [here](https://github.com/RobustiPy/Empirical-Examples) and some simulated examples [here](Simulated-Examples).

![Union dataset example](./figures/union_example/union_curve_new.png)

## Website 

We have a shiny website made with `jekkyl-theme-minimal` that you can find [here](https://robustipy.github.io/). It also contains details of a Hackathon! 

## License
This work is free. You can redistribute it and/or modify it under the terms of the GNU 3.0 license. The two datasets listed above come with their own licensing conditions, and should be treatedly accordingly. 

## Acknowledgements
We are grateful to the extensive comments made by various academic communities over the course of our thinking about this work, not least the members of the [ESRC Centre for Care](https://centreforcare.ac.uk/) and the [Leverhulme Centre for Demographic Science](https://demography.ox.ac.uk/).

<div style="display: flex; justify-content: space-between;">
    <img src="https://github.com/RobustiPy/RobustiPy.github.io/blob/main/assets/cfc_logo.png?raw=true" alt="CfC" style="width: 200px; height: auto; margin-right: 20px;">
    <img src="https://github.com/RobustiPy/RobustiPy.github.io/blob/main/assets/lcds_logo.png?raw=true" alt="LCDS" style="width: 280px; height: auto;">
</div>

