You are here: IRS>SmartDoc Web>SmtvFileViewer (04 Nov 2008, DonBarry)

SMART SMTV File Viewer

SPECIAL NOTE : ATV was written originally by Aaron Barth, now at Caltech, (with contributions from others).
The work of the original developers is here fully acknowledged.

A version of ATV was then incorporated into SMART by the SMART development team. Within SMART this was originally called ATV.
At the request of Aaron Barth and to prevent possible version conflicts with subsequent releases of ATV the SMART specific version has been re-named SMTV.

SMART specific modifications have also been added by the SMART Team at Cornell.
A full description and instructions for the current publically available (non-SMART specific) version can be found at : ATV.PRO

The Description on this page refers entirely to the SMART specific version.

|Note : |The SMART modified version of SMTV requires an additional routine : cmps_form.pro
If this has not already been installed please dowload it and place it in your default IDL directory. |

|Note : |The SMART modified version of SMTV can show either single plane data or three plane (3plane) data.
When showing 3plane data the box above the data display area is visible as seen in the above screen grab. This shows :

Image #=
A horizontal slider allowing scrolling through data planes.
A drop down menu defaulted to "Constant".

This box only appears when three plane data is loaded.
Its appearance is controled by the settings of the "Data", "Noise", "Bmask" and "All" radio buttons on the Dataset Manager.
Only when the the "All" option is set will all three planes of a three plane data set be loaded into SMTV.
Any other selected option will just display that particular plane and no others. |

Invoking SMTV within SMART

There are three ways to invoke SMTV while SMART is running :

1. Type "SMTV" at the "IDL>" command prompt.
2. Use the "Start SMTV" option on the Project Manager "Tools" menu.
3. Use the "SMTV" option on the Project Manager "Dataset" window "View" menu.

SMART Specific Modifications to SMTV

The following modifications have been made to the version of SMTV supplied with SMART.
They are to enable SMART and SMTV to interface together more effectively and are not present in other versions of SMTV.

Toolbar - The toolbar has one completly new option and multiple changes to its existing options :

File

!WriteFits - This option is capable of writing the currently displayed image to an image FITS file.
!WritePS - This option allows the currently displayed image to be written to a PostScript file.
!WriteImage - This option allows the currently displayed image to be written in JPEG, TIFF, BMP, PICT, or PNG format.
Quit - This option ends the session.

!ColorMap - This menu provides a wide variety of color schemes for use.

Scaling

Linear - Scales the image brightness and contrast linearly from the minimum value to the maximum value of the array.
Log - Scales the image brightness and contrast logarithmically from the minimum value to the maximum value of the array.
!HistEq - Does not scale the image brightness or contrast.

Labels

!TextLabel - Displays a specified text label, placed anywhere on the image.
Arrow - Displays an arrow of any length, place, and direction.
Contour - Displays contour lines as on a topographical map.
Compass - Displays a compass drawn with North and East arrows anywhere on the image.
!ScaleBar - Displays a scale bar.
Region - Displays a circle, box, ellipse, or line around a specified target area.
!DrawExtraction - Displays extracted data overplotted the original image.
!DrawWavsamp - Displays the current Wavesamp.
!EraseLast - Erases the last label placed on the image.
!EraseAll - Erases all labels placed on the image.

Blink - This menu allows the current image to be set to blink against another image. The MouseMode must be set to Blink in order for this menu to work.

Zoom

Zoom options: These options allow the image to be zoomed in on from 1/16 original size to 16 times original size.
Center: Centers the image.
Inversion options: These four options allow the image to be inverted not at all, around just the x or y axes, or around both.
Rotate options: These options allow the image to be rotated by any amount counterclockwise.

!ImageInfo

Photometry - Performs aperture photometry on the current cursor position.
NB In order to use the photometry feature properly, the scroll-down menu should not be used.
Select MouseMode ImExam, and click on the center pixel of the source in order to bring up the photometry window.
Statistics - Displays basic statistics on a box of specified size and center.
!ImageHeader - Displays a separate, independent window with the current image's header.
Pixel Table - Displays a 5-by-5 grid of the pixel values of the pixels surrounding the cursor's current position.
Load Region - Loads a previously saved region from memory.
Save Region - Saves all of the displayed regions currently on the image in memory (see Labels-->Region).
Mosaic - Displays multiple ../images/planes at once in a mosaic.
RA,Dec options: These six options allow the type of coordinates wanted to be displayed in the WCS Data box.

MouseMode - Gives the mouse control of one of the following options :

Color - change contrast and brightness by clicking and dragging.
Zoom - zoom in by clicking.
Blink - when images are set to blinks 1, 2 and/or 3, mouse buttons 1, 2, and/or 3 may be used to blink them.
!ImExam - brings up aperture photometry window centered around the nearest and brightest centroid to the current cursor position when the mouse is clicked.
!ImExam3D - draw a box around a desired region to display image statistics of all of the images in the data cube for that region.
Vector - displays a one-dimensional intensity plot of the column the cursor is clicked on.
Region - click on a position on the image where a region is wanted.

SmartDoc

Printable
PDF