DOKUMENTNAME:

Pflichtenheft XCTL-Steuerprogramm

Hauptfunktion: Protokollbuch

Teilfunktion: Protokollbuch - Topographie
 
Dokumentversion: 1.20 (letzte Änderung: 07.März 2002)
Autor: J. Klier
Zustand: in Arbeit



Gliederung

1. Überblick
2. Funktionale Beschreibung
2.1 Aufruf der Dialogbox aus dem Steuerprogramm
2.2 Protokollbuch Topographie
2.3 Protokollbuch Topographie - Suchen/Drucken
3. Daten
3.1. Benutzerschnittstelle
3.1.1 Steuerung
3.1.2 Parameter einer Messung
3.2. Dateien
3.2.1 csv-Datei
3.2.2 xmf-Dateien
3.2.3 ini-Datei
4. Qualitätsbestimmung
5. Anmerkungen
6. Verwandte Dokumente
7. Testfälle
8. Glossar

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 Topographie" kann aus dem Steuerprogramm jederzeit über "Einstellungen --> Protokoll --> Protokoll Topographie..." aufgerufen werden. Weiterhin wird beim Start einer Topographiemessung 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 Topographie

DIALOGBOX:

Protokollbuch Topographie

Protokollbuch - Register Kollimator/Röhre

Protokollbuch - Register Messung/Filme

Protokollbuch - Register Beginn Messung

Protokollbuch - Register Ende Messung



DETAILBESCHREIBUNG:

Mit Hilfe der 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 "Kollimator/Röhre", "Messung/Filme", "Beginn Messung" und "Ende Messung" gewechselt werden.

Eine Messung wird durch den Parameter "Lfd.-RTK-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. Alle Parameter einer Messung können jederzeit verändert werden. Bei einer direkten Eingabe des Parameters "Lfd.-RTK-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, mit Ausnahme der Parametergruppen "Beginn Messung" und "Ende Messung", 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.-RTK-Nr",
- "Datum",
- "Probennummer",
- "Lieferant",
- "Material",
- "Reflex" und
- "Einfallswinkel" 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.

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

Wechsel zwischen existierenden Messungen
- Drücken der Pfeiltasten
- Eingabe einer "Lfd.-RTK-Nr."
Erstellen einer neuen Messung
- Eingabe einer nicht existierenden "Lfd.-RTK-Nr."
Verändern der Lageskizze
- Drücken der "Ändern"-Taste
- Drücken der "Löschen"-Taste, wenn die Skizze gelöscht werden soll
- Zeichnen der Skizze: Gedrückthalten der Linken Maustaste und gleichzeitiges Bewegen der Maus
- Beschriften der Skizze: Drücken der rechten Maustaste, Eingabe von Zeichen in das Eingabefeld, Drücken der "Ok"-Taste
- Drücken der "Sichern"-Taste

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 werden jeweils drei 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.

Das Druckbild entspricht dem in der Datei AusdruckTopographie.pdf gezeigtem Format.

3. Daten

3.1 Benutzerschnittstelle

3.1.1 Steuerung

3.1.2 Parameter einer Messung

Die Parameter werden in der folgenden Tabelle beschrieben.

Bezeichnung Beispiele Maßeinheit Datentyp Bemerkungen
Lfd.Nr. C3335 . string(6) Versuchsnummer
Datum 4.10.2001 . date Versuchsdatum

Probe
    Probennummer:
    Lieferant:
    Merkmal:
    Material:


40
TU

GaAs


.
.
.
.


string(25)
string(20)
string(20
string(10)


Proben-Nr., wird mitgeliefert
Lieferant, wird mitgeliefert

Materialbezeichnung , wird mitgeliefert

Lageskizze
    Form:
    Winkel:
    Größe(a,b):
    Reflex:
    Einfallswinkel:
    Beugungswinkel:









Grad
mm

Grad
Grad


Bild
integer(3)
integer(3)
string(8)
integer(2)
integer(2)


Skizze mit Orientierung der Probe


Reflexionsebene in der Probe
Winkel zwischen Strahl u. Probenebene
.

RTK-Nr.

4

.

string(2)

Messplatznummer

Kollimator
    Material:
    Reflex:
    Nr.:
    Krümmung:


Si
[440]
40
-53


.
.
.
µm


string(6)
string(5)
string(3)
integer(4)



Reflexionsebene im Kollimator
Koll.-Beschriftung
Koll.-Krümmung

Röhre
    Material:
    Spannung:
    Strom:


40
25
4


.
kV
mA


string(2)
integer(2)
integer(2)


Röntgenröhre

Imp/s Max

40T

Tausend

integer(3)

Impulse/s bei Messungsbeginn am Pik

Film
    Anzahl:
    Spannung:
    Strom:
    Aufnahmematerial:
    Plattengröße:
    Abstand:





L4

15


.
kV
mA
.
mm
mm


string(1)
integer(2)
integer(2)
string(5)
integer(3)
integer(3)





Fotoplatte-, Film-Bezeichnung

Abstand: Aufnahmematerial - Probe

HWB

15" arcsec integer(3) Halbwertsbreite Rockingkurve

ST.E.
CR.T.
INC.DF

100

.
.
.

string(3)
string(2)
string(3)

Zählrohr(statistischer Fehler)
Zählzeit
Schrittweite Beugung fein

NB.EXPOS.

4

. string(2) Anzahl der Belichtungen

A.B.E.
R.S.A.


arcsec
arcsec

integer(2)
integer(2)

Winkel zwischen den Belichtungen
kleinster Startwinkel

CON.LIMIT

5

%

integer(2)

proz. Abweichung, bei der Belichtungsregelung einsetzt

CON.POINT

-60

%

integer(2)

Arbeitspunkt

EXP.T.

10

h

integer(3)

Belichtungszeit

Imp/s vor/nach
DF vor/nach

40/25
-244/-237

Imp/s
arcsec

integer(3)
integer(3)

Impulse/sec bei Messungsbeginn u. -ende
Beugung fein bei Messungsbeginn u. -ende

Bemerkung:

Fehlschnitt . string(80) allgemeine Bemerkungen

3.2 Dateien

3.2.1 csv-Datei

Die Parameter einer Messung werden in der Datei prottopo.csv gespeichert (Beispieldatei: prottopo.csv). Beim Start des Programms wird von dieser Datei eine Sicherheitskopie angelegt. Es existieren maximal 5 Sicherheitskopien der Protokolldatei (prottopx.csv, x=1..5). Jeder Wert wird in Textform durch ein Semikolon getrennt abgespeichert. Enthält ein Wert ein Semikolon, muss es in Hochkomma eingeschlossen sein. Enthält ein Wert ein Hochkomma, wird es durch zwei aufeinander folgende Hochkommas dargestellt. Jeder Versuch wird durch ein "Zeilenende" abgeschlossen. Die Anwendung dieses Formates macht es möglich, die Protokolldatei in andere Anwendungen zu exportieren (z.B.: Excel...).

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 Sichheitskopie 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.2 ini-Datei

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

Parameter Beispiel Beschreibung
LfdNrBereich C Teil der Lfd.-Nr.; Kennzeichnet die Abteilung in der das Programm eingesetzt wird
RTKNr 12 Nummer der Röntgen-Topographie-Kamera; Kennzeichnet den Messplatz
NutzerX
(X=1..n)
Meier Person die die Messung durchführt
LieferantX (X=1..n) HUB Berlin Lieferanten der Probe (erscheinen in der "Lieferant"-Auswahlbox)
MaterialX
(X=1..n)
Cu Material der Probe (erscheinen in der "Material"-Auswahlbox)
KMaterialX
(X=1..n)
Cu Material des Kollimators (erscheinen in der "Material"-Auswahlbox des Kollimator-Abschnittes)
RMaterialX
(X=1..n)
Cu Material der Röhre (erscheinen in der "Material"-Auswahlbox des Röhre-Abschnittes)
TopographyPath c:\tmp Path der Protokolldatei, existiert dieser Wert nicht wird der StandardPath verwendet (Programmverzeichnis\protocol\topogrfy\)

4. Qualitätsbestimmung

Produktqualität Sehr gut Gut Normal Nicht relevant
Funktionalität . X . .
Zuverlässigkeit . X . .
Benutzbarkeit . X . .
Effizienz . X . .
Änderbarkeit . X . .
Übertragbarkeit . X . .

5. Anmerkungen

6. Verwandte Dokumente

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


7. Testfälle

Folgende Funktionen sind zu überprüfen:

Weitere Testfälle sind noch mit der Arbeitsgruppe der Physiker zu klären.

8. Glossar