---

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

---

• Changes in version 4.00
• New commands
• New options
• Altered commands and options
• Previous releases

---

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

• Release Notes 3.01
• Release Notes 3.00

---

---

Please send reports of errors to : xanprob@athena.gsfc.nasa.gov

---

HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public