bluesky / hklpy2 / 24414216571

100%

push

github

feat #296 add cut-point (angle branch-cut) to LimitsConstraint

* feat #296 add cut-point (angle branch-cut) to LimitsConstraint

Add per-axis cut_point attribute to LimitsConstraint that maps computed
angles into [cut_point, cut_point+360) before limit checking in
Core.forward().  Default is -180 (range -180 up to +180), matching
SPEC cuts and diffcalc setcut semantics.  Add glossary entry, update
concepts/constraints.rst with Cut Points section, update spec_xref.rst.
Agent: OpenCode (claudeopus46)

* test #296 handle Python-version-specific solver fp for phi=-6 case

After cut-point wrapping, omega ~= -180.0001 maps to ~= +179.9999
which may pass the (-1, 180) constraint depending on solver fp
behavior.  Use _allows_no_solutions context to accept either 0 or 1
solutions for this boundary case.
Agent: OpenCode (claudeopus46)

* docs #296 add four-stage pipeline and architecture diagrams

Add sphinx.ext.graphviz to conf.py. Add four-stage forward()
pipeline diagram to howto_write_solver.rst and how_forward_solution.rst.
Add package architecture diagram to concepts/__overview.rst showing
Bluesky/EPICS -> User-facing -> Core -> Solver -> Backends layout
with blocks grouped by layer. Update AGENTS.md with guidance on
keeping the architecture diagram in sync.
Agent: OpenCode (claudeopus46)

* docs #296 refine architecture diagram labels and layout

Shorten block labels (Sample/Lattice, Reflection, Constraints,
Presets, Zone, Configuration), simplify Core label, change
'forward()/inverse()' edge to 'calculations'. Revert to TB layout
after LR experiment; keep Bluesky/EPICS as separate clusters with
EPICS below user-facing, DiffractometerBase/.beam interconnect.
Agent: OpenCode (claudeopus46)

* docs #296 plain-English explanation of cut point first

Lead both the glossary entry and concepts/constraints.rst with a
user-facing plain-English description of cut point before the
technical detail.  Add two common examples and an 'in practice'
note to the concept... (continued)

44 of 44 new or added lines in 2 files covered. (100.0%)

3073 of 3073 relevant lines covered (100.0%)

4.99 hits per line