rapid_models.doe.utils

Module Contents

Functions

fullfact_with_bounds(LBs, UBs, N_xi)

Return a ND array of corresponding (x_0, ..., x_i) values that span out the inputspace

lhs_with_bounds(nDim, nSamples, LBs, UBs[, random_state])

Return a 2D array of corresponding (x, y) values that fill the input space

in_hull(p, hull)

Test if points in p are in hull

kmeans_sample(points, N[, values, mode, random_state])

Based on
rapid_models.doe.utils.fullfact_with_bounds(LBs, UBs, N_xi)

Return a ND array of corresponding (x_0, …, x_i) values that span out the inputspace between lowerbound and upperbound in a structured (grid-like) way with n_x_i points in the i’th-dimension.

Parameters:

  • LBs (list-like, 1D) – lower bounds of the input space. len(LBs) must equal len(UBs)

  • UBs (list-like, 1D) – upper bounds of the input space. len(UBs) must equal len(LBs)

  • N_xi (list-like, 1D) – number of equidistant samples for each xi-dimension

Returns:

[[x_0,…,x_i],…,[x_0_n,…,x_i_n]]

Return type:

fullfact (ndarray)

rapid_models.doe.utils.lhs_with_bounds(nDim, nSamples, LBs, UBs, random_state=None)

Return a 2D array of corresponding (x, y) values that fill the input space between lowerbound and upperbound with n points using a Latin-hypercube design.

Parameters:

  • nDim (int) – Number of dimensions

  • nSamples (int) – Number of total samples

  • LBs (list-like) – 1D, lower bounds of the input space. len(LBs) must equal len(UBs)

  • UBs (list-like) – 1D, upper bounds of the input space. len(UBs) must equal len(LBs)

  • random_state (int, RandomState instance or None, default=None) – Determines random number generation used to initialize the samples. Pass an int for reproducible results across multiple function calls.

Returns:

Array of sample points with shape (nSamples, nDim)[[x_0,…,x_i],…,[x_0_n,…,x_i_n]]

Return type:

lhs (ndarray)

rapid_models.doe.utils.in_hull(p, hull)

Test if points in p are in hull

p should be a NxK coordinates of N points in K dimensions hull is either a scipy.spatial.Delaunay object or the MxK array of the coordinates of M points in `K`dimensions for which Delaunay triangulation will be computed.

Parameters:

  • p (array-like) – NxK array. Set of N points in K dimensions for which to check if is inside convex hull.

  • hull (array like / scipy.spatial.Delaunay) – MxK array. Set of M points in K dimensions to calculate the Delaunay tessellation using the [Qhull library](http://www.qhull.org/), or an existing scipy.spatial.Delaunay object.

Returns:

(N, ) boolean array of sample points where

True’ indicate that the point of that index is inside the triangulation while `False indicate that the point of corresponding index is outside the triangulation.

Return type:

b_in_hull (boolean ndarray)

rapid_models.doe.utils.kmeans_sample(points, N, values=None, mode='center', random_state=42)

Based on https://stackoverflow.com/questions/69195903/

Parameters:

  • points (array-like) – PxK array, set of ´P´ points in ´K´ dimensions from which to calculate N k-means clusters to use as distance maximizing samples in K-dimensions

  • N (int) – Number of clusters

  • values (array-like, 1D) – Array of corresponding values at each point ´P´ in points. These values can be used to select e.g. minimum or maximum values inside each cluster by specifying mode

  • mode (str, default="center") – default mode select center of k-means cluster. “center_closest_point” select the point which are closest to the cluster center, “min” select the point with the corresponding minimum value, “max” select the point with the corresponding maximum value

Returns:

NxK array of ´N´ points in ´K´ dimensions

representing the mode (default “center”) in the N k-means clusters.

values (ndarray): optional array of N values of the returned points.

Return type:

points (ndarray)