SANS2D: Detector & Baffle Schematic Indicator

[kjwoodsISIS]

As a SANS2D scientist, I want IBEX to provide a GUI element that indicates (schematically) the position of the two detector arrays (front & rear) and two baffles (front and rear), so that I can easily see their relative positions.

Acceptance Criteria

1. The IBEX GUI provides an indicator that illustrates the relative position of each of the front & rear detectors and front & rear baffles
   • the detectors & baffles all move, in effect, on a shared, linear axis (the z-axis)
   • from low z to high z, the order of the elements is:
     1. front detector
     2. front baffle
     3. rear baffle
     4. rear detector
2. There should be 4 items on the indicator (one for each element listed above)
3. Detectors should be illustrated in a different colour from baffles.
4. The indicator should have a scale to provide a numerical indication of the position of each element.
5. The indicator should display the distances between:
   1. the front detector and the front baffle
   2. the front baffle and the rear baffle
   3. the rear baffle and the rear detector
6. The fields showing the inter detector/baffle distances should change colour as the distances approach the minimum allowed distances (see SANS2D: Minimum Baffle/Detector Intervals #4587):
   • orange background when distance is within 10 cm (configurable) of the minimum
   • red background when distance is within 5 cm (configurable) of the minimum
7. As the motor positions of the detectors & baffles change, the sliders should move accordingly.
8. IBEX provides at least the same level of functionality as the existing LabVIEW VI.

Notes

1. This ticket is a sub-ticket of SANS2D: Control of Vacuum Tank (EPIC) #4576.
2. The detectors & baffles are each mounted on a trolley; the trolleys move on shared rails.
3. A slider style control is suggested for the Detector & Baffle Indicator:
   • the slider control should reflect the current position of the motor driving each element (detector trolley or baffle trolley)
   • there is no requirement that the control operates by a drag operation
4. A slider style control also provides a simple visual indication of how close the detectors & baffles are to each other, which could help the user avoid a collision of detectors & baffles.
   • For the avoidance of doubt, the Detector & Baffle Schematic Indicator is not intended to provide a collision prevention mechanism.
   • in the event of a collision between detectors & baffles, there are routines in the Galil controller(s) which initiate a rapid deceleration to avoid (or at least minimise) damage to devices.
5. The OPI could display two sets of intervals - one based on readbacks of the current positions of the detectors & baffles; the other based on setpoints for the detector & baffle positions.
   1. Current interval = readback_B - readback_A
   2. Requested interval = setpoint_B - setpoint_A
6. There are schematic diagrams showing the operation of the SANS2D vacuum tank.
7. There are schematic diagrams showing the how the SANS2D vacuum tank User OPI and Advanced OPI could look.
8. The LabVIEW VI for the SANS2D vacuum tank is located at: C:\LabVIEW Modules\Instruments\SANS2D\Sans2d Tank (for more details see the S2d Tank - Front Panel.vi in the file Sans2d Tank - System Functions.llb)

[JamesKingWork]

PRs:

• Ticket4580 sans2d vacuum tank detector baffle indicator ibex_gui#1143
• Ticket4580 sans2d vacuum tank detector baffle indicator EPICS-ioc#513

See https://github.com/ISISComputingGroup/ibex_developers_manual/wiki/Omron-FINS to start the FINS IOC for the vacuum tanks correctly.

You will need to be running with the NDXSANS2D configuration branch. Run the configuration/galils/setupmotors.bat script to set up the sans2D motors.