Datenformat der Toolbox
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 TAload-Routine ist, eine Schnittstelle zwischen allen von der TA-Toolbox verarbeitbaren Dateiformaten und der GUI zu schaffen.
Deshalb gibt es eine einheitliche Datenstruktur für das Ausgabeformat der TAload-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“.
Historie
- 2012-03-31: Version 0.3
- Neue Struktur „shotRepetitionRate“ in „parameters“
- 2012-01-26: Version 0.2 (immer noch)
- Neues Feld „background“ in „parameters.probe“
- 2012-01-24: Version 0.2 (immer noch)
- Format des Parameters „filter“ in „parameters.probe“ geändert: vorher struct, jetzt string
- 2012-01-21: Version 0.2
- Struktur „aperture“ in „parameters.spectrograph“ hinzugefügt
- „parameters.date“ umgewandelt in struct mit Feldern „start“ und „end“
- Struktur „spectrometer“ mit Feldern „name“ und „software“ in „parameters“ hinzugefügt
- Struktur „timeConstant“ in „parameters.detection“ hinzugefügt
- Feld „opoDye“ umbenannt in „tunable“
Struktur
Entwurf für die Struktur:
data
- matrix
eigentliche Daten (ohne Magnetfeld)dataMFon
- matrix
Daten mit angeschaltetem Magnetfeld (leer, wenn kein MFE-Setup)axes
- struct
zusätzliche Informationen zu den Achsenx
- structvalues
- vector
Werte der X-Achse, gleiche Länge wie die korrespondierende Dimension desdata
-Feldesmeasure
- string
Meßgrößeunit
- string
Einheit
y
- structvalues
- vector
Werte der Y-Achse, gleiche Länge wie die korrespondierende Dimension desdata
-Feldesmeasure
- string
Meßgrößeunit
- string
Einheit
z
- structmeasure
- string
Meßgrößeunit
- string
Einheit
parameters
- struct
zusätzliche Informationen zur Messung, die häufig gebraucht werdenruns
- scalaroperator
- string
Nutzer, der den Datensatz aufgenommen hatdate
- NEW struct
Beginn und Ende der Messungstart
- datetimeend
- datetime
- NEW
shotRepetitionRate
- struct
Schußwiederholrate des Experimentesvalue
- scalarunit
- string
spectrometer
- struct
Bezeichnung und grundlegende Informationen zum verwendeten Aufbauname
- string
Kurze, möglichst eindeutige Bezeichnung des Spektrometerssoftware
- string
Bezeichnung inkl. Versionsnummer der verwendeten Meßsoftware
transient
- structpoints
- scalartriggerPosition
- scalarlength
- scalarunit
- string
Einheit
spectrograph
- structtype
- string
Art des verwendeten Spektrographenmodel
- string
Typenbezeichnung des verwendeten Spektrographen- NEW
aperture
- structfront
- structvalue
- scalarunit
- string
back
- structvalue
- scalarunit
- string
detection
- structtype
- string
Art der Detektion („PMT“,„CCD“,…)model
- string
Typenbezeichnung des Detektorspowersupply
- string
Netzgerät des zugehörigen Detektorsimpedance
- struct
Widerstand, der zwischen PMT und Rekorder hängt (und demzufolge die Zeitauflösung des PMT bestimmt)value
- scalarunit
- string
- NEW
timeConstant
- struct
Zeitkonstante (Zeitauflösung) der Detektion (durch die Impedanz bestimmt)value
- scalarunit
- string
recorder
- structsensitivity
- structvalue
- scalarunit
- string
averages
- scalartimeBase
- struct (alt: scalar)value
- scalarunit
- string
bandwidth
- structvalue
- scalarunit
- string
coupling
- string
Art der Ankopplung Transientenrekorders (AC, DC, GND)model
- string
Typenbezeichnung des verwendeten Transientenrekorders
pump
- struct
Alle Informationen zum Pumpstrahltype
- string
Art der Lichtquelle („arclamp“,„laser“)model
- string
Typenbezeichnung der verwendeten Lichtquellewavelength
- structvalue
- scalarunit
- string
power
- structvalue
- scalarunit
- string
repetitionRate
- structvalue
- scalarunit
- string
tunable
- struct
type
- string
Art des verwendeten Geräts („OPO“,„dye“)model
- string
Typenbezeichnung des verwendeten OPOs bzw. Name des Farbstofflasersdye
- string
Name des verwendeten Farbstoffes („none“ im Falle vontype
=„OPO“)
probe
- struct
Alle Informationen zum Probenstrahltype
- string
Art der Anregungsquelle („arclamp“,„laser“)model
- string
Typenbezeichnung der zur Anregung verwendeten Lichtquellewavelength
- structstart
- scalarstop
- scalarstep
- scalarsequence
- stringunit
- string
power
- structvalue
- scalarunit
- string
filter
- string
Liste der verwendeten Filter (kann mehr als ein Filter pro Zeitkurve sein)- NEW
background
- string
temperature
- structvalue
- scalarunit
- stringcontroller
/model
- string
Typenbezeichnung der Temperatursteuereinheitcryostat
- string
Typenbezeichnung des verwendeten Kryostaten („none“, wenn keiner)cryogen
- string
verwendetes Kühlmittel („none“,„H2O“,„LN2“,„LHe“)
MFE
- struct
Alle Parameter, die für das MFE-Setup charakteristisch sindfield
- structvalue
- scalarunit
- string
Einheit
coils
- structtype
- string
Art der verwendeten Spulen („Helmholtz“)model
- string
Eindeutiger Bezeichner für die verwendeten Spulen
powersupply
- string
Netzgerät, mit dem die Spulen versorgt werdengaussmeter
- string
- NEW
timeProfiles
- struct (1xn)filename
- stringwavelength
- structvalue
- scalarunit
- string
averages
- scalarruns
- scalarfilter
- string
-
name
- string
möglichst eindeutiger und kurzer Name der Probedescription
- cell array
Freitext-Beschreibung der Probepreparation
- cell array
Freitext-Beschreibung der Probenpräparationcuvette
- string
verwendete Küvette
header
- cell array
Kommentarkopf der eingelesenen Dateicomment
- cell array
Freitextkommentar zur Messunginfo
- struct
zusätzliche Informationen zum Datensatz, z.B. zur Probe, idealerweise Schlüssel-Wert-Paare; leer, wenn nicht vorhandenfile
- structname
- string
Dateiname, ggf. mit komplettem oder relativem Pfad
label
- string
Anzeigename z.B. in der TAgui; leerer String, wenn nicht angegebenformat
- struct
Informationen über das Datenformatname
- string
Name des Datenformates: „TA toolbox“; dient der Identifizierungversion
- string
Versionsnummer der Datenstruktur