statista


Namestatista JSON
Version 0.6.3 PyPI version JSON
download
home_pageNone
Summarystatistics package
upload_time2025-08-08 20:36:46
maintainerNone
docs_urlNone
authorNone
requires_python<4,>=3.11
licenseGPL-3.0-or-later
keywords statistics distributions extreme-value-analysis probability sensitivity-analysis
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Statista - Advanced Statistical Analysis Package

[![Python Versions](https://img.shields.io/pypi/pyversions/statista.svg)](https://pypi.org/project/statista/)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://serapieum-of-alex.github.io/statista/latest/)
[![codecov](https://codecov.io/gh/Serapieum-of-alex/statista/branch/main/graph/badge.svg?token=GQKhcj2pFK)](https://codecov.io/gh/Serapieum-of-alex/statista)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
[![GitHub last commit](https://img.shields.io/github/last-commit/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/commits/main)
[![GitHub issues](https://img.shields.io/github/issues/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/issues)
[![GitHub stars](https://img.shields.io/github/stars/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/network/members)

## Overview

**Statista** is a comprehensive Python package for statistical analysis, focusing on probability distributions, extreme value analysis, and sensitivity analysis. It provides robust tools for researchers, engineers, and data scientists working with statistical models, particularly in hydrology, climate science, and risk assessment.

Current release info
====================

| Name | Downloads                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Version | Platforms |
| --- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |
| [![Conda Recipe](https://img.shields.io/badge/recipe-statista-green.svg)](https://anaconda.org/conda-forge/statista) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![Downloads](https://pepy.tech/badge/statista)](https://pepy.tech/project/statista) [![Downloads](https://pepy.tech/badge/statista/month)](https://pepy.tech/project/statista)  [![Downloads](https://pepy.tech/badge/statista/week)](https://pepy.tech/project/statista)  ![PyPI - Downloads](https://img.shields.io/pypi/dd/statista?color=blue&style=flat-square) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![PyPI version](https://badge.fury.io/py/statista.svg)](https://badge.fury.io/py/statista) [![Anaconda-Server Badge](https://anaconda.org/conda-forge/statista/badges/version.svg)](https://anaconda.org/conda-forge/statista) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![Join the chat at https://gitter.im/Hapi-Nile/Hapi](https://badges.gitter.im/Hapi-Nile/Hapi.svg)](https://gitter.im/Hapi-Nile/Hapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |


conda-forge feedstock
=====================
[Conda-forge feedstock](https://github.com/conda-forge/statista-feedstock)

## Installation

### Conda (Recommended)

```bash
conda install -c conda-forge statista
```

### PyPI

```bash
pip install statista
```

### Development Version

```bash
pip install git+https://github.com/Serapieum-of-alex/statista
```

## Main Features

### Statistical Distributions
- **Probability Distributions**: GEV, Gumbel, Normal, Exponential, and more
- **Parameter Estimation Methods**: Maximum Likelihood (ML), L-moments, Method of Moments (MOM)
- **Goodness-of-fit Tests**: Kolmogorov-Smirnov, Chi-square
- **Truncated Distributions**: Focus analysis on values above a threshold

### Extreme Value Analysis
- **Return Period Calculation**: Estimate extreme events for different return periods
- **Confidence Intervals**: Calculate confidence bounds using various methods
- **Plotting Positions**: Weibull, Gringorten, and other empirical distribution functions

### Sensitivity Analysis
- **One-at-a-time (OAT)**: Analyze parameter sensitivity individually
- **Sobol Visualization**: Visualize parameter interactions and importance

### Statistical Tools
- **Descriptive Statistics**: Comprehensive statistical descriptors
- **Time Series Analysis**: Auto-correlation and other time series tools
- **Visualization**: Publication-quality plots for statistical analysis

## Quick Start

### Basic Usage

```python
import pandas as pd
from statista.distributions import Distributions

# Load your time series data
data = pd.read_csv("your_data.csv", header=None)[0].tolist()

# Create a distribution object (e.g., Gumbel)
dist = Distributions("Gumbel", data)

# Fit the distribution using maximum likelihood
params = dist.fit_model(method="mle")
print(params)

# Calculate and plot the PDF and CDF
pdf = dist.pdf(plot_figure=True)
cdf, _, _ = dist.cdf(plot_figure=True)

# Perform goodness-of-fit tests
ks_test = dist.ks()
chi2_test = dist.chisquare()

# Create a probability plot with confidence intervals
fig, ax = dist.plot()
```

### Extreme Value Analysis

```python
from statista.distributions import GEV, PlottingPosition

# Create a GEV distribution
gev_dist = Distributions("GEV", data)

# Fit using L-moments
params = gev_dist.fit_model(method="lmoments")

# Calculate non-exceedance probabilities
cdf_weibul = PlottingPosition.weibul(data)

# Calculate confidence intervals
lower_bound, upper_bound, fig, ax = gev_dist.confidence_interval(plot_figure=True)
```

For more examples and detailed documentation, visit [Statista Documentation](https://serapieum-of-alex.github.io/statista)

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

## Citation

If you use Statista in your research, please cite it as:

```
Farrag, M. (2023). Statista: A Python package for statistical analysis, extreme value analysis, and sensitivity analysis.
https://github.com/Serapieum-of-alex/statista
```

BibTeX:
```bibtex
@software{statista2023,
  author = {Farrag, Mostafa},
  title = {Statista: A Python package for statistical analysis, extreme value analysis, and sensitivity analysis},
  url = {https://github.com/Serapieum-of-alex/statista},
  year = {2023}
}
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "statista",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4,>=3.11",
    "maintainer_email": null,
    "keywords": "statistics, distributions, extreme-value-analysis, probability, sensitivity-analysis",
    "author": null,
    "author_email": "Mostafa Farrag <moah.farag@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/0b/61/287d7f37876c20eb56e12549f402d89c5dfdba54af0e81ab6ef0ceef0bea/statista-0.6.3.tar.gz",
    "platform": null,
    "description": "# Statista - Advanced Statistical Analysis Package\n\n[![Python Versions](https://img.shields.io/pypi/pyversions/statista.svg)](https://pypi.org/project/statista/)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://serapieum-of-alex.github.io/statista/latest/)\n[![codecov](https://codecov.io/gh/Serapieum-of-alex/statista/branch/main/graph/badge.svg?token=GQKhcj2pFK)](https://codecov.io/gh/Serapieum-of-alex/statista)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)\n[![GitHub last commit](https://img.shields.io/github/last-commit/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/commits/main)\n[![GitHub issues](https://img.shields.io/github/issues/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/issues)\n[![GitHub stars](https://img.shields.io/github/stars/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/Serapieum-of-alex/statista)](https://github.com/Serapieum-of-alex/statista/network/members)\n\n## Overview\n\n**Statista** is a comprehensive Python package for statistical analysis, focusing on probability distributions, extreme value analysis, and sensitivity analysis. It provides robust tools for researchers, engineers, and data scientists working with statistical models, particularly in hydrology, climate science, and risk assessment.\n\nCurrent release info\n====================\n\n| Name | Downloads                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Version | Platforms |\n| --- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |\n| [![Conda Recipe](https://img.shields.io/badge/recipe-statista-green.svg)](https://anaconda.org/conda-forge/statista) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![Downloads](https://pepy.tech/badge/statista)](https://pepy.tech/project/statista) [![Downloads](https://pepy.tech/badge/statista/month)](https://pepy.tech/project/statista)  [![Downloads](https://pepy.tech/badge/statista/week)](https://pepy.tech/project/statista)  ![PyPI - Downloads](https://img.shields.io/pypi/dd/statista?color=blue&style=flat-square) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![PyPI version](https://badge.fury.io/py/statista.svg)](https://badge.fury.io/py/statista) [![Anaconda-Server Badge](https://anaconda.org/conda-forge/statista/badges/version.svg)](https://anaconda.org/conda-forge/statista) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/statista.svg)](https://anaconda.org/conda-forge/statista) [![Join the chat at https://gitter.im/Hapi-Nile/Hapi](https://badges.gitter.im/Hapi-Nile/Hapi.svg)](https://gitter.im/Hapi-Nile/Hapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |\n\n\nconda-forge feedstock\n=====================\n[Conda-forge feedstock](https://github.com/conda-forge/statista-feedstock)\n\n## Installation\n\n### Conda (Recommended)\n\n```bash\nconda install -c conda-forge statista\n```\n\n### PyPI\n\n```bash\npip install statista\n```\n\n### Development Version\n\n```bash\npip install git+https://github.com/Serapieum-of-alex/statista\n```\n\n## Main Features\n\n### Statistical Distributions\n- **Probability Distributions**: GEV, Gumbel, Normal, Exponential, and more\n- **Parameter Estimation Methods**: Maximum Likelihood (ML), L-moments, Method of Moments (MOM)\n- **Goodness-of-fit Tests**: Kolmogorov-Smirnov, Chi-square\n- **Truncated Distributions**: Focus analysis on values above a threshold\n\n### Extreme Value Analysis\n- **Return Period Calculation**: Estimate extreme events for different return periods\n- **Confidence Intervals**: Calculate confidence bounds using various methods\n- **Plotting Positions**: Weibull, Gringorten, and other empirical distribution functions\n\n### Sensitivity Analysis\n- **One-at-a-time (OAT)**: Analyze parameter sensitivity individually\n- **Sobol Visualization**: Visualize parameter interactions and importance\n\n### Statistical Tools\n- **Descriptive Statistics**: Comprehensive statistical descriptors\n- **Time Series Analysis**: Auto-correlation and other time series tools\n- **Visualization**: Publication-quality plots for statistical analysis\n\n## Quick Start\n\n### Basic Usage\n\n```python\nimport pandas as pd\nfrom statista.distributions import Distributions\n\n# Load your time series data\ndata = pd.read_csv(\"your_data.csv\", header=None)[0].tolist()\n\n# Create a distribution object (e.g., Gumbel)\ndist = Distributions(\"Gumbel\", data)\n\n# Fit the distribution using maximum likelihood\nparams = dist.fit_model(method=\"mle\")\nprint(params)\n\n# Calculate and plot the PDF and CDF\npdf = dist.pdf(plot_figure=True)\ncdf, _, _ = dist.cdf(plot_figure=True)\n\n# Perform goodness-of-fit tests\nks_test = dist.ks()\nchi2_test = dist.chisquare()\n\n# Create a probability plot with confidence intervals\nfig, ax = dist.plot()\n```\n\n### Extreme Value Analysis\n\n```python\nfrom statista.distributions import GEV, PlottingPosition\n\n# Create a GEV distribution\ngev_dist = Distributions(\"GEV\", data)\n\n# Fit using L-moments\nparams = gev_dist.fit_model(method=\"lmoments\")\n\n# Calculate non-exceedance probabilities\ncdf_weibul = PlottingPosition.weibul(data)\n\n# Calculate confidence intervals\nlower_bound, upper_bound, fig, ax = gev_dist.confidence_interval(plot_figure=True)\n```\n\nFor more examples and detailed documentation, visit [Statista Documentation](https://serapieum-of-alex.github.io/statista)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the GPL-3.0 License - see the LICENSE file for details.\n\n## Citation\n\nIf you use Statista in your research, please cite it as:\n\n```\nFarrag, M. (2023). Statista: A Python package for statistical analysis, extreme value analysis, and sensitivity analysis.\nhttps://github.com/Serapieum-of-alex/statista\n```\n\nBibTeX:\n```bibtex\n@software{statista2023,\n  author = {Farrag, Mostafa},\n  title = {Statista: A Python package for statistical analysis, extreme value analysis, and sensitivity analysis},\n  url = {https://github.com/Serapieum-of-alex/statista},\n  year = {2023}\n}\n```\n",
    "bugtrack_url": null,
    "license": "GPL-3.0-or-later",
    "summary": "statistics package",
    "version": "0.6.3",
    "project_urls": {
        "Documentation": "https://github.com/Serapieum-of-alex/statista",
        "Homepage": "https://github.com/Serapieum-of-alex/statista",
        "Repository": "https://github.com/Serapieum-of-alex/statista"
    },
    "split_keywords": [
        "statistics",
        " distributions",
        " extreme-value-analysis",
        " probability",
        " sensitivity-analysis"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f10e685165ec51be05ec1d10c7ef2e20dcc2b814497caaa5be447dce56b79c3f",
                "md5": "919dcd5c2f4d85f12e4b48fd34f7a282",
                "sha256": "26a27a1e15731cf031e5ccb71d4cf10bc2d76d24b57b241c58bac259497ab57a"
            },
            "downloads": -1,
            "filename": "statista-0.6.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "919dcd5c2f4d85f12e4b48fd34f7a282",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4,>=3.11",
            "size": 75933,
            "upload_time": "2025-08-08T20:36:44",
            "upload_time_iso_8601": "2025-08-08T20:36:44.995130Z",
            "url": "https://files.pythonhosted.org/packages/f1/0e/685165ec51be05ec1d10c7ef2e20dcc2b814497caaa5be447dce56b79c3f/statista-0.6.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0b61287d7f37876c20eb56e12549f402d89c5dfdba54af0e81ab6ef0ceef0bea",
                "md5": "4eb6b175987a17bf5b9bfe4049e2fa5d",
                "sha256": "c9235d8167b6b1c8b6f02c8ea69e8bd1330fc1fa17e6de82c9a8d470f0e838a1"
            },
            "downloads": -1,
            "filename": "statista-0.6.3.tar.gz",
            "has_sig": false,
            "md5_digest": "4eb6b175987a17bf5b9bfe4049e2fa5d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4,>=3.11",
            "size": 83750,
            "upload_time": "2025-08-08T20:36:46",
            "upload_time_iso_8601": "2025-08-08T20:36:46.186843Z",
            "url": "https://files.pythonhosted.org/packages/0b/61/287d7f37876c20eb56e12549f402d89c5dfdba54af0e81ab6ef0ceef0bea/statista-0.6.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-08 20:36:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Serapieum-of-alex",
    "github_project": "statista",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "statista"
}
        
Elapsed time: 4.56680s