Information/Instructions/LLNL/rtrt
From C-SAFE Wiki
Contents |
Visualizing data with RTRT @ LLNL
These instructions specify how to launch RTRT on a LLNL computer. If you are looking for information on how to use RTRT in general, look here.
You will be tunneling the RTRT X11 display back to your machine. (The -Y tunnels X through ssh, and -C compresses the data which can improve framerate.)
- ssh -C -Y -p 922 user@zeus.llnl.gov
Common gotchas
- Make sure that if you are logging in from a Mac, that you are using an Xterm (not terminal).
- Once you have first logged into zeus, type "echo $DISPLAY". It should say something like: zeus287:100.0. If it doesn't then there is some problem... send Dav an email.
- To verify that X tunneling is working, try typing "xclock" and see if it shows up on your machine.
batchxterm command
Determine where you want to run RTRT. You can run on the login node, but this will cause contention with other users and is not suggested. It is better to use a compute node. You can try either a compute node from the debug pool or from the batch pool.
- Use the command ju to see how many nodes are available.
- Debug pool:
- In the below command, the 1 represents the number of nodes (Note, you can only use 1 node with RTRT. Each node has 8 processors.), and the 10 is the number of minutes the nodes have been requested for. Zeus is the name of the machine, and the "-p pdebug" tells which queue to use.
- batchxterm $DISPLAY zeus 1 10 "-p pdebug"
- Batch pool:
- batchxterm $DISPLAY zeus 1 10
Running RTRT
- Wait for your batch xterm to pop up on your screen, and then go to the location of the RTRT executable:
- cd /g/g15/dav/SVN/SCIRun/rtrtZeus64opt/Packages/rtrt/StandAlone
- rtrt -np 8 -scene scenes/0
- Uintah scene example:
- rtrt -np 7 -scene scenes/uintahparticle2 /p/lscratchb/vanrij1/Study01/HTContainer_arches_mpmice.uda.013 -timestep 8 -radius 0.00025 -dpyconfig configfile
From your own directory
In order to save images without possible conflicts with those in the rtrt build directory, you may want to run from your own directory. To do so, follow these instructions: (NOTE: you must put the '.mo' at the end of the scene file!)
- setenv RTRT_PATH /g/g15/dav/SVN/SCIRun/rtrtZeus64opt/Packages/rtrt/StandAlone
- cd some_directory_you_own # A directory that has an 'images' and 'movies' subdirectory.
- $RTRT_PATH/rtrt -scene $RTRT_PATH/scenes/0.mo
RTRT GUI Interaction
For more information on using the RTRT application, including GUI and Keyboard commands, go here.
Caveats
- Particle coloring GUI does not work.
- You must be in the 'uintah' unix group.
- If you are having troubles viewing Uintah data, try running with scene 0 to verify that rtrt is working.
- If scene 0 works, but the uintah scene does not display data, make sure that you have a big enough radius for your particles.
- Try pressing 'v' to change the viewpoint to a better location.
- Press 't' to see if the particles are there, but are just not showing up.
Config File
Because the particle GUI does not work from Zeus over ssh, you can specify how to view the data in a config file. Below is an example file that works for the above reference UDA. The config file contains information from 7 variables. (If you need to create your own config file, you can get the information you need from the outpu of rtrt. As can be seen below, rtrt is using 7 variables, with min/max ranges as shown. This information is put directly into the config file. In the example config file below, the 7 at the top means there are 7 variables, the 5 means to color the data by the 5th (0 indexed) variable (in this case - temperature). Then each variable has 4 sets of numbers. For the most part they will all be the same and be the min/max values. However, in the example below, we decided to clip the 'x' variable (so that we could see into the middle of the container). Thus the last (4th) line was changed from min/max to 0/max.
RTRT Output
x min[0] = -0.0612472, max[0] = 0.0649375
y min[1] = -0.0664116, max[1] = 0.0597545
z min[2] = -0.0706093, max[2] = 0.0704039
p.particleID min[3] = 1.15407e+17, max[3] = 1.54532e+17
p.mass min[4] = 1.64349e-10, max[4] = 9.7875e-07
p.temperature min[5] = 305.892, max[5] = 567.872
p.velocity length min[6] = 0.0186925, max[6] = 380.833
Example Config File
7
5
-0.0625886 0.0665135
-0.0625886 0.0665135
-0.0625886 0.0665135
0.0 0.0665135
-0.0678372 0.0613471
-0.0678372 0.0613471
-0.0678372 0.0613471
-0.0678372 0.0613471
-0.0705829 0.0703353
-0.0705829 0.0703353
-0.0705829 0.0703353
-0.0705829 0.0703353
1.15407e+17 1.54532e+17
1.15407e+17 1.54532e+17
1.15407e+17 1.54532e+17
1.15407e+17 1.54532e+17
3.12744e-12 9.7875e-07
3.12744e-12 9.7875e-07
3.12744e-12 9.7875e-07
3.12744e-12 9.7875e-07
305.878 629.223
305.878 629.223
305.878 629.223
305.878 629.223
0.00458128 346.362
0.00458128 346.362
0.00458128 346.362
0.00458128 346.362
Back to: Main:Information:Instructions:LLNL
