From 1e1e2f94e863f1f326ee5697c3e8c14a7bcf8b5a Mon Sep 17 00:00:00 2001
From: Mark Berrill <berrillma@ornl.gov>
Date: Thu, 17 Jul 2014 09:42:51 -0400
Subject: [PATCH] Adding example for visualization

---
 README.visit | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 README.visit

diff --git a/README.visit b/README.visit
new file mode 100644
index 00000000..8b104b13
--- /dev/null
+++ b/README.visit
@@ -0,0 +1,58 @@
+To compile the visit plug-in and run in parallel on computational back-end:
+
+Checkout code and create a cmake script to compile plug-in.
+Example commands for Rhea:
+
+Load the proper modules
+   module load visit
+   module load cmake
+
+Configure cmake to build the plug-in
+    cmake                                        \
+        -D CMAKE_BUILD_TYPE:STRING=Release       \
+        -D CMAKE_C_COMPILER:PATH=gcc             \
+        -D CMAKE_CXX_COMPILER:PATH=g++           \
+        -D USE_MPI=FALSE                         \
+        -D USE_CUDA=FALSE                        \
+        -D USE_VISIT=TRUE                        \
+            -D VISIT_ROOT_DIR=/sw/rhea/visit     \
+        ../../LBPM-WIA
+
+Build the visit plug-in
+    make visit
+
+Check that the visit plug-in installed in ~/.visit/2.7.1/linux-x86_64/plugins/databases
+It should have created several shared libraries:
+    libELBMDatabase_par.so  libELBMDatabase_ser.so  libILBMDatabase.so  libMLBMDatabase.so
+
+Install visit on local machine (2.7.3)
+
+Start visit on local machine
+
+First time:
+    Go to: Options - Host profiles
+    Click Remote Profiles - Update
+    After list populates, drag host_ornl_rhea.xml to Hosts
+    Select ORNL_Rhea from Hosts, click on Machines
+    Set account username
+    Click on Launch Profiles tab
+    Change profile name and timeout if desired
+    Click on Parallel tab
+    Add Default Bank / Account with project number, set default nodes/processors if desired
+    Click Apply, then close window
+    Go to: Options - Save Settings
+
+Open remote file / launch parallel job
+    Click Open file
+    Change Host to ORNL_Rhea, enter passcode when prompted
+    Open visualization file
+        /lustre/atlas/proj-shared/geo106/vis_test/dumps.LBM
+    New window will open prompting for # of nodes, processors, Bank (project number) and time limit
+        Rhea as 16 physical-cores/node and 64 GB/node
+        for example file above I used 1 node, 16 cores
+    Visit will call qsub and submit a parallel job that will start when ready
+
+Visualize desired quantities
+
+
+