Anleitungen für das Scripting in Molecular Workbench

Molecular Workbench bietet zahlreiche Möglichkeiten, mit Hilfe von Scripting eine Simulation zu beeinflussen. Anhand von mehreren Beispielen soll gezeigt werden, wie man von den Elementen, wie zum Beispiel Knöpfen und Schieberegler, die ja außerhalb der Simulationsfenster liegen, auf die Simulationsfenster zugreifen kann.
 
== Beispiel: States of Matter ==
Die Simulation "States of Matter" wird in Molecular Workbench mitgeliefert. Sie ist zu finden unter "Chemistry"- "States of matter" und dort die zweite Datei unter dem gleichen Namen.

[[Datei:Beispiel "States of Matter" in Molecular Workbench.png|right|300px]]

Um diese Simulation zu bedienen gibt es mehrere Bedienelemente unter dem Simulationsfenster.

Um die Scripte richtig zu verstehen, muss man auch wissen, welche Dateien zu der Simulation gehören:

[[Datei:Dateien zum Beispiel "States of Matter" in Molecular Workbench.png|150px]]

Die Datei <code>states of matter.cml</code> ist die Seite, die im wesentlichen eine HTML-Seite ist, die die Oberfläche der Arbeitsfläche darstellt. Das erkennt man an der Endung <code>cml</code>. Die Datei <code>states of matter$0.mml</code> ist aufgrund der Endung <code>mml</code> als eine Datei zu erkennen, die den Inhalt des Modell-Containers definiert. Der Bestandteil <code>$0</code> zeigt an, dass es die Datei ist, die in dem ersten Modell-Container bei Start geladen wird. Standardmäßig enthält der Name immer den Namen der <code>cml</code>-Datei. Die anderen Dateien mit der Endung <code>mml</code> sind ebenfalls Dateien für den Modell-Container, also andere Simulationsdateien, die aber erst über die Bedienelemente geladen werden.

Der Knöpfe werden mit mit ersten Modell-Container verbunden, indem in den Einstellungen des Knopfes "Customize button" unter "Select a model" den entsprechenden Modell-Container auswählt. In diesem Fall ist das <code><Molecular Workbench> states of mater$0.mml</code>.

[[Datei:Einstellungen Knopf "States of Matter" in Molecular Workbench.png|280px]]

Der Bestandteil <code><Molecular Workbench></code> zeigt an, um welche Art von Modell-Container es sich handelt, denn Molecular Workbench bietet ja verschiedene Arten an. Wie schon erwähnt steht <code>$0</code> für den ersten, wobei die Container verschiedener Art immer gemeinsam nummeriert werden.

Im Feld darunter wird angegeben, welche Art von Aktion durchgeführt werden soll. Das kann ein allgemeines Script (dann wählt man <code>Execute MW script</code>) sein oder eine spezielle Aktivitäten, die zum Beispiel Eigenschaften der Elemente im Modell-Container verändern kann.

Der eigentliche Befehl, der im Beispiel ausgeführt wird, steht unten im Bereich ''"Enter the script to be run when clicked"''. Bei einer Aktion zur Änderung von Eigenschaften, steht dann dort nichts.

Einfache Scripting-Befehle sind:
* <code>'''run'''</code> um die Simulation zu starten
* <code>'''stop'''</code> um die Simulation zu anzuhalten
* <code>'''reset silently'''</code> um ohne Nachfrage die Simulation zu anzuhalten und zurückzusetzen
* <code>'''load sm_liq.mml'''</code> um die Datei <code>sm_liq.mml</code> zu laden ''(siehe Dateien der Simulation!)''

Die Einstellungen zu dem Knopf (im Rahmen) sollten selbsterklärend sein.

Der Knopf "Start compression" enthält zwei Zeilen:
* <code>set obstacle[0].density 0.1;</code>
* <code>set obstacle[0].hy 0.2;</code>

Den Namen findet man beim gezeichneten Objekt, indem man rechts draufklickt und im Kontext-Menü "Properties" auswählt. Dort steht der Name im Feld "Index". "obstacle" heißt Hindernis. In dieser Zeichnung also der Stempel, der auf die Teilchen drückt. Außerdem sind dort spezifische Einstellungen zu dem Hindernis.

[[Datei:Eigenschaften Obstacle vor dem Script zu States of Matter.png|300px]]

Nach der Ausführung des Skriptes ändern sich zwei der Werte.

[[Datei:Eigenschaften Obstacle nach dem Script zu States of Matter.png|300px]]

Geändert hat sich die "Dichte" und der Wert bei "Vertical Force". Beide haben jeweils den Wert, den sie über das Skript zugewiesen bekommen haben.

Damit ist klar, dass die Skripte folgendes bedeuten:
* <code>set</code> legt den Wert neu fest.
* <code>obstacle[0]</code> bezeichnet das Objekt, dass verändert werden soll
* <code>.density</code> gibt den Wert an, der von dem Objekt verändert werden soll.
* <code>0.2</code> gibt den neuen Wert an
* <code>;</code> alles wird durch ein Semikolon abgeschlossen