Skip to main content

orivex

A selective and fast engine for exploratory landscape analysis.

Python 3.10+ Status: pre-release Backends: NumPy and PyTorch

Documentation · Quick start · API reference · Contributing

orivex is a successor to pflacco for exploratory landscape analysis (ELA). Compute individually selected features from sampled points and objective values, with shared intermediates, explicit costs, and versioned definitions. A NumPy/SciPy core is complemented by an optional differentiable PyTorch backend.

Installation

Python 3.10 or newer is required. Install from PyPI:

pip install orivex

Add the optional differentiable PyTorch backend with pip install "orivex[torch]".

To work from a checkout instead:

git clone https://github.com/helix-agh/orivex.git
cd orivex
uv sync

With pip, run python -m pip install -e . (add ".[torch]" for the PyTorch backend).

Quick start

import numpy as np

from orivex import LandscapeSample, compute

rng = np.random.default_rng(42)
x = rng.uniform(-5.0, 5.0, size=(200, 2))
y = np.sum(x**2, axis=1)
sample = LandscapeSample(x, y, lower=[-5.0, -5.0], upper=[5.0, 5.0])

result = compute(sample, ["ela_distr.skewness", "nbc.nn_nb.mean_ratio"])
for name, item in result.values.items():
    print(name, item.value, item.status.value)

Objective values are min-max normalized by default. Pass y_normalization=None to use raw canonical objectives. Undefined features return an invalid status with an explanation.

Documentation

Read the documentation for installation, feature selection, normalization, fitness-distance conventions, PyTorch support, and API reference. The feature overview, contributing guide, and benchmark guide are also available.

Preview the documentation locally:

uv sync --extra docs
uv run --no-sync mkdocs serve

See documentation development for strict builds and deployment.

License

orivex is licensed under the MIT License.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

orivex-0.1.0.tar.gz (46.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orivex-0.1.0-py3-none-any.whl (47.4 kB view details)

Uploaded Python 3

File details

Details for the file orivex-0.1.0.tar.gz.

File metadata

  • Download URL: orivex-0.1.0.tar.gz
  • Upload date:
  • Size: 46.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for orivex-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c89805adff1d379d9991f551d62a8daa9bad3fbcb5764130bfaf834928b67bf6
MD5 2814abd5c690bd2fe019bc78a960119a
BLAKE2b-256 a0ddf3c2ac2bd001e42db980a0e62349221cfae1156993b4369e73d09a25cbda

See more details on using hashes here.

Provenance

The following attestation bundles were made for orivex-0.1.0.tar.gz:

Publisher: publish.yml on helix-agh/orivex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file orivex-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: orivex-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 47.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for orivex-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bb684ac28fe4d4e38dc7d379b6bd054479d94fd1a1a14f7fb7439a9c8269c6ce
MD5 92b40a487f3370444638d715815daad6
BLAKE2b-256 1c7919e5c06af8370053950b008f78c34f807ccd3c17a39e5535e5e7b9e8b9b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for orivex-0.1.0-py3-none-any.whl:

Publisher: publish.yml on helix-agh/orivex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page