Running Puffin on Vhub

Version
by (unknown)
Version 6
by (unknown)

Deletions or items before changed

Additions or items after changed

1 -
 
+
==Introduction==
2 +
3 +
Puffin is a coupling of the programs Puffin (also known as Bent) and
4 +
Puff. Puffin is a theoretical model of a volcanic plume based on applying the equations of
5 +
motion in a plume-centered coordinate system.
6 +
Puff simulates the transport, dispersion and sedimentation of volcanic ash.
7 +
Puff also prepares some scripts to turn the cdf files generated into images.
8 +
ImageMagick then creates an animated gif using these images,
9 +
so we can see how ash spreads over time.
10 +
11 +
==Required Preparations==
12 +
13 +
The tools we use require large databases, too large to be stored on Vhub.
14 +
For this reason, you will need to mount onto the irods database in order to be able to run Puffin.
15 +
Additionally, for large runs you have the option of sending larger jobs to the cluster.
16 +
17 +
First of all, you need to join the '''network''' group. By default, the hub does not allow outgoing network access. You will need to request an administrator to be added, and then it may take an hour for access to be granted.
18 +
19 +
To set up irods, look up the topics page for [http://vhub.org/topics/iRodsforHUBs installing irods]
20 +
to get details on how to set up irods.
21 +
For the purposes of running Puffin, I recommend having the irods directory be in your home directory
22 +
and to stay logged in as the public user.
23 +
All necessary databases are in the public folder.
24 +
25 +
==Example Run==
26 +
27 +
When you start Puffin, most of the entries will start out as filled.
28 +
The only entries you may need to change for a test run are the locations of the reanalysis
29 +
databases on the Database tab.
30 +
If you set up irods to be in your home directory, it will automatically set up the locations
31 +
in the gui.
32 +
33 +
In order to run the test run, you just need to press the three buttons on the '''run''' tab in order.
34 +
The first button runs puffin, which fills out some information about the plume on the puff input tab.
35 +
The second button runs puff, which will create the cdf files representing the ashes.
36 +
The third button creates the animations, which will then display on the '''output''' tab.
37 +
You can view these various animations by clicking the buttons on the bottom of the output tab.
38 +
39 +
The prepared run simulates a volcanic plume in Iceland.
40 +
The sample runs only 10000 particles over a 72 hour period, so it runs rather quickly.
41 +
Running puffin should take less than a minute.
42 +
Running puff should take less than five minutes.
43 +
Creating the animations should take less than a minute.
44 +
45 +
Discussing each tab in more detail:
46 +
47 +
===Puffin Input===
48 +
49 +
[[Image(TabPuffin.png)]]
50 +
51 +
All the entries here are pretty self expanatory.
52 +
53 +
If you have the .inp from a previous run, you can load the information from a previous run.
54 +
Just select the .inp file, and press load.
55 +
All relevant entries will be updated.
56 +
57 +
===More Puffin Input===
58 +
59 +
[[Image(TabPuffinMore.png)]]
60 +
61 +
In order to simulate how the ash will move up into the atmosphere,
62 +
you need to give information about the air conditions, given by a weather balloon file.
63 +
If you have one already, just mark in where the file is, what are the relevant columns,
64 +
and what the relevant columns represent.
65 +
If you do not have one, select generate weather file in order to automatically generate one
66 +
from the databases.
67 +
Note that this requires all 3 databases from the database tab to be filled out.
68 +
69 +
Additionally, you have the choice to specify the mean and standard diviation, or just
70 +
select grain random.
71 +
72 +
===Puff Input===
73 +
74 +
[[Image(TabPuff.png)]]
75 +
76 +
First of all, having ash output selected is very important.
77 +
With no intermediary ash outputs, no images can be made for the animation.
78 +
79 +
Second, the more particles you simulate, the more computation time the program will take.
80 +
Because of this, you are limited in how many particles you can simulation.
81 +
If running locally, you are capped at 100,000.
82 +
If you submit to the u2-grid, you are capped at 10,000,000.
83 +
84 +
Also, note that the bottom six entries will be filled out by running puffin.
85 +
You do not need to fill them out yourself if you are doing a full run through.
86 +
87 +
===Databases===
88 +
89 +
[[Image(TabDatabases.png)]]
90 +
91 +
There are three databases that may need to be set up.
92 +
93 +
The wind u and wind v databases (which is in miles per hour) are needed to run puff.
94 +
95 +
The temperature database (which is in Celcius) is only needed for generating a weather balloon file for puffin.
96 +
97 +
98 +
For each database you need to set:
99 +
100 +
* MODEL- The name of the model you are using.
101 +
102 +
* DIR- The directory where your nc file is.
103 +
104 +
* MASK- The filenames of the data files. YYYY represents where the year would go.
105 +
106 +
* VARUNAME- The name of variable within the nc file that we use. This can be found by running `ncdump -h` on the file.
107 +
108 +
The irods username is only needed for remote runs. The Irods username is used to
109 +
convert the directory paths of an irods mount into the directory paths on
110 +
the cluster.
111 +
112 +
===Image Properties===
113 +
114 +
[[Image(TabImage.png)]]
115 +
116 +
The images to output button selects which images to create.
117 +
Warning: Ashgmt currently requires some files that are not on Vhub.
118 +
Ashgmt will not be able to create an image.
119 +
120 +
121 +
===Run===
122 +
123 +
[[Image(TabRun.png)]]
124 +
125 +
First of all, you specify where you want to output in the output folder,
126 +
and whether you want to create a new folder to keep the information in with run name.
127 +
Every time puffin run, a new folder will be created based on the current time.
128 +
129 +
Normally, you will want to press run puffin, then run puff, then make animations.
130 +
131 +
You have the option to send the job to the cluster.
132 +
Puffin runs (when you hit the first button) will always be done locally. You can send Puff runs (second button) and the animation runs (third button) to the cluster.
133 +
134 +
===Output===
135 +
136 +
[[Image(TabOutput.png)]]
137 +
138 +
If successful, there will be images on the output tab after make animations is run.
139 +
Click the thumbnails on the bottom in order to cycle through the images made.
140 +
141 +
==Run Time==
142 +
143 +
Running Puffin should take seconds, even if you are outputting the plume information.
144 +
145 +
If you generate a weather balloon file, it will take considerably longer because it has to load the databases. The entire calcuation should take on the order of 4 minutes.
146 +
147 +
148 +
Running Puff is much more computationally intensive, and takes time dependent on how many particles you want to simulate over how much time. You are restricted to only using 100,000 particles locally and 10,000,000 on the hub. Running locally, loading the databases takes about 2 minutes and most computations will take at most 2 minutes. From running several runs, here is a graph of how much time you can expect your runs to take.
149 +
150 +
[[Image(submitlocal.png)]]
151 +
152 +
When you submit puff to u2, since databases don't have to be loaded the run will be a lot faster. However, often you will have to wait a couple minutes before your job is queued onto the server. As a result, runs on u2 tend to take just as long as local runs. Here is a graph of the computation time for some larger runs (but note that the time to queue is not included).
153 +
154 +
[[Image(submit.png)]]
155 +
156 +
157 +
Creating the animations should also take on the order of a minute.