<p align="center">
  <img src="man/figures/logo.png" width="240" alt="SujathaDist logo">
</p>
# SujathaDist <img src="man/figures/logo.png" align="right" height="140"/>

<!-- badges: start -->
[![R-CMD-check](https://github.com/hosenur72/SujathaDist/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/hosenur72/SujathaDist/actions/workflows/R-CMD-check.yaml)
[![License: GPL-3](https://img.shields.io/badge/License-GPL--3-blue.svg)]
<!-- badges: end -->

## Overview

**SujathaDist** is an R package that provides computational tools for the **Sujatha distribution**, a one-parameter lifetime distribution introduced by Shanker (2016). The package offers functions for evaluating distributional quantities, generating random samples, estimating model parameters, assessing goodness-of-fit, and performing statistical analyses for lifetime and reliability data.

## Features

The package currently provides:

- Probability density function (`dsujatha()`)
- Cumulative distribution function (`psujatha()`)
- Quantile function (`qsujatha()`)
- Random number generation (`rsujatha()`)
- Maximum likelihood estimation (`fitsujatha()`)
- Goodness-of-fit analysis (`gofsujatha()`)
- S3 methods:
  - `print()`
  - `summary()`
  - `coef()`
  - `vcov()`
  - `confint()`
  - `logLik()`
  - `AIC()`
  - `BIC()`
  - `deviance()`

---

## Installation

### Development version

```r
install.packages("remotes")

remotes::install_github("hosenur72/SujathaDist")
```

---

## Quick Start

```r
library(SujathaDist)

theta <- 2

## Density
dsujatha(1, theta)

## Distribution
psujatha(1, theta)

## Quantile
qsujatha(0.5, theta)

## Random generation
set.seed(123)
x <- rsujatha(100, theta)

## Parameter estimation
fit <- fitsujatha(x)

summary(fit)

## Goodness of fit
gofsujatha(fit)
```

---

## Package Structure

| Function | Description |
|----------|-------------|
| dsujatha | Density |
| psujatha | Distribution |
| qsujatha | Quantile |
| rsujatha | Random generation |
| fitsujatha | Maximum likelihood estimation |
| gofsujatha | Goodness-of-fit |

---

## References

Shanker, R. (2016).

*Sujatha Distribution and its Applications.*

Statistics in Transition New Series,
17(3), 391–410.

https://doi.org/10.21307/stattrans-2016-029

---

## Citation

```r
citation("SujathaDist")
```
Prodhani, H. R. (2026):Statistical Methods for the Sujatha Distribution,
  R package version 1.0.0, https://github.com/hosenur72/SujathaDist"

---

## Author

**Hosenur Rahman Prodhani**
Assistant Professor

Department of Statistics

B.N. College (Autonomous),Dhubri, Assam, India

Email: hosenur72@gmail.com
- ORCID: https://orcid.org/0009-0001-3919-4952

---

## License

GPL-3
