gratinglab 0.2.3__tar.gz → 0.2.5__tar.gz

{gratinglab-0.2.3/src/gratinglab.egg-info → gratinglab-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gratinglab
-Version: 0.2.3
+Version: 0.2.5
 Summary: Open platform for diffraction grating groove metrology and efficiency analysis
 Author: Jake McCoy, Aditi Gangadharan
 License: BSD-3-Clause
@@ -110,8 +110,10 @@ convergence harnesses and the materials layer work end to end. They are checked
 against closed-form results, published benchmark tables, energy balance and
 reciprocity, but remain experimental until they have been used on real problems.
 Efficiencies are absolute when a coating is named, using an optical constant table
-supplied by the user (see Install). A rigorous coupled-wave analysis (RCWA) backend
-is planned, written in-house.
+supplied by the user (see Install). Since 0.2.0 two more rigorous backends sit
+beside them, both written in-house and both experimental: a rigorous coupled-wave
+analysis (RCWA), which also models coated gratings through conformal layers, and
+the C-method (Chandezon). Each has a tab in the efficiency window since 0.2.1.
 
 ## Scope
 
@@ -136,8 +138,8 @@ grazing incidence (γ of a degree or two), the soft X-ray spectroscopy regime th
 project began with, where the integral method is the established approach and
 general-purpose RCWA codes are least reliable. `Illumination.classical`,
 `Illumination.conical(theta, phi)` and `Illumination.offplane(graze, azimuth)` all
-build the same object, and both solvers accept any of them. Which method serves which regime, and what is not yet covered
-(coated and multilayer gratings, for one), is mapped in
+build the same object, and every solver accepts any of them. Which method serves which regime, and what is not yet covered
+(multilayer stacks checked against an independent code, for one), is mapped in
 [`docs/roadmap.md`](https://github.com/jamccoy/gratinglab/blob/master/docs/roadmap.md#regimes-and-the-methods-that-serve-them).
 
 The method backends, in order of development:
@@ -146,8 +148,8 @@ The method backends, in order of development:
 |---|---|
 | Scalar (Kirchhoff, x-ray blaze form) | experimental; checked against closed-form results |
 | Integral method (boundary integral, conical, undercut-capable) | experimental; perfect and finite conductivity (`conductivity="tabulated"`, Goray & Schmidt 2010), absolute efficiencies with the absorbed fraction recorded; a corner-graded mesh for profiles with corners (`corner_grading=4`), under either boundary condition; checked against published benchmark tables (Maystre & Popov; Goray & Schmidt), energy balance and reciprocity |
-| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | planned, written in-house |
-| C-method (Chandezon) | planned |
+| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | experimental, since 0.2.0; lamellar gratings exact and other profiles staircased, transmitted orders, and coatings through conformal layers (`Problem.layers`); checked against Fresnel, the Airy film formula, reciprocity, the integral solver, and published lamellar values (Granet; Lalanne & Hugonin; Gralak; Goray & Schmidt's conical tables). Not yet checked: staircase accuracy in metallic TM, and layers of a second material against an independent code |
+| C-method (Chandezon) | experimental, since 0.2.0; perfect conductor in any mount, and one interface into an absorbing or lossless material, conical and coupled; checked against Goray & Schmidt's Table 3, Fresnel and the integral solver. Refuses vertical facets and undercuts; converges slowly on sawtooth corners, and loses precision at high truncation on profiles deeper than about half the period, both reported in provenance. No coatings |
 
 The comparison harness also accepts an efficiency table already computed by an
 external program as one of its methods, so that comparison plots can be made without

{gratinglab-0.2.3 → gratinglab-0.2.5}/README.md

@@ -65,8 +65,10 @@ convergence harnesses and the materials layer work end to end. They are checked
 against closed-form results, published benchmark tables, energy balance and
 reciprocity, but remain experimental until they have been used on real problems.
 Efficiencies are absolute when a coating is named, using an optical constant table
-supplied by the user (see Install). A rigorous coupled-wave analysis (RCWA) backend
-is planned, written in-house.
+supplied by the user (see Install). Since 0.2.0 two more rigorous backends sit
+beside them, both written in-house and both experimental: a rigorous coupled-wave
+analysis (RCWA), which also models coated gratings through conformal layers, and
+the C-method (Chandezon). Each has a tab in the efficiency window since 0.2.1.
 
 ## Scope
 
@@ -91,8 +93,8 @@ grazing incidence (γ of a degree or two), the soft X-ray spectroscopy regime th
 project began with, where the integral method is the established approach and
 general-purpose RCWA codes are least reliable. `Illumination.classical`,
 `Illumination.conical(theta, phi)` and `Illumination.offplane(graze, azimuth)` all
-build the same object, and both solvers accept any of them. Which method serves which regime, and what is not yet covered
-(coated and multilayer gratings, for one), is mapped in
+build the same object, and every solver accepts any of them. Which method serves which regime, and what is not yet covered
+(multilayer stacks checked against an independent code, for one), is mapped in
 [`docs/roadmap.md`](https://github.com/jamccoy/gratinglab/blob/master/docs/roadmap.md#regimes-and-the-methods-that-serve-them).
 
 The method backends, in order of development:
@@ -101,8 +103,8 @@ The method backends, in order of development:
 |---|---|
 | Scalar (Kirchhoff, x-ray blaze form) | experimental; checked against closed-form results |
 | Integral method (boundary integral, conical, undercut-capable) | experimental; perfect and finite conductivity (`conductivity="tabulated"`, Goray & Schmidt 2010), absolute efficiencies with the absorbed fraction recorded; a corner-graded mesh for profiles with corners (`corner_grading=4`), under either boundary condition; checked against published benchmark tables (Maystre & Popov; Goray & Schmidt), energy balance and reciprocity |
-| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | planned, written in-house |
-| C-method (Chandezon) | planned |
+| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | experimental, since 0.2.0; lamellar gratings exact and other profiles staircased, transmitted orders, and coatings through conformal layers (`Problem.layers`); checked against Fresnel, the Airy film formula, reciprocity, the integral solver, and published lamellar values (Granet; Lalanne & Hugonin; Gralak; Goray & Schmidt's conical tables). Not yet checked: staircase accuracy in metallic TM, and layers of a second material against an independent code |
+| C-method (Chandezon) | experimental, since 0.2.0; perfect conductor in any mount, and one interface into an absorbing or lossless material, conical and coupled; checked against Goray & Schmidt's Table 3, Fresnel and the integral solver. Refuses vertical facets and undercuts; converges slowly on sawtooth corners, and loses precision at high truncation on profiles deeper than about half the period, both reported in provenance. No coatings |
 
 The comparison harness also accepts an efficiency table already computed by an
 external program as one of its methods, so that comparison plots can be made without

{gratinglab-0.2.3 → gratinglab-0.2.5}/src/gratinglab/__init__.py

@@ -22,7 +22,7 @@ from .measured import MeasuredEfficiency, MeasurementProvenance
 from .resolution import ResolvingPower, resolving_power
 from .result import EfficiencyScan, OrderEfficiency, Provenance
 
-__version__ = "0.2.3"
+__version__ = "0.2.5"
 
 __all__ = [
     "Illumination",

{gratinglab-0.2.3 → gratinglab-0.2.5}/src/gratinglab/gui/qt/theming.py

@@ -36,6 +36,7 @@ __all__ = [
     "current",
     "install",
     "manager",
+    "settings",
     "subscribe",
     "swatch",
 ]
@@ -47,13 +48,21 @@ _KEY = "appearance/theme"
 _PROPERTY = "_gratinglab_theme_manager"
 
 
-def _settings() -> QSettings:
+def settings() -> QSettings:
+    """The application's settings store, or the INI file ``GRATINGLAB_SETTINGS`` names.
+
+    Shared by everything the windows remember (the theme, the AFM column
+    width), so the test suite's redirect covers all of it at once.
+    """
     path = os.environ.get(SETTINGS_ENV)
     if path:
         return QSettings(path, QSettings.Format.IniFormat)
     return QSettings("gratinglab", "gratinglab")
 
 
+_settings = settings
+
+
 def palette(theme: Theme) -> QPalette:
     """A ``QPalette`` for ``theme``, with disabled text dimmed to its muted colour."""
     role = QPalette.ColorRole

gratinglab-0.2.5/src/gratinglab/metrology/gui/qt/layout.py

@@ -0,0 +1,95 @@
+"""
+The controls-and-plot layout every AFM tab shares.
+
+Each tab was a fixed 272 px column of controls in a 292 px scroll area beside
+its plot, so long labels were crammed and nothing could be widened. A splitter
+replaces that: the column starts wide enough for its contents, cannot be
+dragged narrower than its widest control needs, and gives the plot every pixel
+the window gains.
+
+The width is one setting, not one per tab. Dragging the column in any tab
+moves it in the others, so switching tabs never makes the plot jump, and the
+width is saved as it is dragged, so the window opens at it next time. It is
+kept in the same store as the theme (``theming.settings``), which the test
+suite redirects to a scratch file.
+"""
+from __future__ import annotations
+
+import weakref
+
+from . import *  # noqa: F401,F403 - sets QT_API before matplotlib's shim loads
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import QFrame, QScrollArea, QSplitter, QWidget
+
+from gratinglab.gui.qt.theming import settings
+
+__all__ = ["controls_beside", "MIN_CONTROLS_WIDTH", "START_CONTROLS_WIDTH",
+           "WIDTH_KEY"]
+
+#: Narrower than this and the group boxes' labels start to wrap mid-word.
+MIN_CONTROLS_WIDTH = 260
+#: Where the column starts, unless its contents ask for more.
+START_CONTROLS_WIDTH = 320
+#: Where the chosen width is remembered.
+WIDTH_KEY = "afm/controls_width"
+
+# Every live splitter, so a drag in one tab can move the others. Weak, so a
+# closed window's splitters drop out on their own.
+_SPLITTERS: "weakref.WeakSet[QSplitter]" = weakref.WeakSet()
+
+
+def _saved_width() -> int | None:
+    value = settings().value(WIDTH_KEY)
+    try:
+        return int(value) if value is not None else None
+    except (TypeError, ValueError):
+        return None     # a hand-edited or corrupt value: fall back to the default
+
+
+def _follow(source: QSplitter) -> None:
+    """Remember ``source``'s column width and give it to every other tab."""
+    width = source.sizes()[0]
+    store = settings()
+    store.setValue(WIDTH_KEY, width)
+    store.sync()
+    for other in list(_SPLITTERS):
+        if other is source:
+            continue
+        try:
+            total = sum(other.sizes())
+            other.blockSignals(True)
+            other.setSizes([width, max(1, total - width)])
+            other.blockSignals(False)
+        except RuntimeError:
+            # Its window was closed and Qt has deleted it, while the Python
+            # wrapper waits for collection.
+            _SPLITTERS.discard(other)
+
+
+def controls_beside(controls: QWidget, plot: QWidget) -> QSplitter:
+    """A splitter holding the scrolling ``controls`` column and the ``plot``."""
+    scroll = QScrollArea()
+    scroll.setWidget(controls)
+    scroll.setWidgetResizable(True)
+    scroll.setFrameShape(QFrame.NoFrame)
+    # Width is the splitter's to decide; only the height should ever scroll.
+    scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
+
+    gutter = scroll.verticalScrollBar().sizeHint().width()
+    floor = max(MIN_CONTROLS_WIDTH, controls.minimumSizeHint().width() + gutter)
+    scroll.setMinimumWidth(floor)
+
+    splitter = QSplitter(Qt.Horizontal)
+    splitter.setChildrenCollapsible(False)
+    splitter.addWidget(scroll)
+    splitter.addWidget(plot)
+    splitter.setStretchFactor(0, 0)
+    splitter.setStretchFactor(1, 1)
+    # A remembered width wins, but never below what this tab's controls need.
+    start = max(_saved_width() or START_CONTROLS_WIDTH, floor)
+    splitter.setSizes([start, max(1, 4 * start)])
+
+    _SPLITTERS.add(splitter)
+    splitter.splitterMoved.connect(lambda *_: _follow(splitter))
+    return splitter

{gratinglab-0.2.3 → gratinglab-0.2.5/src/gratinglab.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gratinglab
-Version: 0.2.3
+Version: 0.2.5
 Summary: Open platform for diffraction grating groove metrology and efficiency analysis
 Author: Jake McCoy, Aditi Gangadharan
 License: BSD-3-Clause
@@ -110,8 +110,10 @@ convergence harnesses and the materials layer work end to end. They are checked
 against closed-form results, published benchmark tables, energy balance and
 reciprocity, but remain experimental until they have been used on real problems.
 Efficiencies are absolute when a coating is named, using an optical constant table
-supplied by the user (see Install). A rigorous coupled-wave analysis (RCWA) backend
-is planned, written in-house.
+supplied by the user (see Install). Since 0.2.0 two more rigorous backends sit
+beside them, both written in-house and both experimental: a rigorous coupled-wave
+analysis (RCWA), which also models coated gratings through conformal layers, and
+the C-method (Chandezon). Each has a tab in the efficiency window since 0.2.1.
 
 ## Scope
 
@@ -136,8 +138,8 @@ grazing incidence (γ of a degree or two), the soft X-ray spectroscopy regime th
 project began with, where the integral method is the established approach and
 general-purpose RCWA codes are least reliable. `Illumination.classical`,
 `Illumination.conical(theta, phi)` and `Illumination.offplane(graze, azimuth)` all
-build the same object, and both solvers accept any of them. Which method serves which regime, and what is not yet covered
-(coated and multilayer gratings, for one), is mapped in
+build the same object, and every solver accepts any of them. Which method serves which regime, and what is not yet covered
+(multilayer stacks checked against an independent code, for one), is mapped in
 [`docs/roadmap.md`](https://github.com/jamccoy/gratinglab/blob/master/docs/roadmap.md#regimes-and-the-methods-that-serve-them).
 
 The method backends, in order of development:
@@ -146,8 +148,8 @@ The method backends, in order of development:
 |---|---|
 | Scalar (Kirchhoff, x-ray blaze form) | experimental; checked against closed-form results |
 | Integral method (boundary integral, conical, undercut-capable) | experimental; perfect and finite conductivity (`conductivity="tabulated"`, Goray & Schmidt 2010), absolute efficiencies with the absorbed fraction recorded; a corner-graded mesh for profiles with corners (`corner_grading=4`), under either boundary condition; checked against published benchmark tables (Maystre & Popov; Goray & Schmidt), energy balance and reciprocity |
-| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | planned, written in-house |
-| C-method (Chandezon) | planned |
+| RCWA (in-plane, conical, off-plane; Li factorization, S-matrix, layer stacks) | experimental, since 0.2.0; lamellar gratings exact and other profiles staircased, transmitted orders, and coatings through conformal layers (`Problem.layers`); checked against Fresnel, the Airy film formula, reciprocity, the integral solver, and published lamellar values (Granet; Lalanne & Hugonin; Gralak; Goray & Schmidt's conical tables). Not yet checked: staircase accuracy in metallic TM, and layers of a second material against an independent code |
+| C-method (Chandezon) | experimental, since 0.2.0; perfect conductor in any mount, and one interface into an absorbing or lossless material, conical and coupled; checked against Goray & Schmidt's Table 3, Fresnel and the integral solver. Refuses vertical facets and undercuts; converges slowly on sawtooth corners, and loses precision at high truncation on profiles deeper than about half the period, both reported in provenance. No coatings |
 
 The comparison harness also accepts an efficiency table already computed by an
 external program as one of its methods, so that comparison plots can be made without

gratinglab-0.2.3/src/gratinglab/metrology/gui/qt/layout.py

@@ -1,46 +0,0 @@
-"""
-The controls-and-plot layout every AFM tab shares.
-
-Each tab was a fixed 272 px column of controls in a 292 px scroll area beside
-its plot, so long labels were crammed and nothing could be widened. A splitter
-replaces that: the column starts wide enough for its contents, cannot be
-dragged narrower than its widest control needs, and gives the plot every pixel
-the window gains.
-"""
-from __future__ import annotations
-
-from . import *  # noqa: F401,F403 - sets QT_API before matplotlib's shim loads
-
-from PySide6.QtCore import Qt
-from PySide6.QtWidgets import QFrame, QScrollArea, QSplitter, QWidget
-
-__all__ = ["controls_beside", "MIN_CONTROLS_WIDTH", "START_CONTROLS_WIDTH"]
-
-#: Narrower than this and the group boxes' labels start to wrap mid-word.
-MIN_CONTROLS_WIDTH = 260
-#: Where the column starts, unless its contents ask for more.
-START_CONTROLS_WIDTH = 320
-
-
-def controls_beside(controls: QWidget, plot: QWidget) -> QSplitter:
-    """A splitter holding the scrolling ``controls`` column and the ``plot``."""
-    scroll = QScrollArea()
-    scroll.setWidget(controls)
-    scroll.setWidgetResizable(True)
-    scroll.setFrameShape(QFrame.NoFrame)
-    # Width is the splitter's to decide; only the height should ever scroll.
-    scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
-
-    gutter = scroll.verticalScrollBar().sizeHint().width()
-    floor = max(MIN_CONTROLS_WIDTH, controls.minimumSizeHint().width() + gutter)
-    scroll.setMinimumWidth(floor)
-
-    splitter = QSplitter(Qt.Horizontal)
-    splitter.setChildrenCollapsible(False)
-    splitter.addWidget(scroll)
-    splitter.addWidget(plot)
-    splitter.setStretchFactor(0, 0)
-    splitter.setStretchFactor(1, 1)
-    start = max(START_CONTROLS_WIDTH, floor)
-    splitter.setSizes([start, max(1, 4 * start)])
-    return splitter