Large Synoptjc Survey Telescope (LSST) LSE-66: Guider Interface - PDF document

Large Synoptjc Survey Telescope (LSST) LSE-66: Guider Interface Between the Camera and Telescope Paul Lotz Latest Version: 3.2 Latest Revision Date: March 6, 2017

Table of Contents 1 Change Record 6 2 LSE-66 Overview 7 2.1 Related Documents 8 2.2 Contents 8 3 Requirements 8 3.1 Data Exchange 8 3.1.1 Data Provided by Camera 8 3.1.1.1 Data Content 8 3.1.1.1.1 Image Data 8 3.1.1.1.1.1 Region of Interest Data 8 3.1.1.1.1.1.1 Image Metadata 8 3.1.1.1.1.1.1.1 Image Location 9 3.1.1.1.1.1.1.1.1 Sensor to Focal Plane Registration 9 3.1.1.1.1.1.1.2 Image Identifier 9 3.1.1.1.1.1.1.3 Time Tag 9 3.1.1.1.1.1.1.3.1 guiderTime 9 3.1.1.1.1.1.1.4 Spatial Identifier 9 3.1.1.1.1.1.1.5 Pixel Binning Level 10 3.1.1.1.1.1.1.5.1 Issue: Consider making unbinned = 1 comment a referenced element. 10 3.1.1.1.1.1.1.6 Issue: Add requirement to include ROI dimensions 10 3.1.1.1.1.1.2 Guider Data Sample Size 10 3.1.1.1.1.1.2.1 Guider data format 10 3.1.1.2 Data Transport Mechanism 10 3.1.1.2.1 Transfer Interface 10 3.1.1.2.2 Performance Constraints 11 3.1.1.2.2.1 Data Delivery Latency 11 3.1.1.2.2.1.1 dataDeliveryLatency 11 3.1.1.2.2.2 Frame Rate 11 3.1.1.2.2.2.1 FrameRate 11 3.1.1.2.2.3 Data Availability 12 3.1.1.2.3 Deployment 12 3.1.1.2.3.1 Camera Provided Software 12 3.1.1.2.3.1.1 T&S Provided Host Computer 12 3.1.1.2.3.1.1.1 Execution Environment 12 3.1.1.2.3.1.1.2 Dual-homed 12 3.1.1.2.3.1.1.3 Ethernet Port Speed 12 3.1.1.2.3.1.1.4 IPv4 Support 13 3.1.1.2.3.1.1.5 Network Configurability 13 3.1.2 Data Provided by Telescope 13 3.1.2.1 Data Content 13 3.1.2.1.1 Region of Interest Definition 13 3.1.2.1.1.1 Exposure 14 3.1.2.1.1.2 Guide Sensor 14 3.1.2.1.1.3 Guide Sensor Set 14 3.1.2.1.1.4 ROI Definition 14 3.1.2.1.1.5 ROI Dimensions 14 3.1.2.1.1.6 ROI Location 15 3.1.2.1.1.7 Object 15 3.1.2.1.1.8 Region of Interest Dimensions Request 15

3.1.2.1.1.8.1 Region of Interest Dimensions 15 3.1.2.1.1.8.1.1 ROIDimensions 16 3.1.2.1.2 Region of Interest Location Request 16 3.1.2.1.2.1 Avoidance of Detector Middle 17 3.1.2.1.3 Integration Time 17 3.1.2.1.3.1 Detector Integration Time 17 3.1.2.1.3.1.1 Integration Time 17 3.1.2.1.3.1.1.1 Issue: Use base units? 17 3.1.2.1.3.1.2 Issue: Make Detector Integration Time a constraint 17 3.1.2.2 Data Transport Mechanism 17 3.1.2.2.1 Control Commands 17 3.1.2.2.2 Performance Constraints 18 3.1.2.2.2.1 Region of Interest Lead Time 18 3.1.2.2.2.1.1 Issue: Derive requirement for TCS 18 3.1.2.2.2.1.2 Issue: Reference definition of start of exposure 18 3.1.2.2.2.1.3 Issue: Update definition mechanism 18 3.1.2.2.2.1.4 ROILeadTime 18 3.2 Sensing Requirements 18 3.2.1 Detector Requirements 19 3.2.1.1 Windows Per Sensor 19 3.2.1.1.1 Number of Windows 19 3.2.1.2 Available Area 19 3.2.1.2.1 Sensor Area 19 3.2.1.3 Detector Pixel Size 19 3.2.1.3.1 pixelSize 20 3.2.1.4 Detector Read Noise 20 3.2.1.4.1 Issue: Change text to less than or equal to 20 3.2.1.4.2 Issue: Change to "acquired at the nominal integration time" 20 3.2.1.4.3 readNoise 20 3.2.1.5 Detector Position 21 3.2.1.5.1 Sensor z-axis Tolerance 21 3.2.1.5.1.1 guiderZTolerance 21 3.2.1.5.2 Sensor z-axis Stability 21 3.2.1.5.2.1 guiderZStability 21 3.2.1.5.3 Sensor x/y Stability 21 3.2.1.5.3.1 guiderXYStability 22 3.2.1.5.4 Issue: Add a drawing 22 3.2.1.5.5 Issue: Parameterize exposure time? 22 3.2.2 Guide Sensor Integration Timing 22 3.2.2.1 Integration Time Start 22 3.2.2.1.1 intDelay 22 3.2.2.2 Integration Time Synchronization 23 3.2.2.2.1 guideSync 23 3.3 Camera Control 23 3.3.1 Diagnostic Mode 23 3.3.1.1 Binning 25 3.3.1.2 Frame Rate 25 3.3.2 Issue: Clarify that only ROI location changes per sesnsor 25 3.3.3 Issue: Delete requirement? 25 3.3.4 Issue: Identify method to change mode 25 3.4 Definitions 25 3.4.1 Pixel Identification 26 4 Details 26 4.1 Component Interactions 26

4.1.1 Interface Data 26 4.1.1.1 Init Guider 26 4.1.1.1.1 Exposure 27 4.1.1.1.2 ROI Definition 27 4.1.1.1.3 ROI Dimensions 27 4.1.1.1.4 Init Guider 28 4.1.1.2 ROI Usage 28 4.1.1.2.1 Guide Sensor 28 4.1.1.2.2 Guide Sensor Collection 28 4.1.1.3 Guider Data 28 4.1.1.3.1 Guider Data 29 4.1.1.3.2 Guider Sensor Data 29 4.1.1.3.3 Image Identifier 29 4.1.1.3.4 Image Metadata 29 4.1.1.3.5 Pixel Binning Level 29 4.1.1.3.6 ROI Location 30 4.1.1.3.7 Sensor ID 30 4.1.1.3.8 Sensor to Focal Plane Registration 30 4.1.1.3.9 Time Tag 30 4.1.1.3.10 Versioning Information 30 4.1.1.3.11 Ìmage Data 30 4.2 Deployment 31 4.2.1 Camera System 31 4.2.1.1 Camera Interface Computer 31 4.2.1.1.1 Camera Interface Environment 31 4.2.1.1.1.1 Camera 32 4.2.1.2 DAQ Computer 32 4.2.1.2.1 DAQ Server Environment 32 4.2.1.2.1.1 DAQ Service 32 4.2.2 Telescope Control System 32 4.2.2.1 Telescope Guider Computer 32 4.2.2.1.1 DAQ Client Environment 32 4.2.2.1.1.1 DAQ Client 33 4.2.2.1.2 Guider Application Environment 33 4.2.2.1.2.1 Telescope Guider 33 4.2.2.1.2.2 Telescope Guider Client 33 4.2.3 Other System 33 4.2.3.1 Other Component Computer 33 4.2.3.1.1 Other Component Environment 34 4.2.3.1.1.1 Other Component 34 4.3 Interfaces Interpretation 3 34 4.3.1 IDAQClient 34 4.3.2 IDAQService 35 4.3.3 ITelescopeGuiderClient 35 4.3.4 Image 35 4.3.5 Metadata 35 4.3.6 DAQ Client Interaction 35 4.3.6.1 MergeNode 36 4.3.6.2 ActivityFinal 36 4.3.6.3 ActivityInitial 37 4.3.6.4 Receive Guide Sensor Data 37 4.3.6.5 Subscribe to Guide Sensor Data 37 4.3.6.6 Unsubscribe from Guide Sensor Data 37 4.3.6.7 Wait for more data? 37

4.3.6.8 Subscribe to Guide Sensor Data 37 4.3.6.8.1 Object 38 4.3.6.8.2 Client1 38 4.3.6.8.3 Client2 39 4.3.6.8.4 DAQClient1 39 4.3.6.8.5 DAQClient2 39 4.3.6.8.6 MessageEnd 39 4.3.6.9 Receive Guide Sensor Data 39 4.3.6.9.1 Object 42 4.3.6.9.2 Client1 42 4.3.6.9.3 Client2 42 4.3.6.9.4 DAQClient1 42 4.3.6.9.5 DAQClient2 42 4.3.6.9.6 MessageEnd 42 4.3.6.9.7 MessageEnd 42 4.3.6.9.8 MessageEnd 43 4.3.6.9.9 MessageEnd 43 4.3.6.9.10 MessageEnd 43 4.3.6.10 Unsubscribe from Guide Sensor Data 43 4.3.6.10.1 Object 43 4.3.6.10.2 Client1 43 4.3.6.10.3 Client2 44 4.3.6.10.4 DAQClient1 44 4.3.6.10.5 DAQClient2 44 4.3.7 GuideSensorDataSignal 44 4.3.7.1 GuideSensor1Data 44 4.3.7.2 GuideSensor2Data 44 4.3.7.3 GuideSensor3Data 44 4.3.7.4 GuideSensor4Data 44 4.3.7.5 GuideSensor5Data 45 4.3.7.6 GuideSensor6Data 45 4.3.7.7 GuideSensor7Data 45 4.3.7.8 GuideSensor8Data 45 4.3.7.9 GuideSensorDataSignal 45

Large Synoptic Survey Telescope LSE-66: Guider Interface Between the Camera and Telescope 1 Change Record The revision history of this document is as follows. Version Date Description Owner name V. Riot, J. Sebag, M. 1 10/19/2010 Initial version Warner 1.1 6/16/2011 Elevation to LSE handle C. Claver 1.2 7/4/2011 General edits J. Sebag 1.3 8/11/2011 General edits J. Sebag 1.4 4/25/2012 Expanded detail J. Sebag Incorporates geometric and tolerancing definition agreed 2 10/28/2014 B. Selvy to by all parties. Approved via LCR-255 Incorporates LCR-360, which updated the ROI size and 3 1/28/2016 B. Selvy associated interface requirements Restructured requirements to make relationships clear. Added connectors and diagrams to detail the relationships. Modified text for clarity. Added a number of issues. Added requirement (previously proposed) for Spatial Identifier in metadata. Made modifications to text for clarity in: Guider Data Sample Size (added “per pixel”) 3.1 11/10/2016 Frame Rate (changed “size” to “dimensions”). (Made P. Lotz equivalent changes elsewhere.) Expanded TS Provided Host Computer requirement into multiple requirements. Added diagram and model elements describing Deployment and message content. Did some restructuring and added text to structural elements of document to make the generated document more readable. Added text to packages and elements where appropriate. 3.2 Made changes to follow up on agreements during P. Lotz discussions with Camera and Systems Engineering teams 29 Nov 2016 and 02 Dec 2016. Updated Overview text. Cleaned up Data Content hierarchy. Image Data requirement (0001): Added "to the Telescope" to the text. Sensor to Focal Plan Registration requirement (0031): Reworded to include the phrase, "The Camera shall provide" for clarity. Added statement indicating this is The contents of this document are subject to configuration control and may not be changed, altered, or their provisions waived without prior approval of the LSST Change Control Board. 6 March, 2017 Page 6 of 45