Merge pull request #52 from zasexton/main

removing the linux-specific package installations from .yml gui env setup

Author: zasexton

README.md

@@ -9,7 +9,7 @@
 [![Docs](https://img.shields.io/badge/docs-gh--pages-brightgreen)](https://simvascular.github.io/svVascularize/)
 [![Telemetry](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/zasexton/svVascularize/main/docs/badges/telemetry.json)](https://sentry.io)
 <!-- smoke-test-badge -->
-[![SVV passing](https://img.shields.io/badge/svv_passing-linux_fail-macos_fail-windows_fail-red)](https://github.com/SimVascular/svVascularize/actions/workflows/basic-smoke-test.yml?query=branch%3Amain)
+[![SVV passing](https://img.shields.io/badge/svv_passing-linux_fail-macos_fail-windows_fail-red)](https://github.com/zasexton/svVascularize/actions/workflows/basic-smoke-test.yml?query=branch%3Amain)
 <!-- /smoke-test-badge -->
 
 <p align="left">

docs/doc.html

@@ -39,6 +39,7 @@ <h3>Get Started</h3>
     <ul>
       <li><a href="quickstart.html">🟢 Quickstart tutorial</a></li>
       <li><a href="pipeline.html">End‑to‑end pipeline (generation → 3‑D CFD)</a></li>
+      <li><a href="gui.html">Interactive GUI (domains → start points → generate → export)</a></li>
     </ul>
 
     <h3>Concept Guides</h3>

docs/style.css

@@ -251,6 +251,14 @@ table { border-collapse: collapse; margin: 1.2rem 0; width: 100%; }
 th, td { border: 1px solid var(--clr-grey-300); padding: .55rem; text-align: left; font-size: .95rem; }
 th { background: var(--clr-grey-100); color: var(--clr-grey-700); }
 
+/* small UI icons (used in gui docs) */
+.icon {
+  width: 22px;
+  height: 22px;
+  vertical-align: middle;
+  display: inline-block;
+}
+
 /* callouts */
 .callout {
   border-left: 4px solid var(--clr-warning);
@@ -436,4 +444,4 @@ pre[data-copy]::after { right: .75rem; top: .5rem; }
   .doc-grid { grid-template-columns: 1fr; }
   .left-nav { display: none; }
   .content { padding: 1rem; }
-}
+}

environment-gui.yml

@@ -1,20 +1,19 @@
+# Cross-platform svVascularize GUI environment.
+#
+# - Windows/macOS: use this file as-is.
+# - Linux: consider `environment-gui-linux.yml` (includes Mesa/libGL + X11 libs)
+#   if you encounter OpenGL/VTK/Qt runtime issues.
 name: svv-gui
 channels:
   - conda-forge
 dependencies:
   - python>=3.9,<3.13
+  - numpy
+  - psutil
   - pyside6>=6.4
   - pyvista>=0.41
   - pyvistaqt>=0.11.0
   - vtk
-  - mesalib
-  - libglvnd
-  - libxcb
-  - xorg-libx11
-  - xorg-libxt
-  - xorg-libxfixes
-  - numpy
-  - psutil
   - pip
   - pip:
       - .

svv/visualize/gui/README.md

@@ -19,10 +19,15 @@ The GUI requires PySide6 and PyVistaQt (with PyVista).
 
 Conda (recommended for shipping/testing):
 ```bash
+# Windows/macOS:
 conda env create -f environment-gui.yml
+
+# Linux (includes Mesa/libGL + X11 runtime libs):
+conda env create -f environment-gui-linux.yml
+
 conda activate svv-gui
 ```
-This installs PySide6/PyVista/PyVistaQt plus Mesa/GL runtime pieces needed on many Linux systems.
+On Linux, `environment-gui-linux.yml` installs PySide6/PyVista/PyVistaQt plus Mesa/GL runtime pieces; on Windows/macOS those Mesa packages are not needed.
 
 Alternative (pip):
 ```bash