Repository navigation
XinMatch v3.6.3 — Element constraints four-state + closed-loop · FPFM full-profile fitting as default
LatestXinMatch v3.6.3 — Element constraints four-state + closed-loop · FPFM full-profile fitting as default
This Release cumulates the four never-separately-released versions v3.6.0 / v3.6.1 / v3.6.2 / v3.6.3. The previous public release was v3.5.0. The reference library format (
.xinDBv3), FoM weights, command-line interface and.xinmarchive format are all unchanged; old archives open as usual.
Highlights of this release (v3.6.3)
① Element constraints four-state + closed-loop (criteria aligned with sibling project PolyXRD)
Previously there were only three states "must-contain / exclude / no-constraint", with two real shortcomings: to express "the sample is the MgO or CaO or CaCO3 family" you could only mark all 4 elements must-contain (AND semantics, leaving only dolomite); to express "only allow these detected elements" you'd have to click 113 of the 118 buttons. Now:
| State | Predicate | Meaning |
|---|---|---|
| Must have | P ⊆ S |
each must appear (AND) |
| May contain | S ∩ H ≠ ∅ |
contains at least one (OR) |
| Possible | no forced condition | only relaxes the closed-loop allowed pool |
| Must not have | S ∩ E = ∅ |
contains any → eliminated |
Click order: no-constraint → may-contain → possible → must-not-have → must-have (the harshest filter placed last). New closed-loop switch "restrict to selected elements": unmarked elements are all treated as "must-not-have"; the panel adds "add light elements" to mark O/C/H/N/S as "may-contain" in one click. The four-state conversion is consolidated into a single element_constraint_sets(), shared by prescreen / direct SQL query / baseline scripts.
② Phase identification now defaults to FPFM full-profile fitting (no peak finding)
The toolbar dropdown can still switch back to "peak-list FoM (peak finding)" with one click.
⚠️ Element constraints only take effect in "peak-list FoM" mode — the FPFM search chain has norestraintsparameter. To use element constraints as chemical priors, switch back to peak-finding mode first; the toolbar "sample elements" button, when constraints are set + FPFM, persistently shows the "|not effective under FPFM" hint.
③ Compatibility: closed_world defaults off, and the new states aren't used by old archives, so behavior is bit-identical to v3.5.0 when only must-have/must-not-have are set; baseline numbers (real-pattern phases 30/43, etc.) are unchanged.
Cumulated v3.6.0 ~ v3.6.2
| Version | Contents |
|---|---|
| v3.6.0 | All 11 placeholder GUI menu actions wired up (Profile Fit / Quantify / Microstructure / Indexing / Export); peak-position refinement switched to LM optimization (35 s → 0.35 s); candidate list 50-row display budget; periodic table redesigned (font-metric-driven sizing, fixes clipped symbols) |
| v3.6.1 | Three field-reported bug fixes: each curve shown twice in the pattern legend / Rietveld refinement wizard full-window white-screen freeze / match-list "crystal system" column labeling hexagonal phases as monoclinic |
| v3.6.2 | Pattern-area interaction rework: reference-line zones below the pattern (candidate-phase preview + all confirmed-phase columns, to spot unmatched peaks); top axis control bar hidden, switched to click-axis-to-toggle; pattern shortcut icon row (reset / box-select by axis / pan / step zoom / crosshair) |
Deliverables
Only XinMatch-Setup-3.6.3.exe (Windows installer). Bundles the COD-Inorg default reference library, search works out of the box with no separate database download. The portable zip is for internal-evaluation use and is not released with the Release.
Validation
ruff check ./mypy xinmatch/coreall pass; version consistency 5/5- Full regression 1867 = 1862 passed / 4 skipped / 1 xfailed / 0 F / 0 E (
--collect-onlysum reconciled exactly to 1867) - Binary robustness 5-round automated acceptance (hash / portable launch / frozen GUI / silent install / post-install real search)
Detailed release notes in repo docs/RELEASE-NOTES-v3.6.0.md ~ docs/RELEASE-NOTES-v3.6.3.md, roadmap and acceptance checklist in docs/STATUS.md and docs/HANDOVER-20261106.md.