website: misc edits

Author: huiwanpnnl

docs/.vitepress/config.mjs

@@ -47,10 +47,10 @@ export default defineConfig({
         {
           text: "Introduction",
           items: [
-            { text: "Key Reminders", link: "/guides/reminders" },
+            { text: "Key Reminders",      link: "/guides/reminders" },
             { text: "Connecitiviy Files", link: "/guides/connectivity" },
-            { text: "Data Format", link: "/guides/data" },
-            { text: "Installation", link: "/guides/installation" },
+            { text: "Simulation Files",   link: "/guides/data" },
+            { text: "Installation",       link: "/guides/installation" },
           ],
         },
         {

docs/guides/connectivity.md

@@ -1,12 +1,5 @@
 # Connectivity files
 
-::: tip Connecitivity File Download
-
-A collection of connectivity files can
-be found on [Zenodo](https://doi.org/10.5281/zenodo.16908566). The archive is
-continually updated as more users inform us about the grids use.
-:::
-
 The horizontal grids used by E3SM's atmosphere component EAM, and sometimes the
 land component ELM as well, are cubed spheres. Since these are unstructed
 grids from ParaView's perspective, QuickView needs to know how to map data to the globe.
@@ -26,6 +19,13 @@ Future versions of QuickView will also support the cubed-sphere meshes used by
 EAM's dynamical core, i.e., the `ne*np4` grids (also referred to as "native
 grids" or "GLL grids").
 
+## Connecitivity file download
+
+A collection of connectivity files can
+be found on [Zenodo](https://doi.org/10.5281/zenodo.16908566). The archive is
+continually updated as more users inform us about the grids use.
+
+
 ## Generating connectivity files
 
 Users can generate connectivity files with

docs/guides/data.md

@@ -1,36 +1,11 @@
-# Data
+# Simulation Files 
 
-QuickView has been developed using EAM's history output on the physics grids
-(`pg2` grids) written by EAMv2, v3, and an intermediate version towards v4
-(EAMxx). Those sample output files can be found on
+The QuickView family of tools has been developed using history output
+on the physics grids (`pg2` grids) of the E3SM Atmosphere Model, EAM,
+generated using EAMv2, v3, and intermediate versions towards v4
+(EAMxx). Sample output files can be found on
 [Zenodo](https://zenodo.org/records/16922607).
 
-Developers and users of EAM often use tools like NCO and CDO or write their own
-scripts to calculate time averages and/or select a subset of variables from the
-original model output. For those use cases, we clarify below the features of the
-data format that QuickView expects in order to properly read and visualize the
-simulation data.
-
-::: tip Tip: Consistency Between Simulation File and Connecitivity File One of
-the repeatedly encountered causes of error when loading files in QuickView is
-that the grid described by the connecitivity file does not match the grid in the
-simulation data file.
-:::
-
-::: warning Caution: Newer EAMxx Output Files The EAMxx output file that
-QuickView has been tested for was generated in late 2024. As EAMxx further
-evolves and its output format changes, QuickView might need to be updated
-accordingly. If the user encounters such a case, we recommend reaching out to
-our developers or using the
-[Issue tab on GitHub](https://github.com/Kitware/QuickView/issues) to start a
-discussion.
-:::
-
-## Overview
-
-The ParaView Reader behind the QuickView GUI detects and categorizes variables
-based on their dimensions. Variables with dimensions not matching the expected
-patterns are ignored.
 
 ## 2D variables
 

docs/guides/reminders.md

@@ -1,21 +1,27 @@
 # Key reminders for using QuickView and other tools in the family
 
-::: info Two modes of use
+::: warning Two modes of use
 QuickView can be used in two modes:
 a *new-viz* mode (for starting a new visualization) or
 a *resume* mode (for resuming an analysis). Further details can be found on
 the [toolbar description page](/guides/quickview/toolbar.md).
 :::
 
-::: warning Connectivity Files
+::: info Connectivity files
 Since E3SM's horizontal grids are unstructured meshes from ParaView's perspective,
 connectivity files are needed in addition to  the simulation data files.
 Further details can be found on the documentation pages
 describing the [connectivity files](/guides/connectivity.md) and the
 [toolbar](/guides/quickview/toolbar.md).
 :::
 
-::: tip The `LOAD VARIABLES` Button
+::: tip Consistency between connecitivity and simulation files
+One of the repeatedly encountered causes of error when loading files in QuickView is
+that the grid described by the connecitivity file does not match the grid in the
+simulation data file. Please double check when you run into a loading error.
+:::
+
+::: warning The `LOAD VARIABLES` Button
 Most buttons, sliders, and selection boxes in the UI apply their effects
 immediately upon user interaction. The only exception is variable
 selection: After variables are chosen for the first time following file load
@@ -41,4 +47,3 @@ Furthermore, if a user saves a state file after these
 adjustments, they can later resume their analysis with the customized
 arrangement.
 :::
-

docs/index.md

@@ -6,7 +6,7 @@ hero:
   name: "QuickView"
   text: "for Earth system models"
   tagline:
-    Intuitive and interactive exploration of simulation data.
+    Efficient, intuitive, and interactive exploration of simulation data.
   image: /banner.png
   actions:
     - theme: brand 
@@ -34,8 +34,9 @@ features:
       src: /logos/paraview_trame_python.png
       width: 180px
     details:
-      User Interfaces (UIs) based on Python and trame provide
-      intuitive access to ParaView's powerful analysis and visualization
+      User Interfaces (UIs) based on Python and [trame](https://kitware.github.io/trame/)
+      provide intuitive access to [ParaView's](https://www.paraview.org/)
+      powerful analysis and visualization
       capabilities without requiring a steep learning curve.
     link: https://www.paraview.org/ 
   - title: Remote Data 
@@ -51,9 +52,9 @@ features:
   - title: Funding Source 
     icon:
       src: /logos/SciDAC-logo.png
-      width: 160px
+      width: 170px
     details:
-      The QuickView family of tools are developed using funding from the
+      The QuickView family of tools is developed using funding from the
       U.S. Department of Energy's SciDAC program.
     link: https://www.energy.gov/science/articles/accelerating-scientific-discovery-through-advanced-computing
 ---