This directory contains files you will need to create a 3D visualization of clouds over SE China like the movie shown at [https://zenodo.org/records/14523263](https://zenodo.org/records/14523263).

## NetCDF files 

- E3SMv2 history output file: `v2_F2010_nc00_inst_6hr.eam.h0.2010-02-28-00000.nc`
- Connectivity file for the `ne30pg2` grid: `TEMPEST_ne30pg2.scrip.renamed.nc`

## How to use these files in ParaView

##### Step 1: Download a ParaView binary from [Kitware](https://www.paraview.org/download/)
##### Step 2: Start ParaView and load plugins

1. Start the ParaView GUI.
2. In the menu bar, go to "Tools" -> "Manage Plugins ..."
3. In the pop-up window titled "Plugin Manager", click on "Load New ..." near the bottom left corner.
4. In the new "Load Plugin" window, locate `eam_reader.py`; select it and click on "OK".
5. [Optional] After the "Plugin Manager" window shows a "Loaded" for "eam_reader", you might want to click on the right arrow (`>`) to the left of the reader and then, in the unfolded menu, check the box for "Auto Load" so that the reader will automatically get loaded the next time you start ParaView.
6. Repeat steps 3--5 to load `eam_filters.py`.
7. When you are back in the "Plugin Manager" window, click on "Close" in the bottom right corner.

##### Step 3: Load a state file

1. In ParaView's menu bar, go to "File" -> "Load State".
2. In the new "Load State File" window, locate the `.pvsm` (state) file and then click on "OK".
3. In the new "Load State Options" window, use the drop-down menu to select "Choose File Names".    For "Connectivity File", choose the `TEMPEST_ne30pg2.scrip.renamed.nc` included here. For "Data File", choose the E3SM history output file listed above. After you are back in the "Load State Options" window, click on "OK". 
4. Wait for a second or two, and ParaView should show three render views with dark blue/gray background in its main window. You will probably get an "Output Messages" window with some error messages, but these should be okay, and you can close that "Output Messages" window.
5. The EAM Reader has a small unresolved issue that when a state file is loaded, the data will *not* be loaded automatically. To manually load data from the `.nc` file, go to ParaView's "Pipeline Browser", select the data source, then look for variable lists in the "Properties" window. Check the box to the left of one of the variables, say "cnd01_CCN3_ACTDIAG01", then the "Apply" button in the "Properties" window should turn blue. Click on the "Apply" button and wait for a couple of seconds. Hopefully, you will see the E3SM variables shown in colors in the render view windows.

##### POC

- Hui Wan (PNNL, hui.wan@pnnl.gov)
- Abhishek Yenpure (Kitware, abhi.yenpure@kitware.com)