= SHARK-NIR Commissioning Plan =
[[TOC(inline)]]

This document lays out the procedures and performance requirements for commissioning the SHARK-NIR instrument. Specifically, it lists the on-telescope activities needed to bring SHARK-NIR online for scientific exploitation starting from unpacking the boxes at LBT.

The commissioning is broadly divided into four phases:
 **Phase 1**: We start by inspecting the boxes at LBT mountain bay, unpacking, and installing the instrument at the mountain lab (clean room) for alignment verification and functionality checks. All of these are daytime activities. [Pre-commissioning]

 **Phase 2**: The activities starting from the installation of SHARK-NIR at the SX central bent Gregorian focus of LBT, followed by preliminary functional checks, aligning SHARK-NIR to the telescope (daytime), and daytime closed dome engineering/technical testing. All of these are daytime activities. [Installation & Closed-Dome Testing]

 **Phase 3**: Phase 3 commences the nighttime commissioning, starting from sending preset to the telescope to testing individual SHARK-NIR observation modes for performance to the total SHARK-NIR performance. All the activities are nighttime. However, some daytime activities may be anticipated as well. By the end of this phase, SHARK-NIR is ready for early science observations. [Commissioning]

 **Phase 4**: SHARK-NIR is ready for the final phase of the commissioning - the science verification / early science observations. The final form of the SHARK-NIR software, observing blocks, data-reduction pipeline, etc. will be tested. The final performance of the SHARK-NIR will be analyzed using the data from this run. All the activities are nighttime. By the end of this phase, SHARK-NIR is ready for regular science operations (with some 'risk' of course for another year). [Science Verification]


Note that the corresponding evolving doc in the SHARK-NIR Dropbox folder is **SHARK-NIR-INAFP-COM-001_CommissioningPlan.docx**. There is also an excel file listing the activities titled **SHARK-NIR-INAFP-COM-002_CommissioningActivityList.xlsx** (BOTH NOT UPDATED).

== Applicable Documents ==

|| '''No.''' || '''Title''' || '''Number & Issue''' ||
|| AD1 || SHARK-NIR Schedule || SHARK-NIR-INAFP-SCH-001_Issue 1.2.pdf ||
|| AD2 || SHARK-NIR SW ICD || SHARK-NIR-INAFP-SW-ICD-FDR Issue 0.4 ||
|| AD3 || SHARK-NIR Installation Plan || SHARK-NIR-INAFP-IP-001 Issue 0.2 ||
|| AD4 || SHARK-NIR Calibrations || SHARK-NIR-INAFP-MAN-004 ||

== Category  ==
The table below lists the categories of commissioning activities (MAYBE BETTER TO CHANGE THE NOMENCLATURE. ALIGN CLOSE TO CALIBRATION PLAN).
||'''Category Name'''||'''Category Number'''||
||Installation, integration, verification|| C1 ||
||Daytime testing (functionality and operability)||C2||
||Daytime calibration||C3||
||Nighttime testing (functionality and operability)||C4||
||Nighttime Science Calibration||C5||
||Nighttime testing for performance||C6||

== Naming structure of the commissioning activity ==
Each commissioning test/activity has a unified structure as follows:

{{{
Name of the commissioning activity
  - phase : states the phase of the commissioning (1/2/3/4)
  - status : reports the current status of the test (draft, final, complete)
  - category : one of the categories mentioned above
  - recurrence : describes how frequently the test must be executed
  - duration : estimates the time required to complete the test (the duration mentioned here is valid only for commissioning)

Description
  - Contains a general description of the test

Prerequisites
  - Lists items that must be in place before the test begins

Procedure
  - Explains in detail how to execute the test

Success Criteria
  - Enumerates the outcome associates with successful completion of the test

Notes
  - Additional supporting information

LBTO Support
  - Mention if (and what) support required from LBTO

Associated SHARK-NIR personnel
  - Mentions here who are the associated personnel to the test

Date performed and by whom
  - Mentions who performed the test and when

}}}


== Commissioning Activity ==
In this section, you can see all the commissioning activities listed in chronological order. If you click the individual activity, you can see more details of it.

=== Phase 1 ===
'''SHARK-NIR Location''' : LBT mountain bay and clean room (Some of the activities may run in parallel).
||'''Number'''||'''Activity Name'''||'''Day / Night'''||'''Duration (days)'''||'''Category'''||'''LBTO Support'''||			
||P1.1||[wiki:/docs/CommissioningPlan/P1.1 Inspection of the boxes]||Day||0.5||C1||crane operator to lift and move containers/boxes (mountain bay)||
||P1.2||[wiki:/docs/CommissioningPlan/P1.2 Opening boxes and their visual inspection]||Day||0.5||C1||crane operator to lift and move containers/boxes (mountain bay), 1-2 crew to support unpacking and moving||
||P1.3||[wiki:/docs/CommissioningPlan/P1.3 Install the instrument in the cleanroom with its electronics cabinet]||Day||0.5||C1||crane operator to lift and move containers/boxes (mountain bay & cleanroom), 1-2 crew to support installation on the mechanical structure||
||P1.4||[wiki:/docs/CommissioningPlan/P1.4 Cable in the instrument, power on, install workstations, and connect to LBT network]||Day||0.5||C1||support to connect to LBT network, IT support to install/set the workstations in the proper location||
||P1.5||[wiki:/docs/CommissioningPlan/P1.5 Start all the services and initialize all the motors]||Day||0.5||C1||-||
||P1.6||[wiki:/docs/CommissioningPlan/P1.6 Cool down the cryostat]||Day||1||C1||Liquid N2 fill in the cleanroom||
||P1.7||[wiki:/docs/CommissioningPlan/P1.7 Verification of the operability of the motors and light sources]||Day||0.5||C1||optical bench needed in the cleanroom||
||P1.8||[wiki:/docs/CommissioningPlan/P1.8 Verification of the internal alignment of the instrument]||Day||4||C1||optical bench needed in the cleanroom||
||P1.9||[wiki:/docs/CommissioningPlan/P1.9 Science detector calibrations]||Day||1||C1||-||
||Total||Contigency of 1 day|| ||9+1=10|| || ||

=== Phase 2 ===
'''SHARK-NIR Location''' : LBT platform
||'''Number'''||'''Activity Name'''||'''Day / Night'''||'''Duration (days)'''||'''Category'''||'''LBTO Support'''||	
||P2.0||[wiki:/docs/CommissioningPlan/P2.0 Installation of the SHARK-NIR at LBT platform]||Day||1 (preparation) + 1 (lift-off) + 1 (contigency)||C1||Crew members' support for the preparation, lift-off, and installation of SHARK-NIR, crane operator (mountain bay, LBT platform), safety officer, working platform installed infont of the gregorian focal-station SX, installation of electronics in LBTI/SHARK cabinet||
||P2.1||[wiki:/docs/CommissioningPlan/P2.1 Activating the instrument and testing instrument states & transitions]||Day||1||C2||support to verify the working of emergency button/stop||
||P2.2||[wiki:/docs/CommissioningPlan/P2.2 Instrument operability and performance]||Day||0.5||C2||-||
||P2.3||[wiki:/docs/CommissioningPlan/P2.3 TCS communication test]||Day||0.5||C2||Authorise SHARK-NIR, connecting to ASM+LBTI AO system, able to send preset, receiving LBT telemetry (inc. the derotator trajectory) and details for the fitswriter, support from LBT SW team||
||P2.4||[wiki:/docs/CommissioningPlan/P2.4 Align SHARK-NIR to the telescope]||Day||1+1||C2||working platform installed in front of the gregorian focal-station SX, Mounting RR on the SX side. Support from LBTI/Arcetri on running SOUL AO||
||P2.5||[wiki:/docs/CommissioningPlan/P2.5 SOUL AO system test]||Day||0.5||C2||working platform installed in front of the gregorian focal-station SX, Mounting RR on the SX side. Support from LBTI/Arcetri on running SOUL AO||
||P2.6||[wiki:/docs/CommissioningPlan/P2.6 Measurement of NCPA]||Day||0.5||C3||Mounting RR on the SX side. Support from LBTI/Arcetri on running SOUL AO||
||P2.7||[wiki:/docs/CommissioningPlan/P2.7 Looking for filter defects/effects/features]||Day||0.5||C2||Mounting RR on the SX side. Support from LBTI/Arcetri on running SOUL AO||
||P2.8||[wiki:/docs/CommissioningPlan/P2.8 Flexure tests]||Day||2.5||C2 + C3||Mounting RR on the SX side. Support from LBTI/Arcetri on running SOUL AO, the telescope need to move in elevation||
||Total||Contigency included within || ||11 days || || ||

=== Phase 3 ===
'''SHARK-NIR Location''' : LBT platform
||'''Number'''||'''Activity Name'''||'''Day / Night'''||'''Responsible'''||'''Frequency'''||'''Duration (mins)'''||'''Category'''||'''LBTO Support'''||
||P3.1||[wiki:/docs/CommissioningPlan/P3.1 Telescope control – sending preset]||Night||SHARK-NIR||Nightly||10||C4||LBTI(AO), presence of John Hill will be great||
||P3.2||[wiki:/docs/CommissioningPlan/P3.2 Telescope control – checking focus for different wavelengths]||Night||SHARK-NIR||Nightly||30||C4||-||
||P3.3||[wiki:/docs/CommissioningPlan/P3.3 Telescope control – telescope mode and offset]||Night||SHARK-NIR||Nightly||30||C4||LBTI(AO)||
||P3.4||[wiki:/docs/CommissioningPlan/P3.4 Telescope control – focal plane geometry estimation]||Night||SHARK-NIR||Nightly||60||C4||LBTI(AO)||
||P3.5||[wiki:/docs/CommissioningPlan/P3.5 Check the acquisition procedure]||Night||SHARK-NIR||Nightly||60||C4||LBTI(AO)||
||P3.6||[wiki:/docs/CommissioningPlan/P3.6 Orient the coronagraphs]||Night||SHARK-NIR||Nightly||40||C4||LBTI(AO)||
||P3.7||[wiki:/docs/CommissioningPlan/P3.7 Estimate the instrument throughput]||Night||SHARK-NIR||Nightly||50||C4||LBTI(AO)||
||P3.8||[wiki:/docs/CommissioningPlan/P3.8 Estimate the limiting magnitude for every filter]||Night||SHARK-NIR||Nightly||50||C4||LBTI(AO)||
||P3.9||[wiki:/docs/CommissioningPlan/P3.9 Estimate sky background for broadband filters]||Night||SHARK-NIR||Nightly||50||C4||LBTI(AO)||
||P3.10||[wiki:/docs/CommissioningPlan/P3.10 Verify the ADC rotation on sky]||Night||SHARK-NIR||Nightly||40||C4||LBTI(AO)||
||P3.11||[wiki:/docs/CommissioningPlan/P3.11 Ghost positions on the SCICAM]||Night||SHARK-NIR||Nightly||50||C4||LBTI(AO)||
||P3.12||[wiki:/docs/CommissioningPlan/P3.12 Checking field-stabilized mode/bearing rotation service]||Night||SHARK-NIR||Nightly||40||C4||LBTI(AO)||
||P3.13||[wiki:/docs/CommissioningPlan/P3.13 Center the slit]||Night||SHARK-NIR||Nightly||40||C4||LBTI(AO)||
||P3.14||[wiki:/docs/CommissioningPlan/P3.14 Astrometry plate scale and orientation]||Night||SHARK-NIR||Nightly||60||C5||LBTI(AO)||
||P3.15||[wiki:/docs/CommissioningPlan/P3.15 Flux calibration (off-centered target observation)]||Night||SHARK-NIR||As required for observing||30||C5||LBTI(AO)||
||P3.16||[wiki:/docs/CommissioningPlan/P3.16 Instrumental throughput and absolute flux calibration]||Night||SHARK-NIR||Monthly||60||C5||LBTI(AO)||
||P3.17||[wiki:/docs/CommissioningPlan/P3.17 Atmospheric calibration and absolute flux calibration]||Night||SHARK-NIR||Each target||60||C5||LBTI(AO)||
||P3.18||[wiki:/docs/CommissioningPlan/P3.18 Large spatial scale instrument and telescope flat field]||Twilight||SHARK-NIR||Daily for observing nights||120||C5||LBTI(AO)||
||P3.19||[wiki:/docs/CommissioningPlan/P3.19 Sky background]||Night||SHARK-NIR||As required for observing||30||C5||LBTI(AO)||
||P3.20||[wiki:/docs/CommissioningPlan/P3.20 Instrumental background for science]||Day||SHARK-NIR||Daily for observing nights, closed dome||(TBD)||C5||-||
||P3.21||[wiki:/docs/CommissioningPlan/P3.21 Star center]||Night||SHARK-NIR||Nightly||15/target||C5||LBTI(AO)||
||P3.22||[wiki:/docs/CommissioningPlan/P3.22 Instrument flat field, detector linearity and bad pixels]||Day||SHARK-NIR||Daily for observing nights, closed dome||120||C5||-||
||P3.23||[wiki:/docs/CommissioningPlan/P3.23 Wavelength calibration]||Day||SHARK-NIR||Daily when LSS is used||15||C5||-||
||P3.24||[wiki:/docs/CommissioningPlan/P3.24 Thermal background]||Day||SHARK-NIR||Monthly, closed dome||60||C3||-||
||P3.25||[wiki:/docs/CommissioningPlan/P3.25 Detector gain]||Day||SHARK-NIR||Monthly, closed dome||30||C3||-||
||P3.26||[wiki:/docs/CommissioningPlan/P3.26 Detector persistence]||Day||SHARK-NIR||Quarterly, closed dome||30||C3||-||
||P3.27||[wiki:/docs/CommissioningPlan/P3.27 Spectral resolution]||Day||SHARK-NIR||Monthly, closed dome||30||C3||-||
||P3.28||[wiki:/docs/CommissioningPlan/P3.28 Ghost calibration]||Day||SHARK-NIR||Semi-annually, closed dome||120||C3||-||
||P3.29||[wiki:/docs/CommissioningPlan/P3.29 Distortion map]||Night||SHARK-NIR||Weekly||60||C5||LBTI(AO)||
||P3.30||[wiki:/docs/CommissioningPlan/P3.30 Filter wheels reproducibility monitoring]||Day||SHARK-NIR||Semi-annually, closed dome||60||C3||-||
||P3.31||[wiki:/docs/CommissioningPlan/P3.31 Pupil alignment]||Night||SHARK-NIR||Nightly||5/target||C4||LBTI(AO)||
||P3.32||[wiki:/docs/CommissioningPlan/P3.32 PSF Alignment]||Night||SHARK-NIR||Nightly||5/target||C4||LBTI(AO)||

Cross-check with https://docs.google.com/spreadsheets/d/1MdX_-JROUDo9gQLif_mKtfvTKAgrezCl0Yb3_hi550g/edit#gid=345442572

Another Table with "science commissioning" to be added. More details soon..

== Additional Information  ==

Note:
 - as of now, there is no one to one correspondence with the evolving doc (eventually they will be the same)
 - you may see that there is some repetition in the activities. this needs to be sorted out eventually.
 - the order of the activities may also be changed later.
 - the details of each of the activity (when you click on them individually) may not be complete and will be refined in time.

To be added:
 1. Nighttime performance activities:
      - Evaluate the seeing performance and Strehl achieved from the LBTI AO in closed-loop and various seeing conditions.

 2. Look-up table activities:
      -  NCPA measurement for different telescope elevations?



Reminders:
 - The space requirements at the mountain bay (@LBT) should be communicated to LBT at the earliest, along with the availability of crane operator, container moving tools, etc. Depending upon the month of the year, the mountain bay can be seriously booked (especially during July-October months due to summer shutdown).
 - The same is true for the cleanroom near the mountain bay. If we need access to the LBTO network in the cleanroom, there are some network ports. But we may need to tell them in advance (Talk to Florian Briegel for more info).
 - Note that if there is any ASM repair/activity scheduled in the cleanroom, preference is always for them and we will have to co-live or get after that.
 - From the LINC-NIRVANA commissioning experience, it is always better to keep the tools associated with a particular alignment together, to avoid looking for it in all the boxes there. Also, there MUST be a **living inventory** wiki page where everyone should note down what is taken and kept in the box/container.
 -  Space required by SHARK-NIR at 3L is already mentioned to JC and CV. Later, we may need to specify the exact area.
 - For activities (P2.4-P2.8) which need the RR to be mounted on the SX side, the source should be a bright broad-band source (including also NIR wavelength). Perhaps, Ocean Optics would do. Also, if helpful, we may use a powerful (green) laser beam for initial alignment checks.


== Comments ==

=== MDP
- all operation that should be supported by **control software** automated procedures should be defined by the responsible person with software person in copy or in accordance with software department (better) (e.g.: P1.8 and P1.9)
 
=== Reminders
 - check if all the installation of interfaces is mentioned and in the right places. if LBTO support is needed (crew, crane support, etc.), mention those.
 - make sure if all the support from LBTI and iLOCATOR team are mentioned clearly (related to the installation of electronics in their cabinets, sharing space, access permissions, IP addresses, etc.)
 - need emergency stop buttons in SHARK-NIR? If so, need to integrate them into the LBT control system?
 - check if all the electronics related support and requirements are mentioned.
 - check if all okay for the LN2 fill and glycol/cooling water flow, etc.