Source code for elastica.modules.callbacks

__doc__ = """

Provides the callBack interface to collect data over time (see ``).

from elastica.callback_functions import CallBackBaseClass

[docs]class CallBacks: """ CallBacks class is a module for calling callback functions, set by the user. If the user wants to collect data from the simulation, the simulator class has to be derived from the CallBacks class. Attributes ---------- _callback_list: list List of call back classes defined for rod-like objects. """ def __init__(self): self._callback_list = [] super(CallBacks, self).__init__() self._feature_group_callback.append(self._callback_execution) self._feature_group_finalize.append(self._finalize_callback)
[docs] def collect_diagnostics(self, system): """ This method calls user-defined call-back classes for a user-defined system or rod-like object. You need to input the system or rod-like object that you want to collect data from. Parameters ---------- system: object System is a rod-like object. Returns ------- """ sys_idx = self._get_sys_idx_if_valid(system) # Create _Constraint object, cache it and return to user _callbacks = _CallBack(sys_idx) self._callback_list.append(_callbacks) return _callbacks
def _finalize_callback(self): # From stored _CallBack objects, instantiate the boundary conditions # inplace : # dev : the first index stores the rod index to collect data. # Technically we can use another array but it its one more book-keeping # step. Being lazy, I put them both in the same array self._callback_list[:] = [ (, callback(self._systems[])) for callback in self._callback_list ] # Sort from lowest id to highest id for potentially better memory access # _callbacks contains list of tuples. First element of tuple is rod number and # following elements are the type of boundary condition such as # [(0, MyCallBack), (1, MyVelocityCallBack), ... ] # Thus using lambda we iterate over the list of tuples and use rod number (x[0]) # to sort callbacks. self._callback_list.sort(key=lambda x: x[0]) self._callback_execution(time=0.0, current_step=0) def _callback_execution(self, time, current_step: int, *args, **kwargs): for sys_id, callback in self._callback_list: callback.make_callback( self._systems[sys_id], time, current_step, *args, **kwargs )
class _CallBack: """ CallBack module private class Attributes ---------- _sys_idx: rod object index _callback_cls: list *args Variable length argument list. **kwargs Arbitrary keyword arguments. """ def __init__(self, sys_idx: int): """ Parameters ---------- sys_idx: int rod object index """ self._sys_idx = sys_idx self._callback_cls = None self._args = () self._kwargs = {} def using(self, callback_cls, *args, **kwargs): """ This method is a module to set which callback class is used to collect data from user defined rod-like object. Parameters ---------- callback_cls: object User defined callback class. Returns ------- """ assert issubclass( callback_cls, CallBackBaseClass ), "{} is not a valid call back. Did you forget to derive from CallBackClass?".format( callback_cls ) self._callback_cls = callback_cls self._args = args self._kwargs = kwargs return self def id(self): return self._sys_idx def __call__(self, *args, **kwargs) -> CallBackBaseClass: """Constructs a callback functions after checks""" if not self._callback_cls: raise RuntimeError( "No callback provided to act on rod id {0}" "but a callback was registered. Did you forget to call" "the `using` method".format( ) try: return self._callback_cls(*self._args, **self._kwargs) except (TypeError, IndexError): raise TypeError( r"Unable to construct callback class.\n" r"Did you provide all necessary callback properties?" )