Home > distances > preprocessSystems.m

preprocessSystems

PURPOSE

This is a helper function for the distance calulation functions. This allows

SYNOPSIS

function [angles,sigma,systems,mParam] = preprocessSystems(sType,varargin)

DESCRIPTION

 This is a helper function for the distance calulation functions. This allows
 the distance functions to be called with different types of argumennts. 

 INPUTS
   sType    - Distance type 0: Subspace Angle Distance, 1: Binet Cauchy Distance
   varargin - All the arguments from the calling function

 OUTPUTS
   angles  - Subspace angles for subspace angle distances, 
             Solution of Sylvester equation for binet cauchy kernels
   sigma   - Sigma for binet cauchy kernels
   systems - Original input systems
   mParam  - Metric parameters. Returns the default paramters if no metric parameters are passed.
             If metric paramters are passed, then it returns the input metric parameters. Note that
             for the case of subspace angle distance, no metric parameters are returned. The angles 
             are calculated based on the paramters and returned.

 EXAMPLE
 

% Written by : Avinash Ravichandran
% $DATE      : 27-Jul-2011 12:08:21 $
% $REVISION  : 1.00 $

CROSS-REFERENCE INFORMATION

This function calls:

calculateParamsForBinetCauchyKernels Compute the Binet-Cauchy kernels between dynamical systems
checkInputsForDistances Helper function for the distance calculations
subspaceAnglesAR Calculates the subspace angles between two AR systems
subspaceAnglesARMA Calculates the subspace angles between two ARMA systems

This function is called by:

calculateFinslerDistance Compute the Finsler distance between dynamical systems
calculateFrobeniusDistance Compute the Frobenius distance between dynamical systems
calculateGapDistance Compute the Gap distance between dynamical systems
calculateMartinDistance Compute the Martin distance between dynamical systems
calculateMartinKernel Compute the Martin kernel between dynamical systems
calculateMartinKernelToDistance Compute the distance derived from the Martin kernel between dynamical systems
calculatePartialDeterminantKernel Compute the Determinant kernel between dynamical systems
calculatePartialMaxSVKernel Compute the Maximum Singular value kernel between dynamical systems
calculatePartialTraceKernel Compute the partial trace kernel between dynamical systems
calculateTraceKernel Compute the original Binet-Cauchy Trace kernel between dynamical systems