Skip to main content
Gemini Observatory Logo
NOIRLab Logo U.S. National Science Foundation (NSF) logo
Canadian National Research Council (NRC) logo Chilean Agencia Nacional de Investigación y Desarrollo (ANID) logo Brazilian Ministério da Ciência, Tecnologia e Inovação logo Argentinean Ministerio de Ciencia, Tecnología e Innovación logo Korea Astronomy and Space Institute (KASI) logo
  • Menu
      • Start here!
      • Phase I: Proposing for Time
        • PIT
          • PIT Description
          • PIT Help
        • Standard Semester Program
          • 2025A Call for Proposals
            • Semester 2025A Instrument Restrictions and Target Accessibility
            • Semester 2025A Important Dates
            • Semester 2025A Time Distribution
          • 2024B Call for Proposals
            • Semester 2024B Instrument Restrictions and Target Accessibility
            • Semester 2024B Important Dates
            • Semester 2024B Time Distribution
          • 2024A Call for Proposals
            • Semester 2024A Instrument Restrictions and Target Accessibility
            • Semester 2024A Important Dates
            • Semester 2024A Time Distribution
          • JWST Synergies Proposal Category
          • Previous Calls for Proposals
            • 2023B Call for Proposals
              • Semester 2023B Instrument Restrictions and Target Accessibility
              • Semester 2023B Important Dates
              • Semester 2023B Time Distribution
        • TAC
        • PW
        • LLP
          • 2025 LLP Call for Proposals
          • 2024 LLP Call for Proposals
          • 2023 LLP Call for Proposals
          • 2021 LLP Call for Proposals
          • 2020 LLP Call for Proposals
          • Approved LLPs
            • Gemini as the Ultimate Time Domain Follow-up Machine: Understanding the Nearest Cosmic Explosions
            • SPECTRE-GHOST: Spectroscopically Probing Extremely (hot) Climates of TRansiting Exoplanets with GHOST
            • The GHOSTLy quasar sample
            • GOFAST–XRB: Gemini Optical FAST timing of X-Ray Binaries
            • Velocity-resolved Echo Mapping with Gemini
            • Deriving Reliable Fundamental Quasar Properties with Gemini Near-Infrared Spectroscopy
            • The First Large Census of Fast Radio Burst Host Galaxies with Gemini
            • Leverage the Past For A Future With High-res Spectroscopic Phase Curves of Hot Jupiters
            • Elemental Abundances via SpectroscopY of Exoplanet-hosting Cool Dwarfs
            • A MAROON-X radial velocity search for planets around the nearest stars
            • A Spectroscopically Complete Census of Faint Transients Observed by the Young Supernova Experiment
            • Roasting Marshmallows: Disentangling Composition & Climate in Hot Jupiter Atmospheres through High-Resolution Thermal Emission Cross-Correlation Spectroscopy
            • Investigating the Activity Drivers of Small Bodies in the Centaur-to-Jupiter-Family Transition
            • Subaru Intensive Program: g-band Imaging for Science with Euclid and UNIONS
            • Exploring the Diversity of Exoplanet Atmospheres at High Spectral Resolution
            • A High-Resolution Survey of Molecular Abundances in Transiting Exoplanet Atmospheres
            • Validation and Characterization of Exoplanets with Gemini High-Resolution Imaging
            • Monitoring Seasonal Reversal in Uranus' Upper Atmosphere
            • Observational Characterization of Recurrently Active Main-Belt Comets and Near-Earth Main-Belt Comet Candidates
            • ZF2K: The First Exploration of the K-Band Window and a Complete Census of Massive Galaxies at 4 < z < 6
            • Chemistry of new metal-poor stars found in the Pristine Survey
            • Validating TESS Exoplanet Candidates
            • Young Star & Protoplanetary Disk Evolution with High- Resolution IR Spectroscopy
            • Placing High-Redshift Quasars in Perspective: a Gemini Near-Infrared Spectroscopic Survey
            • MaDCoWS: The Massive and Distant Clusters of WISE Survey
            • The K2 Supernova Experiment - Campaigns 16 and 17
            • Scattered Light imaging of YSOs: Probing the Fundamental Stages of Planet Formation
            • DES Supernova Cosmology
            • Addressing a Bias in the Relation Between Galaxies and Their Central Black Holes
            • Observational Characterization of Active Main-Belt Comets and Main-Belt Comet Nuclei
            • Dynamical Masses of Black Holes and Neutron Stars from the Galactic Bulge Survey
            • Characterizing Dusty Debris in Exoplanetary Systems
            • The First Survey Dedicated to the Detection and Characterization of Clouds in Exoplanet Atmospheres
            • Validating K2’s Habitable and Rocky Planets with AO Imaging
            • A GNIRS Near-IR Spectroscopic Survey of z>5.7 Quasars
            • Probing the dark halo of the Milky Way with GeMS/GSAOI
            • Where Accretion Meets Feedback: A Galaxy Redshift Survey in HST/COS Quasar Fields
            • Rapid Spectroscopy of Elusive Transients and Young Supernovae
            • Spectroscopic Confirmation of Dark Energy Survey Strong Lensing Systems and Spectra for Photometric Redshift Calibration
            • COL-OSSOS: COLours for the Outer Solar System Object Survey
            • The GOGREEN Survey of dense galaxy environments at 1<z<1.5
            • Followup of newly discovered Near-Earth objects from the NEOWISE survey
        • FT
          • FT CfP
        • DDT
        • Queue
        • Classical
        • PV
        • ToO
        • Eavesdropping
        • Joint Proposals
      • Phase II: Requesting & Monitoring Observations
        • OT
          • OT Description
            • Science Program Elements
            • Detailed element editor
            • Menu Bar
            • Problems tab
            • Main Toolbar
            • Science Program Viewer
            • Libraries
            • Browser
            • OT Position Editor
            • Guide Star Selection
            • Catalog Query Tool
            • Templates
            • Other
          • OT Help
        • OT/Phase II Checklist
        • Instructions
          • Instructions archives
        • Useful to know
        • Non-Sidereal Targets
      • Phase III: Retrieving & Reducing Data
        • Downloading and Understanding the Data
        • Reducing the Data
          • DRAGONS Data Reduction Software
          • Gemini IRAF Data Reduction Software
            • Getting Started with Gemini IRAF
          • Timing information
          • Data Formats
          • Installing Anaconda for Gemini
        • Getting Help
          • Data Workshops
        • Acknowledging Gemini
        • Providing Feedback
      • Getting Help
        • Submit a General Helpdesk Request
      • Schedules and Queue
        • Nightlog GN
        • Nightlog GS
        • 2025A Classical Schedule
        • 2024B Classical Schedule
        • Queue Summary (Bands, DD, LP, FT, PW)
        • Previous Semesters
          • 2024A Classical Schedule
      • Resources
        • Magnitudes and Fluxes
          • Conversions between magnitudes and flux
          • Flux Conversion Tool
        • Multi-Object Spectroscopy
        • Near-IR Resources
          • Photometry
            • Photometric Standard Search
            • UKIRT Standards
            • Hunt Standards
            • Persson Standards
            • Persson Red Standrads
            • UKIRT Bright Standards
            • NIRI Filter Color Transformations
            • Very Faint Standards
          • Spectroscopy
            • Telluric Standard Search
            • Spectral Templates - Library V2.0
            • Spectral Templates - Observations and Data Reduction
            • Spectral Templates - R=18000
            • CO lines and band heads
            • Important H2 Lines
            • Hydrogen Recombination Lines
        • Optical Resources
        • Integration Time Calculator (ITC)
          • ITC Help
          • ITC Release Notes
          • Properties in the ITC
        • Advice
        • Available Filters
      • Science Operations Statistics
        • Historical statistics
      • Telescopes and Sites
        • Telescopes
        • Sites
          • Cloud Cameras
            • Gemini South All Sky Camera
          • Site Status
          • Weather Now
      • Policies Regarding Observing
      • Visiting Gemini
        • Graduate Student Visitor Program
        • Visitas al telescopio
        • Maunakea Visitor's Guidelines
      • Operations Development
      • Current Instruments
        • Altair
          • Modes
          • Performance
          • Field Lens
          • Observation Preparation
          • Documents
        • GHOST
          • Capabilities
          • Components
          • Proposal Preparation
          • Calibrations
          • Exposure Time Estimation
          • Preparing Observations
          • Data Reduction
          • GHOST Webinar Series
          • GHOST System Verification
          • Documentation
        • NIRI
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure time estimation
          • Data reduction
        • TEXES
          • Sensitivity and Time Requests
          • Integration Time Calculator
        • GNIRS
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure time estimation
          • Data reduction
          • Documents
        • IGRINS-2
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure Time Estimation
          • Data Reduction
          • Documents
        • GMOS
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure Time Estimation
          • Data Reduction
          • Documents
        • GeMS
          • MCAO
          • Performances
          • Components
          • Observation Preparation
          • Procedures
          • Documents
        • Flamingos 2
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure Time Estimation
          • Data reduction
          • Documents
        • GSAOI
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation preparation
          • Exposure Time Estimation
          • Data reduction
          • Documents
        • `Alopeke & Zorro
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
            • Point Source Standard Search
          • Observation preparation
          • Data reduction
        • MAROON-X
          • Capability
          • Components
          • Proposal preparation
          • Calibrations
          • Observation Preparation
          • Exposure Time Estimation
          • Data Reduction
          • Documents
      • Future Instruments
        • Specs and Documents
        • SCORPIO
        • GIRMOS
        • GPI 2.0
        • GNAO
          • Design
          • Publications
          • Science Cases
          • Team
      • Visiting Instrument Program
        • Telescope Interfaces
      • Instrument Upgrade Program
        • Previously Awarded Updates
        • 2017 Request for Proposals
      • Retired Instruments
      • Performance Monitoring
      • Timing information in Gemini Instruments
      • Conduct
      • Careers and Jobs
      • Publications
      • Gemini Telescopes, Science and Technologies
      • Gemini In The Era of Multi-Messenger Astronomy
        • GEMMA Team
        • Publications
        • GEMMA Outreach
        • Documents
          • AOB Conceptual Design
      • National Gemini Offices (NGO)
      • Governance
      • Participant Shares
      • Web Accessibility
      • Contact Us
      • Gemini Contact Scientists
      • Gemini Strategic Planning
      • Gemini Research Staff
      • Images
      • Videos
      • CloudCam
      • Virtual tour
      • Activities at Gemini
        • Live From Gemini
        • Journey Through The Universe
      • Facility Tours
      • Gemini Card Game
      • Gemini Science Meetings
      • Gemini at National Meetings
      • Topical Science Meetings
  • Home
  • Observing
  • Phase II - Program preparation, observations, quality control and archiving
  • Observing Tool (OT)
  • Gemini Observing Tool (OT) Description

Other Components

Updated October 1, 2021 by astephens
  • Share
  • Tweet

OT Description

  • Science Program Elements
  • Detailed element editor
  • Menu Bar
  • Problems tab
  • Main Toolbar
  • Science Program Viewer
  • Libraries
  • Browser
  • OT Position Editor
  • Guide Star Selection
  • Catalog Query Tool
  • Templates
  • Other

Templates

The initial program 'skeleton' observations were replaced in 2012B with much more complete template observations based on the examples in the OT instrument libraries.  This page describes the features related to the use of the template observations.

Template Groups

Template groups for science observations are found in the new "Templates" folder at the top of the program. Inside the Templates folder exists a "Template Group" for each configuration requested in the Phase-I proposal.

Targets associated with template groups

Template observations may be accompanied by baseline calibration observations in separate "Baseline" folders. These typically include observations which will be executed once per instrumental configuraton, e.g. twilight flats, nod & shuffle darks, and spectrophotometric standards.

The targets approved in the Phase I proposal may be viewed by clicking on the "Template Group" nodes which are labeled according to the instrument configuration, e.g. "GMOS-N LongSlit R831...". This list includes the approved observing conditions and the total integration times. Targets may be moved between templates using drag and drop.

Template Regeneration

The libraries and rules used to generate the templates are maintained in a web service. The templates will be updated each semester and as new modes are commisisoned or procedures updated. The templates may be regenerated from the server at any time that you are connected to the internet. The Regenerate button is located in the "Templates" Folder (below) or in the Templates option of the righ-click menu, or via the Menu bar: Edit > Template > Regenerate.

Top-level templates folder

Selecting "Regenerate" brings up the "Template and Calibration Regeneration" window:

Template regeneration window

If "Add a new copy of the templates" is selected, the current templates will be preserved as well as the links between these templates and any observations created from them. Associated targets may be moved (via drag & drop) to the new tempates when the new templates are created or kept in their current groups.

Any Baseline calibration observations that are added to a separate 'Baseline' folder that are regenerated are always added to a new folder.

Template Splitting

Template Groups may be "split" to create a new group which may be configured independently from the original group. This allows for changes in observing strategy (i.e., acquisitions, offset patterns, etc.) for different targets. To split a Template Group, select the group and click the "Split..." button at the bottom. This will bring up a dialog box to select which targets and conditions should be moved to the new Template Group:

Template Splitting Window

The new Template Group will have a running number appended to the group number (in brackets) to help identify it's origin. This new group may now be modified as needed.

Applying Templates

When satisfied with the templates, they may be "applied" to any or all of the associated targets to create real observations. This is accomplished by clicking the "Apply" button on the Main Toolbar or via the right mouse button "Template" menu, or via the Edit > Template drop-down in the Menu Bar. The Apply Template window is shown below and here it is possible to select any or all of the approved targets. The "apply" process creates a copy of the template and adds the target and observing conditions.

Template Apply Window

Reapplying Templates

After a template has been applied to create observations, it is possible to make bulk changes to those observations by updating the template and then re-applying the template to the relevant observations. This will modify existing observations so that they match the template, keeping only the target node and position angle unchanged.

Template Reapply Window


Phase 2" indicating that the detailed definition of the observation is in progress. 

Observations are set to "For Review" to indicate that they are ready for checking by the Principal Support staff who provides Phase II support*. Observations are set to "In Review" to indicate that the Principal Support staff are actively reviewing them.  If any problems are found then may be set back to "Phase 2" for further work by the PI.Observations are set to "For Activation" to indicate that they are ready for final verification by the Additional Support staff *. If any problems are found then they may be marked back to "For Review" or "Phase 2" for further work by the Principal Support staff or the PI."On Hold" observations are either active templates for Target of Opportunity triggers or are waiting for an external event, such as the arrival of a MOS mask.Observations marked "Prepared/Ready" may be selected by the observer for execution.* For newly commissioned instruments or modes where Gemini staff provide Phase II support, observations that are correctly defined pass directly from "For Review" to "Ready". 

Responsibilities During Phase II Process

During the Phase II cycle illustrated above, the process to be followed and actions to be taken by Principal Investigators, Principal Support staff and Additional Support staff are as follows:

Gemini Before the start of the semester, creates skeleton science programs in Observing Database. Emails PI (or Joint Proposal Principal Contact, PC) with the unique key assigned to their program. Emails National Offices with keys for supporting that partners Phase II observations.
Investigators (PI / PC) The PI or PC (or anyone to whom they have delegated responsibility) uses the current Observing Tool to sync the skeleton science program from Observing Database. The Sync option is available from the main toolbar in the science program editor, from the File menu, or with Cmd/Ctrl-s.

The PI or PC uses OT to define details of some or all observations *. During this phase the all edits by the PI/PC are saved automatially to the local database (on their local disk). The program can be exported as an XML file for backup (see the loading/saving maintenance options).

*For GMOS MOS programs, pre-imaging observations and complete MOS spectroscopy template groups must be defined by the regular Phase II deadlines. Once the masks have been designed and submitted by the PI there will be opportunities for small revisions to the MOS spectroscopic observations defined by the PI as needed . 

Once they are satisfied with the observation details, the user sets observation status flag(s) to For Review and then syncs the science program into the Observing Database (using the toolbar button or the  File...Sync menu option in the science program editor). The newly-defined observations are merged automatically with the existing contents of the Observing Database (ODB). If the observations have status Phase 2 or For Review in the ODB, then changes made in the local database are copied to the ODB.  However, if the observations have status In Review or higher in the ODB then a sync conflict will need to be resolved.

Note that PIs can only change the observation status between Phase 2 and For Review. (The reverse change is available so that a PI can change their mind about the status).

 Before making any changes to a program, it is good practice to sync the program to the ODB. Before storing the updated science program to the ODB, ensure that the observation status flags are set appropriately (e.g. to For Review) and export the program to a XML file (File...Export as XML).

Setting the status flags and storing the science program causes the Observing Database to notify automatically the relevant National Office and Gemini support staff that one or more observations are awaiting review.
Principal Support Upon notification that observations are ready for review, the Principal Support contact uses the OT to retrieve relevant science programs from the Observing Database using the same sync option available to PIs and checks observation details. The NGO key or User key allows them to access all programs for which they are responsible for Phase II support.
The Principal Support staff member should set all the observations that they are reviewing to status In Review and store the program in order to prevent any changes during the review process.
If an observation checks OK, the Principal Support contact sets observation status flag to For Activation and uses the OT to store the science program into the Observing Database.  The PI and the Additional Support staff are automatically notified that one or more observations are awaiting final verification. If the Principal Support is a Gemini staff member, then the observations may be set directly to Prepared.
If observation are found to have problems, the Principal Support staff member sets the observation status flag back to Phase 2 and stores the science program into the Observing Database. The PI is automatically notified that one or more observations need further work. PI and support staff work to resolve the problems off-line, e.g., using the Gemini Helpdesk.
Additional Support Upon notification that observations are set to  For Activation, the Additional Support contact uses the OT to examine relevant science programs from the Observing Database. (Gemini staff have access to all programs.)
If an observation checks out, then the observation status flag is set to On Hold or Prepared (equivalent to Ready). If the observation is set to Prepared then the PI and all support staff are automatically notified that it is active in the queue.
If observation details are found to have problems, the observation status flags are set back to For Review and the PI and Principal Support staff are automatically notified that one or more observations need further attention.

Science Program Tabs

File Attachment tab

Auxiliary files for the program such as Phase I files, mask design files, finding charts, and special ephemerides can be uploaded and download using the File Attachment tab on the top-level science program node. New programs include the files from the Phase I proposal (PIT XML, PDF attachment, and summary PDF). 

File Attachment tab

Drag the boundary line between the column titles to change the column width. Selecting a row in the table will activate all of the buttons along the bottom of the tab. The possible actions are:

Add  Add (upload) a new file. Clicking this will bring up a file selection dialog. Navigate to the proper directory, select the file or enter the file name, and click Attach.
Remove  Remove the selected file from the ODB server.
Download Download the selected file to the local machine. A file dialog will appear. Select or enter the path to the director where the file will be stored. Then click Store. The file will be saved with the same name as given in the table.
Open Download and display the selected PDF or image file and view it in the default application. 
Refresh Refresh the attachment table.

When a line is highlighted you may enter a short description in the text box. Then click the Describe button to save the text. 

Program checkers will be able to toggle the "NGO Check" status. This is to inform Gemini that mask designs or finder charts have been checked and are acceptable for continued processing.

Sync History tab

As the name suggests, the Sync History tab contains time stamps for when the program was synced with the relevant Gemini Observing Database (ODB). The table shows the number of syncs within the given periods of the time and the key that was used. This can help identify who made a given change.

Sync tab

International Gemini Observatory

The International Gemini Observatory  provides the astronomical communities in six participant countries with state-of-the-art astronomical facilities that allocate observing time in proportion to each country's contribution. In addition to financial support, each country also contributes significant scientific and technical resources. The national research agencies that form the Gemini partnership include: the US National Science Foundation (NSF), the Canadian National Research Council (NRC), the Chilean Agencia Nacional de Investigación y Desarrollo (ANID), the Brazilian Ministério da Ciência, Tecnologia e Inovação, the Argentinean Ministerio de Ciencia, Tecnología e Innovación, and the Korea Astronomy and Space Institute (KASI). The observatory is managed by the Association of Universities for Research in Astronomy, Inc. (AURA) under a cooperative agreement with the NSF. The NSF also serves as the executive agency for the international partnership.     


Association of Universities for Research in Astronomy, Inc. (AURA) logo

Follow Gemini Observatory