Function Class

The function class provides a wrapper around a function \(f\) posed on some domain \(\mathcal{D} \subset \mathbb{R}^m\).

Design Considerations

Often-times functions coming from engineering applications come in application units, e.g., in meters, Pascals, etc. The trouble is that these units are often poorly scaled with respect to each other, causing numerical issues. Hence, one of the first steps is to restate the problem on the normalized domain: an affine transform of \(\mathcal{D}\) into the unit box \([-1,1]^m\). One of the roles of the Function class is to transparently handle working in the normalized domain so that no changes are needed for the functions provided.

Function Class API

class psdr.Function(funs, domain, grads=None, fd_grad=None, vectorized=False, kwargs={}, dask_client=None, return_grad=False)[source]

Wrapper around function specifying the domain

Provided a function \(f: \mathcal{D} \subset \mathbb{R}^m \to \mathbb{R}^d\), and a domain \(\mathcal{D}\), this class acts as a wrapper for both. The key contribution of this class is to provide access to the function on the normalized domain \(\mathcal{D}_{\text{norm}}\) that is a subset of the \([-1,1]^m\) cube; i.e.,

\[\mathcal{D}_{\text{norm}} \subset [-1,1]^m \subset \mathbb{R}^m.\]
Parameters:
  • fun (function or list of functions) – Either a python function or a list of functions to evaluate
  • domain (Domain) – The domain on which the function is posed
  • vectorized (bool, default: False) – If True, the functions are vectorized for use with numpy.
  • kwargs (dict, default: empty) – Keyword arguments to pass to the functions when evaluating function
  • dask_client (dask.distributed.Client) – Client to use for multiprocessing