PFS GUI Documentation

The Observatories of the Carnegie Institution for Science (Carnegie Observatories), Pasadena, CA

Version 2.4

Christoph C. Birk (birk AT carnegiescience DOT edu)


Location of this document: http://instrumentation.obs.carnegiescience.edu/Software/PFS/pfs_sta.html


  • News
  • Screen Shots and GUI Documentation
  • PFS Meta Controller Status (How does this work?)
  • Troubleshooting

  • PFS Website
  • PLC manuals
  • How-To change the IP number of an Archon controller


    News

    v2.4 (2023-04-27)
  • Added the item "Observer" to the Options menu. It allows to change the OBSERVER record in the FITS header without having to restart the GUI.
  • v2.3.8 (2022-06-27)
  • Keep the magnifier in the same position when changing the binning.
  • Changed the FITS record 'DATE-OBS' to show the full date and time
  • DATE-OBS= '2022-06-23T23:07:10'
  • Deployment target macOS 10.13 (HighSierra).
  • v2.3.7 (2019-12-20)
  • Preset the exposure type ("ExpType") to Object when using the PresetGUI button on the object list window.
  • Release Notes


    Screen Shots and GUI Documentation

  • Configuration and Startup
  • Preferences
  • Main Menu
  • PFS Instrument and Data Acquisition Window
  • Auxilliary Windows
  • Quick Look Tool


    Configuration Window

    Observer: Name(s) of the observers for the FITS header.
    CCD: {offline,Online}
    offline: Simulator mode for testing.
    Online: The Archon controller is connected and powered up.
    Overscan: number of overscan pixels per line and output.
    Biaslines: number bias lines per frame.
    PLC: {offline,Online}
    offline: Simulator mode for testing.
    Online: The PLC is powered and connected to the network.
    Telescope: {offline,Clay}
    offline: Simulator mode for testing.
    Clay: get telescope coordinates from the Clay TCSIS
    CCD/Archon: IP address of the Archon CCD controller.
    PFS/PLC: IP address of the PFS PLC.
    TCS: IP address of the Clay telescope control system.


    Preferences

    General - Exposure - QL-Tool - Warnings

    Engineering Mode: Disables various warnings:
    The following features are disabled in Engineering Mode:
    The Engineering Mode is required to enable these features:
    AutoStartup: Opens the PFS-GUI without presenting the Configuration window first.
    CCD PowerOff: Turn off the power to the CCD when no exposures are taken ('0' disables this feature).
    PMT PowerOff: Turn off the power to the PMT when no exposure are taken.
    Background Collection: display a warning if the PMT has not been on long enough to estimate the background level.
    Lamp PowerOff: Turn off the power to the calibration lamps when no exposures are taken.
    Counts Time: the minimum and maximum exposure time in Counts mode.
    Shutter: text spoken by the GUI when the shutter closes.
    The text has to be in quotes; without quotes the string is interpreted as a sound filename.
    Exposure: text spoken by the GUI when the readout has finished.
    The text has to be in quotes; without quotes the string is interpreted as a sound filename.
    Clear Display: fills the display buffer with zeroes before the readout starts.
    Trim bias: display the image data only when loading a FITS file.
    Saturation Level: pixels above this level will be displayed in red.
    CCD Heater: popup warnings when the CCD heater power drops below.
    Getter Temp: popup warnings when the getter temperature rises above.
    Email: send emails to these address.


    Main Menu

    PFS - File - View - Options - Help

    About: opens a dialog box that shows the PFS-GUI software version.
    Preferences: opens the Preferences window.
    Quit: closes the PFS GUI.
    Load FITS: loads a FITS file for display on the QuickLook tool.
    Load ObjectList: loads an object list and displays it in a window.
    Load CalibrationList: loads an calibration list and displays it in a window.
    Show Logfile: displays the logfile(s) in the Console application.
    Show DataFolder: opens the data path folder in a Finder window.
    Show AppSupport: opens the /Users/Shared/Library/Application Support/PFS folder in a Finder window.
    This is where the object list(s) and calibration list(s) are stored.
    QuickLook: opens the QuickLook Tool (QlTool) windows.
    ObjectList: opens the Object List window.
    CalibrationList: opens the Calibration List window.
    PFS Status: opens the Instruments Status window.
    PLC Hardhat: opens the PLC Hardhat window.
    Target Photons: opens the Target Photons plot.
    Background Photons: opens the Background Photons plot.
    Dewar Status: opens the Dewar Status window.
    Graphs: opens the Temperature Graph plots.
    Archon Hardhat: opens the Archon Hardhat window.
    DataPaths: opens a window that allows to set the path for the FITS files.
    File Number: Temporarily enables the File# edit control on the PFS-Camera window.
    Observer: Opens a dialog box that allows to chage the observer record for the FITS header.
    Slit-Lock: dis/enables the slit control on the PFS-Camera window.
    Focus-Lock: dis/enables the focus control on the PFS-Camera window.
    GraphPars: opens a window that allows to modify the Temperature Graph scaling.
    Please note that the graph to be modified has to be the active window.
    Software Documentation: opens this webpage in a browser.
    Website: opens the PFS webpage in a browser.


    PFS Main Window

    Exposure Parameters - PFS - Exposure Control - Disk(s)


    left: PFS-GUI in ExpTime mode, right: Counts mode

    TODO
    TODO
    TODO
    TODO


    Auxilliary Windows

    DataPaths - PFS Instrument Status - Dewar Status - PLC - Photon Plots - Temperature Graphs - Object List Calibration List

    Data Paths

    /Volumes/DATA_CLAY/PFS/...: this is the primary (mandatory) data path
    The Default button presets the edit window to the standard path recommended at LCO.
    All FITS files will be written to this directory.
    It also will contain a file called pmtlog.txt that logs the readings from the PMT (photon counter) every second. This file has 6 columns:
    File#, UT-Time, counts(last second), background (per second), exposure time, exposure center
    /Volumes/DATA_CLAY/PFS/...: this is the secondary (optional) data path.
    The Browse button allows the observer to select any path, eg. to an external USB-drive to create a data backup.

    PFS Instrument Status

    If you don't know what these controls do -- please do not touch them.

    PFS Dewar Status

    CCD: CCD temperature [K] sensor (controlled, floating)
    ColdPlate: Temperature [K] of the LN2 cold plate.
    SetPoint: Set point of the CCD temperature controller (Archon).
    VacSensor: Pressure reading from the GP-375 vacuum sensor.
    IonPump: Pressure reading from the ion pump.
    The ion pump maybe turned on, off or set to Auto (recommended).
    The Auto mode uses the dewar temperature and pressure from the vacuum sensor to determine if the ion pump should be running.

    PLC Hardhat

    This window allows to manually position the Slit, Hartmann mask and the iodine cell.

    Photon Plots

    Shows the reading of the PMT (photon counter) when the shutter is closed (background) and when the shutter is open (target).

    Temperature Graphs

    These graphs show the CCD- and cold plate temperatures and the output of the CCD heater.
    The Graph Parameters window is used to manually scale the temperature / heater plots.
    The menu entry Options--GraphPars allows to scale the graph window that is currently the foreground window.

    Archon Hardhat

    If you don't know what these controls do -- please do not touch them.

    Object List

    The list is loaded by going to the PFS GUI and using the menu to select “Load ObjectList”.
    It is sortable by name, RA, and DEC. The list does not contain exposure time or exposure counts, number of loops, or whether the iodine should be in/out -- these values must be entered manually in the PFS GUI.
    In the list, you highlight the target you want (only one is able to be highlighted at a time, unlike the Calibration list), and hit “Preset”. This will send the coordinates of your selected target to the TO. It will also automatically change the binning, and readout speed in the PFS GUI, and object name that gets stored in the header.
    Clicking "Send To TCS" will only send the coordinates, but not preset anything on the PFS GUI. This option is useful when you want to send the coordinates while the last exposure loop is still running.
    It will not begin the exposure, unlike the Calibration list. If you close the Object list window, you can reopen it from the PFS GUI menu as you did at first, or go to the “View” menu in the PFS GUI and click on “Object List”.

    Calibration List

    The list is loaded by going to the PFS GUI and using the menu to select “Load Calibration List”.
    In the list, you click on which of the calibrations you want to execute, using the command key on the keyboard, and then hit “Execute Selected” (bottom right of the Calibration list window). This will send the commands to the PFS GUI, to be execute in the order they are listed in the text file -- that is, the calibrations you selected will begin execution in the GUI.
    If the Reverse box is checked, the calibrations will be executed in reverse order.
    If you accidentally start exposures that you don’t want to run, you can hit “Abort” in the PFS GUI, and that will stop the current exposure, but not any that you have selected after it. To stop all of the selected and executed calibration exposures, you need to hit “Stop” in the Calibration List window (bottom left). If you close the Calibration list window, you can reopen it from the PFS GUI menu as you did at first, or go to the “View” menu in the PFS GUI and click on “Calibration List”.


    QuickLook Tool

    TODO


    
    
    
    
    
    
    
    


    Instrument Software Documentation Index


    2016-04-13, Christoph C. Birk, Carnegie Observatories