PyMieSimX 0.2.2__tar.gz → 0.3.0__tar.gz

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.2.2
+Version: 0.3.0
 Summary: Graphical Dash interface for PyMieSim.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License-Expression: MIT
@@ -50,6 +50,15 @@ 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.
 
+Examples
+--------
+
+The **Examples** page provides six starting points: gold and silver nanoparticle
+resonances, a silica size sweep, gold nanoshells, a bead's angular scattering,
+and a polydisperse silica suspension. Each card links to its simulation
+workspace, restores the complete setup, and runs automatically to show results.
+The parameters can then be adjusted and the results exported as CSV.
+
 Sharing simulations
 -------------------
 
@@ -58,8 +67,8 @@ Optics to share the current setup. Links preserve the input values, sweep
 ranges, selected measures, and plot settings without requiring an account.
 Opening a link restores the setup and automatically runs the simulation once
 the inputs and plot settings are ready. Later edits can be calculated with
-**Run**. If clipboard access is unavailable, use **Show simulation
-link** and copy the displayed URL.
+**Run**. Copying puts the link directly on the clipboard and briefly shows
+**Copied** on the button without displaying an additional card.
 
 Links store the configuration rather than a result snapshot. Recalculation
 uses the installed solver and optical material data, so results can change

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/assets/dashboard.css

@@ -4077,9 +4077,43 @@ html .single-workspace .representation-card {
     .workspace-header .eyebrow { min-height: 2lh; }
     .workspace-header .hero-text { min-height: 4lh; }
 }
+@media (max-width: 380px) {
+    .workspace-header .eyebrow { min-height: 3lh; }
+    .workspace-header .hero-text { min-height: 6lh; }
+}
 
-.simulation-share-feedback { display: grid; gap: 8px; font-size: .86rem; color: var(--muted); }
 .simulation-share-actions { display: contents; }
-.simulation-share-feedback:empty { display: none; }
-.simulation-share-feedback .field-input { width: 100%; min-width: 0; }
+.simulation-copy-button { display: inline-grid; }
+.simulation-copy-button > span { grid-area: 1 / 1; }
+.simulation-copy-pending-label,
+.simulation-copy-success-label,
+.simulation-copy-error-label { visibility: hidden; }
+.simulation-copy-pending .simulation-copy-label,
+.simulation-copy-success .simulation-copy-label,
+.simulation-copy-error .simulation-copy-label { visibility: hidden; }
+.simulation-copy-pending > .simulation-copy-pending-label,
+.simulation-copy-success > .simulation-copy-success-label,
+.simulation-copy-error > .simulation-copy-error-label { visibility: visible; }
+.simulation-copy-button:active { transform: translateY(1px); }
+.simulation-copy-button.simulation-copy-success { background: rgba(25, 135, 84, .12); border-color: #198754; color: #198754; }
+.simulation-copy-button.simulation-copy-error { background: rgba(190, 50, 50, .10); border-color: #be3232; color: #be3232; }
 .simulation-link-notice { padding: 10px 14px; border: 1px solid var(--line); border-radius: 8px; color: var(--ink); }
+
+.examples-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 18px; }
+.example-card { display: flex; flex-direction: column; gap: 14px; padding: 22px; min-width: 0; }
+.example-card-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.example-number { font-size: 1.7rem; font-weight: 700; color: var(--accent); }
+.example-topic { font-size: .75rem; color: var(--muted); text-align: right; }
+.example-card h2 { margin: 0; font-size: 1.2rem; line-height: 1.3; }
+.example-description, .example-observe p { margin: 0; font-size: .88rem; line-height: 1.6; color: var(--muted); }
+.example-parameters { margin: 0; display: grid; gap: 8px; padding: 12px; background: var(--panel); border: 1px solid var(--line); border-radius: 8px; }
+.example-parameters dt { font-size: .72rem; color: var(--muted); }
+.example-parameters dd { margin: 2px 0 0; font-size: .84rem; overflow-wrap: anywhere; }
+.example-observe { flex: 1; }
+.example-observe strong { display: block; margin-bottom: 4px; font-size: .8rem; }
+.example-reference { font-size: .72rem; color: var(--muted); }
+.example-card-actions { display: grid; gap: 8px; padding-top: 12px; border-top: 1px solid var(--line); }
+.example-card-actions > span { font-size: .72rem; color: var(--muted); }
+.example-open { text-decoration: none; text-align: center; white-space: normal; }
+@media (max-width: 1250px) { .examples-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
+@media (max-width: 700px) { .examples-grid { grid-template-columns: minmax(0, 1fr); } }

pymiesimx-0.3.0/PyMieSimX/gui/assets/simulation-sharing.js

@@ -0,0 +1,85 @@
+window.dash_clientside = Object.assign({}, window.dash_clientside, {
+    simulation_sharing: {
+        copy_feedback: function(clicks, status) {
+            const sharing = window.dash_clientside.simulation_sharing;
+            const base = 'toolbar-button toolbar-button-secondary simulation-copy-button';
+            const title = 'Copy a link to this simulation setup';
+            window.clearTimeout(sharing.feedbackTimer);
+            if (!clicks) return [base, title];
+            if (!status || status.clicks !== clicks) {
+                return [base + ' simulation-copy-pending', 'Copying the simulation link…'];
+            }
+            const button = document.getElementById('simulation-clipboard');
+            sharing.feedbackTimer = window.setTimeout(function() {
+                if (document.getElementById('simulation-clipboard') === button) {
+                    window.dash_clientside.set_props('simulation-clipboard', {className: base, title: title});
+                }
+            }, 2000);
+            return status.copied
+                ? [base + ' simulation-copy-success', 'Simulation link copied to clipboard']
+                : [base + ' simulation-copy-error', 'Unable to copy. Try again or check clipboard permissions.'];
+        },
+        copy_link: async function(link) {
+            if (!link) return window.dash_clientside.no_update;
+            if (!link.url) return {clicks: link.clicks, copied: false};
+            if (window.isSecureContext && navigator.clipboard && navigator.clipboard.writeText) {
+                try {
+                    await navigator.clipboard.writeText(link.url);
+                    return {clicks: link.clicks, copied: true};
+                } catch (error) {
+                    // Older browsers and denied clipboard permissions can
+                    // still support copying through the document selection.
+                }
+            }
+            const field = document.createElement('textarea');
+            const focused = document.activeElement;
+            field.value = link.url;
+            field.setAttribute('readonly', '');
+            field.style.cssText = 'position:fixed;top:0;left:0;opacity:0;pointer-events:none;';
+            document.body.appendChild(field);
+            let copied = false;
+            try {
+                field.select();
+                copied = document.execCommand('copy');
+            } catch (error) {
+                copied = false;
+            } finally {
+                field.remove();
+                if (focused && focused.focus) focused.focus({preventScroll: true});
+            }
+            return {clicks: link.clicks, copied: copied};
+        },
+        auto_run: function(config, fieldIds, fieldValues, fieldClasses, settings) {
+            const unchanged = window.dash_clientside.no_update;
+            if (!config || config.started) return [unchanged, unchanged];
+            const values = Array.prototype.slice.call(arguments, 5);
+            const clicks = values.pop();
+            if (clicks) return [unchanged, Object.assign({}, config, {started: true})];
+
+            const actual = {};
+            config.control_names.forEach((name, index) => { actual[name] = values[index]; });
+            (fieldIds || []).forEach((id, index) => {
+                const ordered = {};
+                Object.keys(id).sort().forEach(key => { ordered[key] = id[key]; });
+                actual[JSON.stringify(ordered)] = fieldValues[index];
+            });
+            // Field classes depend on the existing validation callbacks; this
+            // also waits for dynamic fields and material-mode restoration.
+            if (!fieldClasses || fieldClasses.length < config.field_keys.length ||
+                !config.field_keys.every(key => Object.prototype.hasOwnProperty.call(actual, key))) {
+                return [unchanged, unchanged];
+            }
+            const same = (left, right) => JSON.stringify(left) === JSON.stringify(right);
+            if (!Object.entries(config.expected_controls).every(([key, value]) => same(actual[key], value))) {
+                return [unchanged, unchanged];
+            }
+            const plot = (settings || {})[config.workspace] || {};
+            if (!Object.entries(config.plot_settings).every(([key, value]) => same(plot[key], value))) {
+                return [unchanged, unchanged];
+            }
+            // Both outputs update together. Later edits and callback updates
+            // see the started flag and cannot launch a second automatic run.
+            return [1, Object.assign({}, config, {started: true})];
+        }
+    }
+});

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/callbacks.py

@@ -14,6 +14,7 @@ from PyMieSimX.gui.pages.sellmeier import build_sellmeier_page
 from PyMieSimX.gui.pages.field_syntax import build_field_syntax_page
 from PyMieSimX.gui.pages.citation import build_citation_page
 from PyMieSimX.gui.pages.home import build_home_page
+from PyMieSimX.gui.pages.examples import build_examples_page
 from PyMieSimX.gui.pages.install_local import build_install_local_page
 from PyMieSimX.gui.pages.experiment import build_experiment_page
 from PyMieSimX.gui.pages.settings import build_settings_page
@@ -182,6 +183,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
         Output("sidebar-link-single", "className"),
         Output("sidebar-link-documentation", "className"),
         Output("sidebar-link-settings", "className"),
+        Output("sidebar-link-examples", "className"),
         Output("sidebar-link-population", "className"),
         Output("home-visit-count", "data"),
         Input("url", "pathname"),
@@ -216,6 +218,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             "single": "sidebar-link",
             "documentation": "sidebar-link",
             "settings": "sidebar-link",
+            "examples": "sidebar-link",
             "population": "sidebar-link",
         }
         home_visits = _counter(home_visits)
@@ -228,36 +231,39 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
                 home_visits = float("nan")
         if route == "/admin":
             token = parse_qs((search or "").lstrip("?")).get("token", [None])[0]
-            return build_page_with_footer(build_admin_page(token)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_admin_page(token)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
+        if route == "/examples":
+            active["examples"] += " active"
+            return build_page_with_footer(build_examples_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/documentation":
             active["documentation"] += " active"
-            return build_page_with_footer(build_documentation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_documentation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/citation":
             active["home"] += " active"
-            return build_page_with_footer(build_citation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_citation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/documentation/install-local":
             active["documentation"] += " active"
-            return build_page_with_footer(build_install_local_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_install_local_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/documentation/sellmeier":
             active["documentation"] += " active"
-            return build_page_with_footer(build_sellmeier_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_sellmeier_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/documentation/field-syntax":
             active["documentation"] += " active"
-            return build_page_with_footer(build_field_syntax_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_field_syntax_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/settings":
             active["settings"] += " active"
-            return build_page_with_footer(build_settings_page((theme_store or {}).get("theme", "light"), plot_settings or {})), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return build_page_with_footer(build_settings_page((theme_store or {}).get("theme", "light"), plot_settings or {})), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/single":
             active["single"] += " active"
-            return simulation_page(build_single_page((plot_settings or {}).get("particle_explorer", {}), setup)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return simulation_page(build_single_page((plot_settings or {}).get("particle_explorer", {}), setup)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/population":
             active["population"] += " active"
-            return simulation_page(build_population_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return simulation_page(build_population_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         if route == "/experiment":
             active["experiment"] += " active"
-            return simulation_page(build_experiment_page(default_measure_options, plot_settings or {}, setup)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+            return simulation_page(build_experiment_page(default_measure_options, plot_settings or {}, setup)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
         active["home"] += " active"
-        return build_page_with_footer(build_home_page(home_visits=home_visits)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+        return build_page_with_footer(build_home_page(home_visits=home_visits)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "examples", "population")), home_visits
 
     @app.callback(
         Output("admin-home-page-visits", "children"),

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/layout.py

@@ -310,6 +310,7 @@ def _build_sidebar():
                     _sidebar_link("Single Scatterer", "/single"),
                     _sidebar_link("Parameter Scan", "/experiment"),
                     _sidebar_link("Ensemble Optics", "/population"),
+                    _sidebar_link("Examples", "/examples"),
                     _sidebar_link("Documentation", "/documentation"),
                     _sidebar_link("Settings", "/settings"),
                 ],

pymiesimx-0.3.0/PyMieSimX/gui/pages/examples.py

@@ -0,0 +1,140 @@
+"""Curated examples that open reproducible, automatically run simulations."""
+
+from urllib.parse import urlencode
+
+from dash import html
+
+from PyMieSimX.gui.components import Card
+from PyMieSimX.gui.defaults import DEFAULT_PLOT_SETTINGS
+from PyMieSimX.gui.schemas import SECTION_FIELDS, SINGLE_SOURCE_FIELDS, SINGLE_SCATTERER_FIELDS
+from PyMieSimX.gui.sharing import control_key, encode_simulation
+
+
+GOLD = "main/Au/Olmon-ev"
+SILVER = "main/Ag/Johnson"
+SILICA = "main/SiO2/Malitson"
+
+
+def _fields(section, specs, values):
+    return {control_key({"kind": "field", "section": section, "name": spec.name}):
+            values.get(spec.name, spec.default) for spec in specs}
+
+
+def _sweep(wavelength, particles, *, model="SphereSet", axis="wavelength", measures=None):
+    controls = {
+        "source-type": "PlaneWaveSet", "scatterer-type": model, "detector-type": "None",
+        "measure-select": measures or ["Qsca", "Qabs", "Qext"],
+        "x-axis-select": axis, "plot-experiment-projection": "cartesian",
+        **_fields("source", SECTION_FIELDS["source"]["PlaneWaveSet"], {"wavelength": wavelength}),
+        **_fields("scatterer", SECTION_FIELDS["scatterer"][model], particles),
+    }
+    return {"v": 1, "page": "/experiment", "controls": controls, "plot_settings": dict(DEFAULT_PLOT_SETTINGS)}
+
+
+def _angular():
+    controls = {
+        "single-source-type": "PlaneWave", "single-scatterer-type": "Sphere",
+        "single-representation": "s1s2", "single-projection": "polar_1d", "single-sampling": "180",
+        "single-nearfield-mode": ["absolute"], "single-include-incident-field": ["include"],
+        **_fields("single-source", SINGLE_SOURCE_FIELDS["PlaneWave"], {"wavelength": "633"}),
+        **_fields("single-scatterer", SINGLE_SCATTERER_FIELDS["Sphere"], {
+            "diameter": "1000", "material": "organic/polystyrene/Sultanova", "medium": "1.33"}),
+    }
+    return {"v": 1, "page": "/single", "controls": controls, "plot_settings": dict(DEFAULT_PLOT_SETTINGS)}
+
+
+def _suspension():
+    controls = {f"population-{name}": value for name, value in {
+        "wavelength": "633", "distribution": "lognormal", "diameter": "500", "width": "1.25",
+        "minimum": "100", "maximum": "1500", "sampling": "96", "concentration-basis": "number",
+        "concentration": "1e8",
+    }.items()}
+    controls.update({control_key({"kind": "field", "section": "population", "name": name}): value
+                     for name, value in {"material": SILICA, "medium": "1.33"}.items()})
+    return {"v": 1, "page": "/population", "controls": controls, "plot_settings": {}}
+
+
+EXAMPLES = (
+    {
+        "id": "gold-resonance", "title": "Gold nanoparticle resonances", "topic": "Plasmonics", "color": "yellow",
+        "description": "Compare the scattering, absorption, and extinction spectra of a gold nanosphere in water.",
+        "observe": "Find the extinction peak and compare the contributions of scattering and absorption.",
+        "parameters": [("Particle", "80 nm gold sphere"), ("Wavelength", "400–850 nm · 181 points"), ("Medium", "n = 1.33")],
+        "setup": _sweep("400:850:181", {"diameter": "80", "material": GOLD, "medium": "1.33"}),
+        "reference": ("Gold optical data · Olmon", "https://refractiveindex.info/?shelf=main&book=Au&page=Olmon-ev"),
+    },
+    {
+        "id": "silver-resonance", "title": "Silver nanoparticle resonances", "topic": "Plasmonics", "color": "cyan",
+        "description": "Explore the wavelength-dependent response of a silver nanosphere immersed in water.",
+        "observe": "Locate the resonance and compare its spectral shape with the gold example.",
+        "parameters": [("Particle", "60 nm silver sphere"), ("Wavelength", "300–650 nm · 141 points"), ("Medium", "n = 1.33")],
+        "setup": _sweep("300:650:141", {"diameter": "60", "material": SILVER, "medium": "1.33"}),
+        "reference": ("Silver optical data · Johnson & Christy", "https://refractiveindex.info/?shelf=main&book=Ag&page=Johnson"),
+    },
+    {
+        "id": "silica-size", "title": "From Rayleigh to Mie scattering", "topic": "Particle size", "color": "blue",
+        "description": "Sweep the diameter of a silica sphere at a fixed wavelength to explore how scattering changes with size.",
+        "observe": "Follow the transition from weak small-particle scattering to the oscillations of larger spheres.",
+        "parameters": [("Particle", "Silica · 30–1600 nm diameter"), ("Wavelength", "633 nm"), ("Medium", "n = 1.00")],
+        "setup": _sweep("633", {"diameter": "30:1600:160", "material": SILICA, "medium": "1.0"},
+                        axis="diameter", measures=["Qsca", "Qext"]),
+        "reference": ("Silica optical data · Malitson", "https://refractiveindex.info/?shelf=main&book=SiO2&page=Malitson"),
+    },
+    {
+        "id": "gold-nanoshell", "title": "Tune a gold nanoshell", "topic": "Core–shell particles", "color": "purple",
+        "description": "Compare three gold shell thicknesses around the same silica core across a wavelength sweep.",
+        "observe": "Compare the extinction peaks as the shell thickness changes while the core diameter stays fixed.",
+        "parameters": [("Core", "80 nm silica diameter"), ("Gold shell", "5, 15, and 30 nm thick"), ("Wavelength", "450–1100 nm · n = 1.33")],
+        "setup": _sweep("450:1100:161", {"core_diameter": "80", "shell_thickness": "5,15,30",
+                         "core_material": SILICA, "shell_material": GOLD, "medium": "1.33"}, model="CoreShellSet"),
+        "reference": ("Gold optical data · Olmon", "https://refractiveindex.info/?shelf=main&book=Au&page=Olmon-ev"),
+    },
+    {
+        "id": "bead-angular", "title": "Where does a bead scatter light?", "topic": "Angular scattering", "color": "green",
+        "description": "Inspect the two angular scattering amplitudes of a micrometre-sized polystyrene bead in water.",
+        "observe": "Compare |S1| and |S2| in the polar plot to explore angular lobes and polarization dependence.",
+        "parameters": [("Particle", "1 µm polystyrene bead"), ("Wavelength", "633 nm · linear polarization"), ("View", "Polar S1 / S2 amplitudes · n = 1.33")],
+        "setup": _angular(),
+        "reference": ("Polystyrene optical data · Sultanova", "https://refractiveindex.info/?shelf=organic&book=polystyrene&page=Sultanova"),
+    },
+    {
+        "id": "silica-suspension", "title": "Optics of a silica suspension", "topic": "Ensemble optics", "color": "blue",
+        "description": "Combine a lognormal size distribution and concentration to calculate the optical properties of a dilute suspension.",
+        "observe": "Inspect scattering and absorption coefficients, albedo, and the scattering-weighted anisotropy.",
+        "parameters": [("Distribution", "500 nm median · GSD 1.25"), ("Concentration", "10⁸ particles/mL"), ("Illumination", "633 nm · n = 1.33")],
+        "setup": _suspension(),
+        "reference": ("Silica optical data · Malitson", "https://refractiveindex.info/?shelf=main&book=SiO2&page=Malitson"),
+    },
+)
+
+
+def example_link(example):
+    """Build a portable link using the same format as user-shared simulations."""
+    setup = example["setup"]
+    return setup["page"] + "?" + urlencode({"simulation": encode_simulation(setup)})
+
+
+def build_examples_page():
+    """Show six independent starting points without computing on page load."""
+    return html.Div(className="page-content-stack examples-page", children=[
+        html.Section(className="page-hero", children=[
+            html.P("Start with a physical question", className="eyebrow"),
+            html.H1("Examples"),
+            html.P("Six ready-to-run simulations. Open an example to restore its setup, run it automatically, and explore the results.", className="hero-text"),
+        ]),
+        html.Div(className="examples-grid", children=[_example_card(example, index) for index, example in enumerate(EXAMPLES, 1)]),
+    ])
+
+
+def _example_card(example, index):
+    workspace = {"/experiment": "Parameter Scan", "/single": "Single Scatterer", "/population": "Ensemble Optics"}[example["setup"]["page"]]
+    reference_label, reference_url = example["reference"]
+    return html.Article(id=f"example-{example['id']}", className=Card.classes(color=example["color"], extra="example-card"), children=[
+        html.Div(className="example-card-heading", children=[html.Span(f"{index:02d}", className="example-number"), html.Span(example["topic"], className="example-topic")]),
+        html.H2(example["title"]),
+        html.P(example["description"], className="example-description"),
+        html.Dl(className="example-parameters", children=[html.Div([html.Dt(label), html.Dd(value)]) for label, value in example["parameters"]]),
+        html.Div(className="example-observe", children=[html.Strong("What to look for"), html.P(example["observe"])]),
+        html.A(reference_label, href=reference_url, target="_blank", rel="noopener noreferrer", className="example-reference"),
+        html.Div(className="example-card-actions", children=[html.Span(workspace), html.A("Open simulation & results →", href=example_link(example), className="example-open toolbar-button toolbar-button-primary")]),
+    ])

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/pages/experiment/page.py

@@ -3,7 +3,7 @@
 
 from dash import dcc, html
 
-from PyMieSimX.gui.sharing import sharing_controls, sharing_feedback
+from PyMieSimX.gui.sharing import sharing_controls
 from PyMieSimX.gui.components.cards import workspace_header
 
 from PyMieSimX.gui.callback_helpers import status_banner
@@ -56,7 +56,6 @@ def build_experiment_page(default_measure_options: list[str], plot_settings: dic
                                 className="experiment-run-feedback",
                                 children=status_banner("idle", "Ready. Click Run to start a sweep."),
                             ),
-                            sharing_feedback(),
                             _x_axis_card(default_measure_options),
                             html.Section(className="panel graph-panel", children=[dcc.Loading(id="result-graph-loading", type="circle", color="#4f8df7", custom_spinner=html.Div("Computing…", className="plot-computing-indicator"), delay_show=150, delay_hide=150, children=dcc.Graph(id="result-graph", config=PLOT_CONFIG))]),
                         ],

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/pages/population.py

@@ -5,7 +5,7 @@ import logging
 from dash import Input, Output, State, dcc, html, no_update
 from dash.exceptions import PreventUpdate
 
-from PyMieSimX.gui.sharing import sharing_controls, sharing_feedback, shared_setup
+from PyMieSimX.gui.sharing import sharing_controls, shared_setup
 import plotly.graph_objects as go
 import numpy as np
 
@@ -104,7 +104,6 @@ def build_population_page():
                                 id="population-export", disabled=True, className="toolbar-button toolbar-button-secondary"),
                     sharing_controls("/population"),
                 ]),
-                sharing_feedback(),
                 html.Div(id="population-status", role="status", children="Ready. Click Run to calculate all properties."),
                 _panel("Distribution preview", [
                     dcc.Graph(id="population-preview", config={"displaylogo": False}),

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/pages/single/page.py

@@ -2,7 +2,7 @@
 
 from dash import dcc, html
 
-from PyMieSimX.gui.sharing import sharing_controls, sharing_feedback
+from PyMieSimX.gui.sharing import sharing_controls
 from PyMieSimX.gui.components.cards import workspace_header
 
 from PyMieSimX.gui.defaults import DEFAULT_WORKSPACE_SETTINGS
@@ -47,7 +47,6 @@ def build_single_page(plot_settings: dict | None = None, simulation: dict | None
                                     sharing_controls("/single"),
                                 ],
                             ),
-                            sharing_feedback(),
                             build_representation_section(),
                             html.Section(className="panel graph-panel single-graph-panel", children=[dcc.Loading(id="single-graph-loading", type="circle", color="#4f8df7", custom_spinner=html.Div("Computing…", className="plot-computing-indicator"), delay_show=150, delay_hide=150, children=dcc.Graph(id="single-graph", config=PLOT_CONFIG))]),
                         ],

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/seo.py

@@ -8,6 +8,10 @@ from flask import has_request_context, request
 
 
 PAGE_METADATA = {
+    "/examples": {
+        "title": "Mie Scattering Examples — Nanoparticle Resonances & More | PyMieSimX",
+        "description": "Explore six Mie scattering examples: gold and silver nanoparticle resonances, silica size sweeps, gold nanoshells, angular scattering, and suspension optics.",
+    },
     "/": {
         "title": "Mie Scattering Calculator & Mie Theory Simulator | PyMieSimX",
         "description": "Calculate Mie scattering in your browser with PyMieSimX. Explore single particles, run parameter sweeps, and export results with the PyMieSim solver.",

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX/gui/sharing.py

@@ -254,17 +254,18 @@ def restore_controls(component, setup):
 def sharing_controls(path):
     return html.Div(className="simulation-share-actions", children=[
         dcc.Store(id=f"{path.strip('/')}-auto-run", data=None),
-        dcc.Clipboard(id="simulation-clipboard", children="Copy simulation link", copied_children="Link copied",
-                      title="Copy a link to this simulation setup", className="toolbar-button toolbar-button-secondary", n_clicks=0),
-        html.Button("Show simulation link", id="simulation-link-fallback", n_clicks=0,
-                    className="toolbar-button toolbar-button-secondary", style={"display": "none"}),
+        dcc.Store(id="simulation-link"),
+        dcc.Store(id="simulation-copy-status"),
+        html.Button([
+            html.Span("Copy simulation link", className="simulation-copy-label"),
+            html.Span("Copying…", className="simulation-copy-pending-label"),
+            html.Span("✓ Copied", className="simulation-copy-success-label"),
+            html.Span("Unable to copy", className="simulation-copy-error-label"),
+        ], id="simulation-clipboard", n_clicks=0, title="Copy a link to this simulation setup",
+            className="toolbar-button toolbar-button-secondary simulation-copy-button", **{"aria-live": "polite"}),
     ])
 
 
-def sharing_feedback():
-    return html.Div(id="simulation-share-feedback", role="status", className="simulation-share-feedback")
-
-
 def register_sharing_callbacks(app):
     from dash import ClientsideFunction
     for path, button_id in RUN_BUTTONS.items():
@@ -281,11 +282,14 @@ def register_sharing_callbacks(app):
             State(button_id, "n_clicks"),
         )
     app.clientside_callback(
-        """function(pathname) {
-            return window.isSecureContext && navigator.clipboard && navigator.clipboard.writeText
-                ? {display: 'none'} : {};
-        }""",
-        Output("simulation-link-fallback", "style"), Input("url", "pathname"),
+        ClientsideFunction(namespace="simulation_sharing", function_name="copy_link"),
+        Output("simulation-copy-status", "data"), Input("simulation-link", "data"),
+        prevent_initial_call=True,
+    )
+    app.clientside_callback(
+        ClientsideFunction(namespace="simulation_sharing", function_name="copy_feedback"),
+        Output("simulation-clipboard", "className"), Output("simulation-clipboard", "title"),
+        Input("simulation-clipboard", "n_clicks"), Input("simulation-copy-status", "data"),
     )
     @app.callback(
         Output("experiment-result", "clear_data"), Output("single-result", "clear_data"),
@@ -296,18 +300,16 @@ def register_sharing_callbacks(app):
         return clear, clear
 
     @app.callback(
-        Output("simulation-clipboard", "content"), Output("simulation-clipboard", "copied_children"),
-        Output("simulation-share-feedback", "children"),
+        Output("simulation-link", "data"),
         Input("simulation-clipboard", "n_clicks"),
-        Input("simulation-link-fallback", "n_clicks"),
         State("url", "href"), State("url", "pathname"), State("plot-settings-store", "data"),
         State({"kind": "field", "section": ALL, "name": ALL}, "id"),
         State({"kind": "field", "section": ALL, "name": ALL}, "value"),
         *[State(name, "value", allow_optional=True) for name in CAPTURE_CONTROLS],
         prevent_initial_call=True,
     )
-    def _copy_simulation_link(clicks, fallback_clicks, href, path, settings, field_ids, field_values, *values):
-        if not (clicks or fallback_clicks) or path not in WORKSPACES:
+    def _copy_simulation_link(clicks, href, path, settings, field_ids, field_values, *values):
+        if not clicks or path not in WORKSPACES:
             raise PreventUpdate
         allowed = allowed_controls(path)
         controls = {name: value for name, value in zip(CAPTURE_CONTROLS, values) if name in allowed and value is not None}
@@ -321,12 +323,8 @@ def register_sharing_callbacks(app):
         payload = {"v": 1, "page": path, "controls": controls, "plot_settings": plot}
         try:
             token = encode_simulation(payload)
-        except ValueError as error:
-            return "", "Unable to copy", str(error)
+        except ValueError:
+            return {"clicks": clicks, "url": None}
         parts = urlsplit(href)
         link = urlunsplit((parts.scheme, parts.netloc, path, urlencode({"simulation": token}), ""))
-        feedback = []
-        if fallback_clicks and not clicks:
-            feedback = [html.Label("Simulation link", htmlFor="simulation-share-link"),
-                        dcc.Input(id="simulation-share-link", value=link, readOnly=True, type="text", className="field-input")]
-        return link, "Link copied", feedback
+        return {"clicks": clicks, "url": link}

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.2.2
+Version: 0.3.0
 Summary: Graphical Dash interface for PyMieSim.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License-Expression: MIT
@@ -50,6 +50,15 @@ 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.
 
+Examples
+--------
+
+The **Examples** page provides six starting points: gold and silver nanoparticle
+resonances, a silica size sweep, gold nanoshells, a bead's angular scattering,
+and a polydisperse silica suspension. Each card links to its simulation
+workspace, restores the complete setup, and runs automatically to show results.
+The parameters can then be adjusted and the results exported as CSV.
+
 Sharing simulations
 -------------------
 
@@ -58,8 +67,8 @@ Optics to share the current setup. Links preserve the input values, sweep
 ranges, selected measures, and plot settings without requiring an account.
 Opening a link restores the setup and automatically runs the simulation once
 the inputs and plot settings are ready. Later edits can be calculated with
-**Run**. If clipboard access is unavailable, use **Show simulation
-link** and copy the displayed URL.
+**Run**. Copying puts the link directly on the clipboard and briefly shows
+**Copied** on the button without displaying an additional card.
 
 Links store the configuration rather than a result snapshot. Recalculation
 uses the installed solver and optical material data, so results can change

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX.egg-info/SOURCES.txt

@@ -67,6 +67,7 @@ PyMieSimX/gui/components/cards.py
 PyMieSimX/gui/pages/__init__.py
 PyMieSimX/gui/pages/citation.py
 PyMieSimX/gui/pages/documentation.py
+PyMieSimX/gui/pages/examples.py
 PyMieSimX/gui/pages/field_syntax.py
 PyMieSimX/gui/pages/home.py
 PyMieSimX/gui/pages/install_local.py
@@ -88,6 +89,7 @@ tests/gui/cli.py
 tests/gui/test_admin.py
 tests/gui/test_api.py
 tests/gui/test_dash_callbacks.py
+tests/gui/test_examples.py
 tests/gui/test_home.py
 tests/gui/test_population.py
 tests/gui/test_seo.py

{pymiesimx-0.2.2 → pymiesimx-0.3.0}/PyMieSimX.egg-info/scm_file_list.json

@@ -47,6 +47,7 @@
     "PyMieSimX/gui/pages/__init__.py",
     "PyMieSimX/gui/pages/citation.py",
     "PyMieSimX/gui/pages/documentation.py",
+    "PyMieSimX/gui/pages/examples.py",
     "PyMieSimX/gui/pages/experiment/__init__.py",
     "PyMieSimX/gui/pages/experiment/page.py",
     "PyMieSimX/gui/pages/experiment/sections/__init__.py",
@@ -82,6 +83,7 @@
     "tests/gui/test_admin.py",
     "tests/gui/test_api.py",
     "tests/gui/test_dash_callbacks.py",
+    "tests/gui/test_examples.py",
     "tests/gui/test_home.py",
     "tests/gui/test_population.py",
     "tests/gui/test_seo.py",