Ximage
Release Notes Version 4.00
Part of HEAsoft 5.1 - July 26, 2001

* Changes in version 4.00
  • Tcl interface
  • New /xtk device provides GUI facilities
  • Multiple image maps (up to nine) may be loaded in memory at once
  • Real maps are fully supported, allowing negative and null values as well
  • Overlayed contours are automatically transformed to underlying coordinates

* New commands
  • map - Image map information and manipulation
  • marith - Perform arithmetic on image maps
  • syscall - Spawn system command (Replaces $ spawning)
  • coord - Perform (scriptable) coordinate conversion
  • screengrab - Captures current appearance of /xtk plot
  • bglevels - Calculate background levels (mainly for internal use by contour/statistic)
  • gencolor - Extracts red, green, and blue ranges from event file, then spawns external tool, mkcolor, to generate color image, and displays
  • draw - Draw shapes (mainly for internal use)
  • pimage - Plot image (mainly for internal use by display)
  • pcontour - Plot contours (mainly for internal use by contour)

*
New options
  • colors
    • null - Specify color index with which to draw null pixels
  • contour
    • mapid - Plot contours for specified map
    • nocoortrf - Disable automatic coordinate transformation on overlay
    • statistic - Contour based on background statistics
    • sigma_levels - Contour based on sigma levels based on background statistics
    • mult_levels - Contour based on multiples of background
    • background - Specify value for background
  • cpd
    • leaveopen - Leave /xtk device open when changing device (mainly for internal use)
  • display
    • mapid - Plot image for specified map
  • hotspot
    • angle - Specify angle of text
    • just - Specify justification of text
  • iminfo
    • widscale - Specify width of image scale bar
  • label
    • clip - Turn on clipping, so labels outside viewport aren't plotted
    • text - Specify label text with qualifier
  • levels
    • histo - Calculate levels based on histogram equalization
    • linear - Calculate levels based on linear scaling
    • log - Calculate levels based on logarithmic scaling
    • sqrt - Calculate levels based on square-root scaling
    • minlevel - Set minimum level in calculation
    • maxlevel - Set maximum level in calculation
    • list - Enter levels as Tcl list, e.g. {1 2 3 4} or "1 2 3 4"
  • read_image
    • mapid - Read image into specified map
    • tcol - Set time column
  • smooth
    • real - Retain real values after smoothing instead of truncating to integers
  • sosta
    • bgregion - Specify background with region
    • srcregion - Specify source with region
  • surface
    • xmin,xmax,ymin,ymax,refresh - Added to allow zooming in on /xtk device (mainly for internal use)
  • viewport
    • switch - In combination with number, selects the viewport to which all coordinate retrieval refers
    • info - Print information on the contents of displayed viewports
  • vplabel
    • text - Specify label text with qualifier
  • write_image
    • mapid - Write specified map to a file
    • nonull - Zero out null values in output image

*
Altered commands and options
  • alias
    • (all options removed) - Only supported syntax: alias <newcmd> <oldcmd>
  • centroid
    • plot - Removed as new default is to plot centroid location
  • contour
    • coordsaved - Removed as coordinate transformation is now automatic on overlay.
      Old procedure: read;disp;save;read;cont/over/coordsaved
      New equivalent: read;disp;save;read;cont/over
  • extract
    • regionfile=@filename - When preceded by @, filename is assumed to be list of regionfiles to perform color extraction on
  • info->iminfo
    • (name change) - Tcl's info command conflicts, so ximage info command is now iminfo
  • keywords (aka ?)
    • (modified behavior) - Now takes user to keywords prompt, like help
  • levels
    • ldshow - Removed as show and ldshow now correspond to same levels
  • pixel_to_radec
    • plot - Removed as new default is to plot specified location
  • sosta
    • cursor - Removed - Now default
    • loop - Removed
    • no_of_boxes - Removed
    • size_of_boxes - Removed

*
Previous releases
Ximage Home Page Xanadu Home Page Xanadu ftp site

Please send reports of errors to : xanprob@athena.gsfc.nasa.gov
HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public

Last modified: Wednesday, 12-Jul-2006 09:12:24 EDT