DS9 Version 5 Release Notes

Version 1.6.1

fix some minor problems with odd chars in -filenames
fix some minor problems with odd chars in filenames
fix problems with fits image extensions
removed minimal geometry restrictions
fits file support is more robust

DS9 Version 1.7 Release Notes

SAOImageDS9 Version 1.7 Release Notes

Version 1.7.2

$ xpaset -p DS9 colormap BB # change colormap

$ xpaset -p DS9 file snr.fits # load a fits file

$ cat snr.fits | xpaset DS9 fits # load via XPA

$ cat snr.fits | xpaset DS9 fits foo[key=RAWX,RAWY] # load via -XPA

$ cat snr.fits | xpaset DS9 fits foo[key=RAWX,RAWY] # load via XPA

Note: xpa class and name for ds9

-- xpa class : 'DS9'

-- xpa name : 'DS9'

both class and name are case sensitive

To specify a different xpa name for this application use -the

To specify a different xpa name for this application use the

-title command line option:

$ -ds9& -# default name of 'DS9'

$ ds9& # default name of 'DS9'

$ ds9 -title foo& # name of 'foo'

$ xpaset -p foo colormap BB # change colormap for -'foo'

$ xpaset -p :foo colormap A # change colormap for -'foo'

$ xpaset -p DS9:foo colormap BB # change colormap for -'foo'

$ xpaset -p DS9: colormap I8 # change colormap for 'DS9 & -foo'

$ xpaset -p foo colormap BB # change colormap for 'foo'

$ xpaset -p :foo colormap A # change colormap for 'foo'

$ xpaset -p DS9:foo colormap BB # change colormap for 'foo'

$ xpaset -p DS9: colormap I8 # change colormap for 'DS9 & foo'

fixed bug with zscale and minmax preferences
geometry command line option: $ ds9 -geometry -600x500
geometry command line option: $ ds9 -geometry 600x500
Note: this does not include space needed for menus.
default wcs is 'fk5'
url's are now supported
example:
-$ ds9 -ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/fits/rh100193_img.fits
- -$ ds9 -http://legacy.gsfc.nasa.gov/FTP/rosat/data/cdrom/vol1/IMAGES/00h/p000s26b.img.Z

$ ds9 ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/fits/rh100193_img.fits

$ ds9 http://legacy.gsfc.nasa.gov/FTP/rosat/data/cdrom/vol1/IMAGES/00h/p000s26b.img.Z

fixed some minor problems with Mosaic Images
Support for FITS bin tables
example:
-$ ds9 snr.fits[2] # assume 'X' or 'x' and 'Y' or 'y' -column
+$ ds9 snr.fits[2] # assume 'X' or 'x' and 'Y' or 'y' column
$ ds9 snr.fits[EVENTS]
$ ds9 snr.fits # assumes EVENTS or STDEVT extension
-$ ds9 snr.fits[key=RAWX,RAWY] # bin on RAWX/RAWY -column
Backward compatible with Einstein .xpa data for -bining

$ ds9 snr.fits[key=RAWX,RAWY] # bin on RAWX/RAWY column

Backward compatible with Einstein .xpa data for bining
Contours are now supported
-You can generate contours for each frame and cut/paste them -into other frames. When you paste a contour, you choose which -coordinate system to translate the contour into. Obvisously, to -paste via WCS, each image must have a valid WCS. Printing of -image/contours also is supported.
-The contour algorithm currently implemented is a general -purpose algorithm, good for most images. However, there are some -issues that make it less than optimal for sparse high energy data. -Therefor, next on the list is implemention of the 'Pros Imcontour' -algorithm.

You can generate contours for each frame and cut/paste them into other frames. When you paste a contour, you choose which coordinate system to translate the contour into. Obvisously, to paste via WCS, each image must have a valid WCS. Printing of image/contours also is supported.

The contour algorithm currently implemented is a general purpose algorithm, good for most images. However, there are some issues that make it less than optimal for sparse high energy data. Therefor, next on the list is implemention of the 'Pros Imcontour' algorithm.

Now supports ICRS WCS
Now Uses Tcl/Tk 8.0.4 and BLT 2.4g
Now uses Doug Minks's wcssubs 2.6.

DS9 Version 1.8 Release Notes

SAOImageDS9 Version 1.8 Release Notes

Version 1.8.7.8

Dialog windows now use the same colormap as the parent -window.
Dialog windows now use the same colormap as the parent window.
Fixed a problem with the tile xpa point.

Version 1.8.7.7

Fixed a problem with updating the Contour dialog -box.
Fixed a problem with updating the Contour dialog box.
Fixed another problem with .gz, .Z, and .z
Coordinate Grids now support WCS of projection -TNX.
Improved the appearance of Grids while in Internal -Mode.
Coordinate Grids now support WCS of projection TNX.
Improved the appearance of Grids while in Internal Mode.

Version 1.8.7.6

Fixed a problem with running under linux and displaying on -Solaris.
Fixed a problem with running under linux and displaying on Solaris.
Fixed a problem with Truecolor 8 support.
Added Coordinate Grids!
Mouse coordinates may be printed by pressing the 'C' key. -Which coordinates are printed may be specified via the -'Edit:Preferences:Print Coordinates' menu.
Default Region Parameters now can be specified via the -Preferences menu.
Contour Dialog has been redesigned and Contour scales and -limits added.
Fixed a problem with Contour scales log, squared, and -sqrt.
The user can save and load contours via the Contour -Parameter Dialog Box. The contours may be any supported coordinate -system.
The user can save and load contour levels via the Contour -Parameter Dialog Box.
Fixed a problem with file names that contain .z, .Z, -.gz
Mouse coordinates may be printed by pressing the 'C' key. Which coordinates are printed may be specified via the 'Edit:Preferences:Print Coordinates' menu.
Default Region Parameters now can be specified via the Preferences menu.
Contour Dialog has been redesigned and Contour scales and limits added.
Fixed a problem with Contour scales log, squared, and sqrt.
The user can save and load contours via the Contour Parameter Dialog Box. The contours may be any supported coordinate system.
The user can save and load contour levels via the Contour Parameter Dialog Box.
Fixed a problem with file names that contain .z, .Z, .gz

Version 1.8.7.5

Fixed a problem with Truecolor 24 bit visuals under Solaris -7
Fixed a problem with selecting Ruler Regions that are -horizontal or vertical.
Fixed a problem with Truecolor 24 bit visuals under Solaris 7
Fixed a problem with selecting Ruler Regions that are horizontal or vertical.

Version 1.8.7.4

Fixed a major bug with mosaics with an amplifier that reads -out in reverse and the data has been flipped before -writing.
Fixed a major bug with mosaics with an amplifier that reads out in reverse and the data has been flipped before writing.

Version 1.8.7.3

New wcssubs: Fixed a problem with wcs of RA--NCP and -DEC--NCP
New wcssubs: Fixed a problem with wcs of RA--NCP and DEC--NCP
Fixed a problem with 'Scale:User Limits'
Removed a warning message if xpa is not available
The coordinate info box is updated while editing -regions
Fixed a problem with the window manager closing region -dialog boxes, regions list dialog box, and analysis result dialog -box
List Regions, Display Header, and the Analysis Dialog box -now have options for printing, saving, and searching the -contents.
Display Header now supports multiple dialogs, one for each -frame.
Fixed a problem with parsing region files and the LINE -region.
Fixed a problem with polygon regions and PROS region file -formats.
All regions are deleted when 'Clear Frame' or 'Open' action -taken.
When creating Text regions, the 'Cancel' button now -works.
'Clear Frame' has been moved from 'File menu to 'Frame' -menu.
shell variable DS9_ARRAY may be used to define default -array parameters. Example: $export -DS9_ARRAY='[dim=512,bitpix=-32]'
shell variable DS9_BINKEY may be used to define default -FITS bin table cols. Example: $export -DS9_BINKEY='[bin=rawx,rawy]'
new 'Open Array...' menu item has been added to the 'File' -menu.
The coordinate info box is updated while editing regions
Fixed a problem with the window manager closing region dialog boxes, regions list dialog box, and analysis result dialog box
List Regions, Display Header, and the Analysis Dialog box now have options for printing, saving, and searching the contents.
Display Header now supports multiple dialogs, one for each frame.
Fixed a problem with parsing region files and the LINE region.
Fixed a problem with polygon regions and PROS region file formats.
All regions are deleted when 'Clear Frame' or 'Open' action taken.
When creating Text regions, the 'Cancel' button now works.
'Clear Frame' has been moved from 'File menu to 'Frame' menu.
shell variable DS9_ARRAY may be used to define default array parameters. Example: $export DS9_ARRAY='[dim=512,bitpix=-32]'
shell variable DS9_BINKEY may be used to define default FITS bin table cols. Example: $export DS9_BINKEY='[bin=rawx,rawy]'
new 'Open Array...' menu item has been added to the 'File' menu.
Changes to following ommand line options:
--array, -mosaicimage, -mosaicimages, -mosaicsegment, --shared

-array, -mosaicimage, -mosaicimages, -mosaicsegment, -shared

Version 1.8.7.2

Add the -iconify command line option.
FITS Region Binary Table Region file format is supported -for input.
FITS Region Binary Table Region file format is supported for input.

Version 1.8.7.1

Now using BLT 2.4l
Now using X11R6
Fixed a problem with selecting blink frames multiple -times.
Fixed a problem with Line Regions always printing with -arrows.
Fixed a problem with selecting blink frames multiple times.
Fixed a problem with Line Regions always printing with arrows.
Fixed a problem when a printing error occurs.
External File support is now available.
External Analysis support is now available.
Added Frame refresh menu item.
Fixed a problem with shared memory size.
XPA frame has changed. The argument is now only a number, -not a name. This clears up some problems with syntax. If the frame -does not exists, the frame is created. The option 'frameno' is -provided for backward compatiblity.
XPA frame has changed. The argument is now only a number, not a name. This clears up some problems with syntax. If the frame does not exists, the frame is created. The option 'frameno' is provided for backward compatiblity.
-Example: xpaset -p ds9 frame 2 # goto frame name -'frame2'
- xpaset -p ds9 -frame frameno 4 # goto frame name 'frame4'

Example: xpaset -p ds9 frame 2 # goto frame name 'frame2'

xpaset -p ds9 frame frameno 4 # goto frame name 'frame4'

Version 1.8.7

Scale type 'Ln' has been removed.
Contour scales Log, Sqrt, and Squared have been -fixed.
Contour scales Log, Sqrt, and Squared have been fixed.
Contour Dialog box is now non-modal.
Fixed a problem with the FITS Header Dialog box.
Support for > 256 colors in truecolor mode.
New PS level 2 drivers that support more than 256 -colors.
Crosshairs will now appear in the magnifier if graphics -enabled.
Improved on the gui in terms of tile and blink. Now ds9 is -in one of 3 display modes: single frame, tile frames, and blink -frames.
You can now Show or Hide frames, via the Frame:Show/Hide -menu. When a frame is 'Hidden', it does not appear in Single, Tile, -or Blink mode, and can not be selected via the Frames -menu.
Added a new mode: Examine. While in examine mode, if you -click, a new frame is created, loaded with the same data, and -scaled about the point you clicked. If the base frame is a FITS -image, it is zoomed, if the base frame is a FITS binary table, it -is blocked. The file is not loaded again, but shared between -frames, requiring little additional memory. When you clear or -delete a base frame, all examine frames are deleted. Options as to -how many frames are created and the scale factor may be specified -via the preferences menu.
New PS level 2 drivers that support more than 256 colors.
Crosshairs will now appear in the magnifier if graphics enabled.
Improved on the gui in terms of tile and blink. Now ds9 is in one of 3 display modes: single frame, tile frames, and blink frames.
You can now Show or Hide frames, via the Frame:Show/Hide menu. When a frame is 'Hidden', it does not appear in Single, Tile, or Blink mode, and can not be selected via the Frames menu.
Added a new mode: Examine. While in examine mode, if you click, a new frame is created, loaded with the same data, and scaled about the point you clicked. If the base frame is a FITS image, it is zoomed, if the base frame is a FITS binary table, it is blocked. The file is not loaded again, but shared between frames, requiring little additional memory. When you clear or delete a base frame, all examine frames are deleted. Options as to how many frames are created and the scale factor may be specified via the preferences menu.

Version 1.8.6.9

Support for FITS Bin Table Type 'U' (unsigned short) and -Type 'V' (unsigned long). Note these are not supported by the FITS -standard.
Support for FITS Bin Table Type 'U' (unsigned short) and Type 'V' (unsigned long). Note these are not supported by the FITS standard.
Added new default colormap 'Cool'
SAOtng and PROS Regions file support: if wcs coords are -used, yet no wcs system has been specified, the native wcs of the -file is used.
Regions now are available in the magnifier (user -prerference)
Fixed a problem with working with line regions at high zoom -factors
Fixed a problem with working with polygon regions at high -zoom factors
SAOtng and PROS Regions file support: if wcs coords are used, yet no wcs system has been specified, the native wcs of the file is used.
Regions now are available in the magnifier (user prerference)
Fixed a problem with working with line regions at high zoom factors
Fixed a problem with working with polygon regions at high zoom factors

Version 1.8.6.8

Fixed again problems with FITS Tables, Binning, Physical -Coords, and WCS
Fixed again problems with FITS Tables, Binning, Physical Coords, and WCS

Version 1.8.6.7

Added new 'Block to Fit Window' function
Added 'Block to...' function
'Mode' menu has been moved to under 'Edit' menu.
Show/Hide Panner and Magnifier via the prefs, command line, -and xpa
Show/Hide Panner and Magnifier via the prefs, command line, and xpa
Tear-Off menus now have window titles
minor changes to xpa options syntax (no more -options), see -XPA for more info.
minor changes to xpa options syntax (no more -options), see XPA for more info.
xpa colormap is no longer case sensitive
fixed a problem with tables and physical -coordinates
fixed a problem with interactive pan/zoom/rotate and -coordinates
fixed a problem with tables and physical coordinates
fixed a problem with interactive pan/zoom/rotate and coordinates

Version 1.8.6.5

Fixed a problem with reading IRAF Pros regions -files
Fixed a problem with reading IRAF Pros regions files

Version 1.8.6.4

Fixed a problem with Little Endian Machines and doubles in -FITS bin tables
Fixed a problem with Little Endian Machines and doubles in FITS bin tables

Version 1.8.6.3

Now supports SAOtng regions files in physical -coordinates.
Now supports SAOtng regions files in physical coordinates.

Version 1.8.6.2

@@ -228,33 +148,25 @@ coordinates.

Version 1.8.6.1

Fixed a rather nasty bug with rendering Circle Regions. -This bug would sometimes cause the X Server to hang.
Now does a better job of creating the default size -regions.
Frame buttons Prev and Next now will cycle thru all -frames.
Fixed a rather nasty bug with rendering Circle Regions. This bug would sometimes cause the X Server to hang.
Now does a better job of creating the default size regions.
Frame buttons Prev and Next now will cycle thru all frames.

Version 1.8.6

Automatic Tile Mode with multiple files on command -line
Automatic Tile Mode with multiple files on command line
Fixed problems with HTTP and FTP access
Fixed another problem with FITS Bin tables and -regions
There are now 2 modes for interactive panning-- default -click to center
Fixed another problem with FITS Bin tables and regions
There are now 2 modes for interactive panning-- default click to center
- Click to Center (SAOimage method)
- Drag to Center (Native DS9 method)
New frames use the current user scale limits and -colorscale.
New frames use the current user scale limits and colorscale.
Added frameno option to FRAME xpa point
REGION SAVE FORMAT menu now reflects coords -available
REGION SAVE FORMAT menu now reflects coords available

Version 1.8.5

Regions Modes now intergrated into Pointer Mode
New colormaps have been added
Fixed a problem with FITS ext names
Editing RECTANGLE regions resizes about the opposite node, -not the center
Editing RECTANGLE regions resizes about the opposite node, not the center
Polished the GUI for creating regions
list/save regions in saoimage format now outputs -points
Fixed a problem with existing regions and -blocking
list/save regions in saoimage format now outputs points
Fixed a problem with existing regions and blocking

Version 1.8.4.1

Online Documentation!
Fixed a problem with Physical Coordinates and FITS Bin -Tables
Fixed a problem with Physical Coordinates and FITS Bin Tables
Sticky file names have been implemented
Fixed a problem with standard dialogs and double/triple -clicks
If Header window is open, load will display the new -header
Fixed a problem with standard dialogs and double/triple clicks
If Header window is open, load will display the new header
Delete Frame now asks for confirmation
Fixed a problem with arrays and xpa
Fixed a problem with FITS keyword inheritance
for FITS bin tables, the keywords BIN, BINKEY, and KEY are -equivalent
for FITS bin tables, the keywords BIN, BINKEY, and KEY are equivalent
Fixed a problem with regions and tiled frames
Keystroke shortcuts have been added to the GUI
Added WCS menu items to preferences saved
Added 'Clear Preferences' to preferences menu
Mouse button 2 is now bound to 'Pan' function
Minor changes to layout of Small and Large Infomation -Panel
Fixed problem with pseudocolor 8 and private -colormaps
Minor changes to layout of Small and Large Infomation Panel
Fixed problem with pseudocolor 8 and private colormaps

Version 1.8.3

Fixed a problem with arrays and xpa
xpaget regions: you now can specify -coord/coordformat/format
$ xpaget ds9 regions -format pros -coord fk4 -coordformat -hms
xpaget regions: you now can specify coord/coordformat/format
$ xpaget ds9 regions -format pros -coord fk4 -coordformat hms
Interactive rotation is now works!
PanZoom Dialog and Rotate Dialog now have 'Apply' -buttons
Preferences have been implemented. 'Save Preferences' will -save the current values of the 'Preferences' and 'View' menus in -$HOME/.ds9.prefs. On startup, this values will be used.
Source user tcl file has been implemented. If $HOME/.ds9 -exists, it will be sourced on start up.
New Standard Dialog box has been implemented. User now has -a choice of motif, windows, or 'blue plate special' dialog -boxes.
PanZoom Dialog and Rotate Dialog now have 'Apply' buttons
Preferences have been implemented. 'Save Preferences' will save the current values of the 'Preferences' and 'View' menus in $HOME/.ds9.prefs. On startup, this values will be used.
Source user tcl file has been implemented. If $HOME/.ds9 exists, it will be sourced on start up.
New Standard Dialog box has been implemented. User now has a choice of motif, windows, or 'blue plate special' dialog boxes.
'$ xpaget ds9 file' now returns full file name
More tolerant of non-existent or bad files.
More robust checking of mosaic files
FITS keyword inheritance is now supported.
Mosaic Multiple Extension Fits files are now -supported.
Coordinate name 'CCD' has been changed to -'Physical'
Mosaic Multiple Extension Fits files are now supported.
Coordinate name 'CCD' has been changed to 'Physical'

Version 1.8.2

$ ds9 "foo.arr[dim=1024,bitpix=8,arch=littleendian]"

xpa support for raw data arrays
-$ cat foo.arr | xpaset ds9 array -"[dim=512,bitpix=16]"

$ cat foo.arr | xpaset ds9 array "[dim=512,bitpix=16]"

Version 1.8.1.2

@@ -371,18 +263,14 @@ supported.

Version 1.8.1

fix blockfactor,blockbuffersize, and blockfunction command -line options.
fix blockfactor,blockbuffersize, and blockfunction command line options.
fixed problem with Marker type Line Dialog box.
Added new marker type: Ruler.
fixed major problem with regions files and loading via -xpa.
fixed major problem with regions files and loading via xpa.
Added arrows to line marker.
more robust error handling.
bin table extension names and column names are no longer -case sensitive.
fixed problem with printing to different page -sizes
bin table extension names and column names are no longer case sensitive.
fixed problem with printing to different page sizes

Version 1.8

the xpa class name is now "DS9"
example:
-$ xpaget ds9 version # get version number from just -ds9
-$ xpaget DS9:ds9 version # get version number from just -ds9
$ xpaget DS9: version # get version number for all DS9 -apps

$ xpaget ds9 version # get version number from just ds9

$ xpaget DS9:ds9 version # get version number from just ds9

$ xpaget DS9: version # get version number for all DS9 apps
Markers!

DS9 Version 1.9 Release Notes

SAOImageDS9 Version 1.9 Release Notes

Version 1.9.8

fixed a problem with listing regions that are very long. -the size limit has been increased from 1024 to 8192
fixed a problem with listing regions that are very long. the size limit has been increased from 1024 to 8192
completed MS Windows port
fixed a problem with large polygons in FITS Regions bin -table format
ds9 will now correctly load a FITS Extension image without -a primary header
fixed a problem with large polygons in FITS Regions bin table format
ds9 will now correctly load a FITS Extension image without a primary header
xpa wcs [reset|replace|append] function added
the default nameserver is now 'simbad-sao'

Version 1.9.7.2

fixed a problem with reading arrays via xpa and extra data -an the end of the image
fixed a problem with region callbacks and actions on -regions within the callback
fixed a memory leak with deleteing polygon -vertices
double click on region with select=0 no longers opens a -dialog
added select property to ds9 region properties -list
for default annulus, ellipse annulus, box annulus, the -number of annuli is now used when the user click and -drags
fixed a problem with ellipse annulus and box annulus and -zero inner radius
fixed a problem with box and boxannuls and updating the -region dialog coords
fixed a problem with reading arrays via xpa and extra data an the end of the image
fixed a problem with region callbacks and actions on regions within the callback
fixed a memory leak with deleteing polygon vertices
double click on region with select=0 no longers opens a dialog
added select property to ds9 region properties list
for default annulus, ellipse annulus, box annulus, the number of annuli is now used when the user click and drags
fixed a problem with ellipse annulus and box annulus and zero inner radius
fixed a problem with box and boxannuls and updating the region dialog coords
fixed a problem with turning off/on active frames
fixed a problem with saving fits images created from a fits -image extension
added new 'new' option to xpa points 'FITS' and 'ARRAY' to -create a new frame before loading the new image
fixed a problem with saving fits images created from a fits image extension
added new 'new' option to xpa points 'FITS' and 'ARRAY' to create a new frame before loading the new image
completed port HP-UX

Version 1.9.7.1

fixed a problem with prefs and sourcing external tcl -files
fixed a problem with prefs and sourcing external tcl files

Version 1.9.7

mktclapp is now used to build the application from -tcl
mktclapp is now used to build the application from tcl
fixed a problem with HMS and hour=0
fixed a problem with parseing old ds9 region files and -'global'
support for SAOtng Regions file format has been -restored
fixed a problem with parseing old ds9 region files and 'global'
support for SAOtng Regions file format has been restored
upgraded to tcl/tk 8.3.2
upgraded to blt2.4u
minor changes made to ciao regions file format

Version 1.9.6

Added Truecolor Colorbar preference
Fitsy++ now supports fixed and free format keyword strings -correctly
While in 'Pan' mode, the arrow keys may be used to pan the -image
Fitsy++ now supports fixed and free format keyword strings correctly
While in 'Pan' mode, the arrow keys may be used to pan the image
Custom Page Setup in mm is now supported
Region Text string can now contain both a ' and "
Region File format for text now supports the following text -strings:
Region File format for text now supports the following text strings:
text="This is a test"
text="This is a test of '"
text='This is a test of "'
text={This is a test of ' and "}
DS9 will now correctly parse a regions spec with a delim of -';'
XPA tcl command now runs in the same context frame as -source and ds9
Fixed a problem with the Colorbar contrat/bias dialog and -truecolor
DS9 will now correctly parse a regions spec with a delim of ';'
XPA tcl command now runs in the same context frame as source and ds9
Fixed a problem with the Colorbar contrat/bias dialog and truecolor
Fixed a problem with BOX list/save format
Fixed a problem with contours in that one extra level was -generated when using the low/high and number of contours -controls
Updated to Doug Mink's wcssub version 2.8.1, which fixes a -problem with keywords without an '='
Fixed a problem with printing Region Text with '(', ')', or -'\' in it.
Region file format is now valid for both reading and -writing Region files
Fixed a problem with contours in that one extra level was generated when using the low/high and number of contours controls
Updated to Doug Mink's wcssub version 2.8.1, which fixes a problem with keywords without an '='
Fixed a problem with printing Region Text with '(', ')', or '\' in it.
Region file format is now valid for both reading and writing Region files
Implemented new Regions file format, version 3
Fixed a problem with IRAF and the 'f' and 'c' -keys
Images with odd length will center on pixel -boundaries
The number of bins if determined from TLMIN/TLMAX will now -vary, based on column type (integer or real). The bin space for -integer is TLMIN-.5 to TLMAX +.5 and for real TLMIN to -TLMAX.
Fixed a problem with IRAF and the 'f' and 'c' keys
Images with odd length will center on pixel boundaries
The number of bins if determined from TLMIN/TLMAX will now vary, based on column type (integer or real). The bin space for integer is TLMIN-.5 to TLMAX +.5 and for real TLMIN to TLMAX.
Binning Dialog box is now non-modal
Made improvements in the resolution of -coordinates
Made improvements in the resolution of coordinates
Added the -version command line option
Fixed a problem with bad name resolution and -NED-SAO
Fixed a problem with -grid and -contour command line -options
Add -format, -coord, -coordformat, and -delim to xpaget -regions
Fixed a problem with bad name resolution and NED-SAO
Fixed a problem with -grid and -contour command line options
Add -format, -coord, -coordformat, and -delim to xpaget regions
Added FITS bin table filtering
Changed XPA BLOCK to BIN
bin factors of less than 1 but greater that 0 are now -allowed
fixed a problem with ecliptic coords and FITS BIN TABLES -with wcs
Fixed a problem with contours and high resolution -values
bin factors of less than 1 but greater that 0 are now allowed
fixed a problem with ecliptic coords and FITS BIN TABLES with wcs
Fixed a problem with contours and high resolution values
Added algorithm method to contours
Fixed a problem with contours and re-binning a FITS bin -table
Changes to BIN commandline options to mirror BIN xpa -options
Fixed a problem with contours and re-binning a FITS bin table
Changes to BIN commandline options to mirror BIN xpa options
Added raise/lower command line options
Added raise/lower xpa options
Cut/Paste to/from the primary selection is now -provided
Added new type of grid, Exterior Axis with interior -numerics
Fixed problems with grid numerics and rotation of -non-zero
Cut/Paste to/from the primary selection is now provided
Added new type of grid, Exterior Axis with interior numerics
Fixed problems with grid numerics and rotation of non-zero
Fixed a problem with graphs and no FITS loaded
Added Regions Delimiter menu
Added ANNULUS, ELLIPSE ANNULUS, and BOX ANNULUS -regions
Added ANNULUS, ELLIPSE ANNULUS, and BOX ANNULUS regions

Version 1.9.5

Fixed a problem with Saving FITS images on byte swaped -platforms
FITS Bin table support now uses TLMIN/TLMAX to determine -binning buffersize up to the user specified limit
Fixed the XPA Regions format,coord, and coordformat -calls
Changed the behavior of $xpaget ds9 regions -[format|coord|coordformat]
Fixed a problem with Saving FITS images on byte swaped platforms
FITS Bin table support now uses TLMIN/TLMAX to determine binning buffersize up to the user specified limit
Fixed the XPA Regions format,coord, and coordformat calls
Changed the behavior of $xpaget ds9 regions [format|coord|coordformat]

Version 1.9.4

Added ability to save a FITS bin table as a FITS -image
Added ability to save a FITS bin table as a FITS image
Added xpa point to support the above
Fixed a problem with loading arrays
Added support for the Rosat All Sky Survey
Added command line support for DSS and RASS
Fixed a problem with displaying LINEAR WCS
DS9 is now much more tolarent of FITS files in which the -data segment is short in size, ie, is not a multiple of FITBLOCK -(2880 bytes)
Fixed a problem with FITS files with headers with 100's or -1000's of comments or history keywords
DS9 is now much more tolarent of FITS files in which the data segment is short in size, ie, is not a multiple of FITBLOCK (2880 bytes)
Fixed a problem with FITS files with headers with 100's or 1000's of comments or history keywords
Enhanced Preferences support
The information panel is now updated during -blinking
The information panel is now updated during blinking
Fixed a problem with long frame names
Added new fuctionality to the 'Frame' xpa point
Fixed a memory problem that caused problems with the Alpha -port
Fixed a problem with regions in sexagesimal format and -NATIVE WCS
DS9 is now much mor tolerant of sexagesimal format regions -that do not map directly on top of a image
Fixed a memory problem that caused problems with the Alpha port
Fixed a problem with regions in sexagesimal format and NATIVE WCS
DS9 is now much mor tolerant of sexagesimal format regions that do not map directly on top of a image
Implemented the new default region format
Fixed a problem with Polygon regions and creating/moving -vertices
Fixed a problem with Polygon regions and creating/moving vertices
Added Colormap Contrast and Bias Dialog
Fixed a problem with Box regions and negative width and -height
Angle has been added to the Ruler Region dialog -box
Length has been added to the Line Region dialog -box
Fixed a problem with Region Text and the '"' -character
Fixed a problem with Box regions and negative width and height
Angle has been added to the Ruler Region dialog box
Length has been added to the Line Region dialog box
Fixed a problem with Region Text and the '"' character
Added XPA point for DSS
Added XPA point for RASS
Added XPA point for Name Servers
Fixed a problem with rotated Regions and IRAF -images
Fixed a problem with rotated Regions and IRAF images
Added XPA point xpaget fits
Added XPA point xpaset file save <filename>
xpa regions may now be delimited by nl or -semicolon
xpa regions may now be delimited by nl or semicolon

Version 1.9.3

Fixed a problem with preferences. The prefs file was not -parsed.
Fixed a problem with xpaset ds9 fits and multiple ext fits -files
Fixed some minor problems with xpa and -blink,frame
Fixed a problem with preferences. The prefs file was not parsed.
Fixed a problem with xpaset ds9 fits and multiple ext fits files
Fixed some minor problems with xpa and blink,frame
Added xpaset ds9 frame [first|next|prev|last]
Added printing of pixel tables
Added Copy/Paste support for pixel tables
Fixed a problem with changing the size of pixel -tables
Fixed a problem with changing the size of pixel tables
'F' toggles Info Pannel 'freeze' mode.
Full shared memory support has been added
@@ -229,57 +154,42 @@ tables

$xpaset -p ds9 shm mosaicimage key 100 10240 foo

$xpaset -p ds9 shm mosaic key 100 10240 foo[3]

$xpaset -p ds9 shm array shmid 102 8640 [dim=32,bitpix=16]

$xpaset -p ds9 update 1 100 100 200 200 # update HDU1 in -image coords
-$xpaset -p ds9 update 3 400 400 500 500 # update HDU3 in image -coords

$xpaset -p ds9 update 1 100 100 200 200 # update HDU1 in image coords
+$xpaset -p ds9 update 3 400 400 500 500 # update HDU3 in image coords

Version 1.9.2

Fixed yet another problem with contours
Fixed a problem with loading arrays with bitpix of --64
Fixed a problem with loading arrays with bitpix of -64

Version 1.9.1

Fixed the 'Analysis' menu item 'DSS'
provided for more backward compatibility with old -preference files
Fixed a problem with IRAF support and changing buffer -sizes
Fixed a problem with contours and reading incorrectly -levels
Fixed a problem with printing and -pan/rotation/zoom
Fixed a problem with Grid Rotated numbers and MSB/LSB -cross-platform
provided for more backward compatibility with old preference files
Fixed a problem with IRAF support and changing buffer sizes
Fixed a problem with contours and reading incorrectly levels
Fixed a problem with printing and pan/rotation/zoom
Fixed a problem with Grid Rotated numbers and MSB/LSB cross-platform

Version 1.9

DS9 now supports IRAF!

point regions now have the include/exclude -property
point regions now have the include/exclude property
crosshairs will now print
fixed a problem with contours and the contour dialog is -visible
fixed a problem with the wcs of FITS files with very long -headers
fixed a problem with contours and the contour dialog is visible
fixed a problem with the wcs of FITS files with very long headers
added Pixel Table feature
contours now appear in the magnifier with graphics -enabled
contours now appear in the magnifier with graphics enabled
John Roll's Tcl Ast package has been added
DS9 is now more tolerant of 'SIMPLE = F' type FITS -files
fixed a problem with render speed in single frame mode and -multiple frames loaded
DS9 is now more tolerant of 'SIMPLE = F' type FITS files
fixed a problem with render speed in single frame mode and multiple frames loaded
The Pan Zoom Rotate Dialog Box is now Non-Modal
Name Resolution support has been added
DSS support has been added
A problem with contours has been corrected. if contours -levels = n, then n+1 contours are actually rendered
A problem with contours has been corrected. if contours levels = n, then n+1 contours are actually rendered
DEC Alphas are now supported
SGI is now supported
LINEAR WCS is now fully supported

DS9 Version 2.0 Release Notes

SAOImageDS9 Version 2.0 Release Notes

Version 2.0

changed xpa tcl received to remove eval statement

fixed a problem clearing the magnifier in the windows -version
implemented a work around for a bug in dvips version 5.55 -and level 2 postscript driver
filename with a space in them will now load -correctly
fixed a problem with FITS Regions Files and optional -columns
fixed a problem clearing the magnifier in the windows version
implemented a work around for a bug in dvips version 5.55 and level 2 postscript driver
filename with a space in them will now load correctly
fixed a problem with FITS Regions Files and optional columns

DS9 Version 2.1 Release Notes

SAOImageDS9 Version 2.1 Release Notes

Version 2.1

04.05.2002 fixed a problem with xpa contour load.
04.22.2002 ds9 version 2.1 released to the -public.
04.22.2002 ds9 version 2.1 released to the public.

Version 2.1b7

04.02.2002 upgrade to XPA 2.1.0e2. This fixes a problem -with xpa and linux/linuxppc.
04.03.2002 fixed a problem with AST. plot.c, line 19463, -change parameter 'force' from 1 to 0 in call to 'CheckLabels'. -Sometimes we were seeing adj labels that where the same. This -change makes sure that the labels are 'reduced' if we have this -condition.
04.03.2002 ds9 will now automatically open as a bin table -fits extension named EVENTS, STDEVT, and RAYEVENT.
04.03.2002 when trying to find an image to open in relax -mode (ie the use did not specify an extension), ds9 will not find a -valid image if the length of either axis is 0.
04.03.2002 now check for Ghostscript version 6.50 or higher -when invoking Save As.
04.03.2002 add help application preference. Users can now -choose between Netscape and Mozilla as the prefered help -application.
04.04.2002 ds9 version 2.1b7 released to the -public.
04.02.2002 upgrade to XPA 2.1.0e2. This fixes a problem with xpa and linux/linuxppc.
04.03.2002 fixed a problem with AST. plot.c, line 19463, change parameter 'force' from 1 to 0 in call to 'CheckLabels'. Sometimes we were seeing adj labels that where the same. This change makes sure that the labels are 'reduced' if we have this condition.
04.03.2002 ds9 will now automatically open as a bin table fits extension named EVENTS, STDEVT, and RAYEVENT.
04.03.2002 when trying to find an image to open in relax mode (ie the use did not specify an extension), ds9 will not find a valid image if the length of either axis is 0.
04.03.2002 now check for Ghostscript version 6.50 or higher when invoking Save As.
04.03.2002 add help application preference. Users can now choose between Netscape and Mozilla as the prefered help application.
04.04.2002 ds9 version 2.1b7 released to the public.

Version 2.1b6

02.04.2002 upgraded to ast version 1.8.6. Modified ast to -use sscanf() for all platforms except Darwin. Darwin uses -astSscanf(), which works around a problem with sscanf() on MacOSX, -with format strings of the following format: sscanf(str, " %s %n", -foo, &nc).
02.04.2002 changed fity++ primary_/head_ header -relationship. primary_ is only set if there is a primary header is -available and different from head_.
02.04.2002 wsc's are init'd with both the head_ and the -primary_ (if available) to handle the case where wcs keywords are -spread between hdu nd primary headers in mulitiple extension -files.
02.06.2002 all xpa commands are now 'catch{}' to invoke a -procedure that will unwind the watch cursor stack. Hopefully, no -more stuck watch cursors.
02.07.2002 add color and width parameters to -contours paste command. defaults are green and -1
02.08.2002 fixed a problem with the FRAME menu. It was -cutting off the last separator.
02.12.2002 AST grid still does not support ICRS properly. -When a user sets the coordinate system to ICRS, the actually -parameters sent to the AST grid code is FK5
02.13.2002 for XPA points array, fits, regions, and wcs -(fillbuf=false), manually flush the buffer at the end to make sure -no data is left
02.13.2002 ecliptic coords from wcssubs corrected by new -version of wcs/wcscon.c
02.13.2002 AST grids, corrected the MDJ-OBS keyword -generated to generate the correct EPOCH.
02.13.2002 adjusted the EQUINOX value for ECLIPTIC coords -for ast grids to agree with wcssubs. Seems for ecliptic coords, -wcssubs and ast use two slightly different interpretations of the -EQUINOX value.
02.13.2002 fixed a problem with histogram equalization -introduced in version 2.1b5.
02.14.2002 fixed a problem with titles in plot(stdin). We -now take the first line, and starting from the end, pick off the -dimension, x and y axis titles, and the remainder is taken as the -plot title. It can contain spaces and special characters such as -'[]'
02.14.2002 add 'Always create new plot' option to -prefs
02.14.2002 add multiple analysis plots, unless prefs are -unset
02.14.2002 change default annulus and panda to 1 -annuli
02.14.2002 enable multiple array loads via blueplate -dialog
02.14.2002 reset,append, and replace wcs now processes -OBJECT keyword
02.15.2002 fixed a problem with grid format of degrees. -Sometimes, the incorrect format would be used. This was corrected -by up'ng the number of digits displayed to d.3
02.04.2002 upgraded to ast version 1.8.6. Modified ast to use sscanf() for all platforms except Darwin. Darwin uses astSscanf(), which works around a problem with sscanf() on MacOSX, with format strings of the following format: sscanf(str, " %s %n", foo, &nc).
02.04.2002 changed fity++ primary_/head_ header relationship. primary_ is only set if there is a primary header is available and different from head_.
02.04.2002 wsc's are init'd with both the head_ and the primary_ (if available) to handle the case where wcs keywords are spread between hdu nd primary headers in mulitiple extension files.
02.06.2002 all xpa commands are now 'catch{}' to invoke a procedure that will unwind the watch cursor stack. Hopefully, no more stuck watch cursors.
02.07.2002 add color and width parameters to contours paste command. defaults are green and 1
02.08.2002 fixed a problem with the FRAME menu. It was cutting off the last separator.
02.12.2002 AST grid still does not support ICRS properly. When a user sets the coordinate system to ICRS, the actually parameters sent to the AST grid code is FK5
02.13.2002 for XPA points array, fits, regions, and wcs (fillbuf=false), manually flush the buffer at the end to make sure no data is left
02.13.2002 ecliptic coords from wcssubs corrected by new version of wcs/wcscon.c
02.13.2002 AST grids, corrected the MDJ-OBS keyword generated to generate the correct EPOCH.
02.13.2002 adjusted the EQUINOX value for ECLIPTIC coords for ast grids to agree with wcssubs. Seems for ecliptic coords, wcssubs and ast use two slightly different interpretations of the EQUINOX value.
02.13.2002 fixed a problem with histogram equalization introduced in version 2.1b5.
02.14.2002 fixed a problem with titles in plot(stdin). We now take the first line, and starting from the end, pick off the dimension, x and y axis titles, and the remainder is taken as the plot title. It can contain spaces and special characters such as '[]'
02.14.2002 add 'Always create new plot' option to prefs
02.14.2002 add multiple analysis plots, unless prefs are unset
02.14.2002 change default annulus and panda to 1 annuli
02.14.2002 enable multiple array loads via blueplate dialog
02.14.2002 reset,append, and replace wcs now processes OBJECT keyword
02.15.2002 fixed a problem with grid format of degrees. Sometimes, the incorrect format would be used. This was corrected by up'ng the number of digits displayed to d.3
02.21.2002 upgraded to AST 1.8.7
02.21.2002 upgraded to WCS 3.0.7
02.22.2002 fixed a problem with Ascii Tables in fitsy++. -The column offset is now calculated from TBCOLn if -present.
02.22.2002 simplied columns in fitsy++. Now all columns -have a value(char* ptr, int i) and str(char* ptr, int i) -procedure.
02.22.2002 fixed a problem with Ascii Tables in fitsy++. The column offset is now calculated from TBCOLn if present.
02.22.2002 simplied columns in fitsy++. Now all columns have a value(char* ptr, int i) and str(char* ptr, int i) procedure.
02.22.2002 add support for HST WFPC2 mosaics
02.25.2002 fixed a problem with 'marker command'. The -command STRING must be quoted by '\{' '\}' before being pasted to -the Frame parser.
02.26.2002 add $ERROR/ERROR: support for analysis -$plot(stdin) macro.
02.26.2002 analysis menus now support multiple levels of -hierarchical menus
02.26.2002 multiple hierarchical menus may have the same -label
02.26.2002 hierarchical menu label may have an imbedded -spaces
02.26.2002 add endhmenu endparam to analysis file -parser
02.25.2002 fixed a problem with 'marker command'. The command STRING must be quoted by '\{' '\}' before being pasted to the Frame parser.
02.26.2002 add $ERROR/ERROR: support for analysis $plot(stdin) macro.
02.26.2002 analysis menus now support multiple levels of hierarchical menus
02.26.2002 multiple hierarchical menus may have the same label
02.26.2002 hierarchical menu label may have an imbedded spaces
02.26.2002 add endhmenu endparam to analysis file parser
02.26.2002 analysis file text maybe indented
02.26.2002 add help support to analysis file
02.27.2002 add $BEGINTEXT/$ENDTEXT to $plot(stdin) -macro
02.27.2002 add xpa get fits [type|image|table] -command
02.27.2002 add $BEGINTEXT/$ENDTEXT to $plot(stdin) macro
02.27.2002 add xpa get fits [type|image|table] command
02.27.2002 minor tweak with the File:Save as menu
02.27.2002 clean up some minor memory leaks with -FitsImage::initwcs()
02.27.2002 fixed a problem in dialog.tcl DialogWait and -reseting errorInfo
02.27.2002 clean up some minor memory leaks with FitsImage::initwcs()
02.27.2002 fixed a problem in dialog.tcl DialogWait and reseting errorInfo
03.01.2002 dss non-save file now uses internal gz
03.04.2002 plot windows can now support a second set of y -and error values.
03.04.2002 plot windows can now support a second set of y and error values.
03.05.2002 add debug iis option
03.05.2002 filenames now always reflect fits extension -name/number and filter.
03.05.2002 the last step in analysis commands now replaces -all '][' with ',', building up readable filters.
03.06.2002 updated nan.C and nan.h to reflect erics new -treatment of alpha
03.05.2002 filenames now always reflect fits extension name/number and filter.
03.05.2002 the last step in analysis commands now replaces all '][' with ',', building up readable filters.
03.06.2002 updated nan.C and nan.h to reflect erics new treatment of alpha
03.08.2002 add support for save fits gz
03.12.2002 keywords BSCALE/BZERO/BLANK are now ignored for -FITS IEEE floating point data
03.12.2002 IEEE nan and inf are supported as valid FITS -IEEE floating point data
03.13.2002 add fits.sh test suite which tests for bitpix = -8,16,32,-32,-64 and BLANK,BSCALE,BZERO keywords, and IEEE floating -point data NaN and INF.
03.12.2002 keywords BSCALE/BZERO/BLANK are now ignored for FITS IEEE floating point data
03.12.2002 IEEE nan and inf are supported as valid FITS IEEE floating point data
03.13.2002 add fits.sh test suite which tests for bitpix = 8,16,32,-32,-64 and BLANK,BSCALE,BZERO keywords, and IEEE floating point data NaN and INF.
03.15.2002 add save resample support
03.18.2002 add support for Mosaic Fast Render. Only valid -for IRAF mosaics. Basically, you track the current fitsimage til -you have miss.
03.18.2002 add support for Mosaic Fast Render. Only valid for IRAF mosaics. Basically, you track the current fitsimage til you have miss.
03.19.2002 upgrade XPA 2.1.0e
03.19.2002 upgrade FILTER 1.1.0e
03.19.2002 upgrade FITSY 1.1.0e
03.19.2002 fixed a problem when a user CUT a region that -had a dialog box open. A CUT operation now calls the delete -callback to remove any pending dialog boxes.
03.19.2002 fixed a problem with -print command line option -for truecolor visuals. We need to make sure that the window is -realized so that the colormap has been created.
03.20.2002 ds9 version 2.1b6 released to the -public
03.19.2002 fixed a problem when a user CUT a region that had a dialog box open. A CUT operation now calls the delete callback to remove any pending dialog boxes.
03.19.2002 fixed a problem with -print command line option for truecolor visuals. We need to make sure that the window is realized so that the colormap has been created.
03.20.2002 ds9 version 2.1b6 released to the public

Version 2.1b5

fixed a problem with bogus wcs data and replace wcs xpa -command
fixed a problem with bogus wcs data and replace wcs xpa command
add view tickmarks to grid dialog box
fixed a problem with loading a custom colormap and then -printing
fixed a problem with loading a custom colormap and then printing
add command line/xpa option load colormap file
fixed problems with grid dialog box and switching between -frames
fixed problems with grid dialog box and switching between frames
add command line option pan
add command line option about
add command line option view
gzip compression is now built-in
add xpa fits [mosaic|mosaicimage]
fixed a problem with loading arrays via stdin
fixed a problem with the panda region and -rotation
improved performance in plotting of large data -sets
fixed a problem with xpa analysis plot stdin and ';' in the -title
fixed a problem with the panda region and rotation
improved performance in plotting of large data sets
fixed a problem with xpa analysis plot stdin and ';' in the title
increased the histequ internal buffer size to 16k
enhance xpa analysis load command
add multiple preload analysis files
added analysis command log
add xpa grid load/save
add command line option grid
fixed a problem with loading fits from a stream where the -primary hdu contains an image
fixed a problem with loading fits from a stream where the primary hdu contains an image
enhance xpa/command support for dss
add nameserver command line option
fix a problem with panner and magnifer -preferences
fix a problem with panner and magnifer preferences
fixed a issue when gz files are a few bytes short
add support for wcs mosaics
added support for wcs grids for all types of -mosaics
added support for wcs grids for all types of mosaics
speed up printing by factor of 5
add new grid type
updated to wcssubs 3.0.5
updated to ast 1.8.3
updated to filter 1.0b9
updated to fitsy 1.0b9
command line options -file, -mosaic, -mosaicimage, -array, --url are now modal
command line options -file, -mosaic, -mosaicimage, -array, -url are now modal
add -debug [options] support
fixed a problem with contours and NAN data
fixed a problem with contours and DATASEC
split the pros, saoimage, and saotng parsers
fixed a problem with text with the saotng parser
fixed a problem with saotng,saoimage, and pros regions -parsers and \n terminators
fixed a problem with saotng,saoimage, and pros regions parsers and \n terminators
add thin width contours
add thin width grids
fixed a problem with iraf mosaics
10.31.2001 Physical, Amplifier, and Detector coordinates -are only displayed if keywords are present
11.1.2001 Diplay header will display primary header if -requested
10.31.2001 Physical, Amplifier, and Detector coordinates are only displayed if keywords are present
11.1.2001 Diplay header will display primary header if requested
11.1.2001 add xpa cmap value command
11.2.2001 removed support for analysis with files with -spaces cause it created a problem with filename with -extensions
11.2.2001 fixed a problem with analysis regions files and -special characters that was causing a problem with ellipse -annlus
11.2.2001 removed support for analysis with files with spaces cause it created a problem with filename with extensions
11.2.2001 fixed a problem with analysis regions files and special characters that was causing a problem with ellipse annlus
11.2.2001 add analysis $file[$region] macro
11.8.2001 fixed a problem with saving pixel table -data
11.8.2001 add John Rolls new blueplate special stand dialog -box
11.8.2001 removed 'Open Mosaic Images', since you can now -do the same from the dialog box
11.8.2001 fixed a problem with printing/saving text from -SimpleTextDialog
11.8.2001 fixed a problem with saving pixel table data
11.8.2001 add John Rolls new blueplate special stand dialog box
11.8.2001 removed 'Open Mosaic Images', since you can now do the same from the dialog box
11.8.2001 fixed a problem with printing/saving text from SimpleTextDialog
11.9.2001 load muliple files is now much faster
11.13.2001 fixed a problem with Simple List Box and -windows
11.13.2001 default standard dialog box for windows is now -the windows default
11.13.2001 fixed a problem with Simple List Box and windows
11.13.2001 default standard dialog box for windows is now the windows default
12.3.2001 expand update to update [now]
12.4.2001 fitsy++ now promotes all keyword finds to -uppercase
12.4.2001 add 'get fits header # keyword <str>' -command
12.4.2001 fix a problem with selecting projection region at -high zoom factors
12.5.2001 fixed problems with length and orientation of -projection region
12.6.2001 change 'get data values' syntax to include fits -#
12.14.2001 fixed a problem with mosaics with linear wcs -that caused a core
12.31.2001 supported added for regions and -mosaics
12.4.2001 fitsy++ now promotes all keyword finds to uppercase
12.4.2001 add 'get fits header # keyword <str>' command
12.4.2001 fix a problem with selecting projection region at high zoom factors
12.5.2001 fixed problems with length and orientation of projection region
12.6.2001 change 'get data values' syntax to include fits #
12.14.2001 fixed a problem with mosaics with linear wcs that caused a core
12.31.2001 supported added for regions and mosaics
1.2.2002 projection regions now support mosaics
1.3.2002 updated xparemote with proxy support
1.3.2002 add vo prefs
1.4.2002 add ciao pie region support
1.7.2002 fixed panda and wcs with rotation -problem
1.7.2002 fixed panda and wcs with rotation problem
1.9.2002 uprade ast to version 1.8.4
1.15.2002 enable Blt_ZoomStack for data plots
1.17.2002 fixed a problem with iraf mosaics with flipped -segments and a round off problem
1.17.2002 fixed a problem with iraf mosaics with flipped segments and a round off problem
1.18.2002 add support for multiple aux contours
1.23.2002 fixed a problem with fits headers and the END -keyword is not 8 chars
1.23.2002 fixed many problems with no fits loaded and user -gui actions
1.24.2002 fixed a problem with looking for fits region -extensions and a filter specified
1.24.2002 add regions file format and coord system to prefs -menu
1.25.2002 get data values now spans mosaics and is in -native coords
1.31.2002 ds9 version 2.1b5 released to the -public
1.23.2002 fixed a problem with fits headers and the END keyword is not 8 chars
1.23.2002 fixed many problems with no fits loaded and user gui actions
1.24.2002 fixed a problem with looking for fits region extensions and a filter specified
1.24.2002 add regions file format and coord system to prefs menu
1.25.2002 get data values now spans mosaics and is in native coords
1.31.2002 ds9 version 2.1b5 released to the public

Version 2.1b4

fixed a problem very, very large images and int -overflow
fixed a problem very, very large images and int overflow
add Page Setup preferences
plot data is filtered to remove all non numeric -data
plot data is filtered to remove all non numeric data
fixed a problem with plotting x,y data on alpha
add manual grid layout
text regions can now be rotated
regions text now appears in the magnifier
added the PANDA region
added analysis file macro $entry
fixed a problem with multiple menu entries for analysis -files with multiple file templates
default values of Analysis file parameters are now -updated
fixed a problem with multiple menu entries for analysis files with multiple file templates
default values of Analysis file parameters are now updated
fixed a problem with clear analysis commands
analysis tasks are now non-blocking
add xy regions file format
fixed problem with ps level 2 psuedocolor8 printing and -inverse colormaps
in regions files, the comment char '#' comments out til a -new-line char
extended $regions macro to include multiple properties and -regions format
fixed a problem with loading array data on a little endian -machine and the arch is not specified
fixed problem with ps level 2 psuedocolor8 printing and inverse colormaps
in regions files, the comment char '#' comments out til a new-line char
extended $regions macro to include multiple properties and regions format
fixed a problem with loading array data on a little endian machine and the arch is not specified
fixed a problem with histogram equalization
fixed a major problem with all negative float or double -data and min/max issues
fixed a major problem with all negative float or double data and min/max issues
fixed a problem with $regions and no wcs
fixed a problem with printing ps level 2 and fits with -NAN
fixed a problem with running on a msb machine, and -displaying on a lsb 24bit machine
unrolled all mosaic algorithms to cycle thru all segments -for each pixel
fixed a problem with printing ps level 2 and fits with NAN
fixed a problem with running on a msb machine, and displaying on a lsb 24bit machine
unrolled all mosaic algorithms to cycle thru all segments for each pixel
add DATASEC for rendering and printing
upgraded to tcl/tk 8.3.3
add http and ftp macro expand to analysis
fixed a problem with contour log scale
add button 2 bindinds for panner
iraf -fifo default is now /dev/imt1
commented out error messages for bad iraf -fifo, -port, --unix
add default imtoolrc values to fb_config if no imtoolrc -file is found at startup
commented out error messages for bad iraf -fifo, -port, -unix
add default imtoolrc values to fb_config if no imtoolrc file is found at startup
add iis support for windows port
add command: get data coordsys x y dx dy var
add plot limits to plot tool
add PROJECTION region
add GETURL analysis macro
Fits bin table keywords TUNITx are now process if -available
Fits bin table keywords TUNITx are now process if available
add $filename(root) macro
update filename on load
fixed a problem with Colormaps with a name with a single -character
fixed a problem with Colormaps with a name with a single character
added iraf 'non-display' imexamine support

Version 2.1b3

fixed a problem with angles of regions specified in -WCS
fixed a problem with angles of regions specified in WCS
add xpa point 'regions save'
add xpa point 'regions load'
regions file format SAOIMAGE now supports annulus, -ellipse annulus, and box annulus
the obsolete Ftools regions file format support has -been removed
fixed many problems with IRAF regions file -format
fixed many problems with CIAO regions file -format
regions file format SAOIMAGE now supports annulus, ellipse annulus, and box annulus
the obsolete Ftools regions file format support has been removed
fixed many problems with IRAF regions file format
fixed many problems with CIAO regions file format
removed all support for Rosat All Sky Survey
all comments and global settings have been removed from -regions output if delimiter is set to semicolon
fixed a problem with regions defined in WCS degrees and do -not lie on an image
fixed a problem with ellipse annulus and box annulus -regions in regions files that contain only one region
check for radius of length 0 for circle, annulus, ellipse, -and ellipse annulus
Added Histogram Equalization colormap scale -distribution
all comments and global settings have been removed from regions output if delimiter is set to semicolon
fixed a problem with regions defined in WCS degrees and do not lie on an image
fixed a problem with ellipse annulus and box annulus regions in regions files that contain only one region
check for radius of length 0 for circle, annulus, ellipse, and ellipse annulus
Added Histogram Equalization colormap scale distribution
removed default as font option
default font is now helvetica
changed command line option -regionfile to --region
fixed a problem with command line option -region and -incorrect coordinates
Change the 'Scale:User Limits...' dialog into non-modal -'Scale Parameters...'
changed command line option -regionfile to -region
fixed a problem with command line option -region and incorrect coordinates
Change the 'Scale:User Limits...' dialog into non-modal 'Scale Parameters...'
Added 'ZMax' Scale Limits algorithm
fixed a problem with loading regions files with full -pathnames with 'fits' in them
Updated Prefs, command line options, and xpa points to -reflect the new way minmax and scale options are handled
fixed a problem with loading regions files with full pathnames with 'fits' in them
Updated Prefs, command line options, and xpa points to reflect the new way minmax and scale options are handled
Removed 'Scan On Load' prefs
Added 'Source/Background' region property
Add support for 'Source/Background' region property to -SAOtng region parser
Fixed a color problem with pseudocolor 8 frames and -black/white. This showed up in new Sun hardware and Solaris 8 -sofware
Fixed a problem with Postscript printing in pseudocolor 8 -colormode
Add support for 'Source/Background' region property to SAOtng region parser
Fixed a color problem with pseudocolor 8 frames and black/white. This showed up in new Sun hardware and Solaris 8 sofware
Fixed a problem with Postscript printing in pseudocolor 8 colormode
The magnifier now updates during blinking
Added pixel table commands to command line options and -xpa
Added pixel table commands to command line options and xpa
Add -single command line option
Add default region shape to preferences
New Analysis File format supported, with new macros -$message, $text, $plot
New Analysis File format supported, with new macros $message, $text, $plot
Add -analysis command line option
Add subcommands to xpa analysis: -load,clear,message,text,plot
Add subcommands to xpa analysis: load,clear,message,text,plot
Add Analysis File macros $data and $image
Add autoload FITS regions option
Add load FITS Region file to command line options and xpa -regions
DSS servers now have limits as to size of image -downloaded
Open Array now presents a dialog box if no specs are -given
Add load FITS Region file to command line options and xpa regions
DSS servers now have limits as to size of image downloaded
Open Array now presents a dialog box if no specs are given
Now supports compression with .ftz extension
All non-modal windows raise to top when -re-invoked
All non-modal windows raise to top when re-invoked
Added Line Width to all regions
Comments are now retained for regions files
Add Line Width to contours
Add $xpa analysis macro
Add $param analysis macros
Fixed a problem with crosshair and rebinning
Fixed a problem with pan click and drag and fits binary -tables
Fixed a problem with pan click and drag and fits binary tables
Add undo regions
Add cut/copy/paste regions
Changed the preferences file and startup file to be -consistent across platforms
Changed the preferences file and startup file to be consistent across platforms
Add 'Pan then Zoom' to button 2 options
Add support for FITS 3D data cubes
Add Edit button row
Add default mode to prefs
Fixed a problem with file names starting with -'file'
Fixed a problem with file names starting with 'file'
Add xpa regions shape/color/width

DS9 Version 2.2 Release Notes

SAOImageDS9 Version 2.2 Release Notes

Version 2.2.1

11.04.2002 fixed bin smooth buttons.
11.07.2002 remove debug statements in dss.tcl
11.07.2002 fixed a problem with pure virtual method called -when frame was deleted and histequ was the active scale.
11.07.2002 fixed a problem with pasting filters that -contains '\n' on the end of the string.
11.07.2002 fixed a problem with pure virtual method called when frame was deleted and histequ was the active scale.
11.07.2002 fixed a problem with pasting filters that contains '\n' on the end of the string.
11.14.2002 add W3Browse to archive menu
11.14.2002 Web Display: for redirection, first use -'location' meta data parameter, then look for first 'href' in html -to find the redirection url.
11.14.2002 move 'IISInit' after 'ProcessCommandLine' so -that iis command line options take affect.
11.14.2002 remove menu short cut options. Too many -conflicts and unable to support multiple languages.
11.18.2002 change prefs(scalemode) to prefs(scale,mode), -prefs(scalescope) to prefs(scale,scope) and added -prefs(scale,scope) to prefs written.
11.18.2002 change prefs(minmaxmode) to prefs(minmax,mode), -prefs(minmaxsample) to prefs(minmax,sample)
11.18.2002 changes to Archive Servers preferences take -effect immediately.
11.19.2002 Web Display: improved support for fits -mime-types.
11.20.2002 Web Display: improved HVVerifyURL repairing -urls.
11.14.2002 Web Display: for redirection, first use 'location' meta data parameter, then look for first 'href' in html to find the redirection url.
11.14.2002 move 'IISInit' after 'ProcessCommandLine' so that iis command line options take affect.
11.14.2002 remove menu short cut options. Too many conflicts and unable to support multiple languages.
11.18.2002 change prefs(scalemode) to prefs(scale,mode), prefs(scalescope) to prefs(scale,scope) and added prefs(scale,scope) to prefs written.
11.18.2002 change prefs(minmaxmode) to prefs(minmax,mode), prefs(minmaxsample) to prefs(minmax,sample)
11.18.2002 changes to Archive Servers preferences take effect immediately.
11.19.2002 Web Display: improved support for fits mime-types.
11.20.2002 Web Display: improved HVVerifyURL repairing urls.
11.20.2002 Archive: add IRAS MSX support.
11.22.2002 add 'update now' when a new display is received. -This will allow 'movies' from iraf to display properly.
11.22.2002 ds9 version 2.2.1 released to the -public.
11.22.2002 add 'update now' when a new display is received. This will allow 'movies' from iraf to display properly.
11.22.2002 ds9 version 2.2.1 released to the public.

Version 2.2

09.03.2002 add Archive Server user prefs.
09.03.2002 when HV window is unable to parse input, place a -html header around it and display it as text.
09.04.2002 update FITS Bin Table WCS keywords to conform to -25 June 2002 WCS FITS Documentation.
09.04.2002 add support for FITS Bin Table Alt WCS -keywords.
09.04.2002 corrected minor errors in xpa -documentation.
09.04.2002 fixed a minor memory leak when frame is deleted -and an image is still loaded.
09.03.2002 when HV window is unable to parse input, place a html header around it and display it as text.
09.04.2002 update FITS Bin Table WCS keywords to conform to 25 June 2002 WCS FITS Documentation.
09.04.2002 add support for FITS Bin Table Alt WCS keywords.
09.04.2002 corrected minor errors in xpa documentation.
09.04.2002 fixed a minor memory leak when frame is deleted and an image is still loaded.
09.05.2002 added IPAC NED to archive menu.
09.05.2002 add 'marker # move to canvas x y' command for -CXC.
09.05.2002 add 'marker # move to canvas x y' command for CXC.
09.05.2002 add 'marker # angle' command for CXC.
09.09.2002 change ds9 regions syntax for ellipse annulus -and box annulus from old saoimage to funtools syntax.
09.10.2002 undid grid WIDGETBB fix. The results where not -acceptable.
09.12.2002 fixed a nasty bug with binning FITS bin tables -and high bin factor values.
09.13.2002 add Match Scales to Frame menu. This matches all -scale parameters across all frames.
09.09.2002 change ds9 regions syntax for ellipse annulus and box annulus from old saoimage to funtools syntax.
09.10.2002 undid grid WIDGETBB fix. The results where not acceptable.
09.12.2002 fixed a nasty bug with binning FITS bin tables and high bin factor values.
09.13.2002 add Match Scales to Frame menu. This matches all scale parameters across all frames.
09.16.2002 add Grid debug option.
09.17.2002 upgrade to ast 1.8.9. This corrected two -problems. First, incorrect grids were generated for dss images in -the southern hemisphere. Second, a problem with galactic grids that -crossed 0 degrees.
09.17.2002 modify grid code to not to set attributes unless -really needed. ast 1.8.9 tends to set attributes much more often -than previous versions.
09.17.2002 fixed a problem with reconizing non-standard wcs -in the header.
09.17.2002 add more xpa grid support for coordinate -systems, grid type, and view options.
09.18.2002 fixed grid axes label and title spacing problems -in publication mode.
09.18.2002 add optional grid axes label and title spacing -parameters that override internal calculated values.
09.18.2002 the grid x-axis is now plotted on the bottom of -publication grid.
09.18.2002 zoom to fit now makes room for labels for -publication grid.
09.19.2002 fixed a problem with Clear Analysis File that -deleted too much of the Analysis Menu.
09.19.2002 support new vo list syntax of a tab delimited -newline terminated list of three parameters, xpa, title, and -url.
09.20.2002 PHYSICAL Coordinate System: first look for -WCSNAMEx='PHYSICAL', then look for LTM/LTV keywords.
09.24.2002 fixed yet another bug with binning, and -TLMIN/TLMAX keywords whose values were not powers of 2.
09.24.2002 fixed a problem with cores and bad wcs grids. -ds9 now checks to make sure ast generated a vaild grid.
09.24.2002 WebDisplay: plain text is now displayed using -<pre>.
09.24.2002 WebDisplay: default method for forms is now -GET.
09.24.2002 WebDisplay: default width for TEXT form elements -is 20
09.24.2002 XPA nameserver: http has a error, so just clear -errorInfo.
09.25.2002 fixed a bug in wcsinit.c, line 328 and line -409.
09.17.2002 upgrade to ast 1.8.9. This corrected two problems. First, incorrect grids were generated for dss images in the southern hemisphere. Second, a problem with galactic grids that crossed 0 degrees.
09.17.2002 modify grid code to not to set attributes unless really needed. ast 1.8.9 tends to set attributes much more often than previous versions.
09.17.2002 fixed a problem with reconizing non-standard wcs in the header.
09.17.2002 add more xpa grid support for coordinate systems, grid type, and view options.
09.18.2002 fixed grid axes label and title spacing problems in publication mode.
09.18.2002 add optional grid axes label and title spacing parameters that override internal calculated values.
09.18.2002 the grid x-axis is now plotted on the bottom of publication grid.
09.18.2002 zoom to fit now makes room for labels for publication grid.
09.19.2002 fixed a problem with Clear Analysis File that deleted too much of the Analysis Menu.
09.19.2002 support new vo list syntax of a tab delimited newline terminated list of three parameters, xpa, title, and url.
09.20.2002 PHYSICAL Coordinate System: first look for WCSNAMEx='PHYSICAL', then look for LTM/LTV keywords.
09.24.2002 fixed yet another bug with binning, and TLMIN/TLMAX keywords whose values were not powers of 2.
09.24.2002 fixed a problem with cores and bad wcs grids. ds9 now checks to make sure ast generated a vaild grid.
09.24.2002 WebDisplay: plain text is now displayed using <pre>.
09.24.2002 WebDisplay: default method for forms is now GET.
09.24.2002 WebDisplay: default width for TEXT form elements is 20
09.24.2002 XPA nameserver: http has a error, so just clear errorInfo.
09.25.2002 fixed a bug in wcsinit.c, line 328 and line 409.
09.25.2002 add Debug Bin option.
09.26.2002 upgrade to xpa 2.1.3
09.26.2002 upgrade to wcssubs 3.1.3
09.26.2002 upgrade to filter 1.2b1
09.26.2002 upgrade to fitsy 1.2b1
10.01.2002 Web Display: more robust URL parseing
10.01.2002 Web Display: add 'Save to Fits File' -option
10.01.2002 fixed 'xpaget ds9 bin cols' to return only 2 -cols if bin depth is 1.
10.07.2002 Web Display: add support for new window with -button click.
10.08.2002 Change in saotk Makefiles to correct a problem -with Bison and Flex.
10.08.2002 Analysis Text now updates as text -arrives.
10.08.2002 add xpa/command line support for -MatchFrames.
10.08.2002 don't write WCS for Save Fits Resample and DSS -fits.
10.10.2002 Web Display: hidden fields are not totally -encoded if url is present.
10.17.2002 Fixed a problem with default fonts. Add the -option of 'Default', which will not set any font options, if -selected. This allows the native system to choose the best -font/size combo.
10.01.2002 Web Display: add 'Save to Fits File' option
10.01.2002 fixed 'xpaget ds9 bin cols' to return only 2 cols if bin depth is 1.
10.07.2002 Web Display: add support for new window with button click.
10.08.2002 Change in saotk Makefiles to correct a problem with Bison and Flex.
10.08.2002 Analysis Text now updates as text arrives.
10.08.2002 add xpa/command line support for MatchFrames.
10.08.2002 don't write WCS for Save Fits Resample and DSS fits.
10.10.2002 Web Display: hidden fields are not totally encoded if url is present.
10.17.2002 Fixed a problem with default fonts. Add the option of 'Default', which will not set any font options, if selected. This allows the native system to choose the best font/size combo.
10.18.2002 Add ProcessFrameCmd.
10.18.2002 Add system wide preference file -support.
10.18.2002 Add Default mode. It just updates the infobox -and graphs, with no regions.
10.21.2002 Fixed a problem with old prefs files and -marker(system).
10.22.2002 Fixed a problem with MINMAX Sample. Sample -intervals are now equal in row and columns.
10.25.2002 Fixed a problem with vo and errors that occur -when connecting to the vo server.
10.25.2002 Add Match Colorbars and Match Scales xpa/command -line options.
10.25.2002 Changed Analysis plot error reporting to include -first line of received data.
10.25.2002 Fixed a problem with DSS and editing the dialog -with another image loaded.
10.27.2002 Add filename to ds9/funtools regions file -header.
10.29.2002 Add Lock Crosshairs xpa/command line -options.
10.18.2002 Add system wide preference file support.
10.18.2002 Add Default mode. It just updates the infobox and graphs, with no regions.
10.21.2002 Fixed a problem with old prefs files and marker(system).
10.22.2002 Fixed a problem with MINMAX Sample. Sample intervals are now equal in row and columns.
10.25.2002 Fixed a problem with vo and errors that occur when connecting to the vo server.
10.25.2002 Add Match Colorbars and Match Scales xpa/command line options.
10.25.2002 Changed Analysis plot error reporting to include first line of received data.
10.25.2002 Fixed a problem with DSS and editing the dialog with another image loaded.
10.27.2002 Add filename to ds9/funtools regions file header.
10.29.2002 Add Lock Crosshairs xpa/command line options.
10.31.2002 ds9 version 2.2 released to public.
Version 2.2b2

07.31.2002 fixed a problem with hv and urls of the form -foo.com/foo/bar.html#foo. Now, the html is not reloaded before the -goto is executed.
08.01.2002 add adjust text size support to web -browser
08.01.2002 add boxcar and tophat smooth support for -binning.
07.31.2002 fixed a problem with hv and urls of the form foo.com/foo/bar.html#foo. Now, the html is not reloaded before the goto is executed.
08.01.2002 add adjust text size support to web browser
08.01.2002 add boxcar and tophat smooth support for binning.
08.05.2002 add -vo commandline and xpa support
08.05.2002 fixed a problem for the windows port where -windows has been configured to open a fits file with ds9. In this -case, the file path name passed to ds9 is actually in 'dos' format. -So we used a cygwin function to convert to a posix format. This -only occurs in a command line file name option.
08.06.2002 fixed a problem with smooth and -depth>1.
08.06.2002 fixed a problem with save fits -resample.
08.07.2002 the user can now display the horz and vert -graphs, even in tile or blink mode
08.07.2002 ds9 will operate in single mode, even if in tile -or blink mode, if there is just one frame.
08.08.2002 add Gaussian smooth support for -binning.
08.08.2002 fixed a problem with the plot tool and -displaying discrete x y e1 y2 data. The correct colors are now -used.
08.08.2002 the plot tool will now always update the plot -title, x axis label, and y axis label when receiving new -data.
08.08.2002 add xpaset -p ds9 analysis plot close -support.
08.05.2002 fixed a problem for the windows port where windows has been configured to open a fits file with ds9. In this case, the file path name passed to ds9 is actually in 'dos' format. So we used a cygwin function to convert to a posix format. This only occurs in a command line file name option.
08.06.2002 fixed a problem with smooth and depth>1.
08.06.2002 fixed a problem with save fits resample.
08.07.2002 the user can now display the horz and vert graphs, even in tile or blink mode
08.07.2002 ds9 will operate in single mode, even if in tile or blink mode, if there is just one frame.
08.08.2002 add Gaussian smooth support for binning.
08.08.2002 fixed a problem with the plot tool and displaying discrete x y e1 y2 data. The correct colors are now used.
08.08.2002 the plot tool will now always update the plot title, x axis label, and y axis label when receiving new data.
08.08.2002 add xpaset -p ds9 analysis plot close support.
08.08.2002 add Know Issues Documentation
08.12.2002 add http proxy support.
08.12.2002 fixed a problem with the close box for the bin -dialog box.
08.20.2002 add support for default fonts to -preferences.
08.23.2002 remove timeouts for all http requests with -optional cancel support.
08.23.2002 fixed a number of items with web -display.
08.26.2002 reformat all documentation to remove references -to Helvetica
08.26.2002 bring grid WIDGETBB in by one so that the border -can be seen and printed.
08.26.2002 fixed a problem with web gifs under windows. The -output channel needed an -translation binary flag.
08.26.2002 adjust font sizes for web display to more -closely follow those of Netscape and IE.
08.27.2002 add 'Save as Fits', 'Save as Image', and 'Page -Setup' buttons.
08.27.2002 add 'First' and 'NVSS' archive server menu -items.
08.28.2002 add auto coordinate feed to HV for archive -servers.
08.12.2002 fixed a problem with the close box for the bin dialog box.
08.20.2002 add support for default fonts to preferences.
08.23.2002 remove timeouts for all http requests with optional cancel support.
08.23.2002 fixed a number of items with web display.
08.26.2002 reformat all documentation to remove references to Helvetica
08.26.2002 bring grid WIDGETBB in by one so that the border can be seen and printed.
08.26.2002 fixed a problem with web gifs under windows. The output channel needed an -translation binary flag.
08.26.2002 adjust font sizes for web display to more closely follow those of Netscape and IE.
08.27.2002 add 'Save as Fits', 'Save as Image', and 'Page Setup' buttons.
08.27.2002 add 'First' and 'NVSS' archive server menu items.
08.28.2002 add auto coordinate feed to HV for archive servers.
08.30.2002 ds9 version 2.2b2 released to public.

Version 2.2b1

04.05.2002 fixed a problem with xpa contour load.
04.05.2002 improved parsing of analysis menu file. In -particular, keywords like 'help', 'param', and 'end' can be used -more freely.
04.05.2002 improved parsing of analysis menu file. In particular, keywords like 'help', 'param', and 'end' can be used more freely.
04.10.2002 add tag suppport for regions.
04.11.2002 add background marker stack. The default stack -is in the foreground.
04.11.2002 fixed checks for can Edit, can Move, can Rotate, -and can Delete properties thru out marker code.
04.11.2002 add background marker stack. The default stack is in the foreground.
04.11.2002 fixed checks for can Edit, can Move, can Rotate, and can Delete properties thru out marker code.
04.11.2002 add HIGHLITE marker property.
04.12.2002 add $null macro to analysis support.
04.17.2002 fitsy++ now builds an keyword index to search -for keywords. Previously, it would search sequentially.
04.18.2002 add a fix to ps level 2 driver to prevent a -'\n%' in the image data. Seems the perl script 'assemble' does a -global search/replace that results in corrupted image data. This -fix includes a redesign of a previous fix that worked around an -issue with old versions of dvips that will incorrectly -process'\n%%'.
04.17.2002 fitsy++ now builds an keyword index to search for keywords. Previously, it would search sequentially.
04.18.2002 add a fix to ps level 2 driver to prevent a '\n%' in the image data. Seems the perl script 'assemble' does a global search/replace that results in corrupted image data. This fix includes a redesign of a previous fix that worked around an issue with old versions of dvips that will incorrectly process'\n%%'.
04.18.2002 upgrade to WCS 3.1.0
04.24.2002 start to add support for multiple -wcs's.
04.25.2002 add support for multiple wcs's in -infobox.
04.26.2002 improve tag support for regions. All -functionality of selected regions are now available for tagged -regions.
04.30.2002 add marker command var command to support -regions files in tcl vars.
05.08.2002 recalc polygon center when adding or deleteing -vertex.
05.13.2002 complete implementation of multiple wcs support. -ds9 now supports a total of 31 coordinate systems. Furthermore, of -the 27 WCS coordinate systems, both sky coordinates and linear -coordinates are fully supported.
05.13.2002 complete re-implemenation of map() functions. -Now all map functions are in the fits case, and only map between -REF and IMAGE/PHYSICAL/AMPLIFIER/DETECTOR/WCS/WCSA... coordinate -systems. This cleans up alot of code and confusion.
05.14.2002 add support for TCROT and CDn_1 WCS keywords in -FITS bin tables.
05.16.2002 dramatically speed up parsing wcs keywords by -substituting the fitsy++ index based keyword search routine for -Doug Mink's 'ksearch' routine. With multiple wcs's in a large -mosaic this can save up to a minute at load time.
05.16.2002 fixed a minor problem with xpa dss. http has a -error, that carries over and is caught by xpa.
05.16.2002 analysis $text windows will not appear if there -is no output, or just an <cr>.
05.16.2002 fixed display header to correctly display 80 -chars, not 79.
05.16.2002 fixed a problem with iis and very long file -names. names up to 256 chars are now allowed.
005.20.2002 AMPLIFER and DETECTOR coordinate menu entries -are now an option, to be enabled via the Preferences:Misc menu -option. Changes will take affect at startup.
05.23.2002 add support for 3D binning of fits bin -tables.
05.24.2002 made changes to grid.C to handle the special -LONG/NPOL skyframe coordinate system used by Chandra.
05.24.2002 add -xpa and xpa prefs to allow a user to enable -or disable initialization of XPA at startup
05.28.2002 add -xpa [inet|local|unix|localhost] xpa -point.
05.29.2002 correct 3D binning to properly reflect filter -params in the filename.
06.03.2002 fixed a problem with Fits Bin Tables, odd length -rows and referencing shorts.
06.04.2002 add support for multiple wcs with skyframe -panner compass, along with prefs.
04.24.2002 start to add support for multiple wcs's.
04.25.2002 add support for multiple wcs's in infobox.
04.26.2002 improve tag support for regions. All functionality of selected regions are now available for tagged regions.
04.30.2002 add marker command var command to support regions files in tcl vars.
05.08.2002 recalc polygon center when adding or deleteing vertex.
05.13.2002 complete implementation of multiple wcs support. ds9 now supports a total of 31 coordinate systems. Furthermore, of the 27 WCS coordinate systems, both sky coordinates and linear coordinates are fully supported.
05.13.2002 complete re-implemenation of map() functions. Now all map functions are in the fits case, and only map between REF and IMAGE/PHYSICAL/AMPLIFIER/DETECTOR/WCS/WCSA... coordinate systems. This cleans up alot of code and confusion.
05.14.2002 add support for TCROT and CDn_1 WCS keywords in FITS bin tables.
05.16.2002 dramatically speed up parsing wcs keywords by substituting the fitsy++ index based keyword search routine for Doug Mink's 'ksearch' routine. With multiple wcs's in a large mosaic this can save up to a minute at load time.
05.16.2002 fixed a minor problem with xpa dss. http has a error, that carries over and is caught by xpa.
05.16.2002 analysis $text windows will not appear if there is no output, or just an <cr>.
05.16.2002 fixed display header to correctly display 80 chars, not 79.
05.16.2002 fixed a problem with iis and very long file names. names up to 256 chars are now allowed.
005.20.2002 AMPLIFER and DETECTOR coordinate menu entries are now an option, to be enabled via the Preferences:Misc menu option. Changes will take affect at startup.
05.23.2002 add support for 3D binning of fits bin tables.
05.24.2002 made changes to grid.C to handle the special LONG/NPOL skyframe coordinate system used by Chandra.
05.24.2002 add -xpa and xpa prefs to allow a user to enable or disable initialization of XPA at startup
05.28.2002 add -xpa [inet|local|unix|localhost] xpa point.
05.29.2002 correct 3D binning to properly reflect filter params in the filename.
06.03.2002 fixed a problem with Fits Bin Tables, odd length rows and referencing shorts.
06.04.2002 add support for multiple wcs with skyframe panner compass, along with prefs.
06.04.2002 add -xpa noxpans support.
06.04.2002 match frames wcs now uses the wcs system and wcs -skyframe specified in align to wcs.
06.04.2002 match frames wcs now uses the wcs system and wcs skyframe specified in align to wcs.
06.05.2002 upgrade to xpa 2.1.1
06.06.2002 add wcs master menu and buttons
06.06.2002 sync xpa wcs and command line wcs -command.
06.10.2002 xpa wcs and commanline -wcs now uses same code -to process
06.06.2002 sync xpa wcs and command line wcs command.
06.10.2002 xpa wcs and commanline -wcs now uses same code to process
06.10.2002 xpa nameserver format now skyformat
06.10.2002 added support for variable args for xpa contour -and -contour.
06.11.2002 add match frames physical, amplifier, detector. -this does not handle rotation, nor orientation.
06.11.2002 the master wcs menu now modifies the Region:File -Coordinate System menu also
06.11.2002 fixed a problem with list projection and linear -wcs. the thickness parameter was not written correctly.
06.12.2002 fixed a problem with -tile and -region -commandline options. The ds9 window must be realized before -processing region files.
06.13.2002 fixed a problem with -pagesetup commandline -option.
06.13.2002 fixed a problem with ds9parser.Y, prosparser.Y, -and tngparser.Y when processing coordinates when no coordinate -system has been specified.
06.13.2002 fixed a problem with -pan to command line -option. The ds9 window needs to be realized (and the matrices -defined) before processing.
06.13.2002 binning on a third column now invokes the data -cube dialog box.
06.14.2002 add smaller buffer sizes to binning menus. We -want to do this for those building large 3D binning -movies.
06.19.2002 implemented new grid support. Grids now handle -rotated images much better. Numerics are better -positioned.
06.27.2002 updated to WCSSUBS 3.1.1. This corrects a number -of TNX problems.
06.10.2002 added support for variable args for xpa contour and -contour.
06.11.2002 add match frames physical, amplifier, detector. this does not handle rotation, nor orientation.
06.11.2002 the master wcs menu now modifies the Region:File Coordinate System menu also
06.11.2002 fixed a problem with list projection and linear wcs. the thickness parameter was not written correctly.
06.12.2002 fixed a problem with -tile and -region commandline options. The ds9 window must be realized before processing region files.
06.13.2002 fixed a problem with -pagesetup commandline option.
06.13.2002 fixed a problem with ds9parser.Y, prosparser.Y, and tngparser.Y when processing coordinates when no coordinate system has been specified.
06.13.2002 fixed a problem with -pan to command line option. The ds9 window needs to be realized (and the matrices defined) before processing.
06.13.2002 binning on a third column now invokes the data cube dialog box.
06.14.2002 add smaller buffer sizes to binning menus. We want to do this for those building large 3D binning movies.
06.19.2002 implemented new grid support. Grids now handle rotated images much better. Numerics are better positioned.
06.27.2002 updated to WCSSUBS 3.1.1. This corrects a number of TNX problems.
06.27.2002 add File:XPA info menu item.
06.27.2002 add XPA regions selected feature.
06.28.2002 Analysis $geturl macro calls are now -logged.
06.28.2002 Analysis $geturl macro calls are now logged.
07.01.2002 add support for limited web browser
07.01.2002 help reference manual now uses built-in brower, -and is static.
07.02.2002 fixed a problem with cross-platform displays and -16 bit truecolor.
07.08.2002 fixed a problem with regions and changes in the -bin factor of fits bin tables.
07.01.2002 help reference manual now uses built-in brower, and is static.
07.02.2002 fixed a problem with cross-platform displays and 16 bit truecolor.
07.08.2002 fixed a problem with regions and changes in the bin factor of fits bin tables.
07.08.2002 add $xpa_method analysis macro.
07.08.2002 add @@xpa_method@@ support in hv.html
07.22.2002 fix numerous problems with internal web -browser.
07.23.2002 add async support for internal web -browser.
07.24.2002 changed Makefiles so that parser.C, parser.C.h, -and lex.C are now archived. Therefor, builds no longer need bison -and flex, unless changes have been made to the parser.Y. This gets -around problems with different versions of bison.
07.22.2002 fix numerous problems with internal web browser.
07.23.2002 add async support for internal web browser.
07.24.2002 changed Makefiles so that parser.C, parser.C.h, and lex.C are now archived. Therefor, builds no longer need bison and flex, unless changes have been made to the parser.Y. This gets around problems with different versions of bison.
07.25.2002 add support for the Compass region.
07.25.2002 add vo proxy and internal hv support.

diff --git a/ds9/doc/release/r2.3.html b/ds9/doc/release/r2.3.html index ff83da1..f17d708 100644 --- a/ds9/doc/release/r2.3.html +++ b/ds9/doc/release/r2.3.html @@ -1,69 +1,41 @@ - - - + + + DS9 Version 2.3 Release Notes - +

SAOImageDS9 Version 2.3 Release Notes

Version 2.3b1

11.04.2002 add multi-language support structure.
12.02.2002 configure http user agent to 'ds9'. This fixes a -problem with www.google.com
12.02.2002 configure http user agent to 'ds9'. This fixes a problem with www.google.com
12.02.2002 add Help DS9 Home Page menu Item.
12.03.2002 Web Display: implemented 'Content-Encoding' and -modified 'Mime-Type' to use new proposed FITS Mime-Type -RFC.
12.03.2002 Web Display: when the mime-type is set to -'application/octet-stream', try to parse the url, looking for a -valid fits or fits.gz image. If so, load as a fits. If not, save to -disk.
12.03.2002 Web Display: reduced the size of fonts by -2 to -more closely match netscape and internet explorer.
12.03.2002 Web Display: updated Archive menus to use new -IRAS web interface.
12.03.2002 Web Display: add font size argument to HV. Now, -web sites can have different default font sizes, based on what -looks the best.
12.10.2002 Fixed a problem with calculating LTMV keywords -from alt WCS keywords in the case of WCSNAME='PHYSICAL'
12.10.2002 Add support for TDMIN and TDMAX FITS bin table -keywords.
12.03.2002 Web Display: implemented 'Content-Encoding' and modified 'Mime-Type' to use new proposed FITS Mime-Type RFC.
12.03.2002 Web Display: when the mime-type is set to 'application/octet-stream', try to parse the url, looking for a valid fits or fits.gz image. If so, load as a fits. If not, save to disk.
12.03.2002 Web Display: reduced the size of fonts by -2 to more closely match netscape and internet explorer.
12.03.2002 Web Display: updated Archive menus to use new IRAS web interface.
12.03.2002 Web Display: add font size argument to HV. Now, web sites can have different default font sizes, based on what looks the best.
12.10.2002 Fixed a problem with calculating LTMV keywords from alt WCS keywords in the case of WCSNAME='PHYSICAL'
12.10.2002 Add support for TDMIN and TDMAX FITS bin table keywords.
12.10.2002 Add 'Delete All Frames' support.
12.10.2002 only use fits keyword inheritence if INHERIT -keyword is present in the header.
12.11.2002 Fixed a problem with WCS headers and INHERIT, -which resulted in duplicate keywords. This made wcssubs very -confused.
12.11.2002 Add 'Delete Selected Regions' to Regions -menu.
12.11.2002 Add confirmation dialog to 'Delete All -Regions'.
12.12.2002 Display Header List dialog is now 40 chars -wide.
12.12.2002 Web Display: add initial coordinates to ADS -archive sites
12.16.2002 Add *.fit and *.fts to fits dialog box -templates.
12.16.2002 Add support for GUI Groups, based on region -tags.
12.10.2002 only use fits keyword inheritence if INHERIT keyword is present in the header.
12.11.2002 Fixed a problem with WCS headers and INHERIT, which resulted in duplicate keywords. This made wcssubs very confused.
12.11.2002 Add 'Delete Selected Regions' to Regions menu.
12.11.2002 Add confirmation dialog to 'Delete All Regions'.
12.12.2002 Display Header List dialog is now 40 chars wide.
12.12.2002 Web Display: add initial coordinates to ADS archive sites
12.16.2002 Add *.fit and *.fts to fits dialog box templates.
12.16.2002 Add support for GUI Groups, based on region tags.
12.17.2002 Add HSV colormap.
12.18.2002 Fixed a problem with the PANDA Region at zooms -other than 1.
12.19.2002 DS9 version 2.3b1 released to the -public.
12.18.2002 Fixed a problem with the PANDA Region at zooms other than 1.
12.19.2002 DS9 version 2.3b1 released to the public.

diff --git a/ds9/doc/release/r3.0.html b/ds9/doc/release/r3.0.html index 5ce289d..73adbc8 100644 --- a/ds9/doc/release/r3.0.html +++ b/ds9/doc/release/r3.0.html @@ -1,660 +1,337 @@ - - - + + + DS9 Version 3.0 Release Notes - -

SAOImageDS9 Version 3.0 Release Notes

+ +

SAOImageDS9 Version 3.0 Release Notes

Version 3.0

12.24.2002 TCL/TK: update to 8.4.1
12.24.2002 BLT: update to 2.4z
12.24.2002 TKIMG: update to 1.3rc
01.03.2003 XPA: fixed a problem with 'xpaget ds9 regions -selected'
01.28.2003 SAVEAS: now saves all slices of a data cube, if -the display mode is single.
01.28.2003 GUI: Add 'wm protocol . WM_DELETE_WINDOW -QuitDS9' for main window so that tcl/tk 8.4 does not segv when a -user double clicks on a close window icon.
01.03.2003 XPA: fixed a problem with 'xpaget ds9 regions selected'
01.28.2003 SAVEAS: now saves all slices of a data cube, if the display mode is single.
01.28.2003 GUI: Add 'wm protocol . WM_DELETE_WINDOW QuitDS9' for main window so that tcl/tk 8.4 does not segv when a user double clicks on a close window icon.
01.29.2003 GCC: add support for gcc 3.0/3.2
01.29.2002 GCC: updated saotk/FlexLexer.h from flex 2.5.27, -available at http://lex.sourceforge.net/
02.04.2003 WINDOWS: modify configuration files for tkimg1.3 -and tkhtml to support windows.
01.29.2002 GCC: updated saotk/FlexLexer.h from flex 2.5.27, available at http://lex.sourceforge.net/
02.04.2003 WINDOWS: modify configuration files for tkimg1.3 and tkhtml to support windows.
02.05.2003 WCS: upgrade to 3.3.0
02.06.2003 ARCHIVE: the default ADS max search size is now -a radius of .1 arcmin.
02.06.2003 XPA: add '-xpa tcl' command line option. By -default, disable xpa tcl access since it is a major security -risk.
02.07.03 FITS: fixed a problem with loading fits files via -the url menu or command line.
02.07.03 HTTP: loading images via url http processes the -image based on the http header mime type and encoding, not the file -name. images loaded via url ftp are still processed based on file -name.
02.07.03 PLOT: fixed a problem with global vars and the -plot widget.
02.11.03 BINNING: fixed a bug with the bin table smoothing -support. If the bin factor is large enough to bin the entire image -in the bin buffer, ds9 would segv by trying to read out of -bounds.
02.25.03 XPA: fixed a bug with loading an image from xpa -stdin without a filename.
02.25.03 XPA: add 'fillbuf=false' to all xpa receive -commands that do not use $buf. This will speed up processing -because the data socket is not opened.
02.25.03 XPA: fixed a problem with appending an wcs via -xpa. The appended wcs is now positioned at the end, not the -beginning. also, a problem occurred when the 'END' card was not the -last card of the header. This has been fixed.
02.25.03 XPA: changes to xpa regions syntax. -'moveback'/'movefront' are now 'move back'/'move front', -'selectall'/'selectnone' are now 'select all'/'select none', and -'deleteall' is 'delete all'. Backward compatibility has bee -maintained
02.25.03 XPA: add 'select group <groupname>' and -'delete select' to xpa regions access point.
02.26.03 HV: add support for gif,png,ppm,xbm,xpm file -formats
02.27.03 HV: fixed some problems with -tkhtml uri resolver. This cleans up a lot of tcl code.
03.04.03 HV: images are now scaled if the width/height args -are provided in the html src.
02.06.2003 ARCHIVE: the default ADS max search size is now a radius of .1 arcmin.
02.06.2003 XPA: add '-xpa tcl' command line option. By default, disable xpa tcl access since it is a major security risk.
02.07.03 FITS: fixed a problem with loading fits files via the url menu or command line.
02.07.03 HTTP: loading images via url http processes the image based on the http header mime type and encoding, not the file name. images loaded via url ftp are still processed based on file name.
02.07.03 PLOT: fixed a problem with global vars and the plot widget.
02.11.03 BINNING: fixed a bug with the bin table smoothing support. If the bin factor is large enough to bin the entire image in the bin buffer, ds9 would segv by trying to read out of bounds.
02.25.03 XPA: fixed a bug with loading an image from xpa stdin without a filename.
02.25.03 XPA: add 'fillbuf=false' to all xpa receive commands that do not use $buf. This will speed up processing because the data socket is not opened.
02.25.03 XPA: fixed a problem with appending an wcs via xpa. The appended wcs is now positioned at the end, not the beginning. also, a problem occurred when the 'END' card was not the last card of the header. This has been fixed.
02.25.03 XPA: changes to xpa regions syntax. 'moveback'/'movefront' are now 'move back'/'move front', 'selectall'/'selectnone' are now 'select all'/'select none', and 'deleteall' is 'delete all'. Backward compatibility has bee maintained
02.25.03 XPA: add 'select group <groupname>' and 'delete select' to xpa regions access point.
02.26.03 HV: add support for gif,png,ppm,xbm,xpm file formats
02.27.03 HV: fixed some problems with tkhtml uri resolver. This cleans up a lot of tcl code.
03.04.03 HV: images are now scaled if the width/height args are provided in the html src.
03.04.03 ARCHIVE: add chandra archive web chaser.
03.12.03 COLORMAP: Fixed a problem with InitColorbar and a -colormap of A or B.
03.12.03 ANALYSIS: all comments after # are -ignored.
03.12.03 ANALYSIS: non macros can be escaped by using -$$.
03.12.03 COLORMAP: Fixed a problem with InitColorbar and a colormap of A or B.
03.12.03 ANALYSIS: all comments after # are ignored.
03.12.03 ANALYSIS: non macros can be escaped by using $$.
03.31.03 COMMAND: Add -frame command line option.
04.08.03 GUI: Remove Magnifier Mode option, along with -Magnifier Replicate code.
04.23.03 HST WFPC: Mosaic images must be loaded directly. -this fixes a problem in that it was not possible to autodect a -WFPC2 image in an incoming data stream, such as stdin.
05.12.03 API: *** CHANGE *** Frame load syntax has changed -to make it consistent across all modes and file formats. In -particular, the general syntax is: <frame> load fits|array -<filename> mmap|alloc|alloc gz|channel|shared|socket|var -<options>
05.12.03 API: *** CHANGE *** shared memory loads no longer -require the size of the memory segment.
04.08.03 GUI: Remove Magnifier Mode option, along with Magnifier Replicate code.
04.23.03 HST WFPC: Mosaic images must be loaded directly. this fixes a problem in that it was not possible to autodect a WFPC2 image in an incoming data stream, such as stdin.
05.12.03 API: *** CHANGE *** Frame load syntax has changed to make it consistent across all modes and file formats. In particular, the general syntax is: <frame> load fits|array <filename> mmap|alloc|alloc gz|channel|shared|socket|var <options>
05.12.03 API: *** CHANGE *** shared memory loads no longer require the size of the memory segment.
05.20.03 WCS: update to 3.3.4
05.20.03 AST: update to 2.0
05.22.03 GRID: fix a problem with grid.C interface to AST. -The text bounding box code was returning the coordinates in a -clockwise manner. It needs to be returned in an anti-clockwise -manner.
05.22.03 GRID: Add support for user specified Grid Axes -Numerics gap.
05.27.03 GRID: Fixed a problem with the bounding box of a -publication grid. it was .5 pixels off.
05.28.03 GUI: Fixed a problem with 'get cursor'. Sometimes, -as with loading dss images, the matrices were not updated in time, -and 'get cursor' returned bogus values. Now all calls to 'get -cursor' force an update.
06.02.03 GUI: fixed several problems with examine -mode
06.02.03 ARCHIVE: add NOAO 4MASS and SIRTF and NOAO NSA to -archive menu
06.09.03 RGB: support is FINISHED! now, lets see how its -works!
06.11.03 RGB: Add Lock Channels to lock most Scale and Bin -parameters between channels.
06.16.03 GRID: Add numerics spacing to save/load grid -configuration
05.22.03 GRID: fix a problem with grid.C interface to AST. The text bounding box code was returning the coordinates in a clockwise manner. It needs to be returned in an anti-clockwise manner.
05.22.03 GRID: Add support for user specified Grid Axes Numerics gap.
05.27.03 GRID: Fixed a problem with the bounding box of a publication grid. it was .5 pixels off.
05.28.03 GUI: Fixed a problem with 'get cursor'. Sometimes, as with loading dss images, the matrices were not updated in time, and 'get cursor' returned bogus values. Now all calls to 'get cursor' force an update.
06.02.03 GUI: fixed several problems with examine mode
06.02.03 ARCHIVE: add NOAO 4MASS and SIRTF and NOAO NSA to archive menu
06.09.03 RGB: support is FINISHED! now, lets see how its works!
06.11.03 RGB: Add Lock Channels to lock most Scale and Bin parameters between channels.
06.16.03 GRID: Add numerics spacing to save/load grid configuration
06.16.03 FITS: Add 3D array data cube
06.17.03 FITS: Fixed a problem with an incorrect data cube -dialog and wfpc2 mosaics and rgb data cubes. Basically, these two -cases are not really data cubes.
06.17.03 FITS: Fixed a problem with an incorrect data cube dialog and wfpc2 mosaics and rgb data cubes. Basically, these two cases are not really data cubes.
06.17.03 RGB: Replace RGB menu with RGB dialog.
06.17.03 XPA: Fixed a problem with xpaget ds9 regions -[include|exclude|source|background].
06.18.03 REGION: fix a problem with non-linear physical -coordinates and save/load regions.
06.18.03 WCS: fix a problem with determining the rotation -of a wcs coordinate system. previously, CRPIX was used as the start -point. This does not work in cases where the tangent point is very -far off the image. Instead, (1,1) is used.
06.18.03 WCS: Remove preference Panner WCS origin. This is -stupid and breaks with the previous change. Just remove it instead -of trying to fix it.
06.17.03 XPA: Fixed a problem with xpaget ds9 regions [include|exclude|source|background].
06.18.03 REGION: fix a problem with non-linear physical coordinates and save/load regions.
06.18.03 WCS: fix a problem with determining the rotation of a wcs coordinate system. previously, CRPIX was used as the start point. This does not work in cases where the tangent point is very far off the image. Instead, (1,1) is used.
06.18.03 WCS: Remove preference Panner WCS origin. This is stupid and breaks with the previous change. Just remove it instead of trying to fix it.
06.26.03 FITS: Add support 3D array data cubes.
06.30.03 RGB: Add support for RGB array data -cube.
07.01.03 DSS: Fixed namesrv.tcl and dss.tcl to promote more -robust error handling. In particular, http error codes are now -checked, and the results are verified before proceeding
07.01.03 XPA: fixed a problem with $ds9 -xpa tcl. The next -argument was being ignored.
07.02.03 DSS: fixed another problem with namesrv.tcl. -SAONED and SAOSIMBAD were returning incorrect values for southern -hemisphere.
07.02.03 HTTP: remove http log from preferences and added -http log and ftp log to debug menu
07.03.03 GUI: fixed a problem with open file dialog box. if -the user clicked 'cancel', an error message would result. this has -been corrected.
07.09.03 FITS: add Large File Support for Linux. Linux is -still restricted to ~2.5Gb.
07.10.03 FITS: add FLUSH parameter for fitsy++ -array.
07.10.03 FITS: Major change in behavior of fitsy++ streams -and FLUSH. Only socket and socketgz will flush, all others will not -flush the buffer after an error, or after successfull loading a -fits image.
06.30.03 RGB: Add support for RGB array data cube.
07.01.03 DSS: Fixed namesrv.tcl and dss.tcl to promote more robust error handling. In particular, http error codes are now checked, and the results are verified before proceeding
07.01.03 XPA: fixed a problem with $ds9 -xpa tcl. The next argument was being ignored.
07.02.03 DSS: fixed another problem with namesrv.tcl. SAONED and SAOSIMBAD were returning incorrect values for southern hemisphere.
07.02.03 HTTP: remove http log from preferences and added http log and ftp log to debug menu
07.03.03 GUI: fixed a problem with open file dialog box. if the user clicked 'cancel', an error message would result. this has been corrected.
07.09.03 FITS: add Large File Support for Linux. Linux is still restricted to ~2.5Gb.
07.10.03 FITS: add FLUSH parameter for fitsy++ array.
07.10.03 FITS: Major change in behavior of fitsy++ streams and FLUSH. Only socket and socketgz will flush, all others will not flush the buffer after an error, or after successfull loading a fits image.
07.11.03 XPA: add DATACUBE support.
07.14.03 WCS: Fixed a problem with WCS XLON-TAN (NPOLE) and -AST. NPOLE is a special wcs equ coord system, and has to be handed -by wcs2ast().
07.15.03 XPA: add xpa iis access port for control of some -iis functionality.
07.14.03 WCS: Fixed a problem with WCS XLON-TAN (NPOLE) and AST. NPOLE is a special wcs equ coord system, and has to be handed by wcs2ast().
07.15.03 XPA: add xpa iis access port for control of some iis functionality.
07.17.03 RELEASE version 3.0b4
07.25.03 FITS: add MMAPINCR memory access mode. This only -mmaps the data needed, not the entire file. This allows a user to -view many small segements of a very large file.
07.25.03 FITS: add MMAPINCR memory access mode. This only mmaps the data needed, not the entire file. This allows a user to view many small segements of a very large file.
07.28.03 TCL/TK: upgrade to 8.4.4
07.30.03 XPA: add regions fg/bg support.
08.05.03 PLOT: reimplement analaysis plot widget to support -unlimited number of data sets.
08.05.03 PLOT: reimplement analaysis plot widget to support unlimited number of data sets.
08.07.03 ARCHIVE: add Rosat All-Sky survey
08.08.03 XPA: add PLOT, which allows full control over all -plot widgets via xpa.
08.13.03 COLORMAP: fixed a problem with loading lut -colormaps under linux. ifstream behaves differently between solaris -and linux.
08.14.03 XPA: changed xpaget array. Now returns the array -data in the current frame.
08.08.03 XPA: add PLOT, which allows full control over all plot widgets via xpa.
08.13.03 COLORMAP: fixed a problem with loading lut colormaps under linux. ifstream behaves differently between solaris and linux.
08.14.03 XPA: changed xpaget array. Now returns the array data in the current frame.
08.15.03 RELEASE version 3.0b5
08.18.03 FITS: add Large file support for darwin and -linuxppc
08.18.03 LINUXPPC: fixed a problem with linking linuxppc. -The copy of libX11.a that comes with Yellow Dog 3.0 is bad. So we -can't links static.
08.19.03 XPA: add options to xpa update so that 'update -idletasks' is not run at the end of file loads. This allows the -user to do several incremental loads without updating the -screen.
08.19.03 API: only update idletasks for horz/vert graph if -graphs are on
08.18.03 FITS: add Large file support for darwin and linuxppc
08.18.03 LINUXPPC: fixed a problem with linking linuxppc. The copy of libX11.a that comes with Yellow Dog 3.0 is bad. So we can't links static.
08.19.03 XPA: add options to xpa update so that 'update idletasks' is not run at the end of file loads. This allows the user to do several incremental loads without updating the screen.
08.19.03 API: only update idletasks for horz/vert graph if graphs are on
08.19.03 API: add debug idletasks support.
08.29.03 GCC: gcc 3.3 is now supported. For all code, if -GNUC >=3, new <sstream> are used. For all code, GNUC -<3, <strstream> is used.
08.29.03 PLOT: fixed a problem with saving plot data in -x,y,ye format
08.29.03 GCC: gcc 3.3 is now supported. For all code, if GNUC >=3, new <sstream> are used. For all code, GNUC <3, <strstream> is used.
08.29.03 PLOT: fixed a problem with saving plot data in x,y,ye format
08.29.03 FITS: add LFS for solaris.
08.29.03 COMMAND: add -analysismenu command line option at -the request of CXC.
08.29.03 COMMAND: fixed a problem with -pan and -pan to and -other comman line options that follow.
08.29.03 COMMAND: add -analysismenu command line option at the request of CXC.
08.29.03 COMMAND: fixed a problem with -pan and -pan to and other comman line options that follow.
09.02.03 FITS: add LFS for alpha.
09.04.03 SOLARIS: add new solaris64 port. Requires gcc 3.3 -or greater.
09.04.03 SOLARIS: add new solaris64 port. Requires gcc 3.3 or greater.
09.04.03 XPA: upgrade to 2.1.4
09.04.03 FILTER: upgrade to 1.2.3b1
09.04.03 FITSY: upgrade to 1.2.3b1
09.06.03 SOLARIS: fixed a problem with 64bit machines and -truecolor displays.
09.06.03 FITS: add support for multiple extension fits data -cubes.
09.08.03 REGION: fixed a problem with projection regions -and an undefined variable.
09.08.03 BINNING: fixed a problem with fits bin tables -without TLMIN/TLMAX or TDMIN/TDMAX. the center was incorrectly -being calculated.
09.08.03 ARCHIVE: fixed a problem with the NOAO archive web -display with no images loaded. The variables 'ra' and 'dec' were -not defined.
09.08.03 PLOT: ixed a problem with the plot widget and the -preferences unique plot parameter.
09.09.03 PLOT: project plot xaxis are now in coordinate -system specified via the marker dialog box.
09.11.03 PLOT: fixed a problem with the line, ruler, and -projection regions and properly displaying wcs linear -coordinates
09.11.03 WCS: cleaned up a lot of code for -setting/adjusting coordinate menus
09.11.03 RGB: loading a new channel in a rgb image will no -longer delete regions, grids, or aux contours.
09.15.03 FITS: removed BITPIX32 define. using <int> -instead since it is defined as a consistent 4 bytes across all -platforms.
09.18.03 RGB: split lock rgb into lock scale and lock -bin.
09.21.03 BINNING: frames now have 'memory' of certain bin -paramenters. It is now possiable to set bin parameters before -loading a bin table.
09.22.03 RGB: InfoBox now displays all values for RGB -images, not just the current channel value.
09.22.03 API: change names of various tcl marker -variables
09.22.03 REGION: add prefs for regions color, width, -properties, font
09.22.03 GUI: add HJKL key bindings as substitute for arrow -keys
09.06.03 SOLARIS: fixed a problem with 64bit machines and truecolor displays.
09.06.03 FITS: add support for multiple extension fits data cubes.
09.08.03 REGION: fixed a problem with projection regions and an undefined variable.
09.08.03 BINNING: fixed a problem with fits bin tables without TLMIN/TLMAX or TDMIN/TDMAX. the center was incorrectly being calculated.
09.08.03 ARCHIVE: fixed a problem with the NOAO archive web display with no images loaded. The variables 'ra' and 'dec' were not defined.
09.08.03 PLOT: ixed a problem with the plot widget and the preferences unique plot parameter.
09.09.03 PLOT: project plot xaxis are now in coordinate system specified via the marker dialog box.
09.11.03 PLOT: fixed a problem with the line, ruler, and projection regions and properly displaying wcs linear coordinates
09.11.03 WCS: cleaned up a lot of code for setting/adjusting coordinate menus
09.11.03 RGB: loading a new channel in a rgb image will no longer delete regions, grids, or aux contours.
09.15.03 FITS: removed BITPIX32 define. using <int> instead since it is defined as a consistent 4 bytes across all platforms.
09.18.03 RGB: split lock rgb into lock scale and lock bin.
09.21.03 BINNING: frames now have 'memory' of certain bin paramenters. It is now possiable to set bin parameters before loading a bin table.
09.22.03 RGB: InfoBox now displays all values for RGB images, not just the current channel value.
09.22.03 API: change names of various tcl marker variables
09.22.03 REGION: add prefs for regions color, width, properties, font
09.22.03 GUI: add HJKL key bindings as substitute for arrow keys
09.24.03 RELEASE version 3.0b6
09.29.03 WCS: changes to getWCSRotation, getWCSOrientation -to better reflect the actual rotation
09.30.03 XPA: add xpa/command line options for -configuration of info panel
09.30.03 API: change variable 'mosaic(fast)' to -'ds9(mosaic,fast)'
09.30.03 FITS: add new support for blank/Inf/NaN background -color
10.01.03 FITS: add support for image background -color.
09.29.03 WCS: changes to getWCSRotation, getWCSOrientation to better reflect the actual rotation
09.30.03 XPA: add xpa/command line options for configuration of info panel
09.30.03 API: change variable 'mosaic(fast)' to 'ds9(mosaic,fast)'
09.30.03 FITS: add new support for blank/Inf/NaN background color
10.01.03 FITS: add support for image background color.
10.01.03 RGB: add support for RGB lock colorbar
10.23.03 HV: add support for VO DIS
10.23.03 HV: fixed a problem with forms and encrypting -field names, allow with the returned value
10.23.03 GUI: Change mode 'Default' to 'None'. We can't use -the term 'default' because with problems with tcl switchs and the -default keyword
10.24.03 WCS: add support for WCS AIPS projections via the -preferences menu.
10.23.03 HV: fixed a problem with forms and encrypting field names, allow with the returned value
10.23.03 GUI: Change mode 'Default' to 'None'. We can't use the term 'default' because with problems with tcl switchs and the default keyword
10.24.03 WCS: add support for WCS AIPS projections via the preferences menu.
10.24.03 API: add acknowledgment
11.03.03 COMMAND: fixed a problem with command line options --mosaicimage, -mosaicimagewfpc2, -medatacube
11.03.03 FITS: fixed a problem with multiple extension data -cube with all memory models except MMAPINCR.
11.03.03 COMMAND: fixed a problem with command line options --mosaicimagewcs, -mosaicimageiraf, -mosaicimagewfpc2, -medatacube -and RGB frames
11.05.03 WCS: remove internal wcsZoom matrix. All wcsZoom -actions are now applied to the current zoom matrix. This -fixes a number of problems with 'Match Frames to WCS'
11.05.03 WCS: fixed a problem with rotated images and -examine mode.
11.07.03 REGION: ffixed a problem with -regular panda regions. The code incorrectly determined a regulier -panda was irregulier and output it as such.
11.07.03 REGION: fixed a problem with region angles in -general, where there there was a rotation in the wcs.
11.03.03 COMMAND: fixed a problem with command line options -mosaicimage, -mosaicimagewfpc2, -medatacube
11.03.03 FITS: fixed a problem with multiple extension data cube with all memory models except MMAPINCR.
11.03.03 COMMAND: fixed a problem with command line options -mosaicimagewcs, -mosaicimageiraf, -mosaicimagewfpc2, -medatacube and RGB frames
11.05.03 WCS: remove internal wcsZoom matrix. All wcsZoom actions are now applied to the current zoom matrix. This fixes a number of problems with 'Match Frames to WCS'
11.05.03 WCS: fixed a problem with rotated images and examine mode.
11.07.03 REGION: ffixed a problem with regular panda regions. The code incorrectly determined a regulier panda was irregulier and output it as such.
11.07.03 REGION: fixed a problem with region angles in general, where there there was a rotation in the wcs.
11.07.03 HV: add Server Apache Refresh support.
11.07.03 XPA: add xpaget ds9 fits size <coordsys> -<skyformat>
11.07.03 XPA: add xpaget ds9 fits size <coordsys> <skyformat>
11.11.03 XPA: add regions group support.
12.01.03 WCS: update to 3.5.0
12.01.03 XPA: add get contour <coordinate system> -<skyframe> support.
12.01.03 XPA: add get contour <coordinate system> <skyframe> support.
12.05.03 WCS: update to 3.5.1
12.05.03 XPA: upgrade to 2.1.5
12.05.03 FILTER: upgrade to 1.2.3
12.05.03 FITSY: upgrade to 1.2.3
12.05.03 AST: upgrade to 3.0
12.05.03 IIS: upgrade to 1.0
12.10.03 REGION: casted all XPoint to short. There is a -problem with rendering line segments at very high zoom. X11 -overflows and the lines become random. We should check that screen -coordinates never exceed SHRT_MAX
12.10.03 ANALYSIS: geturl() macro is formated before -execution.
12.10.03 REGION: casted all XPoint to short. There is a problem with rendering line segments at very high zoom. X11 overflows and the lines become random. We should check that screen coordinates never exceed SHRT_MAX
12.10.03 ANALYSIS: geturl() macro is formated before execution.
12.11.03 FITs: add mosaic image next wcs support.
12.15.03 RGB: fixed a problem with wcs matching when one of -the wcs is flipped in XX
12.15.03 WCS: fixed a problem with wcs matching -when one of the wcs is flipped in XX
12.15.03 REGION: load fits regions now utilitize the -current region color, width, and font
12.24.03 WCS: back out change #50. We have to use the -projection tan point to correctly build mosaics and RGB -images.
12.15.03 RGB: fixed a problem with wcs matching when one of the wcs is flipped in XX
12.15.03 WCS: fixed a problem with wcs matching when one of the wcs is flipped in XX
12.15.03 REGION: load fits regions now utilitize the current region color, width, and font
12.24.03 WCS: back out change #50. We have to use the projection tan point to correctly build mosaics and RGB images.
01.09.04 AST: upgrade to 3.1.1
01.09.04 GRID: pass PV,PROJP,PS keywords to -AST
01.12.04 TCLLIB: add tcllib 1.4. This package contains a -number of useful tcl packages
01.09.04 GRID: pass PV,PROJP,PS keywords to AST
01.12.04 TCLLIB: add tcllib 1.4. This package contains a number of useful tcl packages
01.12.04 FTP: upgrade to 2.4
01.13.04 TCL: upgrade to 8.4.5
01.13.04 TK: upgrade to 8.4.5
01.13.04 HTTP: add support for proxy -authentication.
01.14.04 COMMAND: fixed a problem with printing from the -command line. The canvas widget was not fully realized before -printing, resulting in no image.
01.15.04 MKTCLAPP: made two changes to the default init -script of mktclapp. The first sees that the the virtual file system -is init'd before the first call to Tcl. This allows Tcl to 'see' -encoding files. The second, for windows only, makes sure that the -Tcl windows file system is init'd before the first call to -Tcl.
01.15.04 MKTCLAPP: add default encoding files to ds9.mta, -now that we can use them.
01.22.04 GUI: Add preference for default temporary file -directory.
01.13.04 HTTP: add support for proxy authentication.
01.14.04 COMMAND: fixed a problem with printing from the command line. The canvas widget was not fully realized before printing, resulting in no image.
01.15.04 MKTCLAPP: made two changes to the default init script of mktclapp. The first sees that the the virtual file system is init'd before the first call to Tcl. This allows Tcl to 'see' encoding files. The second, for windows only, makes sure that the Tcl windows file system is init'd before the first call to Tcl.
01.15.04 MKTCLAPP: add default encoding files to ds9.mta, now that we can use them.
01.22.04 GUI: Add preference for default temporary file directory.
01.23.04 XPA: add xpa imexam.
01.25.04 XPA: add xpa fits header.
01.25.04 XPA: add xpa fits depth.
01.25.04 XPA: modified xpa fits size.
01.25.04 GUI: add language support for info and error -messages.
02.01.04 WCS: more on #50 and #141. If wcs projection is -Zenithal, use CRPIX as reference point to determine wcs rotation -and oriention. Otherwise, use image center point.
02.04.04 CONTOUR: modified smooth algorithm. We now SMOOTH -the entire image with a gaussian kernal. Previously, we would block -by 2 before smoothing with a boxcar kernal. Finally, the default -method is BLOCK.
02.04.04 CONTOUR: A .5 error has been removed -from the BLOCK algorithm.
02.04.04 CONTOUR: the number of contour levels has -been inconsistant in the pass. this has been fixed. If the -number of levels is 1, the high cut value is used.
02.04.04 CONTOUR: fixed log scale bug. it was incorrectly -calculating the levels.
02.05.04 SAVEAS: jpeg,tiff,png,ppm support is now internal -and available to all ports. gs is no longer needed.
02.10.04 REGION: add show/hide support for fg and bg -regions.
02.10.04 COLORMAP: fixed a problem with the -cmap value x y -command. On truecolor visuals, we need to be realized before we -start to manipulate the colormap.
02.10.04 FITS: cleaned up smooth convolve code. same speed, -easier to understand.
01.25.04 GUI: add language support for info and error messages.
02.01.04 WCS: more on #50 and #141. If wcs projection is Zenithal, use CRPIX as reference point to determine wcs rotation and oriention. Otherwise, use image center point.
02.04.04 CONTOUR: modified smooth algorithm. We now SMOOTH the entire image with a gaussian kernal. Previously, we would block by 2 before smoothing with a boxcar kernal. Finally, the default method is BLOCK.
02.04.04 CONTOUR: A .5 error has been removed from the BLOCK algorithm.
02.04.04 CONTOUR: the number of contour levels has been inconsistant in the pass. this has been fixed. If the number of levels is 1, the high cut value is used.
02.04.04 CONTOUR: fixed log scale bug. it was incorrectly calculating the levels.
02.05.04 SAVEAS: jpeg,tiff,png,ppm support is now internal and available to all ports. gs is no longer needed.
02.10.04 REGION: add show/hide support for fg and bg regions.
02.10.04 COLORMAP: fixed a problem with the -cmap value x y command. On truecolor visuals, we need to be realized before we start to manipulate the colormap.
02.10.04 FITS: cleaned up smooth convolve code. same speed, easier to understand.
02.11.04 GUI: Add Colorbar Parameter dialog.
02.11.04 COLORBAR: add support for load/save -contrast/bias.
02.12.04 EXPORT: split EXPORT from SAVEAS. Currently only -FITS is supported.
02.17.04 CONTOUR: when update data cube slice, -automatically regenerate contours.
02.18.04 REGION: the marker menu is now enabled if no frame -or an empty frame is available.
02.20.04 SCALE: add Auto MinMax. by default, use SCAN for -single and SAMPLE for Mosaic and DataCube files
02.20.04 SCALE: fixed a problem with scobe being reset to -LOCAL.
02.23.04 CONTOUR: fixed a problem with incorrect contours -for mosaics and rgb images at startup.
02.11.04 COLORBAR: add support for load/save contrast/bias.
02.12.04 EXPORT: split EXPORT from SAVEAS. Currently only FITS is supported.
02.17.04 CONTOUR: when update data cube slice, automatically regenerate contours.
02.18.04 REGION: the marker menu is now enabled if no frame or an empty frame is available.
02.20.04 SCALE: add Auto MinMax. by default, use SCAN for single and SAMPLE for Mosaic and DataCube files
02.20.04 SCALE: fixed a problem with scobe being reset to LOCAL.
02.23.04 CONTOUR: fixed a problem with incorrect contours for mosaics and rgb images at startup.
02.23.04 XPA: add cd (current directory) command
02.24.04 AST: upgrade 3.2.4
02.24.04 DOC: added support for generating postscript and -pdf versions of the reference manual.
02.25.04 CONTOUR: convert contours to polygons will now -also convert any aux contours.
02.24.04 DOC: added support for generating postscript and pdf versions of the reference manual.
02.25.04 CONTOUR: convert contours to polygons will now also convert any aux contours.
02.27.04 PANDA: fixed probems with GUI add angle.
02.27.04 CIRCLE: new GUI edit algorithm.
02.27.04 ANNULUS: new GUI edit and add annulus -algorithms.
02.27.04 ANNULUS: new GUI edit and add annulus algorithms.
02.27.04 ELLIPSE: new GU edit algorithm.
02.27.04 ELLIPSE ANNULUS: new GUI edit and add annulus -algorithm. This fixed a problem with 0 radius annuli. Also fixed a -problem with GUI rotate after close dialog box.
3.1.04 BOXANNULUS: new GUI edit and add size algorithms. -This fixed a problem with 0 size annuli.
03.01.04 PANDA: new GUI edit and add annulus -algorithms.
03.01.04 PANDA: fixed a problem with a full PANDA from 0 to -360 degrees. Previously, it was displayed as 0 to 0 -degrees.
03.02.04 PANDA: fixed a problem with postscript and radial -lines. The zoom was incorrectly being calculated..
03.02.04 PANDA: fixed a problem with render in magnifier. -The wrong zoom factor was being used.
03.09.04 GUI: add Tab/Shift-Tab bindings to -panner.
03.10.04 GRID: fixed a problem with single publication -bounding box. It now takes into account DATASEC.
02.27.04 ELLIPSE ANNULUS: new GUI edit and add annulus algorithm. This fixed a problem with 0 radius annuli. Also fixed a problem with GUI rotate after close dialog box.
3.1.04 BOXANNULUS: new GUI edit and add size algorithms. This fixed a problem with 0 size annuli.
03.01.04 PANDA: new GUI edit and add annulus algorithms.
03.01.04 PANDA: fixed a problem with a full PANDA from 0 to 360 degrees. Previously, it was displayed as 0 to 0 degrees.
03.02.04 PANDA: fixed a problem with postscript and radial lines. The zoom was incorrectly being calculated..
03.02.04 PANDA: fixed a problem with render in magnifier. The wrong zoom factor was being used.
03.09.04 GUI: add Tab/Shift-Tab bindings to panner.
03.10.04 GRID: fixed a problem with single publication bounding box. It now takes into account DATASEC.
03.10.04 AST: upgrade to 3.2.6
03.12.04 GRAPH: graphs are now active for single,tile,and -blink modes.
03.16.04 WCS LINEAR: fixed many problems with alignment of -WCS LINEAR MOSAICS
03.16.04 RGB: fixed many problems with alignment of RGB WCS -images
03.18.04 FITS: fixed a problem with random numbers beening -displayed for BLANK/NaN
03.12.04 GRAPH: graphs are now active for single,tile,and blink modes.
03.16.04 WCS LINEAR: fixed many problems with alignment of WCS LINEAR MOSAICS
03.16.04 RGB: fixed many problems with alignment of RGB WCS images
03.18.04 FITS: fixed a problem with random numbers beening displayed for BLANK/NaN
03.18.04 RELEASE version 3.0b7
03.22.04 PIXELTABLE: fixed a problem with 'unset -pixelValues'.
03.22.04 SAVEAS: fixed a problem with -'processSaveAs'.
03.22.04 RGB: fixed a problem with turning off all loaded -channels within a frame.
03.31.04 IIS: fixed a problem with a old variable in -DisplayCoordDialog.
03.31.04 BINNING: fixed a problem with dimensions of -DBL_MIN,DBL_MAX.
03.31.04 IIS: turn off blinking cursor while changing -colormap so we do not see a color flash due to the updating of the -frame when the cursor form is changed.
04.01.04 WEB DISPLAY: add options on how to load downloaded -fits.
04.01.04 WEB DISPLAY: fixed a problem when the image -width/height contains garbage.
03.22.04 PIXELTABLE: fixed a problem with 'unset pixelValues'.
03.22.04 SAVEAS: fixed a problem with 'processSaveAs'.
03.22.04 RGB: fixed a problem with turning off all loaded channels within a frame.
03.31.04 IIS: fixed a problem with a old variable in DisplayCoordDialog.
03.31.04 BINNING: fixed a problem with dimensions of DBL_MIN,DBL_MAX.
03.31.04 IIS: turn off blinking cursor while changing colormap so we do not see a color flash due to the updating of the frame when the cursor form is changed.
04.01.04 WEB DISPLAY: add options on how to load downloaded fits.
04.01.04 WEB DISPLAY: fixed a problem when the image width/height contains garbage.
04.02.04 TCL/TK: update to 8.4.6
04.05.04 PAN: fixed yet another problem with -pan. -Hopefully this time, I've got it right.
04.06.04 GRID: fixed a problem with psLine and gcc -2.96.
04.05.04 PAN: fixed yet another problem with -pan. Hopefully this time, I've got it right.
04.06.04 GRID: fixed a problem with psLine and gcc 2.96.
04.06.04 MAKEFILE: fixed a typo with ./configure.
04.06.04 RELEASE version 3.0b8
04.12.04 SAVEAS: add SaveAs MPEG-1 support using tkmpeg and -exmpeg.
04.14.04 BINNING: 60% improvement in speed for little -endian arch.
04.12.04 SAVEAS: add SaveAs MPEG-1 support using tkmpeg and exmpeg.
04.14.04 BINNING: 60% improvement in speed for little endian arch.
04.23.04 ZLIB: upgrade to version 1.2.1
04.26.04 ALPHA: minor changes to make.alpha and -ds9/Makefile for alpha support.
04.26.04 FITS: fixed problems with trying to open regions -extensions in cases where the mode was not mmap.
04.27.04 EXTERNAL FITS: fixed major problems with pattern -matching.
04.27.04 FITSY++: skip over unknow binary column types. We -used to force an exit.
04.28.04 FITSY++: fixed a problem with SocketGZ where if -too little data had arrived, ds9 would incorrectly see this as an -error.
04.29.04 GUI: fixed a race condition in which ds9 'thinks' -the windows have been realized, and XPA has been init'd and the -user starts to delete windows that don't exists. Now XPA is not -realized until the canvas window has been realized.
04.29.04 LINUX: return to a full static link. Seems like -the best option to support current and future versions of -linux.
04.26.04 ALPHA: minor changes to make.alpha and ds9/Makefile for alpha support.
04.26.04 FITS: fixed problems with trying to open regions extensions in cases where the mode was not mmap.
04.27.04 EXTERNAL FITS: fixed major problems with pattern matching.
04.27.04 FITSY++: skip over unknow binary column types. We used to force an exit.
04.28.04 FITSY++: fixed a problem with SocketGZ where if too little data had arrived, ds9 would incorrectly see this as an error.
04.29.04 GUI: fixed a race condition in which ds9 'thinks' the windows have been realized, and XPA has been init'd and the user starts to delete windows that don't exists. Now XPA is not realized until the canvas window has been realized.
04.29.04 LINUX: return to a full static link. Seems like the best option to support current and future versions of linux.
04.29.04 PRINT: add print prefs.
05.03.04 RELEASE version 3.0b9
05.04.04 BINNING: fixed a problem with column size double -and buffer overflow on little endian machines.
05.04.04 PANDA: fixed a problem with postscript and gcc -2.95 compilers. This problem had already been fixed for gcc 3.x -compilers.
05.06.04 BINNING: add support for variable binning in x and -y.
05.07.04 IIS: fixed a problem with buffer overflow and -determining imtool.rc file location.
05.07.04 FRAMEBASE: fixed some minor memory -leaks.
05.10.04 BINNING: for FITS REGIONS files, when loading -against a binned image, compare X and Y bin columns to regions X -and Y bin columns for a match. Do not load unless they -match.
05.10.04 GUI: add 'option' command to control GUI -appearance. Removed many -bd 2 options to clean up the -interface.
05.12.04 BINNING: fixed a major problem with 3D binning. -Once it was turned on and then turned off, important internal -parameters where not being update, resulting in segvs.
05.15.04 RGB: fixed memory leak in loading RGB -images.
05.17.04 LINUX: ok, back to two versions: one dynamic, one -static. The static version is buggy under Fedora, but is required -for old versions of RH. So the default version will be dynamic -linked, with an static version available for older -machines.
05.21.04 XPA: fixed a problem with WCS REPLACE FILE and WCS -APPEND FILE.
05.25.04 PANDA: fixed CIAO output so that the start angle -is always less than the end angle.
05.26.04 FITSY++: clean up code for strm.C, map.C, -mapincr.C
05.31.04 FITSY++: introduce new 'internal paging' mapince.C -for binning files larger than 1Gb. Only 1Gb segments are mmap at -one time, to allow binning >2Gb/>4Gb bin tables under a 32bit -OS.
05.31.04 FITSDATA: optimized swap(), getValueFloat(), -getValueDouble(), and scan() in hopes of speeding up display times, -especially for linux.
05.04.04 BINNING: fixed a problem with column size double and buffer overflow on little endian machines.
05.04.04 PANDA: fixed a problem with postscript and gcc 2.95 compilers. This problem had already been fixed for gcc 3.x compilers.
05.06.04 BINNING: add support for variable binning in x and y.
05.07.04 IIS: fixed a problem with buffer overflow and determining imtool.rc file location.
05.07.04 FRAMEBASE: fixed some minor memory leaks.
05.10.04 BINNING: for FITS REGIONS files, when loading against a binned image, compare X and Y bin columns to regions X and Y bin columns for a match. Do not load unless they match.
05.10.04 GUI: add 'option' command to control GUI appearance. Removed many -bd 2 options to clean up the interface.
05.12.04 BINNING: fixed a major problem with 3D binning. Once it was turned on and then turned off, important internal parameters where not being update, resulting in segvs.
05.15.04 RGB: fixed memory leak in loading RGB images.
05.17.04 LINUX: ok, back to two versions: one dynamic, one static. The static version is buggy under Fedora, but is required for old versions of RH. So the default version will be dynamic linked, with an static version available for older machines.
05.21.04 XPA: fixed a problem with WCS REPLACE FILE and WCS APPEND FILE.
05.25.04 PANDA: fixed CIAO output so that the start angle is always less than the end angle.
05.26.04 FITSY++: clean up code for strm.C, map.C, mapincr.C
05.31.04 FITSY++: introduce new 'internal paging' mapince.C for binning files larger than 1Gb. Only 1Gb segments are mmap at one time, to allow binning >2Gb/>4Gb bin tables under a 32bit OS.
05.31.04 FITSDATA: optimized swap(), getValueFloat(), getValueDouble(), and scan() in hopes of speeding up display times, especially for linux.
06.13.04 WCS: upgrade to version 3.5.3
06.16.04 WEB DISPLAY: increased default font by one -size.
06.16.04 GUI: fixed a problem with display header. Under -Fedora Core 2, the default font size was too small.
06.16.04 WEB DISPLAY: increased default font by one size.
06.16.04 GUI: fixed a problem with display header. Under Fedora Core 2, the default font size was too small.
06.17.04 XPA: add fits header keyword support.
06.17.04 PLOT: add option plot names to xpa, plot name in -window title, plot data command
06.17.04 PLOT: fixed a problem with closing xpa plots via -xpa.
06.18.04 PLOT: remove prefs 'Unique Plot'. This never -worked correctly and is now obsolete.
06.21.04 PANDA: radii now extend from inner annuli to outer -annuli and not from the center.
06.21.04 RGB: fixed a problem with 'fit to zoom' for rgb -frames.
06.17.04 PLOT: add option plot names to xpa, plot name in window title, plot data command
06.17.04 PLOT: fixed a problem with closing xpa plots via xpa.
06.18.04 PLOT: remove prefs 'Unique Plot'. This never worked correctly and is now obsolete.
06.21.04 PANDA: radii now extend from inner annuli to outer annuli and not from the center.
06.21.04 RGB: fixed a problem with 'fit to zoom' for rgb frames.
06.22.04 AST: update to version 3.3-1.
06.23.04 GRIDS: fixed justification (yet again!)
06.24.04 REGIONS: the default GUI size is now constant, -reguardless of current zoom.
06.24.04 REGIONS: add support for cut/copy/paste regions -across frames.
06.25.04 REGIONS: add unselect, begin rotate, end rotate, -begin move, end move, begin edit, end edit callback -support.
06.25.04 GUI: add support for multiple FITS headers for -multiple extension FITS files.
06.28.04 REGIONS: add support for listing WCS keywords and -values as comments in region files.
06.28.04 REGIONS: fixed a problem with the TEXT region -handles with zooms not equal to 1.
06.28.04 XPA: fixed a problem with xpaset regions color and -xpaset regions width.
06.29.04 FITS: add support for reload option. if reload -option is set, markers and aux contours are preserved across -loads.
07.01.04 FITSY++: fixed a problem with binning if the image -header contained more than 36 cards.
07.01.04 FITSY++: added TV and TS keyword support for FITS -bin tables.
07.01.04 FITSY++: add TP keyword support for FITS bin -tables.
07.02.04 GRID: fixed a problem with a wcs with PC -keywords.
07.05.04 WCS: removed WCS projection option. Its no longer -needed.
07.05.04 GRID: fixed several problems with converting from -wcs to AST. AST is very very picky as to which keywords to use and -in what order. These include CDELT's, CD's, PC's, -CROTA's.
06.24.04 REGIONS: the default GUI size is now constant, reguardless of current zoom.
06.24.04 REGIONS: add support for cut/copy/paste regions across frames.
06.25.04 REGIONS: add unselect, begin rotate, end rotate, begin move, end move, begin edit, end edit callback support.
06.25.04 GUI: add support for multiple FITS headers for multiple extension FITS files.
06.28.04 REGIONS: add support for listing WCS keywords and values as comments in region files.
06.28.04 REGIONS: fixed a problem with the TEXT region handles with zooms not equal to 1.
06.28.04 XPA: fixed a problem with xpaset regions color and xpaset regions width.
06.29.04 FITS: add support for reload option. if reload option is set, markers and aux contours are preserved across loads.
07.01.04 FITSY++: fixed a problem with binning if the image header contained more than 36 cards.
07.01.04 FITSY++: added TV and TS keyword support for FITS bin tables.
07.01.04 FITSY++: add TP keyword support for FITS bin tables.
07.02.04 GRID: fixed a problem with a wcs with PC keywords.
07.05.04 WCS: removed WCS projection option. Its no longer needed.
07.05.04 GRID: fixed several problems with converting from wcs to AST. AST is very very picky as to which keywords to use and in what order. These include CDELT's, CD's, PC's, CROTA's.
07.08.04 SAVEAS: reorganize save as menus.
07.08.04 SAVEAS: add support for saving multiple frames as -MPEG movie.
07.13.04 MOSAIC: fixed a problem with mosaic image wcs with -orientations of xx.
07.08.04 SAVEAS: add support for saving multiple frames as MPEG movie.
07.13.04 MOSAIC: fixed a problem with mosaic image wcs with orientations of xx.
07.14.04 WCS: upgrade to version 3.5.5.
07.14.04 FITSY++: add support for real number format -'D'.
07.14.04 FITSY: add changes to support real number format -'D'.
07.15.04 ANALYSIS: stderr can now be redirected to stdout -for $text with the |& macro.
07.15.04 ANALYSIS: shell environment vars will be expanded -within the command with the env() macro.
07.15.04 ANALYSIS: add support for the WEB menu -item.
07.14.04 FITSY++: add support for real number format 'D'.
07.14.04 FITSY: add changes to support real number format 'D'.
07.15.04 ANALYSIS: stderr can now be redirected to stdout for $text with the |& macro.
07.15.04 ANALYSIS: shell environment vars will be expanded within the command with the env() macro.
07.15.04 ANALYSIS: add support for the WEB menu item.
07.26.04 RELEASE version 3.0
07.28.04 IIS: fixed a problem with iraf iis support that -would sometimes result in a blank screen.
07.28.04 IIS: fixed a problem with iraf iis support that would sometimes result in a blank screen.
07.28.04 RELEASE version 3.0.1
08.02.2004 VECTOR: fixed a problem with matrix inversion -with numbers smaller than DBL_EPSILON.
08.02.2004 VECTOR: fixed a problem with matrix inversion with numbers smaller than DBL_EPSILON.
08.02.2004 FRAME: check for negative zoom.
08.06.2004 FITSIMAGE: fixed a problem with determining the -length of a vector in the case of a non-wcs rotated coordinate -system.
08.09.2004 GRID: fixed a problem with a rotation in -physical and wcs linear grids.
08.10.2004 MAKEFILE: add support for emacs tags in -saods9/saotk
08.12.2004 PROJECTION: fixed a problem with paste -projection and setup callback procs.
08.12.2004 REGIONS: fixed a problem where regions -properties where lost if cut/paste across frames.
08.13.2004 DIALOGS: fixed an issues with some windows -managers who needed a hint to bring all dialogs to the -front.
08.13.2004 POLYGON: change default create method to be -simular to box.
08.13.2004 POLYGON: add prefs default polygon -size.
08.13.2004 POLYGON: fixed a problem with the control -handles at high zoom.
08.16.2004 REGIONS: fixed a problem with updating -coordinates/angles/distances when rebinning a FITS bin -table.
08.16.2004 REGIONS: add default system, sky, skyformat, -dist system, and dist format for regions dialog to -preferences.
08.16.2004 FITSY++: fixed a problem with <unsigned -char> columns. They where incorrectly cased as a -<char>.
08.18.2004 SCALE: nolonger reset scale mode from USERCLIP -on load FITS.
08.06.2004 FITSIMAGE: fixed a problem with determining the length of a vector in the case of a non-wcs rotated coordinate system.
08.09.2004 GRID: fixed a problem with a rotation in physical and wcs linear grids.
08.10.2004 MAKEFILE: add support for emacs tags in saods9/saotk
08.12.2004 PROJECTION: fixed a problem with paste projection and setup callback procs.
08.12.2004 REGIONS: fixed a problem where regions properties where lost if cut/paste across frames.
08.13.2004 DIALOGS: fixed an issues with some windows managers who needed a hint to bring all dialogs to the front.
08.13.2004 POLYGON: change default create method to be simular to box.
08.13.2004 POLYGON: add prefs default polygon size.
08.13.2004 POLYGON: fixed a problem with the control handles at high zoom.
08.16.2004 REGIONS: fixed a problem with updating coordinates/angles/distances when rebinning a FITS bin table.
08.16.2004 REGIONS: add default system, sky, skyformat, dist system, and dist format for regions dialog to preferences.
08.16.2004 FITSY++: fixed a problem with <unsigned char> columns. They where incorrectly cased as a <char>.
08.18.2004 SCALE: nolonger reset scale mode from USERCLIP on load FITS.
08.18.2004 AST: upgrade to version 3.4
08.18.2004 GRID: minor tweaks with the default axes -numerics gaps.
08.18.2004 REGIONS: for RGB frames, always use the keyFits -channel in mapping regions to/from reference coordinate -system.
08.18.2004 GRID: minor tweaks with the default axes numerics gaps.
08.18.2004 REGIONS: for RGB frames, always use the keyFits channel in mapping regions to/from reference coordinate system.
08.19.2004 LINUX64: add support for Linux 64.
08.24.2004 XPA: add get data support.
08.25.2004 AST: fixed a bug with using free'd memory in -plot.c
08.25.2004 GUI: fixed two problems with the getDataValues -routine. With non-symetric binning or equatorial sky coordinates, -an incorrect number of values where returned.
08.25.2004 AST: fixed a bug with using free'd memory in plot.c
08.25.2004 GUI: fixed two problems with the getDataValues routine. With non-symetric binning or equatorial sky coordinates, an incorrect number of values where returned.
08.27.2004 RELEASE version 3.0.2
09.01.2004 FTTYS++: add a check for mmapincr and mmap to -ensure that there is at least 2880 bytes before trying to parse a -header.
09.02.2004 FITSY++: add new memory mode, SMMAP which allows -for split fits mmap files.
09.02.2004 XPA: add new support for split mmap and shared -FITS files.
09.03.2004 FITSY++: add new memory mode, SSHARE which -allows for split fits shared memory files.
09.06.2004 COMMAND: add support for split mmap and shared -FITS files.
09.01.2004 FTTYS++: add a check for mmapincr and mmap to ensure that there is at least 2880 bytes before trying to parse a header.
09.02.2004 FITSY++: add new memory mode, SMMAP which allows for split fits mmap files.
09.02.2004 XPA: add new support for split mmap and shared FITS files.
09.03.2004 FITSY++: add new memory mode, SSHARE which allows for split fits shared memory files.
09.06.2004 COMMAND: add support for split mmap and shared FITS files.
09.07.2004 XPA: update to 2.1.6

09.10.2004 RELEASE version 3.0.3

diff --git a/ds9/doc/release/r4.0.html b/ds9/doc/release/r4.0.html index 9b31b08..d191d0e 100644 --- a/ds9/doc/release/r4.0.html +++ b/ds9/doc/release/r4.0.html @@ -1,18 +1,13 @@ - - - + + + DS9 Version 4 Release Notes - -

SAOImageDS9 Version 4.0 Release Notes

+ +

SAOImageDS9 Version 4.0 Release Notes

Version 4

09.14.2004 WCSSUBS: update to version 3.5.6
09.14.2004 TCLLIB: update to version 1.6.1
09.15.2004 TKTABLE: installed 2.9
09.20.2004 SAOTK: fixed a problem with calculating a -regions rotational angle with a galactic or ecliptic wcs.
09.21.2004 SAVEFITS: fixed a problem with the savefits xpa -and command line options.
09.21.2004 REGIONS: fixed a problem with updating region -dialog boxes after a change in event file bin factor.
09.23.2004 DSS: if user selects dss2red or dss2blue survey, -force server to eso.
09.20.2004 SAOTK: fixed a problem with calculating a regions rotational angle with a galactic or ecliptic wcs.
09.21.2004 SAVEFITS: fixed a problem with the savefits xpa and command line options.
09.21.2004 REGIONS: fixed a problem with updating region dialog boxes after a change in event file bin factor.
09.23.2004 DSS: if user selects dss2red or dss2blue survey, force server to eso.
09.23.2004 2MASS: add image server.
10.01.2004 DSS: fixed a problem with 'Update from current -Frame'.
10.12.2004 MAKEFILE: add export-dynamic for linux so that -external shared libs can be loaded.
10.21.2004 GUI: fixed a problem if while blinking the user -changes the colorbar via mouse.
11.17.2004 IMAGESERVER: fixed incompatibilities between DSS -and 2MASS.
10.01.2004 DSS: fixed a problem with 'Update from current Frame'.
10.12.2004 MAKEFILE: add export-dynamic for linux so that external shared libs can be loaded.
10.21.2004 GUI: fixed a problem if while blinking the user changes the colorbar via mouse.
11.17.2004 IMAGESERVER: fixed incompatibilities between DSS and 2MASS.
11.19.2004 AST: update to version 3.5
11.29.2004 FUNTOOLS: update to version 1.2.4
11.30.2004 SAOTK: use NaN.h from Funtools. This corrects -problems with new architectures.
11.30.2004 SAOTK: use NaN.h from Funtools. This corrects problems with new architectures.
12.03.2004 MAKEFILE: now support gcc 3.4.x
12.15.2004 XPA: fixed a problem with preserve regions -command.
12.15.2004 HTML: fixed several problems with color matching -within htmlwidget.
12.16.2004 GUI: fixed a problem with saving text from -SimpleTextDialog.
12.16.2004 WCS: main wcs menu item now sets default marker -coordinate system and skyframe.
12.16.2004 COMPASS: create compass now uses current marker -dialog system and skyframe.
12.20.2004 POLYGON: fixed a problem with the exclude strip -and rotation.
12.20.2004 COMPOSITE: add support for composite -region.
12.22.2004 TEXT REGION: fixed a problem in which the text -angle did not reflect the native coordinate system.
12.29.2004 IMAGESERVER: xpa and command line options are -now synchronous. The GUI is still asynchronous.
12.30.2004 NAMESERVER: fixed a problem with sexigesmal from -SIMBAD near the equator.
12.30.2004 NAMESERVER: xpa and command line options are now -synchronous. The GUI is still asynchronous.
01.31.2005 VECTOR: add support for new VECTOR -region.
02.08.2005 REGIONS: fix varies errors with definition of -angles. Position angles are now defined as from first positive -coordinate axis to second positive coordinate axis except in the -case of equatorial wcs, in this case it is defined as from second -positive coordinate axis to first positive coordinate -axis.
02.16.2005 SCALE: added User menu options to clarify -current scaling mode.
02.17.2005 LINUX64: fixed a problem with generating -postscript.
02.28.2005 MOSAIC: add support for mosaic data -cubes.
03.01.2005 STD Dialog: fixed several problems with ds9 not -remembering the current working directory.
03.02.2005 WINDOWS: fixed a problem with a memory leak when -rendering regions on the windows platform. We no longer try to clip -against a clip region.
03.02.2005 WINDOWS: fixed a problem with command line -options that require the ds9 window to be visible. We have to -process all events with 'update' before the windows version of ds9 -is visible.
03.03.2005 REGIONS: add support to all regions parsers for -ms windows line terminators
03.03.2005 ANALYSIS: removed extra ';' at the end of all -regions substitutions.
03.16.2005 FITS: increased fits file name size to 1024 -chars.
12.15.2004 XPA: fixed a problem with preserve regions command.
12.15.2004 HTML: fixed several problems with color matching within htmlwidget.
12.16.2004 GUI: fixed a problem with saving text from SimpleTextDialog.
12.16.2004 WCS: main wcs menu item now sets default marker coordinate system and skyframe.
12.16.2004 COMPASS: create compass now uses current marker dialog system and skyframe.
12.20.2004 POLYGON: fixed a problem with the exclude strip and rotation.
12.20.2004 COMPOSITE: add support for composite region.
12.22.2004 TEXT REGION: fixed a problem in which the text angle did not reflect the native coordinate system.
12.29.2004 IMAGESERVER: xpa and command line options are now synchronous. The GUI is still asynchronous.
12.30.2004 NAMESERVER: fixed a problem with sexigesmal from SIMBAD near the equator.
12.30.2004 NAMESERVER: xpa and command line options are now synchronous. The GUI is still asynchronous.
01.31.2005 VECTOR: add support for new VECTOR region.
02.08.2005 REGIONS: fix varies errors with definition of angles. Position angles are now defined as from first positive coordinate axis to second positive coordinate axis except in the case of equatorial wcs, in this case it is defined as from second positive coordinate axis to first positive coordinate axis.
02.16.2005 SCALE: added User menu options to clarify current scaling mode.
02.17.2005 LINUX64: fixed a problem with generating postscript.
02.28.2005 MOSAIC: add support for mosaic data cubes.
03.01.2005 STD Dialog: fixed several problems with ds9 not remembering the current working directory.
03.02.2005 WINDOWS: fixed a problem with a memory leak when rendering regions on the windows platform. We no longer try to clip against a clip region.
03.02.2005 WINDOWS: fixed a problem with command line options that require the ds9 window to be visible. We have to process all events with 'update' before the windows version of ds9 is visible.
03.03.2005 REGIONS: add support to all regions parsers for ms windows line terminators
03.03.2005 ANALYSIS: removed extra ';' at the end of all regions substitutions.
03.16.2005 FITS: increased fits file name size to 1024 chars.
03.17.2005 CATALOGS: are finally implemented!
03.24.2005 WINDOWS: implemented non-windows native standard -dialogs. This allows uses to specify a file extension.
03.29.2005 FITY++: fixed a problem with filtering large bin -tables while in mmapincr mode. We now insure that enough data is -mmap'd for filter to build its good array.
03.29.2005 PRESERVE: fixed syntax errors with preserve -regions and pan.
03.30.2005 REGIONS: fixed regions parsers to accept a -regions file without terminator as the last character.
03.30.2005 ZOOM: all zooms are now specified in terms of x -and y internally
04.01.2005 GRID: fixed a problem with grid -options
04.28.2005 REGIONS: reimplemented -basemarker,baseellipse,basebox classes.
04.28.2005 ZOOM: implemented support for different x and y -zoom.
03.24.2005 WINDOWS: implemented non-windows native standard dialogs. This allows uses to specify a file extension.
03.29.2005 FITY++: fixed a problem with filtering large bin tables while in mmapincr mode. We now insure that enough data is mmap'd for filter to build its good array.
03.29.2005 PRESERVE: fixed syntax errors with preserve regions and pan.
03.30.2005 REGIONS: fixed regions parsers to accept a regions file without terminator as the last character.
03.30.2005 ZOOM: all zooms are now specified in terms of x and y internally
04.01.2005 GRID: fixed a problem with grid options
04.28.2005 REGIONS: reimplemented basemarker,baseellipse,basebox classes.
04.28.2005 ZOOM: implemented support for different x and y zoom.
04.29.2005 XPA: update to version 2.1.6
04.29.2005 FUNTOOLS: update to version 1.3.0b3
04.29.2005 TCL/TK: update to version 8.4.9
05.25.2005 REGIONS: update all regions code
05.25.2005 REGIONS: add EPANDA
06.07.2005 FUNTOOLS: update to version 1.3.0b6
06.13.2005 SCALE: new LOG algorithm -log10(i/s*1000+1)/log10(1001) where 0<i<s
06.13.2005 SCALE: new LOG algorithm log10(i/s*1000+1)/log10(1001) where 0<i<s
06.13.2005 MAKEFILE: add support for FreeBSD
06.19.2005 FTP: all ftp opens now are in passive -mode
06.19.2005 FTP: all ftp opens now are in passive mode
06.28.2005 BIN: fixed a problem with -bin factor
06.28.2005 PAGESETUP: pagesetup command line options are no -longer case sensitive
06.28.2005 PAGESETUP: pagesetup command line options are no longer case sensitive
07.12.2005 FUNTOOLS: update to version 1.3.0.b7
07.13.2005 REGIONS: new DS9 regions 4.0 format
07.13.2005 REGIONS: add copy,cut,paste,undo xpa and command -line options.
08.01.2005 GCC: add support for gcc 4.0. Remove backward -support for gcc 2.96 or earlier.
08.03.2005 REGIONS: panda,epanda,bpanda, only render -start/stop angles in red/blue when selected.
08.04.2005 SMOOTH: add smoothing algorithms -boxcar,tophat,gaussian
08.15.2005 COLORBAR: add support for printing the -colorbar
07.13.2005 REGIONS: add copy,cut,paste,undo xpa and command line options.
08.01.2005 GCC: add support for gcc 4.0. Remove backward support for gcc 2.96 or earlier.
08.03.2005 REGIONS: panda,epanda,bpanda, only render start/stop angles in red/blue when selected.
08.04.2005 SMOOTH: add smoothing algorithms boxcar,tophat,gaussian
08.15.2005 COLORBAR: add support for printing the colorbar
08.15.2005 FUNTOOLS: update to version 1.3.0b9
08.15.2005 ZLIB: update to version 1.2.3
08.17.2005 GUI: add View menu and prefs.
08.24.2005 REGIONS: fixed a problem with ciao pie -regions.
08.24.2005 REGIONS: fixed a problem with ciao pie regions.
08.24.2005 REGIONS: add invert selection.
08.25.2005 GUI: add display image window size.
08.30.2005 RELEASE version 4.0b6
09.12.2005 IIS: fixed a problem with iis and -cursors.
09.12.2005 IIS: fixed a problem with iis and cursors.
09.12.2005 RELEASE version 4.0b7
09.15.2005 ARRAY: fixed a problem with loading array cubes -from a file and determining the correct endian.
10.24.2005 BIN: if unable to find suitable cols to bin, -chose the first and second column. This way, if you have table, it -will always load, even if you don't know the column -names.
10.25.2005 BIN: binning dialog box. if number of columns is -too large to display, wrap the menu.
10.27.2005 CONTOUR: complete support for command line/xpa -control of contour features.
10.27.2005 CONTOUR: fixed a problem with convert and -contours of zero length.
11.01.2005 FITS: fixed a problem loading very small arrays -mmapincr
11.01.2005 VECTOR: small change to correct issue with gcc -4.0.1
11.01.2005 WCS: fixed a problem with wcs -append/replace.
11.02.2005 GRID: fixed a problem with alternative linear -wcs.
11.02.2005 WCS: fixed a problem with alternative wcs names. -All wcs names are now lower case.
11.03.2005 CONTOUR: fixed a problem with contour convert -after a catalog command.
11.03.2005 HELP: altered tk to pass -help to us. For -help, -we now display a brief message and exit and for --help, we display -the reference manual command line options.
11.09.2005 CATALOG: fixed a problem with starbase to trim -column names of white spaces.
11.09.2005 CATALOG: add user specified RA/DEC column -option.
09.15.2005 ARRAY: fixed a problem with loading array cubes from a file and determining the correct endian.
10.24.2005 BIN: if unable to find suitable cols to bin, chose the first and second column. This way, if you have table, it will always load, even if you don't know the column names.
10.25.2005 BIN: binning dialog box. if number of columns is too large to display, wrap the menu.
10.27.2005 CONTOUR: complete support for command line/xpa control of contour features.
10.27.2005 CONTOUR: fixed a problem with convert and contours of zero length.
11.01.2005 FITS: fixed a problem loading very small arrays mmapincr
11.01.2005 VECTOR: small change to correct issue with gcc 4.0.1
11.01.2005 WCS: fixed a problem with wcs append/replace.
11.02.2005 GRID: fixed a problem with alternative linear wcs.
11.02.2005 WCS: fixed a problem with alternative wcs names. All wcs names are now lower case.
11.03.2005 CONTOUR: fixed a problem with contour convert after a catalog command.
11.03.2005 HELP: altered tk to pass -help to us. For -help, we now display a brief message and exit and for --help, we display the reference manual command line options.
11.09.2005 CATALOG: fixed a problem with starbase to trim column names of white spaces.
11.09.2005 CATALOG: add user specified RA/DEC column option.
11.10.2005 CATALOG: speed up catreg for large dbs
11.14.2005 GUI: the meus Cut,Copy,Paste,Clear now works for -all dialog boxes on all platforms.
11.16.2005 REGIONS: fixed a problem with rendering arrows -for line,vector,ruler, and compass with width>1.
11.16.2005 GUI: Modified standard dialog boxes to remember -file types.
11.14.2005 GUI: the meus Cut,Copy,Paste,Clear now works for all dialog boxes on all platforms.
11.16.2005 REGIONS: fixed a problem with rendering arrows for line,vector,ruler, and compass with width>1.
11.16.2005 GUI: Modified standard dialog boxes to remember file types.
11.17.2005 GUI: remove 'Use Cursors' Misc Option.
11.17.2005 GUI: Modified standard dialog boxes to remember -filters.
11.18.2005 COMPOSITE: fixed a problem with loading -composite regions with properties.
12.05.2005 RGB: Fixed a problem with wcs matching rgb -frames .
12.08.2005 REGIONS: Fixed a problem general comment such as -## and #.
12.08.2005 HELP: reset previous behavior for -help. fv uses -ds9 -help to probe for ds9. Until fv is changed, we need to support -the prior behavior.
12.15.2005 X11: Insure that all X11 rendering is calculated -in double precision until the very last, at which, the results are -rounded to the nearest integer. This includes markers, contours, -grids.
12.17.2005 PS: set default resolution to 150, from -72.
12.19.2005 GUI: add .ftz and .FTZ to default fits name -filter.
11.17.2005 GUI: Modified standard dialog boxes to remember filters.
11.18.2005 COMPOSITE: fixed a problem with loading composite regions with properties.
12.05.2005 RGB: Fixed a problem with wcs matching rgb frames .
12.08.2005 REGIONS: Fixed a problem general comment such as ## and #.
12.08.2005 HELP: reset previous behavior for -help. fv uses ds9 -help to probe for ds9. Until fv is changed, we need to support the prior behavior.
12.15.2005 X11: Insure that all X11 rendering is calculated in double precision until the very last, at which, the results are rounded to the nearest integer. This includes markers, contours, grids.
12.17.2005 PS: set default resolution to 150, from 72.
12.19.2005 GUI: add .ftz and .FTZ to default fits name filter.
12.19.2005 FREEBSD: added support for freebsd.
01.03.2006 FITSY++: fixed an overflow problem with mmap -very large array files.
01.04.2006 GUI: reinstated DETECTOR and AMPLIFIER -coordinate system menu items in menus and removed the -preferences.
01.04.2006 GUI: reinstated ZMAX menu items in -menus.
01.05.2006 CATALOGS: fixed a problem with rotated or -flipped images and determining image size in ra and dec
01.05.2006 PROJECTION: fixed a problem move and -moveto.
01.03.2006 FITSY++: fixed an overflow problem with mmap very large array files.
01.04.2006 GUI: reinstated DETECTOR and AMPLIFIER coordinate system menu items in menus and removed the preferences.
01.04.2006 GUI: reinstated ZMAX menu items in menus.
01.05.2006 CATALOGS: fixed a problem with rotated or flipped images and determining image size in ra and dec
01.05.2006 PROJECTION: fixed a problem move and moveto.
01.12.2006 COLORBAR: added numerics to colorbar.
01.18.2006 GUI: separte controls for min/max and -low/high.
01.24.2006 HISTOGRAM EQU: is now based on low/high, not -min/max.
01.27.2006 GUI: fixed a problem with updating the current -colormap.
01.30.2006 PANNER: under truecolor visuals, the panner is -now updated with the colorbar.
02.01.2006 TEMPLATE: tweak xmm templates for correct -boresite.
01.18.2006 GUI: separte controls for min/max and low/high.
01.24.2006 HISTOGRAM EQU: is now based on low/high, not min/max.
01.27.2006 GUI: fixed a problem with updating the current colormap.
01.30.2006 PANNER: under truecolor visuals, the panner is now updated with the colorbar.
02.01.2006 TEMPLATE: tweak xmm templates for correct boresite.
02.03.2006 GUI: fixed Shift-Tab under linux.
02.03.2006 GUI: fixed a problem with loading multiple -files, with -single command line option, followed by Match Frame. -The frames where not realized so the coordinate systems where not -valid.
02.03.2006 MARKERS: added the ability to toggle marker -text.
02.03.2006 GUI: fixed a problem with loading multiple files, with -single command line option, followed by Match Frame. The frames where not realized so the coordinate systems where not valid.
02.03.2006 MARKERS: added the ability to toggle marker text.
02.08.2006 RELEASE version 4.0b8
02.07.2006 TCL/TK: update to version 8.4.12
02.08.2006 CROSSHAIR: fix a typo that caused the crosshair -command-line option to fail.
02.27.2006 CATALOG: fixed a problem with finding which -columns contain RA and DEC.
02.27.2006 XPA: fixed a problem with xpaget ds9 -width.
02.08.2006 CROSSHAIR: fix a typo that caused the crosshair command-line option to fail.
02.27.2006 CATALOG: fixed a problem with finding which columns contain RA and DEC.
02.27.2006 XPA: fixed a problem with xpaget ds9 width.
03.20.2006 DSS: add new survey options for STSCI.
03.24.2006 i18n: finished implemenation of -internationalization and localization code.
03.29.2006 SCALE: fixed a problem with RGB frames and -log/pow scales. Incorrect low/high values were being used to -calculate the scale.
03.29.2006 PREFS: the default prefs file is now ds9.prf. -The following directories are now searched in order: ./ ~ -/usr/local/lib /opt/local/lib
03.29.2006 INITALIZATION: the default initalization file is -now ds9.ini. The following directories are now searched in order: -./ ~ /usr/local/lib /opt/local/lib
03.31.2006 GUI: fixed a problem with several dialog boxes -with the Paste menu option. If the clipboard was empty, an error -was generated.
04.3.2006 FITS HEADER: fixed a problem displaying datacube -headers.
04.3.2006 PROJECTION REGION: Projection region plots can -now be accessed via XPA PLOT
04.5.2006 MACOSX: fix a problem with the macosx startup -scripts to allow path names with a space.
04.7.2006 WCS: fix a problem WCS menu and images without a -wcs.
04.10.2006 GRID: fixed a problem with GLACTIC wcs, AST, -WCSSUBS, and defined LATPOLE/LONPOLE keywords.
03.24.2006 i18n: finished implemenation of internationalization and localization code.
03.29.2006 SCALE: fixed a problem with RGB frames and log/pow scales. Incorrect low/high values were being used to calculate the scale.
03.29.2006 PREFS: the default prefs file is now ds9.prf. The following directories are now searched in order: ./ ~ /usr/local/lib /opt/local/lib
03.29.2006 INITALIZATION: the default initalization file is now ds9.ini. The following directories are now searched in order: ./ ~ /usr/local/lib /opt/local/lib
03.31.2006 GUI: fixed a problem with several dialog boxes with the Paste menu option. If the clipboard was empty, an error was generated.
04.3.2006 FITS HEADER: fixed a problem displaying datacube headers.
04.3.2006 PROJECTION REGION: Projection region plots can now be accessed via XPA PLOT
04.5.2006 MACOSX: fix a problem with the macosx startup scripts to allow path names with a space.
04.7.2006 WCS: fix a problem WCS menu and images without a wcs.
04.10.2006 GRID: fixed a problem with GLACTIC wcs, AST, WCSSUBS, and defined LATPOLE/LONPOLE keywords.
04.15.2006 RELEASE version 4.0b9
04.18.2006 CATALOGS: fixed a problem with filter editor -menu.
04.18.2006 CATALOGS: fixed a problem with searching for -other catalogs
04.24.2006 TEMP: DS9 will now look for environment vars -TEMP and TMP first for location of temp directory.
04.28.2006 PREFS: Fixed a problem with writing invalid -preferences.
04.28.2006 PS: Fixed a problem with printing Grayscale and -pure white values. They were being rounded off to 254, not -255.
04.28.2006 PREFS: prefs are now written to a users home -directory if available (including windows) and hidden.
05.02.2006 GCC: now compiles properly under gcc -4.1
05.08.2006 SCALE: more checks for illegal low/high values -for log/pow scales
05.10.2006 BIN: fix an issue with calculated width/height. -No matter the bin factor, or the dimensions of the data, always -have at least an 1x1 image.
05.11.2006 DARWIN: compile under 10.4.x with no -OSSPINLOCKLOCK, which is not available under 10.3.x
05.16.2006 CROSSHAIR: fixed a problem with xpa/cmd option -crosshair.
05.16.2006 ANALYSIS: fixed a problem with loading analysis -files with bindings at startup with one frame.
04.18.2006 CATALOGS: fixed a problem with filter editor menu.
04.18.2006 CATALOGS: fixed a problem with searching for other catalogs
04.24.2006 TEMP: DS9 will now look for environment vars TEMP and TMP first for location of temp directory.
04.28.2006 PREFS: Fixed a problem with writing invalid preferences.
04.28.2006 PS: Fixed a problem with printing Grayscale and pure white values. They were being rounded off to 254, not 255.
04.28.2006 PREFS: prefs are now written to a users home directory if available (including windows) and hidden.
05.02.2006 GCC: now compiles properly under gcc 4.1
05.08.2006 SCALE: more checks for illegal low/high values for log/pow scales
05.10.2006 BIN: fix an issue with calculated width/height. No matter the bin factor, or the dimensions of the data, always have at least an 1x1 image.
05.11.2006 DARWIN: compile under 10.4.x with no OSSPINLOCKLOCK, which is not available under 10.3.x
05.16.2006 CROSSHAIR: fixed a problem with xpa/cmd option crosshair.
05.16.2006 ANALYSIS: fixed a problem with loading analysis files with bindings at startup with one frame.
05.22.2006 WCSSUBS: Update to version 3.6.4
05.25.2006 ANALYSIS: add $xcen and $ycen macros.
05.25.2006 ANALYSIS: add $vo_method macro.
06.05.2006 FITSY++: fixed a problem with incorrectly -detecting the beginning sequence of gz stream.
06.12.2006 HV/XPA: Implemented 'xpaset' mime -support.
06.14.2006 FITS: Fixed a problem with displaying the header -of a file in which there was an extention name in the primary -header.
06.21.2006 GUI: Fixed a problem -single and -blink command -line optons.
06.21.2006 REGIONS: Check for valid image loaded before -processing load regions commands.
06.21.2006 MOSAIC: fixed a problem with mosaicimage wfpc2 -and display header.
06.05.2006 FITSY++: fixed a problem with incorrectly detecting the beginning sequence of gz stream.
06.12.2006 HV/XPA: Implemented 'xpaset' mime support.
06.14.2006 FITS: Fixed a problem with displaying the header of a file in which there was an extention name in the primary header.
06.21.2006 GUI: Fixed a problem -single and -blink command line optons.
06.21.2006 REGIONS: Check for valid image loaded before processing load regions commands.
06.21.2006 MOSAIC: fixed a problem with mosaicimage wfpc2 and display header.
06.23.2006 HV: Implemented file caching.
06.23.2006 HV: Implemented image caching.
06.26.2006 HV: Implemented multiple mime -processing.
06.26.2006 HV: Implemented multiple mime processing.
06.29.2006 TCLLIB: update to version 1.8
07.11.2006 WCSSUBS: update to version 3.6.5
07.11.2006 WCSSUBS: fix a problem with naxis>2
07.12.2006 NAME SERVER: support for HTTP -redirection
07.12.2006 IMAGE SERVER: support for HTTP -redirection
07.12.2006 NAME SERVER: support for HTTP redirection
07.12.2006 IMAGE SERVER: support for HTTP redirection
07.13.2006 CATALOGS: support for HTTP redirection
07.13.2006 REGIONS: fixed a problem with cut/copy/paste -regions dialog.
07.25.2006 PREFS: preferences are automatically -saved.
07.25.2006 FITSY++: fixed a problem with large RGB arrays -and streams.
07.31.2006 RGB: add support for invert RGB -colormap.
07.31.2006 FIRST: add support for VLA FIRST image -server.
08.01.2006 HTTP: add timeout options to all geturl -calls.
07.13.2006 REGIONS: fixed a problem with cut/copy/paste regions dialog.
07.25.2006 PREFS: preferences are automatically saved.
07.25.2006 FITSY++: fixed a problem with large RGB arrays and streams.
07.31.2006 RGB: add support for invert RGB colormap.
07.31.2006 FIRST: add support for VLA FIRST image server.
08.01.2006 HTTP: add timeout options to all geturl calls.
08.02.2006 CATALOGS: add suppport for SDSS.
08.07.2006 ANALYSIS: fixed a problem with cancel geturl -tasks.
08.14.2006 TKTABLE: fixed configure files for darwin -intel.
08.14.2006 TKIMG: fixed configure files for darwin -intel.
08.14.2006 AST: apply patch to plot.c at line -23207
08.17.2006 BIN: fixed a problem with binning 3D and integer -cols.
08.17.2006 BIN: fixed a problem with binning 3D and -updating the bin dialog box.
08.17.2006 SCALE: changed AUTO to sample only for -mosaics.
08.30.2006 CATALOG: fixed a problem with filtering and -column names to leading or trailing spaces.
08.31.2006 CATALOG: add support for CSV catalog files -with/wo header.
09.06.2006 EPANDA: Fixed problems with rendering start and -stop angles.
09.08.2006 BPANDA: Fixed problems with rendering start and -stop angles.
09.11.2006 TEMPLATES: When creating templates, they were -placed in the upper right corner of the frame. This has been -changed to the center of the frame.
09.11.2006 TEMPLATES: When templates where created via the -gui, the screen was not refreshed properly. This has been -corrected.
09.12.2006 FITSY++: Fixed a problem with hist() and column -values of 0, which was used as the default value.
08.07.2006 ANALYSIS: fixed a problem with cancel geturl tasks.
08.14.2006 TKTABLE: fixed configure files for darwin intel.
08.14.2006 TKIMG: fixed configure files for darwin intel.
08.14.2006 AST: apply patch to plot.c at line 23207
08.17.2006 BIN: fixed a problem with binning 3D and integer cols.
08.17.2006 BIN: fixed a problem with binning 3D and updating the bin dialog box.
08.17.2006 SCALE: changed AUTO to sample only for mosaics.
08.30.2006 CATALOG: fixed a problem with filtering and column names to leading or trailing spaces.
08.31.2006 CATALOG: add support for CSV catalog files with/wo header.
09.06.2006 EPANDA: Fixed problems with rendering start and stop angles.
09.08.2006 BPANDA: Fixed problems with rendering start and stop angles.
09.11.2006 TEMPLATES: When creating templates, they were placed in the upper right corner of the frame. This has been changed to the center of the frame.
09.11.2006 TEMPLATES: When templates where created via the gui, the screen was not refreshed properly. This has been corrected.
09.12.2006 FITSY++: Fixed a problem with hist() and column values of 0, which was used as the default value.
09.13.2006 COMPOSITE: Add complement angle.
09.15.2006 CPANDA,EPANDA,BPANDA: fixed a conflict with -funtools. Stop/start angles will alway increase in value.
09.15.2006 CPANDA,EPANDA,BPANDA: fixed a conflict with funtools. Stop/start angles will alway increase in value.
09.18.2006 MOSAIC IMAGE NEXT: removed support.
10.01.2006 RELEASE version 4.0b10
10.01.2006 I18N: Add Portuguese support.
10.01.2006 RELEASE version 4.0b10.1
10.01.2006 FITS: external support for bzip2.
10.01.2006 REGIONS: fixed a problem with clipping regions -in tile mode.
10.03.2006 HV: add support for HTTP-EQUIV HTML Meta -keyword.
10.03.2006 PANDA: fixed a problem with zero length radius -and printing.
10.01.2006 REGIONS: fixed a problem with clipping regions in tile mode.
10.03.2006 HV: add support for HTTP-EQUIV HTML Meta keyword.
10.03.2006 PANDA: fixed a problem with zero length radius and printing.
10.10.2006 WCSSUBS: update to version 3.6.6
10.13.2006 TCL/TK: update to version 8.4.13
10.13.2006 FUNTOOLS: update to version 1.3.0b22
10.13.2006 TCLLIB: update to version 1.9
10.23.2006 LANGUAGE: add support for following languages -fr,es,de,it,pt,ru,da.
10.23.2006 LANGUAGE: add support for following languages fr,es,de,it,pt,ru,da.
10.23.2006 HTTP: increase timeout to 3 minutes.
10.24.2006 GUI: add view colorbar numerics -support.
10.31.2006 CATALOGS: add full symbol support via -xpa/command line.
10.31.2006 CATALOGS: fixed a problem with the optional -catalog name as a parameter.
10.31.2006 GUI: multi column frame and active frame -menu.
10.31.2006 GUI: multi column catalog col name -menus.
10.24.2006 GUI: add view colorbar numerics support.
10.31.2006 CATALOGS: add full symbol support via xpa/command line.
10.31.2006 CATALOGS: fixed a problem with the optional catalog name as a parameter.
10.31.2006 GUI: multi column frame and active frame menu.
10.31.2006 GUI: multi column catalog col name menus.
11.02.2006 XPA: add xpaget ds9 fits bitpix.
11.06.2006 GUI: add confirmation option -preference.
11.28.2006 REGIONS: add xpa/command line option get -info.
11.28.2006 REGIONS: fits regions file: first look for -extension [REGIONS], then attempt to load the first -extension.
11.29.2006 FITS: fixed a overflow problem with very very -large fits images > 8Gb in size.
12.06.2006 RGB: fixed a problem with aligning very large -images.
12.07.2006 MOSAIC: fixed a problem with wcs mosaicsa and -very large images.
12.09.2006 FITS: removed a kludge for defining the wcs -tangent point that only affected AIR and AZP -projections.
12.12.2006 GUI: fixed a problem with default vertical -layout. The default size is now consistent with other -options.
12.13.2006 SAVEAS: fixed a problem with PHYSICAL and WCS -coordinates. They were 1 pixel off.
12.13.2006 CPANDA/EPANDA: fixed a problem with render and -printing with an image flipped.
12.20.2006 RGB: NaN are now ignored when building an RGB -image.
12.22.2006 GUI: Increased default X size so that buttons do -not cause automatic resizing.
01.08.2007 PREFS: fixed a problem with frame parser and -LoadPrefs so that a preferences file from version b9 will correctly -parse.
01.23.2007 FITS: Added additional checks for valid format -and values for DATASEC, DETSEC, and DETSIZE keywords.
01.24.2007 CATALOGS: fixed a problem with -redirect.
01.24.2007 REGIONS: fixed a problem measuring WCS lengths -across wcs mosacis and RGB images.
01.25.2007 REGIONS: fixed a problem with rotated text -regions.
01.30.2007 DSS: Split DSS server into three -servers.
01.31.2007 GUI: add binning buffersize 8192 and binfactor -256.
11.06.2006 GUI: add confirmation option preference.
11.28.2006 REGIONS: add xpa/command line option get info.
11.28.2006 REGIONS: fits regions file: first look for extension [REGIONS], then attempt to load the first extension.
11.29.2006 FITS: fixed a overflow problem with very very large fits images > 8Gb in size.
12.06.2006 RGB: fixed a problem with aligning very large images.
12.07.2006 MOSAIC: fixed a problem with wcs mosaicsa and very large images.
12.09.2006 FITS: removed a kludge for defining the wcs tangent point that only affected AIR and AZP projections.
12.12.2006 GUI: fixed a problem with default vertical layout. The default size is now consistent with other options.
12.13.2006 SAVEAS: fixed a problem with PHYSICAL and WCS coordinates. They were 1 pixel off.
12.13.2006 CPANDA/EPANDA: fixed a problem with render and printing with an image flipped.
12.20.2006 RGB: NaN are now ignored when building an RGB image.
12.22.2006 GUI: Increased default X size so that buttons do not cause automatic resizing.
01.08.2007 PREFS: fixed a problem with frame parser and LoadPrefs so that a preferences file from version b9 will correctly parse.
01.23.2007 FITS: Added additional checks for valid format and values for DATASEC, DETSEC, and DETSIZE keywords.
01.24.2007 CATALOGS: fixed a problem with redirect.
01.24.2007 REGIONS: fixed a problem measuring WCS lengths across wcs mosacis and RGB images.
01.25.2007 REGIONS: fixed a problem with rotated text regions.
01.30.2007 DSS: Split DSS server into three servers.
01.31.2007 GUI: add binning buffersize 8192 and binfactor 256.
02.01.2007 RELEASE version 4.0b11
02.02.2007 CATALOGS: add cols.
02.02.2007 VO: default url is now -http://cxc.harvard.edu/chandraed/list.txt.
02.07.2007 PREFERENCES: if ds9 detects a newer prefs file, -it will not be processed.
02.09.2007 SKYVIEW: added support for HEASARC's skyview -image cutout service.
02.09.2007 GUI: dropped the 'b' for beta, afterall, ds9 is -always beta!
02.13.2007 CATALOGS: new non-modal search catalogs -support.
02.02.2007 VO: default url is now http://cxc.harvard.edu/chandraed/list.txt.
02.07.2007 PREFERENCES: if ds9 detects a newer prefs file, it will not be processed.
02.09.2007 SKYVIEW: added support for HEASARC's skyview image cutout service.
02.09.2007 GUI: dropped the 'b' for beta, afterall, ds9 is always beta!
02.13.2007 CATALOGS: new non-modal search catalogs support.
02.13.2007 CATALOGS: add show/hide support.
02.15.2007 FIRST: fixed a problem with xpa -first.
02.15.2007 2MASS: fixed a problem with xpa -2mass.
02.15.2007 FIRST: fixed a problem with xpa first.
02.15.2007 2MASS: fixed a problem with xpa 2mass.
03.06.2007 MASK: add support for fits masks.
03.06.2007 MOSAIC: remove support for 'fast mosaic' -mode.
03.06.2007 SCALE: added support for zscale parameter -prefs.
03.20.2007 FITSY++: add support for compressed -FITS.
03.27.2007 WCS: fixed support for alt wcs for bin -tables.
03.29.2007 REGIONS: add support for user specified point -sizes
04.02.2007 GRID: fixed a problem with TNX -projection.
04.03.2007 FITSY++: split code supporting FITS ASCII tables -and FITS Binary Tables.
04.03.2007 FITSY++: removed code supporting FITS Binary -Tables substring arrays.
03.06.2007 MOSAIC: remove support for 'fast mosaic' mode.
03.06.2007 SCALE: added support for zscale parameter prefs.
03.20.2007 FITSY++: add support for compressed FITS.
03.27.2007 WCS: fixed support for alt wcs for bin tables.
03.29.2007 REGIONS: add support for user specified point sizes
04.02.2007 GRID: fixed a problem with TNX projection.
04.03.2007 FITSY++: split code supporting FITS ASCII tables and FITS Binary Tables.
04.03.2007 FITSY++: removed code supporting FITS Binary Tables substring arrays.
04.03.2007 WCSSUBS: update to version 3.6.8
04.03.2007 FUNTOOLS: update to version 1.3.0b30
04.03.2007 XPA: update to version 2.1.7b2
04.06.2007 FITSY++: add support for RICE compressed -FITS.
04.06.2007 SMOOTH: now implemented on a per channel basis -for RGB.
04.10.2007 WCSSUBS: backed out of wcscon.c to version 3.6.6 -due to a bug in prec.
04.12.2007 WINDOWS: fixed a problem with iis and -iraf.
04.06.2007 FITSY++: add support for RICE compressed FITS.
04.06.2007 SMOOTH: now implemented on a per channel basis for RGB.
04.10.2007 WCSSUBS: backed out of wcscon.c to version 3.6.6 due to a bug in prec.
04.12.2007 WINDOWS: fixed a problem with iis and iraf.
04.15.2007 RELEASE version 4.12
04.16.2007 FITSIMAGE: fixed an bug with setting file names -after a reset.
04.16.2007 FITSIMAGE: fixed an bug with setting file names after a reset.
04.26.2007 ESO-DSS: support new survey names.
05.10.2007 NSVR: fixed a problem with xpa/command line name -lookup.
05.10.2007 NSVR: fixed a problem with xpa/command line name lookup.
05.10.2007 NSVR: fixed a problem redirection.
05.11.2007 TCL: realize ds9 before executing any external -tcl source.
05.11.2007 CATALOGS: for csv files, ignore any comment -lines.
05.21.2007 MOSAICS: fixed several problems with -constructing mosaics from both IRAF and WCS keywords.
05.21.2007 IRAF MOSAICS: the image size is now defined by -the actual data (just as with WCS) and not the DETSIZE -keyword.
05.30.2007 GRID: fixed a problem with plain font style that -resulted in always using system and not the selected -font.
05.31.2007 ELLIPSE PANDA: fixed a problem incorrect -postscript code.
06.08.2007 GUI: fixed a problem with the Display Fits -Header button.
06.13.2007 FITS: add fits header command and xpa -point.
06.30.2007 RULER: fixed a problem with displaying the -length text.
05.11.2007 TCL: realize ds9 before executing any external tcl source.
05.11.2007 CATALOGS: for csv files, ignore any comment lines.
05.21.2007 MOSAICS: fixed several problems with constructing mosaics from both IRAF and WCS keywords.
05.21.2007 IRAF MOSAICS: the image size is now defined by the actual data (just as with WCS) and not the DETSIZE keyword.
05.30.2007 GRID: fixed a problem with plain font style that resulted in always using system and not the selected font.
05.31.2007 ELLIPSE PANDA: fixed a problem incorrect postscript code.
06.08.2007 GUI: fixed a problem with the Display Fits Header button.
06.13.2007 FITS: add fits header command and xpa point.
06.30.2007 RULER: fixed a problem with displaying the length text.
07.15.2007 RELEASE version 4.13

diff --git a/ds9/doc/release/r5.0.html b/ds9/doc/release/r5.0.html index e7eeab3..c6ff35d 100644 --- a/ds9/doc/release/r5.0.html +++ b/ds9/doc/release/r5.0.html @@ -1,602 +1,321 @@ - - - + + + DS9 Version 5 Release Notes - -

SAOImageDS9 Version 5 Release Notes

+ +

SAOImageDS9 Version 5 Release Notes

07.16.2007 FITSY++: fix a problem with rice compressed -images and multiple tiles.
07.17.2007 MOSAIC: fix a problem with bin table extensions -at the end of a mosaic image wcs.
07.20.2007 COLORMAP: fixed a problem with loading external -colormaps.
07.20.2007 COLORMAP: fixed a problem colormap -menus.
07.16.2007 FITSY++: fix a problem with rice compressed images and multiple tiles.
07.17.2007 MOSAIC: fix a problem with bin table extensions at the end of a mosaic image wcs.
07.20.2007 COLORMAP: fixed a problem with loading external colormaps.
07.20.2007 COLORMAP: fixed a problem colormap menus.
07.23.2007 ARCHIVES: new url for skyview.
07.23.2007 I18N: add language support for Japanese. (many -thanks to Masahiro Tsujimoto!).
07.23.2007 PIXEL TABLE: xpaget will now return the pixel -table values.
07.23.2007 I18N: add language support for Japanese. (many thanks to Masahiro Tsujimoto!).
07.23.2007 PIXEL TABLE: xpaget will now return the pixel table values.
07.31.2007 SOLARISx86: now supporting solarisx86.
08.15.2007 PIXELTABLE: fixed a minor problem with xpaget -pixeltable.
08.15.2007 PIXELTABLE: fixed a minor problem with xpaget pixeltable.
08.15.2007 FUNTOOLS: update to version 1.4.0
08.15.2007 IIS: fixed a problem with frame number greater -than 10.
08.15.2007 EXAMINE: changed frame name to -'Frame'.
09.02.2007 CATALOGS: updated urls and menu -titles.
08.15.2007 IIS: fixed a problem with frame number greater than 10.
08.15.2007 EXAMINE: changed frame name to 'Frame'.
09.02.2007 CATALOGS: updated urls and menu titles.
09.20.2007 PREFS: new prefs dialog box.
09.24.2007 CATALOGS: fixed a problem with the CDS -query.
09.24.2007 CATALOGS: fixed a problem with the CDS query.
09.24.2007 CATALOGS: add SDSS DR6.
09.24.2007 SKYVIEW: fixed default image size and updated -url.
09.24.2007 PROJECTION: install callbacks only after Button -Release.
09.25.2007 REGIONS: add xpa/command SHOW and SHOWTEXT -support.
09.25.2007 CONTOURS: fixed a problem with load contours -from the command line.
10.03.2007 MACOSX: MacOSX Aqua support is now fully -implemented!
10.03.2007 COLORMAP: pass colormap names thru translation -tables
09.24.2007 SKYVIEW: fixed default image size and updated url.
09.24.2007 PROJECTION: install callbacks only after Button Release.
09.25.2007 REGIONS: add xpa/command SHOW and SHOWTEXT support.
09.25.2007 CONTOURS: fixed a problem with load contours from the command line.
10.03.2007 MACOSX: MacOSX Aqua support is now fully implemented!
10.03.2007 COLORMAP: pass colormap names thru translation tables
10.03.2007 XPA: update to version 2.1.8
10.05.2007 COMPOSITE: add global properties -switch.
10.05.2007 LINE: fixed a problem with initial displayed -arrow checkboxes in dialog.
10.05.2007 FOV: moved FOV menu to more visible -level
10.05.2007 COMPOSITE: add global properties switch.
10.05.2007 LINE: fixed a problem with initial displayed arrow checkboxes in dialog.
10.05.2007 FOV: moved FOV menu to more visible level
10.10.2007 I18N: add language support for French.
10.11.2007 CATALOGS: fixed a problem with the symbol editor -dialog.
10.11.2007 CATALOGS: fixed a problem with the symbol editor dialog.
10.15.2007 RELEASE version 5.0
10.16.2007 PROJECTION: fixed a problem with the coordinates -of the projection plot.
10.17.2007 RICE: fixed a problem with float and double RICE -compression.
10.24.2007 RICE: fixed several problems with mosaics, cubes -and RICE compression.
10.24.2007 GUI: added support for ds9 beta -versions.
10.24.2007 PREFS: added OK and Cancel buttons to all -tabs.
10.29.2007 CATALOGS: implemented support for new CDS -catalogs search format.
10.16.2007 PROJECTION: fixed a problem with the coordinates of the projection plot.
10.17.2007 RICE: fixed a problem with float and double RICE compression.
10.24.2007 RICE: fixed several problems with mosaics, cubes and RICE compression.
10.24.2007 GUI: added support for ds9 beta versions.
10.24.2007 PREFS: added OK and Cancel buttons to all tabs.
10.29.2007 CATALOGS: implemented support for new CDS catalogs search format.
10.30.2007 SAOTK: implemented reentrant parsers.
11.01.2007 SAOTK: now support any color for markers, -contours, etc.
11.02.2007 MACOSX/WINDOWS: fixed a problem with native open -file dialog. If bad file name had been used, (or an extention), an -error would occur.
11.01.2007 SAOTK: now support any color for markers, contours, etc.
11.02.2007 MACOSX/WINDOWS: fixed a problem with native open file dialog. If bad file name had been used, (or an extention), an error would occur.
11.07.2007 TCL/TK: update to version 8.4.16.
11.08.2007 PLOT: fixed a problem with xpa/command line -linear/line tokens to match documentation.
11.09.2007 PREFERENCES: fixed a problem with slower ppcs. -use 'update idletasks' instead of 'update' to avoid possible race -condition.
11.08.2007 PLOT: fixed a problem with xpa/command line linear/line tokens to match documentation.
11.09.2007 PREFERENCES: fixed a problem with slower ppcs. use 'update idletasks' instead of 'update' to avoid possible race condition.
11.21.2007 XPA: update to version 2.1.9
11.21.2007 FUNTOOLS: update to version 1.4.1
11.21.2007 WCSSUBS: update to version 3.7.0
11.21.2007 TCLLIBS: update to version 1.10
11.28.2007 TCL/TK: update to version 8.4.17 beta.
11.28.2007 ANALYSIS: fix a problem with spaces in tmp file -names.
11.28.2007 ANALYSIS: fix a problem with spaces in tmp file names.
12.05.2007 FLEXLEXER.Y: updated version.
12.06.2007 GUI: change key binding 'c' to 'r'. It conflicts -with 'copy' on MacOSX and Windows platforms.
12.06.2007 REGIONS: fixed a problem with pasteing regions -into an empty frame.
12.18.2007 ZIP: fixed a problem with the unix -Makefile.
12.06.2007 GUI: change key binding 'c' to 'r'. It conflicts with 'copy' on MacOSX and Windows platforms.
12.06.2007 REGIONS: fixed a problem with pasteing regions into an empty frame.
12.18.2007 ZIP: fixed a problem with the unix Makefile.
12.18.2007 FUNTOOLS: update to version 1.4.2.
12.18.2007 2MASS: limit size to 1024 arcsec.
12.21.2007 FITSY++: add support for HCOMPRESS compressed -FITS.
12.28.2007 FITSY++: add support for GZIP compressed -FITS.
01.03.2008 FITSY++: add support for PLIO compressed -FITS.
01.04.2008 GUI: fixed a problem with X11 servers that -return truecolor 32 bit when in fact the visual is truecolor -24bit.
12.21.2007 FITSY++: add support for HCOMPRESS compressed FITS.
12.28.2007 FITSY++: add support for GZIP compressed FITS.
01.03.2008 FITSY++: add support for PLIO compressed FITS.
01.04.2008 GUI: fixed a problem with X11 servers that return truecolor 32 bit when in fact the visual is truecolor 24bit.
01.15.2008 RELEASE version 5.1
01.17.2008 ANALYSIS: add the directory of any loaded -analysis file to the PATH.
01.22.2008 REGIONS: fixed a problem introduced with -reentrant parsers. Sexagesimal values between -00 and +00 were -incorrectly parsed as +00.
01.23.2008 REGIONS: fixed a problem with parsing HMS/DMS -coordinates.
01.24.2008 GUI: fixed a problem shift rotate -mode.
01.24.2008 GUI: info panel 'Frame' width set to -+4.
01.17.2008 ANALYSIS: add the directory of any loaded analysis file to the PATH.
01.22.2008 REGIONS: fixed a problem introduced with reentrant parsers. Sexagesimal values between -00 and +00 were incorrectly parsed as +00.
01.23.2008 REGIONS: fixed a problem with parsing HMS/DMS coordinates.
01.24.2008 GUI: fixed a problem shift rotate mode.
01.24.2008 GUI: info panel 'Frame' width set to +4.
01.24.2008 GUI: add new goto frame menu.
01.24.2008 GUI: add support for move frames.
01.24.2008 ANALYSIS: for MacOSX tiger, wrap cmds with shell -and PATH.
01.25.2008 CATALOGS: make sure xpa and command line -retrieves are syncronous.
01.28.2008 CONTOUR: fixed a problem with loading contour -levels into multiple frames.
01.31.2008 WINDOWS: changed how windows come into -focus.
01.24.2008 ANALYSIS: for MacOSX tiger, wrap cmds with shell and PATH.
01.25.2008 CATALOGS: make sure xpa and command line retrieves are syncronous.
01.28.2008 CONTOUR: fixed a problem with loading contour levels into multiple frames.
01.31.2008 WINDOWS: changed how windows come into focus.
01.31.2008 TCL/TK: update to version 8.4.17.
02.07.2008 GUI: change default directory for standard -dialog to $HOME.
02.07.2008 ANALYSIS: add /sw/bin to default path for -MacOSX.
02.20.2008 CATALOGS: add support for editing a catalog -table and regions.
02.20.2008 TEXT: add enable rotation switch for text -regions.
02.20.2008 GUI: ds9 will now start in the users home -directory for MacOSX Aqua users when invoked from a double click -and the default dialog box is Motif or Windows.
02.07.2008 GUI: change default directory for standard dialog to $HOME.
02.07.2008 ANALYSIS: add /sw/bin to default path for MacOSX.
02.20.2008 CATALOGS: add support for editing a catalog table and regions.
02.20.2008 TEXT: add enable rotation switch for text regions.
02.20.2008 GUI: ds9 will now start in the users home directory for MacOSX Aqua users when invoked from a double click and the default dialog box is Motif or Windows.
02.20.2008 TCL/TK: update to version 8.4.18.
02.26.2008 IIS: disable most keystroke and mouse events for -iis frames.
02.28.2008 FITSY++: fixed a problem with save fits and -smoothed images.
02.29.2008 WCS: fixed a problem with calculating the size -and center of complex fits images in WCS.
03.05.2008 GUI: backed out change key binding 'c' to 'r'. -It causes untold grief with IRAF.
03.10.2008 MACOSX: fixed a problem with printing non -standard colors.
03.10.2008 CATALOGS: catalog dialogs are now tied to the -frame. This allows multiple copies of the same catalog, one per -frame.
03.12.2008 GRID: added support for PC001001 formated WCS -keywords.
03.13.2008 IIS: make sure socket is closed on -exec.
03.13.2008 WINDOWS: add support for native -printing.
03.18.2008 CROSSHAIR: fix a problem with the line width for -postscript.
02.26.2008 IIS: disable most keystroke and mouse events for iis frames.
02.28.2008 FITSY++: fixed a problem with save fits and smoothed images.
02.29.2008 WCS: fixed a problem with calculating the size and center of complex fits images in WCS.
03.05.2008 GUI: backed out change key binding 'c' to 'r'. It causes untold grief with IRAF.
03.10.2008 MACOSX: fixed a problem with printing non standard colors.
03.10.2008 CATALOGS: catalog dialogs are now tied to the frame. This allows multiple copies of the same catalog, one per frame.
03.12.2008 GRID: added support for PC001001 formated WCS keywords.
03.13.2008 IIS: make sure socket is closed on exec.
03.13.2008 WINDOWS: add support for native printing.
03.18.2008 CROSSHAIR: fix a problem with the line width for postscript.
03.18.2008 MACOSX: restore postscript printing.
03.18.2008 WINDOWS: restore postscript printing.
03.19.2008 GUI: enhancements with Find/FindNext in text -dialog windows.
03.19.2008 GUI: enhancements with Find/FindNext in text dialog windows.
03.19.2008 GUI: add console support.
03.24.2008 REGIONS: apply WCS to fits regions if -present.
03.25.2008 PREFS: fixed a problem with Zoom menu -preferences.
03.31.2008 GUI: add support for user configured button -bar.
03.24.2008 REGIONS: apply WCS to fits regions if present.
03.25.2008 PREFS: fixed a problem with Zoom menu preferences.
03.31.2008 GUI: add support for user configured button bar.
04.03.2008 CATALOGS: add support for simbad.
04.04.2008 MASKS: fixed a problem with mask color -preference.
04.07.2008 IMEXAMINE: added support for key stroke -events.
04.04.2008 MASKS: fixed a problem with mask color preference.
04.07.2008 IMEXAMINE: added support for key stroke events.
04.15.2008 RELEASE version 5.2
04.18.2008 REGIONS: added support for centroid.
04.21.2008 GUI: fixed a problem with 'c' and -control-c.
04.21.2008 IIS: fixed a problem key events. Now all key -events are active until IIS is in cursor mode. At this point all -key events are passed to IRAF except for 'TAB'.
04.23.2008 MACOSX: split the binary and archive into two -files, and codesign the binary, so that it will play well with -leopard's new firewall.
04.25.2008 FITSY++: fixed a proble with mapincr. If seek_ -is at end of file, mmap will not return an error.
04.28.2008 GUI: delete all frames resets the frame counter -(broken in 5.2).
06.02.2008 GCC: remove all references to "iostream.h" and -use "iostream" instead.
04.21.2008 GUI: fixed a problem with 'c' and control-c.
04.21.2008 IIS: fixed a problem key events. Now all key events are active until IIS is in cursor mode. At this point all key events are passed to IRAF except for 'TAB'.
04.23.2008 MACOSX: split the binary and archive into two files, and codesign the binary, so that it will play well with leopard's new firewall.
04.25.2008 FITSY++: fixed a proble with mapincr. If seek_ is at end of file, mmap will not return an error.
04.28.2008 GUI: delete all frames resets the frame counter (broken in 5.2).
06.02.2008 GCC: remove all references to "iostream.h" and use "iostream" instead.
06.02.2008 GCC: support for gcc 4.2.
06.02.2008 GUI: fix typo in bin.tcl menus.
06.03.2008 FITSY++: changes to processing the header where -ds9 will now work with illegal fits files that contains NULLs -instead of SPACEs.
06.03.2008 RICE: implemented compatibility with cfitsio -3.08.
06.04.2008 GZIP: implemented compatibility with cfitsio -3.08.
06.04.2008 HCOMPRESS: implemented compatibility with -cfitsio 3.08.
06.05.2008 IIS: disable scale menu with iis frame (fixed -from version 5.2).
06.05.2008 REGIONS: fixed FITS regions polygon support. Now -determine how many points based on the repeat value of the column, -but check for .
06.06.2008 FITS: for saveimage fits, if non-linear WCS, -don't attempt to save WCS.
06.06.2008 BLINK: add xpa/command line option -blink -interval.
06.03.2008 FITSY++: changes to processing the header where ds9 will now work with illegal fits files that contains NULLs instead of SPACEs.
06.03.2008 RICE: implemented compatibility with cfitsio 3.08.
06.04.2008 GZIP: implemented compatibility with cfitsio 3.08.
06.04.2008 HCOMPRESS: implemented compatibility with cfitsio 3.08.
06.05.2008 IIS: disable scale menu with iis frame (fixed from version 5.2).
06.05.2008 REGIONS: fixed FITS regions polygon support. Now determine how many points based on the repeat value of the column, but check for .
06.06.2008 FITS: for saveimage fits, if non-linear WCS, don't attempt to save WCS.
06.06.2008 BLINK: add xpa/command line option -blink interval.
06.06.2008 REGIONS: add for DASH property.
07.11.2008 REGIONS: fixed a problem with the 'delete all' -button.
07.16.2008 XPA: if CHECKDNS fails, set XPA_METHOD to local -and initialize.
07.21.2008 PROJECTION: minor change to ensure that we step -over the grid in 1 pixel values.
07.24.2008 IIS: add support for all 16 IIS -colors.
07.25.2008 BINNING: fixed a problem with smooth and 3d -binning.
08.04.2008 FITSY++: fixed a problem with BSCALE/BZERO and -float/double data types.
08.11.2008 CATALOGS: fixed a problem with catalogs -retrieved via a cds search. The id returned would fail during -evaluation in creating a valid header.
07.11.2008 REGIONS: fixed a problem with the 'delete all' button.
07.16.2008 XPA: if CHECKDNS fails, set XPA_METHOD to local and initialize.
07.21.2008 PROJECTION: minor change to ensure that we step over the grid in 1 pixel values.
07.24.2008 IIS: add support for all 16 IIS colors.
07.25.2008 BINNING: fixed a problem with smooth and 3d binning.
08.04.2008 FITSY++: fixed a problem with BSCALE/BZERO and float/double data types.
08.11.2008 CATALOGS: fixed a problem with catalogs retrieved via a cds search. The id returned would fail during evaluation in creating a valid header.
08.11.2008 CATALOGS: add CMC to catalog menu.
08.11.2008 GUI: fixed a problem with the initial directory -for the standard dialog when loading from the command -line.
08.14.2008 VECTOR: vast improvements in -optimization.
08.19.2008 GUI: catch a failure to initialize window system -(a problem with X11) and exit nice.
08.19.2008 MACOSX: fixed the window tab problem for Aqua -port.
08.19.2008 MACOSX: fixed canvas background -issues.
08.11.2008 GUI: fixed a problem with the initial directory for the standard dialog when loading from the command line.
08.14.2008 VECTOR: vast improvements in optimization.
08.19.2008 GUI: catch a failure to initialize window system (a problem with X11) and exit nice.
08.19.2008 MACOSX: fixed the window tab problem for Aqua port.
08.19.2008 MACOSX: fixed canvas background issues.
08.20.2008 GUI: Add buttons to vertical layout.
09.10.2008 XPA: fixed a problem with blink interval < -1.
09.12.2008 PREFS: add 'Preserve During Load' for scale, -pan, and regions.
09.10.2008 XPA: fixed a problem with blink interval < 1.
09.12.2008 PREFS: add 'Preserve During Load' for scale, pan, and regions.
09.12.2008 CONTOUR: add dash line option.
09.17.2008 PANNER: check to see if we are at -pole.
09.17.2008 PANNER: check to see if we are at pole.
09.17.2008 CATALOGS: add copy from row(s).
09.17.2008 REGIONS: look for new FITS POLYGON termination -conditions
09.22.2008 COLORBAR: removed truecolor colorbar options. -Always paint the entire image.
09.25.2008 BINNING: automatically look for x,y then ra,dec, -before settling for columns 1 and 2.
09.25.2008 IMEXAM: added 'any' event (returns with a mouse -event or key event).
10.02.2008 CATALOGS: fixed a problem with size format for -SIMBAD and NED. Degrees and ArcSecs were incorrectly -calculated.
09.17.2008 REGIONS: look for new FITS POLYGON termination conditions
09.22.2008 COLORBAR: removed truecolor colorbar options. Always paint the entire image.
09.25.2008 BINNING: automatically look for x,y then ra,dec, before settling for columns 1 and 2.
09.25.2008 IMEXAM: added 'any' event (returns with a mouse event or key event).
10.02.2008 CATALOGS: fixed a problem with size format for SIMBAD and NED. Degrees and ArcSecs were incorrectly calculated.
10.03.2008 CATALOGS: Add support for CXC catalog.
10.08.2008 MACOSX: add MacOSX X11 10.5 firewall -port.
10.08.2008 MACOSX: add MacOSX X11 10.5 firewall port.
10.10.2008 FOV: add sao/binospec.
10.15.2008 RELEASE version 5.3
10.17.2008 CATALOGS: removed support for Chandra Source -Catalog at request of Ian Evans of CXC.
10.22.2008 MASKS: add support for mask -transparency.
10.17.2008 CATALOGS: removed support for Chandra Source Catalog at request of Ian Evans of CXC.
10.22.2008 MASKS: add support for mask transparency.
10.24.2008 MASKS: add new mask properties.
10.28.2008 GRID: add grid title support.
10.31.2008 RELEASE version 5.4
10.31.2008 GRID: full grid support for command line and -xpa.
11.04.2008 FITSY: fixed a problem with header keywords that -start with 'END'.
11.13.2008 FITSY: fixed a problem when there was a failure -to correctly parse iraf or wcs keywords.
12.02.2008 FITS: for saveimage fits, fixed a problem with -LTMV,DTMV, and WCS coordinates. They were off by 1 pixel in -x.
12.02.2008 GUI: fixed a problem with panning via click and -drag.
12.04.2008 MPEG: changed makefiles to compile tkmpeg code -without optiminzation. -O created invalid code for MacOSX (and -possible others)
12.04.2008 REGIONS: fixed a problem when creating a default -panda region via a mouse click.
12.05.2008 POSTSCRIPT: fixed a problem with printing frames -that have no image loaded.
12.05.2008 CATALOGS: fixed a problem with using the arrow -keys in catalog dialogs.
12.10.2008 REGIONS: fixed a problem elongated rotated -ellipses.
12.10.2008 MACOSX: fixed several problems with processing -AppleEvents OpenDocument and PrintDocument. DS9 now supports -opendoc and printdoc while currently running.
12.12.2008 IIS: re-enabled mouse events while in cursor -mode.
12.12.2008 IIS: trap arrow keys while in cursor mode, do -not pass to IRAF, instead warp cursor.
12.15.2008 SMOOTH: ignore NAN in smoothing -convolution.
12.16.2008 GUI: fixed a problem with 'get fits size' to -make it behave in the regions of poles.
12.29.2008 IIS: try to decode OBJECT from -iisMessageCmd.
12.29.2008 IIS: if frame is in cursor mode (via the imexam -task), RESET FRAME, will attempt to clean up.
10.31.2008 GRID: full grid support for command line and xpa.
11.04.2008 FITSY: fixed a problem with header keywords that start with 'END'.
11.13.2008 FITSY: fixed a problem when there was a failure to correctly parse iraf or wcs keywords.
12.02.2008 FITS: for saveimage fits, fixed a problem with LTMV,DTMV, and WCS coordinates. They were off by 1 pixel in x.
12.02.2008 GUI: fixed a problem with panning via click and drag.
12.04.2008 MPEG: changed makefiles to compile tkmpeg code without optiminzation. -O created invalid code for MacOSX (and possible others)
12.04.2008 REGIONS: fixed a problem when creating a default panda region via a mouse click.
12.05.2008 POSTSCRIPT: fixed a problem with printing frames that have no image loaded.
12.05.2008 CATALOGS: fixed a problem with using the arrow keys in catalog dialogs.
12.10.2008 REGIONS: fixed a problem elongated rotated ellipses.
12.10.2008 MACOSX: fixed several problems with processing AppleEvents OpenDocument and PrintDocument. DS9 now supports opendoc and printdoc while currently running.
12.12.2008 IIS: re-enabled mouse events while in cursor mode.
12.12.2008 IIS: trap arrow keys while in cursor mode, do not pass to IRAF, instead warp cursor.
12.15.2008 SMOOTH: ignore NAN in smoothing convolution.
12.16.2008 GUI: fixed a problem with 'get fits size' to make it behave in the regions of poles.
12.29.2008 IIS: try to decode OBJECT from iisMessageCmd.
12.29.2008 IIS: if frame is in cursor mode (via the imexam task), RESET FRAME, will attempt to clean up.
01.05.2009 FUNTOOLS: update to version 1.4.2.2
01.05.2009 WCSSUBS: update to version 3.7.6
01.05.2009 GUI: add support for loading FITS multiple -extension as multiple frames.
01.05.2009 EXAMINE: fixed many problems. Will work not work -with data loaded via stdin or xpa fits.
01.15.2009 SMOOOTH: fixed a problem with BZERO and BSCALE. -These keywords are reset to default values if present in the -smoothed image, since the scaling has already been -applied.
01.15.2009 FILTER: fixed an issue when unable to build a -valid filter. Previously, it would exit() the program. Now, it will -issue an error message and continue.
01.16.2009 MACOSX: if using the X11 port of MacOSX, -increase the size of the window to make room for the size tab, -similar for Aqua.
01.05.2009 GUI: add support for loading FITS multiple extension as multiple frames.
01.05.2009 EXAMINE: fixed many problems. Will work not work with data loaded via stdin or xpa fits.
01.15.2009 SMOOOTH: fixed a problem with BZERO and BSCALE. These keywords are reset to default values if present in the smoothed image, since the scaling has already been applied.
01.15.2009 FILTER: fixed an issue when unable to build a valid filter. Previously, it would exit() the program. Now, it will issue an error message and continue.
01.16.2009 MACOSX: if using the X11 port of MacOSX, increase the size of the window to make room for the size tab, similar for Aqua.
01.16.2009 SAVEAS: PNG now saves without GAMMA.
01.20.2009 GUI: Rearrange Frame menu and Region menu. They -had grown too long and some window managers were having -difficulties.
01.21.2009 REGIONS: fixed a problem rendering Bezier -curves.
01.20.2009 GUI: Rearrange Frame menu and Region menu. They had grown too long and some window managers were having difficulties.
01.21.2009 REGIONS: fixed a problem rendering Bezier curves.
01.23.2009 RELEASE version 5.5
01.28.2009 RELEASE version 5.5.1
01.28.2009 GUI: fixed a problem in that the last file name -loaded is incorrectly set if there are command line options that -follow the file name.
02.02.2009 CATALOGS: updated urls for cds -mirrors.
02.03.2009 CATALOGS: cleaned up tsv code. Will read comma -and tab separted values, and will write tab separated values. -Assumes first row is cols header unless first and second cols are -numbers, then assumes ra, dec, in fk5 degrees.
02.04.2009 PSEUDOCOLOR: fixed a problem with the frame not -remembering its current colormap bias and contrast setting when -toggling between frames.
02.10.2009 BLT: fixed a problem zoombox under Aqua. XOR -draws are now disabled.
02.11.2009 CIAO: The ciao regions parser will now accept -compound region descriptions.
02.12.2009 CONTOURS: fixed a problem with command line/xpa -dashed line parameter. Processing the -contour command is now a lot -more robust in determining missing parameters.
02.16.2009 HISTOGRAM EQU: fixed a problem with clipping low -= clipping high (usually as a result of ZSCALE).
02.19.2009 FITSY++: fixed a problem specifying an extension -number of 0 with a multiple extension file with no primary image. -It now properly fails to load.
02.19.2009 GUI: FITS multiple extension multiple frame will -now load a primary image if present.
02.19.2009 GUI: compressed FITS multiple extension multiple -frame will now load properly.
02.19.2009 GUI: FITS multiple extension multiple frame will -ignore any bin table extensions.
02.19.2009 BLT: add support for MacOSX native -printing.
02.19.2009 PLOT: native printing now fully supported for -MacOSX and Windows.
02.24.2009 SAMP: add support for VO Simple Application -Messaging Protocol (SAMP). Will process image.load.fits and -table.load.votable events.
02.25.2009 FITSY++: fixed a problem with saving a slice of -a cube. The header had invalid keywords.
01.28.2009 GUI: fixed a problem in that the last file name loaded is incorrectly set if there are command line options that follow the file name.
02.02.2009 CATALOGS: updated urls for cds mirrors.
02.03.2009 CATALOGS: cleaned up tsv code. Will read comma and tab separted values, and will write tab separated values. Assumes first row is cols header unless first and second cols are numbers, then assumes ra, dec, in fk5 degrees.
02.04.2009 PSEUDOCOLOR: fixed a problem with the frame not remembering its current colormap bias and contrast setting when toggling between frames.
02.10.2009 BLT: fixed a problem zoombox under Aqua. XOR draws are now disabled.
02.11.2009 CIAO: The ciao regions parser will now accept compound region descriptions.
02.12.2009 CONTOURS: fixed a problem with command line/xpa dashed line parameter. Processing the -contour command is now a lot more robust in determining missing parameters.
02.16.2009 HISTOGRAM EQU: fixed a problem with clipping low = clipping high (usually as a result of ZSCALE).
02.19.2009 FITSY++: fixed a problem specifying an extension number of 0 with a multiple extension file with no primary image. It now properly fails to load.
02.19.2009 GUI: FITS multiple extension multiple frame will now load a primary image if present.
02.19.2009 GUI: compressed FITS multiple extension multiple frame will now load properly.
02.19.2009 GUI: FITS multiple extension multiple frame will ignore any bin table extensions.
02.19.2009 BLT: add support for MacOSX native printing.
02.19.2009 PLOT: native printing now fully supported for MacOSX and Windows.
02.24.2009 SAMP: add support for VO Simple Application Messaging Protocol (SAMP). Will process image.load.fits and table.load.votable events.
02.25.2009 FITSY++: fixed a problem with saving a slice of a cube. The header had invalid keywords.
02.27.2009 CATALOGS: support VOTable format.
03.02.2009 MacOSX: support for the MacOSX X11 Leopard 10.5 -non-firewall version has been discontinued.
03.02.2009 MacOSX: fixed a problem with plot y axis titles -offset.
03.02.2009 MacOSX: fixed a problem fork/exec and version -10.5 New version of tclMacNotify.c now used.
03.02.2009 MacOSX: support for the MacOSX X11 Leopard 10.5 non-firewall version has been discontinued.
03.02.2009 MacOSX: fixed a problem with plot y axis titles offset.
03.02.2009 MacOSX: fixed a problem fork/exec and version 10.5 New version of tclMacNotify.c now used.
03.09.2009 FUNTOOLS: updated to version 1.4.3.
03.10.2009 REGIONS: fixed a problem with listing irregular -panda, ellipse panda, and box panda in ds9/funtools format. The -conjunction has been removed.
03.12.2009 GUI: If in tile mode, with only one frame, and -tile mode is set to manual, tile anyway (don't drop into single -mode).
03.12.2009 CATALOGS: speed up rendering of catalogs for -simple symbol filters.
03.12.2009 REGIONS: support wildcards in -filename.
03.12.2009 REGIONS: add support for load into all -frames.
03.17.2009 GUI: Name server support now utilizies CDS -Sesame.
03.17.2009 SKYVIEW: fixed a problem processing the survey -query.
03.10.2009 REGIONS: fixed a problem with listing irregular panda, ellipse panda, and box panda in ds9/funtools format. The conjunction has been removed.
03.12.2009 GUI: If in tile mode, with only one frame, and tile mode is set to manual, tile anyway (don't drop into single mode).
03.12.2009 CATALOGS: speed up rendering of catalogs for simple symbol filters.
03.12.2009 REGIONS: support wildcards in filename.
03.12.2009 REGIONS: add support for load into all frames.
03.17.2009 GUI: Name server support now utilizies CDS Sesame.
03.17.2009 SKYVIEW: fixed a problem processing the survey query.
03.18.2009 HV: add support for cookies.
03.18.2009 ARCHIVES: add support for NVO Montage.
03.18.2009 REGIONS: fixed a problem calculating the WCS -angle of a flipped WCS.
03.18.2009 HV: add support for mime-type text/xml for -votable.
03.18.2009 REGIONS: fixed a problem calculating the WCS angle of a flipped WCS.
03.18.2009 HV: add support for mime-type text/xml for votable.
03.19.2009 CATALOGS: CDS now uses VOTABLE.
03.24.2009 CATALOGS: SIMBAD now uses VOTABLE.
03.24.2009 CATALOGS: NED now uses VOTABLE.
03.24.2009 CATALOGS: add preferences to download in VOTABLE -if available.
04.01.2009 GUI: when you delete a frame, the current frame -is reset to the previous frame, not the first frame.
04.06.2009 RULER: use preferences default distance -system.
04.06.2009 GUI: fixed a problem with open other -url.
04.09.2009 PROJECTION: properly calculate width when -rebinning.
03.24.2009 CATALOGS: add preferences to download in VOTABLE if available.
04.01.2009 GUI: when you delete a frame, the current frame is reset to the previous frame, not the first frame.
04.06.2009 RULER: use preferences default distance system.
04.06.2009 GUI: fixed a problem with open other url.
04.09.2009 PROJECTION: properly calculate width when rebinning.
04.15.2009 RELEASE version 5.6
04.16.2009 REGIONS: fixed a rather nasty bug which caused a -segv when switching between modes after copy a region from a -frame.
04.16.2009 REGIONS: fixed a rather nasty bug which caused a segv when switching between modes after copy a region from a frame.
04.16.2009 RELEASE version 5.6.1
04.17.2009 SAMP: use xmlrpc url method in POST -header.
04.17.2009 CATALOGS: fixed a typo in the default SDSSR5 -query.
04.20.2009 HV: fixed a problem with parsing query linked to -a button.
04.17.2009 SAMP: use xmlrpc url method in POST header.
04.17.2009 CATALOGS: fixed a typo in the default SDSSR5 query.
04.20.2009 HV: fixed a problem with parsing query linked to a button.
04.20.2009 RELEASE version 5.6.2
04.22.2009 PREFS: updated the default name server -menu.
04.24.2009 FIRST: removed a debug statement which was left -in.
04.27.2009 REGIONS: fixed a problem loading a fits file -with specified extension.
04.28.2009 HV: fixed again a problem with parsing url -within a link with a query which contains a '?'.
04.22.2009 PREFS: updated the default name server menu.
04.24.2009 FIRST: removed a debug statement which was left in.
04.27.2009 REGIONS: fixed a problem loading a fits file with specified extension.
04.28.2009 HV: fixed again a problem with parsing url within a link with a query which contains a '?'.
04.30.2009 RELEASE version 5.6.3
05.01.2009 REGIONS: fixed a problem creating a text region -with arcsec or arcmin char.
05.01.2009 NAMESRVR: fixed a problem with simbad cfa -sexagesimal.
05.01.2009 CATALOGS: fixed a problem with quoting a VOTABLE -FIELD DESCRIPTION string.
05.01.2009 CATALOGS: add column parameters in header -output.
05.04.2009 SAMP: fixed a problem with select row -list.
05.04.2009 REGIONS: add list to xpa and command line -regions option.
05.01.2009 REGIONS: fixed a problem creating a text region with arcsec or arcmin char.
05.01.2009 NAMESRVR: fixed a problem with simbad cfa sexagesimal.
05.01.2009 CATALOGS: fixed a problem with quoting a VOTABLE FIELD DESCRIPTION string.
05.01.2009 CATALOGS: add column parameters in header output.
05.04.2009 SAMP: fixed a problem with select row list.
05.04.2009 REGIONS: add list to xpa and command line regions option.
05.21.2009 NVSS: add NVSS Image server back.
05.26.2009 NAMESRVR: set default name server to -cds.
05.26.2009 CATALOGS: set default catalog erver to -cds.
05.26.2009 SAMP: fixed a proble with quoting filenames and -urls for xml.
05.26.2009 CATALOGS: will now try to determine the RA and -DEC cols via the UCD if available.
05.26.2009 GUI: fixed a problem with standard dialog boxes -and MacOSX Aqua and Windows. The dialogbox would sometimes fail to -rise to top.
05.27.2009 GUI: WCS menu correctly updates print coordinate -parameters.
05.27.2009 REGIONS: autocentroid now works for move, edit, -and rotate.
05.27.2009 CATALOGS: CDS Search now retrieves search -options from cds.
05.27.2009 CATALOGS: fixed a problem with FILTER and -VOTable. The votable cols params were not being properly transfered -to the new filtered table.
06.10.2009 REGIONS: DS9 regions syntax now supported in -VOTable format.
06.11.2009 CATALOGS: "No Items Found" is now displayed on -status line and not as a model dialog.
06.11.2009 REGIONS: fixed problem with dashed lines with -rotated ellipses.
06.11.2009 GUI: fixed problem with standard file dialog -boxes. Now, command line options and xpa command DOES NOT CHANGE -the current directory. Only the use of the dialog box will reset -the current directory.
05.26.2009 NAMESRVR: set default name server to cds.
05.26.2009 CATALOGS: set default catalog erver to cds.
05.26.2009 SAMP: fixed a proble with quoting filenames and urls for xml.
05.26.2009 CATALOGS: will now try to determine the RA and DEC cols via the UCD if available.
05.26.2009 GUI: fixed a problem with standard dialog boxes and MacOSX Aqua and Windows. The dialogbox would sometimes fail to rise to top.
05.27.2009 GUI: WCS menu correctly updates print coordinate parameters.
05.27.2009 REGIONS: autocentroid now works for move, edit, and rotate.
05.27.2009 CATALOGS: CDS Search now retrieves search options from cds.
05.27.2009 CATALOGS: fixed a problem with FILTER and VOTable. The votable cols params were not being properly transfered to the new filtered table.
06.10.2009 REGIONS: DS9 regions syntax now supported in VOTable format.
06.11.2009 CATALOGS: "No Items Found" is now displayed on status line and not as a model dialog.
06.11.2009 REGIONS: fixed problem with dashed lines with rotated ellipses.
06.11.2009 GUI: fixed problem with standard file dialog boxes. Now, command line options and xpa command DOES NOT CHANGE the current directory. Only the use of the dialog box will reset the current directory.
06.11.2009 SAMP: don't send empty catalogs.
06.11.2009 CATALOGS: don't write empty catalogs.
06.11.2009 FILTER: fixed a problem with parsing filters on -the command line that contain quotes.
06.16.2009 SAMP: the samp port number is now automatically -determined at connection time.
06.17.2009 CATALOGS: for VOTables, change id to -ID.
06.11.2009 FILTER: fixed a problem with parsing filters on the command line that contain quotes.
06.16.2009 SAMP: the samp port number is now automatically determined at connection time.
06.17.2009 CATALOGS: for VOTables, change id to ID.
06.17.2009 CATALOGS: Add ID param to CXC catalog.
06.17.2009 SAMP: send unique catalog table-id for each -catalog so tha multiple copies of ds9 with the same catalog loaded -don't walk all over each other when connected to a hub.
06.18.2009 REGIONS: Update info box, graphs, and pixel -table when draging in pointer and catalog mode.
06.18.2009 GUI: clean up code which enables/disables WCS -menus based on current frame.
06.19.2009 HV: add support for arrow keys and mouse -wheel.
06.17.2009 SAMP: send unique catalog table-id for each catalog so tha multiple copies of ds9 with the same catalog loaded don't walk all over each other when connected to a hub.
06.18.2009 REGIONS: Update info box, graphs, and pixel table when draging in pointer and catalog mode.
06.18.2009 GUI: clean up code which enables/disables WCS menus based on current frame.
06.19.2009 HV: add support for arrow keys and mouse wheel.
06.19.2009 HV: add support for copy key shortcut.
06.19.2009 HV: add support for Return key shortcut for -Submit.
06.25.2009 GUI: update crosshair, infobox, pixeltable when -changing current slice in crosshair mode.
06.25.2009 REGIONS: fixed a problem with create/load/save -regions with mosaic. The WCS of the first mosaic segment loaded is -used for all regions.
06.30.2009 REGIONS: removed listwcs option for ds9 -format.
06.30.2009 IIS: disabled annoying 'port/addr already in -use' error message.
07.06.2009 BINNING: add update button to bin -dialog.
07.06.2009 HV: add enhancements to allow complete control -over a web browser window.
07.06.2009 VO: add enhancements to allow complete control -over the vo dialog.
07.09.2009 XPA: 'page setup' has been renamed -pagesetup.
06.19.2009 HV: add support for Return key shortcut for Submit.
06.25.2009 GUI: update crosshair, infobox, pixeltable when changing current slice in crosshair mode.
06.25.2009 REGIONS: fixed a problem with create/load/save regions with mosaic. The WCS of the first mosaic segment loaded is used for all regions.
06.30.2009 REGIONS: removed listwcs option for ds9 format.
06.30.2009 IIS: disabled annoying 'port/addr already in use' error message.
07.06.2009 BINNING: add update button to bin dialog.
07.06.2009 HV: add enhancements to allow complete control over a web browser window.
07.06.2009 VO: add enhancements to allow complete control over the vo dialog.
07.09.2009 XPA: 'page setup' has been renamed pagesetup.
07.15.2009 HV: support for sync http added.
07.15.2009 VO: support for sync http added.
07.15.2009 ANALYSIS: support for sync http added.
07.15.2009 ANALYSIS: analysis tasks invoked via xpa or -command line are now run in blocking (sync) mode.
07.16.2009 XPA: added optional param to xpaget array to -specify the endianness.
07.15.2009 ANALYSIS: analysis tasks invoked via xpa or command line are now run in blocking (sync) mode.
07.16.2009 XPA: added optional param to xpaget array to specify the endianness.
08.05.2009 XPA: add sleep command.
08.05.2009 GUI: add sleep command line option.
08.10.2009 GUI: fixed command line option -commands.
08.10.2009 CATALOGS: for CDS catalogs, ignore the UCD at -first and look for _RAJ2000 and _DEJ2000, then the UCD, then a list -of common names.
08.11.2009 GUI: update Magnifier in Pan mode and key -arrows.
08.12.2009 WINDOWS: Add support for wildcard filename -expansion if invoked from DOS shell.
08.12.2009 REGIONS: Add support for load template at ra dec -skyframe.
08.20.2009 MOSAIC: default for loading mosaics is now WCS -not IRAF.
08.25.2009 SAMP: implemented full XPA capabilities via -SAMP.
08.25.2009 I18N: make changes to fitsy++ lexer to allow -non-single byte chars in filenames and paths.
08.26.2009 SAMP: fixed a problem with parsing the -hub.xmlrup.url.
08.10.2009 GUI: fixed command line option commands.
08.10.2009 CATALOGS: for CDS catalogs, ignore the UCD at first and look for _RAJ2000 and _DEJ2000, then the UCD, then a list of common names.
08.11.2009 GUI: update Magnifier in Pan mode and key arrows.
08.12.2009 WINDOWS: Add support for wildcard filename expansion if invoked from DOS shell.
08.12.2009 REGIONS: Add support for load template at ra dec skyframe.
08.20.2009 MOSAIC: default for loading mosaics is now WCS not IRAF.
08.25.2009 SAMP: implemented full XPA capabilities via SAMP.
08.25.2009 I18N: make changes to fitsy++ lexer to allow non-single byte chars in filenames and paths.
08.26.2009 SAMP: fixed a problem with parsing the hub.xmlrup.url.
08.26.2009 XPA: update to version 2.1.10.
08.27.2009 FUNTOOLS: update to version 1.4.4.
09.01.2009 SAMP: fixed a problem with extra key value pairs -in message.
09.01.2009 SAMP: fixed a problem with extra key value pairs in message.
09.01.2009 CATALOGS: add default samp command.
09.01.2009 CATALOGS: removed modal dialog info box calls. -Messages are now updated in the status windows.
09.01.2009 GUI: added new level of menu updates that are -only executed when a frame is create or deleted and not everytime -there is a change of state.
09.03.2009 WINDOWS: disable menu updates during blinking -because windows redraws the menu window each time the configuration -is changed.
09.03.2009 SOLARIS: removed support for Solaris<9.0. DS9 -now requires libxml2 be supported by the OS.
09.03.2009 GUI: added signal handling for non-windows. We -now trap SIGINT and clean up before exiting.
09.08.2009 I18N: fixed a problem with spaces in -filename.
09.08.2009 SAMP: fixed a problem using a hub that uses the -Apache xmlrpc library.
09.10.2009 SAMP: fixed a problem with invalid ds9.get -commands.
09.10.2009 GUI: cmap xpa, samp, and command line option is -now much more tolerant to capitalization and spellings.
09.10.2009 WINDOWS: tcc is now used for the bin filter -compiler. cygwin is no longer required.
09.21.2009 MACOSX: ports to Tiger (10.4), Leopard (10.5), -and Snow Leopard (10.6) are now built under 10.6
09.22.2009 MACOSX: fixed a problem with snowleopard. For -32bit visuals, the alpha channel is set to 0xff, not 0.
09.28.2009 XPA: add XPA connect/disconnect menu -options.
09.29.2009 RGB: fixed a problem with displaying images with -NAN.
10.02.2009 MACOSX: pcc is now used for the bin filter -compiler of i386 platforms if XCode is not -installed./tt>
10.09.2009 ANALYSIS: fixed a problem with analysis plot -command to maintain backward compatibility./tt>
10.12.2009 SMOOTH: fixed a problem that smooth is reset -when no image is loaded. /tt>
09.01.2009 CATALOGS: removed modal dialog info box calls. Messages are now updated in the status windows.
09.01.2009 GUI: added new level of menu updates that are only executed when a frame is create or deleted and not everytime there is a change of state.
09.03.2009 WINDOWS: disable menu updates during blinking because windows redraws the menu window each time the configuration is changed.
09.03.2009 SOLARIS: removed support for Solaris<9.0. DS9 now requires libxml2 be supported by the OS.
09.03.2009 GUI: added signal handling for non-windows. We now trap SIGINT and clean up before exiting.
09.08.2009 I18N: fixed a problem with spaces in filename.
09.08.2009 SAMP: fixed a problem using a hub that uses the Apache xmlrpc library.
09.10.2009 SAMP: fixed a problem with invalid ds9.get commands.
09.10.2009 GUI: cmap xpa, samp, and command line option is now much more tolerant to capitalization and spellings.
09.10.2009 WINDOWS: tcc is now used for the bin filter compiler. cygwin is no longer required.
09.21.2009 MACOSX: ports to Tiger (10.4), Leopard (10.5), and Snow Leopard (10.6) are now built under 10.6
09.22.2009 MACOSX: fixed a problem with snowleopard. For 32bit visuals, the alpha channel is set to 0xff, not 0.
09.28.2009 XPA: add XPA connect/disconnect menu options.
09.29.2009 RGB: fixed a problem with displaying images with NAN.
10.02.2009 MACOSX: pcc is now used for the bin filter compiler of i386 platforms if XCode is not installed./tt>
10.09.2009 ANALYSIS: fixed a problem with analysis plot command to maintain backward compatibility./tt>
10.12.2009 SMOOTH: fixed a problem that smooth is reset when no image is loaded. /tt>
10.15.2009 RELEASE version 5.7

diff --git a/ds9/doc/release/r6.0.html b/ds9/doc/release/r6.0.html index 864fd2a..ec11395 100644 --- a/ds9/doc/release/r6.0.html +++ b/ds9/doc/release/r6.0.html @@ -1,347 +1,168 @@ - - - + + + DS9 Version 6 Release Notes - -

SAOImageDS9 Version 6 Release Notes

+ +

SAOImageDS9 Version 6 Release Notes

10.20.2009 XPA: moved processing xpa command line options -to first pass, and init xpa earlier in startup, so that vo and web -click can be processed along with regular command line -options.
10.24.2009 UPDATE: fixed a problem with trying to provide -support for backward compatibility.
10.24.2009 IMGSVR: fixed a problem with trying to provide -support for backward compatibility
10.20.2009 XPA: moved processing xpa command line options to first pass, and init xpa earlier in startup, so that vo and web click can be processed along with regular command line options.
10.24.2009 UPDATE: fixed a problem with trying to provide support for backward compatibility.
10.24.2009 IMGSVR: fixed a problem with trying to provide support for backward compatibility
10.24.2009 GUI: sleep command arg is now optional
10.24.2009 MOSAIC: IRAF mosaics are now layed out based on -the first segment load, like WCS mosaics
10.27.2009 GUI: fixed a problem if you delete all frames, -some of the load commands (such as -rgbcube) are not executed until -there is a new frame. Now, if there are no frames, the load command -will create a new frame if needed
10.28.2009 REGION: Corrected a problem with creating -templates from a VAR. Uncommented old syntax which has been -superceeded
11.02.2009 GRID: fixed a problem with 'grid numlab -gap2'
10.24.2009 MOSAIC: IRAF mosaics are now layed out based on the first segment load, like WCS mosaics
10.27.2009 GUI: fixed a problem if you delete all frames, some of the load commands (such as -rgbcube) are not executed until there is a new frame. Now, if there are no frames, the load command will create a new frame if needed
10.28.2009 REGION: Corrected a problem with creating templates from a VAR. Uncommented old syntax which has been superceeded
11.02.2009 GRID: fixed a problem with 'grid numlab gap2'
11.02.2009 AST: updated to version 5.3-1
11.05.2009 TILE: corrected documentation for '-tile grid -layout', should be column #, row #
11.05.2009 DATACUBE: fixed a problem with '-wcs -replace|reset|append'. The result WCS is now applied to all -slices
11.05.2009 XPA: fixed a problem with 'xpaset wcs replace -foo.wcs'
11.05.2009 TILE: corrected documentation for '-tile grid layout', should be column #, row #
11.05.2009 DATACUBE: fixed a problem with '-wcs replace|reset|append'. The result WCS is now applied to all slices
11.05.2009 XPA: fixed a problem with 'xpaset wcs replace foo.wcs'
11.13.2009 RICE: updated to cfitsio 3210/tt>
11.16.2009 COMPRESS: fixed a problem with compression that -extends over a page boundry of 1Gb
11.30.2009 GRID: fixed a problem with exterior numerics and -zoomed images
11.16.2009 COMPRESS: fixed a problem with compression that extends over a page boundry of 1Gb
11.30.2009 GRID: fixed a problem with exterior numerics and zoomed images
11.30.2009 HELP: combine FAQ and ISSUES pages
12.04.2009 RGB: aux contour overlays are now displayed on a -per channel basis
12.07.2009 RGB: rgb images with data cubes can now set the -current slice on a per channel basis
12.07.2009 VO: fixed a problem with xpa -keep-alive
12.10.2009 TK: fixed a problem MacOSX X11 standard file -dialog boxes. Borrowed code from tk8.5 to correct the problem when -events are added to X11
12.10.2009 GUI: fixed a problem with modal dialogs when the -user closed the window via the window manager and not the OK/CANCEL -button
12.04.2009 RGB: aux contour overlays are now displayed on a per channel basis
12.07.2009 RGB: rgb images with data cubes can now set the current slice on a per channel basis
12.07.2009 VO: fixed a problem with xpa keep-alive
12.10.2009 TK: fixed a problem MacOSX X11 standard file dialog boxes. Borrowed code from tk8.5 to correct the problem when events are added to X11
12.10.2009 GUI: fixed a problem with modal dialogs when the user closed the window via the window manager and not the OK/CANCEL button
12.10.2009 XPA: update to version 2.1.11
12.14.2009 RGB: fixed a problem with a incorrect WCS -compass in the panner image
12.15.2009 WCS: Documented the old ALIGN command and -updated for XPA and SAMP
12.15.2009 GUI: Values accepted for SKYFORMAT expanded to -'deg', 'degree', and 'degrees' for command line options, XPA, and -SAMP
12.17.2009 WCS: added code to test for bad WCS alignment -issues (mainly from CAR projection, or pole problems)
12.17.2009 WCS: added code for WCS alignment for CAR. If -CAR, getWCScrpix() is taken from center of image, and not from -CRPIX keywords
12.18.2009 CATALOG: added USNO UCAC3 to the Optical -list
12.24.2009 DATACUBE: DS9 now supports FITS images up to 10 -dimensions. Happy Holidays!
12.28.2009 ANALYSIS: fixed problems with $data and $url and -spaces in the tmp directory path name
12.28.2009 COMM: fixed problems with spaces in file names -received as argumetns via SAMP and http
12.29.2009 REGION: fixed problems with XPA/SAMP and --format/-system/-sky options
12.29.2009 GUI: fixed a problem with hiding the current -frame
12.30.2009 HV: at EXIT, close all opened HV windows so that -tmp files may be deleted
12.30.2009 HV: fixed a problem for MIME type -'multipart/mixed', a tmp file was not deleted
12.30.2009 HV: fixed a problem for MIME type 'text/plain', -a tmp file was not deleted
12.30.2009 ANALYSIS: add $filedialog(open) and -$filedialog(save) macros
12.30.2009 GUI: allow filenames starting with a -'-'
01.07.2009 I18N: for X11 port, look for LC_MESSAGES, -LC_ALL, LANG env vars to set langage in that order
01.07.2009 I18N: update Japanese language -translation
01.07.2009 CONTOUR: fix muliple problems with command line -contour options. Each frame will now remember contour params -between frames
01.08.2009 ANALYSIS: minor changes in output of get -analysis commands. Now include parameters for web and bind -commands
01.11.2009 COLORBAR: fixed a problem with the orientation -of the numerics for vertical colorbar. This problem was introduced -with AST-5.3
01.11.2009 RGB: fixed a memory leak for RGB -frames
01.11.2009 I18N: update Japanese language -translation
01.11.2009 MACOSX: fixed a problem with non-native standard -file dialog boxes and error messages
01.12.2009 AST: fixed a memory leak with colorbar -grid.
01.13.2009 PLOT: fixed a rare problem when the user closes -a plot while in the middle of a zoom.
01.13.2009 IRAF: fixed a problem for mosaic iraf images are -loaded and the bounding box is incorrectly calculated.
12.14.2009 RGB: fixed a problem with a incorrect WCS compass in the panner image
12.15.2009 WCS: Documented the old ALIGN command and updated for XPA and SAMP
12.15.2009 GUI: Values accepted for SKYFORMAT expanded to 'deg', 'degree', and 'degrees' for command line options, XPA, and SAMP
12.17.2009 WCS: added code to test for bad WCS alignment issues (mainly from CAR projection, or pole problems)
12.17.2009 WCS: added code for WCS alignment for CAR. If CAR, getWCScrpix() is taken from center of image, and not from CRPIX keywords
12.18.2009 CATALOG: added USNO UCAC3 to the Optical list
12.24.2009 DATACUBE: DS9 now supports FITS images up to 10 dimensions. Happy Holidays!
12.28.2009 ANALYSIS: fixed problems with $data and $url and spaces in the tmp directory path name
12.28.2009 COMM: fixed problems with spaces in file names received as argumetns via SAMP and http
12.29.2009 REGION: fixed problems with XPA/SAMP and -format/-system/-sky options
12.29.2009 GUI: fixed a problem with hiding the current frame
12.30.2009 HV: at EXIT, close all opened HV windows so that tmp files may be deleted
12.30.2009 HV: fixed a problem for MIME type 'multipart/mixed', a tmp file was not deleted
12.30.2009 HV: fixed a problem for MIME type 'text/plain', a tmp file was not deleted
12.30.2009 ANALYSIS: add $filedialog(open) and $filedialog(save) macros
12.30.2009 GUI: allow filenames starting with a '-'
01.07.2009 I18N: for X11 port, look for LC_MESSAGES, LC_ALL, LANG env vars to set langage in that order
01.07.2009 I18N: update Japanese language translation
01.07.2009 CONTOUR: fix muliple problems with command line contour options. Each frame will now remember contour params between frames
01.08.2009 ANALYSIS: minor changes in output of get analysis commands. Now include parameters for web and bind commands
01.11.2009 COLORBAR: fixed a problem with the orientation of the numerics for vertical colorbar. This problem was introduced with AST-5.3
01.11.2009 RGB: fixed a memory leak for RGB frames
01.11.2009 I18N: update Japanese language translation
01.11.2009 MACOSX: fixed a problem with non-native standard file dialog boxes and error messages
01.12.2009 AST: fixed a memory leak with colorbar grid.
01.13.2009 PLOT: fixed a rare problem when the user closes a plot while in the middle of a zoom.
01.13.2009 IRAF: fixed a problem for mosaic iraf images are loaded and the bounding box is incorrectly calculated.
01.15.2010 RELEASE version 6.0
01.27.2010 XPA: fixed a problem with reporting errors -during an XPA operation. The correct error message is now passed to -XPA.
01.27.2010 SAMP: fixed a problem with reporting errors -during an SAMP operation. The correct error message is now passed -to SAMP.
01.27.2010 REGION: fixed a problem with catch and XPA/SAMP. -Errors are now reset when needed so as not to invoke an XPA/SAMP -ERROR message.
01.27.2010 XPA: fixed a problem with reporting errors during an XPA operation. The correct error message is now passed to XPA.
01.27.2010 SAMP: fixed a problem with reporting errors during an SAMP operation. The correct error message is now passed to SAMP.
01.27.2010 REGION: fixed a problem with catch and XPA/SAMP. Errors are now reset when needed so as not to invoke an XPA/SAMP ERROR message.
01.27.2010 XPA: update to version 2.1.12
02.02.2010 CONTOURS: fixed a problem with manually entered -contours values.
02.12.2010 COLORBAR: add numerics equal distance -option.
02.02.2010 CONTOURS: fixed a problem with manually entered contours values.
02.12.2010 COLORBAR: add numerics equal distance option.
02.12.2010 COLORBAR: add colorbar size option.
02.12.2010 COLORBAR: move colorbar parameters from view -menu to colorbar menu.
02.18.2010 MACOSX: fixed a problem where pcc was always -being installed. Now, first look for FILTER_CC (valid for X11 users -only). Next, see if /usr/bin/gcc exists. Finally, install pcc if -needed, and set to use it.
02.25.2010 SCALE: fixed numerous problems with LOG and POW -scales. Previously, the exp value of the log ratio was based on the -dynamic range of the data. It is now specified by the user. This -solves a number of issues with data which contains negative values. -(see new documenation on scale equations).
02.25.2010 CATALOG: CSC is now loaded as a VOTABLE by -default.
03.02.2010 CATALOG: add support for SkyBot catalog -server.
03.03.2010 MACOSX: printing, reduce image by 5% so colorbar -end tick numerics are not cutoff.
03.03.2010 WINDOWS: printing, reduce image by 5% so -colorbar end tick numerics are not cutoff.
03.03.2010 HV: fixed a problem with MouseWheel scrolling -under X11.
03.04.2010 ZOOM: added support for mouse wheel -zoom.
03.04.2010 HV: added support for Find and -FindNext.
03.10.2010 POSTSCRIPT: if colorbar and colorbar numerics -are visible, reduce image by 5% so colorbar end tick numerics are -not cutoff.
03.10.2010 PRINT: add psprint xpa/command/samp command for -postscript printing on MacOSX and Windows.
03.10.2010 GRID: add support for custom numeric -formats.
02.12.2010 COLORBAR: move colorbar parameters from view menu to colorbar menu.
02.18.2010 MACOSX: fixed a problem where pcc was always being installed. Now, first look for FILTER_CC (valid for X11 users only). Next, see if /usr/bin/gcc exists. Finally, install pcc if needed, and set to use it.
02.25.2010 SCALE: fixed numerous problems with LOG and POW scales. Previously, the exp value of the log ratio was based on the dynamic range of the data. It is now specified by the user. This solves a number of issues with data which contains negative values. (see new documenation on scale equations).
02.25.2010 CATALOG: CSC is now loaded as a VOTABLE by default.
03.02.2010 CATALOG: add support for SkyBot catalog server.
03.03.2010 MACOSX: printing, reduce image by 5% so colorbar end tick numerics are not cutoff.
03.03.2010 WINDOWS: printing, reduce image by 5% so colorbar end tick numerics are not cutoff.
03.03.2010 HV: fixed a problem with MouseWheel scrolling under X11.
03.04.2010 ZOOM: added support for mouse wheel zoom.
03.04.2010 HV: added support for Find and FindNext.
03.10.2010 POSTSCRIPT: if colorbar and colorbar numerics are visible, reduce image by 5% so colorbar end tick numerics are not cutoff.
03.10.2010 PRINT: add psprint xpa/command/samp command for postscript printing on MacOSX and Windows.
03.10.2010 GRID: add support for custom numeric formats.
03.17.2010 BIN: add support for Match Bin.
03.23.2010 FITS: add a check tor binary tables with no rows -or cols.
03.24.2010 WINDOWS: fixed a problem with native printing -and bitmaps that were not aligned upon a word boundary.
03.24.2010 WINDOWS: fixed a problem with rendering circle -point and box circle point.
03.26.2010 HV: fixed a rather nasty bug. If a HV window is -open when prefs are saved, the next time ds9 is started, upon exist -it tried to close an non-existent window, and went into a -loop.
03.29.2010 SAMP: add support for table.load.fits -events.
04.13.2010 BACKUP: add support for backup and -restore.
04.14.2010 GUI: ensure all temp files in /tmp have unique -names which will not conflict with other programs.
04.14.2010 RGB: corrected inconsistant behavior. The -creation of a RGB frame will not alter the single/tile -setting.
04.16.2010 TK: fixed a problem with some tk lib scripts not -sourced at startup and if -cd is executed, ds9 is unable to locate -the scripts.
04.16.2010 CIAO: removed any conjuction operators (which -are not supported).
04.16.2010 COLORBAR: fixed a rather nasty memory bug which -was invoked when the colorbar was re-configured.
04.23.2010 BACKUP: backup save sets can be saved into on a -repeat basis.
04.26.2010 SCALE: fixed a problem with segv and Scale -Dialog box.
04.26.2010 GUI: fixed a problem matching frames while in -single mode.
03.23.2010 FITS: add a check tor binary tables with no rows or cols.
03.24.2010 WINDOWS: fixed a problem with native printing and bitmaps that were not aligned upon a word boundary.
03.24.2010 WINDOWS: fixed a problem with rendering circle point and box circle point.
03.26.2010 HV: fixed a rather nasty bug. If a HV window is open when prefs are saved, the next time ds9 is started, upon exist it tried to close an non-existent window, and went into a loop.
03.29.2010 SAMP: add support for table.load.fits events.
04.13.2010 BACKUP: add support for backup and restore.
04.14.2010 GUI: ensure all temp files in /tmp have unique names which will not conflict with other programs.
04.14.2010 RGB: corrected inconsistant behavior. The creation of a RGB frame will not alter the single/tile setting.
04.16.2010 TK: fixed a problem with some tk lib scripts not sourced at startup and if -cd is executed, ds9 is unable to locate the scripts.
04.16.2010 CIAO: removed any conjuction operators (which are not supported).
04.16.2010 COLORBAR: fixed a rather nasty memory bug which was invoked when the colorbar was re-configured.
04.23.2010 BACKUP: backup save sets can be saved into on a repeat basis.
04.26.2010 SCALE: fixed a problem with segv and Scale Dialog box.
04.26.2010 GUI: fixed a problem matching frames while in single mode.
04.29.2010 GUI: add cycle windows key shortcut.
05.04.2010 WINDOWS: new windows installation -procedure.
05.06.2010 CATALOG: add IAU location code in preferences -(for Skybot).
05.10.2010 REGION: fixed a problem with projection region -when one or both end points are off the image. All gaps (mosaic) or -off image (non-mosaic) have a value of 0 and NaNs are -ignored.
05.12.2010 VOTable: add support for FIEDref and PARAMref -elements.
05.04.2010 WINDOWS: new windows installation procedure.
05.06.2010 CATALOG: add IAU location code in preferences (for Skybot).
05.10.2010 REGION: fixed a problem with projection region when one or both end points are off the image. All gaps (mosaic) or off image (non-mosaic) have a value of 0 and NaNs are ignored.
05.12.2010 VOTable: add support for FIEDref and PARAMref elements.
05.15.2010 RELEASE version 6.1
05.18.2010 WINDOWS: change windows installation procedure -back to allow user to specify destination directory.
05.18.2010 SAMP: fixed an issue with DS9 being confused as -to if it is currently connected and the need to shutdown SAMP at -exit.
05.18.2010 WINDOWS: change windows installation procedure back to allow user to specify destination directory.
05.18.2010 SAMP: fixed an issue with DS9 being confused as to if it is currently connected and the need to shutdown SAMP at exit.
05.18.2010 RELEASE version 6.1.1
05.19.2010 BACKUP: fixed several major problems.
05.19.2010 PSEUDOCOLOR: fixed a typo.
05.19.2010 RELEASE version 6.1.2
05.20.2010 MACOSX: always install pcc if gcc not available. -We don't want old versions of pcc around after upgrades of the -OS.
05.28.2010 PLOT: added statistics window for -plots.
05.28.2010 PLOT: fixed some problems with menus and clear -data.
05.28.2010 NAMESERVER: add get option to return coords -directly to calling proc.
06.17.2010 CHECKDNS: update chechdns to add support for -actually connect.
06.17.2010 VO: use checkdns to look for active server. If -none found, used hard coded list.
06.21.2010 ZOOM TO FIT: center image exactly, do not round -to nearest whole pixel.
06.21.2010 BACKUP: don't save prefs(version) var. We want -the current preference file version, not the save set -version.
06.21.2010 GUI: ds9 will now look for its auxiliary file -using the current name of the executable.
05.20.2010 MACOSX: always install pcc if gcc not available. We don't want old versions of pcc around after upgrades of the OS.
05.28.2010 PLOT: added statistics window for plots.
05.28.2010 PLOT: fixed some problems with menus and clear data.
05.28.2010 NAMESERVER: add get option to return coords directly to calling proc.
06.17.2010 CHECKDNS: update chechdns to add support for actually connect.
06.17.2010 VO: use checkdns to look for active server. If none found, used hard coded list.
06.21.2010 ZOOM TO FIT: center image exactly, do not round to nearest whole pixel.
06.21.2010 BACKUP: don't save prefs(version) var. We want the current preference file version, not the save set version.
06.21.2010 GUI: ds9 will now look for its auxiliary file using the current name of the executable.
06.30.2010 WCS: add WCS Edit dialog.
07.01.2010 XPA: add frame has command.
07.01.2010 SAMP: add frame has command.
07.09.2010 SAMP: fixed a problem with updating the connect -meun item after a manual disconnect.
07.09.2010 SAMP: added support for SAMP_HUB env -var.
07.13.2010 COLORBAR: fixed a problem with a bad default --size param. This problem only showed up with a pseudocolor8 -visual.
07.15.2010 GUI: implemented support for internal error -message facility. Any fatal internal error event will trigger an -GUI error message, hopefully leaving the user the option to save -data and to exit gracefully.
07.15.2010 GUI: implemented support for trapping the SIGBUS -signal and routing it to the internal error message facilty. This -usually occurs when a data file has been overwritten or a shared -memory segment is no longer available.
07.27.2010 PLOT: save font info when save -configuration.
08.04.2010 REGION: fixed a problem with the close button on -EPANDA and BPANDA dialog boxes.
08.05.2010 COLORBAR: fixed a problem when the image is all -one value.
08.10.2010 GUI: add Frame Match Image, Physical, Detector, -Amplifier buttons.
08.12.2010 MAGNIFIER: add magnifier prefs for XPA, SAMP, -and the command line.
07.09.2010 SAMP: fixed a problem with updating the connect meun item after a manual disconnect.
07.09.2010 SAMP: added support for SAMP_HUB env var.
07.13.2010 COLORBAR: fixed a problem with a bad default -size param. This problem only showed up with a pseudocolor8 visual.
07.15.2010 GUI: implemented support for internal error message facility. Any fatal internal error event will trigger an GUI error message, hopefully leaving the user the option to save data and to exit gracefully.
07.15.2010 GUI: implemented support for trapping the SIGBUS signal and routing it to the internal error message facilty. This usually occurs when a data file has been overwritten or a shared memory segment is no longer available.
07.27.2010 PLOT: save font info when save configuration.
08.04.2010 REGION: fixed a problem with the close button on EPANDA and BPANDA dialog boxes.
08.05.2010 COLORBAR: fixed a problem when the image is all one value.
08.10.2010 GUI: add Frame Match Image, Physical, Detector, Amplifier buttons.
08.12.2010 MAGNIFIER: add magnifier prefs for XPA, SAMP, and the command line.
08.12.2010 MAGNIFIER: add magnifier color option.
08.17.2010 GRID: fixed a problem with init -colors.
08.17.2010 GRID: now supports colors in form -#ffffff.
08.18.2010 CONTOURS: fixed an issue when loading aux -contours which do not end with a linefeed.
08.23.2010 COLORBAR: fixed an issue when printing colorbar -from the command line. The numerics are now updated before -printing.
08.23.2010 COLORBAR: fixed an issue when rendering -numerics. Numerics are now properly positioned, regardless of -colorbar orientation or font.
08.25.2010 GRID: fixed a number of issues when rendering -grid numerics. Numerics are now properly positioned, regardless of -orientation or font.
08.27.2010 POSTSCRIPT: fixed a rather nastsy prolblem with -the level 2 postscript driver (Ascii85 filter) in which, sometimes, -the last line of the image would not be written.
08.30.2010 POSTSCRIPT: add new postscript level 3 driver, -which uses Flate and Ascii85 filters.
08.31.2010 COLORBAR: add support for user specified number -of tickmarks to be displayed.
08.31.2010 CATALOG: The user can now invoke a blank catalog -tool via the command line, xpa, or samp.
08.17.2010 GRID: fixed a problem with init colors.
08.17.2010 GRID: now supports colors in form #ffffff.
08.18.2010 CONTOURS: fixed an issue when loading aux contours which do not end with a linefeed.
08.23.2010 COLORBAR: fixed an issue when printing colorbar from the command line. The numerics are now updated before printing.
08.23.2010 COLORBAR: fixed an issue when rendering numerics. Numerics are now properly positioned, regardless of colorbar orientation or font.
08.25.2010 GRID: fixed a number of issues when rendering grid numerics. Numerics are now properly positioned, regardless of orientation or font.
08.27.2010 POSTSCRIPT: fixed a rather nastsy prolblem with the level 2 postscript driver (Ascii85 filter) in which, sometimes, the last line of the image would not be written.
08.30.2010 POSTSCRIPT: add new postscript level 3 driver, which uses Flate and Ascii85 filters.
08.31.2010 COLORBAR: add support for user specified number of tickmarks to be displayed.
08.31.2010 CATALOG: The user can now invoke a blank catalog tool via the command line, xpa, or samp.
09.01.2010 TCL/TK: upate to version 8.5.8.
09.01.2010 CATALOG: add font properties to display symbol -database.
09.07.2010 CATALOG: now supports image/physical coordinate -systems.
09.21.2010 CONTOUR: copy/paste contours no longer requires -equatorial sky param.
09.21.2010 REGION: copy/paste contours no longer requires -equatorial sky param.
09.21.2010 SAVEAS: add optional params for jpeg, mpeg and -tiff command line options.
09.01.2010 CATALOG: add font properties to display symbol database.
09.07.2010 CATALOG: now supports image/physical coordinate systems.
09.21.2010 CONTOUR: copy/paste contours no longer requires equatorial sky param.
09.21.2010 REGION: copy/paste contours no longer requires equatorial sky param.
09.21.2010 SAVEAS: add optional params for jpeg, mpeg and tiff command line options.
09.22.2010 FOV: update Chandra Templates.
09.22.2010 GUI: add open and close support for XPA, SAMP, -and command line, for all dialogs.
09.28.2010 COLORBAR: fixed a problem with generating -colorbar values when no frame is available.
09.30.2010 HV: fixed a problem with multiple cookies, which -created a bad header.
09.30.2010 VO: fixed a problem with 'xpaget ds9 vo -connect'. Now returns only the current connections, not all -possible connections.
09.30.2010 REGION: added check for no frame and no image -loaded for xpaset regions via stdin.
09.22.2010 GUI: add open and close support for XPA, SAMP, and command line, for all dialogs.
09.28.2010 COLORBAR: fixed a problem with generating colorbar values when no frame is available.
09.30.2010 HV: fixed a problem with multiple cookies, which created a bad header.
09.30.2010 VO: fixed a problem with 'xpaget ds9 vo connect'. Now returns only the current connections, not all possible connections.
09.30.2010 REGION: added check for no frame and no image loaded for xpaset regions via stdin.
09.30.2010 ANALYSIS: add 'task #|name' command.
10.01.2010 ANALYSIS: fixed a problem when an analysis file -was loaded after an image had been loaded. Them menu was not -properly updated to reflect the template for each menu -item.
10.05.2010 CUBE: fixed a problem in which sometimes -changing the current slice whould hang.
10.05.2010 CUBE: add support for WCS in cube -dialog.
10.07.2010 CENTROID: add support centroid params -xpa/command line.
10.07.2010 CENTROID: fix some problems with an offset of .5 -pixels.
10.07.2010 SMOOTH: new frames inherit current smooth -params.
10.07.2010 RGB: fixed a problem when the first image load -has a flipped wcs.
10.01.2010 ANALYSIS: fixed a problem when an analysis file was loaded after an image had been loaded. Them menu was not properly updated to reflect the template for each menu item.
10.05.2010 CUBE: fixed a problem in which sometimes changing the current slice whould hang.
10.05.2010 CUBE: add support for WCS in cube dialog.
10.07.2010 CENTROID: add support centroid params xpa/command line.
10.07.2010 CENTROID: fix some problems with an offset of .5 pixels.
10.07.2010 SMOOTH: new frames inherit current smooth params.
10.07.2010 RGB: fixed a problem when the first image load has a flipped wcs.
10.08.2010 REGION: add CIRCLE3D region.
10.11.2010 BACKUP: fixed a problem with smoothed images and -contours.
10.14.2010 HELP: fixed a problem with finding the help -files if the CD command has changed the default -directory.
10.11.2010 BACKUP: fixed a problem with smoothed images and contours.
10.14.2010 HELP: fixed a problem with finding the help files if the CD command has changed the default directory.
10.14.2010 XPA: update to version 2.1.13
10.15.2010 RELEASE version 6.2

diff --git a/ds9/doc/release/r7.0.html b/ds9/doc/release/r7.0.html index a0ce068..88f2798 100644 --- a/ds9/doc/release/r7.0.html +++ b/ds9/doc/release/r7.0.html @@ -1,436 +1,237 @@ - - - + + + DS9 Version 7 Release Notes - -

SAOImageDS9 Version 7 Release Notes

+ +

SAOImageDS9 Version 7 Release Notes

10.18.2010 SCALE: fixed a problem preserve Scale at -load.
10.18.2010 REGION: add group new, group update, and select -invert commands.
10.18.2010 SCALE: fixed a problem preserve Scale at load.
10.18.2010 REGION: add group new, group update, and select invert commands.
10.20.2010 TCL/TK: update to version 8.5.9.
12.01.2010 FOV: Add HEASARC/Suzaku templates for HXD, XIS, -and XRS
12.03.2010 CATALOG: fixed a problem when dec is specified -as -00:xx:xx for CXC, SIMBAD, SKYBOT, and SKYVIEW
12.07.2010 BINNING: update WCS keywords for FITS -bintables
12.10.2010 GUI: fixed a problem with displaying greek -letters under linux.
12.24.2010 MOSAIC: fixed a problem introduced with verison -6.1 with wcs mosaics when first segment is flipped.
12.24.2010 MOSAIC: removed the FLT_EPSILON fudge factors in -calculating mosaic segment matrices.
01.04.2011 SOLARIS: fixed a major bug with color -allocation.
02.03.2011 POSTSCRIPT: all ports now generate identical -postscript output (with a minor exception with ast grid -numerics).
02.03.2011 TEXT: selecting a TEXT region now handles -rotated text correctly.
02.18.2011 GROUPS: fixed a problem with selecting multiple -regions.
02.21.2011 PIXELTABLE: fixed two problems with xpa and copy -commands.
12.01.2010 FOV: Add HEASARC/Suzaku templates for HXD, XIS, and XRS
12.03.2010 CATALOG: fixed a problem when dec is specified as -00:xx:xx for CXC, SIMBAD, SKYBOT, and SKYVIEW
12.07.2010 BINNING: update WCS keywords for FITS bintables
12.10.2010 GUI: fixed a problem with displaying greek letters under linux.
12.24.2010 MOSAIC: fixed a problem introduced with verison 6.1 with wcs mosaics when first segment is flipped.
12.24.2010 MOSAIC: removed the FLT_EPSILON fudge factors in calculating mosaic segment matrices.
01.04.2011 SOLARIS: fixed a major bug with color allocation.
02.03.2011 POSTSCRIPT: all ports now generate identical postscript output (with a minor exception with ast grid numerics).
02.03.2011 TEXT: selecting a TEXT region now handles rotated text correctly.
02.18.2011 GROUPS: fixed a problem with selecting multiple regions.
02.21.2011 PIXELTABLE: fixed two problems with xpa and copy commands.
02.28.2011 GUI: add theme options.
03.01.2011 TKTABLE: updated to version 2.10.
03.03.2011 POSTSCRIPT: add new scale factor.
03.02.2011 GUI: all dialogs now use the new ttk widgets -(with a few exceptions).
03.04.2011 PREFS: add -bg and -nan xpa/command line -options.
03.14.2011 MOSAIC: added patch from Frank Valdes for -default DETSIZE values.
03.14.2011 CMAP: add load/save xpa/command line -options.
03.14.2011 BACKUP: fixed a problem with saved cmaps. -Pathname is now relative.
03.02.2011 GUI: all dialogs now use the new ttk widgets (with a few exceptions).
03.04.2011 PREFS: add -bg and -nan xpa/command line options.
03.14.2011 MOSAIC: added patch from Frank Valdes for default DETSIZE values.
03.14.2011 CMAP: add load/save xpa/command line options.
03.14.2011 BACKUP: fixed a problem with saved cmaps. Pathname is now relative.
03.17.2011 TKIMG: updated to version 1.4.
03.17.2011 ZLIB: updated to version 1.2.5
03.18.2011 WCSSUBS: updated to version 3.8.2
04.05.2011 AST: updated to version 5.6-0
04.05.2011 WCS: fixed/improved support for TNX, ZPN, ZPX, -CAR.
04.05.2011 WCS: fixed/improved support for TNX, ZPN, ZPX, CAR.
04.25.2011 WCS: use AST for most WCS functions.
04.25.2011 SCALE: fix Scale Dialog formating -issues.
04.26.2011 HELP: All user manual images are now -local.
04.26.2011 CONTOUR: fixed problem with generating contours -with BITPIX=-64.
04.26.2011 SMOOTH: now generates BITPIX=-64 -image.
04.27.2011 SCALE: fixed a problem with setting scale user -limits and then loading an image.
04.28.2011 EXTERNAL FILE: fixed a problem with macro -substitution $filename.
04.25.2011 SCALE: fix Scale Dialog formating issues.
04.26.2011 HELP: All user manual images are now local.
04.26.2011 CONTOUR: fixed problem with generating contours with BITPIX=-64.
04.26.2011 SMOOTH: now generates BITPIX=-64 image.
04.27.2011 SCALE: fixed a problem with setting scale user limits and then loading an image.
04.28.2011 EXTERNAL FILE: fixed a problem with macro substitution $filename.
04.28.2011 FUNTOOLS: updated to version 1.4.5.
04.28.2011 XPA: reinstalled version 2.1.13.
05.02.2011 WCS: use AST for all FITS WCS projections and -DSS. Use WCSSUBS for TNX, ZPX, SIP, SCAMP, WCSDEP.
05.06.2011 WCS: Added additional reverse transformation -(thanks Ed Los) for calculation of Panner WCS compass.
05.09.2011 GRID: add support for non-standard WCSDEP -keyword.
05.12.2011 IMGSVR: for all image servers -(2mass,dss,first,nvss,skyview) if invoked with no argument, yet -dialog has a name or coords, automatically retreive the -image.
05.12.2011 FITS: External File support- fixed a problem -where the channel was not closed after the open pipe cmd was -invoked and ds9 would run out of resources.
05.13.2011 GUI: enhanced/implemented Match/Lock -Crosshairs.
05.13.2011 GUI: enhanced/implemented Match/Lock -Frames.
05.13.2011 GUI: Moved Match Scale/Bin/Colorbar to -respective menus.
05.16.2011 CONTOUR: fixed a problem with NAN in -data.
05.17.2011 CATALOG: NED fixed a problem with getURL and -added support for in/out sys/sky formats.
05.19.2011 CATALOG: SIMBAD added support for in/out sys/sky -formats.
05.19.2011 CATALOG: CDS added support for in/out sys/sky -formats.
05.20.2011 COMPOSITE: speed up create/delete composite -region with +1000 regions.
05.20.2011 WCS: implemented preferred WCS for each frame. -All WCS functions use the preferred WCS (i.e. copy/paste/load/save -regions, contours, align, match, lock, rgb, cube).
05.02.2011 WCS: use AST for all FITS WCS projections and DSS. Use WCSSUBS for TNX, ZPX, SIP, SCAMP, WCSDEP.
05.06.2011 WCS: Added additional reverse transformation (thanks Ed Los) for calculation of Panner WCS compass.
05.09.2011 GRID: add support for non-standard WCSDEP keyword.
05.12.2011 IMGSVR: for all image servers (2mass,dss,first,nvss,skyview) if invoked with no argument, yet dialog has a name or coords, automatically retreive the image.
05.12.2011 FITS: External File support- fixed a problem where the channel was not closed after the open pipe cmd was invoked and ds9 would run out of resources.
05.13.2011 GUI: enhanced/implemented Match/Lock Crosshairs.
05.13.2011 GUI: enhanced/implemented Match/Lock Frames.
05.13.2011 GUI: Moved Match Scale/Bin/Colorbar to respective menus.
05.16.2011 CONTOUR: fixed a problem with NAN in data.
05.17.2011 CATALOG: NED fixed a problem with getURL and added support for in/out sys/sky formats.
05.19.2011 CATALOG: SIMBAD added support for in/out sys/sky formats.
05.19.2011 CATALOG: CDS added support for in/out sys/sky formats.
05.20.2011 COMPOSITE: speed up create/delete composite region with +1000 regions.
05.20.2011 WCS: implemented preferred WCS for each frame. All WCS functions use the preferred WCS (i.e. copy/paste/load/save regions, contours, align, match, lock, rgb, cube).
05.25.2011 WCSSUBS: updated to version 3.8.3.
05.25.2011 AST: updated to version 5.7-0.
05.26.2011 WCS: use AST for TNX,ZPX,SCAMP.
05.27.2011 REGIONS: if unable to copy/cut/paste in WCS, -fall back upon PHYSICAL.
05.27.2011 REGIONS: if unable to map coordinates correctly, -do not a region.
06.03.2011 WCS: added support for xLON/xLAT and xyLN xyLT -WCS.
06.03.2011 REGIONS: added regions properites commands to -xpa,samp, and command line.
06.10.2011 HEALPIX: added support for generating an image -from a healpix table (both binary and ascii).
06.13.2011 WCS: use AST for all WCS including TAN-SIP and -WCSDEP.
06.16.2011 SAMP: added code to clean up better when DS9 is -unable to parse a SAMP hub file.
06.16.2011 REGIONS: be sure to return template id when -created.
06.16.2011 ANALYSIS: added autoload support for analysis -files. DS9 will search a list of known dirs for *.ds9, at which DS9 -will load the analysis file, and add the path to -env(PATH).
06.20.2011 RGB: fixed a problem where the calculated wcs -rotation between two frames was reset.
06.27.2011 REGIONS: fixed a problem the ds9, ciao, and pros -regions parser. The parsers will now accept arcmin and arcsec -syntax which includes sciencetific notation.
07.07.2011 POSTSCRIPT: generate postscipt now uses generic -font names reguardless of platform and window manager.
07.08.2011 BIN: split mousewheel preferences between zoom -and binning. By default, a bin file is zoom'd in/out with the mouse -wheel, unless the binning mouse wheel is enabled via the -preferences.
07.08.2011 GUI: add preference for standard dialog box for -order of file types.
07.21.2011 GUI: all non-modal dialogs have Edit -menu.
05.27.2011 REGIONS: if unable to copy/cut/paste in WCS, fall back upon PHYSICAL.
05.27.2011 REGIONS: if unable to map coordinates correctly, do not a region.
06.03.2011 WCS: added support for xLON/xLAT and xyLN xyLT WCS.
06.03.2011 REGIONS: added regions properites commands to xpa,samp, and command line.
06.10.2011 HEALPIX: added support for generating an image from a healpix table (both binary and ascii).
06.13.2011 WCS: use AST for all WCS including TAN-SIP and WCSDEP.
06.16.2011 SAMP: added code to clean up better when DS9 is unable to parse a SAMP hub file.
06.16.2011 REGIONS: be sure to return template id when created.
06.16.2011 ANALYSIS: added autoload support for analysis files. DS9 will search a list of known dirs for *.ds9, at which DS9 will load the analysis file, and add the path to env(PATH).
06.20.2011 RGB: fixed a problem where the calculated wcs rotation between two frames was reset.
06.27.2011 REGIONS: fixed a problem the ds9, ciao, and pros regions parser. The parsers will now accept arcmin and arcsec syntax which includes sciencetific notation.
07.07.2011 POSTSCRIPT: generate postscipt now uses generic font names reguardless of platform and window manager.
07.08.2011 BIN: split mousewheel preferences between zoom and binning. By default, a bin file is zoom'd in/out with the mouse wheel, unless the binning mouse wheel is enabled via the preferences.
07.08.2011 GUI: add preference for standard dialog box for order of file types.
07.21.2011 GUI: all non-modal dialogs have Edit menu.
07.21.2011 CUBE: add match/lock slice commands.
07.22.2011 AST: updated to version 5.7-2
07.22.2011 WCS: speedup generating sexagesimal -output
07.25.2011 BIN: fixed a problem with the update filter -function.
07.29.2011 DIALOGS: fixed a problem with the motif -dialogbox and selection of the initial directory. Set the code to -the same as tkfmbox.tcl.
08.22.2011 WCS: if CTYPE is not of known type, assume -LINEAR.
07.22.2011 WCS: speedup generating sexagesimal output
07.25.2011 BIN: fixed a problem with the update filter function.
07.29.2011 DIALOGS: fixed a problem with the motif dialogbox and selection of the initial directory. Set the code to the same as tkfmbox.tcl.
08.22.2011 WCS: if CTYPE is not of known type, assume LINEAR.
08.26.2011 PANNER: simplified compass prefs.
09.19.2011 WCS: only use A_ and B_ keywords if CTYPE is -TAN-SIP. Ignore otherwise.
09.26.2011 REGIONS: use ::math::fuzzy for comparisons in -basepanda, composite, and convert.
09.19.2011 WCS: only use A_ and B_ keywords if CTYPE is TAN-SIP. Ignore otherwise.
09.26.2011 REGIONS: use ::math::fuzzy for comparisons in basepanda, composite, and convert.
09.27.2011 WCSSUBS: updated to version 3.8.4.
09.30.2011 REGIONS: implemented M_PI_2, M_TWOMPI -constants.
09.30.2011 REGIONS: use fuzzy math for degToRad() and -radToDeg()
10.04.2011 WCS: pass any PV and QV keywords if present, -regardless of projection.
09.30.2011 REGIONS: implemented M_PI_2, M_TWOMPI constants.
09.30.2011 REGIONS: use fuzzy math for degToRad() and radToDeg()
10.04.2011 WCS: pass any PV and QV keywords if present, regardless of projection.
10.05.2011 AST: updated to version 5.7-3
10.24.2011 REGIONS: fixed a problem with angs and PANDA, -EPANDA, and BPANDA and copy/paste in FK5. This is related to the -fuzzy math changes made earlier.
10.25.2011 FITSY++: fixed a problem finding cols by name in -bin tables. Previous 'R' would be matched by 'RA'.
10.28.2011 HV: remove NED,SIMBAD,ADS,TDC,SKYVIEW,W3BROWSE -from ANALYSIS:ARCHIVES menu due to lack of support from -sites.
10.28.2011 COLORMAP: add colormap server to colormap -dialog
11.01.2011 PRINT COORDINATES: now uses default skyframe and -skyformat (as defined by WCS menu).
10.24.2011 REGIONS: fixed a problem with angs and PANDA, EPANDA, and BPANDA and copy/paste in FK5. This is related to the fuzzy math changes made earlier.
10.25.2011 FITSY++: fixed a problem finding cols by name in bin tables. Previous 'R' would be matched by 'RA'.
10.28.2011 HV: remove NED,SIMBAD,ADS,TDC,SKYVIEW,W3BROWSE from ANALYSIS:ARCHIVES menu due to lack of support from sites.
10.28.2011 COLORMAP: add colormap server to colormap dialog
11.01.2011 PRINT COORDINATES: now uses default skyframe and skyformat (as defined by WCS menu).
11.04.2011 SCALE: add asinh() and sinh() scales.
11.10.2011 CROP: add new crop commands.
12.09.2011 AST: updated to version 6.0-1
12.09.2011 CROSSHAIR: fixed an issue with coordinates of -crosshair were .5 pixel off in Y.
12.09.2011 GUI: fixed an issue with centerimage() was .5 -pixel off in Y.
12.15.2011 GRID: fixed an issue with text upside -down.
01.03.2012 BIN: fixed a problem with depth of a 3d bin'd -table.
01.03.2012 GRID: DSS and Linear projections use -AST.
12.09.2011 CROSSHAIR: fixed an issue with coordinates of crosshair were .5 pixel off in Y.
12.09.2011 GUI: fixed an issue with centerimage() was .5 pixel off in Y.
12.15.2011 GRID: fixed an issue with text upside down.
01.03.2012 BIN: fixed a problem with depth of a 3d bin'd table.
01.03.2012 GRID: DSS and Linear projections use AST.
01.17.2012 3D: 3D Frame is now available.
01.19.2012 ANALYSIS: added $z macro.
01.19.2012 CROP: add [xmin:xmax,ymin:ymax,zmin:zmax] -syntax
01.19.2012 CROP: check for valid crop with [] -syntax.
01.19.2012 CROP: add [xmin:xmax,ymin:ymax,zmin:zmax] syntax
01.19.2012 CROP: check for valid crop with [] syntax.
01.23.2012 3D: add current slice highlite.
01.23.2012 SAVEIMAGE: fixed a problem with frame highlite -during saveimage process.
01.23.2012 ANALYSIS: expand $image macro to accept new -params: rgb and 3d.
01.27.2012 ANALYSIS: expand $filename(full) to return full -filename (without cropping or filters parameters).
01.23.2012 SAVEIMAGE: fixed a problem with frame highlite during saveimage process.
01.23.2012 ANALYSIS: expand $image macro to accept new params: rgb and 3d.
01.27.2012 ANALYSIS: expand $filename(full) to return full filename (without cropping or filters parameters).
01.27.2012 ANALYSIS: add macro $value.
01.27.2012 CROP: fixed a problem when using an image -subsection spec for a datacube.
01.28.2012 REGIONS: clean up rendering code for -X,ps,win32,macosx to reduce un-needed calls to set the graphics -context.
01.28.2012 CROP: all data cubes can be cropped in -3D.
01.28.2012 CROP: cropping in 3D will reset currentSlice if -needed.
01.28.2012 REGIONS: fixed a problem if the region color was -an X11 valid color, some names would get mapped to the incorrect -color when printing.
02.02.2012 COLORMAP: fixed a problem with SAO format -colormaps that have very long lines.
02.03.2012 PRINT COORDINATES: added filename to -options.
02.03.2012 WCS: if wcs parameters are changed or reset, all -open catalogs regions are updated. Normal regions are not -changed.
02.07.2012 COLORMAP: remove support for old RTD and ITT -colormaps
02.08.2012 GUI: consolidate MATCH and LOCK items into -submenus.
02.08.2012 GUI: move match bin, match scale, and match -colorbar to frame match menu.
02.16.2012 CUBE: fixed a proble with calculating the wcs to -image for axis 3.
01.27.2012 CROP: fixed a problem when using an image subsection spec for a datacube.
01.28.2012 REGIONS: clean up rendering code for X,ps,win32,macosx to reduce un-needed calls to set the graphics context.
01.28.2012 CROP: all data cubes can be cropped in 3D.
01.28.2012 CROP: cropping in 3D will reset currentSlice if needed.
01.28.2012 REGIONS: fixed a problem if the region color was an X11 valid color, some names would get mapped to the incorrect color when printing.
02.02.2012 COLORMAP: fixed a problem with SAO format colormaps that have very long lines.
02.03.2012 PRINT COORDINATES: added filename to options.
02.03.2012 WCS: if wcs parameters are changed or reset, all open catalogs regions are updated. Normal regions are not changed.
02.07.2012 COLORMAP: remove support for old RTD and ITT colormaps
02.08.2012 GUI: consolidate MATCH and LOCK items into submenus.
02.08.2012 GUI: move match bin, match scale, and match colorbar to frame match menu.
02.16.2012 CUBE: fixed a proble with calculating the wcs to image for axis 3.
02.16.2012 FITSY++: changes required for gcc 4.7.
02.16.2012 BLT: patched graph.tcl to use legendRelief -instead of labelRelief.
02.16.2012 BLT: patched graph.tcl to use legendRelief instead of labelRelief.
02.16.2012 RGB: added lock wcs.
02.16.2012 FUNTOOLS: updated to version 1.4.5-2.
02.21.2012 3D: fixed a problem with scale clip scope. -Should alway be in GLOBAL.
02.21.2012 3D: fixed a problem with scale clip scope. Should alway be in GLOBAL.
02.29.2012 HEADER: add save header command.
03.01.2012 XPA: updated to version 2.1.14.
03.01.2012 SCALE: MinMax mode AUTOSCAN set to SAMPLE if -width*height*depth > 1e8.
03.12.2012 IMGSVR: fixed a problem with clearing params if -no image was loaded previously.
03.22.2012 REGION: add ellipse3d, box3d, polygon3d, point3d -regions.
03.23.2012 IMGSVR: fixed a problem new frame option and -rgb.
03.23.2012 BIN: check for valid col names for -bin col -command.
03.28.2012 REGIONS: add Analysis support per -region.
03.28.2012 REGIONS: add Analysis Plot3d support for -Circle,Ellipse,Box,Polygon,Point.
03.28.2012 REGIONS: add Analysis Plot2d support for -Projection,Line,Vector.
03.28.2012 REGIONS: Circle3d now converted to -Circle.
03.28.2012 REGIONS: Plot3d saves native coordinate -values.
03.28.2012 SCALE: simplified scale dialog controls to allow -user values.
03.29.2012 WCS: fixed a problem with numaxes > 3 images -and editing WCS params.
04.09.2012 WCS: second attempt to handle non-equatorial -wcs. try to build a legal header from the wcssubs struct to feed to -ast.
04.10.2012 SCALE: fixed an issue with autocut, ll != -hh.
04.10.2012 SKYVIEW: add WISE/COBE/WMAP to skyview survey -menu.
04.10.2012 WCS: if CD matrix is all zero, use cdelt/pc -matrix.
04.11.2012 SMOOTH: fixed a problem with images with -BSCALE/BZERO.
04.11.2012 CATALOG: fixed a problem with d:m:s formated DEC -which started with a '+'
04.12.2012 CATALOG: fixed a problem with d:m:s to degree -conversion. Try to maintain higher precision.
04.12.2012 CATALOG: add IAU location code to -dialog.
03.01.2012 SCALE: MinMax mode AUTOSCAN set to SAMPLE if width*height*depth > 1e8.
03.12.2012 IMGSVR: fixed a problem with clearing params if no image was loaded previously.
03.22.2012 REGION: add ellipse3d, box3d, polygon3d, point3d regions.
03.23.2012 IMGSVR: fixed a problem new frame option and rgb.
03.23.2012 BIN: check for valid col names for -bin col command.
03.28.2012 REGIONS: add Analysis support per region.
03.28.2012 REGIONS: add Analysis Plot3d support for Circle,Ellipse,Box,Polygon,Point.
03.28.2012 REGIONS: add Analysis Plot2d support for Projection,Line,Vector.
03.28.2012 REGIONS: Circle3d now converted to Circle.
03.28.2012 REGIONS: Plot3d saves native coordinate values.
03.28.2012 SCALE: simplified scale dialog controls to allow user values.
03.29.2012 WCS: fixed a problem with numaxes > 3 images and editing WCS params.
04.09.2012 WCS: second attempt to handle non-equatorial wcs. try to build a legal header from the wcssubs struct to feed to ast.
04.10.2012 SCALE: fixed an issue with autocut, ll != hh.
04.10.2012 SKYVIEW: add WISE/COBE/WMAP to skyview survey menu.
04.10.2012 WCS: if CD matrix is all zero, use cdelt/pc matrix.
04.11.2012 SMOOTH: fixed a problem with images with BSCALE/BZERO.
04.11.2012 CATALOG: fixed a problem with d:m:s formated DEC which started with a '+'
04.12.2012 CATALOG: fixed a problem with d:m:s to degree conversion. Try to maintain higher precision.
04.12.2012 CATALOG: add IAU location code to dialog.
04.13.2012 COLORMAP: add user contributed cmaps.
04.18.2012 GUI: fixed a problem with long WCSNAME -values.
04.20.2012 FITSY++: added support for GZIP compresss -parameter ZQUANTIZ.
04.23.2012 PS: fixed a bug with definiton of 32 bit -integers on 64 bit OS.
04.23.2012 PREFS: add Text Dialog Font preferences -menu.
04.23.2012 LOCK: fixed a problem with lock frame and mouse -wheel events.
04.24.2012 SKYBOT: Look for EXPTIME and add 1/2 to DATE-OBS -to get middle of observation.
04.24.2012 LINUX64: add --hash-style=both to support old -and new GNU API for hash libs.
04.26.2012 PHOTO: add support for other image -formats.
04.26.2012 EXPORT: add support for exporting to other image -formats.
04.30.2012 WCS: fixed a problem with TAN-SIP and wcs -append/replace.
05.01.2012 TCL: check to see if packages msgcat and http -have already been found before sourcing during startup.
05.03.2012 MPEG: fixed a problem with the bottom of an -image cut off.
04.18.2012 GUI: fixed a problem with long WCSNAME values.
04.20.2012 FITSY++: added support for GZIP compresss parameter ZQUANTIZ.
04.23.2012 PS: fixed a bug with definiton of 32 bit integers on 64 bit OS.
04.23.2012 PREFS: add Text Dialog Font preferences menu.
04.23.2012 LOCK: fixed a problem with lock frame and mouse wheel events.
04.24.2012 SKYBOT: Look for EXPTIME and add 1/2 to DATE-OBS to get middle of observation.
04.24.2012 LINUX64: add --hash-style=both to support old and new GNU API for hash libs.
04.26.2012 PHOTO: add support for other image formats.
04.26.2012 EXPORT: add support for exporting to other image formats.
04.30.2012 WCS: fixed a problem with TAN-SIP and wcs append/replace.
05.01.2012 TCL: check to see if packages msgcat and http have already been found before sourcing during startup.
05.03.2012 MPEG: fixed a problem with the bottom of an image cut off.
05.07.2012 COLORTAG: add color tags.
05.10.2012 CROP: fixed a problem with backup and lock -crop.
05.10.2012 SCALE: fixed a problem lock scale and -crop.
05.10.2012 BACKUP: fixed a problem with back and -slice, --mosaic load options.
05.11.2012 REGIONS: add auto plot2d and plot3d -prefs.
05.10.2012 CROP: fixed a problem with backup and lock crop.
05.10.2012 SCALE: fixed a problem lock scale and crop.
05.10.2012 BACKUP: fixed a problem with back and -slice, -mosaic load options.
05.11.2012 REGIONS: add auto plot2d and plot3d prefs.
05.14.2012 GUI: add fits save.
05.17.2012 MPEG: updated to ezMPEG v0.1
05.17.2012 AST: updated to 7.0.3
05.23.2012 WCS: is always displayed
05.23.2012 CATALOG: fixed a problem with the sign of d:m:s -conversion introduced on 04.12.2012.
05.28.2012 MOVIE: minor tweaks on incr slice during -movie.
05.28.2012 WIN32: fixed a problem with 3d fillImageJoin. -Statck overflow.
05.23.2012 CATALOG: fixed a problem with the sign of d:m:s conversion introduced on 04.12.2012.
05.28.2012 MOVIE: minor tweaks on incr slice during movie.
05.28.2012 WIN32: fixed a problem with 3d fillImageJoin. Statck overflow.
05.29.2012 BACKUP: fixed active frames issue.
05.30.2012 GUI: add threads command.
05.30.2012 GUI: fixed a problem with PASTE for entries. -Will now process unicode.
05.31.2012 GRID: fixed a problem with parsing 6.1 and 6.2 -backup save sets. New grid options parser implemented.
05.31.2012 PLOT: fixed a problem in generating postscript. -Now just set plot size.
05.31.2012 PLOT: fixed a postscript font issue with -helvetica.
05.30.2012 GUI: fixed a problem with PASTE for entries. Will now process unicode.
05.31.2012 GRID: fixed a problem with parsing 6.1 and 6.2 backup save sets. New grid options parser implemented.
05.31.2012 PLOT: fixed a problem in generating postscript. Now just set plot size.
05.31.2012 PLOT: fixed a postscript font issue with helvetica.
05.31.2012 PLOT: add axes format.
06.06.2012 RELEASE version 7.0
06.12.2012 BACKUP: fixed a problem with processing version -6.1 and 6.2 backup save sets.
06.12.2012 BACKUP: fixed a problem with processing version 6.1 and 6.2 backup save sets.
06.15.2012 RELEASE version 7.0.1
06.13.2012 3D: add border graphics.
06.15.2012 TCLLIB: updated to version 1.14. This fixes a -problem with math::fuzzy::tlt.
06.21.2012 REGION: fixed a problem with rotated images and -postscript printing of circle region.
06.21.2012 IMGSRV: fixed a problem loading images from -dss/2mass/etc from the command line. Use the first frame if not -already loaded.
06.21.2012 SLA: removed from build tree. not needed since -AST now has own version.
06.21.2012 HELP: rm link to home page. hv can't handle the -new web site.
06.15.2012 TCLLIB: updated to version 1.14. This fixes a problem with math::fuzzy::tlt.
06.21.2012 REGION: fixed a problem with rotated images and postscript printing of circle region.
06.21.2012 IMGSRV: fixed a problem loading images from dss/2mass/etc from the command line. Use the first frame if not already loaded.
06.21.2012 SLA: removed from build tree. not needed since AST now has own version.
06.21.2012 HELP: rm link to home page. hv can't handle the new web site.
06.22.2012 SKYBOT: added -filter=0.
06.22.2012 POSTSCRIPT: fixed a problem with rotated text -regions affecting other regions.
06.22.2012 REGIONS: fixed a problem selecting text regions -at high zoom.
06.22.2012 WCS: add support for SAO Polynomial -Plate.
06.25.2012 GUI: improved error handling. Will now properly -handle a FATAL error msg from internal widgets.
06.25.2012 GUI: non FATAL msgs can be supressed via -preferences.
06.25.2012 FRAME: trap SIGBUS while scanning for -min/max.
06.25.2012 WCS: use new version of AST:fitschan.c which -supports SAO polynomial plate solution and checks for the case of -all PV keywords=0.
06.25.2012 GUI: enable hidden directory button for linux -standard dialog box (windows only).
06.25.2012 GUI: move About menu item to Help -menu.
06.27.2012 LOCK: fixed a problem with LOCK FRAME and the -current skyframe.
06.27.2012 PANNER: fixed a problem where the wcs compass -was incorrectly set.
06.22.2012 POSTSCRIPT: fixed a problem with rotated text regions affecting other regions.
06.22.2012 REGIONS: fixed a problem selecting text regions at high zoom.
06.22.2012 WCS: add support for SAO Polynomial Plate.
06.25.2012 GUI: improved error handling. Will now properly handle a FATAL error msg from internal widgets.
06.25.2012 GUI: non FATAL msgs can be supressed via preferences.
06.25.2012 FRAME: trap SIGBUS while scanning for min/max.
06.25.2012 WCS: use new version of AST:fitschan.c which supports SAO polynomial plate solution and checks for the case of all PV keywords=0.
06.25.2012 GUI: enable hidden directory button for linux standard dialog box (windows only).
06.25.2012 GUI: move About menu item to Help menu.
06.27.2012 LOCK: fixed a problem with LOCK FRAME and the current skyframe.
06.27.2012 PANNER: fixed a problem where the wcs compass was incorrectly set.
06.29.2012 AST: updated to 7.0.5
07.02.2012 HTTP: set default timeout to 1 minute.
07.03.2012 RELEASE version 7.0.2
07.05.2012 RGB: fixed a problem with -rgbimage and -extnames.
07.05.2012 GCC: fixed a problem gcc 4.5 and Pixmap -typedef.
07.06.2012 SCALE: fixed a problem with scale dialog and -very small numbers.
07.10.2012 BIN: fixed a problem with very large FITS Bin -Tables.
07.11.2012 FITSY++: fixed a number of problems with very -large (2Gb>) FITS Image and Bin Tables.
07.13.2012 WINDOWS: fixed a problem with dashs on the -display. Tk does not give us much flexibilty, so pick something -closer to the desired length.
07.17.2012 CATALOG: add sdss r7 and sdss r8 to default -menu.
07.17.2012 GRIDS: fixed a problem where each frame grid -remembers its own configuration.
07.17.2012 FITSY++: fixed a number of problems with save -very large (2Gb>) FITS Image and Bin Tables.
07.23.2012 REGIONS: fixed a problem with PLOT3D and BOX, -ELLIPSE, POLYGON. At certain angles, incorrect counts were -calculated.
07.27.2012 REGIONS: fixed a problem with rendering ELLIPSE -PANDA X11 at angle=0.
07.30.2012 PRINT: fixed a problem with printing simple text -and catalog dialogs.
07.30.2012 REGIONS: add default length format to -preferences.
07.30.2012 GUI: update infobox when moving between -frames.
07.30.2012 BACKUP: don't save compressed image files if not -requested.
08.02.2012 WCS: fixed a number of issues with the WCS -parameters dialog.
08.02.2012 WCS: added support for SIP and SCAMP keywords to -WCS parameters dialog.
08.06.2012 MAGNIFIER: be sure to update magnifier when -changing slice.
08.09.2012 PLOT: fixed a problem reading muliple datasets -from one source.
07.05.2012 RGB: fixed a problem with -rgbimage and extnames.
07.05.2012 GCC: fixed a problem gcc 4.5 and Pixmap typedef.
07.06.2012 SCALE: fixed a problem with scale dialog and very small numbers.
07.10.2012 BIN: fixed a problem with very large FITS Bin Tables.
07.11.2012 FITSY++: fixed a number of problems with very large (2Gb>) FITS Image and Bin Tables.
07.13.2012 WINDOWS: fixed a problem with dashs on the display. Tk does not give us much flexibilty, so pick something closer to the desired length.
07.17.2012 CATALOG: add sdss r7 and sdss r8 to default menu.
07.17.2012 GRIDS: fixed a problem where each frame grid remembers its own configuration.
07.17.2012 FITSY++: fixed a number of problems with save very large (2Gb>) FITS Image and Bin Tables.
07.23.2012 REGIONS: fixed a problem with PLOT3D and BOX, ELLIPSE, POLYGON. At certain angles, incorrect counts were calculated.
07.27.2012 REGIONS: fixed a problem with rendering ELLIPSE PANDA X11 at angle=0.
07.30.2012 PRINT: fixed a problem with printing simple text and catalog dialogs.
07.30.2012 REGIONS: add default length format to preferences.
07.30.2012 GUI: update infobox when moving between frames.
07.30.2012 BACKUP: don't save compressed image files if not requested.
08.02.2012 WCS: fixed a number of issues with the WCS parameters dialog.
08.02.2012 WCS: added support for SIP and SCAMP keywords to WCS parameters dialog.
08.06.2012 MAGNIFIER: be sure to update magnifier when changing slice.
08.09.2012 PLOT: fixed a problem reading muliple datasets from one source.
08.10.2012 AST: updated to version 7.0.6
08.13.2012 3D: add z axis scaling.
08.13.2012 FITSY++: accept double quoted (invalid) -strings.
08.21.2012 REGIONS: fixed a problem with -regions centroid -command.
08.13.2012 FITSY++: accept double quoted (invalid) strings.
08.21.2012 REGIONS: fixed a problem with -regions centroid command.
09.05.2012 SMOOTH: add lock/match smooth.
09.14.2012 PLOT: enhanced gui.
09.14.2012 PLOT: add bar chart option.
10.3.2012 CATALOG: add match option.
10.15.2012 RELEASE version 7.1
10.18.2012 GUI: update File menu.
11.02.2012 GUI: add support for NRRD file format. Includes -encodings: raw and gzip.
11.05.2012 GUI: fixed a problem with cut/paste for contours -and catalogs.
11.02.2012 GUI: add support for NRRD file format. Includes encodings: raw and gzip.
11.05.2012 GUI: fixed a problem with cut/paste for contours and catalogs.
11.27.2012 PLOT: fixed typo in range dialog.
11.27.2012 GUI: fixed a problem with clear analysis menu -item and the analysis menu.
12.06.2012 SAMP: fixed a typo which disabled SAMP_HUB -functionality.
12.06.2012 DS9: fixed a problem on how to align an image -with an odd size frame. In versions <7.0, the floating point -number was rounded down. This has been re-implemented.
11.27.2012 GUI: fixed a problem with clear analysis menu item and the analysis menu.
12.06.2012 SAMP: fixed a typo which disabled SAMP_HUB functionality.
12.06.2012 DS9: fixed a problem on how to align an image with an odd size frame. In versions <7.0, the floating point number was rounded down. This has been re-implemented.
12.11.2012 GPL: upgrade license to GPL v3.
12.18.2012 COLORBAR: add support for SAO format GAMMA -param.
12.18.2012 COLORBAR: add support for SAO format GAMMA param.
12.18.2012 SAVEIMAGE: add support for EPS.
12.20.2012 REGIONS: fixed a problem with updating analysis -plot x/y axis titles.
12.21.2012 REGIONS: fixed a problem with analysis radial -profile and negative xaxis values.
12.21.2012 REGIONS: fixed a problem with writing composited -regions.
12.21.2012 REGIONS: fixed a problem with list/save data -radial annulus.
12.20.2012 REGIONS: fixed a problem with updating analysis plot x/y axis titles.
12.21.2012 REGIONS: fixed a problem with analysis radial profile and negative xaxis values.
12.21.2012 REGIONS: fixed a problem with writing composited regions.
12.21.2012 REGIONS: fixed a problem with list/save data radial annulus.
12.28.2012 RGB: add photo export.
01.19.2013 FITSY++: fixed a problem parsing -filters
01.19.2013 FITSY++: fixed a problem with incomplete -variable array TFORM descriptions, used in fits compression. If no -length is specified, set default to 8.
01.29.2013 SAVE: save fits will now save an entire cube if -loaded.
01.19.2013 FITSY++: fixed a problem parsing filters
01.19.2013 FITSY++: fixed a problem with incomplete variable array TFORM descriptions, used in fits compression. If no length is specified, set default to 8.
01.29.2013 SAVE: save fits will now save an entire cube if loaded.
01.30.2013 SAVE: add support for save mecube.
01.31.2013 CONTOUR: fixed a problem with loading a set of -contours with a specified color.
02.13.2013 FITSY++: support new fits compression -float/double gzip method.
02.13.2013 FITSY++: ds9 now distinguishes between -BLANK/NAN/INF values.
02.15.2013 REGIONS: no longer output filename in -header.
02.26.2013 FITSY++: use magic bytes to check for gz -compressed files before load.
02.28.2013 RGB: loading rgbimage, rgbcube, rgbarray into -non-rgb frame will create new rgb frame for all command line, xpa, -and samp commands.
03.01.2013 FRAME: trap SIGBUS and SIGSEGV while scanning -data.
03.01.2013 FRAME: will only return error messages at levels -info, warning, and error.
03.10.2013 PREFS: fixed a problem with prefs zoom -align.
01.31.2013 CONTOUR: fixed a problem with loading a set of contours with a specified color.
02.13.2013 FITSY++: support new fits compression float/double gzip method.
02.13.2013 FITSY++: ds9 now distinguishes between BLANK/NAN/INF values.
02.15.2013 REGIONS: no longer output filename in header.
02.26.2013 FITSY++: use magic bytes to check for gz compressed files before load.
02.28.2013 RGB: loading rgbimage, rgbcube, rgbarray into non-rgb frame will create new rgb frame for all command line, xpa, and samp commands.
03.01.2013 FRAME: trap SIGBUS and SIGSEGV while scanning data.
03.01.2013 FRAME: will only return error messages at levels info, warning, and error.
03.10.2013 PREFS: fixed a problem with prefs zoom align.
03.12.2013 BACKUP: check for sym links.
03.14.2013 GUI: non-modal dialogs are now created at the -center of the main ds9 window.
03.14.2013 GUI: non-modal dialogs are now created at the center of the main ds9 window.
03.25.2013 VO: default vo method is mime.
03.25.2013 VO: if xpa method fails, default to -mime.
03.25.2013 VO: if xpa method fails, default to mime.
03.26.2013 XPA: add samp cmd to xpa.
03.26.2013 SAMP: add xpa cmd to samp.
04.01.2013 AST: updated to version 7.1.1
04.11.2013 CATALOG: fixed cut and paste.
04.11.2013 WCS: SAO_PLT is now handled directly by -AST.
04.11.2013 WCS: SAO_PLT is now handled directly by AST.
04.12.2013 PREFS: add dialog center option.
04.12.2013 PLOT: all plots (user, analysis and catalogs) -are now available to the plot command.
04.12.2013 PLOT: all plots (user, analysis and catalogs) are now available to the plot command.
04.15.2013 RELEASE version 7.2
04.16.2013 AST: updated to version 7.2
04.16.2013 TCLLIB: updated to version 1.15
04.26.2013 ZVFS: updated to version 2
05.15.2013 CATALOGS: add AAVSO to cat list.
05.17.2013 HV: add DASCHE to Archives list.
06.03.2013 IRAF: fixed a problem with imexamine -coords.
06.04.2013 IRAF: save/export will save wcs values, not just -the color number.
06.03.2013 IRAF: fixed a problem with imexamine coords.
06.04.2013 IRAF: save/export will save wcs values, not just the color number.
06.05.2013 IRAF: colorbar displays wcs values.
06.05.2013 IRAF: fixed a number of issues with tvmark -colors.
06.11.2013 FITSY++: implemented compressed FITS -SUBTRACTIVE_DITHER_1 method.
06.14.2013 ENVI: add support for import/export envi -format.
06.05.2013 IRAF: fixed a number of issues with tvmark colors.
06.11.2013 FITSY++: implemented compressed FITS SUBTRACTIVE_DITHER_1 method.
06.14.2013 ENVI: add support for import/export envi format.
06.14.2013 AST: updated to version 7.3.1
06.18.2013 GUI: fixed a problem with blank headers being -displayed.
06.18.2013 ARRAY: now accepts cropping info in -filename.
06.18.2013 NRRD: now accepts cropping info in -filename.
06.18.2013 ENVI: now accepts cropping info in -filename.
06.21.2013 PHOTO: fixed a problem with rounding -average.
06.18.2013 GUI: fixed a problem with blank headers being displayed.
06.18.2013 ARRAY: now accepts cropping info in filename.
06.18.2013 NRRD: now accepts cropping info in filename.
06.18.2013 ENVI: now accepts cropping info in filename.
06.21.2013 PHOTO: fixed a problem with rounding average.
06.24.2013 ZVFS: zvfs.c updated from freewrap 6.6
06.26.2013 SEGMENT: add new segment region.
07.02.2013 ENVI: fixed a problem with calculating -wcs.
07.02.2013 ENVI: fixed a problem with calculating wcs.
07.02.2013 FITSY++: changes to allow 1D image.
07.03.2013 GROUPS: fixed a problem allowing multiple -selection of region groups.
08.14.2013 WCS: Linear WCS now goes straight to -AST.
09.10.2013 PSEUDOCOLOR: rm support for pseudocolor -visuals.
09.17.2013 REGIONS: PLOT3D dramatic improvements in speed -of deep images and large regions.
09.17.2013 GUI: set last file directory based on file type -last loaded.
07.03.2013 GROUPS: fixed a problem allowing multiple selection of region groups.
08.14.2013 WCS: Linear WCS now goes straight to AST.
09.10.2013 PSEUDOCOLOR: rm support for pseudocolor visuals.
09.17.2013 REGIONS: PLOT3D dramatic improvements in speed of deep images and large regions.
09.17.2013 GUI: set last file directory based on file type last loaded.
09.18.2013 ENVI: minor change to hdr parser.
09.18.2013 ENVI: fixed a major problem with -swapbytes.
09.18.2013 CATALOG: fixed a problem with selecting the -correct region when arrow keys are used.
09.19.2013 FITSY++: cleaned up code for dumping -array,nrrd,envi in native endian.
09.25.2013 AST: updated to version 7.3.2 to fix problem -with SCAMP.
09.25.2013 FITSY++: fixed a problem parsing filters in the -command line.
09.18.2013 ENVI: fixed a major problem with swapbytes.
09.18.2013 CATALOG: fixed a problem with selecting the correct region when arrow keys are used.
09.19.2013 FITSY++: cleaned up code for dumping array,nrrd,envi in native endian.
09.25.2013 AST: updated to version 7.3.2 to fix problem with SCAMP.
09.25.2013 FITSY++: fixed a problem parsing filters in the command line.
10.05.2013 3D: implement image cache.
10.08.2013 3D: implement az and el background -render.
10.10.2013 COLORBAR: fixed a minor problem with specifing -'other color'.
10.11.2013 REGIONS: add mouse click epsilon -parameter.
10.08.2013 3D: implement az and el background render.
10.10.2013 COLORBAR: fixed a minor problem with specifing 'other color'.
10.11.2013 REGIONS: add mouse click epsilon parameter.
10.16.2013 CUBE: add lock slice wcs.
10.17.2013 REGIONS: fixed a problem with ds9 regions parser -and parsing hex color specification.
10.18.2013 XPA: fixed a problem with "file" and backward -compatability.
10.18.2013 ANALYSIS: add several checks to verify analysis -file before try to parse.
10.22.2013 GUI: fixed a problem with preserve PAN while -loading.
10.22.2013 SCALE: removed PRESERVE SCALE. This has been -redundant since 7.0. Setting the scale limits does the same -thing.
10.22.2013 CONTOUR: fixed a problem if no system is -specified and, the default is normally WCS, unless no WCS is -defined, then default to PHYSICAL.
10.17.2013 REGIONS: fixed a problem with ds9 regions parser and parsing hex color specification.
10.18.2013 XPA: fixed a problem with "file" and backward compatability.
10.18.2013 ANALYSIS: add several checks to verify analysis file before try to parse.
10.22.2013 GUI: fixed a problem with preserve PAN while loading.
10.22.2013 SCALE: removed PRESERVE SCALE. This has been redundant since 7.0. Setting the scale limits does the same thing.
10.22.2013 CONTOUR: fixed a problem if no system is specified and, the default is normally WCS, unless no WCS is defined, then default to PHYSICAL.
10.28.2013 TCL/TK: update to version 8.6.1.
10.31.2013 HTML: fixed issue causeing corrupt stack with -new CLANG compilers.
11.10.2013 FITS: improved error handling for malformed FITS -tables.
11.15.2013 CUBE: fixed a problem with lock slice -wcs.
10.31.2013 HTML: fixed issue causeing corrupt stack with new CLANG compilers.
11.10.2013 FITS: improved error handling for malformed FITS tables.
11.15.2013 CUBE: fixed a problem with lock slice wcs.
11.18.2013 CATALOG: add SDSS9 to optical menu.
12.12.2013 WCS: add support for AST WCS def.
01.28.2014 REGIONS: add auto statistics option.
03.06.2014 AST: updated to version 7.3.4.
03.21.2014 CATALOG: add 'Copy to Regions' from -XPA/SAMP/commandline.
03.26.2014 WCS: fixed a problem with wcs append/replace -where the line length was 81 with newline.
04.07.2014 FITSY++: expanded valid EXTNAME keywords to -include '.', '-', and '_' chars.
04.07.2014 FITSY++: save fits will convert BITPIX=-16 to -BITPIX=32
06.09.2014 CATALOG: if sort col is of type real, but -contains blank values, substitue a value of 0.
03.21.2014 CATALOG: add 'Copy to Regions' from XPA/SAMP/commandline.
03.26.2014 WCS: fixed a problem with wcs append/replace where the line length was 81 with newline.
04.07.2014 FITSY++: expanded valid EXTNAME keywords to include '.', '-', and '_' chars.
04.07.2014 FITSY++: save fits will convert BITPIX=-16 to BITPIX=32
06.09.2014 CATALOG: if sort col is of type real, but contains blank values, substitue a value of 0.
07.01.2014 BLT: completed upgrade to TkBLT 3.0.
07.28.2014 CATALOG: add UCAC4 to optical menu.
08.01.2014 MACOSX: completed new 64bit Aqua port.
08.06.2014 3D: don't wipeout the cache when generating a -movie.
09.15.2014 ENVI: try to determine data file name from -header file name.
09.30.2014 GUI: default mouse mode is NONE (not -POINTER).
08.06.2014 3D: don't wipeout the cache when generating a movie.
09.15.2014 ENVI: try to determine data file name from header file name.
09.30.2014 GUI: default mouse mode is NONE (not POINTER).
09.30.2014 GUI: change mode POINTER to REGION.
10.01.2014 RELEASE version 7.3
10.03.2014 GUI: Fixed problems with Control-S and Control-Z -accelerators.
10.03.2014 MACOSX: Removed accelerators for Print, -PageSetup, and Find, as then invoke a known bug with Tk and -dialogs.
10.03.2014 MACOSX: Fixed a problem with coordinate display -dialog.
10.03.2014 MACOSX: Fixed a problem with deleting colorbar -tags.
10.03.2014 PREFS: Beta versions are now deemed to be of the -same verison as the final release.
10.03.2014 PREFS: Fixed a problem processing a newer prefs -file. Now wait to notify the user after the init phase has been -completed.
10.03.2014 PREFS: some combinations of old prefs files were -not being updated correctly.
10.03.2014 GUI: Fixed problems with Control-S and Control-Z accelerators.
10.03.2014 MACOSX: Removed accelerators for Print, PageSetup, and Find, as then invoke a known bug with Tk and dialogs.
10.03.2014 MACOSX: Fixed a problem with coordinate display dialog.
10.03.2014 MACOSX: Fixed a problem with deleting colorbar tags.
10.03.2014 PREFS: Beta versions are now deemed to be of the same verison as the final release.
10.03.2014 PREFS: Fixed a problem processing a newer prefs file. Now wait to notify the user after the init phase has been completed.
10.03.2014 PREFS: some combinations of old prefs files were not being updated correctly.
10.06.2014 FIRST: rename FIRST to VLA
10.06.2014 VLA: add STRIPE82 survey.
10.06.2014 HV: fixed a problem with scrolling.
10.07.2014 RELEASE version 7.3.1
10.08.2014 REGIONS: fixed a problem with parsing old -regions file fonts.
10.08.2014 REGIONS: fixed a problem with parsing old regions file fonts.
10.08.2014 RELEASE version 7.3.2
10.10.2014 IEXAM: imexam has been renamed iexam.
10.15.2014 WCS: fixed a problem with imflip=1.
10.15.2014 AST: updated to version 8.0.0.
10.20.2014 AST: updated to version 8.0.2.
10.20.2014 HPX: updated compatiable wcslib-4.24.
10.21.2014 CATALOG: add width property for -symbols.
10.22.2014 MACOSX: fixed a problem with mouse wheel -zoom.
10.22.2014 FITSY++: add support for SUBTRACTIVE_DITHER_2 -keyword.
10.22.2014 FITSY++: fixed a problem with native endian -arrays. Unless specified, the array is assumed to be of the same -endian-ness as the processor.
11.14.2014 CUBE: fixed a problem with lock slice with no -fits loaded.
10.21.2014 CATALOG: add width property for symbols.
10.22.2014 MACOSX: fixed a problem with mouse wheel zoom.
10.22.2014 FITSY++: add support for SUBTRACTIVE_DITHER_2 keyword.
10.22.2014 FITSY++: fixed a problem with native endian arrays. Unless specified, the array is assumed to be of the same endian-ness as the processor.
11.14.2014 CUBE: fixed a problem with lock slice with no fits loaded.
11.17.2014 TCL/TK: update to version 8.6.3.
11.18.2014 MACOSX: preferences, fixed jumpy window size -problem.
11.19.2014 GUI: view horizontal/vertical now sets display -size to default settings.
11.18.2014 MACOSX: preferences, fixed jumpy window size problem.
11.19.2014 GUI: view horizontal/vertical now sets display size to default settings.
12.03.2014 IIS: fixed a problem with open_unix().
12.29.2014 BLOCK: add support for blocking.
02.04.2015 HPX: fixed a problem with cropping HPX -images.
02.05.2015 FITS++: Fits Compression- fixed a problem with -uncompressed blocks.
02.05.2015 FITS++: added support for 'Q' column -arrays.
02.17.2015 HV: Fixed a problem when url scheme is FTP and -authority included username and passwd.
02.18.2015 WCS: Fixed a problem when CDELTs and PCs -keywords are used, but not in the orthodox way.
03.11.2015 NRRD: Fixed a problem exporting built data -cube.
03.11.2015 ENVI: Fixed a problem exporting built data -cube.
03.24.2015 MOSAIC: mecube will now skip over tables and -find all images.
04.08.2015 FITS++: fixed a problem with compressed fits -files and static memory size. now using alloc.
04.13.2015 CATALOGS: fixed a problem with deleting the -frame first, before closing a catalog dialog.
04.15.2015 CUBE: added support for reorder data cube -axes.
04.16.2015 SMOOTH: blank/NaN values are no longer replaced -by 0, instead, NaN is used.
02.04.2015 HPX: fixed a problem with cropping HPX images.
02.05.2015 FITS++: Fits Compression- fixed a problem with uncompressed blocks.
02.05.2015 FITS++: added support for 'Q' column arrays.
02.17.2015 HV: Fixed a problem when url scheme is FTP and authority included username and passwd.
02.18.2015 WCS: Fixed a problem when CDELTs and PCs keywords are used, but not in the orthodox way.
03.11.2015 NRRD: Fixed a problem exporting built data cube.
03.11.2015 ENVI: Fixed a problem exporting built data cube.
03.24.2015 MOSAIC: mecube will now skip over tables and find all images.
04.08.2015 FITS++: fixed a problem with compressed fits files and static memory size. now using alloc.
04.13.2015 CATALOGS: fixed a problem with deleting the frame first, before closing a catalog dialog.
04.15.2015 CUBE: added support for reorder data cube axes.
04.16.2015 SMOOTH: blank/NaN values are no longer replaced by 0, instead, NaN is used.
04.17.2015 SMOOTH: is now threaded.
04.21.2015 GUI: add UNITS keyword to infobox.
04.23.2015 CUBE: reorder is now threaded.
04.24.2015 IEXAM: add macro expansion string.
04.27.2015 CHECKDNS: fixed a problem so that delay will -activate on time (and will return promptly).
04.27.2015 CHECKDNS: fixed a problem so that delay will activate on time (and will return promptly).
04.29.2015 TCL/TK: update to version 8.6.4.
04.30.2015 LAYOUT: add tile grid direction.
04.30.2015 GUI: add user selected keyword to -infobox.
04.30.2015 GUI: add user selected keyword to infobox.
05.21.2015 SCALE: add lock/match scalelimits.
05.29.2015 RELEASE version 7.4b1
06.09.2015 CATALOG: fixed a problem finding correct cols to -parse. Original bug introduced after 7.3.2.
06.09.2015 CATALOG: fixed a problem finding correct cols to parse. Original bug introduced after 7.3.2.
06.09.2015 RELEASE version 7.4b2
06.15.2015 SCALE: scaling for data cubes now use clip scope -(LOCAL/GLOBAL).
06.15.2015 SCALE: scaling for data cubes now use clip scope (LOCAL/GLOBAL).
06.18.2015 SCALE: Default scope is now GLOBAL.
06.18.2015 SCALE: MinMax mode AUTOSCAN has been -deprecated.
06.22.2015 GUI: fixed a font problem displaying greek -symbols.
06.18.2015 SCALE: MinMax mode AUTOSCAN has been deprecated.
06.22.2015 GUI: fixed a font problem displaying greek symbols.
06.22.2015 RELEASE version 7.4b3
06.29.2015 SKYVIEW: add survey and size options.
07.04.2015 RELEASE version 7.4b4
07.07.2015 VO: add additional code to use default url list -if unable to download list.txt for any reason.
07.14.2015 FITSY++: fixed a problem with RICE compression -and 4 byte INT to FLOAT conversions.
07.15.2015 FITSY++: fixed a problem with GZIP lossless -compression.
07.15.2015 FITSY++: Add support for GZIP_2 FITS -compression.
07.07.2015 VO: add additional code to use default url list if unable to download list.txt for any reason.
07.14.2015 FITSY++: fixed a problem with RICE compression and 4 byte INT to FLOAT conversions.
07.15.2015 FITSY++: fixed a problem with GZIP lossless compression.
07.15.2015 FITSY++: Add support for GZIP_2 FITS compression.
07.20.2015 RELEASE version 7.4b5
07.23.2015 FITSY++: fixed a problem with SAVE FITS and -writing NAXIS3=1 into the header.
07.23.2015 FITSY++: added check for fits table in SAVE FITS -TABLE.
07.23.2015 FITSY++: fixed a problem with SAVE FITS and writing NAXIS3=1 into the header.
07.23.2015 FITSY++: added check for fits table in SAVE FITS TABLE.
07.24.2015 RELEASE version 7.4b6
08.13.2015 REGIONS: fixed a problem with FITS CIAO PIE -region.
08.13.2015 REGIONS: fixed a problem with FITS CIAO ANNULUS -region.
08.13.2015 REGIONS: added support for FITS CIAO SECTOR and -ELLIPTANNULS regions.
08.16.2015 WCS: fixed a problem with reorder 3D -cubes.
08.13.2015 REGIONS: fixed a problem with FITS CIAO PIE region.
08.13.2015 REGIONS: fixed a problem with FITS CIAO ANNULUS region.
08.13.2015 REGIONS: added support for FITS CIAO SECTOR and ELLIPTANNULS regions.
08.16.2015 WCS: fixed a problem with reorder 3D cubes.
08.25.2015 COLORBAR: added MathLab colormaps.
08.25.2015 COLORBAR: added MatPlotLib colormaps.
08.26.2015 COLORBAR: added H5utils colormaps.
08.26.2015 COLORBAR: added GIST colormaps.
08.26.2015 COLORBAR: added Topographic colormaps.
08.28.2015 MOSAIC: fixed a problem introduced in 7.4b1 -which failed to ignore generic tables in extensions when loading -multiple extension fits.
09.03.2015 PAN: fixed a problem with pan then zoom -mode.
09.17.2015 IIS: fixed a problem with imexam introduced in -an earlier beta version.
09.17.2015 IIS: fixed a problem with imexam when a former -imexam frame has been delete.
08.28.2015 MOSAIC: fixed a problem introduced in 7.4b1 which failed to ignore generic tables in extensions when loading multiple extension fits.
09.03.2015 PAN: fixed a problem with pan then zoom mode.
09.17.2015 IIS: fixed a problem with imexam introduced in an earlier beta version.
09.17.2015 IIS: fixed a problem with imexam when a former imexam frame has been delete.
09.17.2015 MOSAIC: add IRAF DETSEC Align option.
09.18.2015 RELEASE version 7.4b7
09.21.2015 WCS: Look for old RADECSYS keyword if -present.
09.22.2015 CROSSHAIR: add crosshair parameters -dialog.
09.30.2015 TEMPLATES: fixed a problem with WCS introduced -in an earlier beta version.
09.21.2015 WCS: Look for old RADECSYS keyword if present.
09.22.2015 CROSSHAIR: add crosshair parameters dialog.
09.30.2015 TEMPLATES: fixed a problem with WCS introduced in an earlier beta version.
10.02.2015 SMOOTH: smooth on load now threaded.
10.02.2015 REGIONS: PLOT3D is disabled by -default.
10.13.2015 SAMP: fixed a issue with case of meta-data in -xmlrpc.
10.14.2015 GUI : fixed an issue where not all header -options were offered in the case of compressed fits -images.
10.14.2015 BACKUP : fixed a problem when creating a backup -with a file that has been compressed.
10.15.2015 SAMP: fixed a issue with results with empty -elements.
10.16.2015 LINUX: For all key press events, calculate the -current cursor position, as Ubuntu and MacOSX Aqua returns bad x,y -values.
10.21.2015 CATALOG: fixed a problem where a catalog had a -column of the same name as a variable.
10.26.2015 GUI: fixed a problem remembering the previous -filename loaded for standard dialogs.
10.30.2015 SAMP: fixed a issue with incorrect body length -in xmlrpc messages.
11.03.2015 3D: fixed a major issue introduced in the beta -7.4 series which caused a redraw everytime the current slice was -changed.
10.02.2015 REGIONS: PLOT3D is disabled by default.
10.13.2015 SAMP: fixed a issue with case of meta-data in xmlrpc.
10.14.2015 GUI : fixed an issue where not all header options were offered in the case of compressed fits images.
10.14.2015 BACKUP : fixed a problem when creating a backup with a file that has been compressed.
10.15.2015 SAMP: fixed a issue with results with empty elements.
10.16.2015 LINUX: For all key press events, calculate the current cursor position, as Ubuntu and MacOSX Aqua returns bad x,y values.
10.21.2015 CATALOG: fixed a problem where a catalog had a column of the same name as a variable.
10.26.2015 GUI: fixed a problem remembering the previous filename loaded for standard dialogs.
10.30.2015 SAMP: fixed a issue with incorrect body length in xmlrpc messages.
11.03.2015 3D: fixed a major issue introduced in the beta 7.4 series which caused a redraw everytime the current slice was changed.
11.03.2015 SCALE: Default scope is back to LOCAL.
11.04.2015 CONTOUR: Fixed lots of issues with interaction -with contours and bin/block/smooth.
11.04.2015 SCALE: remove old AUTOSCAN and SAMPLE -code.
11.09.2015 FITS: fixed issues with data all NAN or -INF.
11.09.2015 CUBE: fixed issues with selecting current slice -and updating other dialog boxes while in local mode.
11.04.2015 CONTOUR: Fixed lots of issues with interaction with contours and bin/block/smooth.
11.04.2015 SCALE: remove old AUTOSCAN and SAMPLE code.
11.09.2015 FITS: fixed issues with data all NAN or INF.
11.09.2015 CUBE: fixed issues with selecting current slice and updating other dialog boxes while in local mode.
11.11.2015 RELEASE version 7.4b8
11.11.2015 FITS: fixed another issue when calculating MIN -and MAX and one pixel images.
11.17.2015 WCS: fixed problem with infobox/grid with -xLN/xLT WCS.
11.11.2015 FITS: fixed another issue when calculating MIN and MAX and one pixel images.
11.17.2015 WCS: fixed problem with infobox/grid with xLN/xLT WCS.
11.18.2015 RELEASE version 7.4b9
11.30.2015 CATALOG: update CDS catalog search -parameters.
12.02.2015 BACKUP: fixed a problem with backup save sets -generated with beta versions.
12.03.2015 PREFS: fixed a problem with prefs generated with -beta versions.
12.07.2015 WCS: fixed a problem with replacement -WCS.
12.08.2015 WCS: cubes now share WCS structures (very -fast).
12.08.2015 ANALYSIS: fixed a problem with $z -macro.
11.30.2015 CATALOG: update CDS catalog search parameters.
12.02.2015 BACKUP: fixed a problem with backup save sets generated with beta versions.
12.03.2015 PREFS: fixed a problem with prefs generated with beta versions.
12.07.2015 WCS: fixed a problem with replacement WCS.
12.08.2015 WCS: cubes now share WCS structures (very fast).
12.08.2015 ANALYSIS: fixed a problem with $z macro.
12.10.2015 RELEASE version 7.4b10
12.11.2015 SAVEIMAGE: fixed a problem with the colorbar not -updating when used with -exit.
12.11.2015 SAVEIMAGE: fixed a problem with the colorbar not updating when used with -exit.
12.17.2015 FITS: 3D displayed z coord off by .5.
12.21.2015 RELEASE version 7.4
01.05.2016 XPA: update to version 2.1.17.
01.05.2016 FUNTOOLS: update to version 2.1.6.
01.21.2016 WCS: fixed a problem with PC3_3 being -ignored.
01.21.2016 WCS: fixed a problem with PC3_3 being ignored.
01.21.2016 WCS: add 3d axis params to WCS dialog.
01.25.2016 MACOSX: fixed a problem init Tkblt.
02.10.2016 MACOSX: fixed again the problem with font sizes -and screen dpi.
02.11.2016 WCS: fixed a problem with WCS replace and files -without linefeed termination.
03.07.2016 XPA: "tcl","source","print" commands only -enabled for local.
02.10.2016 MACOSX: fixed again the problem with font sizes and screen dpi.
02.11.2016 WCS: fixed a problem with WCS replace and files without linefeed termination.
03.07.2016 XPA: "tcl","source","print" commands only enabled for local.
03.07.2016 XPA: new xpa command.
03.07.2016 GUI: "tcl" command enabled from -commandline.
03.07.2016 PREFS: for security reasons, will only look for -the prefs file in the $HOME directory, and must be group/world -readonly.
03.07.2016 INIT FILE: will only look for any init file(s) -in the $HOME, /usr/local/lib, /opt/local/lib directories.
03.07.2016 INIT FILE: only read-only files will be -sourced.
03.07.2016 GUI: "tcl" command enabled from commandline.
03.07.2016 PREFS: for security reasons, will only look for the prefs file in the $HOME directory, and must be group/world readonly.
03.07.2016 INIT FILE: will only look for any init file(s) in the $HOME, /usr/local/lib, /opt/local/lib directories.
03.07.2016 INIT FILE: only read-only files will be sourced.
03.08.2016 SAMP: new samp command.
03.08.2016 SAMP: new ds9.restricted-get command.
03.08.2016 SAMP: new ds9.restricted-set command.
03.08.2016 HV: xpa-set is now in safe mode.
03.18.2016 GUI: Hard code font size. Give up on trying to -correct for screen resolution.
03.18.2016 REGION: fixed title issue with radial -plot.
03.18.2016 REGION: fixed title issue with 2d -plot.
03.28.2016 FITSY++: cube update clip is now -threaded.
03.30.2016 GUI: cleaned up initialization and event loop -code.
03.18.2016 GUI: Hard code font size. Give up on trying to correct for screen resolution.
03.18.2016 REGION: fixed title issue with radial plot.
03.18.2016 REGION: fixed title issue with 2d plot.
03.28.2016 FITSY++: cube update clip is now threaded.
03.30.2016 GUI: cleaned up initialization and event loop code.
03.30.2016 WCSSUBS: updated to version 3.9.0.
04.01.2016 GUI: default number of threads is now detected -based on OS.
04.01.2016 WCS: fixed a problem with region templates, -lengths were incorrect.
04.05.2016 GUI: added coordinates of min/max to -infobox.
04.05.2016 GUI: limit dialog status lines to 80 chars, so -the window will not expand off the screen.
04.06.2016 WCS: use getWCSOrientation() instead of -wcs->imflip for calcAlign and mapAngleTo/FromRef.
04.01.2016 GUI: default number of threads is now detected based on OS.
04.01.2016 WCS: fixed a problem with region templates, lengths were incorrect.
04.05.2016 GUI: added coordinates of min/max to infobox.
04.05.2016 GUI: limit dialog status lines to 80 chars, so the window will not expand off the screen.
04.06.2016 WCS: use getWCSOrientation() instead of wcs->imflip for calcAlign and mapAngleTo/FromRef.
04.14.2016 SCALE: fixed minmax mode SAMPLE.
04.14.2016 CUBE: update histogram and histequ when changing -current slice.
04.20.2016 MINMAX: reimplemented "-minmax sample" -commandline option for loading very large images..
04.21.2016 3D: fixed a problem with rendering the bbox when -endpoints are way off screen. Now clip against frame.
04.14.2016 CUBE: update histogram and histequ when changing current slice.
04.20.2016 MINMAX: reimplemented "-minmax sample" commandline option for loading very large images..
04.21.2016 3D: fixed a problem with rendering the bbox when endpoints are way off screen. Now clip against frame.
04.22.2016 3D: rendering speed improvements.
04.26.2016 3D: panner images are now cached.
04.27.2016 GUI: fixed a minor problem with header choice -box and no filename given for xpaset stdin commands.
04.27.2016 3D: dramatic improvements in render speed for -certain data sets.
04.27.2016 3D: fixed a problem with backup and 3D -pan.
05.04.2016 BIN: added keywords EQUINOX, MJD-OBS, and -RADESYS if present.
04.27.2016 GUI: fixed a minor problem with header choice box and no filename given for xpaset stdin commands.
04.27.2016 3D: dramatic improvements in render speed for certain data sets.
04.27.2016 3D: fixed a problem with backup and 3D pan.
05.04.2016 BIN: added keywords EQUINOX, MJD-OBS, and RADESYS if present.
05.06.2016 RELEASE version 7.5b1
05.11.2016 SCALE: fixed a problem where histequ colorbar -numerics displayed were incorrect.
05.18.2016 GUI: fixed a very minor problem where catalog -tools is invoked back to back via command line.
05.19.2016 REGIONS: many important changes to Ciao Region -parser to support current syntax. In particular, changes to BOX, -ROTBOX, RECTANGLE. SECTOR, FIELD, and REGION are now -no-ops.
05.11.2016 SCALE: fixed a problem where histequ colorbar numerics displayed were incorrect.
05.18.2016 GUI: fixed a very minor problem where catalog tools is invoked back to back via command line.
05.19.2016 REGIONS: many important changes to Ciao Region parser to support current syntax. In particular, changes to BOX, ROTBOX, RECTANGLE. SECTOR, FIELD, and REGION are now no-ops.
05.23.2016 TKCON: updated to version 2.7 proper.
05.24.2016 PREFS: check file permissions and set -accordingly.
05.24.2016 PREFS: new prefs file directory -implemented.
05.07.2016 STARTUP: for security reasons, will only look -for the startup file in the $HOME directory, and must be -group/world readonly.
05.24.2016 PREFS: check file permissions and set accordingly.
05.24.2016 PREFS: new prefs file directory implemented.
05.07.2016 STARTUP: for security reasons, will only look for the startup file in the $HOME directory, and must be group/world readonly.
05.31.2016 TKBLT: updated to version 3.1.
06.01.2016 TKBLT: updated to version 3.1.1.
06.20.2016 TKBLT: updated to version 3.1.2.
06.20.2016 FITSY++: fixed a problem where BZERO/BSCALE was -not applied to MIN/MAX for BITPIX=-32,-64.
06.27.2016 REGIONS: default regions coordinate system is -set to PHYSICAL if no WCS present.
06.28.2016 3D: fixed yet another problem with rendering -speed.
07.01.2016 FITSY++: look for MJD_OBS if MJD-OBS is not -present.
06.20.2016 FITSY++: fixed a problem where BZERO/BSCALE was not applied to MIN/MAX for BITPIX=-32,-64.
06.27.2016 REGIONS: default regions coordinate system is set to PHYSICAL if no WCS present.
06.28.2016 3D: fixed yet another problem with rendering speed.
07.01.2016 FITSY++: look for MJD_OBS if MJD-OBS is not present.
07.05.2016 IMGSRV: simplify code.
07.11.2016 IMGSRV: add support for VLSS.
07.12.2016 SIA: simple image access protocal -implemented.
07.12.2016 SIA: simple image access protocal implemented.
07.13.2016 RELEASE version 7.5b2
07.13.2016 SKYVIEW: updated survey options.
07.14.2016 IIS: fixed segv issue.
07.15.2016 RELEASE version 7.5b3
07.15.2016 TKBLT: upgrade to version 3.2.2.
07.15.2016 GUI: fixed an issue with sourcing init files and -'global ds9'.
07.15.2016 GUI: fixed an issue with sourcing init files and 'global ds9'.
07.15.2016 RELEASE version 7.5b4
07.21.2016 PRINT: scaling now implement without mods to Tk -source code.
07.21.2016 PRINT: give up on postscript scaling to screen -resolution. Print resolution of 72 equals screen -resolution.
07.25.2016 TKHTML: updated to version 1.0.3, fixed an -issues with corrupted screens under MacOSX.
07.21.2016 PRINT: scaling now implement without mods to Tk source code.
07.21.2016 PRINT: give up on postscript scaling to screen resolution. Print resolution of 72 equals screen resolution.
07.25.2016 TKHTML: updated to version 1.0.3, fixed an issues with corrupted screens under MacOSX.
07.26.2016 TCL/TK: update to version 8.6.5.
07.26.2016 BACKUP: fixed an issue with missing RGB -channels.
07.26.2016 BACKUP: fixed an issue with missing RGB channels.
07.27.2016 TCLLIB: update to version 1.15.
07.29.2016 PREFS: fixed a problem with name -server.
08.12.2016 REGIONS: Sky Coordinates are now formated for -precision of 1/1000 of arcsec.
08.16.2016 PLOT: fixed an issue with incorrect color for -bar chart.
08.18.2016 BIN: pass all keywords except manitory and -reserved.
09.02.2016 CONTOUR: new contour file format. DS9 can -read/write the new contour file format while continue support for -read the old contour file format.
09.06.2016 CONTOUR: can read contour levels from new format -while continue support for read and write old contour levels -format.
09.09.2016 REGION: fixed a problem where RULER was not -using the default length format.
09.14.2016 POSTSCRIPT: fixed a problem with PS level 3 -images.
07.29.2016 PREFS: fixed a problem with name server.
08.12.2016 REGIONS: Sky Coordinates are now formated for precision of 1/1000 of arcsec.
08.16.2016 PLOT: fixed an issue with incorrect color for bar chart.
08.18.2016 BIN: pass all keywords except manitory and reserved.
09.02.2016 CONTOUR: new contour file format. DS9 can read/write the new contour file format while continue support for read the old contour file format.
09.06.2016 CONTOUR: can read contour levels from new format while continue support for read and write old contour levels format.
09.09.2016 REGION: fixed a problem where RULER was not using the default length format.
09.14.2016 POSTSCRIPT: fixed a problem with PS level 3 images.
09.16.2016 RELEASE version 7.5rc
09.16.2016 MACOSX: add NSHighResolutionCapable attribute to -info.plist to support Retina displays.
10.05.2016 REGION: fixed a problem when contour "Convert to -Polygons" created polygon regions. Saving or listing the regions -caused a Segv.
10.05.2016 REGION: fixed a problem saving or listing -regions in WCS when no WCS is defined for the FITS image. The -regions file was corrupted.
10.05.2016 REGION: fixed a problem with Composite Regions -not properly updating when created. The region was not displayed -properly.
11.10.2016 MAGNIFIER: added check to prevent a SEGV in rare -cases.
11.15.2016 GUI: added check for bad "tk scaling" command -results, which can occur with high resolution monitors.
09.16.2016 MACOSX: add NSHighResolutionCapable attribute to info.plist to support Retina displays.
10.05.2016 REGION: fixed a problem when contour "Convert to Polygons" created polygon regions. Saving or listing the regions caused a Segv.
10.05.2016 REGION: fixed a problem saving or listing regions in WCS when no WCS is defined for the FITS image. The regions file was corrupted.
10.05.2016 REGION: fixed a problem with Composite Regions not properly updating when created. The region was not displayed properly.
11.10.2016 MAGNIFIER: added check to prevent a SEGV in rare cases.
11.15.2016 GUI: added check for bad "tk scaling" command results, which can occur with high resolution monitors.
12.15.2016 RELEASE version 7.5

diff --git a/ds9/doc/release/r7.6.html b/ds9/doc/release/r7.6.html index 0e3ebda..2045c5a 100644 --- a/ds9/doc/release/r7.6.html +++ b/ds9/doc/release/r7.6.html @@ -1,18 +1,13 @@ - - - + + + DS9 Version 7.6 Release Notes - -

SAOImageDS9 Version 7.6 Release Notes

+ +

SAOImageDS9 Version 7.6 Release Notes

12.15.2016 AST: updated to version 8.3.0.
12.15.2016 FUNTOOLS: updated to version 1.4.7.
12.15.2016 TCLLIB: updated to version 1.18.
12.15.2016 XPA: updated to version 2.1.18.
12.28.2016 BUILD: now builds properly on -OpenSUSE.
12.28.2016 BUILD: now builds properly on OpenSUSE.
01.03.2017 TKIMG: updated to version 1.4.6.
01.03.2017 WCS: fixed a problem with FITS WCS files that -use PCx_x keywords. Bug may have been introduced with version -7.4.
01.03.2017 WCS: fixed a problem with FITS WCS files that use PCx_x keywords. Bug may have been introduced with version 7.4.
01.04.2017 BUILD: Simplify Master build.
01.05.2017 TCLZVFS: updated TEA 3.10.
01.05.2017 TKBLT: updated TEA 3.10.
01.09.2017 TKHTML1: updated TEA 3.10.
01.09.2017 TKSAO: updated TEA 3.10.
01.11.2017 TKTABLE: updated TEA 3.10.
01.12.2017 GUI: fixed a problem with horizontal and -vertical graphs when image is zoomed out.
01.12.2017 GUI: fixed a problem with horizontal and vertical graphs when image is zoomed out.
01.13.2017 TCLXML: updated TEA 3.10.
01.13.2017 BUILD: Master build updated TEA 3.10.
01.13.2017 BUILD: DS9/unix updated TEA 3.10.
01.13.2017 BUILD: DS9/macosx updated TEA 3.10.
01.13.2017 BUILD: DS9/win updated TEA 3.10.
01.13.2017 MACOSX: complete new distribution -package.
01.13.2017 MACOSX: complete new distribution package.
01.26.2017 TKCON: updated TEA 3.10.
01.31.2017 XMM: Epic PN template updated.
02.04.2017 WINDOWS: complete new distribution -package.
02.04.2017 WINDOWS: complete new distribution package.
02.06.2017 WINDOWS: enabled pthreads suppport.
02.07.2017 TCLIIS: added support for windows -WINSOCK2.
03.03.2017 WCS: fixed a problem with position angle of -regions in case of WCS linear.
03.03.2017 WCS: No longer use DATE or EPOCH to determine -date of observation if MJD-OBS or DATE-OBS is not -present.
03.07.2017 SAMP: Fixed a problem with MacOSX Aqua -port.
03.08.2017 CONTOURS: Fixed a problem with 3D -cubes.
03.09.2017 SCALE: fixed nested loop issue with scale -dialog
03.09.2017 REGION: fixed a problem with ds9 regions format -not printing coordinate system in rare cases
03.09.2017 PANNER: limit how small panner highlite box is -displayed in cases where zoomed in.
03.10.2017 REGIONS: fixed a problem with reading XML files -with optional region parameters.
03.16.2017 IIS: fixed a minor problem if encode WCS is not -LINEAR.
03.16.2017 IIS: fixed a problem with colorscale -values.
03.16.2017 IIS: add check to prevent segv in case of -mismatch between buffer sizes.
03.17.2017 BACKUP: fixed an problem where any new WCS must -be applied before panning and regions.
03.17.2017 REGION: added filled regions (circle, ellipse, -box, polygon)
04.02.2017 SKYBOT: fixed an issue with API and added new -fields to dialog.
04.13.2017 GRAPH: fixed graphs issue when cursor off image -but in frame, which generated an Internal Error message.
02.07.2017 TCLIIS: added support for windows WINSOCK2.
03.03.2017 WCS: fixed a problem with position angle of regions in case of WCS linear.
03.03.2017 WCS: No longer use DATE or EPOCH to determine date of observation if MJD-OBS or DATE-OBS is not present.
03.07.2017 SAMP: Fixed a problem with MacOSX Aqua port.
03.08.2017 CONTOURS: Fixed a problem with 3D cubes.
03.09.2017 SCALE: fixed nested loop issue with scale dialog
03.09.2017 REGION: fixed a problem with ds9 regions format not printing coordinate system in rare cases
03.09.2017 PANNER: limit how small panner highlite box is displayed in cases where zoomed in.
03.10.2017 REGIONS: fixed a problem with reading XML files with optional region parameters.
03.16.2017 IIS: fixed a minor problem if encode WCS is not LINEAR.
03.16.2017 IIS: fixed a problem with colorscale values.
03.16.2017 IIS: add check to prevent segv in case of mismatch between buffer sizes.
03.17.2017 BACKUP: fixed an problem where any new WCS must be applied before panning and regions.
03.17.2017 REGION: added filled regions (circle, ellipse, box, polygon)
04.02.2017 SKYBOT: fixed an issue with API and added new fields to dialog.
04.13.2017 GRAPH: fixed graphs issue when cursor off image but in frame, which generated an Internal Error message.
04.20.2017 GRAPH: fixed graphs for mosaic image.
04.20.2017 GRAPH: Added support for Sum/Avg and -Thickness.
04.20.2017 GRAPH: In tile mode, graphs are repositioned -accordingly.
04.20.2017 GRAPH: Added support for Sum/Avg and Thickness.
04.20.2017 GRAPH: In tile mode, graphs are repositioned accordingly.
05.04.2017 HTTPS: is now supported.
05.04.2017 REGION: improved Ellipse X11 -rendering.
05.04.2017 WINDOWS: new 32bit and 64bit ports are now -supported.
05.04.2017 REGION: improved Ellipse X11 rendering.
05.04.2017 WINDOWS: new 32bit and 64bit ports are now supported.
05.04.2017 CATALOG: Add GAIA DR1 to menu.
05.04.2017 MOSAIC: fixed building mosaics base on -WCS[A-Z].
05.04.2017 REGION: fixed problem with dashed Pandas X11 -render.
05.04.2017 MOSAIC: fixed building mosaics base on WCS[A-Z].
05.04.2017 REGION: fixed problem with dashed Pandas X11 render.
05.15.2017 RELEASE version 7.6b1
05.26.2017 CONTOURS: Fixed a problem with load/copy/paste -contours.
05.26.2017 CONTOURS: Fixed a problem with load/copy/paste contours.
05.29.2017 RELEASE version 7.6b2
06.01.2017 FITS: Fixed a problem with Healpix RING -formats.
06.02.2017 CUBE: Fixed a problem with command line -cube -play command.
06.02.2017 GUI: Phyical and Image coordinates in the Info -box now displays with precision of 8.
06.26.2017 VO: Fixed a problem in case XPA is not -initialize.
06.26.2017 ANALYSIS: Fixed Clear Analysis Menu -command.
06.27.2017 WINDOWS: Fixed a problem with processing -keyevents at startup.
06.28.2017 TKHTML1: Fixed a problem with a compiler issue -with va_args and 64bit.
06.29.2017 TKHTML1: Properly init all memory -allocation.
06.01.2017 FITS: Fixed a problem with Healpix RING formats.
06.02.2017 CUBE: Fixed a problem with command line -cube play command.
06.02.2017 GUI: Phyical and Image coordinates in the Info box now displays with precision of 8.
06.26.2017 VO: Fixed a problem in case XPA is not initialize.
06.26.2017 ANALYSIS: Fixed Clear Analysis Menu command.
06.27.2017 WINDOWS: Fixed a problem with processing keyevents at startup.
06.28.2017 TKHTML1: Fixed a problem with a compiler issue with va_args and 64bit.
06.29.2017 TKHTML1: Properly init all memory allocation.
07.04.2017 RELEASE version 7.6b3
07.06.2017 XPA: set XPA_CONNECTION_TIMEOUT to 3 -secs.
07.06.2017 GUI: set title to rootname (removes any -extension).
07.06.2017 XPA: fixed an issue with setting XPA at startup -switch.
07.06.2017 XPA: set XPA_CONNECTION_TIMEOUT to 3 secs.
07.06.2017 GUI: set title to rootname (removes any extension).
07.06.2017 XPA: fixed an issue with setting XPA at startup switch.
07.10.2017 WINDOWS: fixed warp cursor.
07.31.2017 CUBE: disable axes reorder for 2D -images.
08.01.2017 WCS: Use default values for wcs keywords (CRPIX, -CRVAL, CDELT, CD, PC) if not present in header.
08.01.2017 CUBE: remove un-needed WCS keywords when saving -as a slice.
08.01.2017 CAT: selected rows blink markers in RED -(/GREEN).
08.01.2017 SMOOTH: separated function radius parameter from -kernel size parameter.
07.31.2017 CUBE: disable axes reorder for 2D images.
08.01.2017 WCS: Use default values for wcs keywords (CRPIX, CRVAL, CDELT, CD, PC) if not present in header.
08.01.2017 CUBE: remove un-needed WCS keywords when saving as a slice.
08.01.2017 CAT: selected rows blink markers in RED (/GREEN).
08.01.2017 SMOOTH: separated function radius parameter from kernel size parameter.
08.02.2017 SMOOTH: support elliptical gaussian.
08.07.2017 RULER: added length format spec. supports -sprintf syntax.
08.07.2017 RULER: added length format spec. supports sprintf syntax.
08.08.2017 TKMPEG: updated to version 1.0.4
08.08.2017 TKBLT: updated to version 3.2.7
08.15.2017 RELEASE version 7.6b4
08.14.2017 TCLIIS: updated to version 1.0.5
08.14.2017 TKHTML1: updated to version 1.0.8
08.14.2017 TKMPEG: updated to version 1.0.5
08.16.2017 FITSY++: FITS compression- fixed a problem with -ZQUANIZ=NO_DITHER.
08.16.2017 FITSY++: FITS compression- fixed a problem with -BITPIX=-64 and ZQUANTIZ=NONE.
08.16.2017 FITSY++: FITS compression- fixed a problem with ZQUANIZ=NO_DITHER.
08.16.2017 FITSY++: FITS compression- fixed a problem with BITPIX=-64 and ZQUANTIZ=NONE.
08.18.2017 RELEASE version 7.6b5
08.22.2017 GUI: don't update screen until end when loading -mulitple files from command line.
08.24.2017 3D: fixed a problem with frame 3d -backup.
08.22.2017 GUI: don't update screen until end when loading mulitple files from command line.
08.24.2017 3D: fixed a problem with frame 3d backup.
08.24.2017 3D: add match/lock support.
09.01.2017 RULER: fixed a problem creating via -GUI.
09.13.2017 ELLIPSE: fixed a problem creating via GUI at -zoom other than 1.
09.14.2017 CONTOURS: add ability to load new contour format -using original color, width, and dash options as specified in -file.
09.14.2017 WCS: fixed a problem with calculating the -rotation angle of regions with a LINEAR WCS which has been flipped. -This bug was introduced with version 7.6b1.
09.18.2017 GUI: update info box when new file -loaded.
09.01.2017 RULER: fixed a problem creating via GUI.
09.13.2017 ELLIPSE: fixed a problem creating via GUI at zoom other than 1.
09.14.2017 CONTOURS: add ability to load new contour format using original color, width, and dash options as specified in file.
09.14.2017 WCS: fixed a problem with calculating the rotation angle of regions with a LINEAR WCS which has been flipped. This bug was introduced with version 7.6b1.
09.18.2017 GUI: update info box when new file loaded.
09.19.2017 TCLZVFS: updated to version 1.0.5
09.20.2017 MACOS: fixed a problem with the standard save -file dialog box. Second time thru, an invalid filename was being -generated.
09.20.2017 MACOS: fixed a problem with the standard save file dialog box. Second time thru, an invalid filename was being generated.
09.21.2017 TCL/TK: updated to version 8.6.7.
09.25.2017 VO: rm checkdns from init sequence
09.25.2017 XPA: rm checkdns from init sequence
09.29.2017 WCS: fixed a problem with use of PC keywords, -with CDELT = 1.
09.29.2017 WCS: fixed a problem with use of PC keywords, with CDELT = 1.
10.01.2017 RELEASE version 7.6b6
10.04.2017 FITSY++: FITS compresssion- fixed a problem with -ZNAXIS3=0 keyword issue.
10.16.2017 CATALOG: cat plot line command incorrectly finds -'Xerr' and 'Yerr' columns.
10.16.2017 CATALOG: match sometimes failed to find proper -catalogs.
10.17.2017 TCL/TK: updated to version -core_8_6_branch.
10.04.2017 FITSY++: FITS compresssion- fixed a problem with ZNAXIS3=0 keyword issue.
10.16.2017 CATALOG: cat plot line command incorrectly finds 'Xerr' and 'Yerr' columns.
10.16.2017 CATALOG: match sometimes failed to find proper catalogs.
10.17.2017 TCL/TK: updated to version core_8_6_branch.
10.18.2017 RELEASE version 7.6b7
10.26.2017 XPA: updated to version 2.1.18+.
10.26.2017 CUBE: be sure to raise Cube Dialog when cube -data is loaded via command line.
10.26.2017 XPA: default XPA_METHOD is now -localhost.
10.30.2017 MACOS: removed codesign step during -build.
10.26.2017 CUBE: be sure to raise Cube Dialog when cube data is loaded via command line.
10.26.2017 XPA: default XPA_METHOD is now localhost.
10.30.2017 MACOS: removed codesign step during build.
10.31.2017 RELEASE version 7.6b8
11.27.2017 MMT: updated Binospec template.
11.27.2017 REGION: fixed an issue where region templates -are rendered incorrectly in the case where the WCS RA and DEC axes -have been flipped in the definition.
11.27.2017 REGION: fixed an issue where region templates are rendered incorrectly in the case where the WCS RA and DEC axes have been flipped in the definition.
12.08.2017 AST: updated to version 8.4.0.
12.20.2017 REGION: fixed a problem with regions statistics. -VAR (and STDDEV) were overflowing with large counts.
12.20.2017 REGION: fixed a problem with regions statistics. VAR (and STDDEV) were overflowing with large counts.
01.02.2018 TCL/TK: updated to version 8.6.8.
01.09.2018 AST: updated to version 8.6.2.
01.10.2018 GUI: up prec of displayed coords for deg and -hms.
01.10.2018 GUI: up prec of displayed coords for deg and hms.
01.11.2018 CATALOG: update CDS server list.
01.12.2018 PREFS: add support for user defined -precision.
01.23.2018 XPA: upgrade xpa to fix an issue with gcc -7.2.
02.12.2018 FITSY++: fixed an issue with the logic of -locating keywords in current hdu and then the primary -hdu.
02.13.2018 GUI: fixed an issue with the panner not updating -properly on initial load.
02.13.2018 GUI: fixed an issue with current zoom and block -factor and menu selection.
02.14.2018 SMOOTH: fixed a problem when creating a new -frame with smoothing enabled. Bug introduced in version -7.6b4.
01.12.2018 PREFS: add support for user defined precision.
01.23.2018 XPA: upgrade xpa to fix an issue with gcc 7.2.
02.12.2018 FITSY++: fixed an issue with the logic of locating keywords in current hdu and then the primary hdu.
02.13.2018 GUI: fixed an issue with the panner not updating properly on initial load.
02.13.2018 GUI: fixed an issue with current zoom and block factor and menu selection.
02.14.2018 SMOOTH: fixed a problem when creating a new frame with smoothing enabled. Bug introduced in version 7.6b4.
04.15.2018 RELEASE version 7.6

diff --git a/ds9/doc/release/r8.0.html b/ds9/doc/release/r8.0.html index 0fa3f92..b913a5a 100644 --- a/ds9/doc/release/r8.0.html +++ b/ds9/doc/release/r8.0.html @@ -1,130 +1,74 @@ - - - + + + DS9 Version 8.0 Release Notes - -

SAOImageDS9 Version 8.0 Release Notes

+ +

SAOImageDS9 Version 8.0 Release Notes

04.18.2018 GUI: fixed an issue with loading gzipped -multiple extension fits files with the -multiframe -option.
04.18.2018 GUI: fixed an issue with loading gzipped multiple extension fits files with the -multiframe option.
05.25.2018 MMT: updated Binospec template.
06.12.2018 CATALOG: GUI now uses a conesearch radius for -query.
06.12.2018 SIA: GUI now uses a conesearch radius for -query.
06.13.2018 FITSY++: be sure to output REAL header keywords -with scientific notation with capital 'E', per FITS -standard.
06.14.2018 CATALOG: add Edit menu to Symbol -dialog.
06.14.2018 NRRD: fixed a problem exporting, an extra byte -was being written.
06.15.2018 IIS: fixed a problem introduced in version 7.6 -with the colormap.
06.15.2018 IIS: fixed a problem the values displayed on the -colorbar.
06.22.2018 API: All new parser/lexer for each command, -backward compatible API. Parser will detect syntax errors, and -suggest options.
06.22.2018 CATALOG: updated catalog menu items for GAIA, -UCAC, and SDSS.
06.25.2018 REGIONS: added support for compressed regions -files.
06.12.2018 CATALOG: GUI now uses a conesearch radius for query.
06.12.2018 SIA: GUI now uses a conesearch radius for query.
06.13.2018 FITSY++: be sure to output REAL header keywords with scientific notation with capital 'E', per FITS standard.
06.14.2018 CATALOG: add Edit menu to Symbol dialog.
06.14.2018 NRRD: fixed a problem exporting, an extra byte was being written.
06.15.2018 IIS: fixed a problem introduced in version 7.6 with the colormap.
06.15.2018 IIS: fixed a problem the values displayed on the colorbar.
06.22.2018 API: All new parser/lexer for each command, backward compatible API. Parser will detect syntax errors, and suggest options.
06.22.2018 CATALOG: updated catalog menu items for GAIA, UCAC, and SDSS.
06.25.2018 REGIONS: added support for compressed regions files.
07.06.2018 CUBE: fixed cube slice dialog slider.
07.10.2018 ANALYSIS: added current slice control to maker -analysis plot 3d.
07.11.2018 BACKUP: fixed an issue when data range is -NAN.
07.20.2018 BIN: fixed an issue introduced in version 7.6 -where repeat bin calls incorrectly scaled markers and -contours.
07.31.2018 REGION: fixed an problem introduced in version -7.6 with angles with a wcs which is flipped in X.
08.06.2018 GUI: fixed an problem introduced in version 7.6 -with bracket filename options in standard dialog boxes.
08.22.2018 WCS: implemented all new wcs support based on -AST. DS9 is fully compliant with FITS WCS Papers I, II, -III.
08.22.2018 CUBE: plot3d current slice is coordinated with -cube dialog box.
08.22.2018 BIN: fixed a problem in the case of a RGB image -has a binned layer, changing bin parameters in other layers caused -cursor movement.
08.22.2018 REGION: plot2d now extends across mosaic -boundries.
07.10.2018 ANALYSIS: added current slice control to maker analysis plot 3d.
07.11.2018 BACKUP: fixed an issue when data range is NAN.
07.20.2018 BIN: fixed an issue introduced in version 7.6 where repeat bin calls incorrectly scaled markers and contours.
07.31.2018 REGION: fixed an problem introduced in version 7.6 with angles with a wcs which is flipped in X.
08.06.2018 GUI: fixed an problem introduced in version 7.6 with bracket filename options in standard dialog boxes.
08.22.2018 WCS: implemented all new wcs support based on AST. DS9 is fully compliant with FITS WCS Papers I, II, III.
08.22.2018 CUBE: plot3d current slice is coordinated with cube dialog box.
08.22.2018 BIN: fixed a problem in the case of a RGB image has a binned layer, changing bin parameters in other layers caused cursor movement.
08.22.2018 REGION: plot2d now extends across mosaic boundries.
08.28.2018 BACKUP: restore crosshair cursor.
08.31.2018 SMOOTH: fixed an issue with old -backups.
08.31.2018 SMOOTH: fixed an issue with old backups.
09.03.2018 RELEASE version 8.0rc
09.04.2018 REGION: accept 'point' as a region shape, -defaulting to 'boxcircle'.
09.04.2018 REGION: fixed a problem with plot3d, incorrectly -calculating an index into the data cube.
09.04.2018 REGION: accept 'point' as a region shape, defaulting to 'boxcircle'.
09.04.2018 REGION: fixed a problem with plot3d, incorrectly calculating an index into the data cube.
09.04.2018 GUI: removed old keyboard doc button.
09.04.2018 DOC: cleaned up html documentation.
09.04.2018 RELEASE version 8.0rc2
09.19.2018 WCS: fix a memory ref with short axes symbols -(aka 'b')
09.19.2018 WCS: fix a problem starting in crosshair mode -set in prefs and infobox update with 2D frame.
09.19.2018 PREFS: fix a problem updating from 7.6 to -8.0.
09.21.2018 GUI: use unicode for deg symbol in infobox, -previous char caused conflicts with Chinese Language.
09.19.2018 WCS: fix a memory ref with short axes symbols (aka 'b')
09.19.2018 WCS: fix a problem starting in crosshair mode set in prefs and infobox update with 2D frame.
09.19.2018 PREFS: fix a problem updating from 7.6 to 8.0.
09.21.2018 GUI: use unicode for deg symbol in infobox, previous char caused conflicts with Chinese Language.
09.21.2018 AST: updated to version 8.6.3.
09.21.2018 TKBLT: updated to version 3.2.11.
09.24.2018 BIN: use old style Einstein WCS keywords if -present.
09.24.2018 PAN: tweak pan parser for backward -compatibility.
09.24.2018 BIN: use old style Einstein WCS keywords if present.
09.24.2018 PAN: tweak pan parser for backward compatibility.
09.25.2018 RELEASE version 8.0rc3
09.26.2018 BIN: fixed old style Einstein WCS keyword -CRVAL2.
09.26.2018 BIN: fixed old style Einstein WCS keyword CRVAL2.
09.26.2018 RELEASE version 8.0rc4
09.27.2018 REGION: Plot2d,Plot3d,Histogram- use BUNIT -keyword if available.
09.27.2018 WCS: Tweaked -TAB code to find WCS HDU extension -easier.
09.30.2018 CONTOURS: fixed contour parser nlevels problem, -again.
09.30.2018 CONTOURS: changed contour limits behavior. Now -set mode to USER when limits are set and update dialog -accordingly.
10.01.2018 API: Tweaked parsers to fix issue with XPA/SAMP -error messages.
09.27.2018 REGION: Plot2d,Plot3d,Histogram- use BUNIT keyword if available.
09.27.2018 WCS: Tweaked -TAB code to find WCS HDU extension easier.
09.30.2018 CONTOURS: fixed contour parser nlevels problem, again.
09.30.2018 CONTOURS: changed contour limits behavior. Now set mode to USER when limits are set and update dialog accordingly.
10.01.2018 API: Tweaked parsers to fix issue with XPA/SAMP error messages.
10.02.2018 RELEASE version 8.0rc5
10.08.2018 FITS: command -url: accept mime type 'text' as -'fits'.
10.16.2018 API: fixed an issue with CommReturn, so that it -returns at the top level.
10.16.2018 SAMP: added -keepalive to http::geturl calls in -cases of retreiveing large files from servers that use -Transport-encoding: chunked.
10.17.2018 SAMP: reset http token in case of -error.
10.17.2018 CUBE: fixed an issue with properly rounding -slice number.
10.08.2018 FITS: command -url: accept mime type 'text' as 'fits'.
10.16.2018 API: fixed an issue with CommReturn, so that it returns at the top level.
10.16.2018 SAMP: added -keepalive to http::geturl calls in cases of retreiveing large files from servers that use Transport-encoding: chunked.
10.17.2018 SAMP: reset http token in case of error.
10.17.2018 CUBE: fixed an issue with properly rounding slice number.
10.18.2018 RELEASE version 8.0rc6
11.03.2018 BACKUP: fixed an issue with soft -links.
11.03.2018 BACKUP: fixed an issue with soft links.
12.15.2018 RELEASE version 8.0
12.26.2018 VIEW: fixed view graph command.
01.03.2019 DS9: fixed a problem with MacOS Aqua and Windows -unable to locate ds9 parser scripts at startup.
01.03.2019 DS9: fixed a problem with MacOS Aqua and Windows unable to locate ds9 parser scripts at startup.
01.03.2019 SCALE: fixed scale command.
01.03.2019 PRINT: add backward compatible options for -resolution to command.
01.03.2019 PRINT: add backward compatible options for resolution to command.
01.03.2019 TILE: fix tile grid layout command.
01.07.2019 RELEASE version 8.0.1

diff --git a/ds9/doc/release/r8.1.html b/ds9/doc/release/r8.1.html index 9905f1e..f95e14c 100644 --- a/ds9/doc/release/r8.1.html +++ b/ds9/doc/release/r8.1.html @@ -1,44 +1,27 @@ - - - + + + DS9 Version 8.1 Release Notes - -

SAOImageDS9 Version 8.1 Release Notes

+ +

SAOImageDS9 Version 8.1 Release Notes

10.29.2018 BLOCK: all supported WCSs now updated to reflect -blocking.
10.30.2018 WFPC2: fixed an issue with blocking and WFPC2 -images.
11.02.2018 MASK: mask now supports WCS, in addition to -physical, image.
11.06.2018 SAVEIMAGE: all supported WCSs now updated to -reflect current rotation, orientation, pan, and zoom.
10.29.2018 BLOCK: all supported WCSs now updated to reflect blocking.
10.30.2018 WFPC2: fixed an issue with blocking and WFPC2 images.
11.02.2018 MASK: mask now supports WCS, in addition to physical, image.
11.06.2018 SAVEIMAGE: all supported WCSs now updated to reflect current rotation, orientation, pan, and zoom.
11.26.2018 TCL/TK: updated to version 8.6.9.
12.07.2018 CONTOURS: merge old and new contour parsers so -that regardless of file extension, the file will be correctly -parsed.
12.10.2018 CONTOURS: LEVELS command now takes one numeric -in addition to a string.
12.14.2018 GRID: add checks to avoid NULL pointers in cases -of odd WCS defs.
12.14.2018 BINNING: bring forward any 3rd column WCS -defines for binned 3d cubes.
12.14.2018 PLOT3D: verify 3D WCS, reset to IMAGE if not -available.
12.19.2018 SAVEIMAGE: is now supported under -Windows.
12.19.2018 MOVIE3D: is now supported under -Windows.
12.07.2018 CONTOURS: merge old and new contour parsers so that regardless of file extension, the file will be correctly parsed.
12.10.2018 CONTOURS: LEVELS command now takes one numeric in addition to a string.
12.14.2018 GRID: add checks to avoid NULL pointers in cases of odd WCS defs.
12.14.2018 BINNING: bring forward any 3rd column WCS defines for binned 3d cubes.
12.14.2018 PLOT3D: verify 3D WCS, reset to IMAGE if not available.
12.19.2018 SAVEIMAGE: is now supported under Windows.
12.19.2018 MOVIE3D: is now supported under Windows.
12.27.2018 TCLIIS: update TEA to 3.13.
12.27.2018 TKSAO: update TEA to 3.13.
12.29.2018 TKMACOSX: update TEA to 3.13.
01.07.2019 TKMPEG: update TEA to 3.13.
01.07.2019 TKTABLE: update TEA to 3.13.
01.08.2019 TKIMG: updated to version 1.4.7
01.17.2019 TCLZIPFS: now using tclzipfs for unix -port.
01.22.2019 MACOS: fixed image byte order bug with TCL/TK -8.6.
01.23.2019 MACOS: fix rotate/colormap issues with TCL/TK -8.6.
01.23.2019 MACOS: fixed 3D magnifier issues with TCL/TK -8.6.
01.24.2019 SAVEIMAGE: is now supported under MacOS -Aqua.
01.24.2019 MOVIE3D: is now supported under -Windows.
01.24.2019 MOVIE3D: is now supported under MacOS -Aqua.
01.17.2019 TCLZIPFS: now using tclzipfs for unix port.
01.22.2019 MACOS: fixed image byte order bug with TCL/TK 8.6.
01.23.2019 MACOS: fix rotate/colormap issues with TCL/TK 8.6.
01.23.2019 MACOS: fixed 3D magnifier issues with TCL/TK 8.6.
01.24.2019 SAVEIMAGE: is now supported under MacOS Aqua.
01.24.2019 MOVIE3D: is now supported under Windows.
01.24.2019 MOVIE3D: is now supported under MacOS Aqua.
02.11.2019 WCS: 1D WCS is now supported.
02.11.2019 WCS: Increase WCS params dialog to full 4 -axes.
02.14.2019 BIN: fix binning physical in case of no -WCS.
02.11.2019 WCS: Increase WCS params dialog to full 4 axes.
02.14.2019 BIN: fix binning physical in case of no WCS.
02.15.2019 TCLLIB: updated to version 1.19.
02.26.2019 GUI: add command "preserve scale" for backward -compatibility.
02.28.2019 TKBLT: fixed postscript bounding box -issue.
03.01.2019 PLOT: removed old split data sets from plot -widgets.
03.02.2019 SHM: fixed type in loading shared memory -segments.
03.04.2019 CATALOG: fixed issue allowing column names for -size/size2/angle via parser.
02.26.2019 GUI: add command "preserve scale" for backward compatibility.
02.28.2019 TKBLT: fixed postscript bounding box issue.
03.01.2019 PLOT: removed old split data sets from plot widgets.
03.02.2019 SHM: fixed type in loading shared memory segments.
03.04.2019 CATALOG: fixed issue allowing column names for size/size2/angle via parser.
03.06.2019 PLOT: update error cap documentation.
03.06.2019 PLOT: Line Plot, add 0 width option to Width -Menu.
03.06.2019 PLOT: Line Plot, add 0 width option to Width Menu.
03.06.2019 PLOT: support graph background color.
03.06.2019 PLOT: add plot export to -gif,png,tiff,jpeg.
03.06.2019 PLOT: add plot export to gif,png,tiff,jpeg.
03.07.2019 TKBLT: fix segv Marker Op delete.
03.18.2019 CONTOURS: contours are now threaded.
03.18.2019 CONTOURS: default contour method is now -smooth.
03.18.2019 CONTOURS: default contour method is now smooth.
03.19.2019 TKIMG: update to verision 1.4.9.
03.21.2019 PLOT: removed old sequence flag.
03.25.2019 MOVIE: fixed movie 3d to/from params -issues.
03.25.2019 MOVIE: add support for animated gif -movies.
03.25.2019 MOVIE: fixed movie 3d to/from params issues.
03.25.2019 MOVIE: add support for animated gif movies.
03.28.2019 3D: add 3D mouse mode.
03.28.2019 GIF: use native Tk gif.
03.28.2019 PNG: use native Tk png.
04.16.2019 GUI: fix math::fuzzy issue with MacOS -Aqua.
04.17.2019 MACOS: fix issue with analysis filedialog macro -and MacOS Aqua.
04.16.2019 GUI: fix math::fuzzy issue with MacOS Aqua.
04.17.2019 MACOS: fix issue with analysis filedialog macro and MacOS Aqua.
04.22.2019 TCL/TK: downgrade to version 8.6.8.
04.22.2019 GUI: rotate image and change colorbar now uses -full render algorithm.
04.23.2019 MASK: default systems is now WCS (similar to -RGB).
04.25.2019 MASK: fixed an issue with mask and -backups.
04.25.2019 BACKUP: fixed an issue with reading version 6.x -backup files.
04.22.2019 GUI: rotate image and change colorbar now uses full render algorithm.
04.23.2019 MASK: default systems is now WCS (similar to RGB).
04.25.2019 MASK: fixed an issue with mask and backups.
04.25.2019 BACKUP: fixed an issue with reading version 6.x backup files.
04.25.2019 CUBE: add 'get cube coordsys command'
xx.xx.2019 RELEASE version 8.1b1

-- cgit v0.12 From 3de51ebd8f1c533d7cc1fb62ac93682eb03229ee Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 14:22:50 -0400 Subject: clean up html --- ds9/doc/acknowledgment.html | 48 ++-- ds9/doc/faq.html | 655 ++++++++++---------------------------------- ds9/doc/helpdesk.html | 18 +- ds9/doc/install.html | 35 +-- ds9/doc/story.html | 64 +---- ds9/doc/tutorial.html | 24 +- 6 files changed, 193 insertions(+), 651 deletions(-) diff --git a/ds9/doc/acknowledgment.html b/ds9/doc/acknowledgment.html index 49c5f1e..1333559 100644 --- a/ds9/doc/acknowledgment.html +++ b/ds9/doc/acknowledgment.html @@ -1,34 +1,20 @@ - - - - - DS9 Acknowledgment - - -

- SAOImageDS9 Acknowledgment

-
DS9 development has been made possible by funding from the - Chandra X-ray Science Center (CXC) (NAS8-03060) and the High - Energy Astrophysics Science Archive Center (HEASARC) (NCC5-568). - Additional funding was provided by the JWST Mission office at - Space Telescope Science Institute (NAS-03127) to improve - capabilities for 3-D data visualization.
-
-
If you have found DS9 to be helpful in your research, the - following acknowledgment would be appreciated
-
-
"This research has made use of SAOImageDS9, developed by - Smithsonian Astrophysical Observatory"
-
-
or reference the following paper 2003adass..295..489J
-

- + + + + +DS9 Acknowledgment + + +

SAOImageDS9 Acknowledgment

+
DS9 development has been made possible by funding from the Chandra X-ray Science Center (CXC) (NAS8-03060) and the High Energy Astrophysics Science Archive Center (HEASARC) (NCC5-568). Additional funding was provided by the JWST Mission office at Space Telescope Science Institute (NAS-03127) to improve capabilities for 3-D data visualization.
+
If you have found DS9 to be helpful in your research, the following acknowledgment would be appreciated
+
+
"This research has made use of SAOImageDS9, developed by Smithsonian Astrophysical Observatory"
+
+
or reference the following paper 2003adass..295..489J
+

+ diff --git a/ds9/doc/faq.html b/ds9/doc/faq.html index 3e4ab82..07a7427 100644 --- a/ds9/doc/faq.html +++ b/ds9/doc/faq.html @@ -1,22 +1,15 @@ - - - + + + DS9 FAQ - -

SAOImageDS9 FAQ

-
This FAQ is a new, on going project, and it is far from being -complete. But as common questions on DS9 are received, the FAQ will -be updated.
+ +
SAOImageDS9 FAQ
+
+
This FAQ is a new, on going project, and it is far from being complete. But as common questions on DS9 are received, the FAQ will be updated.

Contents

Copyright
General
@@ -35,241 +28,92 @@ be updated.

Copyright

-
DS9 is composed of approximately 20 open source packages, all of -which are distributed under their own open source license -agreements, usually GPL, LGPL, or BSD. In addition, several open -source packages have been developed here at the Smithsonian -Astrophysical Observatory, Cambridge, MA, USA and are distributed -under the terms of the GNU General Public License as published by -the Free Software Foundation. As long as you continue to adhere to -the provisions of the licenses, you are free to distribute DS9 -along with your software.
-
The GNU site -contains an excellent FAQ on the the dos and donts of GPL.
+
DS9 is composed of approximately 20 open source packages, all of which are distributed under their own open source license agreements, usually GPL, LGPL, or BSD. In addition, several open source packages have been developed here at the Smithsonian Astrophysical Observatory, Cambridge, MA, USA and are distributed under the terms of the GNU General Public License as published by the Free Software Foundation. As long as you continue to adhere to the provisions of the licenses, you are free to distribute DS9 along with your software.
+
The GNU site contains an excellent FAQ on the the dos and donts of GPL.

General

-
The web browser, catalog tool, image server, and other -Analysis functions don't appear to work. Whats going -on?
-
For a number of the Analysis functions, DS9 requires temporary -disk space to download and store data. By default, this directory -is defined by the TMP or TEMP environment variable. This is usually -defined as /tmp for Linux and MacOSX users. For Windows -users, this will vary, depending on which version of Windows you -have. In any case, if the temp directory is not writable, or you -have specified an invalid directory in the preferences, these -functions will fail with a variety of error messages.
-
My system admin stripped the DS9 binary and now DS9 fails to -start with the following error message:
-
Application initialization failed: Can't find a usable -tk.tcl in the following directories...
-
DS9 is based on tcl/tk which is a scripting language which -requires many support files. To create a stand alone application, -we fool tcl/tk into thinking that it has a valid -installation. To do this, DS9 is really an application, along with -an zip archive attached. The first thing DS9 does is to create a -virtual file system in memory and unpack that archive into memory. -The application DS9 is already stripped of debugging symbols when -built.
-
It appears that the strip command is stripping -part of the archive, hence DS9 is unable to un-compress it. In -summary, don't strip the DS9 binary and everything works -fine.
-
When I open my FITS image, all I see is 'white'. Yet -everything, including the color bar seems to work?
-
New with version 2.1, is support for the DATASEC keyword. This -keyword specifies what portion of the image is valid data, for -calculating min / max and for displaying. This is very important -for images created from CCDs with over scan and bias strips. By -default, this support is enabled. However, a number of fits images -with this keyword, have invalid values. Therefor, when DS9 opens -the image, it finds no valid data to display. To correct this -problem, either disable DATASEC support, via the Scale menu, or -correct the the value of DATASEC in the fits header. You can also -change the default behavior by disabling DATASEC from the -preferences menu.
+
The web browser, catalog tool, image server, and other Analysis functions don't appear to work. Whats going on?
+
For a number of the Analysis functions, DS9 requires temporary disk space to download and store data. By default, this directory is defined by the TMP or TEMP environment variable. This is usually defined as /tmp for Linux and MacOSX users. For Windows users, this will vary, depending on which version of Windows you have. In any case, if the temp directory is not writable, or you have specified an invalid directory in the preferences, these functions will fail with a variety of error messages.
+
My system admin stripped the DS9 binary and now DS9 fails to start with the following error message:
+
Application initialization failed: Can't find a usable tk.tcl in the following directories...
+
DS9 is based on tcl/tk which is a scripting language which requires many support files. To create a stand alone application, we fool tcl/tk into thinking that it has a valid installation. To do this, DS9 is really an application, along with an zip archive attached. The first thing DS9 does is to create a virtual file system in memory and unpack that archive into memory. The application DS9 is already stripped of debugging symbols when built.
+
It appears that the strip command is stripping part of the archive, hence DS9 is unable to un-compress it. In summary, don't strip the DS9 binary and everything works fine.
+
When I open my FITS image, all I see is 'white'. Yet everything, including the color bar seems to work?
+
New with version 2.1, is support for the DATASEC keyword. This keyword specifies what portion of the image is valid data, for calculating min / max and for displaying. This is very important for images created from CCDs with over scan and bias strips. By default, this support is enabled. However, a number of fits images with this keyword, have invalid values. Therefor, when DS9 opens the image, it finds no valid data to display. To correct this problem, either disable DATASEC support, via the Scale menu, or correct the the value of DATASEC in the fits header. You can also change the default behavior by disabling DATASEC from the preferences menu.

Fonts

-
Where is the Symbol Font? How do I enter special characters -into an entry dialog?
-
The concept of a separate SYMBOL font is no longer -implemented with the latest OS font and scripting support, -especially with scalable anti-alias fonts such as Xft for Linux. -Most newer fonts (if not all) now have greek characters as part of -the font. The greek chars start at unicode \u0391 for 'A' and -\u03b1 for 'a'. Each OS has a tool used to build and copy a string -of characters. Then use the Edit:Paste menu of DS9 to insert the -character string.
-
Linux- Gnome: gucharmap
Linux- KDE: -kcharselect
MacOSX: Character Viewer (Select -Edit:Special Characters) Now click and drag the characters -to a terminal window. Then select the string and select -Edit:Copy.
-Windows: Character Map (from Start button, select -All Programs, Accessories, System Tools -and then Character Map)
+
Where is the Symbol Font? How do I enter special characters into an entry dialog?
+
The concept of a separate SYMBOL font is no longer implemented with the latest OS font and scripting support, especially with scalable anti-alias fonts such as Xft for Linux. Most newer fonts (if not all) now have greek characters as part of the font. The greek chars start at unicode \u0391 for 'A' and \u03b1 for 'a'. Each OS has a tool used to build and copy a string of characters. Then use the Edit:Paste menu of DS9 to insert the character string.
+
Linux- Gnome: gucharmap
Linux- KDE: kcharselect
MacOSX: Character Viewer (Select Edit:Special Characters) Now click and drag the characters to a terminal window. Then select the string and select Edit:Copy.
+Windows: Character Map (from Start button, select All Programs, Accessories, System Tools and then Character Map)

Linux

-
My /tmp directory is mounted -noexec and bin table filtering -does not work.
-
Set the environment variable FILTER_TMPDIR to a directory that -is both writable and can execute.
-
I have Red Hat 7, and I'm running KDE. The magnifier keeps -going blank after a few seconds, what's going on?
-
The problem was in KDE. If the user has decided to hide the -panel taskbar and sets a delay time for when it appears if -the mouse is moved to the panel location, then it appears -that KDE creates mouse events that fool DS9 into thinking the -mouse is outside and it blanks the magnifier. By turning off -the hide panel, the effect goes away. The alternative is to -update to KDE2.1Beta where this method of dealing with the -hidden panel is not used and all is well, as it was for -KDE
-
I have FreeBSD. When I run ds9, I get the following -error: ELF binary type "0" not known -Whats going on?
-
The solution was to use the brandelf utility on -the file to ensure that the machine understood that it was a -Linux program.
+
My /tmp directory is mounted -noexec and bin table filtering does not work.
+
Set the environment variable FILTER_TMPDIR to a directory that is both writable and can execute.
+
I have Red Hat 7, and I'm running KDE. The magnifier keeps going blank after a few seconds, what's going on?
+
The problem was in KDE. If the user has decided to hide the panel taskbar and sets a delay time for when it appears if the mouse is moved to the panel location, then it appears that KDE creates mouse events that fool DS9 into thinking the mouse is outside and it blanks the magnifier. By turning off the hide panel, the effect goes away. The alternative is to update to KDE2.1Beta where this method of dealing with the hidden panel is not used and all is well, as it was for KDE
+
I have FreeBSD. When I run ds9, I get the following error: ELF binary type "0" not known Whats going on?
+
The solution was to use the brandelf utility on the file to ensure that the machine understood that it was a Linux program.

% brandelf -t Linux (file name)

Windows

-
When I do Save Image, I get the same result (and this is true -for either .gif, .jpeg, .tiff, .png and .ppm) : it saves only a -stripe at the top of my image.
-
This problem seems to be caused by running DS9 in Windows XP -compatibility mode. Please un-check the compatibility option in the -properties dialog.
+
When I do Save Image, I get the same result (and this is true for either .gif, .jpeg, .tiff, .png and .ppm) : it saves only a stripe at the top of my image.
+
This problem seems to be caused by running DS9 in Windows XP compatibility mode. Please un-check the compatibility option in the properties dialog.

How can I open a FITS file with an extension name?
-
By default, the windows port of DS9 uses the Windows standard -dialog box to open and save files. This can be a problem in that -the native Windows dialog will not allow extensions to the file -name, such as foo.fits[2]. You must use the Unix like -standard dialogs to be able to specify an extension. Select -Edit->Preferences->General:Dialogbox to change the -default standard dialog.
-
Every time I create an auxiliary window in ds9, such as a -Pixel Table, or Analysis Plot, it will retreat behind the main ds9 -window. Then, when I bring the auxiliary window to the front and -move the mouse out of it, it automatically goes behind the main ds9 -window again. What can I do to fix things so that the auxiliary -window stays on top of the ds9 window?
-
To fix things so that the auxiliary window stays on top of the -ds9 window, do the following:
-
-
Go to the icon task bar at the bottom of the screen. -Bring the auxiliary window to the front by clicking on its icon -in the icon task bar. While the mouse still is on the aux -window icon, press the mouse button, and keeping it pressed, move -the mouse off the task bar. Release the mouse while off -the task bar. The auxiliary window will now stay on top of -the main ds9 window.
+
By default, the windows port of DS9 uses the Windows standard dialog box to open and save files. This can be a problem in that the native Windows dialog will not allow extensions to the file name, such as foo.fits[2]. You must use the Unix like standard dialogs to be able to specify an extension. Select Edit->Preferences->General:Dialogbox to change the default standard dialog.
+
Every time I create an auxiliary window in ds9, such as a Pixel Table, or Analysis Plot, it will retreat behind the main ds9 window. Then, when I bring the auxiliary window to the front and move the mouse out of it, it automatically goes behind the main ds9 window again. What can I do to fix things so that the auxiliary window stays on top of the ds9 window?
+
To fix things so that the auxiliary window stays on top of the ds9 window, do the following:
+
+
Go to the icon task bar at the bottom of the screen. Bring the auxiliary window to the front by clicking on its icon in the icon task bar. While the mouse still is on the aux window icon, press the mouse button, and keeping it pressed, move the mouse off the task bar. Release the mouse while off the task bar. The auxiliary window will now stay on top of the main ds9 window.

MacOSX

-
I can't invoke the 'Save Image' function from the MacOSX X11 -version. I get an error message "An error has occurred while -creating the image. Please make sure entire image is visible on -screen."
-Up until MacOSX 10.8 (Mountain Lion), Apple provided their own -version of a X11 server. At first, it was based on XFree86 -(X11R6.6) and available with versions up to MacOSX 10.4. Later with -MacOSX versions 10.5 to 10.7, the Apple's X11 server was based upon -X.org (X11R7.2).
+
I can't invoke the 'Save Image' function from the MacOSX X11 version. I get an error message "An error has occurred while creating the image. Please make sure entire image is visible on screen."
+Up until MacOSX 10.8 (Mountain Lion), Apple provided their own version of a X11 server. At first, it was based on XFree86 (X11R6.6) and available with versions up to MacOSX 10.4. Later with MacOSX versions 10.5 to 10.7, the Apple's X11 server was based upon X.org (X11R7.2).

-The Apple version of X11 server for MacOSX 10.5 to 10.7 contains a -bug which fails if you invoke certain X11 calls on a window if its -location is not at 0,0 on the screen. Hence, within DS9, if you -'Save Image' and your window is not exactly in the upper left -corner, it will fail.
+The Apple version of X11 server for MacOSX 10.5 to 10.7 contains a bug which fails if you invoke certain X11 calls on a window if its location is not at 0,0 on the screen. Hence, within DS9, if you 'Save Image' and your window is not exactly in the upper left corner, it will fail.

Again, this only affects users of MacOSX 10.5 to 10.7.

-Starting with MacOSX 10.8, Apple no longer provides a X11 window -server. The user must go to the XQuartz site and download/install -directly. The current version is 2.7.3.
-
When I invoke DS9 MacOSX Aqua from the command line, I get -weird errors such as:
-
-
The document "foo.fits" could not be opened. SAOImage DS9 -cannot open files in the "Flexible Image Transport System" -format.
-
-
When opening MacOSX Aqua from the command line, it is better to -use the OPEN application as opposed to specifying the -binary directly. The OPEN application sets up the -environment just as it is when a user double clicks.
+Starting with MacOSX 10.8, Apple no longer provides a X11 window server. The user must go to the XQuartz site and download/install directly. The current version is 2.7.3.
+
When I invoke DS9 MacOSX Aqua from the command line, I get weird errors such as:
+
+
The document "foo.fits" could not be opened. SAOImage DS9 cannot open files in the "Flexible Image Transport System" format.
+
+
When opening MacOSX Aqua from the command line, it is better to use the OPEN application as opposed to specifying the binary directly. The OPEN application sets up the environment just as it is when a user double clicks.
# good
% open /Applications/SAOImage\ DS9.app foo.fits # bad -% /Applications/SAOImage\ DS9.app/Contents/MacOS/ds9 -bar.fits
+% /Applications/SAOImage\ DS9.app/Contents/MacOS/ds9 bar.fits

How can I open a FITS file with an extension name?
-
By default, DS9 MacOSX Aqua uses the MacOSX standard dialog box -to open and save files. This can be a problem in that the native -MacOSX dialog will not allow extensions to the file name, such as -foo.fits[2]. You must use the Unix like standard dialogs -to be able to specify an extension. Select -Edit->Preferences->General to change the default -standard dialog.
-
How do I set my PATH environment variable under MacOSX for -use with external analysis programs, such as funtools?
-
When you double click on a MacOSX application, it does not parse -any shell startup files, such as ~/.profile. Instead, the -environment is defined using a special environment file, -.MacOSX/environment.plist. This file can be created with -the MacOSX utility -/Developer/Applications/PropertyListEditor.app. For -further information, please click here.
+
By default, DS9 MacOSX Aqua uses the MacOSX standard dialog box to open and save files. This can be a problem in that the native MacOSX dialog will not allow extensions to the file name, such as foo.fits[2]. You must use the Unix like standard dialogs to be able to specify an extension. Select Edit->Preferences->General to change the default standard dialog.
+
How do I set my PATH environment variable under MacOSX for use with external analysis programs, such as funtools?
+
When you double click on a MacOSX application, it does not parse any shell startup files, such as ~/.profile. Instead, the environment is defined using a special environment file, .MacOSX/environment.plist. This file can be created with the MacOSX utility /Developer/Applications/PropertyListEditor.app. For further information, please click here.

X11

-
Is it possible to work in batch mode without a physical -display?
-
DS9 is written as an interactive, window client program, and as -a result, does require a window server to be available for -rendering (X11, Windows, or MacOSX).
+
Is it possible to work in batch mode without a physical display?
+
DS9 is written as an interactive, window client program, and as a result, does require a window server to be available for rendering (X11, Windows, or MacOSX).

-Therefore, using DS9 as a batch process can be cumbersome. We -recommend using xvfb under X11. Just set up a virtual -display buffer, reset your DISPLAY variable, then invoke DS9 with a -number of command line options or use xpa from a shell script as a -batch processor. Example:
-
% export DISPLAY=:1 % Xvfb :1 -screen -0 1024x768x16 & % ds9 -file cmap.fits --zoom to fit -cmap b -grid skyformat degrees -grid yes -regions -../EMS-names.reg -saveimage png mytest.png -exit
+Therefore, using DS9 as a batch process can be cumbersome. We recommend using xvfb under X11. Just set up a virtual display buffer, reset your DISPLAY variable, then invoke DS9 with a number of command line options or use xpa from a shell script as a batch processor. Example:
+
% export DISPLAY=:1 % Xvfb :1 -screen 0 1024x768x16 & % ds9 -file cmap.fits -zoom to fit -cmap b -grid skyformat degrees -grid yes -regions ../EMS-names.reg -saveimage png mytest.png -exit

When I start DS9, I get the following error message:
-_X11TransSocketINETConnect: Can't get address for -foo.bar.edu
+_X11TransSocketINETConnect: Can't get address for foo.bar.edu
couldn't connect to display "foo.bar.edu:0.0"
-
DS9 is unable to determine a valid X11 Display server, because -of a number of reasons. Most often this is seen when you have a -laptop configured for a network, but is not physically connected. -You need to set the DISPLAY environment variable to :0.0
+
DS9 is unable to determine a valid X11 Display server, because of a number of reasons. Most often this is seen when you have a laptop configured for a network, but is not physically connected. You need to set the DISPLAY environment variable to :0.0

$ xhost +
$ set DISPLAY=:0.0
$ export DISPLAY
-
Under Solaris, when I start DS9, my twm window manager -crashes!
-
TWM distributed with X11R5 had a major bug, that was corrected -around 1996. DS9 will trigger this bug, and will cause TWM to -crash. If you are running Solaris, and have X11R5 installed, be -sure that /usr/openwin/bin is in your path before X11R5/bin. This -will insure that you are running the correct version of TWM .
-
When I run ds9 with the tvtwm window manager, sometimes the -open file dialog box does not appear?
-
If you are running tvtwm, and you are currently viewing a -virtual screen other than the first, when you open a file, the -dialog box will appear in the first virtual screen, not your -current. This is a bug with tvtwm and not ds9.
+
Under Solaris, when I start DS9, my twm window manager crashes!
+
TWM distributed with X11R5 had a major bug, that was corrected around 1996. DS9 will trigger this bug, and will cause TWM to crash. If you are running Solaris, and have X11R5 installed, be sure that /usr/openwin/bin is in your path before X11R5/bin. This will insure that you are running the correct version of TWM .
+
When I run ds9 with the tvtwm window manager, sometimes the open file dialog box does not appear?
+
If you are running tvtwm, and you are currently viewing a virtual screen other than the first, when you open a file, the dialog box will appear in the first virtual screen, not your current. This is a bug with tvtwm and not ds9.

@@ -277,75 +121,30 @@ current. This is a bug with tvtwm and not ds9.

-
I can't use more than 9 frames with the IMEXAMINE -task?
-
The task IMEXAMINE can not be used with frame numbers -greater than 9.
-
Can I display from IRAF to DS9 running under Windows or -MacOSX?
-
Yes, DS9 for Windows and MacOSX is also a fully functional IRAF -display server. To direct image output from IRAF to DS9 running -under Windows or MacOSX, use the IMTDEV environment variable. For -example, if the machine is named 'foo.bar.edu', define IMTDEV to -the follow value before entering IRAF.
+
I can't use more than 9 frames with the IMEXAMINE task?
+
The task IMEXAMINE can not be used with frame numbers greater than 9.
+
Can I display from IRAF to DS9 running under Windows or MacOSX?
+
Yes, DS9 for Windows and MacOSX is also a fully functional IRAF display server. To direct image output from IRAF to DS9 running under Windows or MacOSX, use the IMTDEV environment variable. For example, if the machine is named 'foo.bar.edu', define IMTDEV to the follow value before entering IRAF.

$ setenv IMTDEV inet:5137:foo.bar.edu
$ cl
cl> display dev$pix
-
I'm having problems with mscred task -msczero?
-DS9 now supports IRAF's new IIS image display protocol. However, -there is one minor problem with the mscred task -msczero. Before using msczero, issue the following -command in the cl:
+
I'm having problems with mscred task msczero?
+DS9 now supports IRAF's new IIS image display protocol. However, there is one minor problem with the mscred task msczero. Before using msczero, issue the following command in the cl:

cl> set disable_wcs_maps="" cl> flpr
-
I find that there is a frustrating delay in performing -operations on images displayed from IRAF - there's a wait of a -second or two before an image is (re)displayed, whereas -saoimage reacts virtually instantly for the same type of -operation. This makes running imexamine on a batch of images a -pain, and using the mouse to change color gamma/bias to desired -values basically impossible.
-
DS9 and saoimage are similar in speed when working with -IRAF. In fact, DS9 uses the same code to interface with IRAF -as saoimage and ximtool. The only difference is that DS9 is -double buffered, whereas, saoimage and ximtool -only use a single buffer. So with saoimage and -ximtool, you see incremental progress, where DS9 will -render the image all at one time. However, the overall time -to finish rendering should almost be the same.
-
DS9 runs in both 8 bit and 24 bit environments, but -saoimage is restricted to 8 bit. If you are running DS9 and -saoimage at the same time, then you must be in 8 bit mode. -You should not see any delay in changing the color -bias/contrast between the two.
-
However, if you are running DS9 in 24 bit mode, then you will -see slower performance in changing the bias/contrast, as -compared to 8 bit mode. Instead of changing a color look up -table, as in 8 bit mode, DS9 has to update every pixel on the -screen. If your cpu speed is slow, you can select the -Edit:Preferences:True Colorbar to tell DS9 not to update the entire -screen, only a part of the screen. This should only be needed -if your machine is slower than 200 MHz. Again saoimage -does not even run in 24 bit mode, so there are no -comparisons.
-
I try to display an image from IRAF and I get the following -error message:
+
I find that there is a frustrating delay in performing operations on images displayed from IRAF - there's a wait of a second or two before an image is (re)displayed, whereas saoimage reacts virtually instantly for the same type of operation. This makes running imexamine on a batch of images a pain, and using the mouse to change color gamma/bias to desired values basically impossible.
+
DS9 and saoimage are similar in speed when working with IRAF. In fact, DS9 uses the same code to interface with IRAF as saoimage and ximtool. The only difference is that DS9 is double buffered, whereas, saoimage and ximtool only use a single buffer. So with saoimage and ximtool, you see incremental progress, where DS9 will render the image all at one time. However, the overall time to finish rendering should almost be the same.
+
DS9 runs in both 8 bit and 24 bit environments, but saoimage is restricted to 8 bit. If you are running DS9 and saoimage at the same time, then you must be in 8 bit mode. You should not see any delay in changing the color bias/contrast between the two.
+
However, if you are running DS9 in 24 bit mode, then you will see slower performance in changing the bias/contrast, as compared to 8 bit mode. Instead of changing a color look up table, as in 8 bit mode, DS9 has to update every pixel on the screen. If your cpu speed is slow, you can select the Edit:Preferences:True Colorbar to tell DS9 not to update the entire screen, only a part of the screen. This should only be needed if your machine is slower than 200 MHz. Again saoimage does not even run in 24 bit mode, so there are no comparisons.
+
I try to display an image from IRAF and I get the following error message:

Cannot open device (node!imtool,,512,512)
-
DS9 works the same way as ximtool, saoimage, -and saotng. No special scripts should be needed. If -you have one of the above currently working, DS9 should work -out of the box.
-
IRAF can use one of three methods to communicate with DS9: fifo, -socket, and unix domain name. The DS9 defaults are:
+
DS9 works the same way as ximtool, saoimage, and saotng. No special scripts should be needed. If you have one of the above currently working, DS9 should work out of the box.
+
IRAF can use one of three methods to communicate with DS9: fifo, socket, and unix domain name. The DS9 defaults are:

fifo /dev/imt1
port 5137
unix /tmp/.IMT%d
-
If your IRAF configuration is set up different (i.e., a -different port number, or via a fifo), you need to tell DS9 -how to communicate with iraf. DS9 uses the same command line -options as XIMTOOL:
+
If your IRAF configuration is set up different (i.e., a different port number, or via a fifo), you need to tell DS9 how to communicate with iraf. DS9 uses the same command line options as XIMTOOL:

-fifo
-fifo_only
-inet_only
@@ -357,68 +156,34 @@ options as XIMTOOL:

-
I try to display an image, I see something, but it's -corrupted and I get multiple error messages from DS9...
-
An IRAF image server (ximtool, saoimage, DS9, -etc...) uses a configuration file to specify the number of -available buffers and their sizes. What actually passes from -IRAF is not the buffer size, but an index number into this -file.
-
So when an image server starts (DS9), it will attempt to locate -this file as $HOME/.imtoolrc and /usr/local/lib/imtoolrc. If -not found, it will look for shell environment variables -IMTOOLRC and imtoolrc, that contains the name of the configuration -file.
-
If no configuration file is found, DS9 will assume the following -default configuration:
-
1 2 512 512 # -imt1|imt512
- 2 2 800 800 # -imt2|imt800
+
I try to display an image, I see something, but it's corrupted and I get multiple error messages from DS9...
+
An IRAF image server (ximtool, saoimage, DS9, etc...) uses a configuration file to specify the number of available buffers and their sizes. What actually passes from IRAF is not the buffer size, but an index number into this file.
+
So when an image server starts (DS9), it will attempt to locate this file as $HOME/.imtoolrc and /usr/local/lib/imtoolrc. If not found, it will look for shell environment variables IMTOOLRC and imtoolrc, that contains the name of the configuration file.
+
If no configuration file is found, DS9 will assume the following default configuration:
+
1 2 512 512 # imt1|imt512
+ 2 2 800 800 # imt2|imt800
3 2 1024 1024 # imt3|imt1024
4 1 1600 1600 # imt4|imt1600
5 1 2048 2048 # imt5|imt2048
6 1 4096 4096 # imt6|imt4096
7 1 8192 8192 # imt7|imt8192
8 1 1024 4096 # imt8|imt1x4
- 9 2 1144 880 # imt9|imtfs full screen -(1152x900 minus frame)
-10 2 1144 764 # imt10|imtfs35 full screen at -35mm film aspect ratio
+ 9 2 1144 880 # imt9|imtfs full screen (1152x900 minus frame)
+10 2 1144 764 # imt10|imtfs35 full screen at 35mm film aspect ratio
11 2 128 128 # imt11|imt128
12 2 256 256 # imt12|imt256
-13 2 128 1056 # imt13|imttall128 tall & -narrow for spectro.
-14 2 256 1056 # imt14|imttall256 tall & -wider for spectro.
-15 2 1056 128 # imt15|imtwide128 wide & -thin for spectro.
-16 2 1056 256 # imt16|imtwide256 wide & -fatter for spectro.
-17 2 1008 648 # imt17|imtssy Solitaire fmt w/ -imtool border
-18 2 1024 680 # imt18|imtssn Solitaire fmt -w/out imtool border
+13 2 128 1056 # imt13|imttall128 tall & narrow for spectro.
+14 2 256 1056 # imt14|imttall256 tall & wider for spectro.
+15 2 1056 128 # imt15|imtwide128 wide & thin for spectro.
+16 2 1056 256 # imt16|imtwide256 wide & fatter for spectro.
+17 2 1008 648 # imt17|imtssy Solitaire fmt w/ imtool border
+18 2 1024 680 # imt18|imtssn Solitaire fmt w/out imtool border
19 1 4096 1024 # imt19|imt4x1
-
If on the other hand, IRAF assumes a different buffer size, the -image will appear corrupted and DS9 may issue a number of error -messages.
-
Another problem is that this file must be in sync with -dev$graphcap. If your system administrator has made changes -to graphcap, they must also be implemented in imtoolrc.
+
If on the other hand, IRAF assumes a different buffer size, the image will appear corrupted and DS9 may issue a number of error messages.
+
Another problem is that this file must be in sync with dev$graphcap. If your system administrator has made changes to graphcap, they must also be implemented in imtoolrc.

Here is a note from NOAO:

-
The messages means that there is no /usr/local/lib/imtoolrc -file on the machine. This is created as a symlink to -dev$imtoolrc by the iraf install script but only if the -/usr/local/lib dir already exists on the machine. The fix -is the create the dir and rerun the install script or else -make the link by hand. Users can also just copy -dev$imtoolrc to $HOME/.imtoolrc and restart the server to -also workaround it. Note that an existing .imtoolrc might -define old frame buffer configs which might confuse -things, so if the system file exists check for a private -copy screwing things up.
+
The messages means that there is no /usr/local/lib/imtoolrc file on the machine. This is created as a symlink to dev$imtoolrc by the iraf install script but only if the /usr/local/lib dir already exists on the machine. The fix is the create the dir and rerun the install script or else make the link by hand. Users can also just copy dev$imtoolrc to $HOME/.imtoolrc and restart the server to also workaround it. Note that an existing .imtoolrc might define old frame buffer configs which might confuse things, so if the system file exists check for a private copy screwing things up.

@@ -427,74 +192,42 @@ things, so if the system file exists check for a private
Where do I find this .imtoolrc file?

Again, here a note from NOAO concerning this issue:

-
In a smooth installation the imtoolrc file is installed as -a /usr/local/lib/imtoolrc symlink pointing to the -dev$imtoolrc file in the iraf system. This is -normally what's used but XImtool (and DS9?) also allow a -$HOME/.imtoolrc and IMTOOLRC environment variable defining the -path as fallbacks. There are several practical problems -with this: for some reason (I'm trying to fix) -the imtoolrc link won't be created if the /usr/local/lib -directory doesn't exist when the install script is run on -the machine, even though it's run as root and the file can be -directory easily. On PC-IRAF systems there is also a typo -in the install script (extra logical or at line 515) which -causes it to exit before the display setup is run (i.e. no -/dev fifos or imtoolrc). If users don't catch this or see -it in the README file they'll think everything went fine. -Lastly, the local iraf admin might not have run the install -script on the local iraf NFS client machine at -all.
-
-
-
-
-
-
When I display an image from IRAF, the SCALE menu option is -not active, Why?
-
When you display an image from IRAF into DS9, IRAF actually does -the color scale distribution. In Display, use the ztrans and -z1,z2 parameters to set the upper/lower bounds and distribution. -You can also use the zscale parameter to auto determine z1,z2.Here -are the DISPLAY parameters in question:
+
In a smooth installation the imtoolrc file is installed as a /usr/local/lib/imtoolrc symlink pointing to the dev$imtoolrc file in the iraf system. This is normally what's used but XImtool (and DS9?) also allow a $HOME/.imtoolrc and IMTOOLRC environment variable defining the path as fallbacks. There are several practical problems with this: for some reason (I'm trying to fix) the imtoolrc link won't be created if the /usr/local/lib directory doesn't exist when the install script is run on the machine, even though it's run as root and the file can be directory easily. On PC-IRAF systems there is also a typo in the install script (extra logical or at line 515) which causes it to exit before the display setup is run (i.e. no /dev fifos or imtoolrc). If users don't catch this or see it in the README file they'll think everything went fine. Lastly, the local iraf admin might not have run the install script on the local iraf NFS client machine at all.
+
+
+
+
+
+
When I display an image from IRAF, the SCALE menu option is not active, Why?
+
When you display an image from IRAF into DS9, IRAF actually does the color scale distribution. In Display, use the ztrans and z1,z2 parameters to set the upper/lower bounds and distribution. You can also use the zscale parameter to auto determine z1,z2.Here are the DISPLAY parameters in question:

ztrans=[linear|log|none|user]
z1=min
z2=max
zscale=[yes|no]
-
What actually is sent from IRAF to DS9 is one byte per pixel, -values 0-200, which already has applied both the upper and -lower clipping bounds and the distribution. So this is why, the -SCALE menu is disabled in DS9 when it receives a image from -IRAF.
+
What actually is sent from IRAF to DS9 is one byte per pixel, values 0-200, which already has applied both the upper and lower clipping bounds and the distribution. So this is why, the SCALE menu is disabled in DS9 when it receives a image from IRAF.

-
Coordinates
+
Coordinates

-
Why don't I see PHYSICAL/WCS/WCSA...WCSZ coordinates -displayed when I load my image?
+
Why don't I see PHYSICAL/WCS/WCSA...WCSZ coordinates displayed when I load my image?

DS9 supports the following coordinate systems:
-
WCS Sky coords -(fk4,fk5,icrs,galactic,ecliptic) WCS Linear -coords Image (also known as Logical) -Physical (also known as CCD) +WCS Sky coords (fk4,fk5,icrs,galactic,ecliptic) WCS Linear coords Image (also known as Logical) Physical (also known as CCD) Detector Amplifier -DS9 uses the following FITS keywords in the header to define a -coordinate system: +DS9 uses the following FITS keywords in the header to define a coordinate system:
- + - - + + @@ -518,189 +251,83 @@ TCRVL,TCRPX,TCDLT,... (for tables) Coordinate System Keyword Values WCS / WCSA...WCSZ WCS / WCSA...WCSZ CRVAL,CRPIX,CRDELT,CD... (for images) TCRVL,TCRPX,TCDLT,... (for tables) -If the required keywords are not present, values for those -coordinates are not displayed. -Note: For PHYSICAL, DS9 will first look for an alternative WCS -with WCSNAMEx='PHYSICAL'. If not found, DS9 will then look for the -LTMx_x LTVx keywords. +If the required keywords are not present, values for those coordinates are not displayed. +Note: For PHYSICAL, DS9 will first look for an alternative WCS with WCSNAMEx='PHYSICAL'. If not found, DS9 will then look for the LTMx_x LTVx keywords.
Regions -How do I indicate distance on my printed -images? -You have two choices, the RULER region and the LINE region. The -ruler region is mainly used for interactive measurements. For -printed output, use the LINE region to create a distance indicator. -In the line region dialog, there is a read-only entry that -indicates the length in pixels, degrees, arcmin, or arcsec. Edit to -the desired distance and enter the desired label, including ' or ", -in the region text labile entry. You have the option of arrows at -each end of the line. +How do I indicate distance on my printed images? +You have two choices, the RULER region and the LINE region. The ruler region is mainly used for interactive measurements. For printed output, use the LINE region to create a distance indicator. In the line region dialog, there is a read-only entry that indicates the length in pixels, degrees, arcmin, or arcsec. Edit to the desired distance and enter the desired label, including ' or ", in the region text labile entry. You have the option of arrows at each end of the line. Printing -I can make some wonderful color images in DS9 and save them -as postscript files that look great, but often when I print them -they appear washed out or very different than they do on the -screen. My question then is what, if anything, can I do about -this? -The problem is that you create an image on a display, which is -the product of RGB colors (red, green, and blue) and print -the image on a printer, which is the product of CMYK colors -(cyan, yellow, magenta, and black). Furthermore, every -monitor is different in how it will display a certain color, and -every printing technology is different in how well it will -reproduce that color. And finally, the translation between -RGB and CMYK is not symmetric, i.e. its not possible to -translate some colors back and forth. -It's possible to calibrate your monitor and your printer, to -create a translation matrix, to correct for problems outlined -above (in the Macintosh world, this is what ColorSync does). -The idea is to apply a gamma correction to the output of -DS9, so that it will print much more in line with what you -expect. To do this you'd need special software and hardware, -and its only valid for your monitor and your printer. -In summary, its not worth it. Especially in the case of -publication, such as ApJ, where you have no idea on what -printing technology will be used to reproduce your image. So -the only control you have is to calibrate your monitor and to -hope for the best. -However, there are some rules of thumb that might help. -First, printers have a very hard time with blues and -purples, as they tend to be washed out. Either avoid these -colors, or over compensate these colors. -ApJ has a good idea in that you send in both an electronic -version and a hard copy of your color image. That way, they can -manually adjust the printers to try to match your output. -NOTE: Even though ApJ requests images in CMYK, we recommend -RGB. From personal experience, if you send RGB, the printed results -will be closer to the original. -We used DS9 to generate 300 dpi CMYK eps figures, as per the -ApJ specifications, but the color scheme on our proofs is -wrong. In the proofs, the violet is washed out and looks -similar to the black, and the blue is not nearly as -intense. -There are two issues here: first, color printers are -notorious for failure to reproduce blues and purples correctly. -Second, not all colors in RGB space can be reproduced -correctly in CMYK space, blues being the prime example. Below is an -excerpt from an industry pamphlet: - -Be aware that it is possible to see colors in RGB that you -can't make with CMYK. They are said to be "out of the CMYK color -gamut". What happens is that the RGB-to-CMYK translator just gets -as close as possible to the appearance of the original and that's -as good as it can be. It's something that everyone in the industry -puts up with. So it's best to select any colors you use for fonts -or other design elements in your layout using CMYK definitions -instead of RGB. That way, you will have a better idea of how they -will appear in your printed piece. Here's a common example: many -programs translate the 100% Blue in RGB into a somewhat -purple-looking color in CMYK. We recommend a CMYK value of -100-65-0-0 to get a nice clean blue. - -For this reason, you may wish to use the RGB color space or -colormaps without deep blues and purples, such as BB or -Heat. +I can make some wonderful color images in DS9 and save them as postscript files that look great, but often when I print them they appear washed out or very different than they do on the screen. My question then is what, if anything, can I do about this? +The problem is that you create an image on a display, which is the product of RGB colors (red, green, and blue) and print the image on a printer, which is the product of CMYK colors (cyan, yellow, magenta, and black). Furthermore, every monitor is different in how it will display a certain color, and every printing technology is different in how well it will reproduce that color. And finally, the translation between RGB and CMYK is not symmetric, i.e. its not possible to translate some colors back and forth. +It's possible to calibrate your monitor and your printer, to create a translation matrix, to correct for problems outlined above (in the Macintosh world, this is what ColorSync does). The idea is to apply a gamma correction to the output of DS9, so that it will print much more in line with what you expect. To do this you'd need special software and hardware, and its only valid for your monitor and your printer. +In summary, its not worth it. Especially in the case of publication, such as ApJ, where you have no idea on what printing technology will be used to reproduce your image. So the only control you have is to calibrate your monitor and to hope for the best. +However, there are some rules of thumb that might help. First, printers have a very hard time with blues and purples, as they tend to be washed out. Either avoid these colors, or over compensate these colors. +ApJ has a good idea in that you send in both an electronic version and a hard copy of your color image. That way, they can manually adjust the printers to try to match your output. +NOTE: Even though ApJ requests images in CMYK, we recommend RGB. From personal experience, if you send RGB, the printed results will be closer to the original. +We used DS9 to generate 300 dpi CMYK eps figures, as per the ApJ specifications, but the color scheme on our proofs is wrong. In the proofs, the violet is washed out and looks similar to the black, and the blue is not nearly as intense. +There are two issues here: first, color printers are notorious for failure to reproduce blues and purples correctly. Second, not all colors in RGB space can be reproduced correctly in CMYK space, blues being the prime example. Below is an excerpt from an industry pamphlet: + +Be aware that it is possible to see colors in RGB that you can't make with CMYK. They are said to be "out of the CMYK color gamut". What happens is that the RGB-to-CMYK translator just gets as close as possible to the appearance of the original and that's as good as it can be. It's something that everyone in the industry puts up with. So it's best to select any colors you use for fonts or other design elements in your layout using CMYK definitions instead of RGB. That way, you will have a better idea of how they will appear in your printed piece. Here's a common example: many programs translate the 100% Blue in RGB into a somewhat purple-looking color in CMYK. We recommend a CMYK value of 100-65-0-0 to get a nice clean blue. + +For this reason, you may wish to use the RGB color space or colormaps without deep blues and purples, such as BB or Heat. XPA -How can I use XPA to display from a client machine to DS9 on -a server machine? -Assuming you have direct IP reachability between the machines -(i.e. one host can successfully connect() to the other), XPA does -allow you to have an XPA-enabled server like DS9 on one machine and -a client on another. To make this work, you need to do two things -(let's assume DS9 is running on a machine called "server_host" and -you want to send xpa commands from "client_host"): +How can I use XPA to display from a client machine to DS9 on a server machine? +Assuming you have direct IP reachability between the machines (i.e. one host can successfully connect() to the other), XPA does allow you to have an XPA-enabled server like DS9 on one machine and a client on another. To make this work, you need to do two things (let's assume DS9 is running on a machine called "server_host" and you want to send xpa commands from "client_host"): -The XPA server program (i.e. DS9) must allow the client host to -send XPA commands. Access can be permitted in one of two ways: + The XPA server program (i.e. DS9) must allow the client host to send XPA commands. Access can be permitted in one of two ways: -Send the XPA server an acl request by running xpaset on the -same host on which the server is running (i.e. on the -server_host): + Send the XPA server an acl request by running xpaset on the same host on which the server is running (i.e. on the server_host): -% xpaset -p ds9 -acl -client_host + +% xpaset -p ds9 -acl client_host + For more permanent access, add permissions in ~acls.xpa: -% cat > -~/acls.xpa -DS9:ds9 client_host -+ +% cat > ~/acls.xpa +DS9:ds9 client_host + You can check the acls for an XPA server using xpaget: -% xpaget ds9 --acl +% xpaget ds9 -acl -On the client side, the client needs to communicate with the -xpansname server program on the server machine to find the XPA -server communication info. This also can be done in two ways: + On the client side, the client needs to communicate with the xpansname server program on the server machine to find the XPA server communication info. This also can be done in two ways: -use the -i [host] switch to override XPA_NSINET for this execution (The -default port is 14285): + use the -i [host] switch to override XPA_NSINET for this execution (The default port is 14285): -% xpaget -i 'server_host:14285' ds9 +% xpaget -i 'server_host:14285' ds9 -Set the XPA_NSINET -variable for more permanent selection of xpans on the server -host: + Set the XPA_NSINET variable for more permanent selection of xpans on the server host: -% setenv XPA_NSINET -'server_host:14285' +% setenv XPA_NSINET 'server_host:14285' -Once these two setup steps are performed, you should be able to -send commands to DS9 and receive data from DS9. You can look at the -xpaacl man -page for more information. -I have a laptop, that most of the time, is connected to a -network. DS9 runs fine. However, when I'm not connected to a -network and I start DS9, it hangs. What's going on? - DS9 uses XPA for interprocess communication. When DS9 -starts, XPA initializes itself. XPA uses either IP sockets or UNIX -sockets, based if your machine is configured to connect to the -internet. In the case where your machine is configured for the -internet, but you are not currently connected, XPA gets very -confused. So, you can define a shell variable, XPA_METHOD, that -tells XPA which method to use. +Once these two setup steps are performed, you should be able to send commands to DS9 and receive data from DS9. You can look at the xpaacl man page for more information. +I have a laptop, that most of the time, is connected to a network. DS9 runs fine. However, when I'm not connected to a network and I start DS9, it hangs. What's going on? + DS9 uses XPA for interprocess communication. When DS9 starts, XPA initializes itself. XPA uses either IP sockets or UNIX sockets, based if your machine is configured to connect to the internet. In the case where your machine is configured for the internet, but you are not currently connected, XPA gets very confused. So, you can define a shell variable, XPA_METHOD, that tells XPA which method to use. The following is from the XPA documentation: -Determines the socket connection method used by this session -of XPA. The choices are: inet (to use INET or Internet-based -sockets) and local (unix) (to use UNIX sockets). The default is -INET. Using the inet method will allow access from other machines -(subject to access controls) but using local will not. Local is -most useful for private access and when the machine in question is -not connected to the Internet +Determines the socket connection method used by this session of XPA. The choices are: inet (to use INET or Internet-based sockets) and local (unix) (to use UNIX sockets). The default is INET. Using the inet method will allow access from other machines (subject to access controls) but using local will not. Local is most useful for private access and when the machine in question is not connected to the Internet -More information is available on XPA shell variables at: -The XPA -Environment +More information is available on XPA shell variables at: The XPA Environment VO -I can't connect to any of the virtual observatories. What do -I do now? -The DS9 help facility now contains a tutorial on how to -configure DS9 to by pass network firewalls. See Virtual Observatory Reference for more -information. +I can't connect to any of the virtual observatories. What do I do now? +The DS9 help facility now contains a tutorial on how to configure DS9 to by pass network firewalls. See Virtual Observatory Reference for more information. diff --git a/ds9/doc/helpdesk.html b/ds9/doc/helpdesk.html index a822a2e..27d09d7 100644 --- a/ds9/doc/helpdesk.html +++ b/ds9/doc/helpdesk.html @@ -1,21 +1,15 @@ - - - + + + DS9 Help Desk - - SAOImageDS9 Help Desk + + SAOImageDS9 Help Desk -If you encounter any problems or have suggestions with DS9, -please contact us: + If you encounter any problems or have suggestions with DS9, please contact us: ds9help @ cfa.harvard.edu William Joye Smithsonian Astrophysical Observatory diff --git a/ds9/doc/install.html b/ds9/doc/install.html index 3ed77f4..38ec454 100644 --- a/ds9/doc/install.html +++ b/ds9/doc/install.html @@ -1,57 +1,44 @@ - - + + DS9 Installation Instructions - SAOImageDS9 Installation Instructions + SAOImageDS9 Installation Instructions Linux Installation -DS9 for linux is a self contained application and does not require -any installation procedures or support files. +DS9 for linux is a self contained application and does not require any installation procedures or support files. Download DS9 for linux. Use the following command line to extract DS9: -$ cat -ds9.<port>.<version>.tar.gz | tar -xzvf - +$ cat ds9.<port>.<version>.tar.gz | tar -xzvf - Move the ds9 executable into a directory in your path. MacOS -Download DS9 for MacOS. Drag to your Applications -folder. +Download DS9 for MacOS. Drag to your Applications folder. Darwin -Darwin is only recommended for experienced users of linux. For -other users, we recommend DS9 for MacOS. -DS9 Darwin requires XQuartz. DS9 for Darwin is a -executable and must be run from the command line of a Terminal -window. +Darwin is only recommended for experienced users of linux. For other users, we recommend DS9 for MacOS. +DS9 Darwin requires XQuartz. DS9 for Darwin is a executable and must be run from the command line of a Terminal window. Download DS9 for Darwin. Open a Terminal window. Use the following command line to extract DS9: -$ cat -ds9.darwin<arch>.<version>.tar.gz | tar -xzvf -- -(Optional) Move ds9 and ds9.zip executable into a directory in -your path. +$ cat ds9.darwin<arch>.<version>.tar.gz | tar -xzvf - +(Optional) Move ds9 and ds9.zip executable into a directory in your path. Windows Download DS9 for Windows. -Execute the install file. DS9 will be installed by default in -C:\SAOImageDS9. +Execute the install file. DS9 will be installed by default in C:\SAOImageDS9. diff --git a/ds9/doc/story.html b/ds9/doc/story.html index c224c83..e4a2082 100644 --- a/ds9/doc/story.html +++ b/ds9/doc/story.html @@ -1,62 +1,20 @@ - - - + + + Story of SAOImageDS9 - - The Story of SAOImageDS9: How DS9 got its name + + The Story of SAOImageDS9: How DS9 got its name -In 1990, Mike Van Hilst, at the Smithsonian Astrophysical -Observatory, Center for Astrophysics, Harvard University, developed -SAOImage. SAOImage was first implemented in X10, then reimplemented -in X11. In fact, it was one of the first X11 based applications -publicly made available. SAOImage was a brilliant program, -implementing techniques in scientific visualization 20 years ago -that are still being used by today's applications. Since Mike's -departure from SAO, SAOImage has been maintained by Jessica -Mink. -In the mid 1990's, with the administrative support of Steve -Murray, Eric Mandel developed SAOtng, or (SAOImage, The Next -Generation), named after the Star Trek series. TNG was based on -IRAF's XIMTOOL graphics libraries and Tcl. It explored new GUI -interfaces and supported a new external analysis interface. In -particular, it utilized XPA, (X11 Public Access, also written by -Eric) which allowed TNG to be scripted via a shell, or from other -application. -In 1998, while working with Eric, William Joye began a complete -rewrite of TNG, based on the experience developed while supporting -TNG. This project was funded by the NASA Applied Information -Systems Research Program, under the title "Future Directions for -Astronomical Image Display". For lack of a name, the new project -was referred to as DS9, the logical extension of the Star Trek -series. The name continues to be in use. Current funding is -provided by the NASA High Energy Astrophysics Science Archive -Center and the Chandra X-ray Science Center. -DS9 is a Tcl/Tk application. The GUI is implemented as a very -thin layer of Tk. A number of Tk Canvas widgets in C++ were created -to support all the functionality needed. Basically, all the real -work is done in C++. DS9 inherited TNG's support of regions, XPA, -external analysis support, and the general GUI. However, all the -visualization techniques come directly from SAOImage. -The current version of DS9 is composed of the Tk widgets created -along with support from about 20 other open source products -(including Tcl/Tk, AST, BLT, HCompress, HTMLWidget, plio, rics, -tcllib, tclxml, tkcon, tkimg, tktable, wcssubs, xmlrpc, XPA, zip, -zlib, and zvfs). The distributed binaries consist of a -self-contained self-extracting archive and application, which -provides an independent Tcl/Tk environment without -installation. -The first versions of DS9 were made available in 1999. Since -then, the popularity of DS9 has grown far beyond -expectations. +In 1990, Mike Van Hilst, at the Smithsonian Astrophysical Observatory, Center for Astrophysics, Harvard University, developed SAOImage. SAOImage was first implemented in X10, then reimplemented in X11. In fact, it was one of the first X11 based applications publicly made available. SAOImage was a brilliant program, implementing techniques in scientific visualization 20 years ago that are still being used by today's applications. Since Mike's departure from SAO, SAOImage has been maintained by Jessica Mink. +In the mid 1990's, with the administrative support of Steve Murray, Eric Mandel developed SAOtng, or (SAOImage, The Next Generation), named after the Star Trek series. TNG was based on IRAF's XIMTOOL graphics libraries and Tcl. It explored new GUI interfaces and supported a new external analysis interface. In particular, it utilized XPA, (X11 Public Access, also written by Eric) which allowed TNG to be scripted via a shell, or from other application. +In 1998, while working with Eric, William Joye began a complete rewrite of TNG, based on the experience developed while supporting TNG. This project was funded by the NASA Applied Information Systems Research Program, under the title "Future Directions for Astronomical Image Display". For lack of a name, the new project was referred to as DS9, the logical extension of the Star Trek series. The name continues to be in use. Current funding is provided by the NASA High Energy Astrophysics Science Archive Center and the Chandra X-ray Science Center. +DS9 is a Tcl/Tk application. The GUI is implemented as a very thin layer of Tk. A number of Tk Canvas widgets in C++ were created to support all the functionality needed. Basically, all the real work is done in C++. DS9 inherited TNG's support of regions, XPA, external analysis support, and the general GUI. However, all the visualization techniques come directly from SAOImage. +The current version of DS9 is composed of the Tk widgets created along with support from about 20 other open source products (including Tcl/Tk, AST, BLT, HCompress, HTMLWidget, plio, rics, tcllib, tclxml, tkcon, tkimg, tktable, wcssubs, xmlrpc, XPA, zip, zlib, and zvfs). The distributed binaries consist of a self-contained self-extracting archive and application, which provides an independent Tcl/Tk environment without installation. +The first versions of DS9 were made available in 1999. Since then, the popularity of DS9 has grown far beyond expectations. diff --git a/ds9/doc/tutorial.html b/ds9/doc/tutorial.html index 99e61ca..7cdc83b 100644 --- a/ds9/doc/tutorial.html +++ b/ds9/doc/tutorial.html @@ -1,26 +1,16 @@ - - - + + + SAOImage: Tutorials - - SAOImageDS9: Tutorials -Below is a list of instructional tutorials which are -currently available. This list is updated regularly as new material -becomes available. + + SAOImageDS9: Tutorials +Below is a list of instructional tutorials which are currently available. This list is updated regularly as new material becomes available. -Exploring -Advanced Features of SAOImageDS9 +Exploring Advanced Features of SAOImageDS9 CFA Head Lunch Talk: May 5, 2009 -- cgit v0.12 From 608d1942c190fd615027e49c766083f65526818a Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 16:08:14 -0400 Subject: clean up html --- ds9/doc/ref/xpa.html | 6890 ++++++++++++++++++++++---------------------------- 1 file changed, 2994 insertions(+), 3896 deletions(-) diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index fdde311..28ac728 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -1,3907 +1,3005 @@ - - - - - XPA Access Points - - - XPA Access Points - - The XPA - messaging system provides seamless communication between DS9 and - other Unix programs, including X programs, Perl, S-Lang, - and Tcl/Tk. It also provides an easy way for users to - communicate with DS9 by executing XPA client commands in the - shell or by utilizing such commands in scripts. Because XPA - works both at the programming level and the shell level, it is a - powerful tool for unifying any analysis environment. - 2mass - 3d - about - align - analysis - array - background - backup - bin - blink - block - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - data - dsssao - dsseso - dssstsci - envi - exit - export - file - fits - frame - gif - grid - header - height - iconify - iexam - iis - jpeg - lock - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - multiframe - nameserver - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - quit - raise - regions - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - save - saveimage - scale - shm - sia - single - skyview - sleep - smooth - source - tcl - threads - tile - update - url - version - view - vla - vlss - vo - wcs - web - width - xpa - zscale - zoom - - 2mass - Support for 2MASS Digital Sky Survey. - Syntax: - 2mass [] -       [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -     [survey j|h|k] -       [open|close] - - Example: - $xpaget ds9 2mass name - $xpaget ds9 2mass coord - $xpaget ds9 2mass size - $xpaget ds9 2mass save - $xpaget ds9 2mass frame - $xpaget ds9 2mass survey - $xpaset -p ds9 2mass - $xpaset -p ds9 2mass m31 - $xpaset -p ds9 2mass name m31 - $xpaset -p ds9 2mass name clear - $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 2mass size 60 60 arcmin - $xpaset -p ds9 2mass save yes - $xpaset -p ds9 2mass frame current - $xpaset -p ds9 2mass update frame - $xpaset -p ds9 2mass survey j - $xpaset -p ds9 2mass open - $xpaset -p ds9 2mass close - 3d - Support for 3D frame. - Syntax: - 3d [] -    [view <az> <el>] -    [az <az>] -    [el <el>] -    [scale <scale>] -    [method mip|aip] -    [background none|azimuth|elevation] -    [border yes|no] -    [border color <color>] -    [highlite yes|no] -    [highlite color <color>] -    [compass yes|no] -    [compass color <color>] -    [match] -    [lock [yes|no]] -    [open|close] - - Example: - $xpaget ds9 3d view - $xpaget ds9 3d az - $xpaget ds9 3d el - $xpaget ds9 3d scale - $xpaget ds9 3d method - $xpaget ds9 3d background - $xpaget ds9 3d border - $xpaget ds9 3d border color - $xpaget ds9 3d highlite - $xpaget ds9 3d highlite color - $xpaget ds9 3d compass - $xpaget ds9 3d compass color - $xpaget ds9 3d lock - $xpaset -p ds9 3d # create new 3D frame - $xpaset -p ds9 3d view 45 30 - $xpaset -p ds9 3d az 45 - $xpaset -p ds9 3d el 30 - $xpaset -p ds9 3d scale 10 - $xpaset -p ds9 3d method mip - $xpaset -p ds9 3d background azimuth - $xpaset -p ds9 3d border yes - $xpaset -p ds9 3d border color red - $xpaset -p ds9 3d highlite yes - $xpaset -p ds9 3d highlite color red - $xpaset -p ds9 3d compass yes - $xpaset -p ds9 3d - compass color red - $xpaset - - - - - - - - - - - - - -p ds9 3d match - $xpaset -p ds9 3d lock - yes - - $xpaset -p ds9 3d open - $xpaset -p ds9 3d close - - about - Get DS9 credits. - Syntax: - about - - Example: - $xpaget ds9 about - - align - Controls the World Coordinate System alignment for the current - frame. - Syntax: - align [] -       [yes|no] - - Example: - $xpaget ds9 align - $xpaset -p ds9 align yes - - analysis - Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window. - Syntax: - analysis [<task number>] -          - [<filename>] -          [task <task - number>|<task name>] -          [load - <filename>] -          [clear] -          [clear][load - <filename>] -          [message - ok|okcancel|yesno <message>] -          [entry - <message>] -          [text] - - Example: - $xpaget ds9 analysis - $xpaget ds9 analysis task - $xpaget ds9 analysis entry {Please enter something} - $xpaget ds9 analysis message okcancel {Hello World} - $xpaset -p ds9 analysis 0 # invoke first analysis task - $xpaset -p ds9 analysis task 0 - $xpaset -p ds9 analysis task foobar - $xpaset -p ds9 analysis {foo bar} - $xpaset -p ds9 analysis my.ans - $xpaset -p ds9 analysis load my.ans - $xpaset -p ds9 analysis clear - $xpaset -p ds9 analysis clear load my.ans - $xpaset -p ds9 analysis message {This is a message} - $xpaset -p ds9 analysis text {this is text} - $cat my.ans | xpaset ds9 analysis load - $cat foo.txt | xpaset ds9 analysis text - - array - Load raw data array into current frame. - - Syntax: - array [native|little|big] - array [new|mask] + + + + +XPA Access Points + + + XPA Access Points + +The XPA messaging +system provides seamless communication between DS9 and other Unix +programs, including X programs. It also provides an easy way for +users to communicate with DS9 by executing XPA client commands in +the shell or by utilizing such commands in scripts. Because XPA +works both at the programming level and the shell level, it is a +powerful tool for unifying any analysis environment. +2mass +3d +about +align +analysis +array +background +backup +bin +blink +block +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +data +dsssao +dsseso +dssstsci +envi +exit +export +file +fits +frame +gif +grid +header +height +iconify +iexam +iis +jpeg +lock +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +multiframe +nameserver +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +quit +raise +regions +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +save +saveimage +scale +shm +sia +single +skyview +sleep +smooth +source +tcl +threads +tile +update +url +version +view +vla +vlss +vo +wcs +web +width +xpa +zscale +zoom +2mass +Support for 2MASS Digital Sky Survey. +Syntax: +2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +$xpaget ds9 2mass name +$xpaget ds9 2mass coord +$xpaget ds9 2mass size +$xpaget ds9 2mass save +$xpaget ds9 2mass frame +$xpaget ds9 2mass survey +$xpaset -p ds9 2mass +$xpaset -p ds9 2mass m31 +$xpaset -p ds9 2mass name m31 +$xpaset -p ds9 2mass name clear +$xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 2mass size 60 60 arcmin +$xpaset -p ds9 2mass save yes +$xpaset -p ds9 2mass frame current +$xpaset -p ds9 2mass update frame +$xpaset -p ds9 2mass survey j +$xpaset -p ds9 2mass open +$xpaset -p ds9 2mass close +3d +Support for 3D frame. +Syntax: +3d [] +    [view <az> <el>] +    [az <az>] +    [el <el>] +    [scale <scale>] +    [method mip|aip] +    [background none|azimuth|elevation] +    [border yes|no] +    [border color <color>] +    [highlite yes|no] +    [highlite color <color>] +    [compass yes|no] +    [compass color <color>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 3d view +$xpaget ds9 3d az +$xpaget ds9 3d el +$xpaget ds9 3d scale +$xpaget ds9 3d method +$xpaget ds9 3d background +$xpaget ds9 3d border +$xpaget ds9 3d border color +$xpaget ds9 3d highlite +$xpaget ds9 3d highlite color +$xpaget ds9 3d compass +$xpaget ds9 3d compass color +$xpaget ds9 3d lock +$xpaset -p ds9 3d # create new 3D frame +$xpaset -p ds9 3d view 45 30 +$xpaset -p ds9 3d az 45 +$xpaset -p ds9 3d el 30 +$xpaset -p ds9 3d scale 10 +$xpaset -p ds9 3d method mip +$xpaset -p ds9 3d background azimuth +$xpaset -p ds9 3d border yes +$xpaset -p ds9 3d border color red +$xpaset -p ds9 3d highlite yes +$xpaset -p ds9 3d highlite color red +$xpaset -p ds9 3d compass yes +$xpaset -p ds9 3d compass color red +$xpaset -p ds9 3d match +$xpaset -p ds9 3d lock yes +$xpaset -p ds9 3d open +$xpaset -p ds9 3d close +about +Get DS9 credits. +Syntax: +about + +Example: +$xpaget ds9 about +align +Controls the World Coordinate System alignment for the current +frame. +Syntax: +align [] +    [yes|no] + +Example: +$xpaget ds9 align +$xpaset -p ds9 align yes +analysis +Control external analysis tasks. Tasks are numbered as they are +loaded, starting with 0. Can also be used to display a message and +display text in the text dialog window. +Syntax: +analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +$xpaget ds9 analysis +$xpaget ds9 analysis task +$xpaget ds9 analysis entry {Please enter something} +$xpaget ds9 analysis message okcancel {Hello World} +$xpaset -p ds9 analysis 0 # invoke first analysis task +$xpaset -p ds9 analysis task 0 +$xpaset -p ds9 analysis task foobar +$xpaset -p ds9 analysis {foo bar} +$xpaset -p ds9 analysis my.ans +$xpaset -p ds9 analysis load my.ans +$xpaset -p ds9 analysis clear +$xpaset -p ds9 analysis clear load my.ans +$xpaset -p ds9 analysis message {This is a message} +$xpaset -p ds9 analysis text {this is text} +$cat my.ans | xpaset ds9 analysis load +$cat foo.txt | xpaset ds9 analysis text +array +Load raw data array into current frame. +Syntax: +array [native|little|big] +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $xpaget ds9 array > foo.arr - $xpaget ds9 array little > foo.arr - $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] - $xpaset -p ds9 array new foo.arr[dim=512,bitpix=-32,endian=little] - $xpaset -p ds9 array mask foo.arr[dim=512,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 array - [dim=512,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 array new - [dim=512,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 array mask - [dim=512,bitpix=-32,endian=little] - bg - background - Set image background color. - Syntax: - bg <color> - - Example: - $xpaget ds9 bg - $xpaset -p ds9 bg red - backup - Create a backup save set. - Syntax: - backup <filename> - - Example: - $xpaset -p ds9 backup ds9.bck - bin - Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility. - Syntax: - bin [about <x> <y>] -     [about center] -     [buffersize <value>] -     [cols <x> <y>] -     [colsz <x> <y> <z>] -     [factor <value> [<vector>]] -     [depth <value>] -     [filter <string>] -     [filter clear] -     [function average|sum] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $xpaget ds9 bin about - $xpaget ds9 bin buffersize - $xpaget ds9 bin cols - $xpaget ds9 bin factor - $xpaget ds9 bin depth - $xpaget ds9 bin filter - $xpaget ds9 bin function - $xpaget ds9 bin smooth - $xpaget ds9 bin smooth function - $xpaget ds9 bin smooth radius - $xpaget ds9 bin lock - $xpaset -p ds9 bin about 4096 4096 - $xpaset -p ds9 bin about center - $xpaset -p ds9 bin buffersize 512 - $xpaset -p ds9 bin cols detx dety - $xpaset -p ds9 bin colsz detx dety time - $xpaset -p ds9 bin factor 4 - $xpaset -p ds9 bin factor 4 2 - $xpaset -p ds9 bin depth 10 - $xpaset -p ds9 bin filter 'pha > 5' - $xpaset -p ds9 bin filter clear - $xpaset -p ds9 bin function sum - $xpaset -p ds9 bin in - $xpaset -p ds9 bin out - $xpaset -p ds9 bin to fit - $xpaset -p ds9 bin match - $xpaset -p ds9 bin lock yes - $xpaset -p ds9 bin open - $xpaset -p ds9 bin close - - blink - Blink mode parameters. Interval is in seconds. - - Syntax: - blink [] -       [yes|no] -       [interval <value>] - - Example: - $xpaget ds9 blink - $xpaget ds9 blink interval - $xpaset -p ds9 blink - $xpaset -p ds9 blink yes - $xpaset -p ds9 blink interval 1 - block - Controls blocking parameters. - Syntax: - block [<value>] -       [<value> <value>] -       [to <value>] -       [to <value> - <value>] -       [in] -       [out] -       [to fit] -       [match] -       [lock [yes|no]] -       [open|close] - - Example: - $xpaget ds9 block - $xpaget ds9 block lock - $xpaset -p ds9 block 4 - $xpaset -p ds9 block 4 2 - $xpaset -p ds9 block - to 4 - $xpaset -p ds9 block to 4 2 - $xpaset -p ds9 block in - $xpaset -p ds9 block - out - $xpaset -p ds9 block to - fit - $xpaset -p ds9 block match - $xpaset -p ds9 block lock yes - $xpaset -p ds9 block open - $xpaset -p ds9 block close - - catalog - cat - - Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise. - Syntax: - catalog [new] -         - [ned|simbad|denis|skybot] -         -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -         [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -         [2mass|iras] -         [csc|xmm|rosat] -         [first|nvss] -         - [chandralog|cfhtlog|esolog|stlog|xmmlog] -         [cds <catalogname>] -         [cds - <catalogid>] - -         [load <filename>] -         [import sb|tsv - <filename>] - -         [<ref>] - [<ra> <dec> <coordsys>] -       [<ref>] [allcols] -         - [<ref>] [allrows] -         [<ref>] - [cancel] -         [<ref>] - [clear] -       [<ref>] [close] -         [<ref>] - - - - - - - - - - - - - [crosshair] -         [<ref>] [dec - <col>] -         [<ref>] [edit - yes|no] -         [<ref>] - [export sb|tsv <filename>] -         - [<ref>] [filter <string>] -         [<ref>] [filter load - <filename>] -         [<ref>] - [header] -         [<ref>] [location - <code>] -         [<ref>] - [match] -         - - - - - - - - - - - - - - [<ref>] [match <ref> <ref>] -         [<ref>] -[match - - - - - - - - - - - - - - error <value> degrees|arcmin|arcsec] -         [<ref>] - - - - - - - - - - - - - [match function 1and2|1not2|2not1] -         [<ref>] - - - - - - - - - - - - - [match return 1and2|1only|2only] -         [<ref>] - - - - - - - - - - - - - [match unique yes|no] -         [<ref>] [maxrows - <number>] -       [<ref>] [name - <object>] -         - [<ref>] [panto yes|no] -         [<ref>] [plot - <xcol> <ycol> <xerrcol> <yerrcol>] -       [<ref>] [print] -         [<ref>] [psky - <skyframe>] -         [<ref>] [psystem - <coordsys>] -         [<ref>] [ra - <col>] -         [<ref>] [regions] -         [<ref>] [retrieve] -         [<ref>] [samp] -         [<ref>] [samp - broadcast] -         [<ref>] [samp - send <application>] -         - [<ref>] [save <filename>] -         [<ref>] - [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -         [<ref>] [show - yes|no] -       [<ref>] [radius - <value> degrees|arcmin|arcsec] -         [<ref>] [sky - <skyframe>] -         [<ref>] - [skyformat <skyformat>] -         [<ref>] - [sort <col> incr|decr] -         [<ref>] [symbol - [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -         [<ref>] - [symbol [#] text|size|size2|units|angle <value>] -         [<ref>] - [symbol shape circle|ellipse|box|text|point] -         [<ref>] -[symbol - - - - - - - - - - - - - - shape circle point|box point|diamond point|cross - - - - - - - - - - - - - point|x point|arrow point|boxcircle point] -         [<ref>] [symbol - add| [#] remove] -         [<ref>] [symbol - save|load <filename>] -         [<ref>] [system - <coordsys>] -         [<ref>] - - - - - - - - - - - - - [update] -         [<ref>] [x - <col>] -         [<ref>] [y - <col>] - - Example: - $xpaget ds9 catalog - $xpaget ds9 catalog header - - $xpaset -p ds9 catalog new - $xpaset -p ds9 catalog 2mass - $xpaset -p ds9 catalog cds 2mass - $xpaset -p ds9 catalog cds {I/252} - - $xpaset -p ds9 catalog load foo.xml - $xpaset -p ds9 catalog import tsv foo.tsv - - $xpaset -p ds9 catalog 202.48 47.21 fk5 - $xpaset -p ds9 catalog allrows - $xpaset -p ds9 catalog allcols - $xpaset -p ds9 catalog cancel - $xpaset -p ds9 catalog clear - $xpaset -p ds9 catalog close - $xpaset -p ds9 catalog crosshair - $xpaset -p ds9 catalog dec DEC - $xpaset -p ds9 catalog edit yes - $xpaset -p ds9 catalog export tsv bar.tsv - $xpaset -p ds9 catalog filter '$Jmag>10' - $xpaset -p ds9 catalog filter load foo.flt - $xpaset -p ds9 catalog header - $xpaset -p ds9 catalog location 500 - $xpaset -p ds9 catalog match error 2 arcsec - $xpaset -p ds9 catalog match function 1and2 - $xpaset -p ds9 catalog match unique no - $xpaset -p ds9 catalog match return 1only - $xpaset -p ds9 catalog match # last two catalogs loaded - $xpaset -p ds9 catalog match 2mass csc - $xpaset -p ds9 catalog maxrows 2000 - $xpaset -p ds9 catalog name m51 - $xpaset -p ds9 catalog panto no - $xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' - '$e_Hmag' - $xpaset -p ds9 catalog print - $xpaset -p ds9 catalog psky fk5 - $xpaset -p ds9 catalog psystem wcs - $xpaset -p ds9 catalog ra RA - $xpaset -p ds9 catalog regions - $xpaset -p ds9 catalog retrieve - $xpaset -p ds9 catalog samp broadcast - $xpaset -p ds9 catalog samp send aladin - $xpaset -p ds9 catalog save foo.xml - $xpaset -p ds9 catalog server sao - $xpaset -p ds9 catalog show yes - $xpaset -p ds9 catalog radius 1 degrees - $xpaset -p ds9 catalog symbol condition '$Jmag>15' - $xpaset -p ds9 catalog symbol 2 shape {boxcircle point} - $xpaset -p ds9 catalog symbol color red - $xpaset -p ds9 catalog symbol font times - $xpaset -p ds9 catalog symbol fontsize 14 - $xpaset -p ds9 catalog symbol fontweight bold - $xpaset -p ds9 catalog symbol fontslant italic - $xpaset -p ds9 catalog symbol add - $xpaset -p ds9 catalog symbol 2 remove - $xpaset -p ds9 catalog symbol load foo.sym - $xpaset -p ds9 catalog symbol save bar.sym - $xpaset -p ds9 catalog sky fk5 - $xpaset -p ds9 catalog skyformat degrees - $xpaset -p ds9 catalog sort {Jmag} incr - $xpaset -p ds9 catalog system wcs - $xpaset -p ds9 catalog update - $xpaset -p ds9 catalog x RA - $xpaset -p ds9 catalog y DEC - cd - Sets/Returns the current working directory. - Syntax: - cd [<directory>] - - Example: - $xpaget ds9 cd - $xpaset -p ds9 cd /home/mrbill - - cmap - Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1. - Syntax: - cmap [<colormap>] -      [file] -      [load <filename>] -      [save <filename>] -      [invert yes|no] -      [<constrast> <bias>] -      [tag [load|save] <filename>] -      [tag delete] -      [open|close] - - Example: - $xpaget ds9 cmap - $xpaget ds9 cmap file - $xpaget ds9 cmap invert - $xpaget ds9 cmap value - $xpaset -p ds9 cmap Heat - $xpaset -p ds9 cmap load foo.sao - $xpaset -p ds9 cmap save bar.sao - $xpaset -p ds9 cmap invert yes - $xpaset -p ds9 cmap 5 .5 - $xpaset -p ds9 cmap tag load foo.tag - $xpaset -p ds9 cmap tag save foo.tag - $xpaset -p ds9 cmap tag delete - $xpaset -p ds9 cmap open - $xpaset -p ds9 cmap close - - colorbar - - Controls colorbar parameters. - Syntax: - colorbar [] -          [yes|no] -          [orientation] -          - [horizontal|vertical] -          [numerics - yes|no] -          [space - value|distance] -          [font - times|helvetica|courier] -          [fontsize - <value>] -          [fontweight - normal|bold] -          [fontslant - roman|italic] -          [size] -          [ticks] -          [match] -          [lock - [yes|no]] - - Example: - $xpaget ds9 colorbar - $xpaget ds9 colorbar orientation - $xpaget ds9 colorbar numerics - $xpaget ds9 colorbar space - $xpaget ds9 colorbar font - $xpaget ds9 colorbar fontsize - $xpaget ds9 colorbar fontweight - $xpaget ds9 colorbar fontslant - $xpaget ds9 colorbar size - $xpaget ds9 colorbar ticks - $xpaget ds9 colorbar lock - $xpaset -p ds9 colorbar yes - $xpaset -p ds9 colorbar vertical - $xpaset -p ds9 colorbar orientation vertical - $xpaset -p ds9 colorbar numerics yes - $xpaset -p ds9 colorbar space value - $xpaset -p ds9 colorbar font times - $xpaset -p ds9 colorbar fontsize 14 - $xpaset -p ds9 colorbar fontweight bold - $xpaset -p ds9 colorbar fontslant italic - $xpaset -p ds9 colorbar size 20 - $xpaset -p ds9 colorbar ticks 11 - $xpaset -p ds9 colorbar match - $xpaset -p ds9 colorbar lock yes - - console - Display tcl console window. - Syntax: - -console - - Example: - $xpaset -p ds9 console - - contour - - Controls contours in the current frame. - Syntax: - contour [] -         [yes|no] -         [<coordsys> - [<skyframe>]] -         [clear] -         [generate] -         [load - <filename>] -       [save <filename> - [<coordsys> <skyframe>]] -         [convert] -         [load levels - <filename>] -         [save levels - <filename>] -         [copy] -         [paste - [<coordsys> <color> <width> yes|no]] -         [color <color>] -         [width <width>] -         [dash yes|no] -         [smooth <smooth>] -         [method block|smooth] -         [nlevels <number of - levels>] -         [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -         [log exp <value>] -         [mode - minmax|<value>|zscale|zmax] -         [scope global|local] -         [limits <min> - <max>] -         [levels <value - value value...>] -         [open|close] - - Example: - $xpaget ds9 contour - $xpaget ds9 contour wcs fk5 - $xpaget ds9 contour color - $xpaget ds9 contour width - $xpaget ds9 contour dash - $xpaget ds9 contour smooth - $xpaget ds9 contour method - $xpaget ds9 contour nlevels - $xpaget ds9 contour scale - $xpaget ds9 contour log exp - $xpaget ds9 contour mode - $xpaget ds9 contour scope - $xpaget ds9 contour limits - $xpaget ds9 contour levels - $xpaset -p ds9 contour - $xpaset -p ds9 contour yes - $xpaset -p ds9 contour clear - $xpaset -p ds9 contour generate - $xpaset -p ds9 contour load ds9.ctr - $xpaset -p ds9 contour save ds9.ctr - $xpaset -p ds9 contour save ds9.ctr wcs fk5 - $xpaset -p ds9 contour convert - $xpaset -p ds9 contour load levels ds9.ctr - $xpaset -p ds9 contour save levels ds9.lev - $xpaset -p ds9 contour copy - $xpaset -p ds9 contour paste - $xpaset -p ds9 contour paste wcs red 2 - no - $xpaset -p ds9 contour color yellow - $xpaset -p ds9 contour width 2 - $xpaset -p ds9 contour dash yes - $xpaset -p ds9 contour smooth 5 - $xpaset -p ds9 contour method smooth - $xpaset -p ds9 contour nlevels 10 - $xpaset -p ds9 contour scale sqrt - $xpaset -p ds9 contour log exp 1000 - $xpaset -p ds9 contour mode zscale - $xpaset -p ds9 contour scope local - $xpaset -p ds9 contour limits 1 100 - $xpaset -p ds9 contour levels 1 10 100 1000 - $xpaset -p ds9 contour open - $xpaset -p ds9 contour close - - crop - Set current image display area. - Syntax: - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -      [match <coordsys>] -      [lock <coordsys>|none] -      [reset] -      [3d zmin zmax <coordsys>] -      [open|close] - - Example: - $xpaget ds9 crop # get crop in physical coords - $xpaget ds9 crop wcs galactic sexagesimal arcsec - $xpaget ds9 crop lock - $xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords - $xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 - 22.000204 wcs galactic arcsec - $xpaset -p ds9 crop match wcs - $xpaset -p ds9 crop lock wcs - $xpaset -p ds9 crop reset - $xpaset -p ds9 crop 3d .25 .50 wcs - $xpaset -p ds9 crop open - $xpaset -p ds9 crop close - crosshair - Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set. - Syntax: - crosshair [<x> <y> <coordsys> - [<skyframe>]] -           [match - <coordsys>] -           [lock - <coordsys>|none] - - Example: - $xpaget ds9 crosshair # get crosshair in physical coords - $xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs - coords - $xpaget ds9 crosshair lock - $xpaset -p ds9 crosshair 100 100 physical # set crosshair in - physical - $xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs - coords - $xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 - $xpaset -p ds9 crosshair match wcs - $xpaset -p ds9 crosshair lock wcs - - cube - - Controls FITS cube dialog. - Syntax: - cube [] -      [play|stop|next|prev|first|last] -      [<slice> [<coordsys>]] -      [interval <numeric>] -      [match <coordsys>] -      [lock <coordsys>|none] -      [order 123|132|213|231|312|321] -      [axes lock [yes|no]] -      [open|close] - - Example: - $xpaget ds9 cube - $xpaget ds9 cube wcs - $xpaget ds9 cube interval - $xpaget ds9 cube lock - $xpaget ds9 cube order - $xpaget ds9 cube axes lock - $xpaset -p ds9 cube - $xpaset -p ds9 cube play - $xpaset -p ds9 cube last - $xpaset -p ds9 cube 3 - $xpaset -p ds9 cube 4.4 wcs - $xpaset -p ds9 cube interval 2 - $xpaset -p ds9 cube match wcs - $xpaset -p ds9 cube lock wcs - $xpaset -p ds9 cube order 123 - $xpaset -p ds9 cube axes lock yes - $xpaset -p ds9 cube open - $xpaset -p ds9 cube close - cursor - Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also. - Syntax: - cursor [<x> <y>] - - Example: - $xpaset -p ds9 cursor 10 10 - - data - Return an array of data values given a lower left corner and a - width and height in specified coordinate system. The last - argument of yes indicates to strip the coordinates from the - output and just list the data values. The default is yes. - Syntax: - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]] - - Example: - $xpaget ds9 data image 450 520 3 3 yes - $xpaget ds9 data physical 899 1039 6 6 no - $xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 - 0.00016516669 no - $xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no - - dsssao - dss - - Support for Digital Sky Survey at SAO. - Syntax: - dsssao [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -        [open|close] - - Example: - $xpaget ds9 dsssao name - $xpaget ds9 dsssao coord - $xpaget ds9 dsssao size - $xpaget ds9 dsssao save - $xpaget ds9 dsssao frame - $xpaset -p ds9 dsssao - $xpaset -p ds9 dsssao m31 - $xpaset -p ds9 dsssao name m31 - $xpaset -p ds9 dsssao name clear - $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dsssao size 60 60 arcmin - $xpaset -p ds9 dsssao save yes - $xpaset -p ds9 dsssao frame current - $xpaset -p ds9 dsssao update frame - $xpaset -p ds9 dsssao open - $xpaset -p ds9 dsssao close - dsseso - Support for Digital Sky Survey at ESO. - Syntax: - dsseso [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -    [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -        [open|close] - - Example: - $xpaget ds9 dsseso name - $xpaget ds9 dsseso coord - $xpaget ds9 dsseso size - $xpaget ds9 dsseso save - $xpaget ds9 dsseso frame - $xpaget ds9 dsseso survey - $xpaset -p ds9 dsseso - $xpaset -p ds9 dsseso m31 - $xpaset -p ds9 dsseso name m31 - $xpaset -p ds9 dsseso name clear - $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dsseso size 60 60 arcmin - $xpaset -p ds9 dsseso save yes - $xpaset -p ds9 dsseso frame current - $xpaset -p ds9 dsseso update frame - $xpaset -p ds9 dsseso survey DSS2-red - $xpaset -p ds9 dsseso open - $xpaset -p ds9 dsseso close - dssstsci - Support for Digital Sky Survey at STSCI. - Syntax: - dssstsci [] -          - [<object>] -    [name <object>|clear] -          [<ra> - <dec>] # in wcs fk5 -          [size - <width> <height> degrees|arcmin|arcsec] -          [save yes|no] -          [frame - new|current] -          [update - frame|crosshair] -          [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -          [survey - poss1_blue|poss1_red] -          [survey - all|quickv|phase2_gsc2|phase2_gsc1] -          [open|close] - - Example: - $xpaget ds9 dssstsci name - $xpaget ds9 dssstsci coord - $xpaget ds9 dssstsci size - $xpaget ds9 dssstsci save - $xpaget ds9 dssstsci frame - $xpaget ds9 dssstsci survey - $xpaset -p ds9 dssstsci - $xpaset -p ds9 dssstsci m31 - $xpaset -p ds9 dssstsci name m31 - $xpaset -p ds9 dssstsci name clear - $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dssstsci size 60 60 arcmin - $xpaset -p ds9 dssstsci save yes - $xpaset -p ds9 dssstsci frame current - $xpaset -p ds9 dssstsci update frame - $xpaset -p ds9 dssstsci survey all - $xpaset -p ds9 dssstsci open - $xpaset -p ds9 dssstsci close - envi - Load an ENVI header and file. Optional parameter: array endian. - - Syntax: - envi [new] <header> [<filename>] - - Example: - $xpaset -p ds9 envi foo.hdr - $xpaset -p ds9 envi new foo.hdr - $xpaset -p ds9 envi foo.hdr - foo.bsq - - exit - quits - - Quits DS9. - Syntax: - exit - quit - - Example: - $xpaset -p ds9 exit - - export - - Export loaded image data of current frame in specified image - format. Optional parameters: array endian, nrrd endian, jpeg - quality (1-100) and tiff compression method. - Syntax: - export [array|nrrd|envi|gif|tiff|jpeg|png] - <filename> - export array <filename> - [big|little|native] - export nrrd <filename> - [big|little|native] - export envi <header> [<filename>] [big|little|native] - - export jpeg <filename> [1-100] - export tiff <filename> - [none|jpeg|packbits|deflate] - - Example: - $xpaset -p ds9 export array foo.arr little - $xpaset -p ds9 export nrrd foo.nrrd little - $xpaset -p ds9 export envi foo.hdr little - $xpaset - - - - - - - - - - - - -p ds9 export envi foo.hdr foo.bsq little - $xpaset -p ds9 export tiff - foo.tiff jpeg - $xpaset -p ds9 export jpeg foo.jpeg 75 - $xpaset -p ds9 export png foo.png - file - Query currently loaded file information. - Syntax: - file - - Example: - $xpaget ds9 file - fits - Load a FITS image into the current frame or query the currently - loaded image. - - Syntax: - fits [new|mask|slice] [<filename>] -      [width|height|depth|bitpix] -    [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -     [header [<ext>] [keyword - <string>]] -      [image|table|slice] - - Example: - $xpaget ds9 fits > foo.fits - $xpaget ds9 fits width - $xpaget ds9 fits height - $xpaget ds9 fits depth - $xpaget ds9 fits bitpix - $xpaget ds9 fits size - $xpaget ds9 fits size wcs fk5 arcmin - $xpaget ds9 fits header # primary - $xpaget ds9 fits header 2 # hdu 2 - $xpaget ds9 fits header -2 # hdu 2 with inherit - $xpaget ds9 fits header keyword BITPIX - $xpaget ds9 fits header 1 keyword BITPIX - $xpaget ds9 fits image > foo.fits - $xpaget ds9 fits table > bar.fits - $xpaget ds9 fits slice > foo.fits - $xpaset -p ds9 fits foo.fits - $xpaset -p ds9 fits new foo.fits - $xpaset -p ds9 fits bar.fits[bin=detx,dety] - $xpaset -p ds9 fits slice foo.fits - $xpaset -p ds9 fits mask foo.fits - $cat foo.fits | xpaset ds9 fits - $cat foo.fits | xpaset ds9 fits new - $cat bar.fits | xpaset ds9 fits -[bin=detx,dety] - $cat foo.fits | xpaset ds9 fits slice - $cat foo.fits | xpaset ds9 fits mask - - frame - Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility. - Syntax: - frame [center [#|all]] - [clear [#|all]] -       [new [rgb|3d]] - [delete [#|all]] - [reset [#|all]] -     [refresh [#|all]] -       [hide [#|all]] -     [show [#|all]] -       [move first] -       [move back] -       [move forward] -       [move last] - [first] -     [prev] - [next] - [last] - [frameno #] -     [#] -       [match <coordsys>] -       [lock <coordsys>|none] -       [has + +Example: +$xpaget ds9 array > foo.arr +$xpaget ds9 array little > foo.arr +$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] +$xpaset -p ds9 array new +foo.arr[dim=512,bitpix=-32,endian=little] +$xpaset -p ds9 array mask +foo.arr[dim=512,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 +array[dim=512,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 array +new[dim=512,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 array mask +[dim=512,bitpix=-32,endian=little] +bg +background +Set image background color. +Syntax: +bg <color> + +Example: +$xpaget ds9 bg +$xpaset -p ds9 bg red +backup +Create a backup save set. +Syntax: +backup <filename> + +Example: +$xpaset -p ds9 backup ds9.bck +bin +Controls binning factor, binning buffer size, and +binning function for binning FITS bin tables. The access point +blocking is provided for backward compatibility. +Syntax: +bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<vector>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 bin about +$xpaget ds9 bin buffersize +$xpaget ds9 bin cols +$xpaget ds9 bin factor +$xpaget ds9 bin depth +$xpaget ds9 bin filter +$xpaget ds9 bin function +$xpaget ds9 bin smooth +$xpaget ds9 bin smooth function +$xpaget ds9 bin smooth radius +$xpaget ds9 bin lock +$xpaset -p ds9 bin about 4096 4096 +$xpaset -p ds9 bin about center +$xpaset -p ds9 bin buffersize 512 +$xpaset -p ds9 bin cols detx dety +$xpaset -p ds9 bin colsz detx dety time +$xpaset -p ds9 bin factor 4 +$xpaset -p ds9 bin factor 4 2 +$xpaset -p ds9 bin depth 10 +$xpaset -p ds9 bin filter 'pha > 5' +$xpaset -p ds9 bin filter clear +$xpaset -p ds9 bin function sum +$xpaset -p ds9 bin in +$xpaset -p ds9 bin out +$xpaset -p ds9 bin to fit +$xpaset -p ds9 bin match +$xpaset -p ds9 bin lock yes +$xpaset -p ds9 bin open +$xpaset -p ds9 bin close +blink +Blink mode parameters. Interval is in seconds. +Syntax: +blink [] +    [yes|no] +    [interval <value>] + +Example: +$xpaget ds9 blink +$xpaget ds9 blink interval +$xpaset -p ds9 blink +$xpaset -p ds9 blink yes +$xpaset -p ds9 blink interval 1 +block +Controls blocking parameters. +Syntax: +block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value><value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 block +$xpaget ds9 block lock +$xpaset -p ds9 block 4 +$xpaset -p ds9 block 4 2 +$xpaset -p ds9 block to 4 +$xpaset -p ds9 block to 4 2 +$xpaset -p ds9 block in +$xpaset -p ds9block out +$xpaset -p ds9 block to fit +$xpaset -p ds9 block match +$xpaset -p ds9 block lock yes +$xpaset -p ds9 block open +$xpaset -p ds9 block close +catalog +cat +Support for catalogs. The first three commands will create a new +catalog search. All other commands operated on the last search +created, unless indicated otherwise. +Syntax: +catalog [new] +    [ned|simbad|denis|skybot] +    +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] + +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> +<coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match] +    [<ref>] [match <ref> +<ref>] +    [<ref>] [match error <value> +degrees|arcmin|arcsec] +    [<ref>] [match function +1and2|1not2|2not1] +    [<ref>] [match return +1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> +<xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send +<application>] +    [<ref>] [save <filename>] +    [<ref>] [server +cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>] +    [<ref>] [symbol [#] +text|size|size2|units|angle <value>] +    [<ref>] [symbol shape +circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box +point|diamond point|cross point|x point|arrow point|boxcircle +point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load +<filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +$xpaget ds9 catalog +$xpaget ds9 catalog header + +$xpaset -p ds9 catalog new +$xpaset -p ds9 catalog 2mass +$xpaset -p ds9 catalog cds 2mass +$xpaset -p ds9 catalog cds {I/252} + +$xpaset -p ds9 catalog load foo.xml +$xpaset -p ds9 catalog import tsv foo.tsv + +$xpaset -p ds9 catalog 202.48 47.21 fk5 +$xpaset -p ds9 catalog allrows +$xpaset -p ds9 catalog allcols +$xpaset -p ds9 catalog cancel +$xpaset -p ds9 catalog clear +$xpaset -p ds9 catalog close +$xpaset -p ds9 catalog crosshair +$xpaset -p ds9 catalog dec DEC +$xpaset -p ds9 catalog edit yes +$xpaset -p ds9 catalog export tsv bar.tsv +$xpaset -p ds9 catalog filter '$Jmag>10' +$xpaset -p ds9 catalog filter load foo.flt +$xpaset -p ds9 catalog header +$xpaset -p ds9 catalog location 500 +$xpaset -p ds9 catalog match error 2 arcsec +$xpaset -p ds9 catalog match function 1and2 +$xpaset -p ds9 catalog match unique no +$xpaset -p ds9 catalog match return 1only +$xpaset -p ds9 catalog match # last two catalogs loaded +$xpaset -p ds9 catalog match 2mass csc +$xpaset -p ds9 catalog maxrows 2000 +$xpaset -p ds9 catalog name m51 +$xpaset -p ds9 catalog panto no +$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag' +$xpaset -p ds9 catalog print +$xpaset -p ds9 catalog psky fk5 +$xpaset -p ds9 catalog psystem wcs +$xpaset -p ds9 catalog ra RA +$xpaset -p ds9 catalog regions +$xpaset -p ds9 catalog retrieve +$xpaset -p ds9 catalog samp broadcast +$xpaset -p ds9 catalog samp send aladin +$xpaset -p ds9 catalog save foo.xml +$xpaset -p ds9 catalog server sao +$xpaset -p ds9 catalog show yes +$xpaset -p ds9 catalog radius 1 degrees +$xpaset -p ds9 catalog symbol condition '$Jmag>15' +$xpaset -p ds9 catalog symbol 2 shape {boxcircle point} +$xpaset -p ds9 catalog symbol color red +$xpaset -p ds9 catalog symbol font times +$xpaset -p ds9 catalog symbol fontsize 14 +$xpaset -p ds9 catalog symbol fontweight bold +$xpaset -p ds9 catalog symbol fontslant italic +$xpaset -p ds9 catalog symbol add +$xpaset -p ds9 catalog symbol 2 remove +$xpaset -p ds9 catalog symbol load foo.sym +$xpaset -p ds9 catalog symbol save bar.sym +$xpaset -p ds9 catalog sky fk5 +$xpaset -p ds9 catalog skyformat degrees +$xpaset -p ds9 catalog sort {Jmag} incr +$xpaset -p ds9 catalog system wcs +$xpaset -p ds9 catalog update +$xpaset -p ds9 catalog x RA +$xpaset -p ds9 catalog y DEC +cd +Sets/Returns the current working directory. +Syntax: +cd [<directory>] + +Example: +$xpaget ds9 cd +$xpaset -p ds9 cd /home/mrbill +cmap +Controls the colormap for the current frame. The colormap name +is not case sensitive. A valid contrast value is from 0 to 10 +and bias value from 0 to 1. +Syntax: +cmap [<colormap>] +    [file] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<constrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +$xpaget ds9 cmap +$xpaget ds9 cmap file +$xpaget ds9 cmap invert +$xpaget ds9 cmap value +$xpaset -p ds9 cmap Heat +$xpaset -p ds9 cmap load foo.sao +$xpaset -p ds9 cmap save bar.sao +$xpaset -p ds9 cmap invert yes +$xpaset -p ds9 cmap 5 .5 +$xpaset -p ds9 cmap tag load foo.tag +$xpaset -p ds9 cmap tag save foo.tag +$xpaset -p ds9 cmap tag delete +$xpaset -p ds9 cmap open +$xpaset -p ds9 cmap close +colorbar +Controls colorbar parameters. +Syntax: +colorbar [] +    [yes|no] +    [orientation] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] + +Example: +$xpaget ds9 colorbar +$xpaget ds9 colorbar orientation +$xpaget ds9 colorbar numerics +$xpaget ds9 colorbar space +$xpaget ds9 colorbar font +$xpaget ds9 colorbar fontsize +$xpaget ds9 colorbar fontweight +$xpaget ds9 colorbar fontslant +$xpaget ds9 colorbar size +$xpaget ds9 colorbar ticks +$xpaget ds9 colorbar lock +$xpaset -p ds9 colorbar yes +$xpaset -p ds9 colorbar vertical +$xpaset -p ds9 colorbar orientation vertical +$xpaset -p ds9 colorbar numerics yes +$xpaset -p ds9 colorbar space value +$xpaset -p ds9 colorbar font times +$xpaset -p ds9 colorbar fontsize 14 +$xpaset -p ds9 colorbar fontweight bold +$xpaset -p ds9 colorbar fontslant italic +$xpaset -p ds9 colorbar size 20 +$xpaset -p ds9 colorbar ticks 11 +$xpaset -p ds9 colorbar match +$xpaset -p ds9 colorbar lock yes +console +Display tcl console window. +Syntax: +-console + +Example: +$xpaset -p ds9 console +contour +Controls contours in the current frame. +Syntax: +contour [] +    [yes|no] +    [<coordsys> [<skyframe>]] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> +<skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> +<width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale +linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +$xpaget ds9 contour +$xpaget ds9 contour wcs fk5 +$xpaget ds9 contour color +$xpaget ds9 contour width +$xpaget ds9 contour dash +$xpaget ds9 contour smooth +$xpaget ds9 contour method +$xpaget ds9 contour nlevels +$xpaget ds9 contour scale +$xpaget ds9 contour log exp +$xpaget ds9 contour mode +$xpaget ds9 contour scope +$xpaget ds9 contour limits +$xpaget ds9 contour levels +$xpaset -p ds9 contour +$xpaset -p ds9 contour yes +$xpaset -p ds9 contour clear +$xpaset -p ds9 contour generate +$xpaset -p ds9 contour load ds9.ctr +$xpaset -p ds9 contour save ds9.ctr +$xpaset -p ds9 contour save ds9.ctr wcs fk5 +$xpaset -p ds9 contour convert +$xpaset -p ds9 contour load levels ds9.ctr +$xpaset -p ds9 contour save levels ds9.lev +$xpaset -p ds9 contour copy +$xpaset -p ds9 contour paste +$xpaset -p ds9 contour paste wcs red 2 no +$xpaset -p ds9 contour color yellow +$xpaset -p ds9 contour width 2 +$xpaset -p ds9 contour dash yes +$xpaset -p ds9 contour smooth 5 +$xpaset -p ds9 contour method smooth +$xpaset -p ds9 contour nlevels 10 +$xpaset -p ds9 contour scale sqrt +$xpaset -p ds9 contour log exp 1000 +$xpaset -p ds9 contour mode zscale +$xpaset -p ds9 contour scope local +$xpaset -p ds9 contour limits 1 100 +$xpaset -p ds9 contour levels 1 10 100 1000 +$xpaset -p ds9 contour open +$xpaset -p ds9 contour close +crop +Set current image display area. +Syntax: +crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3d zmin zmax <coordsys>] +    [open|close] + +Example: +$xpaget ds9 crop # get crop in physical coords +$xpaget ds9 crop wcs galactic sexagesimal arcsec +$xpaget ds9 crop lock +$xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords +$xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 +22.000204 wcs galactic arcsec +$xpaset -p ds9 crop match wcs +$xpaset -p ds9 crop lock wcs +$xpaset -p ds9 crop reset $xpaset -p ds9 crop 3d .25 .50 +wcs +$xpaset -p ds9 crop open +$xpaset -p ds9 crop close +crosshair +Controls the current position of the crosshair in the current +frame. DS9 is placed in crosshair mode when the crosshair is +set. +Syntax: +crosshair [<x> <y> <coordsys> +[<skyframe>]] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$xpaget ds9 crosshair # get crosshair in physical coords +$xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs +coords +$xpaget ds9 crosshair lock +$xpaset -p ds9 crosshair 100 100 physical # set crosshair in +physical +$xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs +coords +$xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 +$xpaset -p ds9 crosshair match wcs +$xpaset -p ds9 crosshair lock wcs +cube +Controls FITS cube dialog. +Syntax: +cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 cube +$xpaget ds9 cube wcs +$xpaget ds9 cube interval +$xpaget ds9 cube lock +$xpaget ds9 cube order +$xpaget ds9 cube axes lock +$xpaset -p ds9 cube +$xpaset -p ds9 cube play +$xpaset -p ds9 cube last +$xpaset -p ds9 cube 3 +$xpaset -p ds9 cube 4.4 wcs +$xpaset -p ds9 cube interval 2 +$xpaset -p ds9 cube match wcs +$xpaset -p ds9 cube lock wcs +$xpaset -p ds9 cube order 123 +$xpaset -p ds9 cube axes lock yes +$xpaset -p ds9 cube open +$xpaset -p ds9 cube close +cursor +Move mouse pointer or crosshair in image pixels in the current +frame. Note, this will move selected Regions also. +Syntax: +cursor [<x> <y>] + +Example: +$xpaset -p ds9 cursor 10 10 +data +Return an array of data values given a lower left corner and a +width and height in specified coordinate system. The last argument +of yes indicates to strip the coordinates from the output and just +list the data values. The default is yes. +Syntax: +data [<coordsys> [<skyframe>] <x> <y> +<width> <height> [yes|no]] + +Example: +$xpaget ds9 data image 450 520 3 3 yes +$xpaget ds9 data physical 899 1039 6 6 no +$xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 +0.00016516669 no +$xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 +0.00016516669 no +dsssao +dss +Support for Digital Sky Survey at SAO. +Syntax: +dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 dsssao name +$xpaget ds9 dsssao coord +$xpaget ds9 dsssao size +$xpaget ds9 dsssao save +$xpaget ds9 dsssao frame +$xpaset -p ds9 dsssao +$xpaset -p ds9 dsssao m31 +$xpaset -p ds9 dsssao name m31 +$xpaset -p ds9 dsssao name clear +$xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dsssao size 60 60 arcmin +$xpaset -p ds9 dsssao save yes +$xpaset -p ds9 dsssao frame current +$xpaset -p ds9 dsssao update frame +$xpaset -p ds9 dsssao open +$xpaset -p ds9 dsssao close +dsseso +Support for Digital Sky Survey at ESO. +Syntax: +dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +$xpaget ds9 dsseso name +$xpaget ds9 dsseso coord +$xpaget ds9 dsseso size +$xpaget ds9 dsseso save +$xpaget ds9 dsseso frame +$xpaget ds9 dsseso survey +$xpaset -p ds9 dsseso +$xpaset -p ds9 dsseso m31 +$xpaset -p ds9 dsseso name m31 +$xpaset -p ds9 dsseso name clear +$xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dsseso size 60 60 arcmin +$xpaset -p ds9 dsseso save yes +$xpaset -p ds9 dsseso frame current +$xpaset -p ds9 dsseso update frame +$xpaset -p ds9 dsseso survey DSS2-red +$xpaset -p ds9 dsseso open +$xpaset -p ds9 dsseso close +dssstsci +Support for Digital Sky Survey at STSCI. +Syntax: +dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +$xpaget ds9 dssstsci name +$xpaget ds9 dssstsci coord +$xpaget ds9 dssstsci size +$xpaget ds9 dssstsci save +$xpaget ds9 dssstsci frame +$xpaget ds9 dssstsci survey +$xpaset -p ds9 dssstsci +$xpaset -p ds9 dssstsci m31 +$xpaset -p ds9 dssstsci name m31 +$xpaset -p ds9 dssstsci name clear +$xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dssstsci size 60 60 arcmin +$xpaset -p ds9 dssstsci save yes +$xpaset -p ds9 dssstsci frame current +$xpaset -p ds9 dssstsci update frame +$xpaset -p ds9 dssstsci survey all +$xpaset -p ds9 dssstsci open +$xpaset -p ds9 dssstsci close +envi +Load an ENVI header and file. Optional parameter: array +endian. +Syntax: +envi [new] <header> [<filename>] + +Example: +$xpaset -p ds9 envi foo.hdr +$xpaset -p ds9 envi new foo.hdr +$xpaset -p ds9 envi foo.hdr foo.bsq + +exit +quits +Quits DS9. +Syntax: +exit +quit + +Example: +$xpaset -p ds9 exit +export +Export loaded image data of current frame in specified image +format. Optional parameters: array endian, nrrd endian, jpeg +quality (1-100) and tiff compression method. +Syntax: +export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> +export array <filename>[big|little|native] +export nrrd <filename>[big|little|native] +export envi <header> +[<filename>][big|little|native] +export jpeg <filename>[1-100] +export tiff <filename>[none|jpeg|packbits|deflate] + +Example: +$xpaset -p ds9 export array foo.arr little +$xpaset -p ds9 export nrrd foo.nrrd little +$xpaset -p ds9 export envi foo.hdr little +$xpaset -p ds9 export envi foo.hdr foo.bsq little +$xpaset -p ds9 export tiff foo.tiff jpeg +$xpaset -p ds9 export jpeg foo.jpeg 75 +$xpaset -p ds9 export png foo.png +file +Query currently loaded file information. +Syntax: +file + +Example: +$xpaget ds9 file +fits +Load a FITS image into the current frame or query the currently +loaded image. +Syntax: +fits[new|mask|slice] [<filename>] +    [width|height|depth|bitpix] +    [size [wcs|wcsa...wcsz] +[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +    [header [<ext>] [keyword +<string>]] +    [image|table|slice] + +Example: +$xpaget ds9 fits > foo.fits +$xpaget ds9 fits width +$xpaget ds9 fits height +$xpaget ds9 fits depth +$xpaget ds9 fits bitpix +$xpaget ds9 fits size +$xpaget ds9 fits size wcs fk5 arcmin +$xpaget ds9 fits header # primary +$xpaget ds9 fits header 2 # hdu 2 +$xpaget ds9 fits header -2 # hdu 2 with inherit +$xpaget ds9 fits header keyword BITPIX +$xpaget ds9 fits header 1 keyword BITPIX +$xpaget ds9 fits image > foo.fits +$xpaget ds9 fits table > bar.fits +$xpaget ds9 fits slice > foo.fits +$xpaset -p ds9 fits foo.fits +$xpaset -p ds9 fits new foo.fits +$xpaset -p ds9 fits bar.fits[bin=detx,dety] +$xpaset -p ds9 fits slice foo.fits +$xpaset -p ds9 fits mask foo.fits +$cat foo.fits | xpaset ds9 fits +$cat foo.fits | xpaset ds9 fits new +$cat bar.fits | xpaset ds9 fits -[bin=detx,dety] +$cat foo.fits | xpaset ds9 fits slice +$cat foo.fits | xpaset ds9 fits mask +frame +Controls frame functions. Frames may be created, deleted, reset, +and centered. While return the current frame number. If you goto a +frame that does not exists, it will be created. If the frame is +hidden, it will be shown. The 'frameno' option is available for +backward compatibility. +Syntax: +frame [center [#|all]] +    [clear [#|all]] +    [new [rgb|3d]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] +    [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] -       [has contour [aux]]] -       [has fits [bin|cube|mosaic]] -       [has marker - [highlite|paste|select|undo]] -       [has system <coordsys>] -       [has wcs - [<wcssys>]] -       [has wcs celestial - [<wcssys>]] -       [has wcs linear - [<wcssys>]] - - Example: - $xpaget ds9 frame # returns the id of the current frame - $xpaget ds9 frame frameno # returns the id of the current frame - $xpaget ds9 frame all # returns the id of all frames - $xpaget ds9 frame active # returns the id of all active frames - $xpaget ds9 frame lock - $xpaget ds9 frame has amplifier - $xpaget ds9 frame has datamin - $xpaget ds9 frame has datasec - $xpaget ds9 frame has detector - $xpaget ds9 frame has grid - $xpaget ds9 frame has iis - $xpaget ds9 frame has irafmin - $xpaget ds9 frame has physical - $xpaget ds9 frame has smooth - $xpaget ds9 frame has contour - $xpaget ds9 frame has contour aux - $xpaget ds9 frame has fits - $xpaget ds9 frame has fits bin - $xpaget ds9 frame has fits cube - $xpaget ds9 frame has fits mosaic - $xpaget ds9 frame has marker highlite - $xpaget ds9 frame has marker paste - $xpaget ds9 frame has marker select - $xpaget ds9 frame has marker undo - $xpaget ds9 frame has system physical - $xpaget ds9 frame has wcs wcsa - $xpaget ds9 frame has wcs celestial wcsa - $xpaget ds9 frame has wcs linear wcsa - $xpaset -p ds9 frame center # center current frame - $xpaset -p ds9 frame center 1 # center 'Frame1' - $xpaset -p ds9 frame center all # center all frames - $xpaset -p ds9 frame clear # clear current frame - $xpaset -p ds9 frame new # create new frame - $xpaset -p ds9 frame new rgb # create new rgb frame - $xpaset -p ds9 frame delete # delete current frame - $xpaset -p ds9 frame reset # reset current frame - $xpaset -p ds9 frame refresh # refresh current frame - $xpaset -p ds9 frame hide # hide current frame - $xpaset -p ds9 frame show 1 # show frame 'Frame1' - $xpaset -p ds9 frame move first # move frame to first in order - $xpaset -p ds9 frame move back # move frame back in order - $xpaset -p ds9 frame move forward # move frame forward in order - $xpaset -p ds9 frame move last # move frame to last in order - $xpaset -p ds9 frame first # goto first frame - $xpaset -p ds9 frame prev # goto prev frame - $xpaset -p ds9 frame next # goto next frame - $xpaset -p ds9 frame last # goto last frame - $xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if - needed - $xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed - $xpaset -p ds9 frame match wcs - $xpaset -p ds9 frame lock wcs - gif - Load GIF image into current frame. - - Syntax: - gif [new|slice] [<filename>] - - Example: - $xpaget ds9 gif > foo.gif - $xpaset -p ds9 gif foo.gif - $xpaset -p ds9 gif new foo.gif - $xpaset -p ds9 gif slice foo.gif - $cat foo.gif | xpaset ds9 gif # not available - windows - $cat foo.gif | xpaset ds9 gif new # not - available windows - $cat foo.gif | xpaset ds9 gif slice # - not available windows - grid - Controls coordinate grid. For grid numeric format syntax, - click here. - Syntax: - grid [] -       [yes|no] -       [type analysis|publication] -       [system <coordsys>] -       [sky <skyframe>] -       [skyformat <skyformat>] -       [grid yes|no] -       [grid color <color>] -       [grid width <value>] -       [grid dash yes|no] -       [grid gap1 <value>] -       [grid gap2 - <value>] -       [grid - gap3 <value>] -       [axes yes|no] -       [axes color <color>] -       [axes width <value>] -       [axes dash yes|no] -       [axes type interior|exterior] -       [axes origin - lll|llu|lul|luu|ull|ulu|uul|uuu] -       [format1 <format>] -       [format2 <format>] -       [tickmarks yes|no] -       [tickmarks color <color>] -       [tickmarks width <value>] -       [tickmarks dash yes|no] -       [border yes|no] -       [border color <color>] -       [border width <value>] -       [border dash yes|no] -       [numerics yes|no] -       [numerics font - times|helvetica|courier] -       [numerics fontsize <value>] -       [numerics fontweight normal|bold] -       [numerics fontslant roman|italic] -       [numerics color <color>] -       [numerics gap1 <value>] -       [numerics gap2 - <value>] -       [numerics - gap3 <value>] -       [numerics type - interior|exterior] -       [numerics vertical yes|no] -       [title yes|no] -       [title text <text>] -       [title def yes|no] -       [title gap <value>] -       [title font - times|helvetica|courier] -       [title fontsize <value>] -       [title fontweight normal|bold] -       [title fontslant roman|italic] -       [title color <color>] -       [labels yes|no] -       [labels def1 yes|no] -       [labels def2 yes|no] -       [labels text1 <text>] -       [labels text2 - <text>] -       [labels gap1 - <value>] -       [labels gap2 <value>] -       [labels font - times|helvetica|courier] -       [labels fontsize <value>] -       [labels fontweight normal|bold] -       [labels fontslant roman|italic] -       [labels color <color>] -       [reset] -       [load <filename>] -       [save <filename>] -       [open|close] - - Example: - $xpaget ds9 grid - $xpaget ds9 grid type - $xpaget ds9 grid system - $xpaget ds9 grid sky - $xpaget ds9 grid skyformat - $xpaget ds9 grid grid - $xpaget ds9 grid grid color - $xpaget ds9 grid grid width - $xpaget ds9 grid grid dash - $xpaget ds9 grid grid gap1 - $xpaget ds9 grid grid gap2 - $xpaget ds9 grid grid gap3 - $xpaget ds9 grid axes - $xpaget ds9 grid axes color - $xpaget ds9 grid axes width - $xpaget ds9 grid axes dash - $xpaget ds9 grid axes type - $xpaget ds9 grid axes origin - $xpaget ds9 grid format1 - $xpaget ds9 grid format2 - $xpaget ds9 grid tickmarks - $xpaget ds9 grid tickmarks color - $xpaget ds9 grid tickmarks width - $xpaget ds9 grid tickmarks dash - $xpaget ds9 grid border - $xpaget ds9 grid border color - $xpaget ds9 grid border width - $xpaget ds9 grid border dash - $xpaget ds9 grid numerics - $xpaget ds9 grid numerics font - $xpaget ds9 grid numerics fontsize - $xpaget ds9 grid numerics fontweight - $xpaget ds9 grid numerics fontslant - $xpaget ds9 grid numerics color - $xpaget ds9 grid numerics gap1 - $xpaget ds9 grid numerics gap2 - $xpaget ds9 grid numerics gap3 - $xpaget ds9 grid numerics type - $xpaget ds9 grid numerics vertical - $xpaget ds9 grid title - $xpaget ds9 grid title text - $xpaget ds9 grid title def - $xpaget ds9 grid title gap - $xpaget ds9 grid title font - $xpaget ds9 grid title fontsize - $xpaget ds9 grid title fontweight - $xpaget ds9 grid title fontslant - $xpaget ds9 grid title color - $xpaget ds9 grid labels - $xpaget ds9 grid labels text1 - $xpaget ds9 grid labels def1 - $xpaget ds9 grid labels gap1 - $xpaget ds9 grid labels text2 - $xpaget ds9 grid labels def2 - $xpaget ds9 grid labels gap2 - $xpaget ds9 grid labels font - $xpaget ds9 grid labels fontsize - $xpaget ds9 grid labels fontweight - $xpaget ds9 grid labels fontslant - $xpaget ds9 grid labels color - $xpaset -p ds9 grid - $xpaset -p ds9 grid yes - $xpaset -p ds9 grid type analysis - $xpaset -p ds9 grid system wcs - $xpaset -p ds9 grid sky fk5 - $xpaset -p ds9 grid skyformat degrees - $xpaset -p ds9 grid grid yes - $xpaset -p ds9 grid grid color red - $xpaset -p ds9 grid grid width 2 - $xpaset -p ds9 grid grid dash yes - $xpaset -p ds9 grid grid gap1 10 - $xpaset -p ds9 grid grid gap2 10 - $xpaset -p ds9 grid grid gap3 10 - $xpaset -p ds9 grid axes yes - $xpaset -p ds9 grid axes color red - $xpaset -p ds9 grid axes width 2 - $xpaset -p ds9 grid axes dash yes - $xpaset -p ds9 grid axes type exterior - $xpaset -p ds9 grid axes origin lll - $xpaset -p ds9 grid format1 d.2 - $xpaset -p ds9 grid format2 d.2 - $xpaset -p ds9 grid tickmarks yes - $xpaset -p ds9 grid tickmarks color red - $xpaset -p ds9 grid tickmarks width 2 - $xpaset -p ds9 grid tickmarks dash yes - $xpaset -p ds9 grid border yes - $xpaset -p ds9 grid border color red - $xpaset -p ds9 grid border width 2 - $xpaset -p ds9 grid border dash yes - $xpaset -p ds9 grid numerics yes - $xpaset -p ds9 grid numerics font courier - $xpaset -p ds9 grid numerics fontsize 12 - $xpaset -p ds9 grid numerics fontweight bold - $xpaset -p ds9 grid numerics fontslant italic - $xpaset -p ds9 grid numerics color red - $xpaset -p ds9 grid numerics gap1 10 - $xpaset -p ds9 grid numerics gap2 10 - $xpaset -p ds9 grid numerics gap3 10 - $xpaset -p ds9 grid numerics type exterior - $xpaset -p ds9 grid numerics vertical yes - $xpaset -p ds9 grid title yes - $xpaset -p ds9 grid title text {Hello World} - $xpaset -p ds9 grid title def yes - $xpaset -p ds9 grid title gap 10 - $xpaset -p ds9 grid title font courier - $xpaset -p ds9 grid title fontsize 12 - $xpaset -p ds9 grid title fontweight bold - $xpaset -p ds9 grid title fontslant italic - $xpaset -p ds9 grid title color red - $xpaset -p ds9 grid labels yes - $xpaset -p ds9 grid labels text1 {Hello World} - $xpaset -p ds9 grid labels def1 yes - $xpaset -p ds9 grid labels gap1 10 - $xpaset -p ds9 grid labels text2 {Hello World} - $xpaset -p ds9 grid labels def2 yes - $xpaset -p ds9 grid labels gap2 10 - $xpaset -p ds9 grid labels font courier - $xpaset -p ds9 grid labels fontsize 12 - $xpaset -p ds9 grid labels fontweight boldj - $xpaset -p ds9 grid labels fontslant italic - $xpaset -p ds9 grid labels color red - $xpaset -p ds9 grid reset - $xpaset -p ds9 grid load foo.grd - $xpaset -p ds9 grid save foo.grd - $xpaset -p ds9 grid open - $xpaset -p ds9 grid close - - header - Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from xpa fits header. - Syntax: - header [<ext>] -        [close [<ext>]] -        [save [<ext>] - <filename>] - - Example: - $xpaset -p ds9 header - $xpaset -p ds9 header 2 - $xpaset -p ds9 header close - $xpaset -p ds9 header save 1 foo.txt - - height - Set the height of the image display window. - Syntax: - height [<value>] - - Example: - $xpaget ds9 height - $xpaset -p ds9 height 512 - - iconify - Toggles iconification. - Syntax: - iconify [] -         [yes|no] - - Example: - $xpaget ds9 iconify - $xpaset -p ds9 iconify - $xpaset -p ds9 iconify yes - iexam - Interactive examine function. A blinking cursor will indicate - to the user to click on a point on an image. The specified - information will be returned at that time. The default event is - button. In the last form, the following macros will be - expanded if present: $width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z. See Analysis - Macros for more information. - - Syntax: - iexam [] -       [[]|button|key|any] coordinate - <coordsys> [<skyframe>] [<skyformat>] -       [[]|button|key|any] data - [width][height] -       [[]|button|key|any] - <macro string>] - - Example: - $xpaget ds9 iexam # image coordinates - $xpaget ds9 iexam coordinate image - $xpaget ds9 iexam key coordinate image # return coordinate - and key event - $xpaget ds9 iexam coordinate wcs fk5 degrees - $xpaget ds9 iexam coordinate wcs galactic sexagesimal - $xpaget ds9 iexam coordinate fk5 - $xpaget ds9 iexam data # return data value - $xpaget ds9 iexam key data # return data value and key event - $xpaget ds9 iexam data 3 3 # return all data in 3x3 box about - selected point - $xpaget ds9 iexam {'Click at $x,$y in file $filename'} - iis - Set/Get IIS Filename. Optional mosaic number maybe supplied. - Syntax: - iis [filename <filename> [#]] - - Example: - $xpaget ds9 iis filename - $xpaget ds9 iis filename 4 - $xpaset -p ds9 iis filename foo.fits - $xpaset -p ds9 iis filename bar.fits 4 - jpeg - Load JPEG image into current frame. Optional parameters: jpeg - quality (1-100) - Syntax: - jpeg [new|slice] [<filename>] [1-100] - - Example: - $xpaget ds9 jpeg > foo.jpeg - $xpaget ds9 jpeg 100 > foo.jpeg - $xpaset -p ds9 jpeg foo.jpeg - $xpaset -p ds9 jpeg new foo.jpeg - $xpaset -p ds9 jpeg slice foo.jpeg - $cat foo.jpeg | xpaset ds9 jpeg # - not available windows - $cat foo.jpeg | xpaset ds9 jpeg new # - not available windows - $cat foo.jpeg | xpaset ds9 jpeg slice # - not available windows - lock - Lock all other frames to the current frame. - Syntax: - lock [frame <coordsys>|none] -      [crosshair - <coordsys>|none] -      [crop <coordsys>|none] -      [slice <coordsys>|none]] -      [bin [yes|no]] -      [axes [yes|no]] -      [scale [yes|no]] -      [scalelimites [yes|no]] -      [colorbar [yes|no]] -      [block [yes|no]] -      [smooth [yes|no]] -      [3d [yes|no]] - - Example: - $xpaget -p ds9 lock frame - $xpaget -p ds9 lock crosshair - $xpaget -p ds9 lock crop - $xpaget -p ds9 lock slice - $xpaget -p ds9 lock bin - $xpaget -p ds9 lock axes - $xpaget -p ds9 lock scale - $xpaget -p ds9 lock scalelimits - $xpaget -p ds9 lock colorbar - $xpaget -p ds9 lock block - $xpaget -p ds9 lock smooth - $xpaget -p ds9 lock 3d - $xpaset -p ds9 lock frame wcs - $xpaset -p ds9 lock crosshair wcs - $xpaset -p ds9 lock crop wcs - $xpaset -p ds9 lock slice wcs - $xpaset -p ds9 lock bin yes - $xpaset -p ds9 lock axes yes - $xpaset -p ds9 lock scale yes - $xpaset -p ds9 lock scalelimits yes - $xpaset -p ds9 lock colorbar yes - $xpaset -p ds9 lock block yes - $xpaset -p ds9 lock smooth yes - $xpaset -p ds9 lock 3d yes - - lower - Lower in the window stacking order. - Syntax: - lower - - Example: - $xpaset -p ds9 lower - - magnifier - Controls the magnifier settings. - Syntax: - magnifier [color <color>] -           [zoom - <value>] -           [cursor - yes|no] -           [region - yes|no] - - Example: - $xpaget ds9 magnifier color - $xpaget ds9 magnifier zoom - $xpaget ds9 magnifier cursor - $xpaget ds9 magnifier region - $xpaset -p ds9 magnifier color yellow - $xpaset -p ds9 magnifier zoom 2 - $xpaset -p ds9 magnifier cursor no - $xpaset -p ds9 magnifier region no - mask - - Controls mask parameters. - Syntax: - mask [color <color>] -      [mark zero|nonzero|nan|nonnan|range] -      [range <low> <high>] -      [transparency <value>] -      [system <coordsys>] -      [clear] -      [open|close] - - Example: - $xpaget ds9 mask color - $xpaget ds9 mask mark - $xpaget ds9 mask range - $xpaget ds9 mask system - $xpaget ds9 mask transparency - $xpaset -p ds9 mask color red - $xpaset -p ds9 mask mark zero - $xpaset -p ds9 mask range 10 100 - $xpaset -p ds9 mask transparency 50 - $xpaset -p ds9 mask system wcs - $xpaset -p ds9 mask clear - $xpaset -p ds9 mask open - $xpaset -p ds9 mask close - - match - Match all other frames to the current frame. - Syntax: - match [frame <coordsys>] -       [crosshair - <coordsys>] -       [crop <coordsys>] -       [slice <coordsys>] -       [bin] -       [axes] -       [scale] -       [scalelimits] -       [colorbar] -       [block] -     [smooth] -       [3d] - - Example: - $xpaset -p ds9 match frame wcs - $xpaset -p ds9 match crosshair wcs - $xpaset -p ds9 match crop wcs - $xpaset -p ds9 match slice wcs - $xpaset -p ds9 match bin - $xpaset -p ds9 match axes - $xpaset -p ds9 match scale - $xpaset -p ds9 match scalelimits - $xpaset -p ds9 match colorbar - $xpaset -p ds9 match block - $xpaset -p ds9 match smooth - $xpaset -p ds9 match 3d - - mecube - Load FITS multiple extension file as data cube. - - Syntax: - mecube [new] [<filename>] - - Example: - $xpaget ds9 mecube > foo.fits - $xpaset -p ds9 mecube foo.fits - $xpaset -p ds9 mecube new foo.fits - $cat foo.fits | xpaset ds9 mecube - $cat foo.fits | xpaset ds9 mecube new - minmax - This is how DS9 determines the min and max data values - from the data. SCAN will scan all data. DATAMIN - and IRAFMIN will use the values of the keywords if - present. - - Syntax: - minmax [scan|sample|datamin|irafmin] -        [mode - scan|sample|datamin|irafmin] -    [interval #] - - Example: - $xpaget ds9 minmax mode - $xpaget ds9 minmax interval - $xpaset -p ds9 minmax scan - $xpaset -p ds9 minmax mode scan - $xpaset -p ds9 minmax interval 100 - - mode - Controls the first mouse button mode. - Syntax: - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - $xpaget ds9 mode - $xpaset -p ds9 mode crosshair - mosaic - Load FITS mosaic segment into current frame. - Syntax: - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] - [<filename>] - - Example: - $xpaget ds9 mosaic > foo.fits - $xpaset -p ds9 mosaic foo.fits - $xpaset -p ds9 mosaic wcs foo.fits - $xpaset -p ds9 mosaic wcs new foo.fits - $xpaset -p ds9 mosaic wcs mask foo.fits - $cat foo.fits | xpaset ds9 mosaic - $cat foo.fits | xpaset ds9 mosaic wcs - $cat foo.fits | xpaset ds9 mosaic wcs new - $cat foo.fits | xpaset ds9 mosaic wcs - mask - - mosaicimage - Load FITS mosaic image into current frame. - Syntax: - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>] - - Example: - $xpaget ds9 mosaicimage > foo.fits - $xpaset -p ds9 mosaicimage foo.fits - $xpaset -p ds9 mosaicimage wcs foo.fits - $xpaset -p ds9 mosaicimage wcs new foo.fits - $xpaset -p ds9 mosaicimage wcs mask foo.fits - $cat foo.fits | xpaset ds9 mosaicimage - $cat foo.fits | xpaset ds9 mosaicimage wcs - $cat foo.fits | xpaset ds9 mosaicimage wcs new - $cat foo.fits | xpaset ds9 mosaicimage wcs mask - movie - - Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times. - Syntax: - movie [slice|frame|3d] [mpeg|gif] - <filename> - movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - $xpaset -p ds9 movie slice mpeg ds9.mpg - $xpaset -p ds9 movie frame gif ds9.gif - $xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 - azto 60 oscillate 1 - multiframe - Load FITS multiple extension file as multiple images. - - Syntax: - multiframe [<filename>] - - Example: - $xpaset -p ds9 multiframe foo.fits - $cat foo.fits | xpaset ds9 multiframe # - not available windows - nameserver - Support Name Server functions. Coordinates are in fk5. - Syntax: - nameserver [<object>] -            - [name <object>] -            - [server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] -            - [skyformat degrees|sexagesimal] -            - [pan] -            - [crosshair] -            - [open|close] - - Example: - $xpaget ds9 nameserver - $xpaget ds9 nameserver server - $xpaget ds9 nameserver skyformat - $xpaget ds9 nameserver m31 - $xpaset -p ds9 nameserver m31 - $xpaset -p ds9 nameserver name m31 - $xpaset -p ds9 nameserver server ned-sao - $xpaset -p ds9 nameserver skyformat sexagesimal - $xpaset -p ds9 nameserver pan - $xpaset -p ds9 nameserver crosshair - $xpaset -p ds9 nameserver open - $xpaset -p ds9 nameserver close - - nan - Set image not-a-number color. - Syntax: - nan <color> - - Example: - $xpaget ds9 nan - $xpaset -p ds9 nan red - - nrrd - Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian. - - Syntax: - nrrd [native|little|big] - nrrd [new|mask] [<filename>] - - Example: - $xpaget ds9 nrrd - $xpaget ds9 nrrd big - $xpaset -p ds9 nrrd foo.nrrd - $xpaset -p ds9 nrrd new foo.nrrd - $xpaset -p ds9 nrrd mask foo.nrrd - $cat foo.nrrd | xpaset ds9 nrrd - $cat foo.nrrd | xpaset ds9 nrrd new - $cat foo.nrrd | xpaset ds9 nrrd mask - nvss - Support for NRAO VLA Sky Survey. - Syntax: - nvss [] -      [<object>] -      [name <object>|clear] -      [<ra> <dec>] # in wcs fk5 -      [size <width> <height> - degrees|arcmin|arcsec] -      [save yes|no] -      [frame new|current] -      [update frame|crosshair] -      [open|close] - - Example: - $xpaget ds9 nvss name - $xpaget ds9 nvss coord - $xpaget ds9 nvss size - $xpaget ds9 nvss save - $xpaget ds9 nvss frame - $xpaset -p ds9 nvss - $xpaset -p ds9 nvss m31 - $xpaset -p ds9 nvss name m31 - $xpaset -p ds9 nvss name clear - $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 nvss size 60 60 arcmin - $xpaset -p ds9 nvss save yes - $xpaset -p ds9 nvss frame current - $xpaset -p ds9 nvss update frame - $xpaset -p ds9 nvss open - $xpaset -p ds9 nvss close - orient - Controls the orientation of the current frame. - Syntax: - orient [none|x|y|xy] -        [open|close] - - Example: - $xpaget ds9 orient - $xpaset -p ds9 orient xy - $xpaset -p ds9 orient open - $xpaset -p ds9 orient close - - pagesetup - Controls Page Setup options. - - Syntax: - pagesetup [orient portrait|landscape] -           [scale - <numberic>] -           [size - letter|legal|tabloid|poster|a4] - - Example: - $xpaget ds9 pagesetup orient - $xpaget ds9 pagesetup scale - $xpaget ds9 pagesetup size - $xpaset -p ds9 pagesetup orient portrait - $xpaset -p ds9 pagesetup scale 50 - $xpaset -p ds9 pagesetup size poster - - pan - Controls the current image cursor location for the current - frame. - Syntax: - pan [<coordsys> [<skyframe>] [<skyformat>]] # - get current coords - - pan [<x> <y> <coordsys> [<skyframe>]] # - relative -     [to <x> <y> <coordsys> - [<skyframe>]] # absolute -     [open|close] - - Example: - $xpaget ds9 pan # get current image coords - $xpaget ds9 pan wcs fk4 sexagesimal # get current coords - $xpaset -p ds9 pan 200 200 image # pan relative - $xpaset -p ds9 pan to 400 400 physical # pan to physical coords - $xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs - coords - $xpaset -p ds9 pan open - $xpaset -p ds9 pan close - - pixeltable - Display/Hide the pixel table. - Syntax: - pixeltable [] -            [yes|open] -            - [no|close] - - Example: - $xpaget ds9 pixeltable - $xpaset -p ds9 pixeltable - $xpaset -p ds9 pixeltable yes - $xpaset -p ds9 pixeltable open - $xpaset -p ds9 pixeltable close - plot - Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions: - xy    x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors - - To create a new plot, use the plot new command. - Syntax: - # create new empty plot window - plot [] -      - [line|bar|scatter] -      [new] -      [new - line|bar|scatter] -      [new name - <plotname>] -      [new name - <plotname> line|bar|scatter] - - # create new plot with data from - stdin - plot [new - <title> <xaxis label> <yaxis label> xy|xyex|xyey|xyexey] -      [new - - - - - - - - - - - - - [line|bar|scatter] <title> <xaxis label> <yaxis - label> xy|xyex|xyey|xyexey] -      [new - name <plotname> <title> - <xaxis label> <yaxis label> xy|xyex|xyey|xyexey] -      [new - name <plotname> line|bar|scatter - <title> <xaxis label> <yaxis label> xy|xyex|xyey|xyexey] - - # create new plot with data from - stdin which includes title/dim headers - plot [new stdin] -      [new - [line|bar|scatter] stdin] -      [new - - - - - - - - - - - - name <plotname> stdin] -      [new - - - - - - - - - - - - name <plotname> line|bar|scatter - stdin] - - # load data into - existing plot from stdin - plot [[<plotname>] data - xy|xyex|xyey|xyexey] - - # existing plot - plot [[<plotname>] - - - - - - - - - - - - load <filename> xy|xyex|xyey|xyexey] -      - [[<plotname>] save <filename>] -      - [[<plotname>] clear] -      [[<plotname>] - - - - - - - - - - - - - duplicate [#]] -      [[<plotname>] - - - - - - - - - - - - - stats yes|no] -      [[<plotname>] - - - - - - - - - - - - - list yes|no] -      [[<plotname>] - - - - - - - - - - - - - loadconfig <filename>] -      - [[<plotname>] saveconfig <filename>] -      - [[<plotname>] pagesetup orient portrait|landscape] -      - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] -      - [[<plotname>] print] -    - [[<plotname>] print destination printer|file] -      - [[<plotname>] print command <command>] -      - [[<plotname>] print filename <filename>] -      - [[<plotname>] print color rgb|gray] -      [[<plotname>] - - - - - - - - - - - - - close] -      [[<plotname>] - - - - - - - - - - - - - mode pointer|zoom] - - # export image - plot [[<plotname>] - - - +    [has contour [aux]]] +    [has fits [bin|cube|mosaic]] +    [has marker [highlite|paste|select|undo]] +    [has system <coordsys>] +    [has wcs [<wcssys>]] +    [has wcs celestial [<wcssys>]] +    [has wcs linear [<wcssys>]] + +Example: +$xpaget ds9 frame # returns the id of the current frame +$xpaget ds9 frame frameno # returns the id of the current frame +$xpaget ds9 frame all # returns the id of all frames +$xpaget ds9 frame active # returns the id of all active frames +$xpaget ds9 frame lock +$xpaget ds9 frame has amplifier +$xpaget ds9 frame has datamin +$xpaget ds9 frame has datasec +$xpaget ds9 frame has detector +$xpaget ds9 frame has grid +$xpaget ds9 frame has iis +$xpaget ds9 frame has irafmin +$xpaget ds9 frame has physical +$xpaget ds9 frame has smooth +$xpaget ds9 frame has contour +$xpaget ds9 frame has contour aux +$xpaget ds9 frame has fits +$xpaget ds9 frame has fits bin +$xpaget ds9 frame has fits cube +$xpaget ds9 frame has fits mosaic +$xpaget ds9 frame has marker highlite +$xpaget ds9 frame has marker paste +$xpaget ds9 frame has marker select +$xpaget ds9 frame has marker undo +$xpaget ds9 frame has system physical +$xpaget ds9 frame has wcs wcsa +$xpaget ds9 frame has wcs celestial wcsa +$xpaget ds9 frame has wcs linear wcsa +$xpaset -p ds9 frame center # center current frame +$xpaset -p ds9 frame center 1 # center 'Frame1' +$xpaset -p ds9 frame center all # center all frames +$xpaset -p ds9 frame clear # clear current frame +$xpaset -p ds9 frame new # create new frame +$xpaset -p ds9 frame new rgb # create new rgb frame +$xpaset -p ds9 frame delete # delete current frame +$xpaset -p ds9 frame reset # reset current frame +$xpaset -p ds9 frame refresh # refresh current frame +$xpaset -p ds9 frame hide # hide current frame +$xpaset -p ds9 frame show 1 # show frame 'Frame1' +$xpaset -p ds9 frame move first # move frame to first in order +$xpaset -p ds9 frame move back # move frame back in order +$xpaset -p ds9 frame move forward # move frame forward in order +$xpaset -p ds9 frame move last # move frame to last in order +$xpaset -p ds9 frame first # goto first frame +$xpaset -p ds9 frame prev # goto prev frame +$xpaset -p ds9 frame next # goto next frame +$xpaset -p ds9 frame last # goto last frame +$xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if +needed +$xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed +$xpaset -p ds9 frame match wcs +$xpaset -p ds9 frame lock wcs +gif +Load GIF image into current frame. +Syntax: +gif [new|slice] [<filename>] + +Example: +$xpaget ds9 gif > foo.gif +$xpaset -p ds9 gif foo.gif +$xpaset -p ds9 gif new foo.gif +$xpaset -p ds9 gif slice foo.gif +$cat foo.gif | xpaset ds9 gif # not available windows +$cat foo.gif | xpaset ds9 gifnew # not available windows +$cat foo.gif | xpaset ds9 gifslice# not available windows +grid +Controls coordinate grid. For grid numeric format syntax, +click here. +Syntax: +grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin +lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +$xpaget ds9 grid +$xpaget ds9 grid type +$xpaget ds9 grid system +$xpaget ds9 grid sky +$xpaget ds9 grid skyformat +$xpaget ds9 grid grid +$xpaget ds9 grid grid color +$xpaget ds9 grid grid width +$xpaget ds9 grid grid dash +$xpaget ds9 grid grid gap1 +$xpaget ds9 grid grid gap2 +$xpaget ds9 grid grid gap3 +$xpaget ds9 grid axes +$xpaget ds9 grid axes color +$xpaget ds9 grid axes width +$xpaget ds9 grid axes dash +$xpaget ds9 grid axes type +$xpaget ds9 grid axes origin +$xpaget ds9 grid format1 +$xpaget ds9 grid format2 +$xpaget ds9 grid tickmarks +$xpaget ds9 grid tickmarks color +$xpaget ds9 grid tickmarks width +$xpaget ds9 grid tickmarks dash +$xpaget ds9 grid border +$xpaget ds9 grid border color +$xpaget ds9 grid border width +$xpaget ds9 grid border dash +$xpaget ds9 grid numerics +$xpaget ds9 grid numerics font +$xpaget ds9 grid numerics fontsize +$xpaget ds9 grid numerics fontweight +$xpaget ds9 grid numerics fontslant +$xpaget ds9 grid numerics color +$xpaget ds9 grid numerics gap1 +$xpaget ds9 grid numerics gap2 +$xpaget ds9 grid numerics gap3 +$xpaget ds9 grid numerics type +$xpaget ds9 grid numerics vertical +$xpaget ds9 grid title +$xpaget ds9 grid title text +$xpaget ds9 grid title def +$xpaget ds9 grid title gap +$xpaget ds9 grid title font +$xpaget ds9 grid title fontsize +$xpaget ds9 grid title fontweight +$xpaget ds9 grid title fontslant +$xpaget ds9 grid title color +$xpaget ds9 grid labels +$xpaget ds9 grid labels text1 +$xpaget ds9 grid labels def1 +$xpaget ds9 grid labels gap1 +$xpaget ds9 grid labels text2 +$xpaget ds9 grid labels def2 +$xpaget ds9 grid labels gap2 +$xpaget ds9 grid labels font +$xpaget ds9 grid labels fontsize +$xpaget ds9 grid labels fontweight +$xpaget ds9 grid labels fontslant +$xpaget ds9 grid labels color +$xpaset -p ds9 grid +$xpaset -p ds9 grid yes +$xpaset -p ds9 grid type analysis +$xpaset -p ds9 grid system wcs +$xpaset -p ds9 grid sky fk5 +$xpaset -p ds9 grid skyformat degrees +$xpaset -p ds9 grid grid yes +$xpaset -p ds9 grid grid color red +$xpaset -p ds9 grid grid width 2 +$xpaset -p ds9 grid grid dash yes +$xpaset -p ds9 grid grid gap1 10 +$xpaset -p ds9 grid grid gap2 10 +$xpaset -p ds9 grid grid gap3 10 +$xpaset -p ds9 grid axes yes +$xpaset -p ds9 grid axes color red +$xpaset -p ds9 grid axes width 2 +$xpaset -p ds9 grid axes dash yes +$xpaset -p ds9 grid axes type exterior +$xpaset -p ds9 grid axes origin lll +$xpaset -p ds9 grid format1 d.2 +$xpaset -p ds9 grid format2 d.2 +$xpaset -p ds9 grid tickmarks yes +$xpaset -p ds9 grid tickmarks color red +$xpaset -p ds9 grid tickmarks width 2 +$xpaset -p ds9 grid tickmarks dash yes +$xpaset -p ds9 grid border yes +$xpaset -p ds9 grid border color red +$xpaset -p ds9 grid border width 2 +$xpaset -p ds9 grid border dash yes +$xpaset -p ds9 grid numerics yes +$xpaset -p ds9 grid numerics font courier +$xpaset -p ds9 grid numerics fontsize 12 +$xpaset -p ds9 grid numerics fontweight bold +$xpaset -p ds9 grid numerics fontslant italic +$xpaset -p ds9 grid numerics color red +$xpaset -p ds9 grid numerics gap1 10 +$xpaset -p ds9 grid numerics gap2 10 +$xpaset -p ds9 grid numerics gap3 10 +$xpaset -p ds9 grid numerics type exterior +$xpaset -p ds9 grid numerics vertical yes +$xpaset -p ds9 grid title yes +$xpaset -p ds9 grid title text {Hello World} +$xpaset -p ds9 grid title def yes +$xpaset -p ds9 grid title gap 10 +$xpaset -p ds9 grid title font courier +$xpaset -p ds9 grid title fontsize 12 +$xpaset -p ds9 grid title fontweight bold +$xpaset -p ds9 grid title fontslant italic +$xpaset -p ds9 grid title color red +$xpaset -p ds9 grid labels yes +$xpaset -p ds9 grid labels text1 {Hello World} +$xpaset -p ds9 grid labels def1 yes +$xpaset -p ds9 grid labels gap1 10 +$xpaset -p ds9 grid labels text2 {Hello World} +$xpaset -p ds9 grid labels def2 yes +$xpaset -p ds9 grid labels gap2 10 +$xpaset -p ds9 grid labels font courier +$xpaset -p ds9 grid labels fontsize 12 +$xpaset -p ds9 grid labels fontweight boldj +$xpaset -p ds9 grid labels fontslant italic +$xpaset -p ds9 grid labels color red +$xpaset -p ds9 grid reset +$xpaset -p ds9 grid load foo.grd +$xpaset -p ds9 grid save foo.grd +$xpaset -p ds9 grid open +$xpaset -p ds9 grid close +header +Display current fits header dialog. Optional extension number +maybe specified. Please note, this differs from xpa fits +header. +Syntax: +header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +$xpaset -p ds9 header +$xpaset -p ds9 header 2 +$xpaset -p ds9 header close +$xpaset -p ds9 header save 1 foo.txt +height +Set the height of the image display window. +Syntax: +height [<value>] + +Example: +$xpaget ds9 height +$xpaset -p ds9 height 512 +iconify +Toggles iconification. +Syntax: +iconify [] +    [yes|no] + +Example: +$xpaget ds9 iconify +$xpaset -p ds9 iconify +$xpaset -p ds9 iconify yes +iexam +Interactive examine function. A blinking cursor will indicate to +the user to click on a point on an image. The specified information +will be returned at that time. The default event is +button. In the last form, the following macros will be +expanded if present: $width, $height, $depth, $bitpix, +$filename, $regions, $filename[$regions], $env, $pan, $value, $x, +$y, $z. See Analysis Macros +for more information. +Syntax: +iexam [] +    [[]|button|key|any] coordinate <coordsys> +[<skyframe>] [<skyformat>] +     [[]|button|key|any] data +[width][height] +     [[]|button|key|any] <macro +string>] + +Example: +$xpaget ds9 iexam # image coordinates +$xpaget ds9 iexam coordinate image +$xpaget ds9 iexam key coordinate image # return coordinate and key +event +$xpaget ds9 iexam coordinate wcs fk5 degrees +$xpaget ds9 iexam coordinate wcs galactic sexagesimal +$xpaget ds9 iexam coordinate fk5 +$xpaget ds9 iexam data # return data value +$xpaget ds9 iexam key data # return data value and key event +$xpaget ds9 iexam data 3 3 # return all data in 3x3 box about +selected point +$xpaget ds9 iexam {'Click at $x,$y in file $filename'} +iis +Set/Get IIS Filename. Optional mosaic number maybe supplied. +Syntax: +iis [filename <filename> [#]] + +Example: +$xpaget ds9 iis filename +$xpaget ds9 iis filename 4 +$xpaset -p ds9 iis filename foo.fits +$xpaset -p ds9 iis filename bar.fits 4 +jpeg +Load JPEG image into current frame. Optional parameters: +jpeg quality (1-100) +Syntax: +jpeg [new|slice] [<filename>] [1-100] + +Example: +$xpaget ds9 jpeg > foo.jpeg +$xpaget ds9 jpeg 100 > foo.jpeg +$xpaset -p ds9 jpeg foo.jpeg +$xpaset -p ds9 jpeg new foo.jpeg +$xpaset -p ds9 jpeg slice foo.jpeg +$cat foo.jpeg | xpaset ds9 jpeg# not available windows +$cat foo.jpeg | xpaset ds9 jpegnew# not available windows +$cat foo.jpeg | xpaset ds9 jpegslice# not available windows +lock +Lock all other frames to the current frame. +Syntax: +lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none]] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimites [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +$xpaget -p ds9 lock frame +$xpaget -p ds9 lock crosshair +$xpaget -p ds9 lock crop +$xpaget -p ds9 lock slice +$xpaget -p ds9 lock bin +$xpaget -p ds9 lock axes +$xpaget -p ds9 lock scale +$xpaget -p ds9 lock scalelimits +$xpaget -p ds9 lock colorbar +$xpaget -p ds9 lock block +$xpaget -p ds9 lock smooth +$xpaget -p ds9 lock 3d +$xpaset -p ds9 lock frame wcs +$xpaset -p ds9 lock crosshair wcs +$xpaset -p ds9 lock crop wcs +$xpaset -p ds9 lock slice wcs +$xpaset -p ds9 lock bin yes +$xpaset -p ds9 lock axes yes +$xpaset -p ds9 lock scale yes +$xpaset -p ds9 lock scalelimits yes +$xpaset -p ds9 lock colorbar yes +$xpaset -p ds9 lock block yes +$xpaset -p ds9 lock smooth yes +$xpaset -p ds9 lock 3d yes + lower +Lower in the window stacking order. +Syntax: +lower + +Example: +$xpaset -p ds9 lower +magnifier +Controls the magnifier settings. +Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +$xpaget ds9 magnifier color +$xpaget ds9 magnifier zoom +$xpaget ds9 magnifier cursor +$xpaget ds9 magnifier region +$xpaset -p ds9 magnifier color yellow +$xpaset -p ds9 magnifier zoom 2 +$xpaset -p ds9 magnifier cursor no +$xpaset -p ds9 magnifier region no +mask +Controls mask parameters. +Syntax: +mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] + +Example: +$xpaget ds9 mask color +$xpaget ds9 mask mark +$xpaget ds9 mask range +$xpaget ds9 mask system +$xpaget ds9 mask transparency +$xpaset -p ds9 mask color red +$xpaset -p ds9 mask mark zero +$xpaset -p ds9 mask range 10 100 +$xpaset -p ds9 mask transparency 50 +$xpaset -p ds9 mask system wcs +$xpaset -p ds9 mask clear +$xpaset -p ds9 mask open +$xpaset -p ds9 mask close +match +Match all other frames to the current frame. +Syntax: +match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +$xpaset -p ds9 match frame wcs +$xpaset -p ds9 match crosshair wcs +$xpaset -p ds9 match crop wcs +$xpaset -p ds9 match slicewcs +$xpaset -p ds9 match bin +$xpaset -p ds9 match axes +$xpaset -p ds9 match scale +$xpaset -p ds9 match scalelimits +$xpaset -p ds9 match colorbar +$xpaset -p ds9 match block +$xpaset -p ds9 match smooth +$xpaset -p ds9 match 3d + mecube +Load FITS multiple extension file as data cube. +Syntax: +mecube [new] [<filename>] + +Example: +$xpaget ds9 mecube > foo.fits +$xpaset -p ds9 mecube foo.fits +$xpaset -p ds9 mecube new foo.fits +$cat foo.fits | xpaset ds9 mecube +$cat foo.fits | xpaset ds9 mecubenew +minmax +This is how DS9 determines the min and max data values +from the data. SCAN will scan all +data. DATAMIN and IRAFMIN will use the +values of the keywords if present. +Syntax: +minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +$xpaget ds9 minmax mode +$xpaget ds9 minmax interval +$xpaset -p ds9 minmax scan +$xpaset -p ds9 minmax mode scan +$xpaset -p ds9 minmax interval 100 +mode +Controls the first mouse button mode. +Syntax: +mode +[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + +Example: +$xpaget ds9 mode +$xpaset -p ds9 mode crosshair +mosaic +Load FITS mosaic segment into current frame. +Syntax: +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + +Example: +$xpaget ds9 mosaic > foo.fits +$xpaset -p ds9 mosaic foo.fits +$xpaset -p ds9 mosaic wcs foo.fits +$xpaset -p ds9 mosaic wcs new foo.fits +$xpaset -p ds9 mosaic wcs mask foo.fits +$cat foo.fits | xpaset ds9 mosaic +$cat foo.fits | xpaset ds9 mosaic wcs +$cat foo.fits | xpaset ds9 mosaic wcsnew +$cat foo.fits | xpaset ds9 mosaic wcsmask +mosaicimage +Load FITS mosaic image into current frame. +Syntax: +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] +[<filename>] + +Example: +$xpaget ds9 mosaicimage > foo.fits +$xpaset -p ds9 mosaicimage foo.fits +$xpaset -p ds9 mosaicimage wcs foo.fits +$xpaset -p ds9 mosaicimage wcs new foo.fits +$xpaset -p ds9 mosaicimage wcs mask foo.fits +$cat foo.fits | xpaset ds9 mosaicimage +$cat foo.fits | xpaset ds9 mosaicimage wcs +$cat foo.fits | xpaset ds9 mosaicimage wcs new +$cat foo.fits | xpaset ds9 mosaicimage wcs mask +movie +Create a movie from snap shots of the DS9 window. A +slice movie cycles though all slices of a cube. A +frame movie cycles through all active frames. A +3d movie cycles through specified viewing angles. The +default action is slice. Movie types are either +MPEG or Animated GIF, with default MPEG. +Optional parameters for 3d: number of frames, azimuth +from/to, elevation from/to, slice from/to, oscillate/repeat +times. +Syntax: +movie [slice|frame|3d][mpeg|gif] <filename> +movie 3d [mpeg|gif] <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>] + +Example: +$xpaset -p ds9 movie slice mpeg ds9.mpg +$xpaset -p ds9 movie frame gif ds9.gif +$xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 +oscillate 1 +multiframe +Load FITS multiple extension file as multiple images. +Syntax: +multiframe [<filename>] + +Example: +$xpaset -p ds9 multiframe foo.fits +$cat foo.fits | xpaset ds9 multiframe# not available +windows +nameserver +Support Name Server functions. Coordinates are in fk5. +Syntax: +nameserver [<object>] +    [name <object>] +    +[serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] + +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [open|close] + +Example: +$xpaget ds9 nameserver +$xpaget ds9 nameserver server +$xpaget ds9 nameserver skyformat +$xpaget ds9 nameserver m31 +$xpaset -p ds9 nameserver m31 +$xpaset -p ds9 nameserver name m31 +$xpaset -p ds9 nameserver server ned-sao +$xpaset -p ds9 nameserver skyformat sexagesimal +$xpaset -p ds9 nameserver pan +$xpaset -p ds9 nameserver crosshair +$xpaset -p ds9 nameserver open +$xpaset -p ds9 nameserver close +nan +Set image not-a-number color. +Syntax: +nan <color> + +Example: +$xpaget ds9 nan +$xpaset -p ds9 nan red +nrrd +Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: +array endian. +Syntax: +nrrd [native|little|big] +nrrd [new|mask] [<filename>] + +Example: +$xpaget ds9 nrrd +$xpaget ds9 nrrd big +$xpaset -p ds9 nrrd foo.nrrd +$xpaset -p ds9 nrrd new foo.nrrd +$xpaset -p ds9 nrrd mask foo.nrrd +$cat foo.nrrd | xpaset ds9 nrrd +$cat foo.nrrd | xpaset ds9 nrrdnew +$cat foo.nrrd | xpaset ds9 nrrd mask +nvss +Support for NRAO VLA Sky Survey. +Syntax: +nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 nvss name +$xpaget ds9 nvss coord +$xpaget ds9 nvss size +$xpaget ds9 nvss save +$xpaget ds9 nvss frame +$xpaset -p ds9 nvss +$xpaset -p ds9 nvss m31 +$xpaset -p ds9 nvss name m31 +$xpaset -p ds9 nvss name clear +$xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 nvss size 60 60 arcmin +$xpaset -p ds9 nvss save yes +$xpaset -p ds9 nvss frame current +$xpaset -p ds9 nvss update frame +$xpaset -p ds9 nvss open +$xpaset -p ds9 nvss close +orient +Controls the orientation of the current frame. +Syntax: +orient [none|x|y|xy] +    [open|close] + +Example: +$xpaget ds9 orient +$xpaset -p ds9 orient xy +$xpaset -p ds9 orient open +$xpaset -p ds9 orient close +pagesetup +Controls Page Setup options. +Syntax: +pagesetup [orient portrait|landscape] +    [scale <numberic>] +    [size letter|legal|tabloid|poster|a4] + +Example: +$xpaget ds9 pagesetup orient +$xpaget ds9 pagesetup scale +$xpaget ds9 pagesetup size +$xpaset -p ds9 pagesetup orient portrait +$xpaset -p ds9 pagesetup scale 50 +$xpaset -p ds9 pagesetup size poster +pan +Controls the current image cursor location for the current +frame. +Syntax: +pan [<coordsys> [<skyframe>] [<skyformat>]] # get +current coords + +pan [<x> <y> <coordsys> [<skyframe>]] # +relative +    [to <x> <y> <coordsys> +[<skyframe>]] # absolute +    [open|close] + +Example: +$xpaget ds9 pan # get current image coords +$xpaget ds9 pan wcs fk4 sexagesimal # get current coords +$xpaset -p ds9 pan 200 200 image # pan relative +$xpaset -p ds9 pan to 400 400 physical # pan to physical coords +$xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs +coords +$xpaset -p ds9 pan open +$xpaset -p ds9 pan close +pixeltable +Display/Hide the pixel table. +Syntax: +pixeltable [] +    [yes|open] +    [no|close] + +Example: +$xpaget ds9 pixeltable +$xpaset -p ds9 pixeltable +$xpaset -p ds9 pixeltable yes +$xpaset -p ds9 pixeltable open +$xpaset -p ds9 pixeltable close +plot +Display and configure data plots. All plot commands take an +optional second command, the plot name. If no plot name is +specified, the last plot created is assumed. Plot data is assumed +to be a pair of coordinates, with optional error values. The follow +are valid data descriptions: +xy     x and y coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y +errors +To create a new plot, use the plot new command. +Syntax: +# create new empty plot window +plot [] +    [line|bar|scatter] +    [new] +    [new line|bar|scatter] +    [new name <plotname>] +    [new name <plotname> line|bar|scatter] + +# create new plot with data from stdin +plot[new <title> <xaxis label> <yaxis +label>xy|xyex|xyey|xyexey] +    [new [line|bar|scatter] <title> <xaxis +label> <yaxis label>xy|xyex|xyey|xyexey] +    [newname <plotname><title> <xaxis +label> <yaxis label>xy|xyex|xyey|xyexey] +    [newname <plotname>line|bar|scatter +<title> <xaxis label> <yaxis +label>xy|xyex|xyey|xyexey] + +# create new plot with data from stdin which includes title/dim +headers +plot [new stdin] +    [new[line|bar|scatter]stdin] +    [new name <plotname> stdin] +    [new name +<plotname>line|bar|scatterstdin] + +#load data into existing plot from stdin +plot [[<plotname>] data xy|xyex|xyey|xyexey] + +# existing plot +plot[[<plotname>] load <filename> +xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig +<filename>] +    [[<plotname>] saveconfig +<filename>] +    [[<plotname>] pagesetup orient +portrait|landscape] +    [[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination +printer|file] +    [[<plotname>] print command +<command>] +    [[<plotname>] print filename +<filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>] +export[gif|tiff|jpeg|png]<filename> +    [[<plotname>] export jpeg +<filename>[1-100] +    [[<plotname>]export tiff +<filename>[none|jpeg|packbits|deflate] + +# configure graph +plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min +<value>] +    [[<plotname>] axis x|y max +<value>] +    [[<plotname>] axis x|y format +<string>] +    [[<plotname>] background +<value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position +right|left|top|bottom] +    [[<plotname>] font title|labels|numbers +font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize +<value>] +    [[<plotname>] +fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] +fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y +<string>] +    [[<plotname>] barmode +normal|stacked|aligned|overlap] + +# configure current dataset +plot [[<plotname>] show yes|no] +    [[<plotname>] shape +none|circle|square|diamond|plus|splus|scross|triangle|arrow] +    [[<plotname>] shape fill yes|no] +    [[<plotname>] shape color +<value>] +    [[<plotname>] smooth +step|linear|cubic|quadratic|catrom] +    [[<plotname>] color +<value>]     [[<plotname>] +width <value>] +    [[<plotname>] dash yes|no] +    [[<plotname>] error yes|no] +    [[<plotname>] error color +<value>] +    [[<plotname>] error cap yes|no] +    [[<plotname>] error width +<value>] +    [[<plotname>] name <string>] + +# select current dataset +plot [[<plotname>] select <value>] + +Example: +# return all plotnames +$xpaget ds9 plot + +# create new empty plot window +$xpaset -p ds9 plot +$xpaset -p ds9 plot bar +$xpaset -p ds9 plot new +$xpaset -p ds9 plot new bar +$xpaset -p ds9 plot new name foo +$xpaset -p ds9 plot new name foo bar + +# create new plot with data from stdin +$cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} +xy +$cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} +xy +$cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} {Y +Axis} xy +$cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X Axis} +{Y Axis} xy + +# create new plot with data from stdin which includes title/dim +headers +$cat stdin.2.dat | xpaset ds9 plot new stdin +$cat stdin.2.dat | xpaset ds9 plot new line stdin +$cat stdin.2.dat | xpaset ds9 plot new name foo stdin +$cat stdin.2.dat | xpaset ds9 plot new name foo line stdin + +#load data into existing plot from stdin +$cat xy.dat | xpaset ds9 plot data xy +$cat xy.dat | xpaset ds9 plot foo data xy + +# existing plot +$xpaget ds9 plot stats +$xpaget ds9 plot list +$xpaset -p ds9 plot load xy.dat xy +$xpaset -p ds9 plot save foo.dat +$xpaset -p ds9 plot clear +$xpaset -p ds9 plot duplicate 1 +$xpaset -p ds9 plot stats yes +$xpaset -p ds9 plot list yes +$xpaset -p ds9 plot loadconfig foo.plt +$xpaset -p ds9 plot saveconfig foo.plt +$xpaset -p ds9 plot pagesetup orient portrait +$xpaset -p ds9 plot pagesetup size letter +$xpaset -p ds9 plot print +$xpaset -p ds9 plot print destination file +$xpaset -p ds9 plot print command lp +$xpaset -p ds9 plot print filename foo.ps +$xpaset -p ds9 plot print color rgb +$xpaset -p ds9 plot close +$xpaget ds9 plot mode +$xpaset -p ds9 plot mode pointer + +# export plot +$xpaset -p ds9 plot export tiff foo.tiff jpeg +$xpaset -p ds9 plot export jpeg foo.jpeg 75 +$xpaset -p ds9 plot export png foo.png + +# configure plot +$xpaget ds9 plot axis x grid +$xpaget ds9 plot axis x log +$xpaget ds9 plot axis x flip +$xpaget ds9 plot axis x auto +$xpaget ds9 plot axis x min +$xpaget ds9 plot axis x max +$xpaget ds9 plot axis x format +$xpaset -p ds9 plot axis x grid yes +$xpaset -p ds9 plot axis x log yes +$xpaset -p ds9 plot axis x flip yes +$xpaset -p ds9 plot axis x auto no +$xpaset -p ds9 plot axis x min 1 +$xpaset -p ds9 plot axis x max 100 +$xpaset -p ds9 plot axis x format {%f} + +$xpaget ds9 plot background +$xpaset -p ds9 plot background white + +$xpaget ds9 plot legend +$xpaget ds9 plot legend position +$xpaset -p ds9 plot legend yes +$xpaset -p ds9 plot legend position left + +$xpaget ds9 plot font numbers font +$xpaget ds9 plot font numbers size +$xpaget ds9 plot font numbers weight +$xpaget ds9 plot font numbers slant +$xpaset -p ds9 plot font numbers font times +$xpaset -p ds9 plot font numbers size 12 +$xpaset -p ds9 plot font numbers weight bold +$xpaset -p ds9 plot font numbers slant italic + +$xpaget ds9 plot title +$xpaget ds9 plot title xaxis +$xpaget ds9 plot title yaxis +$xpaset -p ds9 plot title {This is a Title} +$xpaset -p ds9 plot title x {X Axis} +$xpaset -p ds9 plot title y {Y Axis} +$xpaset -p ds9 plot title legend {This is the Legend} + +$xpaget ds9 plot barmode +$xpaset -p ds9 plot barmode aligned + +# configure current dataset +$xpaget ds9 plot show +$xpaget ds9 plot shape +$xpaget ds9 plot shape fill +$xpaget ds9 plot shape color +$xpaget ds9 plot smooth +$xpaget ds9 plot color +$xpaget ds9 plot width +$xpaget ds9 plot dash +$xpaget ds9 plot error +$xpaget ds9 plot error color +$xpaget ds9 plot error cap +$xpaget ds9 plot error width +$xpaget ds9 plot name +$xpaset -p ds9 plot show yes +$xpaset -p ds9 plot shape circle +$xpaset -p ds9 plot shape fill no +$xpaset -p ds9 plot shape color cyan +$xpaset -p ds9 plot smooth step +$xpaset -p ds9 plot color red +$xpaset -p ds9 plot width 2 +$xpaset -p ds9 plot dash yes +$xpaset -p ds9 plot error yes +$xpaset -p ds9 plot error color red +$xpaset -p ds9 plot error cap yes +$xpaset -p ds9 plot error width 2 +$xpaset -p ds9 plot name {My Data} + +# select current dataset +$xpaget ds9 plot select +$xpaset -p ds9 plot select 2 +png +Load PNG image into current frame. +Syntax: +png [new|slice] [<filename>] + +Example: +$xpaget ds9 png > foo.png +$xpaset -p ds9 png foo.png +$xpaset -p ds9 png new foo.png +$xpaset -p ds9 png slice foo.png +$cat foo.png | xpaset ds9 png +$cat foo.png | xpaset ds9 png new +$cat foo.png | xpaset ds9 png slice +precision +Set region and coordinate output format precision. +Syntax: +precision +<linear><degree><hms><dms><arcmin><arcsec> + + +Example: +$xpaget ds9 precision +$xpaset -p ds9 precision 8 10 4 3 5 3 +prefs +Controls various preference settings. +Syntax: +prefs [clear] +    [irafalign yes|no] + +Example: +$xpaget ds9 prefs irafalign +$xpaset -p ds9 prefs clear +$xpaset -p ds9 prefs iraf yes +preserve +Preserve the follow attributes while loading a new image. +Syntax: +preserve [pan yes|no] +      [regions yes|no] + +Example: +$xpaget ds9 preserve pan +$xpaget ds9 preserve regions +$xpaset -p ds9 preserve pan yes +$xpaset -p ds9 preserve regions yes +psprint +Invokes postscript printing. Please see print for further details. +print +Controls printing. Use print option to set printing options. +Only available for XPA_METHOD local. +Syntax: +print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    [resolution +72|screen|96|144|150|225|300|600|1200] + +Example: +$xpaget ds9 print destination +$xpaget ds9 print command +$xpaget ds9 print filename +$xpaget ds9 print color +$xpaget ds9 print level +$xpaget ds9 print resolution +$xpaset -p ds9 print +$xpaset -p ds9 print destination file +$xpaset -p ds9 print command lp +$xpaset -p ds9 print filename foo.ps +$xpaset -p ds9 print color cmyk +$xpaset -p ds9 print level 2 +$xpaset -p ds9 print resolution 96 +raise +Raise in the window stacking order. +Syntax: +raise + +Example: +$xpaset -p ds9 raise +regions +Controls regions in the current frame. +Syntax: +regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration +<value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format +ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color &ltcolor>] +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> +<dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [groups] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color &ltcolor>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> +<int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> +yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] +    [-format ds9|ciao|saotng|saoimage|pros|xy] +    [-system image|physical|wcs|wcsa...wcsz] +    [-sky fk4|fk5|icrs|galactic|ecliptic] +    [-skyformat degrees|sexagesimal] +    [-delim [nl|<char>]] +    [-prop +select|edit|move|rotate|delete|fixed|include|source 1|0] +    [-group <tag>] +    [-strip yes|no] +    [-wcs yes|no] + +Example: +$xpaget ds9 regions +$xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat +sexagesimal -prop edit 1 -group foo +$xpaget ds9 regions epsilon +$xpaget ds9 regions show +$xpaget ds9 regions showtext +$xpaget ds9 regions centroid auto +$xpaget ds9 regions centroid radius +$xpaget ds9 regions centroid iteration +$xpaget ds9 regions selected +$xpaget ds9 regions format +$xpaget ds9 regions system +$xpaget ds9 regions sky +$xpaget ds9 regions skyformat +$xpaget ds9 regions strip +$xpaget ds9 regions shape +$xpaget ds9 regions color +$xpaget ds9 regions width +$xpaget ds9 regions source +$xpaget ds9 regions background +$xpaget ds9 regions include +$xpaget ds9 regions exclude +$xpaget ds9 regions selected +$xpaget ds9 regions groups +$cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky +fk5 +$cat bar.reg | xpaset ds9 regions -format ds9 +$echo "image; circle 100 100 20" | xpaset ds9 regions +$echo "image; circle 100 100 20" | xpaset ds9 regions +$echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions +$echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions +$echo "box 100 100 20 40 25" | xpaset ds9 regions +$echo "image; line 100 100 200 400" | xpaset ds9 regions +$echo "physical; ruler 200 300 200 400" | xpaset ds9 regions +$echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 +regions +$echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 +regions +$xpaset -p ds9 regions foo.reg +$xpaset -p ds9 regions -format ciao bar.reg # load as ciao +format +$xpaset -p ds9 regions foo.fits # FITS regions files do not need a +format specification +$xpaset -p ds9 regions load foo.reg # load foo.reg into current +frame +$xpaset -p ds9 regions load all foo.reg # load foo.reg into all +frames +$xpaset -p ds9 regions load '*.reg'# expand *.reg and load into +current frame +$xpaset -p ds9 regions load all '*.reg' # expand *.reg and load +into all frames +$xpaset -p ds9 regions save foo.reg +$xpaset -p ds9 regions list +$xpaset -p ds9 regions list close +$xpaset -p ds9 regions epsilon 5 +$xpaset -p ds9 regions show yes +$xpaset -p ds9 regions showtext no +$xpaset -p ds9 regions centroid +$xpaset -p ds9 regions centroid auto yes +$xpaset -p ds9 regions centroid radius 10 +$xpaset -p ds9 regions centroid iteration 20 +$xpaset -p ds9 regions getinfo +$xpaset -p ds9 regions move back +$xpaset -p ds9 regions move front +$xpaset -p ds9 regions select all +$xpaset -p ds9 regions select none +$xpaset -p ds9 regions select invert +$xpaset -p ds9 regions delete all +$xpaset -p ds9 regions delete select +$xpaset -p ds9 regions format ds9 +$xpaset -p ds9 regions system wcs +$xpaset -p ds9 regions sky fk5 +$xpaset -p ds9 regions skyformat degrees +$xpaset -p ds9 regions strip yes +$xpaset -p ds9 regions shape ellipse +$xpaset -p ds9 regions color red +$xpaset -p ds9 regions width 3 +$xpaset -p ds9 regions edit yes +$xpaset -p ds9 regions include +$xpaset -p ds9 regions command '{circle 100 100 20 # +color=red}' +$xpaset -p ds9 regions composite +$xpaset -p ds9 regions dissolve +$xpaset -p ds9 regions template foo.tpl +$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 +47:12:48.02 +fk5 +$xpaset -p ds9 regions savetemplate foo.tpl +$xpaset -p ds9 regions group new +$xpaset -p ds9 regions group foo new +$xpaset -p ds9 regions group foo update +$xpaset -p ds9 regions group foo select +$xpaset -p ds9 regions group foo color red +$xpaset -p ds9 regions group foo copy +$xpaset -p ds9 regions group foo delete +$xpaset -p ds9 regions group foo cut +$xpaset -p ds9 regions group foo font {times 14 bold} +$xpaset -p ds9 regions group foo move 100 100 +$xpaset -p ds9 regions group foo movefront +$xpaset -p ds9 regions group foo moveback +$xpaset -p ds9 regions group foo property delete no + +$xpaset -p ds9 regions copy +$xpaset -p ds9 regions cut +$xpaset -p ds9 regions paste wcs +$xpaset -p ds9 regions undo +restore +Restore DS9 to a previous state from a backup save set. +Syntax: +restore <filename> + +Example: +$xpaset -p ds9 restore ds9.bck +rgb +Create RGB frame and control RGB frame parameters. +Syntax: +rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +    [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock +wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth +[yes|no]] +    [open|close] + +Example: +$xpaget ds9 rgb channel +$xpaget ds9 rgb lock wcs +$xpaget ds9 rgb lock crop +$xpaget ds9 rgb lock slice +$xpaget ds9 rgb lock bin +$xpaget ds9 rgb lock scale +$xpaset ds9 rgb lock scalelimits +$xpaget ds9 rgb lock colorbar +$xpaget ds9 rgb lock block +$xpaget ds9 rgb lock smooth +$xpaget ds9 rgb system +$xpaget ds9 rgb view red +$xpaget ds9 rgb view green +$xpaget ds9 rgb view blue +$xpaset -p ds9 rgb # create new rgb frame +$xpaset -p ds9 rgb red # set current channel to red +$xpaset -p ds9 rgb channel red # set current channel to red +$xpaset -p ds9 rgb view blue no # turn off blue channel +$xpaset -p ds9 rgb system wcs # set rgb coordinate system +$xpaset -p ds9 rgb lock wcs yes +$xpaset -p ds9 rgb lock crop yes +$xpaset -p ds9 rgb lock slice yes +$xpaset -p ds9 rgb lock bin yes +$xpaset -p ds9 rgb lock scale yes +$xpaset -p ds9 rgb lock scalelimits yes +$xpaset -p ds9 rgb lock colorbar yes +$xpaset -p ds9 rgb lock block yes +$xpaset -p ds9 rgb lock smooth yes +$xpaset -p ds9 rgb open +$xpaset -p ds9 rgb close +rgbarray +Load raw data array cube into rgb frame. +Syntax: +rgbarray [native|big|little] +rgbarray [new] +[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +$xpaget ds9 rgbarray > foo.arr +$xpaget ds9 rgbarray little > foo.arr +$xpaset -p ds9 rgbarray +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +$xpaset -p ds9 rgbarray new +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 rgbarray +[dim=512,zdim=3,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 rgbarray new +[dim=512,zdim=3,bitpix=-32,endian=little] +rgbcube +Load FITS rgbcube into rgb frame. +Syntax: +rgbcube [new] [<filename>] + +Example: +$xpaget ds9 rgbcube > foo.fits +$xpaset -p ds9 rgbcube foo.fits +$xpaset -p ds9 rgbcube new foo.fits +$cat foo.fits | xpaset ds9 rgbcube +$cat foo.fits | xpaset ds9 rgbcubenew +rgbimage +Load FITS rgbimage into rgb frame. +Syntax: +rgbimage [new] [<filename>] + +Example: +$xpaget ds9 rgbimage > foo.fits +$xpaset -p ds9 rgbimage foo.fits +$xpaset -p ds9 rgbimage new foo.fits +$cat foo.fits | xpaset ds9 rgbimage +$cat foo.fits | xpaset ds9 rgbimage new +rotate +Controls the rotation angle (in degrees) of the current +frame. +Syntax: +rotate [<value>] +    [to <value>] +    [open|close] + +Example: +$xpaget ds9 rotate +$xpaset -p ds9 rotate 45 +$xpaset -p ds9 rotate to 30 +$xpaset -p ds9 rotate open +$xpaset -p ds9 rotate close +save +Save loaded image data of current frame as FITS. +Syntax: +save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice] + +Example: +$xpaset -p ds9 save foo.fits +$xpaset -p ds9 save fits foo.fits image +$xpaset -p ds9 save fits foo.fits table +$xpaset -p ds9 save fits foo.fits slice +$xpaset -p ds9 save rgbimage foo.fits +$xpaset -p ds9 save rgbcube foo.fits +$xpaset -p ds9 save mecube foo.fits +$xpaset -p ds9 save mosaic foo.fits +$xpaset -p ds9 save mosaicimage foo.fits +saveimage +Create a snap shot of the current DS9 window and save in +specified image format. If no format specified, the file name +extension is used to determine the output format. Optional +parameters: jpeg quality (1-100) and tiff +compression method. +Syntax: +saveimage [fits|eps|gif|tiff|jpeg|png]<filename> +saveimage <filename>.jpeg [1-100] +saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$xpaset -p ds9 saveimage ds9.tiff +$xpaset -p ds9 saveimage jpeg ds9.jpeg 75 +scale +Controls the limits and color scale distribution. +Syntax: +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +$xpaget ds9 scale +$xpaget ds9 scale log exp +$xpaget ds9 scale datasec +$xpaget ds9 scale limits +$xpaget ds9 scale mode +$xpaget ds9 scale scope +$xpaget ds9 scale lock +$xpaget ds9 scale lock limits +$xpaset -p ds9 scale linear +$xpaset -p ds9 scale log exp 100 +$xpaset -p ds9 scale datasec yes +$xpaset -p ds9 scale histequ +$xpaset -p ds9 scale limits 1 100 +$xpaset -p ds9 scale mode zscale +$xpaset -p ds9 scale mode 99.5 +$xpaset -p ds9 scale scope local +$xpaset -p ds9 scale match +$xpaset -p ds9 scale match limits +$xpaset -p ds9 scale lock yes +$xpaset -p ds9 scale lock limits yes +$xpaset -p ds9 scale open +$xpaset -p ds9 scale close +shm +Load a shared memory segment into the current frame. +Syntax: +shm [<key> [<filename>]] +    [key <key> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> +[<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] +[key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] +<id> [<filename>]] +    [rgbcube [key|shmid] <id> +[<filename>] +    [rgbimage [key|shmid] <id> +[<filename>]] +    [rgbarray [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] - - - - - - export [gif|tiff|jpeg|png] <filename> -      [[<plotname>] - - - - - - - - - - - - export jpeg <filename> [1-100] -      [[<plotname>] - - - - - - - - - - - - export tiff <filename> [none|jpeg|packbits|deflate] - - # configure graph - plot [[<plotname>] axis x|y - grid yes|no] -      - [[<plotname>] axis x|y log yes|no] -      - [[<plotname>] axis x|y flip yes|no] -    - [[<plotname>] axis x|y auto yes|no] -    - [[<plotname>] axis x|y min <value>] -    - [[<plotname>] axis x|y max <value>] -    - [[<plotname>] axis x|y format <string>] -      - [[<plotname>] background <value>] -      [[<plotname>] - - - - - - - - - - - - - legend yes|no] -      - [[<plotname>] legend position right|left|top|bottom] -    - [[<plotname>] font title|labels|numbers font - times|helvetica|courier] -    - [[<plotname>] font title|labels|numbers - size <value>] -    - [[<plotname>] font title|labels|numbers - weight normal|bold] -    - [[<plotname>] font title|labels|numbers - slant roman|italic] -    - [[<plotname>] title <string>] -    - [[<plotname>] title x|y <string>] -      [[<plotname>] - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap] - - # configure current dataset - plot [[<plotname>] show - yes|no] -    [[<plotname>] - - - - - - - - - - - - shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -      [[<plotname>] - - - - - - - - - - - - - shape fill yes|no] -      [[<plotname>] - - - - - - - - - - - - - shape color <value>] -      [[<plotname>] - - - - - - - - - - - - - smooth step|linear|cubic|quadratic|catrom] -      [[<plotname>] - - - - - - - - - - - - - color <value>] -      [[<plotname>] - - - - - - - - - - - - - width <value>] -      [[<plotname>] - - - - - - - - - - - - - dash yes|no] -      [[<plotname>] - - - - - - - - - - - - - error yes|no] -      [[<plotname>] - - - - - - - - - - - - - error color <value>] -      [[<plotname>] - - - - - - - - - - - - - error cap yes|no] -      [[<plotname>] - - - - - - - - - - - - - error width <value>] -      [[<plotname>] - - - - - - - - - - - - - name <string>] - - # select current dataset - plot [[<plotname>] select - <value>] - - Example: - # return all plotnames - $xpaget ds9 plot - - # create new empty plot window - $xpaset -p ds9 plot - $xpaset -p ds9 plot bar - $xpaset -p ds9 plot new - $xpaset -p ds9 plot new bar - $xpaset -p ds9 plot new name foo - $xpaset -p ds9 plot new name foo - bar - - # create new plot with data from - stdin - $cat xy.dat | xpaset ds9 plot new - {The Title} {X Axis} {Y Axis} xy - $cat xy.dat | xpaset ds9 plot new - bar {The Title} {X Axis} {Y Axis} xy - $cat xy.dat | xpaset ds9 plot new - name foo {The Title} {X Axis} {Y Axis} xy - $cat xy.dat | xpaset ds9 plot new - name foo bar {The Title} {X Axis} {Y Axis} xy - - # create new plot with data from - stdin which includes title/dim headers - $cat stdin.2.dat | xpaset ds9 plot - new stdin - $cat stdin.2.dat | xpaset ds9 plot - new line stdin - $cat stdin.2.dat | xpaset ds9 plot - new name foo stdin - $cat stdin.2.dat | xpaset ds9 plot - new name foo line stdin - - # load data into - existing plot from stdin - $cat xy.dat | xpaset ds9 plot data - xy - $cat xy.dat | xpaset ds9 plot foo - data xy - - # existing plot - $xpaget ds9 plot stats - $xpaget ds9 plot list - $xpaset -p ds9 plot load xy.dat xy - $xpaset -p ds9 plot save foo.dat - $xpaset -p ds9 plot clear - $xpaset -p ds9 plot duplicate 1 - $xpaset -p ds9 plot stats yes - $xpaset -p ds9 plot list yes - $xpaset -p ds9 plot loadconfig - foo.plt - $xpaset -p ds9 plot saveconfig - foo.plt - $xpaset -p ds9 plot pagesetup - orient portrait - $xpaset -p ds9 plot pagesetup size - letter - $xpaset -p ds9 plot print - $xpaset -p ds9 plot print - destination file - $xpaset -p ds9 plot print command - lp - $xpaset -p ds9 plot print filename - foo.ps - $xpaset -p ds9 plot print color rgb - $xpaset -p ds9 plot close - $xpaget ds9 plot mode - $xpaset -p ds9 plot mode pointer - - # export plot - $xpaset -p ds9 plot export - tiff foo.tiff jpeg - $xpaset -p ds9 plot export jpeg foo.jpeg 75 - $xpaset -p ds9 plot export png foo.png - - # configure plot - $xpaget ds9 plot axis x grid - $xpaget ds9 plot axis x log - $xpaget ds9 plot axis x flip - $xpaget ds9 plot axis x auto - $xpaget ds9 plot axis x min - $xpaget ds9 plot axis x max - $xpaget ds9 plot axis x format - $xpaset -p ds9 plot axis x grid yes - $xpaset -p ds9 plot axis x log yes - $xpaset -p ds9 plot axis x flip yes - $xpaset -p ds9 plot axis x auto no - $xpaset -p ds9 plot axis x min 1 - $xpaset -p ds9 plot axis x max 100 - $xpaset -p ds9 plot axis x format - {%f} - - $xpaget ds9 plot background - $xpaset -p ds9 plot background - white - - $xpaget ds9 plot legend - $xpaget ds9 plot legend position - $xpaset -p ds9 plot legend yes - $xpaset -p ds9 plot legend position - left - - $xpaget ds9 plot font numbers font - $xpaget ds9 plot font numbers size - $xpaget ds9 plot font numbers - weight - $xpaget ds9 plot font numbers slant - $xpaset -p ds9 plot font numbers - font times - $xpaset -p ds9 plot font numbers - size 12 - $xpaset -p ds9 plot font numbers - weight bold - $xpaset -p ds9 plot font numbers - slant italic - - $xpaget ds9 plot title - $xpaget ds9 plot title xaxis - $xpaget ds9 plot title yaxis - $xpaset -p ds9 plot title {This is - a Title} - $xpaset -p ds9 plot title x {X - Axis} - $xpaset -p ds9 plot title y {Y - Axis} - $xpaset -p ds9 plot title legend - {This is the Legend} - - $xpaget ds9 plot barmode - $xpaset -p ds9 plot barmode aligned - - # configure current dataset - $xpaget ds9 plot show - $xpaget ds9 plot shape - $xpaget ds9 plot shape fill - $xpaget ds9 plot shape color - $xpaget ds9 plot smooth - $xpaget ds9 plot color - $xpaget ds9 plot width - $xpaget ds9 plot dash - $xpaget ds9 plot error - $xpaget ds9 plot error color - $xpaget ds9 plot error cap - $xpaget ds9 plot error width - $xpaget ds9 plot name - $xpaset -p ds9 plot show yes - $xpaset -p ds9 plot shape circle - $xpaset -p ds9 plot shape fill no - $xpaset -p ds9 plot shape color - cyan - $xpaset -p ds9 plot smooth step - $xpaset -p ds9 plot color red - $xpaset -p ds9 plot width 2 - $xpaset -p ds9 plot dash yes - $xpaset -p ds9 plot error yes - $xpaset -p ds9 plot error color red - $xpaset -p ds9 plot error cap yes - $xpaset -p ds9 plot error width 2 - $xpaset -p ds9 plot name {My Data} - - # select current dataset - $xpaget ds9 plot select - $xpaset -p ds9 plot select 2 - png - Load PNG image into current frame. - - Syntax: - png [new|slice] [<filename>] - - Example: - $xpaget ds9 png > foo.png - $xpaset -p ds9 png foo.png - $xpaset -p ds9 png new foo.png - $xpaset -p ds9 png slice foo.png - $cat foo.png | xpaset ds9 png # - not available windows - $cat foo.png | xpaset ds9 png new # - not available windows - $cat foo.png | xpaset ds9 png slice # - not available windows - - precision - Set region and coordinate output format precision. - Syntax: - precision <linear> <degree> - <hms> <dms> - <arcmin> <arcsec> - - Example: - $xpaget ds9 precision - $xpaset -p ds9 precision 8 10 4 3 5 3 - prefs - Controls various preference settings. - Syntax: - prefs [clear] -       [irafalign yes|no] - - Example: - $xpaget ds9 prefs irafalign - $xpaset -p ds9 prefs clear - $xpaset -p ds9 prefs iraf yes - - preserve - Preserve the follow attributes while loading a new image. - Syntax: - preserve [pan yes|no] -    [regions yes|no] - - Example: - $xpaget ds9 preserve pan - $xpaget ds9 preserve regions - $xpaset -p ds9 preserve pan yes - $xpaset -p ds9 preserve regions yes - - psprint - Invokes postscript printing. Please see print for further details. - print - Controls printing. Use print option to set printing options. - Only available for XPA_METHOD local. - Syntax: - print [destination printer|file] -       [command <command>] -       [filename <filename>] -       [color rgb|cmyk|gray] -       [level 1|2|3] -       [resolution - 72|screen|96|144|150|225|300|600|1200] - - Example: - $xpaget ds9 print destination - $xpaget ds9 print command - $xpaget ds9 print filename - $xpaget ds9 print color - $xpaget ds9 print level - $xpaget ds9 print resolution - $xpaset -p ds9 print - $xpaset -p ds9 print destination file - $xpaset -p ds9 print command lp - $xpaset -p ds9 print filename foo.ps - $xpaset -p ds9 print color cmyk - $xpaset -p ds9 print level 2 - $xpaset -p ds9 print resolution 96 - raise - Raise in the window stacking order. - Syntax: - raise - - Example: - $xpaset -p ds9 raise - regions - Controls regions in the current frame. - Syntax: - regions [<filename>] -         [load [all] - <filename>] -         [save - <filename>] -         [list [close]] -         [epsilon <integer>] -         [show yes|no] -         [showtext yes|no] -         [centroid] -         [centroid auto - yes|no] -         [centroid radius - <value>|iteration <value>] -         [getinfo] -         [move front] -         [move back] -         [select all] -         [select none] -         [select invert] -         [delete all] -         [delete select] -         [format - ds9|xml|ciao|saotng|saoimage|pros|xy] -         [system - image|physical|wcs|wcsa...wcsz] -         [sky - fk4|fk5|icrs|galactic|ecliptic] -         [skyformat - degrees|sexagesimal] -         [strip yes|no] -         [shape <shape>] -         [color - &ltcolor>] -         [width <width>] -         - [fixed|edit|rotate|delete yes|no] -         - [include|exclude|source|background] -         [command <marker - command>] -         [composite] -         [dissolve] -         [template - <filename>] -         [template <filename> - at <ra> <dec> <coordsys> <skyframe>] -         [savetemplate - <filename>] -         [groups] -         [group new] -         [group <tag> - new] -         [group <tag> update] -         [group <tag> - select] -         [group <tag> color - &ltcolor>] -         [group <tag> copy] -         [group <tag> delete] -         [group <tag> cut] -         [group <tag> font - <font>] -         [group <tag> move - <int> <int>] -         [group <tag> - movefront] -         [group <tag> - moveback] -         [group <tag> - property <property> yes|no] -         [copy] -         [cut] -         [paste - image|physical|wcs|wcsa...wcsz] -         [undo] -         [-format - ds9|ciao|saotng|saoimage|pros|xy] -         [-system - image|physical|wcs|wcsa...wcsz] -         [-sky - fk4|fk5|icrs|galactic|ecliptic] -         [-skyformat - degrees|sexagesimal] -         [-delim [nl|<char>]] -         [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0] -         [-group <tag>] -         [-strip yes|no] -         [-wcs yes|no] - - Example: - $xpaget ds9 regions - $xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat - sexagesimal -prop edit 1 -group foo - $xpaget ds9 regions epsilon - $xpaget ds9 regions show - $xpaget ds9 regions showtext - $xpaget ds9 regions centroid auto - $xpaget ds9 regions centroid radius - $xpaget ds9 regions centroid iteration - $xpaget ds9 regions selected - $xpaget ds9 regions format - $xpaget ds9 regions system - $xpaget ds9 regions sky - $xpaget ds9 regions skyformat - $xpaget ds9 regions strip - $xpaget ds9 regions shape - $xpaget ds9 regions color - $xpaget ds9 regions width - $xpaget ds9 regions source - $xpaget ds9 regions background - $xpaget ds9 regions include - $xpaget ds9 regions exclude - $xpaget ds9 regions selected - $xpaget ds9 regions groups - $cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky - fk5 - $cat bar.reg | xpaset ds9 regions -format ds9 - $echo "image; circle 100 100 20" | xpaset ds9 regions - $echo "image; circle 100 100 20" | xpaset ds9 regions - $echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions - $echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions - $echo "box 100 100 20 40 25" | xpaset ds9 regions - $echo "image; line 100 100 200 400" | xpaset ds9 regions - $echo "physical; ruler 200 300 200 400" | xpaset ds9 regions - $echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 - regions - $echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 - regions - $xpaset -p ds9 regions foo.reg - $xpaset -p ds9 regions -format ciao bar.reg # load as ciao - format - $xpaset -p ds9 regions foo.fits # FITS regions files do not need - a format specification - $xpaset -p ds9 regions load foo.reg # load foo.reg into current - frame - $xpaset -p ds9 regions load all foo.reg # load foo.reg into all - frames - $xpaset -p ds9 regions load '*.reg'# expand *.reg and load into - current frame - $xpaset -p ds9 regions load all '*.reg' # expand *.reg and load - into all frames - $xpaset -p ds9 regions save foo.reg - $xpaset -p ds9 regions list - $xpaset -p ds9 regions list close - $xpaset -p ds9 regions epsilon 5 - $xpaset -p ds9 regions show yes - $xpaset -p ds9 regions showtext no - $xpaset -p ds9 regions centroid - $xpaset -p ds9 regions centroid auto yes - $xpaset -p ds9 regions centroid radius 10 - $xpaset -p ds9 regions centroid iteration 20 - $xpaset -p ds9 regions getinfo - $xpaset -p ds9 regions move back - $xpaset -p ds9 regions move front - $xpaset -p ds9 regions select all - $xpaset -p ds9 regions select none - $xpaset -p ds9 regions select invert - $xpaset -p ds9 regions delete all - $xpaset -p ds9 regions delete select - $xpaset -p ds9 regions format ds9 - $xpaset -p ds9 regions system wcs - $xpaset -p ds9 regions sky fk5 - $xpaset -p ds9 regions skyformat degrees - $xpaset -p ds9 regions strip yes - $xpaset -p ds9 regions shape ellipse - $xpaset -p ds9 regions color red - $xpaset -p ds9 regions width 3 - $xpaset -p ds9 regions edit yes - $xpaset -p ds9 regions include - $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}' - $xpaset -p ds9 regions composite - $xpaset -p ds9 regions dissolve - $xpaset -p ds9 regions template foo.tpl - $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 - +47:12:48.02 fk5 - $xpaset -p ds9 regions savetemplate foo.tpl - $xpaset -p ds9 regions group new - $xpaset -p ds9 regions group foo new - $xpaset -p ds9 regions group foo update - $xpaset -p ds9 regions group foo select - $xpaset -p ds9 regions group foo color red - $xpaset -p ds9 regions group foo copy - $xpaset -p ds9 regions group foo delete - $xpaset -p ds9 regions group foo cut - $xpaset -p ds9 regions group foo font {times 14 bold} - $xpaset -p ds9 regions group foo move 100 100 - $xpaset -p ds9 regions group foo movefront - $xpaset -p ds9 regions group foo moveback - $xpaset -p ds9 regions group foo property delete no - - $xpaset -p ds9 regions copy - $xpaset -p ds9 regions cut - $xpaset -p ds9 regions paste wcs - $xpaset -p ds9 regions undo - - restore - Restore DS9 to a previous state from a backup save set. - Syntax: - restore <filename> - - Example: - $xpaset -p ds9 restore ds9.bck - rgb - Create RGB frame and control RGB frame parameters. - Syntax: - rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -    [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -      [open|close] - - Example: - $xpaget ds9 rgb channel - $xpaget ds9 rgb lock wcs - $xpaget ds9 rgb lock crop - $xpaget ds9 rgb lock slice - $xpaget ds9 rgb lock bin - $xpaget ds9 rgb lock scale - $xpaset ds9 rgb lock scalelimits - $xpaget ds9 rgb lock colorbar - $xpaget ds9 rgb lock block - $xpaget ds9 rgb lock smooth - $xpaget ds9 rgb system - $xpaget ds9 rgb view red - $xpaget ds9 rgb view green - $xpaget ds9 rgb view blue - $xpaset -p ds9 rgb # create new rgb frame - $xpaset -p ds9 rgb red # set current channel to red - $xpaset -p ds9 rgb channel red # set current channel to red - $xpaset -p ds9 rgb view blue no # turn off blue channel - $xpaset -p ds9 rgb system wcs # set rgb coordinate system - $xpaset -p ds9 rgb lock wcs yes - $xpaset -p ds9 rgb lock crop yes - $xpaset -p ds9 rgb lock slice yes - $xpaset -p ds9 rgb lock bin yes - $xpaset -p ds9 rgb lock scale yes - $xpaset -p ds9 rgb lock scalelimits yes - $xpaset -p ds9 rgb lock colorbar yes - $xpaset -p ds9 rgb lock block yes - $xpaset -p ds9 rgb lock smooth yes - $xpaset -p ds9 rgb open - $xpaset -p ds9 rgb close - rgbarray - Load raw data array cube into rgb frame. - - Syntax: - rgbarray [native|big|little] - rgbarray [new] -[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $xpaget ds9 rgbarray > foo.arr - $xpaget ds9 rgbarray little > foo.arr - $xpaset -p ds9 rgbarray - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - $xpaset -p ds9 rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 rgbarray - [dim=512,zdim=3,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 rgbarray new - [dim=512,zdim=3,bitpix=-32,endian=little] - rgbcube - Load FITS rgbcube into rgb frame. - - Syntax: - rgbcube [new] [<filename>] - - Example: - $xpaget ds9 rgbcube > foo.fits - $xpaset -p ds9 rgbcube foo.fits - $xpaset -p ds9 rgbcube new foo.fits - $cat foo.fits | xpaset ds9 rgbcube - $cat foo.fits | xpaset ds9 rgbcube new - rgbimage - Load FITS rgbimage into rgb frame. - - Syntax: - rgbimage [new] [<filename>] - - Example: - $xpaget ds9 rgbimage > foo.fits - $xpaset -p ds9 rgbimage foo.fits - $xpaset -p ds9 rgbimage new foo.fits - $cat foo.fits | xpaset ds9 rgbimage - $cat foo.fits | xpaset ds9 rgbimage new - - rotate - Controls the rotation angle (in degrees) of the current frame. - Syntax: - rotate [<value>] -        [to <value>] -        [open|close] - - Example: - $xpaget ds9 rotate - $xpaset -p ds9 rotate 45 - $xpaset -p ds9 rotate to 30 - $xpaset -p ds9 rotate open - $xpaset -p ds9 rotate close - - save - - Save loaded image data of current frame as FITS. - Syntax: - save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice] - - Example: - $xpaset -p ds9 save foo.fits - $xpaset -p ds9 save fits foo.fits image - $xpaset -p ds9 save fits foo.fits table - $xpaset -p ds9 save fits foo.fits slice - $xpaset -p ds9 save rgbimage foo.fits - $xpaset -p ds9 save rgbcube foo.fits - $xpaset -p ds9 save mecube foo.fits - $xpaset -p ds9 save mosaic foo.fits - $xpaset -p ds9 save mosaicimage foo.fits - saveimage - - Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method. - Syntax: - saveimage [fits|eps|gif|tiff|jpeg|png] <filename> - saveimage <filename>.jpeg [1-100] - saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - $xpaset -p ds9 saveimage ds9.tiff - $xpaset -p ds9 saveimage jpeg ds9.jpeg 75 - scale - Controls the limits and color scale distribution. - Syntax: - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] - [log exp <value>] -       [datasec yes|no] -       [limits <minvalue> - <maxvalue>] -       [mode - minmax|<value>|zscale|zmax] -       [scope local|global] -       [match] -       [match limits] -     [lock [yes|no]] -       [lock limits [yes|no]] -       [open|close] - - Example: - $xpaget ds9 scale - $xpaget ds9 scale log exp - $xpaget ds9 scale datasec - $xpaget ds9 scale limits - $xpaget ds9 scale mode - $xpaget ds9 scale scope - $xpaget ds9 scale lock - $xpaget ds9 scale lock limits - $xpaset -p ds9 scale linear - $xpaset -p ds9 scale log exp 100 - $xpaset -p ds9 scale datasec yes - $xpaset -p ds9 scale histequ - $xpaset -p ds9 scale limits 1 100 - $xpaset -p ds9 scale mode zscale - $xpaset -p ds9 scale mode 99.5 - $xpaset -p ds9 scale scope local - $xpaset -p ds9 scale match - $xpaset -p ds9 scale match limits - $xpaset -p ds9 scale lock yes - $xpaset -p ds9 scale lock limits yes - $xpaset -p ds9 scale open - $xpaset -p ds9 scale close - - shm - Load a shared memory segment into the current frame. - Syntax: - shm [<key> [<filename>]] -     [key <key> [<filename>]] -     [shmid <id> [<filename>]] -     [fits [key|shmid] <id> - [<filename>]] -     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]] -     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] -     [rgbcube [key|shmid] <id> - [<filename>] -     [rgbimage [key|shmid] <id> - [<filename>]] -     [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -     [array [key|shmid] <id> +    [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - $xpaget ds9 shm - $xpaset -p ds9 shm 102 - $xpaset -p ds9 shm key 102 - $xpaset -p ds9 shm shmid 102 foo - $xpaset -p ds9 shm fits key 100 foo - $xpaset -p ds9 shm mosaicimage iraf key 100 foo - $xpaset -p ds9 shm mosaicimage wcs key 100 foo - $xpaset -p ds9 shm mosaicimage wcsa key 100 foo - $xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo - $xpaset -p ds9 shm mosaic iraf key 100 foo - $xpaset -p ds9 shm mosaic wcs key 100 foo - $xpaset -p ds9 shm rgbcube key 100 foo - $xpaset -p ds9 shm rgbimage key 100 foo - $xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] - $xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] - - sia - - Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise. - Syntax: - sia - [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] - -     - [<ref>] [cancel] -     [<ref>] - [clear] -     [<ref>] - [close] -     [<ref>] [coordinate - <ra> <dec> <coordsys>] -     [<ref>] - - - - - - - - - - - - [crosshair] -     [<ref>] [export - sb|tsv <filename>] -     [<ref>] - [name <object>] -     [<ref>] - [print] -     [<ref>] [retrieve] -     [<ref>] [save - <filename>] -     [<ref>] [radius - <value> degrees|arcmin|arcsec] -     [<ref>] [sky - <skyframe>] -     [<ref>] - [skyformat <skyformat>] -     [<ref>] - [system <coordsys>] -     [<ref>] - - - - - - - - - - - - [update] - - Example: - $xpaget ds9 sia - - $xpaset -p ds9 sia 2mass - $xpaset -p ds9 sia cancel - $xpaset -p ds9 sia clear - $xpaset -p ds9 sia close - $xpaset -p ds9 sia coordinate 202.48 47.21 fk5 - $xpaset -p ds9 sia crosshair - $xpaset -p ds9 sia export tsv bar.tsv - $xpaset -p ds9 sia name m51 - $xpaset -p ds9 sia print - $xpaset -p ds9 sia retrieve - $xpaset -p ds9 sia save foo.xml - $xpaset -p ds9 sia radius 1 degrees - $xpaset -p ds9 sia sky fk5 - $xpaset -p ds9 sia skyformat degrees - $xpaset -p ds9 sia system wcs - $xpaset -p ds9 sia update - - single - Select Single Display mode - Syntax: - single - - Example: - $xpaget ds9 single - $xpaset -p ds9 single - - skyview - Support for SkyView image server at HEASARC. - Syntax: - skyview [] -         [<object>] -         [name - <object>|clear] -         [<ra> - <dec>] # in wcs fk5 -         [size <width> - <height> degrees|arcmin|arcsec] -         [pixels <width> - <height>] -         [save yes|no] -         [frame new|current] -         [update - frame|crosshair] -       [survey <survey>] -         [open|close] - - Example: - $xpaget ds9 skyview name - $xpaget ds9 skyview coord - $xpaget ds9 skyview size - $xpaget ds9 skyview pixels - $xpaget ds9 skyview save - $xpaget ds9 skyview frame - $xpaget ds9 skyview survey - $xpaset -p ds9 skyview - $xpaset -p ds9 skyview m31 - $xpaset -p ds9 skyview name m31 - $xpaset -p ds9 skyview name clear - $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 skyview size 60 60 arcmin - $xpaset -p ds9 skyview pixels 600 600 - $xpaset -p ds9 skyview save yes - $xpaset -p ds9 skyview frame current - $xpaset -p ds9 skyview update frame - $xpaset -p ds9 skyview survey sdssi - $xpaset -p ds9 skyview open - $xpaset -p ds9 skyview close - sleep - Delays execution for specified number of seconds. Default is 1 - second. - - Syntax: - sleep [#] - - Example: - $xpaset -p ds9 sleep - $xpaset -p ds9 sleep 2 - - smooth - Smooth current image or set smooth parameters. - Boxcar width = 2*radius+1 - Tophat diameter = 2*radius+1 - Gaussian diameter = 2*radius+1, mean =0 - Elliptical Gaussian diameter = 2*radius+1, mean =0 - - Syntax: - - smooth [] -        [yes|no] -        [function - boxcar|tophat|gaussian] -        [radius - <value>] -        - [radiusminor <value>] -        - - - - - - - - - - - - - - [sigma <value>] -        - - - - - - - - - - - - - - [sigmaminor <value>] -        -[angle - - - - - - - - - - - - - - <value>] -     - - - - - - - - - - - - -    [match] -        [lock [yes|no]] -        [open|close] - - Example: - $xpaget ds9 smooth - $xpaget ds9 smooth function - $xpaget ds9 smooth radius - $xpaget ds9 smooth radiusminor - $xpaget ds9 smooth sigma - $xpaget - - - - - - - - - - - - - ds9 smooth sigmaminor - $xpaget - ds9 smooth lock - $xpaset -p ds9 smooth - $xpaset -p ds9 smooth yes - $xpaset -p ds9 smooth function tophat - $xpaset -p ds9 smooth radius 4 - $xpaset -p ds9 smooth - radiusminor 4 - $xpaset - - - - - - - - - - - - - -p ds9 smooth sigma 2.0 - $xpaset - - - - - - - - - - - - - -p ds9 smooth sigmaminor 2.0 - $xpaset - - - - - - - - - - - - -p ds9 smooth angle 45 - - $xpaset -p ds9 smooth match - $xpaset -p ds9 smooth lock yes - $xpaset -p ds9 smooth open - $xpaset -p ds9 smooth close - - source - Source TCL code from a file. Only available for XPA_METHOD - local. - Syntax: - source [<filename>] - - Example: - $xpaset -p ds9 source foo.tcl - tcl - Execute one tcl command. Only available for XPA_METHOD - local. - Syntax: - tcl [<tcl command>] - - Example: - $echo 'puts "Hello, World"' | xpaset ds9 tcl - $xpaset -p ds9 tcl {puts {Hello, World}} - - threads - Set number of process threads for functions which are - multi-threaded. - - Syntax: - threads # - - Example: - $xpaget ds9 threads - $xpaset -p ds9 threads 8 - tiff - Load TIFF image into current frame. Optional parameters: tiff - compression method. - Syntax: - tiff [new|slice] [<filename>] - [none|jpeg|packbits|deflate] - - Example: - $xpaget ds9 tiff > foo.tiff - $xpaget ds9 tiff jpeg > foo.tiff - $xpaset -p ds9 tiff foo.tiff - $xpaset -p ds9 tiff new foo.tiff - $xpaset -p ds9 tiff slice foo.tiff - $cat foo.tiff | xpaset ds9 tiff # - not available windows - $cat foo.tiff | xpaset ds9 tiff new - # not available windows - $cat foo.tiff | xpaset ds9 tiff slice - # not available windows - tile - Controls the tile display mode. - Syntax: - tile [] -      [yes|no] -      [mode grid|column|row] -      [grid] -      [grid mode automatic|manual] -      [grid direction x|y] -      [grid layout <col> <row>] -      [grid gap <pixels>] -      [row] -      [column] - - Example: - $xpaget ds9 tile - $xpaget ds9 tile mode - $xpaget ds9 tile grid mode - $xpaget ds9 tile grid direction - $xpaget ds9 tile grid layout - $xpaget ds9 tile grid gap - $xpaset -p ds9 tile - $xpaset -p ds9 tile yes - $xpaset -p ds9 tile mode row - $xpaset -p ds9 tile grid - $xpaset -p ds9 tile grid mode manual - $xpaset -p ds9 tile grid direction x - $xpaset -p ds9 tile grid layout 5 5 - $xpaset -p ds9 tile grid gap 10 - $xpaset -p ds9 tile row - $xpaset -p ds9 tile column - update - Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option. - Syntax: - update [] -        [# x1 y1 x2 y2] -        [now] -        [now # x1 y1 x2 y2] - - Example: - $xpaset -p ds9 update - $xpaset -p ds9 update 1 100 100 300 400 - $xpaset -p ds9 update now - $xpaset -p ds9 update now 1 100 100 300 400 - url - Load FITS from URL into the current frame - Syntax: - url <url> - - Example: - $xpaset -p ds9 url http://foo.bar.edu/foo.fits - - version - Returns the current version of DS9. - Syntax: - version - - Example: - $xpaget ds9 version - view - Controls the GUI. - Syntax: - view [layout horizontal|vertical] -       [keyvalue <string>] -       [info yes|no] -       [panner yes|no] -       [magnifier yes|no] -       [buttons yes|no] -       [colorbar yes|no] -       [colorbar horizontal|vertical] -       [colorbar numerics yes|no] -       [graph horizontal|vertical - yes|no] -     [filename yes|no[ -     [object yes|no] -     [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -     [units yes|no] -       [image|physical|wcs|wcsa...wcsz - yes|no] -     [frame yes|no] -     [red yes|no] - [green yes|no] - [blue yes|no] - - Example: - $xpaget ds9 view layout - $xpaget ds9 view keyvalue - $xpaget ds9 view info - $xpaget ds9 view panner - $xpaget ds9 view magnifier - $xpaget ds9 view buttons - $xpaget ds9 view colorbar - $xpaget ds9 view graph horizontal - $xpaget ds9 view filename - $xpaget ds9 view object - $xpaget ds9 view keyword - $xpaget ds9 view minmax - $xpaget ds9 view lowhigh - $xpaget ds9 view units - $xpaget ds9 view image - $xpaget ds9 view wcsa - $xpaget ds9 view red - $xpaget ds9 view frame - $xpaset -p ds9 view layout vertical - $xpaset -p ds9 view keyvalue BITPIX - $xpaset -p ds9 view info yes - $xpaset -p ds9 view panner yes - $xpaset -p ds9 view magnifier yes - $xpaset -p ds9 view buttons yes - $xpaset -p ds9 view colorbar yes - $xpaset -p ds9 view graph horizontal yes - $xpaset -p ds9 view filename yes - $xpaset -p ds9 view object yes - $xpaset -p ds9 view keyword yes - $xpaset -p ds9 view minmax yes - $xpaset -p ds9 view lowhigh yes - $xpaset -p ds9 view units yes - $xpaset -p ds9 view wcsa yes - $xpaset -p ds9 view frame yes - $xpaset -p ds9 view red yes - $xpaset -p ds9 view green yes - $xpaset -p ds9 view blue yes - - vla - Support for VLA Sky Survey. - Syntax: - vla [] -       [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -     [survey first|stripe82] -       [open|close] - - Example: - $xpaget ds9 vla name - $xpaget ds9 vla coord - $xpaget ds9 vla size - $xpaget ds9 vla save - $xpaget ds9 vla frame - $xpaget ds9 vla survey - $xpaset -p ds9 vla - $xpaset -p ds9 vla m31 - $xpaset -p ds9 vla name m31 - $xpaset -p ds9 vla name clear - $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 vla size 60 60 arcmin - $xpaset -p ds9 vla save yes - $xpaset -p ds9 vla frame current - $xpaset -p ds9 vla update frame - $xpaset -p ds9 vla survey stripe82 - $xpaset -p ds9 vla open - $xpaset -p ds9 vla close - - vlss - Support for NRAO VLSS Sky Survey. - Syntax: - vlss [] -      [<object>] -      [name <object>] -      [<ra> <dec>] # in wcs fk5 -      [size <width> <height> - degrees|arcmin|arcsec] -      [save yes|no] -      [frame new|current] -      [update frame|crosshair] -      [open|close] - - Example: - $xpaget ds9 vlss name - $xpaget ds9 vlss coord - $xpaget ds9 vlss size - $xpaget ds9 vlss save - $xpaget ds9 vlss frame - $xpaset -p ds9 vlss - $xpaset -p ds9 vlss m31 - $xpaset -p ds9 vlss name m31 - $xpaset -p ds9 vlss name clear - $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 vlss size 60 60 arcmin - $xpaset -p ds9 vlss save yes - $xpaset -p ds9 vlss frame current - $xpaset -p ds9 vlss update frame - $xpaset -p ds9 vlss open - $xpaset -p ds9 vlss close - vo - Invoke an connection to a Virtual Observatory site. - Syntax: - vo [method xpa|mime] -    [server <url>] -    [internal yes|no] -    [delay #] -    [<url>] -    [connect <url>] -    [disconnect <url>] -    [open|close] - - Example: - $xpaget ds9 vo - $xpaget ds9 vo method - $xpaget ds9 vo server - $xpaget ds9 vo internal - $xpaget ds9 vo delay - $xpaget ds9 vo connect - $xpaset -p ds9 vo method xpa - $xpaset -p ds9 vo server http://foo.bar.edu/list.txt - $xpaset -p ds9 vo internal yes - $xpaset -p ds9 vo delay 15 # keep-alive delay - $xpaset -p ds9 vo chandra-ed - $xpaset -p ds9 vo connect chandra-ed - $xpaset -p ds9 vo disconnect chandra-ed - $xpaset -p ds9 vo open - $xpaset -p ds9 vo close - - wcs - Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, using this access point, a new WCS - specification can be loaded and used by the current image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file . Please see WCS for more information. - Syntax: - wcs [[system] wcs|wcsa...wcsz] -     [[sky] fk4|fk5|icrs|galactic|ecliptic] -     [[skyformat] degrees|sexagesimal] -     [align yes|no] -     [reset [#]] -     [replace [#] <filename>] -     [append [#] <filename>] -     [open|close] - - Example: - $xpaget ds9 wcs - $xpaget ds9 wcs system - $xpaget ds9 wcs sky - $xpaget ds9 wcs skyformat - $xpaget ds9 wcs align - $xpaset -p ds9 wcs wcs - $xpaset -p ds9 wcs system wcs - $xpaset -p ds9 wcs fk5 - $xpaset -p ds9 wcs sky fk5 - $xpaset -p ds9 wcs sexagesimal - $xpaset -p ds9 wcs skyformat sexagesimal - $xpaset -p ds9 wcs align yes - $xpaset -p ds9 wcs reset - $xpaset -p ds9 wcs reset 3 - $xpaset -p ds9 wcs replace foo.wcs - $xpaset -p ds9 wcs replace 3 foo.wcs - $xpaset -p ds9 wcs append foo.wcs - $xpaset -p ds9 wcs append 3 foo.wcs - $cat foo.wcs | xpaset ds9 wcs replace - $cat foo.wcs | xpaset ds9 wcs append - $echo "OBJECT = 'foobar'" | xpaset ds9 wcs append - $xpaset -p ds9 open - $xpaset -p ds9 close - - web - Display specified URL in the web display. - Syntax: - web [] -     [<url>] -     [new <webname> <url>] -     [<webname>] [click - back|forward|stop|reload|#] -     [<webname>] [clear] -     [<webname>] [close] - - Example: - $xpaget ds9 web - $xpaset -p ds9 web www.cnn.com - $xpaset -p ds9 web new www.cnn.com - $xpaset -p ds9 web hvweb www.apple.com - $xpaset -p ds9 web click back - $xpaset -p ds9 web click 2 - $xpaset -p ds9 web clear - $xpaset -p ds9 web close - - width - Set the width of the image display window. - Syntax: - width [<value>] - - Example: - $xpaget ds9 width - $xpaset -p ds9 width 512 - xpa - Configure XPA. - Syntax: - -xpa [disconnect] -      [info] - - Example: - $xpaget ds9 info - $xpaset -p ds9 disconnect - $xpaset -p ds9 info - - zscale - Set Scale Limits based on the IRAF algorithm. - Syntax: - zscale [] -        [contrast] -        [sample] -        [line] - - Example: - $xpaget ds9 zscale contrast - $xpaget ds9 zscale sample - $xpaget ds9 zscale line - $xpaset -p ds9 zscale - $xpaset -p ds9 zscale contrast .25 - $xpaset -p ds9 zscale sample 600 - $xpaset -p ds9 zscale line 120 - - zoom - Controls the current zoom value for the current frame. - Syntax: - zoom [<value>] -      [<value> <value>] -      [to <value>] -      [to <value> <value>] -      [in] -      [out] -      [to fit] -      [open|close] - - Example: - $xpaget ds9 zoom - $xpaset -p ds9 zoom 2 - $xpaset -p ds9 zoom 2 4 - $xpaset -p ds9 zoom to 4 - $xpaset -p ds9 zoom to 2 4 - $xpaset -p ds9 zoom in - $xpaset -p ds9 zoom out - $xpaset -p ds9 zoom to fit - $xpaset -p ds9 zoom open - $xpaset -p ds9 zoom close - - + +Example: +$xpaget ds9 shm +$xpaset -p ds9 shm 102 +$xpaset -p ds9 shm key 102 +$xpaset -p ds9 shm shmid 102 foo +$xpaset -p ds9 shm fits key 100 foo +$xpaset -p ds9 shm mosaicimage iraf key 100 foo +$xpaset -p ds9 shm mosaicimage wcs key 100 foo +$xpaset -p ds9 shm mosaicimage wcsa key 100 foo +$xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo +$xpaset -p ds9 shm mosaic iraf key 100 foo +$xpaset -p ds9 shm mosaic wcs key 100 foo +$xpaset -p ds9 shm rgbcube key 100 foo +$xpaset -p ds9 shm rgbimage key 100 foo +$xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] +$xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] + sia +Support for VO Simple Image Access protocol. The first command +will create a new search. All other commands operated on the last +search created, unless indicated otherwise. +Syntax: +sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> +<coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +$xpaget ds9 sia + +$xpaset -p ds9 sia 2mass +$xpaset -p ds9 sia cancel +$xpaset -p ds9 sia clear +$xpaset -p ds9 sia close +$xpaset -p ds9 sia coordinate 202.48 47.21 fk5 +$xpaset -p ds9 sia crosshair +$xpaset -p ds9 sia export tsv bar.tsv +$xpaset -p ds9 sia name m51 +$xpaset -p ds9 sia print +$xpaset -p ds9 sia retrieve +$xpaset -p ds9 sia save foo.xml +$xpaset -p ds9 sia radius 1 degrees +$xpaset -p ds9 sia sky fk5 +$xpaset -p ds9 sia skyformat degrees +$xpaset -p ds9 sia system wcs +$xpaset -p ds9 sia update + single +Select Single Display mode +Syntax: +single + +Example: +$xpaget ds9 single +$xpaset -p ds9 single +skyview +Support for SkyView image server at HEASARC. +Syntax: +skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +$xpaget ds9 skyview name +$xpaget ds9 skyview coord +$xpaget ds9 skyview size +$xpaget ds9 skyview pixels +$xpaget ds9 skyview save +$xpaget ds9 skyview frame +$xpaget ds9 skyview survey +$xpaset -p ds9 skyview +$xpaset -p ds9 skyview m31 +$xpaset -p ds9 skyview name m31 +$xpaset -p ds9 skyview name clear +$xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 skyview size 60 60 arcmin +$xpaset -p ds9 skyview pixels 600 600 +$xpaset -p ds9 skyview save yes +$xpaset -p ds9 skyview frame current +$xpaset -p ds9 skyview update frame +$xpaset -p ds9 skyview survey sdssi +$xpaset -p ds9 skyview open +$xpaset -p ds9 skyview close +sleep +Delays execution for specified number of seconds. Default is 1 +second. +Syntax: +sleep [#] + +Example: +$xpaset -p ds9 sleep +$xpaset -p ds9 sleep 2 +smooth +Smooth current image or set smooth parameters. +Boxcar width = 2*radius+1 +Tophat diameter = 2*radius+1 +Gaussian diameter = 2*radius+1, mean =0 +Elliptical Gaussian diameter = 2*radius+1, mean +=0 +Syntax: +smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close] +Example: +$xpaget ds9 smooth +$xpaget ds9 smooth function +$xpaget ds9 smooth radius +$xpaget ds9 smooth radiusminor +$xpaget ds9 smooth sigma +$xpaget ds9 smooth sigmaminor +$xpaget ds9 smooth lock +$xpaset -p ds9 smooth +$xpaset -p ds9 smooth yes +$xpaset -p ds9 smooth function tophat +$xpaset -p ds9 smooth radius 4 +$xpaset -p ds9 smooth radiusminor 4 +$xpaset -p ds9 smooth sigma 2.0 +$xpaset -p ds9 smooth sigmaminor 2.0 +$xpaset -p ds9 smooth angle 45 +$xpaset -p ds9 smooth match +$xpaset -p ds9 smooth lock yes +$xpaset -p ds9 smooth open +$xpaset -p ds9 smooth close +source +Source TCL code from a file. Only available for XPA_METHOD +local. +Syntax: +source [<filename>] + +Example: +$xpaset -p ds9 source foo.tcl +tcl +Execute one tcl command. Only available for XPA_METHOD +local. +Syntax: +tcl [<tcl command>] + +Example: +$echo 'puts "Hello, World"' | xpaset ds9 tcl +$xpaset -p ds9 tcl {puts {Hello, World}} +threads +Set number of process threads for functions which are +multi-threaded. +Syntax: +threads # + +Example: +$xpaget ds9 threads +$xpaset -p ds9 threads 8 +tiff +Load TIFF image into current frame. Optional parameters: +tiff compression method. +Syntax: +tiff [new|slice] [<filename>] +[none|jpeg|packbits|deflate] + +Example: +$xpaget ds9 tiff > foo.tiff +$xpaget ds9 tiff jpeg > foo.tiff +$xpaset -p ds9 tiff foo.tiff +$xpaset -p ds9 tiff new foo.tiff +$xpaset -p ds9 tiff slice foo.tiff +$cat foo.tiff | xpaset ds9 tiff# not available windows +$cat foo.tiff | xpaset ds9 tiffnew# not available windows +$cat foo.tiff | xpaset ds9 tiffslice# not available windows +tile +Controls the tile display mode. +Syntax: +tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +$xpaget ds9 tile +$xpaget ds9 tile mode +$xpaget ds9 tile grid mode +$xpaget ds9 tile grid direction +$xpaget ds9 tile grid layout +$xpaget ds9 tile grid gap +$xpaset -p ds9 tile +$xpaset -p ds9 tile yes +$xpaset -p ds9 tile mode row +$xpaset -p ds9 tile grid +$xpaset -p ds9 tile grid mode manual +$xpaset -p ds9 tile grid direction x +$xpaset -p ds9 tile grid layout 5 5 +$xpaset -p ds9 tile grid gap 10 +$xpaset -p ds9 tile row +$xpaset -p ds9 tile column +update +Updates the current frame or region of frame. In the second +form, the first argument is the number of the fits HDU (starting +with 1) and the remaining args are a bounding box in IMAGE +coordinates. By default, the screen is updated the next available +idle cycle. However, you may force an immediate update by +specifying the NOW option. +Syntax: +update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: +$xpaset -p ds9 update +$xpaset -p ds9 update 1 100 100 300 400 +$xpaset -p ds9 update now +$xpaset -p ds9 update now 1 100 100 300 400 +url +Load FITS from URL into the current frame +Syntax: +url <url> + +Example: +$xpaset -p ds9 url http://foo.bar.edu/foo.fits +version +Returns the current version of DS9. +Syntax: +version + +Example: +$xpaget ds9 version +view +Controls the GUI. +Syntax: +view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [colorbar horizontal|vertical] +    [colorbar numerics yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no[ +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +$xpaget ds9 view layout +$xpaget ds9 view keyvalue +$xpaget ds9 view info +$xpaget ds9 view panner +$xpaget ds9 view magnifier +$xpaget ds9 view buttons +$xpaget ds9 view colorbar +$xpaget ds9 view graph horizontal +$xpaget ds9 view filename +$xpaget ds9 view object +$xpaget ds9 view keyword +$xpaget ds9 view minmax +$xpaget ds9 view lowhigh +$xpaget ds9 view units +$xpaget ds9 view image +$xpaget ds9 view wcsa +$xpaget ds9 view red +$xpaget ds9 view frame +$xpaset -p ds9 view layout vertical +$xpaset -p ds9 view keyvalue BITPIX +$xpaset -p ds9 view info yes +$xpaset -p ds9 view panner yes +$xpaset -p ds9 view magnifier yes +$xpaset -p ds9 view buttons yes +$xpaset -p ds9 view colorbar yes +$xpaset -p ds9 view graph horizontal yes +$xpaset -p ds9 view filename yes +$xpaset -p ds9 view object yes +$xpaset -p ds9 view keyword yes +$xpaset -p ds9 view minmax yes +$xpaset -p ds9 view lowhigh yes +$xpaset -p ds9 view units yes +$xpaset -p ds9 view wcsa yes +$xpaset -p ds9 view frame yes +$xpaset -p ds9 view red yes +$xpaset -p ds9 view green yes +$xpaset -p ds9 view blue yes + +vla +Support for VLA Sky Survey. +Syntax: +vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +$xpaget ds9 vla name +$xpaget ds9 vla coord +$xpaget ds9 vla size +$xpaget ds9 vla save +$xpaget ds9 vla frame +$xpaget ds9 vla survey +$xpaset -p ds9 vla +$xpaset -p ds9 vla m31 +$xpaset -p ds9 vla name m31 +$xpaset -p ds9 vla name clear +$xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 vla size 60 60 arcmin +$xpaset -p ds9 vla save yes +$xpaset -p ds9 vla frame current +$xpaset -p ds9 vla update frame +$xpaset -p ds9 vla survey stripe82 +$xpaset -p ds9 vla open +$xpaset -p ds9 vla close +vlss +Support for NRAO VLSS Sky Survey. +Syntax: +vlss [] +    [<object>] +    [name <object>] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 vlss name +$xpaget ds9 vlss coord +$xpaget ds9 vlss size +$xpaget ds9 vlss save +$xpaget ds9 vlss frame +$xpaset -p ds9 vlss +$xpaset -p ds9 vlss m31 +$xpaset -p ds9 vlss name m31 +$xpaset -p ds9 vlss name clear +$xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 vlss size 60 60 arcmin +$xpaset -p ds9 vlss save yes +$xpaset -p ds9 vlss frame current +$xpaset -p ds9 vlss update frame +$xpaset -p ds9 vlss open +$xpaset -p ds9 vlss close +vo +Invoke an connection to a Virtual Observatory site. +Syntax: +vo [method xpa|mime] +   [server <url>] +   [internal yes|no] +   [delay #] +   [<url>] +   [connect <url>] +   [disconnect <url>] +   [open|close] + +Example: +$xpaget ds9 vo +$xpaget ds9 vo method +$xpaget ds9 vo server +$xpaget ds9 vo internal +$xpaget ds9 vo delay +$xpaget ds9 vo connect +$xpaset -p ds9 vo method xpa +$xpaset -p ds9 vo server http://foo.bar.edu/list.txt +$xpaset -p ds9 vo internal yes +$xpaset -p ds9 vo delay 15 # keep-alive delay +$xpaset -p ds9 vo chandra-ed +$xpaset -p ds9 vo connect chandra-ed +$xpaset -p ds9 vo disconnect chandra-ed +$xpaset -p ds9 vo open +$xpaset -p ds9 vo close +wcs +Controls the World Coordinate System for the current frame. If +the wcs system, skyframe, or skyformat is modified, the info panel, +compass, grid, and alignment will be modified accordingly. Also, +using this access point, a new WCS specification can be loaded and +used by the current image regardless of the WCS that was contained +in the image file. WCS specification can be sent to DS9 as an ASCII +file . Please see WCS for more +information. +Syntax: +wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +$xpaget ds9 wcs +$xpaget ds9 wcs system +$xpaget ds9 wcs sky +$xpaget ds9 wcs skyformat +$xpaget ds9 wcs align +$xpaset -p ds9 wcs wcs +$xpaset -p ds9 wcs system wcs +$xpaset -p ds9 wcs fk5 +$xpaset -p ds9 wcs sky fk5 +$xpaset -p ds9 wcs sexagesimal +$xpaset -p ds9 wcs skyformat sexagesimal +$xpaset -p ds9 wcs align yes +$xpaset -p ds9 wcs reset +$xpaset -p ds9 wcs reset 3 +$xpaset -p ds9 wcs replace foo.wcs +$xpaset -p ds9 wcs replace 3 foo.wcs +$xpaset -p ds9 wcs append foo.wcs +$xpaset -p ds9 wcs append 3 foo.wcs +$cat foo.wcs | xpaset ds9 wcs replace +$cat foo.wcs | xpaset ds9 wcs append +$echo "OBJECT = 'foobar'" | xpaset ds9 wcs append +$xpaset -p ds9 open +$xpaset -p ds9 close +web +Display specified URL in the web display. +Syntax: +web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click +back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +$xpaget ds9 web +$xpaset -p ds9 web www.cnn.com +$xpaset -p ds9 web new www.cnn.com +$xpaset -p ds9 web hvweb www.apple.com +$xpaset -p ds9 web click back +$xpaset -p ds9 web click 2 +$xpaset -p ds9 web clear +$xpaset -p ds9 web close +width +Set the width of the image display window. +Syntax: +width [<value>] + +Example: +$xpaget ds9 width +$xpaset -p ds9 width 512 +xpa +Configure XPA. +Syntax: +-xpa [disconnect] +    [info] + +Example: +$xpaget ds9 info +$xpaset -p ds9 disconnect +$xpaset -p ds9 info +zscale +Set Scale Limits based on the IRAF algorithm. +Syntax: +zscale [] +    [contrast] +    [sample] +    [line] + +Example: +$xpaget ds9 zscale contrast +$xpaget ds9 zscale sample +$xpaget ds9 zscale line +$xpaset -p ds9 zscale +$xpaset -p ds9 zscale contrast .25 +$xpaset -p ds9 zscale sample 600 +$xpaset -p ds9 zscale line 120 +zoom +Controls the current zoom value for the current frame. +Syntax: +zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +$xpaget ds9 zoom +$xpaset -p ds9 zoom 2 +$xpaset -p ds9 zoom 2 4 +$xpaset -p ds9 zoom to 4 +$xpaset -p ds9 zoom to 2 4 +$xpaset -p ds9 zoom in +$xpaset -p ds9 zoom out +$xpaset -p ds9 zoom to fit +$xpaset -p ds9 zoom open +$xpaset -p ds9 zoom close + -- cgit v0.12 From 916590230e1de6d35aa04c271c5de8af13388260 Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 16:35:27 -0400 Subject: clean up html --- ds9/doc/ref/xpa.html | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index 28ac728..4cb1862 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -2581,13 +2581,13 @@ Example: $xpaset -p ds9 sleep $xpaset -p ds9 sleep 2 smooth -Smooth current image or set smooth parameters. -Boxcar width = 2*radius+1 -Tophat diameter = 2*radius+1 -Gaussian diameter = 2*radius+1, mean =0 -Elliptical Gaussian diameter = 2*radius+1, mean -=0 -Syntax: + Smooth current image or set smooth parameters. +Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter +=2*radius+1,mean=0 +Syntax: smooth []     [yes|no]     [function boxcar|tophat|gaussian] -- cgit v0.12 From 0544097629929399405fa1b1bcf69667692720ad Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 16:45:50 -0400 Subject: clean up html --- ds9/doc/ref/command.html | 5936 ++++++++++++++++++++-------------------------- 1 file changed, 2574 insertions(+), 3362 deletions(-) diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index ef5a8c9..0694f7d 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -1,3370 +1,2582 @@ - - - - - Command Line Options - - - Command Line Options - - DS9 will process each command line option, one at a time, as - the last step in the initialization process. Therefore, it is - possible to use command line options as a little script. For - example, the following command line option is used: - $ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 - First DS9 is put in tile mode, then foo.fits is - loaded. Then the colormap for foo.fits is changed to Heat - and the scale changed to zscale. Next, bar.fits - is loaded and the colormap for bar.fits is changed to - I8. - 2mass - 3d - about - align - analysis - array - asinh - background - backup - bin - blink - block - blue - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - dsssao - dsseso - dssstsci - envi - exit - export - fifo - fifo_only - fits - frame - geometry - gif - green - grid - header - height - help - histequ - iconify - inet_only - invert - iis - jpeg - language - linear - lock - log - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - msg - multiframe - nameserver - nan - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - port - port_only - pow - quit - raise - regions - red - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - samp - save - saveimage - scale - shm - sia - single - sinh - skyview - sleep - slice - smooth - squared - sqrt - source - tcl - threads - tiff - tile - title - unix - unix_only - update - url - version - view - visual - vla - vlss - vo - wcs - web - width - xpa - zmax - zoom - zscale - - 2mass - Support for 2MASS Digital Sky Survey. - Syntax: - -2mass [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -    [survey j|h|k] -        [open|close] - - Example: - $ds9 -2mass - $ds9 -2mass m31 - $ds9 -2mass name m31 - $ds9 -2mass name clear - $ds9 -2mass 00:42:44.404 +41:16:08.78 - $ds9 -2mass size 60 60 arcmin - $ds9 -2mass save yes - $ds9 -2mass frame current - $ds9 -2mass update frame - $ds9 -2mass survey j - $ds9 -2mass open - $ds9 -2mass close - - 3d - Support for 3D frame. - Syntax: - -3d [] -     [view <az> <el>] -     [az <az>] -     [el <el>] -     [scale <scale>] -     [method mip|aip] -     [background none|azimuth|elevation] -     [border yes|no] -     [border color] -     [highlite yes|no] -     [highlite color] -     [compass yes|no] -     [compass color] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $ds9 -3d # create new 3D frame - $ds9 -3d view 45 30 - $ds9 -3d az 45 - $ds9 -3d el 30 - $ds9 -3d scale 10 - $ds9 -3d method mip - $ds9 -3d background azimuth - $ds9 -3d border yes - $ds9 -3d border color red - $ds9 -3d highlite yes - $ds9 -3d highlite color red - $ds9 -3d compass yes - $ds9 -3d compass color red - $ds9 -3d match - $ds9 -3d lock yes - $ds9 -3d open - $ds9 -3d close - about - Get DS9 credits. - Syntax: - -about - - Example: - $ds9 -about - - align - Controls the World Coordinate System alignment for the current - frame. - Syntax: - -align [yes|no] - - Example: - $ds9 -align yes - - analysis - Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window. - Syntax: - -analysis [<task number>] -           - [<filename>] -         [task <task - number>|<task name>] -           [load - <filename>] -           [clear] -           - [clear][load <filename>] -           [message - ok|okcancel|yesno <message>] -           [entry - <message>] -           [text] - - Example: - $ds9 -analysis 0 # invoke first analysis task - $ds9 -analysis task 0 - $ds9 -analysis task foobar - $ds9 -analysis task {foo bar} - $ds9 -analysis my.ans - $ds9 -analysis load my.ans - $ds9 -analysis clear - $ds9 -analysis clear load my.ans - $ds9 -analysis message {This is a message} - $ds9 -analysis text {This is text} - - array - Load raw data array into current frame. - - Syntax: - -array -<filename>[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] - $cat foo.arr | ds9 -array -[dim=512,bitpix=-32,endian=little] - - asinh - Select ASINH scale function for the current frame. - Syntax: - -asinh - - Example: - $ds9 -asinh - bg - background - Set image background color. - Syntax: - -bg <color> - - Example: - $ds9 -background red - $ds9 -bg red - backup - Create a backup save set. - Syntax: - -backup <filename> - - Example: - $ds9 -backup ds9.bck - bin - Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. - Syntax: - -bin [about <x> <y>] -      [about center] -      [buffersize <value>] -      [cols <x> <y>] -      [colsz <x> <y> <z>] -      [factor <value> [<value>]] -      [depth <value>] -      [filter <string>] -      [filter clear] -      [function average|sum] -      [in] -      [out] -      [to fit] -      [match] -      [lock [yes|no]] -      [open|close] - - Example: - $ds9 -bin about 4096 4096 - $ds9 -bin about center - $ds9 -bin buffersize 512 - $ds9 -bin cols detx dety - $ds9 -bin colsz detx dety time - $ds9 -bin factor 4 - $ds9 -bin factor 4 2 - $ds9 -bin depth 10 - $ds9 -bin filter 'pha > 5' - $ds9 -bin filter clear - $ds9 -bin function sum - $ds9 -bin in - $ds9 -bin out - $ds9 -bin to fit - $ds9 -bin match - $ds9 -bin lock yes - $ds9 -bin open - $ds9 -bin close - - blink - Blink mode parameters. Interval is in seconds. - Syntax: - -blink [] -        [yes|no] -        [interval <value>] - - Example: - $ds9 -blink - $ds9 -blink yes - $ds9 -blink interval 1 - block - Controls blocking parameters. - Syntax: - -block [<value>] -        [<value> - <value>] -        [to <value>] -        [to <value> - <value>] -        [in] -        [out] -        [to fit] -        [match] -        [lock [yes|no]] -        [open|close] - - Example: - $ds9 -block - 4 - $ds9 -block 4 2 - $ds9 -block - to 4 - $ds9 -block to 4 2 - $ds9 -block in - $ds9 -block - out - $ds9 -block to - fit - $ds9 -block match - $ds9 -block lock yes - $ds9 -block open - $ds9 -block close - - blue - For RGB frames, sets the current color channel to blue. - Syntax: - -blue - - Example: - $ds9 -blue foo.fits - - catalog - cat - Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise. - Syntax: - -catalog [new] -         - [ned|simbad|denis|skybot] -         -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -         [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -         - [2mass|iras] -         - [csc|xmm|rosat] -         [first|nvss] -         - [chandralog|cfhtlog|esolog|stlog|xmmlog] -         [cds - <catalogname>] -         [cds - <catalogid>] - -         [load - <filename>] -         [import sb|tsv - <filename>] - -     -     [<ref>] [<ra> <dec> - <coordsys>] -       - [<ref>] [allcols] -      -    [<ref>] [allrows] -         - [<ref>] [cancel] -     -     [<ref>] [clear] -       - [<ref>] [close] -         - [<ref>] [crosshair] -         - [<ref>] [dec <col>] -         - [<ref>] [edit yes|no] -         - [<ref>] [export sb|tsv <filename>] -         - - - - - - - - - - - - - [<ref>] [filter <string>] -         [<ref>] - [filter load <filename>] -         - [<ref>] [header] -         - [<ref>] [location <code>] -         - [<ref>] [match <ref> <ref>] -         - - - - - - - - - - - - - - [<ref>] [match] -         - [<ref>] [match error <value> - degrees|arcmin|arcsec] -         - [<ref>] [match function 1and2|1not2|2not1] -         - [<ref>] [match return 1and2|1only|2only] -         - [<ref>] [match unique yes|no] -         - [<ref>] [maxrows <number>] -       [<ref>] - [name <object>] -         - - - - - - - - - - - - - [<ref>] [panto yes|no] -         - [<ref>] [plot <xcol> <ycol> <xerrcol> - <yerrcol>] -       [<ref>] - [print] -         - [<ref>] [psky <skyframe>] -         - [<ref>] [psystem <coordsys>] -         - [<ref>] [ra <col>] -         - [<ref>] [regions] -         [<ref>] - [retrieve] -     -     [<ref>] [samp] -         [<ref>] - [samp broadcast] -         [<ref>] - [samp send <application>] -         - - - - - - - - - - - - - [<ref>] [save <filename>] -         - [<ref>] [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -         - [<ref>] [show yes|no] -       [<ref>] - [radius <value> degrees|arcmin|arcsec] -         - [<ref>] [sky <skyframe>] -     -     [<ref>] [skyformat <skyformat>] -     -     [<ref>] [sort <col> incr|decr] -         - [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -     -     [<ref>] [symbol [#] - text|size|size2|units|angle <value>] -         - [<ref>] [symbol shape circle|ellipse|box|text|point] -         [<ref>] - - - - - - - - - - - - - [symbol shape circle point|box point|diamond - point|cross point|x point|arrow point|boxcircle point] -         - - - - - - - - - - - - - [<ref>] [symbol add| [#] remove] -         [<ref>] - [symbol save|load <filename>] -         - [<ref>] [system <coordsys>] -      -    [<ref>] [update] -         - [<ref>] [x <col>] -         - [<ref>] [y <col>] - - Example: - $ds9 -catalog new - $ds9 -catalog 2mass - $ds9 -catalog cds 2mass - $ds9 -catalog cds "I/252" - - $ds9 -catalog load foo.xml - $ds9 -catalog import tsv foo.tsv - - $ds9 -catalog 202.48 47.21 fk5 - $ds9 -catalog allrows - $ds9 -catalog allcols - $ds9 -catalog cancel - $ds9 -catalog clear - $ds9 -catalog close - $ds9 -catalog crosshair - $ds9 -catalog dec DEC - $ds9 -catalog edit yes - $ds9 -catalog export tsv bar.tsv - $ds9 -catalog filter '\$Jmag>15' - $ds9 -catalog filter load foo.flt - $ds9 -catalog header - $ds9 -catalog location 500 - $ds9 -catalog match error 2 arcsec - $ds9 -catalog match function 1and2 - $ds9 -catalog match unique no - $ds9 -catalog match return 1only - $ds9 -catalog match # last two - catalogs loaded - $ds9 -catalog match 2mass csc - $ds9 -catalog maxrows 2000 - $ds9 -catalog name m51 - $ds9 -catalog panto no - $ds9 -catalog plot '\$Jmag' - - - - - - - - - - - - '\$Hmag' '\$e_Jmag' '\$e_Hmag' - $ds9 -catalog print - $ds9 -catalog psky fk5 - $ds9 -catalog psystem wcs - $ds9 -catalog ra RA - $ds9 -catalog regions - $ds9 -catalog retrieve - $ds9 -catalog samp broadcast - $ds9 -catalog samp send aladin - $ds9 -catalog save foo.xml - $ds9 -catalog server sao - $ds9 -catalog show yes - $ds9 -catalog radius 1 degrees - $ds9 -catalog symbol condition '\$Jmag>15' - $ds9 -catalog symbol 2 shape "boxcircle point" - $ds9 -catalog symbol color red - $ds9 -catalog symbol font times - $ds9 -catalog symbol fontsize 14 - $ds9 -catalog symbol fontweight - bold - $ds9 -catalog symbol fontslant - italic - $ds9 -catalog symbol add - $ds9 -catalog symbol 2 remove - $ds9 -catalog symbol load foo.sym - $ds9 -catalog symbol save bar.sym - $ds9 -catalog sky fk5 - $ds9 -catalog skyformat degrees - $ds9 -catalog sort "Jmag" incr - $ds9 -catalog system wcs - $ds9 -catalog update - $ds9 -catalog x RA - $ds9 -catalog y DEC - cd - Sets the current working directory. - Syntax: - cd [<directory>] - - Example: - $ds9 -cd /home/mrbill - - cmap - Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1. - Syntax: - -cmap [<colormap>] -       [load <filename>] -       [save <filename>] -       [invert yes|no] -       [<contrast> <bias>] -       [tag [load|save] - <filename>] -       [tag delete] -       [open|close] - - Example: - $ds9 -cmap Heat - $ds9 -cmap load foo.sao - $ds9 -cmap save bar.sao - $ds9 -cmap invert yes - $ds9 -cmap 5 .5 - $ds9 -cmap tag load foo.tag - $ds9 -cmap tag save foo.tag - $ds9 -cmap tag delete - $ds9 -cmap open - $ds9 -cmap close - - colorbar - Controls colorbar parameters. - Syntax: - -colorbar [] -           [yes|no] -           - [horizontal|vertical] -           [numerics - yes|no] -         [space - value|distance] -           [font - times|helvetica|courier] -           [fontsize - <value>] -           - [fontweight normal|bold] -         [fontslant - roman|italic] -           [size] -         [ticks] -           - - - - - - - - - - - - - - [match] -           [lock - [yes|no]] - - Example: - $ds9 -colorbar yes - $ds9 -colorbar vertical - $ds9 -colorbar numerics yes - $ds9 -colorbar space value - $ds9 -colorbar font times - $ds9 -colorbar fontsize 14 - $ds9 -colorbar fontweight bold - $ds9 -colorbar fontslant italic - $ds9 -colorbar size 20 - $ds9 -colorbar ticks 11 - $ds9 -colorbar match - $ds9 -colorbar lock yes - console - Display tcl console window. - Syntax: - -console - - Example: - $ds9 -console - - contour - - Controls contours in the current frame. - Syntax: - -contour [] -          [yes|no] -          [clear] -        [generate] -          [load - <filename>] -        [save - <filename> [<coordsys> <skyframe>]] -          [convert] -          [load levels - <filename>] -          [save - levels <filename>] -          [copy] -          [paste - [<coordsys> <color> <width> yes|no]] -          [color - <color>] -          [width - <width>] -        [dash yes|no] -          [smooth - <smooth>] -          [method - block|smooth] -          [nlevels <number - of levels>] -          [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -          [log exp - <value>] -          [mode - minmax|<value>|zscale|zmax] -          [scope global|local] -          [limits <min> - <max>] -          [levels - <value value value...>] -          [open|close] - - Example: - $ds9 -contour - $ds9 -contour yes - $ds9 -contour generate - $ds9 -contour clear - $ds9 -contour load ds9.ctr - $ds9 -contour save ds9.ctr - $ds9 -contour save ds9.ctr wcs fk5 - $ds9 -contour convert - $ds9 -contour load levels ds9.ctr - $ds9 -contour save levels ds9.lev - $ds9 -contour copy - $ds9 -contour paste - $ds9 -contour paste wcs red 2 no - $ds9 -contour color yellow - $ds9 -contour width 2 - $ds9 -contour dash yes - $ds9 -contour smooth 5 - $ds9 -contour method smooth - $ds9 -contour nlevels 10 - $ds9 -contour scale sqrt - $ds9 -contour log exp 1000 - $ds9 -contour mode zscale - $ds9 -contour scope local - $ds9 -contour limits 1 100 - $ds9 -contour levels 1 10 100 1000 - $ds9 -contour open - $ds9 -contour close - - crop - Set current image display area. - Syntax: - -crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -       [match <coordsys>] -       [lock <coordsys>|none] -       [reset] -       [3d zmin zmax <coordsys>] -       [open|close] - - Example: - $ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords - $ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 - 22.000204 wcs galactic arcsec - $ds9 foo.fits -crop match wcs - $ds9 foo.fits -crop lock wcs - $ds9 foo.fits -crop reset - $ds9 foo.fits -crop 3d .25 .5 wcs - $ds9 foo.fits -crop open - $ds9 foo.fits -crop close - - crosshair - Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set. - Syntax: - -crosshair [<x> <h> <coordsys> - [<skyframe>]] -            -[match - - - - - - - - - - - - - - <coordsys>] -            [lock - <coordsys>|none] - - Example: - $ds9 -crosshair 100 100 physical # set crosshair in physical - $ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords - $ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 - $ds9 -crosshair match - $ds9 -crosshair lock wcs - - cube - - Controls FITS cube. - Syntax: - -cube [] -       [play|stop|next|prev|first|last] -       [<slice> - [<coordsys>]] -       [interval <numeric>] -       [match <coordsys>] -       [lock <coordsys>|none] -       [order 123|132|213|231|312|321] -       [axes lock [yes|no]] -       [open|close] - - Example: - $ds9 -cube - $ds9 -cube play - $ds9 -cube last - $ds9 -cube 3 - $ds9 -cube 4.5 wcs - $ds9 -cube interval 2 - $ds9 -cube match wcs - $ds9 -cube lock wcs - $ds9 -cube order 123 - $ds9 -cube axes lock yes - $ds9 -cube open - $ds9 -cube close - cursor - Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also. - Syntax: - -cursor [<x> <h>] - - Example: - $ds9 -cursor 10 10 - - dsssao - dss - - Support for Digital Sky Survey at SAO. - Syntax: - -dsssao [] -         [<object>] -         [name - <object>|clear] -         [<ra> - <dec>] # in wcs fk5 -         [size <width> - <height> degrees|arcmin|arcsec] -         [save yes|no] -         [frame new|current] -         [update - frame|crosshair] -         [open|close] - - Example: - $ds9 -dsssao - $ds9 -dsssao m31 - $ds9 -dsssao name m31 - $ds9 -dsssao name clear - $ds9 -dsssao 00:42:44.404 +41:16:08.78 - $ds9 -dsssao size 60 60 arcmin - $ds9 -dsssao save yes - $ds9 -dsssao frame current - $ds9 -dsssao update frame - $ds9 -dsssao open - $ds9 -dsssao close - - dsseso - Support for Digital Sky Survey at ESO. - Syntax: - -dsseso [] -         [<object>] -         [name - <object>|clear] -         [<ra> - <dec>] # in wcs fk5 -         [size <width> - <height> degrees|arcmin|arcsec] -         [save yes|no] -         [frame new|current] -         [update - frame|crosshair] -       [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -         [open|close] - - Example: - $ds9 -dsseso - $ds9 -dsseso m31 - $ds9 -dsseso name m31 - $ds9 -dsseso name clear - $ds9 -dsseso 00:42:44.404 +41:16:08.78 - $ds9 -dsseso size 60 60 arcmin - $ds9 -dsseso save yes - $ds9 -dsseso frame current - $ds9 -dsseso update frame - $ds9 -dsseso survey DSS2-red - $ds9 -dsseso open - $ds9 -dsseso close - dssstsci - Support for Digital Sky Survey at STSCI. - Syntax: - -dssstsci [] -         [<object>] -           [name - <object>|clear] -           - [<ra> <dec>] # in wcs fk5 -           [size - <width> <height> degrees|arcmin|arcsec] -           [save - yes|no] -           [frame - new|current] -           [update - frame|crosshair] -           [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -           [survey - poss1_blue|poss1_red] -           [survey - all|quickv|phase2_gsc2|phase2_gsc1] -         [open|close] - - Example: - $ds9 -dssstsci - $ds9 -dssstsci m31 - $ds9 -dssstsci name m31 - $ds9 -dssstsci name clear - $ds9 -dssstsci 00:42:44.404 +41:16:08.78 - $ds9 -dssstsci size 60 60 arcmin - $ds9 -dssstsci save yes - $ds9 -dssstsci frame current - $ds9 -dssstsci update frame - $ds9 -dssstsci survey all - $ds9 -dssstsci open - $ds9 -dssstsci close - envi - Load an ENVI header and file. Optional parameter: array endian. - - Syntax: - -envi <header> [<filename>] - - Example: - $ds9 -envi foo.hdr - $ds9 - - - - - - - - - - - - - -envi foo.hdr foo.bsq - - exit - quit - Quits DS9. - Syntax: - -exit - -quit - - Example: - $ds9 -exit - - export - - Export loaded image data of current frame in specified image - format, at native resolution, using current colormap and - contrast/bias settings. NOTE: not scaling, rotation, or - translation is applied. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff compression method. - - Syntax: - -export [array|nrrd|envi|gif|tiff|jpeg|png] - <filename> - -export array <filename> - [big|little|native] - -export nrrd <filename> [big|little|native] - -export envi <header> [<filename>] - [big|little|native] - -export <filename>.jpeg - - - - - - - - - - - - [1-100] - -export <filename>.tiff - - - - - - - - - - - - - [none|jpeg|packbits|deflate] - - Example: - $ds9 -export array foo.arr little - $ds9 -export nrrd foo.nrrd little - $ds9 -export envi foo.hdr little - $ds9 -export envi foo.hdr foo.bsq - little - $ds9 -export tiff foo.tiff jpeg - $ds9 -export jpeg foo.jpeg 75 - $ds9 -export png foo.png - fifo - Set the name of the IRAF input and output fifos. The default is - /dev/imt1. These fifos are used by IRAF to communicate with DS9. - Syntax: - -fifo name - - Example: - $ds9 -fifo /dev/imt1 - fifo_only - Only use IRAF input and output fifos. Same as -port 0 -unix - none. - Syntax: - -fifo_only - - Example: - $ds9 -fifo_only - - fits - Load a FITS image into the current frame. - - Syntax: - -fits <filename> - - Example: - $ds9 -fits foo.fits - $ds9 -fits bar.fits[bin=detx,dety] - $cat foo.fits | ds9 -fits - - $cat bar.fits | ds9 -fits -[bin=detx,dety] - - frame - Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility. - Syntax: - -frame [center [#|all]] -    [clear [#|all]] -      [new [rgb]] - [delete [#|all]] - [reset [#|all]] -     [refresh [#|all]] -       [hide [#|all]] -     [show [#|all]] -        [move first] -        [move back] -        [move forward] -        [move last] - [first] -     [prev] - [next] - [last] - [frameno #] -     [#] -        [match <coordsys>] -        [lock - <coordsys>|none] - - Example: - $ds9 -frame center # center current frame - $ds9 -frame center 1 # center 'Frame1' - $ds9 -frame center all # center all frames - $ds9 -frame clear # clear current frame - $ds9 -frame new # create new frame - $ds9 -frame new rgb # create new rgb frame - $ds9 -frame delete # delete current frame - $ds9 -frame reset # reset current frame - $ds9 -frame refresh # refresh current frame - $ds9 -frame hide # hide current frame - $ds9 -frame show 1 # show frame 'Frame1' - $ds9 -frame move first # move frame to first in order - $ds9 -frame move back # move frame back in order - $ds9 -frame move forward # move frame forward in order - $ds9 -frame move last # move frame to last in order - $ds9 -frame first # goto first frame - $ds9 -frame prev # goto prev frame - $ds9 -frame next # goto next frame - $ds9 -frame last # goto last frame - $ds9 -frame frameno 4 # goto frame 'Frame4', create if needed - $ds9 -frame 3 # goto frame 'Frame3', create if needed - $ds9 -frame lock wcs - gif - Load GIF image into current frame. - Syntax: - -gif <filename> - - Example: - $ds9 -gif foo.gif - $cat foo.gif | ds9 -gif - - - geometry - Define the initial window geometry. This includes all of the - ds9 window, not just the image space. see X(1). - Syntax: - -geometry value - - Example: - $ds9 -geometry 640x480 - green - For RGB frames, sets the current color channel to green. - Syntax: - -green - - Example: - $ds9 -green foo.fits - grid - Controls coordinate grid. For grid numeric format syntax, - click here. - Syntax: - -grid [] -       [yes|no] -       [type analysis|publication] -       [system <coordsys>] -       [sky <skyframe>] -       [skyformat <skyformat>] -       [grid yes|no] -       [grid color <color>] -       [grid width <value>] -       [grid dash yes|no] -       [grid gap1 <value>] -       [grid gap2 - <value>] -       [grid - gap3 <value>] -       [axes yes|no] -       [axes color <color>] -       [axes width <value>] -       [axes dash yes|no] -       [axes type interior|exterior] -       [axes origin - lll|llu|lul|luu|ull|ulu|uul|uuu] -     [format1 <format>] -       [format2 <format>] -       [tickmarks yes|no] -       [tickmarks color <color>] -       [tickmarks width <value>] -       [tickmarks dash yes|no] -       [border yes|no] -       [border color <color>] -       [border width <value>] -       [border dash yes|no] -       [numerics yes|no] -       [numerics font - times|helvetica|courier] -       [numerics fontsize <value>] -       [numerics fontweight normal|bold] -       [numerics fontslant roman|italic] -       [numerics color <color>] -       [numerics gap1 <value>] -       [numerics gap2 - <value>] -       [numerics - gap3 <value>] -       [numerics type - interior|exterior] -       [numerics vertical yes|no] -       [title yes|no] -       [title text <text>] -       [title def yes|no] -       [title gap <value>] -       [title font - times|helvetica|courier] -       [title fontsize <value>] -       [title fontweight normal|bold] -     [title fontslant roman|italic] -       [title color <color>] -       [labels yes|no] -       [labels text1 <text>] -       [labels text2 - <text>] -       [labels def1 yes|no] -       [labels def2 yes|no] -       [labels gap1 <value>] -       [labels gap2 <value>] -       [labels font - times|helvetica|courier] -       [labels fontsize <value>] -       [labels fontweight normal|bold] -       [labels fontslant roman|italic] -       [labels color <color>] -       [reset] -       [load <filename>] -       [save <filename>] -       [open|close] - - Example: - $ds9 -grid - $ds9 -grid yes - $ds9 -grid type analysis - $ds9 -grid system wcs - $ds9 -grid sky fk5 - $ds9 -grid skyformat degrees - $ds9 -grid grid yes - $ds9 -grid grid color red - $ds9 -grid grid width 2 - $ds9 -grid grid dash yes - $ds9 -grid grid gap1 10 - $ds9 -grid grid gap2 10 - $ds9 -grid grid gap3 10 - $ds9 -grid axes yes - $ds9 -grid axes color red - $ds9 -grid axes width 2 - $ds9 -grid axes dash yes - $ds9 -grid axes type exterior - $ds9 -grid axes origin lll - $ds9 -grid format1 d.2 - $ds9 -grid format2 d.2 - $ds9 -grid tickmarks yes - $ds9 -grid tickmarks color red - $ds9 -grid tickmarks width 2 - $ds9 -grid tickmarks dash yes - $ds9 -grid border yes - $ds9 -grid border color red - $ds9 -grid border width 2 - $ds9 -grid border dash yes - $ds9 -grid numerics yes - $ds9 -grid numerics font courier - $ds9 -grid numerics fontsize 12 - $ds9 -grid numerics fontweight bold - $ds9 -grid numerics fontslant italic - $ds9 -grid numerics color red - $ds9 -grid numerics gap1 10 - $ds9 -grid numerics gap2 10 - $ds9 -grid numerics gap3 10 - $ds9 -grid numerics type exterior - $ds9 -grid numerics vertical yes - $ds9 -grid title yes - $ds9 -grid title text {Hello World} - $ds9 -grid title def yes - $ds9 -grid title gap 10 - $ds9 -grid title font courier - $ds9 -grid title fontsize 12 - $ds9 -grid title fontweight bold - $ds9 -grid title fontslant italic - $ds9 -grid title color red - $ds9 -grid labels yes - $ds9 -grid labels text1 {Hello World} - $ds9 -grid labels text2 {Hello World} - $ds9 -grid labels def1 yes - $ds9 -grid labels def2 yes - $ds9 -grid labels gap1 10 - $ds9 -grid labels gap2 10 - $ds9 -grid labels font courier - $ds9 -grid labels fontsize 12 - $ds9 -grid labels fontweight bold - $ds9 -grid labels fontslant italic - $ds9 -grid labels color red - $ds9 -grid reset - $ds9 -grid load foo.grd - $ds9 -grid save foo.grd - $ds9 -grid open - $ds9 -grid close - - header - Display current fits header dialog. Optional extension number - maybe specified. - Syntax: - -header [<ext>] -         [close [<ext>]] -         [save [<ext>] - <filename>] - - Example: - $ds9 -header - $ds9 -header 2 - $ds9 -header close - $ds9 -header save 1 foo.txt - - height - Set the height of the image display window. Use the geometry command to set the - overall width and height of the ds9 window. - Syntax: - -height [<value>] - - Example: - $ds9 -height 512 - - help - Display help information. To maintain backward compatibility, - -help will display a brief help message and exit. --help will - display all command line options within the built-in help - facility. - Syntax: - -help # Display brief help message and exit. - --help # Display command line options within help facility. - -? # Display command line options within help facility. - - Example: - $ds9 -help # Display brief help message and exit. - $ds9 --help # Display command line options within help facility - $ds9 -? # Display command line options within help facility. - - histequ - Select histogram equalization scale function for the current - frame. - Syntax: - -histequ - - Example: - $ds9 -histequ - - iconify - Toggles iconification. - Syntax: - -iconify [] -          [yes|no] - - Example: - $ds9 -iconify - $ds9 -iconify yes - invert - Invert Colormap. - Syntax: - -invert - - Example: - $ds9 -invert - - iis - Set IIS Filename. Optional mosaic number maybe supplied. - Syntax: - -iis [filename <filename> [#]] - - Example: - $ds9 -iis filename foo.fits - $ds9 -iis filename bar.fits 4 - jpeg - Load JPEG image into current frame. - Syntax: - -jpeg <filename> - - Example: - $ds9 -jpeg foo.jpeg - $cat foo.jpeg | ds9 -jpeg - - language - Select current language. - Syntax: - -language [locale|da|de|es|en|fr|ja|pt] - - Example: - $ds9 -language fr - - linear - Select linear scale function for the current frame. - Syntax: - -linear - - Example: - $ds9 -linear - lock - Lock all other frames to the current frame. - Syntax: - -lock [frame - <coordsys>|none] -       [crosshair - <coordsys>|none] -     [crop - <coordsys>|none] -     [slice - <coordsys>|none] -     [bin [yes|no]] -       [axes [yes|no]] -     [scale [yes|no]] -     [scalelimits [yes|no]] -     [colorbar [yes|no]] -       [block [yes|no]] -       - [smooth [yes|no]] -       [3d [yes|no]] - - Example: - $ds9 -lock frame wcs - $ds9 -lock crosshair wcs - $ds9 -lock crop wcs - $ds9 -lock slice wcs - $ds9 -lock bin yes - $ds9 -lock axes yes - $ds9 -lock scale yes - $ds9 -lock scalelimits yes - $ds9 -lock colorbar yes - $ds9 -lock block yes - $ds9 -lock smooth yes - $ds9 -lock 3d yes - - log - Select log scale function for the current frame. - - Syntax: - -log - - Example: - $ds9 -log - lower - Lower in the window stacking order. - Syntax: - -lower - - Example: - $ds9 -lower - - magnifier - Controls the magnifier settings. - Syntax: - magnifier [color <color>] -           [zoom - <value>] -           [cursor - yes|no] -           [region - yes|no] - - Example: - $ds9 -magnifier color yellow - $ds9 -magnifier zoom 2 - $ds9 -magnifier cursor no - $ds9 -magnifier region no - - mask - nomask - - Controls mask parameters. - Syntax: - -mask [color <color>] -       [mark - zero|nonzero|nan|nonnan|range] -       [range <low> <high>] -       [transparency <value>] -       [system - <coordsys>] -       [clear] -       [open|close] - -nomask - - Example: - $ds9 -mask color red - $ds9 -mask mark zero - $ds9 -mask range 10 100 - $ds9 -mask transparency 50 - $ds9 -mask system wcs - $ds9 -mask clear - $ds9 -mask open - $ds9 -mask close - $ds9 -nomask - - match - Match all other frames to the current frame. - Syntax: - -match [frame - <coordsys>] -        [crosshair - - - - - - - - - - - - - <coordsys>] -        - - - - - - - - - - - - [crop <coordsys>] -        [slice - <coordsys>] -        [bin] -        [axes] -        [scale] -        [scalelimits] -        [colorbar] -        [block] -        [smooth] -        - - - - - - - - - - - - [3d] - - Example: - $ds9 -match frame wcs - $ds9 -match crosshair wcs - $ds9 -match crop wcs - $ds9 -match slice wcs - $ds9 -match bin - $ds9 -match axes - $ds9 -match scale - $ds9 -match scalelimits - $ds9 -match colorbar - $ds9 -match block - $ds9 -match smooth - $ds9 -match 3d - - mecube - Load FITS multiple extension file as data cube. - - Syntax: - mecube <filename> - - Example: - $ds9 -mecube foo.fits - $cat foo.fits | ds9 -mecube - - minmax - This is how DS9 determines the min and max data values - from the data. SCAN will scan all data. - Syntax: - -minmax [scan|sample|datamin|irafmin] -         [mode - scan|sample|datamin|irafmin] -         [interval #] - - Example: - $ds9 -minmax scan - $ds9 -minmax mode scan - $ds9 -minmax interval 100 - - mode - Select the current mode. - Syntax: - -mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - $ds9 -mode crosshair - mosaic - Load FITS mosaic segment into current frame. - Syntax: - -mosaic [wcs|wcsa...wcsz|iraf] <filename> - - Example: - $ds9 -mosaic foo.fits - $ds9 -mosaic wcs foo.fits - $cat foo.fits | ds9 -mosaic - - $cat foo.fits | ds9 -mosaic wcs - - - mosaicimage - Load FITS mosaic image into current frame. - Syntax: - -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> - - Example: - $ds9 -mosaicimage foo.fits - $ds9 -mosaicimage wcs foo.fits - $cat foo.fits | ds9 -mosaicimage - $cat foo.fits | ds9 -mosaiimage wcs - - movie - - Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times. - Syntax: - -movie [slice|frame|3d] [mpeg|gif] <filename> - -movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - $ds9 -movie slice mpeg ds9.mpg - $ds9 -movie frame gif ds9.gif - $ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 - oscillate 1 - msg - Specify a directory of translation tables to be loaded. - Syntax: - -msg <directory> - - Example: - $ds9 -msg $HOME/msgs - multiframe - Load FITS multiple extension file as multiple images. - - Syntax: - multiframe <filename> - - Example: - $ds9 -multiframe foo.fits - $cat foo.fits | ds9 -multiframe - - - nameserver - Support Name Server functions. Coordinates are in fk5. - Syntax: - -nameserver [<object>] - [name <object>] - [server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] - [skyformat - degrees|sexagesimal] -             - - - - - - - - - - - - - - [pan] -             - - - - - - - - - - - - - - [crosshair] -             - - - - - - - - - - - - - - [open|close] - - Example: - $ds9 -nameserver m31 - $ds9 -nameserver name m31 - $ds9 -nameserver server ned-sao - $ds9 -nameserver skyformat sexagesimal - $ds9 -nameserver pan - $ds9 -nameserver crosshair - $ds9 -nameserver open - $ds9 -nameserver close - - nan - Set image not-a-number color. - Syntax: - -nan <color> - - Example: - $ds9 -nan red - nrrd - Load an NRRD (Nearly Raw Raster Data) file. - - Syntax: - -nrrd <filename> - - Example: - $ds9 -nrrd foo.nrrd - $cat foo.nrrd | xpaset ds9 -nrrd - - - nvss - Support for NRAO VLA Sky Survey. - Syntax: - -nvss [] -     [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -       [open|close] - - Example: - $ds9 -nvss - $ds9 -nvss m31 - $ds9 -nvss name m31 - $ds9 -nvss name clear - $ds9 -nvss 00:42:44.404 +41:16:08.78 - $ds9 -nvss size 60 60 arcmin - $ds9 -nvss save yes - $ds9 -nvss frame current - $ds9 -nvss update frame - $ds9 -nvss open - $ds9 -nvess close - - orient - Controls the orientation of the current frame. - Syntax: - -orient [none|x|y|xy] -         [open|close] - - Example: - $ds9 -orient xy - $ds9 -orient open - $ds9 -orient close - - pagesetup - Controls Page Setup options. - - Syntax: - -pagesetup [orient portrait|landscape] -            - [scale <numberic>] -            - [size letter|legal|tabloid|poster|a4] - - Example: - $ds9 -pagesetup orient portrait - $ds9 -pagesetup scale 50 - $ds9 -pagesetup size poster - pan - Controls the current image cursor location for the current - frame. - Syntax: - -pan [<x> <h> <coordsys> - [<skyframe>]] # relative -      [to <x> <h> - <coordsys> [<skyframe>]] # absolute -      [open|close] - - Example: - $ds9 -pan 200 200 image # pan - relative - $ds9 -pan to 400 400 physical # pan - to physical coords - $ds9 -pan to 13:29:55 47:11:50 wcs fk # - pan to wcs coords - $ds9 -pan open - $ds9 -pan close - pixeltable - Display/Hide the pixel table. - Syntax: - -pixeltable [] -             - - - - - - - - - - - - - - [yes|open] -             - [no|close] - - Example: - $ds9 -pixeltable - $ds9 -pixeltable yes - $ds9 -pixeltable open - $ds9 -pixeltable close - - plot - Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions: - xy    x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors - - To create a new plot, use the plot new command. - Syntax: - # create new empty plot window - -plot [line|bar|scatter] - - # existing plot - -plot [[<plotname>] - - - - - - - - - - - - load <filename> xy|xyex|xyey|xyexey] -       - [[<plotname>] save <filename>] -       - [[<plotname>] clear] -       - [[<plotname>] duplicate [#]] -       - [[<plotname>] stats yes|no] -       - [[<plotname>] list yes|no] - [[<plotname>] - - - - - - - - - - - - - loadconfig <filename>] - - [[<plotname>] saveconfig <filename>] -       - [[<plotname>] pagesetup orient portrait|landscape] - - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] - - [[<plotname>] print] - - [[<plotname>] print destination printer|file] - - [[<plotname>] print command <command>] - - [[<plotname>] print filename <filename>] - - [[<plotname>] print color rgb|gray] - [[<plotname>] - - - - - - - - - - - - - close] - [[<plotname>] - - - - - - - - - - - - mode pointer|zoom] - - # export image - plot [[<plotname>] - - - - - - - - - - - - export [gif|tiff|jpeg|png] <filename> -      [[<plotname>] - - - - - - - - - - - - export jpeg <filename> [1-100] -      [[<plotname>] - - - - - - - - - - - - export tiff <filename> [none|jpeg|packbits|deflate] - - # configure graph - -plot [[<plotname>] axis x|y - grid yes|no] -       - [[<plotname>] axis x|y log yes|no] -     - [[<plotname>] axis x|y flip yes|no] - - [[<plotname>] axis x|y auto yes|no] - - [[<plotname>] axis x|y min <value>] - - [[<plotname>] axis x|y max <value>] - - [[<plotname>] axis x|y format <string>] -       [[<plotname>] background - <value>] - [[<plotname>] - - - - - - - - - - - - - legend yes|no] -       - [[<plotname>] legend position right|left|top|bottom] - - [[<plotname>] font title|labels|numbers font - times|helvetica|courier] - - [[<plotname>] font title|labels|numbers - size <value>] - - [[<plotname>] font title|labels|numbers - weight normal|bold] - - [[<plotname>] font title|labels|numbers - slant roman|italic] - - [[<plotname>] title <string>] - - [[<plotname>] title x|y <string>] -       [[<plotname>] - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap] - - # configure current dataset - -plot [[<plotname>] show - yes|no] -     - [[<plotname>] shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -       - [[<plotname>] shape fill yes|no] -       - [[<plotname>] shape color <value>] -       - [[<plotname>] smooth - step|linear|cubic|quadratic|catrom] -       - [[<plotname>] color <value>] -       - [[<plotname>] width <value>] -       - [[<plotname>] dash yes|no] -       - [[<plotname>] error yes|no] -       - [[<plotname>] error color <value>] -       - [[<plotname>] error cap yes|no] -       - [[<plotname>] error width <value>] -       - [[<plotname>] name <string>] - - # select current dataset - -plot [[<plotname>] select - <value>] - - Example: - # create new empty plot window - $ds9 -plot bar - - # existing plot - $ds9 -plot load xy.dat - $ds9 -plot save foo.dat - $ds9 -plot clear - $ds9 -plot duplicate 1 - $ds9 -plot stats yes - $ds9 -plot list yes - $ds9 -plot loadconfig foo.plt - $ds9 -plot saveconfig foo.plt - $ds9 -plot pagesetup orient - portrait - $ds9 -plot pagesetup size letter - $ds9 -plot print - $ds9 -plot print destination file - $ds9 -plot print command lp - $ds9 -plot print filename foo.ps - $ds9 -plot print color rgb - $ds9 -plot close - $ds9 -plot mode pointer - - # export plot - $ds9 -plot export tiff - foo.tiff jpeg - $ds9 -plot export jpeg foo.jpeg 75 - $ds9 -plot export png foo.png - - # configure plot - $ds9 -plot axis x grid yes - $ds9 -plot axis x log yes - $ds9 -plot axis x flip yes - $ds9 -plot axis x auto no - $ds9 -plot axis x min 1 - $ds9 -plot axis x max 100 - $ds9 -plot axis x format '%f' - - $ds9 -plot background white - - $ds9 -plot legend yes - $ds9 -plot legend position left - - $ds9 -plot font numbers font times - $ds9 -plot font numbers size 12 - $ds9 -plot font numbers weight bold - $ds9 -plot font numbers slant - italic - - $ds9 -plot title 'This is a Title' - $ds9 -plot title x 'X Axis' - $ds9 -plot title y 'Y Axis' - $ds9 -plot title legend 'This is - the Legend' - - $ds9 -plot barmode aligned - - # configure current dataset - $ds9 -plot show yes - $ds9 -plot shape circle - $ds9 -plot shape fill no - $ds9 -plot shape color cyan - $ds9 -plot smooth step - $ds9 -plot color red - $ds9 -plot width 2 - $ds9 -plot dash yes - $ds9 -plot error yes - $ds9 -plot error color red - $ds9 -plot error cap yes - $ds9 -plot error width 2 - $ds9 -plot name 'My Data' - - # select current dataset - $ds9 -plot select 2 - png - Load PNG image into current frame. - - Syntax: - -png <filename> - - Example: - $ds9 png foo.png - $cat foo.png | ds9 -png - - - port - Set the IRAF port number, used by IRAF to communicate with DS9. - The default is 5137, the standard IRAF port used by ximtool. - Syntax: - -port number - - Example: - $ds9 -port 5137 - port_only - inet_only - Only use the IRAF port number. This is the same as -fifo none - -unix none. - Syntax: - -port_only - - Example: - $ds9 -port_only - - pow - Select power scale function for the current frame. - Syntax: - -pow - - Example: - $ds9 -pow - - precision - Set region and coordinate output format precision. - Syntax: - -precision <linear> <degree> - <hms> <dms> - <arcmin> <arcsec> - - Example: - $ds9 -precision 8 10 4 3 5 3 - prefs - Controls various preference settings. - Syntax: - -prefs [clear] -        [irafalign yes|no] - - Example: - $ds9 -prefs clear - $ds9 -prefs irafalign yes - - preserve - Preserve the follow attributes while loading a new image. - Syntax: - preserve [pan yes|no] -    [regions yes|no] - - Example: - $ds9 -preserve pan yes - $ds9 -preserve regions yes - - psprint - Invokes postscript printing. Please see print - for further details. - print - Controls printing. Use print option to set printing options. - - Syntax: - -print [destination printer|file] -        [command - <command>] -        [filename - <filename>] -        - - - - - - - - - - - - [color rgb|cmyk|gray] -        [level 1|2|3] -        [resolution 72|screen|96|144|150|225|300|600|1200] - - Example: - $ds9 -print - $ds9 -print destination file - $ds9 -print command lp - $ds9 -print filename foo.ps - $ds9 -print color cmyk - $ds9 -print level 2 - $ds9 -print resolution 96 - raise - Raise in the window stacking order. - Syntax: - -raise - - Example: - $ds9 -raise - - regions - Controls regions in the current frame. - Syntax: - -regions [<filename>] -        [load [all] - <filename>] -          [save - <filename>] -          [list [close]] -          [epsilon - <integer>] -          [show yes|no] -          [showtext yes|no] -          [centroid] -          [centroid auto - yes|no] -          [centroid - radius <value>|iteration <value>] -          [getinfo] -          [move front] -          [move back] -          [select all] -          [select none] -          [select invert] -          [delete all] -          [delete select] -          [format - ds9|xml|ciao|saotng|saoimage|pros|xy] -          [system - image|physical|wcs|wcsa...wcsz] -          [sky - fk4|fk5|icrs|galactic|ecliptic] -          [skyformat - degrees|sexagesimal] -          [strip yes|no] -          [shape - <shape>] -          [color - <color> -          [width - <width>] -          - [fixed|edit|rotate|delete yes|no] -          - [include|exclude|source|background] -          [command - <marker command>] -          [composite] -          [dissolve] -          [template - <filename>] -          [template - <filename> at <ra> <dec> <coordsys> - <skyframe>] -          [savetemplate - <filename>] -          [group new] -          [group - <tag> new] -          [group - <tag> update] -          [group - <tag> select] -          [group - <tag> color <color>] -          [group <tag> - copy] -          [group <tag> - delete] -          [group <tag> - cut] -          [group <tag> - font <font>] -          [group <tag> - move <int> <int>] -          [group <tag> - movefront] -          [group <tag> - moveback] -          [group <tag> - property <property> yes|no] -          [copy] -          [cut] -          [paste - image|physical|wcs|wcsa...wcsz] -          [undo] - - Example: - $ds9 -regions foo.reg - $ds9 -regions -format ciao bar.reg # load as ciao format - $ds9 -regions foo.fits # FITS regions files do not need a format - specification - $ds9 -regions load foo.reg # load foo.reg into current frame - $ds9 -regions load all foo.reg # load foo.reg into all frames - $ds9 -regions load '*.reg'# expand *.reg and load into current - frame - $ds9 -regions load all '*.reg' # expand *.reg and load into all - frames - $ds9 -regions save foo.reg - $ds9 -regions list - $ds9 -regions list close - $ds9 -regions epsilon 5 - $ds9 -regions show yes - $ds9 -regions showtext no - $ds9 -regions centroid - $ds9 -regions centroid auto yes - $ds9 -regions centroid radius 10 - $ds9 -regions centroid iteration 20 - $ds9 -regions getinfo - $ds9 -regions move back - $ds9 -regions move front - $ds9 -regions select all - $ds9 -regions select none - $ds9 -regions select invert - $ds9 -regions delete all - $ds9 -regions delete select - $ds9 -regions format ds9 - $ds9 -regions system wcs - $ds9 -regions sky fk5 - $ds9 -regions skyformat degrees - $ds9 -regions strip yes - $ds9 -regions shape ellipse - $ds9 -regions color red - $ds9 -regions width 3 - $ds9 -regions edit yes - $ds9 -regions include - $ds9 -regions command "circle 100 100 20 # color=red" - $ds9 -regions composite - $ds9 -regions dissolve - $ds9 -regions template foo.tpl - $ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 - $ds9 -regions savetemplate foo.tpl - $ds9 -regions group new - $ds9 -regions group foo new - $ds9 -regions group foo update - $ds9 -regions group foo select - $ds9 -regions group foo color red - $ds9 -regions group foo copy - $ds9 -regions group foo delete - $ds9 -regions group foo cut - $ds9 -regions group foo font {times 14 bold} - $ds9 -regions group foo move 100 100 - $ds9 -regions group foo movefront - $ds9 -regions group foo moveback - $ds9 -regions group foo property delete no - $ds9 -regions copy - $ds9 -regions cut - $ds9 -regions paste wcs - $ds9 -regions undo - - red - For RGB frames, sets the current color channel to red. - Syntax: - -red - - Example: - $ds9 -red foo.fits - - restore - Restore DS9 to a previous state from a backup save set. - Syntax: - -restore <filename> - - Example: - $ds9 -restore ds9.bck - rgb - Create RGB frame and control RGB frame parameters. - Syntax: - -rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -    [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -      [open|close] - - Example: - $ds9 -rgb # create new rgb frame - $ds9 -rgb red # set current channel to red - $ds9 -rgb channel red # set current channel to red - $ds9 -rgb view blue no # turn off blue channel - $ds9 -rgb system wcs # set rgb coordinate system - $ds9 -rgb lock wcs yes - $ds9 -rgb lock crop yes - $ds9 -rgb lock slice yes - $ds9 -rgb lock bin yes - $ds9 -rgb lock scale yes - $ds9 -rgb lock scalelimits yes - $ds9 -rgb lock colorbar yes - $ds9 -rgb lock block yes - $ds9 -rgb lock smooth yes - $ds9 -rgb open - $ds9 -rgb close - rgbarray - Load raw data array cube into rgb frame. - - Syntax: - -rgbarray + + + + +Command Line Options + + + Command Line Options + +DS9 will process each command line option, one at a time, as the +last step in the initialization process. Therefore, it is possible +to use command line options as a little script. For example, the +following command line option is used: +$ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 +First DS9 is put in tile mode, then foo.fits is loaded. +Then the colormap for foo.fits is changed to Heat +and the scale changed to zscale. Next, bar.fits +is loaded and the colormap for bar.fits is changed to +I8. +2mass +3d +about +align +analysis +array +asinh +background +backup +bin +blink +block +blue +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +dsssao +dsseso +dssstsci +envi +exit +export +fifo +fifo_only +fits +frame +geometry +gif +green +grid +header +height +help +histequ +iconify +inet_only +invert +iis +jpeg +language +linear +lock +log +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +msg +multiframe +nameserver +nan +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +port +port_only +pow +quit +raise +regions +red +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +samp +save +saveimage +scale +shm +sia +single +sinh +skyview +sleep +slice +smooth +squared +sqrt +source +tcl +threads +tiff +tile +title +unix +unix_only +update +url +version +view +visual +vla +vlss +vo +wcs +web +width +xpa +zmax +zoom +zscale +2mass +Support for 2MASS Digital Sky Survey. +Syntax: +-2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +$ds9 -2mass +$ds9 -2mass m31 +$ds9 -2mass name m31 +$ds9 -2mass name clear +$ds9 -2mass 00:42:44.404 +41:16:08.78 +$ds9 -2mass size 60 60 arcmin +$ds9 -2mass save yes +$ds9 -2mass frame current +$ds9 -2mass update frame +$ds9 -2mass survey j +$ds9 -2mass open +$ds9 -2mass close +3d +Support for 3D frame. +Syntax: +-3d [] +    [view <az> <el>] +    [az <az>] +    [el <el>] +    [scale <scale>] +    [method mip|aip] +    [background none|azimuth|elevation] +    [border yes|no] +    [border color] +    [highlite yes|no] +    [highlite color] +    [compass yes|no] +    [compass color] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -3d # create new 3D frame +$ds9 -3d view 45 30 +$ds9 -3d az 45 +$ds9 -3d el 30 +$ds9 -3d scale 10 +$ds9 -3d method mip +$ds9 -3d background azimuth +$ds9 -3d border yes +$ds9 -3d border color red +$ds9 -3d highlite yes +$ds9 -3d highlite color red +$ds9 -3d compass yes +$ds9 -3d compass color red +$ds9 -3d match +$ds9 -3d lock yes +$ds9 -3d open +$ds9 -3d close +about +Get DS9 credits. +Syntax: +-about + +Example: +$ds9 -about +align +Controls the World Coordinate System alignment for the current +frame. +Syntax: +-align [yes|no] + +Example: +$ds9 -align yes +analysis +Control external analysis tasks. Tasks are numbered as they are +loaded, starting with 0. Can also be used to display a message and +display text in the text dialog window. +Syntax: +-analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +$ds9 -analysis 0 # invoke first analysis task +$ds9 -analysis task 0 +$ds9 -analysis task foobar +$ds9 -analysis task {foo bar} +$ds9 -analysis my.ans +$ds9 -analysis load my.ans +$ds9 -analysis clear +$ds9 -analysis clear load my.ans +$ds9 -analysis message {This is a message} +$ds9 -analysis text {This is text} +array +Load raw data array into current frame. +Syntax: +-array <filename> +[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] + + +Example: +$ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] +$cat foo.arr | ds9 -array +-[dim=512,bitpix=-32,endian=little] +asinh +Select ASINH scale function for the current frame. +Syntax: +-asinh + +Example: +$ds9 -asinh +bg +background +Set image background color. +Syntax: +-bg <color> + +Example: +$ds9 -background red +$ds9 -bg red +backup +Create a backup save set. +Syntax: +-backup <filename> + +Example: +$ds9 -backup ds9.bck +bin +Controls binning factor, binning buffer size, and binning +function for binning FITS bin tables. +Syntax: +-bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<value>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -bin about 4096 4096 +$ds9 -bin about center +$ds9 -bin buffersize 512 +$ds9 -bin cols detx dety +$ds9 -bin colsz detx dety time +$ds9 -bin factor 4 +$ds9 -bin factor 4 2 +$ds9 -bin depth 10 +$ds9 -bin filter 'pha > 5' +$ds9 -bin filter clear +$ds9 -bin function sum +$ds9 -bin in +$ds9 -bin out +$ds9 -bin to fit +$ds9 -bin match +$ds9 -bin lock yes +$ds9 -bin open +$ds9 -bin close +blink +Blink mode parameters. Interval is in seconds. +Syntax: +-blink [] +    [yes|no] +    [interval <value>] + +Example: +$ds9 -blink +$ds9 -blink yes +$ds9 -blink interval 1 +block +Controls blocking parameters. +Syntax: +-block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9-block4 +$ds9-block4 2 +$ds9-blockto 4 +$ds9-blockto 4 2 +$ds9-blockin +$ds9-blockout +$ds9-blockto fit +$ds9-blockmatch +$ds9-blocklock yes +$ds9-blockopen +$ds9-blockclose +blue +For RGB frames, sets the current color channel to blue. +Syntax: +-blue + +Example: +$ds9 -blue foo.fits +catalog +cat +Support for catalogs. The first three commands will create a new +catalog search. All other commands operated on the last search +created, unless indicated otherwise. +Syntax: +-catalog [new] +    [ned|simbad|denis|skybot] +    +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] + +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> +<coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match <ref> +<ref>] +    [<ref>] [match] +    [<ref>] [match error <value> +degrees|arcmin|arcsec] +    [<ref>] [match function +1and2|1not2|2not1] +    [<ref>] [match return +1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> +<xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send +<application>] +    [<ref>] [save <filename>] +    [<ref>] +[servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>] +    [<ref>] [symbol [#] +text|size|size2|units|angle <value>] +    [<ref>] [symbol shape +circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box +point|diamond point|cross point|x point|arrow point|boxcircle +point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load +<filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +$ds9 -catalog new +$ds9 -catalog 2mass +$ds9 -catalog cds 2mass +$ds9 -catalog cds "I/252" + +$ds9 -catalog load foo.xml +$ds9 -catalog import tsv foo.tsv + +$ds9 -catalog 202.48 47.21 fk5 +$ds9 -catalog allrows +$ds9 -catalog allcols +$ds9 -catalog cancel +$ds9 -catalog clear +$ds9 -catalog close +$ds9 -catalog crosshair +$ds9 -catalog dec DEC +$ds9 -catalog edit yes +$ds9 -catalog export tsv bar.tsv +$ds9 -catalog filter'\$Jmag>15' +$ds9 -catalog filter load foo.flt +$ds9 -catalog header +$ds9 -catalog location 500 +$ds9 -catalog match error 2 arcsec +$ds9 -catalog match function 1and2 +$ds9 -catalog match unique no +$ds9 -catalog match return 1only +$ds9 -catalog match # last two catalogs loaded +$ds9 -catalog match 2mass csc +$ds9 -catalog maxrows 2000 +$ds9 -catalog name m51 +$ds9 -catalog panto no +$ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag' +$ds9 -catalog print +$ds9 -catalog psky fk5 +$ds9 -catalog psystem wcs +$ds9 -catalog ra RA +$ds9 -catalog regions +$ds9 -catalog retrieve +$ds9 -catalog samp broadcast +$ds9 -catalog samp send aladin +$ds9 -catalog save foo.xml +$ds9 -catalog server sao +$ds9 -catalog show yes +$ds9 -catalog radius 1 degrees +$ds9 -catalog symbol condition '\$Jmag>15' +$ds9 -catalog symbol 2 shape "boxcircle point" +$ds9 -catalog symbol color red +$ds9 -catalog symbol font times +$ds9 -catalog symbol fontsize 14 +$ds9 -catalog symbol fontweight bold +$ds9 -catalog symbol fontslant italic +$ds9 -catalog symbol add +$ds9 -catalog symbol 2 remove +$ds9 -catalog symbol load foo.sym +$ds9 -catalog symbol save bar.sym +$ds9 -catalog sky fk5 +$ds9 -catalog skyformat degrees +$ds9 -catalog sort "Jmag" incr +$ds9 -catalog system wcs +$ds9 -catalog update +$ds9 -catalog x RA +$ds9 -catalog y DEC +cd +Sets the current working directory. +Syntax: +cd [<directory>] + +Example: +$ds9 -cd /home/mrbill +cmap +Controls the colormap for the current frame. The colormap name +is not case sensitive. A valid contrast value is from 0 to 10 +and bias value from 0 to 1. +Syntax: +-cmap [<colormap>] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<contrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +$ds9 -cmap Heat +$ds9 -cmap load foo.sao +$ds9 -cmap save bar.sao +$ds9 -cmap invert yes +$ds9 -cmap 5 .5 +$ds9 -cmap tag load foo.tag +$ds9 -cmap tag save foo.tag +$ds9 -cmap tag delete +$ds9 -cmap open +$ds9 -cmap close +colorbar +Controls colorbar parameters. +Syntax: +-colorbar [] +    [yes|no] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] + +Example: +$ds9 -colorbar yes +$ds9 -colorbar vertical +$ds9 -colorbar numerics yes +$ds9 -colorbar space value +$ds9 -colorbar font times +$ds9 -colorbar fontsize 14 +$ds9 -colorbar fontweight bold +$ds9 -colorbar fontslant italic +$ds9 -colorbar size 20 +$ds9 -colorbar ticks 11 +$ds9 -colorbar match +$ds9 -colorbar lock yes +console +Display tcl console window. +Syntax: +-console + +Example: +$ds9 -console +contour +Controls contours in the current frame. +Syntax: +-contour [] +    [yes|no] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> +<skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> +<width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale +linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +$ds9 -contour +$ds9 -contour yes +$ds9 -contour generate +$ds9 -contour clear +$ds9 -contour load ds9.ctr +$ds9 -contour save ds9.ctr +$ds9 -contour save ds9.ctr wcs fk5 +$ds9 -contour convert +$ds9 -contour load levels ds9.ctr +$ds9 -contour save levels ds9.lev +$ds9 -contour copy +$ds9 -contour paste +$ds9 -contour paste wcs red 2 no +$ds9 -contour color yellow +$ds9 -contour width 2 +$ds9 -contour dash yes +$ds9 -contour smooth 5 +$ds9 -contour method smooth +$ds9 -contour nlevels 10 +$ds9 -contour scale sqrt +$ds9 -contour log exp 1000 +$ds9 -contour mode zscale +$ds9 -contour scope local +$ds9 -contour limits 1 100 +$ds9 -contour levels 1 10 100 1000 +$ds9 -contour open +$ds9 -contour close +crop +Set current image display area. +Syntax: +-crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3d zmin zmax <coordsys>] +    [open|close] + +Example: +$ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords +$ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 +22.000204 wcs galactic arcsec +$ds9 foo.fits -crop match wcs +$ds9 foo.fits -crop lock wcs +$ds9 foo.fits -crop reset +$ds9 foo.fits -crop 3d .25 .5 wcs +$ds9 foo.fits -crop open +$ds9 foo.fits -crop close +crosshair +Controls the current position of the crosshair in the current +frame. DS9 is placed in crosshair mode when the crosshair is +set. +Syntax: +-crosshair [<x> <h> <coordsys> +[<skyframe>]] +   [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$ds9 -crosshair 100 100 physical # set crosshair in physical +$ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords +$ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 +$ds9 -crosshair match +$ds9 -crosshair lock wcs +cube +Controls FITS cube. +Syntax: +-cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +$ds9 -cube +$ds9 -cube play +$ds9 -cube last +$ds9 -cube 3 +$ds9 -cube 4.5 wcs +$ds9 -cube interval 2 +$ds9 -cube match wcs +$ds9 -cube lock wcs +$ds9 -cube order 123 +$ds9 -cube axes lock yes +$ds9 -cube open +$ds9 -cube close +cursor +Move mouse pointer or crosshair in image pixels in the current +frame. Note, this will move selected Regions also. +Syntax: +-cursor [<x> <h>] + +Example: +$ds9 -cursor 10 10 +dsssao +dss +Support for Digital Sky Survey at SAO. +Syntax: +-dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -dsssao +$ds9 -dsssao m31 +$ds9 -dsssao name m31 +$ds9 -dsssao name clear +$ds9 -dsssao 00:42:44.404 +41:16:08.78 +$ds9 -dsssao size 60 60 arcmin +$ds9 -dsssao save yes +$ds9 -dsssao frame current +$ds9 -dsssao update frame +$ds9 -dsssao open +$ds9 -dsssao close +dsseso +Support for Digital Sky Survey at ESO. +Syntax: +-dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +$ds9 -dsseso +$ds9 -dsseso m31 +$ds9 -dsseso name m31 +$ds9 -dsseso name clear +$ds9 -dsseso 00:42:44.404 +41:16:08.78 +$ds9 -dsseso size 60 60 arcmin +$ds9 -dsseso save yes +$ds9 -dsseso frame current +$ds9 -dsseso update frame +$ds9 -dsseso survey DSS2-red +$ds9 -dsseso open +$ds9 -dsseso close +dssstsci +Support for Digital Sky Survey at STSCI. +Syntax: +-dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +$ds9 -dssstsci +$ds9 -dssstsci m31 +$ds9 -dssstsci name m31 +$ds9 -dssstsci name clear +$ds9 -dssstsci 00:42:44.404 +41:16:08.78 +$ds9 -dssstsci size 60 60 arcmin +$ds9 -dssstsci save yes +$ds9 -dssstsci frame current +$ds9 -dssstsci update frame +$ds9 -dssstsci survey all +$ds9 -dssstsci open +$ds9 -dssstsci close +envi +Load an ENVI header and file. Optional parameter: array +endian. +Syntax: +-envi <header> [<filename>] + +Example: +$ds9 -envi foo.hdr +$ds9 -envi foo.hdr foo.bsq +exit +quit +Quits DS9. +Syntax: +-exit +-quit + +Example: +$ds9 -exit +export +Export loaded image data of current frame in specified image +format, at native resolution, using current colormap and +contrast/bias settings. NOTE: not scaling, rotation, or translation +is applied. If no format specified, the file name extension is used +to determine the output format. Optional parameters: jpeg quality +(1-100) and tiff compression method. +Syntax: +-export [array|nrrd|envi|gif|tiff|jpeg|png] <filename> +-export array <filename>[big|little|native] +-export nrrd <filename>[big|little|native] +-export envi <header> +[<filename>][big|little|native] +-export <filename>.jpeg [1-100] +-export <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$ds9 -export array foo.arr little +$ds9 -export nrrd foo.nrrd little +$ds9 -export envi foo.hdr little +$ds9 -export envi foo.hdr foo.bsq little +$ds9 -export tiff foo.tiff jpeg +$ds9 -export jpeg foo.jpeg 75 +$ds9 -export png foo.png +fifo +Set the name of the IRAF input and output fifos. The default is +/dev/imt1. These fifos are used by IRAF to communicate with +DS9. +Syntax: +-fifo name + +Example: +$ds9 -fifo /dev/imt1 +fifo_only +Only use IRAF input and output fifos. Same as -port 0 -unix +none. +Syntax: +-fifo_only + +Example: +$ds9 -fifo_only +fits +Load a FITS image into the current frame. +Syntax: +-fits<filename> + +Example: +$ds9 -fits foo.fits +$ds9 -fits bar.fits[bin=detx,dety] +$cat foo.fits | ds9 -fits - +$cat bar.fits | ds9 -fits -[bin=detx,dety] +frame +Controls frame functions. Frames may be created, deleted, reset, +and centered. While return the current frame number. If you goto a +frame that does not exists, it will be created. If the frame is +hidden, it will be shown. The 'frameno' option is available for +backward compatibility. +Syntax: +-frame [center [#|all]] +    [clear [#|all]] +    [new [rgb]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$ds9 -frame center # center current frame +$ds9 -frame center 1 # center 'Frame1' +$ds9 -frame center all # center all frames +$ds9 -frame clear # clear current frame +$ds9 -frame new # create new frame +$ds9 -frame new rgb # create new rgb frame +$ds9 -frame delete # delete current frame +$ds9 -frame reset # reset current frame +$ds9 -frame refresh # refresh current frame +$ds9 -frame hide # hide current frame +$ds9 -frame show 1 # show frame 'Frame1' +$ds9 -frame move first # move frame to first in order +$ds9 -frame move back # move frame back in order +$ds9 -frame move forward # move frame forward in order +$ds9 -frame move last # move frame to last in order +$ds9 -frame first # goto first frame +$ds9 -frame prev # goto prev frame +$ds9 -frame next # goto next frame +$ds9 -frame last # goto last frame +$ds9 -frame frameno 4 # goto frame 'Frame4', create if needed +$ds9 -frame 3 # goto frame 'Frame3', create if needed +$ds9 -frame lock wcs +gif +Load GIF image into current frame. +Syntax: +-gif <filename> + +Example: +$ds9 -gif foo.gif +$cat foo.gif | ds9 -gif - +geometry +Define the initial window geometry. This includes all of the ds9 +window, not just the image space. see X(1). +Syntax: +-geometry value + +Example: +$ds9 -geometry 640x480 +green +For RGB frames, sets the current color channel to green. +Syntax: +-green + +Example: +$ds9 -green foo.fits +grid +Controls coordinate grid. For grid numeric format syntax, +click here. +Syntax: +-grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin +lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +$ds9 -grid +$ds9 -grid yes +$ds9 -grid type analysis +$ds9 -grid system wcs +$ds9 -grid sky fk5 +$ds9 -grid skyformat degrees +$ds9 -grid grid yes +$ds9 -grid grid color red +$ds9 -grid grid width 2 +$ds9 -grid grid dash yes +$ds9 -grid grid gap1 10 +$ds9 -grid grid gap2 10 +$ds9 -grid grid gap3 10 +$ds9 -grid axes yes +$ds9 -grid axes color red +$ds9 -grid axes width 2 +$ds9 -grid axes dash yes +$ds9 -grid axes type exterior +$ds9 -grid axes origin lll +$ds9 -grid format1 d.2 +$ds9 -grid format2 d.2 +$ds9 -grid tickmarks yes +$ds9 -grid tickmarks color red +$ds9 -grid tickmarks width 2 +$ds9 -grid tickmarks dash yes +$ds9 -grid border yes +$ds9 -grid border color red +$ds9 -grid border width 2 +$ds9 -grid border dash yes +$ds9 -grid numerics yes +$ds9 -grid numerics font courier +$ds9 -grid numerics fontsize 12 +$ds9 -grid numerics fontweight bold +$ds9 -grid numerics fontslant italic +$ds9 -grid numerics color red +$ds9 -grid numerics gap1 10 +$ds9 -grid numerics gap2 10 +$ds9 -grid numerics gap3 10 +$ds9 -grid numerics type exterior +$ds9 -grid numerics vertical yes +$ds9 -grid title yes +$ds9 -grid title text {Hello World} +$ds9 -grid title def yes +$ds9 -grid title gap 10 +$ds9 -grid title font courier +$ds9 -grid title fontsize 12 +$ds9 -grid title fontweight bold +$ds9 -grid title fontslant italic +$ds9 -grid title color red +$ds9 -grid labels yes +$ds9 -grid labels text1 {Hello World} +$ds9 -grid labels text2 {Hello World} +$ds9 -grid labels def1 yes +$ds9 -grid labels def2 yes +$ds9 -grid labels gap1 10 +$ds9 -grid labels gap2 10 +$ds9 -grid labels font courier +$ds9 -grid labels fontsize 12 +$ds9 -grid labels fontweight bold +$ds9 -grid labels fontslant italic +$ds9 -grid labels color red +$ds9 -grid reset +$ds9 -grid load foo.grd +$ds9 -grid save foo.grd +$ds9 -grid open +$ds9 -grid close +header +Display current fits header dialog. Optional extension number +maybe specified. +Syntax: +-header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +$ds9 -header +$ds9 -header 2 +$ds9 -header close +$ds9 -header save 1 foo.txt +height +Set the height of the image display window. Use the geometry command to set the overall +width and height of the ds9 window. +Syntax: +-height [<value>] + +Example: +$ds9 -height 512 +help +Display help information. To maintain backward compatibility, +-help will display a brief help message and exit. --help will +display all command line options within the built-in help +facility. +Syntax: +-help # Display brief help message and exit. +--help # Display command line options within help facility. +-? # Display command line options within help facility. + +Example: +$ds9 -help # Display brief help message and exit. +$ds9 --help # Display command line options within help facility +$ds9 -? # Display command line options within help +facility. +histequ +Select histogram equalization scale function for the current +frame. +Syntax: +-histequ + +Example: +$ds9 -histequ +iconify +Toggles iconification. +Syntax: +-iconify [] +    [yes|no] + +Example: +$ds9 -iconify +$ds9 -iconify yes +invert +Invert Colormap. +Syntax: +-invert + +Example: +$ds9 -invert +iis +Set IIS Filename. Optional mosaic number maybe supplied. +Syntax: +-iis [filename <filename> [#]] + +Example: +$ds9 -iis filename foo.fits +$ds9 -iis filename bar.fits 4 +jpeg +Load JPEG image into current frame. +Syntax: +-jpeg <filename> + +Example: +$ds9 -jpeg foo.jpeg +$cat foo.jpeg | ds9 -jpeg - +language +Select current language. +Syntax: +-language [locale|da|de|es|en|fr|ja|pt] + +Example: +$ds9 -language fr +linear +Select linear scale function for the current frame. +Syntax: +-linear + +Example: +$ds9 -linear +lock +Lock all other frames to the current frame. +Syntax: +-lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimits [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +$ds9 -lock frame wcs +$ds9 -lock crosshair wcs +$ds9 -lock crop wcs +$ds9 -lock slice wcs +$ds9 -lock bin yes +$ds9 -lock axes yes +$ds9 -lock scale yes +$ds9 -lock scalelimits yes +$ds9 -lock colorbar yes +$ds9 -lock block yes +$ds9 -lock smooth yes +$ds9 -lock 3d yes + log +Select log scale function for the current frame. +Syntax: +-log + +Example: +$ds9 -log +lower +Lower in the window stacking order. +Syntax: +-lower + +Example: +$ds9 -lower +magnifier +Controls the magnifier settings. +Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +$ds9 -magnifier color yellow +$ds9 -magnifier zoom 2 +$ds9 -magnifier cursor no +$ds9 -magnifier region no +mask +nomask +Controls mask parameters. +Syntax: +-mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] +-nomask + +Example: +$ds9 -mask color red +$ds9 -mask mark zero +$ds9 -mask range 10 100 +$ds9 -mask transparency 50 +$ds9 -mask system wcs +$ds9 -mask clear +$ds9 -mask open +$ds9 -mask close +$ds9 -nomask +match +Match all other frames to the current frame. +Syntax: +-match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +$ds9 -match frame wcs +$ds9 -match crosshair wcs +$ds9 -match crop wcs +$ds9 -match slice wcs +$ds9 -match bin +$ds9 -match axes +$ds9 -match scale +$ds9 -match scalelimits +$ds9 -match colorbar +$ds9 -match block +$ds9 -match smooth +$ds9 -match 3d + mecube +Load FITS multiple extension file as data cube. +Syntax: +mecube <filename> + +Example: +$ds9 -mecube foo.fits +$cat foo.fits | ds9 -mecube - +minmax +This is how DS9 determines the min and max data values +from the data. SCAN will scan all data. +Syntax: +-minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +$ds9 -minmax scan +$ds9 -minmax mode scan +$ds9 -minmax interval 100 +mode +Select the current mode. +Syntax: +-mode +[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + +Example: +$ds9 -mode crosshair +mosaic +Load FITS mosaic segment into current frame. +Syntax: +-mosaic [wcs|wcsa...wcsz|iraf] <filename> + +Example: +$ds9 -mosaic foo.fits +$ds9 -mosaic wcs foo.fits +$cat foo.fits | ds9 -mosaic - +$cat foo.fits | ds9 -mosaic wcs - +mosaicimage +Load FITS mosaic image into current frame. +Syntax: +-mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> + +Example: +$ds9 -mosaicimage foo.fits +$ds9 -mosaicimage wcs foo.fits +$cat foo.fits | ds9 -mosaicimage +$cat foo.fits | ds9 -mosaiimage wcs +movie +Create a movie from snap shots of the DS9 window. A +slice movie cycles though all slices of a cube. A +frame movie cycles through all active frames. A +3d movie cycles through specified viewing angles. The +default action is slice. Movie types are either +MPEG or Animated GIF, with default MPEG. +Optional parameters for 3d: number of frames, azimuth +from/to, elevation from/to, slice from/to, oscillate/repeat +times. +Syntax: +-movie [slice|frame|3d] [mpeg|gif] <filename> +-movie 3d [mpeg|gif] <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>] + +Example: +$ds9 -movie slice mpeg ds9.mpg +$ds9 -movie frame gif ds9.gif +$ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate +1 +msg +Specify a directory of translation tables to be loaded. +Syntax: +-msg <directory> + +Example: +$ds9 -msg $HOME/msgs +multiframe +Load FITS multiple extension file as multiple images. +Syntax: +multiframe <filename> + +Example: +$ds9 -multiframe foo.fits +$cat foo.fits | ds9 -multiframe - +nameserver +Support Name Server functions. Coordinates are in fk5. +Syntax: +-nameserver [<object>] +    [name <object>] +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [open|close] + +Example: +$ds9 -nameserver m31 +$ds9 -nameserver name m31 +$ds9 -nameserver server ned-sao +$ds9 -nameserver skyformat sexagesimal +$ds9 -nameserver pan +$ds9 -nameserver crosshair +$ds9 -nameserver open +$ds9 -nameserver close +nan +Set image not-a-number color. +Syntax: +-nan <color> + +Example: +$ds9 -nan red +nrrd +Load an NRRD (Nearly Raw Raster Data) file. +Syntax: +-nrrd <filename> + +Example: +$ds9 -nrrd foo.nrrd +$cat foo.nrrd | xpaset ds9 -nrrd- +nvss +Support for NRAO VLA Sky Survey. +Syntax: +-nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -nvss +$ds9 -nvss m31 +$ds9 -nvss name m31 +$ds9 -nvss name clear +$ds9 -nvss 00:42:44.404 +41:16:08.78 +$ds9 -nvss size 60 60 arcmin +$ds9 -nvss save yes +$ds9 -nvss frame current +$ds9 -nvss update frame +$ds9 -nvss open +$ds9 -nvess close +orient +Controls the orientation of the current frame. +Syntax: +-orient [none|x|y|xy] +    [open|close] + +Example: +$ds9 -orient xy +$ds9 -orient open +$ds9 -orient close +pagesetup +Controls Page Setup options. +Syntax: +-pagesetup [orient portrait|landscape] +    [scale <numberic>] +    [size letter|legal|tabloid|poster|a4] + +Example: +$ds9 -pagesetup orient portrait +$ds9 -pagesetup scale 50 +$ds9 -pagesetup size poster +pan +Controls the current image cursor location for the current +frame. +Syntax: +-pan [<x> <h> <coordsys> [<skyframe>]] # +relative +    [to <x> <h> <coordsys> +[<skyframe>]] # absolute +    [open|close] + +Example: +$ds9 -pan 200 200 image# pan relative +$ds9 -pan to 400 400 physical# pan to physical coords +$ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords +$ds9 -pan open +$ds9 -pan close +pixeltable +Display/Hide the pixel table. +Syntax: +-pixeltable [] +    [yes|open] +    [no|close] + +Example: +$ds9 -pixeltable +$ds9 -pixeltable yes +$ds9 -pixeltable open +$ds9 -pixeltable close +plot +Display and configure data plots. All plot commands take an +optional second command, the plot name. If no plot name is +specified, the last plot created is assumed. Plot data is assumed +to be a pair of coordinates, with optional error values. The follow +are valid data descriptions: +xy    x and y +coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y +errors +To create a new plot, use the plot new command. +Syntax: +# create new empty plot window +-plot [line|bar|scatter] + +# existing plot +-plot[[<plotname>] load <filename> +xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig +<filename>] +    [[<plotname>] saveconfig +<filename>] +    [[<plotname>] pagesetup orient +portrait|landscape] +    [[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination +printer|file] +    [[<plotname>] print command +<command>] +    [[<plotname>] print filename +<filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> + +    [[<plotname>]export jpeg +<filename>[1-100] +    [[<plotname>]export tiff +<filename>[none|jpeg|packbits|deflate] + +# configure graph +-plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min +<value>] +    [[<plotname>] axis x|y max +<value>] +    [[<plotname>] axis x|y format +<string>] +    [[<plotname>] background +<value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position +right|left|top|bottom] +    [[<plotname>] font title|labels|numbers +font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize +<value>] +    [[<plotname>] +fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] +fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y +<string>] +    [[<plotname>] barmode +normal|stacked|aligned|overlap] + +# configure current dataset +-plot [[<plotname>] show yes|no] +   [[<plotname>] shape +none|circle|square|diamond|plus|splus|scross|triangle|arrow] +   [[<plotname>] shape fill yes|no] +   [[<plotname>] shape color +<value>] +   [[<plotname>] smooth +step|linear|cubic|quadratic|catrom] +   [[<plotname>] color <value>] +   [[<plotname>] width <value>] +   [[<plotname>] dash yes|no] +   [[<plotname>] error yes|no] +   [[<plotname>] error color +<value>] +   [[<plotname>] error cap yes|no] +   [[<plotname>] error width +<value>] +   [[<plotname>] name <string>] + +# select current dataset +-plot [[<plotname>] select <value>] + +Example: +# create new empty plot window +$ds9 -plot bar + +# existing plot +$ds9 -plot load xy.dat +$ds9 -plot save foo.dat +$ds9 -plot clear +$ds9 -plot duplicate 1 +$ds9 -plot stats yes +$ds9 -plot list yes +$ds9 -plot loadconfig foo.plt +$ds9 -plot saveconfig foo.plt +$ds9 -plot pagesetup orient portrait +$ds9 -plot pagesetup size letter +$ds9 -plot print +$ds9 -plot print destination file +$ds9 -plot print command lp +$ds9 -plot print filename foo.ps +$ds9 -plot print color rgb +$ds9 -plot close +$ds9 -plot mode pointer + +# export plot +$ds9 -plot export tiff foo.tiff jpeg +$ds9 -plot export jpeg foo.jpeg 75 +$ds9 -plot export png foo.png + +# configure plot +$ds9 -plot axis x grid yes +$ds9 -plot axis x log yes +$ds9 -plot axis x flip yes +$ds9 -plot axis x auto no +$ds9 -plot axis x min 1 +$ds9 -plot axis x max 100 +$ds9 -plot axis x format '%f' + +$ds9 -plot background white + +$ds9 -plot legend yes +$ds9 -plot legend position left + +$ds9 -plot font numbers font times +$ds9 -plot font numbers size 12 +$ds9 -plot font numbers weight bold +$ds9 -plot font numbers slant italic + +$ds9 -plot title 'This is a Title' +$ds9 -plot title x 'X Axis' +$ds9 -plot title y 'Y Axis' +$ds9 -plot title legend 'This is the Legend' + +$ds9 -plot barmode aligned + +# configure current dataset +$ds9 -plot show yes +$ds9 -plot shape circle +$ds9 -plot shape fill no +$ds9 -plot shape color cyan +$ds9 -plot smooth step +$ds9 -plot color red +$ds9 -plot width 2 +$ds9 -plot dash yes +$ds9 -plot error yes +$ds9 -plot error color red +$ds9 -plot error cap yes +$ds9 -plot error width 2 +$ds9 -plot name 'My Data' + +# select current dataset +$ds9 -plot select 2 +png +Load PNG image into current frame. +Syntax: +-png <filename> + +Example: +$ds9 png foo.png +$cat foo.png | ds9 -png - +port +Set the IRAF port number, used by IRAF to communicate with DS9. +The default is 5137, the standard IRAF port used by +ximtool. +Syntax: +-port number + +Example: +$ds9 -port 5137 +port_only +inet_only +Only use the IRAF port number. This is the same as -fifo none +-unix none. +Syntax: +-port_only + +Example: +$ds9 -port_only +pow +Select power scale function for the current frame. +Syntax: +-pow + +Example: +$ds9 -pow +precision +Set region and coordinate output format precision. +Syntax: +-precision +<linear><degree><hms><dms><arcmin><arcsec> + + +Example: +$ds9 -precision 8 10 4 3 5 3 +prefs +Controls various preference settings. +Syntax: +-prefs [clear] +    [irafalign yes|no] + +Example: +$ds9 -prefs clear +$ds9 -prefs irafalign yes +preserve +Preserve the follow attributes while loading a new image. +Syntax: +preserve [pan yes|no] +    [regions yes|no] + +Example: +$ds9 -preserve pan yes +$ds9 -preserve regions yes +psprint +Invokes postscript printing. Please see print +for further details. +print +Controls printing. Use print option to set printing +options. +Syntax: +-print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    +[resolution72|screen|96|144|150|225|300|600|1200] + +Example: +$ds9 -print +$ds9 -print destination file +$ds9 -print command lp +$ds9 -print filename foo.ps +$ds9 -print color cmyk +$ds9 -print level 2 +$ds9 -print resolution 96 +raise +Raise in the window stacking order. +Syntax: +-raise + +Example: +$ds9 -raise +regions +Controls regions in the current frame. +Syntax: +-regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration +<value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format +ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color <color> +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> +<dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color <color>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> +<int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> +yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] + +Example: +$ds9 -regions foo.reg +$ds9 -regions -format ciao bar.reg # load as ciao format +$ds9 -regions foo.fits # FITS regions files do not need a format +specification +$ds9 -regions load foo.reg # load foo.reg into current frame +$ds9 -regions load all foo.reg # load foo.reg into all frames +$ds9 -regions load '*.reg'# expand *.reg and load into current +frame +$ds9 -regions load all '*.reg' # expand *.reg and load into all +frames +$ds9 -regions save foo.reg +$ds9 -regions list +$ds9 -regions list close +$ds9 -regions epsilon 5 +$ds9 -regions show yes +$ds9 -regions showtext no +$ds9 -regions centroid +$ds9 -regions centroid auto yes +$ds9 -regions centroid radius 10 +$ds9 -regions centroid iteration 20 +$ds9 -regions getinfo +$ds9 -regions move back +$ds9 -regions move front +$ds9 -regions select all +$ds9 -regions select none +$ds9 -regions select invert +$ds9 -regions delete all +$ds9 -regions delete select +$ds9 -regions format ds9 +$ds9 -regions system wcs +$ds9 -regions sky fk5 +$ds9 -regions skyformat degrees +$ds9 -regions strip yes +$ds9 -regions shape ellipse +$ds9 -regions color red +$ds9 -regions width 3 +$ds9 -regions edit yes +$ds9 -regions include +$ds9 -regions command "circle 100 100 20 # color=red" +$ds9 -regions composite +$ds9 -regions dissolve +$ds9 -regions template foo.tpl +$ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 +$ds9 -regions savetemplate foo.tpl +$ds9 -regions group new +$ds9 -regions group foo new +$ds9 -regions group foo update +$ds9 -regions group foo select +$ds9 -regions group foo color red +$ds9 -regions group foo copy +$ds9 -regions group foo delete +$ds9 -regions group foo cut +$ds9 -regions group foo font {times 14 bold} +$ds9 -regions group foo move 100 100 +$ds9 -regions group foo movefront +$ds9 -regions group foo moveback +$ds9 -regions group foo property delete no +$ds9 -regions copy +$ds9 -regions cut +$ds9 -regions paste wcs +$ds9 -regions undo +red +For RGB frames, sets the current color channel to red. +Syntax: +-red + +Example: +$ds9 -red foo.fits +restore +Restore DS9 to a previous state from a backup save set. +Syntax: +-restore <filename> + +Example: +$ds9 -restore ds9.bck +rgb +Create RGB frame and control RGB frame parameters. +Syntax: +-rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +    [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock +wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth +[yes|no]] +    [open|close] + +Example: +$ds9 -rgb # create new rgb frame +$ds9 -rgb red # set current channel to red +$ds9 -rgb channel red # set current channel to red +$ds9 -rgb view blue no # turn off blue channel +$ds9 -rgb system wcs # set rgb coordinate system +$ds9 -rgb lock wcs yes +$ds9 -rgb lock crop yes +$ds9 -rgb lock slice yes +$ds9 -rgb lock bin yes +$ds9 -rgb lock scale yes +$ds9 -rgb lock scalelimits yes +$ds9 -rgb lock colorbar yes +$ds9 -rgb lock block yes +$ds9 -rgb lock smooth yes +$ds9 -rgb open +$ds9 -rgb close +rgbarray +Load raw data array cube into rgb frame. +Syntax: +-rgbarray <filename>[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - $cat foo.arr | ds9 -rgbarray - -[dim=512,zdim=3,bitpix=-32,endian=little] - rgbcube - Load FITS rgbcube into rgb frame. - - Syntax: - -rgbcube <filename> - - Example: - $ds9 -rgbcube foo.fits - $cat foo.fits | ds9 -rgbcube - - rgbimage - Load FITS rgbimage into rgb frame. - - Syntax: - -rgbimage <filename> - - Example: - $ds9 -rgbimage foo.fits - $cat foo.fits | ds9 -rgbimage - - rotate - Controls the rotation angle (in degrees) of the current - frame.< - Syntax: - -rotate [<value>] -         [to <value>] -         [open|close] - - Example: - $ds9 -rotate 45 - $ds9 -rotate to 30 - $ds9 -rotate open - $ds9 -rotate close - - samp - Configure SAMP protocol. - Syntax: - -samp [yes|no|connect|disconnect] -       [broadcast [image|table]] -       [send [image|table] - <application>] - - Example: - $ds9 -samp yes - $ds9 -samp connect - $ds9 -samp broadcast image - $ds9 -samp send image aladin - save - - Save loaded image data of current frame as FITS. - Syntax: - -save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> - - - - - - - - - - - - - [image|table|slice] - - Example: - $ds9 -save foo.fits - $ds9 -save fits foo.fits image - $ds9 -save fits foo.fits table - $ds9 -save fits foo.fits slice - $ds9 -save rgbimage foo.fits - $ds9 -save rgbcube foo.fits - $ds9 -save mecube foo.fits - $ds9 -save mosaic foo.fits - $ds9 -save mosaicimage foo.fits - saveimage - Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method. - Syntax: - -saveimage [fits|eps|gif|tiff|jpeg|png] <filename> - -saveimage <filename>.jpeg [1-100] - -saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - $ds9 -saveimage ds9.tiff - $ds9 -saveimage jpeg ds9.jpeg 75 - - scale - Controls the limits and color scale distribution. - Syntax: - -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -    [log exp <value>] -        [datasec yes|no] -        [limits <minvalue> - <maxvalue>] -        [mode - minmax|<value>|zscale|zmax] -        [scope local|global] -        [match] -        [match limits] -        [lock [yes|no]] -        [lock limits [yes|no]] -        [open|close] - - Example: - $ds9 -scale linear - $ds9 -scale log exp 100 - $ds9 -scale datasec yes - $ds9 -scale histequ - $ds9 -scale limits 1 100 - $ds9 -scale mode zscale - $ds9 -scale mode 99.5 - $ds9 -scale scope local - $ds9 -scale match - $ds9 -scale match limits - $ds9 -scale lock yes - $ds9 -scale lock limits yes - $ds9 -scale open - $ds9 -scale close - - shm - Load a shared memory segment into the current frame. - Syntax: - -shm [<key> [<filename>]] -      [key <id> [<filename>]] -      [shmid <id> [<filename>]] -      [fits [key|shmid] <id> - [<filename>]] -      [mosaicimage - [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> - [<filename>]] -      [mosaic [iraf|wcs|wcsa...wcsz] - [key|shmid] <id> [<filename>]] -      [rgbcube [key|shmid] <id> - [<filename>]] -      [rgbimage [key|shmid] <id> - [<filename>]] -      [rgbarray [key|shmid] <id> + +Example: +$ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +$cat foo.arr | ds9 -rgbarray +-[dim=512,zdim=3,bitpix=-32,endian=little] +rgbcube +Load FITS rgbcube into rgb frame. +Syntax: +-rgbcube <filename> + +Example: +$ds9 -rgbcube foo.fits +$cat foo.fits | ds9 -rgbcube - +rgbimage +Load FITS rgbimage into rgb frame. +Syntax: +-rgbimage <filename> + +Example: +$ds9 -rgbimage foo.fits +$cat foo.fits | ds9 -rgbimage - +rotate +Controls the rotation angle (in degrees) of the current +frame.< +Syntax: +-rotate [<value>] +    [to <value>] +    [open|close] + +Example: +$ds9 -rotate 45 +$ds9 -rotate to 30 +$ds9 -rotate open +$ds9 -rotate close +samp +Configure SAMP protocol. +Syntax: +-samp [yes|no|connect|disconnect] +    [broadcast [image|table]] +    [send [image|table] <application>] + +Example: +$ds9 -samp yes +$ds9 -samp connect +$ds9 -samp broadcast image +$ds9 -samp send image aladin +save +Save loaded image data of current frame as FITS. +Syntax: +-save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice] + +Example: +$ds9 -save foo.fits +$ds9 -save fits foo.fits image +$ds9 -save fits foo.fits table +$ds9 -save fits foo.fits slice +$ds9 -save rgbimage foo.fits +$ds9 -save rgbcube foo.fits +$ds9 -save mecube foo.fits +$ds9 -save mosaic foo.fits +$ds9 -save mosaicimage foo.fits +saveimage +Create a snap shot of the current DS9 window and save in +specified image format. If no format specified, the file name +extension is used to determine the output format. Optional +parameters: jpeg quality (1-100) and tiff +compression method. +Syntax: +-saveimage[fits|eps|gif|tiff|jpeg|png]<filename> +-saveimage <filename>.jpeg [1-100] +-saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$ds9 -saveimage ds9.tiff +$ds9 -saveimage jpeg ds9.jpeg 75 +scale +Controls the limits and color scale distribution. +Syntax: +-scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +$ds9 -scale linear +$ds9 -scale log exp 100 +$ds9 -scale datasec yes +$ds9 -scale histequ +$ds9 -scale limits 1 100 +$ds9 -scale mode zscale +$ds9 -scale mode 99.5 +$ds9 -scale scope local +$ds9 -scale match +$ds9 -scale match limits +$ds9 -scale lock yes +$ds9 -scale lock limits yes +$ds9 -scale open +$ds9 -scale close +shm +Load a shared memory segment into the current frame. +Syntax: +-shm [<key> [<filename>]] +    [key <id> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> +[<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] +[key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] +<id> [<filename>]] +    [rgbcube [key|shmid] <id> +[<filename>]] +    [rgbimage [key|shmid] <id> +[<filename>]] +    [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -      [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - $ds9 -shm 102 - $ds9 -shm key 102 - $ds9 -shm shmid 102 foo - $ds9 -shm fits 100 foo - $ds9 -shm mosaicimage iraf key 100 foo - $ds9 -shm mosaicimage wcs key 100 foo - $ds9 -shm mosaicimage wcsa key 100 foo - $ds9 -shm mosaicimage wfpc2 key 100 foo - $ds9 -shm mosaic iraf key 100 foo - $ds9 -shm mosaic wcs key 100 foo - $ds9 -shm rgbcube key 100 foo - $ds9 -shm rgbimage key 100 foo - $ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] - $ds9 -shm array shmid 102 [dim=32,bitpix=-32] - - sia - - Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise. - Syntax: - -sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] - -      - [<ref>] [cancel] -      - [<ref>] [clear] -    [<ref>] - [close] -      [<ref>] - [coordinate <ra> <dec> <coordsys>] -      [<ref>] - - - - - - - - - - - - - [crosshair] -      [<ref>] [export - sb|tsv <filename>] -    [<ref>] - [name <object>] -    [<ref>] - [print] -      [<ref>] - [retrieve] -      - [<ref>] [save <filename>] -    [<ref>] [radius - <value> degrees|arcmin|arcsec] -      [<ref>] [sky - <skyframe>] -      - [<ref>] [skyformat <skyformat>] -      - [<ref>] [system <coordsys>] -      [<ref>] - - - - - - - - - - - - - [update] - - Example: - $ds9 -sia 2mass - $ds9 -sia cancel - $ds9 -sia clear - $ds9 -sia close - $ds9 -sia coordinate 202.48 47.21 - fk5 - $ds9 -sia crosshair - $ds9 -sia export tsv bar.tsv - $ds9 -sia name m51 - $ds9 -sia print - $ds9 -sia retrieve - $ds9 -sia save foo.xml - $ds9 -sia radius 1 degrees - $ds9 -sia sky fk5 - $ds9 -sia skyformat degrees - $ds9 -sia system wcs - $ds9 -sia update - - single - Set display mode to single. - Syntax: - -single - - Example: - $ds9 -single - - skyview - Support for SkyView image server at HEASARC. - Syntax: - -skyview [] -          [<object>] -          [name - <object>|clear] -          [<ra> - <dec>] # in wcs fk5 -          [size - <width> <height> degrees|arcmin|arcsec] -          [pixels - <width> <height>] -          [save yes|no] -          [frame - new|current] -          [update - frame|crosshair] -        [survey <survey>] -          [open|close] - - Example: - $ds9 -skyview - $ds9 -skyview m31 - $ds9 -skyview name m31 - $ds9 -skyview name clear - $ds9 -skyview 00:42:44.404 +41:16:08.78 - $ds9 -skyview size 60 60 arcmin - $ds9 -skyview pixels 600 600 - $ds9 -skyview save yes - $ds9 -skyview frame current - $ds9 -skyview update frame - $ds9 -skyview survey sdssi - $ds9 -skyview open - $ds9 -skyview close - - sleep - Delays execution for specified number of seconds. Default is 1 - second. - Syntax: - -sleep [#] - - Example: - $ds9 -sleep - $ds9 -sleep 2 - - slice - noslice - - Indicates next files loaded are to treated as slices of a cube. - Can be disabled with noslice command. - - Syntax: - -slice <filename> - -noslice - - Example: - $ds9 -slice *.fits - $ds9 -noslice - - smooth - Smooth current image or set smooth parameters. - Boxcar width = 2*radius+1 - Tophat diameter = 2*radius+1 - Gaussian diameter = 2*radius+1, mean =0 - Elliptical Gaussian diameter = 2*radius+1, mean =0 - - Syntax: - -smooth [] -         [yes|no] -         [function - boxcar|tophat|gaussian|elliptic] -         [radius - <value>] -         - [radiusminor <value>] -         - - - - - - - - - - - - - - [sigma <value>] -         - - - - - - - - - - - - - - [sigmaminor <value>] -         -[angle - - - - - - - - - - - - - - <value>] - -         [match] -         [lock [yes|no]] -         - [open|close] - - Example: - $ds9 -smooth - $ds9 -smooth yes - $ds9 -smooth function tophat - $ds9 -smooth radius 4 - $ds9 -smooth radiusminor 4 - $ds9 -smooth sigma 2.0 - $ds9 --smooth - - - - - - - - - - - - - - sigmaminor 2.0 - $ds9 - - - - - - - - - - +    [array [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - -smooth angle 45 - $ds9 -smooth - match - $ds9 -smooth lock yes - $ds9 -smooth open - $ds9 -smooth close - - squared - Select squared scale function for the current frame. - Syntax: - -squared - - Example: - $ds9 -squared - sqrt - Select square soot scale function for the current frame. - Syntax: - -sqrt - - Example: - $ds9 -sqrt - source - Source TCL code from a file. - Syntax: - -source <filename> - - Example: - $ds9 -source extensions.tcl - - tcl - Execute one TCL command. Note: this a different behavior from - previous versions of DS9. - - Syntax: - -tcl <tcl command> - - Example: - $ds9 -tcl 'puts "Hello, World"' - threads - Set number of process threads for functions which are - multi-threaded. - Syntax: - -threads # - - Example: - $ds9 -threads 8 - - tiff - Load TIFF image into current frame. - - Syntax: - -tiff <filename> - - Example: - $ds9 -tiff foo.tiff - $cat foo.fits | ds9 -tiff - - - tile - Controls the tile display mode. - Syntax: - -tile [] -       [yes|no] -       [mode grid|column|row] -       [grid] -       [grid mode automatic|manual] -       [grid direction x|y] -       [grid layout <col> - <row>] -       [grid gap <pixels>] -       [row] -       [column] - - Example: - $ds9 -tile - $ds9 -tile yes - $ds9 -tile mode row - $ds9 -tile grid - $ds9 -tile grid mode manual - $ds9 -tile grid direction x - $ds9 -tile grid layout 5 5 - $ds9 -tile grid gap 10 - $ds9 -tile row - $ds9 -tile column - title - Changes the display window title to the specified name. - Syntax: - -title name - - Example: - $ds9 -title Voyager - unix - Set the IRAF unix socket name, used by IRAF to communicate with - DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix - socket is defined. - Syntax: - -unix name - - Example: - $ds9 -unix "/tmp/.IMT%d" - unix_only - Only use the IRAF unix socket name. This is the same as -fifo - none -port 0. - Syntax: - -unix_only - - Example: - $ds9 -unix_only - - update - Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option. - Syntax: - -update [] -         [# x1 y1 x2 y2] -         [now] -         [now # x1 y1 x2 y2] - - Example: - $ds9 -update - $ds9 -update 1 100 100 300 400 - $ds9 -update now - $ds9 -update now 1 100 100 300 400 - url - Load FITS from URL into the current frame - Syntax: - -url <url> - - Example: - $ds9 -url http://foo.bar.edu/foo.fits - version - Returns the current version of DS9 and exits. - Syntax: - -version - - Example: - $ds9 -version - view - Controls the GUI and visible RGB frame color channels. - Syntax: - -view [layout horizontal|vertical] -       [keyvalue <string>] -       [info yes|no] -       [panner yes|no] -       [magnifier yes|no] -       [buttons yes|no] -       [colorbar yes|no] -       [graph horizontal|vertical - yes|no] -     [filename yes|no] -     [object yes|no] -       [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -       [units yes|no] -       [image|physical|wcs|wcsa...wcsz - yes|no] -       [frame yes|no] -     [red yes|no] - [green yes|no] - [blue yes|no] - - Example: - $ds9 -view layout vertical - $ds9 -view keyvalue BITPIX - $ds9 -view info yes - $ds9 -view panner yes - $ds9 -view magnifier yes - $ds9 -view buttons yes - $ds9 -view colorbar yes - $ds9 -view graph horizontal yes - $ds9 -view filename yes - $ds9 -view object yes - $ds9 -view keyword yes - $ds9 -view minmax yes - $ds9 -view lowhigh yes - $ds9 -view wcsa yes - $ds9 -view frame yes - $ds9 -view red yes - $ds9 -view green yes - $ds9 -view blue yes - - visual - Force DS9 to use the specified color visual. This argument MUST - be the first argument listed. Requires the visual be available. - Syntax: - -visual [truecolor|truecolor8|truecolor16|truecolor24] - Example: - $ds9 -visual truecolor24 - - vla - Support for VLA Sky Survey. - Syntax: - -vla [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -        [survey first|stripe82] -        [open|close] - - Example: - $ds9 -vla - $ds9 -vla m31 - $ds9 -vla name m31 - $ds9 -vla name clear - $ds9 -vla 00:42:44.404 +41:16:08.78 - $ds9 -vla size 60 60 arcmin - $ds9 -vla save yes - $ds9 -vla frame current - $ds9 -vla update frame - $ds9 -vla survey stripe82 - $ds9 -vla open - $ds9 -vla close - vlss - Support for NRAO VLSS Sky Survey. - Syntax: - -vlss [] -     [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -       [open|close] - - Example: - $ds9 -vlss - $ds9 -vlss m31 - $ds9 -vlss name m31 - $ds9 -vlss name clear - $ds9 -vlss 00:42:44.404 +41:16:08.78 - $ds9 -vlss size 60 60 arcmin - $ds9 -vlss save yes - $ds9 -vlss frame current - $ds9 -vlss update frame - $ds9 -vlss open - $ds9 -nvess close - vo - Invoke an connection to a Virtual Observatory site. - Syntax: - -vo [method xpa|mime] -     [server <url>] -     [internal yes|no] -     [delay #] -     [<url>] -     [connect <url>] -     [disconnect <url>] -     [open|close] - - Example: - $ds9 -vo method xpa - $ds9 -vo server "http://foo.bar.edu/list.txt" - $ds9 -vo internal yes - $ds9 -vo delay 15 # keep-alive delay - $ds9 -vo chandra-ed - $ds9 -vo connect chandra-ed - $ds9 -vo disconnect chandra-ed - $ds9 -vo open - $ds9 -vo close - - wcs - Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, a new WCS specification can be loaded and - used by the current image regardless of the WCS that was - contained in the image file. Please see WCS - for more information. - Syntax: - -wcs [[system] wcs|wcsa...wcsz] -      [[sky] fk4|fk5|icrs|galactic|ecliptic] -      [[skyformat] degrees|sexagesimal] -      [align yes|no] -      [reset [#]] -      [replace [#] <filename>] -      [append [#] <filename>] -      [open|close] - - Example: - $ds9 -wcs wcs - $ds9 -wcs system wcs - $ds9 -wcs fk5 - $ds9 -wcs sky fk5 - $ds9 -wcs sexagesimal - $ds9 -wcs skyformat sexagesimal - $ds9 -wcs align yes - $ds9 -wcs reset - $ds9 -wcs reset 3 - $ds9 -wcs replace foo.wcs - $ds9 -wcs replace 3 foo.wcs - $ds9 -wcs append foo.wcs - $ds9 -wcs append 3 foo.wcs - $ds9 -wcs open - $ds9 -wcs close - - web - Display specified URL in the web display. - Syntax: - -web [] -      [<url>] -      [new <webname> <url>] -      [<webname>] [click - back|forward|stop|reload|#] -      [<webname>] [clear] -      [<webname>] [close] - - Example: - $ds9 -web www.cnn.com - $ds9 -web new www.cnn.com - $ds9 -web hvweb www.apple.com - $ds9 -web click back - $ds9 -web click 2 - $ds9 -web clear - $ds9 -web close - - width - Set the width of the image display window. Use the geometry command to set the - overall width and height of the ds9 window. - Syntax: - -width [<value>] - - Example: - $ds9 -width 512 - - xpa - Configure XPA. - Syntax: - -xpa [yes|no] -      [inet|local|unix|localhost] -      [noxpans] -      [connect] -      [disconnect] -      [info] - - Example: - $ds9 -xpa no - $ds9 -xpa local - $ds9 -xpa noxpans - $ds9 -xpa connect - $ds9 -xpa disconnect - $ds9 -xpa info - - zmax - Set Scale Limits based on the IRAF algorithm and - maximum data value. - Syntax: - -zmax - - Example: - $ds9 -zmax - zscale - Set Scale Limits based on the IRAF algorithm. - Syntax: - -zscale [] -         [contrast] -         [sample] -         [line] - - Example: - $ds9 -zscale - $ds9 -zscale contrast .25 - $ds9 -zscale sample 600 - $ds9 -zscale line 120 - - zoom - Controls the current zoom value for the current frame. - Syntax: - -zoom [<value>] -       [<value> <value>] -       [to <value>] -       [to <value> <value>] -       [in] -       [out] -       [to fit] -       [open|close] - - Example: - $ds9 -zoom 2 - $ds9 -zoom 2 4 - $ds9 -zoom to 4 - $ds9 -zoom to 2 4 - $ds9 -zoom in - $ds9 -zoom out - $ds9 -zoom to fit - $ds9 -zoom open - $ds9 -zoom close - - - + +Example: +$ds9 -shm 102 +$ds9 -shm key 102 +$ds9 -shm shmid 102 foo +$ds9 -shm fits 100 foo +$ds9 -shm mosaicimage iraf key 100 foo +$ds9 -shm mosaicimage wcs key 100 foo +$ds9 -shm mosaicimage wcsa key 100 foo +$ds9 -shm mosaicimage wfpc2 key 100 foo +$ds9 -shm mosaic iraf key 100 foo +$ds9 -shm mosaic wcs key 100 foo +$ds9 -shm rgbcube key 100 foo +$ds9 -shm rgbimage key 100 foo +$ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] +$ds9 -shm array shmid 102 [dim=32,bitpix=-32] +sia +Support for VO Simple Image Access protocol. The first command +will create a new search. All other commands operated on the last +search created, unless indicated otherwise. +Syntax: +-sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> +<coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +$ds9 -sia 2mass +$ds9 -sia cancel +$ds9 -sia clear +$ds9 -sia close +$ds9 -sia coordinate 202.48 47.21 fk5 +$ds9 -sia crosshair +$ds9 -sia export tsv bar.tsv +$ds9 -sia name m51 +$ds9 -sia print +$ds9 -sia retrieve +$ds9 -sia save foo.xml +$ds9 -sia radius 1 degrees +$ds9 -sia sky fk5 +$ds9 -sia skyformat degrees +$ds9 -sia system wcs +$ds9 -sia update + single +Set display mode to single. +Syntax: +-single + +Example: +$ds9 -single +skyview +Support for SkyView image server at HEASARC. +Syntax: +-skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +$ds9 -skyview +$ds9 -skyview m31 +$ds9 -skyview name m31 +$ds9 -skyview name clear +$ds9 -skyview 00:42:44.404 +41:16:08.78 +$ds9 -skyview size 60 60 arcmin +$ds9 -skyview pixels 600 600 +$ds9 -skyview save yes +$ds9 -skyview frame current +$ds9 -skyview update frame +$ds9 -skyview survey sdssi +$ds9 -skyview open +$ds9 -skyview close +sleep +Delays execution for specified number of seconds. Default is 1 +second. +Syntax: +-sleep [#] + +Example: +$ds9 -sleep +$ds9 -sleep 2 +slice +noslice +Indicates next files loaded are to treated as slices of a cube. +Can be disabled with noslice command. +Syntax: +-slice <filename> +-noslice + +Example: +$ds9 -slice *.fits +$ds9 -noslice +smooth +Smooth current image or set smooth parameters. +Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter +=2*radius+1,mean=0 +Syntax: +-smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian|elliptic] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -smooth +$ds9 -smooth yes +$ds9 -smooth function tophat +$ds9 -smooth radius 4 +$ds9 -smooth radiusminor 4 +$ds9 -smooth sigma 2.0 +$ds9 -smooth sigmaminor 2.0 +$ds9 -smooth angle 45 +$ds9 -smooth match +$ds9 -smooth lock yes +$ds9 -smooth open +$ds9 -smooth close +squared +Select squared scale function for the current frame. +Syntax: +-squared + +Example: +$ds9 -squared +sqrt +Select square soot scale function for the current frame. +Syntax: +-sqrt + +Example: +$ds9 -sqrt +source +Source TCL code from a file. +Syntax: +-source <filename> + +Example: +$ds9 -source extensions.tcl +tcl +Execute one TCL command. Note: this a different behavior from +previous versions of DS9. +Syntax: +-tcl <tcl command> + +Example: +$ds9 -tcl 'puts "Hello, World"' +threads +Set number of process threads for functions which are +multi-threaded. +Syntax: +-threads # + +Example: +$ds9 -threads 8 + +tiff +Load TIFF image into current frame. +Syntax: +-tiff <filename> + +Example: +$ds9 -tiff foo.tiff +$cat foo.fits | ds9 -tiff - +tile +Controls the tile display mode. +Syntax: +-tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +$ds9 -tile +$ds9 -tile yes +$ds9 -tile mode row +$ds9 -tile grid +$ds9 -tile grid mode manual +$ds9 -tile grid direction x +$ds9 -tile grid layout 5 5 +$ds9 -tile grid gap 10 +$ds9 -tile row +$ds9 -tile column +title +Changes the display window title to the specified name. +Syntax: +-title name + +Example: +$ds9 -title Voyager +unix +Set the IRAF unix socket name, used by IRAF to communicate with +DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix +socket is defined. +Syntax: +-unix name + +Example: +$ds9 -unix "/tmp/.IMT%d" +unix_only +Only use the IRAF unix socket name. This is the same as -fifo +none -port 0. +Syntax: +-unix_only + +Example: +$ds9 -unix_only +update +Updates the current frame or region of frame. In the second +form, the first argument is the number of the fits HDU (starting +with 1) and the remaining args are a bounding box in IMAGE +coordinates. By default, the screen is updated the next available +idle cycle. However, you may force an immediate update by +specifying the NOW option. +Syntax: +-update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: +$ds9 -update +$ds9 -update 1 100 100 300 400 +$ds9 -update now +$ds9 -update now 1 100 100 300 400 +url +Load FITS from URL into the current frame +Syntax: +-url <url> + +Example: +$ds9 -url http://foo.bar.edu/foo.fits +version +Returns the current version of DS9 and exits. +Syntax: +-version + +Example: +$ds9 -version +view +Controls the GUI and visible RGB frame color channels. +Syntax: +-view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no] +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +$ds9 -view layout vertical +$ds9 -view keyvalue BITPIX +$ds9 -view info yes +$ds9 -view panner yes +$ds9 -view magnifier yes +$ds9 -view buttons yes +$ds9 -view colorbar yes +$ds9 -view graph horizontal yes +$ds9 -view filename yes +$ds9 -view object yes +$ds9 -view keyword yes +$ds9 -view minmax yes +$ds9 -view lowhigh yes +$ds9 -view wcsa yes +$ds9 -view frame yes +$ds9 -view red yes +$ds9 -view green yes +$ds9 -view blue yes +visual +Force DS9 to use the specified color visual. This argument MUST +be the first argument listed. Requires the visual be available. +Syntax: +-visual [truecolor|truecolor8|truecolor16|truecolor24] +Example: +$ds9 -visual truecolor24 +vla +Support for VLA Sky Survey. +Syntax: +-vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +$ds9 -vla +$ds9 -vla m31 +$ds9 -vla name m31 +$ds9 -vla name clear +$ds9 -vla 00:42:44.404 +41:16:08.78 +$ds9 -vla size 60 60 arcmin +$ds9 -vla save yes +$ds9 -vla frame current +$ds9 -vla update frame +$ds9 -vla survey stripe82 +$ds9 -vla open +$ds9 -vla close +vlss +Support for NRAO VLSS Sky Survey. +Syntax: +-vlss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -vlss +$ds9 -vlss m31 +$ds9 -vlss name m31 +$ds9 -vlss name clear +$ds9 -vlss 00:42:44.404 +41:16:08.78 +$ds9 -vlss size 60 60 arcmin +$ds9 -vlss save yes +$ds9 -vlss frame current +$ds9 -vlss update frame +$ds9 -vlss open +$ds9 -nvess close +vo +Invoke an connection to a Virtual Observatory site. +Syntax: +-vo [method xpa|mime] +    [server <url>] +    [internal yes|no] +    [delay #] +    [<url>] +    [connect <url>] +    [disconnect <url>] +    [open|close] + +Example: +$ds9 -vo method xpa +$ds9 -vo server "http://foo.bar.edu/list.txt" +$ds9 -vo internal yes +$ds9 -vo delay 15 # keep-alive delay +$ds9 -vo chandra-ed +$ds9 -vo connect chandra-ed +$ds9 -vo disconnect chandra-ed +$ds9 -vo open +$ds9 -vo close +wcs +Controls the World Coordinate System for the current frame. If +the wcs system, skyframe, or skyformat is modified, the info panel, +compass, grid, and alignment will be modified accordingly. Also, a +new WCS specification can be loaded and used by the current image +regardless of the WCS that was contained in the image file. Please +see WCS for more information. +Syntax: +-wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +$ds9 -wcs wcs +$ds9 -wcs system wcs +$ds9 -wcs fk5 +$ds9 -wcs sky fk5 +$ds9 -wcs sexagesimal +$ds9 -wcs skyformat sexagesimal +$ds9 -wcs align yes +$ds9 -wcs reset +$ds9 -wcs reset 3 +$ds9 -wcs replace foo.wcs +$ds9 -wcs replace 3 foo.wcs +$ds9 -wcs append foo.wcs +$ds9 -wcs append 3 foo.wcs +$ds9 -wcs open +$ds9 -wcs close +web +Display specified URL in the web display. +Syntax: +-web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click +back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +$ds9 -web www.cnn.com +$ds9 -web new www.cnn.com +$ds9 -web hvweb www.apple.com +$ds9 -web click back +$ds9 -web click 2 +$ds9 -web clear +$ds9 -web close +width +Set the width of the image display window. Use the geometry command to set the overall +width and height of the ds9 window. +Syntax: +-width [<value>] + +Example: +$ds9 -width 512 +xpa +Configure XPA. +Syntax: +-xpa [yes|no] +    [inet|local|unix|localhost] +    [noxpans] +    [connect] +    [disconnect] +    [info] + +Example: +$ds9 -xpa no +$ds9 -xpa local +$ds9 -xpa noxpans +$ds9 -xpa connect +$ds9 -xpa disconnect +$ds9 -xpa info +zmax +Set Scale Limits based on the IRAF algorithm and +maximum data value. +Syntax: +-zmax + +Example: +$ds9 -zmax +zscale +Set Scale Limits based on the IRAF algorithm. +Syntax: +-zscale [] +    [contrast] +    [sample] +    [line] + +Example: +$ds9 -zscale +$ds9 -zscale contrast .25 +$ds9 -zscale sample 600 +$ds9 -zscale line 120 +zoom +Controls the current zoom value for the current frame. +Syntax: +-zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +$ds9 -zoom 2 +$ds9 -zoom 2 4 +$ds9 -zoom to 4 +$ds9 -zoom to 2 4 +$ds9 -zoom in +$ds9 -zoom out +$ds9 -zoom to fit +$ds9 -zoom open +$ds9 -zoom close + + -- cgit v0.12 From 557423b2a320bc5fe622c719115d8457c8108cd0 Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 17:24:06 -0400 Subject: clean up html --- ds9/doc/ref/samp.html | 7209 ++++++++++++++++++++++--------------------------- 1 file changed, 3215 insertions(+), 3994 deletions(-) diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index b2c47d8..dfe026a 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -1,4005 +1,3226 @@ - - - - - SAMP - - - SAMP - - SAMP is a messaging protocol that enables astronomy software - tools to interoperate and communicate. Broadly speaking, SAMP is - an abstract framework for loosely-coupled, asynchronous, - RPC-like and/or event-based communication, based on a central - service providing multi-directional publish/subscribe message - brokering. The message semantics are extensible and use - structured but weakly-typed data. For more information on SAMP, - please click here. - The samp implementation for DS9 is based on the XPA model with 2 private calls: - ds9.get -     Arguments -         cmd (string) required -         url (string) optional -     Returned value -         OK (samp.result map) -             value - (string) optional -             -     url (string) optional -         ERROR (samp.error map) -             - samp.errortxt (string) - - ds9.set -     Arguments -         cmd (string) required -         url (string) optional -     Returned value -         OK -         ERROR (samp.error map) -             - samp.errortxt (string) - - ds9.set maybe called via notification, call and - call/wait. ds9.get can only be called via call and - call/wait. Most of the ds9.get calls return a value - string, but a few will return a url instead. - 2mass - 3d - about - analysis - array - background - backup - bin - blink - block - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - data - dsssao - dsseso - dssstsci - envi - exit - export - file - fits - frame - gif - grid - header - height - iconify - iexam - iis - jpeg - lock - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - multiframe - nameserver - nan - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - quit - raise - regions - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - samp - save - saveimage - scale - shm - sia - single - skyview - sleep - smooth - source - tcl - threads - tiff - tile - update - url - version - view - vla - vlss - vo - wcs - web - width - zscale - zoom - - 2mass - Support for 2MASS Digital Sky Survey. - Syntax: - 2mass [] -       [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -     [survey j|h|k] -       [open|close] - - Example: - string value = ds9.get(string cmd) - 2mass name - 2mass coord - 2mass size - 2mass save - 2mass frame - 2mass survey - ds9.set(string cmd) - 2mass - 2mass m31 - 2mass name m31 - 2mass name clear - 2mass 00:42:44.404 +41:16:08.78 - 2mass size 60 60 arcmin - 2mass save yes - 2mass frame current - 2mass update frame - 2mass survey j - 2mass open - 2mass close - - 3d - Support for 3D frame. - Syntax: - 3d [] -    [view <az> <el>] -    [az <az>] -    [el <el>] -    [scale <scale>] -    [method mip|aip] -    [background none|azimuth|elevation] -    [border yes|no] -    [border color <color>] -    [highlite yes|no] -    [hightlite color <color>] -    [compass yes|no] -    [compass color <color>] -    [match] -    [lock [yes|no]] -    [open|close] - - Example: - string value = ds9.get(string cmd) - 3d view - 3d az - 3d el - 3d scale - 3d method - 3d background - 3d border - 3d border color - 3d highlite - 3d highlite color - 3d compass - 3d compass color - 3d lock - ds9.set(string cmd) - 3d # create new 3D frame - 3d view 45 30 - 3d az 45 - 3d el 30 - 3d scale 10 - 3d method mip - 3d background azimuth - 3d border yes - 3d border color red - 3d highlite yes - 3d highlite color red - 3d compass yes - 3d compass color red - 3d match - 3d lock yes - 3d open - 3d close - about - Get DS9 credits. - Syntax: - about - - Example: - string value = ds9.get(string cmd) - about - - align - Controls the World Coordinate System alignment for the current - frame. - Syntax: - align [] -       [yes|no] - - Example: - string value = ds9.get(string cmd) - align - ds9.set(string cmd) - align yes - analysis - Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window. - Syntax: - analysis [<task number>] -          - [<filename>] -          [task <task - number>|<task name>] -          [load - <filename>] -          [clear] -          [clear][load - <filename>] -          [message - ok|okcancel|yesno <message>] -          [entry - <message>] -          [text] - - Example: - string value = ds9.get(string cmd) - analysis - analysis task - analysis entry {Please enter something} - analysis entry okcancel {Hello World} - ds9.set(string cmd) - analysis 0 # invoke first analysis task - analysis task 0 - analysis task foobar - analysis task {foo bar} - analysis my.ans - analysis load my.ans - analysis clear - analysis clear load my.ans - analysis message {This is a message} - analysis text {this is text} - ds9.set(string cmd, string url) - analysis load - analysis text - - array - Load raw data array into current frame. - - Syntax: - array [native|little|big] - array [new|mask] + + + + +SAMP + + + SAMP + +SAMP is a messaging protocol that enables astronomy software +tools to interoperate and communicate. Broadly speaking, SAMP is an +abstract framework for loosely-coupled, asynchronous, RPC-like +and/or event-based communication, based on a central service +providing multi-directional publish/subscribe message brokering. +The message semantics are extensible and use structured but +weakly-typed data. For more information on SAMP, please click +here. +The samp implementation for DS9 is based on the XPA model with 2 private calls: +ds9.get +    Arguments +        cmd (string) required +        url (string) optional +    Returned value +        OK (samp.result map) +            value +(string) optional +            +    url (string) optional +        ERROR (samp.error map) +            +samp.errortxt (string) + +ds9.set +    Arguments +        cmd (string) required +        url (string) optional +    Returned value +        OK +        ERROR (samp.error map) +            +samp.errortxt (string) +ds9.set maybe called via notification, call and +call/wait. ds9.get can only be called via call and +call/wait. Most of the ds9.get calls return a value +string, but a few will return a url instead. +2mass +3d +about +analysis +array +background +backup +bin +blink +block +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +data +dsssao +dsseso +dssstsci +envi +exit +export +file +fits +frame +gif +grid +header +height +iconify +iexam +iis +jpeg +lock +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +multiframe +nameserver +nan +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +quit +raise +regions +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +samp +save +saveimage +scale +shm +sia +single +skyview +sleep +smooth +source +tcl +threads +tiff +tile +update +url +version +view +vla +vlss +vo +wcs +web +width +zscale +zoom +2mass +Support for 2MASS Digital Sky Survey. +Syntax: +2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +string value = ds9.get(string cmd) +2mass name +2mass coord +2mass size +2mass save +2mass frame +2mass survey + +ds9.set(string cmd) +2mass +2mass m31 +2mass name m31 +2mass name clear +2mass 00:42:44.404 +41:16:08.78 +2mass size 60 60 arcmin +2mass save yes +2mass frame current +2mass update frame +2mass survey j +2mass open +2mass close +3d +Support for 3D frame. +Syntax: +3d [] +   [view <az> <el>] +   [az <az>] +   [el <el>] +   [scale <scale>] +   [method mip|aip] +   [background none|azimuth|elevation] +   [border yes|no] +   [border color <color>] +   [highlite yes|no] +   [hightlite color <color>] +   [compass yes|no] +   [compass color <color>] +   [match] +   [lock [yes|no]] +   [open|close] + +Example: +string value = ds9.get(string cmd) +3d view +3d az +3d el +3d scale +3d method +3d background +3d border +3d border color +3d highlite +3d highlite color +3d compass +3d compass color +3d lock + +ds9.set(string cmd) +3d # create new 3D frame +3d view 45 30 +3d az 45 +3d el 30 +3d scale 10 +3d method mip +3d background azimuth +3d border yes +3d border color red +3d highlite yes +3d highlite color red +3d compass yes +3d compass color red +3d match +3d lock yes +3d open +3d close +about +Get DS9 credits. +Syntax: +about + +Example: +string value = ds9.get(string cmd) +about +align +Controls the World Coordinate System alignment for the current +frame. +Syntax: +align [] +    [yes|no] + +Example: +string value = ds9.get(string cmd) +align + +ds9.set(string cmd) +align yes +analysis +Control external analysis tasks. Tasks are numbered as they are +loaded, starting with 0. Can also be used to display a message and +display text in the text dialog window. +Syntax: +analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +string value = ds9.get(string cmd) +analysis +analysis task +analysis entry {Please enter something} +analysis entry okcancel {Hello World} + +ds9.set(string cmd) +analysis 0 # invoke first analysis task +analysis task 0 +analysis task foobar +analysis task {foo bar} +analysis my.ans +analysis load my.ans +analysis clear +analysis clear load my.ans +analysis message {This is a message} +analysis text {this is text} +ds9.set(string cmd, string url) +analysis load +analysis text +array +Load raw data array into current frame. +Syntax: +array [native|little|big] +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - string url = ds9.get(string cmd) - array - array little - ds9.set(string command, string url) - array foo.arr[dim=512,bitpix=-32,endian=little] - array new foo.arr[dim=512,bitpix=-32,endian=little] - array mask foo.arr[dim=512,bitpix=-32,endian=little] - - bg - background - Set image background color. - Syntax: - bg <color> - - Example: - string url = ds9.get(string cmd) - bg - ds9.set(string cmd) - bg red - bg red - backup - Create a backup save set. - Syntax: - backup <filename> - - Example: - ds9.set(string cmd) - backup ds9.bck - bin - Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility. - Syntax: - bin [about <x> <y>] -     [about center] -     [buffersize <value>] -     [cols <x> <y>] -     [colsz <x> <y> <z>] -     [factor <value> [<vector>]] -     [depth <value>] -     [filter <string>] -     [filter clear] -     [function average|sum] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - bin about - bin buffersize - bin cols - bin factor - bin depth - bin filter - bin function - bin smooth - bin smooth function - bin smooth radius - bin lock - ds9.set(string cmd) - bin about 4096 4096 - bin about center - bin buffersize 512 - bin cols detx dety - bin colsz detx dety time - bin factor 4 - bin factor 4 2 - bin depth 10 - bin filter 'pha > 5' - bin filter clear - bin function sum - bin in - bin out - bin to fit - bin match - bin lock yes - bin open - bin close - - blink - Blink mode parameters. Interval is in seconds. - - Syntax: - blink [] -       [yes|no] -       [interval <value>] - - Example: - string value = ds9.get(string cmd) - blink - blink interval - ds9.set(string cmd) - blink - blink yes - blink interval 1 - block - Controls blocking parameters. - Syntax: - block [<value>] -       [<value> <value>] -       [to <value>] -       [to <value> - <value>] -       [in] -       [out] -       [to fit] -       [match] -       [lock [yes|no]] -       [open|close] - - Example: - string value = ds9.get(string cmd) - block - block lock - ds9.set(string cmd) - block 4 - block 4 2 - block to 4 - block to 4 2 - block in - block out - block to fit - block match - block lock yes - block open - block close - - catalog - cat - - Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise. - Syntax: - catalog [new] -         - [ned|simbad|denis|skybot] -         -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -         [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -         - - - - - - - - - - - - [2mass|iras] -         - [csc|xmm|rosat] -         [first|nvss] -         - [chandralog|cfhtlog|esolog|stlog|xmmlog] -         [cds - <catalogname>] -         [cds - <catalogid>] - -         [load - <filename>] -         [import sb|tsv - <filename>] - -     -     [<ref>] [<ra> <dec> - <coordsys>] -       - [<ref>] [allcols] -      -    [<ref>] [allrows] -         - [<ref>] [cancel] -     -     [<ref>] [clear] -       - [<ref>] [close] -         - [<ref>] [crosshair] -         - [<ref>] [dec <col>] -         - [<ref>] [edit yes|no] -         - [<ref>] [export sb|tsv <filename>] -         - - - - - - - - - - - - - [<ref>] [filter <string>] -         [<ref>] - [filter load <filename>] -         - [<ref>] [header] -         - [<ref>] [location <code>] -         - [<ref>] [match] -         - - - - - - - - - - - - - - [<ref>] [match <ref> <ref>] -         - [<ref>] [match error <value> - degrees|arcmin|arcsec] -         - [<ref>] [match function 1and2|1not2|2not1] -         - [<ref>] [match return 1and2|1only|2only] -         - [<ref>] [match unique yes|no] -         - [<ref>] [maxrows <number>] -       [<ref>] - [name <object>] -         - - - - - - - - - - - - - [<ref>] [panto yes|no] -         - [<ref>] [plot <xcol> <ycol> <xerrcol> - <yerrcol>] -       [<ref>] - [print] -         - [<ref>] [psky <skyframe>] -         - [<ref>] [psystem <coordsys>] -         - [<ref>] [ra <col>] -         - [<ref>] [regions] -         - [<ref>] [retrieve] -         [<ref>] - [samp] -         [<ref>] - [samp broadcast] -         [<ref>] - [samp send <application>] -         - - - - - - - - - - - - - [<ref>] [save <filename>] -         - [<ref>] [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -         - [<ref>] [show yes|no] -       [<ref>] - [radius <value> degrees|arcmin|arcsec] -         - [<ref>] [sky <skyframe>] -     -     [<ref>] [skyformat <skyformat>] -     -     [<ref>] [sort <col> incr|decr] -         - [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -     -     [<ref>] [symbol [#] - text|size|size2|units|angle <value>] -     -     [<ref>] [symbol shape - circle|ellipse|box|text|point] -         [<ref>] - - - - - - - - - - - - - [symbol shape circle point|box point|diamond - point|cross point|x point|arrow point|boxcircle point] -         - [<ref>] [symbol add| [#] remove] -         [<ref>] - [symbol save|load <filename>] -         - [<ref>] [system <coordsys>] -      -    [<ref>] [update] -         - [<ref>] [x <col>] -         - [<ref>] [y <col>] - - Example: - string value = ds9.get(string cmd) - catalog - catalog header - - ds9.set(string cmd) - catalog new - catalog 2mass - catalog cds 2mass - catalog cds {I/252} - - catalog load foo.xml - catalog import tsv foo.tsv - - catalog allrows - catalog allcols - catalog cancel - catalog clear - catalog close - catalog coordinate 202.48 47.21 fk5 - catalog crosshair - catalog dec DEC - catalog edit yes - catalog export tsv bar.tsv - catalog filter {$Jmag>10} - catalog filter load foo.flt - catalog header - catalog location 500 - catalog match error 2 arcsec - catalog match function 1and2 - catalog match unique no - catalog match return 1only - catalog match # last two catalogs - loaded - catalog match 2mass csc - catalog maxrows 2000 - catalog name m51 - catalog panto no - catalog plot {$Jmag} - - - - - - - - - - - - {$Hmag} {$e_Jmag} {$e_Hmag} - catalog print - catalog psky fk5 - catalog psystem wcs - catalog ra RA - catalog regions - catalog retrieve - catalog samp broadcast - catalog samp send aladin - catalog save foo.xml - catalog server sao - catalog show yes - catalog radius 1 degrees - catalog symbol condition {$Jmag>15} - catalog symbol 2 shape {boxcircle - - - - - - - - - - - - point} - catalog symbol color red - catalog symbol font times - catalog symbol fontsize 14 - catalog symbol fontweight bold - catalog symbol fontslant italic - catalog symbol add - catalog symbol 2 remove - catalog symbol load foo.sym - catalog symbol save bar.sym - catalog sky fk5 - catalog skyformat degrees - catalog sort {Jmag} incr - catalog system wcs - catalog update - catalog x RA - catalog y DEC - cd - Sets/Returns the current working directory. - Syntax: - cd [<directory>] - - Example: - string value = ds9.get(string cmd) - cd - ds9.set(string cmd) - cd /home/mrbill - - cmap - Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1. - Syntax: - cmap [<colormap>] -      [file] -      [load <filename>] -      [save <filename>] -      [invert yes|no] -      [<constrast> <bias>] -      [tag [load|save] - <filename>] -      [tag delete] -      [open|close] - - Example: - string value = ds9.get(string cmd) - cmap - cmap file - cmap invert - cmap value - cmap lock - ds9.set(string cmd) - cmap Heat - cmap load foo.sao - cmap save bar.sao - cmap invert yes - cmap 5 .5 - cmap tag load foo.tag - cmap tag save foo.tag - cmap tag delete - cmap open - cmap close - - colorbar - Controls colorbar parameters. - Syntax: - colorbar [] -          [yes|no] -          [orientation] -          - [horizontal|vertical] -          [numerics - yes|no] -          [space - value|distance] -          [font - times|helvetica|courier] -          [fontsize - <value>] -          [fontweight - normal|bold] -          [fontslant - roman|italic] -          [size] -          [ticks] -          [match] -          [lock - [yes|no]] - - Example: - string value = ds9.get(string cmd) - colorbar - colorbar orientation - colorbar numerics - colorbar space - colorbar font - colorbar fontsize - colorbar fontweight - colorbar fontslant - colorbar size - colorbar ticks - ds9.set(string cmd) - colorbar yes - colorbar vertical - colorbar numerics yes - colorbar space value - colorbar font times - colorbar fontsize 14 - colorbar fontwieght bold - colorbar fontslant italic - colorbar size 20 - colorbar ticks 11 - colorbar match - colorbar lock yes - console - Display tcl console window. - Syntax: - -console - - Example: - ds9.set(string cmd) - console - - contour - Controls contours in the current frame. - Syntax: - contour [] -         [yes|no] -         [<coordsys> - [<skyframe>]] -         [clear] -         [generate] -         [load - <filename>] -       [save <filename> - [<coordsys> <skyframe>]] -         [convert] -         [load - levels <filename>] -         - - - - - - - - - - - - - [save levels <filename>] -         [copy] -         [paste - [<coordsys> <color> <width> yes|no]] -         [color <color>] -         [width <width>] -         [dash yes|no] -         [smooth <smooth>] -         [method block|smooth] -         [nlevels <number of - levels>] -         [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -         ]scale log exp - <value>] -         [mode - minmax|<value>|zscale|zmax] -         [scope global|local] -         [limits <min> - <max>] -         [levels <value - value value...>] -         [open|close] - - Example: - string value = ds9.get(string cmd) - contour - contour color - contour width - contour dash - contour smooth - contour method - contour nlevels - contour scale - contour log exp - contour mode - contour scope - contour limits - contour levels - string url = ds9.get(string cmd) - contour wcs fk5 - ds9.set(string cmd) - contour - contour yes - contour clear - contour generate - contour load ds9.ctr - contour save ds9.con - contour save ds9.con wcs fk5 - contour convert - contour load levels ds9.ctr - contour save levels ds9.lev - contour copy - contour paste - contour paste wcs red 2 no - contour color yellow - contour width 2 - contour dash yes - contour smooth 5 - contour method smooth - contour nlevels 10 - contour scale sqrt - contour log exp 1000 - contour mode zscale - contour scope local - contour limits 1 100 - contour levels 1 10 100 1000 - contour open - contour close - - crop - Set current image display area. - Syntax: - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -       - [match <coordsys>] -       [lock - <coordsys>|none] -       [reset] -       [3d zmin - - - - - - - - - - - - zmax <coordsys>] -       [open|close] - - Example: - string value = ds9.get(string cmd) - crop # get crop in physical coords - crop wcs galactic sexagesimal - arcsec - crop lock - ds9.set(string cmd) - crop 40 30 10 20 # set crop in physical coords - crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs - galactic arcsec - crop match wcs - crop lock wcs - crop reset - crop 3d .25 .5 wcs - crop open - crop close - - crosshair - Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set. - Syntax: - crosshair [<x> <y> <coordsys> - [<skyframe>]] -           - [match <coordsys>] -           [lock - <coordsys>|none] - - Example: - string value = ds9.get(string cmd) - crosshair # get crosshair in physical coords - crosshair wcs fk4 sexagesimal # get crosshair in wcs coords - crosshair lock - ds9.set(string cmd) - crosshair 100 100 physical # set crosshair in physical - crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords - crosshair 23:01:00 +58:52:51 wcs fk5 - crosshair match wcs - crosshair lock wcs - - cube - - Controls FITS cube. - Syntax: - cube [] -      [play|stop|next|prev|first|last] -      [<slice> [<coordsys>]] -      [interval <numeric>] -      [match <coordsys>] -      [lock <coordsys>|none] -      [order 123|132|213|231|312|321] -      [axes lock [yes|no]] -      [open|close] - - Example: - string value = ds9.get(string cmd) - cube - cube wcs - cube interval - cube lock - cube order - cube axes lock - ds9.set(string cmd) - cube - cube play - cube last - cube 3 - cube 4.5 wcs - cube interval 2 - cube match wcs - cube lock wcs - cube order 123 - cube axes lock yes - cube open - cube close - cursor - Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also. - Syntax: - cursor [<x> <y>] - - Example: - ds9.set(string cmd) - cursor 10 10 - - data - Return an array of data values given a lower left corner and a - width and height in specified coordinate system. The last - argument of yes indicates to strip the coordinates from the - output and just list the data values. The default is yes. - - Syntax: - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]] - - Example: - string url = ds9.get(string cmd) - data image 450 520 3 3 yes - data physical 899 1039 6 6 no - data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no - data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no - - dsssao - dss - - Support for Digital Sky Survey at SAO. - Syntax: - dsssao [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -        [open|close] - - Example: - string value = ds9.get(string cmd) - dsssao name - dsssao coord - dsssao size - dsssao save - dsssao frame - ds9.set(string cmd) - dsssao - dsssao m31 - dsssao name m31 - dsssao name clear - dsssao 00:42:44.404 +41:16:08.78 - dsssao size 60 60 arcmin - dsssao save yes - dsssao frame current - dsssao update frame - dsssao open - dsssao close - - dsseso - Support for Digital Sky Survey at ESO. - Syntax: - dsseso [] -        [<object>] -        [name <object>|clear] -        [<ra> <dec>] # - in wcs fk5 -        [size <width> - <height> degrees|arcmin|arcsec] -        [save yes|no] -        [frame new|current] -        [update frame|crosshair] -    [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -        [open|close] - - Example: - string value = ds9.get(string cmd) - dsseso name - dsseso coord - dsseso size - dsseso save - dsseso frame - dsseso survey - ds9.set(string cmd) - dsseso - dsseso m31 - dsseso name m31 - dsseso name clear - dsseso 00:42:44.404 +41:16:08.78 - dsseso size 60 60 arcmin - dsseso save yes - dsseso frame current - dsseso update frame - dsseso survey DSS2-red - dsseso open - dsseso close - - dssstsci - Support for Digital Sky Survey at STSCI. - Syntax: - dssstsci [] -          [<object>] -    [name <object>|clear] -          [<ra> - <dec>] # in wcs fk5 -          [size - <width> <height> degrees|arcmin|arcsec] -          [save yes|no] -          [frame - new|current] -          [update - frame|crosshair] -          [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -          [survey - poss1_blue|poss1_red] -          [survey - all|quickv|phase2_gsc2|phase2_gsc1] -          [open|close] - - Example: - string value = ds9.get(string cmd) - dssstsci name - dssstsci coord - dssstsci size - dssstsci save - dssstsci frame - dssstsci survey - ds9.set(string cmd) - dssstsci - dssstsci m31 - dssstsci name m31 - dssstsci name clear - dssstsci 00:42:44.404 +41:16:08.78 - dssstsci size 60 60 arcmin - dssstsci save yes - dssstsci frame current - dssstsci update frame - dssstsci survey all - dssstsci open - dssstsci close - envi - Load an ENVI header and file. Optional parameter: array endian. - - Syntax: - envi [new] <header> [<filename>] - - Example: - envi foo.hdr - envi new foo.hdr - envi foo.hdr foo.bsq - - exit - quit - - Quits DS9. - Syntax: - exit - quit - - Example: - ds9.set(string cmd) - exit - export - - Export loaded image data of current frame in specified image - format. Optional parameters: array endian, nrrd endian, jpeg - quality (1-100) and tiff compression method. - Syntax: - export [array|nrrd|envi|gif|tiff|jpeg|png] - <filename> - export array <filename> - [big|little|native] - export nrrd <filename> - [big|little|native] - export envi <header> [<filename>] - [big|little|native] - export jpeg <filename> - [1-100] - export tiff <filename> - [none|jpeg|packbits|deflate] - - Example: - ds9.set (string cmd) - export array foo.arr little - export nrrd foo.nrrd little - export envi foo.hdr little - export envi foo.hdr foo.bsq little - export tiff foo.tiff jpeg - export jpeg foo.jpeg 75 - export png foo.png - file - Query currently loaded file information. - Syntax: - file - - Example: - string value = ds9.get(string cmd) - file - - fits - Load a FITS image into the current frame or query the currently - loaded image. - - Syntax: - fits [new|mask|slice] [<filename>] -      [width|height|depth|bitpix|type] -    [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -     [header [<ext>] [keyword - <string>]] -      [image|table|slice] - - Example: - string value = ds9.get(string cmd) - fits - fits width - fits height - fits depth - fits bitpix - fits type - fits size - fits size wcs fk5 arcmin - fits header # primary - fits header 2 # hdu 2 - fits header -2 # hdu 2 with inherit - fits header keyword BITPIX - fits header 1 keyword BITPIX - fits image - fits table - fits slice - ds9.set(string cmd, string url) - fits foo.fits - fits new foo.fits - fits bar.fits[bin=detx,dety] - fits slice foo.fits - fits mask foo.fits - fits - fits new - fits -[bin=detx,dety] - fits slice - fits mask - Syntax: - - fits [new|mask|slice] [<filename>] -      [width|height|depth|bitpix] -    [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -     [header [<ext>] [keyword - <string>]] -      [image|table|slice] - - Example: - string value = ds9.get(string cmd) - fits width - fits height - fits depth - fits bitpix - fits size - fits size wcs fk5 arcmin - fits header # primary - fits header 2 # hdu 2 - fits header -2 # hdu 2 with inherit - fits header keyword BITPIX - fits header 1 keyword BITPIX - fits - fits image - fits table - fits slice - ds9.set(string cmd, string url) - fits foo.fits - fits new foo.fits - fits bar.fits[bin=detx,dety] - fits slice foo.fits - fits mask foo.fits - - frame - Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility. - Syntax: - frame [center [#|all]] - [clear [#|all]] -       [new [rgb|3d]] - [delete [#|all]] - [reset [#|all]] -     [refresh [#|all]] -       [hide [#|all]] -     [show [#|all]] -       [move first] -       [move back] -       [move forward] -       [move last] - [first] -     [prev] - [next] - [last] - [frameno #] -     [#] -       [match <coordsys>] -       [lock <coordsys>|none] -       [has + +Example: +string url = ds9.get(string cmd) +array +array little + +ds9.set(string command, string url) +array foo.arr[dim=512,bitpix=-32,endian=little] +array new foo.arr[dim=512,bitpix=-32,endian=little] +array mask foo.arr[dim=512,bitpix=-32,endian=little] +bg +background +Set image background color. +Syntax: +bg <color> + +Example: +string url = ds9.get(string cmd) +bg + +ds9.set(string cmd) +bg red +bg red +backup +Create a backup save set. +Syntax: +backup <filename> + +Example: +ds9.set(string cmd) +backup ds9.bck +bin +Controls binning factor, binning buffer size, and binning +function for binning FITS bin tables. The access point blocking is +provided for backward compatibility. +Syntax: +bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<vector>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +bin about +bin buffersize +bin cols +bin factor +bin depth +bin filter +bin function +bin smooth +bin smooth function +bin smooth radius +bin lock + +ds9.set(string cmd) +bin about 4096 4096 +bin about center +bin buffersize 512 +bin cols detx dety +bin colsz detx dety time +bin factor 4 +bin factor 4 2 +bin depth 10 +bin filter 'pha > 5' +bin filter clear +bin function sum +bin in +bin out +bin to fit +bin match +bin lock yes +bin open +bin close +blink +Blink mode parameters. Interval is in seconds. +Syntax: +blink [] +    [yes|no] +    [interval <value>] + +Example: +string value = ds9.get(string cmd) +blink +blink interval + +ds9.set(string cmd) +blink +blink yes +blink interval 1 +block +Controls blocking parameters. +Syntax: +block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +block +block lock + +ds9.set(string cmd) +block4 +block4 2 +blockto 4 +blockto 4 2 +blockin +blockout +blockto fit +blockmatch +blocklock yes +blockopen +blockclose +catalog +cat +Support for catalogs. The first three commands will create a new +catalog search. All other commands operated on the last search +created, unless indicated otherwise. +Syntax: +catalog [new] +    [ned|simbad|denis|skybot] +    +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] + +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> +<coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match] +    [<ref>] [match <ref> +<ref>] +    [<ref>] [match error <value> +degrees|arcmin|arcsec] +    [<ref>] [match function +1and2|1not2|2not1] +    [<ref>] [match return +1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> +<xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send +<application>] +    [<ref>] [save <filename>] +    [<ref>] +[servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>] +    [<ref>] [symbol [#] +text|size|size2|units|angle <value>] +    [<ref>] [symbol shape +circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box +point|diamond point|cross point|x point|arrow point|boxcircle +point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load +<filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +string value = ds9.get(string cmd) +catalog +catalog header + +ds9.set(string cmd) +catalog new +catalog 2mass +catalog cds 2mass +catalog cds{I/252} + +catalog load foo.xml +catalog import tsv foo.tsv + +catalog allrows +catalog allcols +catalog cancel +catalog clear +catalog close +catalog coordinate 202.48 47.21 fk5 +catalog crosshair +catalog dec DEC +catalog edit yes +catalog export tsv bar.tsv +catalog filter {$Jmag>10} +catalog filter load foo.flt +catalog header +catalog location 500 +catalog match error 2 arcsec +catalog match function 1and2 +catalog match unique no +catalog match return 1only +catalog match # last two catalogs loaded +catalog match 2mass csc +catalog maxrows 2000 +catalog name m51 +catalog panto no +catalog plot{$Jmag} {$Hmag} {$e_Jmag} {$e_Hmag} +catalog print +catalog psky fk5 +catalog psystem wcs +catalog ra RA +catalog regions +catalog retrieve +catalog samp broadcast +catalog samp send aladin +catalog save foo.xml +catalog server sao +catalog show yes +catalog radius 1 degrees +catalog symbol condition{$Jmag>15} +catalog symbol 2 shape{boxcircle point} +catalog symbol color red +catalog symbol font times +catalog symbol fontsize 14 +catalog symbol fontweight bold +catalog symbol fontslant italic +catalog symbol add +catalog symbol 2 remove +catalog symbol load foo.sym +catalog symbol save bar.sym +catalog sky fk5 +catalog skyformat degrees +catalog sort {Jmag} incr +catalog system wcs +catalog update +catalog x RA +catalog y DEC +cd +Sets/Returns the current working directory. +Syntax: +cd [<directory>] + +Example: +string value = ds9.get(string cmd) +cd + +ds9.set(string cmd) +cd /home/mrbill +cmap +Controls the colormap for the current frame. The colormap name +is not case sensitive. A valid contrast value is from 0 to 10 +and bias value from 0 to 1. +Syntax: +cmap [<colormap>] +    [file] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<constrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +string value = ds9.get(string cmd) +cmap +cmap file +cmap invert +cmap value +cmap lock + +ds9.set(string cmd) +cmap Heat +cmap load foo.sao +cmap save bar.sao +cmap invert yes +cmap 5 .5 +cmap tag load foo.tag +cmap tag save foo.tag +cmap tag delete +cmap open +cmap close +colorbar +Controls colorbar parameters. +Syntax: +colorbar [] +    [yes|no] +    [orientation] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] + +Example: +string value = ds9.get(string cmd) +colorbar +colorbar orientation +colorbar numerics +colorbar space +colorbar font +colorbar fontsize +colorbar fontweight +colorbar fontslant +colorbar size +colorbar ticks + +ds9.set(string cmd) +colorbar yes +colorbar vertical +colorbar numerics yes +colorbar space value +colorbar font times +colorbar fontsize 14 +colorbar fontwieght bold +colorbar fontslant italic +colorbar size 20 +colorbar ticks 11 +colorbar match +colorbar lock yes +console +Display tcl console window. +Syntax: +-console + +Example: +ds9.set(string cmd) +console +contour +Controls contours in the current frame. +Syntax: +contour [] +    [yes|no] +    [<coordsys> [<skyframe>]] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> +<skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> +<width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale +linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [scale log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +contour +contour color +contour width +contour dash +contour smooth +contour method +contour nlevels +contour scale +contour log exp +contour mode +contour scope +contour limits +contour levels +string url = ds9.get(string cmd) +contour wcs fk5 + +ds9.set(string cmd) +contour +contour yes +contour clear +contour generate +contour load ds9.ctr +contour save ds9.con +contour save ds9.con wcs fk5 +contour convert +contour load levels ds9.ctr +contour save levels ds9.lev +contour copy +contour paste +contour paste wcs red 2 no +contour color yellow +contour width 2 +contour dash yes +contour smooth 5 +contour method smooth +contour nlevels 10 +contour scale sqrt +contour log exp 1000 +contour mode zscale +contour scope local +contour limits 1 100 +contour levels 1 10 100 1000 +contour open +contour close +crop +Set current image display area. +Syntax: +crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3dzmin zmax <coordsys>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +crop # get crop in physical coords +crop wcs galactic sexagesimal arcsec +crop lock + +ds9.set(string cmd) +crop 40 30 10 20 # set crop in physical coords +crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs +galactic arcsec +crop match wcs +crop lock wcs +crop reset +crop 3d .25 .5 wcs +crop open +crop close +crosshair +Controls the current position of the crosshair in the current +frame. DS9 is placed in crosshair mode when the crosshair is +set. +Syntax: +crosshair [<x> <y> <coordsys> +[<skyframe>]] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +string value = ds9.get(string cmd) +crosshair # get crosshair in physical coords +crosshair wcs fk4 sexagesimal # get crosshair in wcs coords +crosshair lock + +ds9.set(string cmd) +crosshair 100 100 physical # set crosshair in physical +crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords +crosshair 23:01:00 +58:52:51 wcs fk5 +crosshair match wcs +crosshair lock wcs +cube +Controls FITS cube. +Syntax: +cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +cube +cube wcs +cube interval +cube lock +cube order +cube axes lock + +ds9.set(string cmd) +cube +cube play +cube last +cube 3 +cube 4.5 wcs +cube interval 2 +cube match wcs +cube lock wcs +cube order 123 +cube axes lock yes +cube open +cube close +cursor +Move mouse pointer or crosshair in image pixels in the current +frame. Note, this will move selected Regions also. +Syntax: +cursor [<x> <y>] + +Example: +ds9.set(string cmd) +cursor 10 10 +data +Return an array of data values given a lower left corner and a +width and height in specified coordinate system. The last argument +of yes indicates to strip the coordinates from the output and just +list the data values. The default is yes. +Syntax: +data [<coordsys> [<skyframe>] <x> <y> +<width> <height> [yes|no]] + +Example: +string url = ds9.get(string cmd) +data image 450 520 3 3 yes +data physical 899 1039 6 6 no +data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no +data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 +no +dsssao +dss +Support for Digital Sky Survey at SAO. +Syntax: +dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dsssao name +dsssao coord +dsssao size +dsssao save +dsssao frame + +ds9.set(string cmd) +dsssao +dsssao m31 +dsssao name m31 +dsssao name clear +dsssao 00:42:44.404 +41:16:08.78 +dsssao size 60 60 arcmin +dsssao save yes +dsssao frame current +dsssao update frame +dsssao open +dsssao close +dsseso +Support for Digital Sky Survey at ESO. +Syntax: +dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dsseso name +dsseso coord +dsseso size +dsseso save +dsseso frame +dsseso survey + +ds9.set(string cmd) +dsseso +dsseso m31 +dsseso name m31 +dsseso name clear +dsseso 00:42:44.404 +41:16:08.78 +dsseso size 60 60 arcmin +dsseso save yes +dsseso frame current +dsseso update frame +dsseso survey DSS2-red +dsseso open +dsseso close +dssstsci +Support for Digital Sky Survey at STSCI. +Syntax: +dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey +poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dssstsci name +dssstsci coord +dssstsci size +dssstsci save +dssstsci frame +dssstsci survey + +ds9.set(string cmd) +dssstsci +dssstsci m31 +dssstsci name m31 +dssstsci name clear +dssstsci 00:42:44.404 +41:16:08.78 +dssstsci size 60 60 arcmin +dssstsci save yes +dssstsci frame current +dssstsci update frame +dssstsci survey all +dssstsci open +dssstsci close +envi +Load an ENVI header and file. Optional parameter: array +endian. +Syntax: +envi [new] <header> [<filename>] + +Example: +ds9.set(string cmd) +envi foo.hdr +envi new foo.hdr envi foo.hdr foo.bsq + +exit +quit +Quits DS9. +Syntax: +exit +quit + +Example: +ds9.set(string cmd) +exit +export +Export loaded image data of current frame in specified image +format. Optional parameters: array endian, nrrd endian, jpeg +quality (1-100) and tiff compression method. +Syntax: +export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> +export array <filename>[big|little|native] +export nrrd <filename>[big|little|native] +export envi <header> +[<filename>][big|little|native] +export jpeg <filename>[1-100] +export tiff <filename>[none|jpeg|packbits|deflate] + +Example: + +ds9.set (string cmd) +export array foo.arr little +export nrrd foo.nrrd little +export envi foo.hdr little +export envi foo.hdr foo.bsq little +export tiff foo.tiff jpeg +export jpeg foo.jpeg 75 +export png foo.png +file +Query currently loaded file information. +Syntax: +file + +Example: +string value = ds9.get(string cmd) +file +fits +Load a FITS image into the current frame or query the currently +loaded image. +Syntax: +fits[new|mask|slice] [<filename>] +    [width|height|depth|bitpix|type] +    [size [wcs|wcsa...wcsz] +[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +    [header [<ext>] [keyword +<string>]] +    [image|table|slice] + +Example: +string value = ds9.get(string cmd) +fits +fits width +fits height +fits depth +fits bitpix +fits type +fits size +fits size wcs fk5 arcmin +fits header # primary +fits header 2 # hdu 2 +fits header -2 # hdu 2 with inherit +fits header keyword BITPIX +fits header 1 keyword BITPIX +fits image +fits table +fits slice + +ds9.set(string cmd, string url) +fits foo.fits +fits new foo.fits +fits bar.fits[bin=detx,dety] +fits slice foo.fits +fits mask foo.fits + frame +Controls frame functions. Frames may be created, deleted, reset, +and centered. While return the current frame number. If you goto a +frame that does not exists, it will be created. If the frame is +hidden, it will be shown. The 'frameno' option is available for +backward compatibility. +Syntax: +frame [center [#|all]] +    [clear [#|all]] +    [new [rgb|3d]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] +    [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] -       [has contour [aux]]] -       [has fits [ |bin|cube|mosaic]] -       [has marker - [highlite|paste|select|undo]] -       [has system <coordsys>] -       [has wcs - [<wcssys>]] -       [has wcs celestial - [<wcssys>]] -       [has wcs linear - [<wcssys>]] - - Example: - string value = ds9.get(string cmd) - frame # returns the id of the current frame - frame frameno # returns the id of the current frame - frame all # returns the id of all frames - frame active # returns the id of all active frames - frame lock - frame has amplifier - frame has datamin - frame has datasec - frame has detector - frame has grid - frame has iis - frame has irafmin - frame has physical - frame has smooth - frame has contour - frame has contour aux - frame has fits - frame has fits bin - frame has fits cube - frame has fits mosaic - frame has marker highlite - frame has marker paste - frame has marker select - frame has marker undo - frame has system physical - frame has wcs wcsa - frame has wcs celestial wcsa - frame has wcs linear wcsa - ds9.set(string cmd) - frame center # center current frame - frame center 1 # center 'Frame1' - frame center all # center all frames - frame clear # clear current frame - frame new # create new frame - frame new rgb # create new rgb frame - frame delete # delete current frame - frame reset # reset current frame - frame refresh # refresh current frame - frame hide # hide current frame - frame show 1 # show frame 'Frame1' - frame move first # move frame to first in order - frame move back # move frame back in order - frame move forward # move frame forward in order - frame move last # move frame to last in order - frame first # goto first frame - frame prev # goto prev frame - frame next # goto next frame - frame last # goto last frame - frame frameno 4 # goto frame 'Frame4', create if needed - frame 3 # goto frame 'Frame3', create if needed - frame match wcs - frame lock wcs - gif - Load GIF image into current frame. - - Syntax: - gif [new|slice] [<filename>] - - Example: - string value = ds9.get(string cmd) - gif - ds9.set(string cmd) - gif foo.gif - gif new foo.gif - gif slice foo.gif - gif - gif new - gif slice - grid - Controls coordinate grid. For grid numeric format syntax, - click here. - Syntax: - grid [] -       [yes|no] -       [type analysis|publication] -       [system <coordsys>] -       [sky <skyframe>] -       [skyformat <skyformat>] -       [grid yes|no] -       [grid color <color>] -       [grid width <value>] -       [grid dash yes|no] -       [grid gap1 <value>] -       [grid gap2 - <value>] -       [grid - gap3 <value>] -       [axes yes|no] -       [axes color <color>] -       [axes width <value>] -       [axes dash yes|no] -       [axes type interior|exterior] -       [axes origin - lll|llu|lul|luu|ull|ulu|uul|uuu] -     [format1 <format>] -       [format2 <format>] -       [tickmarks yes|no] -       [tickmarks color <color>] -       [tickmarks width <value>] -       [tickmarks dash yes|no] -       [border yes|no] -       [border color <color>] -       [border width <value>] -       [border dash yes|no] -       [numerics yes|no] -       [numerics font - times|helvetica|courier] -       [numerics fontsize <value>] -       [numerics fontweight normal|bold] -       [numerics fontslant roman|italic] -       [numerics color <color>] -       [numerics gap1 <value>] -       [numerics gap2 - <value>] -       [numerics - gap3 <value>] -       [numerics type - interior|exterior] -       [numerics vertical yes|no] -       [title yes|no] -       [title text <text>] -       [title def yes|no] -       [title gap <value>] -       [title font - times|helvetica|courier] -       [title fontsize <value>] -       [title fontweight normal|bold] -       [title fontslant roman|italic] -       [title color <color>] -       [labels yes|no] -       [labels text1 <text>] -       [labels text2 - <text>] -       [labels def1 yes|no] -       [labels def2 yes|no] -       [labels gap1 - <value>] -       [labels gap2 <value>] -       [labels font - times|helvetica|courier] -       [labels fontsize <value>] -       [labels fontweight normal|bold] -       [labels fontslant roman|italic] -       [labels color <color>] -       [reset] -       [load <filename>] -       [save <filename>] -       [open|close] - - Example: - string value = ds9.get(string cmd) - grid - grid type - grid system - grid sky - grid skyformat - grid grid - grid grid color - grid grid width - grid grid dash - grid grid gap1 - grid grid gap2 - grid grid gap3 - grid axes - grid axes color - grid axes width - grid axes dash - grid axes type - grid axes origin - grid format1 - grid format2 - grid tickmarks - grid tickmarks color - grid tickmarks width - grid tickmarks dash - grid border - grid border color - grid border width - grid border dash - grid numerics - grid numerics font - grid numerics fontsize - grid numerics fontweight - grid numerics fontslant - grid numerics color - grid numerics gap1 - grid numerics gap2 - grid numerics gap3 - grid numerics type - grid numerics vertical - grid title - grid title text - grid title def - grid title gap - grid title font - grid title fontsize - grid title fontweight - grid title fontslant - grid title color - grid labels - grid labels text1 - grid labels text2 - grid labels def1 - grid labels def2 - grid labels gap1 - grid labels gap2 - grid labels font - grid labels fontsize - grid labels fontweight - grid labels fontslant - grid labels color - ds9.set(string cmd) - grid - grid yes - grid type analysis - grid system wcs - grid sky fk5 - grid skyformat degrees - grid grid yes - grid grid color red - grid grid width 2 - grid grid dash yes - grid grid gap1 10 - grid grid gap2 10 - grid grid gap3 10 - grid axes yes - grid axes color red - grid axes width 2 - grid axes dash yes - grid axes type exterior - grid axes origin lll - grid format1 d.2 - grid format2 d.2 - grid tickmarks yes - grid tickmarks color red - grid tickmarks width 2 - grid tickmarks dash yes - grid border yes - grid border color red - grid border width 2 - grid border dash yes - grid numerics yes - grid numerics font courier - grid numerics fontsize 12 - grid numerics fontweight bold - grid numerics fontslant italic - grid numerics color red - grid numerics gap1 10 - grid numerics gap2 10 - grid numerics gap3 10 - grid numerics type exterior - grid numerics vertical yes - grid title yes - grid title text {Hello World} - grid title def yes - grid title gap 10 - grid title fontsize 12 - grid title font courier - grid title fontweight bold - grid title fontslant italic - grid title color red - grid labels yes - grid labels text1 {Hello World} - grid labels text2 {Hello World} - grid labels def1 yes - grid labels def2 yes - grid labels gap1 10 - grid labels gap2 10 - grid labels font courier - grid labels fontsize 12 - grid labels fontweight bold - grid labels fontslant italic - grid labels color red - grid reset - grid load foo.grd - grid save foo.grd - grid open - grid close - - header - Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from samp fits - header. - Syntax: - header [<ext>] -        [close [<ext>]] -        [save [<ext>] - <filename>] - - Example: - string value = ds9.get(string cmd) - header - header 2 - header close - - height - Set the height of the image display window. - Syntax: - height [<value>] - - Example: - string value = ds9.get(string cmd) - height - ds9.set(string cmd) - height 512 - - iconify - Toggles iconification. - Syntax: - iconify [] -         [yes|no] - - Example: - string value = ds9.get(string cmd) - iconify - ds9.set(string cmd) - iconify - iconify yes - iexam - Interactive examine function. A blinking cursor will indicate - to the user to click on a point on an image. The specified - information will be returned at that time. The default event is - button. In the last form, the following macros will be - expanded if present: $width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z. See Analysis - - - - - - - - - - - - - - Macros for more information. - Syntax: - iexam [] -       [[]|button|key|any] - coordinate <coordsys> [<skyframe>] - [<skyformat>] -       [[]|button|key|any] data - [width][height] -       [[]|button|key|any] - <macro string>] - - Example: - string value = ds9.get(string cmd) - iexam - iexam coordinate image - iexam key coordinate image # return coordinate and key event - iexam coordinate wcs fk5 degrees - iexam coordinate wcs galactic sexagesimal - iexam coordinate fk5 - iexam data # return data value - iexam key data # return data value and key event - iexam data 3 3 # return all data in 3x3 box about selected point - iexam {'Click at $x,$y in file $filename'} - iis - Set/Get IIS Filename. Optional mosaic number maybe supplied. - Syntax: - iis [filename <filename> [#]] - - Example: - string value = ds9.get(string cmd) - iis filename - iis filename 4 - ds9.set(string cmd) - iis filename foo.fits - iis filename bar.fits 4 - jpeg - Load JPEG image into current frame. Optional parameters: jpeg - quality (1-100) - Syntax: - jpeg [new|slice] [<filename>] [1-100] - - Example: - string value = ds9.get(string cmd) - jpeg - jpeg 100 - ds9.set(string cmd) - jpeg foo.jpeg - jpeg new foo.jpeg - jpeg slice foo.jpeg - jpeg - jpeg new - jpeg slice - lock - Lock all other frames to the current frame. - Syntax: - lock [frame - <coordsys>|none] -      [crosshair - <coordsys>|none] -      [crop - <coordsys>|none] -      [slice - <coordsys>|none] -      [bin [yes|no]] -      [axes [yes|no]] -      [scale [yes|no]] -      [scalelimits [yes|no]] -      [colorbar [yes|no]] -      [block [yes|no]] -      [smooth - [yes|no]] -      [3d - [yes|no]] - - Example: - string value = ds9.get(string cmd) - lock frame - lock crosshair - lock crop - lock slice - lock bin - lock axes - lock scale - lock scalelimits - lock colorbar - lock block - lock smooth - lock 3d - ds9.set(string cmd) - lock frame wcs - lock crosshair wcs - lock crop wcs - lock slice wcs - lock bin yes - lock axes yes - lock scale yes - lock scalelimits yes - lock colorbar yes - lock block yes - lock smooth yes - lock 3d yes - - lower - Lower in the window stacking order. - Syntax: - lower - - Example: - ds9.set(string cmd) - lower - - magnifier - Controls the magnifier settings. - Syntax: - magnifier [color <color>] -           [zoom - <value>] -           [cursor - yes|no] -           [region - yes|no] - - Example: - string value = ds9.get(string cmd) - magnifier color - magnifier zoom - magnifier cursor - magnifier region - ds9.set(string cmd) - magnifier color yellow - magnifier zoom 2 - magnifier cursor no - magnifier region no - - mask - - Controls mask parameters. - Syntax: - mask [color <color>] -      [mark zero|nonzero|nan|nonnan|range] -      [range <low> <high>] -      [transparency <value>] -      [system <coordsys>] -      [clear] -      [open|close] - - Example: - string value = ds9.get(string cmd) - mask color - mask mark - mask range - mask system - mask transparency - ds9.set(string cmd) - mask color red - mask mark zero - mask range 10 100 - mask transparency 50 - mask system wcs - mask clear - mask open - mask close - - match - Match all other frames to the current frame. - Syntax: - match [frame <coordsys>] -       [crosshair - <coordsys>] -       [crop <coordsys>] -       [slice <coordsys>] -       [bin] -       [axes] -       [scale] -       [scalelimits] -       [colorbar] -       [block] -       [smooth] -       [3d] - - Example: - ds9.set(string cmd) - match frame wcs - match crosshair wcs - match crop wcs - match slice wcs - match bin - match axes - match scale - match scalelimits - match colorbar - match block - match smooth - match 3d - - mecube - Load FITS multiple extension file as data cube. - - Syntax: - mecube [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - mecube - ds9.set(string cmd) - mecube foo.fits - mecube new foo.fits - mecube - mecube new - minmax - This is how DS9 determines the min and max data values - from the data. SCAN will scan all data. - Syntax: - minmax [scan|sample|datamin|irafmin] -        [mode - scan|sample|datamin|irafmin] -        [interval #] - - Example: - string value = ds9.get(string cmd) - minmax mode - minmax sample - ds9.set(string cmd) - minmax scan - minmax mode scan - minmax interval 100 - - mode - Controls the first mouse button mode. - Syntax: - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - string value = ds9.get(string cmd) - mode - ds9.set(string cmd) - mode crosshair - mosaic - Load FITS mosaic segment into current frame. - Syntax: - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] - - Example: - string value = ds9.get(string cmd) - mosaic - ds9.set(string cmd) - mosaic foo.fits - mosaic wcs foo.fits - mosaic wcs new foo.fits - mosaic wcs mask foo.fits - mosaic - mosaic wcs - mosaic wcs new - mosaic wcs mask - - mosaicimage - Load FITS mosaic image into current frame. - Syntax: - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>] - - Example: - string value = ds9.get(string cmd) - mosaicimage - ds9.set(string cmd) - mosaicimage foo.fits - mosaicimage wcs foo.fits - mosaicimage wcs new foo.fits - mosaicimage wcs mask foo.fits - mosaicimage - mosaicimage wcs - mosaicimage wcs new - mosaicimage wcs mask - movie - Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times. - Syntax: - movie [slice|frame|3d] [mpeg|gif] - <filename> - movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - ds9.set(string cmd) - movie slice mpeg ds9.mpg - movie frame gif ds9.gif - movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 - oscillate 1 - multiframe - Load FITS multiple extension file as multiple images. - - Syntax: - multiframe [<filename>] - - Example: - ds9.set(string cmd) - multiframe foo.fits - multiframe - nameserver - Support Name Server functions. Coordinates are in fk5. - Syntax: - nameserver [<object>] -            - [name <object>] -            - [server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] -            - [skyformat degrees|sexagesimal] -            - [pan] -            - [crosshair] -            [close] - - Example: - string value = ds9.get(string cmd) - nameserver - nameserver server - nameserver skyformat - nameserver m31 - ds9.set(string cmd) - nameserver m31 - nameserver name m31 - nameserver server ned-sao - nameserver skyformat sexagesimal - nameserver pan - nameserver crosshair - nameserver open - nameserver close - - nan - Set image not-a-number color. - Syntax: - nan <color> - - Example: - string value = ds9.get(string cmd) - nan - ds9.set(string cmd) - nan red - nrrd - Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian. - - Syntax: - nrrd [native|little|big] - nrrd [new|mask] [<filename>] - - Example: - string value = ds9.get(string cmd) - nrrd - nrrd big - ds9.set(string cmd, string url) - nrrd foo.nrrd - nrrd new foo.nrrd - nrrd mask foo.nrrd - nrrd - nrrd new - nrrd mask - nvss - Support for NRAO VLA Sky Survey. - Syntax: - nvss [] -      [<object>] -      [name <object>|clear] -      [<ra> <dec>] # in wcs fk5 -      [size <width> <height> - degrees|arcmin|arcsec] -      [save yes|no] -      [frame new|current] -      [update frame|crosshair] -      [open|close] - - Example: - string value = ds9.get(string cmd) - nvss name - nvss coord - nvss size - nvss save - nvss frame - ds9.set(string cmd) - nvss - nvss m31 - nvss name m31 - nvss name clear - nvss 00:42:44.404 +41:16:08.78 - nvss size 60 60 arcmin - nvss save yes - nvss frame current - nvss update frame - nvss open - nvss close - - orient - Controls the orientation of the current frame. - Syntax: - orient [none|x|y|xy] -        [open|close] - - Example: - string value = ds9.get(string cmd) - orient - ds9.set(string cmd) - orient xy - orient open - orient close - - pagesetup - Controls Page Setup options. - Syntax: - pagesetup [orient portrait|landscape] -           [scale - <numeric>] -           [size - letter|legal|tabloid|poster|a4] - - Example: - string value = ds9.get(string cmd) - pagesetup orient - pagesetup scale - pagesetup size - ds9.set(string cmd) - pagesetup orient portrait - pagesetup scale 50 - pagesetup size poster - - pan - Controls the current image cursor location for the current - frame. - Syntax: - pan [<coordsys> [<skyframe>] - [<skyformat>]] # get current coords - - pan [<x> <y> <coordsys> - [<skyframe>]] # relative -     [to <x> <y> <coordsys> - [<skyframe>]] # absolute -     [open|close] -     [close] - - Example: - string value = ds9.get(string cmd) - pan # get current image coords - pan wcs fk4 sexagesimal # get current wcs coords - ds9.set(string cmd) - pan 200 200 image # pan relative - pan to 400 400 physical # pan to physical coords - pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords - pan open - pan close - - pixeltable - Display/Hide the pixel table. - Syntax: - pixeltable [] -            [yes|open] -            [no|close] - - Example: - string url = ds9.get(string cmd) - pixeltable - ds9.set(string cmd) - pixeltable - pixeltable yes - pixeltable open - pixeltable close - - plot - Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions: - xy    x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors - - To create a new plot, use the plot new command. - Syntax: - # create new empty plot window - plot [] -      - [line|bar|scatter] -      [new] -      [new - line|bar|scatter] -      [new name - <plotname>] -      [new name - <plotname> line|bar|scatter] - - # load data into - existing plot from stdin - plot [[<plotname>] data - xy|xyex|xyey|xyexey] - - # existing plot - plot [[<plotname>] - - - - - - - - - - - - load <filename> xy|xyex|xyey|xyexey] -      - [[<plotname>] save <filename>] -      - [[<plotname>] clear] -      [[<plotname>] - - - - - - - - - - - - - duplicate [#]] -      [[<plotname>] - - - - - - - - - - - - - stats yes|no] -      [[<plotname>] - - - - - - - - - - - - - list yes|no] -      [[<plotname>] - - - - - - - - - - - - - loadconfig <filename>] -      - [[<plotname>] saveconfig <filename>] -      - [[<plotname>] pagesetup orient portrait|landscape] -      - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] -      - [[<plotname>] print] -    - [[<plotname>] print destination printer|file] -      - [[<plotname>] print command <command>] -      - [[<plotname>] print filename <filename>] -      - [[<plotname>] print color rgb|gray] -      [[<plotname>] - - - - - - - - - - - - - close] -      [[<plotname>] - - - - - - - - - - - - - mode pointer|zoom] - - # export image - plot [[<plotname>] - - - - - - - - - - - - export [gif|tiff|jpeg|png] - <filename> -      [[<plotname>] - - - - - - - - - - - - export jpeg <filename> [1-100] -      [[<plotname>] - - - - - - - - - - - - export tiff <filename> [none|jpeg|packbits|deflate] - - # configure graph - plot [[<plotname>] axis x|y - grid yes|no] -      - [[<plotname>] axis x|y log yes|no] -      - [[<plotname>] axis x|y flip yes|no] -    - [[<plotname>] axis x|y auto yes|no] -    - [[<plotname>] axis x|y min <value>] -    - [[<plotname>] axis x|y max <value>] -    - [[<plotname>] axis x|y format <string>] -      [[<plotname>] - - - - background <value>] -      [[<plotname>] - - - - - - - - - - - - legend yes|no] -      - [[<plotname>] legend position right|left|top|bottom] -    - [[<plotname>] font title|labels|numbers font - times|helvetica|courier] -    - [[<plotname>] font title|labels|numbers - size <value>] -    - [[<plotname>] font title|labels|numbers - weight normal|bold] -    - [[<plotname>] font title|labels|numbers - slant roman|italic] -    - [[<plotname>] title <string>] -    - [[<plotname>] title x|y <string>] -      [[<plotname>] - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap] - - # configure current dataset - plot [[<plotname>] show - yes|no] -    [[<plotname>] - - - - - - - - - - - - shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -      [[<plotname>] - - - - - - - - - - - - - shape fill yes|no] -      [[<plotname>] - - - - - - - - - - - - - shape color <value>] -      [[<plotname>] - - - - - - - - - - - - - smooth step|linear|cubic|quadratic|catrom] -      [[<plotname>] - - - - - - - - - - - - - color <value>] -      [[<plotname>] - - - - - - - - - - - - - width <value>] -      [[<plotname>] - - - - - - - - - - - - - dash yes|no] -      [[<plotname>] - - - - - - - - - - - - - error yes|no] -      [[<plotname>] - - - - - - - - - - - - - error color <value>] -      - [[<plotname>] error cap yes|no] -      [[<plotname>] - - - - - - - - - - - - - error width <value>] -      [[<plotname>] - - - - - - - - - - - - - name <string>] - - # select current dataset - plot [[<plotname>] select - <value>] - - Example: - # return all plotnames - string value = ds9.get(string cmd) - plot - - # create new empty plot window - ds9.set(string cmd) - plot - plot bar - plot new - plot new bar - plot new name foo - plot new name foo bar - - # load additional dataset into an - existing plot - ds9.set(string cmd, string url) - plot data xy # plot additional data - plot foo data xy # plot additional - data - - string value = ds9.get(string cmd) - plot stats - plot list - ds9.set(string cmd) - plot load foo.dat xy - plot save foo.dat - plot clear - plot duplicate 1 - plot stats yes - plot list yes - plot loadconfig foo.plt - plot saveconfig foo.plt - plot pagesetup orient portrait - plot pagesetup size letter - plot print - plot print destination file - plot print command lp - plot print filename foo.ps - plot print color rgb - plot close - - string value = ds9.get(string cmd) - plot mode - ds9.set(string cmd) - plot mode pointer - - # export plot - ds9.set(string - - - cmd) - plot export tiff foo.tiff - jpeg - plot export jpeg foo.jpeg 75 - plot export png foo.png - - # configure plot - string value = ds9.get(string cmd) - plot axis x grid - plot axis x log - plot axis x flip - plot axis x auto - plot axis x min - plot axis x max - plot axis x format - plot legend - plot legend position - plot font numbers font - plot font numbers size - plot font numbers weight - plot font numbers slant - plot title - plot title x - plot barmode - ds9.set(string cmd) - plot axis x grid yes - plot axis x log yes - plot axis x flip yes - plot axis x auto no - plot axis x min 0 - plot axis x max 100 - plot axis x format "%f" - - string value = - ds9.get(string cmd) - plot background - ds9.set(string cmd) - plot background white - - string value = - ds9.get(string cmd) - plot legend - plot legend position - ds9.set(string cmd) - plot legend yes - plot legend position left - - string value = ds9.get(string cmd) - plot font numbers font - plot font numbers size - plot font numbers weight - plot font numbers slant - ds9.set(string cmd) - plot font numbers font times - plot font numbers size 12 - plot font numbers weight bold - plot font numbers slant italic - - string value = ds9.get(string cmd) - plot title - plot title xaxis - plot title yaxis - ds9.set(string cmd) - plot title "This is a Title" - plot title x "X Axis" - plot title y "Y Axis" - plot title legend "This is the - Legend" - - string value = ds9.get(string cmd) - plot barmode - ds9.set(string cmd) - plot barmode aligned - - # configure current dataset - string value = ds9.get(string cmd) - plot show - plot shape - plot shape fill - plot shape color - plot smooth - plot color - plot width - plot dash - plot error - plot error color - plot error cap - plot error width - plot name - ds9.set(string cmd) - plot show yes - plot shape circle - plot shape fill no - plot shape color cyan - plot smooth step - plot color red - plot width 2 - plot dash yes - plot error yes - plot error color red - plot error cap yes - plot error width 2 - plot name "My Data" - - # select current dataset - string value = ds9.get(string cmd) - plot select - ds9.set(string cmd) - plot select 2 - - png - Load PNG image into current frame. - - Syntax: - png [new|slice] [<filename>] - - Example: - string value = ds9.get(string cmd) - png - ds9.set(string cmd) - png foo.png - png new foo.png - png slice foo.png - png - png new - png slice - precision - Set region and coordinate output format precision. - Syntax: - precision <linear> <degree> - <hms> <dms> - <arcmin> <arcsec> - - Example: - string value = ds9.get(string cmd) - precision - ds9.set(string cmd) - precision 8 10 4 3 5 3 - prefs - Controls various preference settings. - Syntax: - prefs [clear] -       [irafalign yes|no] - - Example: - string value = ds9.get(string cmd) - prefs irafalign - ds9.set(string cmd) - prefs clear - prefs irafalign - - preserve - Preserve the follow attributes while loading a new image. - Syntax: - preserve [pan yes|no] -    [regions yes|no] - - Example: - string value = ds9.get(string cmd) - preserve pan - preserve regions - ds9.set(string cmd) - preserve pan yes - preserve regions yes - - psprint - Invokes postscript printing. Please see print - for further details. - print - Controls printing. Use print option to set printing options. - Syntax: - print [destination printer|file] -       [command <command>] -       [filename <filename>] -       [color rgb|cmyk|gray] -       [level 1|2|3] -       [resolution 72|screen|96|144|150|225|300|600|1200] - - Example: - string value = ds9.get(string cmd) - print destination - print command - print filename - print color - print level - print resolution - ds9.set(string cmd) - print - print destination file - print command lp - print filename foo.ps - print color cmyk - print level 2 - print resolution 96 - raise - Raise in the window stacking order. - Syntax: - raise - - Example: - ds9.set(string cmd) - raise - regions - Controls regions in the current frame. - Syntax: - regions [<filename>] -         [load [all] - <filename>] -         [save - <filename>] -         [list [close]] -         [epsilon - <integer>] -         [show yes|no] -         [showtext yes|no] -         [centroid] -         [centroid auto - yes|no] -         [centroid radius - <value>|iteration <value>] -         [getinfo] -         [move front] -         [move back] -         [select all] -         [select none] -         [select invert] -         [delete all] -         [delete select] -         [format - ds9|xml|ciao|saotng|saoimage|pros|xy] -         [system - image|physical|wcs|wcsa...wcsz] -         [sky - fk4|fk5|icrs|galactic|ecliptic] -         [skyformat - degrees|sexagesimal] -         [strip yes|no] -         [shape <shape>] -         [color - &ltcolor>] -         [width <width>] -         - [fixed|edit|rotate|delete yes|no] -         - [include|exclude|source|background] -         [command <marker - command>] -         [composite] -         [dissolve] -         [template - <filename>] -         [template <filename> - at <ra> <dec> <coordsys> <skyframe>] -         [savetemplate - <filename>] -         [groups] -         [group new] -         [group <tag> - new] -         [group <tag> - update] -         [group <tag> select] -         [group <tag> color - <color>] -         [group <tag> copy] -         [group <tag> delete] -         [group <tag> cut] -         [group <tag> font - <font>] -         [group <tag> move - <int> <int>] -         [group <tag> - movefront] -         [group <tag> - moveback] -         [group <tag> - property <property> yes|no] -         [copy] -         [cut] -         [paste - image|physical|wcs|wcsa...wcsz] -         [undo] -         - [include|exclude|source|background|selected] -         [-format - ds9|ciao|saotng|saoimage|pros|xy] -         [-system - image|physical|wcs|wcsa...wcsz] -         [-sky - fk4|fk5|icrs|galactic|ecliptic] -         [-skyformat - degrees|sexagesimal] -         [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0] -         [-group <tag>] -         [-strip yes|no] -         [-wcs yes|no] - - Example: - string url = ds9.get(string cmd) - regions - regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal - -prop edit 1 -group foo - string value = ds9.get(string cmd) - regions epsilon - regions show - regions showtext - regions centroid - regions centroid auto - regions centroid radius - regions centroid iteration - regions selected - regions format - regions system - regions sky - regions skyformat - regions strip - regions shape - regions color - regions width - regions source - regions background - regions include - regions exclude - regions selected - regions groups - ds9.set(string cmd, string url) - regions -format xy -system wcs -sky fk5 - regions -format ds9 - ds9.set(string cmd) - regions foo.reg - regions -format ciao bar.reg # load as ciao format - regions foo.fits # FITS regions files do not need a format - specification - regions load foo.reg # load foo.reg into current frame - regions load all foo.reg # load foo.reg into all frames - regions load *.reg# expand *.reg and load into current frame - regions load all *.reg # expand *.reg and load into all frames - regions save foo.reg - regions list - regions list close - regions epsilon 5 - regions show yes - regions showtext no - regions centroid - regions centroid auto yes - regions centroid radius 10 - regions centroid iteration 20 - regions getinfo - regions move back - regions move front - regions select all - regions select none - regions select invert - regions delete all - regions delete select - regions format ds9 - regions system wcs - regions sky fk5 - regions skyformat degrees - regions strip yes - regions shape ellipse - regions color red - regions width 3 - regions edit yes - regions include - regions command "circle 100 100 20 # color=red" - regions composite - regions dissolve - regions template foo.tpl - regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 - regions savetemplate foo.tpl - regions group new - regions group foo new - regions group foo update - regions group foo select - regions group foo color red - regions group foo copy - regions group foo delete - regions group foo cut - regions group foo font 'times 14 bold' - regions group foo move 100 100 - regions group foo movefront - regions group foo moveback - regions group foo property delete no - regions copy - regions cut - regions paste wcs - regions undo - - restore - Restore DS9 to a previous state from a backup save set. - Syntax: - restore <filename> - - Example: - restore ds9.bck - rgb - Create RGB frame and control RGB frame parameters. - Syntax: - rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -    [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -      [open|close] - - Example: - string value = ds9.get(string cmd) - rgb channel - rgb lock wcs - rgb lock crop - rgb lock slice - rgb lock bin - rgb lock scale - rgb lock scalelimits - rgb lock colorbar - rgb lock block - rgb lock smooth - rgb system - rgb view red - rgb view green - rgb view blue - ds9.set(string cmd) - rgb # create new rgb frame - rgb red # set current channel to red - rgb channel red # set current channel to red - rgb view blue no # turn off blue channel - rgb system wcs # set rgb coordinate system - rgb lock wcs yes - rgb lock crop yes - rgb lock slice yes - rgb lock bin yes - rgb lock scale yes - rgb lock scalelimits yes - rgb lock colorbar yes - rgb lock block yes - rgb lock smooth yes - rgb open - rgb close - rgbarray - Load raw data array cube into rgb frame. - - Syntax: - rgbarray [native|big|little] - rgbarray [new] +    [has contour [aux]]] +    [has fits [ |bin|cube|mosaic]] +    [has marker [highlite|paste|select|undo]] +    [has system <coordsys>] +    [has wcs [<wcssys>]] +    [has wcs celestial [<wcssys>]] +    [has wcs linear [<wcssys>]] + +Example: +string value = ds9.get(string cmd) +frame # returns the id of the current frame +frame frameno # returns the id of the current frame +frame all # returns the id of all frames +frame active # returns the id of all active frames +frame lock +frame has amplifier +frame has datamin +frame has datasec +frame has detector +frame has grid +frame has iis +frame has irafmin +frame has physical +frame has smooth +frame has contour +frame has contour aux +frame has fits +frame has fits bin +frame has fits cube +frame has fits mosaic +frame has marker highlite +frame has marker paste +frame has marker select +frame has marker undo +frame has system physical +frame has wcs wcsa +frame has wcs celestial wcsa +frame has wcs linear wcsa + +ds9.set(string cmd) +frame center # center current frame +frame center 1 # center 'Frame1' +frame center all # center all frames +frame clear # clear current frame +frame new # create new frame +frame new rgb # create new rgb frame +frame delete # delete current frame +frame reset # reset current frame +frame refresh # refresh current frame +frame hide # hide current frame +frame show 1 # show frame 'Frame1' +frame move first # move frame to first in order +frame move back # move frame back in order +frame move forward # move frame forward in order +frame move last # move frame to last in order +frame first # goto first frame +frame prev # goto prev frame +frame next # goto next frame +frame last # goto last frame +frame frameno 4 # goto frame 'Frame4', create if needed +frame 3 # goto frame 'Frame3', create if needed +frame match wcs +frame lock wcs +gif +Load GIF image into current frame. +Syntax: +gif [new|slice] [<filename>] + +Example: +string value = ds9.get(string cmd) +gif +gifnew +gifslice + +ds9.set(string cmd) +gif foo.gif +gif new foo.gif +gif slice foo.gif +grid +Controls coordinate grid. For grid numeric format syntax, +click here. +Syntax: +grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin +lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +grid +grid type +grid system +grid sky +grid skyformat +grid grid +grid grid color +grid grid width +grid grid dash +grid grid gap1 +grid grid gap2 +grid grid gap3 +grid axes +grid axes color +grid axes width +grid axes dash +grid axes type +grid axes origin +grid format1 +grid format2 +grid tickmarks +grid tickmarks color +grid tickmarks width +grid tickmarks dash +grid border +grid border color +grid border width +grid border dash +grid numerics +grid numerics font +grid numerics fontsize +grid numerics fontweight +grid numerics fontslant +grid numerics color +grid numerics gap1 +grid numerics gap2 +grid numerics gap3 +grid numerics type +grid numerics vertical +grid title +grid title text +grid title def +grid title gap +grid title font +grid title fontsize +grid title fontweight +grid title fontslant +grid title color +grid labels +grid labels text1 +grid labels text2 +grid labels def1 +grid labels def2 +grid labels gap1 +grid labels gap2 +grid labels font +grid labels fontsize +grid labels fontweight +grid labels fontslant +grid labels color + +ds9.set(string cmd) +grid +grid yes +grid type analysis +grid system wcs +grid sky fk5 +grid skyformat degrees +grid grid yes +grid grid color red +grid grid width 2 +grid grid dash yes +grid grid gap1 10 +grid grid gap2 10 +grid grid gap3 10 +grid axes yes +grid axes color red +grid axes width 2 +grid axes dash yes +grid axes type exterior +grid axes origin lll +grid format1 d.2 +grid format2 d.2 +grid tickmarks yes +grid tickmarks color red +grid tickmarks width 2 +grid tickmarks dash yes +grid border yes +grid border color red +grid border width 2 +grid border dash yes +grid numerics yes +grid numerics font courier +grid numerics fontsize 12 +grid numerics fontweight bold +grid numerics fontslant italic +grid numerics color red +grid numerics gap1 10 +grid numerics gap2 10 +grid numerics gap3 10 +grid numerics type exterior +grid numerics vertical yes +grid title yes +grid title text {Hello World} +grid title def yes +grid title gap 10 +grid title fontsize 12 +grid title font courier +grid title fontweight bold +grid title fontslant italic +grid title color red +grid labels yes +grid labels text1 {Hello World} +grid labels text2 {Hello World} +grid labels def1 yes +grid labels def2 yes +grid labels gap1 10 +grid labels gap2 10 +grid labels font courier +grid labels fontsize 12 +grid labels fontweight bold +grid labels fontslant italic +grid labels color red +grid reset +grid load foo.grd +grid save foo.grd +grid open +grid close +header +Display current fits header dialog. Optional extension number +maybe specified. Please note, this differs from samp fits +header. +Syntax: +header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +string value = ds9.get(string cmd) +header +header 2 +header close +height +Set the height of the image display window. +Syntax: +height [<value>] + +Example: +string value = ds9.get(string cmd) +height +ds9.set(string cmd) +height 512 +iconify +Toggles iconification. +Syntax: +iconify [] +    [yes|no] + +Example: +string value = ds9.get(string cmd) +iconify + +ds9.set(string cmd) +iconify +iconify yes +iexam +Interactive examine function. A blinking cursor will indicate to +the user to click on a point on an image. The specified information +will be returned at that time. The default event is +button. In the last form, the following macros will be +expanded if present: $width, $height, $depth, $bitpix, +$filename, $regions, $filename[$regions], $env, $pan, $value, $x, +$y, $z. See Analysis +Macros for more information. +Syntax: +iexam [] +    [[]|button|key|any] coordinate <coordsys> +[<skyframe>] [<skyformat>] +    [[]|button|key|any] data [width][height] +    [[]|button|key|any] <macro string>] + +Example: +string value = ds9.get(string cmd) +iexam +iexam coordinate image +iexam key coordinate image # return coordinate and key event +iexam coordinate wcs fk5 degrees +iexam coordinate wcs galactic sexagesimal +iexam coordinate fk5 +iexam data # return data value +iexam key data # return data value and key event +iexam data 3 3 # return all data in 3x3 box about selected +point +iexam {'Click at $x,$y in file $filename'} +iis +Set/Get IIS Filename. Optional mosaic number maybe supplied. +Syntax: +iis [filename <filename> [#]] + +Example: +string value = ds9.get(string cmd) +iis filename +iis filename 4 + +ds9.set(string cmd) +iis filename foo.fits +iis filename bar.fits 4 +jpeg +Load JPEG image into current frame. Optional parameters: +jpeg quality (1-100) +Syntax: +jpeg [new|slice] [<filename>] [1-100] + +Example: +string value = ds9.get(string cmd) +jpeg +jpegnew +jpegslice + +ds9.set(string cmd) +jpeg foo.jpeg +jpeg new foo.jpeg +jpeg slice foo.jpeg +lock +Lock all other frames to the current frame. +Syntax: +lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimits [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +string value = ds9.get(string cmd) +lock frame +lock crosshair +lock crop +lock slice +lock bin +lock axes +lock scale +lock scalelimits +lock colorbar +lock block +lock smooth +lock 3d + +ds9.set(string cmd) +lock frame wcs +lock crosshair wcs +lock crop wcs +lock slice wcs +lock bin yes +lock axes yes +lock scale yes +lock scalelimits yes +lock colorbar yes +lock block yes +lock smooth yes +lock 3d yes + lower +Lower in the window stacking order. +Syntax: +lower + +Example: +ds9.set(string cmd) +lower +magnifier +Controls the magnifier settings. +Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +string value = ds9.get(string cmd) +magnifier color +magnifier zoom +magnifier cursor +magnifier region +ds9.set(string cmd) +magnifier color yellow +magnifier zoom 2 +magnifier cursor no +magnifier region no +mask +Controls mask parameters. +Syntax: +mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] + +Example: +string value = ds9.get(string cmd) +mask color +mask mark +mask range +mask system +mask transparency + +ds9.set(string cmd) +mask color red +mask mark zero +mask range 10 100 +mask transparency 50 +mask system wcs +mask clear +mask open +mask close +match +Match all other frames to the current frame. +Syntax: +match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +ds9.set(string cmd) +match frame wcs +match crosshair wcs +match crop wcs +match slice wcs +match bin +match axes +match scale +match scalelimits +match colorbar +match block +match smooth +match 3d +mecube +Load FITS multiple extension file as data cube. +Syntax: +mecube [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +mecube + +ds9.set(string cmd) +mecube foo.fits +mecube new foo.fits +mecube +mecubenew +minmax +This is how DS9 determines the min and max data values +from the data. SCAN will scan all data. +Syntax: +minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +string value = ds9.get(string cmd) +minmax mode +minmax sample + +ds9.set(string cmd) +minmax scan +minmax mode scan +minmax interval 100 +mode +Controls the first mouse button mode. +Syntax: +mode +[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + +Example: +string value = ds9.get(string cmd) +mode + +ds9.set(string cmd) +mode crosshair +mosaic +Load FITS mosaic segment into current frame. +Syntax: +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + +Example: +string value = ds9.get(string cmd) +mosaic + +ds9.set(string cmd) +mosaic foo.fits +mosaic wcs foo.fits +mosaic wcs new foo.fits +mosaic wcs mask foo.fits +mosaic +mosaic wcs +mosaic wcsnew +mosaic wcsmask +mosaicimage +Load FITS mosaic image into current frame. +Syntax: +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] +[<filename>] + +Example: +string value = ds9.get(string cmd) +mosaicimage +ds9.set(string cmd) +mosaicimage foo.fits +mosaicimage wcs foo.fits +mosaicimage wcs new foo.fits +mosaicimage wcs mask foo.fits +mosaicimage +mosaicimage wcs +mosaicimage wcs new +mosaicimage wcs mask +movie +Create a movie from snap shots of the DS9 window. A +slice movie cycles though all slices of a cube. A +frame movie cycles through all active frames. A +3d movie cycles through specified viewing angles. The +default action is slice. Movie types are either +MPEG or Animated GIF, with default MPEG. +Optional parameters for 3d: number of frames, azimuth +from/to, elevation from/to, slice from/to, oscillate/repeat +times. +Syntax: +movie[slice|frame|3d][mpeg|gif] <filename> +movie 3d [mpeg|gif] <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>] + +Example: +ds9.set(string cmd) +movie slice mpeg ds9.mpg +movie frame gif ds9.gif +movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate +1 +multiframe +Load FITS multiple extension file as multiple images. +Syntax: +multiframe [<filename>] + +Example: +ds9.set(string cmd) +multiframe foo.fits +multiframe +nameserver +Support Name Server functions. Coordinates are in fk5. +Syntax: +nameserver [<object>] +    [name <object>] +    [server +ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [close] + +Example: +string value = ds9.get(string cmd) +nameserver +nameserver server +nameserver skyformat +nameserver m31 + +ds9.set(string cmd) +nameserver m31 +nameserver name m31 +nameserver server ned-sao +nameserver skyformat sexagesimal +nameserver pan +nameserver crosshair +nameserver open +nameserver close +nan +Set image not-a-number color. +Syntax: +nan <color> + +Example: +string value = ds9.get(string cmd) +nan +ds9.set(string cmd) +nan red +nrrd +Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: +array endian. +Syntax: +nrrd [native|little|big] +nrrd [new|mask] [<filename>] + +Example: +string value = ds9.get(string cmd) +nrrd +nrrd big + +ds9.set(string cmd, string url) +nrrd foo.nrrd +nrrd new foo.nrrd +nrrd mask foo.nrrd +nrrd +nrrdnew +nrrd mask +nvss +Support for NRAO VLA Sky Survey. +Syntax: +nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +nvss name +nvss coord +nvss size +nvss save +nvss frame + +ds9.set(string cmd) +nvss +nvss m31 +nvss name m31 +nvss name clear +nvss 00:42:44.404 +41:16:08.78 +nvss size 60 60 arcmin +nvss save yes +nvss frame current +nvss update frame +nvss open +nvss close +orient +Controls the orientation of the current frame. +Syntax: +orient [none|x|y|xy] +    [open|close] + +Example: +string value = ds9.get(string cmd) +orient + +ds9.set(string cmd) +orient xy +orient open +orient close +pagesetup +Controls Page Setup options. +Syntax: +pagesetup [orient portrait|landscape] +    [scale <numeric>] +    [size letter|legal|tabloid|poster|a4] + +Example: +string value = ds9.get(string cmd) +pagesetup orient +pagesetup scale +pagesetup size + +ds9.set(string cmd) +pagesetup orient portrait +pagesetup scale 50 +pagesetup size poster +pan +Controls the current image cursor location for the current +frame. +Syntax: +pan [<coordsys> [<skyframe>] [<skyformat>]] # get +current coords + +pan [<x> <y> <coordsys> [<skyframe>]] # +relative +    [to <x> <y> <coordsys> +[<skyframe>]] # absolute +    [open|close] +    [close] + +Example: +string value = ds9.get(string cmd) +pan # get current image coords +pan wcs fk4 sexagesimal # get current wcs coords + +ds9.set(string cmd) +pan 200 200 image # pan relative +pan to 400 400 physical # pan to physical coords +pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords +pan open +pan close +pixeltable +Display/Hide the pixel table. +Syntax: +pixeltable [] +    [yes|open] +    [no|close] + +Example: +string url = ds9.get(string cmd) +pixeltable + +ds9.set(string cmd) +pixeltable +pixeltable yes +pixeltable open +pixeltable close +plot +Display and configure data plots. All plot commands take an +optional second command, the plot name. If no plot name is +specified, the last plot created is assumed. Plot data is assumed +to be a pair of coordinates, with optional error values. The follow +are valid data descriptions: +xy    x and y +coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y +errors +To create a new plot, use the plot new command. +Syntax: +# create new empty plot window +plot [] +    [line|bar|scatter] +    [new] +    [new line|bar|scatter] +    [new name <plotname>] +    [new name <plotname> line|bar|scatter] + +#load data into existing plot from stdin +plot [[<plotname>] data xy|xyex|xyey|xyexey] + +# existing plot +plot[[<plotname>] load <filename> +xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig +<filename>] +    [[<plotname>] saveconfig +<filename>] +    [[<plotname>] pagesetup orient +portrait|landscape] +    [[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination +printer|file] +    [[<plotname>] print command +<command>] +    [[<plotname>] print filename +<filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> + +    [[<plotname>]export jpeg +<filename>[1-100] +    [[<plotname>]export tiff +<filename>[none|jpeg|packbits|deflate] + +# configure graph +plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min +<value>] +    [[<plotname>] axis x|y max +<value>] +    [[<plotname>] axis x|y format +<string>] +    [[<plotname>] background +<value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position +right|left|top|bottom] +    [[<plotname>] font title|labels|numbers +font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize +<value>] +    [[<plotname>] +fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] +fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y +<string>] +    [[<plotname>] barmode +normal|stacked|aligned|overlap] + +# configure current dataset +plot [[<plotname>] show yes|no] +    [[<plotname>] shape +none|circle|square|diamond|plus|splus|scross|triangle|arrow] +    [[<plotname>] shape fill yes|no] +    [[<plotname>] shape color +<value>] +    [[<plotname>] smooth +step|linear|cubic|quadratic|catrom] +    [[<plotname>] color <value>] +    [[<plotname>] width <value>] +    [[<plotname>] dash yes|no] +    [[<plotname>] error yes|no] +    [[<plotname>] error color +<value>] +    [[<plotname>] error cap yes|no] +    [[<plotname>] error width +<value>] +    [[<plotname>] name <string>] + +# select current dataset +plot [[<plotname>] select <value>] + +Example: +# return all plotnames +string value = ds9.get(string cmd) +plot + +# create new empty plot window +ds9.set(string cmd) +plot +plot bar +plot new +plot new bar +plot new name foo +plot new name foo bar + +# load additional dataset into an existing plot +ds9.set(string cmd, string url) +plot data xy # plot additional data +plot foo data xy # plot additional data + +string value = ds9.get(string cmd) +plot stats +plot list +ds9.set(string cmd) +plot load foo.dat xy +plot save foo.dat +plot clear +plot duplicate 1 +plot stats yes +plot list yes +plot loadconfig foo.plt +plot saveconfig foo.plt +plot pagesetup orient portrait +plot pagesetup size letter +plot print +plot print destination file +plot print command lp +plot print filename foo.ps +plot print color rgb +plot close + +string value = ds9.get(string cmd) +plot mode +ds9.set(string cmd) +plot mode pointer + +# export plot +ds9.set(string cmd) +plot export tiff foo.tiff jpeg +plot export jpeg foo.jpeg 75 +plot export png foo.png + +# configure plot +string value = ds9.get(string cmd) +plot axis x grid +plot axis x log +plot axis x flip +plot axis x auto +plot axis x min +plot axis x max +plot axis x format +plot legend +plot legend position +plot font numbers font +plot font numbers size +plot font numbers weight +plot font numbers slant +plot title +plot title x +plot barmode +ds9.set(string cmd) +plot axis x grid yes +plot axis x log yes +plot axis x flip yes +plot axis x auto no +plot axis x min 0 +plot axis x max 100 +plot axis x format "%f" + +string value = ds9.get(string cmd) +plot background +ds9.set(string cmd) +plot background white + +string value = ds9.get(string cmd) +plot legend +plot legend position +ds9.set(string cmd) +plot legend yes +plot legend position left + +string value = ds9.get(string cmd) +plot font numbers font +plot font numbers size +plot font numbers weight +plot font numbers slant +ds9.set(string cmd) +plot font numbers font times +plot font numbers size 12 +plot font numbers weight bold +plot font numbers slant italic + +string value = ds9.get(string cmd) +plot title +plot title xaxis +plot title yaxis +ds9.set(string cmd) +plot title "This is a Title" +plot title x "X Axis" +plot title y "Y Axis" +plot title legend "This is the Legend" + +string value = ds9.get(string cmd) +plot barmode +ds9.set(string cmd) +plot barmode aligned + +# configure current dataset +string value = ds9.get(string cmd) +plot show +plot shape +plot shape fill +plot shape color +plot smooth +plot color +plot width +plot dash +plot error +plot error color +plot error cap +plot error width +plot name +ds9.set(string cmd) +plot show yes +plot shape circle +plot shape fill no +plot shape color cyan +plot smooth step +plot color red +plot width 2 +plot dash yes +plot error yes +plot error color red +plot error cap yes +plot error width 2 +plot name "My Data" + +# select current dataset +string value = ds9.get(string cmd) +plot select +ds9.set(string cmd) +plot select 2 + png +Load PNG image into current frame. +Syntax: +png [new|slice] [<filename>] + +Example: +string value = ds9.get(string cmd) +png + +ds9.set(string cmd) +png foo.png +png new foo.png +png slice foo.png +png +pngnew +pngslice +precision +Set region and coordinate output format precision. +Syntax: +precision +<linear><degree><hms><dms><arcmin><arcsec> + + +Example: +string value = ds9.get(string cmd) +precision + +ds9.set(string cmd) +precision 8 10 4 3 5 3 +prefs +Controls various preference settings. +Syntax: +prefs [clear] +    [irafalign yes|no] + +Example: +string value = ds9.get(string cmd) +prefs irafalign + +ds9.set(string cmd) +prefs clear +prefs irafalign + preserve +Preserve the follow attributes while loading a new image. +Syntax: +preserve [pan yes|no] +    [regions yes|no] + +Example: +string value = ds9.get(string cmd) +preserve pan +preserve regions + +ds9.set(string cmd) +preserve pan yes +preserve regions yes +psprint +Invokes postscript printing. Please see print +for further details. +print +Controls printing. Use print option to set printing options. +Syntax: +print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    +[resolution72|screen|96|144|150|225|300|600|1200] + +Example: +string value = ds9.get(string cmd) +print destination +print command +print filename +print color +print level +print resolution + +ds9.set(string cmd) +print +print destination file +print command lp +print filename foo.ps +print color cmyk +print level 2 +print resolution 96 +raise +Raise in the window stacking order. +Syntax: +raise + +Example: +ds9.set(string cmd) +raise +regions +Controls regions in the current frame. +Syntax: +regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration +<value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format +ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color &ltcolor>] +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> +<dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [groups] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color <color>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> +<int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> +yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] +    [include|exclude|source|background|selected] +    [-format ds9|ciao|saotng|saoimage|pros|xy] +    [-system image|physical|wcs|wcsa...wcsz] +    [-sky fk4|fk5|icrs|galactic|ecliptic] +    [-skyformat degrees|sexagesimal] +    [-prop +select|edit|move|rotate|delete|fixed|include|source 1|0] +    [-group <tag>] +    [-strip yes|no] +    [-wcs yes|no] + +Example: +string url = ds9.get(string cmd) +regions +regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal +-prop edit 1 -group foo +string value = ds9.get(string cmd) +regions epsilon +regions show +regions showtext +regions centroid +regions centroid auto +regions centroid radius +regions centroid iteration +regions selected +regions format +regions system +regions sky +regions skyformat +regions strip +regions shape +regions color +regions width +regions source +regions background +regions include +regions exclude +regions selected +regions groups + +ds9.set(string cmd, string url) +regions -format xy -system wcs -sky fk5 +regions -format ds9 + +ds9.set(string cmd) +regions foo.reg +regions -format ciao bar.reg # load as ciao format +regions foo.fits # FITS regions files do not need a format +specification +regions load foo.reg # load foo.reg into current frame +regions load all foo.reg # load foo.reg into all frames +regions load *.reg# expand *.reg and load into current frame +regions load all *.reg # expand *.reg and load into all frames +regions save foo.reg +regions list +regions list close +regions epsilon 5 +regions show yes +regions showtext no +regions centroid +regions centroid auto yes +regions centroid radius 10 +regions centroid iteration 20 +regions getinfo +regions move back +regions move front +regions select all +regions select none +regions select invert +regions delete all +regions delete select +regions format ds9 +regions system wcs +regions sky fk5 +regions skyformat degrees +regions strip yes +regions shape ellipse +regions color red +regions width 3 +regions edit yes +regions include +regions command "circle 100 100 20 # color=red" +regions composite +regions dissolve +regions template foo.tpl +regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 +regions savetemplate foo.tpl +regions group new +regions group foo new +regions group foo update +regions group foo select +regions group foo color red +regions group foo copy +regions group foo delete +regions group foo cut +regions group foo font 'times 14 bold' +regions group foo move 100 100 +regions group foo movefront +regions group foo moveback +regions group foo property delete no +regions copy +regions cut +regions paste wcs +regions undo +restore +Restore DS9 to a previous state from a backup save set. +Syntax: +restore <filename> + +Example: +restore ds9.bck +rgb +Create RGB frame and control RGB frame parameters. +Syntax: +rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +   [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock +wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth +[yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +rgb channel +rgb lock wcs +rgb lock crop +rgb lock slice +rgb lock bin +rgb lock scale +rgb lock scalelimits +rgb lock colorbar +rgb lock block +rgb lock smooth +rgb system +rgb view red +rgb view green +rgb view blue + +ds9.set(string cmd) +rgb # create new rgb frame +rgb red # set current channel to red +rgb channel red # set current channel to red +rgb view blue no # turn off blue channel +rgb system wcs # set rgb coordinate system +rgb lock wcs yes +rgb lock crop yes +rgb lock slice yes +rgb lock bin yes +rgb lock scale yes +rgb lock scalelimits yes +rgb lock colorbar yes +rgb lock block yes +rgb lock smooth yes +rgb open +rgb close +rgbarray +Load raw data array cube into rgb frame. +Syntax: +rgbarray [native|big|little] +rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - string value = ds9.get(string cmd) - rgbarray - rgbarray little - ds9.set(string cmd) - rgbarray - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - rgbcube - Load FITS rgbcube into rgb frame. - - Syntax: - rgbcube [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - rgbcube - ds9.set(string cmd) - rgbcube foo.fits - rgbcube new foo.fits - rgbcube - rgbcube new - rgbimage - Load FITS rgbimage into rgb frame. - - Syntax: - rgbimage [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - rgbimage - ds9.set(string cmd) - rgbimage foo.fits - rgbimage new foo.fits - rgbimage - rgbimage new - rotate - Controls the rotation angle (in degrees) of the current frame. - Syntax: - rotate [<value>] -        [to <value>] -        [open|close] - - Example: - string value = ds9.get(string cmd) - rotate - ds9.set(string cmd) - rotate 45 - rotate to 30 - rotate open - rotate close - samp - Configure SAMP protocol. - Syntax: - samp [no|disconnect] -      [broadcast [image|table]] -      [send [image|table] - <application>] - - Example: - ds9.set(string cmd) - samp no - samp disconnect - samp broadcast image - samp send image aladin - save - - Save loaded image data of current frame as FITS. - Syntax: - save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice] - - Example: - ds9.set(string cmd) - save foo.fits - save fits foo.fits image - save fits foo.fits table - save fits foo.fits slice - save rgbimage foo.fits - save rgbcube foo.fits - save mecube foo.fits - save mosaic foo.fits - save mosaicimage foo.fits - saveimage - Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method. - Syntax: - saveimage [fits|eps|gif|tiff|jpeg|png] <filename> - saveimage <filename>.jpeg [1-100] - saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - ds9.set(string cmd) - saveimage ds9.tiff - saveimage jpeg ds9.jpeg 75 - scale - Controls the limits and color scale distribution. - Syntax: - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] - [log exp <value>] -       [datasec yes|no] -       [limits <minvalue> - <maxvalue>] -       [mode - minmax|<value>|zscale|zmax] -       [scope local|global] -       [match] -       [match limits] -       [lock [yes|no]] -       [lock limits [yes|no]] -       [open|close] - - Example: - string value = ds9.get(string cmd) - scale - scale log exp - scale datasec - scale limits - scale mode - scale scope - scale lock - scale lock limits - ds9.set(string cmd) - scale linear - scale log exp 100 - scale datasec yes - scale histequ - scale limits 1 100 - scale mode zscale - scale mode 99.5 - scale scope local - scale match - scale match limits - scale lock yes - scale lock limits yes - scale open - scale close - - shm - Load a shared memory segment into the current frame. - Syntax: - shm [<key> [<filename>]] -     [key <key> [<filename>]] -     [shmid <id> [<filename>]] -     [fits [key|shmid] <id> - [<filename>]] -     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]] -     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] -     [rgbcube [key|shmid] <id> - [<filename>] -     [rgbimage [key|shmid] <id> - [<filename>]] -     [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -     [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - string value = ds9.get(string cmd) - shm - ds9.set(string cmd) - shm 102 - shm key 102 - shm shmid 102 foo - shm fits key 100 foo - shm mosaicimage iraf key 100 foo - shm mosaicimage wcs key 100 foo - shm mosaicimage wcsa key 100 foo - shm mosaicimage wfpc2 key 100 foo - shm mosaic iraf key 100 foo - shm mosaic wcs key 100 foo - shm rgbcube key 100 foo - shm rgbimage key 100 foo - shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] - shm array shmid 102 [dim=32,bitpix=-32] - - sia - - Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise. - Syntax: - sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] - -     -     [<ref>] [cancel] -     -     [<ref>] [clear] -       - [<ref>] [close] -         - [<ref>] [coordinate <ra> <dec> - <coordsys>] -         - [<ref>] [crosshair] -         - [<ref>] [export sb|tsv <filename>] -       - [<ref>] [name <object>] -       - [<ref>] [print] -         - [<ref>] [retrieve] -         - - - - - - - - - - - - - [<ref>] [save <filename>] -       [<ref>] - [radius <value> degrees|arcmin|arcsec] -         - [<ref>] [sky <skyframe>] -     -     [<ref>] [skyformat <skyformat>] -     -     [<ref>] [system <coordsys>] -      -    [<ref>] [update] - - Example: - string value = ds9.get(string cmd) - sia - - ds9.set(string cmd) - sia 2mass - sia cancel - sia clear - sia close - sia coordinate 202.48 47.21 fk5 - sia crosshair - sia export tsv bar.tsv - sia name m51 - sia print - sia retrieve - sia save foo.xml - sia radius 1degrees - sia sky fk5 - sia skyformat degrees - sia system wcs - sia update - - single - Select Single Display mode - Syntax: - single - - Example: - string value = ds9.get(string cmd) - single - ds9.set(string cmd) - single - - skyview - Support for SkyView image server at HEASARC. - Syntax: - skyview [] -         [<object>] -         [name - <object>|clear] -         [<ra> - <dec>] # in wcs fk5 -         [size <width> - <height> degrees|arcmin|arcsec] -         [pixels <width> - <height>] -         [save yes|no] -         [frame new|current] -         [update - frame|crosshair] -       [survey <survey>] -         [open|close] - - Example: - string value = ds9.get(string cmd) - skyview name - skyview coord - skyview size - skyview pixels - skyview save - skyview frame - skyview survey - ds9.set(string cmd) - skyview - skyview m31 - skyview name m31 - skyview name clear - skyview 00:42:44.404 +41:16:08.78 - skyview size 60 60 arcmin - skyview pixels 600 600 - skyview save yes - skyview frame current - skyview update frame - skyview survey sdssi - skyview open - skyview close - - sleep - Delays execution for specified number of seconds. Default is 1 - second. - Syntax: - sleep [#] - - Example: - ds9.set(string cmd) - sleep - sleep 2 - - smooth - Smooth current image or set smooth parameters. - Boxcar width = 2*radius+1 - Tophat diameter = 2*radius+1 - Gaussian diameter = 2*radius+1, mean =0 - Elliptical Gaussian diameter = 2*radius+1, mean =0 - Syntax: - - smooth [] -        [yes|no] -        [function - boxcar|tophat|gaussian] -        [radius - <value>] -        - [radiusminor <value>] -        - - - - - - - - - - - - - - [sigma <value>] -        - - - - - - - - - - - - - - [sigmaminor <value>] -        -[angle - - - - - - - - - - - - - - <value>] -        - - - - - - - - - - - - - [match] -        [lock [yes|no]] -        [open|close] - - Example: - string value = ds9.get(string cmd) - smooth - smooth function - smooth radius - smooth radiusminor - smooth sigma - smooth sigmaminor - smooth angle - smooth lock - ds9.set(string cmd) - smooth - smooth yes - smooth function tophat - smooth radius 4 - smooth radiusminor 4 - smooth - - - - - - - - - - - - - sigma 2.0 - smooth - - - - - - - - - - - - - sigmaminor 2.0 - smooth - - - - - - - - - + +Example: +string value = ds9.get(string cmd) +rgbarray +rgbarray little + +ds9.set(string cmd) +rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +rgbarray new +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +rgbcube +Load FITS rgbcube into rgb frame. +Syntax: +rgbcube [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +rgbcube + +ds9.set(string cmd) +rgbcube foo.fits +rgbcube new foo.fits +rgbcube +rgbcubenew +rgbimage +Load FITS rgbimage into rgb frame. +Syntax: +rgbimage [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +rgbimage + +ds9.set(string cmd) +rgbimage foo.fits +rgbimage new foo.fits +rgbimage +rgbimagenew +rotate +Controls the rotation angle (in degrees) of the current +frame. +Syntax: +rotate [<value>] +    [to <value>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +rotate + +ds9.set(string cmd) +rotate 45 +rotate to 30 +rotate open +rotate close +samp +Configure SAMP protocol. +Syntax: +samp [no|disconnect] +    [broadcast [image|table]] +    [send [image|table] <application>] + +Example: + +ds9.set(string cmd) +samp no +samp disconnect +samp broadcast image +samp send image aladin +save +Save loaded image data of current frame as FITS. +Syntax: +save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice] + +Example: +ds9.set(string cmd) +save foo.fits +save fits foo.fits image +save fits foo.fits table +save fits foo.fits slice +save rgbimage foo.fits +save rgbcube foo.fits +save mecube foo.fits +save mosaic foo.fits +save mosaicimage foo.fits +saveimage +Create a snap shot of the current DS9 window and save in +specified image format. If no format specified, the file name +extension is used to determine the output format. Optional +parameters: jpeg quality (1-100) and tiff +compression method. +Syntax: +saveimage[fits|eps|gif|tiff|jpeg|png]<filename> +saveimage <filename>.jpeg [1-100] +saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +ds9.set(string cmd) +saveimage ds9.tiff +saveimage jpeg ds9.jpeg 75 +scale +Controls the limits and color scale distribution. +Syntax: +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +scale +scale log exp +scale datasec +scale limits +scale mode +scale scope +scale lock +scale lock limits + +ds9.set(string cmd) +scale linear +scale log exp 100 +scale datasec yes +scale histequ +scale limits 1 100 +scale mode zscale +scale mode 99.5 +scale scope local +scale match +scale match limits +scale lock yes +scale lock limits yes +scale open +scale close +shm +Load a shared memory segment into the current frame. +Syntax: +shm [<key> [<filename>]] +    [key <key> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> +[<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] +[key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] +<id> [<filename>]] +    [rgbcube [key|shmid] <id> +[<filename>] +    [rgbimage [key|shmid] <id> +[<filename>]] +    [rgbarray [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] +    [array [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - angle 45 - - smooth open - smooth close - smooth match - smooth lock yes - smooth open - smooth close - - source - Source TCL code from a file. - Syntax: - source [filename] - - Example: - ds9.set(string cmd) - source foo.tcl - tcl - Execute one TCL command. - - Syntax: - tcl <tcl command> - - Example: - ds9.set(string cmd) - tcl {puts {Hello, World}} - - threads - Set number of process threads for functions which are - multi-threaded. - Syntax: - threads # - - Example: - string value = ds9.get(string cmd) - threads - ds9.set(string cmd) - threads 8 - tiff - Load TIFF image into current frame. Optional parameters: tiff - compression method. - Syntax: - tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] - - Example: - string value = ds9.get(string cmd) - tiff - tiff jpeg - ds9.set(string cmd) - tiff foo.tiff - tiff new foo.tiff - tiff slice foo.tiff - tiff - tiff new - tiff slice - tile - Controls the tile display mode. - Syntax: - tile [] -      [yes|no] -      [mode grid|column|row] -      [grid] -      [grid mode automatic|manual] -      [grid direction x|y] -      [grid layout <col> <row>] -      [grid gap <pixels>] -      [row] -      [column] - - Example: - string value = ds9.get(string cmd) - tile - tile mode - tile grid mode - tile grid direction - tile grid layout - tile grid gap - ds9.set(string cmd) - tile - tile yes - tile mode row - tile grid - tile grid mode manual - tile grid direction x - tile grid layout 5 5 - tile grid gap 10 - tile row - tile column - update - Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option. - Syntax: - update [] -        [# x1 y1 x2 y2] -        [now] -        [now # x1 y1 x2 y2] - - Example: - ds9.set(string cmd) - update - update 1 100 100 300 400 - update now - update now 1 100 100 300 400 - url - Load FITS from URL into the current frame - Syntax: - url <url> - - Example: - ds9.set(string cmd) - url http://foo.bar.edu/foo.fits - version - Returns the current version of DS9. - Syntax: - version - - Example: - string value = ds9.get(string cmd) - version - view - Controls the GUI. - Syntax: - view [layout horizontal|vertical] -       [keyvalue <string>] -       [info yes|no] -       [panner yes|no] -       [magnifier yes|no] -       [buttons yes|no] -       [colorbar yes|no] -       [colorbar horizontal|vertical] -       [colorbar numerics yes|no] -       [graph horizontal|vertical - yes|no] -     [filename yes|no[ -     [object yes|no] -       [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -       [units yes|no] -       [image|physical|wcs|wcsa...wcsz - yes|no] -     [frame yes|no] -     [red yes|no] - [green yes|no] - [blue yes|no] - - Example: - string value = ds9.get(string cmd) - view layout - view keyvalue - view info - view panner - view magnifier - view buttons - view colorbar - view graph horizontal - view filename - view object - view keyword - view minmax - view lowhigh - view units - view image - view wcsa - view frame - view red - ds9.set(string cmd) - view layout vertical - view keyvalue BITPIX - view info yes - view panner yes - view magnifier yes - view buttons yes - view colorbar yes - view graph horizontal yes - view filename yes - view object yes - view keyword yes - view minmax yes - view lowhigh yes - view units yes - view wcsa yes - view frame yes - view red yes - view green yes - view blue yes - vla - Support for VLA Sky Survey. - Syntax: - vla [] -       [<object>] -       [name <object>|clear] -       [<ra> <dec>] # in wcs - fk5 -       [size <width> - <height> degrees|arcmin|arcsec] -       [save yes|no] -       [frame new|current] -       [update frame|crosshair] -       [survey first|stripe82] -       [open|close] - - Example: - string value = ds9.get(string cmd) - vla name - vla coord - vla size - vla save - vla frame - vla survey - ds9.set(string cmd) - vla - vla m31 - vla name m31 - vla name clear - vla 00:42:44.404 +41:16:08.78 - vla size 60 60 arcmin - vla save yes - vla frame current - vla update frame - vla survey stripe82 - vla open - vla close - - vlss - Support for NRAO VLSS Sky Survey. - Syntax: - vlss [] -      [<object>] -      [name <object>|clear] -      [<ra> <dec>] # in wcs fk5 -      [size <width> <height> - degrees|arcmin|arcsec] -      [save yes|no] -      [frame new|current] -      [update frame|crosshair] -      [open|close] - - Example: - string value = ds9.get(string cmd) - vlss name - vlss coord - vlss size - vlss save - vlss frame - ds9.set(string cmd) - vlss - vlss m31 - vlss name m31 - vlss name clear - vlss 00:42:44.404 +41:16:08.78 - vlss size 60 60 arcmin - vlss save yes - vlss frame current - vlss update frame - vlss open - vlss close - vo - Invoke an connection to a Virtual Observatory site. - Syntax: - vo [method xpa|mime] -    [server <url>] -    [internal yes|no] -    [delay #] -    [<url>] -    [connect <url>] -    [disconnect <url>] -    [open|close] - - Example: - string value = ds9.get(string cmd) - vo - vo method - vo server - vo internal - vo delay - vo connect - ds9.set(string cmd) - vo method xpa - vo server "http://foo.bar.edu/list.txt" - vo internal yes - vo delay 15 - vo chandra-ed - vo connect chandra-ed - vo disconnect chandra-ed - vo open - vo close - - wcs - Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, using this access point, a new WCS - specification can be loaded and used by the current image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file . Please see WCS for more information. - Syntax: - wcs [[system] wcs|wcsa...wcsz] -     [[sky] fk4|fk5|icrs|galactic|ecliptic] -     [[skyformat] degrees|sexagesimal] -     [align yes|no] -     [reset [#]] -     [replace [#] <filename>] -     [append [#] <filename>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - wcs - wcs system - wcs sky - wcs skyformat - wcs align - ds9.set(string cmd) - wcs wcs - wcs system wcs - wcs fk5 - wcs sky fk5 - wcs sexagesimal - wcs skyformat sexagesimal - wcs align yes - wcs reset - wcs reset 3 - wcs replace foo.wcs - wcs replace 3 foo.wcs - wcs append foo.wcs - wcs append 3 foo.wcs - ds9.set(string cmd, string url) - wcs replace - wcs append - wcs open - wcs close - - web - Display specified URL in the web display. - Syntax: - web [] -     [<url>] -     [new <webname> <url>] -     [<webname>] [click - back|forward|stop|reload|#] -     [<webname>] [clear] -     [<webname>] [close] - - Example: - string value = ds9.get(string cmd) - web - ds9.set(string cmd) - web www.cnn.com - web new www.cnn.com - web hvweb www.apple.com - web click back - web click 2 - web clear - web close - - width - Set the width of the image display window. - Syntax: - width [<value>] - - Example: - string value = ds9.get(string cmd) - width - ds9.set(string cmd) - width 512 - - zscale - Set Scale Limits based on the IRAF algorithm. - Syntax: - zscale [] -        [contrast] -        [sample] -        [line] - - Example: - string value = ds9.get(string cmd) - zscale contrast - zscale sample - zscale line - ds9.set(string cmd) - zscale - zscale contrast .25 - zscale sample 600 - zscale line 120 - - zoom - Controls the current zoom value for the current frame. - Syntax: - zoom [<value>] -      [<value> <value>] -      [to <value>] -      [to <value> <value>] -      [in] -      [out] -      [to fit] -      [open|close] - - Example: - string value = ds9.get(string cmd) - zoom - ds9.set(string cmd) - zoom 2 - zoom 2 4 - zoom to 4 - zoom to 2 4 - zoom in - zoom out - zoom to fit - zoom open - zoom close - - + +Example: +string value = ds9.get(string cmd) +shm + +ds9.set(string cmd) +shm 102 +shm key 102 +shm shmid 102 foo +shm fits key 100 foo +shm mosaicimage iraf key 100 foo +shm mosaicimage wcs key 100 foo +shm mosaicimage wcsa key 100 foo +shm mosaicimage wfpc2 key 100 foo +shm mosaic iraf key 100 foo +shm mosaic wcs key 100 foo +shm rgbcube key 100 foo +shm rgbimage key 100 foo +shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] +shm array shmid 102 [dim=32,bitpix=-32] + sia +Support for VO Simple Image Access protocol. The first command +will create a new search. All other commands operated on the last +search created, unless indicated otherwise. +Syntax: +sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> +<coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv +<filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> +degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +string value = ds9.get(string cmd) +sia + +ds9.set(string cmd) +sia2mass +siacancel +siaclear +siaclose +siacoordinate 202.48 47.21 fk5 +siacrosshair +siaexport tsv bar.tsv +sianame m51 +siaprint +siaretrieve +siasave foo.xml +siaradius 1degrees +siasky fk5 +sia skyformat degrees +siasystem wcs +siaupdate + single +Select Single Display mode +Syntax: +single + +Example: +string value = ds9.get(string cmd) +single + +ds9.set(string cmd) +single +skyview +Support for SkyView image server at HEASARC. +Syntax: +skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +skyview name +skyview coord +skyview size +skyview pixels +skyview save +skyview frame +skyview survey + +ds9.set(string cmd) +skyview +skyview m31 +skyview name m31 +skyview name clear +skyview 00:42:44.404 +41:16:08.78 +skyview size 60 60 arcmin +skyview pixels 600 600 +skyview save yes +skyview frame current +skyview update frame +skyview survey sdssi +skyview open +skyview close +sleep +Delays execution for specified number of seconds. Default is 1 +second. +Syntax: +sleep [#] + +Example: +ds9.set(string cmd) +sleep +sleep 2 +smooth +Smooth current image or set smooth parameters. +Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter +=2*radius+1,mean=0Syntax: +smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +smooth +smooth function +smooth radius +smooth radiusminor +smooth sigma +smooth sigmaminor +smooth angle +smooth lock + +ds9.set(string cmd) +smooth +smooth yes +smooth function tophat +smooth radius 4 +smooth radiusminor 4 +smooth sigma 2.0 +smooth sigmaminor 2.0 +smooth angle 45 +smooth open +smooth close +smooth match +smooth lock yes +smooth open +smooth close +source +Source TCL code from a file. +Syntax: +source [filename] + +Example: +ds9.set(string cmd) +source foo.tcl +tcl +Execute one TCL command. +Syntax: +tcl <tcl command> + +Example: +ds9.set(string cmd) +tcl {puts {Hello, World}} +threads +Set number of process threads for functions which are +multi-threaded. +Syntax: +threads # + +Example: +string value = ds9.get(string cmd) +threads +ds9.set(string cmd) +threads 8 +tiff +Load TIFF image into current frame. Optional parameters: +tiff compression method. +Syntax: +tiff [new|slice] [<filename>] +[none|jpeg|packbits|deflate] + +Example: +string value = ds9.get(string cmd) +tiff +tiff jpeg + +ds9.set(string cmd) +tiff foo.tiff +tiff new foo.tiff +tiff slice foo.tiff +tiff +tiff new +tiff slice +tile +Controls the tile display mode. +Syntax: +tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +string value = ds9.get(string cmd) +tile +tile mode +tile grid mode +tile grid direction +tile grid layout +tile grid gap + +ds9.set(string cmd) +tile +tile yes +tile mode row +tile grid +tile grid mode manual +tile grid direction x +tile grid layout 5 5 +tile grid gap 10 +tile row +tile column +update +Updates the current frame or region of frame. In the second +form, the first argument is the number of the fits HDU (starting +with 1) and the remaining args are a bounding box in IMAGE +coordinates. By default, the screen is updated the next available +idle cycle. However, you may force an immediate update by +specifying the NOW option. +Syntax: +update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: + +ds9.set(string cmd) +update +update 1 100 100 300 400 +update now +update now 1 100 100 300 400 +url +Load FITS from URL into the current frame +Syntax: +url <url> + +Example: +ds9.set(string cmd) +url http://foo.bar.edu/foo.fits +version +Returns the current version of DS9. +Syntax: +version + +Example: +string value = ds9.get(string cmd) +version +view +Controls the GUI. +Syntax: +view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [colorbar horizontal|vertical] +    [colorbar numerics yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no[ +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +string value = ds9.get(string cmd) +view layout +view keyvalue +view info +view panner +view magnifier +view buttons +view colorbar +view graph horizontal +view filename +view object +view keyword +view minmax +view lowhigh +view units +view image +view wcsa +view frame +view red + +ds9.set(string cmd) +view layout vertical +view keyvalue BITPIX +view info yes +view panner yes +view magnifier yes +view buttons yes +view colorbar yes +view graph horizontal yes +view filename yes +view object yes +view keyword yes +view minmax yes +view lowhigh yes +view units yes +view wcsa yes +view frame yes +view red yes +view green yes +view blue yes +vla +Support for VLA Sky Survey. +Syntax: +vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +string value = ds9.get(string cmd) +vla name +vla coord +vla size +vla save +vla frame +vla survey + +ds9.set(string cmd) +vla +vla m31 +vla name m31 +vla name clear +vla 00:42:44.404 +41:16:08.78 +vla size 60 60 arcmin +vla save yes +vla frame current +vla update frame +vla survey stripe82 +vla open +vla close +vlss +Support for NRAO VLSS Sky Survey. +Syntax: +vlss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> +degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +vlss name +vlss coord +vlss size +vlss save +vlss frame + +ds9.set(string cmd) +vlss +vlss m31 +vlss name m31 +vlss name clear +vlss 00:42:44.404 +41:16:08.78 +vlss size 60 60 arcmin +vlss save yes +vlss frame current +vlss update frame +vlss open +vlss close +vo +Invoke an connection to a Virtual Observatory site. +Syntax: +vo [method xpa|mime] +   [server <url>] +   [internal yes|no] +   [delay #] +   [<url>] +   [connect <url>] +   [disconnect <url>] +   [open|close] + +Example: +string value = ds9.get(string cmd) +vo +vo method +vo server +vo internal +vo delay +vo connect + +ds9.set(string cmd) +vo method xpa +vo server "http://foo.bar.edu/list.txt" +vo internal yes +vo delay 15 +vo chandra-ed +vo connect chandra-ed +vo disconnect chandra-ed +vo open +vo close +wcs +Controls the World Coordinate System for the current frame. If +the wcs system, skyframe, or skyformat is modified, the info panel, +compass, grid, and alignment will be modified accordingly. Also, +using this access point, a new WCS specification can be loaded and +used by the current image regardless of the WCS that was contained +in the image file. WCS specification can be sent to DS9 as an ASCII +file . Please see WCS for more +information. +Syntax: +wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +wcs +wcs system +wcs sky +wcs skyformat +wcs align + +ds9.set(string cmd) +wcs wcs +wcs system wcs +wcs fk5 +wcs sky fk5 +wcs sexagesimal +wcs skyformat sexagesimal +wcs align yes +wcs reset +wcs reset 3 +wcs replace foo.wcs +wcs replace 3 foo.wcs +wcs append foo.wcs +wcs append 3 foo.wcs +ds9.set(string cmd, string url) +wcs replace +wcs append +wcs open +wcs close +web +Display specified URL in the web display. +Syntax: +web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click +back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +string value = ds9.get(string cmd) +web + +ds9.set(string cmd) +web www.cnn.com +web new www.cnn.com +web hvweb www.apple.com +web click back +web click 2 +web clear +web close +width +Set the width of the image display window. +Syntax: +width [<value>] + +Example: +string value = ds9.get(string cmd) +width + +ds9.set(string cmd) +width 512 +zscale +Set Scale Limits based on the IRAF algorithm. +Syntax: +zscale [] +    [contrast] +    [sample] +    [line] + +Example: +string value = ds9.get(string cmd) +zscale contrast +zscale sample +zscale line +ds9.set(string cmd) +zscale +zscale contrast .25 +zscale sample 600 +zscale line 120 +zoom +Controls the current zoom value for the current frame. +Syntax: +zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +string value = ds9.get(string cmd) +zoom + +ds9.set(string cmd) +zoom 2 +zoom 2 4 +zoom to 4 +zoom to 2 4 +zoom in +zoom out +zoom to fit +zoom open +zoom close + -- cgit v0.12 From d842fa425d63cb2b02a8b88a0b2d86bc40d111b4 Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 17:37:57 -0400 Subject: clean up html --- ds9/doc/ref/3d.html | 2 +- ds9/doc/ref/analysis.html | 2 +- ds9/doc/ref/how.html | 2 +- ds9/doc/ref/xpa.html | 25 +++++++++++-------------- 4 files changed, 14 insertions(+), 17 deletions(-) diff --git a/ds9/doc/ref/3d.html b/ds9/doc/ref/3d.html index 2270f49..964e09c 100644 --- a/ds9/doc/ref/3d.html +++ b/ds9/doc/ref/3d.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> $xpaset -p ds9 crop match wcs $xpaset -p ds9 crop lock wcs -$xpaset -p ds9 crop reset $xpaset -p ds9 crop 3d .25 .50 -wcs -$xpaset -p ds9 crop open -$xpaset -p ds9 crop close +$xpaset -p ds9 crop reset +$xpaset -p ds9 crop 3d .25 .50 wcs +$xpaset -p ds9 crop open +$xpaset -p ds9 crop close crosshair Controls the current position of the crosshair in the current frame. DS9 is placed in crosshair mode when the crosshair is @@ -1343,10 +1343,8 @@ for more information. iexam []     [[]|button|key|any] coordinate <coordsys> [<skyframe>] [<skyformat>] -     [[]|button|key|any] data -[width][height] -     [[]|button|key|any] <macro -string>] +    [[]|button|key|any] data [width][height] +    [[]|button|key|any] <macro string>] Example: $xpaget ds9 iexam # image coordinates @@ -1862,9 +1860,8 @@ none|circle|square|diamond|plus|splus|scross|triangle|arrow] <value>]     [[<plotname>] smooth step|linear|cubic|quadratic|catrom] -    [[<plotname>] color -<value>]     [[<plotname>] -width <value>] +    [[<plotname>] color <value>] +    [[<plotname>] width <value>]     [[<plotname>] dash yes|no]     [[<plotname>] error yes|no]     [[<plotname>] error color @@ -2116,8 +2113,8 @@ regions [<filename>]     [delete select]     [format ds9|xml|ciao|saotng|saoimage|pros|xy] -    [system image|physical|wcs|wcsa...wcsz] -    [sky fk4|fk5|icrs|galactic|ecliptic] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic]     [skyformat degrees|sexagesimal]     [strip yes|no]     [shape <shape>] @@ -2279,7 +2276,7 @@ $xpaset -p ds9 restore ds9.bck rgb Create RGB frame and control RGB frame parameters. Syntax: -rgb [] +rgb []     [red|green|blue]     [channel [red|green|blue]]     [view [red|green|blue] [yes|no]] -- cgit v0.12 From d95f446d7d66ffa611867b3db3d2a7cf4fd09df6 Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 17:38:22 -0400 Subject: clean up html --- ds9/doc/ref/backup.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/backup.html b/ds9/doc/ref/backup.html index cc02cef..5de7bfc 100644 --- a/ds9/doc/ref/backup.html +++ b/ds9/doc/ref/backup.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:38:32 -0400 Subject: clean up html --- ds9/doc/ref/bin.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/bin.html b/ds9/doc/ref/bin.html index 0b3e691..88670d6 100644 --- a/ds9/doc/ref/bin.html +++ b/ds9/doc/ref/bin.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:38:42 -0400 Subject: clean up html --- ds9/doc/ref/catalog.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/catalog.html b/ds9/doc/ref/catalog.html index 4e8982a..7560b84 100644 --- a/ds9/doc/ref/catalog.html +++ b/ds9/doc/ref/catalog.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:38:52 -0400 Subject: clean up html --- ds9/doc/ref/colorbar.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/colorbar.html b/ds9/doc/ref/colorbar.html index a9360f7..862c3e2 100644 --- a/ds9/doc/ref/colorbar.html +++ b/ds9/doc/ref/colorbar.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:47:52 -0400 Subject: clean up html --- ds9/doc/ref/contour.html | 81 ++++++++++++++++++++---------------------------- 1 file changed, 34 insertions(+), 47 deletions(-) diff --git a/ds9/doc/ref/contour.html b/ds9/doc/ref/contour.html index 6d85056..82e0d1c 100644 --- a/ds9/doc/ref/contour.html +++ b/ds9/doc/ref/contour.html @@ -2,17 +2,17 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Contours - - Contours + + Contours DS9 can create and display contours as an overlay on an image. The Analysis Contours menu is used to display contours. To create, @@ -46,69 +46,56 @@ Files A contour file is an ASCII file containing a header, global properties, coordinate system, contour levels, and contour points. - Header A DS9 contour file may start with the following optional header: -# Contour file format: DS9 version -7.5 +    # Contour file format: DS9 version +7.5 Global Properties Global properties affect all contour levels unless a line level attribute is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file. -global color=green width=1 dash=1 dashlist=8 -3 +    global color=green width=1 dash=1 dashlist=8 +3 Coordinate Systems For each contour file, it is important to specify the coordinate system used to interpret the contour points, i.e., to set the context in which the positions are interpreted. For this purpose, the following keywords are recognized: - -PHYSICAL                -# pixel coords of original file using LTM/LTV -IMAGE                   -# pixel coords of current file -FK4,B1950             - # sky coordinate systems -FK5,J2000               -# sky coordinate systems -ICRS                    -# sky coordinate systems -GALACTIC                -# sky coordinate systems -ECLIPTIC                -# sky coordinate systems -WCS            -         # primary WCS -WCSA            -        # secondary WCS -LINEAR                  -# linear primary WCS - - +    PHYSICAL    # pixel coords of +original file using LTM/LTV +    IMAGE    # pixel coords of +current file +    FK4,B1950    # sky coordinate +systems +    FK5,J2000    # sky coordinate +systems +    ICRS    # sky coordinate +systems +    GALACTIC    # sky coordinate +systems +    ECLIPTIC    # sky coordinate +systems +    WCS    # primary WCS +    WCSA    # secondary WCS +    LINEAR    # linear primary +WCS Contour Level Each contour level is composed of a line value, line attributes and one or more contours. Line attributes are specified at the start of a new level and only affect contours within that level . -level=15.78775 color=pink width=2 dash=yes -dashlist=2 2 +    level=15.78775 color=pink width=2 dash=yes +dashlist=2 2 Contour Each contour is composed of one or more X,Y coordinates, with a deliminator of space or comma, starting with "(" and ending with ")". Contours are not closed. - - -(202.4836468 47.22380226 - 202.4833538 47.2239185 - 202.4831634 47.22409874 - 202.4829883 47.22428858) - - - - - - +    (202.4836468 47.22380226 +   202.4833538 47.2239185 +   202.4831634 47.22409874 +   202.4829883 +47.22428858) -- cgit v0.12 From debc1ccbc6f4d7d87221b3f61a9c497c0ec1b1fd Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 17:48:29 -0400 Subject: clean up html --- ds9/doc/ref/grid.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/grid.html b/ds9/doc/ref/grid.html index baeeff1..9ca2f17 100644 --- a/ds9/doc/ref/grid.html +++ b/ds9/doc/ref/grid.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:48:40 -0400 Subject: clean up html --- ds9/doc/ref/keyboard.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/keyboard.html b/ds9/doc/ref/keyboard.html index 3335119..594ca03 100644 --- a/ds9/doc/ref/keyboard.html +++ b/ds9/doc/ref/keyboard.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:48:54 -0400 Subject: clean up html --- ds9/doc/ref/prefs.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/prefs.html b/ds9/doc/ref/prefs.html index 2d173be..df89038 100644 --- a/ds9/doc/ref/prefs.html +++ b/ds9/doc/ref/prefs.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:49:09 -0400 Subject: clean up html --- ds9/doc/ref/vo.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/vo.html b/ds9/doc/ref/vo.html index 161d998..bf929a7 100644 --- a/ds9/doc/ref/vo.html +++ b/ds9/doc/ref/vo.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:49:24 -0400 Subject: clean up html --- ds9/doc/ref/iraf.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/iraf.html b/ds9/doc/ref/iraf.html index edfff77..a789f29 100644 --- a/ds9/doc/ref/iraf.html +++ b/ds9/doc/ref/iraf.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:49:42 -0400 Subject: clean up html --- ds9/doc/ref/print.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/print.html b/ds9/doc/ref/print.html index bde693f..bd5dd19 100644 --- a/ds9/doc/ref/print.html +++ b/ds9/doc/ref/print.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Date: Fri, 26 Apr 2019 17:51:31 -0400 Subject: clean up html --- ds9/doc/ref/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ds9/doc/ref/index.html b/ds9/doc/ref/index.html index f479827..db6d624 100644 --- a/ds9/doc/ref/index.html +++ b/ds9/doc/ref/index.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> - -- cgit v0.12 From c6cf220063d31999edaa2c6e3a0b5556c365eebf Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 18:09:11 -0400 Subject: clean up html --- ds9/doc/ref/region.html | 334 ++++++++++++++++++++++-------------------------- 1 file changed, 152 insertions(+), 182 deletions(-) diff --git a/ds9/doc/ref/region.html b/ds9/doc/ref/region.html index d98b940..9a70e95 100644 --- a/ds9/doc/ref/region.html +++ b/ds9/doc/ref/region.html @@ -2,7 +2,7 @@ +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> Circle Usage: circle x y radius # fill=[0|1] Ellipse -Usage: ellipse x y radius radius angle # -fill=[0|1] +Usage: ellipse x y radius radius angle# fill=[0|1] Box -Usage: box x y width height angle # fill=[0|1] +Usage: box x y width height angle# fill=[0|1] Polygon -Usage: polygon x1 y1 x2 y2 x3 y3 ... # fill=[0|1] +Usage: polygon x1 y1 x2 y2 x3 y3 ...# fill=[0|1] Point Usage: point x y # point=[circle|box|diamond|cross|x|arrow|boxcircle] [size] @@ -66,9 +65,9 @@ Usage: annulus x y inner outer n=#        annulus x y r1 r2 r3... Ellipse Annulus -Usage: ellipse x y r11 r12 r21 r22 n=# [angle] -       ellipse x y r11 r12 r21 r22 -r31 r32 ... [angle] +Usage: ellipse x y r11 r12 r21 r22 n=# [angle] +       ellipse x y r11 r12 r21 +r22 r31 r32 ... [angle] Box Annulus Usage: box x y w1 h1 w2 h2 [angle]        box x y w1 h1 w2 h2 w3 h3 ... @@ -94,7 +93,6 @@ Include/Exclude property. It is set via '+' or '-' preceding the region. In addition, the Line, Point, and Ruler regions have unique properties, not shared by others. Not all properties are available via the GUI or are applicable for all regions. - Text All regions may have text associated with them. Use the text property to set the text. Strings may be quoted with " or ' or {}. @@ -107,9 +105,9 @@ and ' in it} textangle=30 rendered. DS9 recognizes many symbolic color names (i.e. "red", "green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex values (#fff, #ffffff, #fffffffff) -Example: -circle(100,100,20) # color=green circle(100,100,20) # -color=#48f +Example: +circle(100,100,20) # color=green +circle(100,100,20) # color=#48f Dash List Sets dashed line parameters. This does not render the region in dashed lines. @@ -160,13 +158,13 @@ the region via the GUI. The Include/Exclude properties flags the region with a boolean NOT for later analysis. Use '+' for include (default), '-' for exclude. -Example: -circle(100,100,20) +Example: -circle(100,100,20) Source/Background The Source/Background properties flag the region for use with other analysis applications. The default is source -Example: circle(100,100,20) # source -        circle(200,200,10) # -background +Example: circle(100,100,20) # source +        circle(200,200,10) +# background Tag All regions may have zero or more tags associated with it, which may be used for grouping and searching. @@ -193,7 +191,7 @@ property to set the point type. Example: point(100,100) # point=diamond 31 Default Properties The default properties are: -text={} +text={} color=green font="helvetica 10 normal roman" select=1 @@ -202,73 +200,56 @@ property to set the point type. delete=1 highlite=1 include=1 -fixed=0 - +fixed=0 Region File Format - Syntax Region arguments may be separated with either a comma or space. Optional parentheses may be used a the beginning and end of a description. -circle 100 100 10 +circle 100 100 10 circle(100 100 10) -circle(100,100,10) +circle(100,100,10) Comments All lines that begin with # are comments and will be ignored. -# This is a comment +# This is a comment Delimiter All lines may be delimited with either a new-line or semi-colon. -circle 100 100 10 -ellipse 200 200 20 40 ; box 300 300 20 40 +circle 100 100 10 +ellipse 200 200 20 40 ; box 300 300 20 40 Header A DS9 region file may start with the following optional header: -# Region file format: DS9 version -4.0 +# Region file format: DS9 version 4.0 Global Properties Global properties affect all regions unless a local property is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file. -global color=green font="helvetica 10 normal roman" -edit=1 move=1 delete=1 highlite=1 include=1 -wcs=wcs +global color=green font="helvetica 10 normal roman" edit=1 +move=1 delete=1 highlite=1 include=1 wcs=wcs Local Properties Local properties start with a # after a region description and only affect the region it is specified with. -physical;circle(504,513,20) # color=red text={This -is a Circle} +physical;circle(504,513,20) # color=red text={This is a +Circle} Coordinate Systems For each region, it is important to specify the coordinate system used to interpret the region, i.e., to set the context in which the position and size values are interpreted. For this purpose, the following keywords are recognized: - - -PHYSICAL                -# pixel coords of original file using LTM/LTV -IMAGE                   -# pixel coords of current file -FK4,B1950             - # sky coordinate systems -FK5,J2000               -# sky coordinate systems -ICRS                    -# sky coordinate systems -GALACTIC                -# sky coordinate systems -ECLIPTIC                -# sky coordinate systems -WCS            -         # primary WCS -WCSA            -        # secondary WCS -LINEAR                  -# linear primary WCS - +PHYSICAL +IMAGE +FK4,B1950 +FK5,J2000 +ICRS +GALACTIC +ECLIPTIC +WCS +WCSA +LINEAR Mosaic Images While some coordinate systems are unique across mosaic images, others coordinate systems, such as image, or @@ -280,13 +261,13 @@ conversions. The default is the first header, or tile Multiple WCS If an image has multiple wcs's defined, use wcs# to specify which wcs to use for all wcs references. Valid values are -wcs, wcsa, wcsb, wcsc... wcsz. -Example: wcsa;linear;point(100,100) # point=diamond +wcs, wcsa, wcsb, wcsc... wcsz. + +Example: wcsa;linear;point(100,100) # point=diamond Specifying Positions and Sizes The arguments to region shapes can be floats or integers describing positions and sizes. They can be specified as pure numbers or using explicit formatting directives: - position arguments [num]                   # context-dependent (see below) @@ -320,7 +301,7 @@ dms [num]p                  # physical pixels [num]i                  -# image pixels +# image pixels When a "pure number" (i.e. one without a format directive such as 'd' for 'degrees') is specified, its interpretation depends on the context defined by the 'coordsys' keyword. In general, the rule @@ -335,56 +316,41 @@ numbers are degrees. For LINEAR systems, pure numbers are in the units of the linear system. This rule covers both positions and sizes. The input values to each shape can be specified in several coordinate systems including: - -IMAGE                   -# pixel coords of current file - -LINEAR                  -# linear wcs as defined in file -FK4, -B1950              -# sky coordinate systems -FK5, J2000 -GALACTIC -ECLIPTIC -ICRS -PHYSICAL                -# pixel coords of original file using LTM/LTV -AMPLIFIER               -# mosaic coords of original file using ATM/ATV -DETECTOR                -# mosaic coords of original file using DTM/DTV - -WCS,WCSA-WCSZ           -# specify which WCS system to be used for -            -            # linear -and sky coordinate systems - +IMAGE +LINEAR +FK4, B1950 +FK5, J2000 +GALACTIC +ECLIPTIC +ICRS +PHYSICAL +AMPLIFIER +DETECTOR +WCS,WCSA-WCSZ If no coordinate system is specified, PHYSICAL is assumed. PHYSICAL or a World Coordinate System such as J2000 is preferred and most general. The coordinate system specifier should appear at the beginning of the region description, on a separate line (in a file), or followed by a new-line or semicolon; e.g., -image; circle 100 100 10 +image; circle 100 100 10 physical; ellipse 200 200 10 20 fk5; point 30 50 wcsa; fk4; point 202 47 -wcsp; linear; point 100 100 +wcsp; linear; point 100 100 The use of celestial input units automatically implies WORLD coordinates of the reference image. Thus, if the world coordinate system of the reference image is J2000, then -circle 10:10:0 20:22:0 3' +circle 10:10:0 20:22:0 3' is equivalent to: -j2000; circle 10:10:0 20:22:0 3' +j2000; circle 10:10:0 20:22:0 3' Note that by using units as described above, you may mix coordinate systems within a region specifier; e.g., -physical; circle 6500 9320 3' +physical; circle 6500 9320 3' Note that, for regions which accept a rotation angle such as: -ellipse (x, y, r1, r2, angle) -box(x, y, w, h, angle) +ellipse (x, y, r1, r2, angle) +box(x, y, w, h, angle) the angle is relative to the specified coordinate system. In particular, if the region is specified in WCS coordinates, the angle is related to the WCS system, not x/y image coordinate axis. @@ -393,15 +359,12 @@ However, some images do define an implicit rotation (e.g., by using a non-zero CROTA value in the WCS parameters) and for these images, the angle will be relative to the WCS axes. In such case, a region specification such as: -fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", -30) +fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", 30) will not, in general, be the same region specified as: -physical;ellipse(465, 578, 40, 20, -30) +physical;ellipse(465, 578, 40, 20, 30) even when positions and sizes match. The angle is relative to WCS axes in the first case, and relative to physical x,y axes in the second. - Composite Region A Composite Region is a region which is a collection of other @@ -436,91 +399,100 @@ regions point is used specify the output coordinate system and format. On input, the menu or xpa point is used only for the X Y format. For all other formats, the input coordinate system is specified in the regions file itself. - Funtools -When using DS9 regions file in FUNTOOLS: -LINE is ignored VECTOR is ignored -PROJECTION is ignored +When using DS9 regions file in FUNTOOLS: +LINE is ignored +VECTOR is ignored +PROJECTION is ignored SEGMENT is ignored -TEXT is ignored RULER is ignored -COMPASS is ignored -CIAO -When importing from CIAO into DS9: -POINT is translated into BOX CIRCLE POINT ROTBOX -is translated into BOX -RECTANGLE is translated into BOX PANDA is translated -as PIE +TEXT is ignored +RULER is ignored +COMPASS is ignored + CIAO + +When importing from CIAO into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX +RECTANGLE is translated into BOX +PANDA is translated as PIE SECTOR is ignored -FIELD is ignored -REGION is ignored -When exporting from DS9 into CIAO: PANDA is translated -into PIE -LINE is ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored -ELLIPSE ANNULUS is ignored -BOX ANNULUS is ignored -EPANDA is ignored -BPANDA is ignored -SAOimage -When importing from SAOIMAGE into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX When exporting -from DS9 into SAOIMAGE: LINE is -ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored ELLIPSE ANNULUS -is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored -IRAF PROS -When importing from PROS into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX When -exporting from DS9 into SAOIMAGE: LINE is -ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored ELLIPSE ANNULUS -is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored +FIELD is ignored +REGION is ignored + +When exporting from DS9 into CIAO: +PANDA is translated into PIE +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +EPANDA is ignored +BPANDA is ignored + SAOimage + + +When importing from SAOIMAGE into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX + +When exporting from DS9 into SAOIMAGE: +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored + IRAF PROS + +When importing from PROS into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX + +When exporting from DS9 into SAOIMAGE: +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored FITS -REGION Binary Table -When importing from FITS REGION -into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX -RECTANGLE is translated into BOX -ROTRECTANGLE is translated into a BOX -PIE is translated into PANDA +REGION Binary Table + +When importing from FITS REGION into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX +RECTANGLE is translated into BOX +ROTRECTANGLE is translated into a BOX +PIE is translated into PANDA ELLIPTANNULUS is translated into EPANDA -SECTOR is ignored -FIELD is ignored -DIAMOND is ignored RHOMBUS -is ignored ROTDIAMOND is -ignored ROTRHOMBUS is ignored - DS9 currently can not -export into this format. -X Y +SECTOR is ignored +FIELD is ignored +DIAMONDis ignored +RHOMBUSis ignored +ROTDIAMONDis ignored +ROTRHOMBUSis ignored + +DS9 currently can not export into this format. + X Y This format consists of a number of coordinate pairs, one per line. The coordinate format for both input and output is specified via the Save Regions Parameters menu or - Example: # this is a comment -physical # this overrides the specified coordinate -system -300 300 -400 400 # this is a comment - - +Example:# this is a comment +physical # this overrides the specified coordinate system +300 300 +400 400 # this is a comment + -- cgit v0.12 From d0bb2c55c4a03a07ede942b5c20271cfde060995 Mon Sep 17 00:00:00 2001 From: William Joye Date: Fri, 26 Apr 2019 18:28:46 -0400 Subject: clean up html --- ds9/doc/ref/file.html | 1434 ++++++++++++++++++++++--------------------------- 1 file changed, 645 insertions(+), 789 deletions(-) diff --git a/ds9/doc/ref/file.html b/ds9/doc/ref/file.html index 012bcf0..b3f15dc 100644 --- a/ds9/doc/ref/file.html +++ b/ds9/doc/ref/file.html @@ -1,796 +1,652 @@ - - - - - File Formats - - - File Formats - FITS - FITS Image - FITS Binary Events Table - FITS HEALPIX Table - FITS Data Cube - FITS Multiple Extension - Data Cube - FITS Multiple - Extension Multiple Frames - FITS Mosaic - FITS Mosaic Data Cube - FITS RGB - Split FITS - Array - NRRD - ENVI - GIF - TIFF - JPEG - PNG - External Format Support - External Analysis - Support - Region Files - Contour Files - Color Lookup Table - WCS - Preference File - Startup File - TCL - FITS - DS9 supports FITS images and FITS binary tables. The following - algorithm is used to locate and to load the FITS image or table if - no additional information is provide: - - - Examine primary HDU, if IMAGE, load. - - Examine each extension HDU - - - If IMAGE, load. - - If BINARY TABLE, create IMAGE if the following is - true: - - - FITS COMPRESSED: keyword ZIMAGE is T. - FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, - or RAYEVENT, - column names X and Y are present. - FITS HEALPIX: keyword PIXTYPE is HEALPIX. - - - - - - If DS9 traverses the entire FITS file without - satisfying - one of the above, an error is generated. - - - FITS keyword inheritance is supported. All valid FITS - BITPIX values are supported, along with -16, - for - UNSIGNED SHORT. The following FITS keywords are - supported: - OBJECT - UNITS - BSCALE / BZERO - BLANK - DATASEC - LTV / LTM for physical coords - DTV / DTM for detector coords - ATV / ATM for amplifier coords - WCS keywords - WCS# keywords - FITS Image - At load time, the user may provide just a file name or a file name - along with FITS extension name/number and image section - specification. FITS extension names are case insensitive. When - specifying an extension, be sure to quote strings correctly to - pass - both the shell and DS9 parser. A image section specification is - used to specify the x,y limits of an image subsection. By default, - x and y coordinates are in IMAGE, use a 'p' as - the last character to indicate PHYSICAL coordinates. A - '*' indicates use the default for that axis only. Block - is - optional and defaults to 1. - Syntax: - filename - filename[ext] - filename[ext][sect] - filename[sect] - filename[ext,sect] - - where - - ext: - [extension name | extension #] - - sect: - [x0:x1,y0:y1[p]] - - [x0:x1,y0:y1,block[p]] - - [x0:x1,y0:y1,z0:z1[p]] - - [x0:x1,y0:y1,block,z0:z1[p]] - [*,y0:y1[p]] - - [*,y0:y1,block[p]] - - [*,y0:y1,z0:z1[p]] - - [*,y0:y1,block,z0:z1[p]] - [x0:x1,*[p]] - - [x0:x1,*,block[p]] - - [x0:x1,*,z0:z1[p]] - - [x0:x1,*,block,z0:z1[p]] - [*,*,block] - - [*,*,z0:z1] - - [*,*,block,z0:z1] - - - [dim1@xcen,dim2@ycen[p]] - - [dim1@xcen,dim2@ycen,block[p]] - - [dim1@xcen,dim2@ycen,dim3@zcen[p]] - - [dim1@xcen,dim2@ycen,block,dim3@zcen[p]] - [*,dim2@ycen[p]] - - [*,dim2@ycen,block[p]] - - [*,dim2@ycen,dim3@zcen[p]] - - [*,dim2@ycen,block,dim3@zcen[p]] - [dim1@xcen,*[p]] - - [dim1@xcen,*,block[p]] - - [dim1@xcen,*,dim3@zcen[p]] - - [dim1@xcen,*,block,dim3@zcen[p]] - [*,*,block] - [*,*,dim3@zcen] - - [*,*,block,dim3@zcen] - - - [dim@xcen@ycen] - - [dim@xcen@ycen,block] - [dim@xcen@ycen,zdim@zcen] - [dim@xcen@ycen,block,zdim@zcen] - - Example: - $ds9 foo.fits # default load - $ds9 foo.fits[1] # load first extension - $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' - $ds9 foo.fits[10:200,40:100] # image section - $ds9 - foo.fits[10:200,40:100,2] # image section, blocked by 2 - - $ds9 foo.fits[*,40:100] # only section y axis - $ds9 foo.fits[256@512@512] # section box at 512,512 - $ds9 foo.fits[2][100:200,100:200] # second extension, image - section - $ds9 foo.fits[2][100:200,100:200,2] # - second extension, image section, blocked by 2 - $ds9 - foo.fits[10:200,40:100,5:20] # cube section - $ds9 foo.fits[*,40:100,5:20] # only section y and z axes - $ds9 foo.fits[256@512@512] # section cube at 512,512 - $ds9 foo.fits[2][100:200,100:200,5:20] # second extension, - cube - section - $ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, - cube section, blocked by 2 - FITS - Binary Events Table - - At load time, the user may provide just a file name or a - file name along with FITS extension name/number, image section - specification, and binnng parameters. DS9 will automatically - convert an FITS binary events table into a 2D image for display. - FITS extension names and parameters are case insensitive. The - users - may specify a number of parameters on how to construct the image - and how to filter data. When specifying a filter, be sure to quote - strings correctly to pass both the shell and DS9 - parser. - - Syntax: - - filename - filename[ext] - filename[ext][sect] - filename[sect] - filename[ext,sect] - - filename[ext][bin] - - filename[ext][bin][sect] - - filename[ext][sect][bin] - - filename[bin] - - filename[bin][sect] - - filename[sect][bin] - filename[ext,bin] - - where: - ext: see FITS Image - sect: see FITS Image - - bin: - [bin=colx,coly] # bin counts - - [bin=colx,coly,filter] # bin counts with filter - - [bin=colx,coly,colz] # bin on colz - - [bin=colx,coly,colz,filter] # bin on colz with - filter - [bin=colz] # bin cols 'x', 'y', and - colz - [bin=colz,filter] # bin cols 'x', 'y', - and colz with filter - [key=colx,coly] - [binkey=colx,coly] - - (see Introduction -to - Filtering) - - Example: - $ds9 foo.fits # default load - $ds9 foo.fits[1] # load first extension - $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' - $ds9 foo.fits[bin=detx,dety] # bin on detx,dety - $ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols - rawx,rawy - $ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, - cols rawx,rawy - $ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi - $ds9 foo.fits[bin=pi] # bin on x,y,pi - $ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted - filter - $ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # - double - quoted filter - $ds9 'foo.fits[events][pha>5,pi<2]' # load extension - 'events' and filter - - - The shell environment variable DS9_BINKEY may be used - to specify default bin cols for FITS bin tables. Example: - $ export DS9_BINKEY='[bin=rawx,rawy]' - $ ds9 foo.fits # load FITS bin table, bin on rawx, - rawy - - FITS - HEALPIX Table - - At load time, the user may provide just a file name or a file name - along with FITS extension name/number, image section - specification, - and Healpix parameters. DS9 will automatically convert a FITS - HEALPIX binary or ascii table into a 2D image for display. FITS - extension names and parameters are case insensitive. The users may - specify a number of parameters on how to construct the image. Any - table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as - an HEALPIX image. The following FITS keywords will be used if - present and not overwritten by a command line option: NSIDE, - COORDSYS, ORDER. - Syntax: - - filename - filename[ext] - filename[ext][sect] - filename[sect] - filename[ext,sect] - - filename[ext][hpx] - - filename[ext][hpx][sect] - - filename[ext][sect][hpx] - - filename[hpx] - - filename[hpx][sect] - - filename[sect][hpx] - filename[ext,hpx] - - where: - ext: see - FITS - Image - sect: see FITS - Image - - hpx: - [order=ring|nested] # default ring - [layout=equatorial|north|south] # default equatorial - [col=<column number>] # defaut 1 - [quad=<quadurant number>] # (1-4) default 1 - [system=equatorial|galactic|ecliptic|unknown] # default - unknown - - Example: - $ds9 foo.fits # default load - $ds9 foo.fits[1] # load first extension - $ds9 + + + + +File Formats + + + File Formats +FITS +FITS Image +FITS Binary Events Table +FITS HEALPIX Table +FITS Data Cube +FITS Multiple Extension +Data Cube +FITS Multiple +Extension Multiple Frames +FITS Mosaic +FITS Mosaic Data Cube +FITS RGB +Split FITS +Array +NRRD +ENVI +GIF +TIFF +JPEG +PNG +External Format Support +External Analysis +Support +Region Files +Contour Files +Color Lookup Table +WCS +Preference File +Startup File +TCL +FITS +DS9 supports FITS images and FITS binary tables. The following +algorithm is used to locate and to load the FITS image or table if +no additional information is provide: + + +Examine primary HDU, if IMAGE, load. +Examine each extension HDU + + +If IMAGE, load. +If BINARY TABLE, create IMAGE if the following is +true: + + +FITS COMPRESSED: keyword ZIMAGE is T. +FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, +column names X and Y are present. +FITS HEALPIX: keyword PIXTYPE is HEALPIX. + + + + +If DS9 traverses the entire FITS file without satisfying +one of the above, an error is generated. + + +FITS keyword inheritance is supported. All valid FITS +BITPIX values are supported, along with -16, for +UNSIGNED SHORT. The following FITS keywords are +supported: + +OBJECT +UNITS +BSCALE / BZERO +BLANK +DATASEC +LTV / LTM for physical coords +DTV / DTM for detector coords +ATV / ATM for amplifier coords +WCS keywords +WCS# keywords +FITS Image +At load time, the user may provide just a file name or a file name +along with FITS extension name/number and image section +specification. FITS extension names are case insensitive. When +specifying an extension, be sure to quote strings correctly to pass +both the shell and DS9 parser. A image section specification is +used to specify the x,y limits of an image subsection. By default, +x and y coordinates are in IMAGE, use a 'p' as +the last character to indicate PHYSICAL coordinates. A +'*' indicates use the default for that axis only. Block is +optional and defaults to 1. + +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +where + +ext: +[extension name | extension #] + +sect: +[x0:x1,y0:y1[p]] +[x0:x1,y0:y1,block[p]] +[x0:x1,y0:y1,z0:z1[p]] +[x0:x1,y0:y1,block,z0:z1[p]] +[*,y0:y1[p]] +[*,y0:y1,block[p]] +[*,y0:y1,z0:z1[p]] +[*,y0:y1,block,z0:z1[p]] +[x0:x1,*[p]] +[x0:x1,*,block[p]] +[x0:x1,*,z0:z1[p]] +[x0:x1,*,block,z0:z1[p]] +[*,*,block] +[*,*,z0:z1] +[*,*,block,z0:z1] + +[dim1@xcen,dim2@ycen[p]] +[dim1@xcen,dim2@ycen,block[p]] +[dim1@xcen,dim2@ycen,dim3@zcen[p]] +[dim1@xcen,dim2@ycen,block,dim3@zcen[p]] +[*,dim2@ycen[p]] +[*,dim2@ycen,block[p]] +[*,dim2@ycen,dim3@zcen[p]] +[*,dim2@ycen,block,dim3@zcen[p]] +[dim1@xcen,*[p]] +[dim1@xcen,*,block[p]] +[dim1@xcen,*,dim3@zcen[p]] +[dim1@xcen,*,block,dim3@zcen[p]] +[*,*,block] +[*,*,dim3@zcen] +[*,*,block,dim3@zcen] + +[dim@xcen@ycen] +[dim@xcen@ycen,block] +[dim@xcen@ycen,zdim@zcen] +[dim@xcen@ycen,block,zdim@zcen] + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' +$ds9 foo.fits[10:200,40:100] # image section +$ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 +$ds9 foo.fits[*,40:100] # only section y axis +$ds9 foo.fits[256@512@512] # section box at 512,512 +$ds9 foo.fits[2][100:200,100:200] # second extension, image +section +$ds9 foo.fits[2][100:200,100:200,2] # second extension, image +section, blocked by 2 +$ds9 foo.fits[10:200,40:100,5:20] # cube section +$ds9 foo.fits[*,40:100,5:20] # only section y and z axes +$ds9 foo.fits[256@512@512] # section cube at 512,512 +$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube +section +$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube +section, blocked by 2 + FITS Binary Events Table + At load time, the user may provide just a file name or a +file name along with FITS extension name/number, image section +specification, and binnng parameters. DS9 will automatically +convert an FITS binary events table into a 2D image for display. +FITS extension names and parameters are case insensitive. The users +may specify a number of parameters on how to construct the image +and how to filter data. When specifying a filter, be sure to quote +strings correctly to pass both the shell and DS9 +parser. +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +filename[ext][bin] +filename[ext][bin][sect] +filename[ext][sect][bin] +filename[bin] +filename[bin][sect] +filename[sect][bin] +filename[ext,bin] + +where: +ext: seeFITS Image +sect: seeFITS Image + +bin: +[bin=colx,coly] # bin counts +[bin=colx,coly,filter] # bin counts with filter +[bin=colx,coly,colz] # bin on colz +[bin=colx,coly,colz,filter] # bin on colz with filter +[bin=colz] # bin cols 'x', 'y', and colz +[bin=colz,filter] # bin cols 'x', 'y', and colz with filter +[key=colx,coly] +[binkey=colx,coly] +(see Introduction +to Filtering) + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' +$ds9 foo.fits[bin=detx,dety] # bin on detx,dety +$ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy +$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols +rawx,rawy +$ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi +$ds9 foo.fits[bin=pi] # bin on x,y,pi +$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted +filter +$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double +quoted filter +$ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' +and filter + +The shell environment variable DS9_BINKEY may be used +to specify default bin cols for FITS bin tables. Example: +$ export DS9_BINKEY='[bin=rawx,rawy]' +$ ds9 foo.fits # load FITS bin table, bin on rawx, rawy +FITS +HEALPIX Table +At load time, the user may provide just a file name or a file name +along with FITS extension name/number, image section specification, +and Healpix parameters. DS9 will automatically convert a FITS +HEALPIX binary or ascii table into a 2D image for display. FITS +extension names and parameters are case insensitive. The users may +specify a number of parameters on how to construct the image. Any +table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as +an HEALPIX image. The following FITS keywords will be used if +present and not overwritten by a command line option: NSIDE, +COORDSYS, ORDER. + +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +filename[ext][hpx] +filename[ext][hpx][sect] +filename[ext][sect][hpx] +filename[hpx] +filename[hpx][sect] +filename[sect][hpx] +filename[ext,hpx] + +where: +ext: seeFITS +Image +sect: seeFITS +Image + +hpx: +[order=ring|nested] # default ring +[layout=equatorial|north|south] # default equatorial +[col=<column number>] # defaut 1 +[quad=<quadurant number>] # (1-4) default 1 +[system=equatorial|galactic|ecliptic|unknown] # default unknown + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] - $ds9 foo.fits[1,order=nested] # first extension, - nested - order - - FITS - Cube - A FITS Cube is a FITS image which contains more than 2 axes - (NAXES>2). DS9 will automatically detect if a cube is present - and will load all additional images. In addition, individual - images - can be loaded one at a time into a cube. DS9 will display the Cube - dialog box which allows the user to select which 2 image to be - displayed. - FITS Multiple - Extension - Cube - A FITS Multiple Extension Data Cube file is a FITS file with one - or - more extensions, that is to be displayed as a data cube. Each - image - does not have to be the same size, however, only the coordinate - systems from the first extension will be used for contours and - grids. - Example: - $ds9 -mecube foo.fits # load multiple extension fits file as - data cube - FITS Multiple - Extension - Multiple Frames - Load a multiple extension FITS file into multiple frames. Please - note that files loaded via standard-in or the xpa fits command can - not be displayed using this method. - Example: - $ds9 -multiframe foo.fits # load multiple extension fits - file - as multiple frames - FITS Mosaic - A FITS mosaic image may exist as a series of FITS files, or as one - FITS file with many extensions. A FITS mosaic may be loaded all a - one time, or by the segment. Once loaded, the multiple FITS images - are treated as one FITS image. - - DS9 supports three forms of mosaics: - - - - - - - - - - - - - - - - - IRAF - contains the DETSEC and DETSIZE - keywords. - See NOAO -IRAF - Mosaic Data Structures - WCS - each FITS image contains - a valid - WCS. - HST WFPC2 - valid HST WFPC2 data - cube, - consisting of 4 planes, along with a fits ascii table - containing - wcs information. - - Example: - $ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one - fits file with multiple exts - $ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic - iraf - from 3 files - $ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one - fits - file with multiple exts - $ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic - wcs - from 3 files - $ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic - $ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) - from 3 files - - FITS -Mosaic - Data Cube - A FITS Mosaic Data Cube is a FITS mosaic image which contains more - than 2 axes (NAXES>2). DS9 will automatically detect if a - mosaic - data cube is present and will load all additional images. At the - same time, DS9 will display the data cube dialog box which allows - the user to select which 2 image to be displayed. - FITS RGB - A FITS RGB image may exist as three of FITS images, one FITS file - with three extensions, or as a FITS 3D Data cube, with three - slices, each representing the red, green, and blue channel. A FITS - RGB image may be loaded all a one time, or by the channel. Once - loaded, the multiple FITS images are treated as one FITS image. - Example: - $ds9 -rgbimage rgb.fits # load rgb image consisting of one - fits - file with 3 image exts - $ds9 -rgbcube cube.fits # load rgb image consisting of one - fits - data cube - $ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb - image from 3 fits images - - Split FITS - A split fits is a valid fits file in which two files contain the - header and data segments. - Array - Raw data arrays are supported. To load an array, the user must - provide the dimensions, pixel depth, and optional header size and - architecture type. - Syntax: - - filename[arr] - - filename[arr][sect] - filename[sect][arr] - - where - sect: see FITS - Image - arr: - - xdim=value - ydim=value - zdim=value # default is a depth of 1 - dim=value - dims=value - bitpix=[8|16|-16|32|64|-32|-64] - skip=value # must be even, most must be factor of 4 - arch|endian=[big|bigendian|little|littleendian] - - Example: - $ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load - 512x512 short - $ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 - float - with 4 byte head - $ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load - 512x512 - long, intel - - or alternate format: - filename[array(<type><dim><:skip><endian>)] - - where: - type: - 'b' 8 -bit unsigned char - 's' 16-bit short int - 'u' 16-bit unsigned short int - 'i' 32-bit int - 'l' 64-bit int - 'r' 32-bit float - 'f' 32-bit float - 'd' 64-bit float - dim: - int     # x,y dim - int.int # x,y dim - int.int.int # x,y,z dim - - skip: - int     # number of bytes to - skip - endian: - 'l' little endian - 'b' big endian - - Example: - $ds9 -array bar.arr[array(s512)]   # load 512x512 - short - $ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 - byte - head - $ds9 -array bar.arr[array(i512l)] # load 512x512 long, - intel - The shell environment variable DS9_ARRAY may be - used to - specify default array parameters. - Example: - $export DS9_ARRAY='[dim=256,bitpix=-32]' - $ds9 -array foo.arr # load 256x256 float - - NRRD (Nearly Raw Raster - Data) - - Images in NRRD are supported directly. Encodings supported: - raw, gzip - - Syntax: - - filename - - filename[sect] - - where: - sect: see FITS - Image - - - Example: - $ds9 -nrrd foo.nrrd - $ds9 -nrrd foo.nrrd[100:200,100:200] # cropped - ENVI - - Images in ENVI are supported directly. Encodings supported: - BIL, BIP, BSQ. - - Syntax: - - filename - - filename[sect] - - where: - sect: see FITS - Image - - - Example: - $ds9 -envi foo.hdr foo.bsq - $ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped - - GIF - - Images in GIF are supported directly. For a Frame, the - average of the luminosity is used. For Frame RGB, each - channel is loaded directly. - - Syntax: - - filename - - Example: - $ ds9 -gif foo.gif - TIFF - - Images in TIFF are supported directly. For a Frame, the - average of the luminosity is used. For Frame RGB, each - channel is loaded directly. - - Syntax: - - filename - - Example: - $ ds9 -tiff foo.tiff - JPEG - - Images in JPEG are supported directly. For a Frame, the - average of the luminosity is used. For Frame RGB, each - channel is loaded directly. - - Syntax: - - filename - - Example: - $ ds9 -jpeg foo.jpeg - PNG - - Images in PNG are supported directly. For a Frame, the - average of the luminosity is used. For Frame RGB, each - channel is loaded directly. - - Syntax: - - filename - - Example: - $ ds9 -png foo.png - External - File Support - DS9 supports external file formats via an ASCII description file. - When loading a file into DS9, these descriptions are referenced - for - instructions for loading the file, based on the file extension. If - found, the command is executed and the result, a FITS image or - FITS - Binary Table, is read into DS9 via stdin. - At start-up, DS9 first searches for the ASCII file, named - .ds9.filin the local directory, then in the users home - directory. - The file command first is macro-expanded to fill in user-defined - arguments and then is executed externally. - The ASCII file that defines the known image files consists of one - or more file descriptors, each of which has the following format: - Help description - A space-separated list of templates - A space-separated list of file types (not currently used) - The command line for the loading this file - type - - Note that blank lines separate the file descriptions and should - not - be used as part of a description. Also, the '#' character is a - comment character. - - The following macros are supported: $filename - For Example: - # File access descriptions: - #       help explanation - #       file template - #       file type - #       access command - IRAF IMH files - *.imh - IMH - i2f -s $filename - External Analysis Support - For more information about external analysis support files, see - Analysis. - Region - Files - DS9 can read and write a number of region file formats. See - Regions documentation for more - information. - DS9 - FUNTools - Ciao - SAOimage - IRAF PROS - FITS REGION Binary - Table - X Y - - Contour - Files - See Contours - documentation for more information. - Color - Lookup Table - DS9 has a number of default colormaps available to the user. DS9 - also supports reading and writing color lookup table formats from - the following programs: - - SAOimage - SAOtng - XImtool - - DS9 uses the file extension to determine the color table format: - - - - - - - - - - - - - - - - - - - - - - Ext - - Format - .lut XImtool, SAOtng .sao DS9, SAOimage any other DS9 - - WCS - A new WCS specification can be loaded and used by the current - image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file via XPA. The - format of the specification is a set of valid FITS keywords that - describe a WCS. - Example: -     CRPIX1 + +$ds9 foo.fits[1,order=nested] # first extension, nested +order +FITS +Cube +A FITS Cube is a FITS image which contains more than 2 axes +(NAXES>2). DS9 will automatically detect if a cube is present +and will load all additional images. In addition, individual images +can be loaded one at a time into a cube. DS9 will display the Cube +dialog box which allows the user to select which 2 image to be +displayed. +FITS Multiple Extension +Cube +A FITS Multiple Extension Data Cube file is a FITS file with one or +more extensions, that is to be displayed as a data cube. Each image +does not have to be the same size, however, only the coordinate +systems from the first extension will be used for contours and +grids. + +Example: +$ds9 -mecube foo.fits # load multiple extension fits file as data +cube +FITS Multiple Extension +Multiple Frames +Load a multiple extension FITS file into multiple frames. Please +note that files loaded via standard-in or the xpa fits command can +not be displayed using this method. + +Example: +$ds9 -multiframe foo.fits # load multiple extension fits file as +multiple frames +FITS Mosaic +A FITS mosaic image may exist as a series of FITS files, or as one +FITS file with many extensions. A FITS mosaic may be loaded all a +one time, or by the segment. Once loaded, the multiple FITS images +are treated as one FITS image. + +DS9 supports three forms of mosaics: + + + + + + + + + + + + + + + + +IRAF contains the DETSEC and DETSIZE keywords. +See NOAO +IRAF Mosaic Data Structures WCS each FITS image contains a valid +WCS. HST WFPC2 valid HST WFPC2 data cube, +consisting of 4 planes, along with a fits ascii table containing +wcs information. + + +Example: +$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits +file with multiple exts +$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf +from 3 files +$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file +with multiple exts +$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from +3 files +$ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic +$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 +files +FITS +Mosaic Data Cube +A FITS Mosaic Data Cube is a FITS mosaic image which contains more +than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic +data cube is present and will load all additional images. At the +same time, DS9 will display the data cube dialog box which allows +the user to select which 2 image to be displayed. +FITS RGB +A FITS RGB image may exist as three of FITS images, one FITS file +with three extensions, or as a FITS 3D Data cube, with three +slices, each representing the red, green, and blue channel. A FITS +RGB image may be loaded all a one time, or by the channel. Once +loaded, the multiple FITS images are treated as one FITS image. + +Example: +$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits +file with 3 image exts +$ds9 -rgbcube cube.fits # load rgb image consisting of one fits +data cube +$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image +from 3 fits images +Split FITS +A split fits is a valid fits file in which two files contain the +header and data segments. +Array +Raw data arrays are supported. To load an array, the user must +provide the dimensions, pixel depth, and optional header size and +architecture type. +Syntax: +filename[arr] +filename[arr][sect] +filename[sect][arr] + +where +sect: see FITS +Image +arr: +xdim=value +ydim=value +zdim=value # default is a depth of 1 +dim=value +dims=value +bitpix=[8|16|-16|32|64|-32|-64] +skip=value # must be even, most must be factor of 4 +arch|endian=[big|bigendian|little|littleendian] +Example: +$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load +512x512 short +$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float +with 4 byte head +$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 +long, intel +or alternate format: +filename[array(<type><dim><:skip><endian>)] + + +where: +type: +'b' 8 -bit unsigned char +'s' 16-bit short int +'u' 16-bit unsigned short int +'i' 32-bit int +'l' 64-bit int +'r' 32-bit float +'f' 32-bit float +'d' 64-bit float +dim: +int     # x,y dim +int.int # x,y dim +int.int.int # x,y,z dim +skip: +int     # number of bytes to +skip +endian: +'l' little endian +'b' big endian +Example: +$ds9 -array bar.arr[array(s512)]   # load 512x512 +short +$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte +head +$ds9 -array bar.arr[array(i512l)] # load 512x512 long, +intel +The shell environment variable DS9_ARRAY may be used to +specify default array parameters. +Example: +$export DS9_ARRAY='[dim=256,bitpix=-32]' +$ds9 -array foo.arr # load 256x256 float +NRRD (Nearly Raw Raster +Data) +Images in NRRD are supported directly. Encodings supported: +raw, gzip +Syntax: filename +filename[sect] + +where: +sect: see FITS +Image +Example: +$ds9 -nrrd foo.nrrd +$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped +ENVI +Images in ENVI are supported directly. Encodings supported: BIL, +BIP, BSQ. +Syntax: +filename +filename[sect] + +where: +sect: see FITS +Image + +Example: +$ds9 -envi foo.hdr foo.bsq +$ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped +GIF +Images in GIF are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly. + +Syntax: +filename + +Example: +$ ds9 -gif foo.gif +TIFF +Images in TIFF are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly. + +Syntax: +filename + +Example: +$ ds9 -tiff foo.tiff +JPEG +Images in JPEG are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly. + +Syntax: +filename + +Example: +$ ds9 -jpeg foo.jpeg +PNG +Images in PNG are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly. + +Syntax: +filename + +Example: +$ ds9 -png foo.png +External File Support +DS9 supports external file formats via an ASCII description file. +When loading a file into DS9, these descriptions are referenced for +instructions for loading the file, based on the file extension. If +found, the command is executed and the result, a FITS image or FITS +Binary Table, is read into DS9 via stdin. +At start-up, DS9 first searches for the ASCII file, named +.ds9.filin the local directory, then in the users home +directory. +The file command first is macro-expanded to fill in user-defined +arguments and then is executed externally. +The ASCII file that defines the known image files consists of one +or more file descriptors, each of which has the following +format: + +Help description +A space-separated list of templates +A space-separated list of file types (not currently +used) +The command line for the loading this file type + +Note that blank lines separate the file descriptions and should not +be used as part of a description. Also, the '#' character is a +comment character. + +The following macros are supported: $filename + +For Example: +# File access descriptions: +#       help explanation +#       file template +#       file type +#       access command +IRAF IMH files +*.imh +IMH +i2f -s $filename +External Analysis Support +For more information about external analysis support files, see +Analysis. +Region +Files +DS9 can read and write a number of region file formats. See +Regions documentation for more +information. + +DS9 +FUNTools +Ciao +SAOimage +IRAF PROS +FITS REGION Binary +Table +X Y +Contour +Files +See Contours documentation for more +information. +Color +Lookup Table +DS9 has a number of default colormaps available to the user. DS9 +also supports reading and writing color lookup table formats from +the following programs: + +SAOimage +SAOtng +XImtool + +DS9 uses the file extension to determine the color table +format: + +.lut # XImtool, SAOtng +.sao # DS9, SAOImage +WCS +A new WCS specification can be loaded and used by the current image +regardless of the WCS that was contained in the image file. WCS +specification can be sent to DS9 as an ASCII file via XPA. The +format of the specification is a set of valid FITS keywords that +describe a WCS. + +CRPIX1 =               - 257.75 -     CRPIX2 +257.75 +CRPIX2 =               - 258.93 -     CRVAL1 - =      - -201.94541667302 -     CRVAL2 +258.93 +CRVAL1 =      +-201.94541667302 +CRVAL2 =             - -47.45444 -     CDELT1 - =        -2.1277777E-4 -     CDELT2 - =         2.1277777E-4 -     CTYPE1 = 'RA---TAN' -     CTYPE2 = 'DEC--TAN' - - Note that the WCS definitions can contain standard FITS 80 - character WCS card images, as shown above, or free-form name/value - pairs without the intervening "=" sign: -     CRPIX1    - 257.75 -     CRPIX2    258.93 -     CRVAL1    -201.94541667302 -     CRVAL2    -47.45444 -     CDELT1    -2.1277777E-4 -     CDELT2    2.1277777E-4 -     CTYPE1   'RA---TAN' -     CTYPE2   'DEC--TAN' - Preference - File - A preference file is a valid tcl script generated by DS9 to save - the current preference items. See Preferences - for more information. - Startup - File - If a startup file $HOME/ds9.ini is available, it is - sourced as the last step in initialization. The file permissions - must be group/world readonly. - Users may have several different startup files. DS9 looks for a - startup file with its own name. By default, if the application is - named ds9, it will look for .ds9.ini. However, - if - the DS9 application is named foo, then DS9 will look for - .foo.ini. In this manner, the user can have several - predefined startup files that are activated by invoking DS9 with a - different application names. - TCL - TCL/TK script file. Users may customize the appearance and enhance - the capabilities of DS9 by sourcing their own TCL - scripts. - +-47.45444
+CDELT1 =        +-2.1277777E-4
+CDELT2 =         +2.1277777E-4
+CTYPE2 = 'DEC--TAN'
+
+Note that the WCS definitions can contain standard FITS 80 +character WCS card images, as shown above, or free-form name/value +pairs without the intervening "=" sign:
+
+CRPIX1    257.75
+CRPIX2    258.93
+CRVAL1    -201.94541667302
+CRVAL2    -47.45444
+CDELT1    -2.1277777E-4
+CDELT2    2.1277777E-4
+CTYPE1   'RA---TAN'
+CTYPE2   'DEC--TAN'
+
+
Preference +File
+A preference file is a valid tcl script generated by DS9 to save +the current preference items. See Preferences for more information. +
Startup +File
+If a startup file $HOME/ds9.ini is available, it is +sourced as the last step in initialization. The file permissions +must be group/world readonly.
+Users may have several different startup files. DS9 looks for a +startup file with its own name. By default, if the application is +named ds9, it will look for .ds9.ini. However, if +the DS9 application is named foo, then DS9 will look for +.foo.ini. In this manner, the user can have several +predefined startup files that are activated by invoking DS9 with a +different application names.
+
TCL
+TCL/TK script file. Users may customize the appearance and enhance +the capabilities of DS9 by sourcing their own TCL +scripts.
+ -- cgit v0.12 From b5e6f9bbee688aa883f4538ad4a1fc877135b8bd Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 14:29:16 -0400 Subject: clean up doc --- ds9/doc/ref/command.html | 5218 +++++++++++++++++++------------------ ds9/doc/ref/samp.html | 6452 +++++++++++++++++++++++----------------------- ds9/doc/ref/xpa.html | 6138 ++++++++++++++++++++++--------------------- 3 files changed, 9025 insertions(+), 8783 deletions(-) diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index 0694f7d..1a33f5c 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -1,2582 +1,2654 @@ - - - - -Command Line Options - - -
Command Line Options
-
-
DS9 will process each command line option, one at a time, as the -last step in the initialization process. Therefore, it is possible -to use command line options as a little script. For example, the -following command line option is used:
-$ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 -
First DS9 is put in tile mode, then foo.fits is loaded. -Then the colormap for foo.fits is changed to Heat -and the scale changed to zscale. Next, bar.fits -is loaded and the colormap for bar.fits is changed to -I8.
-2mass -3d -about -align -analysis -array -asinh -background -backup -bin -blink -block -blue -catalog -cd -cmap -colorbar -console -contour -crop -crosshair -cube -cursor -dsssao -dsseso -dssstsci -envi -exit -export -fifo -fifo_only -fits -frame -geometry -gif -green -grid -header -height -help -histequ -iconify -inet_only -invert -iis -jpeg -language -linear -lock -log -lower -magnifier -mask -match -mecube -minmax -mode -mosaic -mosaicimage -movie -msg -multiframe -nameserver -nan -nrrd -nvss -orient -pagesetup -pan -pixeltable -plot -png -precision -prefs -preserve -psprint -print -port -port_only -pow -quit -raise -regions -red -restore -rgb -rgbarray -rgbcube -rgbimage -rotate -samp -save -saveimage -scale -shm -sia -single -sinh -skyview -sleep -slice -smooth -squared -sqrt -source -tcl -threads -tiff -tile -title -unix -unix_only -update -url -version -view -visual -vla -vlss -vo -wcs -web -width -xpa -zmax -zoom -zscale
-
2mass
-
Support for 2MASS Digital Sky Survey.
-Syntax: --2mass [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey j|h|k] -    [open|close] - -Example: -$ds9 -2mass -$ds9 -2mass m31 -$ds9 -2mass name m31 -$ds9 -2mass name clear -$ds9 -2mass 00:42:44.404 +41:16:08.78 -$ds9 -2mass size 60 60 arcmin -$ds9 -2mass save yes -$ds9 -2mass frame current -$ds9 -2mass update frame -$ds9 -2mass survey j -$ds9 -2mass open -$ds9 -2mass close -
3d
-
Support for 3D frame.
-Syntax: --3d [] -    [view <az> <el>] -    [az <az>] -    [el <el>] -    [scale <scale>] -    [method mip|aip] -    [background none|azimuth|elevation] -    [border yes|no] -    [border color] -    [highlite yes|no] -    [highlite color] -    [compass yes|no] -    [compass color] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$ds9 -3d # create new 3D frame -$ds9 -3d view 45 30 -$ds9 -3d az 45 -$ds9 -3d el 30 -$ds9 -3d scale 10 -$ds9 -3d method mip -$ds9 -3d background azimuth -$ds9 -3d border yes -$ds9 -3d border color red -$ds9 -3d highlite yes -$ds9 -3d highlite color red -$ds9 -3d compass yes -$ds9 -3d compass color red -$ds9 -3d match -$ds9 -3d lock yes -$ds9 -3d open -$ds9 -3d close
-
about
-
Get DS9 credits.
-Syntax: --about - -Example: -$ds9 -about -
align
-
Controls the World Coordinate System alignment for the current -frame.
-Syntax: --align [yes|no] - -Example: -$ds9 -align yes -
analysis
-
Control external analysis tasks. Tasks are numbered as they are -loaded, starting with 0. Can also be used to display a message and -display text in the text dialog window.
-Syntax: --analysis [<task number>] -    [<filename>] -    [task <task number>|<task name>] -    [load <filename>] -    [clear] -    [clear][load <filename>] -    [message ok|okcancel|yesno <message>] -    [entry <message>] -    [text] - -Example: -$ds9 -analysis 0 # invoke first analysis task -$ds9 -analysis task 0 -$ds9 -analysis task foobar -$ds9 -analysis task {foo bar} -$ds9 -analysis my.ans -$ds9 -analysis load my.ans -$ds9 -analysis clear -$ds9 -analysis clear load my.ans -$ds9 -analysis message {This is a message} -$ds9 -analysis text {This is text} -
array
-
Load raw data array into current frame.
-Syntax: --array <filename> + + + + + Command Line Options + + + Command Line Options + + DS9 will process each command line option, one at a time, as + the last step in the initialization process. Therefore, it is + possible to use command line options as a little script. For + example, the following command line option is used: + $ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 + First DS9 is put in tile mode, then foo.fits is + loaded. Then the colormap for foo.fits is changed to Heat + and the scale changed to zscale. Next, bar.fits + is loaded and the colormap for bar.fits is changed to + I8. + 2mass + 3d + about + align + analysis + array + asinh + background + backup + bin + blink + block + blue + catalog + cd + cmap + colorbar + console + contour + crop + crosshair + cube + cursor + dsssao + dsseso + dssstsci + envi + exit + export + fifo + fifo_only + fits + frame + geometry + gif + green + grid + header + height + help + histequ + iconify + inet_only + invert + iis + jpeg + language + linear + lock + log + lower + magnifier + mask + match + mecube + minmax + mode + mosaic + mosaicimage + movie + msg + multiframe + nameserver + nan + nrrd + nvss + orient + pagesetup + pan + pixeltable + plot + png + precision + prefs + preserve + psprint + print + port + port_only + pow + quit + raise + regions + red + restore + rgb + rgbarray + rgbcube + rgbimage + rotate + samp + save + saveimage + scale + shm + sia + single + sinh + skyview + sleep + slice + smooth + squared + sqrt + source + tcl + threads + tiff + tile + title + unix + unix_only + update + url + version + view + visual + vla + vlss + vo + wcs + web + width + xpa + zmax + zoom + zscale + 2mass + Support for 2MASS Digital Sky Survey. + Syntax: + -2mass [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey j|h|k] +     [open|close] + + Example: + $ds9 -2mass + $ds9 -2mass m31 + $ds9 -2mass name m31 + $ds9 -2mass name clear + $ds9 -2mass 00:42:44.404 +41:16:08.78 + $ds9 -2mass size 60 60 arcmin + $ds9 -2mass save yes + $ds9 -2mass frame current + $ds9 -2mass update frame + $ds9 -2mass survey j + $ds9 -2mass open + $ds9 -2mass close + + 3d + Support for 3D frame. + Syntax: + -3d [] +     [view <az> <el>] +     [az <az>] +     [el <el>] +     [scale <scale>] +     [method mip|aip] +     [background none|azimuth|elevation] +     [border yes|no] +     [border color] +     [highlite yes|no] +     [highlite color] +     [compass yes|no] +     [compass color] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $ds9 -3d # create new 3D frame + $ds9 -3d view 45 30 + $ds9 -3d az 45 + $ds9 -3d el 30 + $ds9 -3d scale 10 + $ds9 -3d method mip + $ds9 -3d background azimuth + $ds9 -3d border yes + $ds9 -3d border color red + $ds9 -3d highlite yes + $ds9 -3d highlite color red + $ds9 -3d compass yes + $ds9 -3d compass color red + $ds9 -3d match + $ds9 -3d lock yes + $ds9 -3d open + $ds9 -3d close + about + Get DS9 credits. + Syntax: + -about + + Example: + $ds9 -about + + align + Controls the World Coordinate System alignment for the current + frame. + Syntax: + -align [yes|no] + + Example: + $ds9 -align yes + + analysis + Control external analysis tasks. Tasks are numbered as they are + loaded, starting with 0. Can also be used to display a message + and display text in the text dialog window. + Syntax: + -analysis [<task number>] +     [<filename>] +     [task <task number>|<task name>] +     [load <filename>] +     [clear] +     [clear][load <filename>] +     [message ok|okcancel|yesno <message>] +     [entry <message>] +     [text] + + Example: + $ds9 -analysis 0 # invoke first analysis task + $ds9 -analysis task 0 + $ds9 -analysis task foobar + $ds9 -analysis task {foo bar} + $ds9 -analysis my.ans + $ds9 -analysis load my.ans + $ds9 -analysis clear + $ds9 -analysis clear load my.ans + $ds9 -analysis message {This is a message} + $ds9 -analysis text {This is text} + + array + Load raw data array into current frame. + + Syntax: + -array <filename> [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -$ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] -$cat foo.arr | ds9 -array --[dim=512,bitpix=-32,endian=little] -asinh -Select ASINH scale function for the current frame. -Syntax: --asinh - -Example: -$ds9 -asinh -bg -background -Set image background color. -Syntax: --bg <color> - -Example: -$ds9 -background red -$ds9 -bg red -backup -Create a backup save set. -Syntax: --backup <filename> - -Example: -$ds9 -backup ds9.bck -bin -Controls binning factor, binning buffer size, and binning -function for binning FITS bin tables. -Syntax: --bin [about <x> <y>] -    [about center] -    [buffersize <value>] -    [cols <x> <y>] -    [colsz <x> <y> <z>] -    [factor <value> [<value>]] -    [depth <value>] -    [filter <string>] -    [filter clear] -    [function average|sum] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$ds9 -bin about 4096 4096 -$ds9 -bin about center -$ds9 -bin buffersize 512 -$ds9 -bin cols detx dety -$ds9 -bin colsz detx dety time -$ds9 -bin factor 4 -$ds9 -bin factor 4 2 -$ds9 -bin depth 10 -$ds9 -bin filter 'pha > 5' -$ds9 -bin filter clear -$ds9 -bin function sum -$ds9 -bin in -$ds9 -bin out -$ds9 -bin to fit -$ds9 -bin match -$ds9 -bin lock yes -$ds9 -bin open -$ds9 -bin close -blink -Blink mode parameters. Interval is in seconds. -Syntax: --blink [] -    [yes|no] -    [interval <value>] - -Example: -$ds9 -blink -$ds9 -blink yes -$ds9 -blink interval 1 -block -Controls blocking parameters. -Syntax: --block[<value>] -    [<value> <value>] -    [to <value>] -    [to <value> <value>] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$ds9-block4 -$ds9-block4 2 -$ds9-blockto 4 -$ds9-blockto 4 2 -$ds9-blockin -$ds9-blockout -$ds9-blockto fit -$ds9-blockmatch -$ds9-blocklock yes -$ds9-blockopen -$ds9-blockclose -blue -For RGB frames, sets the current color channel to blue. -Syntax: --blue - -Example: -$ds9 -blue foo.fits -catalog -cat -Support for catalogs. The first three commands will create a new -catalog search. All other commands operated on the last search -created, unless indicated otherwise. -Syntax: --catalog [new] -    [ned|simbad|denis|skybot] -    + + Example: + $ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] + $cat foo.arr | ds9 -array -[dim=512,bitpix=-32,endian=little] + + asinh + Select ASINH scale function for the current frame. + Syntax: + -asinh + + Example: + $ds9 -asinh + bg + background + Set image background color. + Syntax: + -bg <color> + + Example: + $ds9 -background red + $ds9 -bg red + backup + Create a backup save set. + Syntax: + -backup <filename> + + Example: + $ds9 -backup ds9.bck + bin + Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables. + Syntax: + -bin [about <x> <y>] +     [about center] +     [buffersize <value>] +     [cols <x> <y>] +     [colsz <x> <y> <z>] +     [factor <value> [<value>]] +     [depth <value>] +     [filter <string>] +     [filter clear] +     [function average|sum] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $ds9 -bin about 4096 4096 + $ds9 -bin about center + $ds9 -bin buffersize 512 + $ds9 -bin cols detx dety + $ds9 -bin colsz detx dety time + $ds9 -bin factor 4 + $ds9 -bin factor 4 2 + $ds9 -bin depth 10 + $ds9 -bin filter 'pha > 5' + $ds9 -bin filter clear + $ds9 -bin function sum + $ds9 -bin in + $ds9 -bin out + $ds9 -bin to fit + $ds9 -bin match + $ds9 -bin lock yes + $ds9 -bin open + $ds9 -bin close + + blink + Blink mode parameters. Interval is in seconds. + Syntax: + -blink [] +     [yes|no] +     [interval <value>] + + Example: + $ds9 -blink + $ds9 -blink yes + $ds9 -blink interval 1 + block + Controls blocking parameters. + Syntax: + -block[<value>] +     [<value> <value>] +     [to <value>] +     [to <value> <value>] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $ds9-block4 + $ds9-block4 2 + $ds9-blockto 4 + $ds9-blockto 4 2 + $ds9-blockin + $ds9-blockout + $ds9-blockto fit + $ds9-blockmatch + $ds9-blocklock yes + $ds9-blockopen + $ds9-blockclose + + blue + For RGB frames, sets the current color channel to blue. + Syntax: + -blue + + Example: + $ds9 -blue foo.fits + + catalog + cat + Support for catalogs. The first three commands will create a + new catalog search. All other commands operated on the last + search created, unless indicated otherwise. + Syntax: + -catalog [new] +     [ned|simbad|denis|skybot] +     [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] - -    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -    [2mass|iras] -    [csc|xmm|rosat] -    [first|nvss] -    [chandralog|cfhtlog|esolog|stlog|xmmlog] -    [cds <catalogname>] -    [cds <catalogid>] - -    [load <filename>] -    [import sb|tsv <filename>] - -    [<ref>] [<ra> <dec> -<coordsys>] -    [<ref>] [allcols] -    [<ref>] [allrows] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [crosshair] -    [<ref>] [dec <col>] -    [<ref>] [edit yes|no] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [filter <string>] -    [<ref>] [filter load <filename>] -    [<ref>] [header] -    [<ref>] [location <code>] -    [<ref>] [match <ref> -<ref>] -    [<ref>] [match] -    [<ref>] [match error <value> -degrees|arcmin|arcsec] -    [<ref>] [match function -1and2|1not2|2not1] -    [<ref>] [match return -1and2|1only|2only] -    [<ref>] [match unique yes|no] -    [<ref>] [maxrows <number>] -    [<ref>] [name <object>] -    [<ref>] [panto yes|no] -    [<ref>] [plot <xcol> <ycol> -<xerrcol> <yerrcol>] -    [<ref>] [print] -    [<ref>] [psky <skyframe>] -    [<ref>] [psystem <coordsys>] -    [<ref>] [ra <col>] -    [<ref>] [regions] -    [<ref>] [retrieve] -    [<ref>] [samp] -    [<ref>] [samp broadcast] -    [<ref>] [samp send -<application>] -    [<ref>] [save <filename>] -    [<ref>] -[servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -    [<ref>] [show yes|no] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [sort <col> incr|decr] -    [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>] -    [<ref>] [symbol [#] -text|size|size2|units|angle <value>] -    [<ref>] [symbol shape -circle|ellipse|box|text|point] -    [<ref>] [symbol shapecircle point|box -point|diamond point|cross point|x point|arrow point|boxcircle -point] -    [<ref>] [symbol add| [#] remove] -    [<ref>] [symbol save|load -<filename>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] -    [<ref>] [x <col>] -    [<ref>] [y <col>] - -Example: -$ds9 -catalog new -$ds9 -catalog 2mass -$ds9 -catalog cds 2mass -$ds9 -catalog cds "I/252" - -$ds9 -catalog load foo.xml -$ds9 -catalog import tsv foo.tsv - -$ds9 -catalog 202.48 47.21 fk5 -$ds9 -catalog allrows -$ds9 -catalog allcols -$ds9 -catalog cancel -$ds9 -catalog clear -$ds9 -catalog close -$ds9 -catalog crosshair -$ds9 -catalog dec DEC -$ds9 -catalog edit yes -$ds9 -catalog export tsv bar.tsv -$ds9 -catalog filter'\$Jmag>15' -$ds9 -catalog filter load foo.flt -$ds9 -catalog header -$ds9 -catalog location 500 -$ds9 -catalog match error 2 arcsec -$ds9 -catalog match function 1and2 -$ds9 -catalog match unique no -$ds9 -catalog match return 1only -$ds9 -catalog match # last two catalogs loaded -$ds9 -catalog match 2mass csc -$ds9 -catalog maxrows 2000 -$ds9 -catalog name m51 -$ds9 -catalog panto no -$ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag' -$ds9 -catalog print -$ds9 -catalog psky fk5 -$ds9 -catalog psystem wcs -$ds9 -catalog ra RA -$ds9 -catalog regions -$ds9 -catalog retrieve -$ds9 -catalog samp broadcast -$ds9 -catalog samp send aladin -$ds9 -catalog save foo.xml -$ds9 -catalog server sao -$ds9 -catalog show yes -$ds9 -catalog radius 1 degrees -$ds9 -catalog symbol condition '\$Jmag>15' -$ds9 -catalog symbol 2 shape "boxcircle point" -$ds9 -catalog symbol color red -$ds9 -catalog symbol font times -$ds9 -catalog symbol fontsize 14 -$ds9 -catalog symbol fontweight bold -$ds9 -catalog symbol fontslant italic -$ds9 -catalog symbol add -$ds9 -catalog symbol 2 remove -$ds9 -catalog symbol load foo.sym -$ds9 -catalog symbol save bar.sym -$ds9 -catalog sky fk5 -$ds9 -catalog skyformat degrees -$ds9 -catalog sort "Jmag" incr -$ds9 -catalog system wcs -$ds9 -catalog update -$ds9 -catalog x RA -$ds9 -catalog y DEC -cd -Sets the current working directory. -Syntax: -cd [<directory>] - -Example: -$ds9 -cd /home/mrbill -cmap -Controls the colormap for the current frame. The colormap name -is not case sensitive. A valid contrast value is from 0 to 10 -and bias value from 0 to 1. -Syntax: --cmap [<colormap>] -    [load <filename>] -    [save <filename>] -    [invert yes|no] -    [<contrast> <bias>] -    [tag [load|save] <filename>] -    [tag delete] -    [open|close] - -Example: -$ds9 -cmap Heat -$ds9 -cmap load foo.sao -$ds9 -cmap save bar.sao -$ds9 -cmap invert yes -$ds9 -cmap 5 .5 -$ds9 -cmap tag load foo.tag -$ds9 -cmap tag save foo.tag -$ds9 -cmap tag delete -$ds9 -cmap open -$ds9 -cmap close -colorbar -Controls colorbar parameters. -Syntax: --colorbar [] -    [yes|no] -    [horizontal|vertical] -    [numerics yes|no] -    [space value|distance] -    [font times|helvetica|courier] -    [fontsize <value>] -    [fontweight normal|bold] -    [fontslant roman|italic] -    [size] -    [ticks] -    [match] -    [lock [yes|no]] - -Example: -$ds9 -colorbar yes -$ds9 -colorbar vertical -$ds9 -colorbar numerics yes -$ds9 -colorbar space value -$ds9 -colorbar font times -$ds9 -colorbar fontsize 14 -$ds9 -colorbar fontweight bold -$ds9 -colorbar fontslant italic -$ds9 -colorbar size 20 -$ds9 -colorbar ticks 11 -$ds9 -colorbar match -$ds9 -colorbar lock yes -console -Display tcl console window. -Syntax: --console - -Example: -$ds9 -console -contour -Controls contours in the current frame. -Syntax: --contour [] -    [yes|no] -    [clear] -    [generate] -    [load <filename>] -    [save <filename> [<coordsys> -<skyframe>]] -    [convert] -    [load levels <filename>] -    [save levels <filename>] -    [copy] -    [paste [<coordsys> <color> -<width> yes|no]] -    [color <color>] -    [width <width>] -    [dash yes|no] -    [smooth <smooth>] -    [method block|smooth] -    [nlevels <number of levels>] -    [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ] -    [log exp <value>] -    [mode minmax|<value>|zscale|zmax] -    [scope global|local] -    [limits <min> <max>] -    [levels <value value value...>] -    [open|close] - -Example: -$ds9 -contour -$ds9 -contour yes -$ds9 -contour generate -$ds9 -contour clear -$ds9 -contour load ds9.ctr -$ds9 -contour save ds9.ctr -$ds9 -contour save ds9.ctr wcs fk5 -$ds9 -contour convert -$ds9 -contour load levels ds9.ctr -$ds9 -contour save levels ds9.lev -$ds9 -contour copy -$ds9 -contour paste -$ds9 -contour paste wcs red 2 no -$ds9 -contour color yellow -$ds9 -contour width 2 -$ds9 -contour dash yes -$ds9 -contour smooth 5 -$ds9 -contour method smooth -$ds9 -contour nlevels 10 -$ds9 -contour scale sqrt -$ds9 -contour log exp 1000 -$ds9 -contour mode zscale -$ds9 -contour scope local -$ds9 -contour limits 1 100 -$ds9 -contour levels 1 10 100 1000 -$ds9 -contour open -$ds9 -contour close -crop -Set current image display area. -Syntax: --crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec] -    [match <coordsys>] -    [lock <coordsys>|none] -    [reset] -    [3d zmin zmax <coordsys>] -    [open|close] - -Example: -$ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords -$ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 -22.000204 wcs galactic arcsec -$ds9 foo.fits -crop match wcs -$ds9 foo.fits -crop lock wcs -$ds9 foo.fits -crop reset -$ds9 foo.fits -crop 3d .25 .5 wcs -$ds9 foo.fits -crop open -$ds9 foo.fits -crop close -crosshair -Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set. -Syntax: --crosshair [<x> <h> <coordsys> -[<skyframe>]] -   [match <coordsys>] -    [lock <coordsys>|none] - -Example: -$ds9 -crosshair 100 100 physical # set crosshair in physical -$ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords -$ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 -$ds9 -crosshair match -$ds9 -crosshair lock wcs -cube -Controls FITS cube. -Syntax: --cube [] -    [play|stop|next|prev|first|last] -    [<slice> [<coordsys>]] -    [interval <numeric>] -    [match <coordsys>] -    [lock <coordsys>|none] -    [order 123|132|213|231|312|321] -    [axes lock [yes|no]] -    [open|close] - -Example: -$ds9 -cube -$ds9 -cube play -$ds9 -cube last -$ds9 -cube 3 -$ds9 -cube 4.5 wcs -$ds9 -cube interval 2 -$ds9 -cube match wcs -$ds9 -cube lock wcs -$ds9 -cube order 123 -$ds9 -cube axes lock yes -$ds9 -cube open -$ds9 -cube close -cursor -Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also. -Syntax: --cursor [<x> <h>] - -Example: -$ds9 -cursor 10 10 -dsssao -dss -Support for Digital Sky Survey at SAO. -Syntax: --dsssao [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$ds9 -dsssao -$ds9 -dsssao m31 -$ds9 -dsssao name m31 -$ds9 -dsssao name clear -$ds9 -dsssao 00:42:44.404 +41:16:08.78 -$ds9 -dsssao size 60 60 arcmin -$ds9 -dsssao save yes -$ds9 -dsssao frame current -$ds9 -dsssao update frame -$ds9 -dsssao open -$ds9 -dsssao close -dsseso -Support for Digital Sky Survey at ESO. -Syntax: --dsseso [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -    [open|close] - -Example: -$ds9 -dsseso -$ds9 -dsseso m31 -$ds9 -dsseso name m31 -$ds9 -dsseso name clear -$ds9 -dsseso 00:42:44.404 +41:16:08.78 -$ds9 -dsseso size 60 60 arcmin -$ds9 -dsseso save yes -$ds9 -dsseso frame current -$ds9 -dsseso update frame -$ds9 -dsseso survey DSS2-red -$ds9 -dsseso open -$ds9 -dsseso close -dssstsci -Support for Digital Sky Survey at STSCI. -Syntax: --dssstsci [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -    [survey poss1_blue|poss1_red] -    [survey all|quickv|phase2_gsc2|phase2_gsc1] -    [open|close] - -Example: -$ds9 -dssstsci -$ds9 -dssstsci m31 -$ds9 -dssstsci name m31 -$ds9 -dssstsci name clear -$ds9 -dssstsci 00:42:44.404 +41:16:08.78 -$ds9 -dssstsci size 60 60 arcmin -$ds9 -dssstsci save yes -$ds9 -dssstsci frame current -$ds9 -dssstsci update frame -$ds9 -dssstsci survey all -$ds9 -dssstsci open -$ds9 -dssstsci close -envi -Load an ENVI header and file. Optional parameter: array -endian. -Syntax: --envi <header> [<filename>] - -Example: -$ds9 -envi foo.hdr -$ds9 -envi foo.hdr foo.bsq -exit -quit -Quits DS9. -Syntax: --exit --quit - -Example: -$ds9 -exit -export -Export loaded image data of current frame in specified image -format, at native resolution, using current colormap and -contrast/bias settings. NOTE: not scaling, rotation, or translation -is applied. If no format specified, the file name extension is used -to determine the output format. Optional parameters: jpeg quality -(1-100) and tiff compression method. -Syntax: --export [array|nrrd|envi|gif|tiff|jpeg|png] <filename> --export array <filename>[big|little|native] --export nrrd <filename>[big|little|native] --export envi <header> -[<filename>][big|little|native] --export <filename>.jpeg [1-100] --export <filename>.tiff [none|jpeg|packbits|deflate] - -Example: -$ds9 -export array foo.arr little -$ds9 -export nrrd foo.nrrd little -$ds9 -export envi foo.hdr little -$ds9 -export envi foo.hdr foo.bsq little -$ds9 -export tiff foo.tiff jpeg -$ds9 -export jpeg foo.jpeg 75 -$ds9 -export png foo.png -fifo -Set the name of the IRAF input and output fifos. The default is -/dev/imt1. These fifos are used by IRAF to communicate with -DS9. -Syntax: --fifo name - -Example: -$ds9 -fifo /dev/imt1 -fifo_only -Only use IRAF input and output fifos. Same as -port 0 -unix -none. -Syntax: --fifo_only - -Example: -$ds9 -fifo_only -fits -Load a FITS image into the current frame. -Syntax: --fits<filename> - -Example: -$ds9 -fits foo.fits -$ds9 -fits bar.fits[bin=detx,dety] -$cat foo.fits | ds9 -fits - -$cat bar.fits | ds9 -fits -[bin=detx,dety] -frame -Controls frame functions. Frames may be created, deleted, reset, -and centered. While return the current frame number. If you goto a -frame that does not exists, it will be created. If the frame is -hidden, it will be shown. The 'frameno' option is available for -backward compatibility. -Syntax: --frame [center [#|all]] -    [clear [#|all]] -    [new [rgb]] -    [delete [#|all]] -    [reset [#|all]] -    [refresh [#|all]] -    [hide [#|all]] -    [show [#|all]] -    [move first] -    [move back] -    [move forward] -    [move last] -    [first] -    [prev] -    [next] -    [last] -    [frameno #] -    [#] -    [match <coordsys>] -    [lock <coordsys>|none] - -Example: -$ds9 -frame center # center current frame -$ds9 -frame center 1 # center 'Frame1' -$ds9 -frame center all # center all frames -$ds9 -frame clear # clear current frame -$ds9 -frame new # create new frame -$ds9 -frame new rgb # create new rgb frame -$ds9 -frame delete # delete current frame -$ds9 -frame reset # reset current frame -$ds9 -frame refresh # refresh current frame -$ds9 -frame hide # hide current frame -$ds9 -frame show 1 # show frame 'Frame1' -$ds9 -frame move first # move frame to first in order -$ds9 -frame move back # move frame back in order -$ds9 -frame move forward # move frame forward in order -$ds9 -frame move last # move frame to last in order -$ds9 -frame first # goto first frame -$ds9 -frame prev # goto prev frame -$ds9 -frame next # goto next frame -$ds9 -frame last # goto last frame -$ds9 -frame frameno 4 # goto frame 'Frame4', create if needed -$ds9 -frame 3 # goto frame 'Frame3', create if needed -$ds9 -frame lock wcs -gif -Load GIF image into current frame. -Syntax: --gif <filename> - -Example: -$ds9 -gif foo.gif -$cat foo.gif | ds9 -gif - -geometry -Define the initial window geometry. This includes all of the ds9 -window, not just the image space. see X(1). -Syntax: --geometry value - -Example: -$ds9 -geometry 640x480 -green -For RGB frames, sets the current color channel to green. -Syntax: --green - -Example: -$ds9 -green foo.fits -grid -Controls coordinate grid. For grid numeric format syntax, -click here. -Syntax: --grid [] -    [yes|no] -    [type analysis|publication] -    [system <coordsys>] -    [sky <skyframe>] -    [skyformat <skyformat>] -    [grid yes|no] -    [grid color <color>] -    [grid width <value>] -    [grid dash yes|no] -    [grid gap1 <value>] -    [grid gap2 <value>] -    [grid gap3 <value>] -    [axes yes|no] -    [axes color <color>] -    [axes width <value>] -    [axes dash yes|no] -    [axes type interior|exterior] -    [axes origin -lll|llu|lul|luu|ull|ulu|uul|uuu] -    [format1 <format>] -    [format2 <format>] -    [tickmarks yes|no] -    [tickmarks color <color>] -    [tickmarks width <value>] -    [tickmarks dash yes|no] -    [border yes|no] -    [border color <color>] -    [border width <value>] -    [border dash yes|no] -    [numerics yes|no] -    [numerics font times|helvetica|courier] -    [numerics fontsize <value>] -    [numerics fontweight normal|bold] -    [numerics fontslant roman|italic] -    [numerics color <color>] -    [numerics gap1 <value>] -    [numerics gap2 <value>] -    [numerics gap3 <value>] -    [numerics type interior|exterior] -    [numerics vertical yes|no] -    [title yes|no] -    [title text <text>] -    [title def yes|no] -    [title gap <value>] -    [title font times|helvetica|courier] -    [title fontsize <value>] -    [title fontweight normal|bold] -    [title fontslant roman|italic] -    [title color <color>] -    [labels yes|no] -    [labels text1 <text>] -    [labels text2 <text>] -    [labels def1 yes|no] -    [labels def2 yes|no] -    [labels gap1 <value>] -    [labels gap2 <value>] -    [labels font times|helvetica|courier] -    [labels fontsize <value>] -    [labels fontweight normal|bold] -    [labels fontslant roman|italic] -    [labels color <color>] -    [reset] -    [load <filename>] -    [save <filename>] -    [open|close] - -Example: -$ds9 -grid -$ds9 -grid yes -$ds9 -grid type analysis -$ds9 -grid system wcs -$ds9 -grid sky fk5 -$ds9 -grid skyformat degrees -$ds9 -grid grid yes -$ds9 -grid grid color red -$ds9 -grid grid width 2 -$ds9 -grid grid dash yes -$ds9 -grid grid gap1 10 -$ds9 -grid grid gap2 10 -$ds9 -grid grid gap3 10 -$ds9 -grid axes yes -$ds9 -grid axes color red -$ds9 -grid axes width 2 -$ds9 -grid axes dash yes -$ds9 -grid axes type exterior -$ds9 -grid axes origin lll -$ds9 -grid format1 d.2 -$ds9 -grid format2 d.2 -$ds9 -grid tickmarks yes -$ds9 -grid tickmarks color red -$ds9 -grid tickmarks width 2 -$ds9 -grid tickmarks dash yes -$ds9 -grid border yes -$ds9 -grid border color red -$ds9 -grid border width 2 -$ds9 -grid border dash yes -$ds9 -grid numerics yes -$ds9 -grid numerics font courier -$ds9 -grid numerics fontsize 12 -$ds9 -grid numerics fontweight bold -$ds9 -grid numerics fontslant italic -$ds9 -grid numerics color red -$ds9 -grid numerics gap1 10 -$ds9 -grid numerics gap2 10 -$ds9 -grid numerics gap3 10 -$ds9 -grid numerics type exterior -$ds9 -grid numerics vertical yes -$ds9 -grid title yes -$ds9 -grid title text {Hello World} -$ds9 -grid title def yes -$ds9 -grid title gap 10 -$ds9 -grid title font courier -$ds9 -grid title fontsize 12 -$ds9 -grid title fontweight bold -$ds9 -grid title fontslant italic -$ds9 -grid title color red -$ds9 -grid labels yes -$ds9 -grid labels text1 {Hello World} -$ds9 -grid labels text2 {Hello World} -$ds9 -grid labels def1 yes -$ds9 -grid labels def2 yes -$ds9 -grid labels gap1 10 -$ds9 -grid labels gap2 10 -$ds9 -grid labels font courier -$ds9 -grid labels fontsize 12 -$ds9 -grid labels fontweight bold -$ds9 -grid labels fontslant italic -$ds9 -grid labels color red -$ds9 -grid reset -$ds9 -grid load foo.grd -$ds9 -grid save foo.grd -$ds9 -grid open -$ds9 -grid close -header -Display current fits header dialog. Optional extension number -maybe specified. -Syntax: --header [<ext>] -    [close [<ext>]] -    [save [<ext>] <filename>] - -Example: -$ds9 -header -$ds9 -header 2 -$ds9 -header close -$ds9 -header save 1 foo.txt -height -Set the height of the image display window. Use the geometry command to set the overall -width and height of the ds9 window. -Syntax: --height [<value>] - -Example: -$ds9 -height 512 -help -Display help information. To maintain backward compatibility, --help will display a brief help message and exit. --help will -display all command line options within the built-in help -facility. -Syntax: --help # Display brief help message and exit. ---help # Display command line options within help facility. --? # Display command line options within help facility. - -Example: -$ds9 -help # Display brief help message and exit. -$ds9 --help # Display command line options within help facility -$ds9 -? # Display command line options within help -facility. -histequ -Select histogram equalization scale function for the current -frame. -Syntax: --histequ - -Example: -$ds9 -histequ -iconify -Toggles iconification. -Syntax: --iconify [] -    [yes|no] - -Example: -$ds9 -iconify -$ds9 -iconify yes -invert -Invert Colormap. -Syntax: --invert - -Example: -$ds9 -invert -iis -Set IIS Filename. Optional mosaic number maybe supplied. -Syntax: --iis [filename <filename> [#]] - -Example: -$ds9 -iis filename foo.fits -$ds9 -iis filename bar.fits 4 -jpeg -Load JPEG image into current frame. -Syntax: --jpeg <filename> - -Example: -$ds9 -jpeg foo.jpeg -$cat foo.jpeg | ds9 -jpeg - -language -Select current language. -Syntax: --language [locale|da|de|es|en|fr|ja|pt] - -Example: -$ds9 -language fr -linear -Select linear scale function for the current frame. -Syntax: --linear - -Example: -$ds9 -linear -lock -Lock all other frames to the current frame. -Syntax: --lock[frame <coordsys>|none] -    [crosshair <coordsys>|none] -    [crop <coordsys>|none] -    [slice <coordsys>|none] -    [bin [yes|no]] -    [axes [yes|no]] -    [scale [yes|no]] -    [scalelimits [yes|no]] -    [colorbar [yes|no]] -    [block [yes|no]] -    [smooth [yes|no]] -    [3d [yes|no]] - -Example: -$ds9 -lock frame wcs -$ds9 -lock crosshair wcs -$ds9 -lock crop wcs -$ds9 -lock slice wcs -$ds9 -lock bin yes -$ds9 -lock axes yes -$ds9 -lock scale yes -$ds9 -lock scalelimits yes -$ds9 -lock colorbar yes -$ds9 -lock block yes -$ds9 -lock smooth yes -$ds9 -lock 3d yes - log -Select log scale function for the current frame. -Syntax: --log - -Example: -$ds9 -log -lower -Lower in the window stacking order. -Syntax: --lower - -Example: -$ds9 -lower -magnifier -Controls the magnifier settings. -Syntax: -magnifier [color <color>] -    [zoom <value>] -    [cursor yes|no] -    [region yes|no] - -Example: -$ds9 -magnifier color yellow -$ds9 -magnifier zoom 2 -$ds9 -magnifier cursor no -$ds9 -magnifier region no -mask -nomask -Controls mask parameters. -Syntax: --mask [color <color>] -    [mark zero|nonzero|nan|nonnan|range] -    [range <low> <high>] -    [transparency <value>] -    [system <coordsys>] -    [clear] -    [open|close] --nomask - -Example: -$ds9 -mask color red -$ds9 -mask mark zero -$ds9 -mask range 10 100 -$ds9 -mask transparency 50 -$ds9 -mask system wcs -$ds9 -mask clear -$ds9 -mask open -$ds9 -mask close -$ds9 -nomask -match -Match all other frames to the current frame. -Syntax: --match[frame <coordsys>] -    [crosshair <coordsys>] -    [crop <coordsys>] -    [slice <coordsys>] -    [bin] -    [axes] -    [scale] -    [scalelimits] -    [colorbar] -    [block] -    [smooth] -    [3d] - -Example: -$ds9 -match frame wcs -$ds9 -match crosshair wcs -$ds9 -match crop wcs -$ds9 -match slice wcs -$ds9 -match bin -$ds9 -match axes -$ds9 -match scale -$ds9 -match scalelimits -$ds9 -match colorbar -$ds9 -match block -$ds9 -match smooth -$ds9 -match 3d - mecube -Load FITS multiple extension file as data cube. -Syntax: -mecube <filename> - -Example: -$ds9 -mecube foo.fits -$cat foo.fits | ds9 -mecube - -minmax -This is how DS9 determines the min and max data values -from the data. SCAN will scan all data. -Syntax: --minmax [scan|sample|datamin|irafmin] -    [mode scan|sample|datamin|irafmin] -    [interval #] - -Example: -$ds9 -minmax scan -$ds9 -minmax mode scan -$ds9 -minmax interval 100 -mode -Select the current mode. -Syntax: --mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - -Example: -$ds9 -mode crosshair -mosaic -Load FITS mosaic segment into current frame. -Syntax: --mosaic [wcs|wcsa...wcsz|iraf] <filename> - -Example: -$ds9 -mosaic foo.fits -$ds9 -mosaic wcs foo.fits -$cat foo.fits | ds9 -mosaic - -$cat foo.fits | ds9 -mosaic wcs - -mosaicimage -Load FITS mosaic image into current frame. -Syntax: --mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> - -Example: -$ds9 -mosaicimage foo.fits -$ds9 -mosaicimage wcs foo.fits -$cat foo.fits | ds9 -mosaicimage -$cat foo.fits | ds9 -mosaiimage wcs -movie -Create a movie from snap shots of the DS9 window. A -slice movie cycles though all slices of a cube. A -frame movie cycles through all active frames. A -3d movie cycles through specified viewing angles. The -default action is slice. Movie types are either -MPEG or Animated GIF, with default MPEG. -Optional parameters for 3d: number of frames, azimuth -from/to, elevation from/to, slice from/to, oscillate/repeat -times. -Syntax: --movie [slice|frame|3d] [mpeg|gif] <filename> --movie 3d [mpeg|gif] <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>] - -Example: -$ds9 -movie slice mpeg ds9.mpg -$ds9 -movie frame gif ds9.gif -$ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate -1 -msg -Specify a directory of translation tables to be loaded. -Syntax: --msg <directory> - -Example: -$ds9 -msg $HOME/msgs -multiframe -Load FITS multiple extension file as multiple images. -Syntax: -multiframe <filename> - -Example: -$ds9 -multiframe foo.fits -$cat foo.fits | ds9 -multiframe - -nameserver -Support Name Server functions. Coordinates are in fk5. -Syntax: --nameserver [<object>] -    [name <object>] -    [skyformat degrees|sexagesimal] -    [pan] -    [crosshair] -    [open|close] - -Example: -$ds9 -nameserver m31 -$ds9 -nameserver name m31 -$ds9 -nameserver server ned-sao -$ds9 -nameserver skyformat sexagesimal -$ds9 -nameserver pan -$ds9 -nameserver crosshair -$ds9 -nameserver open -$ds9 -nameserver close -nan -Set image not-a-number color. -Syntax: --nan <color> - -Example: -$ds9 -nan red -nrrd -Load an NRRD (Nearly Raw Raster Data) file. -Syntax: --nrrd <filename> - -Example: -$ds9 -nrrd foo.nrrd -$cat foo.nrrd | xpaset ds9 -nrrd- -nvss -Support for NRAO VLA Sky Survey. -Syntax: --nvss [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$ds9 -nvss -$ds9 -nvss m31 -$ds9 -nvss name m31 -$ds9 -nvss name clear -$ds9 -nvss 00:42:44.404 +41:16:08.78 -$ds9 -nvss size 60 60 arcmin -$ds9 -nvss save yes -$ds9 -nvss frame current -$ds9 -nvss update frame -$ds9 -nvss open -$ds9 -nvess close -orient -Controls the orientation of the current frame. -Syntax: --orient [none|x|y|xy] -    [open|close] - -Example: -$ds9 -orient xy -$ds9 -orient open -$ds9 -orient close -pagesetup -Controls Page Setup options. -Syntax: --pagesetup [orient portrait|landscape] -    [scale <numberic>] -    [size letter|legal|tabloid|poster|a4] - -Example: -$ds9 -pagesetup orient portrait -$ds9 -pagesetup scale 50 -$ds9 -pagesetup size poster -pan -Controls the current image cursor location for the current -frame. -Syntax: --pan [<x> <h> <coordsys> [<skyframe>]] # -relative -    [to <x> <h> <coordsys> -[<skyframe>]] # absolute -    [open|close] - -Example: -$ds9 -pan 200 200 image# pan relative -$ds9 -pan to 400 400 physical# pan to physical coords -$ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords -$ds9 -pan open -$ds9 -pan close -pixeltable -Display/Hide the pixel table. -Syntax: --pixeltable [] -    [yes|open] -    [no|close] - -Example: -$ds9 -pixeltable -$ds9 -pixeltable yes -$ds9 -pixeltable open -$ds9 -pixeltable close -plot -Display and configure data plots. All plot commands take an -optional second command, the plot name. If no plot name is -specified, the last plot created is assumed. Plot data is assumed -to be a pair of coordinates, with optional error values. The follow -are valid data descriptions: -xy    x and y -coordinates -xyex    x,y coordinates with x errors -xyey    x,y coordinates with y errors -xyexey    x,y coordinates with x and y -errors -To create a new plot, use the plot new command. -Syntax: -# create new empty plot window --plot [line|bar|scatter] - -# existing plot --plot[[<plotname>] load <filename> -xy|xyex|xyey|xyexey] -    [[<plotname>] save <filename>] -    [[<plotname>] clear] -    [[<plotname>] duplicate [#]] -    [[<plotname>] stats yes|no] -    [[<plotname>] list yes|no] -    [[<plotname>] loadconfig -<filename>] -    [[<plotname>] saveconfig -<filename>] -    [[<plotname>] pagesetup orient -portrait|landscape] -    [[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4] -    [[<plotname>] print] -    [[<plotname>] print destination -printer|file] -    [[<plotname>] print command -<command>] -    [[<plotname>] print filename -<filename>] -    [[<plotname>] print color rgb|gray] -    [[<plotname>] close] -    [[<plotname>] mode pointer|zoom] - -# export image -plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> - -    [[<plotname>]export jpeg -<filename>[1-100] -    [[<plotname>]export tiff -<filename>[none|jpeg|packbits|deflate] - -# configure graph --plot [[<plotname>] axis x|y grid yes|no] -    [[<plotname>] axis x|y log yes|no] -    [[<plotname>] axis x|y flip yes|no] -    [[<plotname>] axis x|y auto yes|no] -    [[<plotname>] axis x|y min -<value>] -    [[<plotname>] axis x|y max -<value>] -    [[<plotname>] axis x|y format -<string>] -    [[<plotname>] background -<value>] -    [[<plotname>] legend yes|no] -    [[<plotname>] legend position -right|left|top|bottom] -    [[<plotname>] font title|labels|numbers -font times|helvetica|courier] -    [[<plotname>] fonttitle|labels|numberssize -<value>] -    [[<plotname>] -fonttitle|labels|numbersweight normal|bold] -    [[<plotname>] -fonttitle|labels|numbersslant roman|italic] -    [[<plotname>] title <string>] -    [[<plotname>] title x|y -<string>] -    [[<plotname>] barmode -normal|stacked|aligned|overlap] - -# configure current dataset --plot [[<plotname>] show yes|no] -   [[<plotname>] shape -none|circle|square|diamond|plus|splus|scross|triangle|arrow] -   [[<plotname>] shape fill yes|no] -   [[<plotname>] shape color -<value>] -   [[<plotname>] smooth -step|linear|cubic|quadratic|catrom] -   [[<plotname>] color <value>] -   [[<plotname>] width <value>] -   [[<plotname>] dash yes|no] -   [[<plotname>] error yes|no] -   [[<plotname>] error color -<value>] -   [[<plotname>] error cap yes|no] -   [[<plotname>] error width -<value>] -   [[<plotname>] name <string>] - -# select current dataset --plot [[<plotname>] select <value>] - -Example: -# create new empty plot window -$ds9 -plot bar - -# existing plot -$ds9 -plot load xy.dat -$ds9 -plot save foo.dat -$ds9 -plot clear -$ds9 -plot duplicate 1 -$ds9 -plot stats yes -$ds9 -plot list yes -$ds9 -plot loadconfig foo.plt -$ds9 -plot saveconfig foo.plt -$ds9 -plot pagesetup orient portrait -$ds9 -plot pagesetup size letter -$ds9 -plot print -$ds9 -plot print destination file -$ds9 -plot print command lp -$ds9 -plot print filename foo.ps -$ds9 -plot print color rgb -$ds9 -plot close -$ds9 -plot mode pointer - -# export plot -$ds9 -plot export tiff foo.tiff jpeg -$ds9 -plot export jpeg foo.jpeg 75 -$ds9 -plot export png foo.png - -# configure plot -$ds9 -plot axis x grid yes -$ds9 -plot axis x log yes -$ds9 -plot axis x flip yes -$ds9 -plot axis x auto no -$ds9 -plot axis x min 1 -$ds9 -plot axis x max 100 -$ds9 -plot axis x format '%f' - -$ds9 -plot background white - -$ds9 -plot legend yes -$ds9 -plot legend position left - -$ds9 -plot font numbers font times -$ds9 -plot font numbers size 12 -$ds9 -plot font numbers weight bold -$ds9 -plot font numbers slant italic - -$ds9 -plot title 'This is a Title' -$ds9 -plot title x 'X Axis' -$ds9 -plot title y 'Y Axis' -$ds9 -plot title legend 'This is the Legend' - -$ds9 -plot barmode aligned - -# configure current dataset -$ds9 -plot show yes -$ds9 -plot shape circle -$ds9 -plot shape fill no -$ds9 -plot shape color cyan -$ds9 -plot smooth step -$ds9 -plot color red -$ds9 -plot width 2 -$ds9 -plot dash yes -$ds9 -plot error yes -$ds9 -plot error color red -$ds9 -plot error cap yes -$ds9 -plot error width 2 -$ds9 -plot name 'My Data' - -# select current dataset -$ds9 -plot select 2 -png -Load PNG image into current frame. -Syntax: --png <filename> - -Example: -$ds9 png foo.png -$cat foo.png | ds9 -png - -port -Set the IRAF port number, used by IRAF to communicate with DS9. -The default is 5137, the standard IRAF port used by -ximtool. -Syntax: --port number - -Example: -$ds9 -port 5137 -port_only -inet_only -Only use the IRAF port number. This is the same as -fifo none --unix none. -Syntax: --port_only - -Example: -$ds9 -port_only -pow -Select power scale function for the current frame. -Syntax: --pow - -Example: -$ds9 -pow -precision -Set region and coordinate output format precision. -Syntax: --precision +     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +     [2mass|iras] +     [csc|xmm|rosat] +     [first|nvss] +     [chandralog|cfhtlog|esolog|stlog|xmmlog] +     [cds <catalogname>] +     [cds <catalogid>] + +     [load <filename>] +     [import sb|tsv <filename>] + +     [<ref>] [<ra> <dec> + <coordsys>] +     [<ref>] [allcols] +     [<ref>] [allrows] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [crosshair] +     [<ref>] [dec <col>] +     [<ref>] [edit yes|no] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [filter <string>] +     [<ref>] [filter load <filename>] +     [<ref>] [header] +     [<ref>] [location <code>] +     [<ref>] [match <ref> <ref>] +     [<ref>] [match] +     [<ref>] [match error <value> + degrees|arcmin|arcsec] +     [<ref>] [match function + 1and2|1not2|2not1] +     [<ref>] [match return + 1and2|1only|2only] +     [<ref>] [match unique yes|no] +     [<ref>] [maxrows <number>] +     [<ref>] [name <object>] +     [<ref>] [panto yes|no] +     [<ref>] [plot <xcol> <ycol> + <xerrcol> <yerrcol>] +     [<ref>] [print] +     [<ref>] [psky <skyframe>] +     [<ref>] [psystem <coordsys>] +     [<ref>] [ra <col>] +     [<ref>] [regions] +     [<ref>] [retrieve] +     [<ref>] [samp] +     [<ref>] [samp broadcast] +     [<ref>] [samp send <application>] +     [<ref>] [save <filename>] +     [<ref>] + [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +     [<ref>] [show yes|no] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [sort <col> incr|decr] +     [<ref>] [symbol [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>] +     [<ref>] [symbol [#] + text|size|size2|units|angle <value>] +     [<ref>] [symbol shape + circle|ellipse|box|text|point] +     [<ref>] [symbol shapecircle point|box + point|diamond point|cross point|x point|arrow point|boxcircle + point] +     [<ref>] [symbol add| [#] remove] +     [<ref>] [symbol save|load + <filename>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] +     [<ref>] [x <col>] +     [<ref>] [y <col>] + + Example: + $ds9 -catalog new + $ds9 -catalog 2mass + $ds9 -catalog cds 2mass + $ds9 -catalog cds "I/252" + + $ds9 -catalog load foo.xml + $ds9 -catalog import tsv foo.tsv + + $ds9 -catalog 202.48 47.21 fk5 + $ds9 -catalog allrows + $ds9 -catalog allcols + $ds9 -catalog cancel + $ds9 -catalog clear + $ds9 -catalog close + $ds9 -catalog crosshair + $ds9 -catalog dec DEC + $ds9 -catalog edit yes + $ds9 -catalog export tsv bar.tsv + $ds9 -catalog filter'\$Jmag>15' + $ds9 -catalog filter load foo.flt + $ds9 -catalog header + $ds9 -catalog location 500 + $ds9 -catalog match error 2 arcsec + $ds9 -catalog match function 1and2 + $ds9 -catalog match unique no + $ds9 -catalog match return 1only + $ds9 -catalog match # last two catalogs loaded + $ds9 -catalog match 2mass csc + $ds9 -catalog maxrows 2000 + $ds9 -catalog name m51 + $ds9 -catalog panto no + $ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag' + $ds9 -catalog print + $ds9 -catalog psky fk5 + $ds9 -catalog psystem wcs + $ds9 -catalog ra RA + $ds9 -catalog regions + $ds9 -catalog retrieve + $ds9 -catalog samp broadcast + $ds9 -catalog samp send aladin + $ds9 -catalog save foo.xml + $ds9 -catalog server sao + $ds9 -catalog show yes + $ds9 -catalog radius 1 degrees + $ds9 -catalog symbol condition '\$Jmag>15' + $ds9 -catalog symbol 2 shape "boxcircle point" + $ds9 -catalog symbol color red + $ds9 -catalog symbol font times + $ds9 -catalog symbol fontsize 14 + $ds9 -catalog symbol fontweight bold + $ds9 -catalog symbol fontslant italic + $ds9 -catalog symbol add + $ds9 -catalog symbol 2 remove + $ds9 -catalog symbol load foo.sym + $ds9 -catalog symbol save bar.sym + $ds9 -catalog sky fk5 + $ds9 -catalog skyformat degrees + $ds9 -catalog sort "Jmag" incr + $ds9 -catalog system wcs + $ds9 -catalog update + $ds9 -catalog x RA + $ds9 -catalog y DEC + cd + Sets the current working directory. + Syntax: + cd [<directory>] + + Example: + $ds9 -cd /home/mrbill + + cmap + Controls the colormap for the current frame. The colormap name + is not case sensitive. A valid contrast value is from 0 to + 10 and bias value from 0 to 1. + Syntax: + -cmap [<colormap>] +     [load <filename>] +     [save <filename>] +     [invert yes|no] +     [<contrast> <bias>] +     [tag [load|save] <filename>] +     [tag delete] +     [open|close] + + Example: + $ds9 -cmap Heat + $ds9 -cmap load foo.sao + $ds9 -cmap save bar.sao + $ds9 -cmap invert yes + $ds9 -cmap 5 .5 + $ds9 -cmap tag load foo.tag + $ds9 -cmap tag save foo.tag + $ds9 -cmap tag delete + $ds9 -cmap open + $ds9 -cmap close + + colorbar + Controls colorbar parameters. + Syntax: + -colorbar [] +     [yes|no] +     [horizontal|vertical] +     [numerics yes|no] +     [space value|distance] +     [font times|helvetica|courier] +     [fontsize <value>] +     [fontweight normal|bold] +     [fontslant roman|italic] +     [size] +     [ticks] +     [match] +     [lock [yes|no]] + + Example: + $ds9 -colorbar yes + $ds9 -colorbar vertical + $ds9 -colorbar numerics yes + $ds9 -colorbar space value + $ds9 -colorbar font times + $ds9 -colorbar fontsize 14 + $ds9 -colorbar fontweight bold + $ds9 -colorbar fontslant italic + $ds9 -colorbar size 20 + $ds9 -colorbar ticks 11 + $ds9 -colorbar match + $ds9 -colorbar lock yes + console + Display tcl console window. + Syntax: + -console + + Example: + $ds9 -console + + contour + + Controls contours in the current frame. + Syntax: + -contour [] +     [yes|no] +     [clear] +     [generate] +     [load <filename>] +     [save <filename> [<coordsys> + <skyframe>]] +     [convert] +     [load levels <filename>] +     [save levels <filename>] +     [copy] +     [paste [<coordsys> <color> + <width> yes|no]] +     [color <color>] +     [width <width>] +     [dash yes|no] +     [smooth <smooth>] +     [method block|smooth] +     [nlevels <number of levels>] +     [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ] +     [log exp <value>] +     [mode minmax|<value>|zscale|zmax] +     [scope global|local] +     [limits <min> <max>] +     [levels <value value value...>] +     [open|close] + + Example: + $ds9 -contour + $ds9 -contour yes + $ds9 -contour generate + $ds9 -contour clear + $ds9 -contour load ds9.ctr + $ds9 -contour save ds9.ctr + $ds9 -contour save ds9.ctr wcs fk5 + $ds9 -contour convert + $ds9 -contour load levels ds9.ctr + $ds9 -contour save levels ds9.lev + $ds9 -contour copy + $ds9 -contour paste + $ds9 -contour paste wcs red 2 no + $ds9 -contour color yellow + $ds9 -contour width 2 + $ds9 -contour dash yes + $ds9 -contour smooth 5 + $ds9 -contour method smooth + $ds9 -contour nlevels 10 + $ds9 -contour scale sqrt + $ds9 -contour log exp 1000 + $ds9 -contour mode zscale + $ds9 -contour scope local + $ds9 -contour limits 1 100 + $ds9 -contour levels 1 10 100 1000 + $ds9 -contour open + $ds9 -contour close + + crop + Set current image display area. + Syntax: + -crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +     [match <coordsys>] +     [lock <coordsys>|none] +     [reset] +     [3d zmin zmax <coordsys>] +     [open|close] + + Example: + $ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords + $ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 + 22.000204 wcs galactic arcsec + $ds9 foo.fits -crop match wcs + $ds9 foo.fits -crop lock wcs + $ds9 foo.fits -crop reset + $ds9 foo.fits -crop 3d .25 .5 wcs + $ds9 foo.fits -crop open + $ds9 foo.fits -crop close + + crosshair + Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set. + Syntax: + -crosshair [<x> <h> <coordsys> + [<skyframe>]] +    [match <coordsys>] +     [lock <coordsys>|none] + + Example: + $ds9 -crosshair 100 100 physical # set crosshair in physical + $ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords + $ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 + $ds9 -crosshair match + $ds9 -crosshair lock wcs + + cube + + Controls FITS cube. + Syntax: + -cube [] +     [play|stop|next|prev|first|last] +     [<slice> [<coordsys>]] +     [interval <numeric>] +     [match <coordsys>] +     [lock <coordsys>|none] +     [order 123|132|213|231|312|321] +     [axes lock [yes|no]] +     [open|close] + + Example: + $ds9 -cube + $ds9 -cube play + $ds9 -cube last + $ds9 -cube 3 + $ds9 -cube 4.5 wcs + $ds9 -cube interval 2 + $ds9 -cube match wcs + $ds9 -cube lock wcs + $ds9 -cube order 123 + $ds9 -cube axes lock yes + $ds9 -cube open + $ds9 -cube close + cursor + Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also. + Syntax: + -cursor [<x> <h>] + + Example: + $ds9 -cursor 10 10 + + dsssao + dss + + Support for Digital Sky Survey at SAO. + Syntax: + -dsssao [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $ds9 -dsssao + $ds9 -dsssao m31 + $ds9 -dsssao name m31 + $ds9 -dsssao name clear + $ds9 -dsssao 00:42:44.404 +41:16:08.78 + $ds9 -dsssao size 60 60 arcmin + $ds9 -dsssao save yes + $ds9 -dsssao frame current + $ds9 -dsssao update frame + $ds9 -dsssao open + $ds9 -dsssao close + + dsseso + Support for Digital Sky Survey at ESO. + Syntax: + -dsseso [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +     [open|close] + + Example: + $ds9 -dsseso + $ds9 -dsseso m31 + $ds9 -dsseso name m31 + $ds9 -dsseso name clear + $ds9 -dsseso 00:42:44.404 +41:16:08.78 + $ds9 -dsseso size 60 60 arcmin + $ds9 -dsseso save yes + $ds9 -dsseso frame current + $ds9 -dsseso update frame + $ds9 -dsseso survey DSS2-red + $ds9 -dsseso open + $ds9 -dsseso close + dssstsci + Support for Digital Sky Survey at STSCI. + Syntax: + -dssstsci [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +     [survey poss1_blue|poss1_red] +     [survey all|quickv|phase2_gsc2|phase2_gsc1] +     [open|close] + + Example: + $ds9 -dssstsci + $ds9 -dssstsci m31 + $ds9 -dssstsci name m31 + $ds9 -dssstsci name clear + $ds9 -dssstsci 00:42:44.404 +41:16:08.78 + $ds9 -dssstsci size 60 60 arcmin + $ds9 -dssstsci save yes + $ds9 -dssstsci frame current + $ds9 -dssstsci update frame + $ds9 -dssstsci survey all + $ds9 -dssstsci open + $ds9 -dssstsci close + envi + Load an ENVI header and file. Optional parameter: array endian. + + Syntax: + -envi <header> [<filename>] + + Example: + $ds9 -envi foo.hdr + $ds9 -envi foo.hdr foo.bsq + + exit + quit + Quits DS9. + Syntax: + -exit + -quit + + Example: + $ds9 -exit + + export + + Export loaded image data of current frame in specified image + format, at native resolution, using current colormap and + contrast/bias settings. NOTE: not scaling, rotation, or + translation is applied. If no format specified, the file name + extension is used to determine the output format. Optional + parameters: jpeg quality (1-100) and tiff compression method. + + Syntax: + -export [array|nrrd|envi|gif|tiff|jpeg|png] <filename> + -export array <filename>[big|little|native] + -export nrrd <filename>[big|little|native] + -export envi <header> + [<filename>][big|little|native] + -export <filename>.jpeg [1-100] + -export <filename>.tiff [none|jpeg|packbits|deflate] + + Example: + $ds9 -export array foo.arr little + $ds9 -export nrrd foo.nrrd little + $ds9 -export envi foo.hdr little + $ds9 -export envi foo.hdr foo.bsq little + $ds9 -export tiff foo.tiff jpeg + $ds9 -export jpeg foo.jpeg 75 + $ds9 -export png foo.png + fifo + Set the name of the IRAF input and output fifos. The default is + /dev/imt1. These fifos are used by IRAF to communicate with DS9. + Syntax: + -fifo name + + Example: + $ds9 -fifo /dev/imt1 + fifo_only + Only use IRAF input and output fifos. Same as -port 0 -unix + none. + Syntax: + -fifo_only + + Example: + $ds9 -fifo_only + + fits + Load a FITS image into the current frame. + + Syntax: + -fits<filename> + + Example: + $ds9 -fits foo.fits + $ds9 -fits bar.fits[bin=detx,dety] + $cat foo.fits | ds9 -fits - + $cat bar.fits | ds9 -fits -[bin=detx,dety] + + frame + Controls frame functions. Frames may be created, deleted, + reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. + Syntax: + -frame [center [#|all]] +     [clear [#|all]] +     [new [rgb]] +     [delete [#|all]] +     [reset [#|all]] +     [refresh [#|all]] +     [hide [#|all]] +     [show [#|all]] +     [move first] +     [move back] +     [move forward] +     [move last] +     [first] +     [prev] +     [next] +     [last] +     [frameno #] +     [#] +     [match <coordsys>] +     [lock <coordsys>|none] + + Example: + $ds9 -frame center # center current frame + $ds9 -frame center 1 # center 'Frame1' + $ds9 -frame center all # center all frames + $ds9 -frame clear # clear current frame + $ds9 -frame new # create new frame + $ds9 -frame new rgb # create new rgb frame + $ds9 -frame delete # delete current frame + $ds9 -frame reset # reset current frame + $ds9 -frame refresh # refresh current frame + $ds9 -frame hide # hide current frame + $ds9 -frame show 1 # show frame 'Frame1' + $ds9 -frame move first # move frame to first in order + $ds9 -frame move back # move frame back in order + $ds9 -frame move forward # move frame forward in order + $ds9 -frame move last # move frame to last in order + $ds9 -frame first # goto first frame + $ds9 -frame prev # goto prev frame + $ds9 -frame next # goto next frame + $ds9 -frame last # goto last frame + $ds9 -frame frameno 4 # goto frame 'Frame4', create if needed + $ds9 -frame 3 # goto frame 'Frame3', create if needed + $ds9 -frame lock wcs + gif + Load GIF image into current frame. + Syntax: + -gif <filename> + + Example: + $ds9 -gif foo.gif + $cat foo.gif | ds9 -gif - + + geometry + Define the initial window geometry. This includes all of the + ds9 window, not just the image space. see X(1). + Syntax: + -geometry value + + Example: + $ds9 -geometry 640x480 + green + For RGB frames, sets the current color channel to green. + Syntax: + -green + + Example: + $ds9 -green foo.fits + grid + Controls coordinate grid. For grid numeric format syntax, + click here. + Syntax: + -grid [] +     [yes|no] +     [type analysis|publication] +     [system <coordsys>] +     [sky <skyframe>] +     [skyformat <skyformat>] +     [grid yes|no] +     [grid color <color>] +     [grid width <value>] +     [grid dash yes|no] +     [grid gap1 <value>] +     [grid gap2 <value>] +     [grid gap3 <value>] +     [axes yes|no] +     [axes color <color>] +     [axes width <value>] +     [axes dash yes|no] +     [axes type interior|exterior] +     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +     [format1 <format>] +     [format2 <format>] +     [tickmarks yes|no] +     [tickmarks color <color>] +     [tickmarks width <value>] +     [tickmarks dash yes|no] +     [border yes|no] +     [border color <color>] +     [border width <value>] +     [border dash yes|no] +     [numerics yes|no] +     [numerics font times|helvetica|courier] +     [numerics fontsize <value>] +     [numerics fontweight normal|bold] +     [numerics fontslant roman|italic] +     [numerics color <color>] +     [numerics gap1 <value>] +     [numerics gap2 <value>] +     [numerics gap3 <value>] +     [numerics type interior|exterior] +     [numerics vertical yes|no] +     [title yes|no] +     [title text <text>] +     [title def yes|no] +     [title gap <value>] +     [title font times|helvetica|courier] +     [title fontsize <value>] +     [title fontweight normal|bold] +     [title fontslant roman|italic] +     [title color <color>] +     [labels yes|no] +     [labels text1 <text>] +     [labels text2 <text>] +     [labels def1 yes|no] +     [labels def2 yes|no] +     [labels gap1 <value>] +     [labels gap2 <value>] +     [labels font times|helvetica|courier] +     [labels fontsize <value>] +     [labels fontweight normal|bold] +     [labels fontslant roman|italic] +     [labels color <color>] +     [reset] +     [load <filename>] +     [save <filename>] +     [open|close] + + Example: + $ds9 -grid + $ds9 -grid yes + $ds9 -grid type analysis + $ds9 -grid system wcs + $ds9 -grid sky fk5 + $ds9 -grid skyformat degrees + $ds9 -grid grid yes + $ds9 -grid grid color red + $ds9 -grid grid width 2 + $ds9 -grid grid dash yes + $ds9 -grid grid gap1 10 + $ds9 -grid grid gap2 10 + $ds9 -grid grid gap3 10 + $ds9 -grid axes yes + $ds9 -grid axes color red + $ds9 -grid axes width 2 + $ds9 -grid axes dash yes + $ds9 -grid axes type exterior + $ds9 -grid axes origin lll + $ds9 -grid format1 d.2 + $ds9 -grid format2 d.2 + $ds9 -grid tickmarks yes + $ds9 -grid tickmarks color red + $ds9 -grid tickmarks width 2 + $ds9 -grid tickmarks dash yes + $ds9 -grid border yes + $ds9 -grid border color red + $ds9 -grid border width 2 + $ds9 -grid border dash yes + $ds9 -grid numerics yes + $ds9 -grid numerics font courier + $ds9 -grid numerics fontsize 12 + $ds9 -grid numerics fontweight bold + $ds9 -grid numerics fontslant italic + $ds9 -grid numerics color red + $ds9 -grid numerics gap1 10 + $ds9 -grid numerics gap2 10 + $ds9 -grid numerics gap3 10 + $ds9 -grid numerics type exterior + $ds9 -grid numerics vertical yes + $ds9 -grid title yes + $ds9 -grid title text {Hello World} + $ds9 -grid title def yes + $ds9 -grid title gap 10 + $ds9 -grid title font courier + $ds9 -grid title fontsize 12 + $ds9 -grid title fontweight bold + $ds9 -grid title fontslant italic + $ds9 -grid title color red + $ds9 -grid labels yes + $ds9 -grid labels text1 {Hello World} + $ds9 -grid labels text2 {Hello World} + $ds9 -grid labels def1 yes + $ds9 -grid labels def2 yes + $ds9 -grid labels gap1 10 + $ds9 -grid labels gap2 10 + $ds9 -grid labels font courier + $ds9 -grid labels fontsize 12 + $ds9 -grid labels fontweight bold + $ds9 -grid labels fontslant italic + $ds9 -grid labels color red + $ds9 -grid reset + $ds9 -grid load foo.grd + $ds9 -grid save foo.grd + $ds9 -grid open + $ds9 -grid close + + header + Display current fits header dialog. Optional extension number + maybe specified. + Syntax: + -header [<ext>] +     [close [<ext>]] +     [save [<ext>] <filename>] + + Example: + $ds9 -header + $ds9 -header 2 + $ds9 -header close + $ds9 -header save 1 foo.txt + + height + Set the height of the image display window. Use the geometry command to set the + overall width and height of the ds9 window. + Syntax: + -height [<value>] + + Example: + $ds9 -height 512 + + help + Display help information. To maintain backward compatibility, + -help will display a brief help message and exit. --help will + display all command line options within the built-in help + facility. + Syntax: + -help # Display brief help message and exit. + --help # Display command line options within help facility. + -? # Display command line options within help facility. + + Example: + $ds9 -help # Display brief help message and exit. + $ds9 --help # Display command line options within help facility + $ds9 -? # Display command line options within help facility. + + histequ + Select histogram equalization scale function for the current + frame. + Syntax: + -histequ + + Example: + $ds9 -histequ + + iconify + Toggles iconification. + Syntax: + -iconify [] +     [yes|no] + + Example: + $ds9 -iconify + $ds9 -iconify yes + invert + Invert Colormap. + Syntax: + -invert + + Example: + $ds9 -invert + + iis + Set IIS Filename. Optional mosaic number maybe supplied. + Syntax: + -iis [filename <filename> [#]] + + Example: + $ds9 -iis filename foo.fits + $ds9 -iis filename bar.fits 4 + jpeg + Load JPEG image into current frame. + Syntax: + -jpeg <filename> + + Example: + $ds9 -jpeg foo.jpeg + $cat foo.jpeg | ds9 -jpeg - + language + Select current language. + Syntax: + -language [locale|da|de|es|en|fr|ja|pt] + + Example: + $ds9 -language fr + + linear + Select linear scale function for the current frame. + Syntax: + -linear + + Example: + $ds9 -linear + lock + Lock all other frames to the current frame. + Syntax: + -lock[frame <coordsys>|none] +     [crosshair <coordsys>|none] +     [crop <coordsys>|none] +     [slice <coordsys>|none] +     [bin [yes|no]] +     [axes [yes|no]] +     [scale [yes|no]] +     [scalelimits [yes|no]] +     [colorbar [yes|no]] +     [block [yes|no]] +     [smooth [yes|no]] +     [3d [yes|no]] + + Example: + $ds9 -lock frame wcs + $ds9 -lock crosshair wcs + $ds9 -lock crop wcs + $ds9 -lock slice wcs + $ds9 -lock bin yes + $ds9 -lock axes yes + $ds9 -lock scale yes + $ds9 -lock scalelimits yes + $ds9 -lock colorbar yes + $ds9 -lock block yes + $ds9 -lock smooth yes + $ds9 -lock 3d yes + + log + Select log scale function for the current frame. + + Syntax: + -log + + Example: + $ds9 -log + lower + Lower in the window stacking order. + Syntax: + -lower + + Example: + $ds9 -lower + + magnifier + Controls the magnifier settings. + Syntax: + magnifier [color <color>] +     [zoom <value>] +     [cursor yes|no] +     [region yes|no] + + Example: + $ds9 -magnifier color yellow + $ds9 -magnifier zoom 2 + $ds9 -magnifier cursor no + $ds9 -magnifier region no + + mask + nomask + + Controls mask parameters. + Syntax: + -mask [color <color>] +     [mark zero|nonzero|nan|nonnan|range] +     [range <low> <high>] +     [transparency <value>] +     [system <coordsys>] +     [clear] +     [open|close] + -nomask + + Example: + $ds9 -mask color red + $ds9 -mask mark zero + $ds9 -mask range 10 100 + $ds9 -mask transparency 50 + $ds9 -mask system wcs + $ds9 -mask clear + $ds9 -mask open + $ds9 -mask close + $ds9 -nomask + + match + Match all other frames to the current frame. + Syntax: + -match[frame <coordsys>] +     [crosshair <coordsys>] +     [crop <coordsys>] +     [slice <coordsys>] +     [bin] +     [axes] +     [scale] +     [scalelimits] +     [colorbar] +     [block] +     [smooth] +     [3d] + + Example: + $ds9 -match frame wcs + $ds9 -match crosshair wcs + $ds9 -match crop wcs + $ds9 -match slice wcs + $ds9 -match bin + $ds9 -match axes + $ds9 -match scale + $ds9 -match scalelimits + $ds9 -match colorbar + $ds9 -match block + $ds9 -match smooth + $ds9 -match 3d + + mecube + Load FITS multiple extension file as data cube. + + Syntax: + mecube <filename> + + Example: + $ds9 -mecube foo.fits + $cat foo.fits | ds9 -mecube - + minmax + This is how DS9 determines the min and max data values + from the data. SCAN will scan all data. + Syntax: + -minmax [scan|sample|datamin|irafmin] +     [mode scan|sample|datamin|irafmin] +     [interval #] + + Example: + $ds9 -minmax scan + $ds9 -minmax mode scan + $ds9 -minmax interval 100 + + mode + Select the current mode. + Syntax: + -mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + Example: + $ds9 -mode crosshair + mosaic + Load FITS mosaic segment into current frame. + Syntax: + -mosaic [wcs|wcsa...wcsz|iraf] <filename> + + Example: + $ds9 -mosaic foo.fits + $ds9 -mosaic wcs foo.fits + $cat foo.fits | ds9 -mosaic - + $cat foo.fits | ds9 -mosaic wcs - + + mosaicimage + Load FITS mosaic image into current frame. + Syntax: + -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> + + Example: + $ds9 -mosaicimage foo.fits + $ds9 -mosaicimage wcs foo.fits + $cat foo.fits | ds9 -mosaicimage + $cat foo.fits | ds9 -mosaiimage wcs + + movie + + Create a movie from snap shots of the DS9 window. A slice + movie cycles though all slices of a cube. A frame + movie cycles through all active frames. A 3d movie + cycles through specified viewing angles. The default action is slice. + Movie types are either MPEG or Animated GIF, + with default MPEG. Optional parameters for 3d: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times. + Syntax: + -movie [slice|frame|3d] [mpeg|gif] <filename> + -movie 3d [mpeg|gif] <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>] + + Example: + $ds9 -movie slice mpeg ds9.mpg + $ds9 -movie frame gif ds9.gif + $ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 + oscillate 1 + msg + Specify a directory of translation tables to be loaded. + Syntax: + -msg <directory> + + Example: + $ds9 -msg $HOME/msgs + multiframe + Load FITS multiple extension file as multiple images. + + Syntax: + multiframe <filename> + + Example: + $ds9 -multiframe foo.fits + $cat foo.fits | ds9 -multiframe - + + nameserver + Support Name Server functions. Coordinates are in fk5. + Syntax: + -nameserver [<object>] +     [name <object>] +     [skyformat degrees|sexagesimal] +     [pan] +     [crosshair] +     [open|close] + + Example: + $ds9 -nameserver m31 + $ds9 -nameserver name m31 + $ds9 -nameserver server ned-sao + $ds9 -nameserver skyformat sexagesimal + $ds9 -nameserver pan + $ds9 -nameserver crosshair + $ds9 -nameserver open + $ds9 -nameserver close + + nan + Set image not-a-number color. + Syntax: + -nan <color> + + Example: + $ds9 -nan red + nrrd + Load an NRRD (Nearly Raw Raster Data) file. + + Syntax: + -nrrd <filename> + + Example: + $ds9 -nrrd foo.nrrd + $cat foo.nrrd | xpaset ds9 -nrrd- + + nvss + Support for NRAO VLA Sky Survey. + Syntax: + -nvss [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $ds9 -nvss + $ds9 -nvss m31 + $ds9 -nvss name m31 + $ds9 -nvss name clear + $ds9 -nvss 00:42:44.404 +41:16:08.78 + $ds9 -nvss size 60 60 arcmin + $ds9 -nvss save yes + $ds9 -nvss frame current + $ds9 -nvss update frame + $ds9 -nvss open + $ds9 -nvess close + + orient + Controls the orientation of the current frame. + Syntax: + -orient [none|x|y|xy] +     [open|close] + + Example: + $ds9 -orient xy + $ds9 -orient open + $ds9 -orient close + + pagesetup + Controls Page Setup options. + + Syntax: + -pagesetup [orient portrait|landscape] +     [scale <numberic>] +     [size letter|legal|tabloid|poster|a4] + + Example: + $ds9 -pagesetup orient portrait + $ds9 -pagesetup scale 50 + $ds9 -pagesetup size poster + pan + Controls the current image cursor location for the current + frame. + Syntax: + -pan [<x> <h> <coordsys> [<skyframe>]] # + relative +     [to <x> <h> <coordsys> + [<skyframe>]] # absolute +     [open|close] + + Example: + $ds9 -pan 200 200 image# pan relative + $ds9 -pan to 400 400 physical# pan to physical coords + $ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords + $ds9 -pan open + $ds9 -pan close + pixeltable + Display/Hide the pixel table. + Syntax: + -pixeltable [] +     [yes|open] +     [no|close] + + Example: + $ds9 -pixeltable + $ds9 -pixeltable yes + $ds9 -pixeltable open + $ds9 -pixeltable close + + plot + Display and configure data plots. All plot commands take an + optional second command, the plot name. If no plot name is + specified, the last plot created is assumed. Plot data is + assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions: + xy    x and y coordinates + xyex    x,y coordinates with x errors + xyey    x,y coordinates with y errors + xyexey    x,y coordinates with x and y + errors + + To create a new plot, use the plot new command. + Syntax: + # create new empty plot window + -plot [line|bar|scatter] + + # existing plot + -plot[[<plotname>] load <filename> + xy|xyex|xyey|xyexey] +     [[<plotname>] save <filename>] +     [[<plotname>] clear] +     [[<plotname>] duplicate [#]] +     [[<plotname>] stats yes|no] +     [[<plotname>] list yes|no] +     [[<plotname>] loadconfig + <filename>] +     [[<plotname>] saveconfig + <filename>] +     [[<plotname>] pagesetup orient + portrait|landscape] +     [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4] +     [[<plotname>] print] +     [[<plotname>] print destination + printer|file] +     [[<plotname>] print command + <command>] +     [[<plotname>] print filename + <filename>] +     [[<plotname>] print color rgb|gray] +     [[<plotname>] close] +     [[<plotname>] mode pointer|zoom] + + # export image + plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> +     [[<plotname>]export jpeg + <filename>[1-100] +     [[<plotname>]export tiff + <filename>[none|jpeg|packbits|deflate] + + # configure graph + -plot [[<plotname>] axis x|y grid yes|no] +     [[<plotname>] axis x|y log yes|no] +     [[<plotname>] axis x|y flip yes|no] +     [[<plotname>] axis x|y auto yes|no] +     [[<plotname>] axis x|y min + <value>] +     [[<plotname>] axis x|y max + <value>] +     [[<plotname>] axis x|y format + <string>] +     [[<plotname>] background <value>] +     [[<plotname>] legend yes|no] +     [[<plotname>] legend position + right|left|top|bottom] +     [[<plotname>] font title|labels|numbers + font times|helvetica|courier] +     [[<plotname>] + fonttitle|labels|numberssize <value>] +     [[<plotname>] + fonttitle|labels|numbersweight normal|bold] +     [[<plotname>] + fonttitle|labels|numbersslant roman|italic] +     [[<plotname>] title <string>] +     [[<plotname>] title x|y <string>] +     [[<plotname>] barmode + normal|stacked|aligned|overlap] + + # configure current dataset + -plot [[<plotname>] show yes|no] +    [[<plotname>] shape + none|circle|square|diamond|plus|splus|scross|triangle|arrow] +    [[<plotname>] shape fill yes|no] +    [[<plotname>] shape color <value>] +    [[<plotname>] smooth + step|linear|cubic|quadratic|catrom] +    [[<plotname>] color <value>] +    [[<plotname>] width <value>] +    [[<plotname>] dash yes|no] +    [[<plotname>] error yes|no] +    [[<plotname>] error color <value>] +    [[<plotname>] error cap yes|no] +    [[<plotname>] error width <value>] +    [[<plotname>] name <string>] + + # select current dataset + -plot [[<plotname>] select <value>] + + Example: + # create new empty plot window + $ds9 -plot bar + + # existing plot + $ds9 -plot load xy.dat + $ds9 -plot save foo.dat + $ds9 -plot clear + $ds9 -plot duplicate 1 + $ds9 -plot stats yes + $ds9 -plot list yes + $ds9 -plot loadconfig foo.plt + $ds9 -plot saveconfig foo.plt + $ds9 -plot pagesetup orient portrait + $ds9 -plot pagesetup size letter + $ds9 -plot print + $ds9 -plot print destination file + $ds9 -plot print command lp + $ds9 -plot print filename foo.ps + $ds9 -plot print color rgb + $ds9 -plot close + + # plot mode + $ds9 -plot mode pointer + + # export plot + $ds9 -plot export tiff foo.tiff jpeg + $ds9 -plot export jpeg foo.jpeg 75 + $ds9 -plot export png foo.png + + # configure plot + $ds9 -plot axis x grid yes + $ds9 -plot axis x log yes + $ds9 -plot axis x flip yes + $ds9 -plot axis x auto no + $ds9 -plot axis x min 1 + $ds9 -plot axis x max 100 + $ds9 -plot axis x format '%f' + $ds9 -plot background white + $ds9 -plot legend yes + $ds9 -plot legend position left + $ds9 -plot font numbers font times + $ds9 -plot font numbers size 12 + $ds9 -plot font numbers weight bold + $ds9 -plot font numbers slant italic + $ds9 -plot title 'This is a Title' + $ds9 -plot title x 'X Axis' + $ds9 -plot title y 'Y Axis' + $ds9 -plot title legend 'This is the Legend' + + # bar plot + $ds9 -plot barmode aligned + + # configure current dataset + $ds9 -plot show yes + $ds9 -plot shape circle + $ds9 -plot shape fill no + $ds9 -plot shape color cyan + $ds9 -plot smooth step + $ds9 -plot color red + $ds9 -plot width 2 + $ds9 -plot dash yes + $ds9 -plot error yes + $ds9 -plot error color red + $ds9 -plot error cap yes + $ds9 -plot error width 2 + $ds9 -plot name 'My Data' + + # select current dataset + $ds9 -plot select 2 + png + Load PNG image into current frame. + + Syntax: + -png <filename> + + Example: + $ds9 png foo.png + $cat foo.png | ds9 -png - + + port + Set the IRAF port number, used by IRAF to communicate with DS9. + The default is 5137, the standard IRAF port used by ximtool. + Syntax: + -port number + + Example: + $ds9 -port 5137 + port_only + inet_only + Only use the IRAF port number. This is the same as -fifo none + -unix none. + Syntax: + -port_only + + Example: + $ds9 -port_only + + pow + Select power scale function for the current frame. + Syntax: + -pow + + Example: + $ds9 -pow + + precision + Set region and coordinate output format precision. + Syntax: + -precision <linear><degree><hms><dms><arcmin><arcsec> - - -Example: -$ds9 -precision 8 10 4 3 5 3 -prefs -Controls various preference settings. -Syntax: --prefs [clear] -    [irafalign yes|no] - -Example: -$ds9 -prefs clear -$ds9 -prefs irafalign yes -preserve -Preserve the follow attributes while loading a new image. -Syntax: -preserve [pan yes|no] -    [regions yes|no] - -Example: -$ds9 -preserve pan yes -$ds9 -preserve regions yes -psprint -Invokes postscript printing. Please see print -for further details. -print -Controls printing. Use print option to set printing -options. -Syntax: --print [destination printer|file] -    [command <command>] -    [filename <filename>] -    [color rgb|cmyk|gray] -    [level 1|2|3] -    -[resolution72|screen|96|144|150|225|300|600|1200] - -Example: -$ds9 -print -$ds9 -print destination file -$ds9 -print command lp -$ds9 -print filename foo.ps -$ds9 -print color cmyk -$ds9 -print level 2 -$ds9 -print resolution 96 -raise -Raise in the window stacking order. -Syntax: --raise - -Example: -$ds9 -raise -regions -Controls regions in the current frame. -Syntax: --regions [<filename>] -    [load [all] <filename>] -    [save <filename>] -    [list [close]] -    [epsilon <integer>] -    [show yes|no] -    [showtext yes|no] -    [centroid] -    [centroid auto yes|no] -    [centroid radius <value>|iteration -<value>] -    [getinfo] -    [move front] -    [move back] -    [select all] -    [select none] -    [select invert] -    [delete all] -    [delete select] -    [format -ds9|xml|ciao|saotng|saoimage|pros|xy] -    [system image|physical|wcs|wcsa...wcsz] -    [sky fk4|fk5|icrs|galactic|ecliptic] -    [skyformat degrees|sexagesimal] -    [strip yes|no] -    [shape <shape>] -    [color <color> -    [width <width>] -    [fixed|edit|rotate|delete yes|no] -    [include|exclude|source|background] -    [command <marker command>] -    [composite] -    [dissolve] -    [template <filename>] -    [template <filename> at <ra> -<dec> <coordsys> <skyframe>] -    [savetemplate <filename>] -    [group new] -    [group <tag> new] -    [group <tag> update] -    [group <tag> select] -    [group <tag> color <color>] -    [group <tag> copy] -    [group <tag> delete] -    [group <tag> cut] -    [group <tag> font <font>] -    [group <tag> move <int> -<int>] -    [group <tag> movefront] -    [group <tag> moveback] -    [group <tag> property <property> -yes|no] -    [copy] -    [cut] -    [paste image|physical|wcs|wcsa...wcsz] -    [undo] - -Example: -$ds9 -regions foo.reg -$ds9 -regions -format ciao bar.reg # load as ciao format -$ds9 -regions foo.fits # FITS regions files do not need a format -specification -$ds9 -regions load foo.reg # load foo.reg into current frame -$ds9 -regions load all foo.reg # load foo.reg into all frames -$ds9 -regions load '*.reg'# expand *.reg and load into current -frame -$ds9 -regions load all '*.reg' # expand *.reg and load into all -frames -$ds9 -regions save foo.reg -$ds9 -regions list -$ds9 -regions list close -$ds9 -regions epsilon 5 -$ds9 -regions show yes -$ds9 -regions showtext no -$ds9 -regions centroid -$ds9 -regions centroid auto yes -$ds9 -regions centroid radius 10 -$ds9 -regions centroid iteration 20 -$ds9 -regions getinfo -$ds9 -regions move back -$ds9 -regions move front -$ds9 -regions select all -$ds9 -regions select none -$ds9 -regions select invert -$ds9 -regions delete all -$ds9 -regions delete select -$ds9 -regions format ds9 -$ds9 -regions system wcs -$ds9 -regions sky fk5 -$ds9 -regions skyformat degrees -$ds9 -regions strip yes -$ds9 -regions shape ellipse -$ds9 -regions color red -$ds9 -regions width 3 -$ds9 -regions edit yes -$ds9 -regions include -$ds9 -regions command "circle 100 100 20 # color=red" -$ds9 -regions composite -$ds9 -regions dissolve -$ds9 -regions template foo.tpl -$ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 -$ds9 -regions savetemplate foo.tpl -$ds9 -regions group new -$ds9 -regions group foo new -$ds9 -regions group foo update -$ds9 -regions group foo select -$ds9 -regions group foo color red -$ds9 -regions group foo copy -$ds9 -regions group foo delete -$ds9 -regions group foo cut -$ds9 -regions group foo font {times 14 bold} -$ds9 -regions group foo move 100 100 -$ds9 -regions group foo movefront -$ds9 -regions group foo moveback -$ds9 -regions group foo property delete no -$ds9 -regions copy -$ds9 -regions cut -$ds9 -regions paste wcs -$ds9 -regions undo -red -For RGB frames, sets the current color channel to red. -Syntax: --red - -Example: -$ds9 -red foo.fits -restore -Restore DS9 to a previous state from a backup save set. -Syntax: --restore <filename> - -Example: -$ds9 -restore ds9.bck -rgb -Create RGB frame and control RGB frame parameters. -Syntax: --rgb [] -    [red|green|blue] -    [channel [red|green|blue]] -    [view [red|green|blue] [yes|no]] -    [system <coordsys>] -    [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]] -    [open|close] - -Example: -$ds9 -rgb # create new rgb frame -$ds9 -rgb red # set current channel to red -$ds9 -rgb channel red # set current channel to red -$ds9 -rgb view blue no # turn off blue channel -$ds9 -rgb system wcs # set rgb coordinate system -$ds9 -rgb lock wcs yes -$ds9 -rgb lock crop yes -$ds9 -rgb lock slice yes -$ds9 -rgb lock bin yes -$ds9 -rgb lock scale yes -$ds9 -rgb lock scalelimits yes -$ds9 -rgb lock colorbar yes -$ds9 -rgb lock block yes -$ds9 -rgb lock smooth yes -$ds9 -rgb open -$ds9 -rgb close -rgbarray -Load raw data array cube into rgb frame. -Syntax: --rgbarray + + Example: + $ds9 -precision 8 10 4 3 5 3 + prefs + Controls various preference settings. + Syntax: + -prefs [clear] +     [irafalign yes|no] + + Example: + $ds9 -prefs clear + $ds9 -prefs irafalign yes + + preserve + Preserve the follow attributes while loading a new image. + Syntax: + preserve [pan yes|no] +     [regions yes|no] + + Example: + $ds9 -preserve pan yes + $ds9 -preserve regions yes + + psprint + Invokes postscript printing. Please see print + for further details. + print + Controls printing. Use print option to set printing options. + + Syntax: + -print [destination printer|file] +     [command <command>] +     [filename <filename>] +     [color rgb|cmyk|gray] +     [level 1|2|3] +     + [resolution72|screen|96|144|150|225|300|600|1200] + + Example: + $ds9 -print + $ds9 -print destination file + $ds9 -print command lp + $ds9 -print filename foo.ps + $ds9 -print color cmyk + $ds9 -print level 2 + $ds9 -print resolution 96 + raise + Raise in the window stacking order. + Syntax: + -raise + + Example: + $ds9 -raise + + regions + Controls regions in the current frame. + Syntax: + -regions [<filename>] +     [load [all] <filename>] +     [save <filename>] +     [list [close]] +     [epsilon <integer>] +     [show yes|no] +     [showtext yes|no] +     [centroid] +     [centroid auto yes|no] +     [centroid radius <value>|iteration + <value>] +     [getinfo] +     [move front] +     [move back] +     [select all] +     [select none] +     [select invert] +     [delete all] +     [delete select] +     [format ds9|xml|ciao|saotng|saoimage|pros|xy] +     [system image|physical|wcs|wcsa...wcsz] +     [sky fk4|fk5|icrs|galactic|ecliptic] +     [skyformat degrees|sexagesimal] +     [strip yes|no] +     [shape <shape>] +     [color <color> +     [width <width>] +     [fixed|edit|rotate|delete yes|no] +     [include|exclude|source|background] +     [command <marker command>] +     [composite] +     [dissolve] +     [template <filename>] +     [template <filename> at <ra> + <dec> <coordsys> <skyframe>] +     [savetemplate <filename>] +     [group new] +     [group <tag> new] +     [group <tag> update] +     [group <tag> select] +     [group <tag> color <color>] +     [group <tag> copy] +     [group <tag> delete] +     [group <tag> cut] +     [group <tag> font <font>] +     [group <tag> move <int> + <int>] +     [group <tag> movefront] +     [group <tag> moveback] +     [group <tag> property <property> + yes|no] +     [copy] +     [cut] +     [paste image|physical|wcs|wcsa...wcsz] +     [undo] + + Example: + $ds9 -regions foo.reg + $ds9 -regions -format ciao bar.reg # load as ciao format + $ds9 -regions foo.fits # FITS regions files do not need a format + specification + $ds9 -regions load foo.reg # load foo.reg into current frame + $ds9 -regions load all foo.reg # load foo.reg into all frames + $ds9 -regions load '*.reg'# expand *.reg and load into current + frame + $ds9 -regions load all '*.reg' # expand *.reg and load into all + frames + $ds9 -regions save foo.reg + $ds9 -regions list + $ds9 -regions list close + $ds9 -regions epsilon 5 + $ds9 -regions show yes + $ds9 -regions showtext no + $ds9 -regions centroid + $ds9 -regions centroid auto yes + $ds9 -regions centroid radius 10 + $ds9 -regions centroid iteration 20 + $ds9 -regions getinfo + $ds9 -regions move back + $ds9 -regions move front + $ds9 -regions select all + $ds9 -regions select none + $ds9 -regions select invert + $ds9 -regions delete all + $ds9 -regions delete select + $ds9 -regions format ds9 + $ds9 -regions system wcs + $ds9 -regions sky fk5 + $ds9 -regions skyformat degrees + $ds9 -regions strip yes + $ds9 -regions shape ellipse + $ds9 -regions color red + $ds9 -regions width 3 + $ds9 -regions edit yes + $ds9 -regions include + $ds9 -regions command "circle 100 100 20 # color=red" + $ds9 -regions composite + $ds9 -regions dissolve + $ds9 -regions template foo.tpl + $ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 + $ds9 -regions savetemplate foo.tpl + $ds9 -regions group new + $ds9 -regions group foo new + $ds9 -regions group foo update + $ds9 -regions group foo select + $ds9 -regions group foo color red + $ds9 -regions group foo copy + $ds9 -regions group foo delete + $ds9 -regions group foo cut + $ds9 -regions group foo font {times 14 bold} + $ds9 -regions group foo move 100 100 + $ds9 -regions group foo movefront + $ds9 -regions group foo moveback + $ds9 -regions group foo property delete no + $ds9 -regions copy + $ds9 -regions cut + $ds9 -regions paste wcs + $ds9 -regions undo + + red + For RGB frames, sets the current color channel to red. + Syntax: + -red + + Example: + $ds9 -red foo.fits + + restore + Restore DS9 to a previous state from a backup save set. + Syntax: + -restore <filename> + + Example: + $ds9 -restore ds9.bck + rgb + Create RGB frame and control RGB frame parameters. + Syntax: + -rgb [] +     [red|green|blue] +     [channel [red|green|blue]] +     [view [red|green|blue] [yes|no]] +     [system <coordsys>] +     [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]] +     [open|close] + + Example: + $ds9 -rgb # create new rgb frame + $ds9 -rgb red # set current channel to red + $ds9 -rgb channel red # set current channel to red + $ds9 -rgb view blue no # turn off blue channel + $ds9 -rgb system wcs # set rgb coordinate system + $ds9 -rgb lock wcs yes + $ds9 -rgb lock crop yes + $ds9 -rgb lock slice yes + $ds9 -rgb lock bin yes + $ds9 -rgb lock scale yes + $ds9 -rgb lock scalelimits yes + $ds9 -rgb lock colorbar yes + $ds9 -rgb lock block yes + $ds9 -rgb lock smooth yes + $ds9 -rgb open + $ds9 -rgb close + rgbarray + Load raw data array cube into rgb frame. + + Syntax: + -rgbarray <filename>[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -$ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] -$cat foo.arr | ds9 -rgbarray --[dim=512,zdim=3,bitpix=-32,endian=little] -rgbcube -Load FITS rgbcube into rgb frame. -Syntax: --rgbcube <filename> - -Example: -$ds9 -rgbcube foo.fits -$cat foo.fits | ds9 -rgbcube - -rgbimage -Load FITS rgbimage into rgb frame. -Syntax: --rgbimage <filename> - -Example: -$ds9 -rgbimage foo.fits -$cat foo.fits | ds9 -rgbimage - -rotate -Controls the rotation angle (in degrees) of the current -frame.< -Syntax: --rotate [<value>] -    [to <value>] -    [open|close] - -Example: -$ds9 -rotate 45 -$ds9 -rotate to 30 -$ds9 -rotate open -$ds9 -rotate close -samp -Configure SAMP protocol. -Syntax: --samp [yes|no|connect|disconnect] -    [broadcast [image|table]] -    [send [image|table] <application>] - -Example: -$ds9 -samp yes -$ds9 -samp connect -$ds9 -samp broadcast image -$ds9 -samp send image aladin -save -Save loaded image data of current frame as FITS. -Syntax: --save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice] - -Example: -$ds9 -save foo.fits -$ds9 -save fits foo.fits image -$ds9 -save fits foo.fits table -$ds9 -save fits foo.fits slice -$ds9 -save rgbimage foo.fits -$ds9 -save rgbcube foo.fits -$ds9 -save mecube foo.fits -$ds9 -save mosaic foo.fits -$ds9 -save mosaicimage foo.fits -saveimage -Create a snap shot of the current DS9 window and save in -specified image format. If no format specified, the file name -extension is used to determine the output format. Optional -parameters: jpeg quality (1-100) and tiff -compression method. -Syntax: --saveimage[fits|eps|gif|tiff|jpeg|png]<filename> --saveimage <filename>.jpeg [1-100] --saveimage <filename>.tiff [none|jpeg|packbits|deflate] - -Example: -$ds9 -saveimage ds9.tiff -$ds9 -saveimage jpeg ds9.jpeg 75 -scale -Controls the limits and color scale distribution. -Syntax: --scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -    [log exp <value>] -    [datasec yes|no] -    [limits <minvalue> <maxvalue>] -    [mode minmax|<value>|zscale|zmax] -    [scope local|global] -    [match] -    [match limits] -    [lock [yes|no]] -    [lock limits [yes|no]] -    [open|close] - -Example: -$ds9 -scale linear -$ds9 -scale log exp 100 -$ds9 -scale datasec yes -$ds9 -scale histequ -$ds9 -scale limits 1 100 -$ds9 -scale mode zscale -$ds9 -scale mode 99.5 -$ds9 -scale scope local -$ds9 -scale match -$ds9 -scale match limits -$ds9 -scale lock yes -$ds9 -scale lock limits yes -$ds9 -scale open -$ds9 -scale close -shm -Load a shared memory segment into the current frame. -Syntax: --shm [<key> [<filename>]] -    [key <id> [<filename>]] -    [shmid <id> [<filename>]] -    [fits [key|shmid] <id> -[<filename>]] -    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]] -    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]] -    [rgbcube [key|shmid] <id> -[<filename>]] -    [rgbimage [key|shmid] <id> -[<filename>]] -    [rgbarray [key|shmid] <id> + + Example: + $ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + $cat foo.arr | ds9 -rgbarray + -[dim=512,zdim=3,bitpix=-32,endian=little] + rgbcube + Load FITS rgbcube into rgb frame. + + Syntax: + -rgbcube <filename> + + Example: + $ds9 -rgbcube foo.fits + $cat foo.fits | ds9 -rgbcube - + rgbimage + Load FITS rgbimage into rgb frame. + + Syntax: + -rgbimage <filename> + + Example: + $ds9 -rgbimage foo.fits + $cat foo.fits | ds9 -rgbimage - + rotate + Controls the rotation angle (in degrees) of the current + frame.< + Syntax: + -rotate [<value>] +     [to <value>] +     [open|close] + + Example: + $ds9 -rotate 45 + $ds9 -rotate to 30 + $ds9 -rotate open + $ds9 -rotate close + + samp + Configure SAMP protocol. + Syntax: + -samp [yes|no|connect|disconnect] +     [broadcast [image|table]] +     [send [image|table] <application>] + + Example: + $ds9 -samp yes + $ds9 -samp connect + $ds9 -samp broadcast image + $ds9 -samp send image aladin + save + + Save loaded image data of current frame as FITS. + Syntax: + -save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice] + + Example: + $ds9 -save foo.fits + $ds9 -save fits foo.fits image + $ds9 -save fits foo.fits table + $ds9 -save fits foo.fits slice + $ds9 -save rgbimage foo.fits + $ds9 -save rgbcube foo.fits + $ds9 -save mecube foo.fits + $ds9 -save mosaic foo.fits + $ds9 -save mosaicimage foo.fits + saveimage + Create a snap shot of the current DS9 window and save in + specified image format. If no format specified, the file name + extension is used to determine the output format. Optional + parameters: jpeg quality (1-100) and tiff + compression method. + Syntax: + -saveimage[fits|eps|gif|tiff|jpeg|png]<filename> + -saveimage <filename>.jpeg [1-100] + -saveimage <filename>.tiff [none|jpeg|packbits|deflate] + + Example: + $ds9 -saveimage ds9.tiff + $ds9 -saveimage jpeg ds9.jpeg 75 + + scale + Controls the limits and color scale distribution. + Syntax: + -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +     [log exp <value>] +     [datasec yes|no] +     [limits <minvalue> <maxvalue>] +     [mode minmax|<value>|zscale|zmax] +     [scope local|global] +     [match] +     [match limits] +     [lock [yes|no]] +     [lock limits [yes|no]] +     [open|close] + + Example: + $ds9 -scale linear + $ds9 -scale log exp 100 + $ds9 -scale datasec yes + $ds9 -scale histequ + $ds9 -scale limits 1 100 + $ds9 -scale mode zscale + $ds9 -scale mode 99.5 + $ds9 -scale scope local + $ds9 -scale match + $ds9 -scale match limits + $ds9 -scale lock yes + $ds9 -scale lock limits yes + $ds9 -scale open + $ds9 -scale close + + shm + Load a shared memory segment into the current frame. + Syntax: + -shm [<key> [<filename>]] +     [key <id> [<filename>]] +     [shmid <id> [<filename>]] +     [fits [key|shmid] <id> + [<filename>]] +     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]] +     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] + <id> [<filename>]] +     [rgbcube [key|shmid] <id> + [<filename>]] +     [rgbimage [key|shmid] <id> + [<filename>]] +     [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] - -    [array [key|shmid] <id> +     [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - -Example: -$ds9 -shm 102 -$ds9 -shm key 102 -$ds9 -shm shmid 102 foo -$ds9 -shm fits 100 foo -$ds9 -shm mosaicimage iraf key 100 foo -$ds9 -shm mosaicimage wcs key 100 foo -$ds9 -shm mosaicimage wcsa key 100 foo -$ds9 -shm mosaicimage wfpc2 key 100 foo -$ds9 -shm mosaic iraf key 100 foo -$ds9 -shm mosaic wcs key 100 foo -$ds9 -shm rgbcube key 100 foo -$ds9 -shm rgbimage key 100 foo -$ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] -$ds9 -shm array shmid 102 [dim=32,bitpix=-32] -sia -Support for VO Simple Image Access protocol. The first command -will create a new search. All other commands operated on the last -search created, unless indicated otherwise. -Syntax: --sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [coordinate <ra> <dec> -<coordsys>] -    [<ref>] [crosshair] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [name <object>] -    [<ref>] [print] -    [<ref>] [retrieve] -    [<ref>] [save <filename>] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] - -Example: -$ds9 -sia 2mass -$ds9 -sia cancel -$ds9 -sia clear -$ds9 -sia close -$ds9 -sia coordinate 202.48 47.21 fk5 -$ds9 -sia crosshair -$ds9 -sia export tsv bar.tsv -$ds9 -sia name m51 -$ds9 -sia print -$ds9 -sia retrieve -$ds9 -sia save foo.xml -$ds9 -sia radius 1 degrees -$ds9 -sia sky fk5 -$ds9 -sia skyformat degrees -$ds9 -sia system wcs -$ds9 -sia update - single -Set display mode to single. -Syntax: --single - -Example: -$ds9 -single -skyview -Support for SkyView image server at HEASARC. -Syntax: --skyview [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [pixels <width> <height>] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey <survey>] -    [open|close] - -Example: -$ds9 -skyview -$ds9 -skyview m31 -$ds9 -skyview name m31 -$ds9 -skyview name clear -$ds9 -skyview 00:42:44.404 +41:16:08.78 -$ds9 -skyview size 60 60 arcmin -$ds9 -skyview pixels 600 600 -$ds9 -skyview save yes -$ds9 -skyview frame current -$ds9 -skyview update frame -$ds9 -skyview survey sdssi -$ds9 -skyview open -$ds9 -skyview close -sleep -Delays execution for specified number of seconds. Default is 1 -second. -Syntax: --sleep [#] - -Example: -$ds9 -sleep -$ds9 -sleep 2 -slice -noslice -Indicates next files loaded are to treated as slices of a cube. -Can be disabled with noslice command. -Syntax: --slice <filename> --noslice - -Example: -$ds9 -slice *.fits -$ds9 -noslice -smooth -Smooth current image or set smooth parameters. -Boxcar width =2*radius+1 -Tophat diameter =2*radius+1 -Gaussian diameter =2*radius+1,mean=0 -Elliptical Gaussian diameter -=2*radius+1,mean=0 -Syntax: --smooth [] -    [yes|no] -    [function boxcar|tophat|gaussian|elliptic] -    [radius <value>] -    [radiusminor <value>] -    [sigma <value>] -    [sigmaminor <value>] -    [angle <value>] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$ds9 -smooth -$ds9 -smooth yes -$ds9 -smooth function tophat -$ds9 -smooth radius 4 -$ds9 -smooth radiusminor 4 -$ds9 -smooth sigma 2.0 -$ds9 -smooth sigmaminor 2.0 -$ds9 -smooth angle 45 -$ds9 -smooth match -$ds9 -smooth lock yes -$ds9 -smooth open -$ds9 -smooth close -squared -Select squared scale function for the current frame. -Syntax: --squared - -Example: -$ds9 -squared -sqrt -Select square soot scale function for the current frame. -Syntax: --sqrt - -Example: -$ds9 -sqrt -source -Source TCL code from a file. -Syntax: --source <filename> - -Example: -$ds9 -source extensions.tcl -tcl -Execute one TCL command. Note: this a different behavior from -previous versions of DS9. -Syntax: --tcl <tcl command> - -Example: -$ds9 -tcl 'puts "Hello, World"' -threads -Set number of process threads for functions which are -multi-threaded. -Syntax: --threads # - -Example: -$ds9 -threads 8 - -tiff -Load TIFF image into current frame. -Syntax: --tiff <filename> - -Example: -$ds9 -tiff foo.tiff -$cat foo.fits | ds9 -tiff - -tile -Controls the tile display mode. -Syntax: --tile [] -    [yes|no] -    [mode grid|column|row] -    [grid] -    [grid mode automatic|manual] -    [grid direction x|y] -    [grid layout <col> <row>] -    [grid gap <pixels>] -    [row] -    [column] - -Example: -$ds9 -tile -$ds9 -tile yes -$ds9 -tile mode row -$ds9 -tile grid -$ds9 -tile grid mode manual -$ds9 -tile grid direction x -$ds9 -tile grid layout 5 5 -$ds9 -tile grid gap 10 -$ds9 -tile row -$ds9 -tile column -title -Changes the display window title to the specified name. -Syntax: --title name - -Example: -$ds9 -title Voyager -unix -Set the IRAF unix socket name, used by IRAF to communicate with -DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix -socket is defined. -Syntax: --unix name - -Example: -$ds9 -unix "/tmp/.IMT%d" -unix_only -Only use the IRAF unix socket name. This is the same as -fifo -none -port 0. -Syntax: --unix_only - -Example: -$ds9 -unix_only -update -Updates the current frame or region of frame. In the second -form, the first argument is the number of the fits HDU (starting -with 1) and the remaining args are a bounding box in IMAGE -coordinates. By default, the screen is updated the next available -idle cycle. However, you may force an immediate update by -specifying the NOW option. -Syntax: --update [] -    [# x1 y1 x2 y2] -    [now] -    [now # x1 y1 x2 y2] - -Example: -$ds9 -update -$ds9 -update 1 100 100 300 400 -$ds9 -update now -$ds9 -update now 1 100 100 300 400 -url -Load FITS from URL into the current frame -Syntax: --url <url> - -Example: -$ds9 -url http://foo.bar.edu/foo.fits -version -Returns the current version of DS9 and exits. -Syntax: --version - -Example: -$ds9 -version -view -Controls the GUI and visible RGB frame color channels. -Syntax: --view [layout horizontal|vertical] -    [keyvalue <string>] -    [info yes|no] -    [panner yes|no] -    [magnifier yes|no] -    [buttons yes|no] -    [colorbar yes|no] -    [graph horizontal|vertical yes|no] -    [filename yes|no] -    [object yes|no] -    [keyword yes|no] -    [minmax yes|no] -    [lowhigh yes|no] -    [units yes|no] -    [image|physical|wcs|wcsa...wcsz yes|no] -    [frame yes|no] -    [red yes|no] -    [green yes|no] -    [blue yes|no] - -Example: -$ds9 -view layout vertical -$ds9 -view keyvalue BITPIX -$ds9 -view info yes -$ds9 -view panner yes -$ds9 -view magnifier yes -$ds9 -view buttons yes -$ds9 -view colorbar yes -$ds9 -view graph horizontal yes -$ds9 -view filename yes -$ds9 -view object yes -$ds9 -view keyword yes -$ds9 -view minmax yes -$ds9 -view lowhigh yes -$ds9 -view wcsa yes -$ds9 -view frame yes -$ds9 -view red yes -$ds9 -view green yes -$ds9 -view blue yes -visual -Force DS9 to use the specified color visual. This argument MUST -be the first argument listed. Requires the visual be available. -Syntax: --visual [truecolor|truecolor8|truecolor16|truecolor24] -Example: -$ds9 -visual truecolor24 -vla -Support for VLA Sky Survey. -Syntax: --vla [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey first|stripe82] -    [open|close] - -Example: -$ds9 -vla -$ds9 -vla m31 -$ds9 -vla name m31 -$ds9 -vla name clear -$ds9 -vla 00:42:44.404 +41:16:08.78 -$ds9 -vla size 60 60 arcmin -$ds9 -vla save yes -$ds9 -vla frame current -$ds9 -vla update frame -$ds9 -vla survey stripe82 -$ds9 -vla open -$ds9 -vla close -vlss -Support for NRAO VLSS Sky Survey. -Syntax: --vlss [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$ds9 -vlss -$ds9 -vlss m31 -$ds9 -vlss name m31 -$ds9 -vlss name clear -$ds9 -vlss 00:42:44.404 +41:16:08.78 -$ds9 -vlss size 60 60 arcmin -$ds9 -vlss save yes -$ds9 -vlss frame current -$ds9 -vlss update frame -$ds9 -vlss open -$ds9 -nvess close -vo -Invoke an connection to a Virtual Observatory site. -Syntax: --vo [method xpa|mime] -    [server <url>] -    [internal yes|no] -    [delay #] -    [<url>] -    [connect <url>] -    [disconnect <url>] -    [open|close] - -Example: -$ds9 -vo method xpa -$ds9 -vo server "http://foo.bar.edu/list.txt" -$ds9 -vo internal yes -$ds9 -vo delay 15 # keep-alive delay -$ds9 -vo chandra-ed -$ds9 -vo connect chandra-ed -$ds9 -vo disconnect chandra-ed -$ds9 -vo open -$ds9 -vo close -wcs -Controls the World Coordinate System for the current frame. If -the wcs system, skyframe, or skyformat is modified, the info panel, -compass, grid, and alignment will be modified accordingly. Also, a -new WCS specification can be loaded and used by the current image -regardless of the WCS that was contained in the image file. Please -see WCS for more information. -Syntax: --wcs [[system] wcs|wcsa...wcsz] -    [[sky] fk4|fk5|icrs|galactic|ecliptic] -    [[skyformat] degrees|sexagesimal] -    [align yes|no] -    [reset [#]] -    [replace [#] <filename>] -    [append [#] <filename>] -    [open|close] - -Example: -$ds9 -wcs wcs -$ds9 -wcs system wcs -$ds9 -wcs fk5 -$ds9 -wcs sky fk5 -$ds9 -wcs sexagesimal -$ds9 -wcs skyformat sexagesimal -$ds9 -wcs align yes -$ds9 -wcs reset -$ds9 -wcs reset 3 -$ds9 -wcs replace foo.wcs -$ds9 -wcs replace 3 foo.wcs -$ds9 -wcs append foo.wcs -$ds9 -wcs append 3 foo.wcs -$ds9 -wcs open -$ds9 -wcs close -web -Display specified URL in the web display. -Syntax: --web [] -    [<url>] -    [new <webname> <url>] -    [<webname>] [click -back|forward|stop|reload|#] -    [<webname>] [clear] -    [<webname>] [close] - -Example: -$ds9 -web www.cnn.com -$ds9 -web new www.cnn.com -$ds9 -web hvweb www.apple.com -$ds9 -web click back -$ds9 -web click 2 -$ds9 -web clear -$ds9 -web close -width -Set the width of the image display window. Use the geometry command to set the overall -width and height of the ds9 window. -Syntax: --width [<value>] - -Example: -$ds9 -width 512 -xpa -Configure XPA. -Syntax: --xpa [yes|no] -    [inet|local|unix|localhost] -    [noxpans] -    [connect] -    [disconnect] -    [info] - -Example: -$ds9 -xpa no -$ds9 -xpa local -$ds9 -xpa noxpans -$ds9 -xpa connect -$ds9 -xpa disconnect -$ds9 -xpa info -zmax -Set Scale Limits based on the IRAF algorithm and -maximum data value. -Syntax: --zmax - -Example: -$ds9 -zmax -zscale -Set Scale Limits based on the IRAF algorithm. -Syntax: --zscale [] -    [contrast] -    [sample] -    [line] - -Example: -$ds9 -zscale -$ds9 -zscale contrast .25 -$ds9 -zscale sample 600 -$ds9 -zscale line 120 -zoom -Controls the current zoom value for the current frame. -Syntax: --zoom [<value>] -    [<value> <value>] -    [to <value>] -    [to <value> <value>] -    [in] -    [out] -    [to fit] -    [open|close] - -Example: -$ds9 -zoom 2 -$ds9 -zoom 2 4 -$ds9 -zoom to 4 -$ds9 -zoom to 2 4 -$ds9 -zoom in -$ds9 -zoom out -$ds9 -zoom to fit -$ds9 -zoom open -$ds9 -zoom close - - + + Example: + $ds9 -shm 102 + $ds9 -shm key 102 + $ds9 -shm shmid 102 foo + $ds9 -shm fits 100 foo + $ds9 -shm mosaicimage iraf key 100 foo + $ds9 -shm mosaicimage wcs key 100 foo + $ds9 -shm mosaicimage wcsa key 100 foo + $ds9 -shm mosaicimage wfpc2 key 100 foo + $ds9 -shm mosaic iraf key 100 foo + $ds9 -shm mosaic wcs key 100 foo + $ds9 -shm rgbcube key 100 foo + $ds9 -shm rgbimage key 100 foo + $ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] + $ds9 -shm array shmid 102 [dim=32,bitpix=-32] + +
sia
+
+
Support for VO Simple Image Access protocol. The first command + will create a new search. All other commands operated on the + last search created, unless indicated otherwise.
+ Syntax: + -sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [coordinate <ra> + <dec> <coordsys>] +     [<ref>] [crosshair] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [name <object>] +     [<ref>] [print] +     [<ref>] [retrieve] +     [<ref>] [save <filename>] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] + + Example: + $ds9 -sia 2mass + $ds9 -sia cancel + $ds9 -sia clear + $ds9 -sia close + $ds9 -sia coordinate 202.48 47.21 fk5 + $ds9 -sia crosshair + $ds9 -sia export tsv bar.tsv + $ds9 -sia name m51 + $ds9 -sia print + $ds9 -sia retrieve + $ds9 -sia save foo.xml + $ds9 -sia radius 1 degrees + $ds9 -sia sky fk5 + $ds9 -sia skyformat degrees + $ds9 -sia system wcs + $ds9 -sia update + + single +
Set display mode to single.
+ Syntax: + -single + + Example: + $ds9 -single + +
skyview
+
Support for SkyView image server at HEASARC.
+ Syntax: + -skyview [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [pixels <width> <height>] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey <survey>] +     [open|close] + + Example: + $ds9 -skyview + $ds9 -skyview m31 + $ds9 -skyview name m31 + $ds9 -skyview name clear + $ds9 -skyview 00:42:44.404 +41:16:08.78 + $ds9 -skyview size 60 60 arcmin + $ds9 -skyview pixels 600 600 + $ds9 -skyview save yes + $ds9 -skyview frame current + $ds9 -skyview update frame + $ds9 -skyview survey sdssi + $ds9 -skyview open + $ds9 -skyview close + +
sleep
+
Delays execution for specified number of seconds. Default is 1 + second.
+ Syntax: + -sleep [#] + + Example: + $ds9 -sleep + $ds9 -sleep 2 + +
slice
+ noslice
+
+
Indicates next files loaded are to treated as slices of a cube. + Can be disabled with noslice command.
+
+ Syntax: + -slice <filename> + -noslice + + Example: + $ds9 -slice *.fits + $ds9 -noslice + +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 + Tophat diameter =2*radius+1 + Gaussian diameter =2*radius+1,mean=0 + Elliptical Gaussian diameter =2*radius+1,mean=0 +
+ Syntax: + -smooth [] +     [yes|no] +     [function boxcar|tophat|gaussian|elliptic] +     [radius <value>] +     [radiusminor <value>] +     [sigma <value>] +     [sigmaminor <value>] +     [angle <value>] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $ds9 -smooth + $ds9 -smooth yes + $ds9 -smooth function tophat + $ds9 -smooth radius 4 + $ds9 -smooth radiusminor 4 + $ds9 -smooth sigma 2.0 + $ds9 -smooth sigmaminor 2.0 + $ds9 -smooth angle 45 + $ds9 -smooth match + $ds9 -smooth lock yes + $ds9 -smooth open + $ds9 -smooth close + +
squared
+
Select squared scale function for the current frame.
+ Syntax: + -squared + + Example: + $ds9 -squared +
sqrt
+
Select square soot scale function for the current frame.
+ Syntax: + -sqrt + + Example: + $ds9 -sqrt +
source
+
Source TCL code from a file.
+ Syntax: + -source <filename> + + Example: + $ds9 -source extensions.tcl + +
tcl
+
Execute one TCL command. Note: this a different behavior from + previous versions of DS9.
+
+ Syntax: + -tcl <tcl command> + + Example: + $ds9 -tcl 'puts "Hello, World"'
+
threads
+
Set number of process threads for functions which are + multi-threaded.
+ Syntax: + -threads # + + Example: + $ds9 -threads 8
+
+ tiff
+
Load TIFF image into current frame.
+
+ Syntax: + -tiff <filename> + + Example: + $ds9 -tiff foo.tiff + $cat foo.fits | ds9 -tiff - +
tile
+
Controls the tile display mode.
+ Syntax: + -tile [] +     [yes|no] +     [mode grid|column|row] +     [grid] +     [grid mode automatic|manual] +     [grid direction x|y] +     [grid layout <col> <row>] +     [grid gap <pixels>] +     [row] +     [column] + + Example: + $ds9 -tile + $ds9 -tile yes + $ds9 -tile mode row + $ds9 -tile grid + $ds9 -tile grid mode manual + $ds9 -tile grid direction x + $ds9 -tile grid layout 5 5 + $ds9 -tile grid gap 10 + $ds9 -tile row + $ds9 -tile column +
title
+
Changes the display window title to the specified name.
+ Syntax: + -title name + + Example: + $ds9 -title Voyager +
unix
+
Set the IRAF unix socket name, used by IRAF to communicate with + DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix + socket is defined.
+ Syntax: + -unix name + + Example: + $ds9 -unix "/tmp/.IMT%d" +
unix_only
+
Only use the IRAF unix socket name. This is the same as -fifo + none -port 0.
+ Syntax: + -unix_only + + Example: + $ds9 -unix_only + +
update
+
Updates the current frame or region of frame. In the second + form, the first argument is the number of the fits HDU (starting + with 1) and the remaining args are a bounding box in IMAGE + coordinates. By default, the screen is updated the next + available idle cycle. However, you may force an immediate update + by specifying the NOW option.
+ Syntax: + -update [] +     [# x1 y1 x2 y2] +     [now] +     [now # x1 y1 x2 y2] + + Example: + $ds9 -update + $ds9 -update 1 100 100 300 400 + $ds9 -update now + $ds9 -update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+ Syntax: + -url <url> + + Example: + $ds9 -url http://foo.bar.edu/foo.fits +
version
+
Returns the current version of DS9 and exits.
+ Syntax: + -version + + Example: + $ds9 -version +
view
+
Controls the GUI and visible RGB frame color channels.
+ Syntax: + -view [layout horizontal|vertical] +     [keyvalue <string>] +     [info yes|no] +     [panner yes|no] +     [magnifier yes|no] +     [buttons yes|no] +     [colorbar yes|no] +     [graph horizontal|vertical yes|no] +     [filename yes|no] +     [object yes|no] +     [keyword yes|no] +     [minmax yes|no] +     [lowhigh yes|no] +     [units yes|no] +     [image|physical|wcs|wcsa...wcsz yes|no] +     [frame yes|no] +     [red yes|no] +     [green yes|no] +     [blue yes|no] + + Example: + $ds9 -view layout vertical + $ds9 -view keyvalue BITPIX + $ds9 -view info yes + $ds9 -view panner yes + $ds9 -view magnifier yes + $ds9 -view buttons yes + $ds9 -view colorbar yes + $ds9 -view graph horizontal yes + $ds9 -view filename yes + $ds9 -view object yes + $ds9 -view keyword yes + $ds9 -view minmax yes + $ds9 -view lowhigh yes + $ds9 -view wcsa yes + $ds9 -view frame yes + $ds9 -view red yes + $ds9 -view green yes + $ds9 -view blue yes + +
visual
+
Force DS9 to use the specified color visual. This argument MUST + be the first argument listed. Requires the visual be available.
+ Syntax: + -visual [truecolor|truecolor8|truecolor16|truecolor24] + Example: + $ds9 -visual truecolor24 + +
vla
+
Support for VLA Sky Survey.
+ Syntax: + -vla [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey first|stripe82] +     [open|close] + + Example: + $ds9 -vla + $ds9 -vla m31 + $ds9 -vla name m31 + $ds9 -vla name clear + $ds9 -vla 00:42:44.404 +41:16:08.78 + $ds9 -vla size 60 60 arcmin + $ds9 -vla save yes + $ds9 -vla frame current + $ds9 -vla update frame + $ds9 -vla survey stripe82 + $ds9 -vla open + $ds9 -vla close
+
vlss
+
Support for NRAO VLSS Sky Survey.
+ Syntax: + -vlss [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $ds9 -vlss + $ds9 -vlss m31 + $ds9 -vlss name m31 + $ds9 -vlss name clear + $ds9 -vlss 00:42:44.404 +41:16:08.78 + $ds9 -vlss size 60 60 arcmin + $ds9 -vlss save yes + $ds9 -vlss frame current + $ds9 -vlss update frame + $ds9 -vlss open + $ds9 -nvess close +
vo
+
Invoke an connection to a Virtual Observatory site.
+ Syntax: + -vo [method xpa|mime] +     [server <url>] +     [internal yes|no] +     [delay #] +     [<url>] +     [connect <url>] +     [disconnect <url>] +     [open|close] + + Example: + $ds9 -vo method xpa + $ds9 -vo server "http://foo.bar.edu/list.txt" + $ds9 -vo internal yes + $ds9 -vo delay 15 # keep-alive delay + $ds9 -vo chandra-ed + $ds9 -vo connect chandra-ed + $ds9 -vo disconnect chandra-ed + $ds9 -vo open + $ds9 -vo close + +
wcs
+
Controls the World Coordinate System for the current frame. If + the wcs system, skyframe, or skyformat is modified, the info + panel, compass, grid, and alignment will be modified + accordingly. Also, a new WCS specification can be loaded and + used by the current image regardless of the WCS that was + contained in the image file. Please see WCS + for more information.
+ Syntax: + -wcs [[system] wcs|wcsa...wcsz] +     [[sky] fk4|fk5|icrs|galactic|ecliptic] +     [[skyformat] degrees|sexagesimal] +     [align yes|no] +     [reset [#]] +     [replace [#] <filename>] +     [append [#] <filename>] +     [open|close] + + Example: + $ds9 -wcs wcs + $ds9 -wcs system wcs + $ds9 -wcs fk5 + $ds9 -wcs sky fk5 + $ds9 -wcs sexagesimal + $ds9 -wcs skyformat sexagesimal + $ds9 -wcs align yes + $ds9 -wcs reset + $ds9 -wcs reset 3 + $ds9 -wcs replace foo.wcs + $ds9 -wcs replace 3 foo.wcs + $ds9 -wcs append foo.wcs + $ds9 -wcs append 3 foo.wcs + $ds9 -wcs open + $ds9 -wcs close + +
web
+
Display specified URL in the web display.
+ Syntax: + -web [] +     [<url>] +     [new <webname> <url>] +     [<webname>] [click + back|forward|stop|reload|#] +     [<webname>] [clear] +     [<webname>] [close] + + Example: + $ds9 -web www.cnn.com + $ds9 -web new www.cnn.com + $ds9 -web hvweb www.apple.com + $ds9 -web click back + $ds9 -web click 2 + $ds9 -web clear + $ds9 -web close + +
width
+
Set the width of the image display window. Use the geometry command to set the + overall width and height of the ds9 window.
+ Syntax: + -width [<value>] + + Example: + $ds9 -width 512 + +
xpa
+
Configure XPA.
+ Syntax: + -xpa [yes|no] +     [inet|local|unix|localhost] +     [noxpans] +     [connect] +     [disconnect] +     [info] + + Example: + $ds9 -xpa no + $ds9 -xpa local + $ds9 -xpa noxpans + $ds9 -xpa connect + $ds9 -xpa disconnect + $ds9 -xpa info + +
zmax
+
Set Scale Limits based on the IRAF algorithm and + maximum data value.
+ Syntax: + -zmax + + Example: + $ds9 -zmax +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+ Syntax: + -zscale [] +     [contrast] +     [sample] +     [line] + + Example: + $ds9 -zscale + $ds9 -zscale contrast .25 + $ds9 -zscale sample 600 + $ds9 -zscale line 120 + +
zoom
+
Controls the current zoom value for the current frame.
+ Syntax: + -zoom [<value>] +     [<value> <value>] +     [to <value>] +     [to <value> <value>] +     [in] +     [out] +     [to fit] +     [open|close] + + Example: + $ds9 -zoom 2 + $ds9 -zoom 2 4 + $ds9 -zoom to 4 + $ds9 -zoom to 2 4 + $ds9 -zoom in + $ds9 -zoom out + $ds9 -zoom to fit + $ds9 -zoom open + $ds9 -zoom close + +
+ diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index dfe026a..acc6300 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -1,3226 +1,3244 @@ - - - - -SAMP - - -
SAMP
-
-
SAMP is a messaging protocol that enables astronomy software -tools to interoperate and communicate. Broadly speaking, SAMP is an -abstract framework for loosely-coupled, asynchronous, RPC-like -and/or event-based communication, based on a central service -providing multi-directional publish/subscribe message brokering. -The message semantics are extensible and use structured but -weakly-typed data. For more information on SAMP, please click -here.
-
The samp implementation for DS9 is based on the XPA model with 2 private calls:
-ds9.get -    Arguments -        cmd (string) required -        url (string) optional -    Returned value -        OK (samp.result map) -            value -(string) optional -            -    url (string) optional -        ERROR (samp.error map) -            -samp.errortxt (string) - -ds9.set -    Arguments -        cmd (string) required -        url (string) optional -    Returned value -        OK -        ERROR (samp.error map) -            -samp.errortxt (string) -
ds9.set maybe called via notification, call and -call/wait. ds9.get can only be called via call and -call/wait. Most of the ds9.get calls return a value -string, but a few will return a url instead.
-2mass -3d -about -analysis -array -background -backup -bin -blink -block -catalog -cd -cmap -colorbar -console -contour -crop -crosshair -cube -cursor -data -dsssao -dsseso -dssstsci -envi -exit -export -file -fits -frame -gif -grid -header -height -iconify -iexam -iis -jpeg -lock -lower -magnifier -mask -match -mecube -minmax -mode -mosaic -mosaicimage -movie -multiframe -nameserver -nan -nrrd -nvss -orient -pagesetup -pan -pixeltable -plot -png -precision -prefs -preserve -psprint -print -quit -raise -regions -restore -rgb -rgbarray -rgbcube -rgbimage -rotate -samp -save -saveimage -scale -shm -sia -single -skyview -sleep -smooth -source -tcl -threads -tiff -tile -update -url -version -view -vla -vlss -vo -wcs -web -width -zscale -zoom -
2mass
-
Support for 2MASS Digital Sky Survey.
-Syntax: -2mass [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey j|h|k] -    [open|close] - -Example: -string value = ds9.get(string cmd) -2mass name -2mass coord -2mass size -2mass save -2mass frame -2mass survey - -ds9.set(string cmd) -2mass -2mass m31 -2mass name m31 -2mass name clear -2mass 00:42:44.404 +41:16:08.78 -2mass size 60 60 arcmin -2mass save yes -2mass frame current -2mass update frame -2mass survey j -2mass open -2mass close -
3d
-
Support for 3D frame.
-Syntax: -3d [] -   [view <az> <el>] -   [az <az>] -   [el <el>] -   [scale <scale>] -   [method mip|aip] -   [background none|azimuth|elevation] -   [border yes|no] -   [border color <color>] -   [highlite yes|no] -   [hightlite color <color>] -   [compass yes|no] -   [compass color <color>] -   [match] -   [lock [yes|no]] -   [open|close] - -Example: -string value = ds9.get(string cmd) -3d view -3d az -3d el -3d scale -3d method -3d background -3d border -3d border color -3d highlite -3d highlite color -3d compass -3d compass color -3d lock - -ds9.set(string cmd) -3d # create new 3D frame -3d view 45 30 -3d az 45 -3d el 30 -3d scale 10 -3d method mip -3d background azimuth -3d border yes -3d border color red -3d highlite yes -3d highlite color red -3d compass yes -3d compass color red -3d match -3d lock yes -3d open -3d close -
about
-
Get DS9 credits.
-Syntax: -about - -Example: -string value = ds9.get(string cmd) -about -
align
-
Controls the World Coordinate System alignment for the current -frame.
-Syntax: -align [] -    [yes|no] - -Example: -string value = ds9.get(string cmd) -align - -ds9.set(string cmd) -align yes
-
analysis
-
Control external analysis tasks. Tasks are numbered as they are -loaded, starting with 0. Can also be used to display a message and -display text in the text dialog window.
-Syntax: -analysis [<task number>] -    [<filename>] -    [task <task number>|<task name>] -    [load <filename>] -    [clear] -    [clear][load <filename>] -    [message ok|okcancel|yesno <message>] -    [entry <message>] -    [text] - -Example: -string value = ds9.get(string cmd) -analysis -analysis task -analysis entry {Please enter something} -analysis entry okcancel {Hello World} - -ds9.set(string cmd) -analysis 0 # invoke first analysis task -analysis task 0 -analysis task foobar -analysis task {foo bar} -analysis my.ans -analysis load my.ans -analysis clear -analysis clear load my.ans -analysis message {This is a message} -analysis text {this is text} -ds9.set(string cmd, string url) -analysis load -analysis text
-
array
-
Load raw data array into current frame.
-Syntax: -array [native|little|big] -array [new|mask] + + + + + SAMP + + + SAMP + + SAMP is a messaging protocol that enables astronomy software + tools to interoperate and communicate. Broadly speaking, SAMP is + an abstract framework for loosely-coupled, asynchronous, + RPC-like and/or event-based communication, based on a central + service providing multi-directional publish/subscribe message + brokering. The message semantics are extensible and use + structured but weakly-typed data. For more information on SAMP, + please click here. + The samp implementation for DS9 is based on the XPA model with 2 private calls: + ds9.get +     Arguments +         cmd (string) required +         url (string) optional +     Returned value +         OK (samp.result map) +             value + (string) optional +             +     url (string) optional +         ERROR (samp.error map) +             + samp.errortxt (string) + + ds9.set +     Arguments +         cmd (string) required +         url (string) optional +     Returned value +         OK +         ERROR (samp.error map) +             + samp.errortxt (string) + + ds9.set maybe called via notification, call and + call/wait. ds9.get can only be called via call and + call/wait. Most of the ds9.get calls return a value + string, but a few will return a url instead. + 2mass + 3d + about + analysis + array + background + backup + bin + blink + block + catalog + cd + cmap + colorbar + console + contour + crop + crosshair + cube + cursor + data + dsssao + dsseso + dssstsci + envi + exit + export + file + fits + frame + gif + grid + header + height + iconify + iexam + iis + jpeg + lock + lower + magnifier + mask + match + mecube + minmax + mode + mosaic + mosaicimage + movie + multiframe + nameserver + nan + nrrd + nvss + orient + pagesetup + pan + pixeltable + plot + png + precision + prefs + preserve + psprint + print + quit + raise + regions + restore + rgb + rgbarray + rgbcube + rgbimage + rotate + samp + save + saveimage + scale + shm + sia + single + skyview + sleep + smooth + source + tcl + threads + tiff + tile + update + url + version + view + vla + vlss + vo + wcs + web + width + zscale + zoom + + 2mass + Support for 2MASS Digital Sky Survey. + Syntax: + 2mass [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey j|h|k] +     [open|close] + + Example: + string value = ds9.get(string cmd) + 2mass name + 2mass coord + 2mass size + 2mass save + 2mass frame + 2mass survey + + ds9.set(string cmd) + 2mass + 2mass m31 + 2mass name m31 + 2mass name clear + 2mass 00:42:44.404 +41:16:08.78 + 2mass size 60 60 arcmin + 2mass save yes + 2mass frame current + 2mass update frame + 2mass survey j + 2mass open + 2mass close + + 3d + Support for 3D frame. + Syntax: + 3d [] +    [view <az> <el>] +    [az <az>] +    [el <el>] +    [scale <scale>] +    [method mip|aip] +    [background none|azimuth|elevation] +    [border yes|no] +    [border color <color>] +    [highlite yes|no] +    [hightlite color <color>] +    [compass yes|no] +    [compass color <color>] +    [match] +    [lock [yes|no]] +    [open|close] + + Example: + string value = ds9.get(string cmd) + 3d view + 3d az + 3d el + 3d scale + 3d method + 3d background + 3d border + 3d border color + 3d highlite + 3d highlite color + 3d compass + 3d compass color + 3d lock + + ds9.set(string cmd) + 3d # create new 3D frame + 3d view 45 30 + 3d az 45 + 3d el 30 + 3d scale 10 + 3d method mip + 3d background azimuth + 3d border yes + 3d border color red + 3d highlite yes + 3d highlite color red + 3d compass yes + 3d compass color red + 3d match + 3d lock yes + 3d open + 3d close + + about + Get DS9 credits. + Syntax: + about + + Example: + string value = ds9.get(string cmd) + about + + align + Controls the World Coordinate System alignment for the current + frame. + Syntax: + align [] +     [yes|no] + + Example: + string value = ds9.get(string cmd) + align + + ds9.set(string cmd) + align yes + analysis + Control external analysis tasks. Tasks are numbered as they are + loaded, starting with 0. Can also be used to display a message + and display text in the text dialog window. + Syntax: + analysis [<task number>] +     [<filename>] +     [task <task number>|<task name>] +     [load <filename>] +     [clear] +     [clear][load <filename>] +     [message ok|okcancel|yesno <message>] +     [entry <message>] +     [text] + + Example: + string value = ds9.get(string cmd) + analysis + analysis task + analysis entry {Please enter something} + analysis entry okcancel {Hello World} + + ds9.set(string cmd) + analysis 0 # invoke first analysis task + analysis task 0 + analysis task foobar + analysis task {foo bar} + analysis my.ans + analysis load my.ans + analysis clear + analysis clear load my.ans + analysis message {This is a message} + analysis text {this is text} + + ds9.set(string cmd, string url) + analysis load + analysis text + + array + Load raw data array into current frame. + + Syntax: + array [native|little|big] + array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -string url = ds9.get(string cmd) -array -array little - -ds9.set(string command, string url) -array foo.arr[dim=512,bitpix=-32,endian=little] -array new foo.arr[dim=512,bitpix=-32,endian=little] -array mask foo.arr[dim=512,bitpix=-32,endian=little] -bg -background -Set image background color. -Syntax: -bg <color> - -Example: -string url = ds9.get(string cmd) -bg - -ds9.set(string cmd) -bg red -bg red -backup -Create a backup save set. -Syntax: -backup <filename> - -Example: -ds9.set(string cmd) -backup ds9.bck -bin -Controls binning factor, binning buffer size, and binning -function for binning FITS bin tables. The access point blocking is -provided for backward compatibility. -Syntax: -bin [about <x> <y>] -    [about center] -    [buffersize <value>] -    [cols <x> <y>] -    [colsz <x> <y> <z>] -    [factor <value> [<vector>]] -    [depth <value>] -    [filter <string>] -    [filter clear] -    [function average|sum] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -bin about -bin buffersize -bin cols -bin factor -bin depth -bin filter -bin function -bin smooth -bin smooth function -bin smooth radius -bin lock - -ds9.set(string cmd) -bin about 4096 4096 -bin about center -bin buffersize 512 -bin cols detx dety -bin colsz detx dety time -bin factor 4 -bin factor 4 2 -bin depth 10 -bin filter 'pha > 5' -bin filter clear -bin function sum -bin in -bin out -bin to fit -bin match -bin lock yes -bin open -bin close -blink -Blink mode parameters. Interval is in seconds. -Syntax: -blink [] -    [yes|no] -    [interval <value>] - -Example: -string value = ds9.get(string cmd) -blink -blink interval - -ds9.set(string cmd) -blink -blink yes -blink interval 1 -block -Controls blocking parameters. -Syntax: -block[<value>] -    [<value> <value>] -    [to <value>] -    [to <value> <value>] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -block -block lock - -ds9.set(string cmd) -block4 -block4 2 -blockto 4 -blockto 4 2 -blockin -blockout -blockto fit -blockmatch -blocklock yes -blockopen -blockclose -catalog -cat -Support for catalogs. The first three commands will create a new -catalog search. All other commands operated on the last search -created, unless indicated otherwise. -Syntax: -catalog [new] -    [ned|simbad|denis|skybot] -    + + Example: + string url = ds9.get(string cmd) + array + array little + + ds9.set(string command, string url) + array foo.arr[dim=512,bitpix=-32,endian=little] + array new foo.arr[dim=512,bitpix=-32,endian=little] + array mask foo.arr[dim=512,bitpix=-32,endian=little] + + bg + background + Set image background color. + Syntax: + bg <color> + + Example: + string url = ds9.get(string cmd) + bg + + ds9.set(string cmd) + bg red + backup + Create a backup save set. + Syntax: + backup <filename> + + Example: + ds9.set(string cmd) + backup ds9.bck + bin + Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables. The access point blocking + is provided for backward compatibility. + Syntax: + bin [about <x> <y>] +     [about center] +     [buffersize <value>] +     [cols <x> <y>] +     [colsz <x> <y> <z>] +     [factor <value> [<vector>]] +     [depth <value>] +     [filter <string>] +     [filter clear] +     [function average|sum] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + bin about + bin buffersize + bin cols + bin factor + bin depth + bin filter + bin function + bin smooth + bin smooth function + bin smooth radius + bin lock + + ds9.set(string cmd) + bin about 4096 4096 + bin about center + bin buffersize 512 + bin cols detx dety + bin colsz detx dety time + bin factor 4 + bin factor 4 2 + bin depth 10 + bin filter 'pha > 5' + bin filter clear + bin function sum + bin in + bin out + bin to fit + bin match + bin lock yes + bin open + bin close + + blink + Blink mode parameters. Interval is in seconds. + + Syntax: + blink [] +     [yes|no] +     [interval <value>] + + Example: + string value = ds9.get(string cmd) + blink + blink interval + + ds9.set(string cmd) + blink + blink yes + blink interval 1 + block + Controls blocking parameters. + Syntax: + block[<value>] +     [<value> <value>] +     [to <value>] +     [to <value> <value>] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + block + block lock + + ds9.set(string cmd) + block4 + block4 2 + blockto 4 + blockto 4 2 + blockin + blockout + blockto fit + blockmatch + blocklock yes + blockopen + blockclose + + catalog + cat + + Support for catalogs. The first three commands will create a + new catalog search. All other commands operated on the last + search created, unless indicated otherwise. + Syntax: + catalog [new] +     [ned|simbad|denis|skybot] +     [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] - -    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -    [2mass|iras] -    [csc|xmm|rosat] -    [first|nvss] -    [chandralog|cfhtlog|esolog|stlog|xmmlog] -    [cds <catalogname>] -    [cds <catalogid>] - -    [load <filename>] -    [import sb|tsv <filename>] - -    [<ref>] [<ra> <dec> -<coordsys>] -    [<ref>] [allcols] -    [<ref>] [allrows] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [crosshair] -    [<ref>] [dec <col>] -    [<ref>] [edit yes|no] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [filter <string>] -    [<ref>] [filter load <filename>] -    [<ref>] [header] -    [<ref>] [location <code>] -    [<ref>] [match] -    [<ref>] [match <ref> -<ref>] -    [<ref>] [match error <value> -degrees|arcmin|arcsec] -    [<ref>] [match function -1and2|1not2|2not1] -    [<ref>] [match return -1and2|1only|2only] -    [<ref>] [match unique yes|no] -    [<ref>] [maxrows <number>] -    [<ref>] [name <object>] -    [<ref>] [panto yes|no] -    [<ref>] [plot <xcol> <ycol> -<xerrcol> <yerrcol>] -    [<ref>] [print] -    [<ref>] [psky <skyframe>] -    [<ref>] [psystem <coordsys>] -    [<ref>] [ra <col>] -    [<ref>] [regions] -    [<ref>] [retrieve] -    [<ref>] [samp] -    [<ref>] [samp broadcast] -    [<ref>] [samp send -<application>] -    [<ref>] [save <filename>] -    [<ref>] -[servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -    [<ref>] [show yes|no] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [sort <col> incr|decr] -    [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>] -    [<ref>] [symbol [#] -text|size|size2|units|angle <value>] -    [<ref>] [symbol shape -circle|ellipse|box|text|point] -    [<ref>] [symbol shapecircle point|box -point|diamond point|cross point|x point|arrow point|boxcircle -point] -    [<ref>] [symbol add| [#] remove] -    [<ref>] [symbol save|load -<filename>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] -    [<ref>] [x <col>] -    [<ref>] [y <col>] - -Example: -string value = ds9.get(string cmd) -catalog -catalog header - -ds9.set(string cmd) -catalog new -catalog 2mass -catalog cds 2mass -catalog cds{I/252} - -catalog load foo.xml -catalog import tsv foo.tsv - -catalog allrows -catalog allcols -catalog cancel -catalog clear -catalog close -catalog coordinate 202.48 47.21 fk5 -catalog crosshair -catalog dec DEC -catalog edit yes -catalog export tsv bar.tsv -catalog filter {$Jmag>10} -catalog filter load foo.flt -catalog header -catalog location 500 -catalog match error 2 arcsec -catalog match function 1and2 -catalog match unique no -catalog match return 1only -catalog match # last two catalogs loaded -catalog match 2mass csc -catalog maxrows 2000 -catalog name m51 -catalog panto no -catalog plot{$Jmag} {$Hmag} {$e_Jmag} {$e_Hmag} -catalog print -catalog psky fk5 -catalog psystem wcs -catalog ra RA -catalog regions -catalog retrieve -catalog samp broadcast -catalog samp send aladin -catalog save foo.xml -catalog server sao -catalog show yes -catalog radius 1 degrees -catalog symbol condition{$Jmag>15} -catalog symbol 2 shape{boxcircle point} -catalog symbol color red -catalog symbol font times -catalog symbol fontsize 14 -catalog symbol fontweight bold -catalog symbol fontslant italic -catalog symbol add -catalog symbol 2 remove -catalog symbol load foo.sym -catalog symbol save bar.sym -catalog sky fk5 -catalog skyformat degrees -catalog sort {Jmag} incr -catalog system wcs -catalog update -catalog x RA -catalog y DEC -cd -Sets/Returns the current working directory. -Syntax: -cd [<directory>] - -Example: -string value = ds9.get(string cmd) -cd - -ds9.set(string cmd) -cd /home/mrbill -cmap -Controls the colormap for the current frame. The colormap name -is not case sensitive. A valid contrast value is from 0 to 10 -and bias value from 0 to 1. -Syntax: -cmap [<colormap>] -    [file] -    [load <filename>] -    [save <filename>] -    [invert yes|no] -    [<constrast> <bias>] -    [tag [load|save] <filename>] -    [tag delete] -    [open|close] - -Example: -string value = ds9.get(string cmd) -cmap -cmap file -cmap invert -cmap value -cmap lock - -ds9.set(string cmd) -cmap Heat -cmap load foo.sao -cmap save bar.sao -cmap invert yes -cmap 5 .5 -cmap tag load foo.tag -cmap tag save foo.tag -cmap tag delete -cmap open -cmap close -colorbar -Controls colorbar parameters. -Syntax: -colorbar [] -    [yes|no] -    [orientation] -    [horizontal|vertical] -    [numerics yes|no] -    [space value|distance] -    [font times|helvetica|courier] -    [fontsize <value>] -    [fontweight normal|bold] -    [fontslant roman|italic] -    [size] -    [ticks] -    [match] -    [lock [yes|no]] - -Example: -string value = ds9.get(string cmd) -colorbar -colorbar orientation -colorbar numerics -colorbar space -colorbar font -colorbar fontsize -colorbar fontweight -colorbar fontslant -colorbar size -colorbar ticks - -ds9.set(string cmd) -colorbar yes -colorbar vertical -colorbar numerics yes -colorbar space value -colorbar font times -colorbar fontsize 14 -colorbar fontwieght bold -colorbar fontslant italic -colorbar size 20 -colorbar ticks 11 -colorbar match -colorbar lock yes -console -Display tcl console window. -Syntax: --console - -Example: -ds9.set(string cmd) -console -contour -Controls contours in the current frame. -Syntax: -contour [] -    [yes|no] -    [<coordsys> [<skyframe>]] -    [clear] -    [generate] -    [load <filename>] -    [save <filename> [<coordsys> -<skyframe>]] -    [convert] -    [load levels <filename>] -    [save levels <filename>] -    [copy] -    [paste [<coordsys> <color> -<width> yes|no]] -    [color <color>] -    [width <width>] -    [dash yes|no] -    [smooth <smooth>] -    [method block|smooth] -    [nlevels <number of levels>] -    [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ] -    [scale log exp <value>] -    [mode minmax|<value>|zscale|zmax] -    [scope global|local] -    [limits <min> <max>] -    [levels <value value value...>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -contour -contour color -contour width -contour dash -contour smooth -contour method -contour nlevels -contour scale -contour log exp -contour mode -contour scope -contour limits -contour levels -string url = ds9.get(string cmd) -contour wcs fk5 - -ds9.set(string cmd) -contour -contour yes -contour clear -contour generate -contour load ds9.ctr -contour save ds9.con -contour save ds9.con wcs fk5 -contour convert -contour load levels ds9.ctr -contour save levels ds9.lev -contour copy -contour paste -contour paste wcs red 2 no -contour color yellow -contour width 2 -contour dash yes -contour smooth 5 -contour method smooth -contour nlevels 10 -contour scale sqrt -contour log exp 1000 -contour mode zscale -contour scope local -contour limits 1 100 -contour levels 1 10 100 1000 -contour open -contour close -crop -Set current image display area. -Syntax: -crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec] -    [match <coordsys>] -    [lock <coordsys>|none] -    [reset] -    [3dzmin zmax <coordsys>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -crop # get crop in physical coords -crop wcs galactic sexagesimal arcsec -crop lock - -ds9.set(string cmd) -crop 40 30 10 20 # set crop in physical coords -crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs -galactic arcsec -crop match wcs -crop lock wcs -crop reset -crop 3d .25 .5 wcs -crop open -crop close -crosshair -Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set. -Syntax: -crosshair [<x> <y> <coordsys> -[<skyframe>]] -    [match <coordsys>] -    [lock <coordsys>|none] - -Example: -string value = ds9.get(string cmd) -crosshair # get crosshair in physical coords -crosshair wcs fk4 sexagesimal # get crosshair in wcs coords -crosshair lock - -ds9.set(string cmd) -crosshair 100 100 physical # set crosshair in physical -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords -crosshair 23:01:00 +58:52:51 wcs fk5 -crosshair match wcs -crosshair lock wcs -cube -Controls FITS cube. -Syntax: -cube [] -    [play|stop|next|prev|first|last] -    [<slice> [<coordsys>]] -    [interval <numeric>] -    [match <coordsys>] -    [lock <coordsys>|none] -    [order 123|132|213|231|312|321] -    [axes lock [yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -cube -cube wcs -cube interval -cube lock -cube order -cube axes lock - -ds9.set(string cmd) -cube -cube play -cube last -cube 3 -cube 4.5 wcs -cube interval 2 -cube match wcs -cube lock wcs -cube order 123 -cube axes lock yes -cube open -cube close -cursor -Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also. -Syntax: -cursor [<x> <y>] - -Example: -ds9.set(string cmd) -cursor 10 10 -data -Return an array of data values given a lower left corner and a -width and height in specified coordinate system. The last argument -of yes indicates to strip the coordinates from the output and just -list the data values. The default is yes. -Syntax: -data [<coordsys> [<skyframe>] <x> <y> -<width> <height> [yes|no]] - -Example: -string url = ds9.get(string cmd) -data image 450 520 3 3 yes -data physical 899 1039 6 6 no -data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no -data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 -no -dsssao -dss -Support for Digital Sky Survey at SAO. -Syntax: -dsssao [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -string value = ds9.get(string cmd) -dsssao name -dsssao coord -dsssao size -dsssao save -dsssao frame - -ds9.set(string cmd) -dsssao -dsssao m31 -dsssao name m31 -dsssao name clear -dsssao 00:42:44.404 +41:16:08.78 -dsssao size 60 60 arcmin -dsssao save yes -dsssao frame current -dsssao update frame -dsssao open -dsssao close -dsseso -Support for Digital Sky Survey at ESO. -Syntax: -dsseso [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -    [open|close] - -Example: -string value = ds9.get(string cmd) -dsseso name -dsseso coord -dsseso size -dsseso save -dsseso frame -dsseso survey - -ds9.set(string cmd) -dsseso -dsseso m31 -dsseso name m31 -dsseso name clear -dsseso 00:42:44.404 +41:16:08.78 -dsseso size 60 60 arcmin -dsseso save yes -dsseso frame current -dsseso update frame -dsseso survey DSS2-red -dsseso open -dsseso close -dssstsci -Support for Digital Sky Survey at STSCI. -Syntax: -dssstsci [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -    [survey poss1_blue|poss1_red] -    [survey all|quickv|phase2_gsc2|phase2_gsc1] -    [open|close] - -Example: -string value = ds9.get(string cmd) -dssstsci name -dssstsci coord -dssstsci size -dssstsci save -dssstsci frame -dssstsci survey - -ds9.set(string cmd) -dssstsci -dssstsci m31 -dssstsci name m31 -dssstsci name clear -dssstsci 00:42:44.404 +41:16:08.78 -dssstsci size 60 60 arcmin -dssstsci save yes -dssstsci frame current -dssstsci update frame -dssstsci survey all -dssstsci open -dssstsci close -envi -Load an ENVI header and file. Optional parameter: array -endian. -Syntax: -envi [new] <header> [<filename>] - -Example: -ds9.set(string cmd) -envi foo.hdr -envi new foo.hdr envi foo.hdr foo.bsq - -exit -quit -Quits DS9. -Syntax: -exit -quit - -Example: -ds9.set(string cmd) -exit -export -Export loaded image data of current frame in specified image -format. Optional parameters: array endian, nrrd endian, jpeg -quality (1-100) and tiff compression method. -Syntax: -export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> -export array <filename>[big|little|native] -export nrrd <filename>[big|little|native] -export envi <header> -[<filename>][big|little|native] -export jpeg <filename>[1-100] -export tiff <filename>[none|jpeg|packbits|deflate] - -Example: - -ds9.set (string cmd) -export array foo.arr little -export nrrd foo.nrrd little -export envi foo.hdr little -export envi foo.hdr foo.bsq little -export tiff foo.tiff jpeg -export jpeg foo.jpeg 75 -export png foo.png -file -Query currently loaded file information. -Syntax: -file - -Example: -string value = ds9.get(string cmd) -file -fits -Load a FITS image into the current frame or query the currently -loaded image. -Syntax: -fits[new|mask|slice] [<filename>] -    [width|height|depth|bitpix|type] -    [size [wcs|wcsa...wcsz] -[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -    [header [<ext>] [keyword -<string>]] -    [image|table|slice] - -Example: -string value = ds9.get(string cmd) -fits -fits width -fits height -fits depth -fits bitpix -fits type -fits size -fits size wcs fk5 arcmin -fits header # primary -fits header 2 # hdu 2 -fits header -2 # hdu 2 with inherit -fits header keyword BITPIX -fits header 1 keyword BITPIX -fits image -fits table -fits slice - -ds9.set(string cmd, string url) -fits foo.fits -fits new foo.fits -fits bar.fits[bin=detx,dety] -fits slice foo.fits -fits mask foo.fits - frame -Controls frame functions. Frames may be created, deleted, reset, -and centered. While return the current frame number. If you goto a -frame that does not exists, it will be created. If the frame is -hidden, it will be shown. The 'frameno' option is available for -backward compatibility. -Syntax: -frame [center [#|all]] -    [clear [#|all]] -    [new [rgb|3d]] -    [delete [#|all]] -    [reset [#|all]] -    [refresh [#|all]] -    [hide [#|all]] -    [show [#|all]] -    [move first] -    [move back] -    [move forward] -    [move last] -    [first] -    [prev] -    [next] -    [last] -    [frameno #] -    [#] -    [match <coordsys>] -    [lock <coordsys>|none] -    [has -[amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] - -    [has contour [aux]]] -    [has fits [ |bin|cube|mosaic]] -    [has marker [highlite|paste|select|undo]] -    [has system <coordsys>] -    [has wcs [<wcssys>]] -    [has wcs celestial [<wcssys>]] -    [has wcs linear [<wcssys>]] - -Example: -string value = ds9.get(string cmd) -frame # returns the id of the current frame -frame frameno # returns the id of the current frame -frame all # returns the id of all frames -frame active # returns the id of all active frames -frame lock -frame has amplifier -frame has datamin -frame has datasec -frame has detector -frame has grid -frame has iis -frame has irafmin -frame has physical -frame has smooth -frame has contour -frame has contour aux -frame has fits -frame has fits bin -frame has fits cube -frame has fits mosaic -frame has marker highlite -frame has marker paste -frame has marker select -frame has marker undo -frame has system physical -frame has wcs wcsa -frame has wcs celestial wcsa -frame has wcs linear wcsa - -ds9.set(string cmd) -frame center # center current frame -frame center 1 # center 'Frame1' -frame center all # center all frames -frame clear # clear current frame -frame new # create new frame -frame new rgb # create new rgb frame -frame delete # delete current frame -frame reset # reset current frame -frame refresh # refresh current frame -frame hide # hide current frame -frame show 1 # show frame 'Frame1' -frame move first # move frame to first in order -frame move back # move frame back in order -frame move forward # move frame forward in order -frame move last # move frame to last in order -frame first # goto first frame -frame prev # goto prev frame -frame next # goto next frame -frame last # goto last frame -frame frameno 4 # goto frame 'Frame4', create if needed -frame 3 # goto frame 'Frame3', create if needed -frame match wcs -frame lock wcs -gif -Load GIF image into current frame. -Syntax: -gif [new|slice] [<filename>] - -Example: -string value = ds9.get(string cmd) -gif -gifnew -gifslice - -ds9.set(string cmd) -gif foo.gif -gif new foo.gif -gif slice foo.gif -grid -Controls coordinate grid. For grid numeric format syntax, -click here. -Syntax: -grid [] -    [yes|no] -    [type analysis|publication] -    [system <coordsys>] -    [sky <skyframe>] -    [skyformat <skyformat>] -    [grid yes|no] -    [grid color <color>] -    [grid width <value>] -    [grid dash yes|no] -    [grid gap1 <value>] -    [grid gap2 <value>] -    [grid gap3 <value>] -    [axes yes|no] -    [axes color <color>] -    [axes width <value>] -    [axes dash yes|no] -    [axes type interior|exterior] -    [axes origin -lll|llu|lul|luu|ull|ulu|uul|uuu] -    [format1 <format>] -    [format2 <format>] -    [tickmarks yes|no] -    [tickmarks color <color>] -    [tickmarks width <value>] -    [tickmarks dash yes|no] -    [border yes|no] -    [border color <color>] -    [border width <value>] -    [border dash yes|no] -    [numerics yes|no] -    [numerics font times|helvetica|courier] -    [numerics fontsize <value>] -    [numerics fontweight normal|bold] -    [numerics fontslant roman|italic] -    [numerics color <color>] -    [numerics gap1 <value>] -    [numerics gap2 <value>] -    [numerics gap3 <value>] -    [numerics type interior|exterior] -    [numerics vertical yes|no] -    [title yes|no] -    [title text <text>] -    [title def yes|no] -    [title gap <value>] -    [title font times|helvetica|courier] -    [title fontsize <value>] -    [title fontweight normal|bold] -    [title fontslant roman|italic] -    [title color <color>] -    [labels yes|no] -    [labels text1 <text>] -    [labels text2 <text>] -    [labels def1 yes|no] -    [labels def2 yes|no] -    [labels gap1 <value>] -    [labels gap2 <value>] -    [labels font times|helvetica|courier] -    [labels fontsize <value>] -    [labels fontweight normal|bold] -    [labels fontslant roman|italic] -    [labels color <color>] -    [reset] -    [load <filename>] -    [save <filename>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -grid -grid type -grid system -grid sky -grid skyformat -grid grid -grid grid color -grid grid width -grid grid dash -grid grid gap1 -grid grid gap2 -grid grid gap3 -grid axes -grid axes color -grid axes width -grid axes dash -grid axes type -grid axes origin -grid format1 -grid format2 -grid tickmarks -grid tickmarks color -grid tickmarks width -grid tickmarks dash -grid border -grid border color -grid border width -grid border dash -grid numerics -grid numerics font -grid numerics fontsize -grid numerics fontweight -grid numerics fontslant -grid numerics color -grid numerics gap1 -grid numerics gap2 -grid numerics gap3 -grid numerics type -grid numerics vertical -grid title -grid title text -grid title def -grid title gap -grid title font -grid title fontsize -grid title fontweight -grid title fontslant -grid title color -grid labels -grid labels text1 -grid labels text2 -grid labels def1 -grid labels def2 -grid labels gap1 -grid labels gap2 -grid labels font -grid labels fontsize -grid labels fontweight -grid labels fontslant -grid labels color - -ds9.set(string cmd) -grid -grid yes -grid type analysis -grid system wcs -grid sky fk5 -grid skyformat degrees -grid grid yes -grid grid color red -grid grid width 2 -grid grid dash yes -grid grid gap1 10 -grid grid gap2 10 -grid grid gap3 10 -grid axes yes -grid axes color red -grid axes width 2 -grid axes dash yes -grid axes type exterior -grid axes origin lll -grid format1 d.2 -grid format2 d.2 -grid tickmarks yes -grid tickmarks color red -grid tickmarks width 2 -grid tickmarks dash yes -grid border yes -grid border color red -grid border width 2 -grid border dash yes -grid numerics yes -grid numerics font courier -grid numerics fontsize 12 -grid numerics fontweight bold -grid numerics fontslant italic -grid numerics color red -grid numerics gap1 10 -grid numerics gap2 10 -grid numerics gap3 10 -grid numerics type exterior -grid numerics vertical yes -grid title yes -grid title text {Hello World} -grid title def yes -grid title gap 10 -grid title fontsize 12 -grid title font courier -grid title fontweight bold -grid title fontslant italic -grid title color red -grid labels yes -grid labels text1 {Hello World} -grid labels text2 {Hello World} -grid labels def1 yes -grid labels def2 yes -grid labels gap1 10 -grid labels gap2 10 -grid labels font courier -grid labels fontsize 12 -grid labels fontweight bold -grid labels fontslant italic -grid labels color red -grid reset -grid load foo.grd -grid save foo.grd -grid open -grid close -header -Display current fits header dialog. Optional extension number -maybe specified. Please note, this differs from samp fits -header. -Syntax: -header [<ext>] -    [close [<ext>]] -    [save [<ext>] <filename>] - -Example: -string value = ds9.get(string cmd) -header -header 2 -header close -height -Set the height of the image display window. -Syntax: -height [<value>] - -Example: -string value = ds9.get(string cmd) -height -ds9.set(string cmd) -height 512 -iconify -Toggles iconification. -Syntax: -iconify [] -    [yes|no] - -Example: -string value = ds9.get(string cmd) -iconify - -ds9.set(string cmd) -iconify -iconify yes -iexam -Interactive examine function. A blinking cursor will indicate to -the user to click on a point on an image. The specified information -will be returned at that time. The default event is -button. In the last form, the following macros will be -expanded if present: $width, $height, $depth, $bitpix, -$filename, $regions, $filename[$regions], $env, $pan, $value, $x, -$y, $z. See Analysis -Macros for more information. -Syntax: -iexam [] -    [[]|button|key|any] coordinate <coordsys> -[<skyframe>] [<skyformat>] -    [[]|button|key|any] data [width][height] -    [[]|button|key|any] <macro string>] - -Example: -string value = ds9.get(string cmd) -iexam -iexam coordinate image -iexam key coordinate image # return coordinate and key event -iexam coordinate wcs fk5 degrees -iexam coordinate wcs galactic sexagesimal -iexam coordinate fk5 -iexam data # return data value -iexam key data # return data value and key event -iexam data 3 3 # return all data in 3x3 box about selected -point -iexam {'Click at $x,$y in file $filename'} -iis -Set/Get IIS Filename. Optional mosaic number maybe supplied. -Syntax: -iis [filename <filename> [#]] - -Example: -string value = ds9.get(string cmd) -iis filename -iis filename 4 - -ds9.set(string cmd) -iis filename foo.fits -iis filename bar.fits 4 -jpeg -Load JPEG image into current frame. Optional parameters: -jpeg quality (1-100) -Syntax: -jpeg [new|slice] [<filename>] [1-100] - -Example: -string value = ds9.get(string cmd) -jpeg -jpegnew -jpegslice - -ds9.set(string cmd) -jpeg foo.jpeg -jpeg new foo.jpeg -jpeg slice foo.jpeg -lock -Lock all other frames to the current frame. -Syntax: -lock[frame <coordsys>|none] -    [crosshair <coordsys>|none] -    [crop <coordsys>|none] -    [slice <coordsys>|none] -    [bin [yes|no]] -    [axes [yes|no]] -    [scale [yes|no]] -    [scalelimits [yes|no]] -    [colorbar [yes|no]] -    [block [yes|no]] -    [smooth [yes|no]] -    [3d [yes|no]] - -Example: -string value = ds9.get(string cmd) -lock frame -lock crosshair -lock crop -lock slice -lock bin -lock axes -lock scale -lock scalelimits -lock colorbar -lock block -lock smooth -lock 3d - -ds9.set(string cmd) -lock frame wcs -lock crosshair wcs -lock crop wcs -lock slice wcs -lock bin yes -lock axes yes -lock scale yes -lock scalelimits yes -lock colorbar yes -lock block yes -lock smooth yes -lock 3d yes - lower -Lower in the window stacking order. -Syntax: -lower - -Example: -ds9.set(string cmd) -lower -magnifier -Controls the magnifier settings. -Syntax: -magnifier [color <color>] -    [zoom <value>] -    [cursor yes|no] -    [region yes|no] - -Example: -string value = ds9.get(string cmd) -magnifier color -magnifier zoom -magnifier cursor -magnifier region -ds9.set(string cmd) -magnifier color yellow -magnifier zoom 2 -magnifier cursor no -magnifier region no -mask -Controls mask parameters. -Syntax: -mask [color <color>] -    [mark zero|nonzero|nan|nonnan|range] -    [range <low> <high>] -    [transparency <value>] -    [system <coordsys>] -    [clear] -    [open|close] - -Example: -string value = ds9.get(string cmd) -mask color -mask mark -mask range -mask system -mask transparency - -ds9.set(string cmd) -mask color red -mask mark zero -mask range 10 100 -mask transparency 50 -mask system wcs -mask clear -mask open -mask close -match -Match all other frames to the current frame. -Syntax: -match[frame <coordsys>] -    [crosshair <coordsys>] -    [crop <coordsys>] -    [slice <coordsys>] -    [bin] -    [axes] -    [scale] -    [scalelimits] -    [colorbar] -    [block] -    [smooth] -    [3d] - -Example: -ds9.set(string cmd) -match frame wcs -match crosshair wcs -match crop wcs -match slice wcs -match bin -match axes -match scale -match scalelimits -match colorbar -match block -match smooth -match 3d -mecube -Load FITS multiple extension file as data cube. -Syntax: -mecube [new] [<filename>] - -Example: -string value = ds9.get(string cmd) -mecube - -ds9.set(string cmd) -mecube foo.fits -mecube new foo.fits -mecube -mecubenew -minmax -This is how DS9 determines the min and max data values -from the data. SCAN will scan all data. -Syntax: -minmax [scan|sample|datamin|irafmin] -    [mode scan|sample|datamin|irafmin] -    [interval #] - -Example: -string value = ds9.get(string cmd) -minmax mode -minmax sample - -ds9.set(string cmd) -minmax scan -minmax mode scan -minmax interval 100 -mode -Controls the first mouse button mode. -Syntax: -mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - -Example: -string value = ds9.get(string cmd) -mode - -ds9.set(string cmd) -mode crosshair -mosaic -Load FITS mosaic segment into current frame. -Syntax: -mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] - -Example: -string value = ds9.get(string cmd) -mosaic - -ds9.set(string cmd) -mosaic foo.fits -mosaic wcs foo.fits -mosaic wcs new foo.fits -mosaic wcs mask foo.fits -mosaic -mosaic wcs -mosaic wcsnew -mosaic wcsmask -mosaicimage -Load FITS mosaic image into current frame. -Syntax: -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] -[<filename>] - -Example: -string value = ds9.get(string cmd) -mosaicimage -ds9.set(string cmd) -mosaicimage foo.fits -mosaicimage wcs foo.fits -mosaicimage wcs new foo.fits -mosaicimage wcs mask foo.fits -mosaicimage -mosaicimage wcs -mosaicimage wcs new -mosaicimage wcs mask -movie -Create a movie from snap shots of the DS9 window. A -slice movie cycles though all slices of a cube. A -frame movie cycles through all active frames. A -3d movie cycles through specified viewing angles. The -default action is slice. Movie types are either -MPEG or Animated GIF, with default MPEG. -Optional parameters for 3d: number of frames, azimuth -from/to, elevation from/to, slice from/to, oscillate/repeat -times. -Syntax: -movie[slice|frame|3d][mpeg|gif] <filename> -movie 3d [mpeg|gif] <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>] - -Example: -ds9.set(string cmd) -movie slice mpeg ds9.mpg -movie frame gif ds9.gif -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate -1 -multiframe -Load FITS multiple extension file as multiple images. -Syntax: -multiframe [<filename>] - -Example: -ds9.set(string cmd) -multiframe foo.fits -multiframe -nameserver -Support Name Server functions. Coordinates are in fk5. -Syntax: -nameserver [<object>] -    [name <object>] -    [server -ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] -    [skyformat degrees|sexagesimal] -    [pan] -    [crosshair] -    [close] - -Example: -string value = ds9.get(string cmd) -nameserver -nameserver server -nameserver skyformat -nameserver m31 - -ds9.set(string cmd) -nameserver m31 -nameserver name m31 -nameserver server ned-sao -nameserver skyformat sexagesimal -nameserver pan -nameserver crosshair -nameserver open -nameserver close -nan -Set image not-a-number color. -Syntax: -nan <color> - -Example: -string value = ds9.get(string cmd) -nan -ds9.set(string cmd) -nan red -nrrd -Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: -array endian. -Syntax: -nrrd [native|little|big] -nrrd [new|mask] [<filename>] - -Example: -string value = ds9.get(string cmd) -nrrd -nrrd big - -ds9.set(string cmd, string url) -nrrd foo.nrrd -nrrd new foo.nrrd -nrrd mask foo.nrrd -nrrd -nrrdnew -nrrd mask -nvss -Support for NRAO VLA Sky Survey. -Syntax: -nvss [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -string value = ds9.get(string cmd) -nvss name -nvss coord -nvss size -nvss save -nvss frame - -ds9.set(string cmd) -nvss -nvss m31 -nvss name m31 -nvss name clear -nvss 00:42:44.404 +41:16:08.78 -nvss size 60 60 arcmin -nvss save yes -nvss frame current -nvss update frame -nvss open -nvss close -orient -Controls the orientation of the current frame. -Syntax: -orient [none|x|y|xy] -    [open|close] - -Example: -string value = ds9.get(string cmd) -orient - -ds9.set(string cmd) -orient xy -orient open -orient close -pagesetup -Controls Page Setup options. -Syntax: -pagesetup [orient portrait|landscape] -    [scale <numeric>] -    [size letter|legal|tabloid|poster|a4] - -Example: -string value = ds9.get(string cmd) -pagesetup orient -pagesetup scale -pagesetup size - -ds9.set(string cmd) -pagesetup orient portrait -pagesetup scale 50 -pagesetup size poster -pan -Controls the current image cursor location for the current -frame. -Syntax: -pan [<coordsys> [<skyframe>] [<skyformat>]] # get -current coords - -pan [<x> <y> <coordsys> [<skyframe>]] # -relative -    [to <x> <y> <coordsys> -[<skyframe>]] # absolute -    [open|close] -    [close] - -Example: -string value = ds9.get(string cmd) -pan # get current image coords -pan wcs fk4 sexagesimal # get current wcs coords - -ds9.set(string cmd) -pan 200 200 image # pan relative -pan to 400 400 physical # pan to physical coords -pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords -pan open -pan close -pixeltable -Display/Hide the pixel table. -Syntax: -pixeltable [] -    [yes|open] -    [no|close] - -Example: -string url = ds9.get(string cmd) -pixeltable - -ds9.set(string cmd) -pixeltable -pixeltable yes -pixeltable open -pixeltable close -plot -Display and configure data plots. All plot commands take an -optional second command, the plot name. If no plot name is -specified, the last plot created is assumed. Plot data is assumed -to be a pair of coordinates, with optional error values. The follow -are valid data descriptions: -xy    x and y -coordinates -xyex    x,y coordinates with x errors -xyey    x,y coordinates with y errors -xyexey    x,y coordinates with x and y -errors -To create a new plot, use the plot new command. -Syntax: -# create new empty plot window -plot [] -    [line|bar|scatter] -    [new] -    [new line|bar|scatter] -    [new name <plotname>] -    [new name <plotname> line|bar|scatter] - -#load data into existing plot from stdin -plot [[<plotname>] data xy|xyex|xyey|xyexey] - -# existing plot -plot[[<plotname>] load <filename> -xy|xyex|xyey|xyexey] -    [[<plotname>] save <filename>] -    [[<plotname>] clear] -    [[<plotname>] duplicate [#]] -    [[<plotname>] stats yes|no] -    [[<plotname>] list yes|no] -    [[<plotname>] loadconfig -<filename>] -    [[<plotname>] saveconfig -<filename>] -    [[<plotname>] pagesetup orient -portrait|landscape] -    [[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4] -    [[<plotname>] print] -    [[<plotname>] print destination -printer|file] -    [[<plotname>] print command -<command>] -    [[<plotname>] print filename -<filename>] -    [[<plotname>] print color rgb|gray] -    [[<plotname>] close] -    [[<plotname>] mode pointer|zoom] - -# export image -plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> - -    [[<plotname>]export jpeg -<filename>[1-100] -    [[<plotname>]export tiff -<filename>[none|jpeg|packbits|deflate] - -# configure graph -plot [[<plotname>] axis x|y grid yes|no] -    [[<plotname>] axis x|y log yes|no] -    [[<plotname>] axis x|y flip yes|no] -    [[<plotname>] axis x|y auto yes|no] -    [[<plotname>] axis x|y min -<value>] -    [[<plotname>] axis x|y max -<value>] -    [[<plotname>] axis x|y format -<string>] -    [[<plotname>] background -<value>] -    [[<plotname>] legend yes|no] -    [[<plotname>] legend position -right|left|top|bottom] -    [[<plotname>] font title|labels|numbers -font times|helvetica|courier] -    [[<plotname>] fonttitle|labels|numberssize -<value>] -    [[<plotname>] -fonttitle|labels|numbersweight normal|bold] -    [[<plotname>] -fonttitle|labels|numbersslant roman|italic] -    [[<plotname>] title <string>] -    [[<plotname>] title x|y -<string>] -    [[<plotname>] barmode -normal|stacked|aligned|overlap] - -# configure current dataset -plot [[<plotname>] show yes|no] -    [[<plotname>] shape -none|circle|square|diamond|plus|splus|scross|triangle|arrow] -    [[<plotname>] shape fill yes|no] -    [[<plotname>] shape color -<value>] -    [[<plotname>] smooth -step|linear|cubic|quadratic|catrom] -    [[<plotname>] color <value>] -    [[<plotname>] width <value>] -    [[<plotname>] dash yes|no] -    [[<plotname>] error yes|no] -    [[<plotname>] error color -<value>] -    [[<plotname>] error cap yes|no] -    [[<plotname>] error width -<value>] -    [[<plotname>] name <string>] - -# select current dataset -plot [[<plotname>] select <value>] - -Example: -# return all plotnames -string value = ds9.get(string cmd) -plot - -# create new empty plot window -ds9.set(string cmd) -plot -plot bar -plot new -plot new bar -plot new name foo -plot new name foo bar - -# load additional dataset into an existing plot -ds9.set(string cmd, string url) -plot data xy # plot additional data -plot foo data xy # plot additional data - -string value = ds9.get(string cmd) -plot stats -plot list -ds9.set(string cmd) -plot load foo.dat xy -plot save foo.dat -plot clear -plot duplicate 1 -plot stats yes -plot list yes -plot loadconfig foo.plt -plot saveconfig foo.plt -plot pagesetup orient portrait -plot pagesetup size letter -plot print -plot print destination file -plot print command lp -plot print filename foo.ps -plot print color rgb -plot close - -string value = ds9.get(string cmd) -plot mode -ds9.set(string cmd) -plot mode pointer - -# export plot -ds9.set(string cmd) -plot export tiff foo.tiff jpeg -plot export jpeg foo.jpeg 75 -plot export png foo.png - -# configure plot -string value = ds9.get(string cmd) -plot axis x grid -plot axis x log -plot axis x flip -plot axis x auto -plot axis x min -plot axis x max -plot axis x format -plot legend -plot legend position -plot font numbers font -plot font numbers size -plot font numbers weight -plot font numbers slant -plot title -plot title x -plot barmode -ds9.set(string cmd) -plot axis x grid yes -plot axis x log yes -plot axis x flip yes -plot axis x auto no -plot axis x min 0 -plot axis x max 100 -plot axis x format "%f" - -string value = ds9.get(string cmd) -plot background -ds9.set(string cmd) -plot background white - -string value = ds9.get(string cmd) -plot legend -plot legend position -ds9.set(string cmd) -plot legend yes -plot legend position left - -string value = ds9.get(string cmd) -plot font numbers font -plot font numbers size -plot font numbers weight -plot font numbers slant -ds9.set(string cmd) -plot font numbers font times -plot font numbers size 12 -plot font numbers weight bold -plot font numbers slant italic - -string value = ds9.get(string cmd) -plot title -plot title xaxis -plot title yaxis -ds9.set(string cmd) -plot title "This is a Title" -plot title x "X Axis" -plot title y "Y Axis" -plot title legend "This is the Legend" - -string value = ds9.get(string cmd) -plot barmode -ds9.set(string cmd) -plot barmode aligned - -# configure current dataset -string value = ds9.get(string cmd) -plot show -plot shape -plot shape fill -plot shape color -plot smooth -plot color -plot width -plot dash -plot error -plot error color -plot error cap -plot error width -plot name -ds9.set(string cmd) -plot show yes -plot shape circle -plot shape fill no -plot shape color cyan -plot smooth step -plot color red -plot width 2 -plot dash yes -plot error yes -plot error color red -plot error cap yes -plot error width 2 -plot name "My Data" - -# select current dataset -string value = ds9.get(string cmd) -plot select -ds9.set(string cmd) -plot select 2 - png -Load PNG image into current frame. -Syntax: -png [new|slice] [<filename>] - -Example: -string value = ds9.get(string cmd) -png - -ds9.set(string cmd) -png foo.png -png new foo.png -png slice foo.png -png -pngnew -pngslice -precision -Set region and coordinate output format precision. -Syntax: -precision +     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +     [2mass|iras] +     [csc|xmm|rosat] +     [first|nvss] +     [chandralog|cfhtlog|esolog|stlog|xmmlog] +     [cds <catalogname>] +     [cds <catalogid>] + +     [load <filename>] +     [import sb|tsv <filename>] + +     [<ref>] [<ra> <dec> + <coordsys>] +     [<ref>] [allcols] +     [<ref>] [allrows] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [crosshair] +     [<ref>] [dec <col>] +     [<ref>] [edit yes|no] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [filter <string>] +     [<ref>] [filter load <filename>] +     [<ref>] [header] +     [<ref>] [location <code>] +     [<ref>] [match] +     [<ref>] [match <ref> <ref>] +     [<ref>] [match error <value> + degrees|arcmin|arcsec] +     [<ref>] [match function + 1and2|1not2|2not1] +     [<ref>] [match return + 1and2|1only|2only] +     [<ref>] [match unique yes|no] +     [<ref>] [maxrows <number>] +     [<ref>] [name <object>] +     [<ref>] [panto yes|no] +     [<ref>] [plot <xcol> <ycol> + <xerrcol> <yerrcol>] +     [<ref>] [print] +     [<ref>] [psky <skyframe>] +     [<ref>] [psystem <coordsys>] +     [<ref>] [ra <col>] +     [<ref>] [regions] +     [<ref>] [retrieve] +     [<ref>] [samp] +     [<ref>] [samp broadcast] +     [<ref>] [samp send <application>] +     [<ref>] [save <filename>] +     [<ref>] + [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +     [<ref>] [show yes|no] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [sort <col> incr|decr] +     [<ref>] [symbol [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>] +     [<ref>] [symbol [#] + text|size|size2|units|angle <value>] +     [<ref>] [symbol shape + circle|ellipse|box|text|point] +     [<ref>] [symbol shapecircle point|box + point|diamond point|cross point|x point|arrow point|boxcircle + point] +     [<ref>] [symbol add| [#] remove] +     [<ref>] [symbol save|load + <filename>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] +     [<ref>] [x <col>] +     [<ref>] [y <col>] + + Example: + string value = ds9.get(string cmd) + catalog + catalog header + + ds9.set(string cmd) + catalog new + catalog 2mass + catalog cds 2mass + catalog cds{I/252} + + catalog load foo.xml + catalog import tsv foo.tsv + + catalog coordinate 202.48 47.21 fk5 + catalog allrows + catalog allcols + catalog cancel + catalog clear + catalog close + catalog crosshair + catalog dec DEC + catalog edit yes + catalog export tsv bar.tsv + catalog filter {$Jmag>10} + catalog filter load foo.flt + catalog header + catalog location 500 + catalog match error 2 arcsec + catalog match function 1and2 + catalog match unique no + catalog match return 1only + catalog match # last two catalogs loaded + catalog match 2mass csc + catalog maxrows 2000 + catalog name m51 + catalog panto no + catalog plot{$Jmag} {$Hmag} {$e_Jmag} {$e_Hmag} + catalog print + catalog psky fk5 + catalog psystem wcs + catalog ra RA + catalog regions + catalog retrieve + catalog samp broadcast + catalog samp send aladin + catalog save foo.xml + catalog server sao + catalog show yes + catalog radius 1 degrees + catalog symbol condition{$Jmag>15} + catalog symbol 2 shape{boxcircle point} + catalog symbol color red + catalog symbol font times + catalog symbol fontsize 14 + catalog symbol fontweight bold + catalog symbol fontslant italic + catalog symbol add + catalog symbol 2 remove + catalog symbol load foo.sym + catalog symbol save bar.sym + catalog sky fk5 + catalog skyformat degrees + catalog sort {Jmag} incr + catalog system wcs + catalog update + catalog x RA + catalog y DEC + + cd + Sets/Returns the current working directory. + Syntax: + cd [<directory>] + + Example: + string value = ds9.get(string cmd) + cd + + ds9.set(string cmd) + cd /home/mrbill + + cmap + Controls the colormap for the current frame. The colormap name + is not case sensitive. A valid contrast value is from 0 to + 10 and bias value from 0 to 1. + Syntax: + cmap [<colormap>] +     [file] +     [load <filename>] +     [save <filename>] +     [invert yes|no] +     [<constrast> <bias>] +     [tag [load|save] <filename>] +     [tag delete] +     [open|close] + + Example: + string value = ds9.get(string cmd) + cmap + cmap file + cmap invert + cmap value + + ds9.set(string cmd) + cmap Heat + cmap load foo.sao + cmap save bar.sao + cmap invert yes + cmap 5 .5 + cmap tag load foo.tag + cmap tag save foo.tag + cmap tag delete + cmap open + cmap close + + colorbar + Controls colorbar parameters. + Syntax: + colorbar [] +     [yes|no] +     [orientation] +     [horizontal|vertical] +     [numerics yes|no] +     [space value|distance] +     [font times|helvetica|courier] +     [fontsize <value>] +     [fontweight normal|bold] +     [fontslant roman|italic] +     [size] +     [ticks] +     [match] +     [lock [yes|no]] + + Example: + string value = ds9.get(string cmd) + colorbar + colorbar orientation + colorbar numerics + colorbar space + colorbar font + colorbar fontsize + colorbar fontweight + colorbar fontslant + colorbar size + colorbar ticks + colorbar lock + + ds9.set(string cmd) + colorbar yes + colorbar vertical + colorbar numerics yes + colorbar space value + colorbar font times + colorbar fontsize 14 + colorbar fontwieght bold + colorbar fontslant italic + colorbar size 20 + colorbar ticks 11 + colorbar match + colorbar lock yes + console + Display tcl console window. + Syntax: + -console + + Example: + ds9.set(string cmd) + console + + contour + Controls contours in the current frame. + Syntax: + contour [] +     [yes|no] +     [<coordsys> [<skyframe>]] +     [clear] +     [generate] +     [load <filename>] +     [save <filename> [<coordsys> + <skyframe>]] +     [convert] +     [load levels <filename>] +     [save levels <filename>] +     [copy] +     [paste [<coordsys> <color> + <width> yes|no]] +     [color <color>] +     [width <width>] +     [dash yes|no] +     [smooth <smooth>] +     [method block|smooth] +     [nlevels <number of levels>] +     [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ] +     [scale log exp <value>] +     [mode minmax|<value>|zscale|zmax] +     [scope global|local] +     [limits <min> <max>] +     [levels <value value value...>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + contour + contour wcs fk5 + contour color + contour width + contour dash + contour smooth + contour method + contour nlevels + contour scale + contour log exp + contour mode + contour scope + contour limits + contour levels + + ds9.set(string cmd) + contour + contour yes + contour clear + contour generate + contour load ds9.ctr + contour save ds9.con + contour save ds9.con wcs fk5 + contour convert + contour load levels ds9.ctr + contour save levels ds9.lev + contour copy + contour paste + contour paste wcs red 2 no + contour color yellow + contour width 2 + contour dash yes + contour smooth 5 + contour method smooth + contour nlevels 10 + contour scale sqrt + contour log exp 1000 + contour mode zscale + contour scope local + contour limits 1 100 + contour levels 1 10 100 1000 + contour open + contour close + + crop + Set current image display area. + Syntax: + crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +     [match <coordsys>] +     [lock <coordsys>|none] +     [reset] +     [3dzmin zmax <coordsys>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + crop # get crop in physical coords + crop wcs galactic sexagesimal arcsec + crop lock + + ds9.set(string cmd) + crop 40 30 10 20 # set crop in physical coords + crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs + galactic arcsec + crop match wcs + crop lock wcs + crop reset + crop 3d .25 .5 wcs + crop open + crop close + + crosshair + Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set. + Syntax: + crosshair [<x> <y> <coordsys> + [<skyframe>]] +     [match <coordsys>] +     [lock <coordsys>|none] + + Example: + string value = ds9.get(string cmd) + crosshair # get crosshair in physical coords + crosshair wcs fk4 sexagesimal # get crosshair in wcs coords + crosshair lock + + ds9.set(string cmd) + crosshair 100 100 physical # set crosshair in physical + crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords + crosshair 23:01:00 +58:52:51 wcs fk5 + crosshair match wcs + crosshair lock wcs + + cube + + Controls FITS cube. + Syntax: + cube [] +     [play|stop|next|prev|first|last] +     [<slice> [<coordsys>]] +     [interval <numeric>] +     [match <coordsys>] +     [lock <coordsys>|none] +     [order 123|132|213|231|312|321] +     [axes lock [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + cube + cube wcs + cube interval + cube lock + cube order + cube axes lock + + ds9.set(string cmd) + cube + cube play + cube last + cube 3 + cube 4.4 wcs + cube interval 2 + cube match wcs + cube lock wcs + cube order 123 + cube axes lock yes + cube open + cube close + cursor + Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also. + Syntax: + cursor [<x> <y>] + + Example: + ds9.set(string cmd) + cursor 10 10 + + data + Return an array of data values given a lower left corner and a + width and height in specified coordinate system. The last + argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes. + + Syntax: + data [<coordsys> [<skyframe>] <x> <y> + <width> <height> [yes|no]] + + Example: + string url = ds9.get(string cmd) + data image 450 520 3 3 yes + data physical 899 1039 6 6 no + data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no + data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 + 0.00016516669 no + + dsssao + dss + + Support for Digital Sky Survey at SAO. + Syntax: + dsssao [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + string value = ds9.get(string cmd) + dsssao name + dsssao coord + dsssao size + dsssao save + dsssao frame + + ds9.set(string cmd) + dsssao + dsssao m31 + dsssao name m31 + dsssao name clear + dsssao 00:42:44.404 +41:16:08.78 + dsssao size 60 60 arcmin + dsssao save yes + dsssao frame current + dsssao update frame + dsssao open + dsssao close + + dsseso + Support for Digital Sky Survey at ESO. + Syntax: + dsseso [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +     [open|close] + + Example: + string value = ds9.get(string cmd) + dsseso name + dsseso coord + dsseso size + dsseso save + dsseso frame + dsseso survey + + ds9.set(string cmd) + dsseso + dsseso m31 + dsseso name m31 + dsseso name clear + dsseso 00:42:44.404 +41:16:08.78 + dsseso size 60 60 arcmin + dsseso save yes + dsseso frame current + dsseso update frame + dsseso survey DSS2-red + dsseso open + dsseso close + + dssstsci + Support for Digital Sky Survey at STSCI. + Syntax: + dssstsci [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +     [survey poss1_blue|poss1_red] +     [survey all|quickv|phase2_gsc2|phase2_gsc1] +     [open|close] + + Example: + string value = ds9.get(string cmd) + dssstsci name + dssstsci coord + dssstsci size + dssstsci save + dssstsci frame + dssstsci survey + + ds9.set(string cmd) + dssstsci + dssstsci m31 + dssstsci name m31 + dssstsci name clear + dssstsci 00:42:44.404 +41:16:08.78 + dssstsci size 60 60 arcmin + dssstsci save yes + dssstsci frame current + dssstsci update frame + dssstsci survey all + dssstsci open + dssstsci close + envi + Load an ENVI header and file. Optional parameter: array endian. + + Syntax: + + envi [new] <header> [<filename>] + + + + Example: + + ds9.set(string cmd) + + envi foo.hdr + + envi new foo.hdr + envi foo.hdr foo.bsq + + exit + quit + + Quits DS9. + Syntax: + exit + quit + + Example: + ds9.set(string cmd) + exit + export + + Export loaded image data of current frame in specified image + format. Optional parameters: array endian, nrrd endian, jpeg + quality (1-100) and tiff compression method. + Syntax: + export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> + export array <filename>[big|little|native] + export nrrd <filename>[big|little|native] + export envi <header> [<filename>][big|little|native] + export jpeg <filename>[1-100] + export tiff <filename>[none|jpeg|packbits|deflate] + + Example: + + ds9.set (string cmd) + export array foo.arr little + export nrrd foo.nrrd little + export envi foo.hdr little + export envi foo.hdr foo.bsq little + export tiff foo.tiff jpeg + export jpeg foo.jpeg 75 + export png foo.png + file + Query currently loaded file information. + Syntax: + file + + Example: + string value = ds9.get(string cmd) + file + + fits + Load a FITS image into the current frame or query the currently + loaded image. + + Syntax: + fits[new|mask|slice] [<filename>] +     [width|height|depth|bitpix|type] +     [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +     [header [<ext>] [keyword + <string>]] +     [image|table|slice] + + Example: + string value = ds9.get(string cmd) + fits + fits width + fits height + fits depth + fits bitpix + fits size + fits size wcs fk5 arcmin + fits header # primary + fits header 2 # hdu 2 + fits header -2 # hdu 2 with inherit + fits header keyword BITPIX + fits header 1 keyword BITPIX + fits image + fits table + fits slice + + ds9.set(string cmd, string url) + fits foo.fits + fits new foo.fits + fits bar.fits[bin=detx,dety] + fits slice foo.fits + fits mask foo.fits + + frame + Controls frame functions. Frames may be created, deleted, + reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. + Syntax: + frame [center [#|all]] +     [clear [#|all]] +     [new [rgb|3d]] +     [delete [#|all]] +     [reset [#|all]] +     [refresh [#|all]] +     [hide [#|all]] +     [show [#|all]] +     [move first] +     [move back] +     [move forward] +     [move last] +     [first] +     [prev] +     [next] +     [last] +     [frameno #] +     [#] +     [match <coordsys>] +     [lock <coordsys>|none] +     [has + [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] +     [has contour [aux]]] +     [has fits [ |bin|cube|mosaic]] +     [has marker [highlite|paste|select|undo]] +     [has system <coordsys>] +     [has wcs [<wcssys>]] +     [has wcs celestial [<wcssys>]] +     [has wcs linear [<wcssys>]] + + Example: + string value = ds9.get(string cmd) + frame # returns the id of the current frame + frame frameno # returns the id of the current frame + frame all # returns the id of all frames + frame active # returns the id of all active frames + frame lock + frame has amplifier + frame has datamin + frame has datasec + frame has detector + frame has grid + frame has iis + frame has irafmin + frame has physical + frame has smooth + frame has contour + frame has contour aux + frame has fits + frame has fits bin + frame has fits cube + frame has fits mosaic + frame has marker highlite + frame has marker paste + frame has marker select + frame has marker undo + frame has system physical + frame has wcs wcsa + frame has wcs celestial wcsa + frame has wcs linear wcsa + + ds9.set(string cmd) + frame center # center current frame + frame center 1 # center 'Frame1' + frame center all # center all frames + frame clear # clear current frame + frame new # create new frame + frame new rgb # create new rgb frame + frame delete # delete current frame + frame reset # reset current frame + frame refresh # refresh current frame + frame hide # hide current frame + frame show 1 # show frame 'Frame1' + frame move first # move frame to first in order + frame move back # move frame back in order + frame move forward # move frame forward in order + frame move last # move frame to last in order + frame first # goto first frame + frame prev # goto prev frame + frame next # goto next frame + frame last # goto last frame + frame frameno 4 # goto frame 'Frame4', create if needed + frame 3 # goto frame 'Frame3', create if needed + frame match wcs + frame lock wcs + gif + Load GIF image into current frame. + + Syntax: + gif [new|slice] [<filename>] + + Example: + string value = ds9.get(string cmd) + gif + + ds9.set(string cmd) + gif foo.gif + gif new foo.gif + gif slice foo.gif + + grid + Controls coordinate grid. For grid numeric format syntax, + click here. + Syntax: + grid [] +     [yes|no] +     [type analysis|publication] +     [system <coordsys>] +     [sky <skyframe>] +     [skyformat <skyformat>] +     [grid yes|no] +     [grid color <color>] +     [grid width <value>] +     [grid dash yes|no] +     [grid gap1 <value>] +     [grid gap2 <value>] +     [grid gap3 <value>] +     [axes yes|no] +     [axes color <color>] +     [axes width <value>] +     [axes dash yes|no] +     [axes type interior|exterior] +     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +     [format1 <format>] +     [format2 <format>] +     [tickmarks yes|no] +     [tickmarks color <color>] +     [tickmarks width <value>] +     [tickmarks dash yes|no] +     [border yes|no] +     [border color <color>] +     [border width <value>] +     [border dash yes|no] +     [numerics yes|no] +     [numerics font times|helvetica|courier] +     [numerics fontsize <value>] +     [numerics fontweight normal|bold] +     [numerics fontslant roman|italic] +     [numerics color <color>] +     [numerics gap1 <value>] +     [numerics gap2 <value>] +     [numerics gap3 <value>] +     [numerics type interior|exterior] +     [numerics vertical yes|no] +     [title yes|no] +     [title text <text>] +     [title def yes|no] +     [title gap <value>] +     [title font times|helvetica|courier] +     [title fontsize <value>] +     [title fontweight normal|bold] +     [title fontslant roman|italic] +     [title color <color>] +     [labels yes|no] +     [labels text1 <text>] +     [labels text2 <text>] +     [labels def1 yes|no] +     [labels def2 yes|no] +     [labels gap1 <value>] +     [labels gap2 <value>] +     [labels font times|helvetica|courier] +     [labels fontsize <value>] +     [labels fontweight normal|bold] +     [labels fontslant roman|italic] +     [labels color <color>] +     [reset] +     [load <filename>] +     [save <filename>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + grid + grid type + grid system + grid sky + grid skyformat + grid grid + grid grid color + grid grid width + grid grid dash + grid grid gap1 + grid grid gap2 + grid grid gap3 + grid axes + grid axes color + grid axes width + grid axes dash + grid axes type + grid axes origin + grid format1 + grid format2 + grid tickmarks + grid tickmarks color + grid tickmarks width + grid tickmarks dash + grid border + grid border color + grid border width + grid border dash + grid numerics + grid numerics font + grid numerics fontsize + grid numerics fontweight + grid numerics fontslant + grid numerics color + grid numerics gap1 + grid numerics gap2 + grid numerics gap3 + grid numerics type + grid numerics vertical + grid title + grid title text + grid title def + grid title gap + grid title font + grid title fontsize + grid title fontweight + grid title fontslant + grid title color + grid labels + grid labels text1 + grid labels text2 + grid labels def1 + grid labels def2 + grid labels gap1 + grid labels gap2 + grid labels font + grid labels fontsize + grid labels fontweight + grid labels fontslant + grid labels color + + ds9.set(string cmd) + grid + grid yes + grid type analysis + grid system wcs + grid sky fk5 + grid skyformat degrees + grid grid yes + grid grid color red + grid grid width 2 + grid grid dash yes + grid grid gap1 10 + grid grid gap2 10 + grid grid gap3 10 + grid axes yes + grid axes color red + grid axes width 2 + grid axes dash yes + grid axes type exterior + grid axes origin lll + grid format1 d.2 + grid format2 d.2 + grid tickmarks yes + grid tickmarks color red + grid tickmarks width 2 + grid tickmarks dash yes + grid border yes + grid border color red + grid border width 2 + grid border dash yes + grid numerics yes + grid numerics font courier + grid numerics fontsize 12 + grid numerics fontweight bold + grid numerics fontslant italic + grid numerics color red + grid numerics gap1 10 + grid numerics gap2 10 + grid numerics gap3 10 + grid numerics type exterior + grid numerics vertical yes + grid title yes + grid title text {Hello World} + grid title def yes + grid title gap 10 + grid title fontsize 12 + grid title font courier + grid title fontweight bold + grid title fontslant italic + grid title color red + grid labels yes + grid labels text1 {Hello World} + grid labels text2 {Hello World} + grid labels def1 yes + grid labels def2 yes + grid labels gap1 10 + grid labels gap2 10 + grid labels font courier + grid labels fontsize 12 + grid labels fontweight bold + grid labels fontslant italic + grid labels color red + grid reset + grid load foo.grd + grid save foo.grd + grid open + grid close + + header + Display current fits header dialog. Optional extension number + maybe specified. Please note, this differs from samp fits + header. + Syntax: + header [<ext>] +     [close [<ext>]] +     [save [<ext>] <filename>] + + Example: + string value = ds9.get(string cmd) + header + header 2 + header close + + height + Set the height of the image display window. + Syntax: + height [<value>] + + Example: + string value = ds9.get(string cmd) + height + + ds9.set(string cmd) + height 512 + + iconify + Toggles iconification. + Syntax: + iconify [] +     [yes|no] + + Example: + string value = ds9.get(string cmd) + iconify + + ds9.set(string cmd) + iconify + iconify yes + iexam + Interactive examine function. A blinking cursor will indicate + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is + button. In the last form, the following macros will be + expanded if present: $width, $height, $depth, $bitpix, + $filename, $regions, $filename[$regions], $env, $pan, $value, + $x, $y, $z. See Analysis + Macros for more information. + Syntax: + iexam [] +     [[]|button|key|any] coordinate + <coordsys> [<skyframe>] [<skyformat>] +     [[]|button|key|any] data [width][height] +     [[]|button|key|any] <macro string>] + + Example: + string value = ds9.get(string cmd) + iexam + iexam coordinate image + iexam key coordinate image # return coordinate and key event + iexam coordinate wcs fk5 degrees + iexam coordinate wcs galactic sexagesimal + iexam coordinate fk5 + iexam data # return data value + iexam key data # return data value and key event + iexam data 3 3 # return all data in 3x3 box about selected point + iexam {'Click at $x,$y in file $filename'} + + iis + Set/Get IIS Filename. Optional mosaic number maybe supplied. + Syntax: + iis [filename <filename> [#]] + + Example: + string value = ds9.get(string cmd) + iis filename + iis filename 4 + + ds9.set(string cmd) + iis filename foo.fits + iis filename bar.fits 4 + jpeg + Load JPEG image into current frame. Optional parameters: jpeg + quality (1-100) + Syntax: + jpeg [new|slice] [<filename>] [1-100] + + Example: + string value = ds9.get(string cmd) + jpeg + + ds9.set(string cmd) + jpeg foo.jpeg + jpeg new foo.jpeg + jpeg slice foo.jpeg + + lock + Lock all other frames to the current frame. + Syntax: + lock[frame <coordsys>|none] +     [crosshair <coordsys>|none] +     [crop <coordsys>|none] +     [slice <coordsys>|none] +     [bin [yes|no]] +     [axes [yes|no]] +     [scale [yes|no]] +     [scalelimits [yes|no]] +     [colorbar [yes|no]] +     [block [yes|no]] +     [smooth [yes|no]] +     [3d [yes|no]] + + Example: + string value = ds9.get(string cmd) + lock frame + lock crosshair + lock crop + lock slice + lock bin + lock axes + lock scale + lock scalelimits + lock colorbar + lock block + lock smooth + lock 3d + + ds9.set(string cmd) + lock frame wcs + lock crosshair wcs + lock crop wcs + lock slice wcs + lock bin yes + lock axes yes + lock scale yes + lock scalelimits yes + lock colorbar yes + lock block yes + lock smooth yes + lock 3d yes + + lower + Lower in the window stacking order. + Syntax: + lower + + Example: + ds9.set(string cmd) + lower + + magnifier + Controls the magnifier settings. + Syntax: + magnifier [color <color>] +     [zoom <value>] +     [cursor yes|no] +     [region yes|no] + + Example: + string value = ds9.get(string cmd) + magnifier color + magnifier zoom + magnifier cursor + magnifier region + + ds9.set(string cmd) + magnifier color yellow + magnifier zoom 2 + magnifier cursor no + magnifier region no + + mask + + Controls mask parameters. + Syntax: + mask [color <color>] +     [mark zero|nonzero|nan|nonnan|range] +     [range <low> <high>] +     [transparency <value>] +     [system <coordsys>] +     [clear] +     [open|close] + + Example: + string value = ds9.get(string cmd) + mask color + mask mark + mask range + mask system + mask transparency + + ds9.set(string cmd) + mask color red + mask mark zero + mask range 10 100 + mask transparency 50 + mask system wcs + mask clear + mask open + mask close + + match + Match all other frames to the current frame. + Syntax: + match[frame <coordsys>] +     [crosshair <coordsys>] +     [crop <coordsys>] +     [slice <coordsys>] +     [bin] +     [axes] +     [scale] +     [scalelimits] +     [colorbar] +     [block] +     [smooth] +     [3d] + + Example: + ds9.set(string cmd) + match frame wcs + match crosshair wcs + match crop wcs + match slice wcs + match bin + match axes + match scale + match scalelimits + match colorbar + match block + match smooth + match 3d + + mecube + Load FITS multiple extension file as data cube. + + Syntax: + mecube [new] [<filename>] + + Example: + string value = ds9.get(string cmd) + mecube + + ds9.set(string cmd) + mecube foo.fits + mecube new foo.fits + + minmax + This is how DS9 determines the min and max data values + from the data. SCAN will scan all data. + Syntax: + minmax [scan|sample|datamin|irafmin] +     [mode scan|sample|datamin|irafmin] +     [interval #] + + Example: + string value = ds9.get(string cmd) + minmax mode + minmax sample + + ds9.set(string cmd) + minmax scan + minmax mode scan + minmax interval 100 + + mode + Controls the first mouse button mode. + Syntax: + mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + Example: + string value = ds9.get(string cmd) + mode + + ds9.set(string cmd) + mode crosshair + mosaic + Load FITS mosaic segment into current frame. + Syntax: + mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + + Example: + string value = ds9.get(string cmd) + mosaic + + ds9.set(string cmd) + mosaic foo.fits + mosaic wcs foo.fits + mosaic wcs new foo.fits + mosaic wcs mask foo.fits + + mosaicimage + Load FITS mosaic image into current frame. + Syntax: + mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] + [<filename>] + + Example: + string value = ds9.get(string cmd) + mosaicimage + ds9.set(string cmd) + mosaicimage foo.fits + mosaicimage wcs foo.fits + mosaicimage wcs new foo.fits + mosaicimage wcs mask foo.fits + + movie + Create a movie from snap shots of the DS9 window. A slice + movie cycles though all slices of a cube. A frame + movie cycles through all active frames. A 3d movie + cycles through specified viewing angles. The default action is slice. + Movie types are either MPEG or Animated GIF, + with default MPEG. Optional parameters for 3d: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times. + Syntax: + movie[slice|frame|3d][mpeg|gif] <filename> + movie 3d [mpeg|gif] <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>] + + Example: + ds9.set(string cmd) + movie slice mpeg ds9.mpg + movie frame gif ds9.gif + movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate 1 + + multiframe + Load FITS multiple extension file as multiple images. + + Syntax: + multiframe [<filename>] + + Example: + ds9.set(string cmd) + multiframe foo.fits + nameserver + Support Name Server functions. Coordinates are in fk5. + Syntax: + nameserver [<object>] +     [name <object>] +     [server + ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] +     [skyformat degrees|sexagesimal] +     [pan] +     [crosshair] +     [close] + + Example: + string value = ds9.get(string cmd) + nameserver + nameserver server + nameserver skyformat + nameserver m31 + + ds9.set(string cmd) + nameserver m31 + nameserver name m31 + nameserver server ned-sao + nameserver skyformat sexagesimal + nameserver pan + nameserver crosshair + nameserver open + nameserver close + + nan + Set image not-a-number color. + Syntax: + nan <color> + + Example: + string value = ds9.get(string cmd) + nan + + ds9.set(string cmd) + nan red + nrrd + Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: + array endian. + + Syntax: + nrrd [native|little|big] + nrrd [new|mask] [<filename>] + + Example: + string value = ds9.get(string cmd) + nrrd + nrrd big + + ds9.set(string cmd, string url) + nrrd foo.nrrd + nrrd new foo.nrrd + nrrd mask foo.nrrd + nvss + Support for NRAO VLA Sky Survey. + Syntax: + nvss [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + string value = ds9.get(string cmd) + nvss name + nvss coord + nvss size + nvss save + nvss frame + + ds9.set(string cmd) + nvss + nvss m31 + nvss name m31 + nvss name clear + nvss 00:42:44.404 +41:16:08.78 + nvss size 60 60 arcmin + nvss save yes + nvss frame current + nvss update frame + nvss open + nvss close + + orient + Controls the orientation of the current frame. + Syntax: + orient [none|x|y|xy] +     [open|close] + + Example: + string value = ds9.get(string cmd) + orient + + ds9.set(string cmd) + orient xy + orient open + orient close + + pagesetup + Controls Page Setup options. + Syntax: + pagesetup [orient portrait|landscape] +     [scale <numeric>] +     [size letter|legal|tabloid|poster|a4] + + Example: + string value = ds9.get(string cmd) + pagesetup orient + pagesetup scale + pagesetup size + + ds9.set(string cmd) + pagesetup orient portrait + pagesetup scale 50 + pagesetup size poster + + pan + Controls the current image cursor location for the current + frame. + Syntax: + pan [<coordsys> [<skyframe>] [<skyformat>]] # + get current coords + + pan [<x> <y> <coordsys> [<skyframe>]] # + relative +     [to <x> <y> <coordsys> + [<skyframe>]] # absolute +     [open|close] +     [close] + + Example: + string value = ds9.get(string cmd) + pan # get current image coords + pan wcs fk4 sexagesimal # get current wcs coords + + ds9.set(string cmd) + pan 200 200 image # pan relative + pan to 400 400 physical # pan to physical coords + pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords + pan open + pan close + + pixeltable + Display/Hide the pixel table. + Syntax: + pixeltable [] +     [yes|open] +     [no|close] + + Example: + string url = ds9.get(string cmd) + pixeltable + + ds9.set(string cmd) + pixeltable + pixeltable yes + pixeltable open + pixeltable close + + plot + Display and configure data plots. All plot commands take an + optional second command, the plot name. If no plot name is + specified, the last plot created is assumed. Plot data is + assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions: + xy    x and y coordinates + xyex    x,y coordinates with x errors + xyey    x,y coordinates with y errors + xyexey    x,y coordinates with x and y + errors + + To create a new plot, use the plot new command. + Syntax: + # create new empty plot window + plot [] +     [line|bar|scatter] +     [new] +     [new line|bar|scatter] +     [new name <plotname>] +     [new name <plotname> line|bar|scatter] + + #load data into existing plot from stdin + plot [[<plotname>] data xy|xyex|xyey|xyexey] + + # existing plot + plot[[<plotname>] load <filename> + xy|xyex|xyey|xyexey] +     [[<plotname>] save <filename>] +     [[<plotname>] clear] +     [[<plotname>] duplicate [#]] +     [[<plotname>] stats yes|no] +     [[<plotname>] list yes|no] +     [[<plotname>] loadconfig + <filename>] +     [[<plotname>] saveconfig + <filename>] +     [[<plotname>] pagesetup orient + portrait|landscape] +     [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4] +     [[<plotname>] print] +     [[<plotname>] print destination + printer|file] +     [[<plotname>] print command + <command>] +     [[<plotname>] print filename + <filename>] +     [[<plotname>] print color rgb|gray] +     [[<plotname>] close] +     [[<plotname>] mode pointer|zoom] + + # export image + plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> +     [[<plotname>]export jpeg + <filename>[1-100] +     [[<plotname>]export tiff + <filename>[none|jpeg|packbits|deflate] + + # configure graph + plot [[<plotname>] axis x|y grid yes|no] +     [[<plotname>] axis x|y log yes|no] +     [[<plotname>] axis x|y flip yes|no] +     [[<plotname>] axis x|y auto yes|no] +     [[<plotname>] axis x|y min + <value>] +     [[<plotname>] axis x|y max + <value>] +     [[<plotname>] axis x|y format + <string>] +     [[<plotname>] background <value>] +     [[<plotname>] legend yes|no] +     [[<plotname>] legend position + right|left|top|bottom] +     [[<plotname>] font title|labels|numbers + font times|helvetica|courier] +     [[<plotname>] + fonttitle|labels|numberssize <value>] +     [[<plotname>] + fonttitle|labels|numbersweight normal|bold] +     [[<plotname>] + fonttitle|labels|numbersslant roman|italic] +     [[<plotname>] title <string>] +     [[<plotname>] title x|y <string>] +     [[<plotname>] barmode + normal|stacked|aligned|overlap] + + # configure current dataset + plot [[<plotname>] show yes|no] +     [[<plotname>] shape + none|circle|square|diamond|plus|splus|scross|triangle|arrow] +     [[<plotname>] shape fill yes|no] +     [[<plotname>] shape color + <value>] +     [[<plotname>] smooth + step|linear|cubic|quadratic|catrom] +     [[<plotname>] color <value>] +     [[<plotname>] width <value>] +     [[<plotname>] dash yes|no] +     [[<plotname>] error yes|no] +     [[<plotname>] error color + <value>] +     [[<plotname>] error cap yes|no] +     [[<plotname>] error width + <value>] +     [[<plotname>] name <string>] + + # select current dataset + plot [[<plotname>] select <value>] + + Example: + # return all plotnames + string value = ds9.get(string cmd) + plot + + # create new empty plot window + ds9.set(string cmd) + plot + plot bar + plot new + plot new bar + plot new name foo + plot new name foo bar + + # existing plot + string value = ds9.get(string cmd) + plot stats + plot list + + ds9.set(string cmd) + plot load foo.dat xy + plot save foo.dat + plot clear + plot duplicate 1 + plot stats yes + plot list yes + plot loadconfig foo.plt + plot saveconfig foo.plt + plot pagesetup orient portrait + plot pagesetup size letter + plot print + plot print destination file + plot print command lp + plot print filename foo.ps + plot print color rgb + plot close + + # plot mode + string value = ds9.get(string cmd) + plot mode + + ds9.set(string cmd) + plot mode pointer + + # export plot + ds9.set(string cmd) + plot export tiff foo.tiff jpeg + plot export jpeg foo.jpeg 75 + plot export png foo.png + + # configure plot + string value = ds9.get(string cmd) + plot axis x grid + plot axis x log + plot axis x flip + plot axis x auto + plot axis x min + plot axis x max + plot axis x format + plot background + plot legend + plot legend position + plot font numbers font + plot font numbers size + plot font numbers weight + plot font numbers slant + plot title + plot title x + + ds9.set(string cmd) + plot axis x grid yes + plot axis x log yes + plot axis x flip yes + plot axis x auto no + plot axis x min 0 + plot axis x max 100 + plot axis x format "%f" + plot background white + plot legend yes + plot legend position left + + plot font numbers font times + plot font numbers size 12 + plot font numbers weight bold + plot font numbers slant italic + plot title "This is a Title" + plot title x "X Axis" + plot title y "Y Axis" + plot title legend "This is the Legend" + + # bar plot + string value = ds9.get(string cmd) + plot barmode + + ds9.set(string cmd) + plot barmode aligned + + # configure current dataset + string value = ds9.get(string cmd) + plot show + plot shape + plot shape fill + plot shape color + plot smooth + plot color + plot width + plot dash + plot error + plot error color + plot error cap + plot error width + plot name + + ds9.set(string cmd) + plot show yes + plot shape circle + plot shape fill no + plot shape color cyan + plot smooth step + plot color red + plot width 2 + plot dash yes + plot error yes + plot error color red + plot error cap yes + plot error width 2 + plot name "My Data" + + # select current dataset + string value = ds9.get(string cmd) + plot select + + ds9.set(string cmd) + plot select 2 + + png + Load PNG image into current frame. + + Syntax: + png [new|slice] [<filename>] + + Example: + string value = ds9.get(string cmd) + png + + ds9.set(string cmd) + png foo.png + png new foo.png + png slice foo.png + precision + Set region and coordinate output format precision. + Syntax: + precision <linear><degree><hms><dms><arcmin><arcsec> - - -Example: -string value = ds9.get(string cmd) -precision - -ds9.set(string cmd) -precision 8 10 4 3 5 3 -prefs -Controls various preference settings. -Syntax: -prefs [clear] -    [irafalign yes|no] - -Example: -string value = ds9.get(string cmd) -prefs irafalign - -ds9.set(string cmd) -prefs clear -prefs irafalign - preserve -Preserve the follow attributes while loading a new image. -Syntax: -preserve [pan yes|no] -    [regions yes|no] - -Example: -string value = ds9.get(string cmd) -preserve pan -preserve regions - -ds9.set(string cmd) -preserve pan yes -preserve regions yes -psprint -Invokes postscript printing. Please see print -for further details. -print -Controls printing. Use print option to set printing options. -Syntax: -print [destination printer|file] -    [command <command>] -    [filename <filename>] -    [color rgb|cmyk|gray] -    [level 1|2|3] -    -[resolution72|screen|96|144|150|225|300|600|1200] - -Example: -string value = ds9.get(string cmd) -print destination -print command -print filename -print color -print level -print resolution - -ds9.set(string cmd) -print -print destination file -print command lp -print filename foo.ps -print color cmyk -print level 2 -print resolution 96 -raise -Raise in the window stacking order. -Syntax: -raise - -Example: -ds9.set(string cmd) -raise -regions -Controls regions in the current frame. -Syntax: -regions [<filename>] -    [load [all] <filename>] -    [save <filename>] -    [list [close]] -    [epsilon <integer>] -    [show yes|no] -    [showtext yes|no] -    [centroid] -    [centroid auto yes|no] -    [centroid radius <value>|iteration -<value>] -    [getinfo] -    [move front] -    [move back] -    [select all] -    [select none] -    [select invert] -    [delete all] -    [delete select] -    [format -ds9|xml|ciao|saotng|saoimage|pros|xy] -    [system image|physical|wcs|wcsa...wcsz] -    [sky fk4|fk5|icrs|galactic|ecliptic] -    [skyformat degrees|sexagesimal] -    [strip yes|no] -    [shape <shape>] -    [color &ltcolor>] -    [width <width>] -    [fixed|edit|rotate|delete yes|no] -    [include|exclude|source|background] -    [command <marker command>] -    [composite] -    [dissolve] -    [template <filename>] -    [template <filename> at <ra> -<dec> <coordsys> <skyframe>] -    [savetemplate <filename>] -    [groups] -    [group new] -    [group <tag> new] -    [group <tag> update] -    [group <tag> select] -    [group <tag> color <color>] -    [group <tag> copy] -    [group <tag> delete] -    [group <tag> cut] -    [group <tag> font <font>] -    [group <tag> move <int> -<int>] -    [group <tag> movefront] -    [group <tag> moveback] -    [group <tag> property <property> -yes|no] -    [copy] -    [cut] -    [paste image|physical|wcs|wcsa...wcsz] -    [undo] -    [include|exclude|source|background|selected] -    [-format ds9|ciao|saotng|saoimage|pros|xy] -    [-system image|physical|wcs|wcsa...wcsz] -    [-sky fk4|fk5|icrs|galactic|ecliptic] -    [-skyformat degrees|sexagesimal] -    [-prop -select|edit|move|rotate|delete|fixed|include|source 1|0] -    [-group <tag>] -    [-strip yes|no] -    [-wcs yes|no] - -Example: -string url = ds9.get(string cmd) -regions -regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal --prop edit 1 -group foo -string value = ds9.get(string cmd) -regions epsilon -regions show -regions showtext -regions centroid -regions centroid auto -regions centroid radius -regions centroid iteration -regions selected -regions format -regions system -regions sky -regions skyformat -regions strip -regions shape -regions color -regions width -regions source -regions background -regions include -regions exclude -regions selected -regions groups - -ds9.set(string cmd, string url) -regions -format xy -system wcs -sky fk5 -regions -format ds9 - -ds9.set(string cmd) -regions foo.reg -regions -format ciao bar.reg # load as ciao format -regions foo.fits # FITS regions files do not need a format -specification -regions load foo.reg # load foo.reg into current frame -regions load all foo.reg # load foo.reg into all frames -regions load *.reg# expand *.reg and load into current frame -regions load all *.reg # expand *.reg and load into all frames -regions save foo.reg -regions list -regions list close -regions epsilon 5 -regions show yes -regions showtext no -regions centroid -regions centroid auto yes -regions centroid radius 10 -regions centroid iteration 20 -regions getinfo -regions move back -regions move front -regions select all -regions select none -regions select invert -regions delete all -regions delete select -regions format ds9 -regions system wcs -regions sky fk5 -regions skyformat degrees -regions strip yes -regions shape ellipse -regions color red -regions width 3 -regions edit yes -regions include -regions command "circle 100 100 20 # color=red" -regions composite -regions dissolve -regions template foo.tpl -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 -regions savetemplate foo.tpl -regions group new -regions group foo new -regions group foo update -regions group foo select -regions group foo color red -regions group foo copy -regions group foo delete -regions group foo cut -regions group foo font 'times 14 bold' -regions group foo move 100 100 -regions group foo movefront -regions group foo moveback -regions group foo property delete no -regions copy -regions cut -regions paste wcs -regions undo -restore -Restore DS9 to a previous state from a backup save set. -Syntax: -restore <filename> - -Example: -restore ds9.bck -rgb -Create RGB frame and control RGB frame parameters. -Syntax: -rgb [] -    [red|green|blue] -    [channel [red|green|blue]] -   [view [red|green|blue] [yes|no]] -    [system <coordsys>] -    [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -rgb channel -rgb lock wcs -rgb lock crop -rgb lock slice -rgb lock bin -rgb lock scale -rgb lock scalelimits -rgb lock colorbar -rgb lock block -rgb lock smooth -rgb system -rgb view red -rgb view green -rgb view blue - -ds9.set(string cmd) -rgb # create new rgb frame -rgb red # set current channel to red -rgb channel red # set current channel to red -rgb view blue no # turn off blue channel -rgb system wcs # set rgb coordinate system -rgb lock wcs yes -rgb lock crop yes -rgb lock slice yes -rgb lock bin yes -rgb lock scale yes -rgb lock scalelimits yes -rgb lock colorbar yes -rgb lock block yes -rgb lock smooth yes -rgb open -rgb close -rgbarray -Load raw data array cube into rgb frame. -Syntax: -rgbarray [native|big|little] -rgbarray [new] + + Example: + string value = ds9.get(string cmd) + precision + + ds9.set(string cmd) + precision 8 10 4 3 5 3 + + prefs + Controls various preference settings. + Syntax: + prefs [clear] +     [irafalign yes|no] + + Example: + string value = ds9.get(string cmd) + prefs irafalign + + ds9.set(string cmd) + prefs clear + prefs irafalign + + preserve + Preserve the follow attributes while loading a new image. + Syntax: + preserve [pan yes|no] +    [regions yes|no] + + Example: + string value = ds9.get(string cmd) + preserve pan + preserve regions + + ds9.set(string cmd) + preserve pan yes + preserve regions yes + + psprint + Invokes postscript printing. Please see print + for further details. + print + Controls printing. Use print option to set printing options. + Syntax: + print [destination printer|file] +     [command <command>] +     [filename <filename>] +     [color rgb|cmyk|gray] +     [level 1|2|3] +     + [resolution72|screen|96|144|150|225|300|600|1200] + + Example: + string value = ds9.get(string cmd) + print destination + print command + print filename + print color + print level + print resolution + + ds9.set(string cmd) + print + print destination file + print command lp + print filename foo.ps + print color cmyk + print level 2 + print resolution 96 + raise + Raise in the window stacking order. + Syntax: + raise + + Example: + ds9.set(string cmd) + raise + regions + Controls regions in the current frame. + Syntax: + regions [<filename>] +     [load [all] <filename>] +     [save <filename>] +     [list [close]] +     [epsilon <integer>] +     [show yes|no] +     [showtext yes|no] +     [centroid] +     [centroid auto yes|no] +     [centroid radius <value>|iteration + <value>] +     [getinfo] +     [move front] +     [move back] +     [select all] +     [select none] +     [select invert] +     [delete all] +     [delete select] +     [format ds9|xml|ciao|saotng|saoimage|pros|xy] +     [system image|physical|wcs|wcsa...wcsz] +     [sky fk4|fk5|icrs|galactic|ecliptic] +     [skyformat degrees|sexagesimal] +     [strip yes|no] +     [shape <shape>] +     [color &ltcolor>] +     [width <width>] +     [fixed|edit|rotate|delete yes|no] +     [include|exclude|source|background] +     [command <marker command>] +     [composite] +     [dissolve] +     [template <filename>] +     [template <filename> at <ra> + <dec> <coordsys> <skyframe>] +     [savetemplate <filename>] +     [groups] +     [group new] +     [group <tag> new] +     [group <tag> update] +     [group <tag> select] +     [group <tag> color <color>] +     [group <tag> copy] +     [group <tag> delete] +     [group <tag> cut] +     [group <tag> font <font>] +     [group <tag> move <int> + <int>] +     [group <tag> movefront] +     [group <tag> moveback] +     [group <tag> property <property> + yes|no] +     [copy] +     [cut] +     [paste image|physical|wcs|wcsa...wcsz] +     [undo] +     [include|exclude|source|background|selected] +     [-format ds9|ciao|saotng|saoimage|pros|xy] +     [-system image|physical|wcs|wcsa...wcsz] +     [-sky fk4|fk5|icrs|galactic|ecliptic] +     [-skyformat degrees|sexagesimal] +     [-prop + select|edit|move|rotate|delete|fixed|include|source 1|0] +     [-group <tag>] +     [-strip yes|no] +     [-wcs yes|no] + + Example: + string url = ds9.get(string cmd) + regions + regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal + -prop edit 1 -group foo + string value = ds9.get(string cmd) + regions epsilon + regions show + regions showtext + regions centroid + regions centroid auto + regions centroid radius + regions centroid iteration + regions selected + regions format + regions system + regions sky + regions skyformat + regions strip + regions shape + regions color + regions width + regions source + regions background + regions include + regions exclude + regions selected + regions groups + + ds9.set(string cmd) + regions foo.reg + regions -format ciao bar.reg # load as ciao format + regions foo.fits # FITS regions files do not need a format + specification + regions load foo.reg # load foo.reg into current frame + regions load all foo.reg # load foo.reg into all frames + regions load *.reg# expand *.reg and load into current frame + regions load all *.reg # expand *.reg and load into all frames + regions save foo.reg + regions list + regions list close + regions epsilon 5 + regions show yes + regions showtext no + regions centroid + regions centroid auto yes + regions centroid radius 10 + regions centroid iteration 20 + regions getinfo + regions move back + regions move front + regions select all + regions select none + regions select invert + regions delete all + regions delete select + regions format ds9 + regions system wcs + regions sky fk5 + regions skyformat degrees + regions strip yes + regions shape ellipse + regions color red + regions width 3 + regions edit yes + regions include + regions command "circle 100 100 20 # color=red" + regions composite + regions dissolve + regions template foo.tpl + regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 + regions savetemplate foo.tpl + regions group new + regions group foo new + regions group foo update + regions group foo select + regions group foo color red + regions group foo copy + regions group foo delete + regions group foo cut + regions group foo font 'times 14 bold' + regions group foo move 100 100 + regions group foo movefront + regions group foo moveback + regions group foo property delete no + regions copy + regions cut + regions paste wcs + regions undo + + restore + Restore DS9 to a previous state from a backup save set. + Syntax: + restore <filename> + + Example: + restore ds9.bck + rgb + Create RGB frame and control RGB frame parameters. + Syntax: + rgb [] +     [red|green|blue] +     [channel [red|green|blue]] +     [view [red|green|blue] [yes|no]] +     [system <coordsys>] +     [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + rgb channel + rgb lock wcs + rgb lock crop + rgb lock slice + rgb lock bin + rgb lock scale + rgb lock scalelimits + rgb lock colorbar + rgb lock block + rgb lock smooth + rgb system + rgb view red + rgb view green + rgb view blue + + ds9.set(string cmd) + rgb # create new rgb frame + rgb red # set current channel to red + rgb channel red # set current channel to red + rgb view blue no # turn off blue channel + rgb system wcs # set rgb coordinate system + rgb lock wcs yes + rgb lock crop yes + rgb lock slice yes + rgb lock bin yes + rgb lock scale yes + rgb lock scalelimits yes + rgb lock colorbar yes + rgb lock block yes + rgb lock smooth yes + rgb open + rgb close + rgbarray + Load raw data array cube into rgb frame. + + Syntax: + rgbarray [native|big|little] + rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -string value = ds9.get(string cmd) -rgbarray -rgbarray little - -ds9.set(string cmd) -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] -rgbarray new -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] -rgbcube -Load FITS rgbcube into rgb frame. -Syntax: -rgbcube [new] [<filename>] - -Example: -string value = ds9.get(string cmd) -rgbcube - -ds9.set(string cmd) -rgbcube foo.fits -rgbcube new foo.fits -rgbcube -rgbcubenew -rgbimage -Load FITS rgbimage into rgb frame. -Syntax: -rgbimage [new] [<filename>] - -Example: -string value = ds9.get(string cmd) -rgbimage - -ds9.set(string cmd) -rgbimage foo.fits -rgbimage new foo.fits -rgbimage -rgbimagenew -rotate -Controls the rotation angle (in degrees) of the current -frame. -Syntax: -rotate [<value>] -    [to <value>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -rotate - -ds9.set(string cmd) -rotate 45 -rotate to 30 -rotate open -rotate close -samp -Configure SAMP protocol. -Syntax: -samp [no|disconnect] -    [broadcast [image|table]] -    [send [image|table] <application>] - -Example: - -ds9.set(string cmd) -samp no -samp disconnect -samp broadcast image -samp send image aladin -save -Save loaded image data of current frame as FITS. -Syntax: -save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice] - -Example: -ds9.set(string cmd) -save foo.fits -save fits foo.fits image -save fits foo.fits table -save fits foo.fits slice -save rgbimage foo.fits -save rgbcube foo.fits -save mecube foo.fits -save mosaic foo.fits -save mosaicimage foo.fits -saveimage -Create a snap shot of the current DS9 window and save in -specified image format. If no format specified, the file name -extension is used to determine the output format. Optional -parameters: jpeg quality (1-100) and tiff -compression method. -Syntax: -saveimage[fits|eps|gif|tiff|jpeg|png]<filename> -saveimage <filename>.jpeg [1-100] -saveimage <filename>.tiff [none|jpeg|packbits|deflate] - -Example: -ds9.set(string cmd) -saveimage ds9.tiff -saveimage jpeg ds9.jpeg 75 -scale -Controls the limits and color scale distribution. -Syntax: -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -    [log exp <value>] -    [datasec yes|no] -    [limits <minvalue> <maxvalue>] -    [mode minmax|<value>|zscale|zmax] -    [scope local|global] -    [match] -    [match limits] -    [lock [yes|no]] -    [lock limits [yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -scale -scale log exp -scale datasec -scale limits -scale mode -scale scope -scale lock -scale lock limits - -ds9.set(string cmd) -scale linear -scale log exp 100 -scale datasec yes -scale histequ -scale limits 1 100 -scale mode zscale -scale mode 99.5 -scale scope local -scale match -scale match limits -scale lock yes -scale lock limits yes -scale open -scale close -shm -Load a shared memory segment into the current frame. -Syntax: -shm [<key> [<filename>]] -    [key <key> [<filename>]] -    [shmid <id> [<filename>]] -    [fits [key|shmid] <id> -[<filename>]] -    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]] -    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]] -    [rgbcube [key|shmid] <id> -[<filename>] -    [rgbimage [key|shmid] <id> -[<filename>]] -    [rgbarray [key|shmid] <id> + + Example: + string value = ds9.get(string cmd) + rgbarray + + ds9.set(string cmd) + rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + rgbcube + Load FITS rgbcube into rgb frame. + + Syntax: + rgbcube [new] [<filename>] + + Example: + string value = ds9.get(string cmd) + rgbcube + + ds9.set(string cmd) + rgbcube foo.fits + rgbcube new foo.fits + rgbimage + Load FITS rgbimage into rgb frame. + + Syntax: + rgbimage [new] [<filename>] + + Example: + string value = ds9.get(string cmd) + rgbimage + + ds9.set(string cmd) + rgbimage foo.fits + rgbimage new foo.fits + + rotate + Controls the rotation angle (in degrees) of the current frame. + Syntax: + rotate [<value>] +     [to <value>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + rotate + + ds9.set(string cmd) + rotate 45 + rotate to 30 + rotate open + rotate close + samp + Configure SAMP protocol. + Syntax: + samp [no|disconnect] +     [broadcast [image|table]] +     [send [image|table] <application>] + + Example: + + ds9.set(string cmd) + samp no + samp disconnect + samp broadcast image + samp send image aladin + save + + Save loaded image data of current frame as FITS. + Syntax: + save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice] + + Example: + ds9.set(string cmd) + save foo.fits + save fits foo.fits image + save fits foo.fits table + save fits foo.fits slice + save rgbimage foo.fits + save rgbcube foo.fits + save mecube foo.fits + save mosaic foo.fits + save mosaicimage foo.fits + saveimage + Create a snap shot of the current DS9 window and save in + specified image format. If no format specified, the file name + extension is used to determine the output format. Optional + parameters: jpeg quality (1-100) and tiff + compression method. + Syntax: + saveimage[fits|eps|gif|tiff|jpeg|png]<filename> + saveimage <filename>.jpeg [1-100] + saveimage <filename>.tiff [none|jpeg|packbits|deflate] + + Example: + ds9.set(string cmd) + saveimage ds9.tiff + saveimage jpeg ds9.jpeg 75 + scale + Controls the limits and color scale distribution. + Syntax: + scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +     [log exp <value>] +     [datasec yes|no] +     [limits <minvalue> <maxvalue>] +     [mode minmax|<value>|zscale|zmax] +     [scope local|global] +     [match] +     [match limits] +     [lock [yes|no]] +     [lock limits [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + scale + scale log exp + scale datasec + scale limits + scale mode + scale scope + scale lock + scale lock limits + + ds9.set(string cmd) + scale linear + scale log exp 100 + scale datasec yes + scale histequ + scale limits 1 100 + scale mode zscale + scale mode 99.5 + scale scope local + scale match + scale match limits + scale lock yes + scale lock limits yes + scale open + scale close + + shm + Load a shared memory segment into the current frame. + Syntax: + shm [<key> [<filename>]] +     [key <key> [<filename>]] +     [shmid <id> [<filename>]] +     [fits [key|shmid] <id> + [<filename>]] +     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]] +     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] + <id> [<filename>]] +     [rgbcube [key|shmid] <id> + [<filename>] +     [rgbimage [key|shmid] <id> + [<filename>]] +     [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] - -    [array [key|shmid] <id> +     [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - -Example: -string value = ds9.get(string cmd) -shm - -ds9.set(string cmd) -shm 102 -shm key 102 -shm shmid 102 foo -shm fits key 100 foo -shm mosaicimage iraf key 100 foo -shm mosaicimage wcs key 100 foo -shm mosaicimage wcsa key 100 foo -shm mosaicimage wfpc2 key 100 foo -shm mosaic iraf key 100 foo -shm mosaic wcs key 100 foo -shm rgbcube key 100 foo -shm rgbimage key 100 foo -shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] -shm array shmid 102 [dim=32,bitpix=-32] - sia -Support for VO Simple Image Access protocol. The first command -will create a new search. All other commands operated on the last -search created, unless indicated otherwise. -Syntax: -sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [coordinate <ra> <dec> -<coordsys>] -    [<ref>] [crosshair] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [name <object>] -    [<ref>] [print] -    [<ref>] [retrieve] -    [<ref>] [save <filename>] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] - -Example: -string value = ds9.get(string cmd) -sia - -ds9.set(string cmd) -sia2mass -siacancel -siaclear -siaclose -siacoordinate 202.48 47.21 fk5 -siacrosshair -siaexport tsv bar.tsv -sianame m51 -siaprint -siaretrieve -siasave foo.xml -siaradius 1degrees -siasky fk5 -sia skyformat degrees -siasystem wcs -siaupdate - single -Select Single Display mode -Syntax: -single - -Example: -string value = ds9.get(string cmd) -single - -ds9.set(string cmd) -single -skyview -Support for SkyView image server at HEASARC. -Syntax: -skyview [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [pixels <width> <height>] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey <survey>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -skyview name -skyview coord -skyview size -skyview pixels -skyview save -skyview frame -skyview survey - -ds9.set(string cmd) -skyview -skyview m31 -skyview name m31 -skyview name clear -skyview 00:42:44.404 +41:16:08.78 -skyview size 60 60 arcmin -skyview pixels 600 600 -skyview save yes -skyview frame current -skyview update frame -skyview survey sdssi -skyview open -skyview close -sleep -Delays execution for specified number of seconds. Default is 1 -second. -Syntax: -sleep [#] - -Example: -ds9.set(string cmd) -sleep -sleep 2 -smooth -Smooth current image or set smooth parameters. -Boxcar width =2*radius+1 -Tophat diameter =2*radius+1 -Gaussian diameter =2*radius+1,mean=0 -Elliptical Gaussian diameter -=2*radius+1,mean=0Syntax: -smooth [] -    [yes|no] -    [function boxcar|tophat|gaussian] -    [radius <value>] -    [radiusminor <value>] -    [sigma <value>] -    [sigmaminor <value>] -    [angle <value>] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -string value = ds9.get(string cmd) -smooth -smooth function -smooth radius -smooth radiusminor -smooth sigma -smooth sigmaminor -smooth angle -smooth lock - -ds9.set(string cmd) -smooth -smooth yes -smooth function tophat -smooth radius 4 -smooth radiusminor 4 -smooth sigma 2.0 -smooth sigmaminor 2.0 -smooth angle 45 -smooth open -smooth close -smooth match -smooth lock yes -smooth open -smooth close -source -Source TCL code from a file. -Syntax: -source [filename] - -Example: -ds9.set(string cmd) -source foo.tcl -tcl -Execute one TCL command. -Syntax: -tcl <tcl command> - -Example: -ds9.set(string cmd) -tcl {puts {Hello, World}} -threads -Set number of process threads for functions which are -multi-threaded. -Syntax: -threads # - -Example: -string value = ds9.get(string cmd) -threads -ds9.set(string cmd) -threads 8 -tiff -Load TIFF image into current frame. Optional parameters: -tiff compression method. -Syntax: -tiff [new|slice] [<filename>] -[none|jpeg|packbits|deflate] - -Example: -string value = ds9.get(string cmd) -tiff -tiff jpeg - -ds9.set(string cmd) -tiff foo.tiff -tiff new foo.tiff -tiff slice foo.tiff -tiff -tiff new -tiff slice -tile -Controls the tile display mode. -Syntax: -tile [] -    [yes|no] -    [mode grid|column|row] -    [grid] -    [grid mode automatic|manual] -    [grid direction x|y] -    [grid layout <col> <row>] -    [grid gap <pixels>] -    [row] -    [column] - -Example: -string value = ds9.get(string cmd) -tile -tile mode -tile grid mode -tile grid direction -tile grid layout -tile grid gap - -ds9.set(string cmd) -tile -tile yes -tile mode row -tile grid -tile grid mode manual -tile grid direction x -tile grid layout 5 5 -tile grid gap 10 -tile row -tile column -update -Updates the current frame or region of frame. In the second -form, the first argument is the number of the fits HDU (starting -with 1) and the remaining args are a bounding box in IMAGE -coordinates. By default, the screen is updated the next available -idle cycle. However, you may force an immediate update by -specifying the NOW option. -Syntax: -update [] -    [# x1 y1 x2 y2] -    [now] -    [now # x1 y1 x2 y2] - -Example: - -ds9.set(string cmd) -update -update 1 100 100 300 400 -update now -update now 1 100 100 300 400 -url -Load FITS from URL into the current frame -Syntax: -url <url> - -Example: -ds9.set(string cmd) -url http://foo.bar.edu/foo.fits -version -Returns the current version of DS9. -Syntax: -version - -Example: -string value = ds9.get(string cmd) -version -view -Controls the GUI. -Syntax: -view [layout horizontal|vertical] -    [keyvalue <string>] -    [info yes|no] -    [panner yes|no] -    [magnifier yes|no] -    [buttons yes|no] -    [colorbar yes|no] -    [colorbar horizontal|vertical] -    [colorbar numerics yes|no] -    [graph horizontal|vertical yes|no] -    [filename yes|no[ -    [object yes|no] -    [keyword yes|no] -    [minmax yes|no] -    [lowhigh yes|no] -    [units yes|no] -    [image|physical|wcs|wcsa...wcsz yes|no] -    [frame yes|no] -    [red yes|no] -    [green yes|no] -    [blue yes|no] - -Example: -string value = ds9.get(string cmd) -view layout -view keyvalue -view info -view panner -view magnifier -view buttons -view colorbar -view graph horizontal -view filename -view object -view keyword -view minmax -view lowhigh -view units -view image -view wcsa -view frame -view red - -ds9.set(string cmd) -view layout vertical -view keyvalue BITPIX -view info yes -view panner yes -view magnifier yes -view buttons yes -view colorbar yes -view graph horizontal yes -view filename yes -view object yes -view keyword yes -view minmax yes -view lowhigh yes -view units yes -view wcsa yes -view frame yes -view red yes -view green yes -view blue yes -vla -Support for VLA Sky Survey. -Syntax: -vla [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey first|stripe82] -    [open|close] - -Example: -string value = ds9.get(string cmd) -vla name -vla coord -vla size -vla save -vla frame -vla survey - -ds9.set(string cmd) -vla -vla m31 -vla name m31 -vla name clear -vla 00:42:44.404 +41:16:08.78 -vla size 60 60 arcmin -vla save yes -vla frame current -vla update frame -vla survey stripe82 -vla open -vla close -vlss -Support for NRAO VLSS Sky Survey. -Syntax: -vlss [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -string value = ds9.get(string cmd) -vlss name -vlss coord -vlss size -vlss save -vlss frame - -ds9.set(string cmd) -vlss -vlss m31 -vlss name m31 -vlss name clear -vlss 00:42:44.404 +41:16:08.78 -vlss size 60 60 arcmin -vlss save yes -vlss frame current -vlss update frame -vlss open -vlss close -vo -Invoke an connection to a Virtual Observatory site. -Syntax: -vo [method xpa|mime] -   [server <url>] -   [internal yes|no] -   [delay #] -   [<url>] -   [connect <url>] -   [disconnect <url>] -   [open|close] - -Example: -string value = ds9.get(string cmd) -vo -vo method -vo server -vo internal -vo delay -vo connect - -ds9.set(string cmd) -vo method xpa -vo server "http://foo.bar.edu/list.txt" -vo internal yes -vo delay 15 -vo chandra-ed -vo connect chandra-ed -vo disconnect chandra-ed -vo open -vo close -wcs -Controls the World Coordinate System for the current frame. If -the wcs system, skyframe, or skyformat is modified, the info panel, -compass, grid, and alignment will be modified accordingly. Also, -using this access point, a new WCS specification can be loaded and -used by the current image regardless of the WCS that was contained -in the image file. WCS specification can be sent to DS9 as an ASCII -file . Please see WCS for more -information. -Syntax: -wcs [[system] wcs|wcsa...wcsz] -    [[sky] fk4|fk5|icrs|galactic|ecliptic] -    [[skyformat] degrees|sexagesimal] -    [align yes|no] -    [reset [#]] -    [replace [#] <filename>] -    [append [#] <filename>] -    [open|close] - -Example: -string value = ds9.get(string cmd) -wcs -wcs system -wcs sky -wcs skyformat -wcs align - -ds9.set(string cmd) -wcs wcs -wcs system wcs -wcs fk5 -wcs sky fk5 -wcs sexagesimal -wcs skyformat sexagesimal -wcs align yes -wcs reset -wcs reset 3 -wcs replace foo.wcs -wcs replace 3 foo.wcs -wcs append foo.wcs -wcs append 3 foo.wcs -ds9.set(string cmd, string url) -wcs replace -wcs append -wcs open -wcs close -web -Display specified URL in the web display. -Syntax: -web [] -    [<url>] -    [new <webname> <url>] -    [<webname>] [click -back|forward|stop|reload|#] -    [<webname>] [clear] -    [<webname>] [close] - -Example: -string value = ds9.get(string cmd) -web - -ds9.set(string cmd) -web www.cnn.com -web new www.cnn.com -web hvweb www.apple.com -web click back -web click 2 -web clear -web close -width -Set the width of the image display window. -Syntax: -width [<value>] - -Example: -string value = ds9.get(string cmd) -width - -ds9.set(string cmd) -width 512 -zscale -Set Scale Limits based on the IRAF algorithm. -Syntax: -zscale [] -    [contrast] -    [sample] -    [line] - -Example: -string value = ds9.get(string cmd) -zscale contrast -zscale sample -zscale line -ds9.set(string cmd) -zscale -zscale contrast .25 -zscale sample 600 -zscale line 120 -zoom -Controls the current zoom value for the current frame. -Syntax: -zoom [<value>] -    [<value> <value>] -    [to <value>] -    [to <value> <value>] -    [in] -    [out] -    [to fit] -    [open|close] - -Example: -string value = ds9.get(string cmd) -zoom - -ds9.set(string cmd) -zoom 2 -zoom 2 4 -zoom to 4 -zoom to 2 4 -zoom in -zoom out -zoom to fit -zoom open -zoom close - + + Example: + string value = ds9.get(string cmd) + shm + + ds9.set(string cmd) + shm 102 + shm key 102 + shm shmid 102 foo + shm fits key 100 foo + shm mosaicimage iraf key 100 foo + shm mosaicimage wcs key 100 foo + shm mosaicimage wcsa key 100 foo + shm mosaicimage wfpc2 key 100 foo + shm mosaic iraf key 100 foo + shm mosaic wcs key 100 foo + shm rgbcube key 100 foo + shm rgbimage key 100 foo + shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] + shm array shmid 102 [dim=32,bitpix=-32] + + sia
+ +
Support for VO Simple Image Access protocol. The first command + will create a new search. All other commands operated on the + last search created, unless indicated otherwise.
+ Syntax: + sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [coordinate <ra> + <dec> <coordsys>] +     [<ref>] [crosshair] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [name <object>] +     [<ref>] [print] +     [<ref>] [retrieve] +     [<ref>] [save <filename>] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] + + Example: + string value = ds9.get(string cmd) + sia + + ds9.set(string cmd) + sia2mass + siacancel + siaclear + siaclose + siacoordinate 202.48 47.21 fk5 + siacrosshair + siaexport tsv bar.tsv + sianame m51 + siaprint + siaretrieve + siasave foo.xml + siaradius 1degrees + siasky fk5 + sia skyformat degrees + siasystem wcs + siaupdate + + single +
Select Single Display mode
+ Syntax: + single + + Example: + string value = ds9.get(string cmd) + single + + ds9.set(string cmd) + single + +
skyview
+
Support for SkyView image server at HEASARC.
+ Syntax: + skyview [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [pixels <width> <height>] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey <survey>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + skyview name + skyview coord + skyview size + skyview pixels + skyview save + skyview frame + skyview survey + + ds9.set(string cmd) + skyview + skyview m31 + skyview name m31 + skyview name clear + skyview 00:42:44.404 +41:16:08.78 + skyview size 60 60 arcmin + skyview pixels 600 600 + skyview save yes + skyview frame current + skyview update frame + skyview survey sdssi + skyview open + skyview close + +
sleep
+
Delays execution for specified number of seconds. Default is 1 + second.
+ Syntax: + sleep [#] + + Example: + ds9.set(string cmd) + sleep + sleep 2 + +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 + Tophat diameter =2*radius+1 + Gaussian diameter =2*radius+1,mean=0 + Elliptical Gaussian diameter =2*radius+1,mean=0Syntax: +
+ smooth [] +     [yes|no] +     [function boxcar|tophat|gaussian] +     [radius <value>] +     [radiusminor <value>] +     [sigma <value>] +     [sigmaminor <value>] +     [angle <value>] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + string value = ds9.get(string cmd) + smooth + smooth function + smooth radius + smooth radiusminor + smooth sigma + smooth sigmaminor + smooth angle + smooth lock + + ds9.set(string cmd) + smooth + smooth yes + smooth function tophat + smooth radius 4 + smooth radiusminor 4 + smooth sigma 2.0 + smooth sigmaminor 2.0 + smooth angle 45 + smooth match + smooth lock yes + smooth open + smooth close + +
source
+
Source TCL code from a file.
+ Syntax: + source [filename] + + Example: + ds9.set(string cmd) + source foo.tcl
+
tcl
+
Execute one TCL command.
+
+ Syntax: + tcl <tcl command> + + Example: + ds9.set(string cmd) + tcl {puts {Hello, World}} + +
threads
+
Set number of process threads for functions which are + multi-threaded.
+ Syntax: + threads # + + Example: + string value = ds9.get(string cmd) + threads + ds9.set(string cmd) + threads 8
+
tiff
+
Load TIFF image into current frame. Optional parameters: tiff + compression method.
+ Syntax: + tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] + + Example: + string value = ds9.get(string cmd) + tiff + tiff jpeg + + ds9.set(string cmd) + tiff foo.tiff + tiff new foo.tiff + tiff slice foo.tiff
+
tile
+
Controls the tile display mode.
+ Syntax: + tile [] +     [yes|no] +     [mode grid|column|row] +     [grid] +     [grid mode automatic|manual] +     [grid direction x|y] +     [grid layout <col> <row>] +     [grid gap <pixels>] +     [row] +     [column] + + Example: + string value = ds9.get(string cmd) + tile + tile mode + tile grid mode + tile grid direction + tile grid layout + tile grid gap + + ds9.set(string cmd) + tile + tile yes + tile mode row + tile grid + tile grid mode manual + tile grid direction x + tile grid layout 5 5 + tile grid gap 10 + tile row + tile column +
update
+
Updates the current frame or region of frame. In the second + form, the first argument is the number of the fits HDU (starting + with 1) and the remaining args are a bounding box in IMAGE + coordinates. By default, the screen is updated the next + available idle cycle. However, you may force an immediate update + by specifying the NOW option.
+ Syntax: + update [] +     [# x1 y1 x2 y2] +     [now] +     [now # x1 y1 x2 y2] + + Example: + + ds9.set(string cmd) + update + update 1 100 100 300 400 + update now + update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+ Syntax: + url <url> + + Example: + ds9.set(string cmd) + url http://foo.bar.edu/foo.fits +
version
+
Returns the current version of DS9.
+ Syntax: + version + + Example: + string value = ds9.get(string cmd) + version +
view
+
Controls the GUI.
+ Syntax: + view [layout horizontal|vertical] +     [keyvalue <string>] +     [info yes|no] +     [panner yes|no] +     [magnifier yes|no] +     [buttons yes|no] +     [colorbar yes|no] +     [colorbar horizontal|vertical] +     [colorbar numerics yes|no] +     [graph horizontal|vertical yes|no] +     [filename yes|no[ +     [object yes|no] +     [keyword yes|no] +     [minmax yes|no] +     [lowhigh yes|no] +     [units yes|no] +     [image|physical|wcs|wcsa...wcsz yes|no] +     [frame yes|no] +     [red yes|no] +     [green yes|no] +     [blue yes|no] + + Example: + string value = ds9.get(string cmd) + view layout + view keyvalue + view info + view panner + view magnifier + view buttons + view colorbar + view graph horizontal + view filename + view object + view keyword + view minmax + view lowhigh + view units + view image + view wcsa + view red
+ view frame + + + ds9.set(string cmd) + view layout vertical + view keyvalue BITPIX + view info yes + view panner yes + view magnifier yes + view buttons yes + view colorbar yes + view graph horizontal yes + view filename yes + view object yes + view keyword yes + view minmax yes + view lowhigh yes + view units yes + view wcsa yes + view frame yes + view red yes + view green yes + view blue yes
+
vla
+
Support for VLA Sky Survey.
+ Syntax: + vla [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey first|stripe82] +     [open|close] + + Example: + string value = ds9.get(string cmd) + vla name + vla coord + vla size + vla save + vla frame + vla survey + + ds9.set(string cmd) + vla + vla m31 + vla name m31 + vla name clear + vla 00:42:44.404 +41:16:08.78 + vla size 60 60 arcmin + vla save yes + vla frame current + vla update frame + vla survey stripe82 + vla open + vla close + +
vlss
+
Support for NRAO VLSS Sky Survey.
+ Syntax: + vlss [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + string value = ds9.get(string cmd) + vlss name + vlss coord + vlss size + vlss save + vlss frame + + ds9.set(string cmd) + vlss + vlss m31 + vlss name m31 + vlss name clear + vlss 00:42:44.404 +41:16:08.78 + vlss size 60 60 arcmin + vlss save yes + vlss frame current + vlss update frame + vlss open + vlss close
+
vo
+
Invoke an connection to a Virtual Observatory site.
+ Syntax: + vo [method xpa|mime] +    [server <url>] +    [internal yes|no] +    [delay #] +    [<url>] +    [connect <url>] +    [disconnect <url>] +    [open|close] + + Example: + string value = ds9.get(string cmd) + vo + vo method + vo server + vo internal + vo delay + vo connect + + ds9.set(string cmd) + vo method xpa + vo server "http://foo.bar.edu/list.txt" + vo internal yes + vo delay 15 + vo chandra-ed + vo connect chandra-ed + vo disconnect chandra-ed + vo open + vo close + +
wcs
+
Controls the World Coordinate System for the current frame. If + the wcs system, skyframe, or skyformat is modified, the info + panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
+ Syntax: + wcs [[system] wcs|wcsa...wcsz] +     [[sky] fk4|fk5|icrs|galactic|ecliptic] +     [[skyformat] degrees|sexagesimal] +     [align yes|no] +     [reset [#]] +     [replace [#] <filename>] +     [append [#] <filename>] +     [open|close] + + Example: + string value = ds9.get(string cmd) + wcs + wcs system + wcs sky + wcs skyformat + wcs align + + ds9.set(string cmd) + wcs wcs + wcs system wcs + wcs fk5 + wcs sky fk5 + wcs sexagesimal + wcs skyformat sexagesimal + wcs align yes + wcs reset + wcs reset 3 + wcs replace foo.wcs + wcs replace 3 foo.wcs + wcs append foo.wcs + wcs append 3 foo.wcs + wcs open + wcs close + +
web
+
Display specified URL in the web display.
+ Syntax: + web [] +     [<url>] +     [new <webname> <url>] +     [<webname>] [click + back|forward|stop|reload|#] +     [<webname>] [clear] +     [<webname>] [close] + + Example: + string value = ds9.get(string cmd) + web + + ds9.set(string cmd) + web www.cnn.com + web new www.cnn.com + web hvweb www.apple.com + web click back + web click 2 + web clear + web close + +
width
+
Set the width of the image display window.
+ Syntax: + width [<value>] + + Example: + string value = ds9.get(string cmd) + width + + ds9.set(string cmd) + width 512 + +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+ Syntax: + zscale [] +     [contrast] +     [sample] +     [line] + + Example: + string value = ds9.get(string cmd) + zscale contrast + zscale sample + zscale line + + ds9.set(string cmd) + zscale + zscale contrast .25 + zscale sample 600 + zscale line 120 + +
zoom
+
Controls the current zoom value for the current frame.
+ Syntax: + zoom [<value>] +     [<value> <value>] +     [to <value>] +     [to <value> <value>] +     [in] +     [out] +     [to fit] +     [open|close] + + Example: + string value = ds9.get(string cmd) + zoom + + ds9.set(string cmd) + zoom 2 + zoom 2 4 + zoom to 4 + zoom to 2 4 + zoom in + zoom out + zoom to fit + zoom open + zoom close +
+ diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index 358cd81..71e0814 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -1,3002 +1,3154 @@ - - - - -XPA Access Points - - -
XPA Access Points
-
-
The XPA messaging -system provides seamless communication between DS9 and other Unix -programs, including X programs. It also provides an easy way for -users to communicate with DS9 by executing XPA client commands in -the shell or by utilizing such commands in scripts. Because XPA -works both at the programming level and the shell level, it is a -powerful tool for unifying any analysis environment.
-2mass -3d -about -align -analysis -array -background -backup -bin -blink -block -catalog -cd -cmap -colorbar -console -contour -crop -crosshair -cube -cursor -data -dsssao -dsseso -dssstsci -envi -exit -export -file -fits -frame -gif -grid -header -height -iconify -iexam -iis -jpeg -lock -lower -magnifier -mask -match -mecube -minmax -mode -mosaic -mosaicimage -movie -multiframe -nameserver -nrrd -nvss -orient -pagesetup -pan -pixeltable -plot -png -precision -prefs -preserve -psprint -print -quit -raise -regions -restore -rgb -rgbarray -rgbcube -rgbimage -rotate -save -saveimage -scale -shm -sia -single -skyview -sleep -smooth -source -tcl -threads -tile -update -url -version -view -vla -vlss -vo -wcs -web -width -xpa -zscale -zoom -
2mass
-
Support for 2MASS Digital Sky Survey.
-Syntax: -2mass [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey j|h|k] -    [open|close] - -Example: -$xpaget ds9 2mass name -$xpaget ds9 2mass coord -$xpaget ds9 2mass size -$xpaget ds9 2mass save -$xpaget ds9 2mass frame -$xpaget ds9 2mass survey -$xpaset -p ds9 2mass -$xpaset -p ds9 2mass m31 -$xpaset -p ds9 2mass name m31 -$xpaset -p ds9 2mass name clear -$xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 2mass size 60 60 arcmin -$xpaset -p ds9 2mass save yes -$xpaset -p ds9 2mass frame current -$xpaset -p ds9 2mass update frame -$xpaset -p ds9 2mass survey j -$xpaset -p ds9 2mass open -$xpaset -p ds9 2mass close
-
3d
-
Support for 3D frame.
-Syntax: -3d [] -    [view <az> <el>] -    [az <az>] -    [el <el>] -    [scale <scale>] -    [method mip|aip] -    [background none|azimuth|elevation] -    [border yes|no] -    [border color <color>] -    [highlite yes|no] -    [highlite color <color>] -    [compass yes|no] -    [compass color <color>] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$xpaget ds9 3d view -$xpaget ds9 3d az -$xpaget ds9 3d el -$xpaget ds9 3d scale -$xpaget ds9 3d method -$xpaget ds9 3d background -$xpaget ds9 3d border -$xpaget ds9 3d border color -$xpaget ds9 3d highlite -$xpaget ds9 3d highlite color -$xpaget ds9 3d compass -$xpaget ds9 3d compass color -$xpaget ds9 3d lock -$xpaset -p ds9 3d # create new 3D frame -$xpaset -p ds9 3d view 45 30 -$xpaset -p ds9 3d az 45 -$xpaset -p ds9 3d el 30 -$xpaset -p ds9 3d scale 10 -$xpaset -p ds9 3d method mip -$xpaset -p ds9 3d background azimuth -$xpaset -p ds9 3d border yes -$xpaset -p ds9 3d border color red -$xpaset -p ds9 3d highlite yes -$xpaset -p ds9 3d highlite color red -$xpaset -p ds9 3d compass yes -$xpaset -p ds9 3d compass color red -$xpaset -p ds9 3d match -$xpaset -p ds9 3d lock yes -$xpaset -p ds9 3d open -$xpaset -p ds9 3d close
-
about
-
Get DS9 credits.
-Syntax: -about - -Example: -$xpaget ds9 about -
align
-
Controls the World Coordinate System alignment for the current -frame.
-Syntax: -align [] -    [yes|no] - -Example: -$xpaget ds9 align -$xpaset -p ds9 align yes -
analysis
-
Control external analysis tasks. Tasks are numbered as they are -loaded, starting with 0. Can also be used to display a message and -display text in the text dialog window.
-Syntax: -analysis [<task number>] -    [<filename>] -    [task <task number>|<task name>] -    [load <filename>] -    [clear] -    [clear][load <filename>] -    [message ok|okcancel|yesno <message>] -    [entry <message>] -    [text] - -Example: -$xpaget ds9 analysis -$xpaget ds9 analysis task -$xpaget ds9 analysis entry {Please enter something} -$xpaget ds9 analysis message okcancel {Hello World} -$xpaset -p ds9 analysis 0 # invoke first analysis task -$xpaset -p ds9 analysis task 0 -$xpaset -p ds9 analysis task foobar -$xpaset -p ds9 analysis {foo bar} -$xpaset -p ds9 analysis my.ans -$xpaset -p ds9 analysis load my.ans -$xpaset -p ds9 analysis clear -$xpaset -p ds9 analysis clear load my.ans -$xpaset -p ds9 analysis message {This is a message} -$xpaset -p ds9 analysis text {this is text} -$cat my.ans | xpaset ds9 analysis load -$cat foo.txt | xpaset ds9 analysis text
-
array
-
Load raw data array into current frame.
-Syntax: -array [native|little|big] -array [new|mask] + + + + + XPA Access Points + + + XPA Access Points + + The XPA + messaging system provides seamless communication between DS9 and + other Unix programs, including X programs. It also provides an + easy way for users to communicate with DS9 by executing XPA + client commands in the shell or by utilizing such commands in + scripts. Because XPA works both at the programming level and the + shell level, it is a powerful tool for unifying any analysis + environment. + + 2mass + 3d + about + align + analysis + array + background + backup + bin + blink + block + catalog + cd + cmap + colorbar + console + contour + crop + crosshair + cube + cursor + data + dsssao + dsseso + dssstsci + envi + exit + export + file + fits + frame + gif + grid + header + height + iconify + iexam + iis + jpeg + lock + lower + magnifier + mask + match + mecube + minmax + mode + mosaic + mosaicimage + movie + multiframe + nameserver + nrrd + nvss + orient + pagesetup + pan + pixeltable + plot + png + precision + prefs + preserve + psprint + print + quit + raise + regions + restore + rgb + rgbarray + rgbcube + rgbimage + rotate + save + saveimage + scale + shm + sia + single + skyview + sleep + smooth + source + tcl + threads + tile + update + url + version + view + vla + vlss + vo + wcs + web + width + xpa + zscale + zoom + + 2mass + Support for 2MASS Digital Sky Survey. + Syntax: + 2mass [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey j|h|k] +     [open|close] + + Example: + $xpaget ds9 2mass name + $xpaget ds9 2mass coord + $xpaget ds9 2mass size + $xpaget ds9 2mass save + $xpaget ds9 2mass frame + $xpaget ds9 2mass survey + + $xpaset -p ds9 2mass + $xpaset -p ds9 2mass m31 + $xpaset -p ds9 2mass name m31 + $xpaset -p ds9 2mass name clear + $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 2mass size 60 60 arcmin + $xpaset -p ds9 2mass save yes + $xpaset -p ds9 2mass frame current + $xpaset -p ds9 2mass update frame + $xpaset -p ds9 2mass survey j + $xpaset -p ds9 2mass open + $xpaset -p ds9 2mass close + 3d + Support for 3D frame. + Syntax: + 3d [] +     [view <az> <el>] +     [az <az>] +     [el <el>] +     [scale <scale>] +     [method mip|aip] +     [background none|azimuth|elevation] +     [border yes|no] +     [border color <color>] +     [highlite yes|no] +     [highlite color <color>] +     [compass yes|no] +     [compass color <color>] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $xpaget ds9 3d view + $xpaget ds9 3d az + $xpaget ds9 3d el + $xpaget ds9 3d scale + $xpaget ds9 3d method + $xpaget ds9 3d background + $xpaget ds9 3d border + $xpaget ds9 3d border color + $xpaget ds9 3d highlite + $xpaget ds9 3d highlite color + $xpaget ds9 3d compass + $xpaget ds9 3d compass color + $xpaget ds9 3d lock + + $xpaset -p ds9 3d # create new 3D frame + $xpaset -p ds9 3d view 45 30 + $xpaset -p ds9 3d az 45 + $xpaset -p ds9 3d el 30 + $xpaset -p ds9 3d scale 10 + $xpaset -p ds9 3d method mip + $xpaset -p ds9 3d background azimuth + $xpaset -p ds9 3d border yes + $xpaset -p ds9 3d border color red + $xpaset -p ds9 3d highlite yes + $xpaset -p ds9 3d highlite color red + $xpaset -p ds9 3d compass yes + $xpaset -p ds9 3d compass color red + $xpaset -p ds9 3d match + $xpaset -p ds9 3d lock yes + $xpaset -p ds9 3d open + $xpaset -p ds9 3d close + about + Get DS9 credits. + Syntax: + about + + Example: + $xpaget ds9 about + + align + Controls the World Coordinate System alignment for the current + frame. + Syntax: + align [] +     [yes|no] + + Example: + $xpaget ds9 align + + $xpaset -p ds9 align yes + + analysis + Control external analysis tasks. Tasks are numbered as they are + loaded, starting with 0. Can also be used to display a message + and display text in the text dialog window. + Syntax: + analysis [<task number>] +     [<filename>] +     [task <task number>|<task name>] +     [load <filename>] +     [clear] +     [clear][load <filename>] +     [message ok|okcancel|yesno <message>] +     [entry <message>] +     [text] + + Example: + $xpaget ds9 analysis + $xpaget ds9 analysis task + $xpaget ds9 analysis entry {Please enter something} + $xpaget ds9 analysis message okcancel {Hello World} + + $xpaset -p ds9 analysis 0 # invoke first analysis task + $xpaset -p ds9 analysis task 0 + $xpaset -p ds9 analysis task foobar + $xpaset -p ds9 analysis {foo bar} + $xpaset -p ds9 analysis my.ans + $xpaset -p ds9 analysis load my.ans + $xpaset -p ds9 analysis clear + $xpaset -p ds9 analysis clear load my.ans + $xpaset -p ds9 analysis message {This is a message} + $xpaset -p ds9 analysis text {this is text} + + $cat my.ans | xpaset ds9 analysis load + $cat foo.txt | xpaset ds9 analysis text + array + Load raw data array into current frame. + + Syntax: + array [native|little|big] + array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -$xpaget ds9 array > foo.arr -$xpaget ds9 array little > foo.arr -$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] -$xpaset -p ds9 array new -foo.arr[dim=512,bitpix=-32,endian=little] -$xpaset -p ds9 array mask -foo.arr[dim=512,bitpix=-32,endian=little] -$cat foo.arr | xpaset ds9 -array[dim=512,bitpix=-32,endian=little] -$cat foo.arr | xpaset ds9 array -new[dim=512,bitpix=-32,endian=little] -$cat foo.arr | xpaset ds9 array mask -[dim=512,bitpix=-32,endian=little] -bg -background -Set image background color. -Syntax: -bg <color> - -Example: -$xpaget ds9 bg -$xpaset -p ds9 bg red -backup -Create a backup save set. -Syntax: -backup <filename> - -Example: -$xpaset -p ds9 backup ds9.bck -bin -Controls binning factor, binning buffer size, and -binning function for binning FITS bin tables. The access point -blocking is provided for backward compatibility. -Syntax: -bin [about <x> <y>] -    [about center] -    [buffersize <value>] -    [cols <x> <y>] -    [colsz <x> <y> <z>] -    [factor <value> [<vector>]] -    [depth <value>] -    [filter <string>] -    [filter clear] -    [function average|sum] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$xpaget ds9 bin about -$xpaget ds9 bin buffersize -$xpaget ds9 bin cols -$xpaget ds9 bin factor -$xpaget ds9 bin depth -$xpaget ds9 bin filter -$xpaget ds9 bin function -$xpaget ds9 bin smooth -$xpaget ds9 bin smooth function -$xpaget ds9 bin smooth radius -$xpaget ds9 bin lock -$xpaset -p ds9 bin about 4096 4096 -$xpaset -p ds9 bin about center -$xpaset -p ds9 bin buffersize 512 -$xpaset -p ds9 bin cols detx dety -$xpaset -p ds9 bin colsz detx dety time -$xpaset -p ds9 bin factor 4 -$xpaset -p ds9 bin factor 4 2 -$xpaset -p ds9 bin depth 10 -$xpaset -p ds9 bin filter 'pha > 5' -$xpaset -p ds9 bin filter clear -$xpaset -p ds9 bin function sum -$xpaset -p ds9 bin in -$xpaset -p ds9 bin out -$xpaset -p ds9 bin to fit -$xpaset -p ds9 bin match -$xpaset -p ds9 bin lock yes -$xpaset -p ds9 bin open -$xpaset -p ds9 bin close -blink -Blink mode parameters. Interval is in seconds. -Syntax: -blink [] -    [yes|no] -    [interval <value>] - -Example: -$xpaget ds9 blink -$xpaget ds9 blink interval -$xpaset -p ds9 blink -$xpaset -p ds9 blink yes -$xpaset -p ds9 blink interval 1 -block -Controls blocking parameters. -Syntax: -block[<value>] -    [<value> <value>] -    [to <value>] -    [to <value><value>] -    [in] -    [out] -    [to fit] -    [match] -    [lock [yes|no]] -    [open|close] - -Example: -$xpaget ds9 block -$xpaget ds9 block lock -$xpaset -p ds9 block 4 -$xpaset -p ds9 block 4 2 -$xpaset -p ds9 block to 4 -$xpaset -p ds9 block to 4 2 -$xpaset -p ds9 block in -$xpaset -p ds9block out -$xpaset -p ds9 block to fit -$xpaset -p ds9 block match -$xpaset -p ds9 block lock yes -$xpaset -p ds9 block open -$xpaset -p ds9 block close -catalog -cat -Support for catalogs. The first three commands will create a new -catalog search. All other commands operated on the last search -created, unless indicated otherwise. -Syntax: -catalog [new] -    [ned|simbad|denis|skybot] -    + + Example: + $xpaget ds9 array > foo.arr + $xpaget ds9 array little > foo.arr + + $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] + $xpaset -p ds9 array new + foo.arr[dim=512,bitpix=-32,endian=little] + $xpaset -p ds9 array mask + foo.arr[dim=512,bitpix=-32,endian=little] + + $cat foo.arr | xpaset ds9 + array[dim=512,bitpix=-32,endian=little] + $cat foo.arr | xpaset ds9 array + new[dim=512,bitpix=-32,endian=little] + $cat foo.arr | xpaset ds9 array mask + [dim=512,bitpix=-32,endian=little] + bg + background + Set image background color. + Syntax: + bg <color> + + Example: + $xpaget ds9 bg + + $xpaset -p ds9 bg red + backup + Create a backup save set. + Syntax: + backup <filename> + + Example: + $xpaset -p ds9 backup ds9.bck + bin + Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables. The access point blocking + is provided for backward compatibility. + Syntax: + bin [about <x> <y>] +     [about center] +     [buffersize <value>] +     [cols <x> <y>] +     [colsz <x> <y> <z>] +     [factor <value> [<vector>]] +     [depth <value>] +     [filter <string>] +     [filter clear] +     [function average|sum] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $xpaget ds9 bin about + $xpaget ds9 bin buffersize + $xpaget ds9 bin cols + $xpaget ds9 bin factor + $xpaget ds9 bin depth + $xpaget ds9 bin filter + $xpaget ds9 bin function + $xpaget ds9 bin smooth + $xpaget ds9 bin smooth function + $xpaget ds9 bin smooth radius + $xpaget ds9 bin lock + + $xpaset -p ds9 bin about 4096 4096 + $xpaset -p ds9 bin about center + $xpaset -p ds9 bin buffersize 512 + $xpaset -p ds9 bin cols detx dety + $xpaset -p ds9 bin colsz detx dety time + $xpaset -p ds9 bin factor 4 + $xpaset -p ds9 bin factor 4 2 + $xpaset -p ds9 bin depth 10 + $xpaset -p ds9 bin filter 'pha > 5' + $xpaset -p ds9 bin filter clear + $xpaset -p ds9 bin function sum + $xpaset -p ds9 bin in + $xpaset -p ds9 bin out + $xpaset -p ds9 bin to fit + $xpaset -p ds9 bin match + $xpaset -p ds9 bin lock yes + $xpaset -p ds9 bin open + $xpaset -p ds9 bin close + blink + Blink mode parameters. Interval is in seconds. + + Syntax: + blink [] +     [yes|no] +     [interval <value>] + + Example: + $xpaget ds9 blink + $xpaget ds9 blink interval + + $xpaset -p ds9 blink + $xpaset -p ds9 blink yes + $xpaset -p ds9 blink interval 1 + block + Controls blocking parameters. + Syntax: + block[<value>] +     [<value> <value>] +     [to <value>] +     [to <value><value>] +     [in] +     [out] +     [to fit] +     [match] +     [lock [yes|no]] +     [open|close] + + Example: + $xpaget ds9 block + $xpaget ds9 block lock + + $xpaset -p ds9 block 4 + $xpaset -p ds9 block 4 2 + $xpaset -p ds9 block to 4 + $xpaset -p ds9 block to 4 2 + $xpaset -p ds9 block in + $xpaset -p ds9block out + $xpaset -p ds9 block to fit + $xpaset -p ds9 block match + $xpaset -p ds9 block lock yes + $xpaset -p ds9 block open + $xpaset -p ds9 block close + catalog + cat + + Support for catalogs. The first three commands will create a + new catalog search. All other commands operated on the last + search created, unless indicated otherwise. + Syntax: + catalog [new] +     [ned|simbad|denis|skybot] +     [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] - -    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -    [2mass|iras] -    [csc|xmm|rosat] -    [first|nvss] -    [chandralog|cfhtlog|esolog|stlog|xmmlog] -    [cds <catalogname>] -    [cds <catalogid>] - -    [load <filename>] -    [import sb|tsv <filename>] - -    [<ref>] [<ra> <dec> -<coordsys>] -    [<ref>] [allcols] -    [<ref>] [allrows] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [crosshair] -    [<ref>] [dec <col>] -    [<ref>] [edit yes|no] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [filter <string>] -    [<ref>] [filter load <filename>] -    [<ref>] [header] -    [<ref>] [location <code>] -    [<ref>] [match] -    [<ref>] [match <ref> -<ref>] -    [<ref>] [match error <value> -degrees|arcmin|arcsec] -    [<ref>] [match function -1and2|1not2|2not1] -    [<ref>] [match return -1and2|1only|2only] -    [<ref>] [match unique yes|no] -    [<ref>] [maxrows <number>] -    [<ref>] [name <object>] -    [<ref>] [panto yes|no] -    [<ref>] [plot <xcol> <ycol> -<xerrcol> <yerrcol>] -    [<ref>] [print] -    [<ref>] [psky <skyframe>] -    [<ref>] [psystem <coordsys>] -    [<ref>] [ra <col>] -    [<ref>] [regions] -    [<ref>] [retrieve] -    [<ref>] [samp] -    [<ref>] [samp broadcast] -    [<ref>] [samp send -<application>] -    [<ref>] [save <filename>] -    [<ref>] [server -cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -    [<ref>] [show yes|no] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [sort <col> incr|decr] -    [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>] -    [<ref>] [symbol [#] -text|size|size2|units|angle <value>] -    [<ref>] [symbol shape -circle|ellipse|box|text|point] -    [<ref>] [symbol shapecircle point|box -point|diamond point|cross point|x point|arrow point|boxcircle -point] -    [<ref>] [symbol add| [#] remove] -    [<ref>] [symbol save|load -<filename>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] -    [<ref>] [x <col>] -    [<ref>] [y <col>] - -Example: -$xpaget ds9 catalog -$xpaget ds9 catalog header - -$xpaset -p ds9 catalog new -$xpaset -p ds9 catalog 2mass -$xpaset -p ds9 catalog cds 2mass -$xpaset -p ds9 catalog cds {I/252} - -$xpaset -p ds9 catalog load foo.xml -$xpaset -p ds9 catalog import tsv foo.tsv - -$xpaset -p ds9 catalog 202.48 47.21 fk5 -$xpaset -p ds9 catalog allrows -$xpaset -p ds9 catalog allcols -$xpaset -p ds9 catalog cancel -$xpaset -p ds9 catalog clear -$xpaset -p ds9 catalog close -$xpaset -p ds9 catalog crosshair -$xpaset -p ds9 catalog dec DEC -$xpaset -p ds9 catalog edit yes -$xpaset -p ds9 catalog export tsv bar.tsv -$xpaset -p ds9 catalog filter '$Jmag>10' -$xpaset -p ds9 catalog filter load foo.flt -$xpaset -p ds9 catalog header -$xpaset -p ds9 catalog location 500 -$xpaset -p ds9 catalog match error 2 arcsec -$xpaset -p ds9 catalog match function 1and2 -$xpaset -p ds9 catalog match unique no -$xpaset -p ds9 catalog match return 1only -$xpaset -p ds9 catalog match # last two catalogs loaded -$xpaset -p ds9 catalog match 2mass csc -$xpaset -p ds9 catalog maxrows 2000 -$xpaset -p ds9 catalog name m51 -$xpaset -p ds9 catalog panto no -$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag' -$xpaset -p ds9 catalog print -$xpaset -p ds9 catalog psky fk5 -$xpaset -p ds9 catalog psystem wcs -$xpaset -p ds9 catalog ra RA -$xpaset -p ds9 catalog regions -$xpaset -p ds9 catalog retrieve -$xpaset -p ds9 catalog samp broadcast -$xpaset -p ds9 catalog samp send aladin -$xpaset -p ds9 catalog save foo.xml -$xpaset -p ds9 catalog server sao -$xpaset -p ds9 catalog show yes -$xpaset -p ds9 catalog radius 1 degrees -$xpaset -p ds9 catalog symbol condition '$Jmag>15' -$xpaset -p ds9 catalog symbol 2 shape {boxcircle point} -$xpaset -p ds9 catalog symbol color red -$xpaset -p ds9 catalog symbol font times -$xpaset -p ds9 catalog symbol fontsize 14 -$xpaset -p ds9 catalog symbol fontweight bold -$xpaset -p ds9 catalog symbol fontslant italic -$xpaset -p ds9 catalog symbol add -$xpaset -p ds9 catalog symbol 2 remove -$xpaset -p ds9 catalog symbol load foo.sym -$xpaset -p ds9 catalog symbol save bar.sym -$xpaset -p ds9 catalog sky fk5 -$xpaset -p ds9 catalog skyformat degrees -$xpaset -p ds9 catalog sort {Jmag} incr -$xpaset -p ds9 catalog system wcs -$xpaset -p ds9 catalog update -$xpaset -p ds9 catalog x RA -$xpaset -p ds9 catalog y DEC -cd -Sets/Returns the current working directory. -Syntax: -cd [<directory>] - -Example: -$xpaget ds9 cd -$xpaset -p ds9 cd /home/mrbill -cmap -Controls the colormap for the current frame. The colormap name -is not case sensitive. A valid contrast value is from 0 to 10 -and bias value from 0 to 1. -Syntax: -cmap [<colormap>] -    [file] -    [load <filename>] -    [save <filename>] -    [invert yes|no] -    [<constrast> <bias>] -    [tag [load|save] <filename>] -    [tag delete] -    [open|close] - -Example: -$xpaget ds9 cmap -$xpaget ds9 cmap file -$xpaget ds9 cmap invert -$xpaget ds9 cmap value -$xpaset -p ds9 cmap Heat -$xpaset -p ds9 cmap load foo.sao -$xpaset -p ds9 cmap save bar.sao -$xpaset -p ds9 cmap invert yes -$xpaset -p ds9 cmap 5 .5 -$xpaset -p ds9 cmap tag load foo.tag -$xpaset -p ds9 cmap tag save foo.tag -$xpaset -p ds9 cmap tag delete -$xpaset -p ds9 cmap open -$xpaset -p ds9 cmap close -colorbar -Controls colorbar parameters. -Syntax: -colorbar [] -    [yes|no] -    [orientation] -    [horizontal|vertical] -    [numerics yes|no] -    [space value|distance] -    [font times|helvetica|courier] -    [fontsize <value>] -    [fontweight normal|bold] -    [fontslant roman|italic] -    [size] -    [ticks] -    [match] -    [lock [yes|no]] - -Example: -$xpaget ds9 colorbar -$xpaget ds9 colorbar orientation -$xpaget ds9 colorbar numerics -$xpaget ds9 colorbar space -$xpaget ds9 colorbar font -$xpaget ds9 colorbar fontsize -$xpaget ds9 colorbar fontweight -$xpaget ds9 colorbar fontslant -$xpaget ds9 colorbar size -$xpaget ds9 colorbar ticks -$xpaget ds9 colorbar lock -$xpaset -p ds9 colorbar yes -$xpaset -p ds9 colorbar vertical -$xpaset -p ds9 colorbar orientation vertical -$xpaset -p ds9 colorbar numerics yes -$xpaset -p ds9 colorbar space value -$xpaset -p ds9 colorbar font times -$xpaset -p ds9 colorbar fontsize 14 -$xpaset -p ds9 colorbar fontweight bold -$xpaset -p ds9 colorbar fontslant italic -$xpaset -p ds9 colorbar size 20 -$xpaset -p ds9 colorbar ticks 11 -$xpaset -p ds9 colorbar match -$xpaset -p ds9 colorbar lock yes -console -Display tcl console window. -Syntax: --console - -Example: -$xpaset -p ds9 console -contour -Controls contours in the current frame. -Syntax: -contour [] -    [yes|no] -    [<coordsys> [<skyframe>]] -    [clear] -    [generate] -    [load <filename>] -    [save <filename> [<coordsys> -<skyframe>]] -    [convert] -    [load levels <filename>] -    [save levels <filename>] -    [copy] -    [paste [<coordsys> <color> -<width> yes|no]] -    [color <color>] -    [width <width>] -    [dash yes|no] -    [smooth <smooth>] -    [method block|smooth] -    [nlevels <number of levels>] -    [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ] -    [log exp <value>] -    [mode minmax|<value>|zscale|zmax] -    [scope global|local] -    [limits <min> <max>] -    [levels <value value value...>] -    [open|close] - -Example: -$xpaget ds9 contour -$xpaget ds9 contour wcs fk5 -$xpaget ds9 contour color -$xpaget ds9 contour width -$xpaget ds9 contour dash -$xpaget ds9 contour smooth -$xpaget ds9 contour method -$xpaget ds9 contour nlevels -$xpaget ds9 contour scale -$xpaget ds9 contour log exp -$xpaget ds9 contour mode -$xpaget ds9 contour scope -$xpaget ds9 contour limits -$xpaget ds9 contour levels -$xpaset -p ds9 contour -$xpaset -p ds9 contour yes -$xpaset -p ds9 contour clear -$xpaset -p ds9 contour generate -$xpaset -p ds9 contour load ds9.ctr -$xpaset -p ds9 contour save ds9.ctr -$xpaset -p ds9 contour save ds9.ctr wcs fk5 -$xpaset -p ds9 contour convert -$xpaset -p ds9 contour load levels ds9.ctr -$xpaset -p ds9 contour save levels ds9.lev -$xpaset -p ds9 contour copy -$xpaset -p ds9 contour paste -$xpaset -p ds9 contour paste wcs red 2 no -$xpaset -p ds9 contour color yellow -$xpaset -p ds9 contour width 2 -$xpaset -p ds9 contour dash yes -$xpaset -p ds9 contour smooth 5 -$xpaset -p ds9 contour method smooth -$xpaset -p ds9 contour nlevels 10 -$xpaset -p ds9 contour scale sqrt -$xpaset -p ds9 contour log exp 1000 -$xpaset -p ds9 contour mode zscale -$xpaset -p ds9 contour scope local -$xpaset -p ds9 contour limits 1 100 -$xpaset -p ds9 contour levels 1 10 100 1000 -$xpaset -p ds9 contour open -$xpaset -p ds9 contour close -crop -Set current image display area. -Syntax: -crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec] -    [match <coordsys>] -    [lock <coordsys>|none] -    [reset] -    [3d zmin zmax <coordsys>] -    [open|close] - -Example: -$xpaget ds9 crop # get crop in physical coords -$xpaget ds9 crop wcs galactic sexagesimal arcsec -$xpaget ds9 crop lock -$xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords -$xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 -22.000204 wcs galactic arcsec -$xpaset -p ds9 crop match wcs -$xpaset -p ds9 crop lock wcs -$xpaset -p ds9 crop reset -$xpaset -p ds9 crop 3d .25 .50 wcs -$xpaset -p ds9 crop open -$xpaset -p ds9 crop close -crosshair -Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set. -Syntax: -crosshair [<x> <y> <coordsys> -[<skyframe>]] -    [match <coordsys>] -    [lock <coordsys>|none] - -Example: -$xpaget ds9 crosshair # get crosshair in physical coords -$xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs -coords -$xpaget ds9 crosshair lock -$xpaset -p ds9 crosshair 100 100 physical # set crosshair in -physical -$xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs -coords -$xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 -$xpaset -p ds9 crosshair match wcs -$xpaset -p ds9 crosshair lock wcs -cube -Controls FITS cube dialog. -Syntax: -cube [] -    [play|stop|next|prev|first|last] -    [<slice> [<coordsys>]] -    [interval <numeric>] -    [match <coordsys>] -    [lock <coordsys>|none] -    [order 123|132|213|231|312|321] -    [axes lock [yes|no]] -    [open|close] - -Example: -$xpaget ds9 cube -$xpaget ds9 cube wcs -$xpaget ds9 cube interval -$xpaget ds9 cube lock -$xpaget ds9 cube order -$xpaget ds9 cube axes lock -$xpaset -p ds9 cube -$xpaset -p ds9 cube play -$xpaset -p ds9 cube last -$xpaset -p ds9 cube 3 -$xpaset -p ds9 cube 4.4 wcs -$xpaset -p ds9 cube interval 2 -$xpaset -p ds9 cube match wcs -$xpaset -p ds9 cube lock wcs -$xpaset -p ds9 cube order 123 -$xpaset -p ds9 cube axes lock yes -$xpaset -p ds9 cube open -$xpaset -p ds9 cube close -cursor -Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also. -Syntax: -cursor [<x> <y>] - -Example: -$xpaset -p ds9 cursor 10 10 -data -Return an array of data values given a lower left corner and a -width and height in specified coordinate system. The last argument -of yes indicates to strip the coordinates from the output and just -list the data values. The default is yes. -Syntax: -data [<coordsys> [<skyframe>] <x> <y> -<width> <height> [yes|no]] - -Example: -$xpaget ds9 data image 450 520 3 3 yes -$xpaget ds9 data physical 899 1039 6 6 no -$xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 -0.00016516669 no -$xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 -0.00016516669 no -dsssao -dss -Support for Digital Sky Survey at SAO. -Syntax: -dsssao [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$xpaget ds9 dsssao name -$xpaget ds9 dsssao coord -$xpaget ds9 dsssao size -$xpaget ds9 dsssao save -$xpaget ds9 dsssao frame -$xpaset -p ds9 dsssao -$xpaset -p ds9 dsssao m31 -$xpaset -p ds9 dsssao name m31 -$xpaset -p ds9 dsssao name clear -$xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 dsssao size 60 60 arcmin -$xpaset -p ds9 dsssao save yes -$xpaset -p ds9 dsssao frame current -$xpaset -p ds9 dsssao update frame -$xpaset -p ds9 dsssao open -$xpaset -p ds9 dsssao close -dsseso -Support for Digital Sky Survey at ESO. -Syntax: -dsseso [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -    [open|close] - -Example: -$xpaget ds9 dsseso name -$xpaget ds9 dsseso coord -$xpaget ds9 dsseso size -$xpaget ds9 dsseso save -$xpaget ds9 dsseso frame -$xpaget ds9 dsseso survey -$xpaset -p ds9 dsseso -$xpaset -p ds9 dsseso m31 -$xpaset -p ds9 dsseso name m31 -$xpaset -p ds9 dsseso name clear -$xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 dsseso size 60 60 arcmin -$xpaset -p ds9 dsseso save yes -$xpaset -p ds9 dsseso frame current -$xpaset -p ds9 dsseso update frame -$xpaset -p ds9 dsseso survey DSS2-red -$xpaset -p ds9 dsseso open -$xpaset -p ds9 dsseso close -dssstsci -Support for Digital Sky Survey at STSCI. -Syntax: -dssstsci [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -    [survey poss1_blue|poss1_red] -    [survey all|quickv|phase2_gsc2|phase2_gsc1] -    [open|close] - -Example: -$xpaget ds9 dssstsci name -$xpaget ds9 dssstsci coord -$xpaget ds9 dssstsci size -$xpaget ds9 dssstsci save -$xpaget ds9 dssstsci frame -$xpaget ds9 dssstsci survey -$xpaset -p ds9 dssstsci -$xpaset -p ds9 dssstsci m31 -$xpaset -p ds9 dssstsci name m31 -$xpaset -p ds9 dssstsci name clear -$xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 dssstsci size 60 60 arcmin -$xpaset -p ds9 dssstsci save yes -$xpaset -p ds9 dssstsci frame current -$xpaset -p ds9 dssstsci update frame -$xpaset -p ds9 dssstsci survey all -$xpaset -p ds9 dssstsci open -$xpaset -p ds9 dssstsci close -envi -Load an ENVI header and file. Optional parameter: array -endian. -Syntax: -envi [new] <header> [<filename>] - -Example: -$xpaset -p ds9 envi foo.hdr -$xpaset -p ds9 envi new foo.hdr -$xpaset -p ds9 envi foo.hdr foo.bsq - -exit -quits -Quits DS9. -Syntax: -exit -quit - -Example: -$xpaset -p ds9 exit -export -Export loaded image data of current frame in specified image -format. Optional parameters: array endian, nrrd endian, jpeg -quality (1-100) and tiff compression method. -Syntax: -export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> -export array <filename>[big|little|native] -export nrrd <filename>[big|little|native] -export envi <header> -[<filename>][big|little|native] -export jpeg <filename>[1-100] -export tiff <filename>[none|jpeg|packbits|deflate] - -Example: -$xpaset -p ds9 export array foo.arr little -$xpaset -p ds9 export nrrd foo.nrrd little -$xpaset -p ds9 export envi foo.hdr little -$xpaset -p ds9 export envi foo.hdr foo.bsq little -$xpaset -p ds9 export tiff foo.tiff jpeg -$xpaset -p ds9 export jpeg foo.jpeg 75 -$xpaset -p ds9 export png foo.png -file -Query currently loaded file information. -Syntax: -file - -Example: -$xpaget ds9 file -fits -Load a FITS image into the current frame or query the currently -loaded image. -Syntax: -fits[new|mask|slice] [<filename>] -    [width|height|depth|bitpix] -    [size [wcs|wcsa...wcsz] -[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -    [header [<ext>] [keyword -<string>]] -    [image|table|slice] - -Example: -$xpaget ds9 fits > foo.fits -$xpaget ds9 fits width -$xpaget ds9 fits height -$xpaget ds9 fits depth -$xpaget ds9 fits bitpix -$xpaget ds9 fits size -$xpaget ds9 fits size wcs fk5 arcmin -$xpaget ds9 fits header # primary -$xpaget ds9 fits header 2 # hdu 2 -$xpaget ds9 fits header -2 # hdu 2 with inherit -$xpaget ds9 fits header keyword BITPIX -$xpaget ds9 fits header 1 keyword BITPIX -$xpaget ds9 fits image > foo.fits -$xpaget ds9 fits table > bar.fits -$xpaget ds9 fits slice > foo.fits -$xpaset -p ds9 fits foo.fits -$xpaset -p ds9 fits new foo.fits -$xpaset -p ds9 fits bar.fits[bin=detx,dety] -$xpaset -p ds9 fits slice foo.fits -$xpaset -p ds9 fits mask foo.fits -$cat foo.fits | xpaset ds9 fits -$cat foo.fits | xpaset ds9 fits new -$cat bar.fits | xpaset ds9 fits -[bin=detx,dety] -$cat foo.fits | xpaset ds9 fits slice -$cat foo.fits | xpaset ds9 fits mask -frame -Controls frame functions. Frames may be created, deleted, reset, -and centered. While return the current frame number. If you goto a -frame that does not exists, it will be created. If the frame is -hidden, it will be shown. The 'frameno' option is available for -backward compatibility. -Syntax: -frame [center [#|all]] -    [clear [#|all]] -    [new [rgb|3d]] -    [delete [#|all]] -    [reset [#|all]] -    [refresh [#|all]] -    [hide [#|all]] -    [show [#|all]] -    [move first] -    [move back] -    [move forward] -    [move last] -    [first] -    [prev] -    [next] -    [last] -    [frameno #] -    [#] -    [match <coordsys>] -    [lock <coordsys>|none] -    [has -[amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] - -    [has contour [aux]]] -    [has fits [bin|cube|mosaic]] -    [has marker [highlite|paste|select|undo]] -    [has system <coordsys>] -    [has wcs [<wcssys>]] -    [has wcs celestial [<wcssys>]] -    [has wcs linear [<wcssys>]] - -Example: -$xpaget ds9 frame # returns the id of the current frame -$xpaget ds9 frame frameno # returns the id of the current frame -$xpaget ds9 frame all # returns the id of all frames -$xpaget ds9 frame active # returns the id of all active frames -$xpaget ds9 frame lock -$xpaget ds9 frame has amplifier -$xpaget ds9 frame has datamin -$xpaget ds9 frame has datasec -$xpaget ds9 frame has detector -$xpaget ds9 frame has grid -$xpaget ds9 frame has iis -$xpaget ds9 frame has irafmin -$xpaget ds9 frame has physical -$xpaget ds9 frame has smooth -$xpaget ds9 frame has contour -$xpaget ds9 frame has contour aux -$xpaget ds9 frame has fits -$xpaget ds9 frame has fits bin -$xpaget ds9 frame has fits cube -$xpaget ds9 frame has fits mosaic -$xpaget ds9 frame has marker highlite -$xpaget ds9 frame has marker paste -$xpaget ds9 frame has marker select -$xpaget ds9 frame has marker undo -$xpaget ds9 frame has system physical -$xpaget ds9 frame has wcs wcsa -$xpaget ds9 frame has wcs celestial wcsa -$xpaget ds9 frame has wcs linear wcsa -$xpaset -p ds9 frame center # center current frame -$xpaset -p ds9 frame center 1 # center 'Frame1' -$xpaset -p ds9 frame center all # center all frames -$xpaset -p ds9 frame clear # clear current frame -$xpaset -p ds9 frame new # create new frame -$xpaset -p ds9 frame new rgb # create new rgb frame -$xpaset -p ds9 frame delete # delete current frame -$xpaset -p ds9 frame reset # reset current frame -$xpaset -p ds9 frame refresh # refresh current frame -$xpaset -p ds9 frame hide # hide current frame -$xpaset -p ds9 frame show 1 # show frame 'Frame1' -$xpaset -p ds9 frame move first # move frame to first in order -$xpaset -p ds9 frame move back # move frame back in order -$xpaset -p ds9 frame move forward # move frame forward in order -$xpaset -p ds9 frame move last # move frame to last in order -$xpaset -p ds9 frame first # goto first frame -$xpaset -p ds9 frame prev # goto prev frame -$xpaset -p ds9 frame next # goto next frame -$xpaset -p ds9 frame last # goto last frame -$xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if -needed -$xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed -$xpaset -p ds9 frame match wcs -$xpaset -p ds9 frame lock wcs -gif -Load GIF image into current frame. -Syntax: -gif [new|slice] [<filename>] - -Example: -$xpaget ds9 gif > foo.gif -$xpaset -p ds9 gif foo.gif -$xpaset -p ds9 gif new foo.gif -$xpaset -p ds9 gif slice foo.gif -$cat foo.gif | xpaset ds9 gif # not available windows -$cat foo.gif | xpaset ds9 gifnew # not available windows -$cat foo.gif | xpaset ds9 gifslice# not available windows -grid -Controls coordinate grid. For grid numeric format syntax, -click here. -Syntax: -grid [] -    [yes|no] -    [type analysis|publication] -    [system <coordsys>] -    [sky <skyframe>] -    [skyformat <skyformat>] -    [grid yes|no] -    [grid color <color>] -    [grid width <value>] -    [grid dash yes|no] -    [grid gap1 <value>] -    [grid gap2 <value>] -    [grid gap3 <value>] -    [axes yes|no] -    [axes color <color>] -    [axes width <value>] -    [axes dash yes|no] -    [axes type interior|exterior] -    [axes origin -lll|llu|lul|luu|ull|ulu|uul|uuu] -    [format1 <format>] -    [format2 <format>] -    [tickmarks yes|no] -    [tickmarks color <color>] -    [tickmarks width <value>] -    [tickmarks dash yes|no] -    [border yes|no] -    [border color <color>] -    [border width <value>] -    [border dash yes|no] -    [numerics yes|no] -    [numerics font times|helvetica|courier] -    [numerics fontsize <value>] -    [numerics fontweight normal|bold] -    [numerics fontslant roman|italic] -    [numerics color <color>] -    [numerics gap1 <value>] -    [numerics gap2 <value>] -    [numerics gap3 <value>] -    [numerics type interior|exterior] -    [numerics vertical yes|no] -    [title yes|no] -    [title text <text>] -    [title def yes|no] -    [title gap <value>] -    [title font times|helvetica|courier] -    [title fontsize <value>] -    [title fontweight normal|bold] -    [title fontslant roman|italic] -    [title color <color>] -    [labels yes|no] -    [labels def1 yes|no] -    [labels def2 yes|no] -    [labels text1 <text>] -    [labels text2 <text>] -    [labels gap1 <value>] -    [labels gap2 <value>] -    [labels font times|helvetica|courier] -    [labels fontsize <value>] -    [labels fontweight normal|bold] -    [labels fontslant roman|italic] -    [labels color <color>] -    [reset] -    [load <filename>] -    [save <filename>] -    [open|close] - -Example: -$xpaget ds9 grid -$xpaget ds9 grid type -$xpaget ds9 grid system -$xpaget ds9 grid sky -$xpaget ds9 grid skyformat -$xpaget ds9 grid grid -$xpaget ds9 grid grid color -$xpaget ds9 grid grid width -$xpaget ds9 grid grid dash -$xpaget ds9 grid grid gap1 -$xpaget ds9 grid grid gap2 -$xpaget ds9 grid grid gap3 -$xpaget ds9 grid axes -$xpaget ds9 grid axes color -$xpaget ds9 grid axes width -$xpaget ds9 grid axes dash -$xpaget ds9 grid axes type -$xpaget ds9 grid axes origin -$xpaget ds9 grid format1 -$xpaget ds9 grid format2 -$xpaget ds9 grid tickmarks -$xpaget ds9 grid tickmarks color -$xpaget ds9 grid tickmarks width -$xpaget ds9 grid tickmarks dash -$xpaget ds9 grid border -$xpaget ds9 grid border color -$xpaget ds9 grid border width -$xpaget ds9 grid border dash -$xpaget ds9 grid numerics -$xpaget ds9 grid numerics font -$xpaget ds9 grid numerics fontsize -$xpaget ds9 grid numerics fontweight -$xpaget ds9 grid numerics fontslant -$xpaget ds9 grid numerics color -$xpaget ds9 grid numerics gap1 -$xpaget ds9 grid numerics gap2 -$xpaget ds9 grid numerics gap3 -$xpaget ds9 grid numerics type -$xpaget ds9 grid numerics vertical -$xpaget ds9 grid title -$xpaget ds9 grid title text -$xpaget ds9 grid title def -$xpaget ds9 grid title gap -$xpaget ds9 grid title font -$xpaget ds9 grid title fontsize -$xpaget ds9 grid title fontweight -$xpaget ds9 grid title fontslant -$xpaget ds9 grid title color -$xpaget ds9 grid labels -$xpaget ds9 grid labels text1 -$xpaget ds9 grid labels def1 -$xpaget ds9 grid labels gap1 -$xpaget ds9 grid labels text2 -$xpaget ds9 grid labels def2 -$xpaget ds9 grid labels gap2 -$xpaget ds9 grid labels font -$xpaget ds9 grid labels fontsize -$xpaget ds9 grid labels fontweight -$xpaget ds9 grid labels fontslant -$xpaget ds9 grid labels color -$xpaset -p ds9 grid -$xpaset -p ds9 grid yes -$xpaset -p ds9 grid type analysis -$xpaset -p ds9 grid system wcs -$xpaset -p ds9 grid sky fk5 -$xpaset -p ds9 grid skyformat degrees -$xpaset -p ds9 grid grid yes -$xpaset -p ds9 grid grid color red -$xpaset -p ds9 grid grid width 2 -$xpaset -p ds9 grid grid dash yes -$xpaset -p ds9 grid grid gap1 10 -$xpaset -p ds9 grid grid gap2 10 -$xpaset -p ds9 grid grid gap3 10 -$xpaset -p ds9 grid axes yes -$xpaset -p ds9 grid axes color red -$xpaset -p ds9 grid axes width 2 -$xpaset -p ds9 grid axes dash yes -$xpaset -p ds9 grid axes type exterior -$xpaset -p ds9 grid axes origin lll -$xpaset -p ds9 grid format1 d.2 -$xpaset -p ds9 grid format2 d.2 -$xpaset -p ds9 grid tickmarks yes -$xpaset -p ds9 grid tickmarks color red -$xpaset -p ds9 grid tickmarks width 2 -$xpaset -p ds9 grid tickmarks dash yes -$xpaset -p ds9 grid border yes -$xpaset -p ds9 grid border color red -$xpaset -p ds9 grid border width 2 -$xpaset -p ds9 grid border dash yes -$xpaset -p ds9 grid numerics yes -$xpaset -p ds9 grid numerics font courier -$xpaset -p ds9 grid numerics fontsize 12 -$xpaset -p ds9 grid numerics fontweight bold -$xpaset -p ds9 grid numerics fontslant italic -$xpaset -p ds9 grid numerics color red -$xpaset -p ds9 grid numerics gap1 10 -$xpaset -p ds9 grid numerics gap2 10 -$xpaset -p ds9 grid numerics gap3 10 -$xpaset -p ds9 grid numerics type exterior -$xpaset -p ds9 grid numerics vertical yes -$xpaset -p ds9 grid title yes -$xpaset -p ds9 grid title text {Hello World} -$xpaset -p ds9 grid title def yes -$xpaset -p ds9 grid title gap 10 -$xpaset -p ds9 grid title font courier -$xpaset -p ds9 grid title fontsize 12 -$xpaset -p ds9 grid title fontweight bold -$xpaset -p ds9 grid title fontslant italic -$xpaset -p ds9 grid title color red -$xpaset -p ds9 grid labels yes -$xpaset -p ds9 grid labels text1 {Hello World} -$xpaset -p ds9 grid labels def1 yes -$xpaset -p ds9 grid labels gap1 10 -$xpaset -p ds9 grid labels text2 {Hello World} -$xpaset -p ds9 grid labels def2 yes -$xpaset -p ds9 grid labels gap2 10 -$xpaset -p ds9 grid labels font courier -$xpaset -p ds9 grid labels fontsize 12 -$xpaset -p ds9 grid labels fontweight boldj -$xpaset -p ds9 grid labels fontslant italic -$xpaset -p ds9 grid labels color red -$xpaset -p ds9 grid reset -$xpaset -p ds9 grid load foo.grd -$xpaset -p ds9 grid save foo.grd -$xpaset -p ds9 grid open -$xpaset -p ds9 grid close -header -Display current fits header dialog. Optional extension number -maybe specified. Please note, this differs from xpa fits -header. -Syntax: -header [<ext>] -    [close [<ext>]] -    [save [<ext>] <filename>] - -Example: -$xpaset -p ds9 header -$xpaset -p ds9 header 2 -$xpaset -p ds9 header close -$xpaset -p ds9 header save 1 foo.txt -height -Set the height of the image display window. -Syntax: -height [<value>] - -Example: -$xpaget ds9 height -$xpaset -p ds9 height 512 -iconify -Toggles iconification. -Syntax: -iconify [] -    [yes|no] - -Example: -$xpaget ds9 iconify -$xpaset -p ds9 iconify -$xpaset -p ds9 iconify yes -iexam -Interactive examine function. A blinking cursor will indicate to -the user to click on a point on an image. The specified information -will be returned at that time. The default event is -button. In the last form, the following macros will be -expanded if present: $width, $height, $depth, $bitpix, -$filename, $regions, $filename[$regions], $env, $pan, $value, $x, -$y, $z. See Analysis Macros -for more information. -Syntax: -iexam [] -    [[]|button|key|any] coordinate <coordsys> -[<skyframe>] [<skyformat>] -    [[]|button|key|any] data [width][height] -    [[]|button|key|any] <macro string>] - -Example: -$xpaget ds9 iexam # image coordinates -$xpaget ds9 iexam coordinate image -$xpaget ds9 iexam key coordinate image # return coordinate and key -event -$xpaget ds9 iexam coordinate wcs fk5 degrees -$xpaget ds9 iexam coordinate wcs galactic sexagesimal -$xpaget ds9 iexam coordinate fk5 -$xpaget ds9 iexam data # return data value -$xpaget ds9 iexam key data # return data value and key event -$xpaget ds9 iexam data 3 3 # return all data in 3x3 box about -selected point -$xpaget ds9 iexam {'Click at $x,$y in file $filename'} -iis -Set/Get IIS Filename. Optional mosaic number maybe supplied. -Syntax: -iis [filename <filename> [#]] - -Example: -$xpaget ds9 iis filename -$xpaget ds9 iis filename 4 -$xpaset -p ds9 iis filename foo.fits -$xpaset -p ds9 iis filename bar.fits 4 -jpeg -Load JPEG image into current frame. Optional parameters: -jpeg quality (1-100) -Syntax: -jpeg [new|slice] [<filename>] [1-100] - -Example: -$xpaget ds9 jpeg > foo.jpeg -$xpaget ds9 jpeg 100 > foo.jpeg -$xpaset -p ds9 jpeg foo.jpeg -$xpaset -p ds9 jpeg new foo.jpeg -$xpaset -p ds9 jpeg slice foo.jpeg -$cat foo.jpeg | xpaset ds9 jpeg# not available windows -$cat foo.jpeg | xpaset ds9 jpegnew# not available windows -$cat foo.jpeg | xpaset ds9 jpegslice# not available windows -lock -Lock all other frames to the current frame. -Syntax: -lock[frame <coordsys>|none] -    [crosshair <coordsys>|none] -    [crop <coordsys>|none] -    [slice <coordsys>|none]] -    [bin [yes|no]] -    [axes [yes|no]] -    [scale [yes|no]] -    [scalelimites [yes|no]] -    [colorbar [yes|no]] -    [block [yes|no]] -    [smooth [yes|no]] -    [3d [yes|no]] - -Example: -$xpaget -p ds9 lock frame -$xpaget -p ds9 lock crosshair -$xpaget -p ds9 lock crop -$xpaget -p ds9 lock slice -$xpaget -p ds9 lock bin -$xpaget -p ds9 lock axes -$xpaget -p ds9 lock scale -$xpaget -p ds9 lock scalelimits -$xpaget -p ds9 lock colorbar -$xpaget -p ds9 lock block -$xpaget -p ds9 lock smooth -$xpaget -p ds9 lock 3d -$xpaset -p ds9 lock frame wcs -$xpaset -p ds9 lock crosshair wcs -$xpaset -p ds9 lock crop wcs -$xpaset -p ds9 lock slice wcs -$xpaset -p ds9 lock bin yes -$xpaset -p ds9 lock axes yes -$xpaset -p ds9 lock scale yes -$xpaset -p ds9 lock scalelimits yes -$xpaset -p ds9 lock colorbar yes -$xpaset -p ds9 lock block yes -$xpaset -p ds9 lock smooth yes -$xpaset -p ds9 lock 3d yes - lower -Lower in the window stacking order. -Syntax: -lower - -Example: -$xpaset -p ds9 lower -magnifier -Controls the magnifier settings. -Syntax: -magnifier [color <color>] -    [zoom <value>] -    [cursor yes|no] -    [region yes|no] - -Example: -$xpaget ds9 magnifier color -$xpaget ds9 magnifier zoom -$xpaget ds9 magnifier cursor -$xpaget ds9 magnifier region -$xpaset -p ds9 magnifier color yellow -$xpaset -p ds9 magnifier zoom 2 -$xpaset -p ds9 magnifier cursor no -$xpaset -p ds9 magnifier region no -mask -Controls mask parameters. -Syntax: -mask [color <color>] -    [mark zero|nonzero|nan|nonnan|range] -    [range <low> <high>] -    [transparency <value>] -    [system <coordsys>] -    [clear] -    [open|close] - -Example: -$xpaget ds9 mask color -$xpaget ds9 mask mark -$xpaget ds9 mask range -$xpaget ds9 mask system -$xpaget ds9 mask transparency -$xpaset -p ds9 mask color red -$xpaset -p ds9 mask mark zero -$xpaset -p ds9 mask range 10 100 -$xpaset -p ds9 mask transparency 50 -$xpaset -p ds9 mask system wcs -$xpaset -p ds9 mask clear -$xpaset -p ds9 mask open -$xpaset -p ds9 mask close -match -Match all other frames to the current frame. -Syntax: -match[frame <coordsys>] -    [crosshair <coordsys>] -    [crop <coordsys>] -    [slice <coordsys>] -    [bin] -    [axes] -    [scale] -    [scalelimits] -    [colorbar] -    [block] -    [smooth] -    [3d] - -Example: -$xpaset -p ds9 match frame wcs -$xpaset -p ds9 match crosshair wcs -$xpaset -p ds9 match crop wcs -$xpaset -p ds9 match slicewcs -$xpaset -p ds9 match bin -$xpaset -p ds9 match axes -$xpaset -p ds9 match scale -$xpaset -p ds9 match scalelimits -$xpaset -p ds9 match colorbar -$xpaset -p ds9 match block -$xpaset -p ds9 match smooth -$xpaset -p ds9 match 3d - mecube -Load FITS multiple extension file as data cube. -Syntax: -mecube [new] [<filename>] - -Example: -$xpaget ds9 mecube > foo.fits -$xpaset -p ds9 mecube foo.fits -$xpaset -p ds9 mecube new foo.fits -$cat foo.fits | xpaset ds9 mecube -$cat foo.fits | xpaset ds9 mecubenew -minmax -This is how DS9 determines the min and max data values -from the data. SCAN will scan all -data. DATAMIN and IRAFMIN will use the -values of the keywords if present. -Syntax: -minmax [scan|sample|datamin|irafmin] -    [mode scan|sample|datamin|irafmin] -    [interval #] - -Example: -$xpaget ds9 minmax mode -$xpaget ds9 minmax interval -$xpaset -p ds9 minmax scan -$xpaset -p ds9 minmax mode scan -$xpaset -p ds9 minmax interval 100 -mode -Controls the first mouse button mode. -Syntax: -mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - -Example: -$xpaget ds9 mode -$xpaset -p ds9 mode crosshair -mosaic -Load FITS mosaic segment into current frame. -Syntax: -mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] - -Example: -$xpaget ds9 mosaic > foo.fits -$xpaset -p ds9 mosaic foo.fits -$xpaset -p ds9 mosaic wcs foo.fits -$xpaset -p ds9 mosaic wcs new foo.fits -$xpaset -p ds9 mosaic wcs mask foo.fits -$cat foo.fits | xpaset ds9 mosaic -$cat foo.fits | xpaset ds9 mosaic wcs -$cat foo.fits | xpaset ds9 mosaic wcsnew -$cat foo.fits | xpaset ds9 mosaic wcsmask -mosaicimage -Load FITS mosaic image into current frame. -Syntax: -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] -[<filename>] - -Example: -$xpaget ds9 mosaicimage > foo.fits -$xpaset -p ds9 mosaicimage foo.fits -$xpaset -p ds9 mosaicimage wcs foo.fits -$xpaset -p ds9 mosaicimage wcs new foo.fits -$xpaset -p ds9 mosaicimage wcs mask foo.fits -$cat foo.fits | xpaset ds9 mosaicimage -$cat foo.fits | xpaset ds9 mosaicimage wcs -$cat foo.fits | xpaset ds9 mosaicimage wcs new -$cat foo.fits | xpaset ds9 mosaicimage wcs mask -movie -Create a movie from snap shots of the DS9 window. A -slice movie cycles though all slices of a cube. A -frame movie cycles through all active frames. A -3d movie cycles through specified viewing angles. The -default action is slice. Movie types are either -MPEG or Animated GIF, with default MPEG. -Optional parameters for 3d: number of frames, azimuth -from/to, elevation from/to, slice from/to, oscillate/repeat -times. -Syntax: -movie [slice|frame|3d][mpeg|gif] <filename> -movie 3d [mpeg|gif] <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>] - -Example: -$xpaset -p ds9 movie slice mpeg ds9.mpg -$xpaset -p ds9 movie frame gif ds9.gif -$xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 -oscillate 1 -multiframe -Load FITS multiple extension file as multiple images. -Syntax: -multiframe [<filename>] - -Example: -$xpaset -p ds9 multiframe foo.fits -$cat foo.fits | xpaset ds9 multiframe# not available -windows -nameserver -Support Name Server functions. Coordinates are in fk5. -Syntax: -nameserver [<object>] -    [name <object>] -    -[serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] - -    [skyformat degrees|sexagesimal] -    [pan] -    [crosshair] -    [open|close] - -Example: -$xpaget ds9 nameserver -$xpaget ds9 nameserver server -$xpaget ds9 nameserver skyformat -$xpaget ds9 nameserver m31 -$xpaset -p ds9 nameserver m31 -$xpaset -p ds9 nameserver name m31 -$xpaset -p ds9 nameserver server ned-sao -$xpaset -p ds9 nameserver skyformat sexagesimal -$xpaset -p ds9 nameserver pan -$xpaset -p ds9 nameserver crosshair -$xpaset -p ds9 nameserver open -$xpaset -p ds9 nameserver close -nan -Set image not-a-number color. -Syntax: -nan <color> - -Example: -$xpaget ds9 nan -$xpaset -p ds9 nan red -nrrd -Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: -array endian. -Syntax: -nrrd [native|little|big] -nrrd [new|mask] [<filename>] - -Example: -$xpaget ds9 nrrd -$xpaget ds9 nrrd big -$xpaset -p ds9 nrrd foo.nrrd -$xpaset -p ds9 nrrd new foo.nrrd -$xpaset -p ds9 nrrd mask foo.nrrd -$cat foo.nrrd | xpaset ds9 nrrd -$cat foo.nrrd | xpaset ds9 nrrdnew -$cat foo.nrrd | xpaset ds9 nrrd mask -nvss -Support for NRAO VLA Sky Survey. -Syntax: -nvss [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$xpaget ds9 nvss name -$xpaget ds9 nvss coord -$xpaget ds9 nvss size -$xpaget ds9 nvss save -$xpaget ds9 nvss frame -$xpaset -p ds9 nvss -$xpaset -p ds9 nvss m31 -$xpaset -p ds9 nvss name m31 -$xpaset -p ds9 nvss name clear -$xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 nvss size 60 60 arcmin -$xpaset -p ds9 nvss save yes -$xpaset -p ds9 nvss frame current -$xpaset -p ds9 nvss update frame -$xpaset -p ds9 nvss open -$xpaset -p ds9 nvss close -orient -Controls the orientation of the current frame. -Syntax: -orient [none|x|y|xy] -    [open|close] - -Example: -$xpaget ds9 orient -$xpaset -p ds9 orient xy -$xpaset -p ds9 orient open -$xpaset -p ds9 orient close -pagesetup -Controls Page Setup options. -Syntax: -pagesetup [orient portrait|landscape] -    [scale <numberic>] -    [size letter|legal|tabloid|poster|a4] - -Example: -$xpaget ds9 pagesetup orient -$xpaget ds9 pagesetup scale -$xpaget ds9 pagesetup size -$xpaset -p ds9 pagesetup orient portrait -$xpaset -p ds9 pagesetup scale 50 -$xpaset -p ds9 pagesetup size poster -pan -Controls the current image cursor location for the current -frame. -Syntax: -pan [<coordsys> [<skyframe>] [<skyformat>]] # get -current coords - -pan [<x> <y> <coordsys> [<skyframe>]] # -relative -    [to <x> <y> <coordsys> -[<skyframe>]] # absolute -    [open|close] - -Example: -$xpaget ds9 pan # get current image coords -$xpaget ds9 pan wcs fk4 sexagesimal # get current coords -$xpaset -p ds9 pan 200 200 image # pan relative -$xpaset -p ds9 pan to 400 400 physical # pan to physical coords -$xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs -coords -$xpaset -p ds9 pan open -$xpaset -p ds9 pan close -pixeltable -Display/Hide the pixel table. -Syntax: -pixeltable [] -    [yes|open] -    [no|close] - -Example: -$xpaget ds9 pixeltable -$xpaset -p ds9 pixeltable -$xpaset -p ds9 pixeltable yes -$xpaset -p ds9 pixeltable open -$xpaset -p ds9 pixeltable close -plot -Display and configure data plots. All plot commands take an -optional second command, the plot name. If no plot name is -specified, the last plot created is assumed. Plot data is assumed -to be a pair of coordinates, with optional error values. The follow -are valid data descriptions: -xy     x and y coordinates -xyex    x,y coordinates with x errors -xyey    x,y coordinates with y errors -xyexey    x,y coordinates with x and y -errors -To create a new plot, use the plot new command. -Syntax: -# create new empty plot window -plot [] -    [line|bar|scatter] -    [new] -    [new line|bar|scatter] -    [new name <plotname>] -    [new name <plotname> line|bar|scatter] - -# create new plot with data from stdin -plot[new <title> <xaxis label> <yaxis -label>xy|xyex|xyey|xyexey] -    [new [line|bar|scatter] <title> <xaxis -label> <yaxis label>xy|xyex|xyey|xyexey] -    [newname <plotname><title> <xaxis -label> <yaxis label>xy|xyex|xyey|xyexey] -    [newname <plotname>line|bar|scatter -<title> <xaxis label> <yaxis -label>xy|xyex|xyey|xyexey] - -# create new plot with data from stdin which includes title/dim -headers -plot [new stdin] -    [new[line|bar|scatter]stdin] -    [new name <plotname> stdin] -    [new name -<plotname>line|bar|scatterstdin] - -#load data into existing plot from stdin -plot [[<plotname>] data xy|xyex|xyey|xyexey] - -# existing plot -plot[[<plotname>] load <filename> -xy|xyex|xyey|xyexey] -    [[<plotname>] save <filename>] -    [[<plotname>] clear] -    [[<plotname>] duplicate [#]] -    [[<plotname>] stats yes|no] -    [[<plotname>] list yes|no] -    [[<plotname>] loadconfig -<filename>] -    [[<plotname>] saveconfig -<filename>] -    [[<plotname>] pagesetup orient -portrait|landscape] -    [[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4] -    [[<plotname>] print] -    [[<plotname>] print destination -printer|file] -    [[<plotname>] print command -<command>] -    [[<plotname>] print filename -<filename>] -    [[<plotname>] print color rgb|gray] -    [[<plotname>] close] -    [[<plotname>] mode pointer|zoom] - -# export image -plot[[<plotname>] -export[gif|tiff|jpeg|png]<filename> -    [[<plotname>] export jpeg -<filename>[1-100] -    [[<plotname>]export tiff -<filename>[none|jpeg|packbits|deflate] - -# configure graph -plot [[<plotname>] axis x|y grid yes|no] -    [[<plotname>] axis x|y log yes|no] -    [[<plotname>] axis x|y flip yes|no] -    [[<plotname>] axis x|y auto yes|no] -    [[<plotname>] axis x|y min -<value>] -    [[<plotname>] axis x|y max -<value>] -    [[<plotname>] axis x|y format -<string>] -    [[<plotname>] background -<value>] -    [[<plotname>] legend yes|no] -    [[<plotname>] legend position -right|left|top|bottom] -    [[<plotname>] font title|labels|numbers -font times|helvetica|courier] -    [[<plotname>] fonttitle|labels|numberssize -<value>] -    [[<plotname>] -fonttitle|labels|numbersweight normal|bold] -    [[<plotname>] -fonttitle|labels|numbersslant roman|italic] -    [[<plotname>] title <string>] -    [[<plotname>] title x|y -<string>] -    [[<plotname>] barmode -normal|stacked|aligned|overlap] - -# configure current dataset -plot [[<plotname>] show yes|no] -    [[<plotname>] shape -none|circle|square|diamond|plus|splus|scross|triangle|arrow] -    [[<plotname>] shape fill yes|no] -    [[<plotname>] shape color -<value>] -    [[<plotname>] smooth -step|linear|cubic|quadratic|catrom] -    [[<plotname>] color <value>] -    [[<plotname>] width <value>] -    [[<plotname>] dash yes|no] -    [[<plotname>] error yes|no] -    [[<plotname>] error color -<value>] -    [[<plotname>] error cap yes|no] -    [[<plotname>] error width -<value>] -    [[<plotname>] name <string>] - -# select current dataset -plot [[<plotname>] select <value>] - -Example: -# return all plotnames -$xpaget ds9 plot - -# create new empty plot window -$xpaset -p ds9 plot -$xpaset -p ds9 plot bar -$xpaset -p ds9 plot new -$xpaset -p ds9 plot new bar -$xpaset -p ds9 plot new name foo -$xpaset -p ds9 plot new name foo bar - -# create new plot with data from stdin -$cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} -xy -$cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} -xy -$cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} {Y -Axis} xy -$cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X Axis} -{Y Axis} xy - -# create new plot with data from stdin which includes title/dim -headers -$cat stdin.2.dat | xpaset ds9 plot new stdin -$cat stdin.2.dat | xpaset ds9 plot new line stdin -$cat stdin.2.dat | xpaset ds9 plot new name foo stdin -$cat stdin.2.dat | xpaset ds9 plot new name foo line stdin - -#load data into existing plot from stdin -$cat xy.dat | xpaset ds9 plot data xy -$cat xy.dat | xpaset ds9 plot foo data xy - -# existing plot -$xpaget ds9 plot stats -$xpaget ds9 plot list -$xpaset -p ds9 plot load xy.dat xy -$xpaset -p ds9 plot save foo.dat -$xpaset -p ds9 plot clear -$xpaset -p ds9 plot duplicate 1 -$xpaset -p ds9 plot stats yes -$xpaset -p ds9 plot list yes -$xpaset -p ds9 plot loadconfig foo.plt -$xpaset -p ds9 plot saveconfig foo.plt -$xpaset -p ds9 plot pagesetup orient portrait -$xpaset -p ds9 plot pagesetup size letter -$xpaset -p ds9 plot print -$xpaset -p ds9 plot print destination file -$xpaset -p ds9 plot print command lp -$xpaset -p ds9 plot print filename foo.ps -$xpaset -p ds9 plot print color rgb -$xpaset -p ds9 plot close -$xpaget ds9 plot mode -$xpaset -p ds9 plot mode pointer - -# export plot -$xpaset -p ds9 plot export tiff foo.tiff jpeg -$xpaset -p ds9 plot export jpeg foo.jpeg 75 -$xpaset -p ds9 plot export png foo.png - -# configure plot -$xpaget ds9 plot axis x grid -$xpaget ds9 plot axis x log -$xpaget ds9 plot axis x flip -$xpaget ds9 plot axis x auto -$xpaget ds9 plot axis x min -$xpaget ds9 plot axis x max -$xpaget ds9 plot axis x format -$xpaset -p ds9 plot axis x grid yes -$xpaset -p ds9 plot axis x log yes -$xpaset -p ds9 plot axis x flip yes -$xpaset -p ds9 plot axis x auto no -$xpaset -p ds9 plot axis x min 1 -$xpaset -p ds9 plot axis x max 100 -$xpaset -p ds9 plot axis x format {%f} - -$xpaget ds9 plot background -$xpaset -p ds9 plot background white - -$xpaget ds9 plot legend -$xpaget ds9 plot legend position -$xpaset -p ds9 plot legend yes -$xpaset -p ds9 plot legend position left - -$xpaget ds9 plot font numbers font -$xpaget ds9 plot font numbers size -$xpaget ds9 plot font numbers weight -$xpaget ds9 plot font numbers slant -$xpaset -p ds9 plot font numbers font times -$xpaset -p ds9 plot font numbers size 12 -$xpaset -p ds9 plot font numbers weight bold -$xpaset -p ds9 plot font numbers slant italic - -$xpaget ds9 plot title -$xpaget ds9 plot title xaxis -$xpaget ds9 plot title yaxis -$xpaset -p ds9 plot title {This is a Title} -$xpaset -p ds9 plot title x {X Axis} -$xpaset -p ds9 plot title y {Y Axis} -$xpaset -p ds9 plot title legend {This is the Legend} - -$xpaget ds9 plot barmode -$xpaset -p ds9 plot barmode aligned - -# configure current dataset -$xpaget ds9 plot show -$xpaget ds9 plot shape -$xpaget ds9 plot shape fill -$xpaget ds9 plot shape color -$xpaget ds9 plot smooth -$xpaget ds9 plot color -$xpaget ds9 plot width -$xpaget ds9 plot dash -$xpaget ds9 plot error -$xpaget ds9 plot error color -$xpaget ds9 plot error cap -$xpaget ds9 plot error width -$xpaget ds9 plot name -$xpaset -p ds9 plot show yes -$xpaset -p ds9 plot shape circle -$xpaset -p ds9 plot shape fill no -$xpaset -p ds9 plot shape color cyan -$xpaset -p ds9 plot smooth step -$xpaset -p ds9 plot color red -$xpaset -p ds9 plot width 2 -$xpaset -p ds9 plot dash yes -$xpaset -p ds9 plot error yes -$xpaset -p ds9 plot error color red -$xpaset -p ds9 plot error cap yes -$xpaset -p ds9 plot error width 2 -$xpaset -p ds9 plot name {My Data} - -# select current dataset -$xpaget ds9 plot select -$xpaset -p ds9 plot select 2 -png -Load PNG image into current frame. -Syntax: -png [new|slice] [<filename>] - -Example: -$xpaget ds9 png > foo.png -$xpaset -p ds9 png foo.png -$xpaset -p ds9 png new foo.png -$xpaset -p ds9 png slice foo.png -$cat foo.png | xpaset ds9 png -$cat foo.png | xpaset ds9 png new -$cat foo.png | xpaset ds9 png slice -precision -Set region and coordinate output format precision. -Syntax: -precision +     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +     [2mass|iras] +     [csc|xmm|rosat] +     [first|nvss] +     [chandralog|cfhtlog|esolog|stlog|xmmlog] +     [cds <catalogname>] +     [cds <catalogid>] + +     [load <filename>] +     [import sb|tsv <filename>] + +     [<ref>] [<ra> <dec> + <coordsys>] +     [<ref>] [allcols] +     [<ref>] [allrows] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [crosshair] +     [<ref>] [dec <col>] +     [<ref>] [edit yes|no] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [filter <string>] +     [<ref>] [filter load <filename>] +     [<ref>] [header] +     [<ref>] [location <code>] +     [<ref>] [match] +     [<ref>] [match <ref> <ref>] +     [<ref>] [match error <value> + degrees|arcmin|arcsec] +     [<ref>] [match function + 1and2|1not2|2not1] +     [<ref>] [match return + 1and2|1only|2only] +     [<ref>] [match unique yes|no] +     [<ref>] [maxrows <number>] +     [<ref>] [name <object>] +     [<ref>] [panto yes|no] +     [<ref>] [plot <xcol> <ycol> + <xerrcol> <yerrcol>] +     [<ref>] [print] +     [<ref>] [psky <skyframe>] +     [<ref>] [psystem <coordsys>] +     [<ref>] [ra <col>] +     [<ref>] [regions] +     [<ref>] [retrieve] +     [<ref>] [samp] +     [<ref>] [samp broadcast] +     [<ref>] [samp send <application>] +     [<ref>] [save <filename>] +     [<ref>] [server + cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +     [<ref>] [show yes|no] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [sort <col> incr|decr] +     [<ref>] [symbol [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>] +     [<ref>] [symbol [#] + text|size|size2|units|angle <value>] +     [<ref>] [symbol shape + circle|ellipse|box|text|point] +     [<ref>] [symbol shapecircle point|box + point|diamond point|cross point|x point|arrow point|boxcircle + point] +     [<ref>] [symbol add| [#] remove] +     [<ref>] [symbol save|load + <filename>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] +     [<ref>] [x <col>] +     [<ref>] [y <col>] + + Example: + $xpaget ds9 catalog + $xpaget ds9 catalog header + + $xpaset -p ds9 catalog new + $xpaset -p ds9 catalog 2mass + $xpaset -p ds9 catalog cds 2mass + $xpaset -p ds9 catalog cds {I/252} + + $xpaset -p ds9 catalog load foo.xml + $xpaset -p ds9 catalog import tsv foo.tsv + + $xpaset -p ds9 catalog 202.48 47.21 fk5 + $xpaset -p ds9 catalog allrows + $xpaset -p ds9 catalog allcols + $xpaset -p ds9 catalog cancel + $xpaset -p ds9 catalog clear + $xpaset -p ds9 catalog close + $xpaset -p ds9 catalog crosshair + $xpaset -p ds9 catalog dec DEC + $xpaset -p ds9 catalog edit yes + $xpaset -p ds9 catalog export tsv bar.tsv + $xpaset -p ds9 catalog filter '$Jmag>10' + $xpaset -p ds9 catalog filter load foo.flt + $xpaset -p ds9 catalog header + $xpaset -p ds9 catalog location 500 + $xpaset -p ds9 catalog match error 2 arcsec + $xpaset -p ds9 catalog match function 1and2 + $xpaset -p ds9 catalog match unique no + $xpaset -p ds9 catalog match return 1only + $xpaset -p ds9 catalog match # last two catalogs loaded + $xpaset -p ds9 catalog match 2mass csc + $xpaset -p ds9 catalog maxrows 2000 + $xpaset -p ds9 catalog name m51 + $xpaset -p ds9 catalog panto no + $xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag' + $xpaset -p ds9 catalog print + $xpaset -p ds9 catalog psky fk5 + $xpaset -p ds9 catalog psystem wcs + $xpaset -p ds9 catalog ra RA + $xpaset -p ds9 catalog regions + $xpaset -p ds9 catalog retrieve + $xpaset -p ds9 catalog samp broadcast + $xpaset -p ds9 catalog samp send aladin + $xpaset -p ds9 catalog save foo.xml + $xpaset -p ds9 catalog server sao + $xpaset -p ds9 catalog show yes + $xpaset -p ds9 catalog radius 1 degrees + $xpaset -p ds9 catalog symbol condition '$Jmag>15' + $xpaset -p ds9 catalog symbol 2 shape {boxcircle point} + $xpaset -p ds9 catalog symbol color red + $xpaset -p ds9 catalog symbol font times + $xpaset -p ds9 catalog symbol fontsize 14 + $xpaset -p ds9 catalog symbol fontweight bold + $xpaset -p ds9 catalog symbol fontslant italic + $xpaset -p ds9 catalog symbol add + $xpaset -p ds9 catalog symbol 2 remove + $xpaset -p ds9 catalog symbol load foo.sym + $xpaset -p ds9 catalog symbol save bar.sym + $xpaset -p ds9 catalog sky fk5 + $xpaset -p ds9 catalog skyformat degrees + $xpaset -p ds9 catalog sort {Jmag} incr + $xpaset -p ds9 catalog system wcs + $xpaset -p ds9 catalog update + $xpaset -p ds9 catalog x RA + $xpaset -p ds9 catalog y DEC + cd + Sets/Returns the current working directory. + Syntax: + cd [<directory>] + + Example: + $xpaget ds9 cd + + $xpaset -p ds9 cd /home/mrbill + + cmap + Controls the colormap for the current frame. The colormap name + is not case sensitive. A valid contrast value is from 0 to + 10 and bias value from 0 to 1. + Syntax: + cmap [<colormap>] +     [file] +     [load <filename>] +     [save <filename>] +     [invert yes|no] +     [<constrast> <bias>] +     [tag [load|save] <filename>] +     [tag delete] +     [open|close] + + Example: + $xpaget ds9 cmap + $xpaget ds9 cmap file + $xpaget ds9 cmap invert + $xpaget ds9 cmap value + + $xpaset -p ds9 cmap Heat + $xpaset -p ds9 cmap load foo.sao + $xpaset -p ds9 cmap save bar.sao + $xpaset -p ds9 cmap invert yes + $xpaset -p ds9 cmap 5 .5 + $xpaset -p ds9 cmap tag load foo.tag + $xpaset -p ds9 cmap tag save foo.tag + $xpaset -p ds9 cmap tag delete + $xpaset -p ds9 cmap open + $xpaset -p ds9 cmap close + + colorbar + + Controls colorbar parameters. + Syntax: + colorbar [] +     [yes|no] +     [orientation] +     [horizontal|vertical] +     [numerics yes|no] +     [space value|distance] +     [font times|helvetica|courier] +     [fontsize <value>] +     [fontweight normal|bold] +     [fontslant roman|italic] +     [size] +     [ticks] +     [match] +     [lock [yes|no]] + + Example: + $xpaget ds9 colorbar + $xpaget ds9 colorbar orientation + $xpaget ds9 colorbar numerics + $xpaget ds9 colorbar space + $xpaget ds9 colorbar font + $xpaget ds9 colorbar fontsize + $xpaget ds9 colorbar fontweight + $xpaget ds9 colorbar fontslant + $xpaget ds9 colorbar size + $xpaget ds9 colorbar ticks + $xpaget ds9 colorbar lock + + $xpaset -p ds9 colorbar yes + $xpaset -p ds9 colorbar vertical + $xpaset -p ds9 colorbar orientation vertical + $xpaset -p ds9 colorbar numerics yes + $xpaset -p ds9 colorbar space value + $xpaset -p ds9 colorbar font times + $xpaset -p ds9 colorbar fontsize 14 + $xpaset -p ds9 colorbar fontweight bold + $xpaset -p ds9 colorbar fontslant italic + $xpaset -p ds9 colorbar size 20 + $xpaset -p ds9 colorbar ticks 11 + $xpaset -p ds9 colorbar match + $xpaset -p ds9 colorbar lock yes + + console + Display tcl console window. + Syntax: + -console + + Example: + $xpaset -p ds9 console + + contour + + Controls contours in the current frame. + Syntax: + contour [] +     [yes|no] +     [<coordsys> [<skyframe>]] +     [clear] +     [generate] +     [load <filename>] +     [save <filename> [<coordsys> + <skyframe>]] +     [convert] +     [load levels <filename>] +     [save levels <filename>] +     [copy] +     [paste [<coordsys> <color> + <width> yes|no]] +     [color <color>] +     [width <width>] +     [dash yes|no] +     [smooth <smooth>] +     [method block|smooth] +     [nlevels <number of levels>] +     [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ] +     [log exp <value>] +     [mode minmax|<value>|zscale|zmax] +     [scope global|local] +     [limits <min> <max>] +     [levels <value value value...>] +     [open|close] + + Example: + $xpaget ds9 contour + $xpaget ds9 contour wcs fk5 + $xpaget ds9 contour color + $xpaget ds9 contour width + $xpaget ds9 contour dash + $xpaget ds9 contour smooth + $xpaget ds9 contour method + $xpaget ds9 contour nlevels + $xpaget ds9 contour scale + $xpaget ds9 contour log exp + $xpaget ds9 contour mode + $xpaget ds9 contour scope + $xpaget ds9 contour limits + $xpaget ds9 contour levels + + $xpaset -p ds9 contour + $xpaset -p ds9 contour yes + $xpaset -p ds9 contour clear + $xpaset -p ds9 contour generate + $xpaset -p ds9 contour load ds9.ctr + $xpaset -p ds9 contour save ds9.ctr + $xpaset -p ds9 contour save ds9.ctr wcs fk5 + $xpaset -p ds9 contour convert + $xpaset -p ds9 contour load levels ds9.ctr + $xpaset -p ds9 contour save levels ds9.lev + $xpaset -p ds9 contour copy + $xpaset -p ds9 contour paste + $xpaset -p ds9 contour paste wcs red 2 no + $xpaset -p ds9 contour color yellow + $xpaset -p ds9 contour width 2 + $xpaset -p ds9 contour dash yes + $xpaset -p ds9 contour smooth 5 + $xpaset -p ds9 contour method smooth + $xpaset -p ds9 contour nlevels 10 + $xpaset -p ds9 contour scale sqrt + $xpaset -p ds9 contour log exp 1000 + $xpaset -p ds9 contour mode zscale + $xpaset -p ds9 contour scope local + $xpaset -p ds9 contour limits 1 100 + $xpaset -p ds9 contour levels 1 10 100 1000 + $xpaset -p ds9 contour open + $xpaset -p ds9 contour close + crop + Set current image display area. + Syntax: + crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +     [match <coordsys>] +     [lock <coordsys>|none] +     [reset] +     [3d zmin zmax <coordsys>] +     [open|close] + + Example: + $xpaget ds9 crop # get crop in physical coords + $xpaget ds9 crop wcs galactic sexagesimal arcsec + $xpaget ds9 crop lock + + $xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords + $xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 + 22.000204 wcs galactic arcsec + $xpaset -p ds9 crop match wcs + $xpaset -p ds9 crop lock wcs + $xpaset -p ds9 crop reset + $xpaset -p ds9 crop 3d .25 .50 wcs + $xpaset -p ds9 crop open + $xpaset -p ds9 crop close + crosshair + Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set. + Syntax: + crosshair [<x> <y> <coordsys> + [<skyframe>]] +     [match <coordsys>] +     [lock <coordsys>|none] + + Example: + $xpaget ds9 crosshair # get crosshair in physical coords + $xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs + coords + $xpaget ds9 crosshair lock + + $xpaset -p ds9 crosshair 100 100 physical # set crosshair in + physical + $xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs + coords + $xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 + $xpaset -p ds9 crosshair match wcs + $xpaset -p ds9 crosshair lock wcs + + cube + + Controls FITS cube dialog. + Syntax: + cube [] +     [play|stop|next|prev|first|last] +     [<slice> [<coordsys>]] +     [interval <numeric>] +     [match <coordsys>] +     [lock <coordsys>|none] +     [order 123|132|213|231|312|321] +     [axes lock [yes|no]] +     [open|close] + + Example: + $xpaget ds9 cube + $xpaget ds9 cube wcs + $xpaget ds9 cube interval + $xpaget ds9 cube lock + $xpaget ds9 cube order + $xpaget ds9 cube axes lock + + $xpaset -p ds9 cube + $xpaset -p ds9 cube play + $xpaset -p ds9 cube last + $xpaset -p ds9 cube 3 + $xpaset -p ds9 cube 4.4 wcs + $xpaset -p ds9 cube interval 2 + $xpaset -p ds9 cube match wcs + $xpaset -p ds9 cube lock wcs + $xpaset -p ds9 cube order 123 + $xpaset -p ds9 cube axes lock yes + $xpaset -p ds9 cube open + $xpaset -p ds9 cube close + cursor + Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also. + Syntax: + cursor [<x> <y>] + + Example: + $xpaset -p ds9 cursor 10 10 + + data + Return an array of data values given a lower left corner and a + width and height in specified coordinate system. The last + argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes. + Syntax: + data [<coordsys> [<skyframe>] <x> <y> + <width> <height> [yes|no]] + + Example: + $xpaget ds9 data image 450 520 3 3 yes + $xpaget ds9 data physical 899 1039 6 6 no + $xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 + 0.00016516669 no + $xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 + 0.00016516669 no + + dsssao + dss + + Support for Digital Sky Survey at SAO. + Syntax: + dsssao [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $xpaget ds9 dsssao name + $xpaget ds9 dsssao coord + $xpaget ds9 dsssao size + $xpaget ds9 dsssao save + $xpaget ds9 dsssao frame + + $xpaset -p ds9 dsssao + $xpaset -p ds9 dsssao m31 + $xpaset -p ds9 dsssao name m31 + $xpaset -p ds9 dsssao name clear + $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 dsssao size 60 60 arcmin + $xpaset -p ds9 dsssao save yes + $xpaset -p ds9 dsssao frame current + $xpaset -p ds9 dsssao update frame + $xpaset -p ds9 dsssao open + $xpaset -p ds9 dsssao close + dsseso + Support for Digital Sky Survey at ESO. + Syntax: + dsseso [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +     [open|close] + + Example: + $xpaget ds9 dsseso name + $xpaget ds9 dsseso coord + $xpaget ds9 dsseso size + $xpaget ds9 dsseso save + $xpaget ds9 dsseso frame + $xpaget ds9 dsseso survey + + $xpaset -p ds9 dsseso + $xpaset -p ds9 dsseso m31 + $xpaset -p ds9 dsseso name m31 + $xpaset -p ds9 dsseso name clear + $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 dsseso size 60 60 arcmin + $xpaset -p ds9 dsseso save yes + $xpaset -p ds9 dsseso frame current + $xpaset -p ds9 dsseso update frame + $xpaset -p ds9 dsseso survey DSS2-red + $xpaset -p ds9 dsseso open + $xpaset -p ds9 dsseso close + dssstsci + Support for Digital Sky Survey at STSCI. + Syntax: + dssstsci [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +     [survey poss1_blue|poss1_red] +     [survey all|quickv|phase2_gsc2|phase2_gsc1] +     [open|close] + + Example: + $xpaget ds9 dssstsci name + $xpaget ds9 dssstsci coord + $xpaget ds9 dssstsci size + $xpaget ds9 dssstsci save + $xpaget ds9 dssstsci frame + $xpaget ds9 dssstsci survey + + $xpaset -p ds9 dssstsci + $xpaset -p ds9 dssstsci m31 + $xpaset -p ds9 dssstsci name m31 + $xpaset -p ds9 dssstsci name clear + $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 dssstsci size 60 60 arcmin + $xpaset -p ds9 dssstsci save yes + $xpaset -p ds9 dssstsci frame current + $xpaset -p ds9 dssstsci update frame + $xpaset -p ds9 dssstsci survey all + $xpaset -p ds9 dssstsci open + $xpaset -p ds9 dssstsci close + envi + Load an ENVI header and file. Optional parameter: array endian. + + Syntax: + + envi [new] <header> [<filename>] + + + + Example: + + $xpaset -p ds9 envi foo.hdr + + $xpaset -p ds9 envi new foo.hdr + + $xpaset -p ds9 envi foo.hdr foo.bsq + + + exit + quits + + Quits DS9. + Syntax: + exit + quit + + Example: + $xpaset -p ds9 exit + + export + + Export loaded image data of current frame in specified image + format. Optional parameters: array endian, nrrd endian, jpeg + quality (1-100) and tiff compression method. + Syntax: + export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> + export array <filename>[big|little|native] + export nrrd <filename>[big|little|native] + export envi <header> [<filename>][big|little|native] + export jpeg <filename>[1-100] + export tiff <filename>[none|jpeg|packbits|deflate] + + Example: + $xpaset -p ds9 export array foo.arr little + $xpaset -p ds9 export nrrd foo.nrrd little + $xpaset -p ds9 export envi foo.hdr little + $xpaset -p ds9 export envi foo.hdr foo.bsq little + $xpaset -p ds9 export tiff foo.tiff jpeg + $xpaset -p ds9 export jpeg foo.jpeg 75 + $xpaset -p ds9 export png foo.png + file + Query currently loaded file information. + Syntax: + file + + Example: + $xpaget ds9 file + fits + Load a FITS image into the current frame or query the currently + loaded image. + + Syntax: + fits[new|mask|slice] [<filename>] +     [width|height|depth|bitpix] +     [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +     [header [<ext>] [keyword + <string>]] +     [image|table|slice] + + Example: + $xpaget ds9 fits > foo.fits + $xpaget ds9 fits width + $xpaget ds9 fits height + $xpaget ds9 fits depth + $xpaget ds9 fits bitpix + $xpaget ds9 fits size + $xpaget ds9 fits size wcs fk5 arcmin + $xpaget ds9 fits header # primary + $xpaget ds9 fits header 2 # hdu 2 + $xpaget ds9 fits header -2 # hdu 2 with inherit + $xpaget ds9 fits header keyword BITPIX + $xpaget ds9 fits header 1 keyword BITPIX + $xpaget ds9 fits image > foo.fits + $xpaget ds9 fits table > bar.fits + $xpaget ds9 fits slice > foo.fits + + $xpaset -p ds9 fits foo.fits + $xpaset -p ds9 fits new foo.fits + $xpaset -p ds9 fits bar.fits[bin=detx,dety] + $xpaset -p ds9 fits slice foo.fits + $xpaset -p ds9 fits mask foo.fits + + $cat foo.fits | xpaset ds9 fits + $cat foo.fits | xpaset ds9 fits new + $cat bar.fits | xpaset ds9 fits -[bin=detx,dety] + $cat foo.fits | xpaset ds9 fits slice + $cat foo.fits | xpaset ds9 fits mask + + frame + Controls frame functions. Frames may be created, deleted, + reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. + Syntax: + frame [center [#|all]] +     [clear [#|all]] +     [new [rgb|3d]] +     [delete [#|all]] +     [reset [#|all]] +     [refresh [#|all]] +     [hide [#|all]] +     [show [#|all]] +     [move first] +     [move back] +     [move forward] +     [move last] +     [first] +     [prev] +     [next] +     [last] +     [frameno #] +     [#] +     [match <coordsys>] +     [lock <coordsys>|none] +     [has + [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] +     [has contour [aux]]] +     [has fits [bin|cube|mosaic]] +     [has marker [highlite|paste|select|undo]] +     [has system <coordsys>] +     [has wcs [<wcssys>]] +     [has wcs celestial [<wcssys>]] +     [has wcs linear [<wcssys>]] + + Example: + $xpaget ds9 frame # returns the id of the current frame + $xpaget ds9 frame frameno # returns the id of the current frame + $xpaget ds9 frame all # returns the id of all frames + $xpaget ds9 frame active # returns the id of all active frames + $xpaget ds9 frame lock + $xpaget ds9 frame has amplifier + $xpaget ds9 frame has datamin + $xpaget ds9 frame has datasec + $xpaget ds9 frame has detector + $xpaget ds9 frame has grid + $xpaget ds9 frame has iis + $xpaget ds9 frame has irafmin + $xpaget ds9 frame has physical + $xpaget ds9 frame has smooth + $xpaget ds9 frame has contour + $xpaget ds9 frame has contour aux + $xpaget ds9 frame has fits + $xpaget ds9 frame has fits bin + $xpaget ds9 frame has fits cube + $xpaget ds9 frame has fits mosaic + $xpaget ds9 frame has marker highlite + $xpaget ds9 frame has marker paste + $xpaget ds9 frame has marker select + $xpaget ds9 frame has marker undo + $xpaget ds9 frame has system physical + $xpaget ds9 frame has wcs wcsa + $xpaget ds9 frame has wcs celestial wcsa + $xpaget ds9 frame has wcs linear wcsa + + $xpaset -p ds9 frame center # center current frame + $xpaset -p ds9 frame center 1 # center 'Frame1' + $xpaset -p ds9 frame center all # center all frames + $xpaset -p ds9 frame clear # clear current frame + $xpaset -p ds9 frame new # create new frame + $xpaset -p ds9 frame new rgb # create new rgb frame + $xpaset -p ds9 frame delete # delete current frame + $xpaset -p ds9 frame reset # reset current frame + $xpaset -p ds9 frame refresh # refresh current frame + $xpaset -p ds9 frame hide # hide current frame + $xpaset -p ds9 frame show 1 # show frame 'Frame1' + $xpaset -p ds9 frame move first # move frame to first in order + $xpaset -p ds9 frame move back # move frame back in order + $xpaset -p ds9 frame move forward # move frame forward in order + $xpaset -p ds9 frame move last # move frame to last in order + $xpaset -p ds9 frame first # goto first frame + $xpaset -p ds9 frame prev # goto prev frame + $xpaset -p ds9 frame next # goto next frame + $xpaset -p ds9 frame last # goto last frame + $xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if + needed + $xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed + $xpaset -p ds9 frame match wcs + $xpaset -p ds9 frame lock wcs + + gif + Load GIF image into current frame. + + Syntax: + gif [new|slice] [<filename>] + + Example: + $xpaget ds9 gif > foo.gif + + $xpaset -p ds9 gif foo.gif + $xpaset -p ds9 gif new foo.gif + $xpaset -p ds9 gif slice foo.gif + + $cat foo.gif | xpaset ds9 gif # not available windows + $cat foo.gif | xpaset ds9 gifnew # not available windows + $cat foo.gif | xpaset ds9 gifslice# not available windows + grid + Controls coordinate grid. For grid numeric format syntax, + click here. + Syntax: + grid [] +     [yes|no] +     [type analysis|publication] +     [system <coordsys>] +     [sky <skyframe>] +     [skyformat <skyformat>] +     [grid yes|no] +     [grid color <color>] +     [grid width <value>] +     [grid dash yes|no] +     [grid gap1 <value>] +     [grid gap2 <value>] +     [grid gap3 <value>] +     [axes yes|no] +     [axes color <color>] +     [axes width <value>] +     [axes dash yes|no] +     [axes type interior|exterior] +     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +     [format1 <format>] +     [format2 <format>] +     [tickmarks yes|no] +     [tickmarks color <color>] +     [tickmarks width <value>] +     [tickmarks dash yes|no] +     [border yes|no] +     [border color <color>] +     [border width <value>] +     [border dash yes|no] +     [numerics yes|no] +     [numerics font times|helvetica|courier] +     [numerics fontsize <value>] +     [numerics fontweight normal|bold] +     [numerics fontslant roman|italic] +     [numerics color <color>] +     [numerics gap1 <value>] +     [numerics gap2 <value>] +     [numerics gap3 <value>] +     [numerics type interior|exterior] +     [numerics vertical yes|no] +     [title yes|no] +     [title text <text>] +     [title def yes|no] +     [title gap <value>] +     [title font times|helvetica|courier] +     [title fontsize <value>] +     [title fontweight normal|bold] +     [title fontslant roman|italic] +     [title color <color>] +     [labels yes|no] +     [labels def1 yes|no] +     [labels def2 yes|no] +     [labels text1 <text>] +     [labels text2 <text>] +     [labels gap1 <value>] +     [labels gap2 <value>] +     [labels font times|helvetica|courier] +     [labels fontsize <value>] +     [labels fontweight normal|bold] +     [labels fontslant roman|italic] +     [labels color <color>] +     [reset] +     [load <filename>] +     [save <filename>] +     [open|close] + + Example: + $xpaget ds9 grid + $xpaget ds9 grid type + $xpaget ds9 grid system + $xpaget ds9 grid sky + $xpaget ds9 grid skyformat + $xpaget ds9 grid grid + $xpaget ds9 grid grid color + $xpaget ds9 grid grid width + $xpaget ds9 grid grid dash + $xpaget ds9 grid grid gap1 + $xpaget ds9 grid grid gap2 + $xpaget ds9 grid grid gap3 + $xpaget ds9 grid axes + $xpaget ds9 grid axes color + $xpaget ds9 grid axes width + $xpaget ds9 grid axes dash + $xpaget ds9 grid axes type + $xpaget ds9 grid axes origin + $xpaget ds9 grid format1 + $xpaget ds9 grid format2 + $xpaget ds9 grid tickmarks + $xpaget ds9 grid tickmarks color + $xpaget ds9 grid tickmarks width + $xpaget ds9 grid tickmarks dash + $xpaget ds9 grid border + $xpaget ds9 grid border color + $xpaget ds9 grid border width + $xpaget ds9 grid border dash + $xpaget ds9 grid numerics + $xpaget ds9 grid numerics font + $xpaget ds9 grid numerics fontsize + $xpaget ds9 grid numerics fontweight + $xpaget ds9 grid numerics fontslant + $xpaget ds9 grid numerics color + $xpaget ds9 grid numerics gap1 + $xpaget ds9 grid numerics gap2 + $xpaget ds9 grid numerics gap3 + $xpaget ds9 grid numerics type + $xpaget ds9 grid numerics vertical + $xpaget ds9 grid title + $xpaget ds9 grid title text + $xpaget ds9 grid title def + $xpaget ds9 grid title gap + $xpaget ds9 grid title font + $xpaget ds9 grid title fontsize + $xpaget ds9 grid title fontweight + $xpaget ds9 grid title fontslant + $xpaget ds9 grid title color + $xpaget ds9 grid labels + $xpaget ds9 grid labels text1 + $xpaget ds9 grid labels def1 + $xpaget ds9 grid labels gap1 + $xpaget ds9 grid labels text2 + $xpaget ds9 grid labels def2 + $xpaget ds9 grid labels gap2 + $xpaget ds9 grid labels font + $xpaget ds9 grid labels fontsize + $xpaget ds9 grid labels fontweight + $xpaget ds9 grid labels fontslant + $xpaget ds9 grid labels color + + $xpaset -p ds9 grid + $xpaset -p ds9 grid yes + $xpaset -p ds9 grid type analysis + $xpaset -p ds9 grid system wcs + $xpaset -p ds9 grid sky fk5 + $xpaset -p ds9 grid skyformat degrees + $xpaset -p ds9 grid grid yes + $xpaset -p ds9 grid grid color red + $xpaset -p ds9 grid grid width 2 + $xpaset -p ds9 grid grid dash yes + $xpaset -p ds9 grid grid gap1 10 + $xpaset -p ds9 grid grid gap2 10 + $xpaset -p ds9 grid grid gap3 10 + $xpaset -p ds9 grid axes yes + $xpaset -p ds9 grid axes color red + $xpaset -p ds9 grid axes width 2 + $xpaset -p ds9 grid axes dash yes + $xpaset -p ds9 grid axes type exterior + $xpaset -p ds9 grid axes origin lll + $xpaset -p ds9 grid format1 d.2 + $xpaset -p ds9 grid format2 d.2 + $xpaset -p ds9 grid tickmarks yes + $xpaset -p ds9 grid tickmarks color red + $xpaset -p ds9 grid tickmarks width 2 + $xpaset -p ds9 grid tickmarks dash yes + $xpaset -p ds9 grid border yes + $xpaset -p ds9 grid border color red + $xpaset -p ds9 grid border width 2 + $xpaset -p ds9 grid border dash yes + $xpaset -p ds9 grid numerics yes + $xpaset -p ds9 grid numerics font courier + $xpaset -p ds9 grid numerics fontsize 12 + $xpaset -p ds9 grid numerics fontweight bold + $xpaset -p ds9 grid numerics fontslant italic + $xpaset -p ds9 grid numerics color red + $xpaset -p ds9 grid numerics gap1 10 + $xpaset -p ds9 grid numerics gap2 10 + $xpaset -p ds9 grid numerics gap3 10 + $xpaset -p ds9 grid numerics type exterior + $xpaset -p ds9 grid numerics vertical yes + $xpaset -p ds9 grid title yes + $xpaset -p ds9 grid title text {Hello World} + $xpaset -p ds9 grid title def yes + $xpaset -p ds9 grid title gap 10 + $xpaset -p ds9 grid title font courier + $xpaset -p ds9 grid title fontsize 12 + $xpaset -p ds9 grid title fontweight bold + $xpaset -p ds9 grid title fontslant italic + $xpaset -p ds9 grid title color red + $xpaset -p ds9 grid labels yes + $xpaset -p ds9 grid labels text1 {Hello World} + $xpaset -p ds9 grid labels def1 yes + $xpaset -p ds9 grid labels gap1 10 + $xpaset -p ds9 grid labels text2 {Hello World} + $xpaset -p ds9 grid labels def2 yes + $xpaset -p ds9 grid labels gap2 10 + $xpaset -p ds9 grid labels font courier + $xpaset -p ds9 grid labels fontsize 12 + $xpaset -p ds9 grid labels fontweight boldj + $xpaset -p ds9 grid labels fontslant italic + $xpaset -p ds9 grid labels color red + $xpaset -p ds9 grid reset + $xpaset -p ds9 grid load foo.grd + $xpaset -p ds9 grid save foo.grd + $xpaset -p ds9 grid open + $xpaset -p ds9 grid close + header + Display current fits header dialog. Optional extension number + maybe specified. Please note, this differs from xpa fits header. + Syntax: + header [<ext>] +     [close [<ext>]] +     [save [<ext>] <filename>] + + Example: + $xpaset -p ds9 header + $xpaset -p ds9 header 2 + $xpaset -p ds9 header close + $xpaset -p ds9 header save 1 foo.txt + + height + Set the height of the image display window. + Syntax: + height [<value>] + + Example: + $xpaget ds9 height + + $xpaset -p ds9 height 512 + + iconify + Toggles iconification. + Syntax: + iconify [] +     [yes|no] + + Example: + $xpaget ds9 iconify + + $xpaset -p ds9 iconify + $xpaset -p ds9 iconify yes + + iexam + Interactive examine function. A blinking cursor will indicate + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is + button. In the last form, the following macros will be + expanded if present: $width, $height, $depth, $bitpix, + $filename, $regions, $filename[$regions], $env, $pan, $value, + $x, $y, $z. See Analysis + Macros for more information. + + Syntax: + iexam [] +     [[]|button|key|any] coordinate + <coordsys> [<skyframe>] [<skyformat>] +     [[]|button|key|any] data [width][height] +     [[]|button|key|any] <macro string>] + + Example: + $xpaget ds9 iexam # image coordinates + $xpaget ds9 iexam coordinate image + $xpaget ds9 iexam key coordinate image # return coordinate and + key event + $xpaget ds9 iexam coordinate wcs fk5 degrees + $xpaget ds9 iexam coordinate wcs galactic sexagesimal + $xpaget ds9 iexam coordinate fk5 + $xpaget ds9 iexam data # return data value + $xpaget ds9 iexam key data # return data value and key event + $xpaget ds9 iexam data 3 3 # return all data in 3x3 box about + selected point + $xpaget ds9 iexam {'Click at $x,$y in file $filename'} + iis + Set/Get IIS Filename. Optional mosaic number maybe supplied. + Syntax: + iis [filename <filename> [#]] + + Example: + $xpaget ds9 iis filename + $xpaget ds9 iis filename 4 + + $xpaset -p ds9 iis filename foo.fits + $xpaset -p ds9 iis filename bar.fits 4 + jpeg + Load JPEG image into current frame. Optional parameters: jpeg + quality (1-100) + Syntax: + jpeg [new|slice] [<filename>] [1-100] + + Example: + $xpaget ds9 jpeg > foo.jpeg + $xpaget ds9 jpeg 100 > foo.jpeg + + $xpaset -p ds9 jpeg foo.jpeg + $xpaset -p ds9 jpeg new foo.jpeg + $xpaset -p ds9 jpeg slice foo.jpeg + + $cat foo.jpeg | xpaset ds9 jpeg# not available windows + $cat foo.jpeg | xpaset ds9 jpegnew# not available windows + $cat foo.jpeg | xpaset ds9 jpegslice# not available windows + lock + Lock all other frames to the current frame. + Syntax: + lock[frame <coordsys>|none] +     [crosshair <coordsys>|none] +     [crop <coordsys>|none] +     [slice <coordsys>|none]] +     [bin [yes|no]] +     [axes [yes|no]] +     [scale [yes|no]] +     [scalelimites [yes|no]] +     [colorbar [yes|no]] +     [block [yes|no]] +     [smooth [yes|no]] +     [3d [yes|no]] + + Example: + $xpaget -p ds9 lock frame + $xpaget -p ds9 lock crosshair + $xpaget -p ds9 lock crop + $xpaget -p ds9 lock slice + $xpaget -p ds9 lock bin + $xpaget -p ds9 lock axes + $xpaget -p ds9 lock scale + $xpaget -p ds9 lock scalelimits + $xpaget -p ds9 lock colorbar + $xpaget -p ds9 lock block + $xpaget -p ds9 lock smooth + $xpaget -p ds9 lock 3d + + $xpaset -p ds9 lock frame wcs + $xpaset -p ds9 lock crosshair wcs + $xpaset -p ds9 lock crop wcs + $xpaset -p ds9 lock slice wcs + $xpaset -p ds9 lock bin yes + $xpaset -p ds9 lock axes yes + $xpaset -p ds9 lock scale yes + $xpaset -p ds9 lock scalelimits yes + $xpaset -p ds9 lock colorbar yes + $xpaset -p ds9 lock block yes + $xpaset -p ds9 lock smooth yes + $xpaset -p ds9 lock 3d yes + + lower + Lower in the window stacking order. + Syntax: + lower + + Example: + $xpaset -p ds9 lower + + magnifier + Controls the magnifier settings. + Syntax: + magnifier [color <color>] +     [zoom <value>] +     [cursor yes|no] +     [region yes|no] + + Example: + $xpaget ds9 magnifier color + $xpaget ds9 magnifier zoom + $xpaget ds9 magnifier cursor + $xpaget ds9 magnifier region + + $xpaset -p ds9 magnifier color yellow + $xpaset -p ds9 magnifier zoom 2 + $xpaset -p ds9 magnifier cursor no + $xpaset -p ds9 magnifier region no + mask + + Controls mask parameters. + Syntax: + mask [color <color>] +     [mark zero|nonzero|nan|nonnan|range] +     [range <low> <high>] +     [transparency <value>] +     [system <coordsys>] +     [clear] +     [open|close] + + Example: + $xpaget ds9 mask color + $xpaget ds9 mask mark + $xpaget ds9 mask range + $xpaget ds9 mask system + $xpaget ds9 mask transparency + + $xpaset -p ds9 mask color red + $xpaset -p ds9 mask mark zero + $xpaset -p ds9 mask range 10 100 + $xpaset -p ds9 mask transparency 50 + $xpaset -p ds9 mask system wcs + $xpaset -p ds9 mask clear + $xpaset -p ds9 mask open + $xpaset -p ds9 mask close + match + Match all other frames to the current frame. + Syntax: + match[frame <coordsys>] +     [crosshair <coordsys>] +     [crop <coordsys>] +     [slice <coordsys>] +     [bin] +     [axes] +     [scale] +     [scalelimits] +     [colorbar] +     [block] +     [smooth] +     [3d] + + Example: + $xpaset -p ds9 match frame wcs + $xpaset -p ds9 match crosshair wcs + $xpaset -p ds9 match crop wcs + $xpaset -p ds9 match slicewcs + $xpaset -p ds9 match bin + $xpaset -p ds9 match axes + $xpaset -p ds9 match scale + $xpaset -p ds9 match scalelimits + $xpaset -p ds9 match colorbar + $xpaset -p ds9 match block + $xpaset -p ds9 match smooth + $xpaset -p ds9 match 3d + + mecube + Load FITS multiple extension file as data cube. + + Syntax: + mecube [new] [<filename>] + + Example: + $xpaget ds9 mecube > foo.fits + + $xpaset -p ds9 mecube foo.fits + $xpaset -p ds9 mecube new foo.fits + + $cat foo.fits | xpaset ds9 mecube + $cat foo.fits | xpaset ds9 mecube new + minmax + This is how DS9 determines the min and max data values + from the data. SCAN will scan all data. DATAMIN + and IRAFMIN will use the values of the keywords if + present. + + Syntax: + minmax [scan|sample|datamin|irafmin] +     [mode scan|sample|datamin|irafmin] +     [interval #] + + Example: + $xpaget ds9 minmax mode + $xpaget ds9 minmax interval + + $xpaset -p ds9 minmax scan + $xpaset -p ds9 minmax mode scan + $xpaset -p ds9 minmax interval 100 + + mode + Controls the first mouse button mode. + Syntax: + mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + + Example: + $xpaget ds9 mode + $xpaset -p ds9 mode crosshair + mosaic + Load FITS mosaic segment into current frame. + Syntax: + mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + + Example: + $xpaget ds9 mosaic > foo.fits + + $xpaset -p ds9 mosaic foo.fits + $xpaset -p ds9 mosaic wcs foo.fits + $xpaset -p ds9 mosaic wcs new foo.fits + $xpaset -p ds9 mosaic wcs mask foo.fits + + $cat foo.fits | xpaset ds9 mosaic + $cat foo.fits | xpaset ds9 mosaic wcs + $cat foo.fits | xpaset ds9 mosaic wcs new + $cat foo.fits | xpaset ds9 mosaic wcs mask + + mosaicimage + Load FITS mosaic image into current frame. + Syntax: + mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] + [<filename>] + + Example: + $xpaget ds9 mosaicimage > foo.fits + + $xpaset -p ds9 mosaicimage foo.fits + $xpaset -p ds9 mosaicimage wcs foo.fits + $xpaset -p ds9 mosaicimage wcs new foo.fits + $xpaset -p ds9 mosaicimage wcs mask foo.fits + + $cat foo.fits | xpaset ds9 mosaicimage + $cat foo.fits | xpaset ds9 mosaicimage wcs + $cat foo.fits | xpaset ds9 mosaicimage wcs new + $cat foo.fits | xpaset ds9 mosaicimage wcs mask + + movie + + Create a movie from snap shots of the DS9 window. A slice + movie cycles though all slices of a cube. A frame + movie cycles through all active frames. A 3d movie + cycles through specified viewing angles. The default action is slice. + Movie types are either MPEG or Animated GIF, + with default MPEG. Optional parameters for 3d: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times. + Syntax: + movie [slice|frame|3d][mpeg|gif] <filename> + movie 3d [mpeg|gif] <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>] + + Example: + $xpaset -p ds9 movie slice mpeg ds9.mpg + $xpaset -p ds9 movie frame gif ds9.gif + $xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto + 60 oscillate 1 + + multiframe + Load FITS multiple extension file as multiple images. + + Syntax: + multiframe [<filename>] + + Example: + $xpaset -p ds9 multiframe foo.fits + + $cat foo.fits | xpaset ds9 multiframe# not available windows + nameserver + Support Name Server functions. Coordinates are in fk5. + Syntax: + nameserver [<object>] +     [name <object>] +     + [serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] +     [skyformat degrees|sexagesimal] +     [pan] +     [crosshair] +     [open|close] + + Example: + $xpaget ds9 nameserver + $xpaget ds9 nameserver server + $xpaget ds9 nameserver skyformat + $xpaget ds9 nameserver m31 + + $xpaset -p ds9 nameserver m31 + $xpaset -p ds9 nameserver name m31 + $xpaset -p ds9 nameserver server ned-sao + $xpaset -p ds9 nameserver skyformat sexagesimal + $xpaset -p ds9 nameserver pan + $xpaset -p ds9 nameserver crosshair + $xpaset -p ds9 nameserver open + $xpaset -p ds9 nameserver close + nan + Set image not-a-number color. + Syntax: + nan <color> + + Example: + $xpaget ds9 nan + + $xpaset -p ds9 nan red + + nrrd + Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: + array endian. + + Syntax: + nrrd [native|little|big] + nrrd [new|mask] [<filename>] + + Example: + $xpaget ds9 nrrd + $xpaget ds9 nrrd big + + $xpaset -p ds9 nrrd foo.nrrd + $xpaset -p ds9 nrrd new foo.nrrd + $xpaset -p ds9 nrrd mask foo.nrrd + + $cat foo.nrrd | xpaset ds9 nrrd + $cat foo.nrrd | xpaset ds9 nrrdnew + $cat foo.nrrd | xpaset ds9 nrrd mask + nvss + Support for NRAO VLA Sky Survey. + Syntax: + nvss [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $xpaget ds9 nvss name + $xpaget ds9 nvss coord + $xpaget ds9 nvss size + $xpaget ds9 nvss save + $xpaget ds9 nvss frame + + $xpaset -p ds9 nvss + $xpaset -p ds9 nvss m31 + $xpaset -p ds9 nvss name m31 + $xpaset -p ds9 nvss name clear + $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 nvss size 60 60 arcmin + $xpaset -p ds9 nvss save yes + $xpaset -p ds9 nvss frame current + $xpaset -p ds9 nvss update frame + $xpaset -p ds9 nvss open + $xpaset -p ds9 nvss close + orient + Controls the orientation of the current frame. + Syntax: + orient [none|x|y|xy] +     [open|close] + + Example: + $xpaget ds9 orient + + $xpaset -p ds9 orient xy + $xpaset -p ds9 orient open + $xpaset -p ds9 orient close + + pagesetup + Controls Page Setup options. + + Syntax: + pagesetup [orient portrait|landscape] +     [scale <numberic>] +     [size letter|legal|tabloid|poster|a4] + + Example: + $xpaget ds9 pagesetup orient + $xpaget ds9 pagesetup scale + $xpaget ds9 pagesetup size + + $xpaset -p ds9 pagesetup orient portrait + $xpaset -p ds9 pagesetup scale 50 + $xpaset -p ds9 pagesetup size poster + + pan + Controls the current image cursor location for the current + frame. + Syntax: + pan [<coordsys> [<skyframe>] [<skyformat>]] # + get current coords + + pan [<x> <y> <coordsys> [<skyframe>]] # + relative +     [to <x> <y> <coordsys> + [<skyframe>]] # absolute +     [open|close] + + Example: + $xpaget ds9 pan # get current image coords + $xpaget ds9 pan wcs fk4 sexagesimal # get current coords + + $xpaset -p ds9 pan 200 200 image # pan relative + $xpaset -p ds9 pan to 400 400 physical # pan to physical coords + $xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs + coords + $xpaset -p ds9 pan open + $xpaset -p ds9 pan close + + pixeltable + Display/Hide the pixel table. + Syntax: + pixeltable [] +     [yes|open] +     [no|close] + + Example: + $xpaget ds9 pixeltable + + $xpaset -p ds9 pixeltable + $xpaset -p ds9 pixeltable yes + $xpaset -p ds9 pixeltable open + $xpaset -p ds9 pixeltable close + plot + Display and configure data plots. All plot commands take an + optional second command, the plot name. If no plot name is + specified, the last plot created is assumed. Plot data is + assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions: + xy     x and y coordinates + xyex    x,y coordinates with x errors + xyey    x,y coordinates with y errors + xyexey    x,y coordinates with x and y + errors + + To create a new plot, use the plot new command. + Syntax: + # create new empty plot window + plot [] +     [line|bar|scatter] +     [new] +     [new line|bar|scatter] +     [new name <plotname>] +     [new name <plotname> line|bar|scatter] + + # create new plot with data from stdin + plot[new <title> <xaxis label> <yaxis + label>xy|xyex|xyey|xyexey] +     [new [line|bar|scatter] <title> + <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] +     [newname <plotname><title> + <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] +     [newname <plotname>line|bar|scatter + <title> <xaxis label> <yaxis + label>xy|xyex|xyey|xyexey] + + # create new plot with data from stdin which includes title/dim + headers + plot [new stdin] +     [new[line|bar|scatter]stdin] +     [new name <plotname> stdin] +     [new name + <plotname>line|bar|scatterstdin] + + #load data into existing plot from stdin + plot [[<plotname>] data xy|xyex|xyey|xyexey] + + # existing plot + plot[[<plotname>] load <filename> + xy|xyex|xyey|xyexey] +     [[<plotname>] save <filename>] +     [[<plotname>] clear] +     [[<plotname>] duplicate [#]] +     [[<plotname>] stats yes|no] +     [[<plotname>] list yes|no] +     [[<plotname>] loadconfig + <filename>] +     [[<plotname>] saveconfig + <filename>] +     [[<plotname>] pagesetup orient + portrait|landscape] +     [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4] +     [[<plotname>] print] +     [[<plotname>] print destination + printer|file] +     [[<plotname>] print command + <command>] +     [[<plotname>] print filename + <filename>] +     [[<plotname>] print color rgb|gray] +     [[<plotname>] close] +     [[<plotname>] mode pointer|zoom] + + # export image + plot[[<plotname>] + export[gif|tiff|jpeg|png]<filename> +     [[<plotname>] export jpeg + <filename>[1-100] +     [[<plotname>]export tiff + <filename>[none|jpeg|packbits|deflate] + + # configure graph + plot [[<plotname>] axis x|y grid yes|no] +     [[<plotname>] axis x|y log yes|no] +     [[<plotname>] axis x|y flip yes|no] +     [[<plotname>] axis x|y auto yes|no] +     [[<plotname>] axis x|y min + <value>] +     [[<plotname>] axis x|y max + <value>] +     [[<plotname>] axis x|y format + <string>] +     [[<plotname>] background <value>] +     [[<plotname>] legend yes|no] +     [[<plotname>] legend position + right|left|top|bottom] +     [[<plotname>] font title|labels|numbers + font times|helvetica|courier] +     [[<plotname>] + fonttitle|labels|numberssize <value>] +     [[<plotname>] + fonttitle|labels|numbersweight normal|bold] +     [[<plotname>] + fonttitle|labels|numbersslant roman|italic] +     [[<plotname>] title <string>] +     [[<plotname>] title x|y <string>] +     [[<plotname>] barmode + normal|stacked|aligned|overlap] + + # configure current dataset + plot [[<plotname>] show yes|no] +     [[<plotname>] shape + none|circle|square|diamond|plus|splus|scross|triangle|arrow] +     [[<plotname>] shape fill yes|no] +     [[<plotname>] shape color + <value>] +     [[<plotname>] smooth + step|linear|cubic|quadratic|catrom] +     [[<plotname>] color <value>] +     [[<plotname>] width <value>] +     [[<plotname>] dash yes|no] +     [[<plotname>] error yes|no] +     [[<plotname>] error color + <value>] +     [[<plotname>] error cap yes|no] +     [[<plotname>] error width + <value>] +     [[<plotname>] name <string>] + + # select current dataset + plot [[<plotname>] select <value>] + + Example: + # return all plotnames + $xpaget ds9 plot + + # create new empty plot window + $xpaset -p ds9 plot + $xpaset -p ds9 plot bar + $xpaset -p ds9 plot new + $xpaset -p ds9 plot new bar + $xpaset -p ds9 plot new name foo + $xpaset -p ds9 plot new name foo bar + + # create new plot with data from stdin + $cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} + xy + $cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y + Axis} xy + $cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} + {Y Axis} xy + $cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X + Axis} {Y Axis} xy + + # create new plot with data from stdin which includes title/dim + headers + $cat stdin.2.dat | xpaset ds9 plot new stdin + $cat stdin.2.dat | xpaset ds9 plot new line stdin + $cat stdin.2.dat | xpaset ds9 plot new name foo stdin + $cat stdin.2.dat | xpaset ds9 plot new name foo line stdin + + #load data into existing plot from stdin + $cat xy.dat | xpaset ds9 plot data xy + $cat xy.dat | xpaset ds9 plot foo data xy + + # existing plot + $xpaget ds9 plot stats + $xpaget ds9 plot list + + $xpaset -p ds9 plot load xy.dat xy + $xpaset -p ds9 plot save foo.dat + $xpaset -p ds9 plot clear + $xpaset -p ds9 plot duplicate 1 + $xpaset -p ds9 plot stats yes + $xpaset -p ds9 plot list yes + $xpaset -p ds9 plot loadconfig foo.plt + $xpaset -p ds9 plot saveconfig foo.plt + $xpaset -p ds9 plot pagesetup orient portrait + $xpaset -p ds9 plot pagesetup size letter + $xpaset -p ds9 plot print + $xpaset -p ds9 plot print destination file + $xpaset -p ds9 plot print command lp + $xpaset -p ds9 plot print filename foo.ps + $xpaset -p ds9 plot print color rgb + $xpaset -p ds9 plot close + + # plot mode + $xpaget ds9 plot mode + + $xpaset -p ds9 plot mode pointer + + # export plot + $xpaset -p ds9 plot export tiff foo.tiff jpeg + $xpaset -p ds9 plot export jpeg foo.jpeg 75 + $xpaset -p ds9 plot export png foo.png + + # configure plot + $xpaget ds9 plot axis x grid + $xpaget ds9 plot axis x log + $xpaget ds9 plot axis x flip + $xpaget ds9 plot axis x auto + $xpaget ds9 plot axis x min + $xpaget ds9 plot axis x max + $xpaget ds9 plot axis x format + $xpaget ds9 plot background + $xpaget ds9 plot legend + $xpaget ds9 plot legend position + $xpaget ds9 plot font numbers font + $xpaget ds9 plot font numbers size + $xpaget ds9 plot font numbers weight + $xpaget ds9 plot font numbers slant + $xpaget ds9 plot title + $xpaget ds9 plot title xaxis + $xpaget ds9 plot title yaxis + + $xpaset -p ds9 plot axis x grid yes + $xpaset -p ds9 plot axis x log yes + $xpaset -p ds9 plot axis x flip yes + $xpaset -p ds9 plot axis x auto no + $xpaset -p ds9 plot axis x min 1 + $xpaset -p ds9 plot axis x max 100 + $xpaset -p ds9 plot axis x format {%f} + $xpaset -p ds9 plot background white + $xpaset -p ds9 plot legend yes + $xpaset -p ds9 plot legend position left + $xpaset -p ds9 plot font numbers font times + $xpaset -p ds9 plot font numbers size 12 + $xpaset -p ds9 plot font numbers weight bold + $xpaset -p ds9 plot font numbers slant italic + $xpaset -p ds9 plot title {This is a Title} + $xpaset -p ds9 plot title x {X Axis} + $xpaset -p ds9 plot title y {Y Axis} + $xpaset -p ds9 plot title legend {This is the Legend} + + # bar plot + $xpaget ds9 plot barmode + + $xpaset -p ds9 plot barmode aligned + + # configure current dataset + $xpaget ds9 plot show + $xpaget ds9 plot shape + $xpaget ds9 plot shape fill + $xpaget ds9 plot shape color + $xpaget ds9 plot smooth + $xpaget ds9 plot color + $xpaget ds9 plot width + $xpaget ds9 plot dash + $xpaget ds9 plot error + $xpaget ds9 plot error color + $xpaget ds9 plot error cap + $xpaget ds9 plot error width + $xpaget ds9 plot name + + $xpaset -p ds9 plot show yes + $xpaset -p ds9 plot shape circle + $xpaset -p ds9 plot shape fill no + $xpaset -p ds9 plot shape color cyan + $xpaset -p ds9 plot smooth step + $xpaset -p ds9 plot color red + $xpaset -p ds9 plot width 2 + $xpaset -p ds9 plot dash yes + $xpaset -p ds9 plot error yes + $xpaset -p ds9 plot error color red + $xpaset -p ds9 plot error cap yes + $xpaset -p ds9 plot error width 2 + $xpaset -p ds9 plot name {My Data} + + # select current dataset + $xpaget ds9 plot select + + $xpaset -p ds9 plot select 2 + png + Load PNG image into current frame. + + Syntax: + png [new|slice] [<filename>] + + Example: + $xpaget ds9 png > foo.png + + $xpaset -p ds9 png foo.png + $xpaset -p ds9 png new foo.png + $xpaset -p ds9 png slice foo.png + + $cat foo.png | xpaset ds9 png + $cat foo.png | xpaset ds9 png new + $cat foo.png | xpaset ds9 png slice + precision + Set region and coordinate output format precision. + Syntax: + precision <linear><degree><hms><dms><arcmin><arcsec> - - -Example: -$xpaget ds9 precision -$xpaset -p ds9 precision 8 10 4 3 5 3 -prefs -Controls various preference settings. -Syntax: -prefs [clear] -    [irafalign yes|no] - -Example: -$xpaget ds9 prefs irafalign -$xpaset -p ds9 prefs clear -$xpaset -p ds9 prefs iraf yes -preserve -Preserve the follow attributes while loading a new image. -Syntax: -preserve [pan yes|no] -      [regions yes|no] - -Example: -$xpaget ds9 preserve pan -$xpaget ds9 preserve regions -$xpaset -p ds9 preserve pan yes -$xpaset -p ds9 preserve regions yes -psprint -Invokes postscript printing. Please see print for further details. -print -Controls printing. Use print option to set printing options. -Only available for XPA_METHOD local. -Syntax: -print [destination printer|file] -    [command <command>] -    [filename <filename>] -    [color rgb|cmyk|gray] -    [level 1|2|3] -    [resolution -72|screen|96|144|150|225|300|600|1200] - -Example: -$xpaget ds9 print destination -$xpaget ds9 print command -$xpaget ds9 print filename -$xpaget ds9 print color -$xpaget ds9 print level -$xpaget ds9 print resolution -$xpaset -p ds9 print -$xpaset -p ds9 print destination file -$xpaset -p ds9 print command lp -$xpaset -p ds9 print filename foo.ps -$xpaset -p ds9 print color cmyk -$xpaset -p ds9 print level 2 -$xpaset -p ds9 print resolution 96 -raise -Raise in the window stacking order. -Syntax: -raise - -Example: -$xpaset -p ds9 raise -regions -Controls regions in the current frame. -Syntax: -regions [<filename>] -    [load [all] <filename>] -    [save <filename>] -    [list [close]] -    [epsilon <integer>] -    [show yes|no] -    [showtext yes|no] -    [centroid] -    [centroid auto yes|no] -    [centroid radius <value>|iteration -<value>] -    [getinfo] -    [move front] -    [move back] -    [select all] -    [select none] -    [select invert] -    [delete all] -    [delete select] -    [format -ds9|xml|ciao|saotng|saoimage|pros|xy] -    [system image|physical|wcs|wcsa...wcsz] -    [sky fk4|fk5|icrs|galactic|ecliptic] -    [skyformat degrees|sexagesimal] -    [strip yes|no] -    [shape <shape>] -    [color &ltcolor>] -    [width <width>] -    [fixed|edit|rotate|delete yes|no] -    [include|exclude|source|background] -    [command <marker command>] -    [composite] -    [dissolve] -    [template <filename>] -    [template <filename> at <ra> -<dec> <coordsys> <skyframe>] -    [savetemplate <filename>] -    [groups] -    [group new] -    [group <tag> new] -    [group <tag> update] -    [group <tag> select] -    [group <tag> color &ltcolor>] -    [group <tag> copy] -    [group <tag> delete] -    [group <tag> cut] -    [group <tag> font <font>] -    [group <tag> move <int> -<int>] -    [group <tag> movefront] -    [group <tag> moveback] -    [group <tag> property <property> -yes|no] -    [copy] -    [cut] -    [paste image|physical|wcs|wcsa...wcsz] -    [undo] -    [-format ds9|ciao|saotng|saoimage|pros|xy] -    [-system image|physical|wcs|wcsa...wcsz] -    [-sky fk4|fk5|icrs|galactic|ecliptic] -    [-skyformat degrees|sexagesimal] -    [-delim [nl|<char>]] -    [-prop -select|edit|move|rotate|delete|fixed|include|source 1|0] -    [-group <tag>] -    [-strip yes|no] -    [-wcs yes|no] - -Example: -$xpaget ds9 regions -$xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat -sexagesimal -prop edit 1 -group foo -$xpaget ds9 regions epsilon -$xpaget ds9 regions show -$xpaget ds9 regions showtext -$xpaget ds9 regions centroid auto -$xpaget ds9 regions centroid radius -$xpaget ds9 regions centroid iteration -$xpaget ds9 regions selected -$xpaget ds9 regions format -$xpaget ds9 regions system -$xpaget ds9 regions sky -$xpaget ds9 regions skyformat -$xpaget ds9 regions strip -$xpaget ds9 regions shape -$xpaget ds9 regions color -$xpaget ds9 regions width -$xpaget ds9 regions source -$xpaget ds9 regions background -$xpaget ds9 regions include -$xpaget ds9 regions exclude -$xpaget ds9 regions selected -$xpaget ds9 regions groups -$cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky -fk5 -$cat bar.reg | xpaset ds9 regions -format ds9 -$echo "image; circle 100 100 20" | xpaset ds9 regions -$echo "image; circle 100 100 20" | xpaset ds9 regions -$echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions -$echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions -$echo "box 100 100 20 40 25" | xpaset ds9 regions -$echo "image; line 100 100 200 400" | xpaset ds9 regions -$echo "physical; ruler 200 300 200 400" | xpaset ds9 regions -$echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 -regions -$echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 -regions -$xpaset -p ds9 regions foo.reg -$xpaset -p ds9 regions -format ciao bar.reg # load as ciao -format -$xpaset -p ds9 regions foo.fits # FITS regions files do not need a -format specification -$xpaset -p ds9 regions load foo.reg # load foo.reg into current -frame -$xpaset -p ds9 regions load all foo.reg # load foo.reg into all -frames -$xpaset -p ds9 regions load '*.reg'# expand *.reg and load into -current frame -$xpaset -p ds9 regions load all '*.reg' # expand *.reg and load -into all frames -$xpaset -p ds9 regions save foo.reg -$xpaset -p ds9 regions list -$xpaset -p ds9 regions list close -$xpaset -p ds9 regions epsilon 5 -$xpaset -p ds9 regions show yes -$xpaset -p ds9 regions showtext no -$xpaset -p ds9 regions centroid -$xpaset -p ds9 regions centroid auto yes -$xpaset -p ds9 regions centroid radius 10 -$xpaset -p ds9 regions centroid iteration 20 -$xpaset -p ds9 regions getinfo -$xpaset -p ds9 regions move back -$xpaset -p ds9 regions move front -$xpaset -p ds9 regions select all -$xpaset -p ds9 regions select none -$xpaset -p ds9 regions select invert -$xpaset -p ds9 regions delete all -$xpaset -p ds9 regions delete select -$xpaset -p ds9 regions format ds9 -$xpaset -p ds9 regions system wcs -$xpaset -p ds9 regions sky fk5 -$xpaset -p ds9 regions skyformat degrees -$xpaset -p ds9 regions strip yes -$xpaset -p ds9 regions shape ellipse -$xpaset -p ds9 regions color red -$xpaset -p ds9 regions width 3 -$xpaset -p ds9 regions edit yes -$xpaset -p ds9 regions include -$xpaset -p ds9 regions command '{circle 100 100 20 # -color=red}' -$xpaset -p ds9 regions composite -$xpaset -p ds9 regions dissolve -$xpaset -p ds9 regions template foo.tpl -$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 +47:12:48.02 -fk5 -$xpaset -p ds9 regions savetemplate foo.tpl -$xpaset -p ds9 regions group new -$xpaset -p ds9 regions group foo new -$xpaset -p ds9 regions group foo update -$xpaset -p ds9 regions group foo select -$xpaset -p ds9 regions group foo color red -$xpaset -p ds9 regions group foo copy -$xpaset -p ds9 regions group foo delete -$xpaset -p ds9 regions group foo cut -$xpaset -p ds9 regions group foo font {times 14 bold} -$xpaset -p ds9 regions group foo move 100 100 -$xpaset -p ds9 regions group foo movefront -$xpaset -p ds9 regions group foo moveback -$xpaset -p ds9 regions group foo property delete no - -$xpaset -p ds9 regions copy -$xpaset -p ds9 regions cut -$xpaset -p ds9 regions paste wcs -$xpaset -p ds9 regions undo -restore -Restore DS9 to a previous state from a backup save set. -Syntax: -restore <filename> - -Example: -$xpaset -p ds9 restore ds9.bck -rgb -Create RGB frame and control RGB frame parameters. -Syntax: -rgb [] -    [red|green|blue] -    [channel [red|green|blue]] -    [view [red|green|blue] [yes|no]] -    [system <coordsys>] -    [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]] -    [open|close] - -Example: -$xpaget ds9 rgb channel -$xpaget ds9 rgb lock wcs -$xpaget ds9 rgb lock crop -$xpaget ds9 rgb lock slice -$xpaget ds9 rgb lock bin -$xpaget ds9 rgb lock scale -$xpaset ds9 rgb lock scalelimits -$xpaget ds9 rgb lock colorbar -$xpaget ds9 rgb lock block -$xpaget ds9 rgb lock smooth -$xpaget ds9 rgb system -$xpaget ds9 rgb view red -$xpaget ds9 rgb view green -$xpaget ds9 rgb view blue -$xpaset -p ds9 rgb # create new rgb frame -$xpaset -p ds9 rgb red # set current channel to red -$xpaset -p ds9 rgb channel red # set current channel to red -$xpaset -p ds9 rgb view blue no # turn off blue channel -$xpaset -p ds9 rgb system wcs # set rgb coordinate system -$xpaset -p ds9 rgb lock wcs yes -$xpaset -p ds9 rgb lock crop yes -$xpaset -p ds9 rgb lock slice yes -$xpaset -p ds9 rgb lock bin yes -$xpaset -p ds9 rgb lock scale yes -$xpaset -p ds9 rgb lock scalelimits yes -$xpaset -p ds9 rgb lock colorbar yes -$xpaset -p ds9 rgb lock block yes -$xpaset -p ds9 rgb lock smooth yes -$xpaset -p ds9 rgb open -$xpaset -p ds9 rgb close -rgbarray -Load raw data array cube into rgb frame. -Syntax: -rgbarray [native|big|little] -rgbarray [new] + + Example: + $xpaget ds9 precision + + $xpaset -p ds9 precision 8 10 4 3 5 3 + prefs + Controls various preference settings. + Syntax: + prefs [clear] +     [irafalign yes|no] + + Example: + $xpaget ds9 prefs irafalign + + $xpaset -p ds9 prefs clear + $xpaset -p ds9 prefs iraf yes + + preserve + Preserve the follow attributes while loading a new image. + Syntax: + preserve [pan yes|no] +       [regions yes|no] + + Example: + $xpaget ds9 preserve pan + $xpaget ds9 preserve regions + + $xpaset -p ds9 preserve pan yes + $xpaset -p ds9 preserve regions yes + + psprint + Invokes postscript printing. Please see print for further details. + print + Controls printing. Use print option to set printing options. + Only available for XPA_METHOD local. + Syntax: + print [destination printer|file] +     [command <command>] +     [filename <filename>] +     [color rgb|cmyk|gray] +     [level 1|2|3] +     [resolution + 72|screen|96|144|150|225|300|600|1200] + + Example: + $xpaget ds9 print destination + $xpaget ds9 print command + $xpaget ds9 print filename + $xpaget ds9 print color + $xpaget ds9 print level + $xpaget ds9 print resolution + + $xpaset -p ds9 print + $xpaset -p ds9 print destination file + $xpaset -p ds9 print command lp + $xpaset -p ds9 print filename foo.ps + $xpaset -p ds9 print color cmyk + $xpaset -p ds9 print level 2 + $xpaset -p ds9 print resolution 96 + raise + Raise in the window stacking order. + Syntax: + raise + + Example: + $xpaset -p ds9 raise + regions + Controls regions in the current frame. + Syntax: + regions [<filename>] +     [load [all] <filename>] +     [save <filename>] +     [list [close]] +     [epsilon <integer>] +     [show yes|no] +     [showtext yes|no] +     [centroid] +     [centroid auto yes|no] +     [centroid radius <value>|iteration + <value>] +     [getinfo] +     [move front] +     [move back] +     [select all] +     [select none] +     [select invert] +     [delete all] +     [delete select] +     [format ds9|xml|ciao|saotng|saoimage|pros|xy] +     [system image|physical|wcs|wcsa...wcsz] +     [sky fk4|fk5|icrs|galactic|ecliptic] +     [skyformat degrees|sexagesimal] +     [strip yes|no] +     [shape <shape>] +     [color &ltcolor>] +     [width <width>] +     [fixed|edit|rotate|delete yes|no] +     [include|exclude|source|background] +     [command <marker command>] +     [composite] +     [dissolve] +     [template <filename>] +     [template <filename> at <ra> + <dec> <coordsys> <skyframe>] +     [savetemplate <filename>] +     [groups] +     [group new] +     [group <tag> new] +     [group <tag> update] +     [group <tag> select] +     [group <tag> color &ltcolor>] +     [group <tag> copy] +     [group <tag> delete] +     [group <tag> cut] +     [group <tag> font <font>] +     [group <tag> move <int> + <int>] +     [group <tag> movefront] +     [group <tag> moveback] +     [group <tag> property <property> + yes|no] +     [copy] +     [cut] +     [paste image|physical|wcs|wcsa...wcsz] +     [undo] +     [-format ds9|ciao|saotng|saoimage|pros|xy] +     [-system image|physical|wcs|wcsa...wcsz] +     [-sky fk4|fk5|icrs|galactic|ecliptic] +     [-skyformat degrees|sexagesimal] +     [-delim [nl|<char>]] +     [-prop + select|edit|move|rotate|delete|fixed|include|source 1|0] +     [-group <tag>] +     [-strip yes|no] +     [-wcs yes|no] + + Example: + $xpaget ds9 regions + $xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat + sexagesimal -prop edit 1 -group foo + $xpaget ds9 regions epsilon + $xpaget ds9 regions show + $xpaget ds9 regions showtext + $xpaget ds9 regions centroid auto + $xpaget ds9 regions centroid radius + $xpaget ds9 regions centroid iteration + $xpaget ds9 regions selected + $xpaget ds9 regions format + $xpaget ds9 regions system + $xpaget ds9 regions sky + $xpaget ds9 regions skyformat + $xpaget ds9 regions strip + $xpaget ds9 regions shape + $xpaget ds9 regions color + $xpaget ds9 regions width + $xpaget ds9 regions source + $xpaget ds9 regions background + $xpaget ds9 regions include + $xpaget ds9 regions exclude + $xpaget ds9 regions selected + $xpaget ds9 regions groups + + $cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky + fk5 + $cat bar.reg | xpaset ds9 regions -format ds9 + $echo "image; circle 100 100 20" | xpaset ds9 regions + $echo "image; circle 100 100 20" | xpaset ds9 regions + $echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions + $echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions + $echo "box 100 100 20 40 25" | xpaset ds9 regions + $echo "image; line 100 100 200 400" | xpaset ds9 regions + $echo "physical; ruler 200 300 200 400" | xpaset ds9 regions + $echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 + regions + $echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 + regions + + $xpaset -p ds9 regions foo.reg + $xpaset -p ds9 regions -format ciao bar.reg # load as ciao + format + $xpaset -p ds9 regions foo.fits # FITS regions files do not need + a format specification + $xpaset -p ds9 regions load foo.reg # load foo.reg into current + frame + $xpaset -p ds9 regions load all foo.reg # load foo.reg into all + frames + $xpaset -p ds9 regions load '*.reg'# expand *.reg and load into + current frame + $xpaset -p ds9 regions load all '*.reg' # expand *.reg and load + into all frames + $xpaset -p ds9 regions save foo.reg + $xpaset -p ds9 regions list + $xpaset -p ds9 regions list close + $xpaset -p ds9 regions epsilon 5 + $xpaset -p ds9 regions show yes + $xpaset -p ds9 regions showtext no + $xpaset -p ds9 regions centroid + $xpaset -p ds9 regions centroid auto yes + $xpaset -p ds9 regions centroid radius 10 + $xpaset -p ds9 regions centroid iteration 20 + $xpaset -p ds9 regions getinfo + $xpaset -p ds9 regions move back + $xpaset -p ds9 regions move front + $xpaset -p ds9 regions select all + $xpaset -p ds9 regions select none + $xpaset -p ds9 regions select invert + $xpaset -p ds9 regions delete all + $xpaset -p ds9 regions delete select + $xpaset -p ds9 regions format ds9 + $xpaset -p ds9 regions system wcs + $xpaset -p ds9 regions sky fk5 + $xpaset -p ds9 regions skyformat degrees + $xpaset -p ds9 regions strip yes + $xpaset -p ds9 regions shape ellipse + $xpaset -p ds9 regions color red + $xpaset -p ds9 regions width 3 + $xpaset -p ds9 regions edit yes + $xpaset -p ds9 regions include + $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}' + $xpaset -p ds9 regions composite + $xpaset -p ds9 regions dissolve + $xpaset -p ds9 regions template foo.tpl + $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 + +47:12:48.02 fk5 + $xpaset -p ds9 regions savetemplate foo.tpl + $xpaset -p ds9 regions group new + $xpaset -p ds9 regions group foo new + $xpaset -p ds9 regions group foo update + $xpaset -p ds9 regions group foo select + $xpaset -p ds9 regions group foo color red + $xpaset -p ds9 regions group foo copy + $xpaset -p ds9 regions group foo delete + $xpaset -p ds9 regions group foo cut + $xpaset -p ds9 regions group foo font {times 14 bold} + $xpaset -p ds9 regions group foo move 100 100 + $xpaset -p ds9 regions group foo movefront + $xpaset -p ds9 regions group foo moveback + $xpaset -p ds9 regions group foo property delete no + $xpaset -p ds9 regions copy + $xpaset -p ds9 regions cut + $xpaset -p ds9 regions paste wcs + $xpaset -p ds9 regions undo + + restore + Restore DS9 to a previous state from a backup save set. + Syntax: + restore <filename> + + Example: + $xpaset -p ds9 restore ds9.bck + rgb + Create RGB frame and control RGB frame parameters. + Syntax: + rgb [] +     [red|green|blue] +     [channel [red|green|blue]] +     [view [red|green|blue] [yes|no]] +     [system <coordsys>] +     [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]] +     [open|close] + + Example: + $xpaget ds9 rgb channel + $xpaget ds9 rgb lock wcs + $xpaget ds9 rgb lock crop + $xpaget ds9 rgb lock slice + $xpaget ds9 rgb lock bin + $xpaget ds9 rgb lock scale + $xpaset ds9 rgb lock scalelimits + $xpaget ds9 rgb lock colorbar + $xpaget ds9 rgb lock block + $xpaget ds9 rgb lock smooth + $xpaget ds9 rgb system + $xpaget ds9 rgb view red + $xpaget ds9 rgb view green + $xpaget ds9 rgb view blue + + $xpaset -p ds9 rgb # create new rgb frame + $xpaset -p ds9 rgb red # set current channel to red + $xpaset -p ds9 rgb channel red # set current channel to red + $xpaset -p ds9 rgb view blue no # turn off blue channel + $xpaset -p ds9 rgb system wcs # set rgb coordinate system + $xpaset -p ds9 rgb lock wcs yes + $xpaset -p ds9 rgb lock crop yes + $xpaset -p ds9 rgb lock slice yes + $xpaset -p ds9 rgb lock bin yes + $xpaset -p ds9 rgb lock scale yes + $xpaset -p ds9 rgb lock scalelimits yes + $xpaset -p ds9 rgb lock colorbar yes + $xpaset -p ds9 rgb lock block yes + $xpaset -p ds9 rgb lock smooth yes + $xpaset -p ds9 rgb open + $xpaset -p ds9 rgb close + rgbarray + Load raw data array cube into rgb frame. + + Syntax: + rgbarray [native|big|little] + rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - -Example: -$xpaget ds9 rgbarray > foo.arr -$xpaget ds9 rgbarray little > foo.arr -$xpaset -p ds9 rgbarray -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] -$xpaset -p ds9 rgbarray new -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] -$cat foo.arr | xpaset ds9 rgbarray -[dim=512,zdim=3,bitpix=-32,endian=little] -$cat foo.arr | xpaset ds9 rgbarray new -[dim=512,zdim=3,bitpix=-32,endian=little] -rgbcube -Load FITS rgbcube into rgb frame. -Syntax: -rgbcube [new] [<filename>] - -Example: -$xpaget ds9 rgbcube > foo.fits -$xpaset -p ds9 rgbcube foo.fits -$xpaset -p ds9 rgbcube new foo.fits -$cat foo.fits | xpaset ds9 rgbcube -$cat foo.fits | xpaset ds9 rgbcubenew -rgbimage -Load FITS rgbimage into rgb frame. -Syntax: -rgbimage [new] [<filename>] - -Example: -$xpaget ds9 rgbimage > foo.fits -$xpaset -p ds9 rgbimage foo.fits -$xpaset -p ds9 rgbimage new foo.fits -$cat foo.fits | xpaset ds9 rgbimage -$cat foo.fits | xpaset ds9 rgbimage new -rotate -Controls the rotation angle (in degrees) of the current -frame. -Syntax: -rotate [<value>] -    [to <value>] -    [open|close] - -Example: -$xpaget ds9 rotate -$xpaset -p ds9 rotate 45 -$xpaset -p ds9 rotate to 30 -$xpaset -p ds9 rotate open -$xpaset -p ds9 rotate close -save -Save loaded image data of current frame as FITS. -Syntax: -save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice] - -Example: -$xpaset -p ds9 save foo.fits -$xpaset -p ds9 save fits foo.fits image -$xpaset -p ds9 save fits foo.fits table -$xpaset -p ds9 save fits foo.fits slice -$xpaset -p ds9 save rgbimage foo.fits -$xpaset -p ds9 save rgbcube foo.fits -$xpaset -p ds9 save mecube foo.fits -$xpaset -p ds9 save mosaic foo.fits -$xpaset -p ds9 save mosaicimage foo.fits -saveimage -Create a snap shot of the current DS9 window and save in -specified image format. If no format specified, the file name -extension is used to determine the output format. Optional -parameters: jpeg quality (1-100) and tiff -compression method. -Syntax: -saveimage [fits|eps|gif|tiff|jpeg|png]<filename> -saveimage <filename>.jpeg [1-100] -saveimage <filename>.tiff [none|jpeg|packbits|deflate] - -Example: -$xpaset -p ds9 saveimage ds9.tiff -$xpaset -p ds9 saveimage jpeg ds9.jpeg 75 -scale -Controls the limits and color scale distribution. -Syntax: -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -    [log exp <value>] -    [datasec yes|no] -    [limits <minvalue> <maxvalue>] -    [mode minmax|<value>|zscale|zmax] -    [scope local|global] -    [match] -    [match limits] -    [lock [yes|no]] -    [lock limits [yes|no]] -    [open|close] - -Example: -$xpaget ds9 scale -$xpaget ds9 scale log exp -$xpaget ds9 scale datasec -$xpaget ds9 scale limits -$xpaget ds9 scale mode -$xpaget ds9 scale scope -$xpaget ds9 scale lock -$xpaget ds9 scale lock limits -$xpaset -p ds9 scale linear -$xpaset -p ds9 scale log exp 100 -$xpaset -p ds9 scale datasec yes -$xpaset -p ds9 scale histequ -$xpaset -p ds9 scale limits 1 100 -$xpaset -p ds9 scale mode zscale -$xpaset -p ds9 scale mode 99.5 -$xpaset -p ds9 scale scope local -$xpaset -p ds9 scale match -$xpaset -p ds9 scale match limits -$xpaset -p ds9 scale lock yes -$xpaset -p ds9 scale lock limits yes -$xpaset -p ds9 scale open -$xpaset -p ds9 scale close -shm -Load a shared memory segment into the current frame. -Syntax: -shm [<key> [<filename>]] -    [key <key> [<filename>]] -    [shmid <id> [<filename>]] -    [fits [key|shmid] <id> -[<filename>]] -    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]] -    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]] -    [rgbcube [key|shmid] <id> -[<filename>] -    [rgbimage [key|shmid] <id> -[<filename>]] -    [rgbarray [key|shmid] <id> + + Example: + $xpaget ds9 rgbarray > foo.arr + + $xpaget ds9 rgbarray little > foo.arr + $xpaset -p ds9 rgbarray + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + $xpaset -p ds9 rgbarray new + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + + $cat foo.arr | xpaset ds9 rgbarray + [dim=512,zdim=3,bitpix=-32,endian=little] + $cat foo.arr | xpaset ds9 rgbarray new + [dim=512,zdim=3,bitpix=-32,endian=little] + rgbcube + Load FITS rgbcube into rgb frame. + + Syntax: + rgbcube [new] [<filename>] + + Example: + $xpaget ds9 rgbcube > foo.fits + + $xpaset -p ds9 rgbcube foo.fits + $xpaset -p ds9 rgbcube new foo.fits + + $cat foo.fits | xpaset ds9 rgbcube + $cat foo.fits | xpaset ds9 rgbcubenew + rgbimage + Load FITS rgbimage into rgb frame. + + Syntax: + rgbimage [new] [<filename>] + + Example: + $xpaget ds9 rgbimage > foo.fits + + $xpaset -p ds9 rgbimage foo.fits + $xpaset -p ds9 rgbimage new foo.fits + + $cat foo.fits | xpaset ds9 rgbimage + $cat foo.fits | xpaset ds9 rgbimage new + + rotate + Controls the rotation angle (in degrees) of the current frame. + Syntax: + rotate [<value>] +     [to <value>] +     [open|close] + + Example: + $xpaget ds9 rotate + + $xpaset -p ds9 rotate 45 + $xpaset -p ds9 rotate to 30 + $xpaset -p ds9 rotate open + $xpaset -p ds9 rotate close + + save + + Save loaded image data of current frame as FITS. + Syntax: + save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice] + + Example: + $xpaset -p ds9 save foo.fits + $xpaset -p ds9 save fits foo.fits image + $xpaset -p ds9 save fits foo.fits table + $xpaset -p ds9 save fits foo.fits slice + $xpaset -p ds9 save rgbimage foo.fits + $xpaset -p ds9 save rgbcube foo.fits + $xpaset -p ds9 save mecube foo.fits + $xpaset -p ds9 save mosaic foo.fits + $xpaset -p ds9 save mosaicimage foo.fits + saveimage + + Create a snap shot of the current DS9 window and save in + specified image format. If no format specified, the file name + extension is used to determine the output format. Optional + parameters: jpeg quality (1-100) and tiff + compression method. + Syntax: + saveimage [fits|eps|gif|tiff|jpeg|png]<filename> + saveimage <filename>.jpeg [1-100] + saveimage <filename>.tiff [none|jpeg|packbits|deflate] + + Example: + $xpaset -p ds9 saveimage ds9.tiff + $xpaset -p ds9 saveimage jpeg ds9.jpeg 75 + scale + Controls the limits and color scale distribution. + Syntax: + scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +     [log exp <value>] +     [datasec yes|no] +     [limits <minvalue> <maxvalue>] +     [mode minmax|<value>|zscale|zmax] +     [scope local|global] +     [match] +     [match limits] +     [lock [yes|no]] +     [lock limits [yes|no]] +     [open|close] + + Example: + $xpaget ds9 scale + $xpaget ds9 scale log exp + $xpaget ds9 scale datasec + $xpaget ds9 scale limits + $xpaget ds9 scale mode + $xpaget ds9 scale scope + $xpaget ds9 scale lock + $xpaget ds9 scale lock limits + + $xpaset -p ds9 scale linear + $xpaset -p ds9 scale log exp 100 + $xpaset -p ds9 scale datasec yes + $xpaset -p ds9 scale histequ + $xpaset -p ds9 scale limits 1 100 + $xpaset -p ds9 scale mode zscale + $xpaset -p ds9 scale mode 99.5 + $xpaset -p ds9 scale scope local + $xpaset -p ds9 scale match + $xpaset -p ds9 scale match limits + $xpaset -p ds9 scale lock yes + $xpaset -p ds9 scale lock limits yes + $xpaset -p ds9 scale open + $xpaset -p ds9 scale close + + shm + Load a shared memory segment into the current frame. + Syntax: + shm [<key> [<filename>]] +     [key <key> [<filename>]] +     [shmid <id> [<filename>]] +     [fits [key|shmid] <id> + [<filename>]] +     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]] +     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] + <id> [<filename>]] +     [rgbcube [key|shmid] <id> + [<filename>] +     [rgbimage [key|shmid] <id> + [<filename>]] +     [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] - -    [array [key|shmid] <id> +     [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - -Example: -$xpaget ds9 shm -$xpaset -p ds9 shm 102 -$xpaset -p ds9 shm key 102 -$xpaset -p ds9 shm shmid 102 foo -$xpaset -p ds9 shm fits key 100 foo -$xpaset -p ds9 shm mosaicimage iraf key 100 foo -$xpaset -p ds9 shm mosaicimage wcs key 100 foo -$xpaset -p ds9 shm mosaicimage wcsa key 100 foo -$xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo -$xpaset -p ds9 shm mosaic iraf key 100 foo -$xpaset -p ds9 shm mosaic wcs key 100 foo -$xpaset -p ds9 shm rgbcube key 100 foo -$xpaset -p ds9 shm rgbimage key 100 foo -$xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] -$xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] - sia -Support for VO Simple Image Access protocol. The first command -will create a new search. All other commands operated on the last -search created, unless indicated otherwise. -Syntax: -sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -    [<ref>] [cancel] -    [<ref>] [clear] -    [<ref>] [close] -    [<ref>] [coordinate <ra> <dec> -<coordsys>] -    [<ref>] [crosshair] -    [<ref>] [export sb|tsv -<filename>] -    [<ref>] [name <object>] -    [<ref>] [print] -    [<ref>] [retrieve] -    [<ref>] [save <filename>] -    [<ref>] [radius <value> -degrees|arcmin|arcsec] -    [<ref>] [sky <skyframe>] -    [<ref>] [skyformat <skyformat>] -    [<ref>] [system <coordsys>] -    [<ref>] [update] - -Example: -$xpaget ds9 sia - -$xpaset -p ds9 sia 2mass -$xpaset -p ds9 sia cancel -$xpaset -p ds9 sia clear -$xpaset -p ds9 sia close -$xpaset -p ds9 sia coordinate 202.48 47.21 fk5 -$xpaset -p ds9 sia crosshair -$xpaset -p ds9 sia export tsv bar.tsv -$xpaset -p ds9 sia name m51 -$xpaset -p ds9 sia print -$xpaset -p ds9 sia retrieve -$xpaset -p ds9 sia save foo.xml -$xpaset -p ds9 sia radius 1 degrees -$xpaset -p ds9 sia sky fk5 -$xpaset -p ds9 sia skyformat degrees -$xpaset -p ds9 sia system wcs -$xpaset -p ds9 sia update - single -Select Single Display mode -Syntax: -single - -Example: -$xpaget ds9 single -$xpaset -p ds9 single -skyview -Support for SkyView image server at HEASARC. -Syntax: -skyview [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [pixels <width> <height>] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey <survey>] -    [open|close] - -Example: -$xpaget ds9 skyview name -$xpaget ds9 skyview coord -$xpaget ds9 skyview size -$xpaget ds9 skyview pixels -$xpaget ds9 skyview save -$xpaget ds9 skyview frame -$xpaget ds9 skyview survey -$xpaset -p ds9 skyview -$xpaset -p ds9 skyview m31 -$xpaset -p ds9 skyview name m31 -$xpaset -p ds9 skyview name clear -$xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 skyview size 60 60 arcmin -$xpaset -p ds9 skyview pixels 600 600 -$xpaset -p ds9 skyview save yes -$xpaset -p ds9 skyview frame current -$xpaset -p ds9 skyview update frame -$xpaset -p ds9 skyview survey sdssi -$xpaset -p ds9 skyview open -$xpaset -p ds9 skyview close -sleep -Delays execution for specified number of seconds. Default is 1 -second. -Syntax: -sleep [#] - -Example: -$xpaset -p ds9 sleep -$xpaset -p ds9 sleep 2 -smooth -Smooth current image or set smooth parameters. -Boxcar width =2*radius+1 -Tophat diameter =2*radius+1 -Gaussian diameter =2*radius+1,mean=0 -Elliptical Gaussian diameter -=2*radius+1,mean=0 -Syntax: -smooth [] -    [yes|no] -    [function boxcar|tophat|gaussian] -    [radius <value>] -    [radiusminor <value>] -    [sigma <value>] -    [sigmaminor <value>] -    [angle <value>] -    [match] -    [lock [yes|no]] -    [open|close] -Example: -$xpaget ds9 smooth -$xpaget ds9 smooth function -$xpaget ds9 smooth radius -$xpaget ds9 smooth radiusminor -$xpaget ds9 smooth sigma -$xpaget ds9 smooth sigmaminor -$xpaget ds9 smooth lock -$xpaset -p ds9 smooth -$xpaset -p ds9 smooth yes -$xpaset -p ds9 smooth function tophat -$xpaset -p ds9 smooth radius 4 -$xpaset -p ds9 smooth radiusminor 4 -$xpaset -p ds9 smooth sigma 2.0 -$xpaset -p ds9 smooth sigmaminor 2.0 -$xpaset -p ds9 smooth angle 45 -$xpaset -p ds9 smooth match -$xpaset -p ds9 smooth lock yes -$xpaset -p ds9 smooth open -$xpaset -p ds9 smooth close -source -Source TCL code from a file. Only available for XPA_METHOD -local. -Syntax: -source [<filename>] - -Example: -$xpaset -p ds9 source foo.tcl -tcl -Execute one tcl command. Only available for XPA_METHOD -local. -Syntax: -tcl [<tcl command>] - -Example: -$echo 'puts "Hello, World"' | xpaset ds9 tcl -$xpaset -p ds9 tcl {puts {Hello, World}} -threads -Set number of process threads for functions which are -multi-threaded. -Syntax: -threads # - -Example: -$xpaget ds9 threads -$xpaset -p ds9 threads 8 -tiff -Load TIFF image into current frame. Optional parameters: -tiff compression method. -Syntax: -tiff [new|slice] [<filename>] -[none|jpeg|packbits|deflate] - -Example: -$xpaget ds9 tiff > foo.tiff -$xpaget ds9 tiff jpeg > foo.tiff -$xpaset -p ds9 tiff foo.tiff -$xpaset -p ds9 tiff new foo.tiff -$xpaset -p ds9 tiff slice foo.tiff -$cat foo.tiff | xpaset ds9 tiff# not available windows -$cat foo.tiff | xpaset ds9 tiffnew# not available windows -$cat foo.tiff | xpaset ds9 tiffslice# not available windows -tile -Controls the tile display mode. -Syntax: -tile [] -    [yes|no] -    [mode grid|column|row] -    [grid] -    [grid mode automatic|manual] -    [grid direction x|y] -    [grid layout <col> <row>] -    [grid gap <pixels>] -    [row] -    [column] - -Example: -$xpaget ds9 tile -$xpaget ds9 tile mode -$xpaget ds9 tile grid mode -$xpaget ds9 tile grid direction -$xpaget ds9 tile grid layout -$xpaget ds9 tile grid gap -$xpaset -p ds9 tile -$xpaset -p ds9 tile yes -$xpaset -p ds9 tile mode row -$xpaset -p ds9 tile grid -$xpaset -p ds9 tile grid mode manual -$xpaset -p ds9 tile grid direction x -$xpaset -p ds9 tile grid layout 5 5 -$xpaset -p ds9 tile grid gap 10 -$xpaset -p ds9 tile row -$xpaset -p ds9 tile column -update -Updates the current frame or region of frame. In the second -form, the first argument is the number of the fits HDU (starting -with 1) and the remaining args are a bounding box in IMAGE -coordinates. By default, the screen is updated the next available -idle cycle. However, you may force an immediate update by -specifying the NOW option. -Syntax: -update [] -    [# x1 y1 x2 y2] -    [now] -    [now # x1 y1 x2 y2] - -Example: -$xpaset -p ds9 update -$xpaset -p ds9 update 1 100 100 300 400 -$xpaset -p ds9 update now -$xpaset -p ds9 update now 1 100 100 300 400 -url -Load FITS from URL into the current frame -Syntax: -url <url> - -Example: -$xpaset -p ds9 url http://foo.bar.edu/foo.fits -version -Returns the current version of DS9. -Syntax: -version - -Example: -$xpaget ds9 version -view -Controls the GUI. -Syntax: -view [layout horizontal|vertical] -    [keyvalue <string>] -    [info yes|no] -    [panner yes|no] -    [magnifier yes|no] -    [buttons yes|no] -    [colorbar yes|no] -    [colorbar horizontal|vertical] -    [colorbar numerics yes|no] -    [graph horizontal|vertical yes|no] -    [filename yes|no[ -    [object yes|no] -    [keyword yes|no] -    [minmax yes|no] -    [lowhigh yes|no] -    [units yes|no] -    [image|physical|wcs|wcsa...wcsz yes|no] -    [frame yes|no] -    [red yes|no] -    [green yes|no] -    [blue yes|no] - -Example: -$xpaget ds9 view layout -$xpaget ds9 view keyvalue -$xpaget ds9 view info -$xpaget ds9 view panner -$xpaget ds9 view magnifier -$xpaget ds9 view buttons -$xpaget ds9 view colorbar -$xpaget ds9 view graph horizontal -$xpaget ds9 view filename -$xpaget ds9 view object -$xpaget ds9 view keyword -$xpaget ds9 view minmax -$xpaget ds9 view lowhigh -$xpaget ds9 view units -$xpaget ds9 view image -$xpaget ds9 view wcsa -$xpaget ds9 view red -$xpaget ds9 view frame -$xpaset -p ds9 view layout vertical -$xpaset -p ds9 view keyvalue BITPIX -$xpaset -p ds9 view info yes -$xpaset -p ds9 view panner yes -$xpaset -p ds9 view magnifier yes -$xpaset -p ds9 view buttons yes -$xpaset -p ds9 view colorbar yes -$xpaset -p ds9 view graph horizontal yes -$xpaset -p ds9 view filename yes -$xpaset -p ds9 view object yes -$xpaset -p ds9 view keyword yes -$xpaset -p ds9 view minmax yes -$xpaset -p ds9 view lowhigh yes -$xpaset -p ds9 view units yes -$xpaset -p ds9 view wcsa yes -$xpaset -p ds9 view frame yes -$xpaset -p ds9 view red yes -$xpaset -p ds9 view green yes -$xpaset -p ds9 view blue yes - -vla -Support for VLA Sky Survey. -Syntax: -vla [] -    [<object>] -    [name <object>|clear] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [survey first|stripe82] -    [open|close] - -Example: -$xpaget ds9 vla name -$xpaget ds9 vla coord -$xpaget ds9 vla size -$xpaget ds9 vla save -$xpaget ds9 vla frame -$xpaget ds9 vla survey -$xpaset -p ds9 vla -$xpaset -p ds9 vla m31 -$xpaset -p ds9 vla name m31 -$xpaset -p ds9 vla name clear -$xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 vla size 60 60 arcmin -$xpaset -p ds9 vla save yes -$xpaset -p ds9 vla frame current -$xpaset -p ds9 vla update frame -$xpaset -p ds9 vla survey stripe82 -$xpaset -p ds9 vla open -$xpaset -p ds9 vla close -vlss -Support for NRAO VLSS Sky Survey. -Syntax: -vlss [] -    [<object>] -    [name <object>] -    [<ra> <dec>] # in wcs fk5 -    [size <width> <height> -degrees|arcmin|arcsec] -    [save yes|no] -    [frame new|current] -    [update frame|crosshair] -    [open|close] - -Example: -$xpaget ds9 vlss name -$xpaget ds9 vlss coord -$xpaget ds9 vlss size -$xpaget ds9 vlss save -$xpaget ds9 vlss frame -$xpaset -p ds9 vlss -$xpaset -p ds9 vlss m31 -$xpaset -p ds9 vlss name m31 -$xpaset -p ds9 vlss name clear -$xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 -$xpaset -p ds9 vlss size 60 60 arcmin -$xpaset -p ds9 vlss save yes -$xpaset -p ds9 vlss frame current -$xpaset -p ds9 vlss update frame -$xpaset -p ds9 vlss open -$xpaset -p ds9 vlss close -vo -Invoke an connection to a Virtual Observatory site. -Syntax: -vo [method xpa|mime] -   [server <url>] -   [internal yes|no] -   [delay #] -   [<url>] -   [connect <url>] -   [disconnect <url>] -   [open|close] - -Example: -$xpaget ds9 vo -$xpaget ds9 vo method -$xpaget ds9 vo server -$xpaget ds9 vo internal -$xpaget ds9 vo delay -$xpaget ds9 vo connect -$xpaset -p ds9 vo method xpa -$xpaset -p ds9 vo server http://foo.bar.edu/list.txt -$xpaset -p ds9 vo internal yes -$xpaset -p ds9 vo delay 15 # keep-alive delay -$xpaset -p ds9 vo chandra-ed -$xpaset -p ds9 vo connect chandra-ed -$xpaset -p ds9 vo disconnect chandra-ed -$xpaset -p ds9 vo open -$xpaset -p ds9 vo close -wcs -Controls the World Coordinate System for the current frame. If -the wcs system, skyframe, or skyformat is modified, the info panel, -compass, grid, and alignment will be modified accordingly. Also, -using this access point, a new WCS specification can be loaded and -used by the current image regardless of the WCS that was contained -in the image file. WCS specification can be sent to DS9 as an ASCII -file . Please see WCS for more -information. -Syntax: -wcs [[system] wcs|wcsa...wcsz] -    [[sky] fk4|fk5|icrs|galactic|ecliptic] -    [[skyformat] degrees|sexagesimal] -    [align yes|no] -    [reset [#]] -    [replace [#] <filename>] -    [append [#] <filename>] -    [open|close] - -Example: -$xpaget ds9 wcs -$xpaget ds9 wcs system -$xpaget ds9 wcs sky -$xpaget ds9 wcs skyformat -$xpaget ds9 wcs align -$xpaset -p ds9 wcs wcs -$xpaset -p ds9 wcs system wcs -$xpaset -p ds9 wcs fk5 -$xpaset -p ds9 wcs sky fk5 -$xpaset -p ds9 wcs sexagesimal -$xpaset -p ds9 wcs skyformat sexagesimal -$xpaset -p ds9 wcs align yes -$xpaset -p ds9 wcs reset -$xpaset -p ds9 wcs reset 3 -$xpaset -p ds9 wcs replace foo.wcs -$xpaset -p ds9 wcs replace 3 foo.wcs -$xpaset -p ds9 wcs append foo.wcs -$xpaset -p ds9 wcs append 3 foo.wcs -$cat foo.wcs | xpaset ds9 wcs replace -$cat foo.wcs | xpaset ds9 wcs append -$echo "OBJECT = 'foobar'" | xpaset ds9 wcs append -$xpaset -p ds9 open -$xpaset -p ds9 close -web -Display specified URL in the web display. -Syntax: -web [] -    [<url>] -    [new <webname> <url>] -    [<webname>] [click -back|forward|stop|reload|#] -    [<webname>] [clear] -    [<webname>] [close] - -Example: -$xpaget ds9 web -$xpaset -p ds9 web www.cnn.com -$xpaset -p ds9 web new www.cnn.com -$xpaset -p ds9 web hvweb www.apple.com -$xpaset -p ds9 web click back -$xpaset -p ds9 web click 2 -$xpaset -p ds9 web clear -$xpaset -p ds9 web close -width -Set the width of the image display window. -Syntax: -width [<value>] - -Example: -$xpaget ds9 width -$xpaset -p ds9 width 512 -xpa -Configure XPA. -Syntax: --xpa [disconnect] -    [info] - -Example: -$xpaget ds9 info -$xpaset -p ds9 disconnect -$xpaset -p ds9 info -zscale -Set Scale Limits based on the IRAF algorithm. -Syntax: -zscale [] -    [contrast] -    [sample] -    [line] - -Example: -$xpaget ds9 zscale contrast -$xpaget ds9 zscale sample -$xpaget ds9 zscale line -$xpaset -p ds9 zscale -$xpaset -p ds9 zscale contrast .25 -$xpaset -p ds9 zscale sample 600 -$xpaset -p ds9 zscale line 120 -zoom -Controls the current zoom value for the current frame. -Syntax: -zoom [<value>] -    [<value> <value>] -    [to <value>] -    [to <value> <value>] -    [in] -    [out] -    [to fit] -    [open|close] - -Example: -$xpaget ds9 zoom -$xpaset -p ds9 zoom 2 -$xpaset -p ds9 zoom 2 4 -$xpaset -p ds9 zoom to 4 -$xpaset -p ds9 zoom to 2 4 -$xpaset -p ds9 zoom in -$xpaset -p ds9 zoom out -$xpaset -p ds9 zoom to fit -$xpaset -p ds9 zoom open -$xpaset -p ds9 zoom close - + + Example: + $xpaget ds9 shm + + $xpaset -p ds9 shm 102 + $xpaset -p ds9 shm key 102 + $xpaset -p ds9 shm shmid 102 foo + $xpaset -p ds9 shm fits key 100 foo + $xpaset -p ds9 shm mosaicimage iraf key 100 foo + $xpaset -p ds9 shm mosaicimage wcs key 100 foo + $xpaset -p ds9 shm mosaicimage wcsa key 100 foo + $xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo + $xpaset -p ds9 shm mosaic iraf key 100 foo + $xpaset -p ds9 shm mosaic wcs key 100 foo + $xpaset -p ds9 shm rgbcube key 100 foo + $xpaset -p ds9 shm rgbimage key 100 foo + $xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] + $xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] + + sia
+ +
Support for VO Simple Image Access protocol. The first command + will create a new search. All other commands operated on the + last search created, unless indicated otherwise.
+ Syntax: + sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +     [<ref>] [cancel] +     [<ref>] [clear] +     [<ref>] [close] +     [<ref>] [coordinate <ra> + <dec> <coordsys>] +     [<ref>] [crosshair] +     [<ref>] [export sb|tsv + <filename>] +     [<ref>] [name <object>] +     [<ref>] [print] +     [<ref>] [retrieve] +     [<ref>] [save <filename>] +     [<ref>] [radius <value> + degrees|arcmin|arcsec] +     [<ref>] [sky <skyframe>] +     [<ref>] [skyformat <skyformat>] +     [<ref>] [system <coordsys>] +     [<ref>] [update] + + Example: + $xpaget ds9 sia + + $xpaset -p ds9 sia 2mass + $xpaset -p ds9 sia cancel + $xpaset -p ds9 sia clear + $xpaset -p ds9 sia close + $xpaset -p ds9 sia coordinate 202.48 47.21 fk5 + $xpaset -p ds9 sia crosshair + $xpaset -p ds9 sia export tsv bar.tsv + $xpaset -p ds9 sia name m51 + $xpaset -p ds9 sia print + $xpaset -p ds9 sia retrieve + $xpaset -p ds9 sia save foo.xml + $xpaset -p ds9 sia radius 1 degrees + $xpaset -p ds9 sia sky fk5 + $xpaset -p ds9 sia skyformat degrees + $xpaset -p ds9 sia system wcs + $xpaset -p ds9 sia update + + single +
Select Single Display mode
+ Syntax: + single + + Example: + $xpaget ds9 single + + $xpaset -p ds9 single + +
skyview
+
Support for SkyView image server at HEASARC.
+ Syntax: + skyview [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [pixels <width> <height>] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey <survey>] +     [open|close] + + Example: + $xpaget ds9 skyview name + $xpaget ds9 skyview coord + $xpaget ds9 skyview size + $xpaget ds9 skyview pixels + $xpaget ds9 skyview save + $xpaget ds9 skyview frame + $xpaget ds9 skyview survey + + $xpaset -p ds9 skyview + $xpaset -p ds9 skyview m31 + $xpaset -p ds9 skyview name m31 + $xpaset -p ds9 skyview name clear + $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 skyview size 60 60 arcmin + $xpaset -p ds9 skyview pixels 600 600 + $xpaset -p ds9 skyview save yes + $xpaset -p ds9 skyview frame current + $xpaset -p ds9 skyview update frame + $xpaset -p ds9 skyview survey sdssi + $xpaset -p ds9 skyview open + $xpaset -p ds9 skyview close
+
sleep
+
Delays execution for specified number of seconds. Default is 1 + second.
+
+ Syntax: + sleep [#] + + Example: + $xpaset -p ds9 sleep + $xpaset -p ds9 sleep 2 + +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 + Tophat diameter =2*radius+1 + Gaussian diameter =2*radius+1,mean=0 + Elliptical Gaussian diameter =2*radius+1,mean=0 + + Syntax: + smooth [] +     [yes|no] +     [function boxcar|tophat|gaussian] +     [radius <value>] +     [radiusminor <value>] +     [sigma <value>] +     [sigmaminor <value>] +     [angle <value>] +     [match] +     [lock [yes|no]] +     [open|close] +
+
Example: + $xpaget ds9 smooth + $xpaget ds9 smooth function + $xpaget ds9 smooth radius + $xpaget ds9 smooth radiusminor + $xpaget ds9 smooth sigma + $xpaget ds9 smooth sigmaminor + $xpaget ds9 smooth lock
+
+ $xpaset -p ds9 smooth + $xpaset -p ds9 smooth yes + $xpaset -p ds9 smooth function tophat + $xpaset -p ds9 smooth radius 4 + $xpaset -p ds9 smooth radiusminor 4 + $xpaset -p ds9 smooth sigma 2.0 + $xpaset -p ds9 smooth sigmaminor 2.0 + $xpaset -p ds9 smooth angle 45 + $xpaset -p ds9 smooth match + $xpaset -p ds9 smooth lock yes + $xpaset -p ds9 smooth open + $xpaset -p ds9 smooth close
+
source
+
Source TCL code from a file. Only available for XPA_METHOD + local.
+ Syntax: + source [<filename>] + + Example: + $xpaset -p ds9 source foo.tcl +
tcl
+
Execute one tcl command. Only available for XPA_METHOD + local.
+ Syntax: + tcl [<tcl command>] + + Example: + $echo 'puts "Hello, World"' | xpaset ds9 tcl + $xpaset -p ds9 tcl {puts {Hello, World}} + +
threads
+
Set number of process threads for functions which are + multi-threaded.
+
+ Syntax: + threads # + + Example: + $xpaget ds9 threads + + $xpaset -p ds9 threads 8
+
tiff
+
Load TIFF image into current frame. Optional parameters: tiff + compression method.
+ Syntax: + tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] + + Example: + $xpaget ds9 tiff > foo.tiff + $xpaget ds9 tiff jpeg > foo.tiff + + $xpaset -p ds9 tiff foo.tiff + $xpaset -p ds9 tiff new foo.tiff + $xpaset -p ds9 tiff slice foo.tiff + + $cat foo.tiff | xpaset ds9 tiff + $cat foo.tiff | xpaset ds9 tiff new + $cat foo.tiff | xpaset ds9 tiff slice +
tile
+
Controls the tile display mode.
+ Syntax: + tile [] +     [yes|no] +     [mode grid|column|row] +     [grid] +     [grid mode automatic|manual] +     [grid direction x|y] +     [grid layout <col> <row>] +     [grid gap <pixels>] +     [row] +     [column] + + Example: + $xpaget ds9 tile + $xpaget ds9 tile mode + $xpaget ds9 tile grid mode + $xpaget ds9 tile grid direction + $xpaget ds9 tile grid layout + $xpaget ds9 tile grid gap + + $xpaset -p ds9 tile + $xpaset -p ds9 tile yes + $xpaset -p ds9 tile mode row + $xpaset -p ds9 tile grid + $xpaset -p ds9 tile grid mode manual + $xpaset -p ds9 tile grid direction x + $xpaset -p ds9 tile grid layout 5 5 + $xpaset -p ds9 tile grid gap 10 + $xpaset -p ds9 tile row + $xpaset -p ds9 tile column +
update
+
Updates the current frame or region of frame. In the second + form, the first argument is the number of the fits HDU (starting + with 1) and the remaining args are a bounding box in IMAGE + coordinates. By default, the screen is updated the next + available idle cycle. However, you may force an immediate update + by specifying the NOW option.
+ Syntax: + update [] +     [# x1 y1 x2 y2] +     [now] +     [now # x1 y1 x2 y2] + + Example: + $xpaset -p ds9 update + $xpaset -p ds9 update 1 100 100 300 400 + $xpaset -p ds9 update now + $xpaset -p ds9 update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+ Syntax: + url <url> + + Example: + $xpaset -p ds9 url http://foo.bar.edu/foo.fits + +
version
+
Returns the current version of DS9.
+ Syntax: + version + + Example: + $xpaget ds9 version +
view
+
Controls the GUI.
+ Syntax: + view [layout horizontal|vertical] +     [keyvalue <string>] +     [info yes|no] +     [panner yes|no] +     [magnifier yes|no] +     [buttons yes|no] +     [colorbar yes|no] +     [colorbar horizontal|vertical] +     [colorbar numerics yes|no] +     [graph horizontal|vertical yes|no] +     [filename yes|no[ +     [object yes|no] +     [keyword yes|no] +     [minmax yes|no] +     [lowhigh yes|no] +     [units yes|no] +     [image|physical|wcs|wcsa...wcsz yes|no] +     [frame yes|no] +     [red yes|no] +     [green yes|no] +     [blue yes|no] + + Example: + $xpaget ds9 view layout + $xpaget ds9 view keyvalue + $xpaget ds9 view info + $xpaget ds9 view panner + $xpaget ds9 view magnifier + $xpaget ds9 view buttons + $xpaget ds9 view colorbar + $xpaget ds9 view graph horizontal + $xpaget ds9 view filename + $xpaget ds9 view object + $xpaget ds9 view keyword + $xpaget ds9 view minmax + $xpaget ds9 view lowhigh + $xpaget ds9 view units + $xpaget ds9 view image + $xpaget ds9 view wcsa + $xpaget ds9 view red + $xpaget ds9 view frame + + $xpaset -p ds9 view layout vertical + $xpaset -p ds9 view keyvalue BITPIX + $xpaset -p ds9 view info yes + $xpaset -p ds9 view panner yes + $xpaset -p ds9 view magnifier yes + $xpaset -p ds9 view buttons yes + $xpaset -p ds9 view colorbar yes + $xpaset -p ds9 view graph horizontal yes + $xpaset -p ds9 view filename yes + $xpaset -p ds9 view object yes + $xpaset -p ds9 view keyword yes + $xpaset -p ds9 view minmax yes + $xpaset -p ds9 view lowhigh yes + $xpaset -p ds9 view units yes + $xpaset -p ds9 view wcsa yes + $xpaset -p ds9 view frame yes + $xpaset -p ds9 view red yes + $xpaset -p ds9 view green yes + $xpaset -p ds9 view blue yes
+
+ vla +
Support for VLA Sky Survey.
+ Syntax: + vla [] +     [<object>] +     [name <object>|clear] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [survey first|stripe82] +     [open|close] + + Example: + $xpaget ds9 vla name + $xpaget ds9 vla coord + $xpaget ds9 vla size + $xpaget ds9 vla save + $xpaget ds9 vla frame + $xpaget ds9 vla survey + + $xpaset -p ds9 vla + $xpaset -p ds9 vla m31 + $xpaset -p ds9 vla name m31 + $xpaset -p ds9 vla name clear + $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 vla size 60 60 arcmin + $xpaset -p ds9 vla save yes + $xpaset -p ds9 vla frame current + $xpaset -p ds9 vla update frame + $xpaset -p ds9 vla survey stripe82 + $xpaset -p ds9 vla open + $xpaset -p ds9 vla close
+
vlss
+
Support for NRAO VLSS Sky Survey.
+ Syntax: + vlss [] +     [<object>] +     [name <object>] +     [<ra> <dec>] # in wcs fk5 +     [size <width> <height> + degrees|arcmin|arcsec] +     [save yes|no] +     [frame new|current] +     [update frame|crosshair] +     [open|close] + + Example: + $xpaget ds9 vlss name + $xpaget ds9 vlss coord + $xpaget ds9 vlss size + $xpaget ds9 vlss save + $xpaget ds9 vlss frame + + $xpaset -p ds9 vlss + $xpaset -p ds9 vlss m31 + $xpaset -p ds9 vlss name m31 + $xpaset -p ds9 vlss name clear + $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 + $xpaset -p ds9 vlss size 60 60 arcmin + $xpaset -p ds9 vlss save yes + $xpaset -p ds9 vlss frame current + $xpaset -p ds9 vlss update frame + $xpaset -p ds9 vlss open + $xpaset -p ds9 vlss close
+
vo
+
Invoke an connection to a Virtual Observatory site.
+ Syntax: + vo [method xpa|mime] +    [server <url>] +    [internal yes|no] +    [delay #] +    [<url>] +    [connect <url>] +    [disconnect <url>] +    [open|close] + + Example: + $xpaget ds9 vo + $xpaget ds9 vo method + $xpaget ds9 vo server + $xpaget ds9 vo internal + $xpaget ds9 vo delay + $xpaget ds9 vo connect + + $xpaset -p ds9 vo method xpa + $xpaset -p ds9 vo server http://foo.bar.edu/list.txt + $xpaset -p ds9 vo internal yes + $xpaset -p ds9 vo delay 15 # keep-alive delay + $xpaset -p ds9 vo chandra-ed + $xpaset -p ds9 vo connect chandra-ed + $xpaset -p ds9 vo disconnect chandra-ed + $xpaset -p ds9 vo open + $xpaset -p ds9 vo close + +
wcs
+
Controls the World Coordinate System for the current frame. If + the wcs system, skyframe, or skyformat is modified, the info + panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
+ Syntax: + wcs [[system] wcs|wcsa...wcsz] +     [[sky] fk4|fk5|icrs|galactic|ecliptic] +     [[skyformat] degrees|sexagesimal] +     [align yes|no] +     [reset [#]] +     [replace [#] <filename>] +     [append [#] <filename>] +     [open|close] + + Example: + $xpaget ds9 wcs + $xpaget ds9 wcs system + $xpaget ds9 wcs sky + $xpaget ds9 wcs skyformat + $xpaget ds9 wcs align + + $xpaset -p ds9 wcs wcs + $xpaset -p ds9 wcs system wcs + $xpaset -p ds9 wcs fk5 + $xpaset -p ds9 wcs sky fk5 + $xpaset -p ds9 wcs sexagesimal + $xpaset -p ds9 wcs skyformat sexagesimal + $xpaset -p ds9 wcs align yes + $xpaset -p ds9 wcs reset + $xpaset -p ds9 wcs reset 3 + $xpaset -p ds9 wcs replace foo.wcs + $xpaset -p ds9 wcs replace 3 foo.wcs + $xpaset -p ds9 wcs append foo.wcs + $xpaset -p ds9 wcs append 3 foo.wcs + $xpaset -p ds9 open + $xpaset -p ds9 close +
+ $cat foo.wcs | xpaset ds9 wcs replace + $cat foo.wcs | xpaset ds9 wcs append + $echo "OBJECT = 'foobar'" | xpaset ds9 wcs append + +
web
+
Display specified URL in the web display.
+ Syntax: + web [] +     [<url>] +     [new <webname> <url>] +     [<webname>] [click + back|forward|stop|reload|#] +     [<webname>] [clear] +     [<webname>] [close] + + Example: + $xpaget ds9 web + + $xpaset -p ds9 web www.cnn.com + $xpaset -p ds9 web new www.cnn.com + $xpaset -p ds9 web hvweb www.apple.com + $xpaset -p ds9 web click back + $xpaset -p ds9 web click 2 + $xpaset -p ds9 web clear + $xpaset -p ds9 web close + +
width
+
Set the width of the image display window.
+ Syntax: + width [<value>] + + Example: + $xpaget ds9 width + + $xpaset -p ds9 width 512
+
xpa
+
Configure XPA.
+ Syntax: + -xpa [disconnect] +     [info] + + Example: + $xpaget ds9 info + + $xpaset -p ds9 disconnect + $xpaset -p ds9 info + +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+ Syntax: + zscale [] +     [contrast] +     [sample] +     [line] + + Example: + $xpaget ds9 zscale contrast + $xpaget ds9 zscale sample + $xpaget ds9 zscale line + + $xpaset -p ds9 zscale + $xpaset -p ds9 zscale contrast .25 + $xpaset -p ds9 zscale sample 600 + $xpaset -p ds9 zscale line 120 + +
zoom
+
Controls the current zoom value for the current frame.
+ Syntax: + zoom [<value>] +     [<value> <value>] +     [to <value>] +     [to <value> <value>] +     [in] +     [out] +     [to fit] +     [open|close] + + Example: + $xpaget ds9 zoom + + $xpaset -p ds9 zoom 2 + $xpaset -p ds9 zoom 2 4 + $xpaset -p ds9 zoom to 4 + $xpaset -p ds9 zoom to 2 4 + $xpaset -p ds9 zoom in + $xpaset -p ds9 zoom out + $xpaset -p ds9 zoom to fit + $xpaset -p ds9 zoom open + $xpaset -p ds9 zoom close +
+ -- cgit v0.12 From e792f2c67d0bd25888fa8b9c97ba1a717cb4cf0c Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 14:44:08 -0400 Subject: clean up doc --- ds9/doc/ref/command.html | 5028 ++++++++++++++++++------------------- ds9/doc/ref/samp.html | 6192 ++++++++++++++++++++++------------------------ ds9/doc/ref/xpa.html | 5987 +++++++++++++++++++++----------------------- 3 files changed, 8164 insertions(+), 9043 deletions(-) diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index 1a33f5c..bfb9506 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -1,2654 +1,2380 @@ - - - - - Command Line Options - - -
Command Line Options
-
-
DS9 will process each command line option, one at a time, as - the last step in the initialization process. Therefore, it is - possible to use command line options as a little script. For - example, the following command line option is used:
- $ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 -
First DS9 is put in tile mode, then foo.fits is - loaded. Then the colormap for foo.fits is changed to Heat - and the scale changed to zscale. Next, bar.fits - is loaded and the colormap for bar.fits is changed to - I8.
- 2mass - 3d - about - align - analysis - array - asinh - background - backup - bin - blink - block - blue - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - dsssao - dsseso - dssstsci - envi - exit - export - fifo - fifo_only - fits - frame - geometry - gif - green - grid - header - height - help - histequ - iconify - inet_only - invert - iis - jpeg - language - linear - lock - log - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - msg - multiframe - nameserver - nan - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - port - port_only - pow - quit - raise - regions - red - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - samp - save - saveimage - scale - shm - sia - single - sinh - skyview - sleep - slice - smooth - squared - sqrt - source - tcl - threads - tiff - tile - title - unix - unix_only - update - url - version - view - visual - vla - vlss - vo - wcs - web - width - xpa - zmax - zoom - zscale
-
2mass
-
Support for 2MASS Digital Sky Survey.
- Syntax: - -2mass [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey j|h|k] -     [open|close] - - Example: - $ds9 -2mass - $ds9 -2mass m31 - $ds9 -2mass name m31 - $ds9 -2mass name clear - $ds9 -2mass 00:42:44.404 +41:16:08.78 - $ds9 -2mass size 60 60 arcmin - $ds9 -2mass save yes - $ds9 -2mass frame current - $ds9 -2mass update frame - $ds9 -2mass survey j - $ds9 -2mass open - $ds9 -2mass close - -
3d
-
Support for 3D frame.
- Syntax: - -3d [] -     [view <az> <el>] -     [az <az>] -     [el <el>] -     [scale <scale>] -     [method mip|aip] -     [background none|azimuth|elevation] -     [border yes|no] -     [border color] -     [highlite yes|no] -     [highlite color] -     [compass yes|no] -     [compass color] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $ds9 -3d # create new 3D frame - $ds9 -3d view 45 30 - $ds9 -3d az 45 - $ds9 -3d el 30 - $ds9 -3d scale 10 - $ds9 -3d method mip - $ds9 -3d background azimuth - $ds9 -3d border yes - $ds9 -3d border color red - $ds9 -3d highlite yes - $ds9 -3d highlite color red - $ds9 -3d compass yes - $ds9 -3d compass color red - $ds9 -3d match - $ds9 -3d lock yes - $ds9 -3d open - $ds9 -3d close
-
about
-
Get DS9 credits.
- Syntax: - -about - - Example: - $ds9 -about - -
align
-
Controls the World Coordinate System alignment for the current - frame.
- Syntax: - -align [yes|no] - - Example: - $ds9 -align yes - -
analysis
-
Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window.
- Syntax: - -analysis [<task number>] -     [<filename>] -     [task <task number>|<task name>] -     [load <filename>] -     [clear] -     [clear][load <filename>] -     [message ok|okcancel|yesno <message>] -     [entry <message>] -     [text] - - Example: - $ds9 -analysis 0 # invoke first analysis task - $ds9 -analysis task 0 - $ds9 -analysis task foobar - $ds9 -analysis task {foo bar} - $ds9 -analysis my.ans - $ds9 -analysis load my.ans - $ds9 -analysis clear - $ds9 -analysis clear load my.ans - $ds9 -analysis message {This is a message} - $ds9 -analysis text {This is text} - -
array
-
Load raw data array into current frame.
-
- Syntax: - -array <filename> -[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] - $cat foo.arr | ds9 -array -[dim=512,bitpix=-32,endian=little] - -
asinh
-
Select ASINH scale function for the current frame.
- Syntax: - -asinh - - Example: - $ds9 -asinh
-
bg
- background
-
Set image background color.
- Syntax: - -bg <color> - - Example: - $ds9 -background red - $ds9 -bg red
-
backup
-
Create a backup save set.
- Syntax: - -backup <filename> - - Example: - $ds9 -backup ds9.bck
-
bin
-
Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables.
- Syntax: - -bin [about <x> <y>] -     [about center] -     [buffersize <value>] -     [cols <x> <y>] -     [colsz <x> <y> <z>] -     [factor <value> [<value>]] -     [depth <value>] -     [filter <string>] -     [filter clear] -     [function average|sum] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $ds9 -bin about 4096 4096 - $ds9 -bin about center - $ds9 -bin buffersize 512 - $ds9 -bin cols detx dety - $ds9 -bin colsz detx dety time - $ds9 -bin factor 4 - $ds9 -bin factor 4 2 - $ds9 -bin depth 10 - $ds9 -bin filter 'pha > 5' - $ds9 -bin filter clear - $ds9 -bin function sum - $ds9 -bin in - $ds9 -bin out - $ds9 -bin to fit - $ds9 -bin match - $ds9 -bin lock yes - $ds9 -bin open - $ds9 -bin close - -
blink
-
Blink mode parameters. Interval is in seconds.
- Syntax: - -blink [] -     [yes|no] -     [interval <value>] - - Example: - $ds9 -blink - $ds9 -blink yes - $ds9 -blink interval 1
-
block
-
Controls blocking parameters.
- Syntax: - -block[<value>] -     [<value> <value>] -     [to <value>] -     [to <value> <value>] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $ds9-block4 - $ds9-block4 2 - $ds9-blockto 4 - $ds9-blockto 4 2 - $ds9-blockin - $ds9-blockout - $ds9-blockto fit - $ds9-blockmatch - $ds9-blocklock yes - $ds9-blockopen - $ds9-blockclose - -
blue
-
For RGB frames, sets the current color channel to blue.
- Syntax: - -blue - - Example: - $ds9 -blue foo.fits - -
catalog
- cat
-
Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise.
- Syntax: - -catalog [new] -     [ned|simbad|denis|skybot] -     -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -     [2mass|iras] -     [csc|xmm|rosat] -     [first|nvss] -     [chandralog|cfhtlog|esolog|stlog|xmmlog] -     [cds <catalogname>] -     [cds <catalogid>] - -     [load <filename>] -     [import sb|tsv <filename>] - -     [<ref>] [<ra> <dec> - <coordsys>] -     [<ref>] [allcols] -     [<ref>] [allrows] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [crosshair] -     [<ref>] [dec <col>] -     [<ref>] [edit yes|no] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [filter <string>] -     [<ref>] [filter load <filename>] -     [<ref>] [header] -     [<ref>] [location <code>] -     [<ref>] [match <ref> <ref>] -     [<ref>] [match] -     [<ref>] [match error <value> - degrees|arcmin|arcsec] -     [<ref>] [match function - 1and2|1not2|2not1] -     [<ref>] [match return - 1and2|1only|2only] -     [<ref>] [match unique yes|no] -     [<ref>] [maxrows <number>] -     [<ref>] [name <object>] -     [<ref>] [panto yes|no] -     [<ref>] [plot <xcol> <ycol> - <xerrcol> <yerrcol>] -     [<ref>] [print] -     [<ref>] [psky <skyframe>] -     [<ref>] [psystem <coordsys>] -     [<ref>] [ra <col>] -     [<ref>] [regions] -     [<ref>] [retrieve] -     [<ref>] [samp] -     [<ref>] [samp broadcast] -     [<ref>] [samp send <application>] -     [<ref>] [save <filename>] -     [<ref>] - [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -     [<ref>] [show yes|no] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [sort <col> incr|decr] -     [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -     [<ref>] [symbol [#] - text|size|size2|units|angle <value>] -     [<ref>] [symbol shape - circle|ellipse|box|text|point] -     [<ref>] [symbol shapecircle point|box - point|diamond point|cross point|x point|arrow point|boxcircle - point] -     [<ref>] [symbol add| [#] remove] -     [<ref>] [symbol save|load - <filename>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] -     [<ref>] [x <col>] -     [<ref>] [y <col>] - - Example: - $ds9 -catalog new - $ds9 -catalog 2mass - $ds9 -catalog cds 2mass - $ds9 -catalog cds "I/252" - - $ds9 -catalog load foo.xml - $ds9 -catalog import tsv foo.tsv - - $ds9 -catalog 202.48 47.21 fk5 - $ds9 -catalog allrows - $ds9 -catalog allcols - $ds9 -catalog cancel - $ds9 -catalog clear - $ds9 -catalog close - $ds9 -catalog crosshair - $ds9 -catalog dec DEC - $ds9 -catalog edit yes - $ds9 -catalog export tsv bar.tsv - $ds9 -catalog filter'\$Jmag>15' - $ds9 -catalog filter load foo.flt - $ds9 -catalog header - $ds9 -catalog location 500 - $ds9 -catalog match error 2 arcsec - $ds9 -catalog match function 1and2 - $ds9 -catalog match unique no - $ds9 -catalog match return 1only - $ds9 -catalog match # last two catalogs loaded - $ds9 -catalog match 2mass csc - $ds9 -catalog maxrows 2000 - $ds9 -catalog name m51 - $ds9 -catalog panto no - $ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag' - $ds9 -catalog print - $ds9 -catalog psky fk5 - $ds9 -catalog psystem wcs - $ds9 -catalog ra RA - $ds9 -catalog regions - $ds9 -catalog retrieve - $ds9 -catalog samp broadcast - $ds9 -catalog samp send aladin - $ds9 -catalog save foo.xml - $ds9 -catalog server sao - $ds9 -catalog show yes - $ds9 -catalog radius 1 degrees - $ds9 -catalog symbol condition '\$Jmag>15' - $ds9 -catalog symbol 2 shape "boxcircle point" - $ds9 -catalog symbol color red - $ds9 -catalog symbol font times - $ds9 -catalog symbol fontsize 14 - $ds9 -catalog symbol fontweight bold - $ds9 -catalog symbol fontslant italic - $ds9 -catalog symbol add - $ds9 -catalog symbol 2 remove - $ds9 -catalog symbol load foo.sym - $ds9 -catalog symbol save bar.sym - $ds9 -catalog sky fk5 - $ds9 -catalog skyformat degrees - $ds9 -catalog sort "Jmag" incr - $ds9 -catalog system wcs - $ds9 -catalog update - $ds9 -catalog x RA - $ds9 -catalog y DEC
-
cd
-
Sets the current working directory.
- Syntax: - cd [<directory>] - - Example: - $ds9 -cd /home/mrbill - -
cmap
-
Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1.
- Syntax: - -cmap [<colormap>] -     [load <filename>] -     [save <filename>] -     [invert yes|no] -     [<contrast> <bias>] -     [tag [load|save] <filename>] -     [tag delete] -     [open|close] - - Example: - $ds9 -cmap Heat - $ds9 -cmap load foo.sao - $ds9 -cmap save bar.sao - $ds9 -cmap invert yes - $ds9 -cmap 5 .5 - $ds9 -cmap tag load foo.tag - $ds9 -cmap tag save foo.tag - $ds9 -cmap tag delete - $ds9 -cmap open - $ds9 -cmap close - -
colorbar
-
Controls colorbar parameters.
- Syntax: - -colorbar [] -     [yes|no] -     [horizontal|vertical] -     [numerics yes|no] -     [space value|distance] -     [font times|helvetica|courier] -     [fontsize <value>] -     [fontweight normal|bold] -     [fontslant roman|italic] -     [size] -     [ticks] -     [match] -     [lock [yes|no]] - - Example: - $ds9 -colorbar yes - $ds9 -colorbar vertical - $ds9 -colorbar numerics yes - $ds9 -colorbar space value - $ds9 -colorbar font times - $ds9 -colorbar fontsize 14 - $ds9 -colorbar fontweight bold - $ds9 -colorbar fontslant italic - $ds9 -colorbar size 20 - $ds9 -colorbar ticks 11 - $ds9 -colorbar match - $ds9 -colorbar lock yes
-
console
-
Display tcl console window.
- Syntax: - -console - - Example: - $ds9 -console - -
contour
-
-
Controls contours in the current frame.
- Syntax: - -contour [] -     [yes|no] -     [clear] -     [generate] -     [load <filename>] -     [save <filename> [<coordsys> - <skyframe>]] -     [convert] -     [load levels <filename>] -     [save levels <filename>] -     [copy] -     [paste [<coordsys> <color> - <width> yes|no]] -     [color <color>] -     [width <width>] -     [dash yes|no] -     [smooth <smooth>] -     [method block|smooth] -     [nlevels <number of levels>] -     [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -     [log exp <value>] -     [mode minmax|<value>|zscale|zmax] -     [scope global|local] -     [limits <min> <max>] -     [levels <value value value...>] -     [open|close] - - Example: - $ds9 -contour - $ds9 -contour yes - $ds9 -contour generate - $ds9 -contour clear - $ds9 -contour load ds9.ctr - $ds9 -contour save ds9.ctr - $ds9 -contour save ds9.ctr wcs fk5 - $ds9 -contour convert - $ds9 -contour load levels ds9.ctr - $ds9 -contour save levels ds9.lev - $ds9 -contour copy - $ds9 -contour paste - $ds9 -contour paste wcs red 2 no - $ds9 -contour color yellow - $ds9 -contour width 2 - $ds9 -contour dash yes - $ds9 -contour smooth 5 - $ds9 -contour method smooth - $ds9 -contour nlevels 10 - $ds9 -contour scale sqrt - $ds9 -contour log exp 1000 - $ds9 -contour mode zscale - $ds9 -contour scope local - $ds9 -contour limits 1 100 - $ds9 -contour levels 1 10 100 1000 - $ds9 -contour open - $ds9 -contour close - -
crop
-
Set current image display area.
- Syntax: - -crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -     [match <coordsys>] -     [lock <coordsys>|none] -     [reset] -     [3d zmin zmax <coordsys>] -     [open|close] - - Example: - $ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords - $ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 - 22.000204 wcs galactic arcsec - $ds9 foo.fits -crop match wcs - $ds9 foo.fits -crop lock wcs - $ds9 foo.fits -crop reset - $ds9 foo.fits -crop 3d .25 .5 wcs - $ds9 foo.fits -crop open - $ds9 foo.fits -crop close - -
crosshair
-
Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set.
- Syntax: - -crosshair [<x> <h> <coordsys> - [<skyframe>]] -    [match <coordsys>] -     [lock <coordsys>|none] - - Example: - $ds9 -crosshair 100 100 physical # set crosshair in physical - $ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords - $ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 - $ds9 -crosshair match - $ds9 -crosshair lock wcs - -
cube
-
-
Controls FITS cube.
- Syntax: - -cube [] -     [play|stop|next|prev|first|last] -     [<slice> [<coordsys>]] -     [interval <numeric>] -     [match <coordsys>] -     [lock <coordsys>|none] -     [order 123|132|213|231|312|321] -     [axes lock [yes|no]] -     [open|close] - - Example: - $ds9 -cube - $ds9 -cube play - $ds9 -cube last - $ds9 -cube 3 - $ds9 -cube 4.5 wcs - $ds9 -cube interval 2 - $ds9 -cube match wcs - $ds9 -cube lock wcs - $ds9 -cube order 123 - $ds9 -cube axes lock yes - $ds9 -cube open - $ds9 -cube close
-
cursor
-
Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also.
- Syntax: - -cursor [<x> <h>] - - Example: - $ds9 -cursor 10 10 - -
dsssao
- dss
-
-
Support for Digital Sky Survey at SAO.
- Syntax: - -dsssao [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $ds9 -dsssao - $ds9 -dsssao m31 - $ds9 -dsssao name m31 - $ds9 -dsssao name clear - $ds9 -dsssao 00:42:44.404 +41:16:08.78 - $ds9 -dsssao size 60 60 arcmin - $ds9 -dsssao save yes - $ds9 -dsssao frame current - $ds9 -dsssao update frame - $ds9 -dsssao open - $ds9 -dsssao close - -
dsseso
-
Support for Digital Sky Survey at ESO.
- Syntax: - -dsseso [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -     [open|close] - - Example: - $ds9 -dsseso - $ds9 -dsseso m31 - $ds9 -dsseso name m31 - $ds9 -dsseso name clear - $ds9 -dsseso 00:42:44.404 +41:16:08.78 - $ds9 -dsseso size 60 60 arcmin - $ds9 -dsseso save yes - $ds9 -dsseso frame current - $ds9 -dsseso update frame - $ds9 -dsseso survey DSS2-red - $ds9 -dsseso open - $ds9 -dsseso close
-
dssstsci
-
Support for Digital Sky Survey at STSCI.
- Syntax: - -dssstsci [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -     [survey poss1_blue|poss1_red] -     [survey all|quickv|phase2_gsc2|phase2_gsc1] -     [open|close] - - Example: - $ds9 -dssstsci - $ds9 -dssstsci m31 - $ds9 -dssstsci name m31 - $ds9 -dssstsci name clear - $ds9 -dssstsci 00:42:44.404 +41:16:08.78 - $ds9 -dssstsci size 60 60 arcmin - $ds9 -dssstsci save yes - $ds9 -dssstsci frame current - $ds9 -dssstsci update frame - $ds9 -dssstsci survey all - $ds9 -dssstsci open - $ds9 -dssstsci close
-
envi
-
Load an ENVI header and file. Optional parameter: array endian.
-
- Syntax: - -envi <header> [<filename>] - - Example: - $ds9 -envi foo.hdr - $ds9 -envi foo.hdr foo.bsq - -
exit
- quit
-
Quits DS9.
- Syntax: - -exit - -quit - - Example: - $ds9 -exit - -
export
-
-
Export loaded image data of current frame in specified image - format, at native resolution, using current colormap and - contrast/bias settings. NOTE: not scaling, rotation, or - translation is applied. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff compression method.
-
- Syntax: - -export [array|nrrd|envi|gif|tiff|jpeg|png] <filename> - -export array <filename>[big|little|native] - -export nrrd <filename>[big|little|native] - -export envi <header> - [<filename>][big|little|native] - -export <filename>.jpeg [1-100] - -export <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - $ds9 -export array foo.arr little - $ds9 -export nrrd foo.nrrd little - $ds9 -export envi foo.hdr little - $ds9 -export envi foo.hdr foo.bsq little - $ds9 -export tiff foo.tiff jpeg - $ds9 -export jpeg foo.jpeg 75 - $ds9 -export png foo.png
-
fifo
-
Set the name of the IRAF input and output fifos. The default is - /dev/imt1. These fifos are used by IRAF to communicate with DS9.
- Syntax: - -fifo name - - Example: - $ds9 -fifo /dev/imt1 -
fifo_only
-
Only use IRAF input and output fifos. Same as -port 0 -unix - none.
- Syntax: - -fifo_only - - Example: - $ds9 -fifo_only - -
fits
-
Load a FITS image into the current frame.
-
- Syntax: - -fits<filename> - - Example: - $ds9 -fits foo.fits - $ds9 -fits bar.fits[bin=detx,dety] - $cat foo.fits | ds9 -fits - - $cat bar.fits | ds9 -fits -[bin=detx,dety] - -
frame
-
Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility.
- Syntax: - -frame [center [#|all]] -     [clear [#|all]] -     [new [rgb]] -     [delete [#|all]] -     [reset [#|all]] -     [refresh [#|all]] -     [hide [#|all]] -     [show [#|all]] -     [move first] -     [move back] -     [move forward] -     [move last] -     [first] -     [prev] -     [next] -     [last] -     [frameno #] -     [#] -     [match <coordsys>] -     [lock <coordsys>|none] - - Example: - $ds9 -frame center # center current frame - $ds9 -frame center 1 # center 'Frame1' - $ds9 -frame center all # center all frames - $ds9 -frame clear # clear current frame - $ds9 -frame new # create new frame - $ds9 -frame new rgb # create new rgb frame - $ds9 -frame delete # delete current frame - $ds9 -frame reset # reset current frame - $ds9 -frame refresh # refresh current frame - $ds9 -frame hide # hide current frame - $ds9 -frame show 1 # show frame 'Frame1' - $ds9 -frame move first # move frame to first in order - $ds9 -frame move back # move frame back in order - $ds9 -frame move forward # move frame forward in order - $ds9 -frame move last # move frame to last in order - $ds9 -frame first # goto first frame - $ds9 -frame prev # goto prev frame - $ds9 -frame next # goto next frame - $ds9 -frame last # goto last frame - $ds9 -frame frameno 4 # goto frame 'Frame4', create if needed - $ds9 -frame 3 # goto frame 'Frame3', create if needed - $ds9 -frame lock wcs
-
gif
-
Load GIF image into current frame.
- Syntax: - -gif <filename> - - Example: - $ds9 -gif foo.gif - $cat foo.gif | ds9 -gif - - -
geometry
-
Define the initial window geometry. This includes all of the - ds9 window, not just the image space. see X(1).
- Syntax: - -geometry value - - Example: - $ds9 -geometry 640x480 -
green
-
For RGB frames, sets the current color channel to green.
- Syntax: - -green - - Example: - $ds9 -green foo.fits -
grid
-
Controls coordinate grid. For grid numeric format syntax, - click here.
- Syntax: - -grid [] -     [yes|no] -     [type analysis|publication] -     [system <coordsys>] -     [sky <skyframe>] -     [skyformat <skyformat>] -     [grid yes|no] -     [grid color <color>] -     [grid width <value>] -     [grid dash yes|no] -     [grid gap1 <value>] -     [grid gap2 <value>] -     [grid gap3 <value>] -     [axes yes|no] -     [axes color <color>] -     [axes width <value>] -     [axes dash yes|no] -     [axes type interior|exterior] -     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] -     [format1 <format>] -     [format2 <format>] -     [tickmarks yes|no] -     [tickmarks color <color>] -     [tickmarks width <value>] -     [tickmarks dash yes|no] -     [border yes|no] -     [border color <color>] -     [border width <value>] -     [border dash yes|no] -     [numerics yes|no] -     [numerics font times|helvetica|courier] -     [numerics fontsize <value>] -     [numerics fontweight normal|bold] -     [numerics fontslant roman|italic] -     [numerics color <color>] -     [numerics gap1 <value>] -     [numerics gap2 <value>] -     [numerics gap3 <value>] -     [numerics type interior|exterior] -     [numerics vertical yes|no] -     [title yes|no] -     [title text <text>] -     [title def yes|no] -     [title gap <value>] -     [title font times|helvetica|courier] -     [title fontsize <value>] -     [title fontweight normal|bold] -     [title fontslant roman|italic] -     [title color <color>] -     [labels yes|no] -     [labels text1 <text>] -     [labels text2 <text>] -     [labels def1 yes|no] -     [labels def2 yes|no] -     [labels gap1 <value>] -     [labels gap2 <value>] -     [labels font times|helvetica|courier] -     [labels fontsize <value>] -     [labels fontweight normal|bold] -     [labels fontslant roman|italic] -     [labels color <color>] -     [reset] -     [load <filename>] -     [save <filename>] -     [open|close] - - Example: - $ds9 -grid - $ds9 -grid yes - $ds9 -grid type analysis - $ds9 -grid system wcs - $ds9 -grid sky fk5 - $ds9 -grid skyformat degrees - $ds9 -grid grid yes - $ds9 -grid grid color red - $ds9 -grid grid width 2 - $ds9 -grid grid dash yes - $ds9 -grid grid gap1 10 - $ds9 -grid grid gap2 10 - $ds9 -grid grid gap3 10 - $ds9 -grid axes yes - $ds9 -grid axes color red - $ds9 -grid axes width 2 - $ds9 -grid axes dash yes - $ds9 -grid axes type exterior - $ds9 -grid axes origin lll - $ds9 -grid format1 d.2 - $ds9 -grid format2 d.2 - $ds9 -grid tickmarks yes - $ds9 -grid tickmarks color red - $ds9 -grid tickmarks width 2 - $ds9 -grid tickmarks dash yes - $ds9 -grid border yes - $ds9 -grid border color red - $ds9 -grid border width 2 - $ds9 -grid border dash yes - $ds9 -grid numerics yes - $ds9 -grid numerics font courier - $ds9 -grid numerics fontsize 12 - $ds9 -grid numerics fontweight bold - $ds9 -grid numerics fontslant italic - $ds9 -grid numerics color red - $ds9 -grid numerics gap1 10 - $ds9 -grid numerics gap2 10 - $ds9 -grid numerics gap3 10 - $ds9 -grid numerics type exterior - $ds9 -grid numerics vertical yes - $ds9 -grid title yes - $ds9 -grid title text {Hello World} - $ds9 -grid title def yes - $ds9 -grid title gap 10 - $ds9 -grid title font courier - $ds9 -grid title fontsize 12 - $ds9 -grid title fontweight bold - $ds9 -grid title fontslant italic - $ds9 -grid title color red - $ds9 -grid labels yes - $ds9 -grid labels text1 {Hello World} - $ds9 -grid labels text2 {Hello World} - $ds9 -grid labels def1 yes - $ds9 -grid labels def2 yes - $ds9 -grid labels gap1 10 - $ds9 -grid labels gap2 10 - $ds9 -grid labels font courier - $ds9 -grid labels fontsize 12 - $ds9 -grid labels fontweight bold - $ds9 -grid labels fontslant italic - $ds9 -grid labels color red - $ds9 -grid reset - $ds9 -grid load foo.grd - $ds9 -grid save foo.grd - $ds9 -grid open - $ds9 -grid close - -
header
-
Display current fits header dialog. Optional extension number - maybe specified.
- Syntax: - -header [<ext>] -     [close [<ext>]] -     [save [<ext>] <filename>] - - Example: - $ds9 -header - $ds9 -header 2 - $ds9 -header close - $ds9 -header save 1 foo.txt - -
height
-
Set the height of the image display window. Use the geometry command to set the - overall width and height of the ds9 window.
- Syntax: - -height [<value>] - - Example: - $ds9 -height 512 - -
help
-
Display help information. To maintain backward compatibility, - -help will display a brief help message and exit. --help will - display all command line options within the built-in help - facility.
- Syntax: - -help # Display brief help message and exit. - --help # Display command line options within help facility. - -? # Display command line options within help facility. - - Example: - $ds9 -help # Display brief help message and exit. - $ds9 --help # Display command line options within help facility - $ds9 -? # Display command line options within help facility. - -
histequ
-
Select histogram equalization scale function for the current - frame.
- Syntax: - -histequ - - Example: - $ds9 -histequ - -
iconify
-
Toggles iconification.
- Syntax: - -iconify [] -     [yes|no] - - Example: - $ds9 -iconify - $ds9 -iconify yes
-
invert
-
Invert Colormap.
- Syntax: - -invert - - Example: - $ds9 -invert - -
iis
-
Set IIS Filename. Optional mosaic number maybe supplied.
- Syntax: - -iis [filename <filename> [#]] - - Example: - $ds9 -iis filename foo.fits - $ds9 -iis filename bar.fits 4
-
jpeg
-
Load JPEG image into current frame.
- Syntax: - -jpeg <filename> - - Example: - $ds9 -jpeg foo.jpeg - $cat foo.jpeg | ds9 -jpeg -
-
language
-
Select current language.
- Syntax: - -language [locale|da|de|es|en|fr|ja|pt] - - Example: - $ds9 -language fr - -
linear
-
Select linear scale function for the current frame.
- Syntax: - -linear - - Example: - $ds9 -linear -
lock
-
Lock all other frames to the current frame.
- Syntax: - -lock[frame <coordsys>|none] -     [crosshair <coordsys>|none] -     [crop <coordsys>|none] -     [slice <coordsys>|none] -     [bin [yes|no]] -     [axes [yes|no]] -     [scale [yes|no]] -     [scalelimits [yes|no]] -     [colorbar [yes|no]] -     [block [yes|no]] -     [smooth [yes|no]] -     [3d [yes|no]] - - Example: - $ds9 -lock frame wcs - $ds9 -lock crosshair wcs - $ds9 -lock crop wcs - $ds9 -lock slice wcs - $ds9 -lock bin yes - $ds9 -lock axes yes - $ds9 -lock scale yes - $ds9 -lock scalelimits yes - $ds9 -lock colorbar yes - $ds9 -lock block yes - $ds9 -lock smooth yes - $ds9 -lock 3d yes - - log -
Select log scale function for the current frame.
-
- Syntax: - -log - - Example: - $ds9 -log -
lower
-
Lower in the window stacking order.
- Syntax: - -lower - - Example: - $ds9 -lower - -
magnifier
-
Controls the magnifier settings.
- Syntax: - magnifier [color <color>] -     [zoom <value>] -     [cursor yes|no] -     [region yes|no] - - Example: - $ds9 -magnifier color yellow - $ds9 -magnifier zoom 2 - $ds9 -magnifier cursor no - $ds9 -magnifier region no - -
mask
- nomask
-
-
Controls mask parameters.
- Syntax: - -mask [color <color>] -     [mark zero|nonzero|nan|nonnan|range] -     [range <low> <high>] -     [transparency <value>] -     [system <coordsys>] -     [clear] -     [open|close] - -nomask - - Example: - $ds9 -mask color red - $ds9 -mask mark zero - $ds9 -mask range 10 100 - $ds9 -mask transparency 50 - $ds9 -mask system wcs - $ds9 -mask clear - $ds9 -mask open - $ds9 -mask close - $ds9 -nomask - -
match
-
Match all other frames to the current frame.
- Syntax: - -match[frame <coordsys>] -     [crosshair <coordsys>] -     [crop <coordsys>] -     [slice <coordsys>] -     [bin] -     [axes] -     [scale] -     [scalelimits] -     [colorbar] -     [block] -     [smooth] -     [3d] - - Example: - $ds9 -match frame wcs - $ds9 -match crosshair wcs - $ds9 -match crop wcs - $ds9 -match slice wcs - $ds9 -match bin - $ds9 -match axes - $ds9 -match scale - $ds9 -match scalelimits - $ds9 -match colorbar - $ds9 -match block - $ds9 -match smooth - $ds9 -match 3d
- - mecube -
Load FITS multiple extension file as data cube.
-
- Syntax: - mecube <filename> - - Example: - $ds9 -mecube foo.fits - $cat foo.fits | ds9 -mecube -
-
minmax
-
This is how DS9 determines the min and max data values - from the data. SCAN will scan all data.
- Syntax: - -minmax [scan|sample|datamin|irafmin] -     [mode scan|sample|datamin|irafmin] -     [interval #] - - Example: - $ds9 -minmax scan - $ds9 -minmax mode scan - $ds9 -minmax interval 100 - -
mode
-
Select the current mode.
- Syntax: - -mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - $ds9 -mode crosshair
-
mosaic
-
Load FITS mosaic segment into current frame.
- Syntax: - -mosaic [wcs|wcsa...wcsz|iraf] <filename> - - Example: - $ds9 -mosaic foo.fits - $ds9 -mosaic wcs foo.fits - $cat foo.fits | ds9 -mosaic - - $cat foo.fits | ds9 -mosaic wcs - - -
mosaicimage
-
Load FITS mosaic image into current frame.
- Syntax: - -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> - - Example: - $ds9 -mosaicimage foo.fits - $ds9 -mosaicimage wcs foo.fits - $cat foo.fits | ds9 -mosaicimage - $cat foo.fits | ds9 -mosaiimage wcs - -
movie
-
-
Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.
- Syntax: - -movie [slice|frame|3d] [mpeg|gif] <filename> - -movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - $ds9 -movie slice mpeg ds9.mpg - $ds9 -movie frame gif ds9.gif - $ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 - oscillate 1
-
msg
-
Specify a directory of translation tables to be loaded.
- Syntax: - -msg <directory> - - Example: - $ds9 -msg $HOME/msgs
-
multiframe
-
Load FITS multiple extension file as multiple images.
-
- Syntax: - multiframe <filename> - - Example: - $ds9 -multiframe foo.fits - $cat foo.fits | ds9 -multiframe - - -
nameserver
-
Support Name Server functions. Coordinates are in fk5.
- Syntax: - -nameserver [<object>] -     [name <object>] -     [skyformat degrees|sexagesimal] -     [pan] -     [crosshair] -     [open|close] - - Example: - $ds9 -nameserver m31 - $ds9 -nameserver name m31 - $ds9 -nameserver server ned-sao - $ds9 -nameserver skyformat sexagesimal - $ds9 -nameserver pan - $ds9 -nameserver crosshair - $ds9 -nameserver open - $ds9 -nameserver close - -
nan
-
Set image not-a-number color.
- Syntax: - -nan <color> - - Example: - $ds9 -nan red
-
nrrd
-
Load an NRRD (Nearly Raw Raster Data) file.
-
- Syntax: - -nrrd <filename> - - Example: - $ds9 -nrrd foo.nrrd - $cat foo.nrrd | xpaset ds9 -nrrd- - -
nvss
-
Support for NRAO VLA Sky Survey.
- Syntax: - -nvss [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $ds9 -nvss - $ds9 -nvss m31 - $ds9 -nvss name m31 - $ds9 -nvss name clear - $ds9 -nvss 00:42:44.404 +41:16:08.78 - $ds9 -nvss size 60 60 arcmin - $ds9 -nvss save yes - $ds9 -nvss frame current - $ds9 -nvss update frame - $ds9 -nvss open - $ds9 -nvess close - -
orient
-
Controls the orientation of the current frame.
- Syntax: - -orient [none|x|y|xy] -     [open|close] - - Example: - $ds9 -orient xy - $ds9 -orient open - $ds9 -orient close - -
pagesetup
-
Controls Page Setup options.
-
- Syntax: - -pagesetup [orient portrait|landscape] -     [scale <numberic>] -     [size letter|legal|tabloid|poster|a4] - - Example: - $ds9 -pagesetup orient portrait - $ds9 -pagesetup scale 50 - $ds9 -pagesetup size poster
-
pan
-
Controls the current image cursor location for the current - frame.
- Syntax: - -pan [<x> <h> <coordsys> [<skyframe>]] # - relative -     [to <x> <h> <coordsys> - [<skyframe>]] # absolute -     [open|close] - - Example: - $ds9 -pan 200 200 image# pan relative - $ds9 -pan to 400 400 physical# pan to physical coords - $ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords - $ds9 -pan open - $ds9 -pan close
-
pixeltable
-
Display/Hide the pixel table.
- Syntax: - -pixeltable [] -     [yes|open] -     [no|close] - - Example: - $ds9 -pixeltable - $ds9 -pixeltable yes - $ds9 -pixeltable open - $ds9 -pixeltable close - -
plot
-
Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions:
-
xy    x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors -
-
To create a new plot, use the plot new command.
- Syntax: - # create new empty plot window - -plot [line|bar|scatter] - - # existing plot - -plot[[<plotname>] load <filename> - xy|xyex|xyey|xyexey] -     [[<plotname>] save <filename>] -     [[<plotname>] clear] -     [[<plotname>] duplicate [#]] -     [[<plotname>] stats yes|no] -     [[<plotname>] list yes|no] -     [[<plotname>] loadconfig - <filename>] -     [[<plotname>] saveconfig - <filename>] -     [[<plotname>] pagesetup orient - portrait|landscape] -     [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] -     [[<plotname>] print] -     [[<plotname>] print destination - printer|file] -     [[<plotname>] print command - <command>] -     [[<plotname>] print filename - <filename>] -     [[<plotname>] print color rgb|gray] -     [[<plotname>] close] -     [[<plotname>] mode pointer|zoom] - - # export image - plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> -     [[<plotname>]export jpeg - <filename>[1-100] -     [[<plotname>]export tiff - <filename>[none|jpeg|packbits|deflate] - - # configure graph - -plot [[<plotname>] axis x|y grid yes|no] -     [[<plotname>] axis x|y log yes|no] -     [[<plotname>] axis x|y flip yes|no] -     [[<plotname>] axis x|y auto yes|no] -     [[<plotname>] axis x|y min - <value>] -     [[<plotname>] axis x|y max - <value>] -     [[<plotname>] axis x|y format - <string>] -     [[<plotname>] background <value>] -     [[<plotname>] legend yes|no] -     [[<plotname>] legend position - right|left|top|bottom] -     [[<plotname>] font title|labels|numbers - font times|helvetica|courier] -     [[<plotname>] - fonttitle|labels|numberssize <value>] -     [[<plotname>] - fonttitle|labels|numbersweight normal|bold] -     [[<plotname>] - fonttitle|labels|numbersslant roman|italic] -     [[<plotname>] title <string>] -     [[<plotname>] title x|y <string>] -     [[<plotname>] barmode - normal|stacked|aligned|overlap] - - # configure current dataset - -plot [[<plotname>] show yes|no] -    [[<plotname>] shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -    [[<plotname>] shape fill yes|no] -    [[<plotname>] shape color <value>] -    [[<plotname>] smooth - step|linear|cubic|quadratic|catrom] -    [[<plotname>] color <value>] -    [[<plotname>] width <value>] -    [[<plotname>] dash yes|no] -    [[<plotname>] error yes|no] -    [[<plotname>] error color <value>] -    [[<plotname>] error cap yes|no] -    [[<plotname>] error width <value>] -    [[<plotname>] name <string>] - - # select current dataset - -plot [[<plotname>] select <value>] - - Example: - # create new empty plot window - $ds9 -plot bar - - # existing plot - $ds9 -plot load xy.dat - $ds9 -plot save foo.dat - $ds9 -plot clear - $ds9 -plot duplicate 1 - $ds9 -plot stats yes - $ds9 -plot list yes - $ds9 -plot loadconfig foo.plt - $ds9 -plot saveconfig foo.plt - $ds9 -plot pagesetup orient portrait - $ds9 -plot pagesetup size letter - $ds9 -plot print - $ds9 -plot print destination file - $ds9 -plot print command lp - $ds9 -plot print filename foo.ps - $ds9 -plot print color rgb - $ds9 -plot close - - # plot mode - $ds9 -plot mode pointer - - # export plot - $ds9 -plot export tiff foo.tiff jpeg - $ds9 -plot export jpeg foo.jpeg 75 - $ds9 -plot export png foo.png - - # configure plot - $ds9 -plot axis x grid yes - $ds9 -plot axis x log yes - $ds9 -plot axis x flip yes - $ds9 -plot axis x auto no - $ds9 -plot axis x min 1 - $ds9 -plot axis x max 100 - $ds9 -plot axis x format '%f' - $ds9 -plot background white - $ds9 -plot legend yes - $ds9 -plot legend position left - $ds9 -plot font numbers font times - $ds9 -plot font numbers size 12 - $ds9 -plot font numbers weight bold - $ds9 -plot font numbers slant italic - $ds9 -plot title 'This is a Title' - $ds9 -plot title x 'X Axis' - $ds9 -plot title y 'Y Axis' - $ds9 -plot title legend 'This is the Legend' - - # bar plot - $ds9 -plot barmode aligned - - # configure current dataset - $ds9 -plot show yes - $ds9 -plot shape circle - $ds9 -plot shape fill no - $ds9 -plot shape color cyan - $ds9 -plot smooth step - $ds9 -plot color red - $ds9 -plot width 2 - $ds9 -plot dash yes - $ds9 -plot error yes - $ds9 -plot error color red - $ds9 -plot error cap yes - $ds9 -plot error width 2 - $ds9 -plot name 'My Data' - - # select current dataset - $ds9 -plot select 2 -
png
-
Load PNG image into current frame.
-
- Syntax: - -png <filename> - - Example: - $ds9 png foo.png - $cat foo.png | ds9 -png - - -
port
-
Set the IRAF port number, used by IRAF to communicate with DS9. - The default is 5137, the standard IRAF port used by ximtool.
- Syntax: - -port number - - Example: - $ds9 -port 5137 -
port_only
- inet_only
-
Only use the IRAF port number. This is the same as -fifo none - -unix none.
- Syntax: - -port_only - - Example: - $ds9 -port_only - -
pow
-
Select power scale function for the current frame.
- Syntax: - -pow - - Example: - $ds9 -pow - -
precision
-
Set region and coordinate output format precision.
- Syntax: - -precision -<linear><degree><hms><dms><arcmin><arcsec> - - Example: - $ds9 -precision 8 10 4 3 5 3
-
prefs
-
Controls various preference settings.
- Syntax: - -prefs [clear] -     [irafalign yes|no] - - Example: - $ds9 -prefs clear - $ds9 -prefs irafalign yes - -
preserve
-
Preserve the follow attributes while loading a new image.
- Syntax: - preserve [pan yes|no] -     [regions yes|no] - - Example: - $ds9 -preserve pan yes - $ds9 -preserve regions yes - -
psprint
-
Invokes postscript printing. Please see print - for further details.
-
print
-
Controls printing. Use print option to set printing options.
-
- Syntax: - -print [destination printer|file] -     [command <command>] -     [filename <filename>] -     [color rgb|cmyk|gray] -     [level 1|2|3] -     - [resolution72|screen|96|144|150|225|300|600|1200] - - Example: - $ds9 -print - $ds9 -print destination file - $ds9 -print command lp - $ds9 -print filename foo.ps - $ds9 -print color cmyk - $ds9 -print level 2 - $ds9 -print resolution 96 -
raise
-
Raise in the window stacking order.
- Syntax: - -raise - - Example: - $ds9 -raise - -
regions
-
Controls regions in the current frame.
- Syntax: - -regions [<filename>] -     [load [all] <filename>] -     [save <filename>] -     [list [close]] -     [epsilon <integer>] -     [show yes|no] -     [showtext yes|no] -     [centroid] -     [centroid auto yes|no] -     [centroid radius <value>|iteration - <value>] -     [getinfo] -     [move front] -     [move back] -     [select all] -     [select none] -     [select invert] -     [delete all] -     [delete select] -     [format ds9|xml|ciao|saotng|saoimage|pros|xy] -     [system image|physical|wcs|wcsa...wcsz] -     [sky fk4|fk5|icrs|galactic|ecliptic] -     [skyformat degrees|sexagesimal] -     [strip yes|no] -     [shape <shape>] -     [color <color> -     [width <width>] -     [fixed|edit|rotate|delete yes|no] -     [include|exclude|source|background] -     [command <marker command>] -     [composite] -     [dissolve] -     [template <filename>] -     [template <filename> at <ra> - <dec> <coordsys> <skyframe>] -     [savetemplate <filename>] -     [group new] -     [group <tag> new] -     [group <tag> update] -     [group <tag> select] -     [group <tag> color <color>] -     [group <tag> copy] -     [group <tag> delete] -     [group <tag> cut] -     [group <tag> font <font>] -     [group <tag> move <int> - <int>] -     [group <tag> movefront] -     [group <tag> moveback] -     [group <tag> property <property> - yes|no] -     [copy] -     [cut] -     [paste image|physical|wcs|wcsa...wcsz] -     [undo] - - Example: - $ds9 -regions foo.reg - $ds9 -regions -format ciao bar.reg # load as ciao format - $ds9 -regions foo.fits # FITS regions files do not need a format - specification - $ds9 -regions load foo.reg # load foo.reg into current frame - $ds9 -regions load all foo.reg # load foo.reg into all frames - $ds9 -regions load '*.reg'# expand *.reg and load into current - frame - $ds9 -regions load all '*.reg' # expand *.reg and load into all - frames - $ds9 -regions save foo.reg - $ds9 -regions list - $ds9 -regions list close - $ds9 -regions epsilon 5 - $ds9 -regions show yes - $ds9 -regions showtext no - $ds9 -regions centroid - $ds9 -regions centroid auto yes - $ds9 -regions centroid radius 10 - $ds9 -regions centroid iteration 20 - $ds9 -regions getinfo - $ds9 -regions move back - $ds9 -regions move front - $ds9 -regions select all - $ds9 -regions select none - $ds9 -regions select invert - $ds9 -regions delete all - $ds9 -regions delete select - $ds9 -regions format ds9 - $ds9 -regions system wcs - $ds9 -regions sky fk5 - $ds9 -regions skyformat degrees - $ds9 -regions strip yes - $ds9 -regions shape ellipse - $ds9 -regions color red - $ds9 -regions width 3 - $ds9 -regions edit yes - $ds9 -regions include - $ds9 -regions command "circle 100 100 20 # color=red" - $ds9 -regions composite - $ds9 -regions dissolve - $ds9 -regions template foo.tpl - $ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 - $ds9 -regions savetemplate foo.tpl - $ds9 -regions group new - $ds9 -regions group foo new - $ds9 -regions group foo update - $ds9 -regions group foo select - $ds9 -regions group foo color red - $ds9 -regions group foo copy - $ds9 -regions group foo delete - $ds9 -regions group foo cut - $ds9 -regions group foo font {times 14 bold} - $ds9 -regions group foo move 100 100 - $ds9 -regions group foo movefront - $ds9 -regions group foo moveback - $ds9 -regions group foo property delete no - $ds9 -regions copy - $ds9 -regions cut - $ds9 -regions paste wcs - $ds9 -regions undo - -
red
-
For RGB frames, sets the current color channel to red.
- Syntax: - -red - - Example: - $ds9 -red foo.fits - -
restore
-
Restore DS9 to a previous state from a backup save set.
- Syntax: - -restore <filename> - - Example: - $ds9 -restore ds9.bck
-
rgb
-
Create RGB frame and control RGB frame parameters.
- Syntax: - -rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -     [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -     [open|close] - - Example: - $ds9 -rgb # create new rgb frame - $ds9 -rgb red # set current channel to red - $ds9 -rgb channel red # set current channel to red - $ds9 -rgb view blue no # turn off blue channel - $ds9 -rgb system wcs # set rgb coordinate system - $ds9 -rgb lock wcs yes - $ds9 -rgb lock crop yes - $ds9 -rgb lock slice yes - $ds9 -rgb lock bin yes - $ds9 -rgb lock scale yes - $ds9 -rgb lock scalelimits yes - $ds9 -rgb lock colorbar yes - $ds9 -rgb lock block yes - $ds9 -rgb lock smooth yes - $ds9 -rgb open - $ds9 -rgb close
-
rgbarray
-
Load raw data array cube into rgb frame.
-
- Syntax: - -rgbarray -<filename>[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - $cat foo.arr | ds9 -rgbarray - -[dim=512,zdim=3,bitpix=-32,endian=little]
-
rgbcube
-
Load FITS rgbcube into rgb frame.
-
- Syntax: - -rgbcube <filename> - - Example: - $ds9 -rgbcube foo.fits - $cat foo.fits | ds9 -rgbcube -
-
rgbimage
-
Load FITS rgbimage into rgb frame.
-
- Syntax: - -rgbimage <filename> - - Example: - $ds9 -rgbimage foo.fits - $cat foo.fits | ds9 -rgbimage -
-
rotate
-
Controls the rotation angle (in degrees) of the current - frame.<
- Syntax: - -rotate [<value>] -     [to <value>] -     [open|close] - - Example: - $ds9 -rotate 45 - $ds9 -rotate to 30 - $ds9 -rotate open - $ds9 -rotate close - -
samp
-
Configure SAMP protocol.
- Syntax: - -samp [yes|no|connect|disconnect] -     [broadcast [image|table]] -     [send [image|table] <application>] - - Example: - $ds9 -samp yes - $ds9 -samp connect - $ds9 -samp broadcast image - $ds9 -samp send image aladin
-
save
-
-
Save loaded image data of current frame as FITS.
- Syntax: - -save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice] - - Example: - $ds9 -save foo.fits - $ds9 -save fits foo.fits image - $ds9 -save fits foo.fits table - $ds9 -save fits foo.fits slice - $ds9 -save rgbimage foo.fits - $ds9 -save rgbcube foo.fits - $ds9 -save mecube foo.fits - $ds9 -save mosaic foo.fits - $ds9 -save mosaicimage foo.fits
-
saveimage
-
Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method.
- Syntax: - -saveimage[fits|eps|gif|tiff|jpeg|png]<filename> - -saveimage <filename>.jpeg [1-100] - -saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - $ds9 -saveimage ds9.tiff - $ds9 -saveimage jpeg ds9.jpeg 75 - -
scale
-
Controls the limits and color scale distribution.
- Syntax: - -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -     [log exp <value>] -     [datasec yes|no] -     [limits <minvalue> <maxvalue>] -     [mode minmax|<value>|zscale|zmax] -     [scope local|global] -     [match] -     [match limits] -     [lock [yes|no]] -     [lock limits [yes|no]] -     [open|close] - - Example: - $ds9 -scale linear - $ds9 -scale log exp 100 - $ds9 -scale datasec yes - $ds9 -scale histequ - $ds9 -scale limits 1 100 - $ds9 -scale mode zscale - $ds9 -scale mode 99.5 - $ds9 -scale scope local - $ds9 -scale match - $ds9 -scale match limits - $ds9 -scale lock yes - $ds9 -scale lock limits yes - $ds9 -scale open - $ds9 -scale close - -
shm
-
Load a shared memory segment into the current frame.
- Syntax: - -shm [<key> [<filename>]] -     [key <id> [<filename>]] -     [shmid <id> [<filename>]] -     [fits [key|shmid] <id> - [<filename>]] -     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]] -     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] -     [rgbcube [key|shmid] <id> - [<filename>]] -     [rgbimage [key|shmid] <id> - [<filename>]] -     [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -     [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - $ds9 -shm 102 - $ds9 -shm key 102 - $ds9 -shm shmid 102 foo - $ds9 -shm fits 100 foo - $ds9 -shm mosaicimage iraf key 100 foo - $ds9 -shm mosaicimage wcs key 100 foo - $ds9 -shm mosaicimage wcsa key 100 foo - $ds9 -shm mosaicimage wfpc2 key 100 foo - $ds9 -shm mosaic iraf key 100 foo - $ds9 -shm mosaic wcs key 100 foo - $ds9 -shm rgbcube key 100 foo - $ds9 -shm rgbimage key 100 foo - $ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] - $ds9 -shm array shmid 102 [dim=32,bitpix=-32] - -
sia
-
-
Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise.
- Syntax: - -sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [coordinate <ra> - <dec> <coordsys>] -     [<ref>] [crosshair] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [name <object>] -     [<ref>] [print] -     [<ref>] [retrieve] -     [<ref>] [save <filename>] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] - - Example: - $ds9 -sia 2mass - $ds9 -sia cancel - $ds9 -sia clear - $ds9 -sia close - $ds9 -sia coordinate 202.48 47.21 fk5 - $ds9 -sia crosshair - $ds9 -sia export tsv bar.tsv - $ds9 -sia name m51 - $ds9 -sia print - $ds9 -sia retrieve - $ds9 -sia save foo.xml - $ds9 -sia radius 1 degrees - $ds9 -sia sky fk5 - $ds9 -sia skyformat degrees - $ds9 -sia system wcs - $ds9 -sia update - - single -
Set display mode to single.
- Syntax: - -single - - Example: - $ds9 -single - -
skyview
-
Support for SkyView image server at HEASARC.
- Syntax: - -skyview [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [pixels <width> <height>] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey <survey>] -     [open|close] - - Example: - $ds9 -skyview - $ds9 -skyview m31 - $ds9 -skyview name m31 - $ds9 -skyview name clear - $ds9 -skyview 00:42:44.404 +41:16:08.78 - $ds9 -skyview size 60 60 arcmin - $ds9 -skyview pixels 600 600 - $ds9 -skyview save yes - $ds9 -skyview frame current - $ds9 -skyview update frame - $ds9 -skyview survey sdssi - $ds9 -skyview open - $ds9 -skyview close - -
sleep
-
Delays execution for specified number of seconds. Default is 1 - second.
- Syntax: - -sleep [#] - - Example: - $ds9 -sleep - $ds9 -sleep 2 - -
slice
- noslice
-
-
Indicates next files loaded are to treated as slices of a cube. - Can be disabled with noslice command.
-
- Syntax: - -slice <filename> - -noslice - - Example: - $ds9 -slice *.fits - $ds9 -noslice - -
smooth
-
Smooth current image or set smooth parameters.
-
Boxcar width =2*radius+1 - Tophat diameter =2*radius+1 - Gaussian diameter =2*radius+1,mean=0 - Elliptical Gaussian diameter =2*radius+1,mean=0 -
- Syntax: - -smooth [] -     [yes|no] -     [function boxcar|tophat|gaussian|elliptic] -     [radius <value>] -     [radiusminor <value>] -     [sigma <value>] -     [sigmaminor <value>] -     [angle <value>] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $ds9 -smooth - $ds9 -smooth yes - $ds9 -smooth function tophat - $ds9 -smooth radius 4 - $ds9 -smooth radiusminor 4 - $ds9 -smooth sigma 2.0 - $ds9 -smooth sigmaminor 2.0 - $ds9 -smooth angle 45 - $ds9 -smooth match - $ds9 -smooth lock yes - $ds9 -smooth open - $ds9 -smooth close - -
squared
-
Select squared scale function for the current frame.
- Syntax: - -squared - - Example: - $ds9 -squared -
sqrt
-
Select square soot scale function for the current frame.
- Syntax: - -sqrt - - Example: - $ds9 -sqrt -
source
-
Source TCL code from a file.
- Syntax: - -source <filename> - - Example: - $ds9 -source extensions.tcl - -
tcl
-
Execute one TCL command. Note: this a different behavior from - previous versions of DS9.
-
- Syntax: - -tcl <tcl command> - - Example: - $ds9 -tcl 'puts "Hello, World"'
-
threads
-
Set number of process threads for functions which are - multi-threaded.
- Syntax: - -threads # - - Example: - $ds9 -threads 8
-
- tiff
-
Load TIFF image into current frame.
-
- Syntax: - -tiff <filename> - - Example: - $ds9 -tiff foo.tiff - $cat foo.fits | ds9 -tiff - -
tile
-
Controls the tile display mode.
- Syntax: - -tile [] -     [yes|no] -     [mode grid|column|row] -     [grid] -     [grid mode automatic|manual] -     [grid direction x|y] -     [grid layout <col> <row>] -     [grid gap <pixels>] -     [row] -     [column] - - Example: - $ds9 -tile - $ds9 -tile yes - $ds9 -tile mode row - $ds9 -tile grid - $ds9 -tile grid mode manual - $ds9 -tile grid direction x - $ds9 -tile grid layout 5 5 - $ds9 -tile grid gap 10 - $ds9 -tile row - $ds9 -tile column -
title
-
Changes the display window title to the specified name.
- Syntax: - -title name - - Example: - $ds9 -title Voyager -
unix
-
Set the IRAF unix socket name, used by IRAF to communicate with - DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix - socket is defined.
- Syntax: - -unix name - - Example: - $ds9 -unix "/tmp/.IMT%d" -
unix_only
-
Only use the IRAF unix socket name. This is the same as -fifo - none -port 0.
- Syntax: - -unix_only - - Example: - $ds9 -unix_only - -
update
-
Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option.
- Syntax: - -update [] -     [# x1 y1 x2 y2] -     [now] -     [now # x1 y1 x2 y2] - - Example: - $ds9 -update - $ds9 -update 1 100 100 300 400 - $ds9 -update now - $ds9 -update now 1 100 100 300 400
-
url
-
Load FITS from URL into the current frame
- Syntax: - -url <url> - - Example: - $ds9 -url http://foo.bar.edu/foo.fits -
version
-
Returns the current version of DS9 and exits.
- Syntax: - -version - - Example: - $ds9 -version -
view
-
Controls the GUI and visible RGB frame color channels.
- Syntax: - -view [layout horizontal|vertical] -     [keyvalue <string>] -     [info yes|no] -     [panner yes|no] -     [magnifier yes|no] -     [buttons yes|no] -     [colorbar yes|no] -     [graph horizontal|vertical yes|no] -     [filename yes|no] -     [object yes|no] -     [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -     [units yes|no] -     [image|physical|wcs|wcsa...wcsz yes|no] -     [frame yes|no] -     [red yes|no] -     [green yes|no] -     [blue yes|no] - - Example: - $ds9 -view layout vertical - $ds9 -view keyvalue BITPIX - $ds9 -view info yes - $ds9 -view panner yes - $ds9 -view magnifier yes - $ds9 -view buttons yes - $ds9 -view colorbar yes - $ds9 -view graph horizontal yes - $ds9 -view filename yes - $ds9 -view object yes - $ds9 -view keyword yes - $ds9 -view minmax yes - $ds9 -view lowhigh yes - $ds9 -view wcsa yes - $ds9 -view frame yes - $ds9 -view red yes - $ds9 -view green yes - $ds9 -view blue yes - -
visual
-
Force DS9 to use the specified color visual. This argument MUST - be the first argument listed. Requires the visual be available.
- Syntax: - -visual [truecolor|truecolor8|truecolor16|truecolor24] - Example: - $ds9 -visual truecolor24 - -
vla
-
Support for VLA Sky Survey.
- Syntax: - -vla [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey first|stripe82] -     [open|close] - - Example: - $ds9 -vla - $ds9 -vla m31 - $ds9 -vla name m31 - $ds9 -vla name clear - $ds9 -vla 00:42:44.404 +41:16:08.78 - $ds9 -vla size 60 60 arcmin - $ds9 -vla save yes - $ds9 -vla frame current - $ds9 -vla update frame - $ds9 -vla survey stripe82 - $ds9 -vla open - $ds9 -vla close
-
vlss
-
Support for NRAO VLSS Sky Survey.
- Syntax: - -vlss [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $ds9 -vlss - $ds9 -vlss m31 - $ds9 -vlss name m31 - $ds9 -vlss name clear - $ds9 -vlss 00:42:44.404 +41:16:08.78 - $ds9 -vlss size 60 60 arcmin - $ds9 -vlss save yes - $ds9 -vlss frame current - $ds9 -vlss update frame - $ds9 -vlss open - $ds9 -nvess close -
vo
-
Invoke an connection to a Virtual Observatory site.
- Syntax: - -vo [method xpa|mime] -     [server <url>] -     [internal yes|no] -     [delay #] -     [<url>] -     [connect <url>] -     [disconnect <url>] -     [open|close] - - Example: - $ds9 -vo method xpa - $ds9 -vo server "http://foo.bar.edu/list.txt" - $ds9 -vo internal yes - $ds9 -vo delay 15 # keep-alive delay - $ds9 -vo chandra-ed - $ds9 -vo connect chandra-ed - $ds9 -vo disconnect chandra-ed - $ds9 -vo open - $ds9 -vo close - -
wcs
-
Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, a new WCS specification can be loaded and - used by the current image regardless of the WCS that was - contained in the image file. Please see WCS - for more information.
- Syntax: - -wcs [[system] wcs|wcsa...wcsz] -     [[sky] fk4|fk5|icrs|galactic|ecliptic] -     [[skyformat] degrees|sexagesimal] -     [align yes|no] -     [reset [#]] -     [replace [#] <filename>] -     [append [#] <filename>] -     [open|close] - - Example: - $ds9 -wcs wcs - $ds9 -wcs system wcs - $ds9 -wcs fk5 - $ds9 -wcs sky fk5 - $ds9 -wcs sexagesimal - $ds9 -wcs skyformat sexagesimal - $ds9 -wcs align yes - $ds9 -wcs reset - $ds9 -wcs reset 3 - $ds9 -wcs replace foo.wcs - $ds9 -wcs replace 3 foo.wcs - $ds9 -wcs append foo.wcs - $ds9 -wcs append 3 foo.wcs - $ds9 -wcs open - $ds9 -wcs close - -
web
-
Display specified URL in the web display.
- Syntax: - -web [] -     [<url>] -     [new <webname> <url>] -     [<webname>] [click - back|forward|stop|reload|#] -     [<webname>] [clear] -     [<webname>] [close] - - Example: - $ds9 -web www.cnn.com - $ds9 -web new www.cnn.com - $ds9 -web hvweb www.apple.com - $ds9 -web click back - $ds9 -web click 2 - $ds9 -web clear - $ds9 -web close - -
width
-
Set the width of the image display window. Use the geometry command to set the - overall width and height of the ds9 window.
- Syntax: - -width [<value>] - - Example: - $ds9 -width 512 - -
xpa
-
Configure XPA.
- Syntax: - -xpa [yes|no] -     [inet|local|unix|localhost] -     [noxpans] -     [connect] -     [disconnect] -     [info] - - Example: - $ds9 -xpa no - $ds9 -xpa local - $ds9 -xpa noxpans - $ds9 -xpa connect - $ds9 -xpa disconnect - $ds9 -xpa info - -
zmax
-
Set Scale Limits based on the IRAF algorithm and - maximum data value.
- Syntax: - -zmax - - Example: - $ds9 -zmax -
zscale
-
Set Scale Limits based on the IRAF algorithm.
- Syntax: - -zscale [] -     [contrast] -     [sample] -     [line] - - Example: - $ds9 -zscale - $ds9 -zscale contrast .25 - $ds9 -zscale sample 600 - $ds9 -zscale line 120 - -
zoom
-
Controls the current zoom value for the current frame.
- Syntax: - -zoom [<value>] -     [<value> <value>] -     [to <value>] -     [to <value> <value>] -     [in] -     [out] -     [to fit] -     [open|close] - - Example: - $ds9 -zoom 2 - $ds9 -zoom 2 4 - $ds9 -zoom to 4 - $ds9 -zoom to 2 4 - $ds9 -zoom in - $ds9 -zoom out - $ds9 -zoom to fit - $ds9 -zoom open - $ds9 -zoom close - -
- + + + + +Command Line Options + + +
Command Line Options
+
+
DS9 will process each command line option, one at a time, as the last step in the initialization process. Therefore, it is possible to use command line options as a little script. For example, the following command line option is used:
+$ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8 +
First DS9 is put in tile mode, then foo.fits is loaded. Then the colormap for foo.fits is changed to Heat and the scale changed to zscale. Next, bar.fits is loaded and the colormap for bar.fits is changed to I8.
+2mass +3d +about +align +analysis +array +asinh +background +backup +bin +blink +block +blue +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +dsssao +dsseso +dssstsci +envi +exit +export +fifo +fifo_only +fits +frame +geometry +gif +green +grid +header +height +help +histequ +iconify +inet_only +invert +iis +jpeg +language +linear +lock +log +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +msg +multiframe +nameserver +nan +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +port +port_only +pow +quit +raise +regions +red +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +samp +save +saveimage +scale +shm +sia +single +sinh +skyview +sleep +slice +smooth +squared +sqrt +source +tcl +threads +tiff +tile +title +unix +unix_only +update +url +version +view +visual +vla +vlss +vo +wcs +web +width +xpa +zmax +zoom +zscale
+
2mass
+
Support for 2MASS Digital Sky Survey.
+Syntax: +-2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +$ds9 -2mass +$ds9 -2mass m31 +$ds9 -2mass name m31 +$ds9 -2mass name clear +$ds9 -2mass 00:42:44.404 +41:16:08.78 +$ds9 -2mass size 60 60 arcmin +$ds9 -2mass save yes +$ds9 -2mass frame current +$ds9 -2mass update frame +$ds9 -2mass survey j +$ds9 -2mass open +$ds9 -2mass close +
3d
+
Support for 3D frame.
+Syntax: +-3d [] +    [view <az> <el>] +    [az <az>] +    [el <el>] +    [scale <scale>] +    [method mip|aip] +    [background none|azimuth|elevation] +    [border yes|no] +    [border color] +    [highlite yes|no] +    [highlite color] +    [compass yes|no] +    [compass color] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -3d # create new 3D frame +$ds9 -3d view 45 30 +$ds9 -3d az 45 +$ds9 -3d el 30 +$ds9 -3d scale 10 +$ds9 -3d method mip +$ds9 -3d background azimuth +$ds9 -3d border yes +$ds9 -3d border color red +$ds9 -3d highlite yes +$ds9 -3d highlite color red +$ds9 -3d compass yes +$ds9 -3d compass color red +$ds9 -3d match +$ds9 -3d lock yes +$ds9 -3d open +$ds9 -3d close
+
about
+
Get DS9 credits.
+Syntax: +-about + +Example: +$ds9 -about +
align
+
Controls the World Coordinate System alignment for the current frame.
+Syntax: +-align [yes|no] + +Example: +$ds9 -align yes +
analysis
+
Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message and display text in the text dialog window.
+Syntax: +-analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +$ds9 -analysis 0 # invoke first analysis task +$ds9 -analysis task 0 +$ds9 -analysis task foobar +$ds9 -analysis task {foo bar} +$ds9 -analysis my.ans +$ds9 -analysis load my.ans +$ds9 -analysis clear +$ds9 -analysis clear load my.ans +$ds9 -analysis message {This is a message} +$ds9 -analysis text {This is text} +
array
+
Load raw data array into current frame.
+Syntax: +-array <filename> [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +$ds9 -array foo.arr[dim=512,bitpix=-32,endian=little] +$cat foo.arr | ds9 -array -[dim=512,bitpix=-32,endian=little] +
asinh
+
Select ASINH scale function for the current frame.
+Syntax: +-asinh + +Example: +$ds9 -asinh
+
bg
+background
+
Set image background color.
+Syntax: +-bg <color> + +Example: +$ds9 -background red +$ds9 -bg red
+
backup
+
Create a backup save set.
+Syntax: +-backup <filename> + +Example: +$ds9 -backup ds9.bck
+
bin
+
Controls binning factor, binning buffer size, and binning function for binning FITS bin tables.
+Syntax: +-bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<value>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -bin about 4096 4096 +$ds9 -bin about center +$ds9 -bin buffersize 512 +$ds9 -bin cols detx dety +$ds9 -bin colsz detx dety time +$ds9 -bin factor 4 +$ds9 -bin factor 4 2 +$ds9 -bin depth 10 +$ds9 -bin filter 'pha > 5' +$ds9 -bin filter clear +$ds9 -bin function sum +$ds9 -bin in +$ds9 -bin out +$ds9 -bin to fit +$ds9 -bin match +$ds9 -bin lock yes +$ds9 -bin open +$ds9 -bin close +
blink
+
Blink mode parameters. Interval is in seconds.
+Syntax: +-blink [] +    [yes|no] +    [interval <value>] + +Example: +$ds9 -blink +$ds9 -blink yes +$ds9 -blink interval 1
+
block
+
Controls blocking parameters.
+Syntax: +-block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9-block4 +$ds9-block4 2 +$ds9-blockto 4 +$ds9-blockto 4 2 +$ds9-blockin +$ds9-blockout +$ds9-blockto fit +$ds9-blockmatch +$ds9-blocklock yes +$ds9-blockopen +$ds9-blockclose +
blue
+
For RGB frames, sets the current color channel to blue.
+Syntax: +-blue + +Example: +$ds9 -blue foo.fits +
catalog
+cat
+
Support for catalogs. The first three commands will create a new catalog search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +-catalog [new] +    [ned|simbad|denis|skybot] +    [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> <coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match <ref> <ref>] +    [<ref>] [match] +    [<ref>] [match error <value> degrees|arcmin|arcsec] +    [<ref>] [match function 1and2|1not2|2not1] +    [<ref>] [match return 1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> <xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send <application>] +    [<ref>] [save <filename>] +    [<ref>] [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>] +    [<ref>] [symbol [#] text|size|size2|units|angle <value>] +    [<ref>] [symbol shape circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box point|diamond point|cross point|x point|arrow point|boxcircle point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load <filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +$ds9 -catalog new +$ds9 -catalog 2mass +$ds9 -catalog cds 2mass +$ds9 -catalog cds "I/252" + +$ds9 -catalog load foo.xml +$ds9 -catalog import tsv foo.tsv + +$ds9 -catalog 202.48 47.21 fk5 +$ds9 -catalog allrows +$ds9 -catalog allcols +$ds9 -catalog cancel +$ds9 -catalog clear +$ds9 -catalog close +$ds9 -catalog crosshair +$ds9 -catalog dec DEC +$ds9 -catalog edit yes +$ds9 -catalog export tsv bar.tsv +$ds9 -catalog filter'\$Jmag>15' +$ds9 -catalog filter load foo.flt +$ds9 -catalog header +$ds9 -catalog location 500 +$ds9 -catalog match error 2 arcsec +$ds9 -catalog match function 1and2 +$ds9 -catalog match unique no +$ds9 -catalog match return 1only +$ds9 -catalog match # last two catalogs loaded +$ds9 -catalog match 2mass csc +$ds9 -catalog maxrows 2000 +$ds9 -catalog name m51 +$ds9 -catalog panto no +$ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag' +$ds9 -catalog print +$ds9 -catalog psky fk5 +$ds9 -catalog psystem wcs +$ds9 -catalog ra RA +$ds9 -catalog regions +$ds9 -catalog retrieve +$ds9 -catalog samp broadcast +$ds9 -catalog samp send aladin +$ds9 -catalog save foo.xml +$ds9 -catalog server sao +$ds9 -catalog show yes +$ds9 -catalog radius 1 degrees +$ds9 -catalog symbol condition '\$Jmag>15' +$ds9 -catalog symbol 2 shape "boxcircle point" +$ds9 -catalog symbol color red +$ds9 -catalog symbol font times +$ds9 -catalog symbol fontsize 14 +$ds9 -catalog symbol fontweight bold +$ds9 -catalog symbol fontslant italic +$ds9 -catalog symbol add +$ds9 -catalog symbol 2 remove +$ds9 -catalog symbol load foo.sym +$ds9 -catalog symbol save bar.sym +$ds9 -catalog sky fk5 +$ds9 -catalog skyformat degrees +$ds9 -catalog sort "Jmag" incr +$ds9 -catalog system wcs +$ds9 -catalog update +$ds9 -catalog x RA +$ds9 -catalog y DEC
+
cd
+
Sets the current working directory.
+Syntax: +cd [<directory>] + +Example: +$ds9 -cd /home/mrbill +
cmap
+
Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to 10 and bias value from 0 to 1.
+Syntax: +-cmap [<colormap>] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<contrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +$ds9 -cmap Heat +$ds9 -cmap load foo.sao +$ds9 -cmap save bar.sao +$ds9 -cmap invert yes +$ds9 -cmap 5 .5 +$ds9 -cmap tag load foo.tag +$ds9 -cmap tag save foo.tag +$ds9 -cmap tag delete +$ds9 -cmap open +$ds9 -cmap close +
colorbar
+
Controls colorbar parameters.
+Syntax: +-colorbar [] +    [yes|no] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] + +Example: +$ds9 -colorbar yes +$ds9 -colorbar vertical +$ds9 -colorbar numerics yes +$ds9 -colorbar space value +$ds9 -colorbar font times +$ds9 -colorbar fontsize 14 +$ds9 -colorbar fontweight bold +$ds9 -colorbar fontslant italic +$ds9 -colorbar size 20 +$ds9 -colorbar ticks 11 +$ds9 -colorbar match +$ds9 -colorbar lock yes
+
console
+
Display tcl console window.
+Syntax: +-console + +Example: +$ds9 -console +
contour
+
Controls contours in the current frame.
+Syntax: +-contour [] +    [yes|no] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> <skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> <width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +$ds9 -contour +$ds9 -contour yes +$ds9 -contour generate +$ds9 -contour clear +$ds9 -contour load ds9.ctr +$ds9 -contour save ds9.ctr +$ds9 -contour save ds9.ctr wcs fk5 +$ds9 -contour convert +$ds9 -contour load levels ds9.ctr +$ds9 -contour save levels ds9.lev +$ds9 -contour copy +$ds9 -contour paste +$ds9 -contour paste wcs red 2 no +$ds9 -contour color yellow +$ds9 -contour width 2 +$ds9 -contour dash yes +$ds9 -contour smooth 5 +$ds9 -contour method smooth +$ds9 -contour nlevels 10 +$ds9 -contour scale sqrt +$ds9 -contour log exp 1000 +$ds9 -contour mode zscale +$ds9 -contour scope local +$ds9 -contour limits 1 100 +$ds9 -contour levels 1 10 100 1000 +$ds9 -contour open +$ds9 -contour close +
crop
+
Set current image display area.
+Syntax: +-crop [<x> <y> <width> <height> [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3d zmin zmax <coordsys>] +    [open|close] + +Example: +$ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords +$ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs galactic arcsec +$ds9 foo.fits -crop match wcs +$ds9 foo.fits -crop lock wcs +$ds9 foo.fits -crop reset +$ds9 foo.fits -crop 3d .25 .5 wcs +$ds9 foo.fits -crop open +$ds9 foo.fits -crop close +
crosshair
+
Controls the current position of the crosshair in the current frame. DS9 is placed in crosshair mode when the crosshair is set.
+Syntax: +-crosshair [<x> <h> <coordsys> [<skyframe>]] +   [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$ds9 -crosshair 100 100 physical # set crosshair in physical +$ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords +$ds9 -crosshair 23:01:00 +58:52:51 wcs fk5 +$ds9 -crosshair match +$ds9 -crosshair lock wcs +
cube
+
Controls FITS cube.
+Syntax: +-cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +$ds9 -cube +$ds9 -cube play +$ds9 -cube last +$ds9 -cube 3 +$ds9 -cube 4.5 wcs +$ds9 -cube interval 2 +$ds9 -cube match wcs +$ds9 -cube lock wcs +$ds9 -cube order 123 +$ds9 -cube axes lock yes +$ds9 -cube open +$ds9 -cube close
+
cursor
+
Move mouse pointer or crosshair in image pixels in the current frame. Note, this will move selected Regions also.
+Syntax: +-cursor [<x> <h>] + +Example: +$ds9 -cursor 10 10 +
dsssao
+dss
+
Support for Digital Sky Survey at SAO.
+Syntax: +-dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -dsssao +$ds9 -dsssao m31 +$ds9 -dsssao name m31 +$ds9 -dsssao name clear +$ds9 -dsssao 00:42:44.404 +41:16:08.78 +$ds9 -dsssao size 60 60 arcmin +$ds9 -dsssao save yes +$ds9 -dsssao frame current +$ds9 -dsssao update frame +$ds9 -dsssao open +$ds9 -dsssao close +
dsseso
+
Support for Digital Sky Survey at ESO.
+Syntax: +-dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +$ds9 -dsseso +$ds9 -dsseso m31 +$ds9 -dsseso name m31 +$ds9 -dsseso name clear +$ds9 -dsseso 00:42:44.404 +41:16:08.78 +$ds9 -dsseso size 60 60 arcmin +$ds9 -dsseso save yes +$ds9 -dsseso frame current +$ds9 -dsseso update frame +$ds9 -dsseso survey DSS2-red +$ds9 -dsseso open +$ds9 -dsseso close
+
dssstsci
+
Support for Digital Sky Survey at STSCI.
+Syntax: +-dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +$ds9 -dssstsci +$ds9 -dssstsci m31 +$ds9 -dssstsci name m31 +$ds9 -dssstsci name clear +$ds9 -dssstsci 00:42:44.404 +41:16:08.78 +$ds9 -dssstsci size 60 60 arcmin +$ds9 -dssstsci save yes +$ds9 -dssstsci frame current +$ds9 -dssstsci update frame +$ds9 -dssstsci survey all +$ds9 -dssstsci open +$ds9 -dssstsci close
+
envi
+
Load an ENVI header and file. Optional parameter: array endian.
+Syntax: +-envi <header> [<filename>] + +Example: +$ds9 -envi foo.hdr +$ds9 -envi foo.hdr foo.bsq +
exit
+quit
+
Quits DS9.
+Syntax: +-exit +-quit + +Example: +$ds9 -exit +
export
+
Export loaded image data of current frame in specified image format, at native resolution, using current colormap and contrast/bias settings. NOTE: not scaling, rotation, or translation is applied. If no format specified, the file name extension is used to determine the output format. Optional parameters: jpeg quality (1-100) and tiff compression method.
+Syntax: +-export [array|nrrd|envi|gif|tiff|jpeg|png] <filename> +-export array <filename>[big|little|native] +-export nrrd <filename>[big|little|native] +-export envi <header> [<filename>][big|little|native] +-export <filename>.jpeg [1-100] +-export <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$ds9 -export array foo.arr little +$ds9 -export nrrd foo.nrrd little +$ds9 -export envi foo.hdr little +$ds9 -export envi foo.hdr foo.bsq little +$ds9 -export tiff foo.tiff jpeg +$ds9 -export jpeg foo.jpeg 75 +$ds9 -export png foo.png
+
fifo
+
Set the name of the IRAF input and output fifos. The default is /dev/imt1. These fifos are used by IRAF to communicate with DS9.
+Syntax: +-fifo name + +Example: +$ds9 -fifo /dev/imt1 +
fifo_only
+
Only use IRAF input and output fifos. Same as -port 0 -unix none.
+Syntax: +-fifo_only + +Example: +$ds9 -fifo_only +
fits
+
Load a FITS image into the current frame.
+Syntax: +-fits<filename> + +Example: +$ds9 -fits foo.fits +$ds9 -fits bar.fits[bin=detx,dety] +$cat foo.fits | ds9 -fits - +$cat bar.fits | ds9 -fits -[bin=detx,dety] +
frame
+
Controls frame functions. Frames may be created, deleted, reset, and centered. While return the current frame number. If you goto a frame that does not exists, it will be created. If the frame is hidden, it will be shown. The 'frameno' option is available for backward compatibility.
+Syntax: +-frame [center [#|all]] +    [clear [#|all]] +    [new [rgb]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$ds9 -frame center # center current frame +$ds9 -frame center 1 # center 'Frame1' +$ds9 -frame center all # center all frames +$ds9 -frame clear # clear current frame +$ds9 -frame new # create new frame +$ds9 -frame new rgb # create new rgb frame +$ds9 -frame delete # delete current frame +$ds9 -frame reset # reset current frame +$ds9 -frame refresh # refresh current frame +$ds9 -frame hide # hide current frame +$ds9 -frame show 1 # show frame 'Frame1' +$ds9 -frame move first # move frame to first in order +$ds9 -frame move back # move frame back in order +$ds9 -frame move forward # move frame forward in order +$ds9 -frame move last # move frame to last in order +$ds9 -frame first # goto first frame +$ds9 -frame prev # goto prev frame +$ds9 -frame next # goto next frame +$ds9 -frame last # goto last frame +$ds9 -frame frameno 4 # goto frame 'Frame4', create if needed +$ds9 -frame 3 # goto frame 'Frame3', create if needed +$ds9 -frame lock wcs
+
gif
+
Load GIF image into current frame.
+Syntax: +-gif <filename> + +Example: +$ds9 -gif foo.gif +$cat foo.gif | ds9 -gif - +
geometry
+
Define the initial window geometry. This includes all of the ds9 window, not just the image space. see X(1).
+Syntax: +-geometry value + +Example: +$ds9 -geometry 640x480 +
green
+
For RGB frames, sets the current color channel to green.
+Syntax: +-green + +Example: +$ds9 -green foo.fits +
grid
+
Controls coordinate grid. For grid numeric format syntax, click here.
+Syntax: +-grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +$ds9 -grid +$ds9 -grid yes +$ds9 -grid type analysis +$ds9 -grid system wcs +$ds9 -grid sky fk5 +$ds9 -grid skyformat degrees +$ds9 -grid grid yes +$ds9 -grid grid color red +$ds9 -grid grid width 2 +$ds9 -grid grid dash yes +$ds9 -grid grid gap1 10 +$ds9 -grid grid gap2 10 +$ds9 -grid grid gap3 10 +$ds9 -grid axes yes +$ds9 -grid axes color red +$ds9 -grid axes width 2 +$ds9 -grid axes dash yes +$ds9 -grid axes type exterior +$ds9 -grid axes origin lll +$ds9 -grid format1 d.2 +$ds9 -grid format2 d.2 +$ds9 -grid tickmarks yes +$ds9 -grid tickmarks color red +$ds9 -grid tickmarks width 2 +$ds9 -grid tickmarks dash yes +$ds9 -grid border yes +$ds9 -grid border color red +$ds9 -grid border width 2 +$ds9 -grid border dash yes +$ds9 -grid numerics yes +$ds9 -grid numerics font courier +$ds9 -grid numerics fontsize 12 +$ds9 -grid numerics fontweight bold +$ds9 -grid numerics fontslant italic +$ds9 -grid numerics color red +$ds9 -grid numerics gap1 10 +$ds9 -grid numerics gap2 10 +$ds9 -grid numerics gap3 10 +$ds9 -grid numerics type exterior +$ds9 -grid numerics vertical yes +$ds9 -grid title yes +$ds9 -grid title text {Hello World} +$ds9 -grid title def yes +$ds9 -grid title gap 10 +$ds9 -grid title font courier +$ds9 -grid title fontsize 12 +$ds9 -grid title fontweight bold +$ds9 -grid title fontslant italic +$ds9 -grid title color red +$ds9 -grid labels yes +$ds9 -grid labels text1 {Hello World} +$ds9 -grid labels text2 {Hello World} +$ds9 -grid labels def1 yes +$ds9 -grid labels def2 yes +$ds9 -grid labels gap1 10 +$ds9 -grid labels gap2 10 +$ds9 -grid labels font courier +$ds9 -grid labels fontsize 12 +$ds9 -grid labels fontweight bold +$ds9 -grid labels fontslant italic +$ds9 -grid labels color red +$ds9 -grid reset +$ds9 -grid load foo.grd +$ds9 -grid save foo.grd +$ds9 -grid open +$ds9 -grid close +
header
+
Display current fits header dialog. Optional extension number maybe specified.
+Syntax: +-header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +$ds9 -header +$ds9 -header 2 +$ds9 -header close +$ds9 -header save 1 foo.txt +
height
+
Set the height of the image display window. Use the geometry command to set the overall width and height of the ds9 window.
+Syntax: +-height [<value>] + +Example: +$ds9 -height 512 +
help
+
Display help information. To maintain backward compatibility, -help will display a brief help message and exit. --help will display all command line options within the built-in help facility.
+Syntax: +-help # Display brief help message and exit. +--help # Display command line options within help facility. +-? # Display command line options within help facility. + +Example: +$ds9 -help # Display brief help message and exit. +$ds9 --help # Display command line options within help facility +$ds9 -? # Display command line options within help facility. +
histequ
+
Select histogram equalization scale function for the current frame.
+Syntax: +-histequ + +Example: +$ds9 -histequ +
iconify
+
Toggles iconification.
+Syntax: +-iconify [] +    [yes|no] + +Example: +$ds9 -iconify +$ds9 -iconify yes
+
invert
+
Invert Colormap.
+Syntax: +-invert + +Example: +$ds9 -invert +
iis
+
Set IIS Filename. Optional mosaic number maybe supplied.
+Syntax: +-iis [filename <filename> [#]] + +Example: +$ds9 -iis filename foo.fits +$ds9 -iis filename bar.fits 4
+
jpeg
+
Load JPEG image into current frame.
+Syntax: +-jpeg <filename> + +Example: +$ds9 -jpeg foo.jpeg +$cat foo.jpeg | ds9 -jpeg -
+
language
+
Select current language.
+Syntax: +-language [locale|da|de|es|en|fr|ja|pt] + +Example: +$ds9 -language fr +
linear
+
Select linear scale function for the current frame.
+Syntax: +-linear + +Example: +$ds9 -linear +
lock
+
Lock all other frames to the current frame.
+Syntax: +-lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimits [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +$ds9 -lock frame wcs +$ds9 -lock crosshair wcs +$ds9 -lock crop wcs +$ds9 -lock slice wcs +$ds9 -lock bin yes +$ds9 -lock axes yes +$ds9 -lock scale yes +$ds9 -lock scalelimits yes +$ds9 -lock colorbar yes +$ds9 -lock block yes +$ds9 -lock smooth yes +$ds9 -lock 3d yes + log +
Select log scale function for the current frame.
+Syntax: +-log + +Example: +$ds9 -log +
lower
+
Lower in the window stacking order.
+Syntax: +-lower + +Example: +$ds9 -lower +
magnifier
+
Controls the magnifier settings.
+Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +$ds9 -magnifier color yellow +$ds9 -magnifier zoom 2 +$ds9 -magnifier cursor no +$ds9 -magnifier region no +
mask
+nomask
+
Controls mask parameters.
+Syntax: +-mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] +-nomask + +Example: +$ds9 -mask color red +$ds9 -mask mark zero +$ds9 -mask range 10 100 +$ds9 -mask transparency 50 +$ds9 -mask system wcs +$ds9 -mask clear +$ds9 -mask open +$ds9 -mask close +$ds9 -nomask +
match
+
Match all other frames to the current frame.
+Syntax: +-match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +$ds9 -match frame wcs +$ds9 -match crosshair wcs +$ds9 -match crop wcs +$ds9 -match slice wcs +$ds9 -match bin +$ds9 -match axes +$ds9 -match scale +$ds9 -match scalelimits +$ds9 -match colorbar +$ds9 -match block +$ds9 -match smooth +$ds9 -match 3d
+ mecube +
Load FITS multiple extension file as data cube.
+Syntax: +mecube <filename> + +Example: +$ds9 -mecube foo.fits +$cat foo.fits | ds9 -mecube -
+
minmax
+
This is how DS9 determines the min and max data values from the data. SCAN will scan all data.
+Syntax: +-minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +$ds9 -minmax scan +$ds9 -minmax mode scan +$ds9 -minmax interval 100 +
mode
+
Select the current mode.
+Syntax: +-mode [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + +Example: +$ds9 -mode crosshair
+
mosaic
+
Load FITS mosaic segment into current frame.
+Syntax: +-mosaic [wcs|wcsa...wcsz|iraf] <filename> + +Example: +$ds9 -mosaic foo.fits +$ds9 -mosaic wcs foo.fits +$cat foo.fits | ds9 -mosaic - +$cat foo.fits | ds9 -mosaic wcs - +
mosaicimage
+
Load FITS mosaic image into current frame.
+Syntax: +-mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename> + +Example: +$ds9 -mosaicimage foo.fits +$ds9 -mosaicimage wcs foo.fits +$cat foo.fits | ds9 -mosaicimage +$cat foo.fits | ds9 -mosaiimage wcs +
movie
+
Create a movie from snap shots of the DS9 window. A slice movie cycles though all slices of a cube. A frame movie cycles through all active frames. A 3d movie cycles through specified viewing angles. The default action is slice. Movie types are either MPEG or Animated GIF, with default MPEG. Optional parameters for 3d: number of frames, azimuth from/to, elevation from/to, slice from/to, oscillate/repeat times.
+Syntax: +-movie [slice|frame|3d] [mpeg|gif] <filename> +-movie 3d [mpeg|gif] <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>] + +Example: +$ds9 -movie slice mpeg ds9.mpg +$ds9 -movie frame gif ds9.gif +$ds9 -movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate 1
+
msg
+
Specify a directory of translation tables to be loaded.
+Syntax: +-msg <directory> + +Example: +$ds9 -msg $HOME/msgs
+
multiframe
+
Load FITS multiple extension file as multiple images.
+Syntax: +multiframe <filename> + +Example: +$ds9 -multiframe foo.fits +$cat foo.fits | ds9 -multiframe - +
nameserver
+
Support Name Server functions. Coordinates are in fk5.
+Syntax: +-nameserver [<object>] +    [name <object>] +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [open|close] + +Example: +$ds9 -nameserver m31 +$ds9 -nameserver name m31 +$ds9 -nameserver server ned-sao +$ds9 -nameserver skyformat sexagesimal +$ds9 -nameserver pan +$ds9 -nameserver crosshair +$ds9 -nameserver open +$ds9 -nameserver close +
nan
+
Set image not-a-number color.
+Syntax: +-nan <color> + +Example: +$ds9 -nan red
+
nrrd
+
Load an NRRD (Nearly Raw Raster Data) file.
+Syntax: +-nrrd <filename> + +Example: +$ds9 -nrrd foo.nrrd +$cat foo.nrrd | xpaset ds9 -nrrd- +
nvss
+
Support for NRAO VLA Sky Survey.
+Syntax: +-nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -nvss +$ds9 -nvss m31 +$ds9 -nvss name m31 +$ds9 -nvss name clear +$ds9 -nvss 00:42:44.404 +41:16:08.78 +$ds9 -nvss size 60 60 arcmin +$ds9 -nvss save yes +$ds9 -nvss frame current +$ds9 -nvss update frame +$ds9 -nvss open +$ds9 -nvess close +
orient
+
Controls the orientation of the current frame.
+Syntax: +-orient [none|x|y|xy] +    [open|close] + +Example: +$ds9 -orient xy +$ds9 -orient open +$ds9 -orient close +
pagesetup
+
Controls Page Setup options.
+Syntax: +-pagesetup [orient portrait|landscape] +    [scale <numberic>] +    [size letter|legal|tabloid|poster|a4] + +Example: +$ds9 -pagesetup orient portrait +$ds9 -pagesetup scale 50 +$ds9 -pagesetup size poster
+
pan
+
Controls the current image cursor location for the current frame.
+Syntax: +-pan [<x> <h> <coordsys> [<skyframe>]] # relative +    [to <x> <h> <coordsys> [<skyframe>]] # absolute +    [open|close] + +Example: +$ds9 -pan 200 200 image# pan relative +$ds9 -pan to 400 400 physical# pan to physical coords +$ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords +$ds9 -pan open +$ds9 -pan close
+
pixeltable
+
Display/Hide the pixel table.
+Syntax: +-pixeltable [] +    [yes|open] +    [no|close] + +Example: +$ds9 -pixeltable +$ds9 -pixeltable yes +$ds9 -pixeltable open +$ds9 -pixeltable close +
plot
+
Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is assumed to be a pair of coordinates, with optional error values. The follow are valid data descriptions:
+
xy    x and y coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y errors
+
To create a new plot, use the plot new command.
+Syntax: +# create new empty plot window +-plot [line|bar|scatter] + +# existing plot +-plot[[<plotname>] load <filename> xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig <filename>] +    [[<plotname>] saveconfig <filename>] +    [[<plotname>] pagesetup orient portrait|landscape] +    [[<plotname>] pagesetup size letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination printer|file] +    [[<plotname>] print command <command>] +    [[<plotname>] print filename <filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> +    [[<plotname>]export jpeg <filename>[1-100] +    [[<plotname>]export tiff <filename>[none|jpeg|packbits|deflate] + +# configure graph +-plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min <value>] +    [[<plotname>] axis x|y max <value>] +    [[<plotname>] axis x|y format <string>] +    [[<plotname>] background <value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position right|left|top|bottom] +    [[<plotname>] font title|labels|numbers font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize <value>] +    [[<plotname>] fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y <string>] +    [[<plotname>] barmode normal|stacked|aligned|overlap] + +# configure current dataset +-plot [[<plotname>] show yes|no] +   [[<plotname>] shape none|circle|square|diamond|plus|splus|scross|triangle|arrow] +   [[<plotname>] shape fill yes|no] +   [[<plotname>] shape color <value>] +   [[<plotname>] smooth step|linear|cubic|quadratic|catrom] +   [[<plotname>] color <value>] +   [[<plotname>] width <value>] +   [[<plotname>] dash yes|no] +   [[<plotname>] error yes|no] +   [[<plotname>] error color <value>] +   [[<plotname>] error cap yes|no] +   [[<plotname>] error width <value>] +   [[<plotname>] name <string>] + +# select current dataset +-plot [[<plotname>] select <value>] + +Example: +# create new empty plot window +$ds9 -plot bar + +# existing plot +$ds9 -plot load xy.dat +$ds9 -plot save foo.dat +$ds9 -plot clear +$ds9 -plot duplicate 1 +$ds9 -plot stats yes +$ds9 -plot list yes +$ds9 -plot loadconfig foo.plt +$ds9 -plot saveconfig foo.plt +$ds9 -plot pagesetup orient portrait +$ds9 -plot pagesetup size letter +$ds9 -plot print +$ds9 -plot print destination file +$ds9 -plot print command lp +$ds9 -plot print filename foo.ps +$ds9 -plot print color rgb +$ds9 -plot close + +# plot mode +$ds9 -plot mode pointer + +# export plot +$ds9 -plot export tiff foo.tiff jpeg +$ds9 -plot export jpeg foo.jpeg 75 +$ds9 -plot export png foo.png + +# configure plot +$ds9 -plot axis x grid yes +$ds9 -plot axis x log yes +$ds9 -plot axis x flip yes +$ds9 -plot axis x auto no +$ds9 -plot axis x min 1 +$ds9 -plot axis x max 100 +$ds9 -plot axis x format '%f' +$ds9 -plot background white +$ds9 -plot legend yes +$ds9 -plot legend position left +$ds9 -plot font numbers font times +$ds9 -plot font numbers size 12 +$ds9 -plot font numbers weight bold +$ds9 -plot font numbers slant italic +$ds9 -plot title 'This is a Title' +$ds9 -plot title x 'X Axis' +$ds9 -plot title y 'Y Axis' +$ds9 -plot title legend 'This is the Legend' + +# bar plot +$ds9 -plot barmode aligned + +# configure current dataset +$ds9 -plot show yes +$ds9 -plot shape circle +$ds9 -plot shape fill no +$ds9 -plot shape color cyan +$ds9 -plot smooth step +$ds9 -plot color red +$ds9 -plot width 2 +$ds9 -plot dash yes +$ds9 -plot error yes +$ds9 -plot error color red +$ds9 -plot error cap yes +$ds9 -plot error width 2 +$ds9 -plot name 'My Data' + +# select current dataset +$ds9 -plot select 2 +
png
+
Load PNG image into current frame.
+Syntax: +-png <filename> + +Example: +$ds9 png foo.png +$cat foo.png | ds9 -png - +
port
+
Set the IRAF port number, used by IRAF to communicate with DS9. The default is 5137, the standard IRAF port used by ximtool.
+Syntax: +-port number + +Example: +$ds9 -port 5137 +
port_only
+inet_only
+
Only use the IRAF port number. This is the same as -fifo none -unix none.
+Syntax: +-port_only + +Example: +$ds9 -port_only +
pow
+
Select power scale function for the current frame.
+Syntax: +-pow + +Example: +$ds9 -pow +
precision
+
Set region and coordinate output format precision.
+Syntax: +-precision <linear><degree><hms><dms><arcmin><arcsec> + +Example: +$ds9 -precision 8 10 4 3 5 3
+
prefs
+
Controls various preference settings.
+Syntax: +-prefs [clear] +    [irafalign yes|no] + +Example: +$ds9 -prefs clear +$ds9 -prefs irafalign yes +
preserve
+
Preserve the follow attributes while loading a new image.
+Syntax: +preserve [pan yes|no] +    [regions yes|no] + +Example: +$ds9 -preserve pan yes +$ds9 -preserve regions yes +
psprint
+
Invokes postscript printing. Please see print for further details.
+
print
+
Controls printing. Use print option to set printing options.
+Syntax: +-print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    [resolution72|screen|96|144|150|225|300|600|1200] + +Example: +$ds9 -print +$ds9 -print destination file +$ds9 -print command lp +$ds9 -print filename foo.ps +$ds9 -print color cmyk +$ds9 -print level 2 +$ds9 -print resolution 96 +
raise
+
Raise in the window stacking order.
+Syntax: +-raise + +Example: +$ds9 -raise +
regions
+
Controls regions in the current frame.
+Syntax: +-regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration <value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color <color> +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> <dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color <color>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> <int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] + +Example: +$ds9 -regions foo.reg +$ds9 -regions -format ciao bar.reg # load as ciao format +$ds9 -regions foo.fits # FITS regions files do not need a format specification +$ds9 -regions load foo.reg # load foo.reg into current frame +$ds9 -regions load all foo.reg # load foo.reg into all frames +$ds9 -regions load '*.reg'# expand *.reg and load into current frame +$ds9 -regions load all '*.reg' # expand *.reg and load into all frames +$ds9 -regions save foo.reg +$ds9 -regions list +$ds9 -regions list close +$ds9 -regions epsilon 5 +$ds9 -regions show yes +$ds9 -regions showtext no +$ds9 -regions centroid +$ds9 -regions centroid auto yes +$ds9 -regions centroid radius 10 +$ds9 -regions centroid iteration 20 +$ds9 -regions getinfo +$ds9 -regions move back +$ds9 -regions move front +$ds9 -regions select all +$ds9 -regions select none +$ds9 -regions select invert +$ds9 -regions delete all +$ds9 -regions delete select +$ds9 -regions format ds9 +$ds9 -regions system wcs +$ds9 -regions sky fk5 +$ds9 -regions skyformat degrees +$ds9 -regions strip yes +$ds9 -regions shape ellipse +$ds9 -regions color red +$ds9 -regions width 3 +$ds9 -regions edit yes +$ds9 -regions include +$ds9 -regions command "circle 100 100 20 # color=red" +$ds9 -regions composite +$ds9 -regions dissolve +$ds9 -regions template foo.tpl +$ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 +$ds9 -regions savetemplate foo.tpl +$ds9 -regions group new +$ds9 -regions group foo new +$ds9 -regions group foo update +$ds9 -regions group foo select +$ds9 -regions group foo color red +$ds9 -regions group foo copy +$ds9 -regions group foo delete +$ds9 -regions group foo cut +$ds9 -regions group foo font {times 14 bold} +$ds9 -regions group foo move 100 100 +$ds9 -regions group foo movefront +$ds9 -regions group foo moveback +$ds9 -regions group foo property delete no +$ds9 -regions copy +$ds9 -regions cut +$ds9 -regions paste wcs +$ds9 -regions undo +
red
+
For RGB frames, sets the current color channel to red.
+Syntax: +-red + +Example: +$ds9 -red foo.fits +
restore
+
Restore DS9 to a previous state from a backup save set.
+Syntax: +-restore <filename> + +Example: +$ds9 -restore ds9.bck
+
rgb
+
Create RGB frame and control RGB frame parameters.
+Syntax: +-rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +    [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth [yes|no]] +    [open|close] + +Example: +$ds9 -rgb # create new rgb frame +$ds9 -rgb red # set current channel to red +$ds9 -rgb channel red # set current channel to red +$ds9 -rgb view blue no # turn off blue channel +$ds9 -rgb system wcs # set rgb coordinate system +$ds9 -rgb lock wcs yes +$ds9 -rgb lock crop yes +$ds9 -rgb lock slice yes +$ds9 -rgb lock bin yes +$ds9 -rgb lock scale yes +$ds9 -rgb lock scalelimits yes +$ds9 -rgb lock colorbar yes +$ds9 -rgb lock block yes +$ds9 -rgb lock smooth yes +$ds9 -rgb open +$ds9 -rgb close
+
rgbarray
+
Load raw data array cube into rgb frame.
+Syntax: +-rgbarray <filename>[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +$ds9 -rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +$cat foo.arr | ds9 -rgbarray -[dim=512,zdim=3,bitpix=-32,endian=little]
+
rgbcube
+
Load FITS rgbcube into rgb frame.
+Syntax: +-rgbcube <filename> + +Example: +$ds9 -rgbcube foo.fits +$cat foo.fits | ds9 -rgbcube -
+
rgbimage
+
Load FITS rgbimage into rgb frame.
+Syntax: +-rgbimage <filename> + +Example: +$ds9 -rgbimage foo.fits +$cat foo.fits | ds9 -rgbimage -
+
rotate
+
Controls the rotation angle (in degrees) of the current frame.<
+Syntax: +-rotate [<value>] +    [to <value>] +    [open|close] + +Example: +$ds9 -rotate 45 +$ds9 -rotate to 30 +$ds9 -rotate open +$ds9 -rotate close +
samp
+
Configure SAMP protocol.
+Syntax: +-samp [yes|no|connect|disconnect] +    [broadcast [image|table]] +    [send [image|table] <application>] + +Example: +$ds9 -samp yes +$ds9 -samp connect +$ds9 -samp broadcast image +$ds9 -samp send image aladin
+
save
+
Save loaded image data of current frame as FITS.
+Syntax: +-save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] <filename> [image|table|slice] + +Example: +$ds9 -save foo.fits +$ds9 -save fits foo.fits image +$ds9 -save fits foo.fits table +$ds9 -save fits foo.fits slice +$ds9 -save rgbimage foo.fits +$ds9 -save rgbcube foo.fits +$ds9 -save mecube foo.fits +$ds9 -save mosaic foo.fits +$ds9 -save mosaicimage foo.fits
+
saveimage
+
Create a snap shot of the current DS9 window and save in specified image format. If no format specified, the file name extension is used to determine the output format. Optional parameters: jpeg quality (1-100) and tiff compression method.
+Syntax: +-saveimage[fits|eps|gif|tiff|jpeg|png]<filename> +-saveimage <filename>.jpeg [1-100] +-saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$ds9 -saveimage ds9.tiff +$ds9 -saveimage jpeg ds9.jpeg 75 +
scale
+
Controls the limits and color scale distribution.
+Syntax: +-scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +$ds9 -scale linear +$ds9 -scale log exp 100 +$ds9 -scale datasec yes +$ds9 -scale histequ +$ds9 -scale limits 1 100 +$ds9 -scale mode zscale +$ds9 -scale mode 99.5 +$ds9 -scale scope local +$ds9 -scale match +$ds9 -scale match limits +$ds9 -scale lock yes +$ds9 -scale lock limits yes +$ds9 -scale open +$ds9 -scale close +
shm
+
Load a shared memory segment into the current frame.
+Syntax: +-shm [<key> [<filename>]] +    [key <id> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> [<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] <id> [<filename>]] +    [rgbcube [key|shmid] <id> [<filename>]] +    [rgbimage [key|shmid] <id> [<filename>]] +    [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] +    [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] + +Example: +$ds9 -shm 102 +$ds9 -shm key 102 +$ds9 -shm shmid 102 foo +$ds9 -shm fits 100 foo +$ds9 -shm mosaicimage iraf key 100 foo +$ds9 -shm mosaicimage wcs key 100 foo +$ds9 -shm mosaicimage wcsa key 100 foo +$ds9 -shm mosaicimage wfpc2 key 100 foo +$ds9 -shm mosaic iraf key 100 foo +$ds9 -shm mosaic wcs key 100 foo +$ds9 -shm rgbcube key 100 foo +$ds9 -shm rgbimage key 100 foo +$ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32] +$ds9 -shm array shmid 102 [dim=32,bitpix=-32] +
sia
+
Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +-sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> <coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +$ds9 -sia 2mass +$ds9 -sia cancel +$ds9 -sia clear +$ds9 -sia close +$ds9 -sia coordinate 202.48 47.21 fk5 +$ds9 -sia crosshair +$ds9 -sia export tsv bar.tsv +$ds9 -sia name m51 +$ds9 -sia print +$ds9 -sia retrieve +$ds9 -sia save foo.xml +$ds9 -sia radius 1 degrees +$ds9 -sia sky fk5 +$ds9 -sia skyformat degrees +$ds9 -sia system wcs +$ds9 -sia update + single +
Set display mode to single.
+Syntax: +-single + +Example: +$ds9 -single +
skyview
+
Support for SkyView image server at HEASARC.
+Syntax: +-skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +$ds9 -skyview +$ds9 -skyview m31 +$ds9 -skyview name m31 +$ds9 -skyview name clear +$ds9 -skyview 00:42:44.404 +41:16:08.78 +$ds9 -skyview size 60 60 arcmin +$ds9 -skyview pixels 600 600 +$ds9 -skyview save yes +$ds9 -skyview frame current +$ds9 -skyview update frame +$ds9 -skyview survey sdssi +$ds9 -skyview open +$ds9 -skyview close +
sleep
+
Delays execution for specified number of seconds. Default is 1 second.
+Syntax: +-sleep [#] + +Example: +$ds9 -sleep +$ds9 -sleep 2 +
slice
+noslice
+
Indicates next files loaded are to treated as slices of a cube. Can be disabled with noslice command.
+Syntax: +-slice <filename> +-noslice + +Example: +$ds9 -slice *.fits +$ds9 -noslice +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter =2*radius+1,mean=0
+Syntax: +-smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian|elliptic] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$ds9 -smooth +$ds9 -smooth yes +$ds9 -smooth function tophat +$ds9 -smooth radius 4 +$ds9 -smooth radiusminor 4 +$ds9 -smooth sigma 2.0 +$ds9 -smooth sigmaminor 2.0 +$ds9 -smooth angle 45 +$ds9 -smooth match +$ds9 -smooth lock yes +$ds9 -smooth open +$ds9 -smooth close +
squared
+
Select squared scale function for the current frame.
+Syntax: +-squared + +Example: +$ds9 -squared +
sqrt
+
Select square soot scale function for the current frame.
+Syntax: +-sqrt + +Example: +$ds9 -sqrt +
source
+
Source TCL code from a file.
+Syntax: +-source <filename> + +Example: +$ds9 -source extensions.tcl +
tcl
+
Execute one TCL command. Note: this a different behavior from previous versions of DS9.
+Syntax: +-tcl <tcl command> + +Example: +$ds9 -tcl 'puts "Hello, World"'
+
threads
+
Set number of process threads for functions which are multi-threaded.
+Syntax: +-threads # + +Example: +$ds9 -threads 8
+
+tiff
+
Load TIFF image into current frame.
+Syntax: +-tiff <filename> + +Example: +$ds9 -tiff foo.tiff +$cat foo.fits | ds9 -tiff - +
tile
+
Controls the tile display mode.
+Syntax: +-tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +$ds9 -tile +$ds9 -tile yes +$ds9 -tile mode row +$ds9 -tile grid +$ds9 -tile grid mode manual +$ds9 -tile grid direction x +$ds9 -tile grid layout 5 5 +$ds9 -tile grid gap 10 +$ds9 -tile row +$ds9 -tile column +
title
+
Changes the display window title to the specified name.
+Syntax: +-title name + +Example: +$ds9 -title Voyager +
unix
+
Set the IRAF unix socket name, used by IRAF to communicate with DS9. The default is /tmp/.IMT%d, so that the standard IRAF unix socket is defined.
+Syntax: +-unix name + +Example: +$ds9 -unix "/tmp/.IMT%d" +
unix_only
+
Only use the IRAF unix socket name. This is the same as -fifo none -port 0.
+Syntax: +-unix_only + +Example: +$ds9 -unix_only +
update
+
Updates the current frame or region of frame. In the second form, the first argument is the number of the fits HDU (starting with 1) and the remaining args are a bounding box in IMAGE coordinates. By default, the screen is updated the next available idle cycle. However, you may force an immediate update by specifying the NOW option.
+Syntax: +-update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: +$ds9 -update +$ds9 -update 1 100 100 300 400 +$ds9 -update now +$ds9 -update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+Syntax: +-url <url> + +Example: +$ds9 -url http://foo.bar.edu/foo.fits +
version
+
Returns the current version of DS9 and exits.
+Syntax: +-version + +Example: +$ds9 -version +
view
+
Controls the GUI and visible RGB frame color channels.
+Syntax: +-view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no] +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +$ds9 -view layout vertical +$ds9 -view keyvalue BITPIX +$ds9 -view info yes +$ds9 -view panner yes +$ds9 -view magnifier yes +$ds9 -view buttons yes +$ds9 -view colorbar yes +$ds9 -view graph horizontal yes +$ds9 -view filename yes +$ds9 -view object yes +$ds9 -view keyword yes +$ds9 -view minmax yes +$ds9 -view lowhigh yes +$ds9 -view wcsa yes +$ds9 -view frame yes +$ds9 -view red yes +$ds9 -view green yes +$ds9 -view blue yes +
visual
+
Force DS9 to use the specified color visual. This argument MUST be the first argument listed. Requires the visual be available.
+Syntax: +-visual [truecolor|truecolor8|truecolor16|truecolor24] +Example: +$ds9 -visual truecolor24 +
vla
+
Support for VLA Sky Survey.
+Syntax: +-vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +$ds9 -vla +$ds9 -vla m31 +$ds9 -vla name m31 +$ds9 -vla name clear +$ds9 -vla 00:42:44.404 +41:16:08.78 +$ds9 -vla size 60 60 arcmin +$ds9 -vla save yes +$ds9 -vla frame current +$ds9 -vla update frame +$ds9 -vla survey stripe82 +$ds9 -vla open +$ds9 -vla close
+
vlss
+
Support for NRAO VLSS Sky Survey.
+Syntax: +-vlss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$ds9 -vlss +$ds9 -vlss m31 +$ds9 -vlss name m31 +$ds9 -vlss name clear +$ds9 -vlss 00:42:44.404 +41:16:08.78 +$ds9 -vlss size 60 60 arcmin +$ds9 -vlss save yes +$ds9 -vlss frame current +$ds9 -vlss update frame +$ds9 -vlss open +$ds9 -nvess close +
vo
+
Invoke an connection to a Virtual Observatory site.
+Syntax: +-vo [method xpa|mime] +    [server <url>] +    [internal yes|no] +    [delay #] +    [<url>] +    [connect <url>] +    [disconnect <url>] +    [open|close] + +Example: +$ds9 -vo method xpa +$ds9 -vo server "http://foo.bar.edu/list.txt" +$ds9 -vo internal yes +$ds9 -vo delay 15 # keep-alive delay +$ds9 -vo chandra-ed +$ds9 -vo connect chandra-ed +$ds9 -vo disconnect chandra-ed +$ds9 -vo open +$ds9 -vo close +
wcs
+
Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info panel, compass, grid, and alignment will be modified accordingly. Also, a new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. Please see WCS for more information.
+Syntax: +-wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +$ds9 -wcs wcs +$ds9 -wcs system wcs +$ds9 -wcs fk5 +$ds9 -wcs sky fk5 +$ds9 -wcs sexagesimal +$ds9 -wcs skyformat sexagesimal +$ds9 -wcs align yes +$ds9 -wcs reset +$ds9 -wcs reset 3 +$ds9 -wcs replace foo.wcs +$ds9 -wcs replace 3 foo.wcs +$ds9 -wcs append foo.wcs +$ds9 -wcs append 3 foo.wcs +$ds9 -wcs open +$ds9 -wcs close +
web
+
Display specified URL in the web display.
+Syntax: +-web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +$ds9 -web www.cnn.com +$ds9 -web new www.cnn.com +$ds9 -web hvweb www.apple.com +$ds9 -web click back +$ds9 -web click 2 +$ds9 -web clear +$ds9 -web close +
width
+
Set the width of the image display window. Use the geometry command to set the overall width and height of the ds9 window.
+Syntax: +-width [<value>] + +Example: +$ds9 -width 512 +
xpa
+
Configure XPA.
+Syntax: +-xpa [yes|no] +    [inet|local|unix|localhost] +    [noxpans] +    [connect] +    [disconnect] +    [info] + +Example: +$ds9 -xpa no +$ds9 -xpa local +$ds9 -xpa noxpans +$ds9 -xpa connect +$ds9 -xpa disconnect +$ds9 -xpa info +
zmax
+
Set Scale Limits based on the IRAF algorithm and maximum data value.
+Syntax: +-zmax + +Example: +$ds9 -zmax +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+Syntax: +-zscale [] +    [contrast] +    [sample] +    [line] + +Example: +$ds9 -zscale +$ds9 -zscale contrast .25 +$ds9 -zscale sample 600 +$ds9 -zscale line 120 +
zoom
+
Controls the current zoom value for the current frame.
+Syntax: +-zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +$ds9 -zoom 2 +$ds9 -zoom 2 4 +$ds9 -zoom to 4 +$ds9 -zoom to 2 4 +$ds9 -zoom in +$ds9 -zoom out +$ds9 -zoom to fit +$ds9 -zoom open +$ds9 -zoom close +
+ diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index acc6300..7860b60 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -1,3244 +1,2954 @@ - - - - - SAMP - - -
SAMP
-
-
SAMP is a messaging protocol that enables astronomy software - tools to interoperate and communicate. Broadly speaking, SAMP is - an abstract framework for loosely-coupled, asynchronous, - RPC-like and/or event-based communication, based on a central - service providing multi-directional publish/subscribe message - brokering. The message semantics are extensible and use - structured but weakly-typed data. For more information on SAMP, - please click here.
-
The samp implementation for DS9 is based on the XPA model with 2 private calls:
- ds9.get -     Arguments -         cmd (string) required -         url (string) optional -     Returned value -         OK (samp.result map) -             value - (string) optional -             -     url (string) optional -         ERROR (samp.error map) -             - samp.errortxt (string) - - ds9.set -     Arguments -         cmd (string) required -         url (string) optional -     Returned value -         OK -         ERROR (samp.error map) -             - samp.errortxt (string) - -
ds9.set maybe called via notification, call and - call/wait. ds9.get can only be called via call and - call/wait. Most of the ds9.get calls return a value - string, but a few will return a url instead.
- 2mass - 3d - about - analysis - array - background - backup - bin - blink - block - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - data - dsssao - dsseso - dssstsci - envi - exit - export - file - fits - frame - gif - grid - header - height - iconify - iexam - iis - jpeg - lock - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - multiframe - nameserver - nan - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - quit - raise - regions - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - samp - save - saveimage - scale - shm - sia - single - skyview - sleep - smooth - source - tcl - threads - tiff - tile - update - url - version - view - vla - vlss - vo - wcs - web - width - zscale - zoom - -
2mass
-
Support for 2MASS Digital Sky Survey.
- Syntax: - 2mass [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey j|h|k] -     [open|close] - - Example: - string value = ds9.get(string cmd) - 2mass name - 2mass coord - 2mass size - 2mass save - 2mass frame - 2mass survey - - ds9.set(string cmd) - 2mass - 2mass m31 - 2mass name m31 - 2mass name clear - 2mass 00:42:44.404 +41:16:08.78 - 2mass size 60 60 arcmin - 2mass save yes - 2mass frame current - 2mass update frame - 2mass survey j - 2mass open - 2mass close - -
3d
-
Support for 3D frame.
- Syntax: - 3d [] -    [view <az> <el>] -    [az <az>] -    [el <el>] -    [scale <scale>] -    [method mip|aip] -    [background none|azimuth|elevation] -    [border yes|no] -    [border color <color>] -    [highlite yes|no] -    [hightlite color <color>] -    [compass yes|no] -    [compass color <color>] -    [match] -    [lock [yes|no]] -    [open|close] - - Example: - string value = ds9.get(string cmd) - 3d view - 3d az - 3d el - 3d scale - 3d method - 3d background - 3d border - 3d border color - 3d highlite - 3d highlite color - 3d compass - 3d compass color - 3d lock - - ds9.set(string cmd) - 3d # create new 3D frame - 3d view 45 30 - 3d az 45 - 3d el 30 - 3d scale 10 - 3d method mip - 3d background azimuth - 3d border yes - 3d border color red - 3d highlite yes - 3d highlite color red - 3d compass yes - 3d compass color red - 3d match - 3d lock yes - 3d open - 3d close - -
about
-
Get DS9 credits.
- Syntax: - about - - Example: - string value = ds9.get(string cmd) - about - -
align
-
Controls the World Coordinate System alignment for the current - frame.
- Syntax: - align [] -     [yes|no] - - Example: - string value = ds9.get(string cmd) - align - - ds9.set(string cmd) - align yes
-
analysis
-
Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window.
- Syntax: - analysis [<task number>] -     [<filename>] -     [task <task number>|<task name>] -     [load <filename>] -     [clear] -     [clear][load <filename>] -     [message ok|okcancel|yesno <message>] -     [entry <message>] -     [text] - - Example: - string value = ds9.get(string cmd) - analysis - analysis task - analysis entry {Please enter something} - analysis entry okcancel {Hello World} - - ds9.set(string cmd) - analysis 0 # invoke first analysis task - analysis task 0 - analysis task foobar - analysis task {foo bar} - analysis my.ans - analysis load my.ans - analysis clear - analysis clear load my.ans - analysis message {This is a message} - analysis text {this is text} - - ds9.set(string cmd, string url) - analysis load - analysis text
- -
array
-
Load raw data array into current frame.
-
- Syntax: - array [native|little|big] - array [new|mask] -[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - string url = ds9.get(string cmd) - array - array little - - ds9.set(string command, string url) - array foo.arr[dim=512,bitpix=-32,endian=little] - array new foo.arr[dim=512,bitpix=-32,endian=little] - array mask foo.arr[dim=512,bitpix=-32,endian=little] - -
bg
- background
-
Set image background color.
- Syntax: - bg <color> - - Example: - string url = ds9.get(string cmd) - bg - - ds9.set(string cmd) - bg red
-
backup
-
Create a backup save set.
- Syntax: - backup <filename> - - Example: - ds9.set(string cmd) - backup ds9.bck
-
bin
-
Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility.
- Syntax: - bin [about <x> <y>] -     [about center] -     [buffersize <value>] -     [cols <x> <y>] -     [colsz <x> <y> <z>] -     [factor <value> [<vector>]] -     [depth <value>] -     [filter <string>] -     [filter clear] -     [function average|sum] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - bin about - bin buffersize - bin cols - bin factor - bin depth - bin filter - bin function - bin smooth - bin smooth function - bin smooth radius - bin lock - - ds9.set(string cmd) - bin about 4096 4096 - bin about center - bin buffersize 512 - bin cols detx dety - bin colsz detx dety time - bin factor 4 - bin factor 4 2 - bin depth 10 - bin filter 'pha > 5' - bin filter clear - bin function sum - bin in - bin out - bin to fit - bin match - bin lock yes - bin open - bin close - -
blink
-
Blink mode parameters. Interval is in seconds.
-
- Syntax: - blink [] -     [yes|no] -     [interval <value>] - - Example: - string value = ds9.get(string cmd) - blink - blink interval - - ds9.set(string cmd) - blink - blink yes - blink interval 1
-
block
-
Controls blocking parameters.
- Syntax: - block[<value>] -     [<value> <value>] -     [to <value>] -     [to <value> <value>] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - block - block lock - - ds9.set(string cmd) - block4 - block4 2 - blockto 4 - blockto 4 2 - blockin - blockout - blockto fit - blockmatch - blocklock yes - blockopen - blockclose - -
catalog
- cat
-
-
Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise.
- Syntax: - catalog [new] -     [ned|simbad|denis|skybot] -     -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -     [2mass|iras] -     [csc|xmm|rosat] -     [first|nvss] -     [chandralog|cfhtlog|esolog|stlog|xmmlog] -     [cds <catalogname>] -     [cds <catalogid>] - -     [load <filename>] -     [import sb|tsv <filename>] - -     [<ref>] [<ra> <dec> - <coordsys>] -     [<ref>] [allcols] -     [<ref>] [allrows] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [crosshair] -     [<ref>] [dec <col>] -     [<ref>] [edit yes|no] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [filter <string>] -     [<ref>] [filter load <filename>] -     [<ref>] [header] -     [<ref>] [location <code>] -     [<ref>] [match] -     [<ref>] [match <ref> <ref>] -     [<ref>] [match error <value> - degrees|arcmin|arcsec] -     [<ref>] [match function - 1and2|1not2|2not1] -     [<ref>] [match return - 1and2|1only|2only] -     [<ref>] [match unique yes|no] -     [<ref>] [maxrows <number>] -     [<ref>] [name <object>] -     [<ref>] [panto yes|no] -     [<ref>] [plot <xcol> <ycol> - <xerrcol> <yerrcol>] -     [<ref>] [print] -     [<ref>] [psky <skyframe>] -     [<ref>] [psystem <coordsys>] -     [<ref>] [ra <col>] -     [<ref>] [regions] -     [<ref>] [retrieve] -     [<ref>] [samp] -     [<ref>] [samp broadcast] -     [<ref>] [samp send <application>] -     [<ref>] [save <filename>] -     [<ref>] - [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -     [<ref>] [show yes|no] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [sort <col> incr|decr] -     [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -     [<ref>] [symbol [#] - text|size|size2|units|angle <value>] -     [<ref>] [symbol shape - circle|ellipse|box|text|point] -     [<ref>] [symbol shapecircle point|box - point|diamond point|cross point|x point|arrow point|boxcircle - point] -     [<ref>] [symbol add| [#] remove] -     [<ref>] [symbol save|load - <filename>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] -     [<ref>] [x <col>] -     [<ref>] [y <col>] - - Example: - string value = ds9.get(string cmd) - catalog - catalog header - - ds9.set(string cmd) - catalog new - catalog 2mass - catalog cds 2mass - catalog cds{I/252} - - catalog load foo.xml - catalog import tsv foo.tsv - -catalog coordinate 202.48 47.21 fk5 - catalog allrows - catalog allcols - catalog cancel - catalog clear - catalog close - catalog crosshair - catalog dec DEC - catalog edit yes - catalog export tsv bar.tsv - catalog filter {$Jmag>10} - catalog filter load foo.flt - catalog header - catalog location 500 - catalog match error 2 arcsec - catalog match function 1and2 - catalog match unique no - catalog match return 1only - catalog match # last two catalogs loaded - catalog match 2mass csc - catalog maxrows 2000 - catalog name m51 - catalog panto no - catalog plot{$Jmag} {$Hmag} {$e_Jmag} {$e_Hmag} - catalog print - catalog psky fk5 - catalog psystem wcs - catalog ra RA - catalog regions - catalog retrieve - catalog samp broadcast - catalog samp send aladin - catalog save foo.xml - catalog server sao - catalog show yes - catalog radius 1 degrees - catalog symbol condition{$Jmag>15} - catalog symbol 2 shape{boxcircle point} - catalog symbol color red - catalog symbol font times - catalog symbol fontsize 14 - catalog symbol fontweight bold - catalog symbol fontslant italic - catalog symbol add - catalog symbol 2 remove - catalog symbol load foo.sym - catalog symbol save bar.sym - catalog sky fk5 - catalog skyformat degrees - catalog sort {Jmag} incr - catalog system wcs - catalog update - catalog x RA - catalog y DEC - -
cd
-
Sets/Returns the current working directory.
- Syntax: - cd [<directory>] - - Example: - string value = ds9.get(string cmd) - cd - - ds9.set(string cmd) - cd /home/mrbill - -
cmap
-
Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1.
- Syntax: - cmap [<colormap>] -     [file] -     [load <filename>] -     [save <filename>] -     [invert yes|no] -     [<constrast> <bias>] -     [tag [load|save] <filename>] -     [tag delete] -     [open|close] - - Example: - string value = ds9.get(string cmd) - cmap - cmap file - cmap invert - cmap value - - ds9.set(string cmd) - cmap Heat - cmap load foo.sao - cmap save bar.sao - cmap invert yes - cmap 5 .5 - cmap tag load foo.tag - cmap tag save foo.tag - cmap tag delete - cmap open - cmap close - -
colorbar
-
Controls colorbar parameters.
- Syntax: - colorbar [] -     [yes|no] -     [orientation] -     [horizontal|vertical] -     [numerics yes|no] -     [space value|distance] -     [font times|helvetica|courier] -     [fontsize <value>] -     [fontweight normal|bold] -     [fontslant roman|italic] -     [size] -     [ticks] -     [match] -     [lock [yes|no]] - - Example: - string value = ds9.get(string cmd) - colorbar - colorbar orientation - colorbar numerics - colorbar space - colorbar font - colorbar fontsize - colorbar fontweight - colorbar fontslant - colorbar size - colorbar ticks - colorbar lock - - ds9.set(string cmd) - colorbar yes - colorbar vertical - colorbar numerics yes - colorbar space value - colorbar font times - colorbar fontsize 14 - colorbar fontwieght bold - colorbar fontslant italic - colorbar size 20 - colorbar ticks 11 - colorbar match - colorbar lock yes
-
console
-
Display tcl console window.
- Syntax: - -console - - Example: - ds9.set(string cmd) - console - -
contour
-
Controls contours in the current frame.
- Syntax: - contour [] -     [yes|no] -     [<coordsys> [<skyframe>]] -     [clear] -     [generate] -     [load <filename>] -     [save <filename> [<coordsys> - <skyframe>]] -     [convert] -     [load levels <filename>] -     [save levels <filename>] -     [copy] -     [paste [<coordsys> <color> - <width> yes|no]] -     [color <color>] -     [width <width>] -     [dash yes|no] -     [smooth <smooth>] -     [method block|smooth] -     [nlevels <number of levels>] -     [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -     [scale log exp <value>] -     [mode minmax|<value>|zscale|zmax] -     [scope global|local] -     [limits <min> <max>] -     [levels <value value value...>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - contour -contour wcs fk5 - contour color - contour width - contour dash - contour smooth - contour method - contour nlevels - contour scale - contour log exp - contour mode - contour scope - contour limits - contour levels - - ds9.set(string cmd) - contour - contour yes - contour clear - contour generate - contour load ds9.ctr - contour save ds9.con - contour save ds9.con wcs fk5 - contour convert - contour load levels ds9.ctr - contour save levels ds9.lev - contour copy - contour paste - contour paste wcs red 2 no - contour color yellow - contour width 2 - contour dash yes - contour smooth 5 - contour method smooth - contour nlevels 10 - contour scale sqrt - contour log exp 1000 - contour mode zscale - contour scope local - contour limits 1 100 - contour levels 1 10 100 1000 - contour open - contour close - -
crop
-
Set current image display area.
- Syntax: - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -     [match <coordsys>] -     [lock <coordsys>|none] -     [reset] -     [3dzmin zmax <coordsys>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - crop # get crop in physical coords - crop wcs galactic sexagesimal arcsec - crop lock - - ds9.set(string cmd) - crop 40 30 10 20 # set crop in physical coords - crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs - galactic arcsec - crop match wcs - crop lock wcs - crop reset - crop 3d .25 .5 wcs - crop open - crop close - -
crosshair
-
Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set.
- Syntax: - crosshair [<x> <y> <coordsys> - [<skyframe>]] -     [match <coordsys>] -     [lock <coordsys>|none] - - Example: - string value = ds9.get(string cmd) - crosshair # get crosshair in physical coords - crosshair wcs fk4 sexagesimal # get crosshair in wcs coords - crosshair lock - - ds9.set(string cmd) - crosshair 100 100 physical # set crosshair in physical - crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords - crosshair 23:01:00 +58:52:51 wcs fk5 - crosshair match wcs - crosshair lock wcs - -
cube
-
-
Controls FITS cube.
- Syntax: - cube [] -     [play|stop|next|prev|first|last] -     [<slice> [<coordsys>]] -     [interval <numeric>] -     [match <coordsys>] -     [lock <coordsys>|none] -     [order 123|132|213|231|312|321] -     [axes lock [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - cube - cube wcs - cube interval - cube lock - cube order - cube axes lock - - ds9.set(string cmd) - cube - cube play - cube last - cube 3 - cube 4.4 wcs - cube interval 2 - cube match wcs - cube lock wcs - cube order 123 - cube axes lock yes - cube open - cube close
-
cursor
-
Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also.
- Syntax: - cursor [<x> <y>] - - Example: - ds9.set(string cmd) - cursor 10 10 - -
data
-
Return an array of data values given a lower left corner and a - width and height in specified coordinate system. The last - argument of yes indicates to strip the coordinates from the - output and just list the data values. The default is yes.
-
- Syntax: - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]] - - Example: - string url = ds9.get(string cmd) - data image 450 520 3 3 yes - data physical 899 1039 6 6 no - data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no - data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no - -
dsssao
- dss
-
-
Support for Digital Sky Survey at SAO.
- Syntax: - dsssao [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - string value = ds9.get(string cmd) - dsssao name - dsssao coord - dsssao size - dsssao save - dsssao frame - - ds9.set(string cmd) - dsssao - dsssao m31 - dsssao name m31 - dsssao name clear - dsssao 00:42:44.404 +41:16:08.78 - dsssao size 60 60 arcmin - dsssao save yes - dsssao frame current - dsssao update frame - dsssao open - dsssao close - -
dsseso
-
Support for Digital Sky Survey at ESO.
- Syntax: - dsseso [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -     [open|close] - - Example: - string value = ds9.get(string cmd) - dsseso name - dsseso coord - dsseso size - dsseso save - dsseso frame - dsseso survey - - ds9.set(string cmd) - dsseso - dsseso m31 - dsseso name m31 - dsseso name clear - dsseso 00:42:44.404 +41:16:08.78 - dsseso size 60 60 arcmin - dsseso save yes - dsseso frame current - dsseso update frame - dsseso survey DSS2-red - dsseso open - dsseso close - -
dssstsci
-
Support for Digital Sky Survey at STSCI.
- Syntax: - dssstsci [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -     [survey poss1_blue|poss1_red] -     [survey all|quickv|phase2_gsc2|phase2_gsc1] -     [open|close] - - Example: - string value = ds9.get(string cmd) - dssstsci name - dssstsci coord - dssstsci size - dssstsci save - dssstsci frame - dssstsci survey - - ds9.set(string cmd) - dssstsci - dssstsci m31 - dssstsci name m31 - dssstsci name clear - dssstsci 00:42:44.404 +41:16:08.78 - dssstsci size 60 60 arcmin - dssstsci save yes - dssstsci frame current - dssstsci update frame - dssstsci survey all - dssstsci open - dssstsci close
-
envi
-
Load an ENVI header and file. Optional parameter: array endian.
-
- Syntax:-- envi [new] <header> [<filename>]-- -- Example:-- ds9.set(string cmd)-- envi foo.hdr-- envi new foo.hdr- envi foo.hdr foo.bsq
-
- exit
-
quit
-
-
Quits DS9.
- Syntax: - exit - quit - - Example: - ds9.set(string cmd) - exit
-
export
-
-
Export loaded image data of current frame in specified image - format. Optional parameters: array endian, nrrd endian, jpeg - quality (1-100) and tiff compression method.
- Syntax: - export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> - export array <filename>[big|little|native] - export nrrd <filename>[big|little|native] - export envi <header> [<filename>][big|little|native] - export jpeg <filename>[1-100] - export tiff <filename>[none|jpeg|packbits|deflate] - - Example: - - ds9.set (string cmd) - export array foo.arr little - export nrrd foo.nrrd little - export envi foo.hdr little - export envi foo.hdr foo.bsq little - export tiff foo.tiff jpeg - export jpeg foo.jpeg 75 - export png foo.png
-
file
-
Query currently loaded file information.
- Syntax: - file - - Example: - string value = ds9.get(string cmd) - file - -
fits
-
Load a FITS image into the current frame or query the currently - loaded image.
-
- Syntax: - fits[new|mask|slice] [<filename>] -     [width|height|depth|bitpix|type] -     [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -     [header [<ext>] [keyword - <string>]] -     [image|table|slice] - - Example: - string value = ds9.get(string cmd) - fits - fits width - fits height - fits depth - fits bitpix - fits size - fits size wcs fk5 arcmin - fits header # primary - fits header 2 # hdu 2 - fits header -2 # hdu 2 with inherit - fits header keyword BITPIX - fits header 1 keyword BITPIX - fits image - fits table - fits slice - - ds9.set(string cmd, string url) - fits foo.fits - fits new foo.fits - fits bar.fits[bin=detx,dety] - fits slice foo.fits - fits mask foo.fits - - frame -
Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility.
- Syntax: - frame [center [#|all]] -     [clear [#|all]] -     [new [rgb|3d]] -     [delete [#|all]] -     [reset [#|all]] -     [refresh [#|all]] -     [hide [#|all]] -     [show [#|all]] -     [move first] -     [move back] -     [move forward] -     [move last] -     [first] -     [prev] -     [next] -     [last] -     [frameno #] -     [#] -     [match <coordsys>] -     [lock <coordsys>|none] -     [has - [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] -     [has contour [aux]]] -     [has fits [ |bin|cube|mosaic]] -     [has marker [highlite|paste|select|undo]] -     [has system <coordsys>] -     [has wcs [<wcssys>]] -     [has wcs celestial [<wcssys>]] -     [has wcs linear [<wcssys>]] - - Example: - string value = ds9.get(string cmd) - frame # returns the id of the current frame - frame frameno # returns the id of the current frame - frame all # returns the id of all frames - frame active # returns the id of all active frames - frame lock - frame has amplifier - frame has datamin - frame has datasec - frame has detector - frame has grid - frame has iis - frame has irafmin - frame has physical - frame has smooth - frame has contour - frame has contour aux - frame has fits - frame has fits bin - frame has fits cube - frame has fits mosaic - frame has marker highlite - frame has marker paste - frame has marker select - frame has marker undo - frame has system physical - frame has wcs wcsa - frame has wcs celestial wcsa - frame has wcs linear wcsa - - ds9.set(string cmd) - frame center # center current frame - frame center 1 # center 'Frame1' - frame center all # center all frames - frame clear # clear current frame - frame new # create new frame - frame new rgb # create new rgb frame - frame delete # delete current frame - frame reset # reset current frame - frame refresh # refresh current frame - frame hide # hide current frame - frame show 1 # show frame 'Frame1' - frame move first # move frame to first in order - frame move back # move frame back in order - frame move forward # move frame forward in order - frame move last # move frame to last in order - frame first # goto first frame - frame prev # goto prev frame - frame next # goto next frame - frame last # goto last frame - frame frameno 4 # goto frame 'Frame4', create if needed - frame 3 # goto frame 'Frame3', create if needed - frame match wcs - frame lock wcs
-
gif
-
Load GIF image into current frame.
-
- Syntax: - gif [new|slice] [<filename>] - - Example: - string value = ds9.get(string cmd) - gif - - ds9.set(string cmd) - gif foo.gif - gif new foo.gif - gif slice foo.gif - -
grid
-
Controls coordinate grid. For grid numeric format syntax, - click here.
- Syntax: - grid [] -     [yes|no] -     [type analysis|publication] -     [system <coordsys>] -     [sky <skyframe>] -     [skyformat <skyformat>] -     [grid yes|no] -     [grid color <color>] -     [grid width <value>] -     [grid dash yes|no] -     [grid gap1 <value>] -     [grid gap2 <value>] -     [grid gap3 <value>] -     [axes yes|no] -     [axes color <color>] -     [axes width <value>] -     [axes dash yes|no] -     [axes type interior|exterior] -     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] -     [format1 <format>] -     [format2 <format>] -     [tickmarks yes|no] -     [tickmarks color <color>] -     [tickmarks width <value>] -     [tickmarks dash yes|no] -     [border yes|no] -     [border color <color>] -     [border width <value>] -     [border dash yes|no] -     [numerics yes|no] -     [numerics font times|helvetica|courier] -     [numerics fontsize <value>] -     [numerics fontweight normal|bold] -     [numerics fontslant roman|italic] -     [numerics color <color>] -     [numerics gap1 <value>] -     [numerics gap2 <value>] -     [numerics gap3 <value>] -     [numerics type interior|exterior] -     [numerics vertical yes|no] -     [title yes|no] -     [title text <text>] -     [title def yes|no] -     [title gap <value>] -     [title font times|helvetica|courier] -     [title fontsize <value>] -     [title fontweight normal|bold] -     [title fontslant roman|italic] -     [title color <color>] -     [labels yes|no] -     [labels text1 <text>] -     [labels text2 <text>] -     [labels def1 yes|no] -     [labels def2 yes|no] -     [labels gap1 <value>] -     [labels gap2 <value>] -     [labels font times|helvetica|courier] -     [labels fontsize <value>] -     [labels fontweight normal|bold] -     [labels fontslant roman|italic] -     [labels color <color>] -     [reset] -     [load <filename>] -     [save <filename>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - grid - grid type - grid system - grid sky - grid skyformat - grid grid - grid grid color - grid grid width - grid grid dash - grid grid gap1 - grid grid gap2 - grid grid gap3 - grid axes - grid axes color - grid axes width - grid axes dash - grid axes type - grid axes origin - grid format1 - grid format2 - grid tickmarks - grid tickmarks color - grid tickmarks width - grid tickmarks dash - grid border - grid border color - grid border width - grid border dash - grid numerics - grid numerics font - grid numerics fontsize - grid numerics fontweight - grid numerics fontslant - grid numerics color - grid numerics gap1 - grid numerics gap2 - grid numerics gap3 - grid numerics type - grid numerics vertical - grid title - grid title text - grid title def - grid title gap - grid title font - grid title fontsize - grid title fontweight - grid title fontslant - grid title color - grid labels - grid labels text1 - grid labels text2 - grid labels def1 - grid labels def2 - grid labels gap1 - grid labels gap2 - grid labels font - grid labels fontsize - grid labels fontweight - grid labels fontslant - grid labels color - - ds9.set(string cmd) - grid - grid yes - grid type analysis - grid system wcs - grid sky fk5 - grid skyformat degrees - grid grid yes - grid grid color red - grid grid width 2 - grid grid dash yes - grid grid gap1 10 - grid grid gap2 10 - grid grid gap3 10 - grid axes yes - grid axes color red - grid axes width 2 - grid axes dash yes - grid axes type exterior - grid axes origin lll - grid format1 d.2 - grid format2 d.2 - grid tickmarks yes - grid tickmarks color red - grid tickmarks width 2 - grid tickmarks dash yes - grid border yes - grid border color red - grid border width 2 - grid border dash yes - grid numerics yes - grid numerics font courier - grid numerics fontsize 12 - grid numerics fontweight bold - grid numerics fontslant italic - grid numerics color red - grid numerics gap1 10 - grid numerics gap2 10 - grid numerics gap3 10 - grid numerics type exterior - grid numerics vertical yes - grid title yes - grid title text {Hello World} - grid title def yes - grid title gap 10 - grid title fontsize 12 - grid title font courier - grid title fontweight bold - grid title fontslant italic - grid title color red - grid labels yes - grid labels text1 {Hello World} - grid labels text2 {Hello World} - grid labels def1 yes - grid labels def2 yes - grid labels gap1 10 - grid labels gap2 10 - grid labels font courier - grid labels fontsize 12 - grid labels fontweight bold - grid labels fontslant italic - grid labels color red - grid reset - grid load foo.grd - grid save foo.grd - grid open - grid close - -
header
-
Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from samp fits - header.
- Syntax: - header [<ext>] -     [close [<ext>]] -     [save [<ext>] <filename>] - - Example: - string value = ds9.get(string cmd) - header - header 2 - header close - -
height
-
Set the height of the image display window.
- Syntax: - height [<value>] - - Example: - string value = ds9.get(string cmd) - height - - ds9.set(string cmd) - height 512 - -
iconify
-
Toggles iconification.
- Syntax: - iconify [] -     [yes|no] - - Example: - string value = ds9.get(string cmd) - iconify - - ds9.set(string cmd) - iconify - iconify yes
-
iexam
-
Interactive examine function. A blinking cursor will indicate - to the user to click on a point on an image. The specified - information will be returned at that time. The default event is - button. In the last form, the following macros will be - expanded if present: $width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z. See Analysis - Macros for more information.
- Syntax: - iexam [] -     [[]|button|key|any] coordinate - <coordsys> [<skyframe>] [<skyformat>] -     [[]|button|key|any] data [width][height] -     [[]|button|key|any] <macro string>] - - Example: - string value = ds9.get(string cmd) - iexam - iexam coordinate image - iexam key coordinate image # return coordinate and key event - iexam coordinate wcs fk5 degrees - iexam coordinate wcs galactic sexagesimal - iexam coordinate fk5 - iexam data # return data value - iexam key data # return data value and key event - iexam data 3 3 # return all data in 3x3 box about selected point - iexam {'Click at $x,$y in file $filename'} - -
iis
-
Set/Get IIS Filename. Optional mosaic number maybe supplied.
- Syntax: - iis [filename <filename> [#]] - - Example: - string value = ds9.get(string cmd) - iis filename - iis filename 4 - - ds9.set(string cmd) - iis filename foo.fits - iis filename bar.fits 4
-
jpeg
-
Load JPEG image into current frame. Optional parameters: jpeg - quality (1-100)
- Syntax: - jpeg [new|slice] [<filename>] [1-100] - - Example: - string value = ds9.get(string cmd) - jpeg - - ds9.set(string cmd) - jpeg foo.jpeg - jpeg new foo.jpeg - jpeg slice foo.jpeg - -
lock
-
Lock all other frames to the current frame.
- Syntax: - lock[frame <coordsys>|none] -     [crosshair <coordsys>|none] -     [crop <coordsys>|none] -     [slice <coordsys>|none] -     [bin [yes|no]] -     [axes [yes|no]] -     [scale [yes|no]] -     [scalelimits [yes|no]] -     [colorbar [yes|no]] -     [block [yes|no]] -     [smooth [yes|no]] -     [3d [yes|no]] - - Example: - string value = ds9.get(string cmd) - lock frame - lock crosshair - lock crop - lock slice - lock bin - lock axes - lock scale - lock scalelimits - lock colorbar - lock block - lock smooth - lock 3d - - ds9.set(string cmd) - lock frame wcs - lock crosshair wcs - lock crop wcs - lock slice wcs - lock bin yes - lock axes yes - lock scale yes - lock scalelimits yes - lock colorbar yes - lock block yes - lock smooth yes - lock 3d yes - - lower -
Lower in the window stacking order.
- Syntax: - lower - - Example: - ds9.set(string cmd) - lower - -
magnifier
-
Controls the magnifier settings.
- Syntax: - magnifier [color <color>] -     [zoom <value>] -     [cursor yes|no] -     [region yes|no] - - Example: - string value = ds9.get(string cmd) - magnifier color - magnifier zoom - magnifier cursor - magnifier region - - ds9.set(string cmd) - magnifier color yellow - magnifier zoom 2 - magnifier cursor no - magnifier region no - -
mask
-
-
Controls mask parameters.
- Syntax: - mask [color <color>] -     [mark zero|nonzero|nan|nonnan|range] -     [range <low> <high>] -     [transparency <value>] -     [system <coordsys>] -     [clear] -     [open|close] - - Example: - string value = ds9.get(string cmd) - mask color - mask mark - mask range - mask system - mask transparency - - ds9.set(string cmd) - mask color red - mask mark zero - mask range 10 100 - mask transparency 50 - mask system wcs - mask clear - mask open - mask close - -
match
-
Match all other frames to the current frame.
- Syntax: - match[frame <coordsys>] -     [crosshair <coordsys>] -     [crop <coordsys>] -     [slice <coordsys>] -     [bin] -     [axes] -     [scale] -     [scalelimits] -     [colorbar] -     [block] -     [smooth] -     [3d] - - Example: - ds9.set(string cmd) - match frame wcs - match crosshair wcs - match crop wcs - match slice wcs - match bin - match axes - match scale - match scalelimits - match colorbar - match block - match smooth - match 3d - -
mecube
-
Load FITS multiple extension file as data cube.
-
- Syntax: - mecube [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - mecube - - ds9.set(string cmd) - mecube foo.fits - mecube new foo.fits - -
minmax
-
This is how DS9 determines the min and max data values - from the data. SCAN will scan all data.
- Syntax: - minmax [scan|sample|datamin|irafmin] -     [mode scan|sample|datamin|irafmin] -     [interval #] - - Example: - string value = ds9.get(string cmd) - minmax mode - minmax sample - - ds9.set(string cmd) - minmax scan - minmax mode scan - minmax interval 100 - -
mode
-
Controls the first mouse button mode.
- Syntax: - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - string value = ds9.get(string cmd) - mode - - ds9.set(string cmd) - mode crosshair
-
mosaic
-
Load FITS mosaic segment into current frame.
- Syntax: - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] - - Example: - string value = ds9.get(string cmd) - mosaic - - ds9.set(string cmd) - mosaic foo.fits - mosaic wcs foo.fits - mosaic wcs new foo.fits - mosaic wcs mask foo.fits - -
mosaicimage
-
Load FITS mosaic image into current frame.
- Syntax: - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>] - - Example: - string value = ds9.get(string cmd) - mosaicimage - ds9.set(string cmd) - mosaicimage foo.fits - mosaicimage wcs foo.fits - mosaicimage wcs new foo.fits - mosaicimage wcs mask foo.fits - -
movie
-
Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.
- Syntax: - movie[slice|frame|3d][mpeg|gif] <filename> - movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - ds9.set(string cmd) - movie slice mpeg ds9.mpg - movie frame gif ds9.gif - movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate 1 - -
multiframe
-
Load FITS multiple extension file as multiple images.
-
- Syntax: - multiframe [<filename>] - - Example: - ds9.set(string cmd) - multiframe foo.fits
-
nameserver
-
Support Name Server functions. Coordinates are in fk5.
- Syntax: - nameserver [<object>] -     [name <object>] -     [server - ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] -     [skyformat degrees|sexagesimal] -     [pan] -     [crosshair] -     [close] - - Example: - string value = ds9.get(string cmd) - nameserver - nameserver server - nameserver skyformat - nameserver m31 - - ds9.set(string cmd) - nameserver m31 - nameserver name m31 - nameserver server ned-sao - nameserver skyformat sexagesimal - nameserver pan - nameserver crosshair - nameserver open - nameserver close - -
nan
-
Set image not-a-number color.
- Syntax: - nan <color> - - Example: - string value = ds9.get(string cmd) - nan - - ds9.set(string cmd) - nan red
-
nrrd
-
Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian.
-
- Syntax: - nrrd [native|little|big] - nrrd [new|mask] [<filename>] - - Example: - string value = ds9.get(string cmd) - nrrd - nrrd big - - ds9.set(string cmd, string url) - nrrd foo.nrrd - nrrd new foo.nrrd - nrrd mask foo.nrrd
-
nvss
-
Support for NRAO VLA Sky Survey.
- Syntax: - nvss [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - string value = ds9.get(string cmd) - nvss name - nvss coord - nvss size - nvss save - nvss frame - - ds9.set(string cmd) - nvss - nvss m31 - nvss name m31 - nvss name clear - nvss 00:42:44.404 +41:16:08.78 - nvss size 60 60 arcmin - nvss save yes - nvss frame current - nvss update frame - nvss open - nvss close - -
orient
-
Controls the orientation of the current frame.
- Syntax: - orient [none|x|y|xy] -     [open|close] - - Example: - string value = ds9.get(string cmd) - orient - - ds9.set(string cmd) - orient xy - orient open - orient close - -
pagesetup
-
Controls Page Setup options.
- Syntax: - pagesetup [orient portrait|landscape] -     [scale <numeric>] -     [size letter|legal|tabloid|poster|a4] - - Example: - string value = ds9.get(string cmd) - pagesetup orient - pagesetup scale - pagesetup size - - ds9.set(string cmd) - pagesetup orient portrait - pagesetup scale 50 - pagesetup size poster - -
pan
-
Controls the current image cursor location for the current - frame.
- Syntax: - pan [<coordsys> [<skyframe>] [<skyformat>]] # - get current coords - - pan [<x> <y> <coordsys> [<skyframe>]] # - relative -     [to <x> <y> <coordsys> - [<skyframe>]] # absolute -     [open|close] -     [close] - - Example: - string value = ds9.get(string cmd) - pan # get current image coords - pan wcs fk4 sexagesimal # get current wcs coords - - ds9.set(string cmd) - pan 200 200 image # pan relative - pan to 400 400 physical # pan to physical coords - pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords - pan open - pan close - -
pixeltable
-
Display/Hide the pixel table.
- Syntax: - pixeltable [] -     [yes|open] -     [no|close] - - Example: - string url = ds9.get(string cmd) - pixeltable - - ds9.set(string cmd) - pixeltable - pixeltable yes - pixeltable open - pixeltable close - -
plot
-
Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions:
-
xy    x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors -
-
To create a new plot, use the plot new command.
- Syntax: - # create new empty plot window - plot [] -     [line|bar|scatter] -     [new] -     [new line|bar|scatter] -     [new name <plotname>] -     [new name <plotname> line|bar|scatter] - - #load data into existing plot from stdin - plot [[<plotname>] data xy|xyex|xyey|xyexey] - - # existing plot - plot[[<plotname>] load <filename> - xy|xyex|xyey|xyexey] -     [[<plotname>] save <filename>] -     [[<plotname>] clear] -     [[<plotname>] duplicate [#]] -     [[<plotname>] stats yes|no] -     [[<plotname>] list yes|no] -     [[<plotname>] loadconfig - <filename>] -     [[<plotname>] saveconfig - <filename>] -     [[<plotname>] pagesetup orient - portrait|landscape] -     [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] -     [[<plotname>] print] -     [[<plotname>] print destination - printer|file] -     [[<plotname>] print command - <command>] -     [[<plotname>] print filename - <filename>] -     [[<plotname>] print color rgb|gray] -     [[<plotname>] close] -     [[<plotname>] mode pointer|zoom] - - # export image - plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> -     [[<plotname>]export jpeg - <filename>[1-100] -     [[<plotname>]export tiff - <filename>[none|jpeg|packbits|deflate] - - # configure graph - plot [[<plotname>] axis x|y grid yes|no] -     [[<plotname>] axis x|y log yes|no] -     [[<plotname>] axis x|y flip yes|no] -     [[<plotname>] axis x|y auto yes|no] -     [[<plotname>] axis x|y min - <value>] -     [[<plotname>] axis x|y max - <value>] -     [[<plotname>] axis x|y format - <string>] -     [[<plotname>] background <value>] -     [[<plotname>] legend yes|no] -     [[<plotname>] legend position - right|left|top|bottom] -     [[<plotname>] font title|labels|numbers - font times|helvetica|courier] -     [[<plotname>] - fonttitle|labels|numberssize <value>] -     [[<plotname>] - fonttitle|labels|numbersweight normal|bold] -     [[<plotname>] - fonttitle|labels|numbersslant roman|italic] -     [[<plotname>] title <string>] -     [[<plotname>] title x|y <string>] -     [[<plotname>] barmode - normal|stacked|aligned|overlap] - - # configure current dataset - plot [[<plotname>] show yes|no] -     [[<plotname>] shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -     [[<plotname>] shape fill yes|no] -     [[<plotname>] shape color - <value>] -     [[<plotname>] smooth - step|linear|cubic|quadratic|catrom] -     [[<plotname>] color <value>] -     [[<plotname>] width <value>] -     [[<plotname>] dash yes|no] -     [[<plotname>] error yes|no] -     [[<plotname>] error color - <value>] -     [[<plotname>] error cap yes|no] -     [[<plotname>] error width - <value>] -     [[<plotname>] name <string>] - - # select current dataset - plot [[<plotname>] select <value>] - - Example: - # return all plotnames - string value = ds9.get(string cmd) - plot - - # create new empty plot window - ds9.set(string cmd) - plot - plot bar - plot new - plot new bar - plot new name foo - plot new name foo bar - -# existing plot - string value = ds9.get(string cmd) - plot stats - plot list - - ds9.set(string cmd) - plot load foo.dat xy - plot save foo.dat - plot clear - plot duplicate 1 - plot stats yes - plot list yes - plot loadconfig foo.plt - plot saveconfig foo.plt - plot pagesetup orient portrait - plot pagesetup size letter - plot print - plot print destination file - plot print command lp - plot print filename foo.ps - plot print color rgb - plot close - - # plot mode - string value = ds9.get(string cmd) - plot mode - - ds9.set(string cmd) - plot mode pointer - - # export plot - ds9.set(string cmd) - plot export tiff foo.tiff jpeg - plot export jpeg foo.jpeg 75 - plot export png foo.png - - # configure plot - string value = ds9.get(string cmd) - plot axis x grid - plot axis x log - plot axis x flip - plot axis x auto - plot axis x min - plot axis x max - plot axis x format -plot background - plot legend - plot legend position - plot font numbers font - plot font numbers size - plot font numbers weight - plot font numbers slant - plot title - plot title x - - ds9.set(string cmd) - plot axis x grid yes - plot axis x log yes - plot axis x flip yes - plot axis x auto no - plot axis x min 0 - plot axis x max 100 - plot axis x format "%f"
- plot background white
- plot legend yes - plot legend position left - - plot font numbers font times - plot font numbers size 12 - plot font numbers weight bold - plot font numbers slant italic - plot title "This is a Title" - plot title x "X Axis" - plot title y "Y Axis" - plot title legend "This is the Legend" - - # bar plot - string value = ds9.get(string cmd) - plot barmode - - ds9.set(string cmd) - plot barmode aligned - - # configure current dataset - string value = ds9.get(string cmd) - plot show - plot shape - plot shape fill - plot shape color - plot smooth - plot color - plot width - plot dash - plot error - plot error color - plot error cap - plot error width - plot name - - ds9.set(string cmd) - plot show yes - plot shape circle - plot shape fill no - plot shape color cyan - plot smooth step - plot color red - plot width 2 - plot dash yes - plot error yes - plot error color red - plot error cap yes - plot error width 2 - plot name "My Data" - - # select current dataset - string value = ds9.get(string cmd) - plot select - - ds9.set(string cmd) - plot select 2 - - png -
Load PNG image into current frame.
-
- Syntax: - png [new|slice] [<filename>] - - Example: - string value = ds9.get(string cmd) - png - - ds9.set(string cmd) - png foo.png - png new foo.png - png slice foo.png
-
precision
-
Set region and coordinate output format precision.
- Syntax: - precision -<linear><degree><hms><dms><arcmin><arcsec> - - Example: - string value = ds9.get(string cmd) - precision - - ds9.set(string cmd) - precision 8 10 4 3 5 3 - -
prefs
-
Controls various preference settings.
- Syntax: - prefs [clear] -     [irafalign yes|no] - - Example: - string value = ds9.get(string cmd) - prefs irafalign - - ds9.set(string cmd) - prefs clear - prefs irafalign - - preserve -
Preserve the follow attributes while loading a new image.
- Syntax: - preserve [pan yes|no] -    [regions yes|no] - - Example: - string value = ds9.get(string cmd) - preserve pan - preserve regions - - ds9.set(string cmd) - preserve pan yes - preserve regions yes - -
psprint
-
Invokes postscript printing. Please see print - for further details.
-
print
-
Controls printing. Use print option to set printing options.
- Syntax: - print [destination printer|file] -     [command <command>] -     [filename <filename>] -     [color rgb|cmyk|gray] -     [level 1|2|3] -     - [resolution72|screen|96|144|150|225|300|600|1200] - - Example: - string value = ds9.get(string cmd) - print destination - print command - print filename - print color - print level - print resolution - - ds9.set(string cmd) - print - print destination file - print command lp - print filename foo.ps - print color cmyk - print level 2 - print resolution 96 -
raise
-
Raise in the window stacking order.
- Syntax: - raise - - Example: - ds9.set(string cmd) - raise -
regions
-
Controls regions in the current frame.
- Syntax: - regions [<filename>] -     [load [all] <filename>] -     [save <filename>] -     [list [close]] -     [epsilon <integer>] -     [show yes|no] -     [showtext yes|no] -     [centroid] -     [centroid auto yes|no] -     [centroid radius <value>|iteration - <value>] -     [getinfo] -     [move front] -     [move back] -     [select all] -     [select none] -     [select invert] -     [delete all] -     [delete select] -     [format ds9|xml|ciao|saotng|saoimage|pros|xy] -     [system image|physical|wcs|wcsa...wcsz] -     [sky fk4|fk5|icrs|galactic|ecliptic] -     [skyformat degrees|sexagesimal] -     [strip yes|no] -     [shape <shape>] -     [color &ltcolor>] -     [width <width>] -     [fixed|edit|rotate|delete yes|no] -     [include|exclude|source|background] -     [command <marker command>] -     [composite] -     [dissolve] -     [template <filename>] -     [template <filename> at <ra> - <dec> <coordsys> <skyframe>] -     [savetemplate <filename>] -     [groups] -     [group new] -     [group <tag> new] -     [group <tag> update] -     [group <tag> select] -     [group <tag> color <color>] -     [group <tag> copy] -     [group <tag> delete] -     [group <tag> cut] -     [group <tag> font <font>] -     [group <tag> move <int> - <int>] -     [group <tag> movefront] -     [group <tag> moveback] -     [group <tag> property <property> - yes|no] -     [copy] -     [cut] -     [paste image|physical|wcs|wcsa...wcsz] -     [undo] -     [include|exclude|source|background|selected] -     [-format ds9|ciao|saotng|saoimage|pros|xy] -     [-system image|physical|wcs|wcsa...wcsz] -     [-sky fk4|fk5|icrs|galactic|ecliptic] -     [-skyformat degrees|sexagesimal] -     [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0] -     [-group <tag>] -     [-strip yes|no] -     [-wcs yes|no] - - Example: - string url = ds9.get(string cmd) - regions - regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal - -prop edit 1 -group foo - string value = ds9.get(string cmd) - regions epsilon - regions show - regions showtext - regions centroid - regions centroid auto - regions centroid radius - regions centroid iteration - regions selected - regions format - regions system - regions sky - regions skyformat - regions strip - regions shape - regions color - regions width - regions source - regions background - regions include - regions exclude - regions selected - regions groups - - ds9.set(string cmd) - regions foo.reg - regions -format ciao bar.reg # load as ciao format - regions foo.fits # FITS regions files do not need a format - specification - regions load foo.reg # load foo.reg into current frame - regions load all foo.reg # load foo.reg into all frames - regions load *.reg# expand *.reg and load into current frame - regions load all *.reg # expand *.reg and load into all frames - regions save foo.reg - regions list - regions list close - regions epsilon 5 - regions show yes - regions showtext no - regions centroid - regions centroid auto yes - regions centroid radius 10 - regions centroid iteration 20 - regions getinfo - regions move back - regions move front - regions select all - regions select none - regions select invert - regions delete all - regions delete select - regions format ds9 - regions system wcs - regions sky fk5 - regions skyformat degrees - regions strip yes - regions shape ellipse - regions color red - regions width 3 - regions edit yes - regions include - regions command "circle 100 100 20 # color=red" - regions composite - regions dissolve - regions template foo.tpl - regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 - regions savetemplate foo.tpl - regions group new - regions group foo new - regions group foo update - regions group foo select - regions group foo color red - regions group foo copy - regions group foo delete - regions group foo cut - regions group foo font 'times 14 bold' - regions group foo move 100 100 - regions group foo movefront - regions group foo moveback - regions group foo property delete no - regions copy - regions cut - regions paste wcs - regions undo - -
restore
-
Restore DS9 to a previous state from a backup save set.
- Syntax: - restore <filename> - - Example: - restore ds9.bck
-
rgb
-
Create RGB frame and control RGB frame parameters.
- Syntax: - rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -     [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - rgb channel - rgb lock wcs - rgb lock crop - rgb lock slice - rgb lock bin - rgb lock scale - rgb lock scalelimits - rgb lock colorbar - rgb lock block - rgb lock smooth - rgb system - rgb view red - rgb view green - rgb view blue - - ds9.set(string cmd) - rgb # create new rgb frame - rgb red # set current channel to red - rgb channel red # set current channel to red - rgb view blue no # turn off blue channel - rgb system wcs # set rgb coordinate system - rgb lock wcs yes - rgb lock crop yes - rgb lock slice yes - rgb lock bin yes - rgb lock scale yes - rgb lock scalelimits yes - rgb lock colorbar yes - rgb lock block yes - rgb lock smooth yes - rgb open - rgb close
-
rgbarray
-
Load raw data array cube into rgb frame.
-
- Syntax: - rgbarray [native|big|little] - rgbarray [new] -[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - string value = ds9.get(string cmd) - rgbarray - - ds9.set(string cmd) - rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
-
rgbcube
-
Load FITS rgbcube into rgb frame.
-
- Syntax: - rgbcube [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - rgbcube - - ds9.set(string cmd) - rgbcube foo.fits - rgbcube new foo.fits
-
rgbimage
-
Load FITS rgbimage into rgb frame.
-
- Syntax: - rgbimage [new] [<filename>] - - Example: - string value = ds9.get(string cmd) - rgbimage - - ds9.set(string cmd) - rgbimage foo.fits - rgbimage new foo.fits - -
rotate
-
Controls the rotation angle (in degrees) of the current frame.
- Syntax: - rotate [<value>] -     [to <value>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - rotate - - ds9.set(string cmd) - rotate 45 - rotate to 30 - rotate open - rotate close
-
samp
-
Configure SAMP protocol.
- Syntax: - samp [no|disconnect] -     [broadcast [image|table]] -     [send [image|table] <application>] - - Example: - - ds9.set(string cmd) - samp no - samp disconnect - samp broadcast image - samp send image aladin -
save
-
-
Save loaded image data of current frame as FITS.
- Syntax: - save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice] - - Example: - ds9.set(string cmd) - save foo.fits - save fits foo.fits image - save fits foo.fits table - save fits foo.fits slice - save rgbimage foo.fits - save rgbcube foo.fits - save mecube foo.fits - save mosaic foo.fits - save mosaicimage foo.fits
-
saveimage
-
Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method.
- Syntax: - saveimage[fits|eps|gif|tiff|jpeg|png]<filename> - saveimage <filename>.jpeg [1-100] - saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - ds9.set(string cmd) - saveimage ds9.tiff - saveimage jpeg ds9.jpeg 75
-
scale
-
Controls the limits and color scale distribution.
- Syntax: - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -     [log exp <value>] -     [datasec yes|no] -     [limits <minvalue> <maxvalue>] -     [mode minmax|<value>|zscale|zmax] -     [scope local|global] -     [match] -     [match limits] -     [lock [yes|no]] -     [lock limits [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - scale - scale log exp - scale datasec - scale limits - scale mode - scale scope - scale lock - scale lock limits - - ds9.set(string cmd) - scale linear - scale log exp 100 - scale datasec yes - scale histequ - scale limits 1 100 - scale mode zscale - scale mode 99.5 - scale scope local - scale match - scale match limits - scale lock yes - scale lock limits yes - scale open - scale close - -
shm
-
Load a shared memory segment into the current frame.
- Syntax: - shm [<key> [<filename>]] -     [key <key> [<filename>]] -     [shmid <id> [<filename>]] -     [fits [key|shmid] <id> - [<filename>]] -     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]] -     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] -     [rgbcube [key|shmid] <id> - [<filename>] -     [rgbimage [key|shmid] <id> - [<filename>]] -     [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -     [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - string value = ds9.get(string cmd) - shm - - ds9.set(string cmd) - shm 102 - shm key 102 - shm shmid 102 foo - shm fits key 100 foo - shm mosaicimage iraf key 100 foo - shm mosaicimage wcs key 100 foo - shm mosaicimage wcsa key 100 foo - shm mosaicimage wfpc2 key 100 foo - shm mosaic iraf key 100 foo - shm mosaic wcs key 100 foo - shm rgbcube key 100 foo - shm rgbimage key 100 foo - shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] - shm array shmid 102 [dim=32,bitpix=-32] - - sia
- -
Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise.
- Syntax: - sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [coordinate <ra> - <dec> <coordsys>] -     [<ref>] [crosshair] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [name <object>] -     [<ref>] [print] -     [<ref>] [retrieve] -     [<ref>] [save <filename>] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] - - Example: - string value = ds9.get(string cmd) - sia - - ds9.set(string cmd) - sia2mass - siacancel - siaclear - siaclose - siacoordinate 202.48 47.21 fk5 - siacrosshair - siaexport tsv bar.tsv - sianame m51 - siaprint - siaretrieve - siasave foo.xml - siaradius 1degrees - siasky fk5 - sia skyformat degrees - siasystem wcs - siaupdate - - single -
Select Single Display mode
- Syntax: - single - - Example: - string value = ds9.get(string cmd) - single - - ds9.set(string cmd) - single - -
skyview
-
Support for SkyView image server at HEASARC.
- Syntax: - skyview [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [pixels <width> <height>] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey <survey>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - skyview name - skyview coord - skyview size - skyview pixels - skyview save - skyview frame - skyview survey - - ds9.set(string cmd) - skyview - skyview m31 - skyview name m31 - skyview name clear - skyview 00:42:44.404 +41:16:08.78 - skyview size 60 60 arcmin - skyview pixels 600 600 - skyview save yes - skyview frame current - skyview update frame - skyview survey sdssi - skyview open - skyview close - -
sleep
-
Delays execution for specified number of seconds. Default is 1 - second.
- Syntax: - sleep [#] - - Example: - ds9.set(string cmd) - sleep - sleep 2 - -
smooth
-
Smooth current image or set smooth parameters.
-
Boxcar width =2*radius+1 - Tophat diameter =2*radius+1 - Gaussian diameter =2*radius+1,mean=0 - Elliptical Gaussian diameter =2*radius+1,mean=0Syntax: -
- smooth [] -     [yes|no] -     [function boxcar|tophat|gaussian] -     [radius <value>] -     [radiusminor <value>] -     [sigma <value>] -     [sigmaminor <value>] -     [angle <value>] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - string value = ds9.get(string cmd) - smooth - smooth function - smooth radius - smooth radiusminor - smooth sigma - smooth sigmaminor - smooth angle - smooth lock - - ds9.set(string cmd) - smooth - smooth yes - smooth function tophat - smooth radius 4 - smooth radiusminor 4 - smooth sigma 2.0 - smooth sigmaminor 2.0 - smooth angle 45 - smooth match - smooth lock yes - smooth open - smooth close - -
source
-
Source TCL code from a file.
- Syntax: - source [filename] - - Example: - ds9.set(string cmd) - source foo.tcl
-
tcl
-
Execute one TCL command.
-
- Syntax: - tcl <tcl command> - - Example: - ds9.set(string cmd) - tcl {puts {Hello, World}} - -
threads
-
Set number of process threads for functions which are - multi-threaded.
- Syntax: - threads # - - Example: - string value = ds9.get(string cmd) - threads - ds9.set(string cmd) - threads 8
-
tiff
-
Load TIFF image into current frame. Optional parameters: tiff - compression method.
- Syntax: - tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] - - Example: - string value = ds9.get(string cmd) - tiff - tiff jpeg - - ds9.set(string cmd) - tiff foo.tiff - tiff new foo.tiff - tiff slice foo.tiff
-
tile
-
Controls the tile display mode.
- Syntax: - tile [] -     [yes|no] -     [mode grid|column|row] -     [grid] -     [grid mode automatic|manual] -     [grid direction x|y] -     [grid layout <col> <row>] -     [grid gap <pixels>] -     [row] -     [column] - - Example: - string value = ds9.get(string cmd) - tile - tile mode - tile grid mode - tile grid direction - tile grid layout - tile grid gap - - ds9.set(string cmd) - tile - tile yes - tile mode row - tile grid - tile grid mode manual - tile grid direction x - tile grid layout 5 5 - tile grid gap 10 - tile row - tile column -
update
-
Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option.
- Syntax: - update [] -     [# x1 y1 x2 y2] -     [now] -     [now # x1 y1 x2 y2] - - Example: - - ds9.set(string cmd) - update - update 1 100 100 300 400 - update now - update now 1 100 100 300 400
-
url
-
Load FITS from URL into the current frame
- Syntax: - url <url> - - Example: - ds9.set(string cmd) - url http://foo.bar.edu/foo.fits -
version
-
Returns the current version of DS9.
- Syntax: - version - - Example: - string value = ds9.get(string cmd) - version -
view
-
Controls the GUI.
- Syntax: - view [layout horizontal|vertical] -     [keyvalue <string>] -     [info yes|no] -     [panner yes|no] -     [magnifier yes|no] -     [buttons yes|no] -     [colorbar yes|no] -     [colorbar horizontal|vertical] -     [colorbar numerics yes|no] -     [graph horizontal|vertical yes|no] -     [filename yes|no[ -     [object yes|no] -     [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -     [units yes|no] -     [image|physical|wcs|wcsa...wcsz yes|no] -     [frame yes|no] -     [red yes|no] -     [green yes|no] -     [blue yes|no] - - Example: - string value = ds9.get(string cmd) - view layout - view keyvalue - view info - view panner - view magnifier - view buttons - view colorbar - view graph horizontal - view filename - view object - view keyword - view minmax - view lowhigh - view units - view image - view wcsa - view red
- view frame - - - ds9.set(string cmd) - view layout vertical - view keyvalue BITPIX - view info yes - view panner yes - view magnifier yes - view buttons yes - view colorbar yes - view graph horizontal yes - view filename yes - view object yes - view keyword yes - view minmax yes - view lowhigh yes - view units yes - view wcsa yes - view frame yes - view red yes - view green yes - view blue yes
-
vla
-
Support for VLA Sky Survey.
- Syntax: - vla [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey first|stripe82] -     [open|close] - - Example: - string value = ds9.get(string cmd) - vla name - vla coord - vla size - vla save - vla frame - vla survey - - ds9.set(string cmd) - vla - vla m31 - vla name m31 - vla name clear - vla 00:42:44.404 +41:16:08.78 - vla size 60 60 arcmin - vla save yes - vla frame current - vla update frame - vla survey stripe82 - vla open - vla close - -
vlss
-
Support for NRAO VLSS Sky Survey.
- Syntax: - vlss [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - string value = ds9.get(string cmd) - vlss name - vlss coord - vlss size - vlss save - vlss frame - - ds9.set(string cmd) - vlss - vlss m31 - vlss name m31 - vlss name clear - vlss 00:42:44.404 +41:16:08.78 - vlss size 60 60 arcmin - vlss save yes - vlss frame current - vlss update frame - vlss open - vlss close
-
vo
-
Invoke an connection to a Virtual Observatory site.
- Syntax: - vo [method xpa|mime] -    [server <url>] -    [internal yes|no] -    [delay #] -    [<url>] -    [connect <url>] -    [disconnect <url>] -    [open|close] - - Example: - string value = ds9.get(string cmd) - vo - vo method - vo server - vo internal - vo delay - vo connect - - ds9.set(string cmd) - vo method xpa - vo server "http://foo.bar.edu/list.txt" - vo internal yes - vo delay 15 - vo chandra-ed - vo connect chandra-ed - vo disconnect chandra-ed - vo open - vo close - -
wcs
-
Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, using this access point, a new WCS - specification can be loaded and used by the current image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
- Syntax: - wcs [[system] wcs|wcsa...wcsz] -     [[sky] fk4|fk5|icrs|galactic|ecliptic] -     [[skyformat] degrees|sexagesimal] -     [align yes|no] -     [reset [#]] -     [replace [#] <filename>] -     [append [#] <filename>] -     [open|close] - - Example: - string value = ds9.get(string cmd) - wcs - wcs system - wcs sky - wcs skyformat - wcs align - - ds9.set(string cmd) - wcs wcs - wcs system wcs - wcs fk5 - wcs sky fk5 - wcs sexagesimal - wcs skyformat sexagesimal - wcs align yes - wcs reset - wcs reset 3 - wcs replace foo.wcs - wcs replace 3 foo.wcs - wcs append foo.wcs - wcs append 3 foo.wcs - wcs open - wcs close - -
web
-
Display specified URL in the web display.
- Syntax: - web [] -     [<url>] -     [new <webname> <url>] -     [<webname>] [click - back|forward|stop|reload|#] -     [<webname>] [clear] -     [<webname>] [close] - - Example: - string value = ds9.get(string cmd) - web - - ds9.set(string cmd) - web www.cnn.com - web new www.cnn.com - web hvweb www.apple.com - web click back - web click 2 - web clear - web close - -
width
-
Set the width of the image display window.
- Syntax: - width [<value>] - - Example: - string value = ds9.get(string cmd) - width - - ds9.set(string cmd) - width 512 - -
zscale
-
Set Scale Limits based on the IRAF algorithm.
- Syntax: - zscale [] -     [contrast] -     [sample] -     [line] - - Example: - string value = ds9.get(string cmd) - zscale contrast - zscale sample - zscale line - - ds9.set(string cmd) - zscale - zscale contrast .25 - zscale sample 600 - zscale line 120 - -
zoom
-
Controls the current zoom value for the current frame.
- Syntax: - zoom [<value>] -     [<value> <value>] -     [to <value>] -     [to <value> <value>] -     [in] -     [out] -     [to fit] -     [open|close] - - Example: - string value = ds9.get(string cmd) - zoom - - ds9.set(string cmd) - zoom 2 - zoom 2 4 - zoom to 4 - zoom to 2 4 - zoom in - zoom out - zoom to fit - zoom open - zoom close -
- + + + + +SAMP + + +
SAMP
+
+
SAMP is a messaging protocol that enables astronomy software tools to interoperate and communicate. Broadly speaking, SAMP is an abstract framework for loosely-coupled, asynchronous, RPC-like and/or event-based communication, based on a central service providing multi-directional publish/subscribe message brokering. The message semantics are extensible and use structured but weakly-typed data. For more information on SAMP, please click here.
+
The samp implementation for DS9 is based on the XPA model with 2 private calls:
+ds9.get +    Arguments +        cmd (string) required +        url (string) optional +    Returned value +        OK (samp.result map) +            value (string) optional +                url (string) optional +        ERROR (samp.error map) +            samp.errortxt (string) + +ds9.set +    Arguments +        cmd (string) required +        url (string) optional +    Returned value +        OK +        ERROR (samp.error map) +            samp.errortxt (string) +
ds9.set maybe called via notification, call and call/wait. ds9.get can only be called via call and call/wait. Most of the ds9.get calls return a value string, but a few will return a url instead.
+2mass +3d +about +analysis +array +background +backup +bin +blink +block +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +data +dsssao +dsseso +dssstsci +envi +exit +export +file +fits +frame +gif +grid +header +height +iconify +iexam +iis +jpeg +lock +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +multiframe +nameserver +nan +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +quit +raise +regions +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +samp +save +saveimage +scale +shm +sia +single +skyview +sleep +smooth +source +tcl +threads +tiff +tile +update +url +version +view +vla +vlss +vo +wcs +web +width +zscale +zoom +
2mass
+
Support for 2MASS Digital Sky Survey.
+Syntax: +2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +string value = ds9.get(string cmd) +2mass name +2mass coord +2mass size +2mass save +2mass frame +2mass survey + +ds9.set(string cmd) +2mass +2mass m31 +2mass name m31 +2mass name clear +2mass 00:42:44.404 +41:16:08.78 +2mass size 60 60 arcmin +2mass save yes +2mass frame current +2mass update frame +2mass survey j +2mass open +2mass close +
3d
+
Support for 3D frame.
+Syntax: +3d [] +   [view <az> <el>] +   [az <az>] +   [el <el>] +   [scale <scale>] +   [method mip|aip] +   [background none|azimuth|elevation] +   [border yes|no] +   [border color <color>] +   [highlite yes|no] +   [hightlite color <color>] +   [compass yes|no] +   [compass color <color>] +   [match] +   [lock [yes|no]] +   [open|close] + +Example: +string value = ds9.get(string cmd) +3d view +3d az +3d el +3d scale +3d method +3d background +3d border +3d border color +3d highlite +3d highlite color +3d compass +3d compass color +3d lock + +ds9.set(string cmd) +3d # create new 3D frame +3d view 45 30 +3d az 45 +3d el 30 +3d scale 10 +3d method mip +3d background azimuth +3d border yes +3d border color red +3d highlite yes +3d highlite color red +3d compass yes +3d compass color red +3d match +3d lock yes +3d open +3d close +
about
+
Get DS9 credits.
+Syntax: +about + +Example: +string value = ds9.get(string cmd) +about +
align
+
Controls the World Coordinate System alignment for the current frame.
+Syntax: +align [] +    [yes|no] + +Example: +string value = ds9.get(string cmd) +align + +ds9.set(string cmd) +align yes
+
analysis
+
Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message and display text in the text dialog window.
+Syntax: +analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +string value = ds9.get(string cmd) +analysis +analysis task +analysis entry {Please enter something} +analysis entry okcancel {Hello World} + +ds9.set(string cmd) +analysis 0 # invoke first analysis task +analysis task 0 +analysis task foobar +analysis task {foo bar} +analysis my.ans +analysis load my.ans +analysis clear +analysis clear load my.ans +analysis message {This is a message} +analysis text {this is text} + +ds9.set(string cmd, string url) +analysis load +analysis text
+
array
+
Load raw data array into current frame.
+Syntax: +array [native|little|big] +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +string url = ds9.get(string cmd) +array +array little + +ds9.set(string command, string url) +array foo.arr[dim=512,bitpix=-32,endian=little] +array new foo.arr[dim=512,bitpix=-32,endian=little] +array mask foo.arr[dim=512,bitpix=-32,endian=little] +
bg
+background
+
Set image background color.
+Syntax: +bg <color> + +Example: +string url = ds9.get(string cmd) +bg + +ds9.set(string cmd) +bg red
+
backup
+
Create a backup save set.
+Syntax: +backup <filename> + +Example: +ds9.set(string cmd) +backup ds9.bck
+
bin
+
Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking is provided for backward compatibility.
+Syntax: +bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<vector>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +bin about +bin buffersize +bin cols +bin factor +bin depth +bin filter +bin function +bin smooth +bin smooth function +bin smooth radius +bin lock + +ds9.set(string cmd) +bin about 4096 4096 +bin about center +bin buffersize 512 +bin cols detx dety +bin colsz detx dety time +bin factor 4 +bin factor 4 2 +bin depth 10 +bin filter 'pha > 5' +bin filter clear +bin function sum +bin in +bin out +bin to fit +bin match +bin lock yes +bin open +bin close +
blink
+
Blink mode parameters. Interval is in seconds.
+Syntax: +blink [] +    [yes|no] +    [interval <value>] + +Example: +string value = ds9.get(string cmd) +blink +blink interval + +ds9.set(string cmd) +blink +blink yes +blink interval 1
+
block
+
Controls blocking parameters.
+Syntax: +block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +block +block lock + +ds9.set(string cmd) +block4 +block4 2 +blockto 4 +blockto 4 2 +blockin +blockout +blockto fit +blockmatch +blocklock yes +blockopen +blockclose +
catalog
+cat
+
Support for catalogs. The first three commands will create a new catalog search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +catalog [new] +    [ned|simbad|denis|skybot] +    [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> <coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match] +    [<ref>] [match <ref> <ref>] +    [<ref>] [match error <value> degrees|arcmin|arcsec] +    [<ref>] [match function 1and2|1not2|2not1] +    [<ref>] [match return 1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> <xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send <application>] +    [<ref>] [save <filename>] +    [<ref>] [servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>] +    [<ref>] [symbol [#] text|size|size2|units|angle <value>] +    [<ref>] [symbol shape circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box point|diamond point|cross point|x point|arrow point|boxcircle point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load <filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +string value = ds9.get(string cmd) +catalog +catalog header + +ds9.set(string cmd) +catalog new +catalog 2mass +catalog cds 2mass +catalog cds{I/252} + +catalog load foo.xml +catalog import tsv foo.tsv + +catalog coordinate 202.48 47.21 fk5 +catalog allrows +catalog allcols +catalog cancel +catalog clear +catalog close +catalog crosshair +catalog dec DEC +catalog edit yes +catalog export tsv bar.tsv +catalog filter {$Jmag>10} +catalog filter load foo.flt +catalog header +catalog location 500 +catalog match error 2 arcsec +catalog match function 1and2 +catalog match unique no +catalog match return 1only +catalog match # last two catalogs loaded +catalog match 2mass csc +catalog maxrows 2000 +catalog name m51 +catalog panto no +catalog plot{$Jmag} {$Hmag} {$e_Jmag} {$e_Hmag} +catalog print +catalog psky fk5 +catalog psystem wcs +catalog ra RA +catalog regions +catalog retrieve +catalog samp broadcast +catalog samp send aladin +catalog save foo.xml +catalog server sao +catalog show yes +catalog radius 1 degrees +catalog symbol condition{$Jmag>15} +catalog symbol 2 shape{boxcircle point} +catalog symbol color red +catalog symbol font times +catalog symbol fontsize 14 +catalog symbol fontweight bold +catalog symbol fontslant italic +catalog symbol add +catalog symbol 2 remove +catalog symbol load foo.sym +catalog symbol save bar.sym +catalog sky fk5 +catalog skyformat degrees +catalog sort {Jmag} incr +catalog system wcs +catalog update +catalog x RA +catalog y DEC +
cd
+
Sets/Returns the current working directory.
+Syntax: +cd [<directory>] + +Example: +string value = ds9.get(string cmd) +cd + +ds9.set(string cmd) +cd /home/mrbill +
cmap
+
Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to 10 and bias value from 0 to 1.
+Syntax: +cmap [<colormap>] +    [file] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<constrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +string value = ds9.get(string cmd) +cmap +cmap file +cmap invert +cmap value + +ds9.set(string cmd) +cmap Heat +cmap load foo.sao +cmap save bar.sao +cmap invert yes +cmap 5 .5 +cmap tag load foo.tag +cmap tag save foo.tag +cmap tag delete +cmap open +cmap close +
colorbar
+
Controls colorbar parameters.
+Syntax: +colorbar [] +    [yes|no] +    [orientation] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] + +Example: +string value = ds9.get(string cmd) +colorbar +colorbar orientation +colorbar numerics +colorbar space +colorbar font +colorbar fontsize +colorbar fontweight +colorbar fontslant +colorbar size +colorbar ticks +colorbar lock + +ds9.set(string cmd) +colorbar yes +colorbar vertical +colorbar numerics yes +colorbar space value +colorbar font times +colorbar fontsize 14 +colorbar fontwieght bold +colorbar fontslant italic +colorbar size 20 +colorbar ticks 11 +colorbar match +colorbar lock yes
+
console
+
Display tcl console window.
+Syntax: +-console + +Example: +ds9.set(string cmd) +console +
contour
+
Controls contours in the current frame.
+Syntax: +contour [] +    [yes|no] +    [<coordsys> [<skyframe>]] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> <skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> <width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [scale log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +contour +contour wcs fk5 +contour color +contour width +contour dash +contour smooth +contour method +contour nlevels +contour scale +contour log exp +contour mode +contour scope +contour limits +contour levels + +ds9.set(string cmd) +contour +contour yes +contour clear +contour generate +contour load ds9.ctr +contour save ds9.con +contour save ds9.con wcs fk5 +contour convert +contour load levels ds9.ctr +contour save levels ds9.lev +contour copy +contour paste +contour paste wcs red 2 no +contour color yellow +contour width 2 +contour dash yes +contour smooth 5 +contour method smooth +contour nlevels 10 +contour scale sqrt +contour log exp 1000 +contour mode zscale +contour scope local +contour limits 1 100 +contour levels 1 10 100 1000 +contour open +contour close +
crop
+
Set current image display area.
+Syntax: +crop [<x> <y> <width> <height> [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3dzmin zmax <coordsys>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +crop # get crop in physical coords +crop wcs galactic sexagesimal arcsec +crop lock + +ds9.set(string cmd) +crop 40 30 10 20 # set crop in physical coords +crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs galactic arcsec +crop match wcs +crop lock wcs +crop reset +crop 3d .25 .5 wcs +crop open +crop close +
crosshair
+
Controls the current position of the crosshair in the current frame. DS9 is placed in crosshair mode when the crosshair is set.
+Syntax: +crosshair [<x> <y> <coordsys> [<skyframe>]] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +string value = ds9.get(string cmd) +crosshair # get crosshair in physical coords +crosshair wcs fk4 sexagesimal # get crosshair in wcs coords +crosshair lock + +ds9.set(string cmd) +crosshair 100 100 physical # set crosshair in physical +crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords +crosshair 23:01:00 +58:52:51 wcs fk5 +crosshair match wcs +crosshair lock wcs +
cube
+
Controls FITS cube.
+Syntax: +cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +cube +cube wcs +cube interval +cube lock +cube order +cube axes lock + +ds9.set(string cmd) +cube +cube play +cube last +cube 3 +cube 4.4 wcs +cube interval 2 +cube match wcs +cube lock wcs +cube order 123 +cube axes lock yes +cube open +cube close
+
cursor
+
Move mouse pointer or crosshair in image pixels in the current frame. Note, this will move selected Regions also.
+Syntax: +cursor [<x> <y>] + +Example: +ds9.set(string cmd) +cursor 10 10 +
data
+
Return an array of data values given a lower left corner and a width and height in specified coordinate system. The last argument of yes indicates to strip the coordinates from the output and just list the data values. The default is yes.
+Syntax: +data [<coordsys> [<skyframe>] <x> <y> <width> <height> [yes|no]] + +Example: +string url = ds9.get(string cmd) +data image 450 520 3 3 yes +data physical 899 1039 6 6 no +data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no +data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 no +
dsssao
+dss
+
Support for Digital Sky Survey at SAO.
+Syntax: +dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dsssao name +dsssao coord +dsssao size +dsssao save +dsssao frame + +ds9.set(string cmd) +dsssao +dsssao m31 +dsssao name m31 +dsssao name clear +dsssao 00:42:44.404 +41:16:08.78 +dsssao size 60 60 arcmin +dsssao save yes +dsssao frame current +dsssao update frame +dsssao open +dsssao close +
dsseso
+
Support for Digital Sky Survey at ESO.
+Syntax: +dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dsseso name +dsseso coord +dsseso size +dsseso save +dsseso frame +dsseso survey + +ds9.set(string cmd) +dsseso +dsseso m31 +dsseso name m31 +dsseso name clear +dsseso 00:42:44.404 +41:16:08.78 +dsseso size 60 60 arcmin +dsseso save yes +dsseso frame current +dsseso update frame +dsseso survey DSS2-red +dsseso open +dsseso close +
dssstsci
+
Support for Digital Sky Survey at STSCI.
+Syntax: +dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +string value = ds9.get(string cmd) +dssstsci name +dssstsci coord +dssstsci size +dssstsci save +dssstsci frame +dssstsci survey + +ds9.set(string cmd) +dssstsci +dssstsci m31 +dssstsci name m31 +dssstsci name clear +dssstsci 00:42:44.404 +41:16:08.78 +dssstsci size 60 60 arcmin +dssstsci save yes +dssstsci frame current +dssstsci update frame +dssstsci survey all +dssstsci open +dssstsci close
+
envi
+
Load an ENVI header and file. Optional parameter: array endian.
+Syntax: envi [new] <header> [<filename>] Example: ds9.set(string cmd) envi foo.hdr envi new foo.hdr envi foo.hdr foo.bsq
+
+exit
+
quit
+
Quits DS9.
+Syntax: +exit +quit + +Example: +ds9.set(string cmd) +exit
+
export
+
Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method.
+Syntax: +export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> +export array <filename>[big|little|native] +export nrrd <filename>[big|little|native] +export envi <header> [<filename>][big|little|native] +export jpeg <filename>[1-100] +export tiff <filename>[none|jpeg|packbits|deflate] + +Example: + +ds9.set (string cmd) +export array foo.arr little +export nrrd foo.nrrd little +export envi foo.hdr little +export envi foo.hdr foo.bsq little +export tiff foo.tiff jpeg +export jpeg foo.jpeg 75 +export png foo.png
+
file
+
Query currently loaded file information.
+Syntax: +file + +Example: +string value = ds9.get(string cmd) +file +
fits
+
Load a FITS image into the current frame or query the currently loaded image.
+Syntax: +fits[new|mask|slice] [<filename>] +    [width|height|depth|bitpix|type] +    [size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +    [header [<ext>] [keyword <string>]] +    [image|table|slice] + +Example: +string value = ds9.get(string cmd) +fits +fits width +fits height +fits depth +fits bitpix +fits size +fits size wcs fk5 arcmin +fits header # primary +fits header 2 # hdu 2 +fits header -2 # hdu 2 with inherit +fits header keyword BITPIX +fits header 1 keyword BITPIX +fits image +fits table +fits slice + +ds9.set(string cmd, string url) +fits foo.fits +fits new foo.fits +fits bar.fits[bin=detx,dety] +fits slice foo.fits +fits mask foo.fits + frame +
Controls frame functions. Frames may be created, deleted, reset, and centered. While return the current frame number. If you goto a frame that does not exists, it will be created. If the frame is hidden, it will be shown. The 'frameno' option is available for backward compatibility.
+Syntax: +frame [center [#|all]] +    [clear [#|all]] +    [new [rgb|3d]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] +    [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] +    [has contour [aux]]] +    [has fits [ |bin|cube|mosaic]] +    [has marker [highlite|paste|select|undo]] +    [has system <coordsys>] +    [has wcs [<wcssys>]] +    [has wcs celestial [<wcssys>]] +    [has wcs linear [<wcssys>]] + +Example: +string value = ds9.get(string cmd) +frame # returns the id of the current frame +frame frameno # returns the id of the current frame +frame all # returns the id of all frames +frame active # returns the id of all active frames +frame lock +frame has amplifier +frame has datamin +frame has datasec +frame has detector +frame has grid +frame has iis +frame has irafmin +frame has physical +frame has smooth +frame has contour +frame has contour aux +frame has fits +frame has fits bin +frame has fits cube +frame has fits mosaic +frame has marker highlite +frame has marker paste +frame has marker select +frame has marker undo +frame has system physical +frame has wcs wcsa +frame has wcs celestial wcsa +frame has wcs linear wcsa + +ds9.set(string cmd) +frame center # center current frame +frame center 1 # center 'Frame1' +frame center all # center all frames +frame clear # clear current frame +frame new # create new frame +frame new rgb # create new rgb frame +frame delete # delete current frame +frame reset # reset current frame +frame refresh # refresh current frame +frame hide # hide current frame +frame show 1 # show frame 'Frame1' +frame move first # move frame to first in order +frame move back # move frame back in order +frame move forward # move frame forward in order +frame move last # move frame to last in order +frame first # goto first frame +frame prev # goto prev frame +frame next # goto next frame +frame last # goto last frame +frame frameno 4 # goto frame 'Frame4', create if needed +frame 3 # goto frame 'Frame3', create if needed +frame match wcs +frame lock wcs
+
gif
+
Load GIF image into current frame.
+Syntax: +gif [new|slice] [<filename>] + +Example: +string value = ds9.get(string cmd) +gif + +ds9.set(string cmd) +gif foo.gif +gif new foo.gif +gif slice foo.gif +
grid
+
Controls coordinate grid. For grid numeric format syntax, click here.
+Syntax: +grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +grid +grid type +grid system +grid sky +grid skyformat +grid grid +grid grid color +grid grid width +grid grid dash +grid grid gap1 +grid grid gap2 +grid grid gap3 +grid axes +grid axes color +grid axes width +grid axes dash +grid axes type +grid axes origin +grid format1 +grid format2 +grid tickmarks +grid tickmarks color +grid tickmarks width +grid tickmarks dash +grid border +grid border color +grid border width +grid border dash +grid numerics +grid numerics font +grid numerics fontsize +grid numerics fontweight +grid numerics fontslant +grid numerics color +grid numerics gap1 +grid numerics gap2 +grid numerics gap3 +grid numerics type +grid numerics vertical +grid title +grid title text +grid title def +grid title gap +grid title font +grid title fontsize +grid title fontweight +grid title fontslant +grid title color +grid labels +grid labels text1 +grid labels text2 +grid labels def1 +grid labels def2 +grid labels gap1 +grid labels gap2 +grid labels font +grid labels fontsize +grid labels fontweight +grid labels fontslant +grid labels color + +ds9.set(string cmd) +grid +grid yes +grid type analysis +grid system wcs +grid sky fk5 +grid skyformat degrees +grid grid yes +grid grid color red +grid grid width 2 +grid grid dash yes +grid grid gap1 10 +grid grid gap2 10 +grid grid gap3 10 +grid axes yes +grid axes color red +grid axes width 2 +grid axes dash yes +grid axes type exterior +grid axes origin lll +grid format1 d.2 +grid format2 d.2 +grid tickmarks yes +grid tickmarks color red +grid tickmarks width 2 +grid tickmarks dash yes +grid border yes +grid border color red +grid border width 2 +grid border dash yes +grid numerics yes +grid numerics font courier +grid numerics fontsize 12 +grid numerics fontweight bold +grid numerics fontslant italic +grid numerics color red +grid numerics gap1 10 +grid numerics gap2 10 +grid numerics gap3 10 +grid numerics type exterior +grid numerics vertical yes +grid title yes +grid title text {Hello World} +grid title def yes +grid title gap 10 +grid title fontsize 12 +grid title font courier +grid title fontweight bold +grid title fontslant italic +grid title color red +grid labels yes +grid labels text1 {Hello World} +grid labels text2 {Hello World} +grid labels def1 yes +grid labels def2 yes +grid labels gap1 10 +grid labels gap2 10 +grid labels font courier +grid labels fontsize 12 +grid labels fontweight bold +grid labels fontslant italic +grid labels color red +grid reset +grid load foo.grd +grid save foo.grd +grid open +grid close +
header
+
Display current fits header dialog. Optional extension number maybe specified. Please note, this differs from samp fits header.
+Syntax: +header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +string value = ds9.get(string cmd) +header +header 2 +header close +
height
+
Set the height of the image display window.
+Syntax: +height [<value>] + +Example: +string value = ds9.get(string cmd) +height + +ds9.set(string cmd) +height 512 +
iconify
+
Toggles iconification.
+Syntax: +iconify [] +    [yes|no] + +Example: +string value = ds9.get(string cmd) +iconify + +ds9.set(string cmd) +iconify +iconify yes
+
iexam
+
Interactive examine function. A blinking cursor will indicate to the user to click on a point on an image. The specified information will be returned at that time. The default event is button. In the last form, the following macros will be expanded if present: $width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, $x, $y, $z. See Analysis Macros for more information.
+Syntax: +iexam [] +    [[]|button|key|any] coordinate <coordsys> [<skyframe>] [<skyformat>] +    [[]|button|key|any] data [width][height] +    [[]|button|key|any] <macro string>] + +Example: +string value = ds9.get(string cmd) +iexam +iexam coordinate image +iexam key coordinate image # return coordinate and key event +iexam coordinate wcs fk5 degrees +iexam coordinate wcs galactic sexagesimal +iexam coordinate fk5 +iexam data # return data value +iexam key data # return data value and key event +iexam data 3 3 # return all data in 3x3 box about selected point +iexam {'Click at $x,$y in file $filename'} +
iis
+
Set/Get IIS Filename. Optional mosaic number maybe supplied.
+Syntax: +iis [filename <filename> [#]] + +Example: +string value = ds9.get(string cmd) +iis filename +iis filename 4 + +ds9.set(string cmd) +iis filename foo.fits +iis filename bar.fits 4
+
jpeg
+
Load JPEG image into current frame. Optional parameters: jpeg quality (1-100)
+Syntax: +jpeg [new|slice] [<filename>] [1-100] + +Example: +string value = ds9.get(string cmd) +jpeg + +ds9.set(string cmd) +jpeg foo.jpeg +jpeg new foo.jpeg +jpeg slice foo.jpeg +
lock
+
Lock all other frames to the current frame.
+Syntax: +lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimits [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +string value = ds9.get(string cmd) +lock frame +lock crosshair +lock crop +lock slice +lock bin +lock axes +lock scale +lock scalelimits +lock colorbar +lock block +lock smooth +lock 3d + +ds9.set(string cmd) +lock frame wcs +lock crosshair wcs +lock crop wcs +lock slice wcs +lock bin yes +lock axes yes +lock scale yes +lock scalelimits yes +lock colorbar yes +lock block yes +lock smooth yes +lock 3d yes + lower +
Lower in the window stacking order.
+Syntax: +lower + +Example: +ds9.set(string cmd) +lower +
magnifier
+
Controls the magnifier settings.
+Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +string value = ds9.get(string cmd) +magnifier color +magnifier zoom +magnifier cursor +magnifier region + +ds9.set(string cmd) +magnifier color yellow +magnifier zoom 2 +magnifier cursor no +magnifier region no +
mask
+
Controls mask parameters.
+Syntax: +mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] + +Example: +string value = ds9.get(string cmd) +mask color +mask mark +mask range +mask system +mask transparency + +ds9.set(string cmd) +mask color red +mask mark zero +mask range 10 100 +mask transparency 50 +mask system wcs +mask clear +mask open +mask close +
match
+
Match all other frames to the current frame.
+Syntax: +match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +ds9.set(string cmd) +match frame wcs +match crosshair wcs +match crop wcs +match slice wcs +match bin +match axes +match scale +match scalelimits +match colorbar +match block +match smooth +match 3d +
mecube
+
Load FITS multiple extension file as data cube.
+Syntax: +mecube [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +mecube + +ds9.set(string cmd) +mecube foo.fits +mecube new foo.fits +
minmax
+
This is how DS9 determines the min and max data values from the data. SCAN will scan all data.
+Syntax: +minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +string value = ds9.get(string cmd) +minmax mode +minmax sample + +ds9.set(string cmd) +minmax scan +minmax mode scan +minmax interval 100 +
mode
+
Controls the first mouse button mode.
+Syntax: +mode [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + +Example: +string value = ds9.get(string cmd) +mode + +ds9.set(string cmd) +mode crosshair
+
mosaic
+
Load FITS mosaic segment into current frame.
+Syntax: +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + +Example: +string value = ds9.get(string cmd) +mosaic + +ds9.set(string cmd) +mosaic foo.fits +mosaic wcs foo.fits +mosaic wcs new foo.fits +mosaic wcs mask foo.fits +
mosaicimage
+
Load FITS mosaic image into current frame.
+Syntax: +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] [<filename>] + +Example: +string value = ds9.get(string cmd) +mosaicimage +ds9.set(string cmd) +mosaicimage foo.fits +mosaicimage wcs foo.fits +mosaicimage wcs new foo.fits +mosaicimage wcs mask foo.fits +
movie
+
Create a movie from snap shots of the DS9 window. A slice movie cycles though all slices of a cube. A frame movie cycles through all active frames. A 3d movie cycles through specified viewing angles. The default action is slice. Movie types are either MPEG or Animated GIF, with default MPEG. Optional parameters for 3d: number of frames, azimuth from/to, elevation from/to, slice from/to, oscillate/repeat times.
+Syntax: +movie[slice|frame|3d][mpeg|gif] <filename> +movie 3d [mpeg|gif] <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>] + +Example: +ds9.set(string cmd) +movie slice mpeg ds9.mpg +movie frame gif ds9.gif +movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate 1 +
multiframe
+
Load FITS multiple extension file as multiple images.
+Syntax: +multiframe [<filename>] + +Example: +ds9.set(string cmd) +multiframe foo.fits
+
nameserver
+
Support Name Server functions. Coordinates are in fk5.
+Syntax: +nameserver [<object>] +    [name <object>] +    [server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [close] + +Example: +string value = ds9.get(string cmd) +nameserver +nameserver server +nameserver skyformat +nameserver m31 + +ds9.set(string cmd) +nameserver m31 +nameserver name m31 +nameserver server ned-sao +nameserver skyformat sexagesimal +nameserver pan +nameserver crosshair +nameserver open +nameserver close +
nan
+
Set image not-a-number color.
+Syntax: +nan <color> + +Example: +string value = ds9.get(string cmd) +nan + +ds9.set(string cmd) +nan red
+
nrrd
+
Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: array endian.
+Syntax: +nrrd [native|little|big] +nrrd [new|mask] [<filename>] + +Example: +string value = ds9.get(string cmd) +nrrd +nrrd big + +ds9.set(string cmd, string url) +nrrd foo.nrrd +nrrd new foo.nrrd +nrrd mask foo.nrrd
+
nvss
+
Support for NRAO VLA Sky Survey.
+Syntax: +nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +nvss name +nvss coord +nvss size +nvss save +nvss frame + +ds9.set(string cmd) +nvss +nvss m31 +nvss name m31 +nvss name clear +nvss 00:42:44.404 +41:16:08.78 +nvss size 60 60 arcmin +nvss save yes +nvss frame current +nvss update frame +nvss open +nvss close +
orient
+
Controls the orientation of the current frame.
+Syntax: +orient [none|x|y|xy] +    [open|close] + +Example: +string value = ds9.get(string cmd) +orient + +ds9.set(string cmd) +orient xy +orient open +orient close +
pagesetup
+
Controls Page Setup options.
+Syntax: +pagesetup [orient portrait|landscape] +    [scale <numeric>] +    [size letter|legal|tabloid|poster|a4] + +Example: +string value = ds9.get(string cmd) +pagesetup orient +pagesetup scale +pagesetup size + +ds9.set(string cmd) +pagesetup orient portrait +pagesetup scale 50 +pagesetup size poster +
pan
+
Controls the current image cursor location for the current frame.
+Syntax: +pan [<coordsys> [<skyframe>] [<skyformat>]] # get current coords + +pan [<x> <y> <coordsys> [<skyframe>]] # relative +    [to <x> <y> <coordsys> [<skyframe>]] # absolute +    [open|close] +    [close] + +Example: +string value = ds9.get(string cmd) +pan # get current image coords +pan wcs fk4 sexagesimal # get current wcs coords + +ds9.set(string cmd) +pan 200 200 image # pan relative +pan to 400 400 physical # pan to physical coords +pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords +pan open +pan close +
pixeltable
+
Display/Hide the pixel table.
+Syntax: +pixeltable [] +    [yes|open] +    [no|close] + +Example: +string url = ds9.get(string cmd) +pixeltable + +ds9.set(string cmd) +pixeltable +pixeltable yes +pixeltable open +pixeltable close +
plot
+
Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is assumed to be a pair of coordinates, with optional error values. The follow are valid data descriptions:
+
xy    x and y coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y errors
+
To create a new plot, use the plot new command.
+Syntax: +# create new empty plot window +plot [] +    [line|bar|scatter] +    [new] +    [new line|bar|scatter] +    [new name <plotname>] +    [new name <plotname> line|bar|scatter] + +#load data into existing plot from stdin +plot [[<plotname>] data xy|xyex|xyey|xyexey] + +# existing plot +plot[[<plotname>] load <filename> xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig <filename>] +    [[<plotname>] saveconfig <filename>] +    [[<plotname>] pagesetup orient portrait|landscape] +    [[<plotname>] pagesetup size letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination printer|file] +    [[<plotname>] print command <command>] +    [[<plotname>] print filename <filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>]export[gif|tiff|jpeg|png]<filename> +    [[<plotname>]export jpeg <filename>[1-100] +    [[<plotname>]export tiff <filename>[none|jpeg|packbits|deflate] + +# configure graph +plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min <value>] +    [[<plotname>] axis x|y max <value>] +    [[<plotname>] axis x|y format <string>] +    [[<plotname>] background <value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position right|left|top|bottom] +    [[<plotname>] font title|labels|numbers font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize <value>] +    [[<plotname>] fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y <string>] +    [[<plotname>] barmode normal|stacked|aligned|overlap] + +# configure current dataset +plot [[<plotname>] show yes|no] +    [[<plotname>] shape none|circle|square|diamond|plus|splus|scross|triangle|arrow] +    [[<plotname>] shape fill yes|no] +    [[<plotname>] shape color <value>] +    [[<plotname>] smooth step|linear|cubic|quadratic|catrom] +    [[<plotname>] color <value>] +    [[<plotname>] width <value>] +    [[<plotname>] dash yes|no] +    [[<plotname>] error yes|no] +    [[<plotname>] error color <value>] +    [[<plotname>] error cap yes|no] +    [[<plotname>] error width <value>] +    [[<plotname>] name <string>] + +# select current dataset +plot [[<plotname>] select <value>] + +Example: +# return all plotnames +string value = ds9.get(string cmd) +plot + +# create new empty plot window +ds9.set(string cmd) +plot +plot bar +plot new +plot new bar +plot new name foo +plot new name foo bar + +# existing plot +string value = ds9.get(string cmd) +plot stats +plot list + +ds9.set(string cmd) +plot load foo.dat xy +plot save foo.dat +plot clear +plot duplicate 1 +plot stats yes +plot list yes +plot loadconfig foo.plt +plot saveconfig foo.plt +plot pagesetup orient portrait +plot pagesetup size letter +plot print +plot print destination file +plot print command lp +plot print filename foo.ps +plot print color rgb +plot close + +# plot mode +string value = ds9.get(string cmd) +plot mode + +ds9.set(string cmd) +plot mode pointer + +# export plot +ds9.set(string cmd) +plot export tiff foo.tiff jpeg +plot export jpeg foo.jpeg 75 +plot export png foo.png + +# configure plot +string value = ds9.get(string cmd) +plot axis x grid +plot axis x log +plot axis x flip +plot axis x auto +plot axis x min +plot axis x max +plot axis x format +plot background +plot legend +plot legend position +plot font numbers font +plot font numbers size +plot font numbers weight +plot font numbers slant +plot title +plot title x + +ds9.set(string cmd) +plot axis x grid yes +plot axis x log yes +plot axis x flip yes +plot axis x auto no +plot axis x min 0 +plot axis x max 100 +plot axis x format "%f" +plot background white +plot legend yes +plot legend position left +plot font numbers font times +plot font numbers size 12 +plot font numbers weight bold +plot font numbers slant italic +plot title "This is a Title" +plot title x "X Axis" +plot title y "Y Axis" +plot title legend "This is the Legend" + +# bar plot +string value = ds9.get(string cmd) +plot barmode + +ds9.set(string cmd) +plot barmode aligned + +# configure current dataset +string value = ds9.get(string cmd) +plot show +plot shape +plot shape fill +plot shape color +plot smooth +plot color +plot width +plot dash +plot error +plot error color +plot error cap +plot error width +plot name + +ds9.set(string cmd) +plot show yes +plot shape circle +plot shape fill no +plot shape color cyan +plot smooth step +plot color red +plot width 2 +plot dash yes +plot error yes +plot error color red +plot error cap yes +plot error width 2 +plot name "My Data" + +# select current dataset +string value = ds9.get(string cmd) +plot select + +ds9.set(string cmd) +plot select 2 + +
png
+
Load PNG image into current frame.
+Syntax: +png [new|slice] [<filename>] + +Example: +string value = ds9.get(string cmd) +png + +ds9.set(string cmd) +png foo.png +png new foo.png +png slice foo.png
+
precision
+
Set region and coordinate output format precision.
+Syntax: +precision <linear><degree><hms><dms><arcmin><arcsec> + +Example: +string value = ds9.get(string cmd) +precision + +ds9.set(string cmd) +precision 8 10 4 3 5 3 +
prefs
+
Controls various preference settings.
+Syntax: +prefs [clear] +    [irafalign yes|no] + +Example: +string value = ds9.get(string cmd) +prefs irafalign + +ds9.set(string cmd) +prefs clear +prefs irafalign + preserve +
Preserve the follow attributes while loading a new image.
+Syntax: +preserve [pan yes|no] +    [regions yes|no] + +Example: +string value = ds9.get(string cmd) +preserve pan +preserve regions + +ds9.set(string cmd) +preserve pan yes +preserve regions yes +
psprint
+
Invokes postscript printing. Please see print for further details.
+
print
+
Controls printing. Use print option to set printing options.
+Syntax: +print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    [resolution72|screen|96|144|150|225|300|600|1200] + +Example: +string value = ds9.get(string cmd) +print destination +print command +print filename +print color +print level +print resolution + +ds9.set(string cmd) +print +print destination file +print command lp +print filename foo.ps +print color cmyk +print level 2 +print resolution 96 +
raise
+
Raise in the window stacking order.
+Syntax: +raise + +Example: +ds9.set(string cmd) +raise +
regions
+
Controls regions in the current frame.
+Syntax: +regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration <value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color &ltcolor>] +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> <dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [groups] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color <color>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> <int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] +    [include|exclude|source|background|selected] +    [-format ds9|ciao|saotng|saoimage|pros|xy] +    [-system image|physical|wcs|wcsa...wcsz] +    [-sky fk4|fk5|icrs|galactic|ecliptic] +    [-skyformat degrees|sexagesimal] +    [-prop select|edit|move|rotate|delete|fixed|include|source 1|0] +    [-group <tag>] +    [-strip yes|no] +    [-wcs yes|no] + +Example: +string url = ds9.get(string cmd) +regions +regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal -prop edit 1 -group foo +string value = ds9.get(string cmd) +regions epsilon +regions show +regions showtext +regions centroid +regions centroid auto +regions centroid radius +regions centroid iteration +regions selected +regions format +regions system +regions sky +regions skyformat +regions strip +regions shape +regions color +regions width +regions source +regions background +regions include +regions exclude +regions selected +regions groups + +ds9.set(string cmd) +regions foo.reg +regions -format ciao bar.reg # load as ciao format +regions foo.fits # FITS regions files do not need a format specification +regions load foo.reg # load foo.reg into current frame +regions load all foo.reg # load foo.reg into all frames +regions load *.reg# expand *.reg and load into current frame +regions load all *.reg # expand *.reg and load into all frames +regions save foo.reg +regions list +regions list close +regions epsilon 5 +regions show yes +regions showtext no +regions centroid +regions centroid auto yes +regions centroid radius 10 +regions centroid iteration 20 +regions getinfo +regions move back +regions move front +regions select all +regions select none +regions select invert +regions delete all +regions delete select +regions format ds9 +regions system wcs +regions sky fk5 +regions skyformat degrees +regions strip yes +regions shape ellipse +regions color red +regions width 3 +regions edit yes +regions include +regions command "circle 100 100 20 # color=red" +regions composite +regions dissolve +regions template foo.tpl +regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 +regions savetemplate foo.tpl +regions group new +regions group foo new +regions group foo update +regions group foo select +regions group foo color red +regions group foo copy +regions group foo delete +regions group foo cut +regions group foo font 'times 14 bold' +regions group foo move 100 100 +regions group foo movefront +regions group foo moveback +regions group foo property delete no +regions copy +regions cut +regions paste wcs +regions undo +
restore
+
Restore DS9 to a previous state from a backup save set.
+Syntax: +restore <filename> + +Example: +restore ds9.bck
+
rgb
+
Create RGB frame and control RGB frame parameters.
+Syntax: +rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +    [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +rgb channel +rgb lock wcs +rgb lock crop +rgb lock slice +rgb lock bin +rgb lock scale +rgb lock scalelimits +rgb lock colorbar +rgb lock block +rgb lock smooth +rgb system +rgb view red +rgb view green +rgb view blue + +ds9.set(string cmd) +rgb # create new rgb frame +rgb red # set current channel to red +rgb channel red # set current channel to red +rgb view blue no # turn off blue channel +rgb system wcs # set rgb coordinate system +rgb lock wcs yes +rgb lock crop yes +rgb lock slice yes +rgb lock bin yes +rgb lock scale yes +rgb lock scalelimits yes +rgb lock colorbar yes +rgb lock block yes +rgb lock smooth yes +rgb open +rgb close
+
rgbarray
+
Load raw data array cube into rgb frame.
+Syntax: +rgbarray [native|big|little] +rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +string value = ds9.get(string cmd) +rgbarray + +ds9.set(string cmd) +rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
+
rgbcube
+
Load FITS rgbcube into rgb frame.
+Syntax: +rgbcube [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +rgbcube + +ds9.set(string cmd) +rgbcube foo.fits +rgbcube new foo.fits
+
rgbimage
+
Load FITS rgbimage into rgb frame.
+Syntax: +rgbimage [new] [<filename>] + +Example: +string value = ds9.get(string cmd) +rgbimage + +ds9.set(string cmd) +rgbimage foo.fits +rgbimage new foo.fits +
rotate
+
Controls the rotation angle (in degrees) of the current frame.
+Syntax: +rotate [<value>] +    [to <value>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +rotate + +ds9.set(string cmd) +rotate 45 +rotate to 30 +rotate open +rotate close
+
samp
+
Configure SAMP protocol.
+Syntax: +samp [no|disconnect] +    [broadcast [image|table]] +    [send [image|table] <application>] + +Example: + +ds9.set(string cmd) +samp no +samp disconnect +samp broadcast image +samp send image aladin +
save
+
Save loaded image data of current frame as FITS.
+Syntax: +save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] <filename> [image|table|slice] + +Example: +ds9.set(string cmd) +save foo.fits +save fits foo.fits image +save fits foo.fits table +save fits foo.fits slice +save rgbimage foo.fits +save rgbcube foo.fits +save mecube foo.fits +save mosaic foo.fits +save mosaicimage foo.fits
+
saveimage
+
Create a snap shot of the current DS9 window and save in specified image format. If no format specified, the file name extension is used to determine the output format. Optional parameters: jpeg quality (1-100) and tiff compression method.
+Syntax: +saveimage[fits|eps|gif|tiff|jpeg|png]<filename> +saveimage <filename>.jpeg [1-100] +saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +ds9.set(string cmd) +saveimage ds9.tiff +saveimage jpeg ds9.jpeg 75
+
scale
+
Controls the limits and color scale distribution.
+Syntax: +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +scale +scale log exp +scale datasec +scale limits +scale mode +scale scope +scale lock +scale lock limits + +ds9.set(string cmd) +scale linear +scale log exp 100 +scale datasec yes +scale histequ +scale limits 1 100 +scale mode zscale +scale mode 99.5 +scale scope local +scale match +scale match limits +scale lock yes +scale lock limits yes +scale open +scale close +
shm
+
Load a shared memory segment into the current frame.
+Syntax: +shm [<key> [<filename>]] +    [key <key> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> [<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] <id> [<filename>]] +    [rgbcube [key|shmid] <id> [<filename>] +    [rgbimage [key|shmid] <id> [<filename>]] +    [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] +    [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] + +Example: +string value = ds9.get(string cmd) +shm + +ds9.set(string cmd) +shm 102 +shm key 102 +shm shmid 102 foo +shm fits key 100 foo +shm mosaicimage iraf key 100 foo +shm mosaicimage wcs key 100 foo +shm mosaicimage wcsa key 100 foo +shm mosaicimage wfpc2 key 100 foo +shm mosaic iraf key 100 foo +shm mosaic wcs key 100 foo +shm rgbcube key 100 foo +shm rgbimage key 100 foo +shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] +shm array shmid 102 [dim=32,bitpix=-32] + sia
+
Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> <coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +string value = ds9.get(string cmd) +sia + +ds9.set(string cmd) +sia2mass +siacancel +siaclear +siaclose +siacoordinate 202.48 47.21 fk5 +siacrosshair +siaexport tsv bar.tsv +sianame m51 +siaprint +siaretrieve +siasave foo.xml +siaradius 1degrees +siasky fk5 +sia skyformat degrees +siasystem wcs +siaupdate + single +
Select Single Display mode
+Syntax: +single + +Example: +string value = ds9.get(string cmd) +single + +ds9.set(string cmd) +single +
skyview
+
Support for SkyView image server at HEASARC.
+Syntax: +skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +skyview name +skyview coord +skyview size +skyview pixels +skyview save +skyview frame +skyview survey + +ds9.set(string cmd) +skyview +skyview m31 +skyview name m31 +skyview name clear +skyview 00:42:44.404 +41:16:08.78 +skyview size 60 60 arcmin +skyview pixels 600 600 +skyview save yes +skyview frame current +skyview update frame +skyview survey sdssi +skyview open +skyview close +
sleep
+
Delays execution for specified number of seconds. Default is 1 second.
+Syntax: +sleep [#] + +Example: +ds9.set(string cmd) +sleep +sleep 2 +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter =2*radius+1,mean=0Syntax:
+smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +string value = ds9.get(string cmd) +smooth +smooth function +smooth radius +smooth radiusminor +smooth sigma +smooth sigmaminor +smooth angle +smooth lock + +ds9.set(string cmd) +smooth +smooth yes +smooth function tophat +smooth radius 4 +smooth radiusminor 4 +smooth sigma 2.0 +smooth sigmaminor 2.0 +smooth angle 45 +smooth match +smooth lock yes +smooth open +smooth close +
source
+
Source TCL code from a file.
+Syntax: +source [filename] + +Example: +ds9.set(string cmd) +source foo.tcl
+
tcl
+
Execute one TCL command.
+Syntax: +tcl <tcl command> + +Example: +ds9.set(string cmd) +tcl {puts {Hello, World}} +
threads
+
Set number of process threads for functions which are multi-threaded.
+Syntax: +threads # + +Example: +string value = ds9.get(string cmd) +threads +ds9.set(string cmd) +threads 8
+
tiff
+
Load TIFF image into current frame. Optional parameters: tiff compression method.
+Syntax: +tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] + +Example: +string value = ds9.get(string cmd) +tiff +tiff jpeg + +ds9.set(string cmd) +tiff foo.tiff +tiff new foo.tiff +tiff slice foo.tiff
+
tile
+
Controls the tile display mode.
+Syntax: +tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +string value = ds9.get(string cmd) +tile +tile mode +tile grid mode +tile grid direction +tile grid layout +tile grid gap + +ds9.set(string cmd) +tile +tile yes +tile mode row +tile grid +tile grid mode manual +tile grid direction x +tile grid layout 5 5 +tile grid gap 10 +tile row +tile column +
update
+
Updates the current frame or region of frame. In the second form, the first argument is the number of the fits HDU (starting with 1) and the remaining args are a bounding box in IMAGE coordinates. By default, the screen is updated the next available idle cycle. However, you may force an immediate update by specifying the NOW option.
+Syntax: +update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: + +ds9.set(string cmd) +update +update 1 100 100 300 400 +update now +update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+Syntax: +url <url> + +Example: +ds9.set(string cmd) +url http://foo.bar.edu/foo.fits +
version
+
Returns the current version of DS9.
+Syntax: +version + +Example: +string value = ds9.get(string cmd) +version +
view
+
Controls the GUI.
+Syntax: +view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [colorbar horizontal|vertical] +    [colorbar numerics yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no[ +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +string value = ds9.get(string cmd) +view layout +view keyvalue +view info +view panner +view magnifier +view buttons +view colorbar +view graph horizontal +view filename +view object +view keyword +view minmax +view lowhigh +view units +view image +view wcsa +view red +view frame + +ds9.set(string cmd) +view layout vertical +view keyvalue BITPIX +view info yes +view panner yes +view magnifier yes +view buttons yes +view colorbar yes +view graph horizontal yes +view filename yes +view object yes +view keyword yes +view minmax yes +view lowhigh yes +view units yes +view wcsa yes +view frame yes +view red yes +view green yes +view blue yes
+
vla
+
Support for VLA Sky Survey.
+Syntax: +vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +string value = ds9.get(string cmd) +vla name +vla coord +vla size +vla save +vla frame +vla survey + +ds9.set(string cmd) +vla +vla m31 +vla name m31 +vla name clear +vla 00:42:44.404 +41:16:08.78 +vla size 60 60 arcmin +vla save yes +vla frame current +vla update frame +vla survey stripe82 +vla open +vla close +
vlss
+
Support for NRAO VLSS Sky Survey.
+Syntax: +vlss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +string value = ds9.get(string cmd) +vlss name +vlss coord +vlss size +vlss save +vlss frame + +ds9.set(string cmd) +vlss +vlss m31 +vlss name m31 +vlss name clear +vlss 00:42:44.404 +41:16:08.78 +vlss size 60 60 arcmin +vlss save yes +vlss frame current +vlss update frame +vlss open +vlss close
+
vo
+
Invoke an connection to a Virtual Observatory site.
+Syntax: +vo [method xpa|mime] +   [server <url>] +   [internal yes|no] +   [delay #] +   [<url>] +   [connect <url>] +   [disconnect <url>] +   [open|close] + +Example: +string value = ds9.get(string cmd) +vo +vo method +vo server +vo internal +vo delay +vo connect + +ds9.set(string cmd) +vo method xpa +vo server "http://foo.bar.edu/list.txt" +vo internal yes +vo delay 15 +vo chandra-ed +vo connect chandra-ed +vo disconnect chandra-ed +vo open +vo close +
wcs
+
Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info panel, compass, grid, and alignment will be modified accordingly. Also, using this access point, a new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. WCS specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
+Syntax: +wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +string value = ds9.get(string cmd) +wcs +wcs system +wcs sky +wcs skyformat +wcs align + +ds9.set(string cmd) +wcs wcs +wcs system wcs +wcs fk5 +wcs sky fk5 +wcs sexagesimal +wcs skyformat sexagesimal +wcs align yes +wcs reset +wcs reset 3 +wcs replace foo.wcs +wcs replace 3 foo.wcs +wcs append foo.wcs +wcs append 3 foo.wcs +wcs open +wcs close +
web
+
Display specified URL in the web display.
+Syntax: +web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +string value = ds9.get(string cmd) +web + +ds9.set(string cmd) +web www.cnn.com +web new www.cnn.com +web hvweb www.apple.com +web click back +web click 2 +web clear +web close +
width
+
Set the width of the image display window.
+Syntax: +width [<value>] + +Example: +string value = ds9.get(string cmd) +width + +ds9.set(string cmd) +width 512 +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+Syntax: +zscale [] +    [contrast] +    [sample] +    [line] + +Example: +string value = ds9.get(string cmd) +zscale contrast +zscale sample +zscale line + +ds9.set(string cmd) +zscale +zscale contrast .25 +zscale sample 600 +zscale line 120 +
zoom
+
Controls the current zoom value for the current frame.
+Syntax: +zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +string value = ds9.get(string cmd) +zoom + +ds9.set(string cmd) +zoom 2 +zoom 2 4 +zoom to 4 +zoom to 2 4 +zoom in +zoom out +zoom to fit +zoom open +zoom close
+ diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index 71e0814..ca6885b 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -1,3154 +1,2839 @@ - - - - - XPA Access Points - - -
XPA Access Points
-
-
The XPA - messaging system provides seamless communication between DS9 and - other Unix programs, including X programs. It also provides an - easy way for users to communicate with DS9 by executing XPA - client commands in the shell or by utilizing such commands in - scripts. Because XPA works both at the programming level and the - shell level, it is a powerful tool for unifying any analysis - environment.
-
- 2mass - 3d - about - align - analysis - array - background - backup - bin - blink - block - catalog - cd - cmap - colorbar - console - contour - crop - crosshair - cube - cursor - data - dsssao - dsseso - dssstsci - envi - exit - export - file - fits - frame - gif - grid - header - height - iconify - iexam - iis - jpeg - lock - lower - magnifier - mask - match - mecube - minmax - mode - mosaic - mosaicimage - movie - multiframe - nameserver - nrrd - nvss - orient - pagesetup - pan - pixeltable - plot - png - precision - prefs - preserve - psprint - print - quit - raise - regions - restore - rgb - rgbarray - rgbcube - rgbimage - rotate - save - saveimage - scale - shm - sia - single - skyview - sleep - smooth - source - tcl - threads - tile - update - url - version - view - vla - vlss - vo - wcs - web - width - xpa - zscale - zoom - -
2mass
-
Support for 2MASS Digital Sky Survey.
- Syntax: - 2mass [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey j|h|k] -     [open|close] - - Example: - $xpaget ds9 2mass name - $xpaget ds9 2mass coord - $xpaget ds9 2mass size - $xpaget ds9 2mass save - $xpaget ds9 2mass frame - $xpaget ds9 2mass survey - - $xpaset -p ds9 2mass - $xpaset -p ds9 2mass m31 - $xpaset -p ds9 2mass name m31 - $xpaset -p ds9 2mass name clear - $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 2mass size 60 60 arcmin - $xpaset -p ds9 2mass save yes - $xpaset -p ds9 2mass frame current - $xpaset -p ds9 2mass update frame - $xpaset -p ds9 2mass survey j - $xpaset -p ds9 2mass open - $xpaset -p ds9 2mass close
-
3d
-
Support for 3D frame.
- Syntax: - 3d [] -     [view <az> <el>] -     [az <az>] -     [el <el>] -     [scale <scale>] -     [method mip|aip] -     [background none|azimuth|elevation] -     [border yes|no] -     [border color <color>] -     [highlite yes|no] -     [highlite color <color>] -     [compass yes|no] -     [compass color <color>] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $xpaget ds9 3d view - $xpaget ds9 3d az - $xpaget ds9 3d el - $xpaget ds9 3d scale - $xpaget ds9 3d method - $xpaget ds9 3d background - $xpaget ds9 3d border - $xpaget ds9 3d border color - $xpaget ds9 3d highlite - $xpaget ds9 3d highlite color - $xpaget ds9 3d compass - $xpaget ds9 3d compass color - $xpaget ds9 3d lock - - $xpaset -p ds9 3d # create new 3D frame - $xpaset -p ds9 3d view 45 30 - $xpaset -p ds9 3d az 45 - $xpaset -p ds9 3d el 30 - $xpaset -p ds9 3d scale 10 - $xpaset -p ds9 3d method mip - $xpaset -p ds9 3d background azimuth - $xpaset -p ds9 3d border yes - $xpaset -p ds9 3d border color red - $xpaset -p ds9 3d highlite yes - $xpaset -p ds9 3d highlite color red - $xpaset -p ds9 3d compass yes - $xpaset -p ds9 3d compass color red - $xpaset -p ds9 3d match - $xpaset -p ds9 3d lock yes - $xpaset -p ds9 3d open - $xpaset -p ds9 3d close
-
about
-
Get DS9 credits.
- Syntax: - about - - Example: - $xpaget ds9 about - -
align
-
Controls the World Coordinate System alignment for the current - frame.
- Syntax: - align [] -     [yes|no] - - Example: - $xpaget ds9 align - - $xpaset -p ds9 align yes - -
analysis
-
Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window.
- Syntax: - analysis [<task number>] -     [<filename>] -     [task <task number>|<task name>] -     [load <filename>] -     [clear] -     [clear][load <filename>] -     [message ok|okcancel|yesno <message>] -     [entry <message>] -     [text] - - Example: - $xpaget ds9 analysis - $xpaget ds9 analysis task - $xpaget ds9 analysis entry {Please enter something} - $xpaget ds9 analysis message okcancel {Hello World} - - $xpaset -p ds9 analysis 0 # invoke first analysis task - $xpaset -p ds9 analysis task 0 - $xpaset -p ds9 analysis task foobar - $xpaset -p ds9 analysis {foo bar} - $xpaset -p ds9 analysis my.ans - $xpaset -p ds9 analysis load my.ans - $xpaset -p ds9 analysis clear - $xpaset -p ds9 analysis clear load my.ans - $xpaset -p ds9 analysis message {This is a message} - $xpaset -p ds9 analysis text {this is text} - - $cat my.ans | xpaset ds9 analysis load - $cat foo.txt | xpaset ds9 analysis text
-
array
-
Load raw data array into current frame.
-
- Syntax: - array [native|little|big] - array [new|mask] -[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $xpaget ds9 array > foo.arr - $xpaget ds9 array little > foo.arr - - $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] - $xpaset -p ds9 array new - foo.arr[dim=512,bitpix=-32,endian=little] - $xpaset -p ds9 array mask - foo.arr[dim=512,bitpix=-32,endian=little] - - $cat foo.arr | xpaset ds9 - array[dim=512,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 array - new[dim=512,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 array mask - [dim=512,bitpix=-32,endian=little] -
bg
- background
-
Set image background color.
- Syntax: - bg <color> - - Example: - $xpaget ds9 bg - - $xpaset -p ds9 bg red
-
backup
-
Create a backup save set.
- Syntax: - backup <filename> - - Example: - $xpaset -p ds9 backup ds9.bck
-
bin
-
Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility.
- Syntax: - bin [about <x> <y>] -     [about center] -     [buffersize <value>] -     [cols <x> <y>] -     [colsz <x> <y> <z>] -     [factor <value> [<vector>]] -     [depth <value>] -     [filter <string>] -     [filter clear] -     [function average|sum] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $xpaget ds9 bin about - $xpaget ds9 bin buffersize - $xpaget ds9 bin cols - $xpaget ds9 bin factor - $xpaget ds9 bin depth - $xpaget ds9 bin filter - $xpaget ds9 bin function - $xpaget ds9 bin smooth - $xpaget ds9 bin smooth function - $xpaget ds9 bin smooth radius - $xpaget ds9 bin lock - - $xpaset -p ds9 bin about 4096 4096 - $xpaset -p ds9 bin about center - $xpaset -p ds9 bin buffersize 512 - $xpaset -p ds9 bin cols detx dety - $xpaset -p ds9 bin colsz detx dety time - $xpaset -p ds9 bin factor 4 - $xpaset -p ds9 bin factor 4 2 - $xpaset -p ds9 bin depth 10 - $xpaset -p ds9 bin filter 'pha > 5' - $xpaset -p ds9 bin filter clear - $xpaset -p ds9 bin function sum - $xpaset -p ds9 bin in - $xpaset -p ds9 bin out - $xpaset -p ds9 bin to fit - $xpaset -p ds9 bin match - $xpaset -p ds9 bin lock yes - $xpaset -p ds9 bin open - $xpaset -p ds9 bin close
-
blink
-
Blink mode parameters. Interval is in seconds.
-
- Syntax: - blink [] -     [yes|no] -     [interval <value>] - - Example: - $xpaget ds9 blink - $xpaget ds9 blink interval - - $xpaset -p ds9 blink - $xpaset -p ds9 blink yes - $xpaset -p ds9 blink interval 1
-
block
-
Controls blocking parameters.
- Syntax: - block[<value>] -     [<value> <value>] -     [to <value>] -     [to <value><value>] -     [in] -     [out] -     [to fit] -     [match] -     [lock [yes|no]] -     [open|close] - - Example: - $xpaget ds9 block - $xpaget ds9 block lock - - $xpaset -p ds9 block 4 - $xpaset -p ds9 block 4 2 - $xpaset -p ds9 block to 4 - $xpaset -p ds9 block to 4 2 - $xpaset -p ds9 block in - $xpaset -p ds9block out - $xpaset -p ds9 block to fit - $xpaset -p ds9 block match - $xpaset -p ds9 block lock yes - $xpaset -p ds9 block open - $xpaset -p ds9 block close
-
catalog
- cat
-
-
Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise.
- Syntax: - catalog [new] -     [ned|simbad|denis|skybot] -     -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] -     [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] -     [2mass|iras] -     [csc|xmm|rosat] -     [first|nvss] -     [chandralog|cfhtlog|esolog|stlog|xmmlog] -     [cds <catalogname>] -     [cds <catalogid>] - -     [load <filename>] -     [import sb|tsv <filename>] - -     [<ref>] [<ra> <dec> - <coordsys>] -     [<ref>] [allcols] -     [<ref>] [allrows] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [crosshair] -     [<ref>] [dec <col>] -     [<ref>] [edit yes|no] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [filter <string>] -     [<ref>] [filter load <filename>] -     [<ref>] [header] -     [<ref>] [location <code>] -     [<ref>] [match] -     [<ref>] [match <ref> <ref>] -     [<ref>] [match error <value> - degrees|arcmin|arcsec] -     [<ref>] [match function - 1and2|1not2|2not1] -     [<ref>] [match return - 1and2|1only|2only] -     [<ref>] [match unique yes|no] -     [<ref>] [maxrows <number>] -     [<ref>] [name <object>] -     [<ref>] [panto yes|no] -     [<ref>] [plot <xcol> <ycol> - <xerrcol> <yerrcol>] -     [<ref>] [print] -     [<ref>] [psky <skyframe>] -     [<ref>] [psystem <coordsys>] -     [<ref>] [ra <col>] -     [<ref>] [regions] -     [<ref>] [retrieve] -     [<ref>] [samp] -     [<ref>] [samp broadcast] -     [<ref>] [samp send <application>] -     [<ref>] [save <filename>] -     [<ref>] [server - cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] -     [<ref>] [show yes|no] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [sort <col> incr|decr] -     [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] -     [<ref>] [symbol [#] - text|size|size2|units|angle <value>] -     [<ref>] [symbol shape - circle|ellipse|box|text|point] -     [<ref>] [symbol shapecircle point|box - point|diamond point|cross point|x point|arrow point|boxcircle - point] -     [<ref>] [symbol add| [#] remove] -     [<ref>] [symbol save|load - <filename>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] -     [<ref>] [x <col>] -     [<ref>] [y <col>] - - Example: - $xpaget ds9 catalog - $xpaget ds9 catalog header - - $xpaset -p ds9 catalog new - $xpaset -p ds9 catalog 2mass - $xpaset -p ds9 catalog cds 2mass - $xpaset -p ds9 catalog cds {I/252} - - $xpaset -p ds9 catalog load foo.xml - $xpaset -p ds9 catalog import tsv foo.tsv - - $xpaset -p ds9 catalog 202.48 47.21 fk5 - $xpaset -p ds9 catalog allrows - $xpaset -p ds9 catalog allcols - $xpaset -p ds9 catalog cancel - $xpaset -p ds9 catalog clear - $xpaset -p ds9 catalog close - $xpaset -p ds9 catalog crosshair - $xpaset -p ds9 catalog dec DEC - $xpaset -p ds9 catalog edit yes - $xpaset -p ds9 catalog export tsv bar.tsv - $xpaset -p ds9 catalog filter '$Jmag>10' - $xpaset -p ds9 catalog filter load foo.flt - $xpaset -p ds9 catalog header - $xpaset -p ds9 catalog location 500 - $xpaset -p ds9 catalog match error 2 arcsec - $xpaset -p ds9 catalog match function 1and2 - $xpaset -p ds9 catalog match unique no - $xpaset -p ds9 catalog match return 1only - $xpaset -p ds9 catalog match # last two catalogs loaded - $xpaset -p ds9 catalog match 2mass csc - $xpaset -p ds9 catalog maxrows 2000 - $xpaset -p ds9 catalog name m51 - $xpaset -p ds9 catalog panto no - $xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag' - $xpaset -p ds9 catalog print - $xpaset -p ds9 catalog psky fk5 - $xpaset -p ds9 catalog psystem wcs - $xpaset -p ds9 catalog ra RA - $xpaset -p ds9 catalog regions - $xpaset -p ds9 catalog retrieve - $xpaset -p ds9 catalog samp broadcast - $xpaset -p ds9 catalog samp send aladin - $xpaset -p ds9 catalog save foo.xml - $xpaset -p ds9 catalog server sao - $xpaset -p ds9 catalog show yes - $xpaset -p ds9 catalog radius 1 degrees - $xpaset -p ds9 catalog symbol condition '$Jmag>15' - $xpaset -p ds9 catalog symbol 2 shape {boxcircle point} - $xpaset -p ds9 catalog symbol color red - $xpaset -p ds9 catalog symbol font times - $xpaset -p ds9 catalog symbol fontsize 14 - $xpaset -p ds9 catalog symbol fontweight bold - $xpaset -p ds9 catalog symbol fontslant italic - $xpaset -p ds9 catalog symbol add - $xpaset -p ds9 catalog symbol 2 remove - $xpaset -p ds9 catalog symbol load foo.sym - $xpaset -p ds9 catalog symbol save bar.sym - $xpaset -p ds9 catalog sky fk5 - $xpaset -p ds9 catalog skyformat degrees - $xpaset -p ds9 catalog sort {Jmag} incr - $xpaset -p ds9 catalog system wcs - $xpaset -p ds9 catalog update - $xpaset -p ds9 catalog x RA - $xpaset -p ds9 catalog y DEC
-
cd
-
Sets/Returns the current working directory.
- Syntax: - cd [<directory>] - - Example: - $xpaget ds9 cd - - $xpaset -p ds9 cd /home/mrbill - -
cmap
-
Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1.
- Syntax: - cmap [<colormap>] -     [file] -     [load <filename>] -     [save <filename>] -     [invert yes|no] -     [<constrast> <bias>] -     [tag [load|save] <filename>] -     [tag delete] -     [open|close] - - Example: - $xpaget ds9 cmap - $xpaget ds9 cmap file - $xpaget ds9 cmap invert - $xpaget ds9 cmap value - - $xpaset -p ds9 cmap Heat - $xpaset -p ds9 cmap load foo.sao - $xpaset -p ds9 cmap save bar.sao - $xpaset -p ds9 cmap invert yes - $xpaset -p ds9 cmap 5 .5 - $xpaset -p ds9 cmap tag load foo.tag - $xpaset -p ds9 cmap tag save foo.tag - $xpaset -p ds9 cmap tag delete - $xpaset -p ds9 cmap open - $xpaset -p ds9 cmap close - -
colorbar
-
-
Controls colorbar parameters.
- Syntax: - colorbar [] -     [yes|no] -     [orientation] -     [horizontal|vertical] -     [numerics yes|no] -     [space value|distance] -     [font times|helvetica|courier] -     [fontsize <value>] -     [fontweight normal|bold] -     [fontslant roman|italic] -     [size] -     [ticks] -     [match] -     [lock [yes|no]] -
- Example: - $xpaget ds9 colorbar - $xpaget ds9 colorbar orientation - $xpaget ds9 colorbar numerics - $xpaget ds9 colorbar space - $xpaget ds9 colorbar font - $xpaget ds9 colorbar fontsize - $xpaget ds9 colorbar fontweight - $xpaget ds9 colorbar fontslant - $xpaget ds9 colorbar size - $xpaget ds9 colorbar ticks - $xpaget ds9 colorbar lock - - $xpaset -p ds9 colorbar yes - $xpaset -p ds9 colorbar vertical - $xpaset -p ds9 colorbar orientation vertical - $xpaset -p ds9 colorbar numerics yes - $xpaset -p ds9 colorbar space value - $xpaset -p ds9 colorbar font times - $xpaset -p ds9 colorbar fontsize 14 - $xpaset -p ds9 colorbar fontweight bold - $xpaset -p ds9 colorbar fontslant italic - $xpaset -p ds9 colorbar size 20 - $xpaset -p ds9 colorbar ticks 11 - $xpaset -p ds9 colorbar match - $xpaset -p ds9 colorbar lock yes - -
console
-
Display tcl console window.
- Syntax: - -console - - Example: - $xpaset -p ds9 console - -
contour
-
-
Controls contours in the current frame.
- Syntax: - contour [] -     [yes|no] -     [<coordsys> [<skyframe>]] -     [clear] -     [generate] -     [load <filename>] -     [save <filename> [<coordsys> - <skyframe>]] -     [convert] -     [load levels <filename>] -     [save levels <filename>] -     [copy] -     [paste [<coordsys> <color> - <width> yes|no]] -     [color <color>] -     [width <width>] -     [dash yes|no] -     [smooth <smooth>] -     [method block|smooth] -     [nlevels <number of levels>] -     [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ] -     [log exp <value>] -     [mode minmax|<value>|zscale|zmax] -     [scope global|local] -     [limits <min> <max>] -     [levels <value value value...>] -     [open|close] - - Example: - $xpaget ds9 contour - $xpaget ds9 contour wcs fk5 - $xpaget ds9 contour color - $xpaget ds9 contour width - $xpaget ds9 contour dash - $xpaget ds9 contour smooth - $xpaget ds9 contour method - $xpaget ds9 contour nlevels - $xpaget ds9 contour scale - $xpaget ds9 contour log exp - $xpaget ds9 contour mode - $xpaget ds9 contour scope - $xpaget ds9 contour limits - $xpaget ds9 contour levels - - $xpaset -p ds9 contour - $xpaset -p ds9 contour yes - $xpaset -p ds9 contour clear - $xpaset -p ds9 contour generate - $xpaset -p ds9 contour load ds9.ctr - $xpaset -p ds9 contour save ds9.ctr - $xpaset -p ds9 contour save ds9.ctr wcs fk5 - $xpaset -p ds9 contour convert - $xpaset -p ds9 contour load levels ds9.ctr - $xpaset -p ds9 contour save levels ds9.lev - $xpaset -p ds9 contour copy - $xpaset -p ds9 contour paste - $xpaset -p ds9 contour paste wcs red 2 no - $xpaset -p ds9 contour color yellow - $xpaset -p ds9 contour width 2 - $xpaset -p ds9 contour dash yes - $xpaset -p ds9 contour smooth 5 - $xpaset -p ds9 contour method smooth - $xpaset -p ds9 contour nlevels 10 - $xpaset -p ds9 contour scale sqrt - $xpaset -p ds9 contour log exp 1000 - $xpaset -p ds9 contour mode zscale - $xpaset -p ds9 contour scope local - $xpaset -p ds9 contour limits 1 100 - $xpaset -p ds9 contour levels 1 10 100 1000 - $xpaset -p ds9 contour open - $xpaset -p ds9 contour close
-
crop
-
Set current image display area.
- Syntax: - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec] -     [match <coordsys>] -     [lock <coordsys>|none] -     [reset] -     [3d zmin zmax <coordsys>] -     [open|close] - - Example: - $xpaget ds9 crop # get crop in physical coords - $xpaget ds9 crop wcs galactic sexagesimal arcsec - $xpaget ds9 crop lock - - $xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords - $xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 - 22.000204 wcs galactic arcsec - $xpaset -p ds9 crop match wcs - $xpaset -p ds9 crop lock wcs - $xpaset -p ds9 crop reset - $xpaset -p ds9 crop 3d .25 .50 wcs - $xpaset -p ds9 crop open - $xpaset -p ds9 crop close -
crosshair
-
Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set.
- Syntax: - crosshair [<x> <y> <coordsys> - [<skyframe>]] -     [match <coordsys>] -     [lock <coordsys>|none] - - Example: - $xpaget ds9 crosshair # get crosshair in physical coords - $xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs - coords - $xpaget ds9 crosshair lock - - $xpaset -p ds9 crosshair 100 100 physical # set crosshair in - physical - $xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs - coords - $xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 - $xpaset -p ds9 crosshair match wcs - $xpaset -p ds9 crosshair lock wcs - -
cube
-
-
Controls FITS cube dialog.
- Syntax: - cube [] -     [play|stop|next|prev|first|last] -     [<slice> [<coordsys>]] -     [interval <numeric>] -     [match <coordsys>] -     [lock <coordsys>|none] -     [order 123|132|213|231|312|321] -     [axes lock [yes|no]] -     [open|close] - - Example: - $xpaget ds9 cube - $xpaget ds9 cube wcs - $xpaget ds9 cube interval - $xpaget ds9 cube lock - $xpaget ds9 cube order - $xpaget ds9 cube axes lock - - $xpaset -p ds9 cube - $xpaset -p ds9 cube play - $xpaset -p ds9 cube last - $xpaset -p ds9 cube 3 - $xpaset -p ds9 cube 4.4 wcs - $xpaset -p ds9 cube interval 2 - $xpaset -p ds9 cube match wcs - $xpaset -p ds9 cube lock wcs - $xpaset -p ds9 cube order 123 - $xpaset -p ds9 cube axes lock yes - $xpaset -p ds9 cube open - $xpaset -p ds9 cube close
-
cursor
-
Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also.
- Syntax: - cursor [<x> <y>] - - Example: - $xpaset -p ds9 cursor 10 10 - -
data
-
Return an array of data values given a lower left corner and a - width and height in specified coordinate system. The last - argument of yes indicates to strip the coordinates from the - output and just list the data values. The default is yes.
- Syntax: - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]] - - Example: - $xpaget ds9 data image 450 520 3 3 yes - $xpaget ds9 data physical 899 1039 6 6 no - $xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 - 0.00016516669 no - $xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no - -
dsssao
- dss
-
-
Support for Digital Sky Survey at SAO.
- Syntax: - dsssao [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $xpaget ds9 dsssao name - $xpaget ds9 dsssao coord - $xpaget ds9 dsssao size - $xpaget ds9 dsssao save - $xpaget ds9 dsssao frame - - $xpaset -p ds9 dsssao - $xpaset -p ds9 dsssao m31 - $xpaset -p ds9 dsssao name m31 - $xpaset -p ds9 dsssao name clear - $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dsssao size 60 60 arcmin - $xpaset -p ds9 dsssao save yes - $xpaset -p ds9 dsssao frame current - $xpaset -p ds9 dsssao update frame - $xpaset -p ds9 dsssao open - $xpaset -p ds9 dsssao close
-
dsseso
-
Support for Digital Sky Survey at ESO.
- Syntax: - dsseso [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared] -     [open|close] - - Example: - $xpaget ds9 dsseso name - $xpaget ds9 dsseso coord - $xpaget ds9 dsseso size - $xpaget ds9 dsseso save - $xpaget ds9 dsseso frame - $xpaget ds9 dsseso survey - - $xpaset -p ds9 dsseso - $xpaset -p ds9 dsseso m31 - $xpaset -p ds9 dsseso name m31 - $xpaset -p ds9 dsseso name clear - $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dsseso size 60 60 arcmin - $xpaset -p ds9 dsseso save yes - $xpaset -p ds9 dsseso frame current - $xpaset -p ds9 dsseso update frame - $xpaset -p ds9 dsseso survey DSS2-red - $xpaset -p ds9 dsseso open - $xpaset -p ds9 dsseso close
-
dssstsci
-
Support for Digital Sky Survey at STSCI.
- Syntax: - dssstsci [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] -     [survey poss1_blue|poss1_red] -     [survey all|quickv|phase2_gsc2|phase2_gsc1] -     [open|close] - - Example: - $xpaget ds9 dssstsci name - $xpaget ds9 dssstsci coord - $xpaget ds9 dssstsci size - $xpaget ds9 dssstsci save - $xpaget ds9 dssstsci frame - $xpaget ds9 dssstsci survey - - $xpaset -p ds9 dssstsci - $xpaset -p ds9 dssstsci m31 - $xpaset -p ds9 dssstsci name m31 - $xpaset -p ds9 dssstsci name clear - $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 dssstsci size 60 60 arcmin - $xpaset -p ds9 dssstsci save yes - $xpaset -p ds9 dssstsci frame current - $xpaset -p ds9 dssstsci update frame - $xpaset -p ds9 dssstsci survey all - $xpaset -p ds9 dssstsci open - $xpaset -p ds9 dssstsci close
-
envi
-
Load an ENVI header and file. Optional parameter: array endian.
-
- Syntax:-- envi [new] <header> [<filename>]-- -- Example:-- $xpaset -p ds9 envi foo.hdr-- $xpaset -p ds9 envi new foo.hdr-- $xpaset -p ds9 envi foo.hdr foo.bsq--
- exit
-
quits
-
-
Quits DS9.
- Syntax: - exit - quit - - Example: - $xpaset -p ds9 exit - -
export
-
-
Export loaded image data of current frame in specified image - format. Optional parameters: array endian, nrrd endian, jpeg - quality (1-100) and tiff compression method.
- Syntax: - export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> - export array <filename>[big|little|native] - export nrrd <filename>[big|little|native] - export envi <header> [<filename>][big|little|native] - export jpeg <filename>[1-100] - export tiff <filename>[none|jpeg|packbits|deflate] - - Example: - $xpaset -p ds9 export array foo.arr little - $xpaset -p ds9 export nrrd foo.nrrd little - $xpaset -p ds9 export envi foo.hdr little - $xpaset -p ds9 export envi foo.hdr foo.bsq little - $xpaset -p ds9 export tiff foo.tiff jpeg - $xpaset -p ds9 export jpeg foo.jpeg 75 - $xpaset -p ds9 export png foo.png
-
file
-
Query currently loaded file information.
- Syntax: - file - - Example: - $xpaget ds9 file
-
fits
-
Load a FITS image into the current frame or query the currently - loaded image.
-
- Syntax: - fits[new|mask|slice] [<filename>] -     [width|height|depth|bitpix] -     [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] -     [header [<ext>] [keyword - <string>]] -     [image|table|slice] - - Example: - $xpaget ds9 fits > foo.fits - $xpaget ds9 fits width - $xpaget ds9 fits height - $xpaget ds9 fits depth - $xpaget ds9 fits bitpix - $xpaget ds9 fits size - $xpaget ds9 fits size wcs fk5 arcmin - $xpaget ds9 fits header # primary - $xpaget ds9 fits header 2 # hdu 2 - $xpaget ds9 fits header -2 # hdu 2 with inherit - $xpaget ds9 fits header keyword BITPIX - $xpaget ds9 fits header 1 keyword BITPIX - $xpaget ds9 fits image > foo.fits - $xpaget ds9 fits table > bar.fits - $xpaget ds9 fits slice > foo.fits - - $xpaset -p ds9 fits foo.fits - $xpaset -p ds9 fits new foo.fits - $xpaset -p ds9 fits bar.fits[bin=detx,dety] - $xpaset -p ds9 fits slice foo.fits - $xpaset -p ds9 fits mask foo.fits - - $cat foo.fits | xpaset ds9 fits - $cat foo.fits | xpaset ds9 fits new - $cat bar.fits | xpaset ds9 fits -[bin=detx,dety] - $cat foo.fits | xpaset ds9 fits slice - $cat foo.fits | xpaset ds9 fits mask - -
frame
-
Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility.
- Syntax: - frame [center [#|all]] -     [clear [#|all]] -     [new [rgb|3d]] -     [delete [#|all]] -     [reset [#|all]] -     [refresh [#|all]] -     [hide [#|all]] -     [show [#|all]] -     [move first] -     [move back] -     [move forward] -     [move last] -     [first] -     [prev] -     [next] -     [last] -     [frameno #] -     [#] -     [match <coordsys>] -     [lock <coordsys>|none] -     [has - [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] -     [has contour [aux]]] -     [has fits [bin|cube|mosaic]] -     [has marker [highlite|paste|select|undo]] -     [has system <coordsys>] -     [has wcs [<wcssys>]] -     [has wcs celestial [<wcssys>]] -     [has wcs linear [<wcssys>]] - - Example: - $xpaget ds9 frame # returns the id of the current frame - $xpaget ds9 frame frameno # returns the id of the current frame - $xpaget ds9 frame all # returns the id of all frames - $xpaget ds9 frame active # returns the id of all active frames - $xpaget ds9 frame lock - $xpaget ds9 frame has amplifier - $xpaget ds9 frame has datamin - $xpaget ds9 frame has datasec - $xpaget ds9 frame has detector - $xpaget ds9 frame has grid - $xpaget ds9 frame has iis - $xpaget ds9 frame has irafmin - $xpaget ds9 frame has physical - $xpaget ds9 frame has smooth - $xpaget ds9 frame has contour - $xpaget ds9 frame has contour aux - $xpaget ds9 frame has fits - $xpaget ds9 frame has fits bin - $xpaget ds9 frame has fits cube - $xpaget ds9 frame has fits mosaic - $xpaget ds9 frame has marker highlite - $xpaget ds9 frame has marker paste - $xpaget ds9 frame has marker select - $xpaget ds9 frame has marker undo - $xpaget ds9 frame has system physical - $xpaget ds9 frame has wcs wcsa - $xpaget ds9 frame has wcs celestial wcsa - $xpaget ds9 frame has wcs linear wcsa - - $xpaset -p ds9 frame center # center current frame - $xpaset -p ds9 frame center 1 # center 'Frame1' - $xpaset -p ds9 frame center all # center all frames - $xpaset -p ds9 frame clear # clear current frame - $xpaset -p ds9 frame new # create new frame - $xpaset -p ds9 frame new rgb # create new rgb frame - $xpaset -p ds9 frame delete # delete current frame - $xpaset -p ds9 frame reset # reset current frame - $xpaset -p ds9 frame refresh # refresh current frame - $xpaset -p ds9 frame hide # hide current frame - $xpaset -p ds9 frame show 1 # show frame 'Frame1' - $xpaset -p ds9 frame move first # move frame to first in order - $xpaset -p ds9 frame move back # move frame back in order - $xpaset -p ds9 frame move forward # move frame forward in order - $xpaset -p ds9 frame move last # move frame to last in order - $xpaset -p ds9 frame first # goto first frame - $xpaset -p ds9 frame prev # goto prev frame - $xpaset -p ds9 frame next # goto next frame - $xpaset -p ds9 frame last # goto last frame - $xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if - needed - $xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed - $xpaset -p ds9 frame match wcs - $xpaset -p ds9 frame lock wcs - -
gif
-
Load GIF image into current frame.-
- Syntax: - gif [new|slice] [<filename>] - - Example: - $xpaget ds9 gif > foo.gif - - $xpaset -p ds9 gif foo.gif - $xpaset -p ds9 gif new foo.gif - $xpaset -p ds9 gif slice foo.gif - - $cat foo.gif | xpaset ds9 gif # not available windows - $cat foo.gif | xpaset ds9 gifnew # not available windows - $cat foo.gif | xpaset ds9 gifslice# not available windows -
grid
-
Controls coordinate grid. For grid numeric format syntax, - click here.
- Syntax: - grid [] -     [yes|no] -     [type analysis|publication] -     [system <coordsys>] -     [sky <skyframe>] -     [skyformat <skyformat>] -     [grid yes|no] -     [grid color <color>] -     [grid width <value>] -     [grid dash yes|no] -     [grid gap1 <value>] -     [grid gap2 <value>] -     [grid gap3 <value>] -     [axes yes|no] -     [axes color <color>] -     [axes width <value>] -     [axes dash yes|no] -     [axes type interior|exterior] -     [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] -     [format1 <format>] -     [format2 <format>] -     [tickmarks yes|no] -     [tickmarks color <color>] -     [tickmarks width <value>] -     [tickmarks dash yes|no] -     [border yes|no] -     [border color <color>] -     [border width <value>] -     [border dash yes|no] -     [numerics yes|no] -     [numerics font times|helvetica|courier] -     [numerics fontsize <value>] -     [numerics fontweight normal|bold] -     [numerics fontslant roman|italic] -     [numerics color <color>] -     [numerics gap1 <value>] -     [numerics gap2 <value>] -     [numerics gap3 <value>] -     [numerics type interior|exterior] -     [numerics vertical yes|no] -     [title yes|no] -     [title text <text>] -     [title def yes|no] -     [title gap <value>] -     [title font times|helvetica|courier] -     [title fontsize <value>] -     [title fontweight normal|bold] -     [title fontslant roman|italic] -     [title color <color>] -     [labels yes|no] -     [labels def1 yes|no] -     [labels def2 yes|no] -     [labels text1 <text>] -     [labels text2 <text>] -     [labels gap1 <value>] -     [labels gap2 <value>] -     [labels font times|helvetica|courier] -     [labels fontsize <value>] -     [labels fontweight normal|bold] -     [labels fontslant roman|italic] -     [labels color <color>] -     [reset] -     [load <filename>] -     [save <filename>] -     [open|close] - - Example: - $xpaget ds9 grid - $xpaget ds9 grid type - $xpaget ds9 grid system - $xpaget ds9 grid sky - $xpaget ds9 grid skyformat - $xpaget ds9 grid grid - $xpaget ds9 grid grid color - $xpaget ds9 grid grid width - $xpaget ds9 grid grid dash - $xpaget ds9 grid grid gap1 - $xpaget ds9 grid grid gap2 - $xpaget ds9 grid grid gap3 - $xpaget ds9 grid axes - $xpaget ds9 grid axes color - $xpaget ds9 grid axes width - $xpaget ds9 grid axes dash - $xpaget ds9 grid axes type - $xpaget ds9 grid axes origin - $xpaget ds9 grid format1 - $xpaget ds9 grid format2 - $xpaget ds9 grid tickmarks - $xpaget ds9 grid tickmarks color - $xpaget ds9 grid tickmarks width - $xpaget ds9 grid tickmarks dash - $xpaget ds9 grid border - $xpaget ds9 grid border color - $xpaget ds9 grid border width - $xpaget ds9 grid border dash - $xpaget ds9 grid numerics - $xpaget ds9 grid numerics font - $xpaget ds9 grid numerics fontsize - $xpaget ds9 grid numerics fontweight - $xpaget ds9 grid numerics fontslant - $xpaget ds9 grid numerics color - $xpaget ds9 grid numerics gap1 - $xpaget ds9 grid numerics gap2 - $xpaget ds9 grid numerics gap3 - $xpaget ds9 grid numerics type - $xpaget ds9 grid numerics vertical - $xpaget ds9 grid title - $xpaget ds9 grid title text - $xpaget ds9 grid title def - $xpaget ds9 grid title gap - $xpaget ds9 grid title font - $xpaget ds9 grid title fontsize - $xpaget ds9 grid title fontweight - $xpaget ds9 grid title fontslant - $xpaget ds9 grid title color - $xpaget ds9 grid labels - $xpaget ds9 grid labels text1 - $xpaget ds9 grid labels def1 - $xpaget ds9 grid labels gap1 - $xpaget ds9 grid labels text2 - $xpaget ds9 grid labels def2 - $xpaget ds9 grid labels gap2 - $xpaget ds9 grid labels font - $xpaget ds9 grid labels fontsize - $xpaget ds9 grid labels fontweight - $xpaget ds9 grid labels fontslant - $xpaget ds9 grid labels color - - $xpaset -p ds9 grid - $xpaset -p ds9 grid yes - $xpaset -p ds9 grid type analysis - $xpaset -p ds9 grid system wcs - $xpaset -p ds9 grid sky fk5 - $xpaset -p ds9 grid skyformat degrees - $xpaset -p ds9 grid grid yes - $xpaset -p ds9 grid grid color red - $xpaset -p ds9 grid grid width 2 - $xpaset -p ds9 grid grid dash yes - $xpaset -p ds9 grid grid gap1 10 - $xpaset -p ds9 grid grid gap2 10 - $xpaset -p ds9 grid grid gap3 10 - $xpaset -p ds9 grid axes yes - $xpaset -p ds9 grid axes color red - $xpaset -p ds9 grid axes width 2 - $xpaset -p ds9 grid axes dash yes - $xpaset -p ds9 grid axes type exterior - $xpaset -p ds9 grid axes origin lll - $xpaset -p ds9 grid format1 d.2 - $xpaset -p ds9 grid format2 d.2 - $xpaset -p ds9 grid tickmarks yes - $xpaset -p ds9 grid tickmarks color red - $xpaset -p ds9 grid tickmarks width 2 - $xpaset -p ds9 grid tickmarks dash yes - $xpaset -p ds9 grid border yes - $xpaset -p ds9 grid border color red - $xpaset -p ds9 grid border width 2 - $xpaset -p ds9 grid border dash yes - $xpaset -p ds9 grid numerics yes - $xpaset -p ds9 grid numerics font courier - $xpaset -p ds9 grid numerics fontsize 12 - $xpaset -p ds9 grid numerics fontweight bold - $xpaset -p ds9 grid numerics fontslant italic - $xpaset -p ds9 grid numerics color red - $xpaset -p ds9 grid numerics gap1 10 - $xpaset -p ds9 grid numerics gap2 10 - $xpaset -p ds9 grid numerics gap3 10 - $xpaset -p ds9 grid numerics type exterior - $xpaset -p ds9 grid numerics vertical yes - $xpaset -p ds9 grid title yes - $xpaset -p ds9 grid title text {Hello World} - $xpaset -p ds9 grid title def yes - $xpaset -p ds9 grid title gap 10 - $xpaset -p ds9 grid title font courier - $xpaset -p ds9 grid title fontsize 12 - $xpaset -p ds9 grid title fontweight bold - $xpaset -p ds9 grid title fontslant italic - $xpaset -p ds9 grid title color red - $xpaset -p ds9 grid labels yes - $xpaset -p ds9 grid labels text1 {Hello World} - $xpaset -p ds9 grid labels def1 yes - $xpaset -p ds9 grid labels gap1 10 - $xpaset -p ds9 grid labels text2 {Hello World} - $xpaset -p ds9 grid labels def2 yes - $xpaset -p ds9 grid labels gap2 10 - $xpaset -p ds9 grid labels font courier - $xpaset -p ds9 grid labels fontsize 12 - $xpaset -p ds9 grid labels fontweight boldj - $xpaset -p ds9 grid labels fontslant italic - $xpaset -p ds9 grid labels color red - $xpaset -p ds9 grid reset - $xpaset -p ds9 grid load foo.grd - $xpaset -p ds9 grid save foo.grd - $xpaset -p ds9 grid open - $xpaset -p ds9 grid close
-
header
-
Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from xpa fits header.
- Syntax: - header [<ext>] -     [close [<ext>]] -     [save [<ext>] <filename>] - - Example: - $xpaset -p ds9 header - $xpaset -p ds9 header 2 - $xpaset -p ds9 header close - $xpaset -p ds9 header save 1 foo.txt - -
height
-
Set the height of the image display window.
- Syntax: - height [<value>] - - Example: - $xpaget ds9 height - - $xpaset -p ds9 height 512 - -
iconify
-
Toggles iconification.
- Syntax: - iconify [] -     [yes|no] - - Example: - $xpaget ds9 iconify - - $xpaset -p ds9 iconify - $xpaset -p ds9 iconify yes - -
iexam
-
Interactive examine function. A blinking cursor will indicate - to the user to click on a point on an image. The specified - information will be returned at that time. The default event is - button. In the last form, the following macros will be - expanded if present: $width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z. See Analysis - Macros for more information.
-
- Syntax: - iexam [] -     [[]|button|key|any] coordinate - <coordsys> [<skyframe>] [<skyformat>] -     [[]|button|key|any] data [width][height] -     [[]|button|key|any] <macro string>] - - Example: - $xpaget ds9 iexam # image coordinates - $xpaget ds9 iexam coordinate image - $xpaget ds9 iexam key coordinate image # return coordinate and - key event - $xpaget ds9 iexam coordinate wcs fk5 degrees - $xpaget ds9 iexam coordinate wcs galactic sexagesimal - $xpaget ds9 iexam coordinate fk5 - $xpaget ds9 iexam data # return data value - $xpaget ds9 iexam key data # return data value and key event - $xpaget ds9 iexam data 3 3 # return all data in 3x3 box about - selected point - $xpaget ds9 iexam {'Click at $x,$y in file $filename'}
-
iis
-
Set/Get IIS Filename. Optional mosaic number maybe supplied.
- Syntax: - iis [filename <filename> [#]] - - Example: - $xpaget ds9 iis filename - $xpaget ds9 iis filename 4 - - $xpaset -p ds9 iis filename foo.fits - $xpaset -p ds9 iis filename bar.fits 4
-
jpeg
-
Load JPEG image into current frame. Optional parameters: jpeg - quality (1-100)
- Syntax: - jpeg [new|slice] [<filename>] [1-100] - - Example: - $xpaget ds9 jpeg > foo.jpeg - $xpaget ds9 jpeg 100 > foo.jpeg - - $xpaset -p ds9 jpeg foo.jpeg - $xpaset -p ds9 jpeg new foo.jpeg - $xpaset -p ds9 jpeg slice foo.jpeg - - $cat foo.jpeg | xpaset ds9 jpeg# not available windows - $cat foo.jpeg | xpaset ds9 jpegnew# not available windows - $cat foo.jpeg | xpaset ds9 jpegslice# not available windows -
lock
-
Lock all other frames to the current frame.
- Syntax: - lock[frame <coordsys>|none] -     [crosshair <coordsys>|none] -     [crop <coordsys>|none] -     [slice <coordsys>|none]] -     [bin [yes|no]] -     [axes [yes|no]] -     [scale [yes|no]] -     [scalelimites [yes|no]] -     [colorbar [yes|no]] -     [block [yes|no]] -     [smooth [yes|no]] -     [3d [yes|no]] - - Example: - $xpaget -p ds9 lock frame - $xpaget -p ds9 lock crosshair - $xpaget -p ds9 lock crop - $xpaget -p ds9 lock slice - $xpaget -p ds9 lock bin - $xpaget -p ds9 lock axes - $xpaget -p ds9 lock scale - $xpaget -p ds9 lock scalelimits - $xpaget -p ds9 lock colorbar - $xpaget -p ds9 lock block - $xpaget -p ds9 lock smooth - $xpaget -p ds9 lock 3d - - $xpaset -p ds9 lock frame wcs - $xpaset -p ds9 lock crosshair wcs - $xpaset -p ds9 lock crop wcs - $xpaset -p ds9 lock slice wcs - $xpaset -p ds9 lock bin yes - $xpaset -p ds9 lock axes yes - $xpaset -p ds9 lock scale yes - $xpaset -p ds9 lock scalelimits yes - $xpaset -p ds9 lock colorbar yes - $xpaset -p ds9 lock block yes - $xpaset -p ds9 lock smooth yes - $xpaset -p ds9 lock 3d yes - - lower -
Lower in the window stacking order.
- Syntax: - lower - - Example: - $xpaset -p ds9 lower - -
magnifier
-
Controls the magnifier settings.
- Syntax: - magnifier [color <color>] -     [zoom <value>] -     [cursor yes|no] -     [region yes|no] - - Example: - $xpaget ds9 magnifier color - $xpaget ds9 magnifier zoom - $xpaget ds9 magnifier cursor - $xpaget ds9 magnifier region - - $xpaset -p ds9 magnifier color yellow - $xpaset -p ds9 magnifier zoom 2 - $xpaset -p ds9 magnifier cursor no - $xpaset -p ds9 magnifier region no
-
mask
-
-
Controls mask parameters.
- Syntax: - mask [color <color>] -     [mark zero|nonzero|nan|nonnan|range] -     [range <low> <high>] -     [transparency <value>] -     [system <coordsys>] -     [clear] -     [open|close] - - Example: - $xpaget ds9 mask color - $xpaget ds9 mask mark - $xpaget ds9 mask range - $xpaget ds9 mask system - $xpaget ds9 mask transparency - - $xpaset -p ds9 mask color red - $xpaset -p ds9 mask mark zero - $xpaset -p ds9 mask range 10 100 - $xpaset -p ds9 mask transparency 50 - $xpaset -p ds9 mask system wcs - $xpaset -p ds9 mask clear - $xpaset -p ds9 mask open - $xpaset -p ds9 mask close
-
match
-
Match all other frames to the current frame.
- Syntax: - match[frame <coordsys>] -     [crosshair <coordsys>] -     [crop <coordsys>] -     [slice <coordsys>] -     [bin] -     [axes] -     [scale] -     [scalelimits] -     [colorbar] -     [block] -     [smooth] -     [3d] - - Example: - $xpaset -p ds9 match frame wcs - $xpaset -p ds9 match crosshair wcs - $xpaset -p ds9 match crop wcs - $xpaset -p ds9 match slicewcs - $xpaset -p ds9 match bin - $xpaset -p ds9 match axes - $xpaset -p ds9 match scale - $xpaset -p ds9 match scalelimits - $xpaset -p ds9 match colorbar - $xpaset -p ds9 match block - $xpaset -p ds9 match smooth - $xpaset -p ds9 match 3d - - mecube -
Load FITS multiple extension file as data cube.
-
- Syntax: - mecube [new] [<filename>] - - Example: - $xpaget ds9 mecube > foo.fits - - $xpaset -p ds9 mecube foo.fits - $xpaset -p ds9 mecube new foo.fits - - $cat foo.fits | xpaset ds9 mecube - $cat foo.fits | xpaset ds9 mecube new -
minmax
-
This is how DS9 determines the min and max data values - from the data. SCAN will scan all data. DATAMIN - and IRAFMIN will use the values of the keywords if - present.
-
- Syntax: - minmax [scan|sample|datamin|irafmin] -     [mode scan|sample|datamin|irafmin] -     [interval #] - - Example: - $xpaget ds9 minmax mode - $xpaget ds9 minmax interval - - $xpaset -p ds9 minmax scan - $xpaset -p ds9 minmax mode scan - $xpaset -p ds9 minmax interval 100 - -
mode
-
Controls the first mouse button mode.
- Syntax: - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] - - Example: - $xpaget ds9 mode - $xpaset -p ds9 mode crosshair
-
mosaic
-
Load FITS mosaic segment into current frame.
- Syntax: - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] - - Example: - $xpaget ds9 mosaic > foo.fits - - $xpaset -p ds9 mosaic foo.fits - $xpaset -p ds9 mosaic wcs foo.fits - $xpaset -p ds9 mosaic wcs new foo.fits - $xpaset -p ds9 mosaic wcs mask foo.fits - - $cat foo.fits | xpaset ds9 mosaic - $cat foo.fits | xpaset ds9 mosaic wcs - $cat foo.fits | xpaset ds9 mosaic wcs new - $cat foo.fits | xpaset ds9 mosaic wcs mask - -
mosaicimage
-
Load FITS mosaic image into current frame.
- Syntax: - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>] - - Example: - $xpaget ds9 mosaicimage > foo.fits - - $xpaset -p ds9 mosaicimage foo.fits - $xpaset -p ds9 mosaicimage wcs foo.fits - $xpaset -p ds9 mosaicimage wcs new foo.fits - $xpaset -p ds9 mosaicimage wcs mask foo.fits - - $cat foo.fits | xpaset ds9 mosaicimage - $cat foo.fits | xpaset ds9 mosaicimage wcs - $cat foo.fits | xpaset ds9 mosaicimage wcs new - $cat foo.fits | xpaset ds9 mosaicimage wcs mask - -
movie
-
-
Create a movie from snap shots of the DS9 window. A slice - movie cycles though all slices of a cube. A frame - movie cycles through all active frames. A 3d movie - cycles through specified viewing angles. The default action is slice. - Movie types are either MPEG or Animated GIF, - with default MPEG. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.
- Syntax: - movie [slice|frame|3d][mpeg|gif] <filename> - movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>] - - Example: - $xpaset -p ds9 movie slice mpeg ds9.mpg - $xpaset -p ds9 movie frame gif ds9.gif - $xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto - 60 oscillate 1 - -
multiframe
-
Load FITS multiple extension file as multiple images.
-
- Syntax: - multiframe [<filename>] - - Example: - $xpaset -p ds9 multiframe foo.fits - - $cat foo.fits | xpaset ds9 multiframe# not available windows
-
nameserver
-
Support Name Server functions. Coordinates are in fk5.
- Syntax: - nameserver [<object>] -     [name <object>] -     - [serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] -     [skyformat degrees|sexagesimal] -     [pan] -     [crosshair] -     [open|close] - - Example: - $xpaget ds9 nameserver - $xpaget ds9 nameserver server - $xpaget ds9 nameserver skyformat - $xpaget ds9 nameserver m31 - - $xpaset -p ds9 nameserver m31 - $xpaset -p ds9 nameserver name m31 - $xpaset -p ds9 nameserver server ned-sao - $xpaset -p ds9 nameserver skyformat sexagesimal - $xpaset -p ds9 nameserver pan - $xpaset -p ds9 nameserver crosshair - $xpaset -p ds9 nameserver open - $xpaset -p ds9 nameserver close
-
nan
-
Set image not-a-number color.
- Syntax: - nan <color> - - Example: - $xpaget ds9 nan - - $xpaset -p ds9 nan red - -
nrrd
-
Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian.
-
- Syntax: - nrrd [native|little|big] - nrrd [new|mask] [<filename>] - - Example: - $xpaget ds9 nrrd - $xpaget ds9 nrrd big - - $xpaset -p ds9 nrrd foo.nrrd - $xpaset -p ds9 nrrd new foo.nrrd - $xpaset -p ds9 nrrd mask foo.nrrd - - $cat foo.nrrd | xpaset ds9 nrrd - $cat foo.nrrd | xpaset ds9 nrrdnew - $cat foo.nrrd | xpaset ds9 nrrd mask -
nvss
-
Support for NRAO VLA Sky Survey.
- Syntax: - nvss [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $xpaget ds9 nvss name - $xpaget ds9 nvss coord - $xpaget ds9 nvss size - $xpaget ds9 nvss save - $xpaget ds9 nvss frame - - $xpaset -p ds9 nvss - $xpaset -p ds9 nvss m31 - $xpaset -p ds9 nvss name m31 - $xpaset -p ds9 nvss name clear - $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 nvss size 60 60 arcmin - $xpaset -p ds9 nvss save yes - $xpaset -p ds9 nvss frame current - $xpaset -p ds9 nvss update frame - $xpaset -p ds9 nvss open - $xpaset -p ds9 nvss close
-
orient
-
Controls the orientation of the current frame.
- Syntax: - orient [none|x|y|xy] -     [open|close] - - Example: - $xpaget ds9 orient - - $xpaset -p ds9 orient xy - $xpaset -p ds9 orient open - $xpaset -p ds9 orient close - -
pagesetup
-
Controls Page Setup options.
-
- Syntax: - pagesetup [orient portrait|landscape] -     [scale <numberic>] -     [size letter|legal|tabloid|poster|a4] - - Example: - $xpaget ds9 pagesetup orient - $xpaget ds9 pagesetup scale - $xpaget ds9 pagesetup size - - $xpaset -p ds9 pagesetup orient portrait - $xpaset -p ds9 pagesetup scale 50 - $xpaset -p ds9 pagesetup size poster - -
pan
-
Controls the current image cursor location for the current - frame.
- Syntax: - pan [<coordsys> [<skyframe>] [<skyformat>]] # - get current coords - - pan [<x> <y> <coordsys> [<skyframe>]] # - relative -     [to <x> <y> <coordsys> - [<skyframe>]] # absolute -     [open|close] - - Example: - $xpaget ds9 pan # get current image coords - $xpaget ds9 pan wcs fk4 sexagesimal # get current coords - - $xpaset -p ds9 pan 200 200 image # pan relative - $xpaset -p ds9 pan to 400 400 physical # pan to physical coords - $xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs - coords - $xpaset -p ds9 pan open - $xpaset -p ds9 pan close - -
pixeltable
-
Display/Hide the pixel table.
- Syntax: - pixeltable [] -     [yes|open] -     [no|close] - - Example: - $xpaget ds9 pixeltable - - $xpaset -p ds9 pixeltable - $xpaset -p ds9 pixeltable yes - $xpaset -p ds9 pixeltable open - $xpaset -p ds9 pixeltable close
-
plot
-
Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions:
-
xy     x and y coordinates - xyex    x,y coordinates with x errors - xyey    x,y coordinates with y errors - xyexey    x,y coordinates with x and y - errors -
-
To create a new plot, use the plot new command.
- Syntax: - # create new empty plot window - plot [] -     [line|bar|scatter] -     [new] -     [new line|bar|scatter] -     [new name <plotname>] -     [new name <plotname> line|bar|scatter] - - # create new plot with data from stdin - plot[new <title> <xaxis label> <yaxis - label>xy|xyex|xyey|xyexey] -     [new [line|bar|scatter] <title> - <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] -     [newname <plotname><title> - <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] -     [newname <plotname>line|bar|scatter - <title> <xaxis label> <yaxis - label>xy|xyex|xyey|xyexey] - - # create new plot with data from stdin which includes title/dim - headers - plot [new stdin] -     [new[line|bar|scatter]stdin] -     [new name <plotname> stdin] -     [new name - <plotname>line|bar|scatterstdin] - - #load data into existing plot from stdin - plot [[<plotname>] data xy|xyex|xyey|xyexey] - - # existing plot - plot[[<plotname>] load <filename> - xy|xyex|xyey|xyexey] -     [[<plotname>] save <filename>] -     [[<plotname>] clear] -     [[<plotname>] duplicate [#]] -     [[<plotname>] stats yes|no] -     [[<plotname>] list yes|no] -     [[<plotname>] loadconfig - <filename>] -     [[<plotname>] saveconfig - <filename>] -     [[<plotname>] pagesetup orient - portrait|landscape] -     [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4] -     [[<plotname>] print] -     [[<plotname>] print destination - printer|file] -     [[<plotname>] print command - <command>] -     [[<plotname>] print filename - <filename>] -     [[<plotname>] print color rgb|gray] -     [[<plotname>] close] -     [[<plotname>] mode pointer|zoom] - - # export image - plot[[<plotname>] - export[gif|tiff|jpeg|png]<filename> -     [[<plotname>] export jpeg - <filename>[1-100] -     [[<plotname>]export tiff - <filename>[none|jpeg|packbits|deflate] - - # configure graph - plot [[<plotname>] axis x|y grid yes|no] -     [[<plotname>] axis x|y log yes|no] -     [[<plotname>] axis x|y flip yes|no] -     [[<plotname>] axis x|y auto yes|no] -     [[<plotname>] axis x|y min - <value>] -     [[<plotname>] axis x|y max - <value>] -     [[<plotname>] axis x|y format - <string>] -     [[<plotname>] background <value>] -     [[<plotname>] legend yes|no] -     [[<plotname>] legend position - right|left|top|bottom] -     [[<plotname>] font title|labels|numbers - font times|helvetica|courier] -     [[<plotname>] - fonttitle|labels|numberssize <value>] -     [[<plotname>] - fonttitle|labels|numbersweight normal|bold] -     [[<plotname>] - fonttitle|labels|numbersslant roman|italic] -     [[<plotname>] title <string>] -     [[<plotname>] title x|y <string>] -     [[<plotname>] barmode - normal|stacked|aligned|overlap] - - # configure current dataset - plot [[<plotname>] show yes|no] -     [[<plotname>] shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow] -     [[<plotname>] shape fill yes|no] -     [[<plotname>] shape color - <value>] -     [[<plotname>] smooth - step|linear|cubic|quadratic|catrom] -     [[<plotname>] color <value>] -     [[<plotname>] width <value>] -     [[<plotname>] dash yes|no] -     [[<plotname>] error yes|no] -     [[<plotname>] error color - <value>] -     [[<plotname>] error cap yes|no] -     [[<plotname>] error width - <value>] -     [[<plotname>] name <string>] - - # select current dataset - plot [[<plotname>] select <value>] - - Example: - # return all plotnames - $xpaget ds9 plot - - # create new empty plot window - $xpaset -p ds9 plot - $xpaset -p ds9 plot bar - $xpaset -p ds9 plot new - $xpaset -p ds9 plot new bar - $xpaset -p ds9 plot new name foo - $xpaset -p ds9 plot new name foo bar - - # create new plot with data from stdin - $cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} - xy - $cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y - Axis} xy - $cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} - {Y Axis} xy - $cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X - Axis} {Y Axis} xy - - # create new plot with data from stdin which includes title/dim - headers - $cat stdin.2.dat | xpaset ds9 plot new stdin - $cat stdin.2.dat | xpaset ds9 plot new line stdin - $cat stdin.2.dat | xpaset ds9 plot new name foo stdin - $cat stdin.2.dat | xpaset ds9 plot new name foo line stdin - - #load data into existing plot from stdin - $cat xy.dat | xpaset ds9 plot data xy - $cat xy.dat | xpaset ds9 plot foo data xy - - # existing plot - $xpaget ds9 plot stats - $xpaget ds9 plot list - - $xpaset -p ds9 plot load xy.dat xy - $xpaset -p ds9 plot save foo.dat - $xpaset -p ds9 plot clear - $xpaset -p ds9 plot duplicate 1 - $xpaset -p ds9 plot stats yes - $xpaset -p ds9 plot list yes - $xpaset -p ds9 plot loadconfig foo.plt - $xpaset -p ds9 plot saveconfig foo.plt - $xpaset -p ds9 plot pagesetup orient portrait - $xpaset -p ds9 plot pagesetup size letter - $xpaset -p ds9 plot print - $xpaset -p ds9 plot print destination file - $xpaset -p ds9 plot print command lp - $xpaset -p ds9 plot print filename foo.ps - $xpaset -p ds9 plot print color rgb - $xpaset -p ds9 plot close - - # plot mode - $xpaget ds9 plot mode - - $xpaset -p ds9 plot mode pointer - - # export plot - $xpaset -p ds9 plot export tiff foo.tiff jpeg - $xpaset -p ds9 plot export jpeg foo.jpeg 75 - $xpaset -p ds9 plot export png foo.png - - # configure plot - $xpaget ds9 plot axis x grid - $xpaget ds9 plot axis x log - $xpaget ds9 plot axis x flip - $xpaget ds9 plot axis x auto - $xpaget ds9 plot axis x min - $xpaget ds9 plot axis x max - $xpaget ds9 plot axis x format -$xpaget ds9 plot background
- $xpaget ds9 plot legend - $xpaget ds9 plot legend position
- $xpaget ds9 plot font numbers font - $xpaget ds9 plot font numbers size - $xpaget ds9 plot font numbers weight - $xpaget ds9 plot font numbers slant
- $xpaget ds9 plot title - $xpaget ds9 plot title xaxis - $xpaget ds9 plot title yaxis - - $xpaset -p ds9 plot axis x grid yes - $xpaset -p ds9 plot axis x log yes - $xpaset -p ds9 plot axis x flip yes - $xpaset -p ds9 plot axis x auto no - $xpaset -p ds9 plot axis x min 1 - $xpaset -p ds9 plot axis x max 100 - $xpaset -p ds9 plot axis x format {%f} - $xpaset -p ds9 plot background white - $xpaset -p ds9 plot legend yes - $xpaset -p ds9 plot legend position left - $xpaset -p ds9 plot font numbers font times - $xpaset -p ds9 plot font numbers size 12 - $xpaset -p ds9 plot font numbers weight bold - $xpaset -p ds9 plot font numbers slant italic - $xpaset -p ds9 plot title {This is a Title} - $xpaset -p ds9 plot title x {X Axis} - $xpaset -p ds9 plot title y {Y Axis} - $xpaset -p ds9 plot title legend {This is the Legend} - - # bar plot - $xpaget ds9 plot barmode - - $xpaset -p ds9 plot barmode aligned - - # configure current dataset - $xpaget ds9 plot show - $xpaget ds9 plot shape - $xpaget ds9 plot shape fill - $xpaget ds9 plot shape color - $xpaget ds9 plot smooth - $xpaget ds9 plot color - $xpaget ds9 plot width - $xpaget ds9 plot dash - $xpaget ds9 plot error - $xpaget ds9 plot error color - $xpaget ds9 plot error cap - $xpaget ds9 plot error width - $xpaget ds9 plot name - - $xpaset -p ds9 plot show yes - $xpaset -p ds9 plot shape circle - $xpaset -p ds9 plot shape fill no - $xpaset -p ds9 plot shape color cyan - $xpaset -p ds9 plot smooth step - $xpaset -p ds9 plot color red - $xpaset -p ds9 plot width 2 - $xpaset -p ds9 plot dash yes - $xpaset -p ds9 plot error yes - $xpaset -p ds9 plot error color red - $xpaset -p ds9 plot error cap yes - $xpaset -p ds9 plot error width 2 - $xpaset -p ds9 plot name {My Data} - - # select current dataset - $xpaget ds9 plot select - - $xpaset -p ds9 plot select 2
-
png
-
Load PNG image into current frame.
-
- Syntax: - png [new|slice] [<filename>] - - Example: - $xpaget ds9 png > foo.png - - $xpaset -p ds9 png foo.png - $xpaset -p ds9 png new foo.png - $xpaset -p ds9 png slice foo.png - - $cat foo.png | xpaset ds9 png - $cat foo.png | xpaset ds9 png new - $cat foo.png | xpaset ds9 png slice
-
precision
-
Set region and coordinate output format precision.
- Syntax: - precision -<linear><degree><hms><dms><arcmin><arcsec> - - Example: - $xpaget ds9 precision - - $xpaset -p ds9 precision 8 10 4 3 5 3
-
prefs
-
Controls various preference settings.
- Syntax: - prefs [clear] -     [irafalign yes|no] - - Example: - $xpaget ds9 prefs irafalign - - $xpaset -p ds9 prefs clear - $xpaset -p ds9 prefs iraf yes - -
preserve
-
Preserve the follow attributes while loading a new image.
- Syntax: - preserve [pan yes|no] -       [regions yes|no] - - Example: - $xpaget ds9 preserve pan - $xpaget ds9 preserve regions - - $xpaset -p ds9 preserve pan yes - $xpaset -p ds9 preserve regions yes - -
psprint
-
Invokes postscript printing. Please see print for further details.
-
print
-
Controls printing. Use print option to set printing options. - Only available for XPA_METHOD local.
- Syntax: - print [destination printer|file] -     [command <command>] -     [filename <filename>] -     [color rgb|cmyk|gray] -     [level 1|2|3] -     [resolution - 72|screen|96|144|150|225|300|600|1200] - - Example: - $xpaget ds9 print destination - $xpaget ds9 print command - $xpaget ds9 print filename - $xpaget ds9 print color - $xpaget ds9 print level - $xpaget ds9 print resolution - - $xpaset -p ds9 print - $xpaset -p ds9 print destination file - $xpaset -p ds9 print command lp - $xpaset -p ds9 print filename foo.ps - $xpaset -p ds9 print color cmyk - $xpaset -p ds9 print level 2 - $xpaset -p ds9 print resolution 96 -
raise
-
Raise in the window stacking order.
- Syntax: - raise - - Example: - $xpaset -p ds9 raise -
regions
-
Controls regions in the current frame.
- Syntax: - regions [<filename>] -     [load [all] <filename>] -     [save <filename>] -     [list [close]] -     [epsilon <integer>] -     [show yes|no] -     [showtext yes|no] -     [centroid] -     [centroid auto yes|no] -     [centroid radius <value>|iteration - <value>] -     [getinfo] -     [move front] -     [move back] -     [select all] -     [select none] -     [select invert] -     [delete all] -     [delete select] -     [format ds9|xml|ciao|saotng|saoimage|pros|xy] -     [system image|physical|wcs|wcsa...wcsz] -     [sky fk4|fk5|icrs|galactic|ecliptic] -     [skyformat degrees|sexagesimal] -     [strip yes|no] -     [shape <shape>] -     [color &ltcolor>] -     [width <width>] -     [fixed|edit|rotate|delete yes|no] -     [include|exclude|source|background] -     [command <marker command>] -     [composite] -     [dissolve] -     [template <filename>] -     [template <filename> at <ra> - <dec> <coordsys> <skyframe>] -     [savetemplate <filename>] -     [groups] -     [group new] -     [group <tag> new] -     [group <tag> update] -     [group <tag> select] -     [group <tag> color &ltcolor>] -     [group <tag> copy] -     [group <tag> delete] -     [group <tag> cut] -     [group <tag> font <font>] -     [group <tag> move <int> - <int>] -     [group <tag> movefront] -     [group <tag> moveback] -     [group <tag> property <property> - yes|no] -     [copy] -     [cut] -     [paste image|physical|wcs|wcsa...wcsz] -     [undo] -     [-format ds9|ciao|saotng|saoimage|pros|xy] -     [-system image|physical|wcs|wcsa...wcsz] -     [-sky fk4|fk5|icrs|galactic|ecliptic] -     [-skyformat degrees|sexagesimal] -     [-delim [nl|<char>]] -     [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0] -     [-group <tag>] -     [-strip yes|no] -     [-wcs yes|no] - - Example: - $xpaget ds9 regions - $xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat - sexagesimal -prop edit 1 -group foo - $xpaget ds9 regions epsilon - $xpaget ds9 regions show - $xpaget ds9 regions showtext - $xpaget ds9 regions centroid auto - $xpaget ds9 regions centroid radius - $xpaget ds9 regions centroid iteration - $xpaget ds9 regions selected - $xpaget ds9 regions format - $xpaget ds9 regions system - $xpaget ds9 regions sky - $xpaget ds9 regions skyformat - $xpaget ds9 regions strip - $xpaget ds9 regions shape - $xpaget ds9 regions color - $xpaget ds9 regions width - $xpaget ds9 regions source - $xpaget ds9 regions background - $xpaget ds9 regions include - $xpaget ds9 regions exclude - $xpaget ds9 regions selected - $xpaget ds9 regions groups - - $cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky - fk5 - $cat bar.reg | xpaset ds9 regions -format ds9 - $echo "image; circle 100 100 20" | xpaset ds9 regions - $echo "image; circle 100 100 20" | xpaset ds9 regions - $echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions - $echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions - $echo "box 100 100 20 40 25" | xpaset ds9 regions - $echo "image; line 100 100 200 400" | xpaset ds9 regions - $echo "physical; ruler 200 300 200 400" | xpaset ds9 regions - $echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 - regions - $echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 - regions - - $xpaset -p ds9 regions foo.reg - $xpaset -p ds9 regions -format ciao bar.reg # load as ciao - format - $xpaset -p ds9 regions foo.fits # FITS regions files do not need - a format specification - $xpaset -p ds9 regions load foo.reg # load foo.reg into current - frame - $xpaset -p ds9 regions load all foo.reg # load foo.reg into all - frames - $xpaset -p ds9 regions load '*.reg'# expand *.reg and load into - current frame - $xpaset -p ds9 regions load all '*.reg' # expand *.reg and load - into all frames - $xpaset -p ds9 regions save foo.reg - $xpaset -p ds9 regions list - $xpaset -p ds9 regions list close - $xpaset -p ds9 regions epsilon 5 - $xpaset -p ds9 regions show yes - $xpaset -p ds9 regions showtext no - $xpaset -p ds9 regions centroid - $xpaset -p ds9 regions centroid auto yes - $xpaset -p ds9 regions centroid radius 10 - $xpaset -p ds9 regions centroid iteration 20 - $xpaset -p ds9 regions getinfo - $xpaset -p ds9 regions move back - $xpaset -p ds9 regions move front - $xpaset -p ds9 regions select all - $xpaset -p ds9 regions select none - $xpaset -p ds9 regions select invert - $xpaset -p ds9 regions delete all - $xpaset -p ds9 regions delete select - $xpaset -p ds9 regions format ds9 - $xpaset -p ds9 regions system wcs - $xpaset -p ds9 regions sky fk5 - $xpaset -p ds9 regions skyformat degrees - $xpaset -p ds9 regions strip yes - $xpaset -p ds9 regions shape ellipse - $xpaset -p ds9 regions color red - $xpaset -p ds9 regions width 3 - $xpaset -p ds9 regions edit yes - $xpaset -p ds9 regions include - $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}' - $xpaset -p ds9 regions composite - $xpaset -p ds9 regions dissolve - $xpaset -p ds9 regions template foo.tpl - $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 - +47:12:48.02 fk5 - $xpaset -p ds9 regions savetemplate foo.tpl - $xpaset -p ds9 regions group new - $xpaset -p ds9 regions group foo new - $xpaset -p ds9 regions group foo update - $xpaset -p ds9 regions group foo select - $xpaset -p ds9 regions group foo color red - $xpaset -p ds9 regions group foo copy - $xpaset -p ds9 regions group foo delete - $xpaset -p ds9 regions group foo cut - $xpaset -p ds9 regions group foo font {times 14 bold} - $xpaset -p ds9 regions group foo move 100 100 - $xpaset -p ds9 regions group foo movefront - $xpaset -p ds9 regions group foo moveback - $xpaset -p ds9 regions group foo property delete no - $xpaset -p ds9 regions copy - $xpaset -p ds9 regions cut - $xpaset -p ds9 regions paste wcs - $xpaset -p ds9 regions undo - -
restore
-
Restore DS9 to a previous state from a backup save set.
- Syntax: - restore <filename> - - Example: - $xpaset -p ds9 restore ds9.bck
-
rgb
-
Create RGB frame and control RGB frame parameters.
- Syntax: - rgb [] -     [red|green|blue] -     [channel [red|green|blue]] -     [view [red|green|blue] [yes|no]] -     [system <coordsys>] -     [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]] -     [open|close] - - Example: - $xpaget ds9 rgb channel - $xpaget ds9 rgb lock wcs - $xpaget ds9 rgb lock crop - $xpaget ds9 rgb lock slice - $xpaget ds9 rgb lock bin - $xpaget ds9 rgb lock scale - $xpaset ds9 rgb lock scalelimits - $xpaget ds9 rgb lock colorbar - $xpaget ds9 rgb lock block - $xpaget ds9 rgb lock smooth - $xpaget ds9 rgb system - $xpaget ds9 rgb view red - $xpaget ds9 rgb view green - $xpaget ds9 rgb view blue - - $xpaset -p ds9 rgb # create new rgb frame - $xpaset -p ds9 rgb red # set current channel to red - $xpaset -p ds9 rgb channel red # set current channel to red - $xpaset -p ds9 rgb view blue no # turn off blue channel - $xpaset -p ds9 rgb system wcs # set rgb coordinate system - $xpaset -p ds9 rgb lock wcs yes - $xpaset -p ds9 rgb lock crop yes - $xpaset -p ds9 rgb lock slice yes - $xpaset -p ds9 rgb lock bin yes - $xpaset -p ds9 rgb lock scale yes - $xpaset -p ds9 rgb lock scalelimits yes - $xpaset -p ds9 rgb lock colorbar yes - $xpaset -p ds9 rgb lock block yes - $xpaset -p ds9 rgb lock smooth yes - $xpaset -p ds9 rgb open - $xpaset -p ds9 rgb close
-
rgbarray
-
Load raw data array cube into rgb frame.
-
- Syntax: - rgbarray [native|big|little] - rgbarray [new] -[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] - - Example: - $xpaget ds9 rgbarray > foo.arr - - $xpaget ds9 rgbarray little > foo.arr - $xpaset -p ds9 rgbarray - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - $xpaset -p ds9 rgbarray new - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] - - $cat foo.arr | xpaset ds9 rgbarray - [dim=512,zdim=3,bitpix=-32,endian=little] - $cat foo.arr | xpaset ds9 rgbarray new - [dim=512,zdim=3,bitpix=-32,endian=little]
-
rgbcube
-
Load FITS rgbcube into rgb frame.
-
- Syntax: - rgbcube [new] [<filename>] - - Example: - $xpaget ds9 rgbcube > foo.fits - - $xpaset -p ds9 rgbcube foo.fits - $xpaset -p ds9 rgbcube new foo.fits - - $cat foo.fits | xpaset ds9 rgbcube - $cat foo.fits | xpaset ds9 rgbcubenew
-
rgbimage
-
Load FITS rgbimage into rgb frame.
-
- Syntax: - rgbimage [new] [<filename>] - - Example: - $xpaget ds9 rgbimage > foo.fits - - $xpaset -p ds9 rgbimage foo.fits - $xpaset -p ds9 rgbimage new foo.fits - - $cat foo.fits | xpaset ds9 rgbimage - $cat foo.fits | xpaset ds9 rgbimage new - -
rotate
-
Controls the rotation angle (in degrees) of the current frame.
- Syntax: - rotate [<value>] -     [to <value>] -     [open|close] - - Example: - $xpaget ds9 rotate - - $xpaset -p ds9 rotate 45 - $xpaset -p ds9 rotate to 30 - $xpaset -p ds9 rotate open - $xpaset -p ds9 rotate close - -
save
-
-
Save loaded image data of current frame as FITS.
- Syntax: - save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice] - - Example: - $xpaset -p ds9 save foo.fits - $xpaset -p ds9 save fits foo.fits image - $xpaset -p ds9 save fits foo.fits table - $xpaset -p ds9 save fits foo.fits slice - $xpaset -p ds9 save rgbimage foo.fits - $xpaset -p ds9 save rgbcube foo.fits - $xpaset -p ds9 save mecube foo.fits - $xpaset -p ds9 save mosaic foo.fits - $xpaset -p ds9 save mosaicimage foo.fits
-
saveimage
-
-
Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: jpeg quality (1-100) and tiff - compression method.
- Syntax: - saveimage [fits|eps|gif|tiff|jpeg|png]<filename> - saveimage <filename>.jpeg [1-100] - saveimage <filename>.tiff [none|jpeg|packbits|deflate] - - Example: - $xpaset -p ds9 saveimage ds9.tiff - $xpaset -p ds9 saveimage jpeg ds9.jpeg 75
-
scale
-
Controls the limits and color scale distribution.
- Syntax: - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] -     [log exp <value>] -     [datasec yes|no] -     [limits <minvalue> <maxvalue>] -     [mode minmax|<value>|zscale|zmax] -     [scope local|global] -     [match] -     [match limits] -     [lock [yes|no]] -     [lock limits [yes|no]] -     [open|close] - - Example: - $xpaget ds9 scale - $xpaget ds9 scale log exp - $xpaget ds9 scale datasec - $xpaget ds9 scale limits - $xpaget ds9 scale mode - $xpaget ds9 scale scope - $xpaget ds9 scale lock - $xpaget ds9 scale lock limits - - $xpaset -p ds9 scale linear - $xpaset -p ds9 scale log exp 100 - $xpaset -p ds9 scale datasec yes - $xpaset -p ds9 scale histequ - $xpaset -p ds9 scale limits 1 100 - $xpaset -p ds9 scale mode zscale - $xpaset -p ds9 scale mode 99.5 - $xpaset -p ds9 scale scope local - $xpaset -p ds9 scale match - $xpaset -p ds9 scale match limits - $xpaset -p ds9 scale lock yes - $xpaset -p ds9 scale lock limits yes - $xpaset -p ds9 scale open - $xpaset -p ds9 scale close - -
shm
-
Load a shared memory segment into the current frame.
- Syntax: - shm [<key> [<filename>]] -     [key <key> [<filename>]] -     [shmid <id> [<filename>]] -     [fits [key|shmid] <id> - [<filename>]] -     [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]] -     [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] -     [rgbcube [key|shmid] <id> - [<filename>] -     [rgbimage [key|shmid] <id> - [<filename>]] -     [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] -     [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] - - Example: - $xpaget ds9 shm - - $xpaset -p ds9 shm 102 - $xpaset -p ds9 shm key 102 - $xpaset -p ds9 shm shmid 102 foo - $xpaset -p ds9 shm fits key 100 foo - $xpaset -p ds9 shm mosaicimage iraf key 100 foo - $xpaset -p ds9 shm mosaicimage wcs key 100 foo - $xpaset -p ds9 shm mosaicimage wcsa key 100 foo - $xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo - $xpaset -p ds9 shm mosaic iraf key 100 foo - $xpaset -p ds9 shm mosaic wcs key 100 foo - $xpaset -p ds9 shm rgbcube key 100 foo - $xpaset -p ds9 shm rgbimage key 100 foo - $xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] - $xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] - - sia
- -
Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise.
- Syntax: - sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] -     [<ref>] [cancel] -     [<ref>] [clear] -     [<ref>] [close] -     [<ref>] [coordinate <ra> - <dec> <coordsys>] -     [<ref>] [crosshair] -     [<ref>] [export sb|tsv - <filename>] -     [<ref>] [name <object>] -     [<ref>] [print] -     [<ref>] [retrieve] -     [<ref>] [save <filename>] -     [<ref>] [radius <value> - degrees|arcmin|arcsec] -     [<ref>] [sky <skyframe>] -     [<ref>] [skyformat <skyformat>] -     [<ref>] [system <coordsys>] -     [<ref>] [update] - - Example: - $xpaget ds9 sia - - $xpaset -p ds9 sia 2mass - $xpaset -p ds9 sia cancel - $xpaset -p ds9 sia clear - $xpaset -p ds9 sia close - $xpaset -p ds9 sia coordinate 202.48 47.21 fk5 - $xpaset -p ds9 sia crosshair - $xpaset -p ds9 sia export tsv bar.tsv - $xpaset -p ds9 sia name m51 - $xpaset -p ds9 sia print - $xpaset -p ds9 sia retrieve - $xpaset -p ds9 sia save foo.xml - $xpaset -p ds9 sia radius 1 degrees - $xpaset -p ds9 sia sky fk5 - $xpaset -p ds9 sia skyformat degrees - $xpaset -p ds9 sia system wcs - $xpaset -p ds9 sia update - - single -
Select Single Display mode
- Syntax: - single - - Example: - $xpaget ds9 single - - $xpaset -p ds9 single - -
skyview
-
Support for SkyView image server at HEASARC.
- Syntax: - skyview [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [pixels <width> <height>] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey <survey>] -     [open|close] - - Example: - $xpaget ds9 skyview name - $xpaget ds9 skyview coord - $xpaget ds9 skyview size - $xpaget ds9 skyview pixels - $xpaget ds9 skyview save - $xpaget ds9 skyview frame - $xpaget ds9 skyview survey - - $xpaset -p ds9 skyview - $xpaset -p ds9 skyview m31 - $xpaset -p ds9 skyview name m31 - $xpaset -p ds9 skyview name clear - $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 skyview size 60 60 arcmin - $xpaset -p ds9 skyview pixels 600 600 - $xpaset -p ds9 skyview save yes - $xpaset -p ds9 skyview frame current - $xpaset -p ds9 skyview update frame - $xpaset -p ds9 skyview survey sdssi - $xpaset -p ds9 skyview open - $xpaset -p ds9 skyview close
-
sleep
-
Delays execution for specified number of seconds. Default is 1 - second.
-
- Syntax: - sleep [#] - - Example: - $xpaset -p ds9 sleep - $xpaset -p ds9 sleep 2 - -
smooth
-
Smooth current image or set smooth parameters.
-
Boxcar width =2*radius+1 - Tophat diameter =2*radius+1 - Gaussian diameter =2*radius+1,mean=0 - Elliptical Gaussian diameter =2*radius+1,mean=0 - - Syntax: - smooth [] -     [yes|no] -     [function boxcar|tophat|gaussian] -     [radius <value>] -     [radiusminor <value>] -     [sigma <value>] -     [sigmaminor <value>] -     [angle <value>] -     [match] -     [lock [yes|no]] -     [open|close] -
-
Example: - $xpaget ds9 smooth - $xpaget ds9 smooth function - $xpaget ds9 smooth radius - $xpaget ds9 smooth radiusminor - $xpaget ds9 smooth sigma - $xpaget ds9 smooth sigmaminor - $xpaget ds9 smooth lock
-
- $xpaset -p ds9 smooth - $xpaset -p ds9 smooth yes - $xpaset -p ds9 smooth function tophat - $xpaset -p ds9 smooth radius 4 - $xpaset -p ds9 smooth radiusminor 4 - $xpaset -p ds9 smooth sigma 2.0 - $xpaset -p ds9 smooth sigmaminor 2.0 - $xpaset -p ds9 smooth angle 45 - $xpaset -p ds9 smooth match - $xpaset -p ds9 smooth lock yes - $xpaset -p ds9 smooth open - $xpaset -p ds9 smooth close
-
source
-
Source TCL code from a file. Only available for XPA_METHOD - local.
- Syntax: - source [<filename>] - - Example: - $xpaset -p ds9 source foo.tcl -
tcl
-
Execute one tcl command. Only available for XPA_METHOD - local.
- Syntax: - tcl [<tcl command>] - - Example: - $echo 'puts "Hello, World"' | xpaset ds9 tcl - $xpaset -p ds9 tcl {puts {Hello, World}} - -
threads
-
Set number of process threads for functions which are - multi-threaded.
-
- Syntax: - threads # - - Example: - $xpaget ds9 threads - - $xpaset -p ds9 threads 8
-
tiff
-
Load TIFF image into current frame. Optional parameters: tiff - compression method.
- Syntax: - tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] - - Example: - $xpaget ds9 tiff > foo.tiff - $xpaget ds9 tiff jpeg > foo.tiff - - $xpaset -p ds9 tiff foo.tiff - $xpaset -p ds9 tiff new foo.tiff - $xpaset -p ds9 tiff slice foo.tiff - - $cat foo.tiff | xpaset ds9 tiff - $cat foo.tiff | xpaset ds9 tiff new - $cat foo.tiff | xpaset ds9 tiff slice -
tile
-
Controls the tile display mode.
- Syntax: - tile [] -     [yes|no] -     [mode grid|column|row] -     [grid] -     [grid mode automatic|manual] -     [grid direction x|y] -     [grid layout <col> <row>] -     [grid gap <pixels>] -     [row] -     [column] - - Example: - $xpaget ds9 tile - $xpaget ds9 tile mode - $xpaget ds9 tile grid mode - $xpaget ds9 tile grid direction - $xpaget ds9 tile grid layout - $xpaget ds9 tile grid gap - - $xpaset -p ds9 tile - $xpaset -p ds9 tile yes - $xpaset -p ds9 tile mode row - $xpaset -p ds9 tile grid - $xpaset -p ds9 tile grid mode manual - $xpaset -p ds9 tile grid direction x - $xpaset -p ds9 tile grid layout 5 5 - $xpaset -p ds9 tile grid gap 10 - $xpaset -p ds9 tile row - $xpaset -p ds9 tile column -
update
-
Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option.
- Syntax: - update [] -     [# x1 y1 x2 y2] -     [now] -     [now # x1 y1 x2 y2] - - Example: - $xpaset -p ds9 update - $xpaset -p ds9 update 1 100 100 300 400 - $xpaset -p ds9 update now - $xpaset -p ds9 update now 1 100 100 300 400
-
url
-
Load FITS from URL into the current frame
- Syntax: - url <url> - - Example: - $xpaset -p ds9 url http://foo.bar.edu/foo.fits - -
version
-
Returns the current version of DS9.
- Syntax: - version - - Example: - $xpaget ds9 version -
view
-
Controls the GUI.
- Syntax: - view [layout horizontal|vertical] -     [keyvalue <string>] -     [info yes|no] -     [panner yes|no] -     [magnifier yes|no] -     [buttons yes|no] -     [colorbar yes|no] -     [colorbar horizontal|vertical] -     [colorbar numerics yes|no] -     [graph horizontal|vertical yes|no] -     [filename yes|no[ -     [object yes|no] -     [keyword yes|no] -     [minmax yes|no] -     [lowhigh yes|no] -     [units yes|no] -     [image|physical|wcs|wcsa...wcsz yes|no] -     [frame yes|no] -     [red yes|no] -     [green yes|no] -     [blue yes|no] - - Example: - $xpaget ds9 view layout - $xpaget ds9 view keyvalue - $xpaget ds9 view info - $xpaget ds9 view panner - $xpaget ds9 view magnifier - $xpaget ds9 view buttons - $xpaget ds9 view colorbar - $xpaget ds9 view graph horizontal - $xpaget ds9 view filename - $xpaget ds9 view object - $xpaget ds9 view keyword - $xpaget ds9 view minmax - $xpaget ds9 view lowhigh - $xpaget ds9 view units - $xpaget ds9 view image - $xpaget ds9 view wcsa - $xpaget ds9 view red - $xpaget ds9 view frame - - $xpaset -p ds9 view layout vertical - $xpaset -p ds9 view keyvalue BITPIX - $xpaset -p ds9 view info yes - $xpaset -p ds9 view panner yes - $xpaset -p ds9 view magnifier yes - $xpaset -p ds9 view buttons yes - $xpaset -p ds9 view colorbar yes - $xpaset -p ds9 view graph horizontal yes - $xpaset -p ds9 view filename yes - $xpaset -p ds9 view object yes - $xpaset -p ds9 view keyword yes - $xpaset -p ds9 view minmax yes - $xpaset -p ds9 view lowhigh yes - $xpaset -p ds9 view units yes - $xpaset -p ds9 view wcsa yes - $xpaset -p ds9 view frame yes - $xpaset -p ds9 view red yes - $xpaset -p ds9 view green yes - $xpaset -p ds9 view blue yes
-
- vla -
Support for VLA Sky Survey.
- Syntax: - vla [] -     [<object>] -     [name <object>|clear] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [survey first|stripe82] -     [open|close] - - Example: - $xpaget ds9 vla name - $xpaget ds9 vla coord - $xpaget ds9 vla size - $xpaget ds9 vla save - $xpaget ds9 vla frame - $xpaget ds9 vla survey - - $xpaset -p ds9 vla - $xpaset -p ds9 vla m31 - $xpaset -p ds9 vla name m31 - $xpaset -p ds9 vla name clear - $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 vla size 60 60 arcmin - $xpaset -p ds9 vla save yes - $xpaset -p ds9 vla frame current - $xpaset -p ds9 vla update frame - $xpaset -p ds9 vla survey stripe82 - $xpaset -p ds9 vla open - $xpaset -p ds9 vla close
-
vlss
-
Support for NRAO VLSS Sky Survey.
- Syntax: - vlss [] -     [<object>] -     [name <object>] -     [<ra> <dec>] # in wcs fk5 -     [size <width> <height> - degrees|arcmin|arcsec] -     [save yes|no] -     [frame new|current] -     [update frame|crosshair] -     [open|close] - - Example: - $xpaget ds9 vlss name - $xpaget ds9 vlss coord - $xpaget ds9 vlss size - $xpaget ds9 vlss save - $xpaget ds9 vlss frame - - $xpaset -p ds9 vlss - $xpaset -p ds9 vlss m31 - $xpaset -p ds9 vlss name m31 - $xpaset -p ds9 vlss name clear - $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 - $xpaset -p ds9 vlss size 60 60 arcmin - $xpaset -p ds9 vlss save yes - $xpaset -p ds9 vlss frame current - $xpaset -p ds9 vlss update frame - $xpaset -p ds9 vlss open - $xpaset -p ds9 vlss close
-
vo
-
Invoke an connection to a Virtual Observatory site.
- Syntax: - vo [method xpa|mime] -    [server <url>] -    [internal yes|no] -    [delay #] -    [<url>] -    [connect <url>] -    [disconnect <url>] -    [open|close] - - Example: - $xpaget ds9 vo - $xpaget ds9 vo method - $xpaget ds9 vo server - $xpaget ds9 vo internal - $xpaget ds9 vo delay - $xpaget ds9 vo connect - - $xpaset -p ds9 vo method xpa - $xpaset -p ds9 vo server http://foo.bar.edu/list.txt - $xpaset -p ds9 vo internal yes - $xpaset -p ds9 vo delay 15 # keep-alive delay - $xpaset -p ds9 vo chandra-ed - $xpaset -p ds9 vo connect chandra-ed - $xpaset -p ds9 vo disconnect chandra-ed - $xpaset -p ds9 vo open - $xpaset -p ds9 vo close - -
wcs
-
Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, using this access point, a new WCS - specification can be loaded and used by the current image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
- Syntax: - wcs [[system] wcs|wcsa...wcsz] -     [[sky] fk4|fk5|icrs|galactic|ecliptic] -     [[skyformat] degrees|sexagesimal] -     [align yes|no] -     [reset [#]] -     [replace [#] <filename>] -     [append [#] <filename>] -     [open|close] - - Example: - $xpaget ds9 wcs - $xpaget ds9 wcs system - $xpaget ds9 wcs sky - $xpaget ds9 wcs skyformat - $xpaget ds9 wcs align - - $xpaset -p ds9 wcs wcs - $xpaset -p ds9 wcs system wcs - $xpaset -p ds9 wcs fk5 - $xpaset -p ds9 wcs sky fk5 - $xpaset -p ds9 wcs sexagesimal - $xpaset -p ds9 wcs skyformat sexagesimal - $xpaset -p ds9 wcs align yes - $xpaset -p ds9 wcs reset - $xpaset -p ds9 wcs reset 3 - $xpaset -p ds9 wcs replace foo.wcs - $xpaset -p ds9 wcs replace 3 foo.wcs - $xpaset -p ds9 wcs append foo.wcs - $xpaset -p ds9 wcs append 3 foo.wcs - $xpaset -p ds9 open - $xpaset -p ds9 close -
- $cat foo.wcs | xpaset ds9 wcs replace - $cat foo.wcs | xpaset ds9 wcs append - $echo "OBJECT = 'foobar'" | xpaset ds9 wcs append - -
web
-
Display specified URL in the web display.
- Syntax: - web [] -     [<url>] -     [new <webname> <url>] -     [<webname>] [click - back|forward|stop|reload|#] -     [<webname>] [clear] -     [<webname>] [close] - - Example: - $xpaget ds9 web - - $xpaset -p ds9 web www.cnn.com - $xpaset -p ds9 web new www.cnn.com - $xpaset -p ds9 web hvweb www.apple.com - $xpaset -p ds9 web click back - $xpaset -p ds9 web click 2 - $xpaset -p ds9 web clear - $xpaset -p ds9 web close - -
width
-
Set the width of the image display window.
- Syntax: - width [<value>] - - Example: - $xpaget ds9 width - - $xpaset -p ds9 width 512
-
xpa
-
Configure XPA.
- Syntax: - -xpa [disconnect] -     [info] - - Example: - $xpaget ds9 info - - $xpaset -p ds9 disconnect - $xpaset -p ds9 info - -
zscale
-
Set Scale Limits based on the IRAF algorithm.
- Syntax: - zscale [] -     [contrast] -     [sample] -     [line] - - Example: - $xpaget ds9 zscale contrast - $xpaget ds9 zscale sample - $xpaget ds9 zscale line - - $xpaset -p ds9 zscale - $xpaset -p ds9 zscale contrast .25 - $xpaset -p ds9 zscale sample 600 - $xpaset -p ds9 zscale line 120 - -
zoom
-
Controls the current zoom value for the current frame.
- Syntax: - zoom [<value>] -     [<value> <value>] -     [to <value>] -     [to <value> <value>] -     [in] -     [out] -     [to fit] -     [open|close] - - Example: - $xpaget ds9 zoom - - $xpaset -p ds9 zoom 2 - $xpaset -p ds9 zoom 2 4 - $xpaset -p ds9 zoom to 4 - $xpaset -p ds9 zoom to 2 4 - $xpaset -p ds9 zoom in - $xpaset -p ds9 zoom out - $xpaset -p ds9 zoom to fit - $xpaset -p ds9 zoom open - $xpaset -p ds9 zoom close -
- + + + + +XPA Access Points + + +
XPA Access Points
+
+
The XPA messaging system provides seamless communication between DS9 and other Unix programs, including X programs. It also provides an easy way for users to communicate with DS9 by executing XPA client commands in the shell or by utilizing such commands in scripts. Because XPA works both at the programming level and the shell level, it is a powerful tool for unifying any analysis environment.
+2mass +3d +about +align +analysis +array +background +backup +bin +blink +block +catalog +cd +cmap +colorbar +console +contour +crop +crosshair +cube +cursor +data +dsssao +dsseso +dssstsci +envi +exit +export +file +fits +frame +gif +grid +header +height +iconify +iexam +iis +jpeg +lock +lower +magnifier +mask +match +mecube +minmax +mode +mosaic +mosaicimage +movie +multiframe +nameserver +nrrd +nvss +orient +pagesetup +pan +pixeltable +plot +png +precision +prefs +preserve +psprint +print +quit +raise +regions +restore +rgb +rgbarray +rgbcube +rgbimage +rotate +save +saveimage +scale +shm +sia +single +skyview +sleep +smooth +source +tcl +threads +tile +update +url +version +view +vla +vlss +vo +wcs +web +width +xpa +zscale +zoom +
2mass
+
Support for 2MASS Digital Sky Survey.
+Syntax: +2mass [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey j|h|k] +    [open|close] + +Example: +$xpaget ds9 2mass name +$xpaget ds9 2mass coord +$xpaget ds9 2mass size +$xpaget ds9 2mass save +$xpaget ds9 2mass frame +$xpaget ds9 2mass survey + +$xpaset -p ds9 2mass +$xpaset -p ds9 2mass m31 +$xpaset -p ds9 2mass name m31 +$xpaset -p ds9 2mass name clear +$xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 2mass size 60 60 arcmin +$xpaset -p ds9 2mass save yes +$xpaset -p ds9 2mass frame current +$xpaset -p ds9 2mass update frame +$xpaset -p ds9 2mass survey j +$xpaset -p ds9 2mass open +$xpaset -p ds9 2mass close
+
3d
+
Support for 3D frame.
+Syntax: +3d [] +    [view <az> <el>] +    [az <az>] +    [el <el>] +    [scale <scale>] +    [method mip|aip] +    [background none|azimuth|elevation] +    [border yes|no] +    [border color <color>] +    [highlite yes|no] +    [highlite color <color>] +    [compass yes|no] +    [compass color <color>] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 3d view +$xpaget ds9 3d az +$xpaget ds9 3d el +$xpaget ds9 3d scale +$xpaget ds9 3d method +$xpaget ds9 3d background +$xpaget ds9 3d border +$xpaget ds9 3d border color +$xpaget ds9 3d highlite +$xpaget ds9 3d highlite color +$xpaget ds9 3d compass +$xpaget ds9 3d compass color +$xpaget ds9 3d lock + +$xpaset -p ds9 3d # create new 3D frame +$xpaset -p ds9 3d view 45 30 +$xpaset -p ds9 3d az 45 +$xpaset -p ds9 3d el 30 +$xpaset -p ds9 3d scale 10 +$xpaset -p ds9 3d method mip +$xpaset -p ds9 3d background azimuth +$xpaset -p ds9 3d border yes +$xpaset -p ds9 3d border color red +$xpaset -p ds9 3d highlite yes +$xpaset -p ds9 3d highlite color red +$xpaset -p ds9 3d compass yes +$xpaset -p ds9 3d compass color red +$xpaset -p ds9 3d match +$xpaset -p ds9 3d lock yes +$xpaset -p ds9 3d open +$xpaset -p ds9 3d close
+
about
+
Get DS9 credits.
+Syntax: +about + +Example: +$xpaget ds9 about +
align
+
Controls the World Coordinate System alignment for the current frame.
+Syntax: +align [] +    [yes|no] + +Example: +$xpaget ds9 align + +$xpaset -p ds9 align yes +
analysis
+
Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message and display text in the text dialog window.
+Syntax: +analysis [<task number>] +    [<filename>] +    [task <task number>|<task name>] +    [load <filename>] +    [clear] +    [clear][load <filename>] +    [message ok|okcancel|yesno <message>] +    [entry <message>] +    [text] + +Example: +$xpaget ds9 analysis +$xpaget ds9 analysis task +$xpaget ds9 analysis entry {Please enter something} +$xpaget ds9 analysis message okcancel {Hello World} + +$xpaset -p ds9 analysis 0 # invoke first analysis task +$xpaset -p ds9 analysis task 0 +$xpaset -p ds9 analysis task foobar +$xpaset -p ds9 analysis {foo bar} +$xpaset -p ds9 analysis my.ans +$xpaset -p ds9 analysis load my.ans +$xpaset -p ds9 analysis clear +$xpaset -p ds9 analysis clear load my.ans +$xpaset -p ds9 analysis message {This is a message} +$xpaset -p ds9 analysis text {this is text} + +$cat my.ans | xpaset ds9 analysis load +$cat foo.txt | xpaset ds9 analysis text
+
array
+
Load raw data array into current frame.
+Syntax: +array [native|little|big] +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +$xpaget ds9 array > foo.arr +$xpaget ds9 array little > foo.arr + +$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little] +$xpaset -p ds9 array new foo.arr[dim=512,bitpix=-32,endian=little] +$xpaset -p ds9 array mask foo.arr[dim=512,bitpix=-32,endian=little] + +$cat foo.arr | xpaset ds9 array[dim=512,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 array new[dim=512,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 array mask [dim=512,bitpix=-32,endian=little] +
bg
+background
+
Set image background color.
+Syntax: +bg <color> + +Example: +$xpaget ds9 bg + +$xpaset -p ds9 bg red
+
backup
+
Create a backup save set.
+Syntax: +backup <filename> + +Example: +$xpaset -p ds9 backup ds9.bck
+
bin
+
Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking is provided for backward compatibility.
+Syntax: +bin [about <x> <y>] +    [about center] +    [buffersize <value>] +    [cols <x> <y>] +    [colsz <x> <y> <z>] +    [factor <value> [<vector>]] +    [depth <value>] +    [filter <string>] +    [filter clear] +    [function average|sum] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 bin about +$xpaget ds9 bin buffersize +$xpaget ds9 bin cols +$xpaget ds9 bin factor +$xpaget ds9 bin depth +$xpaget ds9 bin filter +$xpaget ds9 bin function +$xpaget ds9 bin smooth +$xpaget ds9 bin smooth function +$xpaget ds9 bin smooth radius +$xpaget ds9 bin lock + +$xpaset -p ds9 bin about 4096 4096 +$xpaset -p ds9 bin about center +$xpaset -p ds9 bin buffersize 512 +$xpaset -p ds9 bin cols detx dety +$xpaset -p ds9 bin colsz detx dety time +$xpaset -p ds9 bin factor 4 +$xpaset -p ds9 bin factor 4 2 +$xpaset -p ds9 bin depth 10 +$xpaset -p ds9 bin filter 'pha > 5' +$xpaset -p ds9 bin filter clear +$xpaset -p ds9 bin function sum +$xpaset -p ds9 bin in +$xpaset -p ds9 bin out +$xpaset -p ds9 bin to fit +$xpaset -p ds9 bin match +$xpaset -p ds9 bin lock yes +$xpaset -p ds9 bin open +$xpaset -p ds9 bin close
+
blink
+
Blink mode parameters. Interval is in seconds.
+Syntax: +blink [] +    [yes|no] +    [interval <value>] + +Example: +$xpaget ds9 blink +$xpaget ds9 blink interval + +$xpaset -p ds9 blink +$xpaset -p ds9 blink yes +$xpaset -p ds9 blink interval 1
+
block
+
Controls blocking parameters.
+Syntax: +block[<value>] +    [<value> <value>] +    [to <value>] +    [to <value><value>] +    [in] +    [out] +    [to fit] +    [match] +    [lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 block +$xpaget ds9 block lock + +$xpaset -p ds9 block 4 +$xpaset -p ds9 block 4 2 +$xpaset -p ds9 block to 4 +$xpaset -p ds9 block to 4 2 +$xpaset -p ds9 block in +$xpaset -p ds9block out +$xpaset -p ds9 block to fit +$xpaset -p ds9 block match +$xpaset -p ds9 block lock yes +$xpaset -p ds9 block open +$xpaset -p ds9 block close
+
catalog
+cat
+
Support for catalogs. The first three commands will create a new catalog search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +catalog [new] +    [ned|simbad|denis|skybot] +    [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho] +    [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1] +    [2mass|iras] +    [csc|xmm|rosat] +    [first|nvss] +    [chandralog|cfhtlog|esolog|stlog|xmmlog] +    [cds <catalogname>] +    [cds <catalogid>] + +    [load <filename>] +    [import sb|tsv <filename>] + +    [<ref>] [<ra> <dec> <coordsys>] +    [<ref>] [allcols] +    [<ref>] [allrows] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [crosshair] +    [<ref>] [dec <col>] +    [<ref>] [edit yes|no] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [filter <string>] +    [<ref>] [filter load <filename>] +    [<ref>] [header] +    [<ref>] [location <code>] +    [<ref>] [match] +    [<ref>] [match <ref> <ref>] +    [<ref>] [match error <value> degrees|arcmin|arcsec] +    [<ref>] [match function 1and2|1not2|2not1] +    [<ref>] [match return 1and2|1only|2only] +    [<ref>] [match unique yes|no] +    [<ref>] [maxrows <number>] +    [<ref>] [name <object>] +    [<ref>] [panto yes|no] +    [<ref>] [plot <xcol> <ycol> <xerrcol> <yerrcol>] +    [<ref>] [print] +    [<ref>] [psky <skyframe>] +    [<ref>] [psystem <coordsys>] +    [<ref>] [ra <col>] +    [<ref>] [regions] +    [<ref>] [retrieve] +    [<ref>] [samp] +    [<ref>] [samp broadcast] +    [<ref>] [samp send <application>] +    [<ref>] [save <filename>] +    [<ref>] [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao] +    [<ref>] [show yes|no] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [sort <col> incr|decr] +    [<ref>] [symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>] +    [<ref>] [symbol [#] text|size|size2|units|angle <value>] +    [<ref>] [symbol shape circle|ellipse|box|text|point] +    [<ref>] [symbol shapecircle point|box point|diamond point|cross point|x point|arrow point|boxcircle point] +    [<ref>] [symbol add| [#] remove] +    [<ref>] [symbol save|load <filename>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] +    [<ref>] [x <col>] +    [<ref>] [y <col>] + +Example: +$xpaget ds9 catalog +$xpaget ds9 catalog header + +$xpaset -p ds9 catalog new +$xpaset -p ds9 catalog 2mass +$xpaset -p ds9 catalog cds 2mass +$xpaset -p ds9 catalog cds {I/252} + +$xpaset -p ds9 catalog load foo.xml +$xpaset -p ds9 catalog import tsv foo.tsv + +$xpaset -p ds9 catalog 202.48 47.21 fk5 +$xpaset -p ds9 catalog allrows +$xpaset -p ds9 catalog allcols +$xpaset -p ds9 catalog cancel +$xpaset -p ds9 catalog clear +$xpaset -p ds9 catalog close +$xpaset -p ds9 catalog crosshair +$xpaset -p ds9 catalog dec DEC +$xpaset -p ds9 catalog edit yes +$xpaset -p ds9 catalog export tsv bar.tsv +$xpaset -p ds9 catalog filter '$Jmag>10' +$xpaset -p ds9 catalog filter load foo.flt +$xpaset -p ds9 catalog header +$xpaset -p ds9 catalog location 500 +$xpaset -p ds9 catalog match error 2 arcsec +$xpaset -p ds9 catalog match function 1and2 +$xpaset -p ds9 catalog match unique no +$xpaset -p ds9 catalog match return 1only +$xpaset -p ds9 catalog match # last two catalogs loaded +$xpaset -p ds9 catalog match 2mass csc +$xpaset -p ds9 catalog maxrows 2000 +$xpaset -p ds9 catalog name m51 +$xpaset -p ds9 catalog panto no +$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag' +$xpaset -p ds9 catalog print +$xpaset -p ds9 catalog psky fk5 +$xpaset -p ds9 catalog psystem wcs +$xpaset -p ds9 catalog ra RA +$xpaset -p ds9 catalog regions +$xpaset -p ds9 catalog retrieve +$xpaset -p ds9 catalog samp broadcast +$xpaset -p ds9 catalog samp send aladin +$xpaset -p ds9 catalog save foo.xml +$xpaset -p ds9 catalog server sao +$xpaset -p ds9 catalog show yes +$xpaset -p ds9 catalog radius 1 degrees +$xpaset -p ds9 catalog symbol condition '$Jmag>15' +$xpaset -p ds9 catalog symbol 2 shape {boxcircle point} +$xpaset -p ds9 catalog symbol color red +$xpaset -p ds9 catalog symbol font times +$xpaset -p ds9 catalog symbol fontsize 14 +$xpaset -p ds9 catalog symbol fontweight bold +$xpaset -p ds9 catalog symbol fontslant italic +$xpaset -p ds9 catalog symbol add +$xpaset -p ds9 catalog symbol 2 remove +$xpaset -p ds9 catalog symbol load foo.sym +$xpaset -p ds9 catalog symbol save bar.sym +$xpaset -p ds9 catalog sky fk5 +$xpaset -p ds9 catalog skyformat degrees +$xpaset -p ds9 catalog sort {Jmag} incr +$xpaset -p ds9 catalog system wcs +$xpaset -p ds9 catalog update +$xpaset -p ds9 catalog x RA +$xpaset -p ds9 catalog y DEC
+
cd
+
Sets/Returns the current working directory.
+Syntax: +cd [<directory>] + +Example: +$xpaget ds9 cd + +$xpaset -p ds9 cd /home/mrbill +
cmap
+
Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to 10 and bias value from 0 to 1.
+Syntax: +cmap [<colormap>] +    [file] +    [load <filename>] +    [save <filename>] +    [invert yes|no] +    [<constrast> <bias>] +    [tag [load|save] <filename>] +    [tag delete] +    [open|close] + +Example: +$xpaget ds9 cmap +$xpaget ds9 cmap file +$xpaget ds9 cmap invert +$xpaget ds9 cmap value + +$xpaset -p ds9 cmap Heat +$xpaset -p ds9 cmap load foo.sao +$xpaset -p ds9 cmap save bar.sao +$xpaset -p ds9 cmap invert yes +$xpaset -p ds9 cmap 5 .5 +$xpaset -p ds9 cmap tag load foo.tag +$xpaset -p ds9 cmap tag save foo.tag +$xpaset -p ds9 cmap tag delete +$xpaset -p ds9 cmap open +$xpaset -p ds9 cmap close +
colorbar
+
Controls colorbar parameters.
+Syntax: +colorbar [] +    [yes|no] +    [orientation] +    [horizontal|vertical] +    [numerics yes|no] +    [space value|distance] +    [font times|helvetica|courier] +    [fontsize <value>] +    [fontweight normal|bold] +    [fontslant roman|italic] +    [size] +    [ticks] +    [match] +    [lock [yes|no]] +
+Example: +$xpaget ds9 colorbar +$xpaget ds9 colorbar orientation +$xpaget ds9 colorbar numerics +$xpaget ds9 colorbar space +$xpaget ds9 colorbar font +$xpaget ds9 colorbar fontsize +$xpaget ds9 colorbar fontweight +$xpaget ds9 colorbar fontslant +$xpaget ds9 colorbar size +$xpaget ds9 colorbar ticks +$xpaget ds9 colorbar lock + +$xpaset -p ds9 colorbar yes +$xpaset -p ds9 colorbar vertical +$xpaset -p ds9 colorbar orientation vertical +$xpaset -p ds9 colorbar numerics yes +$xpaset -p ds9 colorbar space value +$xpaset -p ds9 colorbar font times +$xpaset -p ds9 colorbar fontsize 14 +$xpaset -p ds9 colorbar fontweight bold +$xpaset -p ds9 colorbar fontslant italic +$xpaset -p ds9 colorbar size 20 +$xpaset -p ds9 colorbar ticks 11 +$xpaset -p ds9 colorbar match +$xpaset -p ds9 colorbar lock yes +
console
+
Display tcl console window.
+Syntax: +-console + +Example: +$xpaset -p ds9 console +
contour
+
Controls contours in the current frame.
+Syntax: +contour [] +    [yes|no] +    [<coordsys> [<skyframe>]] +    [clear] +    [generate] +    [load <filename>] +    [save <filename> [<coordsys> <skyframe>]] +    [convert] +    [load levels <filename>] +    [save levels <filename>] +    [copy] +    [paste [<coordsys> <color> <width> yes|no]] +    [color <color>] +    [width <width>] +    [dash yes|no] +    [smooth <smooth>] +    [method block|smooth] +    [nlevels <number of levels>] +    [scale linear|log|pow|squared|sqrt|asinh|sinh|histequ] +    [log exp <value>] +    [mode minmax|<value>|zscale|zmax] +    [scope global|local] +    [limits <min> <max>] +    [levels <value value value...>] +    [open|close] + +Example: +$xpaget ds9 contour +$xpaget ds9 contour wcs fk5 +$xpaget ds9 contour color +$xpaget ds9 contour width +$xpaget ds9 contour dash +$xpaget ds9 contour smooth +$xpaget ds9 contour method +$xpaget ds9 contour nlevels +$xpaget ds9 contour scale +$xpaget ds9 contour log exp +$xpaget ds9 contour mode +$xpaget ds9 contour scope +$xpaget ds9 contour limits +$xpaget ds9 contour levels + +$xpaset -p ds9 contour +$xpaset -p ds9 contour yes +$xpaset -p ds9 contour clear +$xpaset -p ds9 contour generate +$xpaset -p ds9 contour load ds9.ctr +$xpaset -p ds9 contour save ds9.ctr +$xpaset -p ds9 contour save ds9.ctr wcs fk5 +$xpaset -p ds9 contour convert +$xpaset -p ds9 contour load levels ds9.ctr +$xpaset -p ds9 contour save levels ds9.lev +$xpaset -p ds9 contour copy +$xpaset -p ds9 contour paste +$xpaset -p ds9 contour paste wcs red 2 no +$xpaset -p ds9 contour color yellow +$xpaset -p ds9 contour width 2 +$xpaset -p ds9 contour dash yes +$xpaset -p ds9 contour smooth 5 +$xpaset -p ds9 contour method smooth +$xpaset -p ds9 contour nlevels 10 +$xpaset -p ds9 contour scale sqrt +$xpaset -p ds9 contour log exp 1000 +$xpaset -p ds9 contour mode zscale +$xpaset -p ds9 contour scope local +$xpaset -p ds9 contour limits 1 100 +$xpaset -p ds9 contour levels 1 10 100 1000 +$xpaset -p ds9 contour open +$xpaset -p ds9 contour close
+
crop
+
Set current image display area.
+Syntax: +crop [<x> <y> <width> <height> [<coordsys>][<skyframe>][degrees|arcmin|arcsec] +    [match <coordsys>] +    [lock <coordsys>|none] +    [reset] +    [3d zmin zmax <coordsys>] +    [open|close] + +Example: +$xpaget ds9 crop # get crop in physical coords +$xpaget ds9 crop wcs galactic sexagesimal arcsec +$xpaget ds9 crop lock + +$xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords +$xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs galactic arcsec +$xpaset -p ds9 crop match wcs +$xpaset -p ds9 crop lock wcs +$xpaset -p ds9 crop reset +$xpaset -p ds9 crop 3d .25 .50 wcs +$xpaset -p ds9 crop open +$xpaset -p ds9 crop close +
crosshair
+
Controls the current position of the crosshair in the current frame. DS9 is placed in crosshair mode when the crosshair is set.
+Syntax: +crosshair [<x> <y> <coordsys> [<skyframe>]] +    [match <coordsys>] +    [lock <coordsys>|none] + +Example: +$xpaget ds9 crosshair # get crosshair in physical coords +$xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs coords +$xpaget ds9 crosshair lock + +$xpaset -p ds9 crosshair 100 100 physical # set crosshair in physical +$xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords +$xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5 +$xpaset -p ds9 crosshair match wcs +$xpaset -p ds9 crosshair lock wcs +
cube
+
Controls FITS cube dialog.
+Syntax: +cube [] +    [play|stop|next|prev|first|last] +    [<slice> [<coordsys>]] +    [interval <numeric>] +    [match <coordsys>] +    [lock <coordsys>|none] +    [order 123|132|213|231|312|321] +    [axes lock [yes|no]] +    [open|close] + +Example: +$xpaget ds9 cube +$xpaget ds9 cube wcs +$xpaget ds9 cube interval +$xpaget ds9 cube lock +$xpaget ds9 cube order +$xpaget ds9 cube axes lock + +$xpaset -p ds9 cube +$xpaset -p ds9 cube play +$xpaset -p ds9 cube last +$xpaset -p ds9 cube 3 +$xpaset -p ds9 cube 4.4 wcs +$xpaset -p ds9 cube interval 2 +$xpaset -p ds9 cube match wcs +$xpaset -p ds9 cube lock wcs +$xpaset -p ds9 cube order 123 +$xpaset -p ds9 cube axes lock yes +$xpaset -p ds9 cube open +$xpaset -p ds9 cube close
+
cursor
+
Move mouse pointer or crosshair in image pixels in the current frame. Note, this will move selected Regions also.
+Syntax: +cursor [<x> <y>] + +Example: +$xpaset -p ds9 cursor 10 10 +
data
+
Return an array of data values given a lower left corner and a width and height in specified coordinate system. The last argument of yes indicates to strip the coordinates from the output and just list the data values. The default is yes.
+Syntax: +data [<coordsys> [<skyframe>] <x> <y> <width> <height> [yes|no]] + +Example: +$xpaget ds9 data image 450 520 3 3 yes +$xpaget ds9 data physical 899 1039 6 6 no +$xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no +$xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 no +
dsssao
+dss
+
Support for Digital Sky Survey at SAO.
+Syntax: +dsssao [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 dsssao name +$xpaget ds9 dsssao coord +$xpaget ds9 dsssao size +$xpaget ds9 dsssao save +$xpaget ds9 dsssao frame + +$xpaset -p ds9 dsssao +$xpaset -p ds9 dsssao m31 +$xpaset -p ds9 dsssao name m31 +$xpaset -p ds9 dsssao name clear +$xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dsssao size 60 60 arcmin +$xpaset -p ds9 dsssao save yes +$xpaset -p ds9 dsssao frame current +$xpaset -p ds9 dsssao update frame +$xpaset -p ds9 dsssao open +$xpaset -p ds9 dsssao close
+
dsseso
+
Support for Digital Sky Survey at ESO.
+Syntax: +dsseso [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey DSS1|DSS2-red|DSS2-blue|DSS2-infrared] +    [open|close] + +Example: +$xpaget ds9 dsseso name +$xpaget ds9 dsseso coord +$xpaget ds9 dsseso size +$xpaget ds9 dsseso save +$xpaget ds9 dsseso frame +$xpaget ds9 dsseso survey + +$xpaset -p ds9 dsseso +$xpaset -p ds9 dsseso m31 +$xpaset -p ds9 dsseso name m31 +$xpaset -p ds9 dsseso name clear +$xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dsseso size 60 60 arcmin +$xpaset -p ds9 dsseso save yes +$xpaset -p ds9 dsseso frame current +$xpaset -p ds9 dsseso update frame +$xpaset -p ds9 dsseso survey DSS2-red +$xpaset -p ds9 dsseso open +$xpaset -p ds9 dsseso close
+
dssstsci
+
Support for Digital Sky Survey at STSCI.
+Syntax: +dssstsci [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] +    [survey poss1_blue|poss1_red] +    [survey all|quickv|phase2_gsc2|phase2_gsc1] +    [open|close] + +Example: +$xpaget ds9 dssstsci name +$xpaget ds9 dssstsci coord +$xpaget ds9 dssstsci size +$xpaget ds9 dssstsci save +$xpaget ds9 dssstsci frame +$xpaget ds9 dssstsci survey + +$xpaset -p ds9 dssstsci +$xpaset -p ds9 dssstsci m31 +$xpaset -p ds9 dssstsci name m31 +$xpaset -p ds9 dssstsci name clear +$xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 dssstsci size 60 60 arcmin +$xpaset -p ds9 dssstsci save yes +$xpaset -p ds9 dssstsci frame current +$xpaset -p ds9 dssstsci update frame +$xpaset -p ds9 dssstsci survey all +$xpaset -p ds9 dssstsci open +$xpaset -p ds9 dssstsci close
+
envi
+
Load an ENVI header and file. Optional parameter: array endian.
+Syntax: envi [new] <header> [<filename>] Example: $xpaset -p ds9 envi foo.hdr $xpaset -p ds9 envi new foo.hdr $xpaset -p ds9 envi foo.hdr foo.bsq
+exit
+
quits
+
Quits DS9.
+Syntax: +exit +quit + +Example: +$xpaset -p ds9 exit +
export
+
Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method.
+Syntax: +export[array|nrrd|envi|gif|tiff|jpeg|png]<filename> +export array <filename>[big|little|native] +export nrrd <filename>[big|little|native] +export envi <header> [<filename>][big|little|native] +export jpeg <filename>[1-100] +export tiff <filename>[none|jpeg|packbits|deflate] + +Example: +$xpaset -p ds9 export array foo.arr little +$xpaset -p ds9 export nrrd foo.nrrd little +$xpaset -p ds9 export envi foo.hdr little +$xpaset -p ds9 export envi foo.hdr foo.bsq little +$xpaset -p ds9 export tiff foo.tiff jpeg +$xpaset -p ds9 export jpeg foo.jpeg 75 +$xpaset -p ds9 export png foo.png
+
file
+
Query currently loaded file information.
+Syntax: +file + +Example: +$xpaget ds9 file
+
fits
+
Load a FITS image into the current frame or query the currently loaded image.
+Syntax: +fits[new|mask|slice] [<filename>] +    [width|height|depth|bitpix] +    [size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]] +    [header [<ext>] [keyword <string>]] +    [image|table|slice] + +Example: +$xpaget ds9 fits > foo.fits +$xpaget ds9 fits width +$xpaget ds9 fits height +$xpaget ds9 fits depth +$xpaget ds9 fits bitpix +$xpaget ds9 fits size +$xpaget ds9 fits size wcs fk5 arcmin +$xpaget ds9 fits header # primary +$xpaget ds9 fits header 2 # hdu 2 +$xpaget ds9 fits header -2 # hdu 2 with inherit +$xpaget ds9 fits header keyword BITPIX +$xpaget ds9 fits header 1 keyword BITPIX +$xpaget ds9 fits image > foo.fits +$xpaget ds9 fits table > bar.fits +$xpaget ds9 fits slice > foo.fits + +$xpaset -p ds9 fits foo.fits +$xpaset -p ds9 fits new foo.fits +$xpaset -p ds9 fits bar.fits[bin=detx,dety] +$xpaset -p ds9 fits slice foo.fits +$xpaset -p ds9 fits mask foo.fits + +$cat foo.fits | xpaset ds9 fits +$cat foo.fits | xpaset ds9 fits new +$cat bar.fits | xpaset ds9 fits -[bin=detx,dety] +$cat foo.fits | xpaset ds9 fits slice +$cat foo.fits | xpaset ds9 fits mask +
frame
+
Controls frame functions. Frames may be created, deleted, reset, and centered. While return the current frame number. If you goto a frame that does not exists, it will be created. If the frame is hidden, it will be shown. The 'frameno' option is available for backward compatibility.
+Syntax: +frame [center [#|all]] +    [clear [#|all]] +    [new [rgb|3d]] +    [delete [#|all]] +    [reset [#|all]] +    [refresh [#|all]] +    [hide [#|all]] +    [show [#|all]] +    [move first] +    [move back] +    [move forward] +    [move last] +    [first] +    [prev] +    [next] +    [last] +    [frameno #] +    [#] +    [match <coordsys>] +    [lock <coordsys>|none] +    [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]] +    [has contour [aux]]] +    [has fits [bin|cube|mosaic]] +    [has marker [highlite|paste|select|undo]] +    [has system <coordsys>] +    [has wcs [<wcssys>]] +    [has wcs celestial [<wcssys>]] +    [has wcs linear [<wcssys>]] + +Example: +$xpaget ds9 frame # returns the id of the current frame +$xpaget ds9 frame frameno # returns the id of the current frame +$xpaget ds9 frame all # returns the id of all frames +$xpaget ds9 frame active # returns the id of all active frames +$xpaget ds9 frame lock +$xpaget ds9 frame has amplifier +$xpaget ds9 frame has datamin +$xpaget ds9 frame has datasec +$xpaget ds9 frame has detector +$xpaget ds9 frame has grid +$xpaget ds9 frame has iis +$xpaget ds9 frame has irafmin +$xpaget ds9 frame has physical +$xpaget ds9 frame has smooth +$xpaget ds9 frame has contour +$xpaget ds9 frame has contour aux +$xpaget ds9 frame has fits +$xpaget ds9 frame has fits bin +$xpaget ds9 frame has fits cube +$xpaget ds9 frame has fits mosaic +$xpaget ds9 frame has marker highlite +$xpaget ds9 frame has marker paste +$xpaget ds9 frame has marker select +$xpaget ds9 frame has marker undo +$xpaget ds9 frame has system physical +$xpaget ds9 frame has wcs wcsa +$xpaget ds9 frame has wcs celestial wcsa +$xpaget ds9 frame has wcs linear wcsa + +$xpaset -p ds9 frame center # center current frame +$xpaset -p ds9 frame center 1 # center 'Frame1' +$xpaset -p ds9 frame center all # center all frames +$xpaset -p ds9 frame clear # clear current frame +$xpaset -p ds9 frame new # create new frame +$xpaset -p ds9 frame new rgb # create new rgb frame +$xpaset -p ds9 frame delete # delete current frame +$xpaset -p ds9 frame reset # reset current frame +$xpaset -p ds9 frame refresh # refresh current frame +$xpaset -p ds9 frame hide # hide current frame +$xpaset -p ds9 frame show 1 # show frame 'Frame1' +$xpaset -p ds9 frame move first # move frame to first in order +$xpaset -p ds9 frame move back # move frame back in order +$xpaset -p ds9 frame move forward # move frame forward in order +$xpaset -p ds9 frame move last # move frame to last in order +$xpaset -p ds9 frame first # goto first frame +$xpaset -p ds9 frame prev # goto prev frame +$xpaset -p ds9 frame next # goto next frame +$xpaset -p ds9 frame last # goto last frame +$xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if needed +$xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed +$xpaset -p ds9 frame match wcs +$xpaset -p ds9 frame lock wcs +
gif
+
Load GIF image into current frame.
+Syntax: +gif [new|slice] [<filename>] + +Example: +$xpaget ds9 gif > foo.gif + +$xpaset -p ds9 gif foo.gif +$xpaset -p ds9 gif new foo.gif +$xpaset -p ds9 gif slice foo.gif + +$cat foo.gif | xpaset ds9 gif # not available windows +$cat foo.gif | xpaset ds9 gifnew # not available windows +$cat foo.gif | xpaset ds9 gifslice# not available windows +
grid
+
Controls coordinate grid. For grid numeric format syntax, click here.
+Syntax: +grid [] +    [yes|no] +    [type analysis|publication] +    [system <coordsys>] +    [sky <skyframe>] +    [skyformat <skyformat>] +    [grid yes|no] +    [grid color <color>] +    [grid width <value>] +    [grid dash yes|no] +    [grid gap1 <value>] +    [grid gap2 <value>] +    [grid gap3 <value>] +    [axes yes|no] +    [axes color <color>] +    [axes width <value>] +    [axes dash yes|no] +    [axes type interior|exterior] +    [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu] +    [format1 <format>] +    [format2 <format>] +    [tickmarks yes|no] +    [tickmarks color <color>] +    [tickmarks width <value>] +    [tickmarks dash yes|no] +    [border yes|no] +    [border color <color>] +    [border width <value>] +    [border dash yes|no] +    [numerics yes|no] +    [numerics font times|helvetica|courier] +    [numerics fontsize <value>] +    [numerics fontweight normal|bold] +    [numerics fontslant roman|italic] +    [numerics color <color>] +    [numerics gap1 <value>] +    [numerics gap2 <value>] +    [numerics gap3 <value>] +    [numerics type interior|exterior] +    [numerics vertical yes|no] +    [title yes|no] +    [title text <text>] +    [title def yes|no] +    [title gap <value>] +    [title font times|helvetica|courier] +    [title fontsize <value>] +    [title fontweight normal|bold] +    [title fontslant roman|italic] +    [title color <color>] +    [labels yes|no] +    [labels def1 yes|no] +    [labels def2 yes|no] +    [labels text1 <text>] +    [labels text2 <text>] +    [labels gap1 <value>] +    [labels gap2 <value>] +    [labels font times|helvetica|courier] +    [labels fontsize <value>] +    [labels fontweight normal|bold] +    [labels fontslant roman|italic] +    [labels color <color>] +    [reset] +    [load <filename>] +    [save <filename>] +    [open|close] + +Example: +$xpaget ds9 grid +$xpaget ds9 grid type +$xpaget ds9 grid system +$xpaget ds9 grid sky +$xpaget ds9 grid skyformat +$xpaget ds9 grid grid +$xpaget ds9 grid grid color +$xpaget ds9 grid grid width +$xpaget ds9 grid grid dash +$xpaget ds9 grid grid gap1 +$xpaget ds9 grid grid gap2 +$xpaget ds9 grid grid gap3 +$xpaget ds9 grid axes +$xpaget ds9 grid axes color +$xpaget ds9 grid axes width +$xpaget ds9 grid axes dash +$xpaget ds9 grid axes type +$xpaget ds9 grid axes origin +$xpaget ds9 grid format1 +$xpaget ds9 grid format2 +$xpaget ds9 grid tickmarks +$xpaget ds9 grid tickmarks color +$xpaget ds9 grid tickmarks width +$xpaget ds9 grid tickmarks dash +$xpaget ds9 grid border +$xpaget ds9 grid border color +$xpaget ds9 grid border width +$xpaget ds9 grid border dash +$xpaget ds9 grid numerics +$xpaget ds9 grid numerics font +$xpaget ds9 grid numerics fontsize +$xpaget ds9 grid numerics fontweight +$xpaget ds9 grid numerics fontslant +$xpaget ds9 grid numerics color +$xpaget ds9 grid numerics gap1 +$xpaget ds9 grid numerics gap2 +$xpaget ds9 grid numerics gap3 +$xpaget ds9 grid numerics type +$xpaget ds9 grid numerics vertical +$xpaget ds9 grid title +$xpaget ds9 grid title text +$xpaget ds9 grid title def +$xpaget ds9 grid title gap +$xpaget ds9 grid title font +$xpaget ds9 grid title fontsize +$xpaget ds9 grid title fontweight +$xpaget ds9 grid title fontslant +$xpaget ds9 grid title color +$xpaget ds9 grid labels +$xpaget ds9 grid labels text1 +$xpaget ds9 grid labels def1 +$xpaget ds9 grid labels gap1 +$xpaget ds9 grid labels text2 +$xpaget ds9 grid labels def2 +$xpaget ds9 grid labels gap2 +$xpaget ds9 grid labels font +$xpaget ds9 grid labels fontsize +$xpaget ds9 grid labels fontweight +$xpaget ds9 grid labels fontslant +$xpaget ds9 grid labels color + +$xpaset -p ds9 grid +$xpaset -p ds9 grid yes +$xpaset -p ds9 grid type analysis +$xpaset -p ds9 grid system wcs +$xpaset -p ds9 grid sky fk5 +$xpaset -p ds9 grid skyformat degrees +$xpaset -p ds9 grid grid yes +$xpaset -p ds9 grid grid color red +$xpaset -p ds9 grid grid width 2 +$xpaset -p ds9 grid grid dash yes +$xpaset -p ds9 grid grid gap1 10 +$xpaset -p ds9 grid grid gap2 10 +$xpaset -p ds9 grid grid gap3 10 +$xpaset -p ds9 grid axes yes +$xpaset -p ds9 grid axes color red +$xpaset -p ds9 grid axes width 2 +$xpaset -p ds9 grid axes dash yes +$xpaset -p ds9 grid axes type exterior +$xpaset -p ds9 grid axes origin lll +$xpaset -p ds9 grid format1 d.2 +$xpaset -p ds9 grid format2 d.2 +$xpaset -p ds9 grid tickmarks yes +$xpaset -p ds9 grid tickmarks color red +$xpaset -p ds9 grid tickmarks width 2 +$xpaset -p ds9 grid tickmarks dash yes +$xpaset -p ds9 grid border yes +$xpaset -p ds9 grid border color red +$xpaset -p ds9 grid border width 2 +$xpaset -p ds9 grid border dash yes +$xpaset -p ds9 grid numerics yes +$xpaset -p ds9 grid numerics font courier +$xpaset -p ds9 grid numerics fontsize 12 +$xpaset -p ds9 grid numerics fontweight bold +$xpaset -p ds9 grid numerics fontslant italic +$xpaset -p ds9 grid numerics color red +$xpaset -p ds9 grid numerics gap1 10 +$xpaset -p ds9 grid numerics gap2 10 +$xpaset -p ds9 grid numerics gap3 10 +$xpaset -p ds9 grid numerics type exterior +$xpaset -p ds9 grid numerics vertical yes +$xpaset -p ds9 grid title yes +$xpaset -p ds9 grid title text {Hello World} +$xpaset -p ds9 grid title def yes +$xpaset -p ds9 grid title gap 10 +$xpaset -p ds9 grid title font courier +$xpaset -p ds9 grid title fontsize 12 +$xpaset -p ds9 grid title fontweight bold +$xpaset -p ds9 grid title fontslant italic +$xpaset -p ds9 grid title color red +$xpaset -p ds9 grid labels yes +$xpaset -p ds9 grid labels text1 {Hello World} +$xpaset -p ds9 grid labels def1 yes +$xpaset -p ds9 grid labels gap1 10 +$xpaset -p ds9 grid labels text2 {Hello World} +$xpaset -p ds9 grid labels def2 yes +$xpaset -p ds9 grid labels gap2 10 +$xpaset -p ds9 grid labels font courier +$xpaset -p ds9 grid labels fontsize 12 +$xpaset -p ds9 grid labels fontweight boldj +$xpaset -p ds9 grid labels fontslant italic +$xpaset -p ds9 grid labels color red +$xpaset -p ds9 grid reset +$xpaset -p ds9 grid load foo.grd +$xpaset -p ds9 grid save foo.grd +$xpaset -p ds9 grid open +$xpaset -p ds9 grid close
+
header
+
Display current fits header dialog. Optional extension number maybe specified. Please note, this differs from xpa fits header.
+Syntax: +header [<ext>] +    [close [<ext>]] +    [save [<ext>] <filename>] + +Example: +$xpaset -p ds9 header +$xpaset -p ds9 header 2 +$xpaset -p ds9 header close +$xpaset -p ds9 header save 1 foo.txt +
height
+
Set the height of the image display window.
+Syntax: +height [<value>] + +Example: +$xpaget ds9 height + +$xpaset -p ds9 height 512 +
iconify
+
Toggles iconification.
+Syntax: +iconify [] +    [yes|no] + +Example: +$xpaget ds9 iconify + +$xpaset -p ds9 iconify +$xpaset -p ds9 iconify yes +
iexam
+
Interactive examine function. A blinking cursor will indicate to the user to click on a point on an image. The specified information will be returned at that time. The default event is button. In the last form, the following macros will be expanded if present: $width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, $x, $y, $z. See Analysis Macros for more information.
+Syntax: +iexam [] +    [[]|button|key|any] coordinate <coordsys> [<skyframe>] [<skyformat>] +    [[]|button|key|any] data [width][height] +    [[]|button|key|any] <macro string>] + +Example: +$xpaget ds9 iexam # image coordinates +$xpaget ds9 iexam coordinate image +$xpaget ds9 iexam key coordinate image # return coordinate and key event +$xpaget ds9 iexam coordinate wcs fk5 degrees +$xpaget ds9 iexam coordinate wcs galactic sexagesimal +$xpaget ds9 iexam coordinate fk5 +$xpaget ds9 iexam data # return data value +$xpaget ds9 iexam key data # return data value and key event +$xpaget ds9 iexam data 3 3 # return all data in 3x3 box about selected point +$xpaget ds9 iexam {'Click at $x,$y in file $filename'}
+
iis
+
Set/Get IIS Filename. Optional mosaic number maybe supplied.
+Syntax: +iis [filename <filename> [#]] + +Example: +$xpaget ds9 iis filename +$xpaget ds9 iis filename 4 + +$xpaset -p ds9 iis filename foo.fits +$xpaset -p ds9 iis filename bar.fits 4
+
jpeg
+
Load JPEG image into current frame. Optional parameters: jpeg quality (1-100)
+Syntax: +jpeg [new|slice] [<filename>] [1-100] + +Example: +$xpaget ds9 jpeg > foo.jpeg +$xpaget ds9 jpeg 100 > foo.jpeg + +$xpaset -p ds9 jpeg foo.jpeg +$xpaset -p ds9 jpeg new foo.jpeg +$xpaset -p ds9 jpeg slice foo.jpeg + +$cat foo.jpeg | xpaset ds9 jpeg# not available windows +$cat foo.jpeg | xpaset ds9 jpegnew# not available windows +$cat foo.jpeg | xpaset ds9 jpegslice# not available windows +
lock
+
Lock all other frames to the current frame.
+Syntax: +lock[frame <coordsys>|none] +    [crosshair <coordsys>|none] +    [crop <coordsys>|none] +    [slice <coordsys>|none]] +    [bin [yes|no]] +    [axes [yes|no]] +    [scale [yes|no]] +    [scalelimites [yes|no]] +    [colorbar [yes|no]] +    [block [yes|no]] +    [smooth [yes|no]] +    [3d [yes|no]] + +Example: +$xpaget -p ds9 lock frame +$xpaget -p ds9 lock crosshair +$xpaget -p ds9 lock crop +$xpaget -p ds9 lock slice +$xpaget -p ds9 lock bin +$xpaget -p ds9 lock axes +$xpaget -p ds9 lock scale +$xpaget -p ds9 lock scalelimits +$xpaget -p ds9 lock colorbar +$xpaget -p ds9 lock block +$xpaget -p ds9 lock smooth +$xpaget -p ds9 lock 3d + +$xpaset -p ds9 lock frame wcs +$xpaset -p ds9 lock crosshair wcs +$xpaset -p ds9 lock crop wcs +$xpaset -p ds9 lock slice wcs +$xpaset -p ds9 lock bin yes +$xpaset -p ds9 lock axes yes +$xpaset -p ds9 lock scale yes +$xpaset -p ds9 lock scalelimits yes +$xpaset -p ds9 lock colorbar yes +$xpaset -p ds9 lock block yes +$xpaset -p ds9 lock smooth yes +$xpaset -p ds9 lock 3d yes + lower +
Lower in the window stacking order.
+Syntax: +lower + +Example: +$xpaset -p ds9 lower +
magnifier
+
Controls the magnifier settings.
+Syntax: +magnifier [color <color>] +    [zoom <value>] +    [cursor yes|no] +    [region yes|no] + +Example: +$xpaget ds9 magnifier color +$xpaget ds9 magnifier zoom +$xpaget ds9 magnifier cursor +$xpaget ds9 magnifier region + +$xpaset -p ds9 magnifier color yellow +$xpaset -p ds9 magnifier zoom 2 +$xpaset -p ds9 magnifier cursor no +$xpaset -p ds9 magnifier region no
+
mask
+
Controls mask parameters.
+Syntax: +mask [color <color>] +    [mark zero|nonzero|nan|nonnan|range] +    [range <low> <high>] +    [transparency <value>] +    [system <coordsys>] +    [clear] +    [open|close] + +Example: +$xpaget ds9 mask color +$xpaget ds9 mask mark +$xpaget ds9 mask range +$xpaget ds9 mask system +$xpaget ds9 mask transparency + +$xpaset -p ds9 mask color red +$xpaset -p ds9 mask mark zero +$xpaset -p ds9 mask range 10 100 +$xpaset -p ds9 mask transparency 50 +$xpaset -p ds9 mask system wcs +$xpaset -p ds9 mask clear +$xpaset -p ds9 mask open +$xpaset -p ds9 mask close
+
match
+
Match all other frames to the current frame.
+Syntax: +match[frame <coordsys>] +    [crosshair <coordsys>] +    [crop <coordsys>] +    [slice <coordsys>] +    [bin] +    [axes] +    [scale] +    [scalelimits] +    [colorbar] +    [block] +    [smooth] +    [3d] + +Example: +$xpaset -p ds9 match frame wcs +$xpaset -p ds9 match crosshair wcs +$xpaset -p ds9 match crop wcs +$xpaset -p ds9 match slicewcs +$xpaset -p ds9 match bin +$xpaset -p ds9 match axes +$xpaset -p ds9 match scale +$xpaset -p ds9 match scalelimits +$xpaset -p ds9 match colorbar +$xpaset -p ds9 match block +$xpaset -p ds9 match smooth +$xpaset -p ds9 match 3d + mecube +
Load FITS multiple extension file as data cube.
+Syntax: +mecube [new] [<filename>] + +Example: +$xpaget ds9 mecube > foo.fits + +$xpaset -p ds9 mecube foo.fits +$xpaset -p ds9 mecube new foo.fits + +$cat foo.fits | xpaset ds9 mecube +$cat foo.fits | xpaset ds9 mecube new +
minmax
+
This is how DS9 determines the min and max data values from the data. SCAN will scan all data. DATAMIN and IRAFMIN will use the values of the keywords if present.
+Syntax: +minmax [scan|sample|datamin|irafmin] +    [mode scan|sample|datamin|irafmin] +    [interval #] + +Example: +$xpaget ds9 minmax mode +$xpaget ds9 minmax interval + +$xpaset -p ds9 minmax scan +$xpaset -p ds9 minmax mode scan +$xpaset -p ds9 minmax interval 100 +
mode
+
Controls the first mouse button mode.
+Syntax: +mode [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d] + +Example: +$xpaget ds9 mode +$xpaset -p ds9 mode crosshair
+
mosaic
+
Load FITS mosaic segment into current frame.
+Syntax: +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>] + +Example: +$xpaget ds9 mosaic > foo.fits + +$xpaset -p ds9 mosaic foo.fits +$xpaset -p ds9 mosaic wcs foo.fits +$xpaset -p ds9 mosaic wcs new foo.fits +$xpaset -p ds9 mosaic wcs mask foo.fits + +$cat foo.fits | xpaset ds9 mosaic +$cat foo.fits | xpaset ds9 mosaic wcs +$cat foo.fits | xpaset ds9 mosaic wcs new +$cat foo.fits | xpaset ds9 mosaic wcs mask +
mosaicimage
+
Load FITS mosaic image into current frame.
+Syntax: +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] [<filename>] + +Example: +$xpaget ds9 mosaicimage > foo.fits + +$xpaset -p ds9 mosaicimage foo.fits +$xpaset -p ds9 mosaicimage wcs foo.fits +$xpaset -p ds9 mosaicimage wcs new foo.fits +$xpaset -p ds9 mosaicimage wcs mask foo.fits + +$cat foo.fits | xpaset ds9 mosaicimage +$cat foo.fits | xpaset ds9 mosaicimage wcs +$cat foo.fits | xpaset ds9 mosaicimage wcs new +$cat foo.fits | xpaset ds9 mosaicimage wcs mask +
movie
+
Create a movie from snap shots of the DS9 window. A slice movie cycles though all slices of a cube. A frame movie cycles through all active frames. A 3d movie cycles through specified viewing angles. The default action is slice. Movie types are either MPEG or Animated GIF, with default MPEG. Optional parameters for 3d: number of frames, azimuth from/to, elevation from/to, slice from/to, oscillate/repeat times.
+Syntax: +movie [slice|frame|3d][mpeg|gif] <filename> +movie 3d [mpeg|gif] <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>] + +Example: +$xpaset -p ds9 movie slice mpeg ds9.mpg +$xpaset -p ds9 movie frame gif ds9.gif +$xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 oscillate 1 +
multiframe
+
Load FITS multiple extension file as multiple images.
+Syntax: +multiframe [<filename>] + +Example: +$xpaset -p ds9 multiframe foo.fits + +$cat foo.fits | xpaset ds9 multiframe# not available windows
+
nameserver
+
Support Name Server functions. Coordinates are in fk5.
+Syntax: +nameserver [<object>] +    [name <object>] +    [serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds] +    [skyformat degrees|sexagesimal] +    [pan] +    [crosshair] +    [open|close] + +Example: +$xpaget ds9 nameserver +$xpaget ds9 nameserver server +$xpaget ds9 nameserver skyformat +$xpaget ds9 nameserver m31 + +$xpaset -p ds9 nameserver m31 +$xpaset -p ds9 nameserver name m31 +$xpaset -p ds9 nameserver server ned-sao +$xpaset -p ds9 nameserver skyformat sexagesimal +$xpaset -p ds9 nameserver pan +$xpaset -p ds9 nameserver crosshair +$xpaset -p ds9 nameserver open +$xpaset -p ds9 nameserver close
+
nan
+
Set image not-a-number color.
+Syntax: +nan <color> + +Example: +$xpaget ds9 nan + +$xpaset -p ds9 nan red +
nrrd
+
Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: array endian.
+Syntax: +nrrd [native|little|big] +nrrd [new|mask] [<filename>] + +Example: +$xpaget ds9 nrrd +$xpaget ds9 nrrd big + +$xpaset -p ds9 nrrd foo.nrrd +$xpaset -p ds9 nrrd new foo.nrrd +$xpaset -p ds9 nrrd mask foo.nrrd + +$cat foo.nrrd | xpaset ds9 nrrd +$cat foo.nrrd | xpaset ds9 nrrdnew +$cat foo.nrrd | xpaset ds9 nrrd mask +
nvss
+
Support for NRAO VLA Sky Survey.
+Syntax: +nvss [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 nvss name +$xpaget ds9 nvss coord +$xpaget ds9 nvss size +$xpaget ds9 nvss save +$xpaget ds9 nvss frame + +$xpaset -p ds9 nvss +$xpaset -p ds9 nvss m31 +$xpaset -p ds9 nvss name m31 +$xpaset -p ds9 nvss name clear +$xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 nvss size 60 60 arcmin +$xpaset -p ds9 nvss save yes +$xpaset -p ds9 nvss frame current +$xpaset -p ds9 nvss update frame +$xpaset -p ds9 nvss open +$xpaset -p ds9 nvss close
+
orient
+
Controls the orientation of the current frame.
+Syntax: +orient [none|x|y|xy] +    [open|close] + +Example: +$xpaget ds9 orient + +$xpaset -p ds9 orient xy +$xpaset -p ds9 orient open +$xpaset -p ds9 orient close +
pagesetup
+
Controls Page Setup options.
+Syntax: +pagesetup [orient portrait|landscape] +    [scale <numberic>] +    [size letter|legal|tabloid|poster|a4] + +Example: +$xpaget ds9 pagesetup orient +$xpaget ds9 pagesetup scale +$xpaget ds9 pagesetup size + +$xpaset -p ds9 pagesetup orient portrait +$xpaset -p ds9 pagesetup scale 50 +$xpaset -p ds9 pagesetup size poster +
pan
+
Controls the current image cursor location for the current frame.
+Syntax: +pan [<coordsys> [<skyframe>] [<skyformat>]] # get current coords + +pan [<x> <y> <coordsys> [<skyframe>]] # relative +    [to <x> <y> <coordsys> [<skyframe>]] # absolute +    [open|close] + +Example: +$xpaget ds9 pan # get current image coords +$xpaget ds9 pan wcs fk4 sexagesimal # get current coords + +$xpaset -p ds9 pan 200 200 image # pan relative +$xpaset -p ds9 pan to 400 400 physical # pan to physical coords +$xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords +$xpaset -p ds9 pan open +$xpaset -p ds9 pan close +
pixeltable
+
Display/Hide the pixel table.
+Syntax: +pixeltable [] +    [yes|open] +    [no|close] + +Example: +$xpaget ds9 pixeltable + +$xpaset -p ds9 pixeltable +$xpaset -p ds9 pixeltable yes +$xpaset -p ds9 pixeltable open +$xpaset -p ds9 pixeltable close
+
plot
+
Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is assumed to be a pair of coordinates, with optional error values. The follow are valid data descriptions:
+
xy     x and y coordinates +xyex    x,y coordinates with x errors +xyey    x,y coordinates with y errors +xyexey    x,y coordinates with x and y errors
+
To create a new plot, use the plot new command.
+Syntax: +# create new empty plot window +plot [] +    [line|bar|scatter] +    [new] +    [new line|bar|scatter] +    [new name <plotname>] +    [new name <plotname> line|bar|scatter] + +# create new plot with data from stdin +plot[new <title> <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] +    [new [line|bar|scatter] <title> <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] +    [newname <plotname><title> <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] +    [newname <plotname>line|bar|scatter <title> <xaxis label> <yaxis label>xy|xyex|xyey|xyexey] + +# create new plot with data from stdin which includes title/dim headers +plot [new stdin] +    [new[line|bar|scatter]stdin] +    [new name <plotname> stdin] +    [new name <plotname>line|bar|scatterstdin] + +#load data into existing plot from stdin +plot [[<plotname>] data xy|xyex|xyey|xyexey] + +# existing plot +plot[[<plotname>] load <filename> xy|xyex|xyey|xyexey] +    [[<plotname>] save <filename>] +    [[<plotname>] clear] +    [[<plotname>] duplicate [#]] +    [[<plotname>] stats yes|no] +    [[<plotname>] list yes|no] +    [[<plotname>] loadconfig <filename>] +    [[<plotname>] saveconfig <filename>] +    [[<plotname>] pagesetup orient portrait|landscape] +    [[<plotname>] pagesetup size letter|legal|tabloid|poster|a4] +    [[<plotname>] print] +    [[<plotname>] print destination printer|file] +    [[<plotname>] print command <command>] +    [[<plotname>] print filename <filename>] +    [[<plotname>] print color rgb|gray] +    [[<plotname>] close] +    [[<plotname>] mode pointer|zoom] + +# export image +plot[[<plotname>] export[gif|tiff|jpeg|png]<filename> +    [[<plotname>] export jpeg <filename>[1-100] +    [[<plotname>]export tiff <filename>[none|jpeg|packbits|deflate] + +# configure graph +plot [[<plotname>] axis x|y grid yes|no] +    [[<plotname>] axis x|y log yes|no] +    [[<plotname>] axis x|y flip yes|no] +    [[<plotname>] axis x|y auto yes|no] +    [[<plotname>] axis x|y min <value>] +    [[<plotname>] axis x|y max <value>] +    [[<plotname>] axis x|y format <string>] +    [[<plotname>] background <value>] +    [[<plotname>] legend yes|no] +    [[<plotname>] legend position right|left|top|bottom] +    [[<plotname>] font title|labels|numbers font times|helvetica|courier] +    [[<plotname>] fonttitle|labels|numberssize <value>] +    [[<plotname>] fonttitle|labels|numbersweight normal|bold] +    [[<plotname>] fonttitle|labels|numbersslant roman|italic] +    [[<plotname>] title <string>] +    [[<plotname>] title x|y <string>] +    [[<plotname>] barmode normal|stacked|aligned|overlap] + +# configure current dataset +plot [[<plotname>] show yes|no] +    [[<plotname>] shape none|circle|square|diamond|plus|splus|scross|triangle|arrow] +    [[<plotname>] shape fill yes|no] +    [[<plotname>] shape color <value>] +    [[<plotname>] smooth step|linear|cubic|quadratic|catrom] +    [[<plotname>] color <value>] +    [[<plotname>] width <value>] +    [[<plotname>] dash yes|no] +    [[<plotname>] error yes|no] +    [[<plotname>] error color <value>] +    [[<plotname>] error cap yes|no] +    [[<plotname>] error width <value>] +    [[<plotname>] name <string>] + +# select current dataset +plot [[<plotname>] select <value>] + +Example: +# return all plotnames +$xpaget ds9 plot + +# create new empty plot window +$xpaset -p ds9 plot +$xpaset -p ds9 plot bar +$xpaset -p ds9 plot new +$xpaset -p ds9 plot new bar +$xpaset -p ds9 plot new name foo +$xpaset -p ds9 plot new name foo bar + +# create new plot with data from stdin +$cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} xy +$cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} xy +$cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} {Y Axis} xy +$cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X Axis} {Y Axis} xy + +# create new plot with data from stdin which includes title/dim headers +$cat stdin.2.dat | xpaset ds9 plot new stdin +$cat stdin.2.dat | xpaset ds9 plot new line stdin +$cat stdin.2.dat | xpaset ds9 plot new name foo stdin +$cat stdin.2.dat | xpaset ds9 plot new name foo line stdin + +#load data into existing plot from stdin +$cat xy.dat | xpaset ds9 plot data xy +$cat xy.dat | xpaset ds9 plot foo data xy + +# existing plot +$xpaget ds9 plot stats +$xpaget ds9 plot list + +$xpaset -p ds9 plot load xy.dat xy +$xpaset -p ds9 plot save foo.dat +$xpaset -p ds9 plot clear +$xpaset -p ds9 plot duplicate 1 +$xpaset -p ds9 plot stats yes +$xpaset -p ds9 plot list yes +$xpaset -p ds9 plot loadconfig foo.plt +$xpaset -p ds9 plot saveconfig foo.plt +$xpaset -p ds9 plot pagesetup orient portrait +$xpaset -p ds9 plot pagesetup size letter +$xpaset -p ds9 plot print +$xpaset -p ds9 plot print destination file +$xpaset -p ds9 plot print command lp +$xpaset -p ds9 plot print filename foo.ps +$xpaset -p ds9 plot print color rgb +$xpaset -p ds9 plot close + +# plot mode +$xpaget ds9 plot mode + +$xpaset -p ds9 plot mode pointer + +# export plot +$xpaset -p ds9 plot export tiff foo.tiff jpeg +$xpaset -p ds9 plot export jpeg foo.jpeg 75 +$xpaset -p ds9 plot export png foo.png + +# configure plot +$xpaget ds9 plot axis x grid +$xpaget ds9 plot axis x log +$xpaget ds9 plot axis x flip +$xpaget ds9 plot axis x auto +$xpaget ds9 plot axis x min +$xpaget ds9 plot axis x max +$xpaget ds9 plot axis x format +$xpaget ds9 plot background +$xpaget ds9 plot legend +$xpaget ds9 plot legend position +$xpaget ds9 plot font numbers font +$xpaget ds9 plot font numbers size +$xpaget ds9 plot font numbers weight +$xpaget ds9 plot font numbers slant +$xpaget ds9 plot title +$xpaget ds9 plot title xaxis +$xpaget ds9 plot title yaxis +$xpaset -p ds9 plot axis x grid yes +$xpaset -p ds9 plot axis x log yes +$xpaset -p ds9 plot axis x flip yes +$xpaset -p ds9 plot axis x auto no +$xpaset -p ds9 plot axis x min 1 +$xpaset -p ds9 plot axis x max 100 +$xpaset -p ds9 plot axis x format {%f} +$xpaset -p ds9 plot background white +$xpaset -p ds9 plot legend yes +$xpaset -p ds9 plot legend position left +$xpaset -p ds9 plot font numbers font times +$xpaset -p ds9 plot font numbers size 12 +$xpaset -p ds9 plot font numbers weight bold +$xpaset -p ds9 plot font numbers slant italic +$xpaset -p ds9 plot title {This is a Title} +$xpaset -p ds9 plot title x {X Axis} +$xpaset -p ds9 plot title y {Y Axis} +$xpaset -p ds9 plot title legend {This is the Legend} + +# bar plot +$xpaget ds9 plot barmode + +$xpaset -p ds9 plot barmode aligned + +# configure current dataset +$xpaget ds9 plot show +$xpaget ds9 plot shape +$xpaget ds9 plot shape fill +$xpaget ds9 plot shape color +$xpaget ds9 plot smooth +$xpaget ds9 plot color +$xpaget ds9 plot width +$xpaget ds9 plot dash +$xpaget ds9 plot error +$xpaget ds9 plot error color +$xpaget ds9 plot error cap +$xpaget ds9 plot error width +$xpaget ds9 plot name + +$xpaset -p ds9 plot show yes +$xpaset -p ds9 plot shape circle +$xpaset -p ds9 plot shape fill no +$xpaset -p ds9 plot shape color cyan +$xpaset -p ds9 plot smooth step +$xpaset -p ds9 plot color red +$xpaset -p ds9 plot width 2 +$xpaset -p ds9 plot dash yes +$xpaset -p ds9 plot error yes +$xpaset -p ds9 plot error color red +$xpaset -p ds9 plot error cap yes +$xpaset -p ds9 plot error width 2 +$xpaset -p ds9 plot name {My Data} + +# select current dataset +$xpaget ds9 plot select + +$xpaset -p ds9 plot select 2
+
png
+
Load PNG image into current frame.
+Syntax: +png [new|slice] [<filename>] + +Example: +$xpaget ds9 png > foo.png + +$xpaset -p ds9 png foo.png +$xpaset -p ds9 png new foo.png +$xpaset -p ds9 png slice foo.png + +$cat foo.png | xpaset ds9 png +$cat foo.png | xpaset ds9 png new +$cat foo.png | xpaset ds9 png slice
+
precision
+
Set region and coordinate output format precision.
+Syntax: +precision <linear><degree><hms><dms><arcmin><arcsec> + +Example: +$xpaget ds9 precision + +$xpaset -p ds9 precision 8 10 4 3 5 3
+
prefs
+
Controls various preference settings.
+Syntax: +prefs [clear] +    [irafalign yes|no] + +Example: +$xpaget ds9 prefs irafalign + +$xpaset -p ds9 prefs clear +$xpaset -p ds9 prefs iraf yes +
preserve
+
Preserve the follow attributes while loading a new image.
+Syntax: +preserve [pan yes|no] +      [regions yes|no] + +Example: +$xpaget ds9 preserve pan +$xpaget ds9 preserve regions + +$xpaset -p ds9 preserve pan yes +$xpaset -p ds9 preserve regions yes +
psprint
+
Invokes postscript printing. Please see print for further details.
+
print
+
Controls printing. Use print option to set printing options. Only available for XPA_METHOD local.
+Syntax: +print [destination printer|file] +    [command <command>] +    [filename <filename>] +    [color rgb|cmyk|gray] +    [level 1|2|3] +    [resolution 72|screen|96|144|150|225|300|600|1200] + +Example: +$xpaget ds9 print destination +$xpaget ds9 print command +$xpaget ds9 print filename +$xpaget ds9 print color +$xpaget ds9 print level +$xpaget ds9 print resolution + +$xpaset -p ds9 print +$xpaset -p ds9 print destination file +$xpaset -p ds9 print command lp +$xpaset -p ds9 print filename foo.ps +$xpaset -p ds9 print color cmyk +$xpaset -p ds9 print level 2 +$xpaset -p ds9 print resolution 96 +
raise
+
Raise in the window stacking order.
+Syntax: +raise + +Example: +$xpaset -p ds9 raise +
regions
+
Controls regions in the current frame.
+Syntax: +regions [<filename>] +    [load [all] <filename>] +    [save <filename>] +    [list [close]] +    [epsilon <integer>] +    [show yes|no] +    [showtext yes|no] +    [centroid] +    [centroid auto yes|no] +    [centroid radius <value>|iteration <value>] +    [getinfo] +    [move front] +    [move back] +    [select all] +    [select none] +    [select invert] +    [delete all] +    [delete select] +    [format ds9|xml|ciao|saotng|saoimage|pros|xy] +    [system image|physical|wcs|wcsa...wcsz] +    [sky fk4|fk5|icrs|galactic|ecliptic] +    [skyformat degrees|sexagesimal] +    [strip yes|no] +    [shape <shape>] +    [color &ltcolor>] +    [width <width>] +    [fixed|edit|rotate|delete yes|no] +    [include|exclude|source|background] +    [command <marker command>] +    [composite] +    [dissolve] +    [template <filename>] +    [template <filename> at <ra> <dec> <coordsys> <skyframe>] +    [savetemplate <filename>] +    [groups] +    [group new] +    [group <tag> new] +    [group <tag> update] +    [group <tag> select] +    [group <tag> color &ltcolor>] +    [group <tag> copy] +    [group <tag> delete] +    [group <tag> cut] +    [group <tag> font <font>] +    [group <tag> move <int> <int>] +    [group <tag> movefront] +    [group <tag> moveback] +    [group <tag> property <property> yes|no] +    [copy] +    [cut] +    [paste image|physical|wcs|wcsa...wcsz] +    [undo] +    [-format ds9|ciao|saotng|saoimage|pros|xy] +    [-system image|physical|wcs|wcsa...wcsz] +    [-sky fk4|fk5|icrs|galactic|ecliptic] +    [-skyformat degrees|sexagesimal] +    [-delim [nl|<char>]] +    [-prop select|edit|move|rotate|delete|fixed|include|source 1|0] +    [-group <tag>] +    [-strip yes|no] +    [-wcs yes|no] + +Example: +$xpaget ds9 regions +$xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal -prop edit 1 -group foo +$xpaget ds9 regions epsilon +$xpaget ds9 regions show +$xpaget ds9 regions showtext +$xpaget ds9 regions centroid auto +$xpaget ds9 regions centroid radius +$xpaget ds9 regions centroid iteration +$xpaget ds9 regions selected +$xpaget ds9 regions format +$xpaget ds9 regions system +$xpaget ds9 regions sky +$xpaget ds9 regions skyformat +$xpaget ds9 regions strip +$xpaget ds9 regions shape +$xpaget ds9 regions color +$xpaget ds9 regions width +$xpaget ds9 regions source +$xpaget ds9 regions background +$xpaget ds9 regions include +$xpaget ds9 regions exclude +$xpaget ds9 regions selected +$xpaget ds9 regions groups + +$cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky fk5 +$cat bar.reg | xpaset ds9 regions -format ds9 +$echo "image; circle 100 100 20" | xpaset ds9 regions +$echo "image; circle 100 100 20" | xpaset ds9 regions +$echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions +$echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions +$echo "box 100 100 20 40 25" | xpaset ds9 regions +$echo "image; line 100 100 200 400" | xpaset ds9 regions +$echo "physical; ruler 200 300 200 400" | xpaset ds9 regions +$echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 regions +$echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 regions + +$xpaset -p ds9 regions foo.reg +$xpaset -p ds9 regions -format ciao bar.reg # load as ciao format +$xpaset -p ds9 regions foo.fits # FITS regions files do not need a format specification +$xpaset -p ds9 regions load foo.reg # load foo.reg into current frame +$xpaset -p ds9 regions load all foo.reg # load foo.reg into all frames +$xpaset -p ds9 regions load '*.reg'# expand *.reg and load into current frame +$xpaset -p ds9 regions load all '*.reg' # expand *.reg and load into all frames +$xpaset -p ds9 regions save foo.reg +$xpaset -p ds9 regions list +$xpaset -p ds9 regions list close +$xpaset -p ds9 regions epsilon 5 +$xpaset -p ds9 regions show yes +$xpaset -p ds9 regions showtext no +$xpaset -p ds9 regions centroid +$xpaset -p ds9 regions centroid auto yes +$xpaset -p ds9 regions centroid radius 10 +$xpaset -p ds9 regions centroid iteration 20 +$xpaset -p ds9 regions getinfo +$xpaset -p ds9 regions move back +$xpaset -p ds9 regions move front +$xpaset -p ds9 regions select all +$xpaset -p ds9 regions select none +$xpaset -p ds9 regions select invert +$xpaset -p ds9 regions delete all +$xpaset -p ds9 regions delete select +$xpaset -p ds9 regions format ds9 +$xpaset -p ds9 regions system wcs +$xpaset -p ds9 regions sky fk5 +$xpaset -p ds9 regions skyformat degrees +$xpaset -p ds9 regions strip yes +$xpaset -p ds9 regions shape ellipse +$xpaset -p ds9 regions color red +$xpaset -p ds9 regions width 3 +$xpaset -p ds9 regions edit yes +$xpaset -p ds9 regions include +$xpaset -p ds9 regions command '{circle 100 100 20 # color=red}' +$xpaset -p ds9 regions composite +$xpaset -p ds9 regions dissolve +$xpaset -p ds9 regions template foo.tpl +$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5 +$xpaset -p ds9 regions savetemplate foo.tpl +$xpaset -p ds9 regions group new +$xpaset -p ds9 regions group foo new +$xpaset -p ds9 regions group foo update +$xpaset -p ds9 regions group foo select +$xpaset -p ds9 regions group foo color red +$xpaset -p ds9 regions group foo copy +$xpaset -p ds9 regions group foo delete +$xpaset -p ds9 regions group foo cut +$xpaset -p ds9 regions group foo font {times 14 bold} +$xpaset -p ds9 regions group foo move 100 100 +$xpaset -p ds9 regions group foo movefront +$xpaset -p ds9 regions group foo moveback +$xpaset -p ds9 regions group foo property delete no +$xpaset -p ds9 regions copy +$xpaset -p ds9 regions cut +$xpaset -p ds9 regions paste wcs +$xpaset -p ds9 regions undo +
restore
+
Restore DS9 to a previous state from a backup save set.
+Syntax: +restore <filename> + +Example: +$xpaset -p ds9 restore ds9.bck
+
rgb
+
Create RGB frame and control RGB frame parameters.
+Syntax: +rgb [] +    [red|green|blue] +    [channel [red|green|blue]] +    [view [red|green|blue] [yes|no]] +    [system <coordsys>] +    [lock wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth [yes|no]] +    [open|close] + +Example: +$xpaget ds9 rgb channel +$xpaget ds9 rgb lock wcs +$xpaget ds9 rgb lock crop +$xpaget ds9 rgb lock slice +$xpaget ds9 rgb lock bin +$xpaget ds9 rgb lock scale +$xpaset ds9 rgb lock scalelimits +$xpaget ds9 rgb lock colorbar +$xpaget ds9 rgb lock block +$xpaget ds9 rgb lock smooth +$xpaget ds9 rgb system +$xpaget ds9 rgb view red +$xpaget ds9 rgb view green +$xpaget ds9 rgb view blue + +$xpaset -p ds9 rgb # create new rgb frame +$xpaset -p ds9 rgb red # set current channel to red +$xpaset -p ds9 rgb channel red # set current channel to red +$xpaset -p ds9 rgb view blue no # turn off blue channel +$xpaset -p ds9 rgb system wcs # set rgb coordinate system +$xpaset -p ds9 rgb lock wcs yes +$xpaset -p ds9 rgb lock crop yes +$xpaset -p ds9 rgb lock slice yes +$xpaset -p ds9 rgb lock bin yes +$xpaset -p ds9 rgb lock scale yes +$xpaset -p ds9 rgb lock scalelimits yes +$xpaset -p ds9 rgb lock colorbar yes +$xpaset -p ds9 rgb lock block yes +$xpaset -p ds9 rgb lock smooth yes +$xpaset -p ds9 rgb open +$xpaset -p ds9 rgb close
+
rgbarray
+
Load raw data array cube into rgb frame.
+Syntax: +rgbarray [native|big|little] +rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]] + +Example: +$xpaget ds9 rgbarray > foo.arr + +$xpaget ds9 rgbarray little > foo.arr +$xpaset -p ds9 rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] +$xpaset -p ds9 rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little] + +$cat foo.arr | xpaset ds9 rgbarray [dim=512,zdim=3,bitpix=-32,endian=little] +$cat foo.arr | xpaset ds9 rgbarray new [dim=512,zdim=3,bitpix=-32,endian=little]
+
rgbcube
+
Load FITS rgbcube into rgb frame.
+Syntax: +rgbcube [new] [<filename>] + +Example: +$xpaget ds9 rgbcube > foo.fits + +$xpaset -p ds9 rgbcube foo.fits +$xpaset -p ds9 rgbcube new foo.fits + +$cat foo.fits | xpaset ds9 rgbcube +$cat foo.fits | xpaset ds9 rgbcubenew
+
rgbimage
+
Load FITS rgbimage into rgb frame.
+Syntax: +rgbimage [new] [<filename>] + +Example: +$xpaget ds9 rgbimage > foo.fits + +$xpaset -p ds9 rgbimage foo.fits +$xpaset -p ds9 rgbimage new foo.fits + +$cat foo.fits | xpaset ds9 rgbimage +$cat foo.fits | xpaset ds9 rgbimage new +
rotate
+
Controls the rotation angle (in degrees) of the current frame.
+Syntax: +rotate [<value>] +    [to <value>] +    [open|close] + +Example: +$xpaget ds9 rotate + +$xpaset -p ds9 rotate 45 +$xpaset -p ds9 rotate to 30 +$xpaset -p ds9 rotate open +$xpaset -p ds9 rotate close +
save
+
Save loaded image data of current frame as FITS.
+Syntax: +save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] <filename> [image|table|slice] + +Example: +$xpaset -p ds9 save foo.fits +$xpaset -p ds9 save fits foo.fits image +$xpaset -p ds9 save fits foo.fits table +$xpaset -p ds9 save fits foo.fits slice +$xpaset -p ds9 save rgbimage foo.fits +$xpaset -p ds9 save rgbcube foo.fits +$xpaset -p ds9 save mecube foo.fits +$xpaset -p ds9 save mosaic foo.fits +$xpaset -p ds9 save mosaicimage foo.fits
+
saveimage
+
Create a snap shot of the current DS9 window and save in specified image format. If no format specified, the file name extension is used to determine the output format. Optional parameters: jpeg quality (1-100) and tiff compression method.
+Syntax: +saveimage [fits|eps|gif|tiff|jpeg|png]<filename> +saveimage <filename>.jpeg [1-100] +saveimage <filename>.tiff [none|jpeg|packbits|deflate] + +Example: +$xpaset -p ds9 saveimage ds9.tiff +$xpaset -p ds9 saveimage jpeg ds9.jpeg 75
+
scale
+
Controls the limits and color scale distribution.
+Syntax: +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ] +    [log exp <value>] +    [datasec yes|no] +    [limits <minvalue> <maxvalue>] +    [mode minmax|<value>|zscale|zmax] +    [scope local|global] +    [match] +    [match limits] +    [lock [yes|no]] +    [lock limits [yes|no]] +    [open|close] + +Example: +$xpaget ds9 scale +$xpaget ds9 scale log exp +$xpaget ds9 scale datasec +$xpaget ds9 scale limits +$xpaget ds9 scale mode +$xpaget ds9 scale scope +$xpaget ds9 scale lock +$xpaget ds9 scale lock limits + +$xpaset -p ds9 scale linear +$xpaset -p ds9 scale log exp 100 +$xpaset -p ds9 scale datasec yes +$xpaset -p ds9 scale histequ +$xpaset -p ds9 scale limits 1 100 +$xpaset -p ds9 scale mode zscale +$xpaset -p ds9 scale mode 99.5 +$xpaset -p ds9 scale scope local +$xpaset -p ds9 scale match +$xpaset -p ds9 scale match limits +$xpaset -p ds9 scale lock yes +$xpaset -p ds9 scale lock limits yes +$xpaset -p ds9 scale open +$xpaset -p ds9 scale close +
shm
+
Load a shared memory segment into the current frame.
+Syntax: +shm [<key> [<filename>]] +    [key <key> [<filename>]] +    [shmid <id> [<filename>]] +    [fits [key|shmid] <id> [<filename>]] +    [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> [<filename>]] +    [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] <id> [<filename>]] +    [rgbcube [key|shmid] <id> [<filename>] +    [rgbimage [key|shmid] <id> [<filename>]] +    [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]] +    [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]] + +Example: +$xpaget ds9 shm + +$xpaset -p ds9 shm 102 +$xpaset -p ds9 shm key 102 +$xpaset -p ds9 shm shmid 102 foo +$xpaset -p ds9 shm fits key 100 foo +$xpaset -p ds9 shm mosaicimage iraf key 100 foo +$xpaset -p ds9 shm mosaicimage wcs key 100 foo +$xpaset -p ds9 shm mosaicimage wcsa key 100 foo +$xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo +$xpaset -p ds9 shm mosaic iraf key 100 foo +$xpaset -p ds9 shm mosaic wcs key 100 foo +$xpaset -p ds9 shm rgbcube key 100 foo +$xpaset -p ds9 shm rgbimage key 100 foo +$xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32] +$xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32] + sia
+
Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the last search created, unless indicated otherwise.
+Syntax: +sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr] +    [<ref>] [cancel] +    [<ref>] [clear] +    [<ref>] [close] +    [<ref>] [coordinate <ra> <dec> <coordsys>] +    [<ref>] [crosshair] +    [<ref>] [export sb|tsv <filename>] +    [<ref>] [name <object>] +    [<ref>] [print] +    [<ref>] [retrieve] +    [<ref>] [save <filename>] +    [<ref>] [radius <value> degrees|arcmin|arcsec] +    [<ref>] [sky <skyframe>] +    [<ref>] [skyformat <skyformat>] +    [<ref>] [system <coordsys>] +    [<ref>] [update] + +Example: +$xpaget ds9 sia + +$xpaset -p ds9 sia 2mass +$xpaset -p ds9 sia cancel +$xpaset -p ds9 sia clear +$xpaset -p ds9 sia close +$xpaset -p ds9 sia coordinate 202.48 47.21 fk5 +$xpaset -p ds9 sia crosshair +$xpaset -p ds9 sia export tsv bar.tsv +$xpaset -p ds9 sia name m51 +$xpaset -p ds9 sia print +$xpaset -p ds9 sia retrieve +$xpaset -p ds9 sia save foo.xml +$xpaset -p ds9 sia radius 1 degrees +$xpaset -p ds9 sia sky fk5 +$xpaset -p ds9 sia skyformat degrees +$xpaset -p ds9 sia system wcs +$xpaset -p ds9 sia update + single +
Select Single Display mode
+Syntax: +single + +Example: +$xpaget ds9 single + +$xpaset -p ds9 single +
skyview
+
Support for SkyView image server at HEASARC.
+Syntax: +skyview [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [pixels <width> <height>] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey <survey>] +    [open|close] + +Example: +$xpaget ds9 skyview name +$xpaget ds9 skyview coord +$xpaget ds9 skyview size +$xpaget ds9 skyview pixels +$xpaget ds9 skyview save +$xpaget ds9 skyview frame +$xpaget ds9 skyview survey + +$xpaset -p ds9 skyview +$xpaset -p ds9 skyview m31 +$xpaset -p ds9 skyview name m31 +$xpaset -p ds9 skyview name clear +$xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 skyview size 60 60 arcmin +$xpaset -p ds9 skyview pixels 600 600 +$xpaset -p ds9 skyview save yes +$xpaset -p ds9 skyview frame current +$xpaset -p ds9 skyview update frame +$xpaset -p ds9 skyview survey sdssi +$xpaset -p ds9 skyview open +$xpaset -p ds9 skyview close
+
sleep
+
Delays execution for specified number of seconds. Default is 1 second.
+Syntax: +sleep [#] + +Example: +$xpaset -p ds9 sleep +$xpaset -p ds9 sleep 2 +
smooth
+
Smooth current image or set smooth parameters.
+
Boxcar width =2*radius+1 +Tophat diameter =2*radius+1 +Gaussian diameter =2*radius+1,mean=0 +Elliptical Gaussian diameter =2*radius+1,mean=0 +Syntax: +smooth [] +    [yes|no] +    [function boxcar|tophat|gaussian] +    [radius <value>] +    [radiusminor <value>] +    [sigma <value>] +    [sigmaminor <value>] +    [angle <value>] +    [match] +    [lock [yes|no]] +    [open|close]
+
Example: +$xpaget ds9 smooth +$xpaget ds9 smooth function +$xpaget ds9 smooth radius +$xpaget ds9 smooth radiusminor +$xpaget ds9 smooth sigma +$xpaget ds9 smooth sigmaminor +$xpaget ds9 smooth lock
+
$xpaset -p ds9 smooth +$xpaset -p ds9 smooth yes +$xpaset -p ds9 smooth function tophat +$xpaset -p ds9 smooth radius 4 +$xpaset -p ds9 smooth radiusminor 4 +$xpaset -p ds9 smooth sigma 2.0 +$xpaset -p ds9 smooth sigmaminor 2.0 +$xpaset -p ds9 smooth angle 45 +$xpaset -p ds9 smooth match +$xpaset -p ds9 smooth lock yes +$xpaset -p ds9 smooth open +$xpaset -p ds9 smooth close
+
source
+
Source TCL code from a file. Only available for XPA_METHOD local.
+Syntax: +source [<filename>] + +Example: +$xpaset -p ds9 source foo.tcl +
tcl
+
Execute one tcl command. Only available for XPA_METHOD local.
+Syntax: +tcl [<tcl command>] + +Example: +$echo 'puts "Hello, World"' | xpaset ds9 tcl +$xpaset -p ds9 tcl {puts {Hello, World}} +
threads
+
Set number of process threads for functions which are multi-threaded.
+Syntax: +threads # + +Example: +$xpaget ds9 threads + +$xpaset -p ds9 threads 8
+
tiff
+
Load TIFF image into current frame. Optional parameters: tiff compression method.
+Syntax: +tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate] + +Example: +$xpaget ds9 tiff > foo.tiff +$xpaget ds9 tiff jpeg > foo.tiff + +$xpaset -p ds9 tiff foo.tiff +$xpaset -p ds9 tiff new foo.tiff +$xpaset -p ds9 tiff slice foo.tiff + +$cat foo.tiff | xpaset ds9 tiff +$cat foo.tiff | xpaset ds9 tiff new +$cat foo.tiff | xpaset ds9 tiff slice +
tile
+
Controls the tile display mode.
+Syntax: +tile [] +    [yes|no] +    [mode grid|column|row] +    [grid] +    [grid mode automatic|manual] +    [grid direction x|y] +    [grid layout <col> <row>] +    [grid gap <pixels>] +    [row] +    [column] + +Example: +$xpaget ds9 tile +$xpaget ds9 tile mode +$xpaget ds9 tile grid mode +$xpaget ds9 tile grid direction +$xpaget ds9 tile grid layout +$xpaget ds9 tile grid gap + +$xpaset -p ds9 tile +$xpaset -p ds9 tile yes +$xpaset -p ds9 tile mode row +$xpaset -p ds9 tile grid +$xpaset -p ds9 tile grid mode manual +$xpaset -p ds9 tile grid direction x +$xpaset -p ds9 tile grid layout 5 5 +$xpaset -p ds9 tile grid gap 10 +$xpaset -p ds9 tile row +$xpaset -p ds9 tile column +
update
+
Updates the current frame or region of frame. In the second form, the first argument is the number of the fits HDU (starting with 1) and the remaining args are a bounding box in IMAGE coordinates. By default, the screen is updated the next available idle cycle. However, you may force an immediate update by specifying the NOW option.
+Syntax: +update [] +    [# x1 y1 x2 y2] +    [now] +    [now # x1 y1 x2 y2] + +Example: +$xpaset -p ds9 update +$xpaset -p ds9 update 1 100 100 300 400 +$xpaset -p ds9 update now +$xpaset -p ds9 update now 1 100 100 300 400
+
url
+
Load FITS from URL into the current frame
+Syntax: +url <url> + +Example: +$xpaset -p ds9 url http://foo.bar.edu/foo.fits +
version
+
Returns the current version of DS9.
+Syntax: +version + +Example: +$xpaget ds9 version +
view
+
Controls the GUI.
+Syntax: +view [layout horizontal|vertical] +    [keyvalue <string>] +    [info yes|no] +    [panner yes|no] +    [magnifier yes|no] +    [buttons yes|no] +    [colorbar yes|no] +    [colorbar horizontal|vertical] +    [colorbar numerics yes|no] +    [graph horizontal|vertical yes|no] +    [filename yes|no[ +    [object yes|no] +    [keyword yes|no] +    [minmax yes|no] +    [lowhigh yes|no] +    [units yes|no] +    [image|physical|wcs|wcsa...wcsz yes|no] +    [frame yes|no] +    [red yes|no] +    [green yes|no] +    [blue yes|no] + +Example: +$xpaget ds9 view layout +$xpaget ds9 view keyvalue +$xpaget ds9 view info +$xpaget ds9 view panner +$xpaget ds9 view magnifier +$xpaget ds9 view buttons +$xpaget ds9 view colorbar +$xpaget ds9 view graph horizontal +$xpaget ds9 view filename +$xpaget ds9 view object +$xpaget ds9 view keyword +$xpaget ds9 view minmax +$xpaget ds9 view lowhigh +$xpaget ds9 view units +$xpaget ds9 view image +$xpaget ds9 view wcsa +$xpaget ds9 view red +$xpaget ds9 view frame + +$xpaset -p ds9 view layout vertical +$xpaset -p ds9 view keyvalue BITPIX +$xpaset -p ds9 view info yes +$xpaset -p ds9 view panner yes +$xpaset -p ds9 view magnifier yes +$xpaset -p ds9 view buttons yes +$xpaset -p ds9 view colorbar yes +$xpaset -p ds9 view graph horizontal yes +$xpaset -p ds9 view filename yes +$xpaset -p ds9 view object yes +$xpaset -p ds9 view keyword yes +$xpaset -p ds9 view minmax yes +$xpaset -p ds9 view lowhigh yes +$xpaset -p ds9 view units yes +$xpaset -p ds9 view wcsa yes +$xpaset -p ds9 view frame yes +$xpaset -p ds9 view red yes +$xpaset -p ds9 view green yes +$xpaset -p ds9 view blue yes
+
+vla +
Support for VLA Sky Survey.
+Syntax: +vla [] +    [<object>] +    [name <object>|clear] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [survey first|stripe82] +    [open|close] + +Example: +$xpaget ds9 vla name +$xpaget ds9 vla coord +$xpaget ds9 vla size +$xpaget ds9 vla save +$xpaget ds9 vla frame +$xpaget ds9 vla survey + +$xpaset -p ds9 vla +$xpaset -p ds9 vla m31 +$xpaset -p ds9 vla name m31 +$xpaset -p ds9 vla name clear +$xpaset -p ds9 vla 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 vla size 60 60 arcmin +$xpaset -p ds9 vla save yes +$xpaset -p ds9 vla frame current +$xpaset -p ds9 vla update frame +$xpaset -p ds9 vla survey stripe82 +$xpaset -p ds9 vla open +$xpaset -p ds9 vla close
+
vlss
+
Support for NRAO VLSS Sky Survey.
+Syntax: +vlss [] +    [<object>] +    [name <object>] +    [<ra> <dec>] # in wcs fk5 +    [size <width> <height> degrees|arcmin|arcsec] +    [save yes|no] +    [frame new|current] +    [update frame|crosshair] +    [open|close] + +Example: +$xpaget ds9 vlss name +$xpaget ds9 vlss coord +$xpaget ds9 vlss size +$xpaget ds9 vlss save +$xpaget ds9 vlss frame + +$xpaset -p ds9 vlss +$xpaset -p ds9 vlss m31 +$xpaset -p ds9 vlss name m31 +$xpaset -p ds9 vlss name clear +$xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78 +$xpaset -p ds9 vlss size 60 60 arcmin +$xpaset -p ds9 vlss save yes +$xpaset -p ds9 vlss frame current +$xpaset -p ds9 vlss update frame +$xpaset -p ds9 vlss open +$xpaset -p ds9 vlss close
+
vo
+
Invoke an connection to a Virtual Observatory site.
+Syntax: +vo [method xpa|mime] +   [server <url>] +   [internal yes|no] +   [delay #] +   [<url>] +   [connect <url>] +   [disconnect <url>] +   [open|close] + +Example: +$xpaget ds9 vo +$xpaget ds9 vo method +$xpaget ds9 vo server +$xpaget ds9 vo internal +$xpaget ds9 vo delay +$xpaget ds9 vo connect + +$xpaset -p ds9 vo method xpa +$xpaset -p ds9 vo server http://foo.bar.edu/list.txt +$xpaset -p ds9 vo internal yes +$xpaset -p ds9 vo delay 15 # keep-alive delay +$xpaset -p ds9 vo chandra-ed +$xpaset -p ds9 vo connect chandra-ed +$xpaset -p ds9 vo disconnect chandra-ed +$xpaset -p ds9 vo open +$xpaset -p ds9 vo close +
wcs
+
Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info panel, compass, grid, and alignment will be modified accordingly. Also, using this access point, a new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. WCS specification can be sent to DS9 as an ASCII file . Please see WCS for more information.
+Syntax: +wcs [[system] wcs|wcsa...wcsz] +    [[sky] fk4|fk5|icrs|galactic|ecliptic] +    [[skyformat] degrees|sexagesimal] +    [align yes|no] +    [reset [#]] +    [replace [#] <filename>] +    [append [#] <filename>] +    [open|close] + +Example: +$xpaget ds9 wcs +$xpaget ds9 wcs system +$xpaget ds9 wcs sky +$xpaget ds9 wcs skyformat +$xpaget ds9 wcs align + +$xpaset -p ds9 wcs wcs +$xpaset -p ds9 wcs system wcs +$xpaset -p ds9 wcs fk5 +$xpaset -p ds9 wcs sky fk5 +$xpaset -p ds9 wcs sexagesimal +$xpaset -p ds9 wcs skyformat sexagesimal +$xpaset -p ds9 wcs align yes +$xpaset -p ds9 wcs reset +$xpaset -p ds9 wcs reset 3 +$xpaset -p ds9 wcs replace foo.wcs +$xpaset -p ds9 wcs replace 3 foo.wcs +$xpaset -p ds9 wcs append foo.wcs +$xpaset -p ds9 wcs append 3 foo.wcs +$xpaset -p ds9 open +$xpaset -p ds9 close
+$cat foo.wcs | xpaset ds9 wcs replace +$cat foo.wcs | xpaset ds9 wcs append +$echo "OBJECT = 'foobar'" | xpaset ds9 wcs append +
web
+
Display specified URL in the web display.
+Syntax: +web [] +    [<url>] +    [new <webname> <url>] +    [<webname>] [click back|forward|stop|reload|#] +    [<webname>] [clear] +    [<webname>] [close] + +Example: +$xpaget ds9 web + +$xpaset -p ds9 web www.cnn.com +$xpaset -p ds9 web new www.cnn.com +$xpaset -p ds9 web hvweb www.apple.com +$xpaset -p ds9 web click back +$xpaset -p ds9 web click 2 +$xpaset -p ds9 web clear +$xpaset -p ds9 web close +
width
+
Set the width of the image display window.
+Syntax: +width [<value>] + +Example: +$xpaget ds9 width + +$xpaset -p ds9 width 512
+
xpa
+
Configure XPA.
+Syntax: +-xpa [disconnect] +    [info] + +Example: +$xpaget ds9 info + +$xpaset -p ds9 disconnect +$xpaset -p ds9 info +
zscale
+
Set Scale Limits based on the IRAF algorithm.
+Syntax: +zscale [] +    [contrast] +    [sample] +    [line] + +Example: +$xpaget ds9 zscale contrast +$xpaget ds9 zscale sample +$xpaget ds9 zscale line + +$xpaset -p ds9 zscale +$xpaset -p ds9 zscale contrast .25 +$xpaset -p ds9 zscale sample 600 +$xpaset -p ds9 zscale line 120 +
zoom
+
Controls the current zoom value for the current frame.
+Syntax: +zoom [<value>] +    [<value> <value>] +    [to <value>] +    [to <value> <value>] +    [in] +    [out] +    [to fit] +    [open|close] + +Example: +$xpaget ds9 zoom + +$xpaset -p ds9 zoom 2 +$xpaset -p ds9 zoom 2 4 +$xpaset -p ds9 zoom to 4 +$xpaset -p ds9 zoom to 2 4 +$xpaset -p ds9 zoom in +$xpaset -p ds9 zoom out +$xpaset -p ds9 zoom to fit +$xpaset -p ds9 zoom open +$xpaset -p ds9 zoom close
+ -- cgit v0.12 From 78f23ae21b9817388c074b2f40e1424e0d3fa9da Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 14:53:11 -0400 Subject: clean up doc --- make.include | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/make.include b/make.include index dcd12c4..b26c365 100644 --- a/make.include +++ b/make.include @@ -26,6 +26,18 @@ DS9_VERSION = 8.1b1 XPA_VERSION = 2.1.18 TCL_VERSION = 8.6 +Tidy = \ + cd $(1); \ + for ff in *.html; \ + do echo ""; echo $$ff; \ + tidy -q -m -w 0 $$ff; \ + done; + +TidyFile = \ + cd $(1); \ + echo ""; echo $(2); \ + tidy -q -m -w 0 $(2); + #-------------------------- Defs DIRS = $(bindir) $(libdir) $(includedir) $(datadir) man build dist @@ -401,6 +413,17 @@ language: grep 'msgcat::mc' library/*.tcl | tclsh8.6 util/mergedict.tcl ja euc-jp; \ grep 'msgcat::mc' library/*.tcl | tclsh8.6 util/mergedict.tcl zh big5 +#-------------------------- tidy + +.PHONY : tidy + +tidy : + $(call Tidy,ds9/doc) + $(call Tidy,ds9/doc/release) + $(call TidyFile,ds9/doc/ref,xpa.html) + $(call TidyFile,ds9/doc/ref,command.html) + $(call TidyFile,ds9/doc/ref,samp.html) + #-------------------------- scrub .PHONY : scrub -- cgit v0.12 From 0e622f97254adb796c116a390f0d76e9aab450df Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:03:02 -0400 Subject: clean up doc --- make.include | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/make.include b/make.include index b26c365..14e52f0 100644 --- a/make.include +++ b/make.include @@ -420,9 +420,27 @@ language: tidy : $(call Tidy,ds9/doc) $(call Tidy,ds9/doc/release) - $(call TidyFile,ds9/doc/ref,xpa.html) + $(call TidyFile,ds9/doc/ref,3d.html) + $(call TidyFile,ds9/doc/ref,analysis.html) + $(call TidyFile,ds9/doc/ref,backup.html) + $(call TidyFile,ds9/doc/ref,bin.html) + $(call TidyFile,ds9/doc/ref,catalog.html) + $(call TidyFile,ds9/doc/ref,colorbar.html) $(call TidyFile,ds9/doc/ref,command.html) + $(call TidyFile,ds9/doc/ref,contour.html) + $(call TidyFile,ds9/doc/ref,grid.html) + $(call TidyFile,ds9/doc/ref,how.html) + $(call TidyFile,ds9/doc/ref,index.html) + $(call TidyFile,ds9/doc/ref,iraf.html) + $(call TidyFile,ds9/doc/ref,prefs.html) + $(call TidyFile,ds9/doc/ref,print.html) + $(call TidyFile,ds9/doc/ref,region.html) $(call TidyFile,ds9/doc/ref,samp.html) + $(call TidyFile,ds9/doc/ref,vo.html) + $(call TidyFile,ds9/doc/ref,xpa.html) + +# $(call TidyFile,ds9/doc/ref,file.html) +# $(call TidyFile,ds9/doc/ref,keyboard.html) #-------------------------- scrub -- cgit v0.12 From c06c97954bbbc646b63aa55f5e839a4c597d4113 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:07:22 -0400 Subject: clean up doc --- make.include | 22 +--------------------- 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/make.include b/make.include index 14e52f0..d3bda41 100644 --- a/make.include +++ b/make.include @@ -420,27 +420,7 @@ language: tidy : $(call Tidy,ds9/doc) $(call Tidy,ds9/doc/release) - $(call TidyFile,ds9/doc/ref,3d.html) - $(call TidyFile,ds9/doc/ref,analysis.html) - $(call TidyFile,ds9/doc/ref,backup.html) - $(call TidyFile,ds9/doc/ref,bin.html) - $(call TidyFile,ds9/doc/ref,catalog.html) - $(call TidyFile,ds9/doc/ref,colorbar.html) - $(call TidyFile,ds9/doc/ref,command.html) - $(call TidyFile,ds9/doc/ref,contour.html) - $(call TidyFile,ds9/doc/ref,grid.html) - $(call TidyFile,ds9/doc/ref,how.html) - $(call TidyFile,ds9/doc/ref,index.html) - $(call TidyFile,ds9/doc/ref,iraf.html) - $(call TidyFile,ds9/doc/ref,prefs.html) - $(call TidyFile,ds9/doc/ref,print.html) - $(call TidyFile,ds9/doc/ref,region.html) - $(call TidyFile,ds9/doc/ref,samp.html) - $(call TidyFile,ds9/doc/ref,vo.html) - $(call TidyFile,ds9/doc/ref,xpa.html) - -# $(call TidyFile,ds9/doc/ref,file.html) -# $(call TidyFile,ds9/doc/ref,keyboard.html) + $(call Tidy,ds9/doc/ref) #-------------------------- scrub -- cgit v0.12 From ed1b3d50e3629685a41cababb244f26169d507ee Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:16:56 -0400 Subject: clean up doc --- make.include | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/make.include b/make.include index d3bda41..7c09f9b 100644 --- a/make.include +++ b/make.include @@ -420,7 +420,7 @@ language: tidy : $(call Tidy,ds9/doc) $(call Tidy,ds9/doc/release) - $(call Tidy,ds9/doc/ref) +# $(call Tidy,ds9/doc/ref) #-------------------------- scrub -- cgit v0.12 From c3564c38dae0f1755e53182ad95b57f01d1004a7 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:17:19 -0400 Subject: clean up doc --- ds9/doc/ref/3d.html | 69 ++----- ds9/doc/ref/analysis.html | 469 ++++++++++++---------------------------------- ds9/doc/ref/backup.html | 48 ++--- ds9/doc/ref/bin.html | 43 ++--- ds9/doc/ref/catalog.html | 151 ++++----------- ds9/doc/ref/colorbar.html | 127 ++++++------- ds9/doc/ref/contour.html | 106 +++-------- ds9/doc/ref/file.html | 408 +++++++++++----------------------------- ds9/doc/ref/grid.html | 92 +++------ ds9/doc/ref/how.html | 155 ++++----------- ds9/doc/ref/index.html | 92 +++------ ds9/doc/ref/iraf.html | 107 ++--------- ds9/doc/ref/keyboard.html | 83 +++----- ds9/doc/ref/prefs.html | 33 +--- ds9/doc/ref/print.html | 47 ++--- ds9/doc/ref/region.html | 358 +++++++++-------------------------- ds9/doc/ref/vo.html | 64 ++----- 17 files changed, 654 insertions(+), 1798 deletions(-) diff --git a/ds9/doc/ref/3d.html b/ds9/doc/ref/3d.html index 964e09c..1be3358 100644 --- a/ds9/doc/ref/3d.html +++ b/ds9/doc/ref/3d.html @@ -1,77 +1,32 @@ - - - + + + 3D - -
3-D Frames
+ +
3-D Frames

-
Previous versions of DS9 would allow users to load 3-D data into -the traditional 2-D frames, and would allow users to step through -successive z-dimension pixel slices of the data cube. To visualize -the 3-D data in DS9 v. 7.0, a new module, encompassed by the new -Frame 3D option, allows users to load and view data cubes -in multiple dimensions.
-
The new module implements a simple ray-trace algorithm. For each -pixel on the screen, a ray is projected back into the view volume, -based on the current viewing parameters, returning a data value if -the ray intersects the FITS data cube. To determine the value -returned, there are 2 methods available, Maximum Intensity -Projection (MIP) and Average Intensity Projection (AIP). MIP -returns the maximum value encountered, AIP returns an average of -all values encountered. At this point, normal DS9 operations are -applied, such as scaling, clipping and applying a color -map.
-
Rendering time is independent upon the actual data cube size. -Instead, the time it takes to render is based on how many rays are -needed to project the data cube upon the screen in the view volume -and the current zoom factor. The new module requires no special -hardware or graphical processor unit (GPU) and the rendering time -is adequate for interactive GUI manipulation on most computers. The -rendering engine is developed using the POSIX thread library, -allowing multiple light weight processes to be spawned to complete -an image in parallel. The number of threads actually generated is a -user specified parameter. Since all modern hardware contain -multiple CPU cores, the default value is 8 threads. For larger work -stations, this number can be increase. For every doubling in the -number of CPU cores available, rendering times decrease -approximately 75%.
+
Previous versions of DS9 would allow users to load 3-D data into the traditional 2-D frames, and would allow users to step through successive z-dimension pixel slices of the data cube. To visualize the 3-D data in DS9 v. 7.0, a new module, encompassed by the new Frame 3D option, allows users to load and view data cubes in multiple dimensions.
+
The new module implements a simple ray-trace algorithm. For each pixel on the screen, a ray is projected back into the view volume, based on the current viewing parameters, returning a data value if the ray intersects the FITS data cube. To determine the value returned, there are 2 methods available, Maximum Intensity Projection (MIP) and Average Intensity Projection (AIP). MIP returns the maximum value encountered, AIP returns an average of all values encountered. At this point, normal DS9 operations are applied, such as scaling, clipping and applying a color map.
+
Rendering time is independent upon the actual data cube size. Instead, the time it takes to render is based on how many rays are needed to project the data cube upon the screen in the view volume and the current zoom factor. The new module requires no special hardware or graphical processor unit (GPU) and the rendering time is adequate for interactive GUI manipulation on most computers. The rendering engine is developed using the POSIX thread library, allowing multiple light weight processes to be spawned to complete an image in parallel. The number of threads actually generated is a user specified parameter. Since all modern hardware contain multiple CPU cores, the default value is 8 threads. For larger work stations, this number can be increase. For every doubling in the number of CPU cores available, rendering times decrease approximately 75%.

Example:
# create 3d frame, load fits file
# set view angle to az 45 el 30 deg
# set rendering method to Average Intensity Projection

-% ds9 -3d mycube.fits -3d vp 45 30 -3d method -aip
+% ds9 -3d mycube.fits -3d vp 45 30 -3d method aip

% xpaset -p ds9 3d
% xpaset -p ds9 file mycube.fits
% xpaset -p ds9 3d vp 45 30
% xpaset -p ds9 3d method aip
-All 2-D graphics, regions, cross hairs, contours, and coordinate -grids, are applied to the current slice, which is selected by the -user. When the user wishes to match or lock a 2-D image and to a -3-D data cube, the current slice is used to determine the rendering -solution. The user can crop the data cube for all 3 axes via the -command line or the GUI. The new module also supports FITS event -files binned into a data cube.
+All 2-D graphics, regions, cross hairs, contours, and coordinate grids, are applied to the current slice, which is selected by the user. When the user wishes to match or lock a 2-D image and to a 3-D data cube, the current slice is used to determine the rendering solution. The user can crop the data cube for all 3 axes via the command line or the GUI. The new module also supports FITS event files binned into a data cube.

-All printing support has been extended to the new 3-D module. The -user may generate 3-D images in Postscript, JPEG, TIFF, and other -formats, just as in the 2-D case. Furthermore, native printing is -supported for the Windows version.
+All printing support has been extended to the new 3-D module. The user may generate 3-D images in Postscript, JPEG, TIFF, and other formats, just as in the 2-D case. Furthermore, native printing is supported for the Windows version.

-DS9 analysis macros have been enhanced to fully support the new 3-D -module, allowing the user to invoke external analysis tasks based -on the current view parameters and to return results back into DS9 -in the form of text, plot, 2-D image, or 3-D image.
+DS9 analysis macros have been enhanced to fully support the new 3-D module, allowing the user to invoke external analysis tasks based on the current view parameters and to return results back into DS9 in the form of text, plot, 2-D image, or 3-D image.
diff --git a/ds9/doc/ref/analysis.html b/ds9/doc/ref/analysis.html index 8b05f8b..bf64138 100644 --- a/ds9/doc/ref/analysis.html +++ b/ds9/doc/ref/analysis.html @@ -1,41 +1,17 @@ - - - + + + Analysis - -
Analysis
+ +
Analysis

-
Each file type known to DS9 can have user-defined analysis -commands associated with it. These analysis commands are defined at -start-up time , or loaded by the user, by means of an ASCII -analysis description file. The analysis commands are available for -execution, either via the Analysis Menu or the XPA point -Analysis. In addition, commands may be bound to -events, such as keystrokes or mouse clicks. This type of command is -called a bind command.
-
DS9 searches for an analysis file named ds9.ans or -ds9.analysis in the current directory and $HOME -to be loaded at startup. In addition, DS9 will search the following -directories for any analysis files to be loaded at startup in the -form of *.ds9: the current directory, $HOME/bin, -/usr/local/bin, /opt/local/bin, and -/soft/saord/bin. Finally, the user may specify analysis -files to be loaded at startup in the preferences analysis panel. -The user may also load or clear current analysis commands via -command line options or the Analysis menu.
-
When activated, either from the menu, XPA, or bound event, an -analysis command first is macro-expanded to fill in user-defined -arguments and then is executed externally. Results may be displayed -in a separate text window, plot window, or in a image frame.
+
Each file type known to DS9 can have user-defined analysis commands associated with it. These analysis commands are defined at start-up time , or loaded by the user, by means of an ASCII analysis description file. The analysis commands are available for execution, either via the Analysis Menu or the XPA point Analysis. In addition, commands may be bound to events, such as keystrokes or mouse clicks. This type of command is called a bind command.
+
DS9 searches for an analysis file named ds9.ans or ds9.analysis in the current directory and $HOME to be loaded at startup. In addition, DS9 will search the following directories for any analysis files to be loaded at startup in the form of *.ds9: the current directory, $HOME/bin, /usr/local/bin, /opt/local/bin, and /soft/saord/bin. Finally, the user may specify analysis files to be loaded at startup in the preferences analysis panel. The user may also load or clear current analysis commands via command line options or the Analysis menu.
+
When activated, either from the menu, XPA, or bound event, an analysis command first is macro-expanded to fill in user-defined arguments and then is executed externally. Results may be displayed in a separate text window, plot window, or in a image frame.
Syntax
Command Type
Macros
@@ -44,28 +20,20 @@ in a separate text window, plot window, or in a image frame.
Hierarchical Menus
Sample
Syntax
-The analysis file that defines the known analysis commands consists -of one or more file descriptors, each of which has the following -format: +The analysis file that defines the known analysis commands consists of one or more file descriptors, each of which has the following format:
Menu label to be used
A space separated list of file templates
Command type [menu | bind <event>]
The command line for the analysis program
-
Task names may contain space characters. All lines may be -indented. Also, the '#' character is a comment character. A -separator can be inserted in the menu by specifying the following -sequence '---'.
+
Task names may contain space characters. All lines may be indented. Also, the '#' character is a comment character. A separator can be inserted in the menu by specifying the following sequence '---'.
Example:
# this will insert a menu separator
---
-
Command -Type
+
Command Type

The third line indicates the type of command.

menu
-
A menu command creates an menu option under the -Analysis menu option, and can be invoked by the user via the -GUI or XPA.
+
A menu command creates an menu option under the Analysis menu option, and can be invoked by the user via the GUI or XPA.
Example:
# Menu command example
My Analysis Task
@@ -73,12 +41,7 @@ GUI or XPA.
menu
$data | doit | $text

bind
-
A bind command is a command that is bound to an event. -When the event occurs, the command is executed. Types of events -available include all TK events, including all keystrokes -and mouse clicks. If a command is bound to an event other -that a keystroke, care must be taken to not to interfere -with other internal DS9 events.
+
A bind command is a command that is bound to an event. When the event occurs, the command is executed. Types of events available include all TK events, including all keystrokes and mouse clicks. If a command is bound to an event other that a keystroke, care must be taken to not to interfere with other internal DS9 events.

To bind to a key stroke, use the following command type:

bind <keystroke>
Example: @@ -88,8 +51,7 @@ with other internal DS9 events.
bind x
echo "$x $y" | $text

web
-
A web command allows the user to invoke the internal -web browser from the analysis menu.
+
A web command allows the user to invoke the internal web browser from the analysis menu.
Example:
# web command example HTTP based @@ -103,208 +65,108 @@ web file:/home/joye/index.html

Macros
-
The following macros are macro-expanded to fill in user-defined -arguments before the command is executed. Strings that contain -$<macroname> that user does not want to be expanded may be -escaped by using $$<macroname>. All strings that contain -$<string> that are not a macro name will not be -affected.
+
The following macros are macro-expanded to fill in user-defined arguments before the command is executed. Strings that contain $<macroname> that user does not want to be expanded may be escaped by using $$<macroname>. All strings that contain $<string> that are not a macro name will not be affected.

For example:

echo "$$data $foo" | $text

will display a text dialog that contains "$data $foo"

$width
$height
$depth
-
Substitute the width, height, or depth of the data file in the -command line.
+
Substitute the width, height, or depth of the data file in the command line.
Syntax:     $width
    $height

-Example:     echo "$width $height -$depth" | $text
+Example:     echo "$width $height $depth" | $text

$bitpix

Substitute the bitpix of the data file in the command line.
Syntax:     $bitpix

-Example:     echo "$bitpix" | -$text +Example:     echo "$bitpix" | $text
$data
-
Data from the current frame becomes the input data to the -command string. This data is in the form of a FITS image. This -macro can only used at the beginning of the command string.
+
Data from the current frame becomes the input data to the command string. This data is in the form of a FITS image. This macro can only used at the beginning of the command string.
Syntax:     $data

-Example:     $data | dosomething | -$text +Example:     $data | dosomething | $text
$entry
-
Display an entry modal dialog. The returned string is -substituted. If cancel is selected, the command line is -not executed.
-Syntax:     -$entry(<message>)
-
-Example:     echo "$entry(Enter -something here)" | $text +
Display an entry modal dialog. The returned string is substituted. If cancel is selected, the command line is not executed.
+Syntax:     $entry(<message>)
+
+Example:     echo "$entry(Enter something here)" | $text
$env

Substitute the value of a shell environment variable.
-Syntax:     $env(<shell -variable>)
+Syntax:     $env(<shell variable>)

-Example:     echo "$env(PATH)" | -$text +Example:     echo "$env(PATH)" | $text
$filedialog
-
Display the standard file dialog. Substitutes the returned -pathname. Argument specifies if an open file or save file dialog is -invoked.
-Syntax:     -$filedialog([open|save])
-
-Example:     echo -"$filedialog(open)" | $text
+
Display the standard file dialog. Substitutes the returned pathname. Argument specifies if an open file or save file dialog is invoked.
+Syntax:     $filedialog([open|save])
+
+Example:     echo "$filedialog(open)" | $text

$filename
-
Substitute the filename of the data file in the command line. A -full filename includes any absolute or relative path. A root -filename contains no path. A (2D) subsection defines a subimage -from xmin,ymin to xmax,ymax. For Frame3D, a 2D -subsection will also include the current slice (PLANE=) parameter -if not 1. A 3D subsection defines a subimage from -xmin,ymin,zmin to xmax,ymax,zmax and no PLANE -parameter.
-Syntax:     $filename # filename -with extname, (2d) subsections, filters
-    $filename(root|root,base) # root filename -with with extname, no subsections, no -filters)
- $filename(full|full,base) # full filename -with extname, no subsections, no filters)
-
-Example:     dosomething $filename -| $text
-    dosomething $filename(root) | -$text
+
Substitute the filename of the data file in the command line. A full filename includes any absolute or relative path. A root filename contains no path. A (2D) subsection defines a subimage from xmin,ymin to xmax,ymax. For Frame3D, a 2D subsection will also include the current slice (PLANE=) parameter if not 1. A 3D subsection defines a subimage from xmin,ymin,zmin to xmax,ymax,zmax and no PLANE parameter.
+Syntax:     $filename # filename with extname, (2d) subsections, filters
+    $filename(root|root,base) # root filename with with extname, no subsections, no filters)
+ $filename(full|full,base) # full filename with extname, no subsections, no filters)
+
+Example:     dosomething $filename | $text
+    dosomething $filename(root) | $text
$filename[$regions] -
Combination of $filename and $regions macros. -Generates a series of filenames, each with a region.
-Syntax:     -$filename[$regions]
-    -$filename[$regions(<options>)]
-
-Example:     dosomething -$filename[$regions] | $text +
Combination of $filename and $regions macros. Generates a series of filenames, each with a region.
+Syntax:     $filename[$regions]
+    $filename[$regions(<options>)]
+
+Example:     dosomething $filename[$regions] | $text
$geturl
-
This macro differs from all other macros, including -$url, in that no subprocess pipe is created. Only HTTP is -supported. The contents of the url are retrieved and sent to -$text, $plot, or $image. No other -processing is allowed. The primary purpose of this macro is to -support external analysis for the Windows platform, which has no -subprocess support.
-Syntax:     -$geturl(http://<hostname>:<port>/<query>)
- -
-Example:     -$geturl(http://foo.bar.edu/foo.html) | $text
+
This macro differs from all other macros, including $url, in that no subprocess pipe is created. Only HTTP is supported. The contents of the url are retrieved and sent to $text, $plot, or $image. No other processing is allowed. The primary purpose of this macro is to support external analysis for the Windows platform, which has no subprocess support.
+Syntax:     $geturl(http://<hostname>:<port>/<query>)
+
+Example:     $geturl(http://foo.bar.edu/foo.html) | $text

$image
-
The resulting image data is display in a DS9 frame. This macro -should be the last macro of a command line. Optional parameter -indicates if a new frame and what type of frame is created for the -new data. The macro is removed from the command line before -execution.
+
The resulting image data is display in a DS9 frame. This macro should be the last macro of a command line. Optional parameter indicates if a new frame and what type of frame is created for the new data. The macro is removed from the command line before execution.
Syntax:     $image
    $image([new|rgb|3d|current])

-Example:     doit | -$image(new) +Example:     doit | $image(new)
$message
-
Display a message dialog box, with option buttons. After -displaying the message, the macro is removed from the command line -before execution. If cancel or no is selected, -the command line is not executed.
-Syntax:     -$message(<message>)
-    -$message([ok|okcancel|yesno],<message>)
-
-Example:     $message(okcancel,This -is a Message)| doit | $text +
Display a message dialog box, with option buttons. After displaying the message, the macro is removed from the command line before execution. If cancel or no is selected, the command line is not executed.
+Syntax:     $message(<message>)
+    $message([ok|okcancel|yesno],<message>)
+
+Example:     $message(okcancel,This is a Message)| doit | $text
$null
-
Expect no output or results from analysis task. Note: no error -message will be returned if the analysis task fails to execute -correctly.
+
Expect no output or results from analysis task. Note: no error message will be returned if the analysis task fails to execute correctly.
Syntax:     $null

-Example:     echo "Hello, world" -> foo | $null +Example:     echo "Hello, world" > foo | $null
$pan
-
Substitute current pan location of the particular data file are -returned. The default coordinate system is physical.
-Syntax:     $pan -    $pan(<coordinate -system>,<format>)
+
Substitute current pan location of the particular data file are returned. The default coordinate system is physical.
+Syntax:     $pan     $pan(<coordinate system>,<format>)

where:
-    coordinate system = -[image|physical|detector|amplifier|wcs|wcsa...wcsz]
-    sky -frame         = -[fk4|fk5|icrs|galactic|ecliptic]
-    sky -format        = -[hms|sexagesimal|degrees]
-
-Example:     echo -$pan(fk5,sexagesimal) | $text
+    coordinate system = [image|physical|detector|amplifier|wcs|wcsa...wcsz]
+    sky frame         = [fk4|fk5|icrs|galactic|ecliptic]
+    sky format        = [hms|sexagesimal|degrees]
+
+Example:     echo $pan(fk5,sexagesimal) | $text

$plot
-
Display data in plot window. This macro should be the last macro -of a command line. The data is read via STDIN and consist -of a pair of coordinates, with option error values. (xy, xyex, -xyey, xyexey) Default dimension is xy. The macro is -removed from the command line before execution.
+
Display data in plot window. This macro should be the last macro of a command line. The data is read via STDIN and consist of a pair of coordinates, with option error values. (xy, xyex, xyey, xyexey) Default dimension is xy. The macro is removed from the command line before execution.

For $plot(stdin) only:
-
The title, x axis label, and y axis label are assumed to be on -the first line of input, delimited with a new-line. However, if the -data starts with $BEGINTEXT, all text between -$BEGINTEXT and $ENDTEXT will be removed from the -data and displayed in a separate text dialog window, with the -remaining data, including the title, x axis label, and y axis -label, will be displayed in a plot window. Furthermore, if the data -contains the string $ERROR, an error is assumed to have -occurred and a text dialog window is displayed only.
+
The title, x axis label, and y axis label are assumed to be on the first line of input, delimited with a new-line. However, if the data starts with $BEGINTEXT, all text between $BEGINTEXT and $ENDTEXT will be removed from the data and displayed in a separate text dialog window, with the remaining data, including the title, x axis label, and y axis label, will be displayed in a plot window. Furthermore, if the data contains the string $ERROR, an error is assumed to have occurred and a text dialog window is displayed only.
Syntax:     $plot
    $plot(,,,)
-    $plot(<title>,<x axis -label>,<y axis label>,[xy|xyex|xyey|xyexey])
+    $plot(<title>,<x axis label>,<y axis label>,[xy|xyex|xyey|xyexey])
    $plot(stdin)

-Example:     doit | $plot(This is -aTitle,X Axis,Y Axis)     doit | -$plot(stdin) +Example:     doit | $plot(This is aTitle,X Axis,Y Axis)     doit | $plot(stdin)
$regions
-
Substitute region definition in specified region format, -coordinate system, and coordinate format. The default coordinate -system is physical, default coordinate format -degrees, and default region format DS9. Arguments -may appear in any order, as long as they are separated by ',' and -no spaces. If one or more properties are specified, only -regions with all of the specified properties will be -substituted.
+
Substitute region definition in specified region format, coordinate system, and coordinate format. The default coordinate system is physical, default coordinate format degrees, and default region format DS9. Arguments may appear in any order, as long as they are separated by ',' and no spaces. If one or more properties are specified, only regions with all of the specified properties will be substituted.
Syntax:     $regions
    $regions(<options>)
where options are one of the following:
-    regions format    = -[ds9|ciao|saotng|saoimage|pros|xy]
-    -property          = -[include|exclude|source|background]
-    coordinate system = -[image|physical|detector|amplifier|wcs]
-    sky -frame         = -[fk4|fk5|icrs|galactic|ecliptic]
-    sky -format        = -[sexagesimal|degrees] +    regions format    = [ds9|ciao|saotng|saoimage|pros|xy]
+    property          = [include|exclude|source|background]
+    coordinate system = [image|physical|detector|amplifier|wcs]
+    sky frame         = [fk4|fk5|icrs|galactic|ecliptic]
+    sky format        = [sexagesimal|degrees]
also, the old SAOTNG formats are also supported:
    $regions_pixels
    $regions_degrees
@@ -317,49 +179,30 @@ format        =     $exclude_regions_pixels
    $exclude_regions_degrees
    $exclude_regions_hms
-Example:     dosomething $regions | -$text
+Example:     dosomething $regions | $text
    dosomething $regions(pros) | $text
-    dosomething $regions(source,wcs,fk5) | -$text
-    dosomething -$regions(saotng,background,exclude,ecliptic,sexagesimal) | -$text +    dosomething $regions(source,wcs,fk5) | $text
+    dosomething $regions(saotng,background,exclude,ecliptic,sexagesimal) | $text
$text
-
Display text in a text dialog window. This macro should be the -last macro of a command line. To display text from only STDOUT use -'|' as the pipe command. To display text from both STDOUT and -STDERR, use '|&' as the pipe command. No parameters are -required. The macro is removed from the command line before -execution.
+
Display text in a text dialog window. This macro should be the last macro of a command line. To display text from only STDOUT use '|' as the pipe command. To display text from both STDOUT and STDERR, use '|&' as the pipe command. No parameters are required. The macro is removed from the command line before execution.
Syntax:     $text

-Example:     doit | $text # -stdout +Example:     doit | $text # stdout     doit |& $text # stdout and stderr $url -URLs are processed and stored in a temporary file. Only HTTP and -anonymous FTP are supported. -Syntax:     -$url(http://<hostname>:<port>/<query>) -    -$url(ftp://<hostname>/<filename>) - -Example:     -$url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | -uncompress | $image -    -$url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/rh100193_img.fits) -| $image +URLs are processed and stored in a temporary file. Only HTTP and anonymous FTP are supported. +Syntax:     $url(http://<hostname>:<port>/<query>) +    $url(ftp://<hostname>/<filename>) + +Example:     $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image +    $url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/rh100193_img.fits) | $image $vo_method Returns the vo method. Syntax:     $vo_method -Example:     echo '$vo_method' | -$text +Example:     echo '$vo_method' | $text $value -Substitute the value at the location of the cursor of an bind -event. +Substitute the value at the location of the cursor of an bind event. Syntax:     $value Example: @@ -367,55 +210,33 @@ Example: $x $y $z -Substitute coordinates of an bind event. When a bind event is -triggered, the x,y coordinates of the mouse of the -particular data file are returned. The default coordinate system is -physical. This macro is only available for bind commands. -For datacubes, the z coordinate is returned based on the current -slice selected. +Substitute coordinates of an bind event. When a bind event is triggered, the x,y coordinates of the mouse of the particular data file are returned. The default coordinate system is physical. This macro is only available for bind commands. For datacubes, the z coordinate is returned based on the current slice selected. Syntax:     $x -    $x(<coordinate -system>,<format>) +    $x(<coordinate system>,<format>)     $y -    $y(<coordinate -system>,<format>) +    $y(<coordinate system>,<format>)     $z     $z(<coordinate system>) where: -    coordinate system = -[image|physical|detector|amplifier|wcs|wcsa...wcsz] -    sky -frame         = -[fk4|fk5|icrs|galactic|ecliptic] -    sky -format        = -[hms|sexagesimal|degrees] - -Example:     echo "$x $y" | -$text +    coordinate system = [image|physical|detector|amplifier|wcs|wcsa...wcsz] +    sky frame         = [fk4|fk5|icrs|galactic|ecliptic] +    sky format        = [hms|sexagesimal|degrees] + +Example:     echo "$x $y" | $text     echo "$x $y $z" | $text -    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | -$text     echo "$x(wcs) $y(wcs) -$z(wcs)" | $text +    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text     echo "$x(wcs) $y(wcs) $z(wcs)" | $text $xpa Returns the xpa access point name. Syntax:     $xpa -Example:     echo '$xpa' | -$text +Example:     echo '$xpa' | $text $xpa_method Returns the xpa method. Syntax:     $xpa_method -Example:     echo '$xpa_method' | -$text +Example:     echo '$xpa_method' | $text Help -The user may define his own HELP message. This message -will be available to the user as a menu item. An optional label -maybe specified. The default label is Help. When invoked, -an text dialog window will appear, containing the message. Multiple -HELP items maybe defined within a menu or across -hierarchical menus. +The user may define his own HELP message. This message will be available to the user as a menu item. An optional label maybe specified. The default label is Help. When invoked, an text dialog window will appear, containing the message. Multiple HELP items maybe defined within a menu or across hierarchical menus. Example: help Main Help A help message may contain @@ -423,22 +244,16 @@ hierarchical menus. in the menu or menus endhelp Parameters -The user may define his own macros or parameters to be evaluated -before the command line is executed. To do this, the user defines a -param segment that is referenced in the command line. The param -definition has the follow format: +The user may define his own macros or parameters to be evaluated before the command line is executed. To do this, the user defines a param segment that is referenced in the command line. The param definition has the follow format: param <name> -<variable> <entry | checkbox | menu> <title> -<default> <{comment}> +<variable> <entry | checkbox | menu> <title> <default> <{comment}> ... endparam or param <name> @<iraf param filename> end -The definition either consisted of a number of variables, one -per row, or the name of a IRAF style parameter file. DS9 will look -for the IRAF parameter file in: +The definition either consisted of a number of variables, one per row, or the name of a IRAF style parameter file. DS9 will look for the IRAF parameter file in: ./<filename> $UPARM/<filename> $HOME/iraf/<filename> @@ -448,23 +263,14 @@ for the IRAF parameter file in: var2 checkbox {Variable 2} 1 {this is a checkbox} var3 menu {Variable 3} AAA|BBB|CCC {this is a menu} endparam
-To use parameters, specify the param name at the beginning of -your command line: +To use parameters, specify the param name at the beginning of your command line: Parameter Test * menu -$param(foobar); echo "$var1 $var2 $var3" | -$text -When the menu item is selected, the user will be presented with -a dialog box that contains entry, checkbox, or menu choices -for each variable specified. If the user clicks ok, the values are -substituted in the command line before execution. -Hierarchical Menus -The user may define hierarchical menus. Use this to organized -crowded menus. To do this, frame menu entries with hmenu -<label> and endhmenu. Hierarchical menu labels -may contain spaces. Multiple levels maybe implemented. +$param(foobar); echo "$var1 $var2 $var3" | $text
+When the menu item is selected, the user will be presented with a dialog box that contains entry, checkbox, or menu choices for each variable specified. If the user clicks ok, the values are substituted in the command line before execution. +Hierarchical Menus +The user may define hierarchical menus. Use this to organized crowded menus. To do this, frame menu entries with hmenu <label> and endhmenu. Hierarchical menu labels may contain spaces. Multiple levels maybe implemented. Example: hmenu Stuff     hello @@ -479,13 +285,11 @@ may contain spaces. Multiple levels maybe implemented.         hello world         *         menu -        echo "Hello World" | -$text +        echo "Hello World" | $text     endhmenu endhmenu -Will create an hierarchical menu with two members, -hello and world. +Will create an hierarchical menu with two members, hello and world. Sample # # Analysis command descriptions: @@ -496,8 +300,7 @@ $text param foo     var1 entry entry 40 {this is a entry} -    var2 checkbox checkbox 1 {this is a -checkbox} +    var2 checkbox checkbox 1 {this is a checkbox}     var3 menu menu AAA|BBB|CCC {this is a menu} endparam @@ -510,8 +313,7 @@ param foobar endparam param ltc -    bins entry "Enter number of [t1:t2:]bins" 0 -"('0' for default number of bins)" +    bins entry "Enter number of [t1:t2:]bins" 0 "('0' for default number of bins)" endparam # Help Main Help @@ -599,24 +401,17 @@ hmenu Test Regions     Test $regions     *.fits     menu -    echo "$regions ds9_s:$regions(ds9,source,image) -ciao_b:$regions(ciao,background) -saotng_i:$regions(saotng,include,wcs,fk5) -pros_e:$regions(pros,exclude,wcs,fk5,sexagesimal) -xy_be:$regions(xy,background,exclude,wcs,fk4,hms)" | $text +    echo "$regions ds9_s:$regions(ds9,source,image) ciao_b:$regions(ciao,background) saotng_i:$regions(saotng,include,wcs,fk5) pros_e:$regions(pros,exclude,wcs,fk5,sexagesimal) xy_be:$regions(xy,background,exclude,wcs,fk4,hms)" | $text     Test $regions wcs     *.fits     menu -    echo "$regions(ds9,wcs) -$regions(ds9,wcs,fk5,sexagesimal) $regions(ds9,wcsa) " | $text +    echo "$regions(ds9,wcs) $regions(ds9,wcs,fk5,sexagesimal) $regions(ds9,wcsa) " | $text     Test $include_regions_pixels     *.fits     menu -    echo "ds9_s: $source_regions ds9_b: -$background_regions_pixels ds9_i: $include_regions_degrees ds9_e: -$exclude_regions_hms" | $text +    echo "ds9_s: $source_regions ds9_b: $background_regions_pixels ds9_i: $include_regions_degrees ds9_e: $exclude_regions_hms" | $text     Test $filename $regions     *.fits @@ -657,14 +452,12 @@ hmenu Test Output     Test $plot(title,x,y,xyey)     *     menu -    cat xye.dat | $plot(Title,X Axis,Y -Axis,xyey) +    cat xye.dat | $plot(Title,X Axis,Y Axis,xyey)     Test $plot(title,x,y,xyexey)     *     menu -    cat xyee.dat | $plot(Title,X Axis,Y -Axis,xyexey) +    cat xyee.dat | $plot(Title,X Axis,Y Axis,xyexey)     Test $plot(title,x,y,4)     * @@ -710,14 +503,12 @@ hmenu Test Dialogs     Test $message(message)     *     menu -    $message(ok,This is a Message) | echo "hello" | -$text +    $message(ok,This is a Message) | echo "hello" | $text     Test $message(ok,message)     *     menu -    $message(ok,This is a Message) | echo "World" | -$text +    $message(ok,This is a Message) | echo "World" | $text     Test $entry(message)     * @@ -733,14 +524,12 @@ hmenu Test Params     Test $param     *     menu -    $param(foo); echo "$var1 $var2 $var3" | -$text +    $param(foo); echo "$var1 $var2 $var3" | $text     Test $param @file     *     menu -    $param(bar); echo "$var1 $var2 $var3" | -$text +    $param(bar); echo "$var1 $var2 $var3" | $text endhmenu hmenu Test Network @@ -751,30 +540,22 @@ hmenu Test Network     Test $url(http://)     *     menu -    -$url(http://legacy.gsfc.nasa.gov/FTP/rosat/data/cdrom/vol1/IMAGES/00h/p000s26b.img.Z) -| gunzip | $image +    $url(http://legacy.gsfc.nasa.gov/FTP/rosat/data/cdrom/vol1/IMAGES/00h/p000s26b.img.Z) | gunzip | $image     Test $url(ftp://)     *     menu -    -$url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/fits/rh100193_img.fits) -| $image +    $url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/fits/rh100193_img.fits) | $image     Test $geturl $text     *     menu -    -$geturl(http://hea-www.harvard.edu/RD/saord-cgi/funtools?funcnts+$filename+$regions(source,,)+$regions(background,,))|$text - +    $geturl(http://hea-www.harvard.edu/RD/saord-cgi/funtools?funcnts+$filename+$regions(source,,)+$regions(background,,))|$text     Test $geturl $plotstd     *     menu -    $param(ltc); -$geturl(http://hea-www.harvard.edu/RD/saord-cgi/funtools?funhist_plot+$filename[$regions]+time+$bins)|$plot(stdin) - +    $param(ltc); $geturl(http://hea-www.harvard.edu/RD/saord-cgi/funtools?funhist_plot+$filename[$regions]+time+$bins)|$plot(stdin) endhmenu hmenu Test Other @@ -791,8 +572,7 @@ hmenu Test Other         test         *         menu -        echo "Hello World" | -$text +        echo "Hello World" | $text     endhmenu endhmenu @@ -809,7 +589,6 @@ echo "$x(fk5,hms) $y(fk5,hms)" | $text $x(wcs,fk5,hms) $y(wcs,fk5,hms) *.fits bind z -echo "$x(wcs,fk5,hms) $y(wcs,fk5,hms)" | -$text

+echo "$x(wcs,fk5,hms) $y(wcs,fk5,hms)" | $text
diff --git a/ds9/doc/ref/backup.html b/ds9/doc/ref/backup.html index 5de7bfc..1e6c0b6 100644 --- a/ds9/doc/ref/backup.html +++ b/ds9/doc/ref/backup.html @@ -1,42 +1,22 @@ - - - + + + Backup - -

Backup and Restore

+ +

Backup and Restore

-
DS9 now supports Backup and Restore. When a backup is invoked, -DS9 will save in a backup save set all files needed to restore DS9 -to that state, including geometry, data files, colormaps, catalogs, -contours, and regions.
+
DS9 now supports Backup and Restore. When a backup is invoked, DS9 will save in a backup save set all files needed to restore DS9 to that state, including geometry, data files, colormaps, catalogs, contours, and regions.

Backup Save Set
-
A backup save set consists of a text file, called a backup -script, and an optional directory, which will contain auxiliary -data files needed to restore DS9 to a previous state. The backup -file and the auxiliary directory maybe moved across file systems, -or even platforms, but must remain together in the same -directory.
+
A backup save set consists of a text file, called a backup script, and an optional directory, which will contain auxiliary data files needed to restore DS9 to a previous state. The backup file and the auxiliary directory maybe moved across file systems, or even platforms, but must remain together in the same directory.

Image data files
-
By default, all data image files are save within the backup save -set. However, the user has the option, via the Preferences, to only -save only an absolute pathname to the data file, and not the data -file itself. This option will dramatically reduce the size of a -backup save set, but will restrict the usage to a particular file -system and platform.
-
Image files that have been loaded into DS9 via XPA, SAMP, or -from URL will always be saved into the save set.
+
By default, all data image files are save within the backup save set. However, the user has the option, via the Preferences, to only save only an absolute pathname to the data file, and not the data file itself. This option will dramatically reduce the size of a backup save set, but will restrict the usage to a particular file system and platform.
+
Image files that have been loaded into DS9 via XPA, SAMP, or from URL will always be saved into the save set.

Caveats
-
There are several caveats in the usage of Backup and Restore. In -particular:
+
There are several caveats in the usage of Backup and Restore. In particular:

Currently, there is no support for masks. External Analysis menus will not be saved. @@ -44,14 +24,10 @@ Plot Tool windows will not be saved. IIS frames (IRAF) will not be saved. SAMP and XPA sessions will not be saved.

-
And finally, if the image data had been loaded into DS9 via XPA, -SAMP, or from a URL, the following complex load operations are not -supported:
+
And finally, if the image data had been loaded into DS9 via XPA, SAMP, or from a URL, the following complex load operations are not supported:

Open Mosaic IRAF Image Open Mosaic IRAF Segment Open Mosaic WCS Image -Open Mosaic WCS Segment Open Mosaic WFPC2 Open RGB Fits Image Open -RGB Fits Cube Open RGB Array Open Multi Ext Data Cube Open Multi -Ext Multiple Frames
+Open Mosaic WCS Segment Open Mosaic WFPC2 Open RGB Fits Image Open RGB Fits Cube Open RGB Array Open Multi Ext Data Cube Open Multi Ext Multiple Frames

diff --git a/ds9/doc/ref/bin.html b/ds9/doc/ref/bin.html index 88670d6..6676879 100644 --- a/ds9/doc/ref/bin.html +++ b/ds9/doc/ref/bin.html @@ -1,44 +1,25 @@ - - - + + + Bin - -

Binning

+ +

Binning

-
To create an image from a FITS Bin Table, the user needs to -specify a binning factor, binning buffer size, and the binning -function.
-
The Binning (or Block) Factor is defined as the following: A -value greater or equal to zero. This value indicates the number of -pixel values that will fall into a particular bin.
-
The Bin Buffer Size is overall size of the image generated. This -has no relation to min and max values of the columns used to create -the image.
-
The Bin Function is defined as the following: Average - all -pixel values that fall into one pixel bin are averaged. Sum - all -pixel values that fall into one pixel bin are summed.
-
Bin to Fit Frame will calculate a bin block factor as a power of -2 that will allow the entire data space to be displayed in the -current frame.
-
By default, DS9 will bin about the center of the image. To -determine the center of the image, DS9 will look for the following -keywords in order:
+
To create an image from a FITS Bin Table, the user needs to specify a binning factor, binning buffer size, and the binning function.
+
The Binning (or Block) Factor is defined as the following: A value greater or equal to zero. This value indicates the number of pixel values that will fall into a particular bin.
+
The Bin Buffer Size is overall size of the image generated. This has no relation to min and max values of the columns used to create the image.
+
The Bin Function is defined as the following: Average - all pixel values that fall into one pixel bin are averaged. Sum - all pixel values that fall into one pixel bin are summed.
+
Bin to Fit Frame will calculate a bin block factor as a power of 2 that will allow the entire data space to be displayed in the current frame.
+
By default, DS9 will bin about the center of the image. To determine the center of the image, DS9 will look for the following keywords in order:

TDMIN/TDMAX TLMIN/TLMAX TALEN AXLEN
-
If no valid keywords are found, DS9 will define the center as -the middle of the possible data space based on the coordinate data -type.
+
If no valid keywords are found, DS9 will define the center as the middle of the possible data space based on the coordinate data type.

diff --git a/ds9/doc/ref/catalog.html b/ds9/doc/ref/catalog.html index 7560b84..4529b3f 100644 --- a/ds9/doc/ref/catalog.html +++ b/ds9/doc/ref/catalog.html @@ -1,126 +1,49 @@ - - - + + + Catalogs - -
Catalogs
+ +
Catalogs

-
DS9 provides full support for loading, displaying, filtering, -and saving catalogs. DS9 allows you to overlay symbols from -multiple catalogs on the current image.
-
Local and on-line catalog access is supported. Most major -catalogs can be retrieved from online servers. Both the CDS and -SDSS catalog servers are now supported. Local catalog files in -starbase (rdb) or CSV (with or without header) are supported.
-
On-line catalogs are available via services provided by the -VizieR catalog access tool, CDS, Strasbourg, France (VizieR is a -joint effort of the Centre de Donnees Astronomiques de Strasbourg -and ESA-ESRIN Information Systems Division) and by the Sloan -Digital Sky Survey.
-
A selection of popular catalogs is provided in the Analysis -menu. In addition, you can search for other catalogs based on -title, keywords, mission, wavelength, and object type.
-
When a catalog is overlayed on an image, each displayed catalog -symbol consists of a shape, color, and text. An advanced symbol -editor is available that allows you to specify the shape, size, -color, and text of each symbol, based on catalog column values. -These symbol expressions can be saved for future use.
-
Along with the overlay display, a catalog list is provided in a -separate window. It displays the column values for each catalog -object. The catalog list can be sorted and filtered, and the -catalog display will be automatically updated. Advanced filtering -options are available. Catalogs can be loaded and saved as local -files in ASCII Starbase format. Each catalog contains header -information which can be displayed. The list can be printed -separately from the image.
-
An interactive connection between the displayed catalog symbols -and the catalog list is provided. When you select one or more rows -within the catalog list, the corresponding symbols are highlighted -on the image display. Conversely, selecting multiple symbols on the -image display will highlight the corresponding rows within the -catalog list. Catalog symbols can be converted to regions for use -with analysis tasks.
+
DS9 provides full support for loading, displaying, filtering, and saving catalogs. DS9 allows you to overlay symbols from multiple catalogs on the current image.
+
Local and on-line catalog access is supported. Most major catalogs can be retrieved from online servers. Both the CDS and SDSS catalog servers are now supported. Local catalog files in starbase (rdb) or CSV (with or without header) are supported.
+
On-line catalogs are available via services provided by the VizieR catalog access tool, CDS, Strasbourg, France (VizieR is a joint effort of the Centre de Donnees Astronomiques de Strasbourg and ESA-ESRIN Information Systems Division) and by the Sloan Digital Sky Survey.
+
A selection of popular catalogs is provided in the Analysis menu. In addition, you can search for other catalogs based on title, keywords, mission, wavelength, and object type.
+
When a catalog is overlayed on an image, each displayed catalog symbol consists of a shape, color, and text. An advanced symbol editor is available that allows you to specify the shape, size, color, and text of each symbol, based on catalog column values. These symbol expressions can be saved for future use.
+
Along with the overlay display, a catalog list is provided in a separate window. It displays the column values for each catalog object. The catalog list can be sorted and filtered, and the catalog display will be automatically updated. Advanced filtering options are available. Catalogs can be loaded and saved as local files in ASCII Starbase format. Each catalog contains header information which can be displayed. The list can be printed separately from the image.
+
An interactive connection between the displayed catalog symbols and the catalog list is provided. When you select one or more rows within the catalog list, the corresponding symbols are highlighted on the image display. Conversely, selecting multiple symbols on the image display will highlight the corresponding rows within the catalog list. Catalog symbols can be converted to regions for use with analysis tasks.

Filter Option
-
The catalog list can be sorted and filtered, and the catalog -display will be automatically updated. A filter is conditional -expression, when evaluated for each row of the catalog, if true, -the row is displayed, and if false, the row is not displayed. The -conditional expression can be any valid TCL expression. The value -of a column may be indicated with $<column -name>.
-
$_RAJ2000>180. && -$_RAJ2000<270.
+
The catalog list can be sorted and filtered, and the catalog display will be automatically updated. A filter is conditional expression, when evaluated for each row of the catalog, if true, the row is displayed, and if false, the row is not displayed. The conditional expression can be any valid TCL expression. The value of a column may be indicated with $<column name>.
+
$_RAJ2000>180. && $_RAJ2000<270.
$Jmag>11
-log($Kmag*10)<.3 [string equal $OTYPE_S -SNR]
+log($Kmag*10)<.3 [string equal $OTYPE_S SNR]

Advanced Symbol Editor
-
An advanced symbol editor is available that allows you to -specify the shape, size, color, and text of each symbol, based on -catalog column values. For each row of the catalog, one or more -conditional expressions are evaluated. For the first expression to -evaluate true, a given symbol is displayed, with the specified -shape, color, size and text properties. As with the filter, the -value of a particular column can be indicated as $<column -name>.
-
For the condition entry, the expression you type in is -automatically evaluated via TCL expr after macro -expansion.
-
-1                               # -always
-0                               # -never
-true                            # -always
-false                           # -never
-$Jmag>2                         # -conditional
-sin($Jmag)>.5 -                  -# conditional
-[string equal $Class -SNR]       # -conditional
-[regexp {*SNR*} -$Class]         # -conditional
-
For the size, size2, and angle entries, the expression you type -in is also automatically evaluated via TCL expr after -macro expansion.
-
-2               # -value of '2' is used
-$Jmag           # -value of column Jmag is used
-$Jmag/2.        # value -of column Jmag div 2 is used
-(4+2)/3         # -value of '2' is used
-
For the text portion, this is not true. It is assumed to be -text, unless you explicitly use an expr operator.
-
-foo             # -will put 'foo' above the symbol
-$Jmag           # -will put the value of column Jmag above the symbol
-(4+2)/3         # -will put the text '(4+2)/3' above the symbol
-[expr (4+2)/3]  # will put the text '2' above the -symbol
-[expr $Jmag/2.] # will take the value of Jmag and div by -2
-
And finally, one special case for shape = text and text = empty. -In this case, the row number is displayed.
+
An advanced symbol editor is available that allows you to specify the shape, size, color, and text of each symbol, based on catalog column values. For each row of the catalog, one or more conditional expressions are evaluated. For the first expression to evaluate true, a given symbol is displayed, with the specified shape, color, size and text properties. As with the filter, the value of a particular column can be indicated as $<column name>.
+
For the condition entry, the expression you type in is automatically evaluated via TCL expr after macro expansion.
+
1                               # always
+0                               # never
+true                            # always
+false                           # never
+$Jmag>2                         # conditional
+sin($Jmag)>.5                   # conditional
+[string equal $Class SNR]       # conditional
+[regexp {*SNR*} $Class]         # conditional
+
For the size, size2, and angle entries, the expression you type in is also automatically evaluated via TCL expr after macro expansion.
+
2               # value of '2' is used
+$Jmag           # value of column Jmag is used
+$Jmag/2.        # value of column Jmag div 2 is used
+(4+2)/3         # value of '2' is used
+
For the text portion, this is not true. It is assumed to be text, unless you explicitly use an expr operator.
+
foo             # will put 'foo' above the symbol
+$Jmag           # will put the value of column Jmag above the symbol
+(4+2)/3         # will put the text '(4+2)/3' above the symbol
+[expr (4+2)/3]  # will put the text '2' above the symbol
+[expr $Jmag/2.] # will take the value of Jmag and div by 2
+
And finally, one special case for shape = text and text = empty. In this case, the row number is displayed.

diff --git a/ds9/doc/ref/colorbar.html b/ds9/doc/ref/colorbar.html index 862c3e2..479081a 100644 --- a/ds9/doc/ref/colorbar.html +++ b/ds9/doc/ref/colorbar.html @@ -1,68 +1,65 @@ - - - - -Color - - -
Colorbar
-
-
Color Tags
-
The purpose of color tags are to highlight (or hide) certain -values of data, regardless of the color map selected. The user -creates, edits, and deletes color tags via the GUI. To create a -color tag, enter the Colorbar Mode, and click once on the colorbar. -This creates a default color tag. Click and drag to change the -values. Click and drag on one side to increase or decrease the -value. Double click to manually edit the values and color. Place -the cursor over the color tag and press the delete key to delete -it. From the color parameters dialog, the user can load, save, and -delete all color tags for that frame.
-
Visuals
-
DS9 supports a number of color environments. Not all color -environments, or visuals, are available on most machines. In fact, -you may be restricted to one or two, base on the color graphics -hardware your computer has. A color visual is composed of two -parts, the color model and the bit depth. Pseudo color uses a color -lookup table to derive the correct color, True color uses the value -directly as a RGB triplet, to derive the correct color. The follow -is a list of the color visuals DS9 currently supports:
-
pseudo color, 8 bit -true color, 8 bit -true color, 15 bit -true color, 16 bit -true color, 24 bit
-
You can use the xdpyinfo command to see if one of these -visual are available. NOTE: Linux Users-- if your desired visual is -not available, use the Xconfigarator command (Red Hat) or similar -command under other versions of linux, to configure your X window -visuals.
-
When DS9 is invoked, by default, it will use the default visual. -You can find out what the default visual is by using the -xdpyinfo command. You can also force DS9 to use another -visual by command line option. If you specify a visual, and it is -not available, DS9 will exit with an error message.
-
-$ds9                      -# default visual, default depth -$ds9 -visual pseudo       # pseudo -color, default depth -$ds9 -visual pseudocolor # pseudo color, default depth -$ds9 -visual pseudocolor8 # pseudo color 8 -$ds9 -visual true         # -true color, default depth -$ds9 -visual truecolor    # true color, default -depth -$ds9 -visual truecolor8   # true color 8 -$ds9 -visual truecolor16 # true color 16 -$ds9 -visual truecolor24 # true color 24
-
- + + + + + Color + + +
Colorbar
+
+
+
Color Tags
+
The purpose of color tags are to highlight (or hide) certain + values of data, regardless of the color map selected. The user + creates, edits, and deletes color tags via the GUI. To create a + color tag, enter the Colorbar Mode, and click once on the + colorbar. This creates a default color tag. Click and drag to + change the values. Click and drag on one side to increase or + decrease the value. Double click to manually edit the values and + color. Place the cursor over the color tag and press the delete + key to delete it. From the color parameters dialog, the user can + load, save, and delete all color tags for that frame.
+
+
Visuals
+
DS9 supports a number of color environments. Not all color + environments, or visuals, are available on most machines. In + fact, you may be restricted to one or two, base on the color + graphics hardware your computer has. A color visual is composed + of two parts, the color model and the bit depth. True color uses + the value directly as a RGB triplet, to derive the correct + color. The follow is a list of the color visuals DS9 currently + supports:
+
true color, 8 bit + true color, 15 bit + true color, 16 bit + true color, 24 bit
+
You can use the xdpyinfo command to see if one of + these visual are available. NOTE: Linux Users-- if your desired + visual is not available, use the Xconfigarator command (Red Hat) + or similar command under other versions of linux, to configure + your X window visuals.
+
When DS9 is invoked, by default, it will use the default + visual. You can find out what the default visual is by using the + xdpyinfo command. You can also force DS9 to use another + visual by command line option. If you specify a visual, and it + is not available, DS9 will exit with an error message.
+
$ds9                      + # default visual, default depth + $ds9 -visual + true         # true + color, default depth + $ds9 -visual truecolor    # true color, default + depth + $ds9 -visual truecolor8   # true color 8 + $ds9 -visual truecolor16 # true color 16 + $ds9 -visual truecolor24 # true color 24
+
+ diff --git a/ds9/doc/ref/contour.html b/ds9/doc/ref/contour.html index 82e0d1c..b18e374 100644 --- a/ds9/doc/ref/contour.html +++ b/ds9/doc/ref/contour.html @@ -1,101 +1,53 @@ - - - + + + Contours - -
Contours
+ +
Contours

-
DS9 can create and display contours as an overlay on an image. -The Analysis Contours menu is used to display contours. To create, -copy, paste, and configure contours, use the Analysis Contour -Parameters menu.
+
DS9 can create and display contours as an overlay on an image. The Analysis Contours menu is used to display contours. To create, copy, paste, and configure contours, use the Analysis Contour Parameters menu.

Contour Parameters
-
When creating a new contour, a dialog box appears, in which the -user selects the number of contour levels, smoothness, and the -distribution of the contours.
+
When creating a new contour, a dialog box appears, in which the user selects the number of contour levels, smoothness, and the distribution of the contours.

Contour Levels
-
Specifies the number of contour levels to be generated. A -typical number is between 1 and 10. Note: large numbers of contours -can take a long time to generate.
+
Specifies the number of contour levels to be generated. A typical number is between 1 and 10. Note: large numbers of contours can take a long time to generate.

Contour Smoothness
-
Specifies how smooth the contours are. A smoothness level of 1 -will evaluate the contour at each image pixel. A level of 2 will -evaluate the contour at every other pixel. The larger the number, -the quicker the contour will be generated, and the less detail will -be available.
+
Specifies how smooth the contours are. A smoothness level of 1 will evaluate the contour at each image pixel. A level of 2 will evaluate the contour at every other pixel. The larger the number, the quicker the contour will be generated, and the less detail will be available.

Contour Scale

Specifies the distribution of the contour levels.

Contour Method
-
There are two methods that are available to calculate the -contour lines. The first, BLOCK, blocks down the image, by the -smoothness factor, before contours are calculated. As a result, the -larger the smoothness, the faster the result. The second method, -SMOOTH, smooths the image before calculating contours. As a result, -the larger the smoothness, the slower the result.
-
Contour -Files
-
A contour file is an ASCII file containing a header, global -properties, coordinate system, contour levels, and contour -points.
+
There are two methods that are available to calculate the contour lines. The first, BLOCK, blocks down the image, by the smoothness factor, before contours are calculated. As a result, the larger the smoothness, the faster the result. The second method, SMOOTH, smooths the image before calculating contours. As a result, the larger the smoothness, the slower the result.
+
Contour Files
+
A contour file is an ASCII file containing a header, global properties, coordinate system, contour levels, and contour points.

Header
-
A DS9 contour file may start with the following optional -header:
-    # Contour file format: DS9 version -7.5
+
A DS9 contour file may start with the following optional header:
+    # Contour file format: DS9 version 7.5

Global Properties
-
Global properties affect all contour levels unless a line level -attribute is specified. The global keyword is first, -followed by a list of keyword = value pairs. Multiple global -property lines may be used within a region file.
-    global color=green width=1 dash=1 dashlist=8 -3
+
Global properties affect all contour levels unless a line level attribute is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file.
+    global color=green width=1 dash=1 dashlist=8 3

Coordinate Systems
-
For each contour file, it is important to specify the coordinate -system used to interpret the contour points, i.e., to set the -context in which the positions are interpreted. For this purpose, -the following keywords are recognized:
-    PHYSICAL    # pixel coords of -original file using LTM/LTV -    IMAGE    # pixel coords of -current file -    FK4,B1950    # sky coordinate -systems -    FK5,J2000    # sky coordinate -systems -    ICRS    # sky coordinate -systems -    GALACTIC    # sky coordinate -systems -    ECLIPTIC    # sky coordinate -systems +For each contour file, it is important to specify the coordinate system used to interpret the contour points, i.e., to set the context in which the positions are interpreted. For this purpose, the following keywords are recognized: +    PHYSICAL    # pixel coords of original file using LTM/LTV +    IMAGE    # pixel coords of current file +    FK4,B1950    # sky coordinate systems +    FK5,J2000    # sky coordinate systems +    ICRS    # sky coordinate systems +    GALACTIC    # sky coordinate systems +    ECLIPTIC    # sky coordinate systems     WCS    # primary WCS     WCSA    # secondary WCS -    LINEAR    # linear primary -WCS +    LINEAR    # linear primary WCS
Contour Level
-
Each contour level is composed of a line value, line attributes -and one or more contours. Line attributes are specified at the -start of a new level and only affect contours within that level -.
-    level=15.78775 color=pink width=2 dash=yes -dashlist=2 2
+
Each contour level is composed of a line value, line attributes and one or more contours. Line attributes are specified at the start of a new level and only affect contours within that level .
+    level=15.78775 color=pink width=2 dash=yes dashlist=2 2

Contour
-
Each contour is composed of one or more X,Y coordinates, with a -deliminator of space or comma, starting with "(" and ending -with ")". Contours are not closed.
+
Each contour is composed of one or more X,Y coordinates, with a deliminator of space or comma, starting with "(" and ending with ")". Contours are not closed.
    (202.4836468 47.22380226    202.4833538 47.2239185    202.4831634 47.22409874 -   202.4829883 -47.22428858)
+   202.4829883 47.22428858)

diff --git a/ds9/doc/ref/file.html b/ds9/doc/ref/file.html index b3f15dc..92e0d42 100644 --- a/ds9/doc/ref/file.html +++ b/ds9/doc/ref/file.html @@ -1,42 +1,33 @@ - - - + + + File Formats - -

File Formats

+ +

File Formats

FITS
FITS Image
FITS Binary Events Table
FITS HEALPIX Table
FITS Data Cube
-FITS Multiple Extension -Data Cube
-FITS Multiple -Extension Multiple Frames
+FITS Multiple Extension Data Cube
+FITS Multiple Extension Multiple Frames
FITS Mosaic
FITS Mosaic Data Cube
FITS RGB
Split FITS
Array
-NRRD
+NRRD
ENVI
GIF
TIFF
JPEG
PNG
External Format Support
-External Analysis -Support
+External Analysis Support
Region Files
Contour Files
Color Lookup Table
@@ -45,9 +36,7 @@ Support
Startup File
TCL

FITS
-DS9 supports FITS images and FITS binary tables. The following -algorithm is used to locate and to load the FITS image or table if -no additional information is provide: +DS9 supports FITS images and FITS binary tables. The following algorithm is used to locate and to load the FITS image or table if no additional information is provide:

Examine primary HDU, if IMAGE, load.
@@ -55,26 +44,20 @@ no additional information is provide:

If IMAGE, load.
-
If BINARY TABLE, create IMAGE if the following is -true:
+
If BINARY TABLE, create IMAGE if the following is true:

FITS COMPRESSED: keyword ZIMAGE is T.
-
FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, -column names X and Y are present.
+
FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, column names X and Y are present.

FITS HEALPIX: keyword PIXTYPE is HEALPIX.

-
If DS9 traverses the entire FITS file without satisfying -one of the above, an error is generated.
+
If DS9 traverses the entire FITS file without satisfying one of the above, an error is generated.

-FITS keyword inheritance is supported. All valid FITS -BITPIX values are supported, along with -16, for -UNSIGNED SHORT. The following FITS keywords are -supported:
+FITS keyword inheritance is supported. All valid FITS BITPIX values are supported, along with -16, for UNSIGNED SHORT. The following FITS keywords are supported:

OBJECT
UNITS
@@ -87,16 +70,7 @@ supported:
WCS keywords
WCS# keywords

FITS Image
-At load time, the user may provide just a file name or a file name -along with FITS extension name/number and image section -specification. FITS extension names are case insensitive. When -specifying an extension, be sure to quote strings correctly to pass -both the shell and DS9 parser. A image section specification is -used to specify the x,y limits of an image subsection. By default, -x and y coordinates are in IMAGE, use a 'p' as -the last character to indicate PHYSICAL coordinates. A -'*' indicates use the default for that axis only. Block is -optional and defaults to 1.
+At load time, the user may provide just a file name or a file name along with FITS extension name/number and image section specification. FITS extension names are case insensitive. When specifying an extension, be sure to quote strings correctly to pass both the shell and DS9 parser. A image section specification is used to specify the x,y limits of an image subsection. By default, x and y coordinates are in IMAGE, use a 'p' as the last character to indicate PHYSICAL coordinates. A '*' indicates use the default for that axis only. Block is optional and defaults to 1.

Syntax: filename @@ -156,28 +130,15 @@ $ds9 foo.fits[10:200,40:100] # image section $ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 $ds9 foo.fits[*,40:100] # only section y axis $ds9 foo.fits[256@512@512] # section box at 512,512 -$ds9 foo.fits[2][100:200,100:200] # second extension, image -section -$ds9 foo.fits[2][100:200,100:200,2] # second extension, image -section, blocked by 2 +$ds9 foo.fits[2][100:200,100:200] # second extension, image section +$ds9 foo.fits[2][100:200,100:200,2] # second extension, image section, blocked by 2 $ds9 foo.fits[10:200,40:100,5:20] # cube section $ds9 foo.fits[*,40:100,5:20] # only section y and z axes $ds9 foo.fits[256@512@512] # section cube at 512,512 -$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube -section -$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube -section, blocked by 2 - FITS Binary Events Table
-
At load time, the user may provide just a file name or a -file name along with FITS extension name/number, image section -specification, and binnng parameters. DS9 will automatically -convert an FITS binary events table into a 2D image for display. -FITS extension names and parameters are case insensitive. The users -may specify a number of parameters on how to construct the image -and how to filter data. When specifying a filter, be sure to quote -strings correctly to pass both the shell and DS9 -parser.

+$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube section
+$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube section, blocked by 2
+
FITS Binary Events Table
+
At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and binnng parameters. DS9 will automatically convert an FITS binary events table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image and how to filter data. When specifying a filter, be sure to quote strings correctly to pass both the shell and DS9 parser.

Syntax: filename filename[ext] @@ -206,9 +167,7 @@ bin: [bin=colz,filter] # bin cols 'x', 'y', and colz with filter [key=colx,coly] [binkey=colx,coly]
-(see Introduction -to Filtering)
+(see Introduction to Filtering)

Example: $ds9 foo.fits # default load @@ -216,33 +175,18 @@ $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' $ds9 foo.fits[bin=detx,dety] # bin on detx,dety $ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy -$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols -rawx,rawy +$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols rawx,rawy $ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi $ds9 foo.fits[bin=pi] # bin on x,y,pi -$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted -filter -$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double -quoted filter -$ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' -and filter

+$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted filter
+$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double quoted filter
+$ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' and filter

-
The shell environment variable DS9_BINKEY may be used -to specify default bin cols for FITS bin tables. Example:
+
The shell environment variable DS9_BINKEY may be used to specify default bin cols for FITS bin tables. Example:
$ export DS9_BINKEY='[bin=rawx,rawy]' $ ds9 foo.fits # load FITS bin table, bin on rawx, rawy
-
FITS -HEALPIX Table
-At load time, the user may provide just a file name or a file name -along with FITS extension name/number, image section specification, -and Healpix parameters. DS9 will automatically convert a FITS -HEALPIX binary or ascii table into a 2D image for display. FITS -extension names and parameters are case insensitive. The users may -specify a number of parameters on how to construct the image. Any -table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as -an HEALPIX image. The following FITS keywords will be used if -present and not overwritten by a command line option: NSIDE, -COORDSYS, ORDER.
+
FITS HEALPIX Table
+At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and Healpix parameters. DS9 will automatically convert a FITS HEALPIX binary or ascii table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image. Any table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as an HEALPIX image. The following FITS keywords will be used if present and not overwritten by a command line option: NSIDE, COORDSYS, ORDER.

Syntax: filename @@ -260,12 +204,8 @@ filename[sect][hpx] filename[ext,hpx] where: -ext: seeFITS -Image -sect: seeFITS -Image +ext: seeFITS Image +sect: seeFITS Image hpx: [order=ring|nested] # default ring @@ -277,123 +217,71 @@ hpx: Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension -$ds9 -foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] - -$ds9 foo.fits[1,order=nested] # first extension, nested -order
-
FITS -Cube
-A FITS Cube is a FITS image which contains more than 2 axes -(NAXES>2). DS9 will automatically detect if a cube is present -and will load all additional images. In addition, individual images -can be loaded one at a time into a cube. DS9 will display the Cube -dialog box which allows the user to select which 2 image to be -displayed. -
FITS Multiple Extension -Cube
-A FITS Multiple Extension Data Cube file is a FITS file with one or -more extensions, that is to be displayed as a data cube. Each image -does not have to be the same size, however, only the coordinate -systems from the first extension will be used for contours and -grids.
+$ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown]
+$ds9 foo.fits[1,order=nested] # first extension, nested order
+
FITS Cube
+A FITS Cube is a FITS image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a cube is present and will load all additional images. In addition, individual images can be loaded one at a time into a cube. DS9 will display the Cube dialog box which allows the user to select which 2 image to be displayed. +
FITS Multiple Extension Cube
+A FITS Multiple Extension Data Cube file is a FITS file with one or more extensions, that is to be displayed as a data cube. Each image does not have to be the same size, however, only the coordinate systems from the first extension will be used for contours and grids.

Example: -$ds9 -mecube foo.fits # load multiple extension fits file as data -cube
-
FITS Multiple Extension -Multiple Frames
-Load a multiple extension FITS file into multiple frames. Please -note that files loaded via standard-in or the xpa fits command can -not be displayed using this method.
+$ds9 -mecube foo.fits # load multiple extension fits file as data cube
+
FITS Multiple Extension Multiple Frames
+Load a multiple extension FITS file into multiple frames. Please note that files loaded via standard-in or the xpa fits command can not be displayed using this method.

Example: -$ds9 -multiframe foo.fits # load multiple extension fits file as -multiple frames
+$ds9 -multiframe foo.fits # load multiple extension fits file as multiple frames

FITS Mosaic
-A FITS mosaic image may exist as a series of FITS files, or as one -FITS file with many extensions. A FITS mosaic may be loaded all a -one time, or by the segment. Once loaded, the multiple FITS images -are treated as one FITS image.
+A FITS mosaic image may exist as a series of FITS files, or as one FITS file with many extensions. A FITS mosaic may be loaded all a one time, or by the segment. Once loaded, the multiple FITS images are treated as one FITS image.

DS9 supports three forms of mosaics: - +
+See NOAO IRAF Mosaic Data Structures
- + - +

IRAF
contains the DETSEC and DETSIZE keywords. -See NOAO -IRAF Mosaic Data Structures

WCS
each FITS image contains a valid -WCS.
each FITS image contains a valid WCS.

HST WFPC2
valid HST WFPC2 data cube, -consisting of 4 planes, along with a fits ascii table containing -wcs information. valid HST WFPC2 data cube, consisting of 4 planes, along with a fits ascii table containing wcs information.

Example: -$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits -file with multiple exts -$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf -from 3 files -$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file -with multiple exts -$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from -3 files +$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits file with multiple exts +$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf from 3 files +$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file with multiple exts +$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from 3 files $ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic -$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 -files
-
FITS -Mosaic Data Cube
-A FITS Mosaic Data Cube is a FITS mosaic image which contains more -than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic -data cube is present and will load all additional images. At the -same time, DS9 will display the data cube dialog box which allows -the user to select which 2 image to be displayed. +$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 files
+
FITS Mosaic Data Cube
+A FITS Mosaic Data Cube is a FITS mosaic image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic data cube is present and will load all additional images. At the same time, DS9 will display the data cube dialog box which allows the user to select which 2 image to be displayed.
FITS RGB
-A FITS RGB image may exist as three of FITS images, one FITS file -with three extensions, or as a FITS 3D Data cube, with three -slices, each representing the red, green, and blue channel. A FITS -RGB image may be loaded all a one time, or by the channel. Once -loaded, the multiple FITS images are treated as one FITS image.
+A FITS RGB image may exist as three of FITS images, one FITS file with three extensions, or as a FITS 3D Data cube, with three slices, each representing the red, green, and blue channel. A FITS RGB image may be loaded all a one time, or by the channel. Once loaded, the multiple FITS images are treated as one FITS image.

Example: -$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits -file with 3 image exts -$ds9 -rgbcube cube.fits # load rgb image consisting of one fits -data cube -$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image -from 3 fits images
+$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts
+$ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube
+$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images

Split FITS
-A split fits is a valid fits file in which two files contain the -header and data segments. +A split fits is a valid fits file in which two files contain the header and data segments.
Array
-Raw data arrays are supported. To load an array, the user must -provide the dimensions, pixel depth, and optional header size and -architecture type. +Raw data arrays are supported. To load an array, the user must provide the dimensions, pixel depth, and optional header size and architecture type.
Syntax: filename[arr] filename[arr][sect] filename[sect][arr]
where
-sect: see FITS -Image +sect: see FITS Image arr:
xdim=value ydim=value @@ -404,15 +292,11 @@ arr: skip=value # must be even, most must be factor of 4
arch|endian=[big|bigendian|little|littleendian]
Example: -$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load -512x512 short -$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float -with 4 byte head -$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 -long, intel +$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load 512x512 short
+$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float with 4 byte head
+$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 long, intel

or alternate format:
filename[array(<type><dim><:skip><endian>)] - where: type: @@ -429,56 +313,42 @@ type: int.int # x,y dim
int.int.int # x,y,z dim
skip: -
int     # number of bytes to -skip
+
int     # number of bytes to skip
endian:
'l' little endian 'b' big endian
Example: -$ds9 -array bar.arr[array(s512)]   # load 512x512 -short -$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte -head -$ds9 -array bar.arr[array(i512l)] # load 512x512 long, -intel -
The shell environment variable DS9_ARRAY may be used to -specify default array parameters.
+$ds9 -array bar.arr[array(s512)]   # load 512x512 short
+$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte head
+$ds9 -array bar.arr[array(i512l)] # load 512x512 long, intel +
The shell environment variable DS9_ARRAY may be used to specify default array parameters.
Example: $export DS9_ARRAY='[dim=256,bitpix=-32]' $ds9 -array foo.arr # load 256x256 float

NRRD (Nearly Raw Raster -Data)

-Images in NRRD are supported directly. Encodings supported: -raw, gzip
+

NRRD (Nearly Raw Raster Data)

+Images in NRRD are supported directly. Encodings supported: raw, gzip
Syntax: filename
filename[sect]

where:
-sect: see FITS -Image
+sect: see FITS Image
Example:
$ds9 -nrrd foo.nrrd
$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped

ENVI

-Images in ENVI are supported directly. Encodings supported: BIL, -BIP, BSQ.
+Images in ENVI are supported directly. Encodings supported: BIL, BIP, BSQ.
Syntax:
filename
filename[sect]

where:
-sect: see FITS -Image
+sect: see FITS Image

Example:
$ds9 -envi foo.hdr foo.bsq
$ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped

GIF

-Images in GIF are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly.
+Images in GIF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
Syntax: filename @@ -486,9 +356,7 @@ filename Example: $ ds9 -gif foo.gif

TIFF

-Images in TIFF are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly.
+Images in TIFF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.

Syntax: filename @@ -496,9 +364,7 @@ filename Example: $ ds9 -tiff foo.tiff

JPEG

-Images in JPEG are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly.
+Images in JPEG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
Syntax: filename @@ -506,40 +372,25 @@ filename Example: $ ds9 -jpeg foo.jpeg

PNG

-Images in PNG are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly.
+Images in PNG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.

Syntax: filename Example: $ ds9 -png foo.png
-

External File Support

-DS9 supports external file formats via an ASCII description file. -When loading a file into DS9, these descriptions are referenced for -instructions for loading the file, based on the file extension. If -found, the command is executed and the result, a FITS image or FITS -Binary Table, is read into DS9 via stdin.
-At start-up, DS9 first searches for the ASCII file, named -.ds9.filin the local directory, then in the users home -directory.
-The file command first is macro-expanded to fill in user-defined -arguments and then is executed externally.
-The ASCII file that defines the known image files consists of one -or more file descriptors, each of which has the following -format:
+

External File Support

+DS9 supports external file formats via an ASCII description file. When loading a file into DS9, these descriptions are referenced for instructions for loading the file, based on the file extension. If found, the command is executed and the result, a FITS image or FITS Binary Table, is read into DS9 via stdin.
+At start-up, DS9 first searches for the ASCII file, named .ds9.filin the local directory, then in the users home directory.
+The file command first is macro-expanded to fill in user-defined arguments and then is executed externally.
+The ASCII file that defines the known image files consists of one or more file descriptors, each of which has the following format:

Help description
A space-separated list of templates
-A space-separated list of file types (not currently -used)
+A space-separated list of file types (not currently used)
The command line for the loading this file type

-Note that blank lines separate the file descriptions and should not -be used as part of a description. Also, the '#' character is a -comment character.
+Note that blank lines separate the file descriptions and should not be used as part of a description. Also, the '#' character is a comment character.

The following macros are supported: $filename

@@ -553,70 +404,43 @@ The following macros are supported: $filename
*.imh
IMH
i2f -s $filename
-

External Analysis Support

-For more information about external analysis support files, see -Analysis. -

Region -Files

-DS9 can read and write a number of region file formats. See -Regions documentation for more -information.
+

External Analysis Support

+For more information about external analysis support files, see Analysis. +

Region Files

+DS9 can read and write a number of region file formats. See Regions documentation for more information.

DS9
FUNTools
Ciao
SAOimage
IRAF PROS
-FITS REGION Binary -Table
+FITS REGION Binary Table
X Y
-

Contour -Files

-See Contours documentation for more -information.
-

Color -Lookup Table

-DS9 has a number of default colormaps available to the user. DS9 -also supports reading and writing color lookup table formats from -the following programs:
+

Contour Files

+See Contours documentation for more information.
+

Color Lookup Table

+DS9 has a number of default colormaps available to the user. DS9 also supports reading and writing color lookup table formats from the following programs:

SAOimage
SAOtng
XImtool

-DS9 uses the file extension to determine the color table -format:
+DS9 uses the file extension to determine the color table format:

.lut # XImtool, SAOtng .sao # DS9, SAOImage

WCS

-A new WCS specification can be loaded and used by the current image -regardless of the WCS that was contained in the image file. WCS -specification can be sent to DS9 as an ASCII file via XPA. The -format of the specification is a set of valid FITS keywords that -describe a WCS.
-
-CRPIX1 -=               -257.75
-CRPIX2 -=               -258.93
-CRVAL1 =      --201.94541667302
-CRVAL2 -=             --47.45444
-CDELT1 =        --2.1277777E-4
-CDELT2 =         -2.1277777E-4
+A new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. WCS specification can be sent to DS9 as an ASCII file via XPA. The format of the specification is a set of valid FITS keywords that describe a WCS.
+
+CRPIX1 =               257.75
+CRPIX2 =               258.93
+CRVAL1 =      -201.94541667302
+CRVAL2 =             -47.45444
+CDELT1 =        -2.1277777E-4
+CDELT2 =         2.1277777E-4
CTYPE2 = 'DEC--TAN'

-Note that the WCS definitions can contain standard FITS 80 -character WCS card images, as shown above, or free-form name/value -pairs without the intervening "=" sign:
+Note that the WCS definitions can contain standard FITS 80 character WCS card images, as shown above, or free-form name/value pairs without the intervening "=" sign:

CRPIX1    257.75
CRPIX2    258.93
@@ -627,26 +451,12 @@ pairs without the intervening "=" sign:
CTYPE1   'RA---TAN'
CTYPE2   'DEC--TAN'

-
Preference -File
-A preference file is a valid tcl script generated by DS9 to save -the current preference items. See Preferences for more information. -
Startup -File
-If a startup file $HOME/ds9.ini is available, it is -sourced as the last step in initialization. The file permissions -must be group/world readonly.
-Users may have several different startup files. DS9 looks for a -startup file with its own name. By default, if the application is -named ds9, it will look for .ds9.ini. However, if -the DS9 application is named foo, then DS9 will look for -.foo.ini. In this manner, the user can have several -predefined startup files that are activated by invoking DS9 with a -different application names.
+
Preference File
+A preference file is a valid tcl script generated by DS9 to save the current preference items. See Preferences for more information. +
Startup File
+If a startup file $HOME/ds9.ini is available, it is sourced as the last step in initialization. The file permissions must be group/world readonly.
+Users may have several different startup files. DS9 looks for a startup file with its own name. By default, if the application is named ds9, it will look for .ds9.ini. However, if the DS9 application is named foo, then DS9 will look for .foo.ini. In this manner, the user can have several predefined startup files that are activated by invoking DS9 with a different application names.

TCL
-TCL/TK script file. Users may customize the appearance and enhance -the capabilities of DS9 by sourcing their own TCL -scripts.

+TCL/TK script file. Users may customize the appearance and enhance the capabilities of DS9 by sourcing their own TCL scripts. diff --git a/ds9/doc/ref/grid.html b/ds9/doc/ref/grid.html index 9ca2f17..e660006 100644 --- a/ds9/doc/ref/grid.html +++ b/ds9/doc/ref/grid.html @@ -1,89 +1,39 @@ - - - + + + Coordinate Grids - -

Coordinate Grids

+ +

Coordinate Grids

-
DS9 can create and display coordinate grids as an overlay on an -image. The Display Coordinate Grid Menu is used to display grids. A -coordinate grid is composed of Grid Lines, Axes, Border, and Title. -Axes include tick marks, title, and numbers. The appearance of the -coordinate grid is specified by parameters. These parameters may be -configured via the Coordinate Grid Parameters dialog box. In -addition to the axes titles and the grid title, the following menus -are available.
+
DS9 can create and display coordinate grids as an overlay on an image. The Display Coordinate Grid Menu is used to display grids. A coordinate grid is composed of Grid Lines, Axes, Border, and Title. Axes include tick marks, title, and numbers. The appearance of the coordinate grid is specified by parameters. These parameters may be configured via the Coordinate Grid Parameters dialog box. In addition to the axes titles and the grid title, the following menus are available.

Numeric Formats
-
The user may specify custom numeric formats for either axes. The -format specification can be empty (default) or a print function, -based on the selected coordinate system:
+
The user may specify custom numeric formats for either axes. The format specification can be empty (default) or a print function, based on the selected coordinate system:

image
physical
detector
amplifier
wcs linear
wcs equatorial
-
The format specification string to be passed to the C "printf" -function (e.g. "%%1.7G") in order to format a single coordinate -value.
-
The Format string supplied should contain one or more of the -following characters. These may occur in any order, but the -following is recommended for clarity:
-
"": Indicates that a plus sign should be prefixed to -positive values. By default, no plus sign is used.
-"z": Indicates that leading zeros should be prefixed to the value -so that the first field is of constant width, as would be required -in a fixed-width table (leading zeros are always prefixed to any -fields that follow). By default, no leading zeros are added.
-"i": Use the standard ISO field separator (a colon) between fields. -This is the default behaviour.
+
The format specification string to be passed to the C "printf" function (e.g. "%%1.7G") in order to format a single coordinate value.
+
The Format string supplied should contain one or more of the following characters. These may occur in any order, but the following is recommended for clarity:
+
"": Indicates that a plus sign should be prefixed to positive values. By default, no plus sign is used.
+"z": Indicates that leading zeros should be prefixed to the value so that the first field is of constant width, as would be required in a fixed-width table (leading zeros are always prefixed to any fields that follow). By default, no leading zeros are added.
+"i": Use the standard ISO field separator (a colon) between fields. This is the default behaviour.
"b": Use a blank to separate fields.
-"l": Use a letter ("h"/"d", "m" or "s" as appropriate) to separate -fields.
-"g": Use a letter and symbols to separate fields ("h"/"d", "m" or -"s", etc, as appropriate), but include escape sequences in the -formatted value so that the Plot class will draw the separators as -small super-scripts.
-"d": Include a degrees field. Expressing the angle purely in -degrees is also the default if none of "h", "m", "s" or "t" are -given.
-"h": Express the angle as a time and include an hours field (where -24 hours correspond to 360 degrees). Expressing the angle purely in -hours is also the default if "t" is given without either "m" or -"s".
+"l": Use a letter ("h"/"d", "m" or "s" as appropriate) to separate fields.
+"g": Use a letter and symbols to separate fields ("h"/"d", "m" or "s", etc, as appropriate), but include escape sequences in the formatted value so that the Plot class will draw the separators as small super-scripts.
+"d": Include a degrees field. Expressing the angle purely in degrees is also the default if none of "h", "m", "s" or "t" are given.
+"h": Express the angle as a time and include an hours field (where 24 hours correspond to 360 degrees). Expressing the angle purely in hours is also the default if "t" is given without either "m" or "s".
"m": Include a minutes field. By default this is not included.
-"s": Include a seconds field. By default this is not included. This -request is ignored if "d" or "h" is given, unless a minutes field -is also included.
-"t": Express the angle as a time (where 24 hours correspond to 360 -degrees). This option is ignored if either "d" or "h" is given and -is intended for use where the value is to be expressed purely in -minutes and/or seconds of time (with no hours field). If "t" is -given without "d", "h", "m" or "s" being present, then it is -equivalent to "h".
-".": Indicates that decimal places are to be given for the final -field in the formatted string (whichever field this is). The "." -should be followed immediately by an unsigned integer which gives -the number of decimal places required, or by an asterisk. If an -asterisk is supplied, a default number of decimal places is used -which is based on the value of the Digits -attribute.
-
All of the above format specifiers are case-insensitive. If -several characters make conflicting requests (e.g. if both "i" and -"b" appear), then the character occurring last takes precedence, -except that "d" and "h" always override "t".
-
The default formats are d.3 for degrees and -hms.1 / dms.1 / ldms.1 for -sexagesimal.
+"s": Include a seconds field. By default this is not included. This request is ignored if "d" or "h" is given, unless a minutes field is also included.
+"t": Express the angle as a time (where 24 hours correspond to 360 degrees). This option is ignored if either "d" or "h" is given and is intended for use where the value is to be expressed purely in minutes and/or seconds of time (with no hours field). If "t" is given without "d", "h", "m" or "s" being present, then it is equivalent to "h".
+".": Indicates that decimal places are to be given for the final field in the formatted string (whichever field this is). The "." should be followed immediately by an unsigned integer which gives the number of decimal places required, or by an asterisk. If an asterisk is supplied, a default number of decimal places is used which is based on the value of the Digits attribute.
+
All of the above format specifiers are case-insensitive. If several characters make conflicting requests (e.g. if both "i" and "b" appear), then the character occurring last takes precedence, except that "d" and "h" always override "t".
+
The default formats are d.3 for degrees and hms.1 / dms.1 / ldms.1 for sexagesimal.

diff --git a/ds9/doc/ref/how.html b/ds9/doc/ref/how.html index eb8f966..8786176 100644 --- a/ds9/doc/ref/how.html +++ b/ds9/doc/ref/how.html @@ -1,18 +1,13 @@ - - - + + + How - -

How it Works

+ +

How it Works

Table of Contents
How DS9 Renders an Image
@@ -21,136 +16,66 @@ Contours
Large Files

How DS9 renders an image
-
Here is a short description on how DS9 decides to paint a pixel -a color on the the screen, give an data value... you need a color -scale, a contrast/bias pair for the colorscale, clip values for the -data, a scale distribution, and finally, the value of the pixel in -question.
+
Here is a short description on how DS9 decides to paint a pixel a color on the the screen, give an data value... you need a color scale, a contrast/bias pair for the colorscale, clip values for the data, a scale distribution, and finally, the value of the pixel in question.

-
Step 1. Select a color scale. A color scale is defined as a -number of colors (RGB triplets). The number of RGB triplets can -vary from just a few to over 200. DS9 contains a number of -predefined color scales (Gray, A, B, I8, ...) or the user may load -his own color scale.
-
Step 2. Apply a contrast/bias pair. This step takes the result -of step 1 and creates a new array with the contrast/bias applied. -The length of the new array will between 200 (for pseudocolor) and -4096 (for truecolor).
-
Step 3. Calculate the data clip values (low/high data values). -The min/max data values may be used or an algorithm may be used to -determine the clip data values.
-
Step 4. Apply the scale distribution. This involves taking the -result of step 2, and creating yet another array, this time of size -16384, redistributing the colors, based on the scale algorithm -selected (see Scales).
-
Step 5. Based on your data clip values, and the value of the -pixel you have, index into the result of step 4, and you have an -index into lookup table (for pseudocolor) and an RGB pair (for -truecolor and postscript).
+
Step 1. Select a color scale. A color scale is defined as a number of colors (RGB triplets). The number of RGB triplets can vary from just a few to over 200. DS9 contains a number of predefined color scales (Gray, A, B, I8, ...) or the user may load his own color scale.
+
Step 2. Apply a contrast/bias pair. This step takes the result of step 1 and creates a new array with the contrast/bias applied. The length of the new array will between 200 (for pseudocolor) and 4096 (for truecolor).
+
Step 3. Calculate the data clip values (low/high data values). The min/max data values may be used or an algorithm may be used to determine the clip data values.
+
Step 4. Apply the scale distribution. This involves taking the result of step 2, and creating yet another array, this time of size 16384, redistributing the colors, based on the scale algorithm selected (see Scales).
+
Step 5. Based on your data clip values, and the value of the pixel you have, index into the result of step 4, and you have an index into lookup table (for pseudocolor) and an RGB pair (for truecolor and postscript).

Scales

The log function is defined as the following:

-
+

-
as x goes from 0 to 1. The user may specify an exponent -a to change the distribution of colors within the colorbar. -The default value of a is 1000. Typically, optical images -respond well at 1000, IR images as low as 100, and high energy bin -tables up to 10000. A value of 10000 closely matches the -log function of SAOImage as defined as the -following:
+
as x goes from 0 to 1. The user may specify an exponent a to change the distribution of colors within the colorbar. The default value of a is 1000. Typically, optical images respond well at 1000, IR images as low as 100, and high energy bin tables up to 10000. A value of 10000 closely matches the log function of SAOImage as defined as the following:

-
+

The pow function is defined as the following:

-
+

-
as x goes from 0 to 1. The user may specify an exponent -a to change the distribution of colors within the colorbar. -The default value of a is 1000.
-
The sqrt scale function is defined as the -following:
-

+
as x goes from 0 to 1. The user may specify an exponent a to change the distribution of colors within the colorbar. The default value of a is 1000.
+
The sqrt scale function is defined as the following:
+

as x goes from 0 to 1.
-
The square scale function is defined as the -following:
-

+
The square scale function is defined as the following:
+

as x goes from 0 to 1.
-
The asinh scale function is defined as the -following:
-

+
The asinh scale function is defined as the following:
+

as x goes from 0 to 1.
-
The sinh scale function is defined as the -following:
-

+
The sinh scale function is defined as the following:
+

as x goes from 0 to 1.
-
The histogram equalization scale function distributes -colors based on the frequency of each data value.
+
The histogram equalization scale function distributes colors based on the frequency of each data value.

Smoothing
-
The user may select one of three types of smoothing kernels. Two -parameters, r (radius) and k -(kernel size), are defined as the following:
-
Kernel width/height = 2k+1 with r -<= k
+
The user may select one of three types of smoothing kernels. Two parameters, r (radius) and k (kernel size), are defined as the following:
+
Kernel width/height = 2k+1 with r <= k
Boxcar function, width = 2r+1
Tophat function, where the diameter = 2r+1
Gaussian function, defined as: -

+

where the mean = 0 and sigma = r/2

Contours
-
The contour algorithm is from an unknown author and originally -came from FV. The difference between the two modes -are:
-
block : the image is blocked down before the -contour is generated
-smooth : the image is smoothed via a Gaussian kernel -before the contour is generated.
-
block mode is faster as the smoothing parameter -increases. Inversely, smooth mode is much slower as the -smoothing parameter increases.
+
The contour algorithm is from an unknown author and originally came from FV. The difference between the two modes are:
+
block : the image is blocked down before the contour is generated
+smooth : the image is smoothed via a Gaussian kernel before the contour is generated.
+
block mode is faster as the smoothing parameter increases. Inversely, smooth mode is much slower as the smoothing parameter increases.

Large Files
-There are several factors that determine if DS9 will be able to -load a large file.
-
32 bit OS vs 64 bit OS : to address very large files, you may -need to use an 64 bit OS with a 64bit version of DS9. 32bit apps -can address up to 4Gb of address space. However, depending on the -OS, this limit may be less. Linux for example, the limit appears to -be ~3GB (the OS and shared libs eat up a lot of address space). -Under 64bit Solaris, 32bit ds9 has a full 4Gb of space. MacOSX -appears to have a limit ~3Gb. Under windows, ~2Gb.
-
Large File Support: is the ability to sequence thru files larger -than 4Gb. DS9 is compiled with LFS.
-
File system: the OS file system must be able to support files -larger than 4Gb. Most recent file systems fully support -4GB>.
-
Memory Management: There are a number of memory management -techniques supported in DS9 that will greatly affect the ability -and speed of loading large files:
+There are several factors that determine if DS9 will be able to load a large file.
+
32 bit OS vs 64 bit OS : to address very large files, you may need to use an 64 bit OS with a 64bit version of DS9. 32bit apps can address up to 4Gb of address space. However, depending on the OS, this limit may be less. Linux for example, the limit appears to be ~3GB (the OS and shared libs eat up a lot of address space). Under 64bit Solaris, 32bit ds9 has a full 4Gb of space. MacOSX appears to have a limit ~3Gb. Under windows, ~2Gb.
+
Large File Support: is the ability to sequence thru files larger than 4Gb. DS9 is compiled with LFS.
+
File system: the OS file system must be able to support files larger than 4Gb. Most recent file systems fully support 4GB>.
+
Memory Management: There are a number of memory management techniques supported in DS9 that will greatly affect the ability and speed of loading large files:

$ ds9 foo.fits # uses mmap
$ cat foo.fits | ds9 - # allocates memory
$ xpaset -p ds9 file foo.fits # uses mmap
-$ xpaset -p ds9 fits foo.fits # allocates -memory
-
Memory Map (mmap) is very fast, limit is memory address -space (see above). Allocate is very slow, limit is amount of -physical memory + swap partition.
-
Scanning Data: DS9 needs to determine the min and max data -values to correctly display your image. For large files, such as -Mosaics and Data Cubes, this can take time. You have the -option of using using the FITS keywords DATAMIN/MAX or IRAFMIN/MAX -- great if present, bad because they are always wrong. Another -option is to specify the low and high clip values via the command -line or Scale dialogbox.
+$ xpaset -p ds9 fits foo.fits # allocates memory
+
Memory Map (mmap) is very fast, limit is memory address space (see above). Allocate is very slow, limit is amount of physical memory + swap partition.
+
Scanning Data: DS9 needs to determine the min and max data values to correctly display your image. For large files, such as Mosaics and Data Cubes, this can take time. You have the option of using using the FITS keywords DATAMIN/MAX or IRAFMIN/MAX - great if present, bad because they are always wrong. Another option is to specify the low and high clip values via the command line or Scale dialogbox.

diff --git a/ds9/doc/ref/index.html b/ds9/doc/ref/index.html index db6d624..ec89c37 100644 --- a/ds9/doc/ref/index.html +++ b/ds9/doc/ref/index.html @@ -1,87 +1,47 @@ - - - + + + Reference Manual - -

SAOImageDS9 Reference Manual

+ +

SAOImageDS9 Reference Manual

-
DS9 is the next version of the popular SAOtng display program. -It is a Tk/Tcl application which utilizes the TkSAO widget set. It -also incorporates the new X Public Access (XPA) mechanism to allow -external processes to access and control its data, GUI functions, -and algorithms. DS9 supports the direct display of FITS -images and binary tables, multiple frame buffers, region cursor -manipulation, many scale algorithms and colormaps, and easy -communication with external analysis tasks. It is highly -configurable and extensible to meet the evolving needs of the -astronomical community.
-
DS9 supports advanced features such as multiple frame buffers, -mosaic images, tiling, blinking, geometric markers, colormap -manipulation, scaling, arbitrary zoom, rotation, pan, and a variety -of coordinate systems (including Image, Physical, Detector, and -WCS). DS9 also supports FTP and HTTP access. The GUI for DS9 is -user configurable.
- +
DS9 is the next version of the popular SAOtng display program. It is a Tk/Tcl application which utilizes the TkSAO widget set. It also incorporates the new X Public Access (XPA) mechanism to allow external processes to access and control its data, GUI functions, and algorithms. DS9 supports the direct display of FITS images and binary tables, multiple frame buffers, region cursor manipulation, many scale algorithms and colormaps, and easy communication with external analysis tasks. It is highly configurable and extensible to meet the evolving needs of the astronomical community.
+
DS9 supports advanced features such as multiple frame buffers, mosaic images, tiling, blinking, geometric markers, colormap manipulation, scaling, arbitrary zoom, rotation, pan, and a variety of coordinate systems (including Image, Physical, Detector, and WCS). DS9 also supports FTP and HTTP access. The GUI for DS9 is user configurable.
+
- - - + + + - - - + + + - - - + + + - - - + + + - - - + + + - - - + + +

How It -Works Backup and -Restore File -Formats How It Works Backup and Restore File Formats

Mouse -and Keyboard Coordinate -Grids Preferences Mouse and Keyboard Coordinate Grids Preferences

Command -Line Options Catalogs 3-D -Frames Command Line Options Catalogs 3-D Frames

XPA Access -Points Colorbar
Contours XPA Access Points Colorbar
Contours

SAMP
Printing IRAF -Support SAMP
Printing IRAF Support

Regions Analysis Binning
Regions Analysis Binning

diff --git a/ds9/doc/ref/iraf.html b/ds9/doc/ref/iraf.html index a789f29..b516a22 100644 --- a/ds9/doc/ref/iraf.html +++ b/ds9/doc/ref/iraf.html @@ -1,36 +1,18 @@ - - - + + + IRAF Support - -
IRAF Support
+ +
IRAF Support

-
DS9 is a fully functional IRAF image display server. IRAF uses -the IIS protocol to communicate with a valid image display server, -such as DS9, ximtool, saoimage, and saotng. With DS9, no special -scripts are needed. If you have one of the above currently working, -DS9 works right out of the box. And DS9 now supports -IRAF's new IIS image display protocol that supports up to 16 -display frames.
-
All native DS9 functions may be used with images load with IRAF -display except for the Scale menu items. Values displayed -may the the true values, if a linear scale is specified with the -display command. Otherwise, the value is a scaled value. -DS9 supports IRAF in all display visuals including -Truecolor. Support full postscript printing of images -loaded from IRAF is provided.
+
DS9 is a fully functional IRAF image display server. IRAF uses the IIS protocol to communicate with a valid image display server, such as DS9, ximtool, saoimage, and saotng. With DS9, no special scripts are needed. If you have one of the above currently working, DS9 works right out of the box. And DS9 now supports IRAF's new IIS image display protocol that supports up to 16 display frames.
+
All native DS9 functions may be used with images load with IRAF display except for the Scale menu items. Values displayed may the the true values, if a linear scale is specified with the display command. Otherwise, the value is a scaled value. DS9 supports IRAF in all display visuals including Truecolor. Support full postscript printing of images loaded from IRAF is provided.

Command Line Arguments
-
As with ximtool, the follow command line arguments may be -used to specify the communication parameters:
+
As with ximtool, the follow command line arguments may be used to specify the communication parameters:

fifo fifo_only inet_only @@ -43,18 +25,9 @@ used to specify the communication parameters: port 5137 unix /tmp/.IMT%d

Configuration
-
An IRAF image server uses a configuration file to specify -the number of available buffers and their sizes. What actually -passes from IRAF is not the buffer size, but an index number into -this file.
-
So when an image server starts (DS9), it will attempt to locate -this file as $HOME/.imtoolrc and -/usr/local/lib/imtoolrc. If not found, it will look for -shell environment variables IMTOOLRC and -imtoolrc, that contains the name of the configuration -file.
-
If no configuration file is found, DS9 will assume the following -default configuration:
+
An IRAF image server uses a configuration file to specify the number of available buffers and their sizes. What actually passes from IRAF is not the buffer size, but an index number into this file.
+
So when an image server starts (DS9), it will attempt to locate this file as $HOME/.imtoolrc and /usr/local/lib/imtoolrc. If not found, it will look for shell environment variables IMTOOLRC and imtoolrc, that contains the name of the configuration file.
+
If no configuration file is found, DS9 will assume the following default configuration:

1 2 512 512 # imt1|imt512 2 2 800 800 # imt2|imt800 3 2 1024 1024 # imt3|imt1024 @@ -64,8 +37,7 @@ default configuration: 7 1 8192 8192 # imt7|imt8192 8 1 1024 4096 # imt8|imt1x4 9 2 1144 880 # imt9|imtfs full screen (1152x900 minus frame) -10 2 1144 764 # imt10|imtfs35 full screen at 35mm film aspect -ratio +10 2 1144 764 # imt10|imtfs35 full screen at 35mm film aspect ratio 11 2 128 128 # imt11|imt128 12 2 256 256 # imt12|imt256 13 2 128 1056 # imt13|imttall128 tall & narrow for spectro. @@ -75,69 +47,30 @@ ratio 17 2 1008 648 # imt17|imtssy Solitaire fmt w/ imtool border 18 2 1024 680 # imt18|imtssn Solitaire fmt w/out imtool border 19 1 4096 1024 # imt19|imt4x1
-
If on the other hand, IRAF assumes a different buffer size, the -image will appear corrupted and DS9 may issue a number of error -messages.
-
Another problem is that this file must be in sync with -dev$graphcap. If your system administrator has made -changes to graphcap, they must also be implemented in -imtoolrc.
+
If on the other hand, IRAF assumes a different buffer size, the image will appear corrupted and DS9 may issue a number of error messages.
+
Another problem is that this file must be in sync with dev$graphcap. If your system administrator has made changes to graphcap, they must also be implemented in imtoolrc.

Here is a note from NOAO:

-
The messages means that there is no /usr/local/lib/imtoolrc -file on the machine. This is created as a symlink to dev$imtoolrc -by the iraf install script but only if the /usr/local/lib dir -already exists on the machine. The fix is the create the dir and -rerun the install script or else make the link by hand. Users can -also just copy dev$imtoolrc to $HOME/.imtoolrc and restart the -server to also workaround it. Note that an existing .imtoolrc might -define old frame buffer configs which might confuse things, so if -the system file exists check for a private copy screwing things -up.
+
The messages means that there is no /usr/local/lib/imtoolrc file on the machine. This is created as a symlink to dev$imtoolrc by the iraf install script but only if the /usr/local/lib dir already exists on the machine. The fix is the create the dir and rerun the install script or else make the link by hand. Users can also just copy dev$imtoolrc to $HOME/.imtoolrc and restart the server to also workaround it. Note that an existing .imtoolrc might define old frame buffer configs which might confuse things, so if the system file exists check for a private copy screwing things up.

Windows DS9 and IRAF
-
To direct image output from IRAF to DS9 running under windows, -use the IMTDEV environment variable. For example, if the -windows machine is named 'foo.bar.edu', define IMTDEV to -the follow value before entering IRAF.
+
To direct image output from IRAF to DS9 running under windows, use the IMTDEV environment variable. For example, if the windows machine is named 'foo.bar.edu', define IMTDEV to the follow value before entering IRAF.

$ setenv IMTDEV inet:5137:foo.bar.edu $ cl cl> display dev$pix

Scale Menu Disabled
-
When you display an image from IRAF into DS9, IRAF -actually does the color scale distribution. In Display, -use the ztrans and z1,z2zscale -parameter to auto determine z1,z2. Here are the -DISPLAY parameters in question: parameters to set the -upper/lower bounds and distribution. You can also use the
+
When you display an image from IRAF into DS9, IRAF actually does the color scale distribution. In Display, use the ztrans and z1,z2zscale parameter to auto determine z1,z2. Here are the DISPLAY parameters in question: parameters to set the upper/lower bounds and distribution. You can also use the

ztrans=[linear|log|none|user] z1=min z2=max zscale=[yes|no]
-
What actually is sent from IRAF to DS9 is one byte per -pixel, values 0-200, which already has applied both the upper and -lower clipping bounds and the distribution. So this is why, the -SCALE menu is disabled in DS9 when it receives a image -from IRAF.
+
What actually is sent from IRAF to DS9 is one byte per pixel, values 0-200, which already has applied both the upper and lower clipping bounds and the distribution. So this is why, the SCALE menu is disabled in DS9 when it receives a image from IRAF.

MSCRED/MSCZERO
-
DS9 now supports IRAF's new IIS image display protocol. However, -there is one minor problem with the mscred task -msczero. Before using msczero, issue the following -command in the cl:
+
DS9 now supports IRAF's new IIS image display protocol. However, there is one minor problem with the mscred task msczero. Before using msczero, issue the following command in the cl:

cl> set disable_wcs_maps="" cl> flpr

IMEXAMINE
-
Due to the unique relationship between DS9 and IRAF, if you use -the imexamine task, you can take advantage of a special -feature of DS9. Instead of loading the image from IRAF with the -display task, load the image directly into DS9. Then, from -the cl prompt, invoke imexamine without a filename. -IRAF will ask DS9 for the current filename and use it for analysis. -This approach provides several advantages over previous methods. -First, it will work with compound fits images such as mosaics, data -cubes, and rgb images. Second, the image displays includes true -image data and WCS information, not the approximated data from -IRAF.
+
Due to the unique relationship between DS9 and IRAF, if you use the imexamine task, you can take advantage of a special feature of DS9. Instead of loading the image from IRAF with the display task, load the image directly into DS9. Then, from the cl prompt, invoke imexamine without a filename. IRAF will ask DS9 for the current filename and use it for analysis. This approach provides several advantages over previous methods. First, it will work with compound fits images such as mosaics, data cubes, and rgb images. Second, the image displays includes true image data and WCS information, not the approximated data from IRAF.

diff --git a/ds9/doc/ref/keyboard.html b/ds9/doc/ref/keyboard.html index 594ca03..bcb79c4 100644 --- a/ds9/doc/ref/keyboard.html +++ b/ds9/doc/ref/keyboard.html @@ -1,24 +1,18 @@ - - - + + + Mouse and Keyboard - -
Mouse and Keyboard
+ +
Mouse and Keyboard

Mouse Buttons
-
The following table contains the event bindings for the mouse -buttons.
+
The following table contains the event bindings for the mouse buttons.
- +
- - + - +

@@ -30,57 +24,38 @@ buttons.

Button 1 Depends on current MODE, which may be selected by the EDIT menu -option.
+ Depends on current MODE, which may be selected by the EDIT menu option.
In Region mode, create/edit/delete regions.
In Crosshair mode, will move current crosshair.
In Colorbar mode, will change contrast and bias of colormap.
In Pan mode, will move or pan to clicked location.
In Zoom mode, will zoom about clicked location.
In Rotate mode, will rotate image about center.
-In Crop mode, will select 2-D crop region. For 3-D -Shift-click will edit front clip plane, Control-click -will edit back clip plane.
+In Crop mode, will select 2-D crop region. For 3-D Shift-click will edit front clip plane, Control-click will edit back clip plane.
In Catalog mode, will select catalog regions.
In examine mode, will follow IRAF examine protocol.

Button 2 Pan mode: will move or pan to clicked location. Behavior -depends on the PAN preference settings. Pan mode: will move or pan to clicked location. Behavior depends on the PAN preference settings.

Button 3 Colorbar mode: will change the contrast and bias of the -colormap. Colorbar mode: will change the contrast and bias of the colormap.

Greek and other special characters.
-
The concept of a separate SYMBOL font is no longer -implemented with the latest OS font and scripting support, -especially with scalable anti-alias fonts such as Xft for Linux. -Most newer fonts (if not all) now have greek characters as part of -the font. The greek characters start at unicode \u0391 for 'A' and -\u03b1 for 'a'. Each OS has a tool used to build and copy a string -of characters. Then use the Edit:Paste menu of DS9 to insert the -character string.
+
The concept of a separate SYMBOL font is no longer implemented with the latest OS font and scripting support, especially with scalable anti-alias fonts such as Xft for Linux. Most newer fonts (if not all) now have greek characters as part of the font. The greek characters start at unicode \u0391 for 'A' and \u03b1 for 'a'. Each OS has a tool used to build and copy a string of characters. Then use the Edit:Paste menu of DS9 to insert the character string.

-
Linux- Gnome: gucharmap
Linux- KDE: -kcharselect
MacOSX: Character Viewer (Select -Edit:Special Characters) Now click and drag the characters -to a terminal window. Then select the string and select -Edit:Copy.
-Windows: Character Map (from Start button, select -All Programs, Accessories, System Tools -and then Character Map)
+
Linux- Gnome: gucharmap
Linux- KDE: kcharselect
MacOSX: Character Viewer (Select Edit:Special Characters) Now click and drag the characters to a terminal window. Then select the string and select Edit:Copy.
+Windows: Character Map (from Start button, select All Programs, Accessories, System Tools and then Character Map)

Keyboard Shortcuts
-
The following table contains the list of keyboard shortcuts and -the resulting action taken.
+
The following table contains the list of keyboard shortcuts and the resulting action taken.
- +
@@ -148,14 +123,12 @@ In Pointer mode, will move the cursor up one pixel.
In Crosshair mode, will move the crosshair up one pixel.
In Pan mode, will pan the image up one pixel. - + - @@ -163,8 +136,7 @@ In Pan mode, will pan the image to the right one pixel. h
@@ -176,19 +148,14 @@ In Crosshair mode, will also move the crosshair down one pixel.
In Pan mode, will pan the image down one pixel. - - + + - + diff --git a/ds9/doc/ref/prefs.html b/ds9/doc/ref/prefs.html index df89038..00ff4cb 100644 --- a/ds9/doc/ref/prefs.html +++ b/ds9/doc/ref/prefs.html @@ -1,34 +1,17 @@ - - - + + +Preferences - -
Preferences
+ +
Preferences
-
Allows the user to customize the appearance and behavior of the -GUI . Please note: some preferences take effect immediately, while -others require DS9 to be restarted. Changes to the preferences can -be saved by selecting the Save button. Use the -Clear Preferences button to restore default settings.
-
User preferences are stored in $HOME/.ds9.prf. DO NOT -EDIT this file, since it will be deleted or overwritten by DS9. The -file permissions must be group/world readonly.
-
Users may have several different preference files. DS9 looks for -a preference file with its own name. By default, if the application -is named ds9, it will look for .ds9.prf. However, -if the DS9 application is named foo, then DS9 will look -for .foo.prf. In this manner, the user can have several -predefined preference files that are activated by invoking DS9 with -a different application names.
+
Allows the user to customize the appearance and behavior of the GUI . Please note: some preferences take effect immediately, while others require DS9 to be restarted. Changes to the preferences can be saved by selecting the Save button. Use the Clear Preferences button to restore default settings.
+
User preferences are stored in $HOME/.ds9.prf. DO NOT EDIT this file, since it will be deleted or overwritten by DS9. The file permissions must be group/world readonly.
+
Users may have several different preference files. DS9 looks for a preference file with its own name. By default, if the application is named ds9, it will look for .ds9.prf. However, if the DS9 application is named foo, then DS9 will look for .foo.prf. In this manner, the user can have several predefined preference files that are activated by invoking DS9 with a different application names.

diff --git a/ds9/doc/ref/print.html b/ds9/doc/ref/print.html index bd5dd19..5f5c08a 100644 --- a/ds9/doc/ref/print.html +++ b/ds9/doc/ref/print.html @@ -1,55 +1,30 @@ - - - + + +Printing - -
Printing
+ +
Printing
-
DS9 provides strong Postscript printing support. This is not a -screen capture method, but a full level 1/2/3 postscript driver. -The postscript images generated are detailed and accurate as -possible, given the resolution of the data, and the printing -resolution.
+
DS9 provides strong Postscript printing support. This is not a screen capture method, but a full level 1/2/3 postscript driver. The postscript images generated are detailed and accurate as possible, given the resolution of the data, and the printing resolution.

Postscript Level

-
Level 1-- The postscript generated consist of a color lookup -table and image data, encoded in ASCIIHEX. All line -graphics and text are postscript elements.
-
Level 2-- The postscript generated consist of a color lookup -table and image data, compressed with RLE, and encoded in -ASCIIHEX85. All line graphics and text are postscript -elements.
+
Level 1-- The postscript generated consist of a color lookup table and image data, encoded in ASCIIHEX. All line graphics and text are postscript elements.
+
Level 2-- The postscript generated consist of a color lookup table and image data, compressed with RLE, and encoded in ASCIIHEX85. All line graphics and text are postscript elements.

-
Level 3-- The postscript generated consist of a color lookup -table and image data, compressed with GZIP. All line -graphics and text are postscript elements.
+
Level 3-- The postscript generated consist of a color lookup table and image data, compressed with GZIP. All line graphics and text are postscript elements.

Postscript Color Model
-
DS9 supports three color models for level 2/3 postscript. All -three color models generate approximately the same size files.
+
DS9 supports three color models for level 2/3 postscript. All three color models generate approximately the same size files.

RGB CMYK Grayscale

Resolution
-
Unlike graphic elements, image data must be sampled when encoded -into postscript. The specified resolution parameter is in "pixels -per inch" and is independent of the current screen resolution. A -value of 96 maps to the current screen resolution. Any value over -96 will over sample the image, while any value under 96 will under -sample. For high resolution printers and posters, the higher -resolution sampling, the better. However, keep in mind the size of -the postscript file grows with the square of the increase in -resolution.
+
Unlike graphic elements, image data must be sampled when encoded into postscript. The specified resolution parameter is in "pixels per inch" and is independent of the current screen resolution. A value of 96 maps to the current screen resolution. Any value over 96 will over sample the image, while any value under 96 will under sample. For high resolution printers and posters, the higher resolution sampling, the better. However, keep in mind the size of the postscript file grows with the square of the increase in resolution.

diff --git a/ds9/doc/ref/region.html b/ds9/doc/ref/region.html index 9a70e95..41c3063 100644 --- a/ds9/doc/ref/region.html +++ b/ds9/doc/ref/region.html @@ -1,36 +1,24 @@ - - - + + +Regions - - + + - -
Regions
+ +
Regions
-
Regions provide a means for marking particular areas of an image -for further analysis. Regions may also be used for presentation -purposes. DS9 supports a number of region descriptions, each of -which may be edited, moved, rotated, displayed, saved and loaded, -via the GUI and XPA.
+
Regions provide a means for marking particular areas of an image for further analysis. Regions may also be used for presentation purposes. DS9 supports a number of region descriptions, each of which may be edited, moved, rotated, displayed, saved and loaded, via the GUI and XPA.
Region Descriptions
Region Properties
Region File Format
Composite Region
Template Region
External Region Files
-
Region Descriptions
+
Region Descriptions

Circle Usage: circle x y radius # fill=[0|1]

Ellipse @@ -40,154 +28,101 @@ Usage: box x y width height angle# fill=[0|1]

Polygon Usage: polygon x1 y1 x2 y2 x3 y3 ...# fill=[0|1]

Point -Usage: point x y # -point=[circle|box|diamond|cross|x|arrow|boxcircle] [size] -       circle point x -y
+Usage: point x y # point=[circle|box|diamond|cross|x|arrow|boxcircle] [size]
+       circle point x y

Line Usage: line x1 y1 x2 y2 # line=[0|1] [0|1]

Vector Usage: vector x1 y1 length angle # vector=[0|1]

Text Usage: text x y # text={Your Text Here} -       text x y {Your Text -Here}
+       text x y {Your Text Here}

Ruler -Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] -[format=<spec>]
+Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] [format=<spec>]

Compass -Usage: compass x1 y1 length # compass=<coordinate system> -<north label> <east label> [0|1] [0|1]
+Usage: compass x1 y1 length # compass=<coordinate system> <north label> <east label> [0|1] [0|1]

Projection Usage: projection x1 y1 x2 y2 width

Annulus Usage: annulus x y inner outer n=# -       annulus x y r1 r2 -r3...
+       annulus x y r1 r2 r3...

Ellipse Annulus -Usage: ellipse x y r11 r12 r21 r22 n=# [angle] -       ellipse x y r11 r12 r21 -r22 r31 r32 ... [angle]
+Usage: ellipse x y r11 r12 r21 r22 n=# [angle]
       ellipse x y r11 r12 r21 r22 r31 r32 ... [angle]

Box Annulus Usage: box x y w1 h1 w2 h2 [angle] -       box x y w1 h1 w2 h2 w3 h3 ... -[angle]
+       box x y w1 h1 w2 h2 w3 h3 ... [angle]

Panda -Usage: panda x y startangle stopangle nangle inner outer -nradius
+Usage: panda x y startangle stopangle nangle inner outer nradius

Epanda -Usage: epanda x y startangle stopangle nangle inner outer nradius -[angle]
+Usage: epanda x y startangle stopangle nangle inner outer nradius [angle]

Bpanda -Usage: bpanda x y startangle stopangle nangle inner outer nradius -[angle]
+Usage: bpanda x y startangle stopangle nangle inner outer nradius [angle]

Composite Usage: # composite x y angle
-
Region -Properties
-
Each region has a number of properties associated with the -region, which indicates how the region is to be rendered or -manipulated. Properties are defined for a region in the comment -section of the region description. The exception is the -Include/Exclude property. It is set via '+' or '-' preceding the -region. In addition, the Line, Point, and Ruler regions have unique -properties, not shared by others. Not all properties are available -via the GUI or are applicable for all regions.
+
Region Properties
+
Each region has a number of properties associated with the region, which indicates how the region is to be rendered or manipulated. Properties are defined for a region in the comment section of the region description. The exception is the Include/Exclude property. It is set via '+' or '-' preceding the region. In addition, the Line, Point, and Ruler regions have unique properties, not shared by others. Not all properties are available via the GUI or are applicable for all regions.

Text
-
All regions may have text associated with them. Use the text -property to set the text. Strings may be quoted with " or ' or {}. -For best results, use {}. Use textangle to specify angle -in degress based on current coordinate system axes.
-Example: circle(100,100,20) # text={This message has both a " -and ' in it} textangle=30 +
All regions may have text associated with them. Use the text property to set the text. Strings may be quoted with " or ' or {}. For best results, use {}. Use textangle to specify angle in degress based on current coordinate system axes.
+Example: circle(100,100,20) # text={This message has both a " and ' in it} textangle=30
Color
-
The color property specifies the color of the region when -rendered. DS9 recognizes many symbolic color names (i.e. "red", -"green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex -values (#fff, #ffffff, #fffffffff)
+
The color property specifies the color of the region when rendered. DS9 recognizes many symbolic color names (i.e. "red", "green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex values (#fff, #ffffff, #fffffffff)
Example:
circle(100,100,20) # color=green
circle(100,100,20) # color=#48f
Dash List
-
Sets dashed line parameters. This does not render the region in -dashed lines.
+
Sets dashed line parameters. This does not render the region in dashed lines.
Example: circle(100,100,20) # dashlist=8 3

Width

Sets the line width used to render the region.
Example: circle(100,100,20) # width=2

Font
-
The font property specifies the font family, size, weight, and -slant of any text to be displayed along with the region.
+
The font property specifies the font family, size, weight, and slant of any text to be displayed along with the region.
Example: circle(100,100,20) # font="times 12 bold italic"
Can Select
-
The Select property specifies if the user is allowed to select -(hence, edit) the region via the GUI. For Regions used for catalogs -and such, it is desirable that the user is unable to edit, move, or -delete the region.
+
The Select property specifies if the user is allowed to select (hence, edit) the region via the GUI. For Regions used for catalogs and such, it is desirable that the user is unable to edit, move, or delete the region.
Example: circle(100,100,20) # select=1

Can Highlite
-The Highlite property specifies if the edit handles become visible -when the region is selected.
+The Highlite property specifies if the edit handles become visible when the region is selected.
Example: circle(100,100,20) # hightlite=1

Dash
-
Render region using dashed lines using current dashlist -value.
+
Render region using dashed lines using current dashlist value.
Example: circle(100,100,20) # dash=1

Fixed in Size
-
The Fixed in Size property specifies that the region does not -change in size as the image magnification factor changes. This -allows the user to build complex pointer type regions.
+
The Fixed in Size property specifies that the region does not change in size as the image magnification factor changes. This allows the user to build complex pointer type regions.
Example: circle(100,100,20) # fixed=1
Can Edit
-
The Edit property specifies if the user is allowed to edit the -region via the GUI.
+
The Edit property specifies if the user is allowed to edit the region via the GUI.
Example: circle(100,100,20) # edit=1
Can Move
-
The Move property specifies if the user is allowed to move the -region via the GUI.
+
The Move property specifies if the user is allowed to move the region via the GUI.
Example: circle(100,100,20) # move=1
Can Rotate
-
The Rotate property specifies if the user is allowed to rotate -the region via the GUI.
+
The Rotate property specifies if the user is allowed to rotate the region via the GUI.
Example: circle(100,100,20) # rotate=1
Can Delete
-
The Delete property specifies if the user is allowed to delete -the region via the GUI.
+
The Delete property specifies if the user is allowed to delete the region via the GUI.
Example: circle(100,100,20) # delete=1
Include/Exclude
-
The Include/Exclude properties flags the region with a boolean -NOT for later analysis. Use '+' for include (default), '-' -for exclude.
+
The Include/Exclude properties flags the region with a boolean NOT for later analysis. Use '+' for include (default), '-' for exclude.
Example: -circle(100,100,20)

Source/Background
-
The Source/Background properties flag the region for use with -other analysis applications. The default is source
+
The Source/Background properties flag the region for use with other analysis applications. The default is source
Example: circle(100,100,20) # source
-        circle(200,200,10) -# background
+        circle(200,200,10) # background

Tag
-
All regions may have zero or more tags associated with it, which -may be used for grouping and searching.
-Example: circle(100,100,20) # tag={Group 1} tag={Group -2} +
All regions may have zero or more tags associated with it, which may be used for grouping and searching.
+Example: circle(100,100,20) # tag={Group 1} tag={Group 2}
Circle | Ellipse | Box | Polygon
-
Circle, ellipse, box, and polygon regions may be rendered with -outline or solid color fill. To indicate fill, use the fill -property. A '1' indicates fill, '0' indicates no outline.
+
Circle, ellipse, box, and polygon regions may be rendered with outline or solid color fill. To indicate fill, use the fill property. A '1' indicates fill, '0' indicates no outline.
Example: circle(100,100,20) # fill=1
Line
-
The line region may be rendered with arrows, one at each end. To -indicate arrows, use the line property. A '1' indicates an arrow, -'0' indicates no arrow.
+
The line region may be rendered with arrows, one at each end. To indicate arrows, use the line property. A '1' indicates an arrow, '0' indicates no arrow.
Example: line(100,100,200,200) # line=1 1
Ruler
-
The ruler region may display information in 'pixels', 'degrees', -'arcmin', or 'arcsec'. Use the ruler property to indicate which -format to display distances in.
+
The ruler region may display information in 'pixels', 'degrees', 'arcmin', or 'arcsec'. Use the ruler property to indicate which format to display distances in.
Example: ruler(100,100,200,200) # ruler=arcmin
Point
-
Point regions have an associated type and size. Use the point -property to set the point type.
+
Point regions have an associated type and size. Use the point property to set the point type.
Example: point(100,100) # point=diamond 31
Default Properties

The default properties are:
@@ -201,45 +136,30 @@ property to set the point type.
highlite=1
include=1
fixed=0
-
Region -File Format
+
Region File Format

Syntax
-
Region arguments may be separated with either a comma or space. -Optional parentheses may be used a the beginning and end of a -description.
+
Region arguments may be separated with either a comma or space. Optional parentheses may be used a the beginning and end of a description.
circle 100 100 10
circle(100 100 10)
circle(100,100,10)

Comments
-
All lines that begin with # are comments and will be -ignored.
+
All lines that begin with # are comments and will be ignored.
# This is a comment

Delimiter
-
All lines may be delimited with either a new-line or -semi-colon.
+
All lines may be delimited with either a new-line or semi-colon.
circle 100 100 10
ellipse 200 200 20 40 ; box 300 300 20 40

Header
-
A DS9 region file may start with the following optional -header:
+
A DS9 region file may start with the following optional header:
# Region file format: DS9 version 4.0

Global Properties
-
Global properties affect all regions unless a local property is -specified. The global keyword is first, followed by a list -of keyword = value pairs. Multiple global property lines may be -used within a region file.
-global color=green font="helvetica 10 normal roman" edit=1 -move=1 delete=1 highlite=1 include=1 wcs=wcs
+
Global properties affect all regions unless a local property is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file.
+global color=green font="helvetica 10 normal roman" edit=1 move=1 delete=1 highlite=1 include=1 wcs=wcs

Local Properties
-
Local properties start with a # after a region description and -only affect the region it is specified with.
-physical;circle(504,513,20) # color=red text={This is a -Circle}
+
Local properties start with a # after a region description and only affect the region it is specified with.
+physical;circle(504,513,20) # color=red text={This is a Circle}

Coordinate Systems
-
For each region, it is important to specify the coordinate -system used to interpret the region, i.e., to set the context in -which the position and size values are interpreted. For this -purpose, the following keywords are recognized:
+
For each region, it is important to specify the coordinate system used to interpret the region, i.e., to set the context in which the position and size values are interpreted. For this purpose, the following keywords are recognized:
PHYSICAL IMAGE FK4,B1950 @@ -251,71 +171,35 @@ WCS WCSA LINEAR

Mosaic Images
-
While some coordinate systems are unique across mosaic images, -others coordinate systems, such as image, or -physical , are valid on a per segment basis. In this case, -use tile to specify which header to use in all coordinate -conversions. The default is the first header, or tile -1.
+
While some coordinate systems are unique across mosaic images, others coordinate systems, such as image, or physical , are valid on a per segment basis. In this case, use tile to specify which header to use in all coordinate conversions. The default is the first header, or tile 1.
Example: tile 2;fk5;point(100,100)
Multiple WCS
-
If an image has multiple wcs's defined, use wcs# to -specify which wcs to use for all wcs references. Valid values are -wcs, wcsa, wcsb, wcsc... wcsz. +
If an image has multiple wcs's defined, use wcs# to specify which wcs to use for all wcs references. Valid values are wcs, wcsa, wcsb, wcsc... wcsz. Example: wcsa;linear;point(100,100) # point=diamond
Specifying Positions and Sizes -The arguments to region shapes can be floats or integers -describing positions and sizes. They can be specified as pure -numbers or using explicit formatting directives: +The arguments to region shapes can be floats or integers describing positions and sizes. They can be specified as pure numbers or using explicit formatting directives: position arguments -[num]                   -# context-dependent (see below) -[num]d                  -# degrees -[num]r                  -# radians -[num]p                  -# physical pixels -[num]i                  -# image pixels -[num]:[num]:[num]       # hms for -'odd' position arguments -[num]:[num]:[num]       # dms for -'even' position arguments -[num]h[num]m[num]s      # explicit -hms -[num]d[num]m[num]s      # explicit -dms +[num]                   # context-dependent (see below) +[num]d                  # degrees +[num]r                  # radians +[num]p                  # physical pixels +[num]i                  # image pixels +[num]:[num]:[num]       # hms for 'odd' position arguments +[num]:[num]:[num]       # dms for 'even' position arguments +[num]h[num]m[num]s      # explicit hms +[num]d[num]m[num]s      # explicit dms size arguments -[num]                   -# context-dependent (see below) -[num]"                  -# arc sec -[num]'                  -# arc min -[num]d                  -# degrees -[num]r                  -# radians -[num]p                  -# physical pixels -[num]i                  -# image pixels -When a "pure number" (i.e. one without a format directive such -as 'd' for 'degrees') is specified, its interpretation depends on -the context defined by the 'coordsys' keyword. In general, the rule -is: -All pure numbers have implied units corresponding to the -current coordinate system. -If no such system is explicitly specified, the default system is -implicitly assumed to be PHYSICAL. In practice this means -that for IMAGE and PHYSICAL systems, pure numbers -are pixels. Otherwise, for all systems other than linear, pure -numbers are degrees. For LINEAR systems, pure numbers are -in the units of the linear system. This rule covers both positions -and sizes. The input values to each shape can be specified in -several coordinate systems including: +[num]                   # context-dependent (see below) +[num]"                  # arc sec +[num]'                  # arc min +[num]d                  # degrees +[num]r                  # radians +[num]p                  # physical pixels +[num]i                  # image pixels +When a "pure number" (i.e. one without a format directive such as 'd' for 'degrees') is specified, its interpretation depends on the context defined by the 'coordsys' keyword. In general, the rule is: +All pure numbers have implied units corresponding to the current coordinate system. +If no such system is explicitly specified, the default system is implicitly assumed to be PHYSICAL. In practice this means that for IMAGE and PHYSICAL systems, pure numbers are pixels. Otherwise, for all systems other than linear, pure numbers are degrees. For LINEAR systems, pure numbers are in the units of the linear system. This rule covers both positions and sizes. The input values to each shape can be specified in several coordinate systems including: IMAGE LINEAR FK4, B1950 @@ -327,81 +211,33 @@ PHYSICAL AMPLIFIER DETECTOR WCS,WCSA-WCSZ -If no coordinate system is specified, PHYSICAL is -assumed. PHYSICAL or a World Coordinate System such as -J2000 is preferred and most general. The coordinate system -specifier should appear at the beginning of the region description, -on a separate line (in a file), or followed by a new-line or -semicolon; e.g., +If no coordinate system is specified, PHYSICAL is assumed. PHYSICAL or a World Coordinate System such as J2000 is preferred and most general. The coordinate system specifier should appear at the beginning of the region description, on a separate line (in a file), or followed by a new-line or semicolon; e.g., image; circle 100 100 10 physical; ellipse 200 200 10 20 fk5; point 30 50 wcsa; fk4; point 202 47 wcsp; linear; point 100 100 -The use of celestial input units automatically implies WORLD -coordinates of the reference image. Thus, if the world coordinate -system of the reference image is J2000, then +The use of celestial input units automatically implies WORLD coordinates of the reference image. Thus, if the world coordinate system of the reference image is J2000, then circle 10:10:0 20:22:0 3' is equivalent to: j2000; circle 10:10:0 20:22:0 3' -Note that by using units as described above, you may mix -coordinate systems within a region specifier; e.g., +Note that by using units as described above, you may mix coordinate systems within a region specifier; e.g., physical; circle 6500 9320 3' -Note that, for regions which accept a rotation angle such -as: +Note that, for regions which accept a rotation angle such as: ellipse (x, y, r1, r2, angle) box(x, y, w, h, angle) -the angle is relative to the specified coordinate system. In -particular, if the region is specified in WCS coordinates, the -angle is related to the WCS system, not x/y image coordinate axis. -For WCS systems with no rotation, this obviously is not an issue. -However, some images do define an implicit rotation (e.g., by using -a non-zero CROTA value in the WCS parameters) and for these images, -the angle will be relative to the WCS axes. In such case, a region -specification such as: +the angle is relative to the specified coordinate system. In particular, if the region is specified in WCS coordinates, the angle is related to the WCS system, not x/y image coordinate axis. For WCS systems with no rotation, this obviously is not an issue. However, some images do define an implicit rotation (e.g., by using a non-zero CROTA value in the WCS parameters) and for these images, the angle will be relative to the WCS axes. In such case, a region specification such as: fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", 30) will not, in general, be the same region specified as: physical;ellipse(465, 578, 40, 20, 30) -even when positions and sizes match. The angle is relative to -WCS axes in the first case, and relative to physical x,y axes in -the second. -Composite -Region -A Composite Region is a region which is a collection of other -regions, which share common properties. A composite region is -composed of a center point and a rotation angle, of which all its -members are rendered in reference to. A composite region is defined -by the # composite x y angle declaration followed by a number of -regions who are or'd together. A composite region is manipulated as -a single region within ds9. A composite region maybe created from -the current selection of regions by selecting the Create Composite -Region menu option. Likewise, a composite region can be dissolved -by selecting the Dissolve Composite Region menu option. -Template -Region -A Template Region is a special form of a region which is saved -in a special wcs coordinate system WCS0. WCS0 indicates that the ra -and dec values are relative to the current WCS location, not -absolute. A template region can be loaded at any location into any -fits image which contains a valid wcs. For example, a user may -create a series of regions, which represent an instrument template. -Then, by selecting the Save As Template menu option, a template -region saved. The user may now load this templated into any other -fits image which contains a valid WCS. -External Region Files -DS9 can read and write a number of region file formats. Not all -formats support all the functionality of DS9 regions. Therefore, -the user may loose some information when writing and then reading -back from a region file in a format other that DS9. On output, the -regions File Format menu or the XPA -regions point is used specify the output coordinate system and -format. On input, the menu or xpa point is used only for the X -Y format. For all other formats, the input coordinate system -is specified in the regions file itself. -Funtools - +even when positions and sizes match. The angle is relative to WCS axes in the first case, and relative to physical x,y axes in the second. +Composite Region +A Composite Region is a region which is a collection of other regions, which share common properties. A composite region is composed of a center point and a rotation angle, of which all its members are rendered in reference to. A composite region is defined by the # composite x y angle declaration followed by a number of regions who are or'd together. A composite region is manipulated as a single region within ds9. A composite region maybe created from the current selection of regions by selecting the Create Composite Region menu option. Likewise, a composite region can be dissolved by selecting the Dissolve Composite Region menu option. +Template Region +A Template Region is a special form of a region which is saved in a special wcs coordinate system WCS0. WCS0 indicates that the ra and dec values are relative to the current WCS location, not absolute. A template region can be loaded at any location into any fits image which contains a valid wcs. For example, a user may create a series of regions, which represent an instrument template. Then, by selecting the Save As Template menu option, a template region saved. The user may now load this templated into any other fits image which contains a valid WCS. +External Region Files +DS9 can read and write a number of region file formats. Not all formats support all the functionality of DS9 regions. Therefore, the user may loose some information when writing and then reading back from a region file in a format other that DS9. On output, the regions File Format menu or the XPA regions point is used specify the output coordinate system and format. On input, the menu or xpa point is used only for the X Y format. For all other formats, the input coordinate system is specified in the regions file itself. +Funtools When using DS9 regions file in FUNTOOLS: LINE is ignored VECTOR is ignored @@ -434,9 +270,7 @@ ELLIPSE ANNULUS is ignored BOX ANNULUS is ignored EPANDA is ignored BPANDA is ignored - SAOimage - + SAOimage

When importing from SAOIMAGE into DS9: POINT is translated into BOX CIRCLE POINT @@ -474,8 +308,7 @@ BOX ANNULUS is ignored PANDA is ignored EPANDA is ignored BPANDA is ignored
-FITS -REGION Binary Table
+FITS REGION Binary Table

When importing from FITS REGION into DS9: POINT is translated into BOX CIRCLE POINT @@ -493,14 +326,7 @@ ROTRHOMBUSis ignored DS9 currently can not export into this format. X Y
-
This format consists of a number of coordinate pairs, one per -line. The coordinate format for both input and output is specified -via the Save Regions Parameters menu or XPA regions point. The first two coordinates -are read, the rest of the line is ignored. The comment character -'#' may be used at the beginning of line and the line is ignored. -This format is very useful for reading in coordinates from other -external analysis programs, such as IRAF.
+
This format consists of a number of coordinate pairs, one per line. The coordinate format for both input and output is specified via the Save Regions Parameters menu or XPA regions point. The first two coordinates are read, the rest of the line is ignored. The comment character '#' may be used at the beginning of line and the line is ignored. This format is very useful for reading in coordinates from other external analysis programs, such as IRAF.
Example:# this is a comment physical # this overrides the specified coordinate system 300 300 diff --git a/ds9/doc/ref/vo.html b/ds9/doc/ref/vo.html index bf929a7..6118aea 100644 --- a/ds9/doc/ref/vo.html +++ b/ds9/doc/ref/vo.html @@ -1,65 +1,29 @@ - - - + + + Virtual Observatory - - Virtual Observatory Reference + + Virtual Observatory Reference Summary -Use the Web proxy connection if your firewall does not allow -your computer to connect directly to external computers. In this -case, you also must use DS9's internal browser. +Use the Web proxy connection if your firewall does not allow your computer to connect directly to external computers. In this case, you also must use DS9's internal browser. Details -When you click on one of the Virtual Observatory servers in the -VO list, DS9 will attempt to connect to that server and (if the -internal Web display is enabled) display its Web page. The square -box to the left of the server name turns yellow while the -connection is being established and then green to signal -success. -A direct connection is fast and flexible. Among other things, it -allows you to perform analysis on your own local data (the VO -server will retrieve the image from DS9) and also allows you to use -an external browser to load images. -Some system managers configure their firewall explicitly to -prevent computers in their care from making a direct connection to -an external host. Instead, they only allow external access through -a Web proxy -server (such as SOCKS). If you are using a computer behind a -restricted firewall of this sort, then DS9 will not be able to -connect directly to a VO server. The yellow box will not turn green -and eventually DS9 will display an error message. -In this case, you can choose to have DS9 communicate with the VO -servers through your Web proxy server. DS9 will use your proxy to -send its commands and retrieve its data and analysis results, -rather than doing this directly. Note that the following -restrictions apply: +When you click on one of the Virtual Observatory servers in the VO list, DS9 will attempt to connect to that server and (if the internal Web display is enabled) display its Web page. The square box to the left of the server name turns yellow while the connection is being established and then green to signal success. +A direct connection is fast and flexible. Among other things, it allows you to perform analysis on your own local data (the VO server will retrieve the image from DS9) and also allows you to use an external browser to load images. +Some system managers configure their firewall explicitly to prevent computers in their care from making a direct connection to an external host. Instead, they only allow external access through a Web proxy +server (such as SOCKS). If you are using a computer behind a restricted firewall of this sort, then DS9 will not be able to connect directly to a VO server. The yellow box will not turn green and eventually DS9 will display an error message. +In this case, you can choose to have DS9 communicate with the VO servers through your Web proxy server. DS9 will use your proxy to send its commands and retrieve its data and analysis results, rather than doing this directly. Note that the following restrictions apply: The transfer of data is slower. You must use the internal Web browser for loading images, etc. You cannot perform analysis on local data. -There is a (large but finite) restriction on the number of annuli, -and number of polygon points you can specify in a region, as well -as the total number of regions allowed. -If your computer and firewall have been configured to require -use of a Web proxy server, you will have to tell DS9 about this -server. Click the Configure Web Proxy button and type the -relevant information into the boxes. (Your systems administrator -will be able to tell you the details.) At this point, you should be -able to connect to a VO server successfully. Please let us know if -you have problems! +There is a (large but finite) restriction on the number of annuli, and number of polygon points you can specify in a region, as well as the total number of regions allowed. +If your computer and firewall have been configured to require use of a Web proxy server, you will have to tell DS9 about this server. Click the Configure Web Proxy button and type the relevant information into the boxes. (Your systems administrator will be able to tell you the details.) At this point, you should be able to connect to a VO server successfully. Please let us know if you have problems! -A final note: you may, of course, choose to use the Web proxy -even if your computer and firewall are configured to allow direct -connections. In this case, there is no need to configure the proxy -server. +A final note: you may, of course, choose to use the Web proxy even if your computer and firewall are configured to allow direct connections. In this case, there is no need to configure the proxy server.
-- cgit v0.12 From e1bd0194e9fda1370ed8e177bc6438a05982598d Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:20:55 -0400 Subject: clean up doc --- ds9/doc/ref/contour.html | 129 ++++++-- ds9/doc/ref/file.html | 830 ++++++++++++++++++++++++++++++----------------- ds9/doc/ref/region.html | 660 ++++++++++++++++++++++++------------- 3 files changed, 1052 insertions(+), 567 deletions(-) diff --git a/ds9/doc/ref/contour.html b/ds9/doc/ref/contour.html index b18e374..6d85056 100644 --- a/ds9/doc/ref/contour.html +++ b/ds9/doc/ref/contour.html @@ -1,53 +1,114 @@ - - - + + + Contours - - Contours + + Contours -DS9 can create and display contours as an overlay on an image. The Analysis Contours menu is used to display contours. To create, copy, paste, and configure contours, use the Analysis Contour Parameters menu. +DS9 can create and display contours as an overlay on an image. +The Analysis Contours menu is used to display contours. To create, +copy, paste, and configure contours, use the Analysis Contour +Parameters menu. Contour Parameters -When creating a new contour, a dialog box appears, in which the user selects the number of contour levels, smoothness, and the distribution of the contours. +When creating a new contour, a dialog box appears, in which the +user selects the number of contour levels, smoothness, and the +distribution of the contours. Contour Levels -Specifies the number of contour levels to be generated. A typical number is between 1 and 10. Note: large numbers of contours can take a long time to generate. +Specifies the number of contour levels to be generated. A +typical number is between 1 and 10. Note: large numbers of contours +can take a long time to generate. Contour Smoothness -Specifies how smooth the contours are. A smoothness level of 1 will evaluate the contour at each image pixel. A level of 2 will evaluate the contour at every other pixel. The larger the number, the quicker the contour will be generated, and the less detail will be available. +Specifies how smooth the contours are. A smoothness level of 1 +will evaluate the contour at each image pixel. A level of 2 will +evaluate the contour at every other pixel. The larger the number, +the quicker the contour will be generated, and the less detail will +be available. Contour Scale Specifies the distribution of the contour levels. Contour Method -There are two methods that are available to calculate the contour lines. The first, BLOCK, blocks down the image, by the smoothness factor, before contours are calculated. As a result, the larger the smoothness, the faster the result. The second method, SMOOTH, smooths the image before calculating contours. As a result, the larger the smoothness, the slower the result. -Contour Files -A contour file is an ASCII file containing a header, global properties, coordinate system, contour levels, and contour points. +There are two methods that are available to calculate the +contour lines. The first, BLOCK, blocks down the image, by the +smoothness factor, before contours are calculated. As a result, the +larger the smoothness, the faster the result. The second method, +SMOOTH, smooths the image before calculating contours. As a result, +the larger the smoothness, the slower the result. +Contour +Files +A contour file is an ASCII file containing a header, global +properties, coordinate system, contour levels, and contour +points. + Header -A DS9 contour file may start with the following optional header: -    # Contour file format: DS9 version 7.5 +A DS9 contour file may start with the following optional +header: +# Contour file format: DS9 version +7.5 Global Properties -Global properties affect all contour levels unless a line level attribute is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file. -    global color=green width=1 dash=1 dashlist=8 3 +Global properties affect all contour levels unless a line level +attribute is specified. The global keyword is first, +followed by a list of keyword = value pairs. Multiple global +property lines may be used within a region file. +global color=green width=1 dash=1 dashlist=8 +3 Coordinate Systems -For each contour file, it is important to specify the coordinate system used to interpret the contour points, i.e., to set the context in which the positions are interpreted. For this purpose, the following keywords are recognized: -    PHYSICAL    # pixel coords of original file using LTM/LTV -    IMAGE    # pixel coords of current file -    FK4,B1950    # sky coordinate systems -    FK5,J2000    # sky coordinate systems -    ICRS    # sky coordinate systems -    GALACTIC    # sky coordinate systems -    ECLIPTIC    # sky coordinate systems -    WCS    # primary WCS -    WCSA    # secondary WCS -    LINEAR    # linear primary WCS +For each contour file, it is important to specify the coordinate +system used to interpret the contour points, i.e., to set the +context in which the positions are interpreted. For this purpose, +the following keywords are recognized: + +PHYSICAL                +# pixel coords of original file using LTM/LTV +IMAGE                   +# pixel coords of current file +FK4,B1950             + # sky coordinate systems +FK5,J2000               +# sky coordinate systems +ICRS                    +# sky coordinate systems +GALACTIC                +# sky coordinate systems +ECLIPTIC                +# sky coordinate systems +WCS            +         # primary WCS +WCSA            +        # secondary WCS +LINEAR                  +# linear primary WCS + + Contour Level -Each contour level is composed of a line value, line attributes and one or more contours. Line attributes are specified at the start of a new level and only affect contours within that level . -    level=15.78775 color=pink width=2 dash=yes dashlist=2 2 +Each contour level is composed of a line value, line attributes +and one or more contours. Line attributes are specified at the +start of a new level and only affect contours within that level +. +level=15.78775 color=pink width=2 dash=yes +dashlist=2 2 Contour -Each contour is composed of one or more X,Y coordinates, with a deliminator of space or comma, starting with "(" and ending with ")". Contours are not closed. -    (202.4836468 47.22380226 -   202.4833538 47.2239185 -   202.4831634 47.22409874 -   202.4829883 47.22428858) +Each contour is composed of one or more X,Y coordinates, with a +deliminator of space or comma, starting with "(" and ending +with ")". Contours are not closed. + + +(202.4836468 47.22380226 + 202.4833538 47.2239185 + 202.4831634 47.22409874 + 202.4829883 47.22428858) + + + + + + diff --git a/ds9/doc/ref/file.html b/ds9/doc/ref/file.html index 92e0d42..b1aebc8 100644 --- a/ds9/doc/ref/file.html +++ b/ds9/doc/ref/file.html @@ -1,33 +1,42 @@ - - - + + + File Formats - - File Formats + + File Formats FITS FITS Image FITS Binary Events Table FITS HEALPIX Table FITS Data Cube -FITS Multiple Extension Data Cube -FITS Multiple Extension Multiple Frames +FITS Multiple Extension +Data Cube +FITS Multiple +Extension Multiple Frames FITS Mosaic FITS Mosaic Data Cube FITS RGB Split FITS Array -NRRD +NRRD ENVI GIF TIFF JPEG PNG External Format Support -External Analysis Support +External Analysis +Support Region Files Contour Files Color Lookup Table @@ -36,7 +45,9 @@ Startup File TCL FITS -DS9 supports FITS images and FITS binary tables. The following algorithm is used to locate and to load the FITS image or table if no additional information is provide: +DS9 supports FITS images and FITS binary tables. The following +algorithm is used to locate and to load the FITS image or table if +no additional information is provide: Examine primary HDU, if IMAGE, load. @@ -44,245 +55,357 @@ DS9 supports FITS images and FITS binary tables. The following algorithm is used If IMAGE, load. -If BINARY TABLE, create IMAGE if the following is true: +If BINARY TABLE, create IMAGE if the following is +true: FITS COMPRESSED: keyword ZIMAGE is T. -FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, column names X and Y are present. +FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, +column names X and Y are present. FITS HEALPIX: keyword PIXTYPE is HEALPIX. -If DS9 traverses the entire FITS file without satisfying one of the above, an error is generated. +If DS9 traverses the entire FITS file without satisfying +one of the above, an error is generated. -FITS keyword inheritance is supported. All valid FITS BITPIX values are supported, along with -16, for UNSIGNED SHORT. The following FITS keywords are supported: - -OBJECT -UNITS -BSCALE / BZERO -BLANK -DATASEC -LTV / LTM for physical coords -DTV / DTM for detector coords -ATV / ATM for amplifier coords -WCS keywords -WCS# keywords +FITS keyword inheritance is supported. All valid FITS +BITPIX values are supported, along with -16, for +UNSIGNED SHORT. The following FITS keywords are supported: +OBJECT +UNITS +BSCALE / BZERO +BLANK +DATASEC +LTV / LTM for physical coords +DTV / DTM for detector coords +ATV / ATM for amplifier coords +WCS keywords +WCS# keywords FITS Image -At load time, the user may provide just a file name or a file name along with FITS extension name/number and image section specification. FITS extension names are case insensitive. When specifying an extension, be sure to quote strings correctly to pass both the shell and DS9 parser. A image section specification is used to specify the x,y limits of an image subsection. By default, x and y coordinates are in IMAGE, use a 'p' as the last character to indicate PHYSICAL coordinates. A '*' indicates use the default for that axis only. Block is optional and defaults to 1. - -Syntax: +At load time, the user may provide just a file name or a file name +along with FITS extension name/number and image section +specification. FITS extension names are case insensitive. When +specifying an extension, be sure to quote strings correctly to pass +both the shell and DS9 parser. A image section specification is +used to specify the x,y limits of an image subsection. By default, +x and y coordinates are in IMAGE, use a 'p' as +the last character to indicate PHYSICAL coordinates. A +'*' indicates use the default for that axis only. Block is +optional and defaults to 1. +Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] -where +where ext: [extension name | extension #] sect: -[x0:x1,y0:y1[p]] -[x0:x1,y0:y1,block[p]] -[x0:x1,y0:y1,z0:z1[p]] -[x0:x1,y0:y1,block,z0:z1[p]] -[*,y0:y1[p]] -[*,y0:y1,block[p]] -[*,y0:y1,z0:z1[p]] -[*,y0:y1,block,z0:z1[p]] -[x0:x1,*[p]] -[x0:x1,*,block[p]] -[x0:x1,*,z0:z1[p]] -[x0:x1,*,block,z0:z1[p]] -[*,*,block] -[*,*,z0:z1] -[*,*,block,z0:z1] - -[dim1@xcen,dim2@ycen[p]] -[dim1@xcen,dim2@ycen,block[p]] -[dim1@xcen,dim2@ycen,dim3@zcen[p]] -[dim1@xcen,dim2@ycen,block,dim3@zcen[p]] -[*,dim2@ycen[p]] -[*,dim2@ycen,block[p]] -[*,dim2@ycen,dim3@zcen[p]] -[*,dim2@ycen,block,dim3@zcen[p]] -[dim1@xcen,*[p]] -[dim1@xcen,*,block[p]] -[dim1@xcen,*,dim3@zcen[p]] -[dim1@xcen,*,block,dim3@zcen[p]] -[*,*,block] -[*,*,dim3@zcen] -[*,*,block,dim3@zcen] - -[dim@xcen@ycen] -[dim@xcen@ycen,block] -[dim@xcen@ycen,zdim@zcen] -[dim@xcen@ycen,block,zdim@zcen] +[x0:x1,y0:y1[p]] +[x0:x1,y0:y1,block[p]] + +[x0:x1,y0:y1,z0:z1[p]] + +[x0:x1,y0:y1,block,z0:z1[p]] + +[*,y0:y1[p]] +[*,y0:y1,block[p]] + +[*,y0:y1,z0:z1[p]] + +[*,y0:y1,block,z0:z1[p]] + +[x0:x1,*[p]] + +[x0:x1,*,block[p]] + +[x0:x1,*,z0:z1[p]] + +[x0:x1,*,block,z0:z1[p]] + +[*,*,block] + +[*,*,z0:z1] + +[*,*,block,z0:z1] + + +[dim1@xcen,dim2@ycen[p]] + +[dim1@xcen,dim2@ycen,block[p]] + +[dim1@xcen,dim2@ycen,dim3@zcen[p]] + +[dim1@xcen,dim2@ycen,block,dim3@zcen[p]] + +[*,dim2@ycen[p]] + +[*,dim2@ycen,block[p]] + +[*,dim2@ycen,dim3@zcen[p]] + +[*,dim2@ycen,block,dim3@zcen[p]] + +[dim1@xcen,*[p]] + +[dim1@xcen,*,block[p]] + +[dim1@xcen,*,dim3@zcen[p]] + +[dim1@xcen,*,block,dim3@zcen[p]] + +[*,*,block] + [*,*,dim3@zcen] +[*,*,block,dim3@zcen] + + +[dim@xcen@ycen] +[dim@xcen@ycen,block] +[dim@xcen@ycen,zdim@zcen] +[dim@xcen@ycen,block,zdim@zcen] + Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' -$ds9 foo.fits[10:200,40:100] # image section -$ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 +$ds9 foo.fits[10:200,40:100] # image section $ds9 +foo.fits[10:200,40:100,2] # image section, blocked by 2 $ds9 foo.fits[*,40:100] # only section y axis $ds9 foo.fits[256@512@512] # section box at 512,512 -$ds9 foo.fits[2][100:200,100:200] # second extension, image section -$ds9 foo.fits[2][100:200,100:200,2] # second extension, image section, blocked by 2 -$ds9 foo.fits[10:200,40:100,5:20] # cube section +$ds9 foo.fits[2][100:200,100:200] # second extension, image +section $ds9 foo.fits[2][100:200,100:200,2] # +second extension, image section, blocked by 2 $ds9 +foo.fits[10:200,40:100,5:20] # cube section $ds9 foo.fits[*,40:100,5:20] # only section y and z axes $ds9 foo.fits[256@512@512] # section cube at 512,512 -$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube section -$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube section, blocked by 2 - FITS Binary Events Table - At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and binnng parameters. DS9 will automatically convert an FITS binary events table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image and how to filter data. When specifying a filter, be sure to quote strings correctly to pass both the shell and DS9 parser. -Syntax: -filename +$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube +section +$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, +cube section, blocked by 2 +FITS Binary Events Table + At load time, the user may provide just a file name or a +file name along with FITS extension name/number, image section +specification, and binnng parameters. DS9 will automatically +convert an FITS binary events table into a 2D image for display. +FITS extension names and parameters are case insensitive. The users +may specify a number of parameters on how to construct the image +and how to filter data. When specifying a filter, be sure to quote +strings correctly to pass both the shell and DS9 +parser. + +Syntax: +filename filename[ext] filename[ext][sect] filename[sect] -filename[ext,sect] - -filename[ext][bin] -filename[ext][bin][sect] -filename[ext][sect][bin] -filename[bin] -filename[bin][sect] -filename[sect][bin] -filename[ext,bin] - -where: -ext: seeFITS Image -sect: seeFITS Image +filename[ext,sect] +filename[ext][bin] +filename[ext][bin][sect] +filename[ext][sect][bin] +filename[bin] +filename[bin][sect] +filename[sect][bin] filename[ext,bin] + where: +ext: see FITS Image +sect: see FITS Image bin: -[bin=colx,coly] # bin counts -[bin=colx,coly,filter] # bin counts with filter -[bin=colx,coly,colz] # bin on colz -[bin=colx,coly,colz,filter] # bin on colz with filter -[bin=colz] # bin cols 'x', 'y', and colz -[bin=colz,filter] # bin cols 'x', 'y', and colz with filter -[key=colx,coly] +[bin=colx,coly] # bin counts +[bin=colx,coly,filter] # bin counts with filter +[bin=colx,coly,colz] # bin on colz +[bin=colx,coly,colz,filter] # bin on colz with +filter [bin=colz] # bin cols 'x', 'y', and +colz [bin=colz,filter] # bin cols 'x', 'y', +and colz with filter [key=colx,coly] [binkey=colx,coly] -(see Introduction to Filtering) - -Example: -$ds9 foo.fits # default load -$ds9 foo.fits[1] # load first extension -$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' -$ds9 foo.fits[bin=detx,dety] # bin on detx,dety -$ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy -$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols rawx,rawy -$ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi -$ds9 foo.fits[bin=pi] # bin on x,y,pi -$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted filter -$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double quoted filter -$ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' and filter +(see Introduction +to Filtering) + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' +$ds9 foo.fits[bin=detx,dety] # bin on detx,dety +$ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols +rawx,rawy +$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, +cols rawx,rawy +$ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi +$ds9 foo.fits[bin=pi] # bin on x,y,pi +$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted +filter +$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double +quoted filter +$ds9 'foo.fits[events][pha>5,pi<2]' # load extension +'events' and filter + -The shell environment variable DS9_BINKEY may be used to specify default bin cols for FITS bin tables. Example: -$ export DS9_BINKEY='[bin=rawx,rawy]' -$ ds9 foo.fits # load FITS bin table, bin on rawx, rawy -FITS HEALPIX Table -At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and Healpix parameters. DS9 will automatically convert a FITS HEALPIX binary or ascii table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image. Any table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as an HEALPIX image. The following FITS keywords will be used if present and not overwritten by a command line option: NSIDE, COORDSYS, ORDER. - -Syntax: -filename +The shell environment variable DS9_BINKEY may be used +to specify default bin cols for FITS bin tables. Example: +$ export DS9_BINKEY='[bin=rawx,rawy]' +$ ds9 foo.fits # load FITS bin table, bin on rawx, +rawy +FITS +HEALPIX Table +At load time, the user may provide just a file name or a file name +along with FITS extension name/number, image section specification, +and Healpix parameters. DS9 will automatically convert a FITS +HEALPIX binary or ascii table into a 2D image for display. FITS +extension names and parameters are case insensitive. The users may +specify a number of parameters on how to construct the image. Any +table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as +an HEALPIX image. The following FITS keywords will be used if +present and not overwritten by a command line option: NSIDE, +COORDSYS, ORDER. +Syntax: +filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] - -filename[ext][hpx] -filename[ext][hpx][sect] -filename[ext][sect][hpx] -filename[hpx] -filename[hpx][sect] -filename[sect][hpx] -filename[ext,hpx] - -where: -ext: seeFITS Image -sect: seeFITS Image - -hpx: -[order=ring|nested] # default ring + filename[ext][hpx] +filename[ext][hpx][sect] +filename[ext][sect][hpx] +filename[hpx] +filename[hpx][sect] +filename[sect][hpx] filename[ext,hpx] + where: ext: see +FITS +Image sect: see FITS +Image + +hpx: [order=ring|nested] # default ring [layout=equatorial|north|south] # default equatorial [col=<column number>] # defaut 1 [quad=<quadurant number>] # (1-4) default 1 -[system=equatorial|galactic|ecliptic|unknown] # default unknown - -Example: -$ds9 foo.fits # default load -$ds9 foo.fits[1] # load first extension -$ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] -$ds9 foo.fits[1,order=nested] # first extension, nested order -FITS Cube -A FITS Cube is a FITS image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a cube is present and will load all additional images. In addition, individual images can be loaded one at a time into a cube. DS9 will display the Cube dialog box which allows the user to select which 2 image to be displayed. -FITS Multiple Extension Cube -A FITS Multiple Extension Data Cube file is a FITS file with one or more extensions, that is to be displayed as a data cube. Each image does not have to be the same size, however, only the coordinate systems from the first extension will be used for contours and grids. - -Example: -$ds9 -mecube foo.fits # load multiple extension fits file as data cube -FITS Multiple Extension Multiple Frames -Load a multiple extension FITS file into multiple frames. Please note that files loaded via standard-in or the xpa fits command can not be displayed using this method. - -Example: -$ds9 -multiframe foo.fits # load multiple extension fits file as multiple frames +[system=equatorial|galactic|ecliptic|unknown] # default +unknown + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 +foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] + $ds9 foo.fits[1,order=nested] # first extension, nested +order +FITS +Cube +A FITS Cube is a FITS image which contains more than 2 axes +(NAXES>2). DS9 will automatically detect if a cube is present +and will load all additional images. In addition, individual images +can be loaded one at a time into a cube. DS9 will display the Cube +dialog box which allows the user to select which 2 image to be +displayed. +FITS Multiple Extension +Cube +A FITS Multiple Extension Data Cube file is a FITS file with one or +more extensions, that is to be displayed as a data cube. Each image +does not have to be the same size, however, only the coordinate +systems from the first extension will be used for contours and +grids. +Example: +$ds9 -mecube foo.fits # load multiple extension fits file as +data cube +FITS Multiple Extension +Multiple Frames +Load a multiple extension FITS file into multiple frames. Please +note that files loaded via standard-in or the xpa fits command can +not be displayed using this method. +Example: +$ds9 -multiframe foo.fits # load multiple extension fits file +as multiple frames FITS Mosaic -A FITS mosaic image may exist as a series of FITS files, or as one FITS file with many extensions. A FITS mosaic may be loaded all a one time, or by the segment. Once loaded, the multiple FITS images are treated as one FITS image. +A FITS mosaic image may exist as a series of FITS files, or as one +FITS file with many extensions. A FITS mosaic may be loaded all a +one time, or by the segment. Once loaded, the multiple FITS images +are treated as one FITS image. DS9 supports three forms of mosaics: -

Key Stroke
Right Arrow l Will move selected regions to the right one -pixel.
+ Will move selected regions to the right one pixel.
In Pointer mode, will move the cursor to the right one pixel.
-In Crosshair mode, will move the crosshair to the right one -pixel.
+In Crosshair mode, will move the crosshair to the right one pixel.
In Pan mode, will pan the image to the right one pixel.

Will move selected regions to the left one pixel.
In Pointer mode, will move the cursor to the left one pixel.
-In Crosshair mode, will move the crosshair to the left one -pixel.
+In Crosshair mode, will move the crosshair to the left one pixel.
In Pan mode, will pan the image to the left one pixel.

Shift-Drag In Pointer mode, will select all regions within the indicated -region.
-In Crop mode, for 3D frame, will move front crop plane -forward.
Shift-Drag In Pointer mode, will select all regions within the indicated region.
+In Crop mode, for 3D frame, will move front crop plane forward.

Control-Drag In Poiner mode, on selected ANNULUS Regions, will -create new radii.
-In Crop mode, for 3D frame, will move back crop plane -backward.
In Poiner mode, on selected ANNULUS Regions, will create new radii.
+In Crop mode, for 3D frame, will move back crop plane backward.

Command-`

+
+See NOAO +IRAF Mosaic Data Structures
- - + + - - + +

IRAF
contains the DETSEC and DETSIZE keywords. -See NOAO IRAF Mosaic Data Structures

WCS
each FITS image contains a valid WCS.
WCS
each FITS image contains a valid +WCS.

HST WFPC2
valid HST WFPC2 data cube, consisting of 4 planes, along with a fits ascii table containing wcs information. HST WFPC2
valid HST WFPC2 data cube, +consisting of 4 planes, along with a fits ascii table containing +wcs information.

-
-Example: -$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits file with multiple exts -$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf from 3 files -$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file with multiple exts -$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from 3 files -$ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic -$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 files
-
FITS Mosaic Data Cube
-A FITS Mosaic Data Cube is a FITS mosaic image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic data cube is present and will load all additional images. At the same time, DS9 will display the data cube dialog box which allows the user to select which 2 image to be displayed. +
Example:
+$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one +fits file with multiple exts
+$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf +from 3 files
+$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits +file with multiple exts
+$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs +from 3 files
+$ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic
+$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) +from 3 files
+
FITS +Mosaic Data Cube
+A FITS Mosaic Data Cube is a FITS mosaic image which contains more +than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic +data cube is present and will load all additional images. At the +same time, DS9 will display the data cube dialog box which allows +the user to select which 2 image to be displayed.
FITS RGB
-A FITS RGB image may exist as three of FITS images, one FITS file with three extensions, or as a FITS 3D Data cube, with three slices, each representing the red, green, and blue channel. A FITS RGB image may be loaded all a one time, or by the channel. Once loaded, the multiple FITS images are treated as one FITS image.
-
-Example: -$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts -$ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube -$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images
+A FITS RGB image may exist as three of FITS images, one FITS file +with three extensions, or as a FITS 3D Data cube, with three +slices, each representing the red, green, and blue channel. A FITS +RGB image may be loaded all a one time, or by the channel. Once +loaded, the multiple FITS images are treated as one FITS image.
+
Example:
+$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits +file with 3 image exts
+$ds9 -rgbcube cube.fits # load rgb image consisting of one fits +data cube
+$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb +image from 3 fits images

Split FITS
-A split fits is a valid fits file in which two files contain the header and data segments. +A split fits is a valid fits file in which two files contain the +header and data segments.
Array
-Raw data arrays are supported. To load an array, the user must provide the dimensions, pixel depth, and optional header size and architecture type. -
Syntax: -filename[arr] -filename[arr][sect] -filename[sect][arr] -
-where
-sect: see FITS Image -arr: +Raw data arrays are supported. To load an array, the user must +provide the dimensions, pixel depth, and optional header size and +architecture type. +
Syntax: +filename[arr] +filename[arr][sect] filename[sect][arr] + +where
+sect: see FITS +Image arr:
xdim=value
ydim=value
zdim=value # default is a depth of 1
@@ -292,11 +415,15 @@ arr:
skip=value # must be even, most must be factor of 4
arch|endian=[big|bigendian|little|littleendian]
Example: -$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load 512x512 short -$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float with 4 byte head -$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 long, intel +$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load +512x512 short
+$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float +with 4 byte head
+$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 +long, intel

or alternate format:
filename[array(<type><dim><:skip><endian>)] + where: type: @@ -313,88 +440,115 @@ type: int.int # x,y dim
int.int.int # x,y,z dim
skip: -
int     # number of bytes to skip
+
int     # number of bytes to +skip
endian:
'l' little endian 'b' big endian
Example: -$ds9 -array bar.arr[array(s512)]   # load 512x512 short -$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte head -$ds9 -array bar.arr[array(i512l)] # load 512x512 long, intel -
The shell environment variable DS9_ARRAY may be used to specify default array parameters.
+$ds9 -array bar.arr[array(s512)]   # load 512x512 +short
+$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte +head
+$ds9 -array bar.arr[array(i512l)] # load 512x512 long, +intel +
The shell environment variable DS9_ARRAY may be used to +specify default array parameters.
Example: $export DS9_ARRAY='[dim=256,bitpix=-32]' $ds9 -array foo.arr # load 256x256 float
-
NRRD (Nearly Raw Raster Data)
-Images in NRRD are supported directly. Encodings supported: raw, gzip
-Syntax: filename
-filename[sect]
-
-where:
-sect: see FITS Image
-Example:
-$ds9 -nrrd foo.nrrd
-$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped
+
NRRD (Nearly Raw Raster +Data)
+Images in NRRD are supported directly. Encodings supported: +raw, gzip
+Syntax: +filename +filename[sect]
+where: +sect: see FITS +Image +Example:
+$ds9 -nrrd foo.nrrd +$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped

ENVI
-Images in ENVI are supported directly. Encodings supported: BIL, BIP, BSQ.
-Syntax:
-filename
+Images in ENVI are supported directly. Encodings supported: +BIL, BIP, BSQ.
+Syntax: +filename filename[sect] -where: -sect: see FITS Image - -Example: -$ds9 -envi foo.hdr foo.bsq -$ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped +where:
+sect: see FITS +Image +Example:
+$ds9 -envi foo.hdr foo.bsq +$ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped
GIF
-Images in GIF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
+Images in GIF are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly.
-Syntax: -filename - -Example: -$ ds9 -gif foo.gif
+Syntax:
+filename
+ +Example: $ ds9 -gif foo.gif

TIFF
-Images in TIFF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
-
-Syntax: -filename - -Example: -$ ds9 -tiff foo.tiff
+Images in TIFF are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly.
+
+Syntax: +filename
+ +Example:
+$ ds9 -tiff foo.tiff

JPEG
-Images in JPEG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
+Images in JPEG are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly.
-Syntax: -filename - -Example: -$ ds9 -jpeg foo.jpeg
+Syntax:
+filename
+ +Example:
+$ ds9 -jpeg foo.jpeg

PNG
-Images in PNG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly.
-
-Syntax: -filename - -Example: -$ ds9 -png foo.png
-
External File Support
-DS9 supports external file formats via an ASCII description file. When loading a file into DS9, these descriptions are referenced for instructions for loading the file, based on the file extension. If found, the command is executed and the result, a FITS image or FITS Binary Table, is read into DS9 via stdin.
-At start-up, DS9 first searches for the ASCII file, named .ds9.filin the local directory, then in the users home directory.
-The file command first is macro-expanded to fill in user-defined arguments and then is executed externally.
-The ASCII file that defines the known image files consists of one or more file descriptors, each of which has the following format:
-
-Help description
-A space-separated list of templates
-A space-separated list of file types (not currently used)
-The command line for the loading this file type
-
-Note that blank lines separate the file descriptions and should not be used as part of a description. Also, the '#' character is a comment character.
+Images in PNG are supported directly. For a Frame, the +average of the luminosity is used. For Frame RGB, each +channel is loaded directly.
+
+Syntax: +filename
+ +Example:
+$ ds9 -png foo.png
+
External File Support
+DS9 supports external file formats via an ASCII description file. +When loading a file into DS9, these descriptions are referenced for +instructions for loading the file, based on the file extension. If +found, the command is executed and the result, a FITS image or FITS +Binary Table, is read into DS9 via stdin.
+At start-up, DS9 first searches for the ASCII file, named +.ds9.filin the local directory, then in the users home +directory.
+The file command first is macro-expanded to fill in user-defined +arguments and then is executed externally.
+The ASCII file that defines the known image files consists of one +or more file descriptors, each of which has the following format: +
Help description +A space-separated list of templates +A space-separated list of file types (not currently used) +The command line for the loading this file +type
+Note that blank lines separate the file descriptions and should not +be used as part of a description. Also, the '#' character is a +comment character.

The following macros are supported: $filename
-
-For Example:
+
For Example:
# File access descriptions:
#       help explanation
#       file template
@@ -403,60 +557,126 @@ The following macros are supported: $filename
IRAF IMH files
*.imh
IMH
-i2f -s $filename
-
External Analysis Support
-For more information about external analysis support files, see Analysis. -
Region Files
-DS9 can read and write a number of region file formats. See Regions documentation for more information.
-
-DS9
-FUNTools
-Ciao
-SAOimage
-IRAF PROS
-FITS REGION Binary Table
-X Y
-
Contour Files
-See Contours documentation for more information.
-
Color Lookup Table
-DS9 has a number of default colormaps available to the user. DS9 also supports reading and writing color lookup table formats from the following programs:
-
-SAOimage
-SAOtng
-XImtool
-
-DS9 uses the file extension to determine the color table format:
-
-.lut # XImtool, SAOtng -.sao # DS9, SAOImage
+i2f -s $filename
+
External Analysis Support
+For more information about external analysis support files, see +Analysis. +
Region +Files
+DS9 can read and write a number of region file formats. See +Regions documentation for more +information. +
DS9 +FUNTools +Ciao +SAOimage +IRAF PROS +FITS REGION Binary +Table +X Y
+
Contour +Files
+See Contours +documentation for more information.
+
Color +Lookup Table
+DS9 has a number of default colormaps available to the user. DS9 +also supports reading and writing color lookup table formats from +the following programs: +
+SAOimage +SAOtng + +XImtool
+DS9 uses the file extension to determine the color table format: + + + + + + + + + + + + + + + + + + + + +
+Ext + +Format +
.lut XImtool, SAOtng
.sao DS9, SAOimage
any other DS9
+
WCS
-A new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. WCS specification can be sent to DS9 as an ASCII file via XPA. The format of the specification is a set of valid FITS keywords that describe a WCS.
-
-CRPIX1 =               257.75
-CRPIX2 =               258.93
-CRVAL1 =      -201.94541667302
-CRVAL2 =             -47.45444
-CDELT1 =        -2.1277777E-4
-CDELT2 =         2.1277777E-4
-CTYPE2 = 'DEC--TAN'
-
-Note that the WCS definitions can contain standard FITS 80 character WCS card images, as shown above, or free-form name/value pairs without the intervening "=" sign:
-
-CRPIX1    257.75
-CRPIX2    258.93
-CRVAL1    -201.94541667302
-CRVAL2    -47.45444
-CDELT1    -2.1277777E-4
-CDELT2    2.1277777E-4
-CTYPE1   'RA---TAN'
-CTYPE2   'DEC--TAN'
-
-
Preference File
-A preference file is a valid tcl script generated by DS9 to save the current preference items. See Preferences for more information. -
Startup File
-If a startup file $HOME/ds9.ini is available, it is sourced as the last step in initialization. The file permissions must be group/world readonly.
-Users may have several different startup files. DS9 looks for a startup file with its own name. By default, if the application is named ds9, it will look for .ds9.ini. However, if the DS9 application is named foo, then DS9 will look for .foo.ini. In this manner, the user can have several predefined startup files that are activated by invoking DS9 with a different application names.
+A new WCS specification can be loaded and used by the current image +regardless of the WCS that was contained in the image file. WCS +specification can be sent to DS9 as an ASCII file via XPA. The +format of the specification is a set of valid FITS keywords that +describe a WCS. +
Example: +    CRPIX1 +=               +257.75 +    CRPIX2 +=               +258.93 +    CRVAL1 =      +-201.94541667302 +    CRVAL2 +=             +-47.45444 +    CDELT1 +=        -2.1277777E-4 +    CDELT2 +=         2.1277777E-4 +    CTYPE1 = 'RA---TAN' +    CTYPE2 = 'DEC--TAN'
+Note that the WCS definitions can contain standard FITS 80 +character WCS card images, as shown above, or free-form name/value +pairs without the intervening "=" sign: +
    CRPIX1    +257.75 +    CRPIX2    258.93 +    CRVAL1    -201.94541667302 +    CRVAL2    -47.45444 +    CDELT1    -2.1277777E-4 +    CDELT2    2.1277777E-4 +    CTYPE1   'RA---TAN' +    CTYPE2   'DEC--TAN'
+
Preference +File
+A preference file is a valid tcl script generated by DS9 to save +the current preference items. See Preferences for more information. +
Startup +File
+If a startup file $HOME/ds9.ini is available, it is +sourced as the last step in initialization. The file permissions +must be group/world readonly.
+Users may have several different startup files. DS9 looks for a +startup file with its own name. By default, if the application is +named ds9, it will look for .ds9.ini. However, if +the DS9 application is named foo, then DS9 will look for +.foo.ini. In this manner, the user can have several +predefined startup files that are activated by invoking DS9 with a +different application names.

TCL
-TCL/TK script file. Users may customize the appearance and enhance the capabilities of DS9 by sourcing their own TCL scripts.
+TCL/TK script file. Users may customize the appearance and enhance +the capabilities of DS9 by sourcing their own TCL +scripts.

diff --git a/ds9/doc/ref/region.html b/ds9/doc/ref/region.html index 41c3063..d98b940 100644 --- a/ds9/doc/ref/region.html +++ b/ds9/doc/ref/region.html @@ -1,132 +1,199 @@ - - - + + + Regions - - + + - -

Regions

+ +

Regions

-
Regions provide a means for marking particular areas of an image for further analysis. Regions may also be used for presentation purposes. DS9 supports a number of region descriptions, each of which may be edited, moved, rotated, displayed, saved and loaded, via the GUI and XPA.
+
Regions provide a means for marking particular areas of an image +for further analysis. Regions may also be used for presentation +purposes. DS9 supports a number of region descriptions, each of +which may be edited, moved, rotated, displayed, saved and loaded, +via the GUI and XPA.
Region Descriptions
Region Properties
Region File Format
Composite Region
Template Region
External Region Files
-
Region Descriptions
+
Region Descriptions

Circle Usage: circle x y radius # fill=[0|1]

Ellipse -Usage: ellipse x y radius radius angle# fill=[0|1]
+Usage: ellipse x y radius radius angle # +fill=[0|1]

Box -Usage: box x y width height angle# fill=[0|1]
+Usage: box x y width height angle # fill=[0|1]

Polygon -Usage: polygon x1 y1 x2 y2 x3 y3 ...# fill=[0|1]
+Usage: polygon x1 y1 x2 y2 x3 y3 ... # fill=[0|1]

Point -Usage: point x y # point=[circle|box|diamond|cross|x|arrow|boxcircle] [size] -       circle point x y
+Usage: point x y # +point=[circle|box|diamond|cross|x|arrow|boxcircle] [size]
+       circle point x +y

Line Usage: line x1 y1 x2 y2 # line=[0|1] [0|1]

Vector Usage: vector x1 y1 length angle # vector=[0|1]

Text Usage: text x y # text={Your Text Here} -       text x y {Your Text Here}
+       text x y {Your Text +Here}

Ruler -Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] [format=<spec>]
+Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] +[format=<spec>]

Compass -Usage: compass x1 y1 length # compass=<coordinate system> <north label> <east label> [0|1] [0|1]
+Usage: compass x1 y1 length # compass=<coordinate system> +<north label> <east label> [0|1] [0|1]

Projection Usage: projection x1 y1 x2 y2 width

Annulus Usage: annulus x y inner outer n=# -       annulus x y r1 r2 r3...
+       annulus x y r1 r2 +r3...

Ellipse Annulus -Usage: ellipse x y r11 r12 r21 r22 n=# [angle]        ellipse x y r11 r12 r21 r22 r31 r32 ... [angle]
+Usage: ellipse x y r11 r12 r21 r22 n=# [angle]
+       ellipse x y r11 r12 r21 r22 +r31 r32 ... [angle]

Box Annulus Usage: box x y w1 h1 w2 h2 [angle] -       box x y w1 h1 w2 h2 w3 h3 ... [angle]
+       box x y w1 h1 w2 h2 w3 h3 ... +[angle]

Panda -Usage: panda x y startangle stopangle nangle inner outer nradius
+Usage: panda x y startangle stopangle nangle inner outer +nradius

Epanda -Usage: epanda x y startangle stopangle nangle inner outer nradius [angle]
+Usage: epanda x y startangle stopangle nangle inner outer nradius +[angle]

Bpanda -Usage: bpanda x y startangle stopangle nangle inner outer nradius [angle]
+Usage: bpanda x y startangle stopangle nangle inner outer nradius +[angle]

Composite Usage: # composite x y angle
-
Region Properties
-
Each region has a number of properties associated with the region, which indicates how the region is to be rendered or manipulated. Properties are defined for a region in the comment section of the region description. The exception is the Include/Exclude property. It is set via '+' or '-' preceding the region. In addition, the Line, Point, and Ruler regions have unique properties, not shared by others. Not all properties are available via the GUI or are applicable for all regions.
+
Region +Properties
+
Each region has a number of properties associated with the +region, which indicates how the region is to be rendered or +manipulated. Properties are defined for a region in the comment +section of the region description. The exception is the +Include/Exclude property. It is set via '+' or '-' preceding the +region. In addition, the Line, Point, and Ruler regions have unique +properties, not shared by others. Not all properties are available +via the GUI or are applicable for all regions.
+

Text
-
All regions may have text associated with them. Use the text property to set the text. Strings may be quoted with " or ' or {}. For best results, use {}. Use textangle to specify angle in degress based on current coordinate system axes.
-Example: circle(100,100,20) # text={This message has both a " and ' in it} textangle=30 +
All regions may have text associated with them. Use the text +property to set the text. Strings may be quoted with " or ' or {}. +For best results, use {}. Use textangle to specify angle +in degress based on current coordinate system axes.
+Example: circle(100,100,20) # text={This message has both a " +and ' in it} textangle=30
Color
-
The color property specifies the color of the region when rendered. DS9 recognizes many symbolic color names (i.e. "red", "green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex values (#fff, #ffffff, #fffffffff)
-Example:
-circle(100,100,20) # color=green
-circle(100,100,20) # color=#48f +
The color property specifies the color of the region when +rendered. DS9 recognizes many symbolic color names (i.e. "red", +"green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex +values (#fff, #ffffff, #fffffffff)
+Example: +circle(100,100,20) # color=green circle(100,100,20) # +color=#48f
Dash List
-
Sets dashed line parameters. This does not render the region in dashed lines.
+
Sets dashed line parameters. This does not render the region in +dashed lines.
Example: circle(100,100,20) # dashlist=8 3

Width

Sets the line width used to render the region.
Example: circle(100,100,20) # width=2

Font
-
The font property specifies the font family, size, weight, and slant of any text to be displayed along with the region.
+
The font property specifies the font family, size, weight, and +slant of any text to be displayed along with the region.
Example: circle(100,100,20) # font="times 12 bold italic"
Can Select
-
The Select property specifies if the user is allowed to select (hence, edit) the region via the GUI. For Regions used for catalogs and such, it is desirable that the user is unable to edit, move, or delete the region.
+
The Select property specifies if the user is allowed to select +(hence, edit) the region via the GUI. For Regions used for catalogs +and such, it is desirable that the user is unable to edit, move, or +delete the region.
Example: circle(100,100,20) # select=1

Can Highlite
-The Highlite property specifies if the edit handles become visible when the region is selected.
+The Highlite property specifies if the edit handles become visible +when the region is selected.
Example: circle(100,100,20) # hightlite=1

Dash
-
Render region using dashed lines using current dashlist value.
+
Render region using dashed lines using current dashlist +value.
Example: circle(100,100,20) # dash=1

Fixed in Size
-
The Fixed in Size property specifies that the region does not change in size as the image magnification factor changes. This allows the user to build complex pointer type regions.
+
The Fixed in Size property specifies that the region does not +change in size as the image magnification factor changes. This +allows the user to build complex pointer type regions.
Example: circle(100,100,20) # fixed=1
Can Edit
-
The Edit property specifies if the user is allowed to edit the region via the GUI.
+
The Edit property specifies if the user is allowed to edit the +region via the GUI.
Example: circle(100,100,20) # edit=1
Can Move
-
The Move property specifies if the user is allowed to move the region via the GUI.
+
The Move property specifies if the user is allowed to move the +region via the GUI.
Example: circle(100,100,20) # move=1
Can Rotate
-
The Rotate property specifies if the user is allowed to rotate the region via the GUI.
+
The Rotate property specifies if the user is allowed to rotate +the region via the GUI.
Example: circle(100,100,20) # rotate=1
Can Delete
-
The Delete property specifies if the user is allowed to delete the region via the GUI.
+
The Delete property specifies if the user is allowed to delete +the region via the GUI.
Example: circle(100,100,20) # delete=1
Include/Exclude
-
The Include/Exclude properties flags the region with a boolean NOT for later analysis. Use '+' for include (default), '-' for exclude.
-Example: -circle(100,100,20)
+
The Include/Exclude properties flags the region with a boolean +NOT for later analysis. Use '+' for include (default), '-' +for exclude.
+Example: -circle(100,100,20)
Source/Background
-
The Source/Background properties flag the region for use with other analysis applications. The default is source
-Example: circle(100,100,20) # source
-        circle(200,200,10) # background
+
The Source/Background properties flag the region for use with +other analysis applications. The default is source
+Example: circle(100,100,20) # source +        circle(200,200,10) # +background

Tag
-
All regions may have zero or more tags associated with it, which may be used for grouping and searching.
-Example: circle(100,100,20) # tag={Group 1} tag={Group 2} +
All regions may have zero or more tags associated with it, which +may be used for grouping and searching.
+Example: circle(100,100,20) # tag={Group 1} tag={Group +2}
Circle | Ellipse | Box | Polygon
-
Circle, ellipse, box, and polygon regions may be rendered with outline or solid color fill. To indicate fill, use the fill property. A '1' indicates fill, '0' indicates no outline.
+
Circle, ellipse, box, and polygon regions may be rendered with +outline or solid color fill. To indicate fill, use the fill +property. A '1' indicates fill, '0' indicates no outline.
Example: circle(100,100,20) # fill=1
Line
-
The line region may be rendered with arrows, one at each end. To indicate arrows, use the line property. A '1' indicates an arrow, '0' indicates no arrow.
+
The line region may be rendered with arrows, one at each end. To +indicate arrows, use the line property. A '1' indicates an arrow, +'0' indicates no arrow.
Example: line(100,100,200,200) # line=1 1
Ruler
-
The ruler region may display information in 'pixels', 'degrees', 'arcmin', or 'arcsec'. Use the ruler property to indicate which format to display distances in.
+
The ruler region may display information in 'pixels', 'degrees', +'arcmin', or 'arcsec'. Use the ruler property to indicate which +format to display distances in.
Example: ruler(100,100,200,200) # ruler=arcmin
Point
-
Point regions have an associated type and size. Use the point property to set the point type.
+
Point regions have an associated type and size. Use the point +property to set the point type.
Example: point(100,100) # point=diamond 31
Default Properties

The default properties are:
-text={}
+
text={}
color=green
font="helvetica 10 normal roman"
select=1
@@ -135,202 +202,339 @@ The Highlite property specifies if the edit handles become visible when the regi delete=1
highlite=1
include=1
-fixed=0
-
Region File Format
+fixed=0
+
+
Region +File Format
+

Syntax
-
Region arguments may be separated with either a comma or space. Optional parentheses may be used a the beginning and end of a description.
-circle 100 100 10
+
Region arguments may be separated with either a comma or space. +Optional parentheses may be used a the beginning and end of a +description.
+
circle 100 100 10
circle(100 100 10)
-circle(100,100,10)
+circle(100,100,10)

Comments
-
All lines that begin with # are comments and will be ignored.
-# This is a comment
+
All lines that begin with # are comments and will be +ignored.
+
# This is a comment

Delimiter
-
All lines may be delimited with either a new-line or semi-colon.
-circle 100 100 10
-ellipse 200 200 20 40 ; box 300 300 20 40
+
All lines may be delimited with either a new-line or +semi-colon.
+
circle 100 100 10
+ellipse 200 200 20 40 ; box 300 300 20 40

Header
-
A DS9 region file may start with the following optional header:
-# Region file format: DS9 version 4.0
+
A DS9 region file may start with the following optional +header:
+
# Region file format: DS9 version +4.0

Global Properties
-
Global properties affect all regions unless a local property is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file.
-global color=green font="helvetica 10 normal roman" edit=1 move=1 delete=1 highlite=1 include=1 wcs=wcs
+
Global properties affect all regions unless a local property is +specified. The global keyword is first, followed by a list +of keyword = value pairs. Multiple global property lines may be +used within a region file.
+
global color=green font="helvetica 10 normal roman" +edit=1 move=1 delete=1 highlite=1 include=1 +wcs=wcs

Local Properties
-
Local properties start with a # after a region description and only affect the region it is specified with.
-physical;circle(504,513,20) # color=red text={This is a Circle}
+
Local properties start with a # after a region description and +only affect the region it is specified with.
+
physical;circle(504,513,20) # color=red text={This +is a Circle}

Coordinate Systems
-
For each region, it is important to specify the coordinate system used to interpret the region, i.e., to set the context in which the position and size values are interpreted. For this purpose, the following keywords are recognized:
-PHYSICAL -IMAGE -FK4,B1950 -FK5,J2000 -ICRS -GALACTIC -ECLIPTIC -WCS -WCSA -LINEAR
+
For each region, it is important to specify the coordinate +system used to interpret the region, i.e., to set the context in +which the position and size values are interpreted. For this +purpose, the following keywords are recognized:
+
+
+PHYSICAL                +# pixel coords of original file using LTM/LTV
+IMAGE                   +# pixel coords of current file
+FK4,B1950             + # sky coordinate systems +FK5,J2000               +# sky coordinate systems +ICRS                    +# sky coordinate systems +GALACTIC                +# sky coordinate systems
+ECLIPTIC                +# sky coordinate systems
+WCS            +         # primary WCS +WCSA            +        # secondary WCS +LINEAR                  +# linear primary WCS
+

Mosaic Images
-
While some coordinate systems are unique across mosaic images, others coordinate systems, such as image, or physical , are valid on a per segment basis. In this case, use tile to specify which header to use in all coordinate conversions. The default is the first header, or tile 1.
+
While some coordinate systems are unique across mosaic images, +others coordinate systems, such as image, or +physical , are valid on a per segment basis. In this case, +use tile to specify which header to use in all coordinate +conversions. The default is the first header, or tile +1.
Example: tile 2;fk5;point(100,100)
Multiple WCS
-
If an image has multiple wcs's defined, use wcs# to specify which wcs to use for all wcs references. Valid values are wcs, wcsa, wcsb, wcsc... wcsz. - -Example: wcsa;linear;point(100,100) # point=diamond
+
If an image has multiple wcs's defined, use wcs# to +specify which wcs to use for all wcs references. Valid values are +wcs, wcsa, wcsb, wcsc... wcsz.
+Example: wcsa;linear;point(100,100) # point=diamond

Specifying Positions and Sizes
-
The arguments to region shapes can be floats or integers describing positions and sizes. They can be specified as pure numbers or using explicit formatting directives:
+
The arguments to region shapes can be floats or integers +describing positions and sizes. They can be specified as pure +numbers or using explicit formatting directives:
+

position arguments
-[num]                   # context-dependent (see below)
-[num]d                  # degrees
-[num]r                  # radians
-[num]p                  # physical pixels
-[num]i                  # image pixels
-[num]:[num]:[num]       # hms for 'odd' position arguments
-[num]:[num]:[num]       # dms for 'even' position arguments
-[num]h[num]m[num]s      # explicit hms
-[num]d[num]m[num]s      # explicit dms +[num]                   +# context-dependent (see below)
+[num]d                  +# degrees
+[num]r                  +# radians
+[num]p                  +# physical pixels
+[num]i                  +# image pixels
+[num]:[num]:[num]       # hms for +'odd' position arguments
+[num]:[num]:[num]       # dms for +'even' position arguments
+[num]h[num]m[num]s      # explicit +hms
+[num]d[num]m[num]s      # explicit +dms
size arguments
-[num]                   # context-dependent (see below)
-[num]"                  # arc sec
-[num]'                  # arc min
-[num]d                  # degrees
-[num]r                  # radians
-[num]p                  # physical pixels
-[num]i                  # image pixels
-
When a "pure number" (i.e. one without a format directive such as 'd' for 'degrees') is specified, its interpretation depends on the context defined by the 'coordsys' keyword. In general, the rule is:
-
All pure numbers have implied units corresponding to the current coordinate system.
-
If no such system is explicitly specified, the default system is implicitly assumed to be PHYSICAL. In practice this means that for IMAGE and PHYSICAL systems, pure numbers are pixels. Otherwise, for all systems other than linear, pure numbers are degrees. For LINEAR systems, pure numbers are in the units of the linear system. This rule covers both positions and sizes. The input values to each shape can be specified in several coordinate systems including:
-IMAGE -LINEAR -FK4, B1950 -FK5, J2000 -GALACTIC -ECLIPTIC -ICRS -PHYSICAL -AMPLIFIER -DETECTOR -WCS,WCSA-WCSZ -
If no coordinate system is specified, PHYSICAL is assumed. PHYSICAL or a World Coordinate System such as J2000 is preferred and most general. The coordinate system specifier should appear at the beginning of the region description, on a separate line (in a file), or followed by a new-line or semicolon; e.g.,
-image; circle 100 100 10
+[num]                   +# context-dependent (see below)
+[num]"                  +# arc sec
+[num]'                  +# arc min
+[num]d                  +# degrees
+[num]r                  +# radians
+[num]p                  +# physical pixels
+[num]i                  +# image pixels
+
When a "pure number" (i.e. one without a format directive such +as 'd' for 'degrees') is specified, its interpretation depends on +the context defined by the 'coordsys' keyword. In general, the rule +is:
+
All pure numbers have implied units corresponding to the +current coordinate system.
+
If no such system is explicitly specified, the default system is +implicitly assumed to be PHYSICAL. In practice this means +that for IMAGE and PHYSICAL systems, pure numbers +are pixels. Otherwise, for all systems other than linear, pure +numbers are degrees. For LINEAR systems, pure numbers are +in the units of the linear system. This rule covers both positions +and sizes. The input values to each shape can be specified in +several coordinate systems including:
+
+IMAGE                   +# pixel coords of current file
+
+LINEAR                  +# linear wcs as defined in file +
FK4, +B1950              +# sky coordinate systems
+FK5, J2000
+GALACTIC
+ECLIPTIC
+ICRS
+PHYSICAL                +# pixel coords of original file using LTM/LTV
+AMPLIFIER               +# mosaic coords of original file using ATM/ATV
+DETECTOR                +# mosaic coords of original file using DTM/DTV
+
+WCS,WCSA-WCSZ           +# specify which WCS system to be used for +            +            # linear +and sky coordinate systems
+
+
If no coordinate system is specified, PHYSICAL is +assumed. PHYSICAL or a World Coordinate System such as +J2000 is preferred and most general. The coordinate system +specifier should appear at the beginning of the region description, +on a separate line (in a file), or followed by a new-line or +semicolon; e.g.,
+
image; circle 100 100 10
physical; ellipse 200 200 10 20
fk5; point 30 50
wcsa; fk4; point 202 47
-wcsp; linear; point 100 100
-
The use of celestial input units automatically implies WORLD coordinates of the reference image. Thus, if the world coordinate system of the reference image is J2000, then
-circle 10:10:0 20:22:0 3'
+wcsp; linear; point 100 100
+
The use of celestial input units automatically implies WORLD +coordinates of the reference image. Thus, if the world coordinate +system of the reference image is J2000, then
+
circle 10:10:0 20:22:0 3'

is equivalent to:
-j2000; circle 10:10:0 20:22:0 3'
-
Note that by using units as described above, you may mix coordinate systems within a region specifier; e.g.,
-physical; circle 6500 9320 3'
-
Note that, for regions which accept a rotation angle such as:
-ellipse (x, y, r1, r2, angle)
-box(x, y, w, h, angle)
-
the angle is relative to the specified coordinate system. In particular, if the region is specified in WCS coordinates, the angle is related to the WCS system, not x/y image coordinate axis. For WCS systems with no rotation, this obviously is not an issue. However, some images do define an implicit rotation (e.g., by using a non-zero CROTA value in the WCS parameters) and for these images, the angle will be relative to the WCS axes. In such case, a region specification such as:
-fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", 30)
+
j2000; circle 10:10:0 20:22:0 3'
+
Note that by using units as described above, you may mix +coordinate systems within a region specifier; e.g.,
+
physical; circle 6500 9320 3'
+
Note that, for regions which accept a rotation angle such +as:
+
ellipse (x, y, r1, r2, angle) +box(x, y, w, h, angle)
+
the angle is relative to the specified coordinate system. In +particular, if the region is specified in WCS coordinates, the +angle is related to the WCS system, not x/y image coordinate axis. +For WCS systems with no rotation, this obviously is not an issue. +However, some images do define an implicit rotation (e.g., by using +a non-zero CROTA value in the WCS parameters) and for these images, +the angle will be relative to the WCS axes. In such case, a region +specification such as:
+
fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", +30)

will not, in general, be the same region specified as:
-physical;ellipse(465, 578, 40, 20, 30)
-
even when positions and sizes match. The angle is relative to WCS axes in the first case, and relative to physical x,y axes in the second.
-
Composite Region
-
A Composite Region is a region which is a collection of other regions, which share common properties. A composite region is composed of a center point and a rotation angle, of which all its members are rendered in reference to. A composite region is defined by the # composite x y angle declaration followed by a number of regions who are or'd together. A composite region is manipulated as a single region within ds9. A composite region maybe created from the current selection of regions by selecting the Create Composite Region menu option. Likewise, a composite region can be dissolved by selecting the Dissolve Composite Region menu option.
-
Template Region
-
A Template Region is a special form of a region which is saved in a special wcs coordinate system WCS0. WCS0 indicates that the ra and dec values are relative to the current WCS location, not absolute. A template region can be loaded at any location into any fits image which contains a valid wcs. For example, a user may create a series of regions, which represent an instrument template. Then, by selecting the Save As Template menu option, a template region saved. The user may now load this templated into any other fits image which contains a valid WCS.
-
External Region Files
-
DS9 can read and write a number of region file formats. Not all formats support all the functionality of DS9 regions. Therefore, the user may loose some information when writing and then reading back from a region file in a format other that DS9. On output, the regions File Format menu or the XPA regions point is used specify the output coordinate system and format. On input, the menu or xpa point is used only for the X Y format. For all other formats, the input coordinate system is specified in the regions file itself.
-
Funtools
-When using DS9 regions file in FUNTOOLS: -LINE is ignored -VECTOR is ignored -PROJECTION is ignored +physical;ellipse(465, 578, 40, 20, +30) +even when positions and sizes match. The angle is relative to +WCS axes in the first case, and relative to physical x,y axes in +the second. +
+Composite +Region +A Composite Region is a region which is a collection of other +regions, which share common properties. A composite region is +composed of a center point and a rotation angle, of which all its +members are rendered in reference to. A composite region is defined +by the # composite x y angle declaration followed by a number of +regions who are or'd together. A composite region is manipulated as +a single region within ds9. A composite region maybe created from +the current selection of regions by selecting the Create Composite +Region menu option. Likewise, a composite region can be dissolved +by selecting the Dissolve Composite Region menu option. +Template +Region +A Template Region is a special form of a region which is saved +in a special wcs coordinate system WCS0. WCS0 indicates that the ra +and dec values are relative to the current WCS location, not +absolute. A template region can be loaded at any location into any +fits image which contains a valid wcs. For example, a user may +create a series of regions, which represent an instrument template. +Then, by selecting the Save As Template menu option, a template +region saved. The user may now load this templated into any other +fits image which contains a valid WCS. +External Region Files +DS9 can read and write a number of region file formats. Not all +formats support all the functionality of DS9 regions. Therefore, +the user may loose some information when writing and then reading +back from a region file in a format other that DS9. On output, the +regions File Format menu or the XPA +regions point is used specify the output coordinate system and +format. On input, the menu or xpa point is used only for the X +Y format. For all other formats, the input coordinate system +is specified in the regions file itself. + +Funtools + +When using DS9 regions file in FUNTOOLS: +LINE is ignored VECTOR is ignored +PROJECTION is ignored SEGMENT is ignored -TEXT is ignored -RULER is ignored -COMPASS is ignored - CIAO - -When importing from CIAO into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into BOX -RECTANGLE is translated into BOX -PANDA is translated as PIE +TEXT is ignored RULER is ignored +COMPASS is ignored +CIAO +When importing from CIAO into DS9: +POINT is translated into BOX CIRCLE POINT ROTBOX +is translated into BOX +RECTANGLE is translated into BOX PANDA is translated +as PIE SECTOR is ignored -FIELD is ignored -REGION is ignored - -When exporting from DS9 into CIAO: -PANDA is translated into PIE -LINE is ignored -VECTOR is ignored -PROJECTION is ignored -SEGMENT is ignored -TEXT is ignored -RULER is ignored -COMPASS is ignored -ELLIPSE ANNULUS is ignored -BOX ANNULUS is ignored -EPANDA is ignored -BPANDA is ignored - SAOimage - -When importing from SAOIMAGE into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into BOX - -When exporting from DS9 into SAOIMAGE: -LINE is ignored -VECTOR is ignored -PROJECTION is ignored -SEGMENT is ignored -TEXT is ignored -RULER is ignored -COMPASS is ignored -ELLIPSE ANNULUS is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored - IRAF PROS - -When importing from PROS into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into BOX - -When exporting from DS9 into SAOIMAGE: -LINE is ignored -VECTOR is ignored -PROJECTION is ignored -SEGMENT is ignored -TEXT is ignored -RULER is ignored -COMPASS is ignored -ELLIPSE ANNULUS is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored -FITS REGION Binary Table - -When importing from FITS REGION into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into BOX -RECTANGLE is translated into BOX -ROTRECTANGLE is translated into a BOX -PIE is translated into PANDA +FIELD is ignored +REGION is ignored +When exporting from DS9 into CIAO: PANDA is translated +into PIE +LINE is ignored +VECTOR is ignored +PROJECTION is ignored SEGMENT is +ignored TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +EPANDA is ignored +BPANDA is ignored +SAOimage +When importing from SAOIMAGE into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into +BOX When exporting +from DS9 into SAOIMAGE: LINE is +ignored +VECTOR is ignored +PROJECTION is ignored SEGMENT is +ignored TEXT is ignored +RULER is ignored +COMPASS is ignored ELLIPSE ANNULUS +is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored +IRAF PROS +When importing from PROS into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into +BOX When +exporting from DS9 into SAOIMAGE: LINE is +ignored +VECTOR is ignored +PROJECTION is ignored SEGMENT is +ignored TEXT is ignored +RULER is ignored +COMPASS is ignored ELLIPSE ANNULUS +is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored +FITS +REGION Binary Table +When importing from FITS REGION +into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into +BOX +RECTANGLE is translated into BOX +ROTRECTANGLE is translated into a BOX +PIE is translated into PANDA ELLIPTANNULUS is translated into EPANDA -SECTOR is ignored -FIELD is ignored -DIAMONDis ignored -RHOMBUSis ignored -ROTDIAMONDis ignored -ROTRHOMBUSis ignored - -DS9 currently can not export into this format. - X Y -This format consists of a number of coordinate pairs, one per line. The coordinate format for both input and output is specified via the Save Regions Parameters menu or XPA regions point. The first two coordinates are read, the rest of the line is ignored. The comment character '#' may be used at the beginning of line and the line is ignored. This format is very useful for reading in coordinates from other external analysis programs, such as IRAF. -Example:# this is a comment -physical # this overrides the specified coordinate system -300 300 -400 400 # this is a comment - +SECTOR is ignored +FIELD is ignored +DIAMOND is ignored RHOMBUS +is ignored ROTDIAMOND is +ignored ROTRHOMBUS is ignored + DS9 currently can not +export into this format. +X Y +This format consists of a number of coordinate pairs, one per +line. The coordinate format for both input and output is specified +via the Save Regions Parameters menu or XPA regions point. The first two coordinates +are read, the rest of the line is ignored. The comment character +'#' may be used at the beginning of line and the line is ignored. +This format is very useful for reading in coordinates from other +external analysis programs, such as IRAF. +Example: # this is a comment +physical # this overrides the specified coordinate +system +300 300 +400 400 # this is a comment +

+ -- cgit v0.12 From 49d32e40ea08a0101855837c35d9305a4418f4da Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:25:00 -0400 Subject: clean up doc --- ds9/doc/ref/contour.html | 118 ++++++++++++++--------------------------------- 1 file changed, 34 insertions(+), 84 deletions(-) diff --git a/ds9/doc/ref/contour.html b/ds9/doc/ref/contour.html index 6d85056..c5a1197 100644 --- a/ds9/doc/ref/contour.html +++ b/ds9/doc/ref/contour.html @@ -1,109 +1,59 @@ - - - + + + Contours - -

Contours

+ +

Contours

-
DS9 can create and display contours as an overlay on an image. -The Analysis Contours menu is used to display contours. To create, -copy, paste, and configure contours, use the Analysis Contour -Parameters menu.
+
DS9 can create and display contours as an overlay on an image. The Analysis Contours menu is used to display contours. To create, copy, paste, and configure contours, use the Analysis Contour Parameters menu.

Contour Parameters
-
When creating a new contour, a dialog box appears, in which the -user selects the number of contour levels, smoothness, and the -distribution of the contours.
+
When creating a new contour, a dialog box appears, in which the user selects the number of contour levels, smoothness, and the distribution of the contours.

Contour Levels
-
Specifies the number of contour levels to be generated. A -typical number is between 1 and 10. Note: large numbers of contours -can take a long time to generate.
+
Specifies the number of contour levels to be generated. A typical number is between 1 and 10. Note: large numbers of contours can take a long time to generate.

Contour Smoothness
-
Specifies how smooth the contours are. A smoothness level of 1 -will evaluate the contour at each image pixel. A level of 2 will -evaluate the contour at every other pixel. The larger the number, -the quicker the contour will be generated, and the less detail will -be available.
+
Specifies how smooth the contours are. A smoothness level of 1 will evaluate the contour at each image pixel. A level of 2 will evaluate the contour at every other pixel. The larger the number, the quicker the contour will be generated, and the less detail will be available.

Contour Scale

Specifies the distribution of the contour levels.

Contour Method
-
There are two methods that are available to calculate the -contour lines. The first, BLOCK, blocks down the image, by the -smoothness factor, before contours are calculated. As a result, the -larger the smoothness, the faster the result. The second method, -SMOOTH, smooths the image before calculating contours. As a result, -the larger the smoothness, the slower the result.
-
Contour -Files
-
A contour file is an ASCII file containing a header, global -properties, coordinate system, contour levels, and contour -points.
+
There are two methods that are available to calculate the contour lines. The first, BLOCK, blocks down the image, by the smoothness factor, before contours are calculated. As a result, the larger the smoothness, the faster the result. The second method, SMOOTH, smooths the image before calculating contours. As a result, the larger the smoothness, the slower the result.
+
Contour Files
+
A contour file is an ASCII file containing a header, global properties, coordinate system, contour levels, and contour points.

Header
-
A DS9 contour file may start with the following optional -header:
-
# Contour file format: DS9 version -7.5
+
A DS9 contour file may start with the following optional header:
+
# Contour file format: DS9 version 7.5

Global Properties
-
Global properties affect all contour levels unless a line level -attribute is specified. The global keyword is first, -followed by a list of keyword = value pairs. Multiple global -property lines may be used within a region file.
-
global color=green width=1 dash=1 dashlist=8 -3
+
Global properties affect all contour levels unless a line level attribute is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file.
+
global color=green width=1 dash=1 dashlist=8 3

Coordinate Systems
-
For each contour file, it is important to specify the coordinate -system used to interpret the contour points, i.e., to set the -context in which the positions are interpreted. For this purpose, -the following keywords are recognized:
-
-PHYSICAL                -# pixel coords of original file using LTM/LTV
-IMAGE                   -# pixel coords of current file
-FK4,B1950             - # sky coordinate systems -FK5,J2000               -# sky coordinate systems -ICRS                    -# sky coordinate systems -GALACTIC                -# sky coordinate systems
-ECLIPTIC                -# sky coordinate systems
-WCS            -         # primary WCS -WCSA            -        # secondary WCS -LINEAR                  -# linear primary WCS
+
For each contour file, it is important to specify the coordinate system used to interpret the contour points, i.e., to set the context in which the positions are interpreted. For this purpose, the following keywords are recognized:
+
PHYSICAL                # pixel coords of original file using LTM/LTV
+IMAGE                   # pixel coords of current file
+FK4,B1950             # sky coordinate systems
+FK5,J2000               # sky coordinate systems
+ICRS                    # sky coordinate systems
+GALACTIC                # sky coordinate systems
+ECLIPTIC                # sky coordinate systems
+WCS                     # primary WCS +WCSA                    # secondary WCS +LINEAR                  # linear primary WCS

Contour Level
-
Each contour level is composed of a line value, line attributes -and one or more contours. Line attributes are specified at the -start of a new level and only affect contours within that level -.
-
level=15.78775 color=pink width=2 dash=yes -dashlist=2 2
+
Each contour level is composed of a line value, line attributes and one or more contours. Line attributes are specified at the start of a new level and only affect contours within that level .
+
level=15.78775 color=pink width=2 dash=yes dashlist=2 2

Contour
-
Each contour is composed of one or more X,Y coordinates, with a -deliminator of space or comma, starting with "(" and ending -with ")". Contours are not closed.
+
Each contour is composed of one or more X,Y coordinates, with a deliminator of space or comma, starting with "(" and ending with ")". Contours are not closed.

-
(202.4836468 47.22380226 - 202.4833538 47.2239185 - 202.4831634 47.22409874 - 202.4829883 47.22428858)
+
(202.4836468 47.22380226 + 202.4833538 47.2239185 + 202.4831634 47.22409874 + 202.4829883 47.22428858)

-- cgit v0.12 From a56ca435f2103ff118e59293097369af3ec3baa7 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:25:57 -0400 Subject: clean up doc --- ds9/doc/ref/3d.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ds9/doc/ref/3d.html b/ds9/doc/ref/3d.html index 1be3358..2aa1652 100644 --- a/ds9/doc/ref/3d.html +++ b/ds9/doc/ref/3d.html @@ -17,7 +17,7 @@ # set view angle to az 45 el 30 deg
# set rendering method to Average Intensity Projection

-% ds9 -3d mycube.fits -3d vp 45 30 -3d method aip
+% ds9 -3d mycube.fits-3d vp 45 30-3d method aip

% xpaset -p ds9 3d
% xpaset -p ds9 file mycube.fits
-- cgit v0.12 From 4781e982ab072d80667c382bb69280ab16ab0e42 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:26:35 -0400 Subject: clean up doc --- ds9/doc/ref/analysis.html | 100 +++++++++++++++++++++++----------------------- 1 file changed, 50 insertions(+), 50 deletions(-) diff --git a/ds9/doc/ref/analysis.html b/ds9/doc/ref/analysis.html index bf64138..651d2c5 100644 --- a/ds9/doc/ref/analysis.html +++ b/ds9/doc/ref/analysis.html @@ -73,93 +73,93 @@ file:/home/joye/index.html
$height
$depth

Substitute the width, height, or depth of the data file in the command line.
-Syntax:     $width
+Syntax:     $width
    $height

-Example:     echo "$width $height $depth" | $text
+Example:     echo "$width $height $depth" | $text

$bitpix

Substitute the bitpix of the data file in the command line.
-Syntax:     $bitpix
+Syntax:     $bitpix

-Example:     echo "$bitpix" | $text +Example:     echo "$bitpix" | $text
$data

Data from the current frame becomes the input data to the command string. This data is in the form of a FITS image. This macro can only used at the beginning of the command string.
-Syntax:     $data
+Syntax:     $data

-Example:     $data | dosomething | $text +Example:     $data | dosomething | $text
$entry

Display an entry modal dialog. The returned string is substituted. If cancel is selected, the command line is not executed.
-Syntax:     $entry(<message>)
+Syntax:     $entry(<message>)

-Example:     echo "$entry(Enter something here)" | $text +Example:     echo "$entry(Enter something here)" | $text
$env

Substitute the value of a shell environment variable.
-Syntax:     $env(<shell variable>)
+Syntax:     $env(<shell variable>)

-Example:     echo "$env(PATH)" | $text +Example:     echo "$env(PATH)" | $text
$filedialog

Display the standard file dialog. Substitutes the returned pathname. Argument specifies if an open file or save file dialog is invoked.
-Syntax:     $filedialog([open|save])
+Syntax:     $filedialog([open|save])

-Example:     echo "$filedialog(open)" | $text
+Example:     echo "$filedialog(open)" | $text

$filename

Substitute the filename of the data file in the command line. A full filename includes any absolute or relative path. A root filename contains no path. A (2D) subsection defines a subimage from xmin,ymin to xmax,ymax. For Frame3D, a 2D subsection will also include the current slice (PLANE=) parameter if not 1. A 3D subsection defines a subimage from xmin,ymin,zmin to xmax,ymax,zmax and no PLANE parameter.
-Syntax:     $filename # filename with extname, (2d) subsections, filters
-    $filename(root|root,base) # root filename with with extname, no subsections, no filters)
- $filename(full|full,base) # full filename with extname, no subsections, no filters)
+Syntax:     $filename # filename with extname, (2d) subsections, filters
+    $filename(root|root,base) # root filename withwith extname,no subsections, no filters)
+ $filename(full|full,base) # full filenamewith extname,no subsections, no filters)

-Example:     dosomething $filename | $text
+Example:     dosomething $filename | $text
    dosomething $filename(root) | $text
$filename[$regions]
Combination of $filename and $regions macros. Generates a series of filenames, each with a region.
-Syntax:     $filename[$regions]
+Syntax:     $filename[$regions]
    $filename[$regions(<options>)]

-Example:     dosomething $filename[$regions] | $text +Example:     dosomething $filename[$regions] | $text
$geturl

This macro differs from all other macros, including $url, in that no subprocess pipe is created. Only HTTP is supported. The contents of the url are retrieved and sent to $text, $plot, or $image. No other processing is allowed. The primary purpose of this macro is to support external analysis for the Windows platform, which has no subprocess support.
-Syntax:     $geturl(http://<hostname>:<port>/<query>)
+Syntax:     $geturl(http://<hostname>:<port>/<query>)

-Example:     $geturl(http://foo.bar.edu/foo.html) | $text
+Example:     $geturl(http://foo.bar.edu/foo.html) | $text

$image

The resulting image data is display in a DS9 frame. This macro should be the last macro of a command line. Optional parameter indicates if a new frame and what type of frame is created for the new data. The macro is removed from the command line before execution.
-Syntax:     $image
+Syntax:     $image
    $image([new|rgb|3d|current])

-Example:     doit | $image(new) +Example:     doit | $image(new)
$message

Display a message dialog box, with option buttons. After displaying the message, the macro is removed from the command line before execution. If cancel or no is selected, the command line is not executed.
-Syntax:     $message(<message>)
+Syntax:     $message(<message>)
    $message([ok|okcancel|yesno],<message>)

-Example:     $message(okcancel,This is a Message)| doit | $text +Example:     $message(okcancel,This is a Message)| doit | $text
$null

Expect no output or results from analysis task. Note: no error message will be returned if the analysis task fails to execute correctly.
-Syntax:     $null
+Syntax:     $null

-Example:     echo "Hello, world" > foo | $null +Example:     echo "Hello, world" > foo | $null
$pan

Substitute current pan location of the particular data file are returned. The default coordinate system is physical.
-Syntax:     $pan     $pan(<coordinate system>,<format>)
+Syntax:     $pan     $pan(<coordinate system>,<format>)

where:
    coordinate system = [image|physical|detector|amplifier|wcs|wcsa...wcsz]
    sky frame         = [fk4|fk5|icrs|galactic|ecliptic]
    sky format        = [hms|sexagesimal|degrees]

-Example:     echo $pan(fk5,sexagesimal) | $text
+Example:     echo $pan(fk5,sexagesimal) | $text

$plot

Display data in plot window. This macro should be the last macro of a command line. The data is read via STDIN and consist of a pair of coordinates, with option error values. (xy, xyex, xyey, xyexey) Default dimension is xy. The macro is removed from the command line before execution.

For $plot(stdin) only:

The title, x axis label, and y axis label are assumed to be on the first line of input, delimited with a new-line. However, if the data starts with $BEGINTEXT, all text between $BEGINTEXT and $ENDTEXT will be removed from the data and displayed in a separate text dialog window, with the remaining data, including the title, x axis label, and y axis label, will be displayed in a plot window. Furthermore, if the data contains the string $ERROR, an error is assumed to have occurred and a text dialog window is displayed only.
-Syntax:     $plot
+Syntax:     $plot
    $plot(,,,)
    $plot(<title>,<x axis label>,<y axis label>,[xy|xyex|xyey|xyexey])
    $plot(stdin)

-Example:     doit | $plot(This is aTitle,X Axis,Y Axis)     doit | $plot(stdin) +Example:     doit | $plot(This is aTitle,X Axis,Y Axis)     doit | $plot(stdin)
$regions

Substitute region definition in specified region format, coordinate system, and coordinate format. The default coordinate system is physical, default coordinate format degrees, and default region format DS9. Arguments may appear in any order, as long as they are separated by ',' and no spaces. If one or more properties are specified, only regions with all of the specified properties will be substituted.
-Syntax:     $regions
+Syntax:     $regions
    $regions(<options>)
where options are one of the following:
    regions format    = [ds9|ciao|saotng|saoimage|pros|xy]
@@ -179,31 +179,31 @@ $depth
    $exclude_regions_pixels
    $exclude_regions_degrees
    $exclude_regions_hms
-Example:     dosomething $regions | $text
+Example:     dosomething $regions | $text
    dosomething $regions(pros) | $text
    dosomething $regions(source,wcs,fk5) | $text
    dosomething $regions(saotng,background,exclude,ecliptic,sexagesimal) | $text
$text

Display text in a text dialog window. This macro should be the last macro of a command line. To display text from only STDOUT use '|' as the pipe command. To display text from both STDOUT and STDERR, use '|&' as the pipe command. No parameters are required. The macro is removed from the command line before execution.
-Syntax:     $text
+Syntax:     $text

-Example:     doit | $text # stdout +Example:     doit | $text # stdout     doit |& $text # stdout and stderr $url URLs are processed and stored in a temporary file. Only HTTP and anonymous FTP are supported. -Syntax:     $url(http://<hostname>:<port>/<query>) +Syntax:     $url(http://<hostname>:<port>/<query>)     $url(ftp://<hostname>/<filename>) -Example:     $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image +Example:     $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image     $url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/rh100193_img.fits) | $image $vo_method Returns the vo method. -Syntax:     $vo_method +Syntax:     $vo_method -Example:     echo '$vo_method' | $text +Example:     echo '$vo_method' | $text $value Substitute the value at the location of the cursor of an bind event. -Syntax:     $value +Syntax:     $value Example:     echo "$value" | $text @@ -211,7 +211,7 @@ Example: $y $z Substitute coordinates of an bind event. When a bind event is triggered, the x,y coordinates of the mouse of the particular data file are returned. The default coordinate system is physical. This macro is only available for bind commands. For datacubes, the z coordinate is returned based on the current slice selected. -Syntax:     $x +Syntax:     $x     $x(<coordinate system>,<format>)     $y     $y(<coordinate system>,<format>) @@ -222,19 +222,19 @@ $z     sky frame         = [fk4|fk5|icrs|galactic|ecliptic]     sky format        = [hms|sexagesimal|degrees] -Example:     echo "$x $y" | $text +Example:     echo "$x $y" | $text     echo "$x $y $z" | $text -    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text     echo "$x(wcs) $y(wcs) $z(wcs)" | $text +    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text     echo "$x(wcs) $y(wcs) $z(wcs)" | $text $xpa Returns the xpa access point name. -Syntax:     $xpa +Syntax:     $xpa -Example:     echo '$xpa' | $text +Example:     echo '$xpa' | $text $xpa_method Returns the xpa method. -Syntax:     $xpa_method +Syntax:     $xpa_method -Example:     echo '$xpa_method' | $text +Example:     echo '$xpa_method' | $text Help The user may define his own HELP message. This message will be available to the user as a menu item. An optional label maybe specified. The default label is Help. When invoked, an text dialog window will appear, containing the message. Multiple HELP items maybe defined within a menu or across hierarchical menus. Example: @@ -364,12 +364,12 @@ hmenu Test Basics     Test $xpa_method     *     menu -    echo $xpa_method | $text +    echo $xpa_method | $text     Test $vo_method     *     menu     echo $vo_method | $text -     Test $filename +     Test $filename     *.fits     menu     echo $filename | $text @@ -383,11 +383,11 @@ hmenu Test Basics     *.fits     menu     echo "$xdim $ydim $bitpix" | $text -     Test $xcen $ycen +     Test $xcen $ycen     *.fits     menu     echo "$xcen $ycen" | $text -     Test $env +     Test $env     *     menu     echo $env(PATH) | $text -- cgit v0.12 From 1483b8287731dc837c3839152379b51a0aa8a685 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:26:44 -0400 Subject: clean up doc --- ds9/doc/ref/analysis.html | 146 +++++++++++++++++++++++++++++++--------------- 1 file changed, 98 insertions(+), 48 deletions(-) diff --git a/ds9/doc/ref/analysis.html b/ds9/doc/ref/analysis.html index 651d2c5..efc921f 100644 --- a/ds9/doc/ref/analysis.html +++ b/ds9/doc/ref/analysis.html @@ -73,93 +73,124 @@ file:/home/joye/index.html

$height
$depth

Substitute the width, height, or depth of the data file in the command line.

-Syntax:     $width
+Syntax: +    $width
    $height

-Example:     echo "$width $height $depth" | $text
+Example: +    echo "$width $height $depth" | $text

$bitpix

Substitute the bitpix of the data file in the command line.

-Syntax:     $bitpix
+Syntax: +    $bitpix

-Example:     echo "$bitpix" | $text +Example: +    echo "$bitpix" | $text

$data

Data from the current frame becomes the input data to the command string. This data is in the form of a FITS image. This macro can only used at the beginning of the command string.

-Syntax:     $data
+Syntax: +    $data

-Example:     $data | dosomething | $text +Example: +    $data | dosomething | $text

$entry

Display an entry modal dialog. The returned string is substituted. If cancel is selected, the command line is not executed.

-Syntax:     $entry(<message>)
+Syntax: +    $entry(<message>)

-Example:     echo "$entry(Enter something here)" | $text +Example: +    echo "$entry(Enter something here)" | $text

$env

Substitute the value of a shell environment variable.

-Syntax:     $env(<shell variable>)
+Syntax: +    $env(<shell variable>)

-Example:     echo "$env(PATH)" | $text +Example: +    echo "$env(PATH)" | $text

$filedialog

Display the standard file dialog. Substitutes the returned pathname. Argument specifies if an open file or save file dialog is invoked.

-Syntax:     $filedialog([open|save])
+Syntax: +    $filedialog([open|save])

-Example:     echo "$filedialog(open)" | $text
+Example: +    echo "$filedialog(open)" | $text

$filename

Substitute the filename of the data file in the command line. A full filename includes any absolute or relative path. A root filename contains no path. A (2D) subsection defines a subimage from xmin,ymin to xmax,ymax. For Frame3D, a 2D subsection will also include the current slice (PLANE=) parameter if not 1. A 3D subsection defines a subimage from xmin,ymin,zmin to xmax,ymax,zmax and no PLANE parameter.

-Syntax:     $filename # filename with extname, (2d) subsections, filters
+Syntax: +    $filename # filename with extname, (2d) subsections, filters
    $filename(root|root,base) # root filename withwith extname,no subsections, no filters)
$filename(full|full,base) # full filenamewith extname,no subsections, no filters)

-Example:     dosomething $filename | $text
+Example: +    dosomething $filename | $text
    dosomething $filename(root) | $text
$filename[$regions]

Combination of $filename and $regions macros. Generates a series of filenames, each with a region.

-Syntax:     $filename[$regions]
+Syntax: +    $filename[$regions]
    $filename[$regions(<options>)]

-Example:     dosomething $filename[$regions] | $text +Example: +    dosomething $filename[$regions] | $text

$geturl

This macro differs from all other macros, including $url, in that no subprocess pipe is created. Only HTTP is supported. The contents of the url are retrieved and sent to $text, $plot, or $image. No other processing is allowed. The primary purpose of this macro is to support external analysis for the Windows platform, which has no subprocess support.

-Syntax:     $geturl(http://<hostname>:<port>/<query>)
+Syntax: +    $geturl(http://<hostname>:<port>/<query>)

-Example:     $geturl(http://foo.bar.edu/foo.html) | $text
+Example: +    $geturl(http://foo.bar.edu/foo.html) | $text

$image

The resulting image data is display in a DS9 frame. This macro should be the last macro of a command line. Optional parameter indicates if a new frame and what type of frame is created for the new data. The macro is removed from the command line before execution.

$message

Display a message dialog box, with option buttons. After displaying the message, the macro is removed from the command line before execution. If cancel or no is selected, the command line is not executed.

$null

Expect no output or results from analysis task. Note: no error message will be returned if the analysis task fails to execute correctly.

-Syntax:     $null
+Syntax: +    $null

-Example:     echo "Hello, world" > foo | $null +Example: +    echo "Hello, world" > foo | $null

$pan

Substitute current pan location of the particular data file are returned. The default coordinate system is physical.

-Syntax: $pan $pan(<coordinate system>,<format>)
+Syntax: + $pan + $pan(<coordinate system>,<format>)

where:

$plot

Display data in plot window. This macro should be the last macro of a command line. The data is read via STDIN and consist of a pair of coordinates, with option error values. (xy, xyex, xyey, xyexey) Default dimension is xy. The macro is removed from the command line before execution.

For $plot(stdin) only:

The title, x axis label, and y axis label are assumed to be on the first line of input, delimited with a new-line. However, if the data starts with $BEGINTEXT, all text between $BEGINTEXT and $ENDTEXT will be removed from the data and displayed in a separate text dialog window, with the remaining data, including the title, x axis label, and y axis label, will be displayed in a plot window. Furthermore, if the data contains the string $ERROR, an error is assumed to have occurred and a text dialog window is displayed only.

$regions

Substitute region definition in specified region format, coordinate system, and coordinate format. The default coordinate system is physical, default coordinate format degrees, and default region format DS9. Arguments may appear in any order, as long as they are separated by ',' and no spaces. If one or more properties are specified, only regions with all of the specified properties will be substituted.

-Syntax:     $regions
+Syntax: +    $regions
    $regions(<options>)

where options are one of the following:

    $exclude_regions_pixels
    $exclude_regions_degrees
    $exclude_regions_hms
-Example:     dosomething $regions | $text
+Example: +    dosomething $regions | $text
    dosomething $regions(pros) | $text
    dosomething $regions(source,wcs,fk5) | $text
    dosomething $regions(saotng,background,exclude,ecliptic,sexagesimal) | $text

$text

Display text in a text dialog window. This macro should be the last macro of a command line. To display text from only STDOUT use '|' as the pipe command. To display text from both STDOUT and STDERR, use '|&' as the pipe command. No parameters are required. The macro is removed from the command line before execution.

-Syntax:     $text
+Syntax: +    $text

-Example:     doit | $text # stdout +Example: +    doit | $text # stdout     doit |& $text # stdout and stderr $url URLs are processed and stored in a temporary file. Only HTTP and anonymous FTP are supported. -Syntax:     $url(http://<hostname>:<port>/<query>) +Syntax: +    $url(http://<hostname>:<port>/<query>)     $url(ftp://<hostname>/<filename>) -Example:     $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image +Example: +    $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image     $url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/rh100193_img.fits) | $image $vo_method Returns the vo method. -Syntax:     $vo_method +Syntax: +    $vo_method -Example:     echo '$vo_method' | $text +Example: +    echo '$vo_method' | $text $value Substitute the value at the location of the cursor of an bind event. -Syntax:     $value +Syntax: +    $value Example:     echo "$value" | $text @@ -211,7 +250,8 @@ Example: $y $z Substitute coordinates of an bind event. When a bind event is triggered, the x,y coordinates of the mouse of the particular data file are returned. The default coordinate system is physical. This macro is only available for bind commands. For datacubes, the z coordinate is returned based on the current slice selected. -Syntax:     $x +Syntax: +    $x     $x(<coordinate system>,<format>)     $y     $y(<coordinate system>,<format>) @@ -222,19 +262,25 @@ $z     sky frame         = [fk4|fk5|icrs|galactic|ecliptic]     sky format        = [hms|sexagesimal|degrees] -Example:     echo "$x $y" | $text +Example: +    echo "$x $y" | $text     echo "$x $y $z" | $text -    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text     echo "$x(wcs) $y(wcs) $z(wcs)" | $text +    echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text +    echo "$x(wcs) $y(wcs) $z(wcs)" | $text $xpa Returns the xpa access point name. -Syntax:     $xpa +Syntax: +    $xpa -Example:     echo '$xpa' | $text +Example: +    echo '$xpa' | $text $xpa_method Returns the xpa method. -Syntax:     $xpa_method +Syntax: +    $xpa_method -Example:     echo '$xpa_method' | $text +Example: +    echo '$xpa_method' | $text Help The user may define his own HELP message. This message will be available to the user as a menu item. An optional label maybe specified. The default label is Help. When invoked, an text dialog window will appear, containing the message. Multiple HELP items maybe defined within a menu or across hierarchical menus. Example: @@ -364,12 +410,14 @@ hmenu Test Basics     Test $xpa_method     *     menu -    echo $xpa_method | $text +    echo $xpa_method | $text +     Test $vo_method     *     menu     echo $vo_method | $text -     Test $filename + +    Test $filename     *.fits     menu     echo $filename | $text @@ -383,11 +431,13 @@ hmenu Test Basics     *.fits     menu     echo "$xdim $ydim $bitpix" | $text -     Test $xcen $ycen + +    Test $xcen $ycen     *.fits     menu     echo "$xcen $ycen" | $text -     Test $env + +    Test $env     *     menu     echo $env(PATH) | $text -- cgit v0.12 From 333df28febe1109921775260ad620618ae3ef6aa Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:28:04 -0400 Subject: clean up doc --- ds9/doc/ref/colorbar.html | 89 ++++++++++++++--------------------------------- 1 file changed, 27 insertions(+), 62 deletions(-) diff --git a/ds9/doc/ref/colorbar.html b/ds9/doc/ref/colorbar.html index 479081a..8ad0a63 100644 --- a/ds9/doc/ref/colorbar.html +++ b/ds9/doc/ref/colorbar.html @@ -1,65 +1,30 @@ - - - - - Color - - - Colorbar - - - Color Tags - The purpose of color tags are to highlight (or hide) certain - values of data, regardless of the color map selected. The user - creates, edits, and deletes color tags via the GUI. To create a - color tag, enter the Colorbar Mode, and click once on the - colorbar. This creates a default color tag. Click and drag to - change the values. Click and drag on one side to increase or - decrease the value. Double click to manually edit the values and - color. Place the cursor over the color tag and press the delete - key to delete it. From the color parameters dialog, the user can - load, save, and delete all color tags for that frame. - - Visuals - DS9 supports a number of color environments. Not all color - environments, or visuals, are available on most machines. In - fact, you may be restricted to one or two, base on the color - graphics hardware your computer has. A color visual is composed - of two parts, the color model and the bit depth. True color uses - the value directly as a RGB triplet, to derive the correct - color. The follow is a list of the color visuals DS9 currently - supports: - true color, 8 bit - true color, 15 bit - true color, 16 bit - true color, 24 bit - You can use the xdpyinfo command to see if one of - these visual are available. NOTE: Linux Users-- if your desired - visual is not available, use the Xconfigarator command (Red Hat) - or similar command under other versions of linux, to configure - your X window visuals. - When DS9 is invoked, by default, it will use the default - visual. You can find out what the default visual is by using the - xdpyinfo command. You can also force DS9 to use another - visual by command line option. If you specify a visual, and it - is not available, DS9 will exit with an error message. - $ds9                      - # default visual, default depth - $ds9 -visual - true         # true - color, default depth - $ds9 -visual truecolor    # true color, default - depth - $ds9 -visual truecolor8   # true color 8 - $ds9 -visual truecolor16 # true color 16 - $ds9 -visual truecolor24 # true color 24 - - + + + + +Color + + + Colorbar + +Color Tags +The purpose of color tags are to highlight (or hide) certain values of data, regardless of the color map selected. The user creates, edits, and deletes color tags via the GUI. To create a color tag, enter the Colorbar Mode, and click once on the colorbar. This creates a default color tag. Click and drag to change the values. Click and drag on one side to increase or decrease the value. Double click to manually edit the values and color. Place the cursor over the color tag and press the delete key to delete it. From the color parameters dialog, the user can load, save, and delete all color tags for that frame. +Visuals +DS9 supports a number of color environments. Not all color environments, or visuals, are available on most machines. In fact, you may be restricted to one or two, base on the color graphics hardware your computer has. A color visual is composed of two parts, the color model and the bit depth. True color uses the value directly as a RGB triplet, to derive the correct color. The follow is a list of the color visuals DS9 currently supports: +true color, 8 bit +true color, 15 bit +true color, 16 bit +true color, 24 bit +You can use the xdpyinfo command to see if one of these visual are available. NOTE: Linux Users-- if your desired visual is not available, use the Xconfigarator command (Red Hat) or similar command under other versions of linux, to configure your X window visuals. +When DS9 is invoked, by default, it will use the default visual. You can find out what the default visual is by using the xdpyinfo command. You can also force DS9 to use another visual by command line option. If you specify a visual, and it is not available, DS9 will exit with an error message. +$ds9                      # default visual, default depth +$ds9 -visual true         # true color, default depth +$ds9 -visual truecolor    # true color, default depth +$ds9 -visual truecolor8   # true color 8 +$ds9 -visual truecolor16 # true color 16 +$ds9 -visual truecolor24 # true color 24 + + -- cgit v0.12 From 317124b4d4f33b0309f052758842135e81af695d Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:38:27 -0400 Subject: clean up doc --- ds9/doc/ref/region.html | 589 ++++++++++++++++-------------------------------- 1 file changed, 197 insertions(+), 392 deletions(-) diff --git a/ds9/doc/ref/region.html b/ds9/doc/ref/region.html index d98b940..2780538 100644 --- a/ds9/doc/ref/region.html +++ b/ds9/doc/ref/region.html @@ -1,195 +1,130 @@ - - - + + + Regions - - + + - - Regions + + Regions -Regions provide a means for marking particular areas of an image -for further analysis. Regions may also be used for presentation -purposes. DS9 supports a number of region descriptions, each of -which may be edited, moved, rotated, displayed, saved and loaded, -via the GUI and XPA. +Regions provide a means for marking particular areas of an image for further analysis. Regions may also be used for presentation purposes. DS9 supports a number of region descriptions, each of which may be edited, moved, rotated, displayed, saved and loaded, via the GUI and XPA. Region Descriptions Region Properties Region File Format Composite Region Template Region External Region Files -Region Descriptions +Region Descriptions Circle Usage: circle x y radius # fill=[0|1] Ellipse -Usage: ellipse x y radius radius angle # -fill=[0|1] +Usage: ellipse x y radius radius angle# fill=[0|1] Box -Usage: box x y width height angle # fill=[0|1] +Usage: box x y width height angle# fill=[0|1] Polygon -Usage: polygon x1 y1 x2 y2 x3 y3 ... # fill=[0|1] +Usage: polygon x1 y1 x2 y2 x3 y3 ...# fill=[0|1] Point -Usage: point x y # -point=[circle|box|diamond|cross|x|arrow|boxcircle] [size] -       circle point x -y +Usage: point x y # point=[circle|box|diamond|cross|x|arrow|boxcircle] [size] +       circle point x y Line Usage: line x1 y1 x2 y2 # line=[0|1] [0|1] Vector Usage: vector x1 y1 length angle # vector=[0|1] Text Usage: text x y # text={Your Text Here} -       text x y {Your Text -Here} +       text x y {Your Text Here} Ruler -Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] -[format=<spec>] +Usage: ruler x1 y1 x2 y2 # ruler=[pixels|degrees|arcmin|arcsec] [format=<spec>] Compass -Usage: compass x1 y1 length # compass=<coordinate system> -<north label> <east label> [0|1] [0|1] +Usage: compass x1 y1 length # compass=<coordinate system> <north label> <east label> [0|1] [0|1] Projection Usage: projection x1 y1 x2 y2 width Annulus Usage: annulus x y inner outer n=# -       annulus x y r1 r2 -r3... +       annulus x y r1 r2 r3... Ellipse Annulus Usage: ellipse x y r11 r12 r21 r22 n=# [angle] -       ellipse x y r11 r12 r21 r22 -r31 r32 ... [angle] +       ellipse x y r11 r12 r21 r22 r31 r32 ... [angle] Box Annulus Usage: box x y w1 h1 w2 h2 [angle] -       box x y w1 h1 w2 h2 w3 h3 ... -[angle] +       box x y w1 h1 w2 h2 w3 h3 ... [angle] Panda -Usage: panda x y startangle stopangle nangle inner outer -nradius +Usage: panda x y startangle stopangle nangle inner outer nradius Epanda -Usage: epanda x y startangle stopangle nangle inner outer nradius -[angle] +Usage: epanda x y startangle stopangle nangle inner outer nradius [angle] Bpanda -Usage: bpanda x y startangle stopangle nangle inner outer nradius -[angle] +Usage: bpanda x y startangle stopangle nangle inner outer nradius [angle] Composite Usage: # composite x y angle -Region -Properties -Each region has a number of properties associated with the -region, which indicates how the region is to be rendered or -manipulated. Properties are defined for a region in the comment -section of the region description. The exception is the -Include/Exclude property. It is set via '+' or '-' preceding the -region. In addition, the Line, Point, and Ruler regions have unique -properties, not shared by others. Not all properties are available -via the GUI or are applicable for all regions. +Region Properties +Each region has a number of properties associated with the region, which indicates how the region is to be rendered or manipulated. Properties are defined for a region in the comment section of the region description. The exception is the Include/Exclude property. It is set via '+' or '-' preceding the region. In addition, the Line, Point, and Ruler regions have unique properties, not shared by others. Not all properties are available via the GUI or are applicable for all regions. Text -All regions may have text associated with them. Use the text -property to set the text. Strings may be quoted with " or ' or {}. -For best results, use {}. Use textangle to specify angle -in degress based on current coordinate system axes. -Example: circle(100,100,20) # text={This message has both a " -and ' in it} textangle=30 +All regions may have text associated with them. Use the text property to set the text. Strings may be quoted with " or ' or {}. For best results, use {}. Use textangle to specify angle in degress based on current coordinate system axes. +Example: circle(100,100,20) # text={This message has both a " and ' in it} textangle=30 Color -The color property specifies the color of the region when -rendered. DS9 recognizes many symbolic color names (i.e. "red", -"green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex -values (#fff, #ffffff, #fffffffff) +The color property specifies the color of the region when rendered. DS9 recognizes many symbolic color names (i.e. "red", "green", "blue", "pink", etc) along with 3, 6, and 9 digit RGB hex values (#fff, #ffffff, #fffffffff) Example: -circle(100,100,20) # color=green circle(100,100,20) # -color=#48f +circle(100,100,20) # color=green +circle(100,100,20) # color=#48f Dash List -Sets dashed line parameters. This does not render the region in -dashed lines. +Sets dashed line parameters. This does not render the region in dashed lines. Example: circle(100,100,20) # dashlist=8 3 Width Sets the line width used to render the region. Example: circle(100,100,20) # width=2 Font -The font property specifies the font family, size, weight, and -slant of any text to be displayed along with the region. +The font property specifies the font family, size, weight, and slant of any text to be displayed along with the region. Example: circle(100,100,20) # font="times 12 bold italic" Can Select -The Select property specifies if the user is allowed to select -(hence, edit) the region via the GUI. For Regions used for catalogs -and such, it is desirable that the user is unable to edit, move, or -delete the region. +The Select property specifies if the user is allowed to select (hence, edit) the region via the GUI. For Regions used for catalogs and such, it is desirable that the user is unable to edit, move, or delete the region. Example: circle(100,100,20) # select=1 Can Highlite -The Highlite property specifies if the edit handles become visible -when the region is selected. +The Highlite property specifies if the edit handles become visible when the region is selected. Example: circle(100,100,20) # hightlite=1 Dash -Render region using dashed lines using current dashlist -value. +Render region using dashed lines using current dashlist value. Example: circle(100,100,20) # dash=1 Fixed in Size -The Fixed in Size property specifies that the region does not -change in size as the image magnification factor changes. This -allows the user to build complex pointer type regions. +The Fixed in Size property specifies that the region does not change in size as the image magnification factor changes. This allows the user to build complex pointer type regions. Example: circle(100,100,20) # fixed=1 Can Edit -The Edit property specifies if the user is allowed to edit the -region via the GUI. +The Edit property specifies if the user is allowed to edit the region via the GUI. Example: circle(100,100,20) # edit=1 Can Move -The Move property specifies if the user is allowed to move the -region via the GUI. +The Move property specifies if the user is allowed to move the region via the GUI. Example: circle(100,100,20) # move=1 Can Rotate -The Rotate property specifies if the user is allowed to rotate -the region via the GUI. +The Rotate property specifies if the user is allowed to rotate the region via the GUI. Example: circle(100,100,20) # rotate=1 Can Delete -The Delete property specifies if the user is allowed to delete -the region via the GUI. +The Delete property specifies if the user is allowed to delete the region via the GUI. Example: circle(100,100,20) # delete=1 Include/Exclude -The Include/Exclude properties flags the region with a boolean -NOT for later analysis. Use '+' for include (default), '-' -for exclude. +The Include/Exclude properties flags the region with a boolean NOT for later analysis. Use '+' for include (default), '-' for exclude. Example: -circle(100,100,20) Source/Background -The Source/Background properties flag the region for use with -other analysis applications. The default is source +The Source/Background properties flag the region for use with other analysis applications. The default is source Example: circle(100,100,20) # source -        circle(200,200,10) # -background +        circle(200,200,10) # background Tag -All regions may have zero or more tags associated with it, which -may be used for grouping and searching. -Example: circle(100,100,20) # tag={Group 1} tag={Group -2} +All regions may have zero or more tags associated with it, which may be used for grouping and searching. +Example: circle(100,100,20) # tag={Group 1} tag={Group 2} Circle | Ellipse | Box | Polygon -Circle, ellipse, box, and polygon regions may be rendered with -outline or solid color fill. To indicate fill, use the fill -property. A '1' indicates fill, '0' indicates no outline. +Circle, ellipse, box, and polygon regions may be rendered with outline or solid color fill. To indicate fill, use the fill property. A '1' indicates fill, '0' indicates no outline. Example: circle(100,100,20) # fill=1 Line -The line region may be rendered with arrows, one at each end. To -indicate arrows, use the line property. A '1' indicates an arrow, -'0' indicates no arrow. +The line region may be rendered with arrows, one at each end. To indicate arrows, use the line property. A '1' indicates an arrow, '0' indicates no arrow. Example: line(100,100,200,200) # line=1 1 Ruler -The ruler region may display information in 'pixels', 'degrees', -'arcmin', or 'arcsec'. Use the ruler property to indicate which -format to display distances in. +The ruler region may display information in 'pixels', 'degrees', 'arcmin', or 'arcsec'. Use the ruler property to indicate which format to display distances in. Example: ruler(100,100,200,200) # ruler=arcmin Point -Point regions have an associated type and size. Use the point -property to set the point type. +Point regions have an associated type and size. Use the point property to set the point type. Example: point(100,100) # point=diamond 31 Default Properties The default properties are: @@ -204,336 +139,206 @@ property to set the point type. include=1 fixed=0 -Region -File Format +Region File Format Syntax -Region arguments may be separated with either a comma or space. -Optional parentheses may be used a the beginning and end of a -description. +Region arguments may be separated with either a comma or space. Optional parentheses may be used a the beginning and end of a description. circle 100 100 10 circle(100 100 10) circle(100,100,10) Comments -All lines that begin with # are comments and will be -ignored. +All lines that begin with # are comments and will be ignored. # This is a comment Delimiter -All lines may be delimited with either a new-line or -semi-colon. +All lines may be delimited with either a new-line or semi-colon. circle 100 100 10 ellipse 200 200 20 40 ; box 300 300 20 40 Header -A DS9 region file may start with the following optional -header: -# Region file format: DS9 version -4.0 +A DS9 region file may start with the following optional header: +# Region file format: DS9 version 4.0 Global Properties -Global properties affect all regions unless a local property is -specified. The global keyword is first, followed by a list -of keyword = value pairs. Multiple global property lines may be -used within a region file. -global color=green font="helvetica 10 normal roman" -edit=1 move=1 delete=1 highlite=1 include=1 -wcs=wcs +Global properties affect all regions unless a local property is specified. The global keyword is first, followed by a list of keyword = value pairs. Multiple global property lines may be used within a region file. +global color=green font="helvetica 10 normal roman" edit=1 move=1 delete=1 highlite=1 include=1 wcs=wcs Local Properties -Local properties start with a # after a region description and -only affect the region it is specified with. -physical;circle(504,513,20) # color=red text={This -is a Circle} +Local properties start with a # after a region description and only affect the region it is specified with. +physical;circle(504,513,20) # color=red text={This is a Circle} Coordinate Systems -For each region, it is important to specify the coordinate -system used to interpret the region, i.e., to set the context in -which the position and size values are interpreted. For this -purpose, the following keywords are recognized: +For each region, it is important to specify the coordinate system used to interpret the region, i.e., to set the context in which the position and size values are interpreted. For this purpose, the following keywords are recognized: - -PHYSICAL                -# pixel coords of original file using LTM/LTV -IMAGE                   -# pixel coords of current file -FK4,B1950             - # sky coordinate systems -FK5,J2000               -# sky coordinate systems -ICRS                    -# sky coordinate systems -GALACTIC                -# sky coordinate systems -ECLIPTIC                -# sky coordinate systems -WCS            -         # primary WCS -WCSA            -        # secondary WCS -LINEAR                  -# linear primary WCS +PHYSICAL                # pixel coords of original file using LTM/LTV +IMAGE                   # pixel coords of current file +FK4,B1950             # sky coordinate systems +FK5,J2000               # sky coordinate systems +ICRS                    # sky coordinate systems +GALACTIC                # sky coordinate systems +ECLIPTIC                # sky coordinate systems +WCS                     # primary WCS +WCSA                    # secondary WCS +LINEAR                  # linear primary WCS Mosaic Images -While some coordinate systems are unique across mosaic images, -others coordinate systems, such as image, or -physical , are valid on a per segment basis. In this case, -use tile to specify which header to use in all coordinate -conversions. The default is the first header, or tile -1. +While some coordinate systems are unique across mosaic images, others coordinate systems, such as image, or physical , are valid on a per segment basis. In this case, use tile to specify which header to use in all coordinate conversions. The default is the first header, or tile 1. Example: tile 2;fk5;point(100,100) Multiple WCS -If an image has multiple wcs's defined, use wcs# to -specify which wcs to use for all wcs references. Valid values are -wcs, wcsa, wcsb, wcsc... wcsz. + If an image has multiple wcs's defined, use wcs# to specify which wcs to use for all wcs references. Valid values are wcs, wcsa, wcsb, wcsc... wcsz. Example: wcsa;linear;point(100,100) # point=diamond Specifying Positions and Sizes -The arguments to region shapes can be floats or integers -describing positions and sizes. They can be specified as pure -numbers or using explicit formatting directives: +The arguments to region shapes can be floats or integers describing positions and sizes. They can be specified as pure numbers or using explicit formatting directives: position arguments -[num]                   -# context-dependent (see below) -[num]d                  -# degrees -[num]r                  -# radians -[num]p                  -# physical pixels -[num]i                  -# image pixels -[num]:[num]:[num]       # hms for -'odd' position arguments -[num]:[num]:[num]       # dms for -'even' position arguments -[num]h[num]m[num]s      # explicit -hms -[num]d[num]m[num]s      # explicit -dms +[num]                   # context-dependent (see below) +[num]d                  # degrees +[num]r                  # radians +[num]p                  # physical pixels +[num]i                  # image pixels +[num]:[num]:[num]       # hms for 'odd' position arguments +[num]:[num]:[num]       # dms for 'even' position arguments +[num]h[num]m[num]s      # explicit hms +[num]d[num]m[num]s      # explicit dms size arguments -[num]                   -# context-dependent (see below) -[num]"                  -# arc sec -[num]'                  -# arc min -[num]d                  -# degrees -[num]r                  -# radians -[num]p                  -# physical pixels -[num]i                  -# image pixels -When a "pure number" (i.e. one without a format directive such -as 'd' for 'degrees') is specified, its interpretation depends on -the context defined by the 'coordsys' keyword. In general, the rule -is: -All pure numbers have implied units corresponding to the -current coordinate system. -If no such system is explicitly specified, the default system is -implicitly assumed to be PHYSICAL. In practice this means -that for IMAGE and PHYSICAL systems, pure numbers -are pixels. Otherwise, for all systems other than linear, pure -numbers are degrees. For LINEAR systems, pure numbers are -in the units of the linear system. This rule covers both positions -and sizes. The input values to each shape can be specified in -several coordinate systems including: - -IMAGE                   -# pixel coords of current file +[num]                   # context-dependent (see below) +[num]"                  # arc sec +[num]'                  # arc min +[num]d                  # degrees +[num]r                  # radians +[num]p                  # physical pixels +[num]i                  # image pixels +When a "pure number" (i.e. one without a format directive such as 'd' for 'degrees') is specified, its interpretation depends on the context defined by the 'coordsys' keyword. In general, the rule is: +All pure numbers have implied units corresponding to the current coordinate system. +If no such system is explicitly specified, the default system is implicitly assumed to be PHYSICAL. In practice this means that for IMAGE and PHYSICAL systems, pure numbers are pixels. Otherwise, for all systems other than linear, pure numbers are degrees. For LINEAR systems, pure numbers are in the units of the linear system. This rule covers both positions and sizes. The input values to each shape can be specified in several coordinate systems including: +IMAGE                   # pixel coords of current file -LINEAR                  -# linear wcs as defined in file -FK4, -B1950              -# sky coordinate systems +LINEAR                  # linear wcs as defined in file + FK4, B1950              # sky coordinate systems FK5, J2000 GALACTIC ECLIPTIC ICRS -PHYSICAL                -# pixel coords of original file using LTM/LTV -AMPLIFIER               -# mosaic coords of original file using ATM/ATV -DETECTOR                -# mosaic coords of original file using DTM/DTV +PHYSICAL                # pixel coords of original file using LTM/LTV +AMPLIFIER               # mosaic coords of original file using ATM/ATV +DETECTOR                # mosaic coords of original file using DTM/DTV -WCS,WCSA-WCSZ           -# specify which WCS system to be used for -            -            # linear -and sky coordinate systems +WCS,WCSA-WCSZ           # specify which WCS system to be used for +                        # linear and sky coordinate systems -If no coordinate system is specified, PHYSICAL is -assumed. PHYSICAL or a World Coordinate System such as -J2000 is preferred and most general. The coordinate system -specifier should appear at the beginning of the region description, -on a separate line (in a file), or followed by a new-line or -semicolon; e.g., +If no coordinate system is specified, PHYSICAL is assumed. PHYSICAL or a World Coordinate System such as J2000 is preferred and most general. The coordinate system specifier should appear at the beginning of the region description, on a separate line (in a file), or followed by a new-line or semicolon; e.g., image; circle 100 100 10 physical; ellipse 200 200 10 20 fk5; point 30 50 wcsa; fk4; point 202 47 wcsp; linear; point 100 100 -The use of celestial input units automatically implies WORLD -coordinates of the reference image. Thus, if the world coordinate -system of the reference image is J2000, then +The use of celestial input units automatically implies WORLD coordinates of the reference image. Thus, if the world coordinate system of the reference image is J2000, then circle 10:10:0 20:22:0 3' is equivalent to: j2000; circle 10:10:0 20:22:0 3' -Note that by using units as described above, you may mix -coordinate systems within a region specifier; e.g., +Note that by using units as described above, you may mix coordinate systems within a region specifier; e.g., physical; circle 6500 9320 3' -Note that, for regions which accept a rotation angle such -as: +Note that, for regions which accept a rotation angle such as: ellipse (x, y, r1, r2, angle) box(x, y, w, h, angle) -the angle is relative to the specified coordinate system. In -particular, if the region is specified in WCS coordinates, the -angle is related to the WCS system, not x/y image coordinate axis. -For WCS systems with no rotation, this obviously is not an issue. -However, some images do define an implicit rotation (e.g., by using -a non-zero CROTA value in the WCS parameters) and for these images, -the angle will be relative to the WCS axes. In such case, a region -specification such as: -fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", -30) +the angle is relative to the specified coordinate system. In particular, if the region is specified in WCS coordinates, the angle is related to the WCS system, not x/y image coordinate axis. For WCS systems with no rotation, this obviously is not an issue. However, some images do define an implicit rotation (e.g., by using a non-zero CROTA value in the WCS parameters) and for these images, the angle will be relative to the WCS axes. In such case, a region specification such as: +fk4;ellipse(22:59:43.985, +58:45:26.92,320", 160", 30) will not, in general, be the same region specified as: -physical;ellipse(465, 578, 40, 20, -30) -even when positions and sizes match. The angle is relative to -WCS axes in the first case, and relative to physical x,y axes in -the second. +physical;ellipse(465, 578, 40, 20, 30) +even when positions and sizes match. The angle is relative to WCS axes in the first case, and relative to physical x,y axes in the second. -Composite -Region -A Composite Region is a region which is a collection of other -regions, which share common properties. A composite region is -composed of a center point and a rotation angle, of which all its -members are rendered in reference to. A composite region is defined -by the # composite x y angle declaration followed by a number of -regions who are or'd together. A composite region is manipulated as -a single region within ds9. A composite region maybe created from -the current selection of regions by selecting the Create Composite -Region menu option. Likewise, a composite region can be dissolved -by selecting the Dissolve Composite Region menu option. -Template -Region -A Template Region is a special form of a region which is saved -in a special wcs coordinate system WCS0. WCS0 indicates that the ra -and dec values are relative to the current WCS location, not -absolute. A template region can be loaded at any location into any -fits image which contains a valid wcs. For example, a user may -create a series of regions, which represent an instrument template. -Then, by selecting the Save As Template menu option, a template -region saved. The user may now load this templated into any other -fits image which contains a valid WCS. -External Region Files -DS9 can read and write a number of region file formats. Not all -formats support all the functionality of DS9 regions. Therefore, -the user may loose some information when writing and then reading -back from a region file in a format other that DS9. On output, the -regions File Format menu or the XPA -regions point is used specify the output coordinate system and -format. On input, the menu or xpa point is used only for the X -Y format. For all other formats, the input coordinate system -is specified in the regions file itself. +Composite Region +A Composite Region is a region which is a collection of other regions, which share common properties. A composite region is composed of a center point and a rotation angle, of which all its members are rendered in reference to. A composite region is defined by the # composite x y angle declaration followed by a number of regions who are or'd together. A composite region is manipulated as a single region within ds9. A composite region maybe created from the current selection of regions by selecting the Create Composite Region menu option. Likewise, a composite region can be dissolved by selecting the Dissolve Composite Region menu option. +Template Region +A Template Region is a special form of a region which is saved in a special wcs coordinate system WCS0. WCS0 indicates that the ra and dec values are relative to the current WCS location, not absolute. A template region can be loaded at any location into any fits image which contains a valid wcs. For example, a user may create a series of regions, which represent an instrument template. Then, by selecting the Save As Template menu option, a template region saved. The user may now load this templated into any other fits image which contains a valid WCS. +External Region Files +DS9 can read and write a number of region file formats. Not all formats support all the functionality of DS9 regions. Therefore, the user may loose some information when writing and then reading back from a region file in a format other that DS9. On output, the regions File Format menu or the XPA regions point is used specify the output coordinate system and format. On input, the menu or xpa point is used only for the X Y format. For all other formats, the input coordinate system is specified in the regions file itself. -Funtools - +Funtools When using DS9 regions file in FUNTOOLS: -LINE is ignored VECTOR is ignored -PROJECTION is ignored +LINE is ignored +VECTOR is ignored +PROJECTION is ignored SEGMENT is ignored -TEXT is ignored RULER is ignored -COMPASS is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored CIAO -When importing from CIAO into DS9: -POINT is translated into BOX CIRCLE POINT ROTBOX -is translated into BOX -RECTANGLE is translated into BOX PANDA is translated -as PIE +When importing from CIAO into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX +RECTANGLE is translated into BOX +PANDA is translated as PIE SECTOR is ignored -FIELD is ignored -REGION is ignored -When exporting from DS9 into CIAO: PANDA is translated -into PIE -LINE is ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored -ELLIPSE ANNULUS is ignored -BOX ANNULUS is ignored -EPANDA is ignored -BPANDA is ignored -SAOimage -When importing from SAOIMAGE into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX When exporting -from DS9 into SAOIMAGE: LINE is -ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored ELLIPSE ANNULUS -is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored +FIELD is ignored +REGION is ignored + +When exporting from DS9 into CIAO: +PANDA is translated into PIE +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +EPANDA is ignored +BPANDA is ignored +SAOimage +When importing from SAOIMAGE into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX + +When exporting from DS9 into SAOIMAGE: +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored IRAF PROS -When importing from PROS into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX When -exporting from DS9 into SAOIMAGE: LINE is -ignored -VECTOR is ignored -PROJECTION is ignored SEGMENT is -ignored TEXT is ignored -RULER is ignored -COMPASS is ignored ELLIPSE ANNULUS -is ignored -BOX ANNULUS is ignored -PANDA is ignored -EPANDA is ignored -BPANDA is ignored -FITS -REGION Binary Table -When importing from FITS REGION -into DS9: -POINT is translated into BOX CIRCLE POINT -ROTBOX is translated into -BOX -RECTANGLE is translated into BOX -ROTRECTANGLE is translated into a BOX -PIE is translated into PANDA +When importing from PROS into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX + +When exporting from DS9 into SAOIMAGE: +LINE is ignored +VECTOR is ignored +PROJECTION is ignored +SEGMENT is ignored +TEXT is ignored +RULER is ignored +COMPASS is ignored +ELLIPSE ANNULUS is ignored +BOX ANNULUS is ignored +PANDA is ignored +EPANDA is ignored +BPANDA is ignored +FITS REGION Binary Table +When importing from FITS REGION into DS9: +POINT is translated into BOX CIRCLE POINT +ROTBOX is translated into BOX +RECTANGLE is translated into BOX +ROTRECTANGLE is translated into a BOX +PIE is translated into PANDA ELLIPTANNULUS is translated into EPANDA -SECTOR is ignored -FIELD is ignored -DIAMOND is ignored RHOMBUS -is ignored ROTDIAMOND is -ignored ROTRHOMBUS is ignored - DS9 currently can not -export into this format. +SECTOR is ignored +FIELD is ignored +DIAMOND is ignored +RHOMBUS is ignored +ROTDIAMOND is ignored +ROTRHOMBUS is ignored + +DS9 currently can not export into this format. X Y -This format consists of a number of coordinate pairs, one per -line. The coordinate format for both input and output is specified -via the Save Regions Parameters menu or XPA regions point. The first two coordinates -are read, the rest of the line is ignored. The comment character -'#' may be used at the beginning of line and the line is ignored. -This format is very useful for reading in coordinates from other -external analysis programs, such as IRAF. -Example: # this is a comment -physical # this overrides the specified coordinate -system -300 300 -400 400 # this is a comment +This format consists of a number of coordinate pairs, one per line. The coordinate format for both input and output is specified via the Save Regions Parameters menu or XPA regions point. The first two coordinates are read, the rest of the line is ignored. The comment character '#' may be used at the beginning of line and the line is ignored. This format is very useful for reading in coordinates from other external analysis programs, such as IRAF. +Example: # this is a comment +physical # this overrides the specified coordinate system +300 300 +400 400 # this is a comment -- cgit v0.12 From 5fb1b1197abbafb1a560a40c3f87b6a54e62ef2f Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:42:59 -0400 Subject: clean up doc --- ds9/doc/ref/file.html | 668 +++++++++----------------------------------------- 1 file changed, 113 insertions(+), 555 deletions(-) diff --git a/ds9/doc/ref/file.html b/ds9/doc/ref/file.html index b1aebc8..ba76cfa 100644 --- a/ds9/doc/ref/file.html +++ b/ds9/doc/ref/file.html @@ -1,42 +1,33 @@ - - - + + + File Formats - - File Formats + + File Formats FITS FITS Image FITS Binary Events Table FITS HEALPIX Table FITS Data Cube -FITS Multiple Extension -Data Cube -FITS Multiple -Extension Multiple Frames +FITS Multiple Extension Data Cube +FITS Multiple Extension Multiple Frames FITS Mosaic FITS Mosaic Data Cube FITS RGB Split FITS Array -NRRD +NRRD ENVI GIF TIFF JPEG PNG External Format Support -External Analysis -Support +External Analysis Support Region Files Contour Files Color Lookup Table @@ -45,561 +36,165 @@ Support Startup File TCL FITS -DS9 supports FITS images and FITS binary tables. The following -algorithm is used to locate and to load the FITS image or table if -no additional information is provide: +DS9 supports FITS images and FITS binary tables. The following algorithm is used to locate and to load the FITS image or table if no additional information is provide: -Examine primary HDU, if IMAGE, load. +Examine primary HDU, if IMAGE, load. Examine each extension HDU -If IMAGE, load. -If BINARY TABLE, create IMAGE if the following is -true: +If IMAGE, load. +If BINARY TABLE, create IMAGE if the following is true: FITS COMPRESSED: keyword ZIMAGE is T. -FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, -column names X and Y are present. -FITS HEALPIX: keyword PIXTYPE is HEALPIX. +FITS EVENTS: keyword EXTNAME is EVENTS,STDEVT, or RAYEVENT, column names X and Y are present. +FITS HEALPIX: keyword PIXTYPE is HEALPIX. -If DS9 traverses the entire FITS file without satisfying -one of the above, an error is generated. +If DS9 traverses the entire FITS file without satisfying one of the above, an error is generated. -FITS keyword inheritance is supported. All valid FITS -BITPIX values are supported, along with -16, for -UNSIGNED SHORT. The following FITS keywords are supported: -OBJECT -UNITS -BSCALE / BZERO -BLANK -DATASEC -LTV / LTM for physical coords -DTV / DTM for detector coords -ATV / ATM for amplifier coords -WCS keywords -WCS# keywords +FITS keyword inheritance is supported. All valid FITS BITPIX values are supported, along with -16, for UNSIGNED SHORT. The following FITS keywords are supported: +OBJECT UNITS BSCALE / BZERO BLANK DATASEC LTV / LTM for physical coords DTV / DTM for detector coords ATV / ATM for amplifier coords WCS keywords WCS# keywords FITS Image -At load time, the user may provide just a file name or a file name -along with FITS extension name/number and image section -specification. FITS extension names are case insensitive. When -specifying an extension, be sure to quote strings correctly to pass -both the shell and DS9 parser. A image section specification is -used to specify the x,y limits of an image subsection. By default, -x and y coordinates are in IMAGE, use a 'p' as -the last character to indicate PHYSICAL coordinates. A -'*' indicates use the default for that axis only. Block is -optional and defaults to 1. -Syntax: -filename -filename[ext] -filename[ext][sect] -filename[sect] -filename[ext,sect] - -where - -ext: -[extension name | extension #] - -sect: -[x0:x1,y0:y1[p]] -[x0:x1,y0:y1,block[p]] - -[x0:x1,y0:y1,z0:z1[p]] - -[x0:x1,y0:y1,block,z0:z1[p]] - -[*,y0:y1[p]] -[*,y0:y1,block[p]] - -[*,y0:y1,z0:z1[p]] - -[*,y0:y1,block,z0:z1[p]] - -[x0:x1,*[p]] - -[x0:x1,*,block[p]] - -[x0:x1,*,z0:z1[p]] - -[x0:x1,*,block,z0:z1[p]] - -[*,*,block] - -[*,*,z0:z1] - -[*,*,block,z0:z1] - - -[dim1@xcen,dim2@ycen[p]] - -[dim1@xcen,dim2@ycen,block[p]] - -[dim1@xcen,dim2@ycen,dim3@zcen[p]] - -[dim1@xcen,dim2@ycen,block,dim3@zcen[p]] - -[*,dim2@ycen[p]] - -[*,dim2@ycen,block[p]] - -[*,dim2@ycen,dim3@zcen[p]] - -[*,dim2@ycen,block,dim3@zcen[p]] - -[dim1@xcen,*[p]] - -[dim1@xcen,*,block[p]] - -[dim1@xcen,*,dim3@zcen[p]] - -[dim1@xcen,*,block,dim3@zcen[p]] - -[*,*,block] - [*,*,dim3@zcen] -[*,*,block,dim3@zcen] - - -[dim@xcen@ycen] -[dim@xcen@ycen,block] -[dim@xcen@ycen,zdim@zcen] -[dim@xcen@ycen,block,zdim@zcen] - - -Example: -$ds9 foo.fits # default load -$ds9 foo.fits[1] # load first extension -$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' -$ds9 foo.fits[10:200,40:100] # image section $ds9 -foo.fits[10:200,40:100,2] # image section, blocked by 2 -$ds9 foo.fits[*,40:100] # only section y axis -$ds9 foo.fits[256@512@512] # section box at 512,512 -$ds9 foo.fits[2][100:200,100:200] # second extension, image -section $ds9 foo.fits[2][100:200,100:200,2] # -second extension, image section, blocked by 2 $ds9 -foo.fits[10:200,40:100,5:20] # cube section -$ds9 foo.fits[*,40:100,5:20] # only section y and z axes -$ds9 foo.fits[256@512@512] # section cube at 512,512 -$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube -section -$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, -cube section, blocked by 2 -FITS Binary Events Table - At load time, the user may provide just a file name or a -file name along with FITS extension name/number, image section -specification, and binnng parameters. DS9 will automatically -convert an FITS binary events table into a 2D image for display. -FITS extension names and parameters are case insensitive. The users -may specify a number of parameters on how to construct the image -and how to filter data. When specifying a filter, be sure to quote -strings correctly to pass both the shell and DS9 -parser. +At load time, the user may provide just a file name or a file name along with FITS extension name/number and image section specification. FITS extension names are case insensitive. When specifying an extension, be sure to quote strings correctly to pass both the shell and DS9 parser. A image section specification is used to specify the x,y limits of an image subsection. By default, x and y coordinates are in IMAGE, use a 'p' as the last character to indicate PHYSICAL coordinates. A '*' indicates use the default for that axis only. Block is optional and defaults to 1. +Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] where ext: [extension name | extension #] sect: [x0:x1,y0:y1[p]] [x0:x1,y0:y1,block[p]] [x0:x1,y0:y1,z0:z1[p]] [x0:x1,y0:y1,block,z0:z1[p]] [*,y0:y1[p]] [*,y0:y1,block[p]] [*,y0:y1,z0:z1[p]] [*,y0:y1,block,z0:z1[p]] [x0:x1,*[p]] [x0:x1,*,block[p]] [x0:x1,*,z0:z1[p]] [x0:x1,*,block,z0:z1[p]] [*,*,block] [*,*,z0:z1] [*,*,block,z0:z1] [dim1@xcen,dim2@ycen[p]] [dim1@xcen,dim2@ycen,block[p]] [dim1@xcen,dim2@ycen,dim3@zcen[p]] [dim1@xcen,dim2@ycen,block,dim3@zcen[p]] [*,dim2@ycen[p]] [*,dim2@ycen,block[p]] [*,dim2@ycen,dim3@zcen[p]] [*,dim2@ycen,block,dim3@zcen[p]] [dim1@xcen,*[p]] [dim1@xcen,*,block[p]] [dim1@xcen,*,dim3@zcen[p]] [dim1@xcen,*,block,dim3@zcen[p]] [*,*,block] [*,*,dim3@zcen] [*,*,block,dim3@zcen] [dim@xcen@ycen] [dim@xcen@ycen,block] [dim@xcen@ycen,zdim@zcen] [dim@xcen@ycen,block,zdim@zcen] Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' $ds9 foo.fits[10:200,40:100] # image section $ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 $ds9 foo.fits[*,40:100] # only section y axis $ds9 foo.fits[256@512@512] # section box at 512,512 $ds9 foo.fits[2][100:200,100:200] # second extension, image section $ds9 foo.fits[2][100:200,100:200,2] # second extension, image section, blocked by 2 $ds9 foo.fits[10:200,40:100,5:20] # cube section $ds9 foo.fits[*,40:100,5:20] # only section y and z axes $ds9 foo.fits[256@512@512] # section cube at 512,512 $ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube section $ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube section, blocked by 2 +FITS Binary Events Table + At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and binnng parameters. DS9 will automatically convert an FITS binary events table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image and how to filter data. When specifying a filter, be sure to quote strings correctly to pass both the shell and DS9 parser. -Syntax: -filename -filename[ext] -filename[ext][sect] -filename[sect] -filename[ext,sect] -filename[ext][bin] -filename[ext][bin][sect] -filename[ext][sect][bin] -filename[bin] -filename[bin][sect] -filename[sect][bin] filename[ext,bin] - where: -ext: see FITS Image -sect: see FITS Image - -bin: -[bin=colx,coly] # bin counts -[bin=colx,coly,filter] # bin counts with filter -[bin=colx,coly,colz] # bin on colz -[bin=colx,coly,colz,filter] # bin on colz with -filter [bin=colz] # bin cols 'x', 'y', and -colz [bin=colz,filter] # bin cols 'x', 'y', -and colz with filter [key=colx,coly] -[binkey=colx,coly] -(see Introduction -to Filtering) +Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] filename[ext][bin] filename[ext][bin][sect] filename[ext][sect][bin] filename[bin] filename[bin][sect] filename[sect][bin] filename[ext,bin] where: ext: see FITS Image sect: see FITS Image bin: [bin=colx,coly] # bin counts [bin=colx,coly,filter] # bin counts with filter [bin=colx,coly,colz] # bin on colz [bin=colx,coly,colz,filter] # bin on colz with filter [bin=colz] # bin cols 'x', 'y', and colz [bin=colz,filter] # bin cols 'x', 'y', and colz with filter [key=colx,coly] [binkey=colx,coly] +(see Introduction to Filtering) -Example: -$ds9 foo.fits # default load -$ds9 foo.fits[1] # load first extension -$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' -$ds9 foo.fits[bin=detx,dety] # bin on detx,dety -$ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols -rawx,rawy -$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, -cols rawx,rawy -$ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi -$ds9 foo.fits[bin=pi] # bin on x,y,pi -$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted -filter -$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double -quoted filter -$ds9 'foo.fits[events][pha>5,pi<2]' # load extension -'events' and filter +Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' $ds9 foo.fits[bin=detx,dety] # bin on detx,dety $ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy $ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols rawx,rawy $ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi $ds9 foo.fits[bin=pi] # bin on x,y,pi $ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted filter $ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double quoted filter $ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' and filter -The shell environment variable DS9_BINKEY may be used -to specify default bin cols for FITS bin tables. Example: -$ export DS9_BINKEY='[bin=rawx,rawy]' -$ ds9 foo.fits # load FITS bin table, bin on rawx, -rawy -FITS -HEALPIX Table -At load time, the user may provide just a file name or a file name -along with FITS extension name/number, image section specification, -and Healpix parameters. DS9 will automatically convert a FITS -HEALPIX binary or ascii table into a 2D image for display. FITS -extension names and parameters are case insensitive. The users may -specify a number of parameters on how to construct the image. Any -table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as -an HEALPIX image. The following FITS keywords will be used if -present and not overwritten by a command line option: NSIDE, -COORDSYS, ORDER. -Syntax: -filename -filename[ext] -filename[ext][sect] -filename[sect] -filename[ext,sect] - filename[ext][hpx] -filename[ext][hpx][sect] -filename[ext][sect][hpx] -filename[hpx] -filename[hpx][sect] -filename[sect][hpx] filename[ext,hpx] - where: ext: see -FITS -Image sect: see FITS -Image - -hpx: [order=ring|nested] # default ring -[layout=equatorial|north|south] # default equatorial -[col=<column number>] # defaut 1 -[quad=<quadurant number>] # (1-4) default 1 -[system=equatorial|galactic|ecliptic|unknown] # default -unknown - -Example: -$ds9 foo.fits # default load -$ds9 foo.fits[1] # load first extension -$ds9 -foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] - $ds9 foo.fits[1,order=nested] # first extension, nested -order -FITS -Cube -A FITS Cube is a FITS image which contains more than 2 axes -(NAXES>2). DS9 will automatically detect if a cube is present -and will load all additional images. In addition, individual images -can be loaded one at a time into a cube. DS9 will display the Cube -dialog box which allows the user to select which 2 image to be -displayed. -FITS Multiple Extension -Cube -A FITS Multiple Extension Data Cube file is a FITS file with one or -more extensions, that is to be displayed as a data cube. Each image -does not have to be the same size, however, only the coordinate -systems from the first extension will be used for contours and -grids. -Example: -$ds9 -mecube foo.fits # load multiple extension fits file as -data cube -FITS Multiple Extension -Multiple Frames -Load a multiple extension FITS file into multiple frames. Please -note that files loaded via standard-in or the xpa fits command can -not be displayed using this method. -Example: -$ds9 -multiframe foo.fits # load multiple extension fits file -as multiple frames +The shell environment variable DS9_BINKEY may be used to specify default bin cols for FITS bin tables. Example: +$ export DS9_BINKEY='[bin=rawx,rawy]' $ ds9 foo.fits # load FITS bin table, bin on rawx, rawy +FITS HEALPIX Table +At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and Healpix parameters. DS9 will automatically convert a FITS HEALPIX binary or ascii table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image. Any table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as an HEALPIX image. The following FITS keywords will be used if present and not overwritten by a command line option: NSIDE, COORDSYS, ORDER. +Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] filename[ext][hpx] filename[ext][hpx][sect] filename[ext][sect][hpx] filename[hpx] filename[hpx][sect] filename[sect][hpx] filename[ext,hpx] where: ext: see FITS Image sect: see FITS Image hpx: [order=ring|nested] # default ring [layout=equatorial|north|south] # default equatorial [col=<column number>] # defaut 1 [quad=<quadurant number>] # (1-4) default 1 [system=equatorial|galactic|ecliptic|unknown] # default unknown Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] $ds9 foo.fits[1,order=nested] # first extension, nested order +FITS Cube +A FITS Cube is a FITS image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a cube is present and will load all additional images. In addition, individual images can be loaded one at a time into a cube. DS9 will display the Cube dialog box which allows the user to select which 2 image to be displayed. +FITS Multiple Extension Cube +A FITS Multiple Extension Data Cube file is a FITS file with one or more extensions, that is to be displayed as a data cube. Each image does not have to be the same size, however, only the coordinate systems from the first extension will be used for contours and grids. +Example: $ds9 -mecube foo.fits # load multiple extension fits file as data cube +FITS Multiple Extension Multiple Frames +Load a multiple extension FITS file into multiple frames. Please note that files loaded via standard-in or the xpa fits command can not be displayed using this method. +Example: $ds9 -multiframe foo.fits # load multiple extension fits file as multiple frames FITS Mosaic -A FITS mosaic image may exist as a series of FITS files, or as one -FITS file with many extensions. A FITS mosaic may be loaded all a -one time, or by the segment. Once loaded, the multiple FITS images -are treated as one FITS image. +A FITS mosaic image may exist as a series of FITS files, or as one FITS file with many extensions. A FITS mosaic may be loaded all a one time, or by the segment. Once loaded, the multiple FITS images are treated as one FITS image. DS9 supports three forms of mosaics: - + +See NOAO IRAF Mosaic Data Structures - + - + IRAF contains the DETSEC and DETSIZE keywords. -See NOAO -IRAF Mosaic Data Structures WCS each FITS image contains a valid -WCS. each FITS image contains a valid WCS. HST WFPC2 valid HST WFPC2 data cube, -consisting of 4 planes, along with a fits ascii table containing -wcs information. valid HST WFPC2 data cube, consisting of 4 planes, along with a fits ascii table containing wcs information. -Example: -$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one -fits file with multiple exts -$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf -from 3 files -$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits -file with multiple exts -$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs -from 3 files -$ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic -$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) -from 3 files -FITS -Mosaic Data Cube -A FITS Mosaic Data Cube is a FITS mosaic image which contains more -than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic -data cube is present and will load all additional images. At the -same time, DS9 will display the data cube dialog box which allows -the user to select which 2 image to be displayed. +Example: $ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits file with multiple exts $ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf from 3 files $ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file with multiple exts $ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from 3 files $ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic $ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 files +FITS Mosaic Data Cube +A FITS Mosaic Data Cube is a FITS mosaic image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic data cube is present and will load all additional images. At the same time, DS9 will display the data cube dialog box which allows the user to select which 2 image to be displayed. FITS RGB -A FITS RGB image may exist as three of FITS images, one FITS file -with three extensions, or as a FITS 3D Data cube, with three -slices, each representing the red, green, and blue channel. A FITS -RGB image may be loaded all a one time, or by the channel. Once -loaded, the multiple FITS images are treated as one FITS image. -Example: -$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits -file with 3 image exts -$ds9 -rgbcube cube.fits # load rgb image consisting of one fits -data cube -$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb -image from 3 fits images +A FITS RGB image may exist as three of FITS images, one FITS file with three extensions, or as a FITS 3D Data cube, with three slices, each representing the red, green, and blue channel. A FITS RGB image may be loaded all a one time, or by the channel. Once loaded, the multiple FITS images are treated as one FITS image. +Example: $ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts $ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube $ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images Split FITS -A split fits is a valid fits file in which two files contain the -header and data segments. +A split fits is a valid fits file in which two files contain the header and data segments. Array -Raw data arrays are supported. To load an array, the user must -provide the dimensions, pixel depth, and optional header size and -architecture type. -Syntax: -filename[arr] -filename[arr][sect] filename[sect][arr] - -where -sect: see FITS -Image arr: -xdim=value -ydim=value -zdim=value # default is a depth of 1 -dim=value -dims=value -bitpix=[8|16|-16|32|64|-32|-64] -skip=value # must be even, most must be factor of 4 -arch|endian=[big|bigendian|little|littleendian] +Raw data arrays are supported. To load an array, the user must provide the dimensions, pixel depth, and optional header size and architecture type. +Syntax: filename[arr] filename[arr][sect] filename[sect][arr] where sect: see FITS Image arr: +xdim=value ydim=value zdim=value # default is a depth of 1 dim=value dims=value bitpix=[8|16|-16|32|64|-32|-64] skip=value # must be even, most must be factor of 4 arch|endian=[big|bigendian|little|littleendian] Example: -$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load -512x512 short -$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float -with 4 byte head -$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 -long, intel +$ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load 512x512 short +$ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float with 4 byte head +$ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 long, intel or alternate format: -filename[array(<type><dim><:skip><endian>)] - - -where: -type: -'b' 8 -bit unsigned char -'s' 16-bit short int -'u' 16-bit unsigned short int -'i' 32-bit int -'l' 64-bit int -'r' 32-bit float -'f' 32-bit float -'d' 64-bit float +filename[array(<type><dim><:skip><endian>)] where: type: +'b' 8 -bit unsigned char 's' 16-bit short int 'u' 16-bit unsigned short int 'i' 32-bit int 'l' 64-bit int 'r' 32-bit float 'f' 32-bit float 'd' 64-bit float dim: -int     # x,y dim -int.int # x,y dim -int.int.int # x,y,z dim +int     # x,y dim int.int # x,y dim int.int.int # x,y,z dim skip: -int     # number of bytes to -skip +int     # number of bytes to skip endian: -'l' little endian -'b' big endian -Example: -$ds9 -array bar.arr[array(s512)]   # load 512x512 -short -$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte -head -$ds9 -array bar.arr[array(i512l)] # load 512x512 long, -intel -The shell environment variable DS9_ARRAY may be used to -specify default array parameters. +'l' little endian 'b' big endian +Example: $ds9 -array bar.arr[array(s512)]   # load 512x512 short $ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte head $ds9 -array bar.arr[array(i512l)] # load 512x512 long, intel +The shell environment variable DS9_ARRAY may be used to specify default array parameters. Example: $export DS9_ARRAY='[dim=256,bitpix=-32]' $ds9 -array foo.arr # load 256x256 float -NRRD (Nearly Raw Raster -Data) -Images in NRRD are supported directly. Encodings supported: -raw, gzip -Syntax: -filename -filename[sect] -where: -sect: see FITS -Image -Example: -$ds9 -nrrd foo.nrrd -$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped +NRRD (Nearly Raw Raster Data) +Images in NRRD are supported directly. Encodings supported: raw, gzip +Syntax: filename filename[sect] where: sect: see FITS Image Example: $ds9 -nrrd foo.nrrd $ds9 -nrrd foo.nrrd[100:200,100:200] # cropped ENVI -Images in ENVI are supported directly. Encodings supported: -BIL, BIP, BSQ. -Syntax: -filename -filename[sect] - -where: -sect: see FITS -Image -Example: -$ds9 -envi foo.hdr foo.bsq +Images in ENVI are supported directly. Encodings supported: BIL, BIP, BSQ. +Syntax: filename filename[sect] where: sect: see FITS Image Example: $ds9 -envi foo.hdr foo.bsq $ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped GIF -Images in GIF are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly. - -Syntax: -filename - -Example: $ ds9 -gif foo.gif +Images in GIF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. + Syntax: filename Example: $ ds9 -gif foo.gif TIFF -Images in TIFF are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly. +Images in TIFF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. -Syntax: -filename - -Example: -$ ds9 -tiff foo.tiff +Syntax: filename Example: $ ds9 -tiff foo.tiff JPEG -Images in JPEG are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly. - -Syntax: -filename - -Example: -$ ds9 -jpeg foo.jpeg +Images in JPEG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. + Syntax: filename Example: $ ds9 -jpeg foo.jpeg PNG -Images in PNG are supported directly. For a Frame, the -average of the luminosity is used. For Frame RGB, each -channel is loaded directly. +Images in PNG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. -Syntax: -filename - -Example: -$ ds9 -png foo.png -External File Support -DS9 supports external file formats via an ASCII description file. -When loading a file into DS9, these descriptions are referenced for -instructions for loading the file, based on the file extension. If -found, the command is executed and the result, a FITS image or FITS -Binary Table, is read into DS9 via stdin. -At start-up, DS9 first searches for the ASCII file, named -.ds9.filin the local directory, then in the users home -directory. -The file command first is macro-expanded to fill in user-defined -arguments and then is executed externally. -The ASCII file that defines the known image files consists of one -or more file descriptors, each of which has the following format: +Syntax: filename Example: $ ds9 -png foo.png +External File Support +DS9 supports external file formats via an ASCII description file. When loading a file into DS9, these descriptions are referenced for instructions for loading the file, based on the file extension. If found, the command is executed and the result, a FITS image or FITS Binary Table, is read into DS9 via stdin. +At start-up, DS9 first searches for the ASCII file, named .ds9.filin the local directory, then in the users home directory. +The file command first is macro-expanded to fill in user-defined arguments and then is executed externally. +The ASCII file that defines the known image files consists of one or more file descriptors, each of which has the following format: Help description A space-separated list of templates A space-separated list of file types (not currently used) -The command line for the loading this file -type -Note that blank lines separate the file descriptions and should not -be used as part of a description. Also, the '#' character is a -comment character. +The command line for the loading this file type +Note that blank lines separate the file descriptions and should not be used as part of a description. Also, the '#' character is a comment character. The following macros are supported: $filename -For Example: -# File access descriptions: -#       help explanation -#       file template -#       file type -#       access command -IRAF IMH files -*.imh -IMH -i2f -s $filename -External Analysis Support -For more information about external analysis support files, see -Analysis. -Region -Files -DS9 can read and write a number of region file formats. See -Regions documentation for more -information. -DS9 +For Example: # File access descriptions: #       help explanation #       file template #       file type #       access command IRAF IMH files *.imh IMH i2f -s $filename +External Analysis Support +For more information about external analysis support files, see Analysis. +Region Files +DS9 can read and write a number of region file formats. See Regions documentation for more information. +DS9 FUNTools Ciao SAOimage IRAF PROS -FITS REGION Binary -Table +FITS REGION Binary Table X Y -Contour -Files -See Contours -documentation for more information. -Color -Lookup Table -DS9 has a number of default colormaps available to the user. DS9 -also supports reading and writing color lookup table formats from -the following programs: - -SAOimage -SAOtng - +Contour Files +See Contours documentation for more information. +Color Lookup Table +DS9 has a number of default colormaps available to the user. DS9 also supports reading and writing color lookup table formats from the following programs: +SAOimage +SAOtng XImtool DS9 uses the file extension to determine the color table format: - + - - + + Ext @@ -622,61 +217,24 @@ DS9 uses the file extension to determine the color table format: WCS -A new WCS specification can be loaded and used by the current image -regardless of the WCS that was contained in the image file. WCS -specification can be sent to DS9 as an ASCII file via XPA. The -format of the specification is a set of valid FITS keywords that -describe a WCS. +A new WCS specification can be loaded and used by the current image regardless of the WCS that was contained in the image file. WCS specification can be sent to DS9 as an ASCII file via XPA. The format of the specification is a set of valid FITS keywords that describe a WCS. Example: -    CRPIX1 -=               -257.75 -    CRPIX2 -=               -258.93 -    CRVAL1 =      --201.94541667302 -    CRVAL2 -=             --47.45444 -    CDELT1 -=        -2.1277777E-4 -    CDELT2 -=         2.1277777E-4 +    CRPIX1 =               257.75 +    CRPIX2 =               258.93 +    CRVAL1 =      -201.94541667302 +    CRVAL2 =             -47.45444 +    CDELT1 =        -2.1277777E-4 +    CDELT2 =         2.1277777E-4     CTYPE1 = 'RA---TAN'     CTYPE2 = 'DEC--TAN' -Note that the WCS definitions can contain standard FITS 80 -character WCS card images, as shown above, or free-form name/value -pairs without the intervening "=" sign: -    CRPIX1    -257.75 -    CRPIX2    258.93 -    CRVAL1    -201.94541667302 -    CRVAL2    -47.45444 -    CDELT1    -2.1277777E-4 -    CDELT2    2.1277777E-4 -    CTYPE1   'RA---TAN' -    CTYPE2   'DEC--TAN' -Preference -File -A preference file is a valid tcl script generated by DS9 to save -the current preference items. See Preferences for more information. -Startup -File -If a startup file $HOME/ds9.ini is available, it is -sourced as the last step in initialization. The file permissions -must be group/world readonly. -Users may have several different startup files. DS9 looks for a -startup file with its own name. By default, if the application is -named ds9, it will look for .ds9.ini. However, if -the DS9 application is named foo, then DS9 will look for -.foo.ini. In this manner, the user can have several -predefined startup files that are activated by invoking DS9 with a -different application names. +Note that the WCS definitions can contain standard FITS 80 character WCS card images, as shown above, or free-form name/value pairs without the intervening "=" sign: +    CRPIX1    257.75     CRPIX2    258.93     CRVAL1    -201.94541667302     CRVAL2    -47.45444     CDELT1    -2.1277777E-4     CDELT2    2.1277777E-4     CTYPE1   'RA---TAN'     CTYPE2   'DEC--TAN' +Preference File +A preference file is a valid tcl script generated by DS9 to save the current preference items. See Preferences for more information. +Startup File +If a startup file $HOME/ds9.ini is available, it is sourced as the last step in initialization. The file permissions must be group/world readonly. +Users may have several different startup files. DS9 looks for a startup file with its own name. By default, if the application is named ds9, it will look for .ds9.ini. However, if the DS9 application is named foo, then DS9 will look for .foo.ini. In this manner, the user can have several predefined startup files that are activated by invoking DS9 with a different application names. TCL -TCL/TK script file. Users may customize the appearance and enhance -the capabilities of DS9 by sourcing their own TCL -scripts. +TCL/TK script file. Users may customize the appearance and enhance the capabilities of DS9 by sourcing their own TCL scripts. -- cgit v0.12 From afadb7ab3d41f2eb64a0582db3aa3feb3c0712b7 Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:44:23 -0400 Subject: clean up doc --- ds9/doc/ref/file.html | 284 +++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 259 insertions(+), 25 deletions(-) diff --git a/ds9/doc/ref/file.html b/ds9/doc/ref/file.html index ba76cfa..32fda5a 100644 --- a/ds9/doc/ref/file.html +++ b/ds9/doc/ref/file.html @@ -58,32 +58,176 @@ DS9 supports FITS images and FITS binary tables. The following algorithm is used FITS keyword inheritance is supported. All valid FITS BITPIX values are supported, along with -16, for UNSIGNED SHORT. The following FITS keywords are supported: -OBJECT UNITS BSCALE / BZERO BLANK DATASEC LTV / LTM for physical coords DTV / DTM for detector coords ATV / ATM for amplifier coords WCS keywords WCS# keywords +OBJECT +UNITS +BSCALE / BZERO +BLANK +DATASEC +LTV / LTM for physical coords +DTV / DTM for detector coords +ATV / ATM for amplifier coords +WCS keywords +WCS# keywords FITS Image At load time, the user may provide just a file name or a file name along with FITS extension name/number and image section specification. FITS extension names are case insensitive. When specifying an extension, be sure to quote strings correctly to pass both the shell and DS9 parser. A image section specification is used to specify the x,y limits of an image subsection. By default, x and y coordinates are in IMAGE, use a 'p' as the last character to indicate PHYSICAL coordinates. A '*' indicates use the default for that axis only. Block is optional and defaults to 1. -Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] where ext: [extension name | extension #] sect: [x0:x1,y0:y1[p]] [x0:x1,y0:y1,block[p]] [x0:x1,y0:y1,z0:z1[p]] [x0:x1,y0:y1,block,z0:z1[p]] [*,y0:y1[p]] [*,y0:y1,block[p]] [*,y0:y1,z0:z1[p]] [*,y0:y1,block,z0:z1[p]] [x0:x1,*[p]] [x0:x1,*,block[p]] [x0:x1,*,z0:z1[p]] [x0:x1,*,block,z0:z1[p]] [*,*,block] [*,*,z0:z1] [*,*,block,z0:z1] [dim1@xcen,dim2@ycen[p]] [dim1@xcen,dim2@ycen,block[p]] [dim1@xcen,dim2@ycen,dim3@zcen[p]] [dim1@xcen,dim2@ycen,block,dim3@zcen[p]] [*,dim2@ycen[p]] [*,dim2@ycen,block[p]] [*,dim2@ycen,dim3@zcen[p]] [*,dim2@ycen,block,dim3@zcen[p]] [dim1@xcen,*[p]] [dim1@xcen,*,block[p]] [dim1@xcen,*,dim3@zcen[p]] [dim1@xcen,*,block,dim3@zcen[p]] [*,*,block] [*,*,dim3@zcen] [*,*,block,dim3@zcen] [dim@xcen@ycen] [dim@xcen@ycen,block] [dim@xcen@ycen,zdim@zcen] [dim@xcen@ycen,block,zdim@zcen] Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' $ds9 foo.fits[10:200,40:100] # image section $ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 $ds9 foo.fits[*,40:100] # only section y axis $ds9 foo.fits[256@512@512] # section box at 512,512 $ds9 foo.fits[2][100:200,100:200] # second extension, image section $ds9 foo.fits[2][100:200,100:200,2] # second extension, image section, blocked by 2 $ds9 foo.fits[10:200,40:100,5:20] # cube section $ds9 foo.fits[*,40:100,5:20] # only section y and z axes $ds9 foo.fits[256@512@512] # section cube at 512,512 $ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube section $ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube section, blocked by 2 +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +where + +ext: +[extension name | extension #] + +sect: +[x0:x1,y0:y1[p]] +[x0:x1,y0:y1,block[p]] +[x0:x1,y0:y1,z0:z1[p]] +[x0:x1,y0:y1,block,z0:z1[p]] +[*,y0:y1[p]] +[*,y0:y1,block[p]] +[*,y0:y1,z0:z1[p]] +[*,y0:y1,block,z0:z1[p]] +[x0:x1,*[p]] +[x0:x1,*,block[p]] +[x0:x1,*,z0:z1[p]] +[x0:x1,*,block,z0:z1[p]] +[*,*,block] +[*,*,z0:z1] +[*,*,block,z0:z1] + +[dim1@xcen,dim2@ycen[p]] +[dim1@xcen,dim2@ycen,block[p]] +[dim1@xcen,dim2@ycen,dim3@zcen[p]] +[dim1@xcen,dim2@ycen,block,dim3@zcen[p]] +[*,dim2@ycen[p]] +[*,dim2@ycen,block[p]] +[*,dim2@ycen,dim3@zcen[p]] +[*,dim2@ycen,block,dim3@zcen[p]] +[dim1@xcen,*[p]] +[dim1@xcen,*,block[p]] +[dim1@xcen,*,dim3@zcen[p]] +[dim1@xcen,*,block,dim3@zcen[p]] +[*,*,block] +[*,*,dim3@zcen] +[*,*,block,dim3@zcen] + +[dim@xcen@ycen] +[dim@xcen@ycen,block] +[dim@xcen@ycen,zdim@zcen] +[dim@xcen@ycen,block,zdim@zcen] + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' +$ds9 foo.fits[10:200,40:100] # image section +$ds9 foo.fits[10:200,40:100,2] # image section, blocked by 2 +$ds9 foo.fits[*,40:100] # only section y axis +$ds9 foo.fits[256@512@512] # section box at 512,512 +$ds9 foo.fits[2][100:200,100:200] # second extension, image section +$ds9 foo.fits[2][100:200,100:200,2] # second extension, image section, blocked by 2 +$ds9 foo.fits[10:200,40:100,5:20] # cube section +$ds9 foo.fits[*,40:100,5:20] # only section y and z axes +$ds9 foo.fits[256@512@512] # section cube at 512,512 +$ds9 foo.fits[2][100:200,100:200,5:20] # second extension, cube section +$ds9 foo.fits[2][100:200,100:200,2,5:20] # second extension, cube section, blocked by 2 FITS Binary Events Table At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and binnng parameters. DS9 will automatically convert an FITS binary events table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image and how to filter data. When specifying a filter, be sure to quote strings correctly to pass both the shell and DS9 parser. -Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] filename[ext][bin] filename[ext][bin][sect] filename[ext][sect][bin] filename[bin] filename[bin][sect] filename[sect][bin] filename[ext,bin] where: ext: see FITS Image sect: see FITS Image bin: [bin=colx,coly] # bin counts [bin=colx,coly,filter] # bin counts with filter [bin=colx,coly,colz] # bin on colz [bin=colx,coly,colz,filter] # bin on colz with filter [bin=colz] # bin cols 'x', 'y', and colz [bin=colz,filter] # bin cols 'x', 'y', and colz with filter [key=colx,coly] [binkey=colx,coly] +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +filename[ext][bin] +filename[ext][bin][sect] +filename[ext][sect][bin] +filename[bin] +filename[bin][sect] +filename[sect][bin] +filename[ext,bin] + +where: +ext: seeFITS Image +sect: seeFITS Image + +bin: +[bin=colx,coly] # bin counts +[bin=colx,coly,filter] # bin counts with filter +[bin=colx,coly,colz] # bin on colz +[bin=colx,coly,colz,filter] # bin on colz with filter +[bin=colz] # bin cols 'x', 'y', and colz +[bin=colz,filter] # bin cols 'x', 'y', and colz with filter +[key=colx,coly] +[binkey=colx,coly] (see Introduction to Filtering) -Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' $ds9 foo.fits[bin=detx,dety] # bin on detx,dety $ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy $ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols rawx,rawy $ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi $ds9 foo.fits[bin=pi] # bin on x,y,pi $ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted filter $ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double quoted filter $ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' and filter +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD' +$ds9 foo.fits[bin=detx,dety] # bin on detx,dety +$ds9 foo.fits[2][bin=rawx,rawy] # load ext 2, cols rawx,rawy +$ds9 foo.fits[bg_events,bin=rawx,rawy] # load ext bg_events, cols rawx,rawy +$ds9 foo.fits[bin=x,y,pha] # bin on x,y,pi +$ds9 foo.fits[bin=pi] # bin on x,y,pi +$ds9 'foo.fits[ccd_id==3&&energy>4000]' # quoted filter +$ds9 '"foo.fits[ccd_id==3 && energy>4000]"' # double quoted filter +$ds9 'foo.fits[events][pha>5,pi<2]' # load extension 'events' and filter The shell environment variable DS9_BINKEY may be used to specify default bin cols for FITS bin tables. Example: -$ export DS9_BINKEY='[bin=rawx,rawy]' $ ds9 foo.fits # load FITS bin table, bin on rawx, rawy +$ export DS9_BINKEY='[bin=rawx,rawy]' +$ ds9 foo.fits # load FITS bin table, bin on rawx, rawy FITS HEALPIX Table At load time, the user may provide just a file name or a file name along with FITS extension name/number, image section specification, and Healpix parameters. DS9 will automatically convert a FITS HEALPIX binary or ascii table into a 2D image for display. FITS extension names and parameters are case insensitive. The users may specify a number of parameters on how to construct the image. Any table with keyword PIXTYPE=HEALPIX or NSIDE=x will be processed as an HEALPIX image. The following FITS keywords will be used if present and not overwritten by a command line option: NSIDE, COORDSYS, ORDER. -Syntax: filename filename[ext] filename[ext][sect] filename[sect] filename[ext,sect] filename[ext][hpx] filename[ext][hpx][sect] filename[ext][sect][hpx] filename[hpx] filename[hpx][sect] filename[sect][hpx] filename[ext,hpx] where: ext: see FITS Image sect: see FITS Image hpx: [order=ring|nested] # default ring [layout=equatorial|north|south] # default equatorial [col=<column number>] # defaut 1 [quad=<quadurant number>] # (1-4) default 1 [system=equatorial|galactic|ecliptic|unknown] # default unknown Example: $ds9 foo.fits # default load $ds9 foo.fits[1] # load first extension $ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] $ds9 foo.fits[1,order=nested] # first extension, nested order +Syntax: +filename +filename[ext] +filename[ext][sect] +filename[sect] +filename[ext,sect] + +filename[ext][hpx] +filename[ext][hpx][sect] +filename[ext][sect][hpx] +filename[hpx] +filename[hpx][sect] +filename[sect][hpx] +filename[ext,hpx] + +where: +ext: seeFITS Image +sect: seeFITS Image + +hpx: +[order=ring|nested] # default ring +[layout=equatorial|north|south] # default equatorial +[col=<column number>] # defaut 1 +[quad=<quadurant number>] # (1-4) default 1 +[system=equatorial|galactic|ecliptic|unknown] # default unknown + +Example: +$ds9 foo.fits # default load +$ds9 foo.fits[1] # load first extension +$ds9 foo.fits[order=ring,layout=equatorial,col=1,quad=1,system=unknown] +$ds9 foo.fits[1,order=nested] # first extension, nested order FITS Cube A FITS Cube is a FITS image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a cube is present and will load all additional images. In addition, individual images can be loaded one at a time into a cube. DS9 will display the Cube dialog box which allows the user to select which 2 image to be displayed. FITS Multiple Extension Cube A FITS Multiple Extension Data Cube file is a FITS file with one or more extensions, that is to be displayed as a data cube. Each image does not have to be the same size, however, only the coordinate systems from the first extension will be used for contours and grids. -Example: $ds9 -mecube foo.fits # load multiple extension fits file as data cube +Example: +$ds9 -mecube foo.fits # load multiple extension fits file as data cube FITS Multiple Extension Multiple Frames Load a multiple extension FITS file into multiple frames. Please note that files loaded via standard-in or the xpa fits command can not be displayed using this method. -Example: $ds9 -multiframe foo.fits # load multiple extension fits file as multiple frames +Example: +$ds9 -multiframe foo.fits # load multiple extension fits file as multiple frames FITS Mosaic A FITS mosaic image may exist as a series of FITS files, or as one FITS file with many extensions. A FITS mosaic may be loaded all a one time, or by the segment. Once loaded, the multiple FITS images are treated as one FITS image. @@ -107,57 +251,131 @@ See NOA -Example: $ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits file with multiple exts $ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf from 3 files $ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file with multiple exts $ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from 3 files $ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic $ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 files +Example: +$ds9 -mosaicimage iraf foo.fits # load mosaic iraf from one fits file with multiple exts +$ds9 -mosaic iraf foo.fits bar.fits wow.fits # load mosaic iraf from 3 files +$ds9 -mosaicimage wcs foo.fits # load mosaic wcs from one fits file with multiple exts +$ds9 -mosaic wcs foo.fits bar.fits wow.fits # load mosaic wcs from 3 files +$ds9 -mosaicimage wfpc2 bar.fits # load wfpc2 mosaic +$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (wcs) from 3 files FITS Mosaic Data Cube A FITS Mosaic Data Cube is a FITS mosaic image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic data cube is present and will load all additional images. At the same time, DS9 will display the data cube dialog box which allows the user to select which 2 image to be displayed. FITS RGB A FITS RGB image may exist as three of FITS images, one FITS file with three extensions, or as a FITS 3D Data cube, with three slices, each representing the red, green, and blue channel. A FITS RGB image may be loaded all a one time, or by the channel. Once loaded, the multiple FITS images are treated as one FITS image. -Example: $ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts $ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube $ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images +Example: +$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts +$ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube +$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images Split FITS A split fits is a valid fits file in which two files contain the header and data segments. Array Raw data arrays are supported. To load an array, the user must provide the dimensions, pixel depth, and optional header size and architecture type. -Syntax: filename[arr] filename[arr][sect] filename[sect][arr] where sect: see FITS Image arr: -xdim=value ydim=value zdim=value # default is a depth of 1 dim=value dims=value bitpix=[8|16|-16|32|64|-32|-64] skip=value # must be even, most must be factor of 4 arch|endian=[big|bigendian|little|littleendian] +Syntax: +filename[arr] +filename[arr][sect] +filename[sect][arr] + +where +sect: seeFITS Image +arr: +xdim=value +ydim=value +zdim=value # default is a depth of 1 +dim=value +dims=value +bitpix=[8|16|-16|32|64|-32|-64] +skip=value # must be even, most must be factor of 4 +arch|endian=[big|bigendian|little|littleendian] Example: $ds9 -array bar.arr[xdim=512,ydim=512,zdim=1,bitpix=16] # load 512x512 short $ds9 -array bar.arr[dim=256,bitpix=-32,skip=4] # load 256x256 float with 4 byte head $ds9 -array bar.arr[dim=512,bitpix=32,arch=little] # load 512x512 long, intel or alternate format: -filename[array(<type><dim><:skip><endian>)] where: type: -'b' 8 -bit unsigned char 's' 16-bit short int 'u' 16-bit unsigned short int 'i' 32-bit int 'l' 64-bit int 'r' 32-bit float 'f' 32-bit float 'd' 64-bit float +filename[array(<type><dim><:skip><endian>)] + +where: +type: +'b' 8 -bit unsigned char +'s' 16-bit short int +'u' 16-bit unsigned short int +'i' 32-bit int +'l' 64-bit int +'r' 32-bit float +'f' 32-bit float +'d' 64-bit float dim: -int     # x,y dim int.int # x,y dim int.int.int # x,y,z dim +int     # x,y dim +int.int # x,y dim +int.int.int # x,y,z dim skip: int     # number of bytes to skip endian: -'l' little endian 'b' big endian -Example: $ds9 -array bar.arr[array(s512)]   # load 512x512 short $ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte head $ds9 -array bar.arr[array(i512l)] # load 512x512 long, intel +'l' little endian +'b' big endian +Example: +$ds9 -array bar.arr[array(s512)]   # load 512x512 short +$ds9 -array bar.arr[array(r256:4)] # load 256x256 float with 4 byte head +$ds9 -array bar.arr[array(i512l)] # load 512x512 long, intel The shell environment variable DS9_ARRAY may be used to specify default array parameters. Example: $export DS9_ARRAY='[dim=256,bitpix=-32]' $ds9 -array foo.arr # load 256x256 float NRRD (Nearly Raw Raster Data) Images in NRRD are supported directly. Encodings supported: raw, gzip -Syntax: filename filename[sect] where: sect: see FITS Image Example: $ds9 -nrrd foo.nrrd $ds9 -nrrd foo.nrrd[100:200,100:200] # cropped +Syntax: +filename +filename[sect] + +where: +sect: seeFITS Image + +Example: +$ds9 -nrrd foo.nrrd +$ds9 -nrrd foo.nrrd[100:200,100:200] # cropped ENVI Images in ENVI are supported directly. Encodings supported: BIL, BIP, BSQ. -Syntax: filename filename[sect] where: sect: see FITS Image Example: $ds9 -envi foo.hdr foo.bsq +Syntax: +filename +filename[sect] + +where: +sect: seeFITS Image + +Example: +$ds9 -envi foo.hdr foo.bsq $ds9 -envi foo.hdr foo.bsq[100:200,100:200] # cropped GIF Images in GIF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. - Syntax: filename Example: $ ds9 -gif foo.gif + +Syntax: +filename + +Example: +$ ds9 -gif foo.gif TIFF Images in TIFF are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. -Syntax: filename Example: $ ds9 -tiff foo.tiff +Syntax: +filename + +Example: +$ ds9 -tiff foo.tiff JPEG Images in JPEG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. - Syntax: filename Example: $ ds9 -jpeg foo.jpeg + +Syntax: +filename + +Example: +$ ds9 -jpeg foo.jpeg PNG Images in PNG are supported directly. For a Frame, the average of the luminosity is used. For Frame RGB, each channel is loaded directly. -Syntax: filename Example: $ ds9 -png foo.png +Syntax: +filename + +Example: +$ ds9 -png foo.png External File Support DS9 supports external file formats via an ASCII description file. When loading a file into DS9, these descriptions are referenced for instructions for loading the file, based on the file extension. If found, the command is executed and the result, a FITS image or FITS Binary Table, is read into DS9 via stdin. At start-up, DS9 first searches for the ASCII file, named .ds9.filin the local directory, then in the users home directory. @@ -170,7 +388,16 @@ The command line for the loading this file type Note that blank lines separate the file descriptions and should not be used as part of a description. Also, the '#' character is a comment character. The following macros are supported: $filename -For Example: # File access descriptions: #       help explanation #       file template #       file type #       access command IRAF IMH files *.imh IMH i2f -s $filename +For Example: +# File access descriptions: +#       help explanation +#       file template +#       file type +#       access command +IRAF IMH files +*.imh +IMH +i2f -s $filename External Analysis Support For more information about external analysis support files, see Analysis. Region Files @@ -228,7 +455,14 @@ A new WCS specification can be loaded and used by the current image regardless o     CTYPE1 = 'RA---TAN'     CTYPE2 = 'DEC--TAN' Note that the WCS definitions can contain standard FITS 80 character WCS card images, as shown above, or free-form name/value pairs without the intervening "=" sign: -    CRPIX1    257.75     CRPIX2    258.93     CRVAL1    -201.94541667302     CRVAL2    -47.45444     CDELT1    -2.1277777E-4     CDELT2    2.1277777E-4     CTYPE1   'RA---TAN'     CTYPE2   'DEC--TAN' +    CRPIX1    257.75 +    CRPIX2    258.93 +    CRVAL1    -201.94541667302 +    CRVAL2    -47.45444 +    CDELT1    -2.1277777E-4 +    CDELT2    2.1277777E-4 +    CTYPE1   'RA---TAN' +    CTYPE2   'DEC--TAN' Preference File A preference file is a valid tcl script generated by DS9 to save the current preference items. See Preferences for more information. Startup File -- cgit v0.12 From 4dff7984d98eccdbae86d9ac70c8c80952f052bb Mon Sep 17 00:00:00 2001 From: William Joye Date: Tue, 30 Apr 2019 15:45:04 -0400 Subject: clean up doc --- make.include | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/make.include b/make.include index 7c09f9b..d3bda41 100644 --- a/make.include +++ b/make.include @@ -420,7 +420,7 @@ language: tidy : $(call Tidy,ds9/doc) $(call Tidy,ds9/doc/release) -# $(call Tidy,ds9/doc/ref) + $(call Tidy,ds9/doc/ref) #-------------------------- scrub -- cgit v0.12

Coordinate System	Keyword Values
`WCS / WCSA...WCSZ`
`WCS / WCSA...WCSZ`	`CRVAL,CRPIX,CRDELT,CD... (for images) TCRVL,TCRPX,TCDLT,... (for tables)`

`IRAF` -	`contains the DETSEC and DETSIZE - keywords. - See NOAO -IRAF - Mosaic Data Structures` -
`WCS` -	`each FITS image contains - a valid - WCS.` -
`HST WFPC2` -	`valid HST WFPC2 data - cube, - consisting of 4 planes, along with a fits ascii table - containing - wcs information.`

Key Stroke
`Right` `Arrow l`	Will move selected regions to the right one -pixel. +	Will move selected regions to the right one pixel. In Pointer mode, will move the cursor to the right one pixel. -In Crosshair mode, will move the crosshair to the right one -pixel. +In Crosshair mode, will move the crosshair to the right one pixel. In Pan mode, will pan the image to the right one pixel.
Will move selected regions to the left one pixel. In Pointer mode, will move the cursor to the left one pixel. -In Crosshair mode, will move the crosshair to the left one -pixel. +In Crosshair mode, will move the crosshair to the left one pixel. In Pan mode, will pan the image to the left one pixel.
`Shift`-`Drag`	In Pointer mode, will select all regions within the indicated -region. -In Crop mode, for 3D frame, will move front crop plane -forward.	`Shift`-`Drag`	In Pointer mode, will select all regions within the indicated region. +In Crop mode, for 3D frame, will move front crop plane forward.
`Control-Drag`	In Poiner mode, on selected `ANNULUS` Regions, will -create new radii. -In Crop mode, for 3D frame, will move back crop plane -backward.	In Poiner mode, on selected `ANNULUS` Regions, will create new radii. +In Crop mode, for 3D frame, will move back crop plane backward.
Command-`

- `Ext` -	- `Format` -
`.lut`	`XImtool, SAOtng`
`.sao`	`DS9, SAOimage`
`any other`	`DS9`

`IRAF`	`contains the DETSEC and DETSIZE keywords. +See NOAO +IRAF Mosaic Data Structures`
`WCS`	`each FITS image contains a valid +WCS.`
`HST WFPC2`	`valid HST WFPC2 data cube, +consisting of 4 planes, along with a fits ascii table containing +wcs information.`

How It -Works	Backup and -Restore	File -Formats	How It Works	Backup and Restore	File Formats
Mouse -and Keyboard	Coordinate -Grids	Preferences	Mouse and Keyboard	Coordinate Grids	Preferences
Command -Line Options	Catalogs	3-D -Frames	Command Line Options	Catalogs	3-D Frames
XPA Access -Points	Colorbar	Contours	XPA Access Points	Colorbar	Contours
SAMP	Printing	IRAF -Support	SAMP	Printing	IRAF Support
Regions	Analysis	Binning	Regions	Analysis	Binning

@@ -30,57 +24,38 @@ buttons.
Button 1	Depends on current MODE, which may be selected by the EDIT menu -option. +	Depends on current MODE, which may be selected by the EDIT menu option. In Region mode, create/edit/delete regions. In Crosshair mode, will move current crosshair. In Colorbar mode, will change contrast and bias of colormap. In Pan mode, will move or pan to clicked location. In Zoom mode, will zoom about clicked location. In Rotate mode, will rotate image about center. -In Crop mode, will select 2-D crop region. For 3-D -Shift-click will edit front clip plane, Control-click -will edit back clip plane. +In Crop mode, will select 2-D crop region. For 3-D Shift-click will edit front clip plane, Control-click will edit back clip plane. In Catalog mode, will select catalog regions. In examine mode, will follow IRAF examine protocol.
Button 2	Pan mode: will move or pan to clicked location. Behavior -depends on the PAN preference settings.	Pan mode: will move or pan to clicked location. Behavior depends on the PAN preference settings.
Button 3	Colorbar mode: will change the contrast and bias of the -colormap.	Colorbar mode: will change the contrast and bias of the colormap.

+`Ext` +	+`Format` +
`.lut`	`XImtool, SAOtng`
`.sao`	`DS9, SAOimage`
`any other`	`DS9`

+
`Ext`	@@ -622,61 +217,24 @@ DS9 uses the file extension to determine the color table format:

- SAOImageDS9 Version 5 Release Notes

SAOImageDS9 Version 5 Release Notes

SAOImageDS9 Version 8.1 Release Notes

SAOImageDS9 Version 8.1 Release Notes

SAOImageDS9 Version 1.5 Release Notes

SAOImageDS9 Version 1.5 Release Notes

Version 1.5

SAOImageDS9 Version 1.6 Release Notes

SAOImageDS9 Version 1.6 Release Notes

Version 1.6.1

SAOImageDS9 Version 1.7 Release Notes

SAOImageDS9 Version 1.7 Release Notes

Version 1.7.2

SAOImageDS9 Version 1.8 Release Notes

SAOImageDS9 Version 1.8 Release Notes

Version 1.8.7.8

Version 1.8.7.7

Version 1.8.7.6

Version 1.8.7.5

Version 1.8.7.4

Version 1.8.7.3

Version 1.8.7.2

Version 1.8.7.1

Version 1.8.7

Version 1.8.6.9

Version 1.8.6.8

Version 1.8.6.7

Version 1.8.6.5

Version 1.8.6.4

Version 1.8.6.3

Version 1.8.6.2

Version 1.8.6.1

Version 1.8.6

Version 1.8.5

Version 1.8.4.1

Version 1.8.3

Version 1.8.2

Version 1.8.1.2

Version 1.8.1

Version 1.8

SAOImageDS9 Version 1.9 Release Notes

SAOImageDS9 Version 1.9 Release Notes

Version 1.9.8

Version 1.9.7.2

Version 1.9.7.1

Version 1.9.7

Version 1.9.6

Version 1.9.5

Version 1.9.4

Version 1.9.3

Version 1.9.2

Version 1.9.1

Version 1.9

SAOImageDS9 Version 2.0 Release Notes

SAOImageDS9 Version 2.0 Release Notes

Version 2.0

SAOImageDS9 Version 2.1 Release Notes

SAOImageDS9 Version 2.1 Release Notes

Version 2.1

Version 2.1b7

Version 2.1b6

Version 2.1b5

Version 2.1b4

Version 2.1b3

SAOImageDS9 Version 2.2 Release Notes

SAOImageDS9 Version 2.2 Release Notes

Version 2.2.1

Version 2.2

Version 2.2b2

Version 2.2b1

SAOImageDS9 Version 2.3 Release Notes

SAOImageDS9 Version 2.3 Release Notes

Version 2.3b1

SAOImageDS9 Version 3.0 Release Notes

SAOImageDS9 Version 3.0 Release Notes

Version 3.0

SAOImageDS9 Version 4.0 Release Notes

SAOImageDS9 Version 4.0 Release Notes

Version 4

SAOImageDS9 Version 5 Release Notes

`Command Line Options`

Colorbar
+