setupEM 0.7.0__tar.gz → 0.7.2__tar.gz

{setupem-0.7.0/src/setupEM.egg-info → setupem-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: setupEM
-Version: 0.7.0
+Version: 0.7.2
 Summary: Python tool for configuration of gds2palace workflow with GUI.
 Author-email: Volker Muehlhaus <volker@muehlhaus.com>
 License-Expression: GPL-3.0-or-later
@@ -21,6 +21,8 @@ Requires-Dist: matplotlib
 Requires-Dist: numpy
 Requires-Dist: gdspy
 Requires-Dist: meshio
+Requires-Dist: pyvista
+Requires-Dist: pyvistaqt
 Dynamic: license-file
 
 # Python GUI for gds2palace 
@@ -35,7 +37,7 @@ An overview of the SetupEM user interface is given below in chapter "Using setup
 
 Two more external tools are used by parts of the workflow, and are not installed automatically:
 
-- [ParaView](https://www.paraview.org/) — to view field-dump output (Palace/Elmer EM) and Elmer thermal result files via the "View fields/results in Paraview" buttons.
+- [ParaView](https://www.paraview.org/) — optional, for viewing field-dump output (Palace/Elmer EM) and Elmer thermal result files with ParaView itself instead of the built-in 3D field viewer. Not required: the built-in viewer needs nothing extra installed and is the default.
 - An MPI implementation — only needed for multi-process Elmer runs (the Elmer solver settings' multithreading option). Use OpenMPI or MPICH on Linux/macOS; on Windows, install [Microsoft MPI](https://learn.microsoft.com/en-us/message-passing-interface/microsoft-mpi) (setupEM checks for this and shows a download link if it's missing).
 
 ## Install
@@ -47,6 +49,12 @@ https://github.com/VolkerMuehlhaus/setupEM
 
 ## Recent changes
 
+# What's New - September 14, 2026
+
+Added a built-in **3D field viewer**, an in-app alternative to launching external ParaView, for setupEM (Palace and Elmer-as-EM-solver) and setupThermal (Elmer thermal) field-dump results: an axis-aligned clip plane with a **Find max.** button, standard CAD/ParaView-style axis-view buttons, tailored per-solver color defaults with a manual range override, opacity and mesh-edge overlay controls, and an arrow overlay with a size slider for vector fields. **View fields in Paraview...** and the previous separate 3D-viewer button are now one **View fields (...)...** button, whose label shows which viewer it opens - choose Built-in (new default) or ParaView on the new **Preferences > Viewer** tab, with automatic fallback to Built-in (and a log message) if ParaView isn't found.
+
+Layout Preview now shows a via port's effective centerline when its drawn marker has finite size in both x and y, since gds2palace's `add_ports()` collapses the shorter axis down to its minimum edge (not the true center) when building the actual simulated port sheet.
+
 # What's New - September 8-12, 2026
 
 Added two reserved stackup materials that need no `<Materials>` entry: `PEC` (ideal conductor, on conductor/via/sheet Layers) and `AIR` (built-in default dielectric, overridable).  
@@ -79,14 +87,6 @@ ParaView launching (Palace and Elmer EM field dumps, Elmer thermal results) now
 
 The Frequencies tab's field-dump control is now solver-aware: Elmer mode shows a plain **"Enable field dump"** checkbox instead of a frequency list, since Elmer has no per-frequency `SaveStep` like Palace - any `fdump` value there dumps fields at *every* solved frequency (sweep and `fpoint` together), so listing specific frequencies was misleading. Palace mode is unchanged, keeping its per-frequency `fdump` list. This also sidesteps a gds2palace bug (see its own CHANGES.md) where a frequency listed in both the sweep and `fdump` was silently solved twice.
 
-# What's New - September 5, 2026
-
-Added a **View fields in Paraview...** button (Create Model tab), shown once `fdump` is set, to open Palace or Elmer EM field-dump results directly. "View Results..." is renamed to **View S-Parameters...** for clarity.
-
-Fixed Elmer EM simulations failing to start on Windows: the run script never actually launched (silently, with no log output), and MPI-enabled runs now check that Microsoft MPI is installed first, with a clear message and download link if it's missing instead of a cryptic failure.
-
-Fixed importing an existing model file and choosing to reuse its filename: it could silently rename the output to a different file than the one imported. Fixed `fdump`/`fpoint` showing raw Hz values instead of GHz after importing a model file. `fdump` is now usable in Elmer mode too (previously hidden).
-
 Full history: [CHANGES.md](https://github.com/VolkerMuehlhaus/setupEM/blob/main/doc/CHANGES.md)
 
 ---
@@ -104,5 +104,7 @@ Full history: [CHANGES.md](https://github.com/VolkerMuehlhaus/setupEM/blob/main/
 - numpy
 - gdspy
 - meshio
+- pyvista
+- pyvistaqt
 
 (Other Python modules mentioned above are only needed to run standalone helper scripts in this repository, not to use the installed package.)

{setupem-0.7.0 → setupem-0.7.2}/README.md

@@ -2,7 +2,7 @@
 
 ## What's New
 
-Reserved PEC/AIR stackup materials, Layout Preview, Results viewer, Model Fit, GDSII Layout Simplification, XML Stackup Editor, setupThermal for Elmer thermal simulation.
+Reserved PEC/AIR stackup materials, Layout Preview, Results viewer, Model Fit, built-in 3D field viewer, GDSII Layout Simplification, XML Stackup Editor, setupThermal for Elmer thermal simulation.
 
 See [CHANGES.md](doc/CHANGES.md) for details.
 
@@ -18,7 +18,7 @@ An overview of the SetupEM user interface is given below in chapter "Using setup
 
 Two more external tools are used by parts of the workflow, and are not installed automatically:
 
-- [ParaView](https://www.paraview.org/) — to view field-dump output (Palace/Elmer EM) and Elmer thermal result files via the "View fields/results in Paraview" buttons.
+- [ParaView](https://www.paraview.org/) — optional, for viewing field-dump output (Palace/Elmer EM) and Elmer thermal result files with ParaView itself instead of the built-in 3D field viewer (see [3D Field Viewer](#3d-field-viewer) below). Not required: the built-in viewer needs nothing extra installed and is the default.
 - An MPI implementation — only needed for multi-process Elmer runs (the Elmer solver settings' multithreading option). Use OpenMPI or MPICH on Linux/macOS; on Windows, install [Microsoft MPI](https://learn.microsoft.com/en-us/message-passing-interface/microsoft-mpi) (setupEM checks for this and shows a download link if it's missing).
 
 
@@ -86,6 +86,8 @@ The setupEM module also installs these dependencies:
 - numpy
 - gdspy
 - meshio
+- pyvista
+- pyvistaqt
     
 ---
 
@@ -235,6 +237,26 @@ Once snp2le is available, Model Fit locates the raw (not `_dc`, not `_deembedded
 
 If no raw result file exists yet (no simulation has been run), Model Fit shows a warning instead of starting snp2le - run a simulation first.
 
+## 3D Field Viewer
+
+Once field-dump results are available (Palace: set `fdump`; Elmer: enable field dump), click **View fields (...)...** on the Create Model tab to open them - the "..." in the label shows which viewer it opens, **Built-in** or **ParaView**, per the setting described below.
+
+<img src="./doc/png/fieldviewer1.png" alt="3D field viewer" width="750">
+
+The built-in viewer has a single, axis-aligned clip plane (X/Y/Z + a position slider, shown in µm) to see a cross-section through the model, rather than a free-orientation drag-widget - **Find max.** jumps the plane straight to the largest value of the currently selected field along that axis. Standard CAD/ParaView-style **+X/-X/+Y/-Y/+Z/-Z** buttons snap the camera to look straight down each axis; the clip plane's kept side follows whichever of these you last used for its axis, so the exposed cut face always faces the camera instead of occasionally showing the model's untouched exterior surface.
+
+The **Field** panel picks which array to color by, defaulting to E-field magnitude (log color scale) for Palace and Elmer-as-EM-solver mode, or temperature (linear) for Elmer thermal - the Min/Max fields let you override the color range manually, with a button to reset back to the data's own range. **Display** controls opacity (to see a hotspot through the surrounding material without losing the outer shape as context) and a mesh-edge overlay. If more than one equally-valid result file exists (e.g. Palace's main "driven" field dump and its separate "driven_boundary" one), a **Result File** picker lets you choose between them instead of guessing.
+
+For a vector array (E/B-field, Poynting vector `S`, ...), **Show arrows** overlays direction arrows on top of the color, auto-scaled from the field's own magnitude on a log scale so both weak and strong regions stay visible instead of only the single hottest point - the **Arrow size** slider (0.5% steps) scales them to taste, and also controls how densely they're packed in, since smaller arrows can sit closer together than large ones without turning into a solid block.
+
+<img src="./doc/png/fieldviewer2.png" alt="3D field viewer, vector arrows on the Poynting vector S" width="750">
+
+Choose which viewer **View fields (...)...** opens - **Built-in** (default, needs nothing else installed) or **ParaView** - on **Preferences > Viewer**. If ParaView is selected but not found on your system, setupEM/setupThermal fall back to the built-in viewer automatically, with a message in the Log panel.
+
+<img src="./doc/png/preferences_viewer1.png" alt="3D field viewer preference" width="500">
+
+Also runnable standalone, without the full setupEM/setupThermal GUI, either directly (`python field_viewer.py <file_path> [--source palace|elmer_em|elmer_thermal]`) or via the `fieldViewer` console script installed with the package.
+
 ## Code 
 Behind the scenes, the setupEM user interface created Python model code for gds2palace, and you can check the resulting code on the "Code" tab.
 

{setupem-0.7.0 → setupem-0.7.2}/README_pypi.md

@@ -10,7 +10,7 @@ An overview of the SetupEM user interface is given below in chapter "Using setup
 
 Two more external tools are used by parts of the workflow, and are not installed automatically:
 
-- [ParaView](https://www.paraview.org/) — to view field-dump output (Palace/Elmer EM) and Elmer thermal result files via the "View fields/results in Paraview" buttons.
+- [ParaView](https://www.paraview.org/) — optional, for viewing field-dump output (Palace/Elmer EM) and Elmer thermal result files with ParaView itself instead of the built-in 3D field viewer. Not required: the built-in viewer needs nothing extra installed and is the default.
 - An MPI implementation — only needed for multi-process Elmer runs (the Elmer solver settings' multithreading option). Use OpenMPI or MPICH on Linux/macOS; on Windows, install [Microsoft MPI](https://learn.microsoft.com/en-us/message-passing-interface/microsoft-mpi) (setupEM checks for this and shows a download link if it's missing).
 
 ## Install
@@ -22,6 +22,12 @@ https://github.com/VolkerMuehlhaus/setupEM
 
 ## Recent changes
 
+# What's New - September 14, 2026
+
+Added a built-in **3D field viewer**, an in-app alternative to launching external ParaView, for setupEM (Palace and Elmer-as-EM-solver) and setupThermal (Elmer thermal) field-dump results: an axis-aligned clip plane with a **Find max.** button, standard CAD/ParaView-style axis-view buttons, tailored per-solver color defaults with a manual range override, opacity and mesh-edge overlay controls, and an arrow overlay with a size slider for vector fields. **View fields in Paraview...** and the previous separate 3D-viewer button are now one **View fields (...)...** button, whose label shows which viewer it opens - choose Built-in (new default) or ParaView on the new **Preferences > Viewer** tab, with automatic fallback to Built-in (and a log message) if ParaView isn't found.
+
+Layout Preview now shows a via port's effective centerline when its drawn marker has finite size in both x and y, since gds2palace's `add_ports()` collapses the shorter axis down to its minimum edge (not the true center) when building the actual simulated port sheet.
+
 # What's New - September 8-12, 2026
 
 Added two reserved stackup materials that need no `<Materials>` entry: `PEC` (ideal conductor, on conductor/via/sheet Layers) and `AIR` (built-in default dielectric, overridable).  
@@ -54,14 +60,6 @@ ParaView launching (Palace and Elmer EM field dumps, Elmer thermal results) now
 
 The Frequencies tab's field-dump control is now solver-aware: Elmer mode shows a plain **"Enable field dump"** checkbox instead of a frequency list, since Elmer has no per-frequency `SaveStep` like Palace - any `fdump` value there dumps fields at *every* solved frequency (sweep and `fpoint` together), so listing specific frequencies was misleading. Palace mode is unchanged, keeping its per-frequency `fdump` list. This also sidesteps a gds2palace bug (see its own CHANGES.md) where a frequency listed in both the sweep and `fdump` was silently solved twice.
 
-# What's New - September 5, 2026
-
-Added a **View fields in Paraview...** button (Create Model tab), shown once `fdump` is set, to open Palace or Elmer EM field-dump results directly. "View Results..." is renamed to **View S-Parameters...** for clarity.
-
-Fixed Elmer EM simulations failing to start on Windows: the run script never actually launched (silently, with no log output), and MPI-enabled runs now check that Microsoft MPI is installed first, with a clear message and download link if it's missing instead of a cryptic failure.
-
-Fixed importing an existing model file and choosing to reuse its filename: it could silently rename the output to a different file than the one imported. Fixed `fdump`/`fpoint` showing raw Hz values instead of GHz after importing a model file. `fdump` is now usable in Elmer mode too (previously hidden).
-
 Full history: [CHANGES.md](https://github.com/VolkerMuehlhaus/setupEM/blob/main/doc/CHANGES.md)
 
 ---
@@ -79,5 +77,7 @@ Full history: [CHANGES.md](https://github.com/VolkerMuehlhaus/setupEM/blob/main/
 - numpy
 - gdspy
 - meshio
+- pyvista
+- pyvistaqt
 
 (Other Python modules mentioned above are only needed to run standalone helper scripts in this repository, not to use the installed package.)

{setupem-0.7.0 → setupem-0.7.2}/pyproject.toml

@@ -22,7 +22,9 @@ dependencies = [
     "matplotlib",
     "numpy",
     "gdspy",
-    "meshio"
+    "meshio",
+    "pyvista",
+    "pyvistaqt"
 ]
 requires-python = ">=3.9"
 
@@ -36,6 +38,7 @@ setupEM = "setupEM.setupEM:main"
 setupThermal = "setupEM.setupThermal:main"
 stackupEditor = "setupEM.stackupEditor:main"
 resultViewer = "setupEM.result_viewer:main"
+fieldViewer = "setupEM.field_viewer:main"
 
 [tool.setuptools.dynamic]
 version = {attr = "setupEM.__version__"}

{setupem-0.7.0 → setupem-0.7.2}/src/setupEM/__init__.py

@@ -24,4 +24,4 @@ A Python tool for EM setup using gds2palace.
 from .setupEM import main
 
 __all__ = ["main"]
-__version__ = "0.7.0"
+__version__ = "0.7.2"