Metadata-Version: 2.4
Name: ids-datatools-hmq-2026
Version: 1.0.0
Summary: A beginner-friendly Python library for descriptive statistics and data cleaning.
Author: Mirza Faizan Baig, Hamza Naveed, Qasim Touqeer
License-Expression: MIT
Project-URL: Documentation, https://pypi.org/project/ids-datatools-hmq-2026/
Keywords: data-science,statistics,data-cleaning,education,python-library
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# IDS DataTools HMQ 2026

`ids-datatools-hmq-2026` is a small, beginner-friendly Python library created for an Introduction to Data Science project. It provides reusable functions for descriptive statistics and common data-cleaning operations without requiring external dependencies.

## Installation

```bash
pip install ids-datatools-hmq-2026
```

## Quick example

```python
from ids_datatools_hmq import calculate_mean, minmax_normalize, remove_missing

scores = [72, 85, None, 91, 85]
clean_scores = remove_missing(scores)

print(calculate_mean(clean_scores))
print(minmax_normalize(clean_scores))
```

Output:

```text
83.25
[0.0, 0.6842105263157895, 1.0, 0.6842105263157895]
```

## Available functions

### Statistics

- `calculate_mean(values)`
- `calculate_median(values)`
- `calculate_range(values)`
- `calculate_standard_deviation(values, sample=False)`
- `summarize(values)`

### Data cleaning

- `remove_missing(values, missing_markers=(None, ""))`
- `remove_duplicates(values)`
- `minmax_normalize(values)`
- `zscore_normalize(values)`
- `clip_outliers_iqr(values, factor=1.5)`

## Command-line demo

After installation, run:

```bash
ids-datatools-demo
```

## License

MIT License.
