Client for the Polaris Hub.
Project description
Polaris
So many stars in the sky, yet one is enough to guide you home.
Polaris establishes a novel, industry‑certified standard to foster the development of impactful methods in AI-based drug discovery.
This library is a Python client to interact with the Polaris Hub. It allows you to:
- Download Polaris datasets and benchmarks.
- Evaluate a custom method against a Polaris benchmark.
- Create and upload new datasets and benchmarks.
[!WARNING] The Polaris Hub is currently released as a closed, private beta. We hope to officially release it early 2024.
Quick API Tour
import polaris as po
# Load the benchmark from the Hub
benchmark = po.load_benchmark("polaris/hello_world_benchmark")
# Get the train and test data-loaders
train, test = benchmark.get_train_test_split()
# Use the training data to train your model
# Get the input as an array with 'train.inputs' and 'train.targets'
# Or simply iterate over the train object.
for x, y in train:
...
# Work your magic to accurately predict the test set
predictions = [0.0 for x in test]
# Evaluate your predictions
results = benchmark.evaluate(predictions)
# Submit your results
results.upload_to_hub(owner="dummy-user")
Documentation
Please refer to the documentation, which contains tutorials for getting started with polaris and detailed descriptions of the functions provided.
Installation
You can install polaris using conda/mamba/micromamba:
conda install -c conda-forge polaris
You can also use pip:
pip install polaris-lib
Development lifecycle
Setup dev environment
conda env create -n polaris -f env.yml
conda activate polaris
pip install --no-deps -e .
Other installation options
Alternatively, using [uv](https://github.com/astral-sh/uv):
```shell
uv venv -p 3.12 polaris
source .venv/polaris/bin/activate
uv pip compile pyproject.toml -o requirements.txt --all-extras
uv pip install -r requirements.txt
```
Tests
You can run tests locally with:
pytest
License
Under the Apache-2.0 license. See LICENSE.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file polaris_lib-0.4.1.tar.gz.
File metadata
- Download URL: polaris_lib-0.4.1.tar.gz
- Upload date:
- Size: 417.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | dd8cefb29dba38859e99a31faf9fa0ced2ac2a4615cc3fc6ae15e940079cc59f |
|
| MD5 | 4e2c125125efd1e3185081fcf48deb55 |
|
| BLAKE2b-256 | da65a789fc63411f49652953af867a1c51d4812e270cd17cdcc969c0e1c121d9 |
File details
Details for the file polaris_lib-0.4.1-py3-none-any.whl.
File metadata
- Download URL: polaris_lib-0.4.1-py3-none-any.whl
- Upload date:
- Size: 72.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2ac49b91ed9d9714316fcdd3965083b1783009c0cb60f22a56a2daf1c2be6a5c |
|
| MD5 | f86306b767024fdb2eeb1be6f085f538 |
|
| BLAKE2b-256 | f647897b68e954592039eb40e15e0856df4268e0754f3e2b551ab3acc3f2bb6f |
