This is a summary of normal IGRINS use for observers at the McDonald 2.7m telescope
...
On Atlas
Log in with IGRINS account.
Ask for username and password if you do not already know it.
Open Browser (Firefox has all of these bookmarked).
In the IGRINS bookmarks folder open the following:
SNR Quicklook (http://192.168.2.2/?obsdate=date): For looking at the spectra taken throughout the night to verify observations are reaching the required SNR. Note: The date at the end of the link must be updated to the current observing date from the bookmarked date.
Nightly Observing Record (https://igrins-status.firebaseapp.com/night/date) : Keeps track of all of the IGRINS observations taken in a night. Note: The date at the end of the link must be updated to the current observing date from the bookmarked date.
House Keeping Package: Keeps track of the instrument health--always--monitor to ensure all of IGRINS parameters are within acceptable ranges.
IGRINS Digital Night Log: A google spreadsheet that will auto populate throughout the night per frame taken.
What Target is IGRINS Observing?: Tracks the coordinates put into the TCS, the position angle of the slit, and over-plots the slit onto a 2MASS K-band image of the target. Best if used in parallel with a finder chart, but can be helpful for verifying rotation orientation and pointing.
Open weather related monitoring pages from the McDonald weather links tab in the bookmarks. We recommend the Mt. Lock Live Weather, the McDonald Observatory Clear Sky Chart, and AccuWeather or Windy for cloud monitoring.
Open the VNC Viewer to view the IGRINS computer.
Applications → Internet → VNC Viewer
Connect to the IGRINS ICC. Should only require a double click, but you can follow the steps below if needed.
From atlas use the internal ip address 198.168.2.2 but if connecting from outside the network use the external ip address (might need to use McDonald VPN): 198.214.229.87
Port: 5902
Username: admin
Password: [ask someone if you don’t know it. It is the standard IGRINS password]
Input the IGRINS computer password.
On the VNC-viewed IGRINS Computer (ICC):
Open a terminal window.
> cd ~/igrins_admin
> sh ./run_icshub.sh
The IGRINS Hub should appear--verify that the date of observation is correct.
If “Check Mount” is Failing:
Open a new terminal window.
> cd ~/igrins_admin
sh ./mntrun
Enter the IGRINS computer password.
Click the “Check Mount” button in the IGRINS Hub, which should hopefully return the status to “Okay”.
If “Fail” again: remote into IGRINS detector computers. If not able to login [add link], check the computers are turned on in the electronics rack. If they are turned on, there is likely an issue with the fiber optic cable--contact observing support.
Click “run HKP” & verify the health of the instrument.
Open a new terminal window.
> cd ~/igrins_admin
sh ./run_all_scripts.sh
The terminal for this should take up the entire length of the screen--it runs multiple scripts with outputs that are hard to read otherwise
This script runs multiple scripts that allow for the use of the firebase apps that update throughout the night (see the IGRINS Bookmarks tab on Atlas Firefox)--these improve quality of life greatly but are not strictly required.
Open a new terminal window.
> cd ~/igrins_admin
sh ./run_file_transfer_daemon.sh
This script manages the file transfer between the ICC and the IGRINS computer. Do not close the pop-up window!
On Atlas, Launch the TCS. Make sure you are using the '2.7m Cass F/9' mount model.
In the IGRINS Hub click “run TCSProxy”.
Verify that the top of the pop-up says “TCSProxy HJST 107””.
Verify that the coordinates from TCSProxy match those in the TCS window on Atlas.
If all of the coordinates read as 0’s, then the Colossus computer might have failed. Phone for observing support locally.
In the IGRINS Hub click “run SCP” and “run DTP”.
On the SCP (Slit Camera Viewer), click “Single” in the Detector Control (box 13).
Verify that a slit camera image is produced (box 5).
On the DTP (Data Taking Package) click “Test Exposure” on the bottom left under the K-Band image box (box 1)
Verify that an image is produced in H- and K-Band
Verify that the TCSProxy coordinates are not all 0’s (that the connection between IGRINS and TCS is good).
If all coordinates read as 0’s, then the Colossus computer might have failed. Phone for observing support locally.
If for whatever reason, either of these fail, phone for help!
To enable sounds from the IGRINS observing computer in the observing room:
Open a terminal in Atlas
> cd igrins_tools
> cd play_msg
> /home/igrins/miniconda3/envs/igos3/bin/python play_msg.py (running the script the enables the notification sounds).
On the Atlas computer open the following:
The MONET sky camera (pink “SKY” button pinned to the taskbar).
The HJST dome floor camera (pink “HJST” button pinned to the taskbar).
The HJST slit camera (pink “SLIT” button pinned to taskbar).
The Night Report (enter name info and add report content throughout the night).
...
Check and zero the telescope pointing
If TCS has not been reset since the prior night of observing, your pointing will be easier to find than if TCS was reset during the day.
Follow either of the directions outlined here:
Note: Since IGRINS has returned to McDonald Observatory in late 2024 the pointing has been difficult to obtain because the zeroes are often far off when TCS is reset. Be prepared to spend up to several hours in the beginning of the night pointing (particularly spiraling around using the paddle in the SCV), especially if you are not an experienced user of McDonald HJST. Our advice to make pointing easier is to pick a star near zenith that has several surrounding bright stars (see example 29 Peg) because if the telescope is very far off in pointing nearby bright stars clustered by dim stars are easier to identify in the slit view camera images than clusters of all dim stars. Remember to take into account the slit rotation when looking at finder charts!
Focus the telescope
Use the yellow hand paddle in the observing room to adjust the telescope focus [add image of location in observing room]
Make sure there is a star near the center of the SVC field of view that is bright enough to measure the FWHM of its PSF but not so bright it saturates the detector [take image of plots we look at in the SCV]
It might be useful to set up a spreadsheet to record your focus values VSvs. star PSF FWHM
Select minimum and maximum range of focus values to check [Note: need to add a reasonable range of valuesGenerally between 58,000 and 65,000], start at the lowest range
Start at the minimum and loop through the following procedure (there is hysteresis in the system so we always step through the same way)
Step up in values of 100- 200
Take a 4 second slit view camera image.
Click the star to measure its FWHM [put in image of the plots we use to measure this from the SCV]
Keep an eye on the shape of the star’s PSF and make sure it looks reasonable [show an example of the tail that can appear when things are out of focus]
Write down a table with the focus value the FWHM of the star
Repeat the above steps, filling up your table, until you reach the maximum focus value to check or you are confident you are out of focus
Find the focus value that gives the best FWHM (it might be useful to plot your table in a spreadsheet)
Go back to the minimum focus value
Slowly in small steps raise your focus value until your reach the value that gave you the best FWHM
Take another exposure of your star and double check you get the expected FWHM
If you are confident the PSF FWHM is good, you are now in focus!
Note: If there are large changes in temperature over the night and/or you notice stellar PSFs in your SVC images look bad, you might want to refocus
...
Move the telescope to Zenith
Using the TCS select Next → Zenith and click yes on all of the pop-up windows.
Click “Go Next” at the top of the TCS window.
Slew the telescope to Zenith by holding down the Autoslew botton on the dome floor console.
Ensure the rolling ladder is not on the raising platform.
Use the yellow hand paddle to raise platform east until you can comfortably reach the mount that connects IGRINS to the telescope.
Not so high that IGRINS or the electronics rack will hit the platform floor!
Get the wheel attachment from the red tool box on the opposite side of platform east (near the ladder that brings you to the second floor in the dome).
There are four screws on the IGRINS rotator plate that need to be loosened.
3 should have star-like handles you can manually loosen (unless a Darrin has been applied recently… then good luck)
The last screw requires a specialized wrench kept..[I don't know where this is kept; a picture of the wrench and the special bolt would be good]
Once all of the screws on the rotator plate are loosened, attach the wheel attachment to the rotator peg on the rotator plate.
This can be a little fussy to attach because the wheel and peg have interlocking parts, so a headlamp or flashlight can be helpful for getting the right orientation of the wheel.
You’ll know the wheel is in position when it is near flush against the rotator plate.
Turn the wheel to rotate IGRINS in the appropriate direction.
This requires some elbow grease!
If you have difficulty moving IGRINS with the wheel alone, attempt applying some pressure on the edges of the electronics rack to loosen the rotator plate.
DO NOT PUSH ON THE CRYOSTAT
Encoder settings for different position angles can be found here.
Once you think you are close to your desired rotation position check the value on the encoder and adjust as needed.
Once you reach the desired position
Remove the wheel and return it to the tool box.
Screw in the 3 star-handled screws on the rotator plate. They should be tight!
Use the wrench to tighten the last special screw and return the wrench to it’s found location.
Verify that the cooling cables are NOT UNDER THE PLATFORM before using the hand paddle on the dome floor console to lower platform east.
This may require that you lower the platform a little, jump off, adjust the cables, and continue lowering the platform (repeat as needed).
In the control room:
In the ICC on the SCV GUI change the the rotator value (box 10) and on the TCSProxy change the rotator value.
Resume observing!
Note: the on sky drift for guiding while observing is always higher when IGRINS is not in PA = 90 deg, so you may have to adjust the frequency that the guiding offsets are sent to the TCS (box 15 in the SCV GUI).
...
Move the telescope to Zenith
Using the TCS select Next → Zenith and click yes on all of the pop-up windows
Close the IGRINS window cover
Rotate IGRINS back to a PA of 90 degrees, if needed
Raise the east platform using the yellow hand paddle
Close the IGRINS window cover using the handle
Be sure to secure the handle using the velcro strip
Stow the telescope
Using the TCS select Next → Stow and click yes on all of the pop-up windows
Press and hold the button on the dome floor console to move the telescope to the stow position
Close the Mirror Window Cover
Using the button on the Colossus Console (the console in the dome with all the red buttons). You should hear the motor stop when it is fully closed.
Close the dome
Using the button on the Colossus Console. There will be a loud sound when it finishes closing.
Put any wind screens that are over the dome slit back to their stow positions using the hand paddle
Park the dome
Using the TCS select Tools → Park Dome and click yes on all of the pop-up windows
Close the dome doors
Close the dome vents
Using the control panel on the East side of the dome near the door
E-stop the telescope
Using the button on the Colossus Console
Turn on the passage lights (only once dome is closed fully)
Using the button on the Colossus Console
From the control room
Log-out of ATLAS
Click the power button on top right hand side of the lower monitor
Turn off the heater in the observing room
...