IDP3 Main Window Display

Load Image

This will pop up a window with which you can browse through your image files. Simply click on the name of the image you would like and hit OK. IDP3 supports fits, tiff, pic, and hdf formats.
Images are loaded with their lower left pixel in the lower left corner of the work area.

Load List

If you have several images to load, make a text file with a list of the names of the images. Save it with the tag ".lst". Then go to File/Load List, select the name of the list and hit OK. Make sure that the entire path for each image is listed in this file.

Load Multiaccum

This is for NICMOS. MIPS people don't have to worry about it...

Load Mips

This will automatically read in fits files that enclude multiple images as extensions of the fits file. The MIPS format is that the first extension is just a header file and the following extensions have all the images taken during that AOR (insrument command/request).
After selecting the fits file, you will be promted as to how many extensions you would like to read, the maximum is 16. To select all extensions for that fits file, type "*" then hit ENTER.

Save Main Display

Saves CURRENT work area image to specified file or memory. User may select to save as a single composite image or save the individual images that are "ON". If the composite image is saved the header from 'reference' image is used. Output image will include the entire work area, not just the viewable portion of the screen (if the work area is larger than the view area). The user can specify in the preferences file to output a simple (Single HDU) FITS file on output to a file when the original data contained image extensions. HDF format is not supported on output. When saving to memory, a new image structure is created and the Show Images Widget is updated with the new image name.

Delete Images

Allows user to select and delete one or more images from the currently loaded list. There is also an option to delete all images. NOT TO WORRY! This will not delete the file off your computer; it will simply remove it from the idp3 memory.

Prints the current display with annotations for the reference image and orientation (if on). The image size will be the display size, not the size of the images that are loaded. If you are printing a postscript file, the size in inches is controlled by the main_ps_size parameter in the user_preferences.

Build Mask

Pops up Build Mask Widget with a display of the reference image. in the display window. The user may Load a Mask File, Overlay a Mask File, or Save a Mask to a File (FITS format) from the File Menu. The user can zoom the data by 1, 2, 4, or 8 from the Zoom Menu. If the resultant image is too big for the default display the image is scrolled. The user may Edit the Mask by undoing the last pixel selected, the last freehand region drawn, or undo all edits. The data may be displayed with or without the mask, as well as the mask itself may be displayed. The user may blink the data with mask on and off or the data and the mask. Bad pixels are added to the mask with the cursor. There are four types of graphics supported by the widget: individual pixels, circles, polygons, and freehand. By selecting the appropriate mouse mode the user can control how bad pixels are selected.

Edit Preference

Allows user to edit several of the user preferences on the fly during program execution. These edits are not updated in the idp3_preferences file but are only applied during that idp3 session. The parameters that can be edited on the fly include:zoom method in main display, zoom method in ROI, flux conservation, method of main display dezoom, value of good pixels in mask, ROI half box size, file delimiter for saving parameters, option to display world coordinates in main display, option to show images path in show images window, specification of a load file path and save file path, as well as a load file filter.

Set Colors

Allows user to set the colors for the radial profile, roi, noise profile, cross section, orientation vector, etc.

Save List Parameters

Saves the filename, image x and y shifts, rotation angle and adjustment, padding, pixel scaling, scale factor and adjustment, bias, move adjustment, and zoom of the currently loaded images that are 'ON' in formatted ascii. A window pops up for the user to enter the name of the output file. The purpose of this is to restore the data to the screen exactly as currently loaded.

Restore List/Parameters

Prompts user for name of parameters save file. Loads in parameters and restores main display to the state when the parameters were saved. Parameters include everything that can be saved in "Save List Parameters". All images are loaded and adjusted according to the values of the above parameters into the CURRENT work area.

Exit idp3

Show Images
Pops up image list if it isn't already shown. Allows user to turn images on or off and to specify how this image is displayed (function).
Select Image
Pops up a selection widget allowing the user to specify which of the currently loaded images will be the Reference image. This can also be selected in the Show Images Widget.
Align by WCS
Aligns all of the 'ON' images by the world coordinates in their headers to the coordinates in the 'Reference' image. Also found in the ROI Plot Menu. NOTE: The world coordinates must be expressed as CRVALS, CRPIX, and CD matrix. CDELT1, CDELT2, and CROT2 can also be supported, but idp3 will convert them to the CD matrix.
Undo Alignment
Sets the x and y offset values to 0.0 for all 'ON' images. Also found in the ROI Plot Menu.
Combine Images
Combines all of the 'ON' images by mean, sigma clipped mean, median, or sigma clipped median. Can also calculate the standard deviation and number of pixels input to each output pixel. Results may be saved to disk in the user designated fits file and/or to idp3 memory. Clipping is controlled by the nsigma limits set in the widget.
Median Images
Computes the median of all 'ON' images and saves result in user designated output file. Superseded by Combine Images.
Sigma Clipped Median
Computes the sigma clipped median and standard deviation images of all 'ON' images and saves the resulting images in the user designated output files. Clipping is controlled by the values of negsig and possig in the preferences file. Superseded by Combine Images.
Sigma Clipped Mean
Computes the sigma clipped mean and standard deviation images of all 'ON' images and saves the resulting images in the user designated output files. Clipping is controlled by values of negsig and possig in the preferences file. Superseded by Combine Images.

Position
Allows the user control over the current 'reference' image. The image may be moved, padded, scaled, bias applied, rotated, clipped, zoomed, and have its plate scale adjusted. This widget is automatically updated if a different image is selected.
Display
Allows the user to control the image display. Lower and Upper gray-scale limits may be specified (Z1 and Z2), the screen offsets, x and y, can be viewed and set, linear, log, or square root scaling can be selected, autoscaling can be switched on or off, a display bias may be entered (sometimes necessary to avoid clipping data with the log and square root scaling.), the color table manipulator can be called, and the images can be redisplayed. (redisplay first clears the screen, this is often useful.)

See also Adjust Display Page.
Resize Display
Allows the user to set the size of the main display in pixels and to toggle between a scrolled and non-scrolled display. The user should be aware that setting the main display to a very large size (e.g. 2000 by 2000 pixels) will cause a significant slow-down in the system performance. It is recommended that if you are viewing a an area greater than 800 by 800 pixels, that you should have the display scrolled with the scroll region smaller than 800 by 800.

Zooming, Scaling, and Bias Removal
Each image that is loaded into IDP3 can be zoomed, scaled, and have bias subtracted/added individually. The user may type a new zoom value into the zoom field and hit the carriage return. The image will be zoomed to the new value and the display will be updated. The image Scale is a real number by which the image will be multiplied before it is included in the display. Likewise, the image Bias is a real number which will be added or subtracted (according to sign) from the image before it is included in the display. Below the image bias field are plus and minus buttons as well as an increment field. This allows the user to adjust the scale in increments up or down just by hitting the buttons. When the widget starts up, the current values for zoom and scale are displayed in the widget. The default for both is 1.0.
Image Movement
Images may be moved by real number amounts in X and in Y. The algorithm for fraction pixel shifts is a bi-cubic interpolation. The reference image may be moved either by typing directly into the x-offset or y-offset fields or by using the arrow buttons. The amount the image is shifted by the arrow buttons is shown in the 'move amount' field. This field is editable by the user as well. Currently, there is no way to drag an image across the screen using the mouse.
Rotation
The user may type a real number into the rotation field (default is 0.0). A positive number rotates the image clock-wise and a negative number rotates the image counter-clock-wise. Units are degrees. Below the image rotation field are plus and minus buttons as well as an increment field. This allows the user to adjust the rotation in increments up or down just by hitting the buttons. The Default point about which the image is rotated is in the center of the image. The user may choose an alternate axis of rotation by placing the cursor at that point on the main display window and pressing the middle mouse button. Changing the axis of rotation in this way only effects the 'reference' image. Each image's axis of rotation must be set individually. Also, in the rotation section of the adjust position widget is a 'rotation center' button. Pressing this button will pop up a small widget with 'x rotation center' and 'y rotation center' fields. This allows the user to enter the exact center of rotation relative to the image's lower left corner. (the center of rotation may have fractional pixel positions, i.e. [57.3,112.84]) When rotating an image pixels may be rotated out of the field. In order to preserve all of the data the user may pad the image before rotation. Padded pixels are set to 0. Setting Border Pad to 'yes' causes the image to be padded on all sides by 40%. The user may adjust the amount of padding by entering the value in the appropriate box.
Pixel Scale Adjustment
The user may adjust the data from one camera/detector to the pixel scale of another. If the instrument is either NICMOS or WFPC2 with a complete FITS header the program can determine the input and output pixel scales. The ratio of these scales is computed and the data zoomed or dezoomed accordingly. If the same instrument/camera is selected for both input and output, the x and y pixel scales are ratioed and the data is zoomed/dezoomed accordingly.
View Head
Pops up a widget allowing the user to scroll through the 'reference' image header. You can also search for a particular keyword when specified in the keyword field.

Set Up
Allows the user to set the blink parameters, Blink Frame Delay, Blink Series Delay, and Blink Count in a widget form. The Blink Frame Delay can have any positive value including 0.0. However, the Blink Series Delay must be greater than 0.0 if the user wishes the ability to terminate the blink before the blink count is reached.
Blink
Causes all the ON images that are either Added or Subtracted to blink.
Stop Blink
Causes the blinking to stop at the end of the current series if the series delay is greater than 0.0.

Edit REF Image
All images are edited in their original data form as they were loaded. Only the current Reference image may be edited, additional images may be edited by selecting them as the reference image. An edit widget pops up where the dynamic range may be set and zoom factor selected (1, 2, 4, 8) by the user. Zooming is accomplished with pixel replication. A small region of the image may be viewed in a spreadsheet by dragging sheet may be selected with a single click and edited with a double click. As a cell is selected the pixel is marked in the edit display. When the Update button is selected, the current spreadsheet is read and searched for updated values. These values (x, y, and z) are appended to the the previous edits for the current image if they exist. No data is permanently altered (until the image is saved). Instead, the original data are modified according to the edits before the data are displayed. The user must select the Show Edits button to show the results of the edit in the edit display window.
Undo Last Edit
When you've messed up a little.
Undo All Edits
When you've messed up a lot.

IDP3 Main Window Display

File Menu Images Menu Adjust Menu Blink Menu Edit Menu SPITZER Menu

File Menu
Images Menu
Adjust Menu
Blink Menu
Edit Menu
SPITZER Menu