PyMieSimX 0.1.6__tar.gz → 0.2.0__tar.gz

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

@@ -17,6 +17,13 @@ jobs:
       package_name: pymiesimx
       recipe_path: conda.recipe
       test_import: PyMieSimX
-      test_command: "python -c 'import PyMieSimX' && pymiesimx --help"
+      # Shell startup in the reusable workflow reactivates base, even through
+      # conda run. Invoke the installed environment's interpreter directly.
+      test_command: >-
+        if [ -f '${test_prefix}/python.exe' ]; then
+        '${test_prefix}/python.exe' '${GITHUB_WORKSPACE}/tools/verify_conda_artifact.py';
+        else
+        '${test_prefix}/bin/python' '${GITHUB_WORKSPACE}/tools/verify_conda_artifact.py';
+        fi
     secrets:
       ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyMieSimX
-Version: 0.1.6
+Version: 0.2.0
 Summary: Graphical Dash interface for PyMieSim.
 Author-email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
 License-Expression: MIT
@@ -8,7 +8,7 @@ Project-URL: Repository, https://github.com/MartinPdeS/PyMieSimX
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: PyMieSim<6,>=5.6.4
+Requires-Dist: PyMieSim<6,>=5.7.1
 Requires-Dist: PyOptik<4,>=3.2.1
 Requires-Dist: dash<5,>=4.1.0
 Requires-Dist: gunicorn<24,>=23.0.0
@@ -50,6 +50,53 @@ 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.
 
+Ensemble Optics
+---------------
+
+Open **Ensemble Optics** to compute the properties of a homogeneous spherical
+particle population at one vacuum wavelength, without a parameter sweep. The
+collapsible Particle, Distribution, and Concentration side tabs hold the inputs;
+the Model tab explains the assumptions and averaging. Choose a monodisperse,
+truncated Gaussian, lognormal, or uniform number-based diameter distribution
+and supply a number concentration (particles/mL) or volume fraction.
+Gaussian width is a standard deviation in nm; lognormal width is a geometric
+standard deviation (greater than 1 and at most 3). Gaussian bounds are positive
+and the distribution is renormalized within them. Named optical materials are
+resolved through PyOptik, or you can enter a particle index ``n+ik`` and a real
+medium index directly. Both fields use the same RI/Material toggle as the other
+workspaces; switching back to RI restores the previously entered index.
+
+Results include scattering, particle absorption, extinction, reduced scattering
+(in inverse millimeters), population single-scattering albedo, effective
+anisotropy, averaged cross sections, and both number- and area-weighted
+efficiencies. Cross sections are number averages; area efficiencies divide mean
+cross section by mean projected area. Effective anisotropy is weighted by
+scattering cross section. Population albedo is mean scattering cross section
+divided by mean extinction cross section, rather than a number average of
+individual albedos. Undefined ratios are displayed as undefined.
+
+The calculation assumes independent scattering and excludes particle
+interactions, multiple scattering, and host-medium absorption. Use dilute
+populations. Preview the discrete number fractions, increase sampling to check
+convergence, and export results with units, definitions, inputs, and weights.
+PyMieSim 5.7.1 or newer supplies the distribution and averaging routines.
+
+The same calculation is available without constructing the GUI::
+
+    from PyMieSimX import compute_population_optics, export_population_to_csv
+
+    result = compute_population_optics(
+        wavelength_nm=650,
+        material="1.5+0.01j",
+        medium="1.33",
+        distribution="lognormal",
+        diameter_nm=500,
+        width=1.2,
+        concentration=1e9,
+        concentration_basis="number",
+    )
+    csv_text = export_population_to_csv(result)
+
 Source-model note
 -----------------
 
@@ -129,7 +176,7 @@ available for applications that need the graphical interface.
 Multiple measures
 -----------------
 
-The Parameter Sweep Measures selector accepts several quantities in one run.
+The Parameter Scan Measures selector accepts several quantities in one run.
 For example, select ``Qsca``, ``Qabs``, and ``Qext`` to compare scattering,
 absorption, and extinction efficiencies. Measures with the same units share a
 plot; different units use separate panels with a shared X axis. CSV exports

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/__init__.py

@@ -10,6 +10,8 @@ from PyMieSimX.api import (
     ResultSizeEstimate,
     ResultSizeLimitError,
     ValidationIssue,
+    compute_population_optics,
+    export_population_to_csv,
     available_measures,
     build_figure,
     build_single_figure,
@@ -27,6 +29,8 @@ except PackageNotFoundError:
     __version__ = "0+unknown"
 
 __all__ = [
+    "compute_population_optics",
+    "export_population_to_csv",
     "MAX_SWEEP_COMBINATIONS",
     "MAX_RESULT_FRAME_BYTES",
     "MAX_RESULT_PAYLOAD_BYTES",

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/api.py

@@ -19,7 +19,11 @@ from PyMieSimX.gui.services import (
     validate_experiment_inputs,
 )
 
+from PyMieSimX.gui.population_service import compute_population_optics, export_population_to_csv
+
 __all__ = [
+    "compute_population_optics",
+    "export_population_to_csv",
     "MAX_SWEEP_COMBINATIONS",
     "MAX_RESULT_FRAME_BYTES",
     "MAX_RESULT_PAYLOAD_BYTES",

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

@@ -3717,8 +3717,8 @@ html .plot-options-card .plot-option-control.dashboard-dropdown .Select-control
     font-weight: 650;
 }
 
-/* Match Particle Explorer representation controls to the compact Graph Axes
-   card used by Parameter Sweep. */
+/* Match Single Scatterer representation controls to the compact Graph Axes
+   card used by Parameter Scan. */
 .single-workspace .representation-card {
     width: 100%;
     max-width: none;
@@ -3910,12 +3910,17 @@ html .single-workspace .representation-card {
     font-variant-numeric: tabular-nums;
 }
 
+.home-support-actions {
+    display: flex;
+    flex-direction: column;
+    gap: 9px;
+}
+
 .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;
@@ -3992,3 +3997,13 @@ html .single-workspace .representation-card {
     grid-template-columns: 1fr;
   }
 }
+
+/* Ensemble Optics shares the workspace toolbar and collapsible side panels. */
+.population-workspace, .population-output { display: grid; gap: 20px; min-width: 0; }
+.population-page .field-block { margin-bottom: 14px; }
+.population-page .field-block small { display: block; margin-top: 6px; opacity: .75; }
+.population-page .field-input { width: 100%; }
+.population-page .documentation-table { width: 100%; }
+.population-page .documentation-table td { overflow-wrap: anywhere; }
+#population-status, #population-preview-error { margin-bottom: 12px; }
+#population-results { overflow-x: auto; }

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

@@ -18,7 +18,10 @@ 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
 from PyMieSimX.gui.pages.single import build_single_page
-from PyMieSimX.gui.schemas import DETECTOR_FIELDS, SCATTERER_FIELDS, SINGLE_SCATTERER_FIELDS, SINGLE_SOURCE_FIELDS, SOURCE_FIELDS
+from PyMieSimX.gui.pages.population import build_population_page, register_population_callbacks
+from PyMieSimX.gui.parsing import is_numeric_material_value
+from PyMieSimX.gui.population_service import parse_population_material
+from PyMieSimX.gui.schemas import POPULATION_OPTICAL_FIELDS, DETECTOR_FIELDS, SCATTERER_FIELDS, SINGLE_SCATTERER_FIELDS, SINGLE_SOURCE_FIELDS, SOURCE_FIELDS
 from PyMieSimX.gui.callback_helpers import (
     execute_single_callback,
     merge_local_plot_values as _merge_local_plot_values,
@@ -59,6 +62,7 @@ def _counter(value: object) -> int:
 
 def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
     """Register all dashboard callbacks."""
+    register_population_callbacks(app)
     LOGGER.debug("Registering dashboard callbacks")
 
     @app.callback(
@@ -151,6 +155,25 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
         return _handle_sidebar_tabs(tab_ids, ["yellow", "blue", "cyan", "purple"], current_class, current_active, "experiment-right-sidebar")
 
 
+    @app.callback(
+        Output("population-right-sidebar", "className"),
+        Output("population-right-sidebar-active", "data"),
+        *[Output(f"population-tab-{name}", "className") for name in ("particle", "distribution", "concentration", "model")],
+        *[Output(f"population-panel-{name}", "style") for name in ("particle", "distribution", "concentration", "model")],
+        *[Input(f"population-tab-{name}", "n_clicks") for name in ("particle", "distribution", "concentration", "model")],
+        Input("page-content", "n_clicks"),
+        Input("dashboard-sidebar", "n_clicks"),
+        Input("population-right-sidebar", "n_clicks"),
+        State("population-right-sidebar", "className"),
+        State("population-right-sidebar-active", "data"),
+        prevent_initial_call=True,
+    )
+    def _handle_population_sidebar_tabs(_particle_clicks, _distribution_clicks, _concentration_clicks, _model_clicks,
+                                        _page_clicks, _sidebar_clicks, _right_sidebar_clicks, current_class, current_active):
+        tab_ids = [f"population-tab-{name}" for name in ("particle", "distribution", "concentration", "model")]
+        return _handle_sidebar_tabs(tab_ids, ["blue", "yellow", "cyan", "purple"], current_class, current_active, "population-right-sidebar")
+
+
     @app.callback(
         Output("page-content", "children"),
         Output("sidebar-link-home", "className"),
@@ -158,6 +181,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-population", "className"),
         Output("home-visit-count", "data"),
         Input("url", "pathname"),
         Input("url", "search"),
@@ -176,6 +200,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             "single": "sidebar-link",
             "documentation": "sidebar-link",
             "settings": "sidebar-link",
+            "population": "sidebar-link",
         }
         home_visits = _counter(home_visits)
         if route == "/":
@@ -187,33 +212,36 @@ 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")), home_visits
+            return build_page_with_footer(build_admin_page(token)), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+            return build_page_with_footer(build_documentation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+            return build_page_with_footer(build_citation_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+            return build_page_with_footer(build_install_local_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+            return build_page_with_footer(build_sellmeier_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+            return build_page_with_footer(build_field_syntax_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), 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", "population")), home_visits
         if route == "/single":
             active["single"] += " active"
-            return build_page_with_footer(build_single_page((plot_settings or {}).get("particle_explorer", {}))), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings")), home_visits
+            return build_page_with_footer(build_single_page((plot_settings or {}).get("particle_explorer", {}))), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
+        if route == "/population":
+            active["population"] += " active"
+            return build_page_with_footer(build_population_page()), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "population")), home_visits
         if route == "/experiment":
             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
+            return build_page_with_footer(build_experiment_page(default_measure_options, plot_settings or {})), *(active[key] for key in ("home", "experiment", "single", "documentation", "settings", "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")), home_visits
+        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
 
     @app.callback(
         Output("admin-home-page-visits", "children"),
@@ -316,6 +344,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             "detector": detector_type,
             "single-source": single_source_type,
             "single-scatterer": single_scatterer_type,
+            "population": "Sphere",
         }
         schema_groups = {
             "source": SOURCE_FIELDS,
@@ -323,6 +352,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
             "detector": DETECTOR_FIELDS,
             "single-source": SINGLE_SOURCE_FIELDS,
             "single-scatterer": SINGLE_SCATTERER_FIELDS,
+            "population": {"Sphere": POPULATION_OPTICAL_FIELDS},
         }
 
         classes = []
@@ -340,7 +370,8 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
                 valid = field.optional and empty
                 if not empty:
                     try:
-                        parsed_value = _parse_field_value(field.kind, raw_value, field.unit)
+                        parsed_value = (parse_population_material(raw_value, medium=field.name == "medium")
+                                        if section == "population" else _parse_field_value(field.kind, raw_value, field.unit))
                         if field.name in {"wavelength", "optical_power", "numerical_aperture", "amplitude", "diameter", "core_diameter", "shell_thickness", "sampling"}:
                             _validate_positive_field(field.name, parsed_value)
                         valid = True
@@ -403,7 +434,7 @@ def register_callbacks(app: Dash, default_measure_options: list[str]) -> None:
         dropdown_style = {} if use_named_material else {"display": "none"}
         ri_value = stored_ri_value or "1.4"
 
-        if current_value and not any(char.isalpha() for char in str(current_value)):
+        if current_value and is_numeric_material_value(current_value):
             ri_value = current_value
 
         if use_named_material and selected_material:

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

@@ -745,9 +745,9 @@ def _plotly_array(value: Any) -> np.ndarray:
 
 
 def export_single_result_to_csv(result: dict[str, Any] | None) -> str:
-    """Serialize a Particle Explorer figure payload to CSV text."""
+    """Serialize a Single Scatterer figure payload to CSV text."""
     if not result or not result.get("figure"):
-        LOGGER.debug("Particle Explorer CSV export requested without a result")
+        LOGGER.debug("Single Scatterer CSV export requested without a result")
         return ""
 
     traces = result["figure"].get("data", [])

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/interface.py

@@ -38,7 +38,7 @@ def create_dash_app() -> Dash:
     """Create and configure the experiment dashboard Dash application."""
     application = Dash(
         __name__,
-        title="PyMieSim Parameter Sweep Lab",
+        title="PyMieSim",
         assets_folder=str(Path(__file__).with_name("assets")),
         suppress_callback_exceptions=True,
     )

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/layout.py

@@ -5,6 +5,7 @@ from dash import dcc, html
 
 from PyMieSimX.gui.defaults import DEFAULT_APPLICATION_SETTINGS, DEFAULT_PLOT_SETTINGS
 from PyMieSimX.gui.material_catalog import material_dropdown_options
+from PyMieSimX.gui.parsing import is_numeric_material_value
 from PyMieSimX.gui.schemas import FieldSpec, SECTION_FIELDS, SINGLE_SCATTERER_FIELDS, SINGLE_SOURCE_FIELDS
 
 
@@ -305,8 +306,9 @@ def _build_sidebar():
                 className="sidebar-nav",
                 children=[
                     _sidebar_link("Home", "/"),
-                    _sidebar_link("Particle Explorer", "/single"),
-                    _sidebar_link("Parameter Sweep", "/experiment"),
+                    _sidebar_link("Single Scatterer", "/single"),
+                    _sidebar_link("Parameter Scan", "/experiment"),
+                    _sidebar_link("Ensemble Optics", "/population"),
                     _sidebar_link("Documentation", "/documentation"),
                     _sidebar_link("Settings", "/settings"),
                 ],
@@ -360,7 +362,7 @@ def render_field(section: str, field_spec: FieldSpec):
     if field_spec.kind in {"material", "medium"}:
         is_medium = field_spec.kind == "medium"
         default_text = str(field_spec.default)
-        default_is_named = any(char.isalpha() for char in default_text)
+        default_is_named = bool(default_text.strip()) and not is_numeric_material_value(default_text)
         named_options = material_dropdown_options(medium=is_medium)
         default_from_catalog = named_options[0]["value"] if named_options else None
         named_values = {option["value"] for option in named_options}

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/pages/documentation.py

@@ -19,8 +19,8 @@ def build_documentation_page():
                     html.Div(
                         className="documentation-hero-actions",
                         children=[
-                            html.A("Start a parameter sweep →", href="/experiment", className="home-button home-button-primary"),
-                            html.A("Open Particle Explorer →", href="/single", className="home-button home-button-outline"),
+                            html.A("Open Parameter Scan →", href="/experiment", className="home-button home-button-primary"),
+                            html.A("Open Single Scatterer →", href="/single", className="home-button home-button-outline"),
                         ],
                     ),
                 ],
@@ -32,7 +32,7 @@ def build_documentation_page():
                     html.Div(
                         className="card-body documentation-quickstart-body",
                         children=[
-                            _step("01", "Choose a workspace", "Use Parameter Sweep for parameter sweeps and detector coupling. Use Particle Explorer to inspect one optical setup."),
+                            _step("01", "Choose a workspace", "Use Parameter Scan for parameter sweeps and detector coupling. Use Single Scatterer to inspect one optical setup."),
                             _step("02", "Configure the objects", "Pick a source, scatterer, and—when needed—a detector. Each card exposes the fields supported by that model."),
                             _step("03", "Enter values or sweeps", "Use one value for a focused run, a comma-separated list for selected values, or start:end:count for an evenly spaced sweep."),
                             _step("04", "Render and inspect", "Run the calculation, select the X axis when several fields vary, and use Settings to tune the resulting plots."),
@@ -43,8 +43,9 @@ def build_documentation_page():
             html.Div(
                 className="documentation-grid documentation-topic-grid",
                 children=[
-                    _guide_card("yellow", "Parameter Sweep", "Sweep a parameter space", "Build a source, scatterer, and detector, then evaluate a measure over every combination.", ["X-axis is inferred from fields with multiple values.", "Detector-free runs are supported.", "Results can be exported as CSV."], "/experiment", "Open Parameter Sweep"),
-                    _guide_card("blue", "Particle Explorer", "Understand one setup", "Inspect angular amplitudes, polarization, phase functions, or far-field intensity for one source and scatterer.", ["Choose a representation.", "Control angular sampling.", "Render the figure on demand."], "/single", "Open Particle Explorer"),
+                    _guide_card("yellow", "Parameter Scan", "Sweep a parameter space", "Build a source, scatterer, and detector, then evaluate a measure over every combination.", ["X-axis is inferred from fields with multiple values.", "Detector-free runs are supported.", "Results can be exported as CSV."], "/experiment", "Open Parameter Scan"),
+                    _guide_card("blue", "Single Scatterer", "Understand one setup", "Inspect angular amplitudes, polarization, phase functions, or far-field intensity for one source and scatterer.", ["Choose a representation.", "Control angular sampling.", "Render the figure on demand."], "/single", "Open Single Scatterer"),
+                    _guide_card("orange", "Ensemble Optics", "Calculate population properties", "Define a particle size distribution and concentration at one wavelength.", ["Gaussian, lognormal, uniform, or monodisperse sizes.", "Scattering, absorption, albedo, and averaged efficiencies.", "Export results and distribution weights as CSV."], "/population", "Open Ensemble Optics"),
                     _guide_card("green", "Material model", "Sellmeier relation", "Understand dispersive refractive-index modeling and check the coefficient table used for material workflows.", ["See the Sellmeier equation.", "Review coefficient values.", "Map values to material inputs."], "/documentation/sellmeier", "Open Sellmeier reference"),
                     _guide_card("blue", "Input reference", "Field syntax & vocabulary", "Learn compact field notation, detector definitions, and the model terms used throughout the dashboard.", ["Enter scalars, lists, and ranges.", "Understand detector choices.", "Review supported model families."], "/documentation/field-syntax", "Open field reference"),
                     _guide_card("cyan", "Plot settings", "Make figures your own", "Set typography, line and marker sizes, grid visibility, legend visibility, and light or dark plot styling.", ["Preferences are saved in this browser.", "Settings apply to both workspaces.", "The application theme is controlled here."], "/settings", "Open Settings"),

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/pages/experiment/__init__.py

@@ -1,4 +1,4 @@
-"""Parameter Sweep page and sections."""
+"""Parameter Scan page and sections."""
 
 from .page import build_experiment_page
 

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/pages/experiment/page.py

@@ -1,4 +1,4 @@
-"""Parameter Sweep page composition."""
+"""Parameter Scan page composition."""
 
 
 from dash import dcc, html
@@ -10,7 +10,7 @@ from .sections import build_detector_section, build_scatterer_section, build_sou
 
 
 def build_experiment_page(default_measure_options: list[str], plot_settings: dict | None = None):
-    """Build the isolated Parameter Sweep workspace."""
+    """Build the isolated Parameter Scan workspace."""
     settings = (plot_settings or {}).get("parameter_sweep", {})
     return html.Div(
         className="tab-content-stack experiment-tab-content",

{pymiesimx-0.1.6 → pymiesimx-0.2.0}/PyMieSimX/gui/pages/field_syntax.py

@@ -39,7 +39,7 @@ def build_field_syntax_page():
                 className=Card.classes(color="blue", extra="panel documentation-note"),
                 children=[
                     html.Div(className="card-header panel-header", children=[html.H2("Continue exploring")]),
-                    html.Div(className="card-body documentation-note-body", children=[html.P("Use these definitions while configuring a Parameter Sweep or Particle Explorer run."), html.A("Back to documentation →", href="/documentation", className="inline-action")]),
+                    html.Div(className="card-body documentation-note-body", children=[html.P("Use these definitions while configuring a Parameter Scan or Single Scatterer run."), html.A("Back to documentation →", href="/documentation", className="inline-action")]),
                 ],
             ),
         ],

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

@@ -38,13 +38,26 @@ def build_home_page(*, home_visits: int | float | None = None):
                     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",
+                            html.Div(
+                                [
+                                    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",
+                                    ),
+                                    html.A(
+                                        [html.Span("\u2605", className="home-support-icon", **{"aria-hidden": "true"}), "Star PyMieSim on GitHub"],
+                                        id="home-star-repository",
+                                        href="https://github.com/MartinPdeS/PyMieSim",
+                                        target="_blank",
+                                        rel="noopener noreferrer",
+                                        className="home-support-button",
+                                    ),
+                                ],
+                                className="home-support-actions",
                             ),
                         ],
                         className="home-hero-actions",
@@ -55,25 +68,35 @@ def build_home_page(*, home_visits: int | float | None = None):
                 className="home-capability-grid",
                 children=[
                     _capability_card(
-                        "Particle Explorer",
+                        "Single Scatterer",
                         "Inspect one optical setup through angular scattering, polarization, phase functions, and field representations.",
                         ["Configure source", "Configure scatterer", "Render representations"],
-                        "Open Particle Explorer",
+                        "Open Single Scatterer",
                         "/single",
                         html.Img(src="/assets/home-spf-radial.gif", className="home-capability-preview home-capability-preview-image", alt="Rotating scattering phase function 3D radial surface"),
                         "Scattering phase function — rotating 3D radial surface",
                         "purple",
                     ),
                     _capability_card(
-                        "Parameter Sweep",
+                        "Parameter Scan",
                         "Run source, scatterer, and detector configurations across parameter sweeps and export structured results for analysis.",
                         ["Configure source", "Configure scatterer and detector", "Run and export results"],
-                        "Open Parameter Sweep",
+                        "Open Parameter Scan",
                         "/experiment",
                         _qsca_preview(),
                         "Scattering-efficiency sweep",
                         "green",
                     ),
+                    _capability_card(
+                        "Ensemble Optics",
+                        "Turn a particle size distribution and concentration into scattering, absorption, albedo, and averaged optical properties at one wavelength.",
+                        ["Define particle properties", "Choose a distribution and concentration", "Compute all properties and export"],
+                        "Open Ensemble Optics",
+                        "/population",
+                        _distribution_preview(),
+                        "Gaussian and lognormal size distributions",
+                        "blue",
+                    ),
                 ],
             ),
         ],
@@ -115,6 +138,7 @@ def _capability_card(
         className="home-capability-preview",
     )
     return html.Section(
+        id=f"home-workflow-{href.strip('/')}",
         className=Card.classes(color=color, extra="home-capability-card"),
         children=[
             html.Div(title, className="home-section-header"),
@@ -207,3 +231,21 @@ def _qsca_preview() -> go.Figure:
         margin={"t": 32},
     )
     return figure
+
+
+def _distribution_preview() -> go.Figure:
+    """Illustrate Gaussian and lognormal particle-size probability densities."""
+    diameter = np.linspace(100, 1000, 240)
+    sigma_log = np.log(1.3)
+    lognormal = np.exp(-0.5 * (np.log(diameter / 450) / sigma_log) ** 2) / (diameter * sigma_log * np.sqrt(2 * np.pi))
+    gaussian = np.exp(-0.5 * ((diameter - 520) / 80) ** 2) / (80 * np.sqrt(2 * np.pi))
+    figure = go.Figure([
+        go.Scatter(x=diameter, y=lognormal, mode="lines", name="Lognormal", hoverinfo="skip",
+                   line={"color": "#2672d6", "width": 3}, fill="tozeroy", fillcolor="rgba(38,114,214,.15)"),
+        go.Scatter(x=diameter, y=gaussian, mode="lines", name="Gaussian", hoverinfo="skip",
+                   line={"color": "#b47b1d", "width": 3, "dash": "dot"}),
+    ])
+    figure = _preview_layout(figure, x_title="Diameter (nm)", y_title="Probability density (nm⁻¹)")
+    figure.update_layout(showlegend=True, margin={"t": 32},
+                         legend={"orientation": "h", "x": 0.5, "xanchor": "center", "y": 1.13, "font": {"size": 10}})
+    return figure