ahco-rust 0.1.0__tar.gz

ahco_rust-0.1.0/Cargo.lock

@@ -0,0 +1,285 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "ahco"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+ "rand",
+ "rand_chacha",
+ "rand_distr",
+]
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.183"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5b646652bf6661599e1da8901b3b9522896f01e736bad5f723fe7a3a27f899d"
+
+[[package]]
+name = "libm"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+ "libm",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rand"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+dependencies = [
+ "libc",
+ "rand_chacha",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom",
+]
+
+[[package]]
+name = "rand_distr"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32cb0b9bc82b0a0876c2dd994a7e7a2683d3e7390ca40e6886785ef0c7e3ee31"
+dependencies = [
+ "num-traits",
+ "rand",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "zerocopy"
+version = "0.8.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2578b716f8a7a858b7f02d5bd870c14bf4ddbbcf3a4c05414ba6503640505e3"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7e6cc098ea4d3bd6246687de65af3f920c430e236bee1e3bf2e441463f08a02f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]

ahco_rust-0.1.0/Cargo.toml

@@ -0,0 +1,25 @@
+[package]
+name = "ahco"
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.82"
+description = "AHCO-v3 continuous black-box optimization in Rust, with optional Python bindings"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+documentation = "https://docs.rs/ahco"
+keywords = ["optimization", "black-box", "continuous", "python"]
+categories = ["science"]
+
+[lib]
+name = "ahco"
+crate-type = ["rlib", "cdylib"]
+
+[features]
+default = []
+python = ["dep:pyo3"]
+
+[dependencies]
+rand = "0.8.5"
+rand_chacha = "0.3.1"
+rand_distr = "0.4.3"
+pyo3 = { version = "0.23.5", optional = true, features = ["extension-module"] }

ahco_rust-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: ahco-rust
+Version: 0.1.0
+Summary: Rust implementation of AHCO-v3 continuous black-box optimization
+License-Expression: MIT OR Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# AHCO
+
+AHCO is a Rust implementation of the AHCO strategy for maximizing a
+continuous, bounded, black-box objective. It is published as the `ahco` Rust
+crate and can also be built as a Python extension, the Rust implementation uses
+native randomized-tree and feature-selection estimators, so it follows the
+same optimization phases and proposal strategies but is not expected to
+produce bit-for-bit identical results to the scikit-learn Python version.
+
+## Rust
+
+Add the crate to `Cargo.toml`:
+
+```toml
+[dependencies]
+ahco = "0.1"
+```
+
+Example:
+
+```rust
+use ahco::{optimize, AhcoConfig};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let result = optimize(
+        AhcoConfig::new(4, 100, 7),
+        |x| Ok(-x.iter().map(|value| (value - 0.7).powi(2)).sum::<f64>()),
+    )?;
+
+    println!("best score: {}", result.best_score);
+    println!("best point: {:?}", result.best_x);
+    Ok(())
+}
+```
+
+Every objective receives a point in `[0, 1]^dimension` and returns a score to
+maximize. Return `Err(AhcoError::Objective(...))` to stop on an objective
+failure. Non-finite scores are treated as very poor scores. `history` contains
+the best score so far after each evaluation.
+
+The crate is dual-licensed under MIT or Apache-2.0.
+
+## Python
+
+Install the extension from this source directory with `pip install .` (a Rust
+toolchain is required to build it):
+
+```python
+from ahco_rust import run_ahco3
+
+result = run_ahco3(
+    lambda x: -sum((value - 0.7) ** 2 for value in x),
+    d=4,
+    budget=100,
+    seed=7,
+)
+
+print(result["best_x"], result["best_score"])
+```
+
+The Python function accepts the same `f`, `d`, `budget`, `seed`, and optional
+`kmax` arguments as `ahco.py`'s `run_ahco3`. Its result has the same keys:
+`method`, `best_score`, `best_x`, `evaluations`, `history`, and `seconds`.
+The Python objective is called once per evaluation; exceptions raised by it
+are propagated to the caller.
+
+## Development
+
+```text
+cargo test
+cargo build --features python
+```
+
+To publish the Rust crate, run `cargo publish` from this directory. The Python
+extension is built separately from the same crate with maturin/pip.
+

ahco_rust-0.1.0/README.md

@@ -0,0 +1,75 @@
+# AHCO
+
+AHCO is a Rust implementation of the AHCO strategy for maximizing a
+continuous, bounded, black-box objective. It is published as the `ahco` Rust
+crate and can also be built as a Python extension, the Rust implementation uses
+native randomized-tree and feature-selection estimators, so it follows the
+same optimization phases and proposal strategies but is not expected to
+produce bit-for-bit identical results to the scikit-learn Python version.
+
+## Rust
+
+Add the crate to `Cargo.toml`:
+
+```toml
+[dependencies]
+ahco = "0.1"
+```
+
+Example:
+
+```rust
+use ahco::{optimize, AhcoConfig};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let result = optimize(
+        AhcoConfig::new(4, 100, 7),
+        |x| Ok(-x.iter().map(|value| (value - 0.7).powi(2)).sum::<f64>()),
+    )?;
+
+    println!("best score: {}", result.best_score);
+    println!("best point: {:?}", result.best_x);
+    Ok(())
+}
+```
+
+Every objective receives a point in `[0, 1]^dimension` and returns a score to
+maximize. Return `Err(AhcoError::Objective(...))` to stop on an objective
+failure. Non-finite scores are treated as very poor scores. `history` contains
+the best score so far after each evaluation.
+
+The crate is dual-licensed under MIT or Apache-2.0.
+
+## Python
+
+Install the extension from this source directory with `pip install .` (a Rust
+toolchain is required to build it):
+
+```python
+from ahco_rust import run_ahco3
+
+result = run_ahco3(
+    lambda x: -sum((value - 0.7) ** 2 for value in x),
+    d=4,
+    budget=100,
+    seed=7,
+)
+
+print(result["best_x"], result["best_score"])
+```
+
+The Python function accepts the same `f`, `d`, `budget`, `seed`, and optional
+`kmax` arguments as `ahco.py`'s `run_ahco3`. Its result has the same keys:
+`method`, `best_score`, `best_x`, `evaluations`, `history`, and `seconds`.
+The Python objective is called once per evaluation; exceptions raised by it
+are propagated to the caller.
+
+## Development
+
+```text
+cargo test
+cargo build --features python
+```
+
+To publish the Rust crate, run `cargo publish` from this directory. The Python
+extension is built separately from the same crate with maturin/pip.