[Anthony Sligar (sligara7)]

Adds set_filters(...) and a Filters tab next to Motors in the GUI: one dropdown each for filter 1 upstream, filter 1 downstream and filter 2.

• Each dropdown lists that filter's choices from filters.yml: pass through plus its configured materials, e.g. 6 mm Cu on filter 1 US, 6 mm Al on filter 1 DS, 1 mm Cu on filter 2. Empty slots are not offered. filters.yml stays the single source.
• A filter left unset does not move; the chosen ones move together.
• The filter devices are taken from the session namespace (ensure_available), so the form only shows the three dropdowns.
• From the CLI: RE(set_filters(filter1_upstream_setting="6 mm Cu", filter2_setting="1 mm Cu")).

filters.yml materials updated from the 27-ID commissioning wiki ("FOE Filters" table). Before, filter 1 US was 12/9/6/3 mm SiC, and filter 1 DS slots 3–4 were 24/12 mm SiC, from the first filter config (2026-08-12). The wiki has:

• filter 1 US: 6 mm Cu, 6 mm Al, empty, Bo-Hori.;
• filter 1 DS: 4 mm Cu, 2 mm Cu, 6 mm Al, Bo-Ver.

Every motor position and limit already matched; only the labels changed. These labels are also what Filter.description records in run metadata. Jakub Wlodek (@jwlodek), please confirm the wiki is current.

Verification: mock tests only; not run on the beamline.

• The choices match filters.yml for each filter.
• Only the chosen filters move, each to its configured position, on the real filters.yml devices mocked.
• 6 mm Cu / 6 mm Al / 1 mm Cu on all three: each filter's recorded description matches.
• An unknown material and an empty call are refused.
• The GUI form (offscreen) has exactly three dropdowns with each filter's materials, and no device pickers.
• set_filters is in the profile namespace.
• Full suite: 474 passed. The one failure, test_detector_viewer_axes, also fails on main in my dev env (older ntnda-qt-viewer than the lock).
• ty adds no diagnostics.

[Copilot]

🟢 Approval recommended

No blocking issues were identified in the plan, GUI integration, exports, or focused tests; runtime tests were not rerun.

No open issues 🎉

What changed in this PR

Adds material-based filter control through a new set_filters plan and a Filters tab in the GUI, using filters.yml as the single source of available settings.

Changes:

• Moves selected filters together while leaving unspecified filters unchanged.
• Exposes three material dropdowns and resolves filter devices from the session namespace.
• Adds plan and GUI tests, profile export coverage, and CLI documentation.

File	Description
tests/​test_profile_namespace.py	Checks that set_filters is available in the profile namespace.
tests/​photon_delivery_system/​test_filters.py	Tests configured choices, selective movement, and invalid inputs.
tests/​gui/​test_plan_widget_filters.py	Tests the three material dropdowns and absence of device pickers.
src/​hextools/​photon_delivery_system/​filters.py	Implements configuration-derived settings and the set_filters plan.
src/​hextools/​photon_delivery_system/​__init__.py	Exports set_filters.
src/​hextools/​gui/​__main__.py	Adds the Filters tab beside Motors.
docs/​profile.md	Lists set_filters among available plans.
docs/​cli.md	Documents material-based filter commands.

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

The revised material mappings control physical filter selection and recorded metadata, and still require beamline-owner confirmation beyond mock tests.

No open issues 🎉

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

The revised material labels need beamline-owner confirmation against installed hardware because they determine movement choices and recorded metadata.

No open issues 🎉

_{Review effort: Balanced}