PyMieSimX 0.1.4__tar.gz → 0.1.6__tar.gz

{pymiesimx-0.1.4 → 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.4 → 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.4 → 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.4 → 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.4 → pymiesimx-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.1.4
+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.4 → 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.4 → 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"),
@@ -690,6 +690,10 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
         State("single-include-incident-field", "value"),
         State("single-run-count", "data"),
         prevent_initial_call=True,
+        running=[
+            (Output("single-graph-loading", "display"), "show", "auto"),
+            (Output("run-single-button", "disabled"), True, False),
+        ],
     )
     def _run_single(
         _run_clicks: int,
@@ -732,6 +736,13 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             LOGGER.exception("Failed to record PyMieSimX particle-explorer metric.")
         return execution.result, execution.run_count
 
+    @app.callback(
+        Output("result-graph-loading", "display"),
+        Input("run-experiment-button", "disabled"),
+    )
+    def _show_experiment_computing(run_disabled: bool):
+        return "show" if run_disabled else "auto"
+
     @app.callback(
         Output("single-representation", "options"),
         Output("single-representation", "value"),

{pymiesimx-0.1.4 → 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
@@ -336,7 +337,8 @@ def build_single_figure(
         colorscale = PYMIESIM_BLUE_BLACK_RED
         x = np.asarray(nearfields.u.to(ureg.nanometer).magnitude, dtype=float)
         y = np.asarray(nearfields.v.to(ureg.nanometer).magnitude, dtype=float)
-        heatmap_kwargs = {"x": x, "y": y, "z": values, "colorscale": colorscale, "colorbar": {"title": "V/m"}}
+        # PyMieSim indexes fields as (u, v); Plotly indexes z as (y, x).
+        heatmap_kwargs = {"x": x, "y": y, "z": values.T, "colorscale": colorscale, "colorbar": {"title": "V/m"}}
         if not is_absolute:
             maximum = float(np.max(np.abs(values)))
             maximum = maximum if maximum > 0 else 1.0
@@ -732,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"):
@@ -742,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.4 → 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.4 → 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.4 → pymiesimx-0.1.6}/PyMieSimX.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.1.4
+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.4 → 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.4 → 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.4 → pymiesimx-0.1.6}/PyMieSimX.egg-info/scm_version.json

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

{pymiesimx-0.1.4 → 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.4 → 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