Changeset c1446cd

Timestamp:

May 8, 2017, 2:00:28 PM (8 years ago)

Author:

Frederik Heber <frederik.heber@…>

Branches:

ForceAnnealing_goodresults, ForceAnnealing_tocheck

Children:

c8165c

Parents:

05a2c5

git-author:

Frederik Heber <heber@…> (03/23/17 17:11:07)

git-committer:

Frederik Heber <frederik.heber@…> (05/08/17 14:00:28)

Message:

DOCU: Added note on necessity of wait() to Python section.

File:

• doc/userguide/userguide.xml (modified) (1 diff)

doc/userguide/userguide.xml

@@ -2518 +2518 @@
       under the command-line interface and look up the function name via
       help.</para>
+      <para>You can freely mix calls to the pymolecuilder module and other python commands.</para>
+      <note>However, be aware that all Actions are executed in another thread,
+      i.e. run in parallel. That means that a pymolecuilder command is not 
+      necessarily finished when python steps on to the next line!</note>
+      <para>In order to make python wait for the Actions to finish before
+      stepping, there is the special wait() command.</para>
+      <programlisting>
+         mol.MoleculeLoad("...")
+         mol.wait()
+      </programlisting>
+      <para>This will continue first after the molecule has been fully loaded.
+      </para>
+      <warning>These wait()s will have no effect if the python script is loaded
+      via the "load-session" command inside a User Interface (command-line,
+      GUI, ...) as this would cause the queue to wait indefinitely, namely till
+      the load-session itself would have finished.</warning>
+      <para>Therefore, more complex python scripts need to be called with
+      python and a set PYTHONPATH as described above.</para>
     </section>
   </chapter>