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 Datenstrukturcharacteristics
version
axis.y.calibratedValues
axis.z
operator
date
parameters.field.calibration
parameters.field.unit
parameters.field.model
parameters.recorder.timeBase
(scalar ⇒ struct)parameters.recorder.bandwidth
parameters.recorder.coupling
parameters.recorder.impedance
parameters.recorder.model
parameters.transient.unit
parameters.bridge.MWfrequency
(scalar ⇒ struct)parameters.bridge.attenuation
(scalar ⇒ struct)parameters.bridge.bandwidth
parameters.bridge.amplification
parameters.bridge.calibration
parameters.bridge.power
parameters.bridge.model
parameters.bridge.probehead
parameters.temperature
(scalar ⇒ struct)parameters.laser.wavelength
(scalar ⇒ struct)parameters.laser.repetitionRate
(scalar ⇒ struct)parameters.laser.power
parameters.laser.model
sample
comment
file
label
Entwurf 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