Class ISFANode

Initializes an object of type 'ISFANode' to perform Independent Slow Feature Analysis.

The notation is the same used in the paper by Blaschke et al. Please refer to the paper for more information.

Parameters:

• lags (list or int) - A list of time-lags to generate the time-delayed covariance matrices (in the paper this is the set of au). If lags is an integer, time-lags 1,2,...,'lags' are used. Note that time-lag == 0 (instantaneous correlation) is always implicitly used.
• sfa_ica_coeff (list) - A list of float with two entries, which defines the weights of the SFA and ICA part of the objective function. They are called b_{SFA} and b_{ICA} in the paper.

• icaweights (int, list or array) - Weighting factors for the cov matrices relative to the ICA part of the objective function (called kappa_{ICA}^{ au} in the paper). Default is 1. Possible values are:

  • An integer n: All matrices are weighted the same (note that it does not make sense to have n != 1).
  • A list or array of floats of len == len(lags): Each element of the list is used for weighting the corresponding matrix.
  • None: Use the default values.

• sfaweights (int, list or array) - Weighting factors for the covariance matrices relative to the SFA part of the objective function (called kappa_{SFA}^{ au} in the paper). Default is [1., 0., ..., 0.] For possible values see the description of icaweights.
• whitened (bool) - True if input data is already white, False otherwise (the data will be whitened internally).
• white_comp (int) - If whitened is false, you can set white_comp to the number of whitened components to keep during the calculation (i.e., the input dimensions are reduced to white_comp` by keeping the components of largest variance).
• white_parm (dict) - A dictionary with additional parameters for whitening. It is passed directly to the WhiteningNode constructor. Ex: white_parm = { 'svd' : True }
• eps_contrast (float) - Convergence is achieved when the relative improvement in the contrast is below this threshold. Values in the range [1E-4, 1E-10] are usually reasonable.
• max_iter (int) - If the algorithms does not achieve convergence within max_iter iterations raise an Exception. Should be larger than 100.
• RP - Starting rotation-permutation matrix. It is an input_dim x input_dim matrix used to initially rotate the input components. If not set, the identity matrix is used. In the paper this is used to start the algorithm at the SFA solution (which is often quite near to the optimum).
• verbose (bool) - Print progress information during convergence. This can slow down the algorithm, but it's the only way to see the rate of improvement and immediately spot if something is going wrong.
• input_dim (int) - The input dimensionality.
• output_dim (int) - Sets the number of independent components that have to be extracted. Note that if this is not smaller than input_dim, the problem is solved linearly and SFA would give the same solution only much faster.
• dtype (numpy.dtype or str) - Datatype to be used.

Overrides: object.__init__

Process the data contained in x.

If the object is still in the training phase, the function stop_training will be called. x is a matrix having different variables on different columns and observations on the rows.

By default, subclasses should overwrite _execute to implement their execution phase. The docstring of the _execute method overwrites this docstring.

Overrides: Node.execute

Invert y.

If the node is invertible, compute the input x such that y = execute(x).

By default, subclasses should overwrite _inverse to implement their inverse function. The docstring of the inverse method overwrites this docstring.

Overrides: Node.inverse

Stop the training phase.

Parameters:

• covs - The covariance matrices.

Overrides: Node.stop_training

Update the internal structures according to the input data x.

x is a matrix having different variables on different columns and observations on the rows.

By default, subclasses should overwrite _train to implement their training phase. The docstring of the _train method overwrites this docstring.

Note: a subclass supporting multiple training phases should implement the same signature for all the training phases and document the meaning of the arguments in the _train method doc-string. Having consistent signatures is a requirement to use the node in a flow.

Overrides: Node.train

RP

RPC

covs

final_contrast

initial_contrast