Metadata-Version: 2.4
Name: poseigen_compass
Version: 0.1.4
Summary: Hyperparameter optimization and model evaluation utilities for the Poseigen family
Author-email: Husam Abdulnabi <husam.abdulnabi@gmail.com>
Maintainer-email: Husam Abdulnabi <husam.abdulnabi@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/husam94/poseigen_compass
Project-URL: Repository, https://github.com/husam94/poseigen_compass
Project-URL: Issues, https://github.com/husam94/poseigen_compass/issues
Keywords: poseigen,bioinformatics,machine-learning,hyperparameter-optimization
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: poseigen_seaside
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# Compass

Compass is the hyperparameter optimization and model evaluation package in the Poseigen family.
It provides utilities for generating and scoring hyperparameter candidates, model ensembling, and statistical assessment.

## Features

- Random candidate generation across continuous and categorical hyperparameter spaces.
- Candidate scoring with optional model repeats and top-k selection.
- Average ensembles from model repeat sets.
- Bootstrap ensembles for statistical assessment.

## Installation

Install from PyPI:

```bash
pip install poseigen_compass
```

For local development, install from source using your preferred editable-install workflow.

## Usage

Import modules directly:

```python
import poseigen_compass as co
```

## Project Status

poseigen_compass is in active development and is intended to support hyperparameter search and evaluation workflows across the Poseigen ecosystem.

## Related Projects

- poseigen_seaside: shared utilities and metrics foundation.

## License

This project is released under the MIT License.
