svd

Attributes

Attribute	Default	Description	Required
basefile		d3d file with the data sets.	Yes
basegroup	SingleTrials	Path to the base datagroup of the basefile. Useful if more than one data groups are included and/or if the based data group has not the default name "Base"	No
labelset	the labels from all time series included in the basefile	The labels of the time series included in the data vector.	No
outfile	svd.d3d	d3d file with the results of the singular value decomposition.	No
approxdim	15	number of principal components used for approximation	No
usesubmean	true	if set to false the mean datavector is not subtracted before the calculation of the svd (useful if the data is normal distributed)	No
includeapprox	false	if set to true than for every data vector the approximation is saved	No
includeoriginal	false	if set to true, the original vectors are saved	No
bothsides	false	if set to true, left and right sides are put together: Trial soll als komplett angenommen werden, sobald die Labels einer Seite komplett sind. Wenn Labels für beide Seiten verfügbar sind, dann wird der Trial in zwei unabhängige Trials aufgespalten. Die Labels die in der DataCollection enthalten sind haben Namen, die die Seite nicht mehr enthalten. Die Default-Prefixe können mit den Attribute rightprefix und leftprefix geändert werden ... (not implemented yet)	No
rightprefix	MeanRight	prefix for right labels (z.B. bei den alten Fussdaten: "Right.") (not implemented yet)	No
leftprefix	MeanLeft	prefix for left labels (z.B. bei den alten Fussdaten: "Left.") (not implemented yet)	No

DataGroup object with name "Projection"

For every data vector the dataGroup "Projection" includes a double time serie with the name "v" - the data vector projected into the approximated eigenspace.

Wenig elegant ist, dass in der DataGroup "Projection" ein LabelSet gespeichert wird, das die Labels der Originaldaten enthält und nicht einfach nur ein Label "v" entsprechend der gespeicherten Zeitreihen.

The dataGroup "Projection includes the following PropertyGroup

<PropertyGroup groupName="svd">
           <Property name="singularValues" values="1 029.3 3434.334 ..."/>
           <Property name="singularValuesNum" values="20"/>
           <Property name="projectionMatrix" values="3 3 3; 3 5 3; ..."/>
           <Property name="projectionMatrixNumCol" value="20"/>
           <Property name="projectionMatrixNumRow" value="20"/>

	if usesubmean="true":
           <Property name="mean" value="4 4 34.3 3 ..."/>
           <Property name="meanNum" value="30"/>
 </PropertyGroup>

DataGroup object with name "Approximation"

If the attribute includeapprox="true",  the approximated (backprojected) vectors are saved in a time serie with the name "v".

DataGroup object with the name "Original"

If the attribute includeoriginal="true", the original data vectors are saved as double time series with the name "v".

Note

Nach dem Laden eine svd Zerlegung stehen die Ursprungsvektoren nicht mehr zur Verfügung insbesondere auch dann nicht, wenn sie explizit mit gespeichert werden.

Examples

<svd basefile="base.d3d"/>