(last updated 6-June-2016)
Barracuda Virtual Reactor (BVR) Tools for EnSight
We here at CEI have written some tools to help with various tasks/capabilities with regards to post processing, analyzing, and communicating results from Barracuda in EnSight. These "tools" are meant to be provide additional functionality, or expose additional capability that EnSight can leverage with Barracuda data.
All of the tools documented here will appear in the User Defined Tools (UDT) menu. However to provide easier access to them we have also created a toolbar which places the tools directly into the main GUI providing quicker access. To activate the toolbar, launch the BVR Toolbar tool from the UDT menu. The toolbar must be launched once each time you start EnSight.
A new toolbar should appear in the main EnSight GUI:
Filtering Particles by Species
We've one new tool to make it easier to do analysis on different particle species. This tool will create an isovolume of each species which is useful if you want to perform calculations on only one species (or several species). For example if you want to count the number of particles of a species you can select the isovolume of that species and use the calculator function NodeCount.
If you only want to view the different species visually we suggest you simply color the particles by the Species variable because creating isovolumes is more computationally intensive.
Quick View Settings Tools
We've added 4 new tools to the BVR Tool collection for setting the views of your data:
(a) Quick View Cells. This shows only the fluid cells in border representation, with all other parts visibility turned off.
(b) Quick View Particles. This shows the particles, and makes the fluid cells grey and semi-transparent.
(c) Quick View Solid. Creates an IsoVolume of the particle volume fraction > 0.45, representing the solidified region.
(d) Quick View Spheres. This shows the particles as spheres (rather than default dots), and sizes them based on the "SIZE" variable, with a scale factor of 2. In most cases this will show the particles at a convenient viewing size that is many times larger than their true physical size.
The first three Quick View tools correspond to View Results buttons in Barracuda. Quick View Cells is for View Cell Data and View Average Cell Data. Quick View Particles is for most views under View Particle Data. Quick View Solid is for Particle Solid Region under View Particle Data. After executing one of these tools the user can color the parts by the desired variable.
Thick Clip for Particle Clips (via BOX Tool)
We've added in the "Thick Clip" tool for creating particle clips. This method isolates the Particles based on the user specification of either the X, Y, or Z location, with a location and thickness. All Particles within this range will be created as a new part. This effectively uses EnSight's "Box" tool, and an "inside" clip. Particles within the box are clipped and a new Part is created. The original Particle part remains unchanged, but simply its visibility is turned off.
There is a alternative method which uses the "Auxiliary Clip" which is another way to perform a similar type of visual. You can find instructions here.
Tools for Importing Historical/Iterational information into EnSight
We have written two rather simple Python utilities to convert text based historical/iterational information into EnSight and stored as Queries. Typically, this information is something like Temperature at a monitoring location/set over time, or some quantity which the solver has boiled down to a single number (Phase value) over time. So far, these files come in two "flavors", denoted as a "trans.data00" type of file, or a "flux_?" type of file. Both files are very similar, but require slightly different parsing/handling. The data in these files is 0D information versus time, or what EnSight would term a "query". So, this python utility converts these files into EnSight and stores them as "Queries". Once as Queries, the user can create plots vs. time within EnSight, overlay multiple queries together, operate between queries, or simply include the values into the 3D Domain post processing, analysis, and visualization of the results.
Instructions to install the tools are provided at the bottom of this page.
Once installed, you should see a "BVR Tool" entry in your User Defined Tool area, currently with two tools.
1. Double click on the Tool in the UserDefinedTool area to open
2. You will presented with a dialog box, allowing you to specify which trans.data00 file to read in (or what FLUX_? file)
3. After clicking "OK", the utility will internally convert the 0D data in the file, and pass this information to the Queries in EnSight. The Queries should all take their labels from the file, along with X-axis, Y-axis, title, and unit declaration. You should now see a series of Queries like:
4. You now have populated a series of queries in EnSight, and can now operate on them like any other query in EnSight. Plot them, compare them, operate between then, display them, save them, quantify them, discover them:
Converting to EnSight Case Gold Format
Another tool is provided which exports the currently-loaded GMV data into EnSight format. Conversion of the full dataset could take minutes to hours depending on your hardware and the size of your data. After conversion you can load the new .case file instead of the gmv files.
Convert to Case Format
Converting your data has several advantages:
1. Much faster to step through time. EnSight should be at least five times faster when changing time steps.
2. Allows calculating transient statistics. The calculator functions TempMean and TempMinMaxField cannot be used on Barracuda GMV data as it is read into EnSight, but after conversion with this tool they can be used.
3. Default variable palette ranges will be correct, using the true min and max values of the variable instead of always including zero in the range.
To convert the data, follow these steps (also shown when you run the tool).
1. Load your GMV data.
1. Load your GMV data.
2. Delete any parts you don't want (you must keep the particles and at least one volume part)
3. Activate variables you want. Deactivate variables you don't want. (you must have at least one particles variable and one mesh variable)
4. Run the tool.
5. Load the new .case file.
Technical details. This tool is hopefully a temporary solution until changes can be implemented in the Barracuda reader. The tool is currently necessary because EnSight reads in GMV data as having changing connectivity geometry, meaning the numbers of nodes and elements and how they are connected can change every time step. However in Barracuda only the numbers of particles actually changes; the mesh does not. The tool creates an EnSight case file which uses static geometry with measured data for particles, resulting in the faster performance and allowed calculations mentioned above. In the future, EnSight could read GMV data in the same way, eliminating the need for this tool.
The BVR (Barracuda Virtual Reactor) Tools utilize the newly available "Package Manager" in EnSight. This is available in EnSight 10.0, as well as EnSight 10.1. To download and install these tools, simply follow the steps:
a. Open the UserDefinedTool box, and navigate to the Utilities folder. Double click on the "Package Manager" utility:
b. Within the Package Manager utility, select the "BVR Toolset" package, and click on the "Install Package":
c. You will be prompted to install the utility in either your Installation Directory (CEI_HOME), or you User Preferences Directory. Once done, follow instructions to restart EnSight to pick up newly available tools.
When updates for the tools have been made, this Package Manager will change the "Status" accordingly, so that you will have the option to update.
Should you have any questions, please feel free to contact CEI (firstname.lastname@example.org)