Changeset 6469 for branches/1.7/lang

Timestamp:

Aug 7, 2016, 2:55:28 PM (8 years ago)

Author:

ldelgass

Message:

merge r6435 from trunk (run tools from Python)

Location:

branches/1.7

Files:

• . (modified) (1 prop)
• lang/python/Rappture/__init__.py (modified) (1 diff)
• lang/python/Rappture/python_api.rst (modified) (2 diffs)
• lang/python/Rappture/pyxml.py (modified) (1 diff)
• lang/python/Rappture/raptool.py (copied) (copied from trunk/lang/python/Rappture/raptool.py)

branches/1.7/lang/python/Rappture/__init__.py

@@ -10 +10 @@
 import Utils
 import encoding
+from raptool import Tool
 
 # encoding/decoding flags

branches/1.7/lang/python/Rappture/python_api.rst

@@ -257 +257 @@
 
 
+
+----------
+
+RUNNING RAPPTURE TOOLS FROM PYTHON
+----------------------------------
+
+If you want to write a Python program that runs Rappture tools, you can do it with the above API and
+the Rappture Tool class.  For example, to run a published tool named "complam":
+
+.. code-block:: python
+
+    import Rappture
+    io = Rappture.Tool("complam")
+
+    # Set input values for the Complam tool
+    material = io['input.group(tabs).group(Material)']
+    material['number(E1).current'] = E1 / 1e9
+    material['number(E2).current'] = E2 / 1e9
+
+    # run the tool
+    io.run()
+
+    # read the results
+    ex = io['output.number(Ex).current'].value
+    nu = io['output.number(nu).current'].value
+
 REFERENCE
 =========
@@ -272 +298 @@
 -------
 
-- node.close()
-    Writes out the XML.
+- node.close(status=0)
+    Sets the output status field and writes out the XML.
 
 Reading

branches/1.7/lang/python/Rappture/pyxml.py

@@ -79 +79 @@
         return elem.xml()
 
-    def close(self):
+    def close(self, status=0):
+        self.lib.result(status)
         result(self.lib)
+