Skip to content

XinMatch v3.5.0

Choose a tag to compare

@PolyXRD PolyXRD released this 06 Nov 06:40
· 168 commits to master since this release

XinMatch v3.5.0 — "Must-not-contain" element constraint enabled, single source of truth for version

Baseline v3.4.0. This is a defect-closure + engineering-governance release: reference library format, FoM weights, P-value definitions, and the command-line interface are all unchanged; search default behavior is unchanged item-by-item (synthetic baseline 11/13·12/13·10/13·19/24 re-verified).

Core capabilities

Capability Description
"Must-not-contain" element constraint Red periodic-table elements now actually participate in search: the prescreen layer uses the element_inv inverted index to drop phases containing that element, intersected with "must-contain" (green)
Three entry points consistent GUI (Constraints panel), search_match(restraints=...), search_match_v3(elements_excluded=...) all go through the same path
Opposite semantics for unknown elements A misspelled symbol empties results on the "must-contain" side, but on the "must-not-contain" side excludes nothing
FPFM mode made explicit The full-profile fitting chain has no restraints parameter; selecting elements then switching to FPFM shows a status-bar hint instead of silently failing
Single source of truth for version pyproject.toml is the only one; the spec derives from it, and the iss keeps just one default value overridden by the build script
Version-consistency tests 5 checks; any drift fails the test (added for XinMatch)

Validation

Item Result
pytest / ruff / mypy all pass, no issues
Synthetic baseline (default metric) Phase-level Top-1 11/13, Top-5 12/13, sequential 10/13, phase recall 19/24 — identical item-by-item to 3.4.x
Element constraint (real 13 sets, ideal XRF settings) Top-1 10/12 → 12/12; per-phase rank changes 21 up / 17 flat / 4 down / 1 pushed out
Binary acceptance (5 rounds) version, library registration, frozen search, new-feature penetration, install/launch/portable all pass

Release artifacts

File Size SHA-256
XinMatch-Setup-3.5.0.exe 242.3 MiB e81ab39f97ec9322db8bf68de18831bb02ce14b3f77e6b8eb23d460d159f9ba7
XinMatch-Internal-3.5.0.zip (portable, not distributed with the Release) 337.4 MiB 41ac3005ea17af5f4af2538ea285a5bbc69932ae9c456985cd5e63cce295b40b

Upgrade notes

  • Default behavior unchanged: users not using the "Constraints" panel get search results bit-identical to 3.4.x.
  • To make red elements take effect, tick elements in the "Constraints" tab and set their state to red, then run Search-Match (peak-list FoM mode only; FPFM will warn it doesn't participate).
  • The installer filename changes to XinMatch-Setup-3.5.0.exe; old data\*.xinDB reference libraries can be carried over directly.