1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
// TODO Avoid stupid long repeated trait requirements for `T`.
//! Optimization algorithms.
//!
//! ## Crate status
//!
//! I made this since alternatives in the Rust ecosystem seemed awkward. I'm just some random dude, don't expect too much.
//!
//! ## Basic guide
//!
//! All the functions have the approximate form:
//! ```ignore
//! # use std::sync::Arc;
//! fn function<A,T,const N: usize>(
//! // The values you want to optimise and there respective ranges.
//! // E.g. Optimizing 2 `f32`s between 0..1 and 2..3 `[0f32..1f32, 2f32..3f32]`).
//! ranges: [Range<T>; N],
//! // The function you want to optimize (loss/cost/whatever).
//! // `&[T; N]` are the input parameters which the algorithm will adjust to
//! // minimize the function.
//! // `Option<Arc<A>>` is how you can pass additional data you might want to use.
//! f: fn(&[T; N], Option<Arc<A>>) -> f64,
//! // The additional data for the evaluation function.
//! evaluation_data: Option<Arc<A>>,
//! // How often (if at all) you want to poll and print progress.
//! polling: Option<u64>,
//! // If this value is reached, the function exits immediately.
//! // When this is `None` if a random search hit the optimum on its first guess
//! // it would still continue to guess many more times (however many you set)
//! // before returning.
//! early_exit_minimum: Option<f64>,
//! // ...
//! ) -> [T;N] { /* ... */}
//! ```
pub use *;
pub use *;
pub use *;