predictr
predict + reliability, in other words: A tool to predict the reliability.
predictr is a Python package for Weibull-based life data analysis (reliability engineering). It covers parameter estimation, bias-correction, confidence bounds, and publication-ready Weibull plots in a single, consistent API.
Installation
pip install predictr
Requires Python >= 3.6.
Quick start
from predictr import Analysis
failures = [0.4508831, 0.68564703, 0.76826143, 0.88231395, 1.48287253, 1.62876357]
weibull = Analysis(df=failures, bounds='fb', show=True)
weibull.mle()
print(weibull.beta, weibull.eta) # shape and scale estimates
This fits a two-parameter Weibull distribution via Maximum Likelihood Estimation, adds Fisher confidence bounds, and renders the probability plot below.
See it in action
A few of predictr's capabilities, from bias-corrected estimates to comparing entire distributions.
| Bias-corrected estimates | Confidence region, multiple levels |
|---|---|
| Ranked by AIC | Distributions compared |
|---|---|
| Regression: survival per covariate profile | Regression: goodness of fit with verdict |
|---|---|
Main features
Parameter estimation
- Uncensored and type I / type II right-censored two-parameter Weibull distribution
- Maximum Likelihood Estimation (MLE) and Median Rank Regression (MRR)
- Bx-life calculator
- Normal, LogNormal and Exponential distributions, alongside Weibull
- Non-parametric Kaplan–Meier
kaplan_meier()and Nelson–Aalennelson_aalen()from the failure / suspension lists (no DataFrame), with pointwise bands and step plots
Lifetime regression (covariates)
- Weibull accelerated failure time (AFT) and Cox proportional hazards (Cox PH) models
- Uncensored and right-censored data, Efron/Breslow tie handling, Wald / profile-likelihood / bootstrap (parametric and non-parametric) bounds
summary(), coefficient forest plot, survival-curve prediction per covariate profile (with pointwise and simultaneous confidence bands)- Goodness of fit:
goodness_of_fit()with a good / marginal / poor verdict (concordance, Cox–Snell slope, proportional-hazards test), Cox–Snell / martingale / deviance residuals,plot_gof(),check_ph() - Non-parametric descriptors: the same
kaplan_meier()/nelson_aalen()asAnalysis, here also splittable by a covariate (by=), plusplot_km()/plot_na() - Accelerated life testing: named aging laws (
stress_model=— Arrhenius, inverse power, Eyring, Coffin–Manson), physical parameters (Ea,n) with CIs,acceleration_factor(), raw-unit predictions,plot_stress_life(),check_shape() - Monte-Carlo
power_analysis()andsample_size()
Bias-correction
- C4 method (reduced bias adjustment)
- Hirose and Ross method
- Parametric and non-parametric bootstrap correction (mean, median, trimmed mean)
Confidence bounds
- Fisher bounds
- Likelihood Ratio bounds (Weibull, Normal, LogNormal)
- Beta-Binomial bounds
- Monte Carlo Pivotal bounds
- Parametric and non-parametric bootstrap bounds
- Exact chi-square bounds (Exponential)
Plots
- Probability plots with all relevant statistics in the legend
- Multiple fits overlaid in one figure, for design comparisons
- Contour plots for the joint confidence region of shape and scale, with support for multiple confidence levels per dataset
- Distribution comparison: fit every supported distribution to one dataset, ranked by AIC or Anderson-Darling, plus a combined PDF plot
See the class documentation for the full method and parameter reference, including censored-data and bias-correction examples.
Documentation and links
Citing predictr
If you use predictr in academic work, please cite it via its Zenodo DOI. See docs/citation.md for details.
License
MIT — see LICENSE.txt.
Contacte me
If you have any questions and / or suggestions, don't hesitate to contact me.
Metadata
Release files for predictr 0.1.37
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| predictr-0.1.37.tar.gz | 4.4 MB | Without provenance | Details for predictr-0.1.37.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| predictr-0.1.37-py3-none-any.whl | Python 3 | none | any | Details for predictr-0.1.37-py3-none-any.whl |
Total release size: 4.5 MB
Release files / predictr-0.1.37.tar.gz
| Download URL | predictr-0.1.37.tar.gz |
|---|---|
| Size | 4.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe0e20ecaf47df27c0c4c1f0cf5cf66fb209e4ae8734e42560e22468bc24593b
|
|
BLAKE2b-256 checksum How to use checksums |
f87f54027c407b80bffef7f9c643e6ee8aa9115bfe5f1a7354bcb8b0beba054d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.7
|
Release files / predictr-0.1.37-py3-none-any.whl
| Download URL | predictr-0.1.37-py3-none-any.whl |
|---|---|
| Size | 102.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
13d49af8a7c8a71a8b88decad659d9eae0e6efd65a09a5b0ac4b3e1c7598d630
|
|
BLAKE2b-256 checksum How to use checksums |
d72c3c8c7b339d1def17ccada9610e7e4f57253ad85a0a12efb6685e6c680d80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.7
|
Security for predictr 0.1.37
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.