Space Telescope Science Institute
DrizzlePac 2012 Handbook
help@stsci.edu
Table of Contents Previous Next Index Print


The DrizzlePac Handbook > Chapter 5: Introduction to the drizzlepac Interface > 5.3 Using the TEAL GUI

5.3
DrizzlePac tasks for aligning and combining images can be run using a new interactive GUI interface called TEAL. It allows users to set parameter values for controlling operation of the task. TEAL also guides users in setting the appropriate task parameters; it can load prepared text parameter files (with suffix .cfg) as well as save new parameter settings to a uniquely-named text parameter file. Help files can be accessed from TEAL, and displayed as the user continues to edit tasks parameters.
Visually, the TEAL interface looks similar to the “epar” GUI task editor developed for IRAF tasks in PyRAF. The TEAL interface, however, provides additional capabilities to assist users in editing drizzlepac task parameters.
In PyRAF, the TEAL GUI for the drizzlepac task, tweakreg, is launched using the epar command, for example, as follows:
The Python command-line syntax, typed from either 1PyRAF or the conventional Python interface, requires a command to load the TEAL task before using it to edit tweakreg. To repeat the example above using Python syntax:
The window’s title bar shows which configuration file was used to fill in the parameter values seen when the GUI is launched. Any changes made to the parameters are saved to this file when the task is executed. The pull-down menus found in the menu bar contain general TEAL operation options. Parameter changes to a task can be saved to a configuration file (more about that in Section 5.5) using the Save As option in the File pull-down menu. Under the ‘Help’ menu, there are two options: either display help for TEAL or for the task that’s being run in the GUI. The task help file can be displayed while parameters are being edited in the GUI, some help files are in the form of a html file displayed in a browser, and others appear as a text file displayed in a window.
The toolbar, found below the menu bar, has four buttons for commonly-used menu bar actions:
Execute: Runs the task using current parameter settings. Parameter settings will also be saved to the file listed at the top of the window
Save & Quit: Saves the current parameter values to the configuration file listed at the top of the window, without running the task
Cancel: Closes the window without saving any changes and without running the task
Defaults: Changes ALL the parameter values to their defaults
Figure 5.1: The TEAL GUI Displaying a Portion of the tweakreg Task
The TEAL GUI interface is especially useful for large tasks because it offers some new features that will help clarify which parameter settings to use for specific steps. Whenever a step in a task is turned off, the parameters that control that step are greyed out to be unavailable for editing by TEAL.For example, in Figure 5.1, the UPDATE HEADER and HEADERLET CREATION sections have been set to “No”. As a result, parameters affecting those sections have been greyed out and cannot be edited.
Each parameter has a short description next to it. Whenever a parameter is changed from its default value, its description changes color to indicate a change has been entered. For example, in Figure 5.1, the refimage parameter, which is blank by default, has the name of a reference image, and as a result, its description is colored red. To clear or change an individual parameter back to its default value, right-clicking on the parameter will bring up a menu that will provides these options.

1
Note the difference between the PyRAF (-->) and Python (>>>) command-line prompts


Table of Contents Previous Next Index Print