PyMieSimX 0.1.5__tar.gz → 0.1.6__tar.gz

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/.github/dependabot.yml

@@ -6,6 +6,5 @@ updates:
     directory: "/"
     target-branch: "master"
     schedule:
-      interval: "monthly"
-      day: "sunday"
+      interval: "quarterly"
       time: "09:00"

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/.github/workflows/deploy_anaconda.yml

@@ -1,6 +1,7 @@
 name: Publish Conda package
 
 on:
+  workflow_dispatch:
   push:
     tags: ["v*"]
 
@@ -16,5 +17,6 @@ jobs:
       package_name: pymiesimx
       recipe_path: conda.recipe
       test_import: PyMieSimX
+      test_command: "python -c 'import PyMieSimX' && pymiesimx --help"
     secrets:
       ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/.github/workflows/quality.yml

@@ -16,12 +16,12 @@ jobs:
       matrix:
         python-version: ["3.11", "3.13"]
     steps:
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
-      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1
+      - name: Set up Python and CI dependencies
+        uses: MartinPdeS/MPSActions/actions/setup-python@0f5927acf88b25b5d253421e508387897096a2cc
         with:
-          python-version: ${{ matrix.python-version }}
-      - name: Install package and quality tools
-        run: python -m pip install --upgrade pip && python -m pip install -e ".[testing,dev]"
+          python-version: "${{ matrix.python-version }}"
+          install-command: >-
+            python -m pip install --upgrade pip && python -m pip install -e ".[testing,dev]"
       - name: Initialize material catalog
         run: python -m PyOptik setup --no-progress
       - name: Ruff
@@ -34,12 +34,12 @@ jobs:
   browser-tests:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
-      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1
+      - name: Set up Python and CI dependencies
+        uses: MartinPdeS/MPSActions/actions/setup-python@0f5927acf88b25b5d253421e508387897096a2cc
         with:
           python-version: "3.11"
-      - name: Install package and browser test tools
-        run: python -m pip install --upgrade pip && python -m pip install -e ".[testing,browser]"
+          install-command: >-
+            python -m pip install --upgrade pip && python -m pip install -e ".[testing,browser]"
       - name: Initialize material catalog
         run: python -m PyOptik setup --no-progress
       - name: Browser workflow tests

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/.github/workflows/tests.yml

@@ -13,10 +13,11 @@ jobs:
   tests:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
-      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1
+      - name: Set up Python and CI dependencies
+        uses: MartinPdeS/MPSActions/actions/setup-python@0f5927acf88b25b5d253421e508387897096a2cc
         with:
           python-version: "3.11"
-      - run: python -m pip install --upgrade pip && python -m pip install -e ".[testing]"
+          install-command: >-
+            python -m pip install --upgrade pip && python -m pip install -e ".[testing]"
       - run: python -m PyOptik setup --no-progress
       - run: python -m pytest -q

pymiesimx-0.1.6/AGENTS.md

@@ -0,0 +1,81 @@
+# Working on PyMieSimX
+
+PyMieSimX provides a Dash GUI and Python API for PyMieSim. The hosted service is
+https://pymiesim.onrender.com/. Keep browser use, local installation, and the
+Python API working together.
+
+## Repository map
+
+- `PyMieSimX/api.py` exposes the computational API. Preserve compatibility for
+  single-measure callers when extending sweep results.
+- `PyMieSimX/gui/computation.py`, `parsing.py`, `validation.py`, and `schemas.py`
+  handle scientific inputs, calculations, result serialization, and plotting.
+  Delegate scientific solvers to PyMieSim and optical materials to PyOptik.
+- `PyMieSimX/gui/jobs.py` manages bounded background sweep jobs;
+  `callbacks.py` connects job state, validation, plotting, and exports to Dash.
+- `PyMieSimX/gui/pages/`, `components/`, and `layout.py` compose the interface.
+  CSS and browser assets live in `PyMieSimX/gui/assets/`.
+- `PyMieSimX/application/wsgi.py` is the hosted-server entry point;
+  `PyMieSimX/__main__.py` provides the `pymiesimx` launcher.
+- `tests/gui/` covers Python behavior and Dash callbacks. `tests/browser/`
+  exercises the real browser workflow separately.
+
+## Setup and checks
+
+Use Python 3.11 or newer and a virtual environment. Reuse an existing suitable
+environment when available; do not modify sibling repositories to set up this
+one.
+
+```sh
+python -m pip install -e ".[testing,dev,browser]"
+python -m PyOptik setup --no-progress
+make quality PYTHON=python
+python -m pytest
+python -m pytest tests/browser --config-file=pytest.ini --headless --cov=PyMieSimX --cov-report=term --cov-fail-under=0
+git diff --check
+```
+
+Browser tests need Chrome and a compatible ChromeDriver. The default pytest
+suite runs `tests/gui` and enforces the coverage threshold in `.coveragerc`;
+the separate browser command intentionally disables that threshold. Use a
+writable `MPLCONFIGDIR` when the default Matplotlib cache is unavailable.
+
+Run checks relevant to the change. For UI interaction changes, run the browser
+suite as well as affected callback tests. Wait for observable UI state and CSS
+transitions; avoid fixed sleeps, JavaScript clicks that bypass actual hit
+testing, or removing assertions to make tests pass. Use explicit viewport sizes
+when testing desktop and responsive layouts.
+
+## Implementation conventions
+
+- Use four spaces and follow the existing Python style. Keep Ruff and the
+  scoped Mypy checks in `make quality` passing.
+- Keep parsing and scientific computation separate from Dash rendering so the
+  public Python API remains usable without constructing a GUI.
+- Preserve physical units, dataframe index information, and all selected
+  measures through serialization, plotting, and CSV export.
+- Validate sweep and result-size limits before expensive work where possible.
+  Keep queued/running/completed/error states visible and make Run recover after
+  validation failures, missing jobs, cancellation, and computation errors.
+- Keep usage metrics optional for local runs and protect the administration
+  page with its server-side token. Never commit database URLs or secrets.
+- Add regression coverage for behavior changes; use asymmetric data when
+  checking axis orientation and multiple measures when checking sweep output.
+
+## Documentation, packaging, and CI
+
+- `README.rst` uses reStructuredText. Check new sections and links render
+  correctly, including heading underline lengths.
+- Dependencies and the console entry point are declared in `pyproject.toml`.
+  Keep `conda.recipe/meta.yaml` consistent with them. Conda builds are
+  platform-specific for Python 3.11–3.13 on Linux, macOS, and Windows; retain
+  the Windows dependency selectors and explicit `pymiesimx` entry point.
+- The Conda workflow supports manual build verification. Publishing to Conda
+  and PyPI occurs on version-tag pushes. Verify the installed Conda artifact,
+  including both import and CLI startup, rather than only the checkout.
+- Versions come from Git tags through setuptools-scm. Use the existing release
+  tools/Makefile when a release is requested; a normal commit/push does not
+  imply creating a release tag.
+- Inspect failing Actions job logs and fix the underlying cause. After pushing
+  a CI fix, check the run for the new commit and report any remaining failures.
+- Preserve unrelated working-tree changes and commit only the requested work.

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.1.5
+Version: 0.1.6
 Summary: Graphical Dash interface for PyMieSim.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License-Expression: MIT
@@ -36,6 +36,20 @@ PyMieSimX is the standalone graphical interface for `PyMieSim
 configuring optical setups, running parameter sweeps, exploring individual
 particles, and exporting results.
 
+Try the live webapp
+----------------------
+
+**Run Mie scattering simulations in your browser—no installation required.**
+
+.. image:: https://img.shields.io/badge/Launch_Webapp-Open_in_browser-2672d6?style=for-the-badge
+   :target: https://pymiesim.onrender.com/
+   :alt: Launch the PyMieSimX webapp in your browser
+
+`Launch the PyMieSimX webapp <https://pymiesim.onrender.com/>`_ to configure
+optical setups, run parameter sweeps, explore individual particles, and download
+your results as CSV files. The hosted service provides direct access to the
+graphical interface; local installation is also available below.
+
 Source-model note
 -----------------
 
@@ -157,10 +171,19 @@ PyMieSimX writes namespaced counters to the shared ``metrics_counters`` table:
 backend is explicitly configured and available. Local installations do not
 persist usage counters.
 
+To show a small **Webapp visits** box in the homepage's top card, set this
+environment variable on the Render service and redeploy::
+
+    SHOW_METRIC=true
+
+The box is hidden by default and requires the PostgreSQL configuration above.
+It shows the total home-page visit count, including repeat visits, rather than
+unique visitors. If the database is unavailable, the box stays hidden.
+
 Administration page
 -------------------
 
-Usage counters are shown only on the hidden, token-protected administration
+Detailed usage counters are shown on the hidden, token-protected administration
 page. Configure a server-side token with::
 
     PYMIESIMX_ADMIN_TOKEN=<a long random value>

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX/gui/assets/dashboard.css

@@ -3865,6 +3865,87 @@ html .single-workspace .representation-card {
         flex-basis: auto;
     }
 }
+.home-page-hero {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 24px;
+    flex-wrap: wrap;
+}
+
+.home-hero-copy {
+    flex: 1 1 360px;
+    min-width: 0;
+}
+
+.home-hero-actions {
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+    flex-wrap: wrap;
+    gap: 14px;
+    margin-left: auto;
+}
+
+.home-visit-metric {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 3px;
+    padding: 9px 16px;
+    border: 1px solid #cddcec;
+    border-radius: 9px;
+    background: #f3f7fc;
+    color: #2f4358;
+}
+
+.home-visit-label {
+    font-size: .72rem;
+    font-weight: 600;
+}
+
+.home-visit-value {
+    font-size: 1.2rem;
+    line-height: 1.2;
+    font-variant-numeric: tabular-nums;
+}
+
+.home-support-button {
+    display: inline-flex;
+    align-items: center;
+    gap: 9px;
+    flex: 0 0 auto;
+    margin-left: auto;
+    padding: 10px 17px;
+    border: 1px solid #e8c56b;
+    border-radius: 9px;
+    background: linear-gradient(135deg, #fff8e3, #ffe8a9);
+    color: #704912;
+    font-size: .92rem;
+    font-weight: 700;
+    text-decoration: none;
+    white-space: nowrap;
+    box-shadow: 0 3px 9px rgba(151, 104, 23, .10);
+    transition: background 150ms ease, box-shadow 150ms ease;
+}
+
+.home-support-button:hover {
+    background: #ffe49a;
+    color: #58350b;
+    text-decoration: none;
+    box-shadow: 0 4px 12px rgba(151, 104, 23, .18);
+}
+
+.home-support-button:focus-visible {
+    outline: 3px solid #2672d6;
+    outline-offset: 3px;
+}
+
+.home-support-icon {
+    color: #ad6515;
+    font-size: 1.1rem;
+}
+
 .admin-page {
   max-width: 1180px;
   margin: 0 auto;

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX/gui/callbacks.py

@@ -213,7 +213,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             active["experiment"] += " active"
             return build_page_with_footer(build_experiment_page(default_measure_options, plot_settings or {})), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings")), home_visits
         active["home"] += " active"
-        return build_page_with_footer(build_home_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings")), home_visits
+        return build_page_with_footer(build_home_page(home_visits=home_visits)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings")), home_visits
 
     @app.callback(
         Output("admin-home-page-visits", "children"),

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX/gui/computation.py

@@ -3,6 +3,7 @@
 
 import logging
 import json
+from base64 import b64decode
 from dataclasses import dataclass
 from math import prod
 from typing import Any, Dict
@@ -733,6 +734,16 @@ def export_result_to_csv(result: dict[str, Any] | None) -> str:
     return frame.to_csv(index=False)
 
 
+def _plotly_array(value: Any) -> np.ndarray:
+    """Read plain arrays and Plotly 6's base64 typed-array payloads."""
+    if isinstance(value, dict) and "bdata" in value:
+        array = np.frombuffer(b64decode(value["bdata"]), dtype=value["dtype"])
+        if "shape" in value:
+            array = array.reshape(tuple(int(size) for size in value["shape"].split(",")))
+        return array
+    return np.asarray(value)
+
+
 def export_single_result_to_csv(result: dict[str, Any] | None) -> str:
     """Serialize a Particle Explorer figure payload to CSV text."""
     if not result or not result.get("figure"):
@@ -743,17 +754,36 @@ def export_single_result_to_csv(result: dict[str, Any] | None) -> str:
     rows: list[dict[str, Any]] = []
     for trace in traces:
         name = trace.get("name", "value")
+        if trace.get("type") == "scatterpolar":
+            theta_values = _plotly_array(trace.get("theta", []))
+            r_values = _plotly_array(trace.get("r", []))
+            rows.extend({"series": name, "theta": theta, "r": radius} for theta, radius in zip(theta_values, r_values))
+            continue
+
         if "z" in trace:
-            z_values = np.asarray(trace["z"])
-            x_values = trace.get("x") or list(range(z_values.shape[1]))
-            y_values = trace.get("y") or list(range(z_values.shape[0]))
+            z_values = _plotly_array(trace["z"])
+            x_values = _plotly_array(trace["x"]) if "x" in trace else np.arange(z_values.shape[1])
+            y_values = _plotly_array(trace["y"]) if "y" in trace else np.arange(z_values.shape[0])
+            if trace.get("type") == "surface":
+                # Surface coordinates may be full grids; z is geometry, while
+                # surfacecolor carries the computed optical field/intensity.
+                values = _plotly_array(trace.get("surfacecolor", trace["z"]))
+                for y_index, x_index in np.ndindex(z_values.shape):
+                    rows.append({
+                        "series": name,
+                        "x": x_values[y_index, x_index] if x_values.ndim == 2 else x_values[x_index],
+                        "y": y_values[y_index, x_index] if y_values.ndim == 2 else y_values[y_index],
+                        "z": z_values[y_index, x_index],
+                        "value": values[y_index, x_index],
+                    })
+                continue
             for y_index, y_value in enumerate(y_values):
                 for x_index, x_value in enumerate(x_values):
                     rows.append({"series": name, "x": x_value, "y": y_value, "value": z_values[y_index, x_index]})
             continue
 
-        y_values = trace.get("y", [])
-        x_values = trace.get("x") or list(range(len(y_values)))
+        y_values = _plotly_array(trace.get("y", []))
+        x_values = _plotly_array(trace["x"]) if "x" in trace else np.arange(len(y_values))
         rows.extend({"series": name, "x": x_value, "value": y_value} for x_value, y_value in zip(x_values, y_values))
 
     return pd.DataFrame(rows).to_csv(index=False) if rows else ""

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX/gui/pages/home.py

@@ -1,14 +1,16 @@
 """Home page composition."""
 
 from importlib.metadata import PackageNotFoundError, version
+from math import isfinite
 
 from dash import dcc, html
 import numpy as np
 import plotly.graph_objects as go
 
 from PyMieSimX.gui.components import Card
+from PyMieSimX.gui.usage_metrics import show_public_metrics
 
-def build_home_page():
+def build_home_page(*, home_visits: int | float | None = None):
     """Build the landing page and its workflow cards."""
     return html.Div(
         className="page-content-stack",
@@ -23,10 +25,29 @@ def build_home_page():
             html.Section(
                 className="page-hero home-page-hero",
                 children=[
-                    html.H1("PyMieSim"),
-                    html.P(
-                        "An open-source library for fast and flexible far-field Mie scattering simulations.",
-                        className="hero-text",
+                    html.Div(
+                        [
+                            html.H1("PyMieSim"),
+                            html.P(
+                                "An open-source library for fast and flexible far-field Mie scattering simulations.",
+                                className="hero-text",
+                            ),
+                        ],
+                        className="home-hero-copy",
+                    ),
+                    html.Div(
+                        [
+                            _visit_metric(home_visits),
+                            html.A(
+                                [html.Span("\u2665", className="home-support-icon", **{"aria-hidden": "true"}), "Support Developer"],
+                                id="home-support-developer",
+                                href="https://github.com/sponsors/MartinPdeS",
+                                target="_blank",
+                                rel="noopener noreferrer",
+                                className="home-support-button",
+                            ),
+                        ],
+                        className="home-hero-actions",
                     ),
                 ],
             ),
@@ -58,6 +79,19 @@ def build_home_page():
         ],
     )
 
+def _visit_metric(home_visits: int | float | None):
+    """Show an available server count without displaying local or failed metrics."""
+    if not show_public_metrics() or home_visits is None or not isfinite(home_visits) or home_visits < 0:
+        return None
+    return html.Div(
+        [
+            html.Span("Webapp visits", className="home-visit-label"),
+            html.Strong(f"{int(home_visits):,}", id="home-public-visit-count", className="home-visit-value"),
+        ],
+        className="home-visit-metric",
+    )
+
+
 def _package_version() -> str:
     try:
         return version("PyMieSimX")

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX/gui/usage_metrics.py

@@ -15,6 +15,7 @@ except Exception:  # pragma: no cover - exercised through fallback behavior.
 LOGGER = logging.getLogger(__name__)
 
 METRICS_BACKEND_ENV_VAR = "PYMIESIMX_USAGE_METRICS_BACKEND"
+SHOW_METRIC_ENV_VAR = "SHOW_METRIC"
 METRICS_DATABASE_URL_ENV_VAR = "PYMIESIMX_USAGE_METRICS_DATABASE_URL"
 DATABASE_URL_ENV_VAR = "DATABASE_URL"
 METRICS_TABLE = "metrics_counters"
@@ -48,6 +49,11 @@ class UsageMetrics:
         }
 
 
+def show_public_metrics() -> bool:
+    """Expose the visit counter only when explicitly enabled for a hosted backend."""
+    return os.getenv(SHOW_METRIC_ENV_VAR, "false").strip().lower() in {"true", "1", "yes", "on"} and _use_postgres_backend()
+
+
 def load_usage_metrics() -> UsageMetrics:
     """Load hosted counters, or return unavailable values when run locally."""
     if _use_postgres_backend():

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.1.5
+Version: 0.1.6
 Summary: Graphical Dash interface for PyMieSim.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License-Expression: MIT
@@ -36,6 +36,20 @@ PyMieSimX is the standalone graphical interface for `PyMieSim
 configuring optical setups, running parameter sweeps, exploring individual
 particles, and exporting results.
 
+Try the live webapp
+----------------------
+
+**Run Mie scattering simulations in your browser—no installation required.**
+
+.. image:: https://img.shields.io/badge/Launch_Webapp-Open_in_browser-2672d6?style=for-the-badge
+   :target: https://pymiesim.onrender.com/
+   :alt: Launch the PyMieSimX webapp in your browser
+
+`Launch the PyMieSimX webapp <https://pymiesim.onrender.com/>`_ to configure
+optical setups, run parameter sweeps, explore individual particles, and download
+your results as CSV files. The hosted service provides direct access to the
+graphical interface; local installation is also available below.
+
 Source-model note
 -----------------
 
@@ -157,10 +171,19 @@ PyMieSimX writes namespaced counters to the shared ``metrics_counters`` table:
 backend is explicitly configured and available. Local installations do not
 persist usage counters.
 
+To show a small **Webapp visits** box in the homepage's top card, set this
+environment variable on the Render service and redeploy::
+
+    SHOW_METRIC=true
+
+The box is hidden by default and requires the PostgreSQL configuration above.
+It shows the total home-page visit count, including repeat visits, rather than
+unique visitors. If the database is unavailable, the box stays hidden.
+
 Administration page
 -------------------
 
-Usage counters are shown only on the hidden, token-protected administration
+Detailed usage counters are shown on the hidden, token-protected administration
 page. Configure a server-side token with::
 
     PYMIESIMX_ADMIN_TOKEN=<a long random value>

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@
 .flake8
 .gitignore
 .pre-commit-config.yaml
+AGENTS.md
 CONTRIBUTING.md
 Dockerfile
 LICENSE
@@ -82,6 +83,7 @@ tests/gui/cli.py
 tests/gui/test_admin.py
 tests/gui/test_api.py
 tests/gui/test_dash_callbacks.py
+tests/gui/test_home.py
 tests/gui/test_services.py
 tests/gui/test_usage_metrics.py
 tools/generate_home_spf.py

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX.egg-info/scm_file_list.json

@@ -10,6 +10,7 @@
     ".github/workflows/tests.yml",
     ".gitignore",
     ".pre-commit-config.yaml",
+    "AGENTS.md",
     "CONTRIBUTING.md",
     "Dockerfile",
     "LICENSE",
@@ -76,6 +77,7 @@
     "tests/gui/test_admin.py",
     "tests/gui/test_api.py",
     "tests/gui/test_dash_callbacks.py",
+    "tests/gui/test_home.py",
     "tests/gui/test_services.py",
     "tests/gui/test_usage_metrics.py",
     "tools/generate_home_spf.py",

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/PyMieSimX.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.1.5",
+  "tag": "0.1.6",
   "distance": 0,
-  "node": "gd609c6cff7e32e562d54244f48e9fe337e64b543",
+  "node": "gc49c47686da32457f0e821e18ec1838d9f9ca16d",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-10-02"

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/README.rst

@@ -6,6 +6,20 @@ PyMieSimX is the standalone graphical interface for `PyMieSim
 configuring optical setups, running parameter sweeps, exploring individual
 particles, and exporting results.
 
+Try the live webapp
+----------------------
+
+**Run Mie scattering simulations in your browser—no installation required.**
+
+.. image:: https://img.shields.io/badge/Launch_Webapp-Open_in_browser-2672d6?style=for-the-badge
+   :target: https://pymiesim.onrender.com/
+   :alt: Launch the PyMieSimX webapp in your browser
+
+`Launch the PyMieSimX webapp <https://pymiesim.onrender.com/>`_ to configure
+optical setups, run parameter sweeps, explore individual particles, and download
+your results as CSV files. The hosted service provides direct access to the
+graphical interface; local installation is also available below.
+
 Source-model note
 -----------------
 
@@ -127,10 +141,19 @@ PyMieSimX writes namespaced counters to the shared ``metrics_counters`` table:
 backend is explicitly configured and available. Local installations do not
 persist usage counters.
 
+To show a small **Webapp visits** box in the homepage's top card, set this
+environment variable on the Render service and redeploy::
+
+    SHOW_METRIC=true
+
+The box is hidden by default and requires the PostgreSQL configuration above.
+It shows the total home-page visit count, including repeat visits, rather than
+unique visitors. If the database is unavailable, the box stays hidden.
+
 Administration page
 -------------------
 
-Usage counters are shown only on the hidden, token-protected administration
+Detailed usage counters are shown on the hidden, token-protected administration
 page. Configure a server-side token with::
 
     PYMIESIMX_ADMIN_TOKEN=<a long random value>

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/conda.recipe/meta.yaml

@@ -7,7 +7,8 @@ source:
 
 build:
   number: 0
-  noarch: python
+  entry_points:
+    - pymiesimx = PyMieSimX.__main__:main
   script: "{{ PYTHON }} -m pip install . -vv --no-deps --no-build-isolation"
 
 requirements:
@@ -46,6 +47,7 @@ test:
     - pytest >=8.0
     - pytest-cov >=5.0
   commands:
+    - pymiesimx --help
     - python -m pytest --config-file=./pytest.ini
   source_files:
     - tests

pymiesimx-0.1.6/tests/browser/test_dashboard.py

@@ -0,0 +1,132 @@
+"""Small browser-level smoke suite for the critical dashboard workflow."""
+
+import pytest
+import numpy as np
+import pandas as pd
+from pathlib import Path
+from selenium.webdriver.common.keys import Keys
+from selenium.webdriver.support.ui import WebDriverWait
+
+from PyMieSimX.gui.interface import create_dash_app
+from PyMieSimX.gui.jobs import ExperimentJobManager
+
+
+@pytest.fixture(autouse=True)
+def isolated_experiment_jobs(dash_duo, monkeypatch):
+    """Finish each worker before Dash's runner tears down its server threads."""
+    manager = ExperimentJobManager()
+    monkeypatch.setattr("PyMieSimX.gui.callbacks.experiment_jobs", manager)
+    yield manager
+    manager._executor.shutdown(wait=True)
+
+
+def _wait_for_sidebar_transition(dash_duo, sidebar_id="experiment-right-sidebar"):
+    """Wait for the panel to settle before clicking its controls or the page."""
+    WebDriverWait(dash_duo.driver, 10).until(
+        lambda driver: driver.execute_script(
+            "return document.getElementById(arguments[0]).getAnimations()"
+            ".every(animation => animation.playState !== 'running')", sidebar_id,
+        )
+    )
+
+
+@pytest.mark.parametrize("viewport", [(1440, 1000), (960, 1000)], ids=["desktop", "compact"])
+def test_navigation_validation_execution_plot_and_export_controls(dash_duo, viewport):
+    # Chrome's default headless window puts Run below the visible compact header.
+    dash_duo.driver.set_window_size(*viewport)
+    dash_duo.start_server(create_dash_app())
+    dash_duo.wait_for_text_to_equal("h1", "PyMieSim")
+    assert dash_duo.find_elements(".home-metric-value") == []
+
+    dash_duo.find_element("#sidebar-link-experiment").click()
+    dash_duo.wait_for_element("#result-graph")
+    dash_duo.wait_for_element("#export-csv")
+    dash_duo.wait_for_text_to_equal("#experiment-run-status .status-banner span:last-child", "Ready. Click Run to start a sweep.")
+    dash_duo.wait_for_element("#experiment-tab-source").click()
+    dash_duo.wait_for_contains_class("#experiment-right-sidebar", "open")
+    _wait_for_sidebar_transition(dash_duo)
+    field = dash_duo.wait_for_element("#source-fields .field-input")
+
+    input_element = field if field.tag_name == "input" else field.find_element("css selector", "input")
+    input_element.click()
+    input_element.clear()
+    input_element.send_keys("-1", Keys.ENTER)
+    dash_duo.wait_for_element("#source-fields .field-input-invalid")
+    dash_duo.find_element("#experiment-tab-source").click()
+    dash_duo.wait_for_class_to_equal("#experiment-right-sidebar", "right-sidebar-panel")
+    _wait_for_sidebar_transition(dash_duo)
+    dash_duo.find_element("#run-experiment-button").click()
+    dash_duo.wait_for_element("#experiment-run-status .status-banner.error")
+    assert "wavelength" in dash_duo.find_element("#experiment-run-status").text
+
+    dash_duo.wait_for_class_to_equal("#experiment-right-sidebar", "right-sidebar-panel")
+    dash_duo.find_element("#experiment-tab-source").click()
+    dash_duo.wait_for_contains_class("#experiment-right-sidebar", "open")
+    _wait_for_sidebar_transition(dash_duo)
+    input_element.click()
+    input_element.clear()
+    input_element.send_keys("600:700:3", Keys.ENTER)
+    dash_duo.wait_for_no_elements("#source-fields .field-input-invalid")
+    dash_duo.find_element("#experiment-tab-source").click()
+    dash_duo.wait_for_class_to_equal("#experiment-right-sidebar", "right-sidebar-panel")
+    _wait_for_sidebar_transition(dash_duo)
+    for measure in ("Qabs", "Qext"):
+        dash_duo.select_dcc_dropdown("#measure-select", measure)
+        dash_duo.find_element(".graph-axis-title").click()
+    dash_duo.find_element("#run-experiment-button").click()
+    dash_duo.wait_for_element("#experiment-run-status .status-banner.success", timeout=30)
+    assert "6 result rows" in dash_duo.find_element("#experiment-run-status").text
+    assert dash_duo.find_element("#run-experiment-button").is_enabled()
+    assert dash_duo.find_element("#export-csv").is_enabled()
+    dash_duo.wait_for_element("#result-graph .scatterlayer .trace")
+    groups = dash_duo.driver.execute_script("return document.querySelector('#result-graph .js-plotly-plot').data.map(trace => trace.legendgroup)")
+    assert set(groups) == {"Qsca", "Qabs", "Qext"}
+
+    dash_duo.find_element("#sidebar-link-single").click()
+    dash_duo.wait_for_element("#single-graph .plotly")
+    dash_duo.wait_for_element("#export-single-csv")
+
+
+@pytest.mark.parametrize("representation, projection, columns, row_count", [
+    ("S1 / S2 amplitudes", None, ["series", "x", "value"], 48),
+    ("Stokes I intensity", "2D heatmap", ["series", "x", "y", "value"], 576),
+    ("Stokes I intensity", "3D radial surface", ["series", "x", "y", "z", "value"], 576),
+])
+def test_particle_explorer_downloads_csv(dash_duo, representation, projection, columns, row_count):
+    dash_duo.driver.set_window_size(1440, 1000)
+    dash_duo.start_server(create_dash_app())
+    dash_duo.find_element("#sidebar-link-single").click()
+    dash_duo.wait_for_element("#export-single-csv")
+    assert not dash_duo.find_element("#export-single-csv").is_enabled()
+    dash_duo.select_dcc_dropdown("#single-representation", representation)
+    if projection:
+        dash_duo.find_element("#single-tab-plot-options").click()
+        dash_duo.wait_for_contains_class("#single-right-sidebar", "open")
+        _wait_for_sidebar_transition(dash_duo, "single-right-sidebar")
+        dash_duo.select_dcc_dropdown("#single-projection", projection)
+        dash_duo.find_element("#single-tab-plot-options").click()
+        dash_duo.wait_for_class_to_equal("#single-right-sidebar", "right-sidebar-panel")
+        _wait_for_sidebar_transition(dash_duo, "single-right-sidebar")
+    sampling = dash_duo.find_element("#single-sampling")
+    sampling.clear()
+    sampling.send_keys("24", Keys.ENTER)
+    dash_duo.find_element("#run-single-button").click()
+    WebDriverWait(dash_duo.driver, 30).until(lambda _: dash_duo.find_element("#export-single-csv").is_enabled())
+    dash_duo.find_element("#export-single-csv").click()
+    downloaded = Path(dash_duo.download_path) / "pymiesim_particle_explorer.csv"
+    WebDriverWait(dash_duo.driver, 10).until(lambda _: downloaded.exists() and downloaded.stat().st_size > 0)
+    frame = pd.read_csv(downloaded)
+    assert list(frame.columns) == columns
+    assert len(frame) == row_count
+    assert np.isfinite(frame[columns[1:]].to_numpy()).all()
+    if representation == "S1 / S2 amplitudes":
+        assert set(frame.series) == {"|S1|", "|S2|"}
+        assert frame.x.min() == pytest.approx(-180)
+        assert frame.x.max() == pytest.approx(180)
+    elif projection == "2D heatmap":
+        assert frame.x.nunique() == 24
+        assert frame.y.nunique() == 24
+    else:
+        assert (frame.value >= 0).all()
+        assert frame.value.nunique() > 1
+    assert dash_duo.get_logs() == []

{pymiesimx-0.1.5 → pymiesimx-0.1.6}/tests/gui/test_dash_callbacks.py

@@ -1,7 +1,11 @@
 """Integration tests for registered Dash callback behavior."""
 
 from math import isnan
+from io import StringIO
 
+import numpy as np
+import pandas as pd
+import plotly.graph_objects as go
 import pytest
 from dash import no_update
 
@@ -46,6 +50,17 @@ def test_navigation_and_local_metrics(monkeypatch):
     assert callbacks._counter(float("nan")) == 0
 
 
+def test_home_route_uses_newly_recorded_server_count(monkeypatch):
+    application = create_dash_app()
+    monkeypatch.setattr(usage_metrics, "record_home_page_visit", lambda: usage_metrics.UsageMetrics(home_page_visit_count=4321))
+    displayed = []
+    original = callbacks.build_home_page
+    monkeypatch.setattr(callbacks, "build_home_page", lambda **kwargs: displayed.append(kwargs["home_visits"]) or original(**kwargs))
+    home = _callback(application, "_route_pages")("/", "", 999999, 0, 0, {"theme": "light"}, {})
+    assert home[-1] == 4321
+    assert displayed == [4321]
+
+
 def test_validation_submission_cancellation_and_polling(monkeypatch):
     application = create_dash_app()
     validate = _callback(application, "_validate_fields")
@@ -105,6 +120,44 @@ def test_plot_and_csv_callbacks():
     assert "Qsca" in download["content"]
 
 
+@pytest.mark.parametrize("encoded", [False, True], ids=["plain", "typed-arrays"])
+@pytest.mark.parametrize("kind", ["scatter", "implicit-x", "scatterpolar", "heatmap", "surface"])
+def test_particle_explorer_csv_preserves_coordinates_and_values(kind, encoded):
+    def array(values):
+        return np.array(values, dtype=float) if encoded else values
+
+    if kind in {"scatter", "implicit-x", "scatterpolar"}:
+        x, y = [10, 20, 40], [1, 3, 7]
+        if kind == "scatterpolar":
+            trace = go.Scatterpolar(theta=array(x), r=array(y), name="field")
+            expected = {"series": ["field"] * 3, "theta": x, "r": y}
+        else:
+            trace = go.Scatter(y=array(y), name="field")
+            if kind == "scatter":
+                trace.x = array(x)
+            expected = {"series": ["field"] * 3, "x": x if kind == "scatter" else [0, 1, 2], "value": y}
+    elif kind == "heatmap":
+        trace = go.Heatmap(x=array([10, 20, 40]), y=array([-5, 15]), z=array([[1, 2, 3], [7, 8, 9]]), name="field")
+        expected = {"series": ["field"] * 6, "x": [10, 20, 40] * 2, "y": [-5] * 3 + [15] * 3, "value": [1, 2, 3, 7, 8, 9]}
+    else:
+        trace = go.Surface(
+            x=array([[10, 20, 40], [50, 60, 80]]), y=array([[-5, -4, -3], [15, 16, 17]]),
+            z=array([[1, 2, 3], [7, 8, 9]]), surfacecolor=array([[11, 12, 13], [21, 22, 23]]), name="field",
+        )
+        expected = {
+            "series": ["field"] * 6, "x": [10, 20, 40, 50, 60, 80], "y": [-5, -4, -3, 15, 16, 17],
+            "z": [1, 2, 3, 7, 8, 9], "value": [11, 12, 13, 21, 22, 23],
+        }
+
+    result = {"figure": go.Figure(trace).to_plotly_json()}
+    export = _callback(create_dash_app(), "_export_single_csv")
+    assert export(0, result) is no_update
+    assert export(1, None) is no_update
+    download = export(1, result)
+    assert download["filename"] == "pymiesim_particle_explorer.csv"
+    pd.testing.assert_frame_equal(pd.read_csv(StringIO(download["content"])), pd.DataFrame(expected), check_dtype=False)
+
+
 @pytest.mark.parametrize("selected, expected", [
     ("Qsca", ["Qsca"]),
     (["Qsca", "coupling", "Qext"], ["Qsca", "Qext"]),

pymiesimx-0.1.6/tests/gui/test_home.py

@@ -0,0 +1,41 @@
+"""Public visit metrics must be explicitly enabled for a hosted backend."""
+
+import pytest
+
+from PyMieSimX.gui import usage_metrics
+from PyMieSimX.gui.pages.home import build_home_page
+
+
+def _visit_values(component):
+    if getattr(component, "id", None) == "home-public-visit-count":
+        yield component.children
+    children = getattr(component, "children", None)
+    for child in children if isinstance(children, (list, tuple)) else [children]:
+        if child is not None and not isinstance(child, (str, int, float)):
+            yield from _visit_values(child)
+
+
+@pytest.mark.parametrize("flag,backend,database", [
+    (None, "postgres", "postgresql://example/metrics"),
+    ("false", "postgres", "postgresql://example/metrics"),
+    ("true", "file", ""),
+    ("true", "postgres", ""),
+])
+def test_visit_box_hidden_without_explicit_hosted_configuration(monkeypatch, flag, backend, database):
+    monkeypatch.delenv("SHOW_METRIC", raising=False)
+    if flag is not None:
+        monkeypatch.setenv("SHOW_METRIC", flag)
+    monkeypatch.setenv("PYMIESIMX_USAGE_METRICS_BACKEND", backend)
+    monkeypatch.setenv("DATABASE_URL", database)
+    monkeypatch.delenv("PYMIESIMX_USAGE_METRICS_DATABASE_URL", raising=False)
+    monkeypatch.setattr(usage_metrics, "psycopg", object())
+    assert list(_visit_values(build_home_page(home_visits=1234))) == []
+
+
+@pytest.mark.parametrize("count,expected", [(0, ["0"]), (12345, ["12,345"]), (float("nan"), []), (None, []), (-1, [])])
+def test_hosted_visit_box_formats_available_counts(monkeypatch, count, expected):
+    monkeypatch.setenv("SHOW_METRIC", "true")
+    monkeypatch.setenv("PYMIESIMX_USAGE_METRICS_BACKEND", "postgres")
+    monkeypatch.setenv("PYMIESIMX_USAGE_METRICS_DATABASE_URL", "postgresql://example/metrics")
+    monkeypatch.setattr(usage_metrics, "psycopg", object())
+    assert list(_visit_values(build_home_page(home_visits=count))) == expected

pymiesimx-0.1.5/tests/browser/test_dashboard.py

@@ -1,50 +0,0 @@
-"""Small browser-level smoke suite for the critical dashboard workflow."""
-
-from selenium.webdriver.common.keys import Keys
-
-from PyMieSimX.gui.interface import create_dash_app
-
-
-def test_navigation_validation_execution_plot_and_export_controls(dash_duo):
-    dash_duo.start_server(create_dash_app())
-    dash_duo.wait_for_text_to_equal("h1", "PyMieSim")
-    assert dash_duo.find_elements(".home-metric-value") == []
-
-    dash_duo.find_element("#sidebar-link-experiment").click()
-    dash_duo.wait_for_element("#result-graph")
-    dash_duo.wait_for_element("#export-csv")
-    dash_duo.wait_for_text_to_equal("#experiment-run-status .status-banner span:last-child", "Ready. Click Run to start a sweep.")
-    dash_duo.wait_for_element("#experiment-tab-source").click()
-    dash_duo.wait_for_contains_class("#experiment-right-sidebar", "open")
-    field = dash_duo.wait_for_element("#source-fields .field-input")
-
-    input_element = field if field.tag_name == "input" else field.find_element("css selector", "input")
-    input_element.click()
-    input_element.send_keys(Keys.CONTROL, "a")
-    input_element.send_keys("-1", Keys.ENTER)
-    dash_duo.wait_for_element("#source-fields .field-input-invalid")
-    dash_duo.find_element("#run-experiment-button").click()
-    dash_duo.wait_for_element("#experiment-run-status .status-banner.error")
-    assert "wavelength" in dash_duo.find_element("#experiment-run-status").text
-
-    dash_duo.wait_for_class_to_equal("#experiment-right-sidebar", "right-sidebar-panel")
-    dash_duo.find_element("#experiment-tab-source").click()
-    dash_duo.wait_for_contains_class("#experiment-right-sidebar", "open")
-    input_element.click()
-    input_element.send_keys(Keys.CONTROL, "a")
-    input_element.send_keys("600:700:3", Keys.ENTER)
-    for measure in ("Qabs", "Qext"):
-        dash_duo.select_dcc_dropdown("#measure-select", measure)
-        dash_duo.find_element(".graph-axis-title").click()
-    dash_duo.find_element("#run-experiment-button").click()
-    dash_duo.wait_for_element("#experiment-run-status .status-banner.success", timeout=30)
-    assert "6 result rows" in dash_duo.find_element("#experiment-run-status").text
-    assert dash_duo.find_element("#run-experiment-button").is_enabled()
-    assert dash_duo.find_element("#export-csv").is_enabled()
-    dash_duo.wait_for_element("#result-graph .scatterlayer .trace")
-    groups = dash_duo.driver.execute_script("return document.querySelector('#result-graph .js-plotly-plot').data.map(trace => trace.legendgroup)")
-    assert set(groups) == {"Qsca", "Qabs", "Qext"}
-
-    dash_duo.find_element("#sidebar-link-single").click()
-    dash_duo.wait_for_element("#single-graph .plotly")
-    dash_duo.wait_for_element("#export-single-csv")