Help for SPEC users

[prjemian]

There is a continuing request by SPEC users for comparisons and assistance with transitioning to use Bluesky.

It would be very helpful to have one place that identifies these many pieces of documentation.

Some documentation exists:

• https://blueskyproject.io/bluesky/comparison-with-spec.html
• diffractometer commands: https://blueskyproject.io/hklpy/user.html
• diffractometer utility functions: https://blueskyproject.io/hklpy/util.html
• 4-circle comparison: https://blueskyproject.io/hklpy/examples/notebooks/tst_e4cv_fourc.html
• supported diffractometer geometries: https://blueskyproject.io/hklpy/geometry_tables.html
• SPEC File Structure: https://bcda-aps.github.io/apstools/latest/api/_filewriters.html#spec-file-structure

We could also identify various bits of code which support SPEC users transitioning to Bluesky:

• convert SPEC config file to ophyd devices: https://bcda-aps.github.io/apstools/latest/applications/spec2ophyd.html
• Write Bluesky data to SPEC file
  • SpecWriterCallback : https://bcda-aps.github.io/apstools/latest/api/_filewriters.html#apstools.callbacks.spec_file_writer.SpecWriterCallback
  • Output scan(s) to a SPEC data file: https://bcda-aps.github.io/apstools/latest/examples/fw_specfile_example.html