Alle Datensätze werden innerhalb der Toolbox in einem einheitlichen Format abgelegt und verarbeitet. Diese Seite dient der Dokumentation der Spezifikation dieses Formates.
Die Aufgabe der trEPRload-Routine ist, eine Schnittstelle zwischen allen von der trEPR-Toolbox verarbeitbaren Dateiformaten und der GUI zu schaffen.
Deshalb gibt es eine einheitliche Datenstruktur für das Ausgabeformat der trEPRload-Routine, die im Folgenden beschrieben wird.
<note important>Die hier aufgeführten Rückgabewerte müssen alle Einlesefunktionen für die jeweiligen spezifischen Datenformate mit sinnvollen Werten füllen. Sie werden so direkt in das „data“-Feld der GUI-Daten übernommen.</note>
Hintergrund: Mittlerweile hat sich herauskristallisiert, daß auch für die Toolbox nicht nur die reinen Daten (strenggenommen eine n×m-Matrix) relevant sind, sondern eben gerade auch eine Menge zusätzlicher Informationen, die teilweise aus den Rohdateien gewonnen werden können, teilweise von anderer Stelle eingepflegt werden müssen. Das ist auch und gerade im Hinblick auf eine spätere Anbindung an ein Laborinformationssystem von Nutzen. Außerdem liefert die GUI der Toolbox einen ersten Zugriff auf diverse „Metadaten“.
axes und abhängige Strukturen umgestellt: x,y,z ⇒ 1,2,3display (vormals nur innerhalb der GUI) nun fester Bestandteil der Datenstrukturcharacteristicsversionaxis.y.calibratedValuesaxis.zoperatordateparameters.field.calibrationparameters.field.unitparameters.field.modelparameters.recorder.timeBase (scalar ⇒ struct)parameters.recorder.bandwidthparameters.recorder.couplingparameters.recorder.impedanceparameters.recorder.modelparameters.transient.unitparameters.bridge.MWfrequency (scalar ⇒ struct)parameters.bridge.attenuation (scalar ⇒ struct)parameters.bridge.bandwidthparameters.bridge.amplificationparameters.bridge.calibrationparameters.bridge.powerparameters.bridge.modelparameters.bridge.probeheadparameters.temperature (scalar ⇒ struct)parameters.laser.wavelength (scalar ⇒ struct)parameters.laser.repetitionRate (scalar ⇒ struct)parameters.laser.powerparameters.laser.modelsamplecommentfilelabelEntwurf für die Struktur
<note important>Die mit NEW markierten Felder sind in Version >1.1 neu hinzugekommen, und werden aktuell (2012-04-19) noch nicht von allen Routinen berücksichtigt.</note>
data - matrixaxes - structx - struct (alt: xaxis)values - vectordata-Feldesmeasure - stringunit - stringy - struct (alt: yaxis)values - vectordata-Feldes, leer im Falle eines 1D-DatensatzescalibratedValues - vectordata-Feldes, leer im Falle eines 1D-Datensatzes2)measure - stringunit - stringz - structmeasure - stringunit - stringparameters - structruns - scalaroperator - stringdate - structstart - stringend - stringpurpose - cell arrayfield - structstart - scalarstop - scalarstep - scalarcalibration - structvalues - vectorunit - stringmodel - stringunit - stringmodel - stringrecorder - structsensitivity - structvalue - scalarunit - string averages - scalartimeBase - struct (alt: scalar)value - scalarunit - stringbandwidth - structvalue - scalarunit - stringcoupling - stringimpedance - structvalue - scalarunit - stringmodel - stringtransient - structpoints - scalartriggerPosition - scalarlength - scalarunit - stringbridge - structMWfrequency - struct (alt: scalar)value - scalarunit - stringattenuation - struct (alt:scalar)value - scalarunit - stringbandwidth - structvalue - scalarunit - stringamplification - structvalue - scalarunit - stringcalibration - structvalues - vectorunit - stringmodel - stringpower - structmodel - stringdetection - stringprobehead - structtype - stringmodel - stringcoupling - stringtemperature - struct (alt: scalar)value - scalarunit - stringlaser - structwavelength - struct (alt: scalar)value - scalarunit - stringrepetitionRate - struct (alt: scalar)value - scalarunit - stringpower - structvalue - scalarunit - stringmodel - stringtunable - structtype - string\\ OPO oder Farbstofflasermodel - stringdye - stringname - stringdescription - cell arraybuffer - cell arraypreparation - cell arraytube - stringheader - cell arraycomment - cell arrayhistory - cell arrayinfo - structfile - structname - stringlabel - stringversion - stringdisplay - structlines - structdata - structcolor - string oder vector, default: 'k'style - string, default: '-'marker - string, default: 'none'width - scalar, default: 1calculated - structcolor - string oder vector, default: 'k'style - string, default: '-'marker - string, default: 'none'width - scalar, default: 1position - structdata - structx - scalar, default: 1y - scalar, default: 1calculated - structx - scalar, default: 1y - scalar, default: 1displacement - structdata - structx - scalar, default: 0y - scalar, default: 0z - scalar, default: 0calculated - structx - scalar, default: 0y - scalar, default: 0z - scalar, default: 0scaling - structdata - structx - scalar, default: 1y - scalar, default: 1z - scalar, default: 1calculated - structx - scalar, default: 1y - scalar, default: 1z - scalar, default: 1smoothing - structdata - structx - structvalue - scalar, default: 1filterfun - stringy - structvalue - scalar, default: 1filterfun - stringcalculated - structx - structvalue - scalar, default: 1filterfun - stringy - structvalue - scalar, default: 1filterfun - stringaveraging - structdata - structx - scalar, default: 1y - scalar, default: 1calculated - structx - scalar, default: 1y - scalar, default: 1Zur Vereinfachung der Entwicklung neuer Einleseroutinen und zum Überprüfen von Datenstrukturen auf Konformität mit dem Datenmodell der trEPR-Toolbox gibt es mittlerweile eine neue Funktion:
trEPRdataStructure()
Aus der Hilfe zu dieser Funktion:
trEPRdataStructure Return data structure for trEPR toolbox data, or test
compliance of given structure with the data structure of the toolbox.
Usage
structure = trEPRdataStructure;
structure = trEPRdataStructure(<command>)
[missingFields,wrongType] = trEPRdataStructure(<command>,structure)
<command> - string
one of 'structure', 'model' or 'check'
'structure' - return (empty) trEPR toolbox data
structure
'model' - return trEPR toolbox data structure with
field types as values
'check' - check given structure for compliance with
the toolbox data structure
'history' - return history structure for processing
step of dataset
'historymodel' - return history structure with field types
as values
short: 'hmodel'
'historycheck' - check given structure for compliance with
the toolbox history record structure
short: 'hcheck'
structure - struct
either empty trEPR toolbox data structure or
trEPR toolbox data structure with field types as values
In case of a history record, data structure complying with
the history record data structure
missingFields - cell array
List of fields missing in the structure with respect to
the toolbox data structure
wrongType - cell array
List of fields in structure having the wrong type with
respect to the toolbox data structure
See also trEPRload.
Wie aus dem Hilfetext ersichtlich kann mit dieser Funktion eine Datenstruktur auf Konformität mit der Toolbox-Datenstruktur überprüft werden.
Spätere Versionen dieser Funktion haben evtl. dann auch die Fähigkeit, eine alte in die jeweils aktuelle Datenstruktur zu überführen.
values oder ebenfalls leer?trEPRload.ini stehen