Pflichtenheft: RTK-Steuerprogramm

Hauptfunktion: Topographie
Teilfunktion: Start und Kontrolle der Topographie
 

Dokumentversion: v2.0  (06.Juli 2000)
Autor:           M. Gollnick, U.Sacklowski
Zustand:   in Bearbeitung

Inhalt

1.   Überblick
2.   Funktionale Beschreibung
2.1   Einstellen der Startposition
2.2   Regelung starten und stoppen
2.3   Einstellungen für die Topographie ändern
2.4   Start und Beendigung der Teilfunktion
3.   Benutzerschnittstelle
3.1   Dialogbox 'Topographie'
3.1.1   Steuerung
3.1.2   Eingaben/Ausgaben und Prüfung
4.   Daten
4.1   .ini-Datei
4.2   standard.mak-Datei
5.   Testfälle
6.   Fehler und Änderungswünsche
6.1   Fehler aus Nutzersicht
6.2   Änderungswünsche
7.   Offene Fragen
 

1. Überblick

Die Teilfunktion 'Start und Kontrolle der Topographie' ist Teil des
Topographie-Gesamtvorganges (Dokument: 'Topographie-Gesamtvorgang'). Dort ist sowohl ihre
Einordnung in den Gesamtvorgang beschrieben, als auch der fachliche Hintergrund.

Mit der Teilfunktion 'Start und Kontrolle der Topographie'
- kann die Startposition angefahren werden,
- wird die Regelung gestartet mit nachfolgender Information in der Dialogbox zum Stand und Verlauf der Regelung,
- wird die Regelung gestoppt,
- können Einstellungen geändert werden.

Zur Abgrenzung von Regelung und Topographie: Mit der Regelung durch das RTK-Steuerprogramm wird bspw., ausgehend von den Detektor-Meßwerten, die Probe nachgeregelt, oder bei der Mehrfachbelichtung wird nach Ablauf der Belichtungszeit auf das nächste Segment gestellt. Ein Stoppen der Regelung stoppt die Aktionen des RTK-Steuerprogrammes. Trotzdem läuft der Topographievorgang mit der Belichtung der Fotoplatte noch weiter bis diese schließlich entnommen oder die Röntgenquelle ausgeschaltet wird.

2.   Funktionale Beschreibung

DIALOGBOX:

2.1   Einstellen der Startposition

Diese Funktion ist abhängig von der Belichtungsart. Sie wird über den Button 'Startposition einstellen' gestartet.

Topographie mit Einfachbelichtung
Entsprechend den Eingaben in der Dialogbox 'Einstellungen Topographie' in die Felder 'Arbeitspunkt; Lage und Anfahren mit' und Motor (Actuator) wird die Startposition (Arbeitspunkt) angefahren. Der Detailsteuerung dabei dient der Makro 'Einstellen des Arbeitspunktes' aus der Datei standard.mak (siehe Pkt. 4.2).
Nach dem Start der Funktion erscheint im Nachrichtenteil des Dialogfensters: 'Arbeitspunkt wird angefahren'. Während des Anfahrens wird man ständig im unteren Fensterrahmen des Hauptfensters über die Detailsteuerung informiert, einschließlich der  aktuellen Motorposition und der Zählrate. Schließlich erscheint die Nachricht:
>>>>>>>> X_RAY OF <<<<<<<<<<<
Bitte Filmkassette auflegen!
Die Aufnahme kann gestartet werden!

Topographie mit Mehrfachbelichtung
Entsprechend den Eingaben in der Dialogbox 'Einstellungen Topographie' in die Felder 'Mehrfachbelichtung; Startwert; Arbeitspunkt: Anfahren mit; Motor (Actuator)' wird die Startposition direkt von der aktuellen Motorposition aus angefahren, d.h. nicht über den Peak.
Frage:Wird die Detailsteuerung auch über ein Makro gesteuert?
Während des Anfahrens wird man ständig im unteren Fensterrahmen des Hauptfensters über die aktuelle Motorposition und der Zählrate informiert. Schließlich erscheint die Nachricht:
>>>>>>>> X_RAY OF <<<<<<<<<<<
Bitte Filmkassette auflegen!
Die Aufnahme kann gestartet werden!

2.2   Regelung starten und stoppen

Diese Funktion wird über den Button 'Regelung starten' gestartet. Nach dem Start ändert sich die Bezeichnung des Buttons in 'Regelung stoppen', wodurch sie gestoppt werden kann.

Der weitereAblauf ist abhängig von der Belichtungsart.

Topographie mit Einfachbelichtung
Nach dem Start werden in den Feldern 'Meß-Zeit' und 'Drift' die abgelaufene Meßzeit und die Drift vom anfänglichen Arbeitspunkt aus angezeigt. Zusätzlich wird  im unteren Fensterrahmen des Hauptfensters über die aktuelle Motorposition und die Zählrate informiert.
Bei einer Drift größer als der 'Belichtungsregelungs-Bereich' (Dialogfenster: Einstellungen Topographie), wird über den Motor mit dem Ziel nachgeregelt, die Zählrate, wie sie am Arbeitspunkt war, wieder zu erreichen.
Nach Ablauf der Meßzeit:
- wird eine Folge von akustischen Signalen ausgegeben,
- erscheint eine Nachrichtenbox mit dem Text 'Meßzeit abgelaufen. Bei Bestätigung wird die Regelung gestoppt' und einem OK-Button.
Solange der OK-Button nicht betätigt wird, läuft der gesamte zuvor beschriebene Ablauf weiter. Zusätzlich wird jetzt nur noch die inzwischen abgelaufene Zeit im Feld 'Zusatz-Zeit' angezeigt.
Die Regelung wird durch Betätigung des OK-Buttons beendet und der Button  'Regelung stoppen' wird wieder zu 'Regelung starten'.
Bei einer Abweichung der Motorposition vom Arbeitspunkt über einen vorgegebenen Bereich hinaus (Dialogbox 'Einstellungen Topographie'  das Feld 'Motor; Beschränkung auf' wird die Regelung gestoppt und im Nachrichtenteil des Dialogfensters erscheint die Nachricht: ???

Topographie mit Mehrfachbelichtung
Abweichend von der Topographie mit Einfachbelichtung
- wird hier die Drift vom Startpunkt des ersten Segmentes, bzws. von den Startpunkten in den Folgesegmenten, angezeigt,
- wird die Anzahl der noch verbleibenden Zyklen im Feld 'Rest-Zyklus' angezeigt,
- wird nach Ablauf der Belichtungszeit zum nächsten Segment gefahren entsprechend den Vorgaben aus den Feldern der Dialogbox 'Einstellungen Topographie': 'Mehrfachbelichtung, Schrittweite' und 'Arbeitspunkt, Anfahren mit ...'.
- bewirkt ein Anwachsen der Drift keine Nachregelung.

2.3   Einstellungen für die Topographie ändern

Durch den Button 'Einstellungen' wird die Dialogbox 'Einstellungen Topographie' geöffnet. Geändert können hier vier Werte:
Detektorparameter: Zeit und Counts
Belichtungsregelung: Schritt (bei Mehrfachbelichtung wohl irrelevant)
Belichtungszeit

Alle anderen Felder sind ausgegraut.

Des weiteren ist die Detektormeßzeit über das Feld 'Detektor-Meßzeit' änderbar.

Die Einstellung kann vor oder während der Regelung erfolgen. Während der Regelung läuft für den Zeitraum der Dialogbox-Bearbeitung die Regelung normal weiter, wie z.B. die Meßzeit.

2.4   Start und Beendigung der Teilfunktion

Start: Die Dialogbox wird geöffnet

- über das Menü: Ausführen, Topographie ...

Beendigung: Die Dialogbox wird geschlossen:

- über den Button Abbrechen
- über den Windows-Button 'x'

3. Benutzerschnittstelle
3.1 Dialogbox 'Topographie'

DIALOGBOX:

3.1.1 Steuerung

- Die Dialogbox ist mausgesteuert
- darf das Feld bei Maussteuerung mit Return abgeschlossen werden?
- ?

3.1.2 Eingaben/Ausgaben und Prüfung

a) oberes Teilfenster (Nachrichtenfenster)
Dient der Ausgabe von Nachrichten, beschrieben in den einzelnen Funktionen.

b) Ausgabefeld: [Meßzeit: 00:00:00]
Ausgabe der Zeit seit Messungsbeginn in hh:mm:ss

c) Ausgabefeld: [Drift: 0.0]
-Topographie mit Einfachbelichtung
Ausgabe der Abweichung vom Arbeitspunkt in arcsec (?)
- Topographie mit Mehrfachbelichtung
Ausgabe der Drift vom Startpunkt des ersten Segmentes, bzws. von den Startpunkten in den Folgesegmenten.

d) Ausgabefeld: [Zusatz-Zeit: 00:00:00]
Ausgabe der über die aus 'Einstellungen, Topographie' in [Belichtungszeit] hinausgehenden Zeit. Bei Mehrfachbelichtung bezieht sie sich auf den letzten Zyklus. Bei den vorangegangenen Zyklen kann es keine Zusatzzeit geben.
Angabe in: hh:mm:ss

e) Ausgabefeld: [Restzyklen ...]
Ausgabe der Anzahl der noch ausstehenden Belichtungszyklen bei Mehrfachbelichtung. Gesamtzahl angegeben in 'Einstellungen, Topographie' in [Mehrfach-Belichtung; Anzahl].
Bei Einfachbelichtung sollte '1' angezeigt werden. Dies ist wohl nicht der Fall, siehe Pkt. 6.1, Fehler aus Nutzersicht.

f) Eingabefeld: [Detektor-Meßzeit: ...]
Vorab ist hier die Zeit aus 'Einstellungen, Topographie', [Detektorparameter: Zeit] angezeigt.
Während der Regelung kann diese Zeit geändert werden (Zeit in Sekunden).
- .ini-File: [Topographie],  ExposureTime
--> Defaultwert aus dem Programm?
- zulässiger Wertebereich: [-n, schrittweite, +n]
Priorität: ?

g) Aktionsschalter: [Startposition einstellen]
Zur Erläuterung siehe Pkt. 2.1 'Einstellen der Startposition'.
Wird der Arbeitspunkt von Hand eingestellt, wird dieser Aktionsschalter nicht benutzt.

h) Aktionsschalter: [Regelung starten/stoppen]
Zur Erläuterung siehe Pkt. 2.2 'Regelung starten und stoppen'.

i) Aktionsschalter: [Einstellungen]
Zur Erläuterung siehe Pkt. 2.3 'Einstellungen für die Topographie ändern'.

j) Aktionsschalter: [Abbrechen]
Schließen des Fensters und Abbruch der Regelung.

4. Daten
4.1 .ini-Datei

Die .ini-Datei speichert Vorabeinstellungen und übernimmt in der Dialogbox geänderte Werte.

Folgende Abschnitte und Parameter sind erforderlich:

[Topography]
ShotingTime
   Einfachbelichtung: Gesamtdauer der gewünschten Belichtung.
   Mehrfachbelichtung: Gesamtdauer der gewünschten Belichtung je Probensegment
   Bezugsfeld in der Dialogbox: Belichtungszeit
ExposureTime
   Detektormeßzeit: Zeitintervall, in welchem der Detektor die Impulsrate zählt.
  Bezugsfeld in der Dialogbox: ...
ExposureCounts
   ...
  Bezugsfeld in der Dialogbox: ...
Failure
   ...
  Bezugsfeld in der Dialogbox: ...
WorkPoint
   Arbeitspunkt
  Bezugsfeld in der Dialogbox: ...
MultibleShot
   Anzahl der Mehrfach-Belichtungen
  Bezugsfeld in der Dialogbox: ...
ControlStep
   ...
ControlRange
   ...

[Motor i]
Name=
   Name des Motors, in der Regel 'Beugung fein '
  Bezugsfeld in der Dialogbox: Actuator

[Device2]
Name=
   Name des Detektors
  Bezugsfeld in der Dialogbox: Detektor

4.2   standard.mak-Datei

Bei der Topographie mit Einfachbeleuchtung wird für die Detailsteuerung zum Anfahren des Arbeitspunktes das Makro aus standard.mak benutzt:

[Common]
# Makro: Einstellen des Arbeitspunkt
Name=SetupTopography
Length=4
[Commands]
GotoPeak
GotoIntensity SmallSide Interpolation 0.6
MoveToPoint     LastGoal
Stop
[End]

Es bewirkt das anfängliche Anfahren des Peaks und das anschließende Anfahren des Arbeitspunktes.

Bei der Topographie mit Mehrfachbeleuchtung wird wohl kein Makro benutzt???

5. Testfälle

Hier sind umfassende Testfälle zu spezifizieren, wie Kombinationen von Eingabewerten, die Reaktion
beim Abbrechen-Button oder die Ausgaben bei der Mehrfachbelichtung. Des weiteren ist zu testen, ob die Werte in das .ini-File übernommen werden.
 

6. Fehler und Änderungswünsche

Bei den Fehlern sind nur solche aus Nutzersicht zu dokumentieren. Fehler aus Entwicklersicht werden
im Web-Dokument 'Pflichtenheft, Systemfehler, Systemfehler aus Entwicklersicht, Topographie'
beschrieben.

6.1 Fehler aus Nutzersicht

Dokumentiert sind keine. Es gibt jedoch Fälle, wo Werte aus der Dialogbox nicht in die .ini-Datei
übernommen werden.

- Wird bei den Restzyklen anfangs immer der Wert aus dem Feld 'Mehrfach-Belichtung; Anzahl' angezeigt, auch wenn keine Mehrfachbelichtung erfolgen soll? Wenn ja, wäre hier der Wert '1' besser.

6.2 Änderungswünsche

- Das Eingabefeld: Detektor-Meßzeit kann entfallen. Sie ist einstellbar über den Button 'Einstellungen'.

7.0 Offene Fragen

???

(Beispiele hierfür siehe: Pflichtenheft zur 'Probe und Kollimator manuell einstellen'.)