Pflichtenheft XCTL-Steuerprogramm

Hauptfunktion: Protokollbuch

Teilfunktion: Protokollbuch - Diffraktometrie/Reflektometrie
 

Dokumentversion:	0.98 (letzte Änderung: 07.März 2002)
Autor:	J. Klier
Zustand:	in Arbeit

1. Überblick

Die Funktion "Protokollbuch" stellt eine Grundfunktion des XCTL-Programmes dar. Mit ihr ist es möglich, alle bei einer Messung anfallenden Parameter zu erfassen. Diese werden in einer speziellen Protokolldatei gespeichert und können angezeigt und ausgedruckt werden. Gehen die Parameter einer Messung verloren, ist diese Messung wertlos, da es nicht mehr möglich ist sie zu einem späteren Zeitpunkt zu wiederholen.
Mit der Teilfunktion "Protokollbuch" können die Parameter einer Messung
- erfasst,
- verändert
- und gespeichert werden.
Mit der Teilfunktion "Suchen/Drucken" können mehrere Messungen nach bestimmten Kriterien
- gesucht
- und ausgedruckt werden.

2. Funktionale Beschreibung

2.1 Aufruf der Dialogbox aus dem Steuerprogramm

DIALOGBOX:

Steuerprogramm

DETAILBESCHREIBUNG:

Die Dialogbox "Protokoll Diffraktometrie/Reflektometrie" kann aus dem Steuerprogramm jederzeit über "Einstellungen --> Protokoll --> Protokoll Diffraktometrie/Reflektometrie..." aufgerufen werden. Weiterhin wird beim Start einer Diffraktometrie-/Reflektometriemessung ein Fenster mit der Anfrage geöffnet, ob die Messung im Protokollbuch erfasst werden soll. Wird diese Anfrage positiv beantwortet, erscheint die Dialogbox am Anfang und am Ende der entsprechenden Messung.

2.2 Protokollbuch Diffraktometrie-/Reflektometriemessung

DIALOGBOX:

Protokollbuch Diffraktometrie-/Reflektometriemessung

Protokollbuch - Register Messung

Protokollbuch - Register Scan (StepScan)

Protokollbuch - Register Scan (ContinuousScan)

Protokollbuch - Register Blende/Absorber

Protokollbuch - Register Detektor (Counter)

Protokollbuch - Register Detektor (PSD)

Protokollbuch - Register Bemerkung

DETAILBESCHREIBUNG:

Mit dieser Dialogbox werden die Parameter einer Messung erfasst und gespeichert. Die Einträge im oberen Teil der Dialogbox sind immer sichtbar. Im unteren Teil kann zwischen den Parametergruppen Parametergruppen "Messung", "Scan", "Blende/Absorber", "Detektor" und "Bemerkung" gewechselt werden.

Eine Messung wird durch den Parameter "Lfd.-Nr." eindeutig bestimmt. Durch die Pfeiltasten neben diesem Parameter kann die jeweils letzte oder nächste bereits existierende Messung angezeigt werden.  Ist die angezeigte Messung die letzte gespeicherte Messung, erscheint in der Dialogbox nach Betätigen der Pfeiltaste "nächste Messung" eine leere Messung. Bei einer direkten Eingabe des Parameters "Lfd.-Nr." überprüft das Programm, ob eine dazugehörende Messung vorhanden ist. Existiert eine solche Messung, wird diese angezeigt. Anderenfalls wird eine neue Messung angelegt. Dabei werden alle Parameter der letzten angezeigten Messung kopiert. War die letzte angezeigte Messung leer ist auch die neu angelegte Messung leer. Beim ersten Aufruf der Dialogbox nach dem Start des Programms erscheint ebenfalls eine leere Messung. Bei jedem folgenden Aufruf der Dialogbox erscheint die jeweils zuletzt angezeigte Messung. Eine neue Messung wird nur gespeichert, wenn mindestens die Parameter
- "Lfd.-Nr",
- "Probennummer",
- "Scantyp",
- "Strom",
- "Spannung",
- "Primärstahlblende horizontal",
- "Primärstahlblende vertikal",
- "Detektorblende horizontal" und
- "Detektorblende vertikal" eingetragen wurden.

Die Lageskizze kann bearbeitet werden, wenn die Taste "Ändern" gedrückt wurde. Die Taste "Ändern" verschwindet, und an ihrer Stelle werden die Tasten "Löschen" und "Sichern" angezeigt. Durch Drücken der "Löschen"-Taste wird die gesamte Skizze gelöscht. Im Bereich der Lageskizze können nun durch das Gedrückthalten der linken Maustaste und gleichzeitiges Bewegen der Maus einfache Linien gezeichnet werden. Beim Drücken der rechten Maustaste erscheint ein Eingabefeld mit einer "Ok"-Taste an der Stelle des Mauszeigers. Hier können Zeichen eingegeben werden, um die Skizze zu beschriften. Nach Drücken der "Ok"-Taste werden diese Zeichen in der Skizze sichtbar. Sind die Änderungen abgeschlossen, erfolgt durch Drücken der "Sichern"-Taste die Speicherung der Skizze. Neben der Lageskizze erscheint innerhalb der Dialogbox nun wieder die "Ändern"-Taste.

Je nachdem was für ein Scan durchgeführt wird, werden in der Dialogbox unterschiedliche Parameter angezeigt. Folgende Tabelle gibt einen Überblick darüber.

Dialogelement	Auswahl	Ändert Dialogelement	Mögliche Parameter
Scantyp	Linescan	Scanart	Standard, Omega2Theta
		Scanachse	Tilt, AF....
	Areascan	Scanart	Omega2Theta
		Scanachse	Omega, Theta
Scanmethode	Stepscan	Scandialogbox	Minimum, Maximum, Schrittweite
	Continuous	Scandialogbox	Start, Ende, Bereichsgröße, Geschwindigkeit
Scanart	Standard	Scanachse	Tilt, AF....
	Omega2Theta	Scanachse	Omega, Theta
Detektor	Counter	-	Distanz
	PSD	PSD-Dialogbox	Winkelbereich, Kanalabstand, Messkanalnr., Addiere

Eine Messung wird gespeichert, wenn die "Ok"-Taste gedrückt wurde. Danach schließt sich die Dialogbox. Soll eine andere Messung angezeigt werden, wird überprüft, ob in der aktuell angezeigten Messung Parameter geändert wurden, die noch nicht abgespeichert sind. In diesem Fall erscheint eine Warnmeldung. Erfolgt eine Bestätigung dieser Meldung mit "Ok" wird die Messung gespeichert, bei "Abbrechen" gehen die vorgenommenen Änderungen verloren.

Die Taste "Suchen/Drucken" öffnet die Dialogbox "Protokollbuch - Suchen/Drucken".

FUNKTIONEN

2.3 Protokollbuch - Suchen/Ducken

DIALOGBOX:

Protokollbuch - Suchen/Drucken

DETAILBESCHREIBUNG:

Im oberen Teil der Dialogbox befinden sich die Parameter, nach denen gesucht werden kann. Alle Parameter sind UND verknüpft. Die Eingabe von Teilstrings ist möglich (z.B. Material: Ku findet Kupfer und Kunststoff). Werden keine Parameter angegeben, werden alle gespeicherten Messungen angezeigt. Durch Drücken der "Suchen"-Taste wird eine Suche gestartet und das Ergebnis in der Listbox dargestellt. Es werden nur Parameter dargestellt, nach denen auch gesucht werden kann. Mit der Maus können nun einzelne oder mehrere Messungen markiert werden. Durch Drücken der "Anzeigen"-Taste wird die erste markierte Messung in der Dialogbox "Protokollbuch" angezeigt. Über den "Drucken"-Knopf können die Parameter aller markierten Messungen ausgedruckt werden. Dabei wird jeweils eine Messungen pro A4 Blatt in einer Tabelle ausgegeben. Wurde keine Messung markiert, erscheint eine Warnmeldung, und es können nach drücken der "Ok"-Taste alle Messungen ausgedruckt werden.

3. Daten

3.1 Benutzerschnittstelle

3.1.1 Steuerung

• Die Dialogboxen sind mausgesteuert.
• Der Wechsel zwischen den Dialogelementen ist mittels TAB oder Maus möglich.
• Durch Anklicken der einzelnen Register-Schalter mit der Maus kann zwischen den Registern gewechselt werden.
• Das Drücken von Return innerhalb der Dialogbox aktiviert den OK- Button.

3.1.2 Parameter einer Messung

Die Parameter werden in der folgenden Tabelle beschrieben.

3.2 Dateien

3.2.1 csv-Datei

3.2.2 xmf-Dateien

Die Skizze einer Messung wird in einer xmf-Datei gespeichert (Beispieldatei: C12345612.xmf). Der Name der jeweiligen Datei ergibt sich aus der "Lfd.-RTK.-Nr" und der Endung ".xmf". Vor dem Ändern einer Skizze wird von der bereits existierenden Skizzendatei eine Sicherheitskopie angelegt. Es existiert maximal 1 Sicherheitskopie einer Skizzendatei ("Lfd.-RTK.-Nr".bak). Bei der Skizzendatei handelt es sich um eine Textdatei mit beliebig vielen Zeilen. Jede Zeile hat eine feste Struktur der Form:
"Buchstabe","Zahl1","Zahl2" Zeilenende oder
T,"Zahl1","Zahl2","Zeichenkette" Zeilenende,
und enthält einzelne Anweisungen zum Zeichnen der Skizze. Dabei steht der Buchstabe für eine auszuführende Aktion. Mögliche Aktionen sind M - Move, L - Line und T - Text. Bei den Zahlen handelt es sich um Positionsangaben. Die Zeichekette kann beliebige Zeichen enthalten, die in der Skizze dargestellt werden.

3.2.3 ini-Datei

Einige Parameter werden in der XCTL-Programm-ini-Datei im Protocol-Abschnitt gespeichert:

Parameter	Beispiel	Beschreibung
NutzerX (X=1..n)	Meier	Person die die Messung durchführt
MaterialX (X=1..n)	Cu	Material der Probe (erscheinen in der "Material"-Auswahlbox)
DiffractometryPath	c:\tmp	Path der Protokolldatei, existiert dieser Wert nicht wird der StandardPath verwendet ( Programmverzeichnis\protocol\difrkmty\)

• Betriebssystem: Windows 9x
• Compiler: Borland C++ 4.5

Grundlage für dieses Dokument sind die Absprachen mit der Arbeitsgruppe der Physiker. Weiterhin wurden das Dokument Diffraktometrie/Reflektometrie- Gesamtvorgang verwendet.

Folgende Funktionen sind zu überprüfen:

• Zeigt die Protokollbuch-Dialogbox alle Parameter aus der csv-Datei richtig an?
• Wenn Parameter geändert wurden und Abbrechen angeklickt wurde, dürfen keine Änderungen in der csv-Datei eingetragen sein.
• Wenn Parameter geändert wurden und Ok angeklickt wurde, müssen alle Änderungen korrekt in die csv-Datei eingetragen sein.
• Werden alle Datensätze in der Drucken/Suchen-Dialogbox entsprechend der Suchkriterien gefunden und angezeigt?
• Werden alle markierten Datensätze korrekt ausgedruckt?