\nF\u00fcr dieses Tutorial ben\u00f6tigen Sie die QmixElements Version v20191121 oder eine neuere Version. Wenn Sie noch eine \u00e4ltere Version verwenden, aktualisieren Sie bitte auf die aktuellste QmixElements Version.<\/p>\n
Aktuelle QmixElements Version<\/p>\n
F\u00fcr dieses Tutorial haben wir zwei Nemesys Niederdruck Spritzenpumpen mit 5 ml Glasspritzen \u2776<\/span> verwendet. Sie k\u00f6nnen das Tutorial auch gern mit anderen Nemesys Spritzenpumpen oder Spritzen durchf\u00fchren, m\u00fcssen aber dann ggf. die Flussraten anpassen. Damit w\u00e4hrend der Generierung der Flussprofile die Ventile automatisch geschaltet werden, aktivieren Sie die Ventilautomatik f\u00fcr beide Pumpen \u2777<\/span>. Als Einheit f\u00fcr die Flussrate konfigurieren Sie bitte ml\/min<\/strong> \u2778<\/span>.<\/p>\n Um berechnete Werte aus dem Script grafisch visualisieren zu k\u00f6nnen, erstellen Sie in der Liste der I\/O Kan\u00e4le einen virtuellen Kanal \u2779<\/span>. Ein virtueller Kanal ist ein I\/O Kanal, der f\u00fcr die Eingabe und Ausgabe von Werten verwendet werden kann.<\/p>\n Damit die generierten Flussprofile grafische in Echtzeit aufgezeichnet und visualisiert werden k\u00f6nnen, verwenden Sie den grafischen Logger und konfigurieren ihn entsprechend der Abbildung unten. Es soll von beiden Pumpen die aktuelle Flussrate und von dem virtuellen Kanal der aktuellen Wert angezeigt werden \u2776<\/span>. Als Log Intervall<\/strong> \u2777<\/span> stellen Sie einen Wert von 0,1 Sekunden ein. Jetzt k\u00f6nnen Sie mit der Programmierung des ersten Scripts starten.<\/p>\n Ziel dieses Scripts soll es sein, mit einer Pumpe ein Flussprofil in Form eines S\u00e4gezahns zu generieren und mit der zweiten Pumpe den Fluss der ersten Pumpe so zu erg\u00e4nzen, dass die Summe der beiden Fl\u00fcsse zu einem konstanten Fluss mit einer definierten Flussrate f\u00fchrt.<\/p>\n Den S\u00e4gezahn generieren Sie, indem Sie die Flussrate schrittweise in einem festen Intervall von 0 bis zur gew\u00fcnschten Zielflussrate erh\u00f6hen. D.h. f\u00fcr das Script lassen sich die folgenden Parameter identifizieren:<\/p>\n F\u00fcr diese Parameter legen Sie in Ihrem Script drei Variablen an. So k\u00f6nnen Sie die Parameter sp\u00e4ter schnell und einfach an einer Stelle \u00e4ndern, ohne st\u00e4ndig durch das komplette Script navigieren zu m\u00fcssen. F\u00fcr jede Variable vergeben Sie einen aussagekr\u00e4ftigen und eindeutigen Namen.<\/p>\n F\u00fcr den Gradient verwenden Sie 20 Schritte ($GradientSteps = 20<\/strong>) mit einer Dauer von je 100 Millisekunden ($StepDuration = 100<\/strong>). Die Aufl\u00f6sung von 100 ms ist f\u00fcr viele Anwendungen eine hinreichend schnelle Zeitbasis. Diese Werte k\u00f6nnen Sie sp\u00e4ter jederzeit \u00e4ndern. F\u00fcr die Zielflussrate k\u00f6nnen Sie einen festen Wert eingeben, oder Sie berechnen die Zielflussrate auf Basis der maximalen Flussrate der ersten Pumpe. Daf\u00fcr k\u00f6nnen Sie in das JavaScript Feld die Ger\u00e4teeigenschaft (Insert device property<\/strong>) f\u00fcr die maximale Flussrate der Pumpe einf\u00fcgen und f\u00fcr Berechnungen verwenden. In diesem Beispiel wollen wir mit einem Zehntel der Maximalflussrate dosieren und teilen diese deshalb einfach durch 10. Sie k\u00f6nnen aber auch gern andere Werte oder eigene Berechnungen verwenden.<\/p>\n $TargetFlow<\/strong> = $neMESYS_Low_Pressure_1.MaxFlow \/ 10<\/p>\n Um einen einzelnen S\u00e4gezahn zu erzeugen, ben\u00f6tigen Sie nun eine Z\u00e4hlschleife (Counting Loop<\/strong>) \u2776<\/span>. F\u00fcr eine Z\u00e4hlschleife k\u00f6nnen zwei Parameter konfiguriert werden: die Anzahl der Schleifendurchl\u00e4ufe (Loop Cycles<\/strong>) \u2777<\/span> und der Name der Variable, in die der Z\u00e4hlerwert f\u00fcr den aktuellen Schleifendurchlauf gespeichert wird \u2778<\/span>. Das Eingabfeld f\u00fcr die Loop Cycles \u2777<\/span> ist mit einem orangefarbenen V markiert, d.h. Sie k\u00f6nnen in diesem Eingabefeld Variablen verwenden. Sie k\u00f6nnen an dieser Stelle also einfach die vorher definierte Variable $GradientSteps<\/strong> eintragen.<\/p>\n Innerhalb der Schleife k\u00f6nnen Sie nun die Flussrate f\u00fcr die erste Pumpe berechnen und in einer Variablen speichern. Der Schleifenz\u00e4hler $i<\/strong> nimmt bei den 20 Schleifendurchl\u00e4ufen die Werte 0 \u2013 19 an. Die Flussrate k\u00f6nnen Sie deshalb mit der folgenden Formel berechnen:<\/p>\n \u2776<\/span> $Flow1<\/strong> = $TargetFlow \/ ($GradientSteps – 1) * $i<\/p>\n D.h. die Flussrate ist im ersten Schleifendurchlauf 0 und erreicht im letzten Durchlauf den Wert $TargetFlow<\/strong>. Die Summe der Flussraten beider Pumpen soll den Wert $TargetFlow<\/strong> ergeben. Deshalb k\u00f6nnen Sie in einer zweiten Variablen die Flussrate der zweiten Pumpe wie folgt berechnen:<\/p>\n \u2777<\/span> $Flow2<\/strong> = $TargetFlow – $Flow1<\/p>\n Diese beiden Werte k\u00f6nnen Sie nun verwenden, um mit der Funktion Generate Flow<\/strong> \u2776<\/span> die Dosierung der beiden Pumpen zu starten. Zur Konfiguration der Generate Flow Funktion w\u00e4hlen Sie einfach die entsprechende Pumpe aus und tragen im Feld Flow<\/strong> \u2777<\/span> den berechneten Wert $Flow1<\/strong> oder $Flow2<\/strong> ein. Wichtig ist, dass hier die Einheit f\u00fcr die Flussrate auf den gleichen Wert eingestellt wird, wie er f\u00fcr die Pumpe konfiguriert wurde \u2013 in diesem Fall ml\/min<\/strong> \u2778<\/span>. Die Checkbox Run to completion<\/strong> \u2779<\/span> m\u00fcssen Sie deaktivieren. Ist dieses Feld aktiv, dann wird die n\u00e4chste Funktion erst gestartet, wenn die Pumpe die Dosierung beendet hat. Im Fall der Generate Flow Funktion w\u00e4re das dann, wenn die Pumpe vollst\u00e4ndig aufgezogen oder vollst\u00e4ndig entleert ist. Da dies hier nicht erw\u00fcnscht ist, sondern das Script sofort fortgesetzt werden soll, deaktivieren Sie das Feld.<\/p>\n Um die gew\u00fcnschte Schrittdauer f\u00fcr jeden Schleifendurchlauf zu erreichen, f\u00fcgen Sie nun noch eine Delay<\/strong> Funktion \u2776<\/span> als letzte Funktion in die Schleife ein. Im Konfigurationsbereich der Funktion im Eingabefeld Milliseconds<\/strong> \u2777<\/span> k\u00f6nnen Sie direkt die Variable $StepDuratio<\/strong>n eintragen. Die Delay Funktion verz\u00f6gert die weitere Scriptausf\u00fchrung f\u00fcr die konfigurierte Zeitdauer.<\/p>\n Am Ende Ihres kurzen Scripts f\u00fcgen Sie jetzt die Funktion Stop All Pumps<\/strong> \u2776<\/span> ein, um alle Pumpen zu stoppen. Um die Aufzeichnung der Flussraten im grafischen Logger mit dem Scriptablauf zu synchronisieren, f\u00fcgen Sie anschlie\u00dfend noch die Funktion zum Start des Loggers (Start Plot Logger<\/strong>) \u2777<\/span> vor der Z\u00e4hlschleife ein und die Funktion zum Stoppen der Aufzeichnung (Stop Plot Logger<\/strong>) \u2778<\/span> am Ende des Scripts.<\/p>\n Wenn Sie Ihre Spritzen komplett gef\u00fcllt haben, k\u00f6nnen Sie jetzt den ersten Testlauf starten. Wenn das Script fehlerfrei durchgelaufen ist, sollten Sie im grafischen Logger das folgende Bild sehen.<\/p>\n Im n\u00e4chsten Schritt erweitern Sie das Script so, dass die Erzeugung des S\u00e4gezahns zyklisch wiederholt wird, bis der Anwender die Taste Request Script Stop<\/strong> \u2776<\/strong><\/span> dr\u00fcckt. F\u00fcgen Sie daf\u00fcr eine anfangsgepr\u00fcfte Schleife (Conditional Loop<\/strong>) \u2777<\/span> vor die S\u00e4gezahnschleife ein. Wechseln Sie im Konfigurationsbereich der Funktion in den JavaScript Bereich \u2778<\/span> und geben Sie dort folgende Bedingung ein:<\/p>\n \u2779<\/span> $StopRequested<\/strong> == false<\/p>\n Das bedeutet, diese Schleife wird st\u00e4ndig wiederholt, so lange die Bedingung erf\u00fcllt ist, d.h. so lange die globale Variable $StopRequested<\/strong> den Wert false hat. Die Variable $StopRequested<\/strong> ist eine globale Scriptvariable die immer vorhanden ist. Nach dem Start des Scripts hat diese Variable stets den Wert false. Erst wenn der Anwender die Schaltfl\u00e4che Request Script Stop<\/strong> \u2776<\/span> dr\u00fcckt, wird der Wert der Variable auf true gesetzt.<\/p>\n Jetzt k\u00f6nnen Sie die S\u00e4gezahnschleife in den Conditional Loop einf\u00fcgen. Klicken Sie daf\u00fcr die Z\u00e4hlschleife (Counting Loop<\/strong>) \u277a<\/span> an und ziehen Sie diese auf den Conditional Loop<\/strong> \u2777<\/span>. Die Z\u00e4hlschleife wird damit in den Conditional Loop eingef\u00fcgt. Starten Sie das Script nun erneut. Die Erzeugung des S\u00e4gezahns wird jetzt so lange wiederholt, bis Sie die Schaltfl\u00e4che Request Script Stop<\/strong> \u2776<\/span> dr\u00fccken.<\/p>\n Dr\u00fccken Sie nach einigen Zyklen die Request Script Stop<\/strong> \u2776<\/span> Schaltfl\u00e4che um das Script zu beenden. Wenn das Script fehlerfrei durchgelaufen ist, sollten Sie im grafischen Logger das folgende Bild sehen.<\/p>\n Damit ist Ihr Flussprofil Script fast fertig. Um die \u00dcbersichtlichkeit noch ein wenig zu verbessern, k\u00f6nnen Sie die Variablen, die Sie am Anfang des Scriptes deklariert haben, in einer Variablengruppe (Variable Declarations<\/strong>) zusammenfassen. F\u00fcgen Sie daf\u00fcr eine Variable Declarations<\/strong> Funktion als erste Funktion in das Script ein. Markieren Sie anschlie\u00dfend alle Variablen. Klicken Sie daf\u00fcr die erste Create Variable<\/strong> Funktion an und klicken Sie dann mit gedr\u00fcckter Umschalttaste auf die letzte Create Variable<\/strong> Funktion – so wie Sie auch mehrere Dateien im Dateiexplorer markieren w\u00fcrden.<\/p>\n Anschlie\u00dfend k\u00f6nnen Sie alle markierten Variablen mit der Maus in die Variablengruppe verschieben. Damit haben Sie die Variablen gruppiert und die \u00dcbersichtlichkeit und Lesbarkeit des Scripts verbessert. Au\u00dferdem ist es nun leichter, diese Gruppe von Variablen an eine andere Position zu verschieben. Ihr Script sollte nun so aussehen:<\/p>\n Im zweiten Teil des Tutorials erfahren Sie, wie Sie das Script so \u00e4ndern, dass mit Hilfe von JavaScript Funktionen sinusf\u00f6rmige Flussprofile erzeugt werden k\u00f6nnen. Zus\u00e4tzlich erweitern Sie das Script um eine Initialisierungsroutine, welche die Spritzen aufzieht und lernen, wie Sie berechnete Werte mit Hilfe von virtuellen I\/O Kan\u00e4len im grafischen Logger aufzeichnen k\u00f6nnen. Abschlie\u00dfend erhalten Sie dann noch Tipps, welche M\u00f6glichkeiten es gibt, die Lesbarkeit Ihres Scriptes zu verbessern und Ihr Script zu dokumentieren.<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_Configuration.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_Loggerconfig.png\")
<\/h3>\nTeil 1 – Script zur Generierung eines S\u00e4gezahnprofils<\/h3>\n
![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/sawtooth_function.png\")
<\/p>\n\n
![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_Variables.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_CountingLoop.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_FlowVariables.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_GenerateFlow.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_Delay.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_FirstTestRun.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_FirstTestRun_Graph.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_ConditionalLoop.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_GraphLog.png\")
<\/p>\n![\"\"](\"https:\/\/cetoni.de\/wp-content\/uploads\/Flowprofile_FinalSawtoothScript-1.png\")
<\/p>\n