@spec get_module(atom()) :: atom()

Return correct module syntax based on SDK environment configuration.

@spec random_seed() :: {map(), any()}

Seed PRNG for the current process.

Uses exs1024s (not cryptographically strong, but fast).

@spec random_string(non_neg_integer()) :: String.t()

Generate a random string of the specified length.

Parameters

• length - The length of the random string to generate

Returns

• A random string of the specified length

@spec safe_binary_to_term(binary()) :: {:ok, term()} | no_return()

Safely convert binary to Erlang term.

@spec safe_serialize_erlang(term()) :: binary()

Safely serialize Erlang term to binary.

@spec sat(float(), float()) :: float()

Saturate a value between a minimum and maximum limit.

Examples

iex> Bardo.Utils.sat(1.5, 1.0)
1.0

iex> Bardo.Utils.sat(-1.5, 1.0) 
-1.0

iex> Bardo.Utils.sat(0.5, 1.0)
0.5

@spec system_metrics() :: map()

Return system metrics.

@spec vec1_dominates_vec2([float()], [float()], float()) :: boolean()

Checks if vector A dominates vector B with a minimum improvement percentage.

Returns true if all elements in A are significantly better than in B.

@spec vec1_dominates_vec2([float()], [float()], float(), [float()]) :: [float()]

Calculate vector difference with minimum improvement percentage (MIP).