bluesky / hklpy2 / 24527290775

100%

push

github

fix #221 forward() performance: >2,000 ops/sec; add benchmark() utility (#359)

* test #221 add forward() and inverse() throughput benchmark

Establishes baseline: forward() ~183 ops/sec, inverse() ~2,700 ops/sec.
Target is >=2,000 ops/sec for both. forward() tests fail until fixes applied.
Agent: OpenCode (claudesonnet46)

* fix #221 short-circuit convert_units() when units are identical

Eliminates 92% of forward() overhead (pint doing 76 same-units conversions
per call). forward() improves from ~183 to >2,000 ops/sec; inverse() from
~2,700 to >10,000 ops/sec. Also adds how_performance.rst guide covering
factors that affect throughput for diffractometer users.
Agent: OpenCode (claudesonnet46)

* docs #221 clarify forward()/inverse() are purely computational; note network solver caveat; fix title underline length

* docs #221 add Documentation: RST Style section to AGENTS.md

Move RST title underline rule into a dedicated section adjacent to other
documentation guidance, where agents writing RST files are more likely
to read and apply it.
Agent: OpenCode (claudesonnet46)

* fix #221 cache axes_xref_reversed; invalidate on assign_axes()

Avoids rebuilding the reversed dict on every forward()/inverse() call
(~5 rebuilds per forward()). Throughput: ~1,951 -> ~1,965 ops/sec.
Agent: OpenCode (claudesonnet46)

* fix #221 eliminate double update_solver() per forward() call

Extract _constant_axis_names() method to avoid duplicating the
constant-axes computation; forward() calls it directly after its
own update_solver(), skipping the redundant second call in
solver_constant_axis_names. Add test_core_constant_axis_names()
to cover the new method directly.
Agent: OpenCode (claudesonnet46)

* maint #221 update RELEASE_NOTES with performance fixes summary

Agent: OpenCode (claudesonnet46)

* feat #221 add benchmark() utility for user-facing performance assessment

benchmark(diffractometer, n=500, print=True) measures forward()/inverse()
throughput against the us... (continued)

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

3257 of 3257 relevant lines covered (100.0%)

4.99 hits per line