diff options
| author | William Joye <wjoye@cfa.harvard.edu> | 2018-09-24 20:14:22 (GMT) |
|---|---|---|
| committer | William Joye <wjoye@cfa.harvard.edu> | 2018-09-24 20:14:22 (GMT) |
| commit | a7e6c895772b9f06c10c29946cf34560a5671e03 (patch) | |
| tree | 06616a780396e360527b7a329a94715670f41ca3 /ds9/doc/ref | |
| parent | ddf4f1207d7a299ba642f5226b90e168fa0628b4 (diff) | |
| download | blt-a7e6c895772b9f06c10c29946cf34560a5671e03.zip blt-a7e6c895772b9f06c10c29946cf34560a5671e03.tar.gz blt-a7e6c895772b9f06c10c29946cf34560a5671e03.tar.bz2 | |
PAN: tweak pan parser for backward compatibility
Diffstat (limited to 'ds9/doc/ref')
| -rw-r--r-- | ds9/doc/ref/command.html | 5811 | ||||
| -rw-r--r-- | ds9/doc/ref/samp.html | 6962 | ||||
| -rw-r--r-- | ds9/doc/ref/xpa.html | 6795 |
3 files changed, 10659 insertions, 8909 deletions
diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index 135101c..2b84c66 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -1,2668 +1,3167 @@ <!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> -<head> -<meta name="generator" content= -"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> -<meta http-equiv="Content-Type" content= -"text/html; charset=us-ascii"> -<meta name="GENERATOR" content= -"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> -<title>Command Line Options</title> -</head> -<body vlink="#551A8B" link="#0000FF" alink="#FF0000"> -<h3><img alt="" src="../sun.gif" width="100" height="98" align= -"middle"> Command Line Options</h3> -<blockquote> -<p>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:</p> -<tt>$ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8</tt> -<p>First DS9 is put in tile mode, then <tt>foo.fits</tt> is loaded. -Then the colormap for <tt>foo.fits</tt> is changed to <tt>Heat</tt> -and the scale changed to <tt>zscale</tt>. Next, <tt>bar.fits</tt> -is loaded and the colormap for <tt>bar.fits</tt> is changed to -<tt>I8.</tt></p> -<tt><a href="#2mass">2mass</a><br> -<a href="#3d">3d</a><br> -<a href="#about">about</a><br> -<a href="#align">align</a><br> -<a href="#analysis">analysis</a><br> -<a href="#array">array</a><br> -<a href="#asinh">asinh</a><br> -<a href="#background">background</a><br> -<a href="#backup">backup</a><br> -<a href="#bin">bin</a><br> -<a href="#blink">blink</a><br> -<a href="#block">block</a><br> -<a href="#blue">blue</a><br> -<a href="#catalog">catalog</a><br> -<a href="#cd">cd</a><br> -<a href="#cmap">cmap</a><br> -<a href="#colorbar">colorbar</a><br> -<a href="#console">console</a><br> -<a href="#contour">contour</a><br> -<a href="#crop">crop</a><br> -<a href="#crosshair">crosshair</a><br> -<a href="#cube">cube</a><br> -<a href="#cursor">cursor</a><br> -<a href="#dsssao">dsssao</a><br> -<a href="#dsseso">dsseso</a><br> -<a href="#dssstsci">dssstsci</a><br> -<a href="#envi">envi</a><br> -<a href="#exit">exit</a><br> -<a href="#export">export</a><br> -<a href="#fifo">fifo</a><br> -<a href="#fifo_only">fifo_only</a><br> -<a href="#fits">fits</a><br> -<a href="#frame">frame</a><br> -<a href="#geometry">geometry</a><br> -<a href="#gif">gif</a><br> -<a href="#green">green</a><br> -<a href="#geometry">grid</a><br> -<a href="#header">header</a><br> -<a href="#height">height</a><br> -<a href="#help">help</a><br> -<a href="#histequ">histequ</a><br> -<a href="#iconify">iconify</a><br> -<a href="#inet_only">inet_only</a><br> -<a href="#invert">invert</a><br> -<a href="#iis">iis</a><br> -<a href="#jpeg">jpeg</a><br> -<a href="#language">language</a><br> -<a href="#linear">linear</a><br> -<a href="#lock">lock</a><br> -<a href="#log">log</a><br> -<a href="#lower">lower</a><br> -<a href="#magnifier">magnifier</a><br> -<a href="#mask">mask</a><br> -<a href="#match">match</a><br> -<a href="#mecube">mecube</a><br> -<a href="#minmax">minmax</a><br> -<a href="#mode">mode</a><br> -<a href="#mosaic">mosaic</a><br> -<a href="#mosaicimage">mosaicimage</a><br> -<a href="#movie">movie</a><br> -<a href="#msg">msg</a><br> -<a href="#multiframe">multiframe</a><br> -<a href="#nameserver">nameserver</a><br> -<a href="#nan">nan</a><br> -<a href="#nrrd">nrrd</a><br> -<a href="#nvss">nvss</a><br> -<a href="#orient">orient</a><br> -<a href="#pagesetup">pagesetup</a><br> -<a href="#pan">pan</a><br> -<a href="#pixeltable">pixeltable</a><br> -<a href="#plot">plot</a><br> -<a href="#png">png</a><br> -<a href="#precision">precision</a><br> -<a href="#prefs">prefs</a><br> -<a href="#preserve">preserve</a><br> -<a href="#psprint">psprint</a><br> -<a href="#print">print</a><br> -<a href="#port">port</a><br> -<a href="#port_only">port_only</a><br> -<a href="#pow">pow</a><br> -<a href="#exit">quit</a><br> -<a href="#raise">raise</a><br> -<a href="#regions">regions</a><br> -<a href="#red">red</a><br> -<a href="#restore">restore</a><br> -<a href="#rgb">rgb</a><br> -<a href="#rgbarray">rgbarray</a><br> -<a href="#rgbcube">rgbcube</a><br> -<a href="#rgbimage">rgbimage</a><br> -<a href="#rotate">rotate</a><br> -<a href="#samp">samp</a><br> -<a href="#save">save</a><br> -<a href="#saveimage">saveimage</a><br> -<a href="#scale">scale</a><br> -<a href="#shm">shm</a><br></tt> <tt><tt><a href= -"#sia">sia</a><br></tt> <a href="#single">single</a><br> -<a href="#sinh">sinh</a><br> -<a href="#skyview">skyview</a><br> -<a href="#sleep">sleep</a><br> -<a href="#slice">slice</a><br> -<a href="#smooth">smooth</a><br> -<a href="#squared">squared</a><br> -<a href="#sqrt">sqrt</a><br> -<a href="#source">source</a><br> -<a href="#tcl">tcl</a><br> -<a href="#threads">threads</a><br> -<a href="#tiff">tiff</a><br> -<a href="#tile">tile</a><br> -<a href="#title">title</a><br> -<a href="#unix">unix</a><br> -<a href="#unix_only">unix_only</a><br> -<a href="#update">update</a><br> -<a href="#url">url</a><br> -<a href="#version">version</a><br> -<a href="#view">view</a><br> -<a href="#visual">visual</a><br> -<a href="#vla">vla</a><br></tt> <tt><tt><a href= -"#vlss">vlss</a><br></tt> <a href="#vo">vo</a><br> -<a href="#wcs">wcs</a><br> -<a href="#web">web</a><br> -<a href="#width">width</a><br> -<a href="#xpa">xpa</a><br> -<a href="#zmax">zmax</a><br> -<a href="#zoom">zoom</a><br> -<a href="#zscale">zscale</a><br></tt> -<p><b><a name="2mass"></a>2mass</b></p> -<p>Support for 2MASS Digital Sky Survey.</p> -<tt>Syntax:<br> --2mass []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey j|h|k]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -2mass<br> -$ds9 -2mass m31<br></tt> <tt><tt>$ds9 -2mass name m31<br></tt></tt> -<tt><tt><tt>$ds9 -2mass name clear<br></tt></tt> $ds9 -2mass -00:42:44.404 +41:16:08.78<br> -$ds9 -2mass size 60 60 arcmin<br> -$ds9 -2mass save yes<br> -$ds9 -2mass frame current<br> -$ds9 -2mass update frame<br> -$ds9 -2mass survey j<br> -$ds9 -2mass open<br> -$ds9 -2mass close<br></tt> -<p><b><a name="3d"></a>3d</b></p> -<p>Support for 3D frame.</p> -<tt>Syntax:<br></tt> <tt>-3d []<br> - [view <az> <el>]<br> - [az <az>]<br> - [el <el>]<br> - [scale <scale>]<br> - [method mip|aip]</tt><br> -<tt><tt> [background -none|azimuth|elevation]<br></tt> </tt><tt> -[border yes|no]<br> - [border color]<br></tt> <tt> -[highlite yes|no]<br> - [highlite color]<br></tt> -<tt><tt> </tt><tt> [compass yes|no]<br> - [compass color]<br> - [match]<br> - [lock [yes|no]]<br></tt> -[open|close]<br></tt> <tt> <br> -Example:<br> -$ds9 -3d # create new 3D frame<br> -$ds9 -3d view 45 30<br> -$ds9 -3d az 45<br> -$ds9 -3d el 30<br> -$ds9 -3d scale 10<br> -$ds9 -3d method mip</tt><br> -<tt>$ds9 -3d background azimuth<br></tt> <tt>$ds9 -3d border -yes<br> -$ds9 -3d border color red<br></tt> <tt>$ds9 -3d highlite yes<br> -$ds9 -3d highlite color red<br></tt> <tt><tt>$ds9 -3d compass -yes<br> -$ds9 -3d compass color red<br> -$ds9 -3d match<br> -$ds9 -3d lock yes<br></tt> $ds9 -3d open<br> -$ds9 -3d close</tt><br> -<p><b><a name="about" id="about"></a>about</b></p> -<p>Get DS9 credits.</p> -<tt>Syntax:<br> --about<br> - <br> -Example:<br> -$ds9 -about<br></tt> -<p><b><a name="align" id="align"></a>align</b></p> -<p>Controls the World Coordinate System alignment for the current -frame.</p> -<tt>Syntax:<br> --align [yes|no]<br> - <br> -Example:<br> -$ds9 -align yes<br></tt> -<p><b><a name="analysis" id="analysis"></a>analysis</b></p> -<p>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.</p> -<tt>Syntax:<br> --analysis [<task number>]<br> - -[<filename>]<br> - [task <task -number>|<task name>]<br> - [load -<filename>]<br> - [clear]<br> - [clear][load -<filename>]<br> - [message -ok|okcancel|yesno <message>]<br> - [entry -<message>]<br> - -[text]</tt><tt><tt><tt><tt><tt><br></tt></tt> </tt></tt><br> -Example:<br> -$ds9 -analysis 0 # invoke first analysis task<br> -$ds9 -analysis task 0<br></tt> <tt>$ds9 -analysis task -foobar<br></tt> <tt>$ds9 -analysis task {foo bar}<br> -$ds9 -analysis my.ans<br> -$ds9 -analysis load my.ans<br> -$ds9 -analysis clear<br> -$ds9 -analysis clear load my.ans<br> -$ds9 -analysis message {This is a message}<br> -$ds9 -analysis text {This is text}</tt><tt><br></tt> -<p><b><a name="array" id="array"></a>array</b></p> -<p>Load raw data array into current frame.<br></p> -<tt>Syntax:<br> --array + <head> + <meta name="generator" content="HTML Tidy for Mac OS X (vers 31 + October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> + <meta http-equiv="Content-Type" content="text/html; + charset=windows-1252"> + <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux + 2.4.7-10 i686) [Netscape]"> + <title>Command Line Options</title> + </head> + <body vlink="#551A8B" link="#0000FF" alink="#FF0000"> + <h3><img alt="" src="../sun.gif" width="100" height="98" + align="middle"> Command Line Options</h3> + <blockquote> + <p>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:</p> + <tt>$ds9 -tile foo.fits -cmap Heat -zscale bar.fits -cmap I8</tt> + <p>First DS9 is put in tile mode, then <tt>foo.fits</tt> is + loaded. + Then the colormap for <tt>foo.fits</tt> is changed to <tt>Heat</tt> + and the scale changed to <tt>zscale</tt>. Next, <tt>bar.fits</tt> + is loaded and the colormap for <tt>bar.fits</tt> is changed to + <tt>I8.</tt></p> + <tt><a href="#2mass">2mass</a><br> + <a href="#3d">3d</a><br> + <a href="#about">about</a><br> + <a href="#align">align</a><br> + <a href="#analysis">analysis</a><br> + <a href="#array">array</a><br> + <a href="#asinh">asinh</a><br> + <a href="#background">background</a><br> + <a href="#backup">backup</a><br> + <a href="#bin">bin</a><br> + <a href="#blink">blink</a><br> + <a href="#block">block</a><br> + <a href="#blue">blue</a><br> + <a href="#catalog">catalog</a><br> + <a href="#cd">cd</a><br> + <a href="#cmap">cmap</a><br> + <a href="#colorbar">colorbar</a><br> + <a href="#console">console</a><br> + <a href="#contour">contour</a><br> + <a href="#crop">crop</a><br> + <a href="#crosshair">crosshair</a><br> + <a href="#cube">cube</a><br> + <a href="#cursor">cursor</a><br> + <a href="#dsssao">dsssao</a><br> + <a href="#dsseso">dsseso</a><br> + <a href="#dssstsci">dssstsci</a><br> + <a href="#envi">envi</a><br> + <a href="#exit">exit</a><br> + <a href="#export">export</a><br> + <a href="#fifo">fifo</a><br> + <a href="#fifo_only">fifo_only</a><br> + <a href="#fits">fits</a><br> + <a href="#frame">frame</a><br> + <a href="#geometry">geometry</a><br> + <a href="#gif">gif</a><br> + <a href="#green">green</a><br> + <a href="#geometry">grid</a><br> + <a href="#header">header</a><br> + <a href="#height">height</a><br> + <a href="#help">help</a><br> + <a href="#histequ">histequ</a><br> + <a href="#iconify">iconify</a><br> + <a href="#inet_only">inet_only</a><br> + <a href="#invert">invert</a><br> + <a href="#iis">iis</a><br> + <a href="#jpeg">jpeg</a><br> + <a href="#language">language</a><br> + <a href="#linear">linear</a><br> + <a href="#lock">lock</a><br> + <a href="#log">log</a><br> + <a href="#lower">lower</a><br> + <a href="#magnifier">magnifier</a><br> + <a href="#mask">mask</a><br> + <a href="#match">match</a><br> + <a href="#mecube">mecube</a><br> + <a href="#minmax">minmax</a><br> + <a href="#mode">mode</a><br> + <a href="#mosaic">mosaic</a><br> + <a href="#mosaicimage">mosaicimage</a><br> + <a href="#movie">movie</a><br> + <a href="#msg">msg</a><br> + <a href="#multiframe">multiframe</a><br> + <a href="#nameserver">nameserver</a><br> + <a href="#nan">nan</a><br> + <a href="#nrrd">nrrd</a><br> + <a href="#nvss">nvss</a><br> + <a href="#orient">orient</a><br> + <a href="#pagesetup">pagesetup</a><br> + <a href="#pan">pan</a><br> + <a href="#pixeltable">pixeltable</a><br> + <a href="#plot">plot</a><br> + <a href="#png">png</a><br> + <a href="#precision">precision</a><br> + <a href="#prefs">prefs</a><br> + <a href="#preserve">preserve</a><br> + <a href="#psprint">psprint</a><br> + <a href="#print">print</a><br> + <a href="#port">port</a><br> + <a href="#port_only">port_only</a><br> + <a href="#pow">pow</a><br> + <a href="#exit">quit</a><br> + <a href="#raise">raise</a><br> + <a href="#regions">regions</a><br> + <a href="#red">red</a><br> + <a href="#restore">restore</a><br> + <a href="#rgb">rgb</a><br> + <a href="#rgbarray">rgbarray</a><br> + <a href="#rgbcube">rgbcube</a><br> + <a href="#rgbimage">rgbimage</a><br> + <a href="#rotate">rotate</a><br> + <a href="#samp">samp</a><br> + <a href="#save">save</a><br> + <a href="#saveimage">saveimage</a><br> + <a href="#scale">scale</a><br> + <a href="#shm">shm</a><br> + </tt> <tt><tt><a href="#sia">sia</a><br> + </tt> <a href="#single">single</a><br> + <a href="#sinh">sinh</a><br> + <a href="#skyview">skyview</a><br> + <a href="#sleep">sleep</a><br> + <a href="#slice">slice</a><br> + <a href="#smooth">smooth</a><br> + <a href="#squared">squared</a><br> + <a href="#sqrt">sqrt</a><br> + <a href="#source">source</a><br> + <a href="#tcl">tcl</a><br> + <a href="#threads">threads</a><br> + <a href="#tiff">tiff</a><br> + <a href="#tile">tile</a><br> + <a href="#title">title</a><br> + <a href="#unix">unix</a><br> + <a href="#unix_only">unix_only</a><br> + <a href="#update">update</a><br> + <a href="#url">url</a><br> + <a href="#version">version</a><br> + <a href="#view">view</a><br> + <a href="#visual">visual</a><br> + <a href="#vla">vla</a><br> + </tt> <tt><tt><a href="#vlss">vlss</a><br> + </tt> <a href="#vo">vo</a><br> + <a href="#wcs">wcs</a><br> + <a href="#web">web</a><br> + <a href="#width">width</a><br> + <a href="#xpa">xpa</a><br> + <a href="#zmax">zmax</a><br> + <a href="#zoom">zoom</a><br> + <a href="#zscale">zscale</a><br> + </tt> + <p><b><a name="2mass"></a>2mass</b></p> + <p>Support for 2MASS Digital Sky Survey.</p> + <tt>Syntax:<br> + -2mass []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -2mass<br> + $ds9 -2mass m31<br> + </tt> <tt><tt>$ds9 -2mass name m31<br> + </tt></tt> + <tt><tt><tt>$ds9 -2mass name clear<br> + </tt></tt> $ds9 -2mass + 00:42:44.404 +41:16:08.78<br> + $ds9 -2mass size 60 60 arcmin<br> + $ds9 -2mass save yes<br> + $ds9 -2mass frame current<br> + $ds9 -2mass update frame<br> + $ds9 -2mass survey j<br> + $ds9 -2mass open<br> + $ds9 -2mass close<br> + </tt> + <p><b><a name="3d"></a>3d</b></p> + <p>Support for 3D frame.</p> + <tt>Syntax:<br> + </tt> <tt>-3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]</tt><br> + <tt><tt> [background + none|azimuth|elevation]<br> + </tt> </tt><tt> + [border yes|no]<br> + [border color]<br> + </tt> <tt> + [highlite yes|no]<br> + [highlite color]<br> + </tt> + <tt><tt> </tt><tt> [compass yes|no]<br> + [compass color]<br> + [match]<br> + [lock [yes|no]]<br> + </tt> + [open|close]<br> + </tt> <tt> <br> + Example:<br> + $ds9 -3d # create new 3D frame<br> + $ds9 -3d view 45 30<br> + $ds9 -3d az 45<br> + $ds9 -3d el 30<br> + $ds9 -3d scale 10<br> + $ds9 -3d method mip</tt><br> + <tt>$ds9 -3d background azimuth<br> + </tt> <tt>$ds9 -3d border + yes<br> + $ds9 -3d border color red<br> + </tt> <tt>$ds9 -3d highlite yes<br> + $ds9 -3d highlite color red<br> + </tt> <tt><tt>$ds9 -3d compass + yes<br> + $ds9 -3d compass color red<br> + $ds9 -3d match<br> + $ds9 -3d lock yes<br> + </tt> $ds9 -3d open<br> + $ds9 -3d close</tt><br> + <p><b><a name="about" id="about"></a>about</b></p> + <p>Get DS9 credits.</p> + <tt>Syntax:<br> + -about<br> + <br> + Example:<br> + $ds9 -about<br> + </tt> + <p><b><a name="align" id="align"></a>align</b></p> + <p>Controls the World Coordinate System alignment for the current + frame.</p> + <tt>Syntax:<br> + -align [yes|no]<br> + <br> + Example:<br> + $ds9 -align yes<br> + </tt> + <p><b><a name="analysis" id="analysis"></a>analysis</b></p> + <p>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.</p> + <tt>Syntax:<br> + -analysis [<task number>]<br> + + [<filename>]<br> + [task <task + number>|<task name>]<br> + [load + <filename>]<br> + [clear]<br> + + [clear][load + <filename>]<br> + [message + ok|okcancel|yesno <message>]<br> + [entry + <message>]<br> + + [text]</tt><tt><tt><tt><tt><tt><br> + </tt></tt> </tt></tt><br> + Example:<br> + $ds9 -analysis 0 # invoke first analysis task<br> + $ds9 -analysis task 0<br> + </tt> <tt>$ds9 -analysis task + foobar<br> + </tt> <tt>$ds9 -analysis task {foo bar}<br> + $ds9 -analysis my.ans<br> + $ds9 -analysis load my.ans<br> + $ds9 -analysis clear<br> + $ds9 -analysis clear load my.ans<br> + $ds9 -analysis message {This is a message}<br> + $ds9 -analysis text {This is text}</tt><tt><br> + </tt> + <p><b><a name="array" id="array"></a>array</b></p> + <p>Load raw data array into current frame.<br> + </p> + <tt>Syntax:<br> + -array <filename>[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br> -$ds9 -array foo.arr[dim=512,bitpix=-32,endian=little]</tt><br> -<tt>$cat foo.arr | ds9 -array --[dim=512,bitpix=-32,endian=little]</tt><tt><br></tt> -<p><b><a name="asinh" id="asinh"></a></b><b>asinh</b></p> -<p>Select ASINH scale function for the current frame.</p> -<tt>Syntax:<br> --asinh<br> - <br> -Example:<br> -$ds9 -asinh</tt><br> -<p><b><a name="background" id="background"></a>bg<br> -background</b></p> -<p>Set image background color.</p> -<tt>Syntax:<br> --bg <color><br> - <br> -Example:<br> -$ds9 -background red<br> -$ds9 -bg red</tt><br> -<p><b><a name="backup" id="backup"></a>backup</b></p> -<p>Create a backup save set.</p> -<tt>Syntax:<br> --backup <filename><br> - <br> -Example:<br> -$ds9 -backup ds9.bck</tt><br> -<p><b><a name="bin" id="bin"></a>bin</b></p> -<p>Controls binning factor, binning buffer size, and binning -function for binning FITS bin tables.</p> -<tt>Syntax:<br> --bin [about <x> <y>]<br> - [about center]<br> - [buffersize <value>]<br> - [cols <x> <y>]<br> - [colsz <x> <y> <z>]<br> - [factor <value> [<value>]]<br> - [depth <value>]<br> - [filter <string>]<br></tt> -<tt><tt> [filter clear]<br></tt> - [function average|sum]<br> - [in]<br> - [out]<br> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -bin about 4096 4096<br> -$ds9 -bin about center<br> -$ds9 -bin buffersize 512<br> -$ds9 -bin cols detx dety<br> -$ds9 -bin colsz detx dety time<br> -$ds9 -bin factor 4<br> -$ds9 -bin factor 4 2<br> -$ds9 -bin depth 10<br> -$ds9 -bin filter 'pha > 5'<br> -$ds9 -bin filter clear<br> -$ds9 -bin function sum<br></tt> <tt><tt>$ds9 -bin in<br> -$ds9 -bin out<br></tt> $ds9 -bin to fit<br> -$ds9 -bin match<br> -$ds9 -bin lock yes<br> -$ds9 -bin open<br> -$ds9 -bin close<br></tt> -<p><b><a name="blink" id="blink"></a>blink</b></p> -<p>Blink mode parameters. Interval is in seconds.</p> -<tt>Syntax:<br> --blink []<br> - [yes|no]<br> - [interval <value>]<br> - <br> -Example:<br> -$ds9 -blink<br> -$ds9 -blink yes<br> -$ds9 -blink interval 1</tt><br> -<p><b><a name="block" id="block"></a>block</b></p> -<p>Controls blocking parameters.</p> -<tt>Syntax:<br> --block</tt> <tt><tt>[<value>]<br> - [<value> -<value>]<br> - [to <value>]<br> - [to <value> -<value>]<br> - [in]<br> - [out]<br></tt> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br></tt> <tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> 4<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> 4 2<br></tt> -<tt><tt><tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> to 4<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> to 4 2<br></tt> $ds9</tt> -<tt><tt><tt>-block</tt></tt> in<br></tt></tt> <tt><tt><tt>$ds9</tt> -<tt><tt><tt>-block</tt></tt> out<br></tt></tt> $ds9</tt> -<tt><tt><tt>-block</tt></tt> to fit<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> match<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> lock yes<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> open<br> -$ds9</tt> <tt><tt><tt>-block</tt></tt> close</tt><tt><br></tt> -<p><b><a name="blue" id="blue"></a>blue</b></p> -<p>For RGB frames, sets the current color channel to blue.</p> -<tt>Syntax:<br> --blue<br> - <br> -Example:<br> -$ds9 -blue foo.fits<br></tt> -<p><b><a name="catalog" id="catalog"></a>catalog<br> -cat</b></p> -<p>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.</p> -<tt>Syntax:<br></tt> <tt>-catalog [new]<br> - -[ned|simbad|denis|skybot]<br></tt> -<tt><tt> + <br> + Example:<br> + $ds9 -array foo.arr[dim=512,bitpix=-32,endian=little]</tt><br> + <tt>$cat foo.arr | ds9 -array + -[dim=512,bitpix=-32,endian=little]</tt><tt><br> + </tt> + <p><b><a name="asinh" id="asinh"></a></b><b>asinh</b></p> + <p>Select ASINH scale function for the current frame.</p> + <tt>Syntax:<br> + -asinh<br> + <br> + Example:<br> + $ds9 -asinh</tt><br> + <p><b><a name="background" id="background"></a>bg<br> + background</b></p> + <p>Set image background color.</p> + <tt>Syntax:<br> + -bg <color><br> + <br> + Example:<br> + $ds9 -background red<br> + $ds9 -bg red</tt><br> + <p><b><a name="backup" id="backup"></a>backup</b></p> + <p>Create a backup save set.</p> + <tt>Syntax:<br> + -backup <filename><br> + <br> + Example:<br> + $ds9 -backup ds9.bck</tt><br> + <p><b><a name="bin" id="bin"></a>bin</b></p> + <p>Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables.</p> + <tt>Syntax:<br> + -bin [about <x> <y>]<br> + [about center]<br> + [buffersize <value>]<br> + [cols <x> <y>]<br> + [colsz <x> <y> <z>]<br> + [factor <value> [<value>]]<br> + [depth <value>]<br> + [filter <string>]<br> + </tt> + <tt><tt> [filter clear]<br> + </tt> + [function average|sum]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -bin about 4096 4096<br> + $ds9 -bin about center<br> + $ds9 -bin buffersize 512<br> + $ds9 -bin cols detx dety<br> + $ds9 -bin colsz detx dety time<br> + $ds9 -bin factor 4<br> + $ds9 -bin factor 4 2<br> + $ds9 -bin depth 10<br> + $ds9 -bin filter 'pha > 5'<br> + $ds9 -bin filter clear<br> + $ds9 -bin function sum<br> + </tt> <tt><tt>$ds9 -bin in<br> + $ds9 -bin out<br> + </tt> $ds9 -bin to fit<br> + $ds9 -bin match<br> + $ds9 -bin lock yes<br> + $ds9 -bin open<br> + $ds9 -bin close<br> + </tt> + <p><b><a name="blink" id="blink"></a>blink</b></p> + <p>Blink mode parameters. Interval is in seconds.</p> + <tt>Syntax:<br> + -blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> + Example:<br> + $ds9 -blink<br> + $ds9 -blink yes<br> + $ds9 -blink interval 1</tt><br> + <p><b><a name="block" id="block"></a>block</b></p> + <p>Controls blocking parameters.</p> + <tt>Syntax:<br> + -block</tt> <tt><tt>[<value>]<br> + [<value> + <value>]<br> + [to <value>]<br> + [to <value> + <value>]<br> + [in]<br> + [out]<br> + </tt> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + </tt> <tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> 4<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> 4 2<br> + </tt> + <tt><tt><tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> to 4<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> to 4 2<br> + </tt> $ds9</tt> + <tt><tt><tt>-block</tt></tt> in<br> + </tt></tt> <tt><tt><tt>$ds9</tt> + <tt><tt><tt>-block</tt></tt> out<br> + </tt></tt> $ds9</tt> + <tt><tt><tt>-block</tt></tt> to fit<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> match<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> lock yes<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> open<br> + $ds9</tt> <tt><tt><tt>-block</tt></tt> close</tt><tt><br> + </tt> + <p><b><a name="blue" id="blue"></a>blue</b></p> + <p>For RGB frames, sets the current color channel to blue.</p> + <tt>Syntax:<br> + -blue<br> + <br> + Example:<br> + $ds9 -blue foo.fits<br> + </tt> + <p><b><a name="catalog" id="catalog"></a>catalog<br> + cat</b></p> + <p>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.</p> + <tt>Syntax:<br> + </tt> <tt>-catalog [new]<br> + + [ned|simbad|denis|skybot]<br> + </tt> + <tt><tt> [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - -[</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br></tt> - [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - -[chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds -<catalogid>]<br> -<br> - [load <filename>]<br> - [import sb|tsv -<filename>]<br> -<br></tt> <tt><tt> -[<ref>] [<ra> <dec> -<coordsys>]</tt><tt><br></tt> - [<ref>] [allcols]<br></tt> -<tt> </tt><tt> [<ref>] -[allrows]<br> - </tt><tt> [<ref>] -[cancel]<br></tt> <tt> -[<ref>] [clear]<br></tt> <tt> -[<ref>] [close]</tt><br> -<tt> </tt> -<tt>[<ref>] [crosshair]</tt><br> -<tt> [<ref>] [dec -<col>]</tt><br> -<tt> [<ref>] [edit -yes|no]</tt><br> -<tt> [<ref>] -[export sb|tsv <filename>]<br></tt> -<tt> [<ref>] -[filter <string>]<br> - [<ref>] [filter load -<filename>]</tt><br> -<tt> [<ref>] -[header]</tt><br> -<tt> [<ref>] [location -<code>]</tt><br> -<tt><tt> [<ref>] -[match <ref> <ref>]<br></tt></tt> -<tt><tt><tt> -[<ref>] [match]<br></tt></tt> - </tt> <tt>[<ref>] -[match error <value> degrees|arcmin|arcsec]</tt><br> -<tt> </tt> -<tt>[<ref>] [match function 1and2|1not2|2not1]<br></tt> -<tt> </tt> -<tt>[<ref>] [match return 1and2|1only|2only]</tt><br> -<tt> </tt> -<tt>[<ref>] [match unique yes|no]</tt><br> -<tt> [<ref>] [maxrows -<number>]</tt><br> -<tt> [<ref>] [name -<object>]<br></tt> -<tt> [<ref>] [panto -yes|no]</tt><br> -<tt> [<ref>] [plot -<xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> -<tt> [<ref>] [print]</tt><br> -<tt> [<ref>] [psky -<skyframe>]</tt><br> -<tt> [<ref>] [psystem -<coordsys>]</tt><br> -<tt> [<ref>] [ra -<col>]</tt><br> -<tt><tt> [<ref>] -[regions]</tt><br> - [<ref>] -[retrieve]<br></tt> <tt> -[<ref>] [samp]<br> - [<ref>] [samp -broadcast]<br> - [<ref>] [samp send -<application>]</tt><tt><br></tt> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] -[server</tt> -<tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> - -<tt> [<ref>] [show -yes|no]</tt><br> -<tt> [<ref>] [radius -<value> degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> - [<ref>] [skyformat -<skyformat>]<br></tt> <tt> - [<ref>] [sort <col> -incr|decr]</tt><br> -<tt> [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>]<br></tt> <tt> -[<ref>] [symbol [#] text|size|size2|units|angle -<value>]</tt><br> -<tt><tt> [<ref>] [symbol -shape circle|ellipse|box|text|point]<br> - </tt></tt> -<tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt>circle point|box point|diamond -point|</tt></tt></tt></tt>cross point|x point|arrow point|boxcircle -point]<br></tt></tt> <tt> -[<ref>] [symbol add| [#] remove]<br> - [<ref>] [symbol -save|load <filename>]</tt><br> -<tt> [<ref>] [system -<coordsys>]</tt><tt><br></tt> <tt> - </tt> <tt>[<ref>] [update]</tt><br> -<tt> [<ref>] [x -<col>]</tt><br> -<tt> [<ref>] [y -<col>]</tt><br> -<tt><br> -Example:<br></tt> <tt><tt>$ds9 -catalog new<br></tt> $ds9 -catalog -2mass<br> -$ds9 -catalog cds 2mass<br> -$ds9 -catalog cds "I/252"<br> -<br></tt> <tt>$ds9 -catalog load foo.xml<br> -$ds9 -catalog import tsv foo.tsv<br> -<br></tt> <tt><tt>$ds9 -catalog 202.48 47.21 fk5<br></tt> $ds9 --catalog allrows<br> -$ds9 -catalog allcols<br></tt> <tt>$ds9 -catalog cancel<br></tt> -<tt>$ds9 -catalog clear<br></tt> <tt>$ds9 -catalog close<br></tt> -<tt>$ds9 -catalog crosshair<br></tt> <tt>$ds9 -catalog dec -DEC<br></tt> <tt>$ds9 -catalog edit yes<br></tt> <tt>$ds9 -catalog -export tsv bar.tsv<br></tt> <tt>$ds9 -catalog filter</tt> -<tt>'\$Jmag>15'</tt><tt><br> -$ds9 -catalog filter load foo.flt<br> -$ds9 -catalog header<br></tt> <tt>$ds9 -catalog location -500</tt><br> -<tt>$ds9 -catalog match error 2 arcsec<br> -$ds9 -catalog match function 1and2<br> -$ds9 -catalog match unique no<br> -$ds9 -catalog match return 1only<br></tt> <tt>$ds9 -catalog match # -last two catalogs loaded<br></tt> <tt>$ds9 -catalog match 2mass -csc<br></tt> <tt>$ds9 -catalog maxrows 2000<br></tt> <tt>$ds9 --catalog name m51<br> -$ds9 -catalog panto no<br></tt> <tt>$ds9 -catalog plot</tt> -<tt>'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag'</tt><tt><br></tt> -<tt>$ds9 -catalog print</tt><br> -<tt>$ds9 -catalog psky fk5</tt><br> -<tt>$ds9 -catalog psystem wcs</tt><br> -<tt>$ds9 -catalog ra RA</tt><br> -<tt><tt>$ds9 -catalog regions<br></tt> $ds9 -catalog -retrieve<br></tt> <tt>$ds9 -catalog samp broadcast<br> -$ds9 -catalog samp send aladin<br> -$ds9 -catalog save foo.xml<br></tt> <tt>$ds9 -catalog server -sao<br></tt> <tt>$ds9 -catalog show yes</tt><br> -<tt>$ds9 -catalog radius 1 degrees</tt><br> -<tt>$ds9 -catalog symbol condition '\$Jmag>15'<br> -$ds9 -catalog symbol 2 shape "boxcircle point"<br> -$ds9 -catalog symbol color red<br> -$ds9 -catalog symbol font times<br></tt> <tt>$ds9 -catalog symbol -fontsize 14<br></tt> <tt>$ds9 -catalog symbol fontweight -bold<br></tt> <tt>$ds9 -catalog symbol fontslant italic<br></tt> -<tt>$ds9 -catalog symbol add<br> -$ds9 -catalog symbol 2 remove<br> -$ds9 -catalog symbol load foo.sym<br> -$ds9 -catalog symbol save bar.sym</tt><tt><br> -$ds9 -catalog sky fk5<br> -$ds9 -catalog skyformat degrees<br></tt> <tt>$ds9 -catalog sort -"Jmag" incr<br></tt> <tt>$ds9 -catalog system wcs</tt><tt><br></tt> -<tt>$ds9 -catalog update<br></tt> <tt>$ds9 -catalog x RA<br> -$ds9 -catalog y DEC</tt><br> -<p><b><a name="cd" id="cd"></a>cd</b></p> -<p>Sets the current working directory.</p> -<tt>Syntax:<br> -cd [<directory>]<br> - <br> -Example:<br> -$ds9 -cd /home/mrbill<br></tt> -<p><b><a name="cmap" id="cmap"></a>cmap</b></p> -<p>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.</p> -<tt>Syntax:<br> --cmap [<colormap>]<br> - [load <filename>]<br> - [save <filename>]<br> - [invert yes|no]<br> - [<contrast> -<bias>]<br></tt> <tt> [tag -[load|save] <filename>]<br> - [tag delete]</tt><br> -<tt> [open|close]<br> - <br> -Example:<br> -$ds9 -cmap Heat<br> -$ds9 -cmap load foo.sao<br> -$ds9 -cmap save bar.sao<br> -$ds9 -cmap invert yes<br> -$ds9 -cmap 5 .5<br> -$ds9 -cmap tag load foo.tag<br> -$ds9 -cmap tag save foo.tag<br> -$ds9 -cmap tag delete<br></tt> <tt>$ds9 -cmap open<br> -$ds9 -cmap close<br></tt> -<p><b><a name="colorbar" id="colorbar"></a>colorbar</b></p> -<p>Controls colorbar parameters.</p> -<tt>Syntax:<br> --colorbar []<br> - [yes|no]<br> - -[horizontal|vertical]<br> - [numerics -yes|no]<br> - [space -value|distance]<br> - [font -times|helvetica|courier]<br> - [fontsize -<value>]<br> - [fontweight -normal|bold]<br> - [fontslant -roman|italic]<br> - [size]<br> - [ticks]<br></tt> -<tt><tt> -[match]<br> - [lock -[yes|no]]</tt><br> - <br> -Example:<br> -$ds9 -colorbar yes<br> -$ds9 -colorbar vertical<br> -$ds9 -colorbar numerics yes<br> -$ds9 -colorbar space value<br> -$ds9 -colorbar font times<br> -$ds9 -colorbar fontsize 14<br> -$ds9 -colorbar fontweight bold<br> -$ds9 -colorbar fontslant italic<br> -$ds9 -colorbar size 20<br> -$ds9 -colorbar ticks 11</tt><br> -<tt>$ds9 -colorbar match<br> -$ds9 -colorbar lock yes</tt><br> -<p><b><a name="console" id="console"></a>console</b></p> -<p>Display tcl console window.</p> -<tt>Syntax:<br> --console<br> - <br> -Example:<br> -$ds9 -console<br></tt> -<p><b><a name="contour" id="contour"></a>contour<br></b></p> -<p>Controls contours in the current frame.</p> -<tt>Syntax:<br> --contour []<br> - [yes|no]<br> - [clear]<br> - [generate]<br> - [load -<filename>]<br> - [save <filename> -[<coordsys> <skyframe>]]<br> - [convert]<br> - [load levels -<filename>]</tt><br> -<tt><tt> [save -levels <filename>]<br></tt> - [copy]<br> - [paste -[<coordsys> <color> <width> yes|no]]<br> - [color -<color>]<br> - [width -<width>]<br> - [dash yes|no]<br> - [smooth -<smooth>]<br> - [method -block|smooth]<br> - [nlevels <number of -levels>]<br> - [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> - [log exp -<value>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope -global|local]<br> - [limits <min> -<max>]<br> - [levels <value -value value...>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -contour<br> -$ds9 -contour yes<br> -$ds9 -contour generate<br> -$ds9 -contour clear<br> -$ds9 -contour load ds9.ctr<br></tt> <tt><tt>$ds9 -contour save -ds9.ctr<br></tt></tt> <tt><tt><tt>$ds9 -contour save ds9.ctr wcs -fk5<br></tt></tt> $ds9 -contour convert<br> -$ds9 -contour load levels ds9.ctr<br></tt> <tt><tt>$ds9 -contour -save levels ds9.lev<br></tt> $ds9 -contour copy<br></tt> -<tt><tt>$ds9 -contour paste<br></tt></tt> <tt><tt><tt>$ds9 -contour -paste wcs red 2 no<br></tt></tt> $ds9 -contour color yellow<br> -$ds9 -contour width 2<br> -$ds9 -contour dash yes<br> -$ds9 -contour smooth 5<br> -$ds9 -contour method smooth<br> -$ds9 -contour nlevels 10<br> -$ds9 -contour scale sqrt<br> -$ds9 -contour log exp 1000<br> -$ds9 -contour mode zscale<br> -$ds9 -contour scope local<br> -$ds9 -contour limits 1 100<br> -$ds9 -contour levels "1 10 100 1000"<br> -$ds9 -contour open<br> -$ds9 -contour close<br></tt> -<p><b><a name="crop" id="crop"></a>crop</b></p> -<p>Set current image display area.</p> -<tt>Syntax:<br> --crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br></tt> -<tt> [match <coordsys>]<br> - [lock -<coordsys>|none]</tt><br> -<tt><tt> [reset]<br> - [3d zmin zmax <coordsys>]<br> - [open|close]<br> -<br></tt> Example:<br> -$ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords<br> -$ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 -22.000204 wcs galactic arcsec<br> -$ds9 foo.fits -crop match wcs<br> -$ds9 foo.fits -crop lock wcs<br> -$ds9 foo.fits -crop reset</tt><br> -<tt>$ds9 foo.fits -crop 3d .25 .5 wcs<br> -$ds9 foo.fits -crop open<br> -$ds9 foo.fits -crop close<br></tt> -<p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> -<p>Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set.</p> -<tt>Syntax:<br> --crosshair [<x> <h> <coordsys> -[<skyframe>]]<br> - </tt><tt> -[match <coordsys>]<br> - [lock -<coordsys>|none]</tt><br> -<tt> <br> -Example:<br> -$ds9 -crosshair 100 100 physical # set crosshair in physical<br> -$ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords<br> -$ds9 -crosshair 23:01:00 +58:52:51 wcs fk5<br> -$ds9 -crosshair match<br> -$ds9 -crosshair lock wcs<br></tt> -<p><b><a name="cube" id="cube"></a>cube<br></b></p> -<p>Controls FITS cube.</p> -<tt>Syntax:<br> --cube []<br> - [play|stop|next|prev|first|last]<br> - [<slice> -[<coordsys>][<axis>]]<br> - [interval <numeric>]<br></tt> -<tt> [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [order 123|132|213|231|312|321]<br> - [axes lock [yes|no]]<br></tt> -<tt> [open|close]<br> - <br> -Example:<br> -$ds9 -cube<br> -$ds9 -cube play<br> -$ds9 -cube last<br> -$ds9 -cube 3<br> -$ds9 -cube 4.5 wcs 3<br> -$ds9 -cube interval 2<br> -$ds9 -cube match wcs<br> -$ds9 -cube lock wcs<br> -$ds9 -cube order 123<br> -$ds9 -cube axes lock yes<br> -$ds9 -cube open<br> -$ds9 -cube close</tt><br> -<p><b><a name="cursor" id="cursor"></a>cursor</b></p> -<p>Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also.</p> -<tt>Syntax:<br> --cursor [<x> <h>]<br> - <br> -Example:<br> -$ds9 -cursor 10 10</tt><tt><br></tt> -<p><b><a name="dsssao" id="dsssao"></a>dsssao<br> -dss<br></b></p> -<p>Support for Digital Sky Survey at SAO.</p> -<tt>Syntax:<br> --dsssao []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] -# in wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update -frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -dsssao<br> -$ds9 -dsssao m31<br></tt> <tt><tt>$ds9 -dsssao name -m31<br></tt></tt> <tt><tt><tt>$ds9 -dsssao name clear<br></tt></tt> -$ds9 -dsssao 00:42:44.404 +41:16:08.78<br> -$ds9 -dsssao size 60 60 arcmin<br> -$ds9 -dsssao save yes<br> -$ds9 -dsssao frame current<br> -$ds9 -dsssao update frame<br> -$ds9 -dsssao open<br> -$ds9 -dsssao close<br></tt> -<p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> -<p>Support for Digital Sky Survey at ESO.</p> -<tt>Syntax:<br> --dsseso []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] -# in wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update -frame|crosshair]<br> - [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -dsseso<br> -$ds9 -dsseso m31<br></tt> <tt><tt>$ds9 -dsseso name -m31<br></tt></tt> <tt><tt><tt>$ds9 -dsseso name clear<br></tt></tt> -$ds9 -dsseso 00:42:44.404 +41:16:08.78<br> -$ds9 -dsseso size 60 60 arcmin<br> -$ds9 -dsseso save yes<br> -$ds9 -dsseso frame current<br> -$ds9 -dsseso update frame<br> -$ds9 -dsseso survey DSS2-red<br> -$ds9 -dsseso open<br></tt> <tt>$ds9 -dsseso close</tt><br> -<p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> -<p>Support for Digital Sky Survey at STSCI.</p> -<tt>Syntax:<br> --dssstsci []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> -<dec>] # in wcs fk5<br> - [size -<width> <height> degrees|arcmin|arcsec]<br> - [save -yes|no]<br> - [frame -new|current]<br> - [update -frame|crosshair]<br> - [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> - [survey -poss1_blue|poss1_red]<br> - [survey -all|quickv|phase2_gsc2|phase2_gsc1]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -dssstsci<br> -$ds9 -dssstsci m31<br></tt> <tt><tt>$ds9 -dssstsci name -m31<br></tt></tt> <tt><tt><tt>$ds9 -dssstsci name -clear<br></tt></tt> $ds9 -dssstsci 00:42:44.404 +41:16:08.78<br> -$ds9 -dssstsci size 60 60 arcmin<br> -$ds9 -dssstsci save yes<br> -$ds9 -dssstsci frame current<br> -$ds9 -dssstsci update frame<br> -$ds9 -dssstsci survey all<br> -$ds9 -dssstsci open<br> -$ds9 -dssstsci close</tt><br> -<p><b><a name="envi" id="envi"></a>envi</b></p> -<p>Load an ENVI header and file. Optional parameter: array -endian.<br></p> -<tt>Syntax:<br> --envi <header> [<filename>]<br> - <br> -Example:<br></tt> <tt><tt><tt><tt>$ds9 -envi -foo.hdr</tt></tt><tt><tt><tt><tt><tt><tt><br></tt></tt></tt></tt></tt></tt></tt></tt> -<tt><tt>$ds9 -envi foo.hdr -foo.bsq</tt></tt><tt><tt><tt><tt><tt><tt><br></tt></tt></tt></tt></tt></tt> -<p><b><a name="exit" id="exit"></a>exit<br> -quit</b></p> -<p>Quits DS9.</p> -<tt>Syntax:<br> --exit<br> --quit<br> - <br> -Example:<br> -$ds9 -exit<br></tt> -<p><b><a name="export" id="export"></a>export<br></b></p> -<p>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.<br></p> -<tt>Syntax:<br> --export [array|nrrd|envi|gif|tiff|jpeg|png] -<filename></tt><tt><br></tt> <tt><tt>-export array -<filename></tt> <tt>[big|little</tt><tt>|native]<br></tt> --export nrrd <filename></tt> -<tt>[big|little</tt><tt>|native]</tt><br> -<tt>-export envi <header> [<filename>]</tt> -<tt>[big|little</tt><tt>|native]</tt> <tt><br></tt> <tt>-export -<filename></tt><tt>.jpeg [1-100]<br></tt> <tt>-export -<filename></tt><tt>.tiff -[none|jpeg|packbits|deflate]</tt><br> -<tt> <br> -Example:<br> -$ds9 -export array foo.arr little<br> -$ds9 -export nrrd foo.nrrd little<br> -$ds9 -export envi foo.hdr little<br></tt> <tt><tt>$ds9 -export envi -foo.hdr foo.bsq little<br></tt> $ds9 -export tiff foo.tiff jpeg<br> -$ds9 -export jpeg foo.jpeg 75<br> -$ds9 -export png foo.png</tt><br> -<p><b><a name="fifo" id="fifo"></a>fifo</b></p> -<p>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.</p> -<tt>Syntax:<br> --fifo name<br> - <br> -Example:<br> -$ds9 -fifo /dev/imt1</tt> -<p><b><a name="fifo_only" id="fifo_only"></a>fifo_only</b></p> -<p>Only use IRAF input and output fifos. Same as -port 0 -unix -none.</p> -<tt>Syntax:<br> --fifo_only<br> - <br> -Example:<br> -$ds9 -fifo_only<br></tt> -<p><b><a name="fits" id="fits"></a>fits</b></p> -<p>Load a FITS image into the current frame.<br></p> -<tt>Syntax:<br> --fits</tt> <tt><tt><filename></tt></tt><tt><br> - <br> -Example:<br></tt> <tt>$ds9 -fits foo.fits<br> -$ds9 -fits bar.fits[bin=detx,dety]<br> -$cat foo.fits | ds9 -fits -<br> -$cat bar.fits | ds9 -fits -[bin=detx,dety]</tt><tt><br></tt> -<p><b><a name="frame" id="frame"></a>frame</b></p> -<p>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.</p> -<tt>Syntax:<br> --frame [center [#|all]]<br> - [clear [#|all]]<br> - [new [rgb]]<br> - [delete [#|all]]<br> - [reset [#|all]]<br> - [refresh [#|all]]<br> - [hide [#|all]]<br> - [show [#|all]]<br> - [move first]<br> - [move back]<br> - [move forward]<br> - [move last]<br> - [first]<br> - [prev]<br> - [next]<br> - [last]<br> - [frameno #]<br> - [#]<br> - [match <coordsys>]<br> - [lock -<coordsys>|none]<br> - <br> -Example:<br> -$ds9 -frame center # center current frame<br> -$ds9 -frame center 1 # center 'Frame1'<br> -$ds9 -frame center all # center all frames<br> -$ds9 -frame clear # clear current frame<br> -$ds9 -frame new # create new frame<br> -$ds9 -frame new rgb # create new rgb frame<br> -$ds9 -frame delete # delete current frame<br> -$ds9 -frame reset # reset current frame<br> -$ds9 -frame refresh # refresh current frame<br> -$ds9 -frame hide # hide current frame<br> -$ds9 -frame show 1 # show frame 'Frame1'<br> -$ds9 -frame move first # move frame to first in order<br> -$ds9 -frame move back # move frame back in order<br> -$ds9 -frame move forward # move frame forward in order<br> -$ds9 -frame move last # move frame to last in order<br> -$ds9 -frame first # goto first frame<br> -$ds9 -frame prev # goto prev frame<br> -$ds9 -frame next # goto next frame<br> -$ds9 -frame last # goto last frame<br> -$ds9 -frame frameno 4 # goto frame 'Frame4', create if needed<br> -$ds9 -frame 3 # goto frame 'Frame3', create if needed<br> -$ds9 -frame lock wcs</tt><br> -<p><b><a name="gif" id="gif"></a>gif</b></p> -<p>Load GIF image into current frame.</p> -<tt>Syntax:<br> --gif <filename><br> - <br> -Example:<br> -$ds9 -gif foo.gif<br> -$cat foo.gif | ds9 -gif -<br></tt> -<p><b><a name="geometry" id="geometry"></a>geometry</b></p> -<p>Define the initial window geometry. This includes all of the ds9 -window, not just the image space. see X(1).</p> -<tt>Syntax:<br> --geometry value<br> - <br> -Example:<br> -$ds9 -geometry 640x480</tt> -<p><b><a name="green" id="green"></a>green</b></p> -<p>For RGB frames, sets the current color channel to green.</p> -<tt>Syntax:<br> --green<br> - <br> -Example:<br> -$ds9 -green foo.fits</tt> -<p><b><a name="grid" id="grid"></a>grid</b></p> -<p>Controls coordinate grid. For grid numeric format syntax, -click <a href="grid.html#Format">here</a>.</p> -<tt>Syntax:<br> --grid []<br> - [yes|no]<br> - [type analysis|publication]<br> - [system <coordsys>]<br> - [sky <skyframe>]<br> - [skyformat <skyformat>]<br> - [grid yes|no]<br> - [grid color <color>]<br> - [grid width <value>]<br> - [grid dash yes|no]<br> - [grid gap1 <value>]<br></tt> -<tt><tt> [grid gap2 -<value>]<br></tt></tt> -<tt><tt><tt> [grid gap3 -<value>]<br></tt></tt> [axes -yes|no]<br> - [axes color <color>]<br> - [axes width <value>]<br> - [axes dash yes|no]<br> - [axes type -interior|exterior]<br></tt> <tt> -[axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> -<tt> [format1 <format>]<br> - [format2 <format>]<br> - [tickmarks yes|no]<br> - [tickmarks color <color>]<br> - [tickmarks width <value>]<br> - [tickmarks dash yes|no]<br> - [border yes|no]<br> - [border color <color>]<br> - [border width <value>]<br> - [border dash yes|no]<br> - [numerics yes|no]<br> - [numerics font -times|helvetica|courier]<br> - [numerics fontsize -<value>]<br> - [numerics fontweight -normal|bold]<br> - [numerics fontslant -roman|italic]<br> - [numerics color <color>]<br> - [numerics gap1 -<value>]<br></tt> <tt><tt> -[numerics gap2 <value>]<br></tt></tt> -<tt><tt><tt> [numerics gap3 -<value>]<br></tt></tt> -[numerics type interior|exterior]<br> - [numerics vertical yes|no]<br> - [title yes|no]<br> - [title text <text>]<br> - [title def yes|no]<br> - [title gap <value>]<br> - [title font -times|helvetica|courier]<br> - [title fontsize <value>]<br> - [title fontweight normal|bold]<br> - [title fontslant roman|italic]<br> - [title color <color>]<br> - [labels yes|no]<br> - [labels text1 <text>]<br></tt> -<tt><tt> [labels text2 -<text>]<br></tt> [labels def1 -yes|no]<br></tt> <tt><tt> [labels -def2 yes|no]<br></tt> [labels gap1 -<value>]<br> - [labels gap2 <value>]<br> - [labels font -times|helvetica|courier]<br> - [labels fontsize <value>]<br> - [labels fontweight normal|bold]<br> - [labels fontslant roman|italic]<br> - [labels color <color>]<br> - [reset]<br> - [load <filename>]<br> - [save <filename>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -grid<br> -$ds9 -grid yes<br> -$ds9 -grid type analysis<br> -$ds9 -grid system wcs<br> -$ds9 -grid sky fk5<br> -$ds9 -grid skyformat degrees<br> -$ds9 -grid grid yes<br> -$ds9 -grid grid color red<br> -$ds9 -grid grid width 2<br> -$ds9 -grid grid dash yes<br> -$ds9 -grid grid gap1 10<br></tt> <tt><tt>$ds9 -grid grid gap2 -10<br></tt></tt> <tt><tt><tt>$ds9 -grid grid gap3 10<br></tt></tt> -$ds9 -grid axes yes<br> -$ds9 -grid axes color red<br> -$ds9 -grid axes width 2<br> -$ds9 -grid axes dash yes<br> -$ds9 -grid axes type exterior<br> -$ds9 -grid axes origin lll<br> -$ds9 -grid format1 d.2<br> -$ds9 -grid format2 d.2<br> -$ds9 -grid tickmarks yes<br> -$ds9 -grid tickmarks color red<br> -$ds9 -grid tickmarks width 2<br> -$ds9 -grid tickmarks dash yes<br> -$ds9 -grid border yes<br> -$ds9 -grid border color red<br> -$ds9 -grid border width 2<br> -$ds9 -grid border dash yes<br> -$ds9 -grid numerics yes<br> -$ds9 -grid numerics font courier<br> -$ds9 -grid numerics fontsize 12<br> -$ds9 -grid numerics fontweight bold<br> -$ds9 -grid numerics fontslant italic<br> -$ds9 -grid numerics color red<br> -$ds9 -grid numerics gap1 10<br></tt> <tt><tt>$ds9 -grid numerics -gap2 10<br></tt></tt> <tt><tt><tt>$ds9 -grid numerics gap3 -10<br></tt></tt> $ds9 -grid numerics type exterior<br> -$ds9 -grid numerics vertical yes<br> -$ds9 -grid title yes<br> -$ds9 -grid title text {Hello World}<br> -$ds9 -grid title def yes<br> -$ds9 -grid title gap 10<br> -$ds9 -grid title font courier<br> -$ds9 -grid title fontsize 12<br> -$ds9 -grid title fontweight bold<br> -$ds9 -grid title fontslant italic<br> -$ds9 -grid title color red<br> -$ds9 -grid labels yes<br> -$ds9 -grid labels text1 {Hello World}<br></tt> <tt><tt>$ds9 -grid -labels text2 {Hello World}<br></tt> $ds9 -grid labels def1 yes<br> -$ds9 -grid labels def2 yes<br></tt> <tt><tt>$ds9 -grid labels gap1 -10<br></tt> $ds9 -grid labels gap2 10<br> -$ds9 -grid labels font courier<br> -$ds9 -grid labels fontsize 12<br> -$ds9 -grid labels fontweight bold<br> -$ds9 -grid labels fontslant italic<br> -$ds9 -grid labels color red<br> -$ds9 -grid reset<br> -$ds9 -grid load foo.grd<br> -$ds9 -grid save foo.grd<br> -$ds9 -grid open<br> -$ds9 -grid close<br></tt> -<p><b><a name="header" id="header"></a>header</b></p> -<p>Display current fits header dialog. Optional extension number -maybe specified.</p> -<tt>Syntax:<br> --header [<ext>]<br> - [close [<ext>]]<br> - [save [<ext>] -<filename>]<br> - <br> -Example:<br> -$ds9 -header<br> -$ds9 -header 2<br> -$ds9 -header close<br> -$ds9 -header save 1 foo.txt<br></tt> -<p><b><a name="height" id="height"></a>height</b></p> -<p>Set the height of the image display window. Use the <a href= -"command.html#geometry">geometry</a> command to set the overall -width and height of the ds9 window.</p> -<tt>Syntax:<br> --height [<value>]<br> - <br> -Example:<br> -$ds9 -height 512<br></tt> -<p><b><a name="help" id="help"></a>help</b></p> -<p>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.</p> -<tt>Syntax:<br> --help # Display brief help message and exit.<br> ---help # Display command line options within help facility.<br> --? # Display command line options within help facility.<br> - <br> -Example:<br> -$ds9 -help # Display brief help message and exit.<br> -$ds9 --help # Display command line options within help facility<br> -$ds9 -? # Display command line options within help -facility.<br></tt> -<p><b><a name="histequ" id="histequ"></a>histequ</b></p> -<p>Select histogram equalization scale function for the current -frame.</p> -<tt>Syntax:<br> --histequ<br> - <br> -Example:<br> -$ds9 -histequ<br></tt> -<p><b><a name="iconify" id="iconify"></a>iconify</b></p> -<p>Toggles iconification.</p> -<tt>Syntax:<br> --iconify []<br> - [yes|no]<br> - <br> -Example:<br> -$ds9 -iconify<br> -$ds9 -iconify yes</tt><br> -<p><b><a name="invert" id="invert"></a>invert</b></p> -<p>Invert Colormap.</p> -<tt>Syntax:<br> --invert<br> - <br> -Example:<br> -$ds9 -invert<br></tt> -<p><b><a name="iis" id="iis"></a>iis</b></p> -<p>Set IIS Filename. Optional mosaic number maybe supplied.</p> -<tt>Syntax:<br> --iis [filename <filename> [#]]<br> - <br> -Example:<br> -$ds9 -iis filename foo.fits<br> -$ds9 -iis filename bar.fits 4</tt><br> -<p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> -<p>Load JPEG image into current frame.</p> -<tt>Syntax:<br> --jpeg <filename><br> - <br> -Example:<br></tt> <tt>$ds9 -jpeg foo.jpeg</tt><br> -<tt>$cat foo.jpeg | ds9 -jpeg -</tt><br> -<p><b><a name="language" id="language"></a>language</b></p> -<p>Select current language.</p> -<tt>Syntax:<br> --language [locale|da|de|es|en|fr|ja|pt]<br> - <br> -Example:<br> -$ds9 -language fr<br></tt> -<p><b><a name="linear" id="linear"></a>linear</b></p> -<p>Select linear scale function for the current frame.</p> -<tt>Syntax:<br> --linear<br> - <br> -Example:<br> -$ds9 -linear</tt> -<p><b><a name="lock" id="lock"></a>lock</b></p> -<p>Lock all other frames to the current frame.</p> -<tt>Syntax:<br></tt> <tt>-lock</tt> <tt>[frame -<coordsys>|none]<br> - </tt> <tt>[crosshair -<coordsys>|none]</tt> <tt><br></tt> <tt> - [crop <coordsys>|none]</tt><br> -<tt> [slice -<coordsys>|none]</tt><br> -<tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimits [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br></tt> -<tt> [smooth [yes|no]]</tt><br> -<tt> [3d [yes|no]]</tt><tt><br></tt> -<tt><br></tt> <tt>Example:</tt> <tt><br> -$ds9 -lock frame wcs</tt><tt><br></tt> <tt>$ds9 -lock crosshair -wcs</tt><tt><br></tt> <tt>$ds9 -lock crop wcs</tt><br> -<tt>$ds9 -lock slice wcs</tt><br> -<tt>$ds9 -lock bin yes<br> -$ds9 -lock axes yes<br></tt> <tt>$ds9 -lock scale yes<br> -$ds9 -lock scalelimits yes<br></tt> <tt>$ds9 -lock colorbar -yes</tt><tt><br> -$ds9 -lock block yes</tt><tt><br> -$ds9 -lock smooth yes</tt><tt><br> -$ds9 -lock 3d yes<br></tt> <b><a name="log" id="log"></a>log</b> -<p>Select log scale function for the current frame.<br></p> -<tt>Syntax:<br> --log<br> - <br> -Example:<br> -$ds9 -log</tt> -<p><b><a name="lower" id="lower"></a>lower</b></p> -<p>Lower in the window stacking order.</p> -<tt>Syntax:<br> --lower<br> - <br> -Example:<br> -$ds9 -lower<br></tt> -<p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> -<p>Controls the magnifier settings.</p> -<tt>Syntax:<br> -magnifier [color <color>]<br> - [zoom -<value>]<br> - [cursor -yes|no]<br> - [region -yes|no]<br> - <br> -Example:<br> -$ds9 -magnifier color yellow<br> -$ds9 -magnifier zoom 2<br> -$ds9 -magnifier cursor no<br> -$ds9 -magnifier region no<br></tt> -<p><b><a name="mask" id="mask"></a>mask<br> -nomask<br></b></p> -<p>Controls mask parameters.</p> -<tt>Syntax:<br> --mask [color <color>]<br> - [mark 1|0]<br> - [transparency <value>]<br> - [clear]<br> - [open|close]<br> --nomask<br> - <br> -Example:<br> -$ds9 -mask color red<br> -$ds9 -mask mark 0<br> -$ds9 -mask transparency 50<br> -$ds9 -mask clear<br> -$ds9 -mask open<br> -$ds9 -mask close<br> -$ds9 -nomask<br></tt> -<p><b><a name="match" id="match"></a>match</b></p> -<p>Match all other frames to the current frame.</p> -<tt>Syntax:<br></tt> <tt>-match</tt> <tt>[frame -<coordsys>]<br> - </tt> <tt>[crosshair -<coordsys>]</tt> <tt><br></tt> -<tt> [crop -<coordsys>]</tt><br> -<tt> [slice -<coordsys>]</tt><br> -<tt> [bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]<br></tt> -<tt><tt> [3d]</tt><tt><tt><br> - </tt></tt><br> -Example:<br></tt> <tt>$ds9 -match frame wcs<br></tt> <tt>$ds9 --match crosshair wcs<br></tt> <tt>$ds9 -match crop wcs</tt><br> -<tt>$ds9 -match slice wcs</tt><br> -<tt>$ds9 -match bin<br> -$ds9 -match axes<br> -$ds9 -match scale<br> -$ds9 -match scalelimits<br> -$ds9 -match colorbar<br> -$ds9 -match block<br></tt> <tt><tt>$ds9 -match smooth<br></tt> $ds9 --match 3d</tt><br> -<tt> <br></tt> <b><a name="mecube" id="mecube"></a>mecube</b> -<p>Load FITS multiple extension file as data cube.<br></p> -<tt>Syntax:<br> -mecube <filename><br> - <br> -Example:<br> -$ds9 -mecube foo.fits</tt><tt><tt><br></tt> $cat foo.fits | ds9 --mecube -</tt><br> -<p><b><a name="minmax" id="minmax"></a>minmax</b></p> -<p>This is how DS9 determines the min and max data values -from the data. <tt>SCAN</tt> will scan all data.</p> -<tt>Syntax:<br> --minmax [scan|sample|datamin|irafmin]<br> - [mode -scan|sample|datamin|irafmin]<br> - [interval #]<br> - <br> -Example:<br> -$ds9 -minmax scan<br> -$ds9 -minmax mode scan<br> -$ds9 -minmax interval 100<br></tt> -<p><b><a name="mode" id="mode"></a>mode</b></p> -<p>Select the current mode.</p> -<tt>Syntax:<br> --mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> - - <br> -Example:<br> -$ds9 -mode crosshair</tt><br> -<p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> -<p>Load FITS mosaic segment into current frame.</p> -<tt>Syntax:<br> --mosaic [wcs|wcsa...wcsz|iraf] <filename><br> - <br> -Example:</tt> <tt><br> -$ds9 -mosaic foo.fits</tt><br> -<tt><tt>$ds9 -mosaic wcs -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> $cat foo.fits | ds9 --mosaic -</tt><br> -<tt><tt>$cat foo.fits | ds9 -mosaic wcs -</tt></tt><tt><br></tt> -<p><b><a name="mosaicimage" id= -"mosaicimage"></a>mosaicimage</b></p> -<p>Load FITS mosaic image into current frame.</p> -<tt>Syntax:<br> --mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename><br> - <br> -Example:</tt> <tt><br> -$ds9 -mosaicimage foo.fits</tt><br> -<tt><tt>$ds9 -mosaicimage wcs -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> $cat foo.fits | ds9 --mosaicimage</tt><br> -<tt><tt>$cat foo.fits | ds9 -mosaiimage wcs</tt></tt><tt><br></tt> -<p><b><a name="movie" id="movie"></a>movie<br> -savempeg<br></b></p> -<p>Create mpeg1 movie from snap shots of the DS9 window. A -<tt>slice</tt> movie cycles though all slices of a cube. A -<tt>frame</tt> movie cycles through all active frames. A -<tt>3d</tt> movie cycles through specified viewing angles. The -default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: -number of frames, azimuth from/to, elevation from/to, slice -from/to, oscillate/repeat times.<br></p> -<tt>Syntax:<br> --movie [slice|frame|3d] <filename><br> --movie 3d <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>]<br> - <br> -Example:<br> -$ds9 -movie slice ds9.mpg<br> -$ds9 -movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate -1</tt><br> -<p><b><a name="msg" id="msg"></a>msg</b></p> -<p>Specify a directory of translation tables to be loaded.</p> -<tt>Syntax:<br> --msg <directory><br> - <br> -Example:<br> -$ds9 -msg $HOME/msgs</tt><br> -<p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> -<p>Load FITS multiple extension file as multiple images.<br></p> -<tt>Syntax:<br> -multiframe <filename><br> - <br> -Example:<br> -$ds9 -multiframe foo.fits</tt><tt><tt><br></tt> $cat foo.fits | ds9 --multiframe -</tt><tt><br></tt> -<p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> -<p>Support Name Server functions. Coordinates are in fk5.</p> -<tt>Syntax:<br> --nameserver [<object>]<br> - [name <object>]<br> - [server</tt> -<tt><tt>ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt></tt>]<br> - - [skyformat -degrees|sexagesimal]<br> + + [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> + </tt> + [2mass|iras]<br> + [csc|xmm|rosat]<br> + [first|nvss]<br> + + [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> + [cds <catalogname>]<br> + [cds + <catalogid>]<br> + <br> + [load <filename>]<br> + [import sb|tsv + <filename>]<br> + <br> + </tt> <tt><tt> + [<ref>] [<ra> <dec> + <coordsys>]</tt><tt><br> + </tt> + [<ref>] [allcols]<br> + </tt> + <tt> </tt><tt> [<ref>] + [allrows]<br> + </tt><tt> [<ref>] + [cancel]<br> + </tt> <tt> + [<ref>] [clear]<br> + </tt> <tt> + [<ref>] [close]</tt><br> + <tt> </tt> + <tt>[<ref>] [crosshair]</tt><br> + <tt> [<ref>] [dec + <col>]</tt><br> + <tt> [<ref>] [edit + yes|no]</tt><br> + <tt> [<ref>] + [export sb|tsv <filename>]<br> + </tt> + <tt> [<ref>] + [filter <string>]<br> + [<ref>] [filter load + <filename>]</tt><br> + <tt> [<ref>] + [header]</tt><br> + <tt> [<ref>] [location + <code>]</tt><br> + <tt><tt> [<ref>] + [match <ref> <ref>]<br> + </tt></tt> + <tt><tt><tt> + [<ref>] [match]<br> + </tt></tt> + </tt> <tt>[<ref>] +[match + error <value> degrees|arcmin|arcsec]</tt><br> + <tt> </tt> + <tt>[<ref>] [match function 1and2|1not2|2not1]<br> + </tt> + <tt> </tt> + <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> + <tt> </tt> + <tt>[<ref>] [match unique yes|no]</tt><br> + <tt> [<ref>] [maxrows + <number>]</tt><br> + <tt> [<ref>] [name + <object>]<br> + </tt> + <tt> [<ref>] + [panto + yes|no]</tt><br> + <tt> [<ref>] [plot + <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> + <tt> [<ref>] [print]</tt><br> + <tt> [<ref>] [psky + <skyframe>]</tt><br> + <tt> [<ref>] [psystem + <coordsys>]</tt><br> + <tt> [<ref>] [ra + <col>]</tt><br> + <tt><tt> [<ref>] + [regions]</tt><br> + [<ref>] + [retrieve]<br> + </tt> <tt> + [<ref>] [samp]<br> + [<ref>] [samp + broadcast]<br> + [<ref>] [samp + send + <application>]</tt><tt><br> + </tt> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] + [server</tt> + <tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> + <tt> [<ref>] [show + yes|no]</tt><br> + <tt> [<ref>] [radius + <value> degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> + [<ref>] [skyformat + <skyformat>]<br> + </tt> <tt> + [<ref>] [sort <col> + incr|decr]</tt><br> + <tt> [<ref>] [symbol + [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>]<br> + </tt> <tt> + [<ref>] [symbol [#] text|size|size2|units|angle + <value>]</tt><br> + <tt><tt> [<ref>] + [symbol + shape circle|ellipse|box|text|point]<br> + </tt></tt> + <tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt>circle point|box point|diamond + point|</tt></tt></tt></tt>cross point|x point|arrow + point|boxcircle + point]<br> + </tt></tt> <tt> + [<ref>] [symbol add| [#] remove]<br> + [<ref>] [symbol + save|load <filename>]</tt><br> + <tt> [<ref>] [system + <coordsys>]</tt><tt><br> + </tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> + <tt> [<ref>] [x + <col>]</tt><br> + <tt> [<ref>] [y + <col>]</tt><br> + <tt><br> + Example:<br> + </tt> <tt><tt>$ds9 -catalog new<br> + </tt> $ds9 -catalog + 2mass<br> + $ds9 -catalog cds 2mass<br> + $ds9 -catalog cds "I/252"<br> + <br> + </tt> <tt>$ds9 -catalog load foo.xml<br> + $ds9 -catalog import tsv foo.tsv<br> + <br> + </tt> <tt><tt>$ds9 -catalog 202.48 47.21 fk5<br> + </tt> $ds9 + -catalog allrows<br> + $ds9 -catalog allcols<br> + </tt> <tt>$ds9 -catalog cancel<br> + </tt> + <tt>$ds9 -catalog clear<br> + </tt> <tt>$ds9 -catalog close<br> + </tt> + <tt>$ds9 -catalog crosshair<br> + </tt> <tt>$ds9 -catalog dec + DEC<br> + </tt> <tt>$ds9 -catalog edit yes<br> + </tt> <tt>$ds9 -catalog + export tsv bar.tsv<br> + </tt> <tt>$ds9 -catalog filter</tt> + <tt>'\$Jmag>15'</tt><tt><br> + $ds9 -catalog filter load foo.flt<br> + $ds9 -catalog header<br> + </tt> <tt>$ds9 -catalog location + 500</tt><br> + <tt>$ds9 -catalog match error 2 arcsec<br> + $ds9 -catalog match function 1and2<br> + $ds9 -catalog match unique no<br> + $ds9 -catalog match return 1only<br> + </tt> <tt>$ds9 -catalog match # + last two catalogs loaded<br> + </tt> <tt>$ds9 -catalog match 2mass + csc<br> + </tt> <tt>$ds9 -catalog maxrows 2000<br> + </tt> <tt>$ds9 + -catalog name m51<br> + $ds9 -catalog panto no<br> + </tt> <tt>$ds9 -catalog plot</tt> + <tt>'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag'</tt><tt><br> + </tt> + <tt>$ds9 -catalog print</tt><br> + <tt>$ds9 -catalog psky fk5</tt><br> + <tt>$ds9 -catalog psystem wcs</tt><br> + <tt>$ds9 -catalog ra RA</tt><br> + <tt><tt>$ds9 -catalog regions<br> + </tt> $ds9 -catalog + retrieve<br> + </tt> <tt>$ds9 -catalog samp broadcast<br> + $ds9 -catalog samp send aladin<br> + $ds9 -catalog save foo.xml<br> + </tt> <tt>$ds9 -catalog server + sao<br> + </tt> <tt>$ds9 -catalog show yes</tt><br> + <tt>$ds9 -catalog radius 1 degrees</tt><br> + <tt>$ds9 -catalog symbol condition '\$Jmag>15'<br> + $ds9 -catalog symbol 2 shape "boxcircle point"<br> + $ds9 -catalog symbol color red<br> + $ds9 -catalog symbol font times<br> + </tt> <tt>$ds9 -catalog symbol + fontsize 14<br> + </tt> <tt>$ds9 -catalog symbol fontweight + bold<br> + </tt> <tt>$ds9 -catalog symbol fontslant italic<br> + </tt> + <tt>$ds9 -catalog symbol add<br> + $ds9 -catalog symbol 2 remove<br> + $ds9 -catalog symbol load foo.sym<br> + $ds9 -catalog symbol save bar.sym</tt><tt><br> + $ds9 -catalog sky fk5<br> + $ds9 -catalog skyformat degrees<br> + </tt> <tt>$ds9 -catalog sort + "Jmag" incr<br> + </tt> <tt>$ds9 -catalog system wcs</tt><tt><br> + </tt> + <tt>$ds9 -catalog update<br> + </tt> <tt>$ds9 -catalog x RA<br> + $ds9 -catalog y DEC</tt><br> + <p><b><a name="cd" id="cd"></a>cd</b></p> + <p>Sets the current working directory.</p> + <tt>Syntax:<br> + cd [<directory>]<br> + <br> + Example:<br> + $ds9 -cd /home/mrbill<br> + </tt> + <p><b><a name="cmap" id="cmap"></a>cmap</b></p> + <p>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.</p> + <tt>Syntax:<br> + -cmap [<colormap>]<br> + [load <filename>]<br> + [save <filename>]<br> + [invert yes|no]<br> + [<contrast> + <bias>]<br> + </tt> <tt> [tag + [load|save] <filename>]<br> + [tag delete]</tt><br> + <tt> [open|close]<br> + <br> + Example:<br> + $ds9 -cmap Heat<br> + $ds9 -cmap load foo.sao<br> + $ds9 -cmap save bar.sao<br> + $ds9 -cmap invert yes<br> + $ds9 -cmap 5 .5<br> + $ds9 -cmap tag load foo.tag<br> + $ds9 -cmap tag save foo.tag<br> + $ds9 -cmap tag delete<br> + </tt> <tt>$ds9 -cmap open<br> + $ds9 -cmap close<br> + </tt> + <p><b><a name="colorbar" id="colorbar"></a>colorbar</b></p> + <p>Controls colorbar parameters.</p> + <tt>Syntax:<br> + -colorbar []<br> + [yes|no]<br> + + [horizontal|vertical]<br> + [numerics + yes|no]<br> + [space + value|distance]<br> + [font + times|helvetica|courier]<br> + [fontsize + <value>]<br> + + [fontweight + normal|bold]<br> + [fontslant + roman|italic]<br> + [size]<br> + [ticks]<br> + </tt> + <tt><tt> + [match]<br> + [lock + [yes|no]]</tt><br> + <br> + Example:<br> + $ds9 -colorbar yes<br> + $ds9 -colorbar vertical<br> + $ds9 -colorbar numerics yes<br> + $ds9 -colorbar space value<br> + $ds9 -colorbar font times<br> + $ds9 -colorbar fontsize 14<br> + $ds9 -colorbar fontweight bold<br> + $ds9 -colorbar fontslant italic<br> + $ds9 -colorbar size 20<br> + $ds9 -colorbar ticks 11</tt><br> + <tt>$ds9 -colorbar match<br> + $ds9 -colorbar lock yes</tt><br> + <p><b><a name="console" id="console"></a>console</b></p> + <p>Display tcl console window.</p> + <tt>Syntax:<br> + -console<br> + <br> + Example:<br> + $ds9 -console<br> + </tt> + <p><b><a name="contour" id="contour"></a>contour<br> + </b></p> + <p>Controls contours in the current frame.</p> + <tt>Syntax:<br> + -contour []<br> + [yes|no]<br> + [clear]<br> + [generate]<br> + [load + <filename>]<br> + [save + <filename> + [<coordsys> <skyframe>]]<br> + [convert]<br> + [load levels + <filename>]</tt><br> + <tt><tt> [save + levels <filename>]<br> + </tt> + [copy]<br> + [paste + [<coordsys> <color> <width> yes|no]]<br> + [color + <color>]<br> + [width + <width>]<br> + [dash yes|no]<br> + [smooth + <smooth>]<br> + [method + block|smooth]<br> + [nlevels <number + of + levels>]<br> + [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + [log exp + <value>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope + global|local]<br> + [limits <min> + <max>]<br> + [levels + <value + value value...>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -contour<br> + $ds9 -contour yes<br> + $ds9 -contour generate<br> + $ds9 -contour clear<br> + $ds9 -contour load ds9.ctr<br> + </tt> <tt><tt>$ds9 -contour save + ds9.ctr<br> + </tt></tt> <tt><tt><tt>$ds9 -contour save ds9.ctr wcs + fk5<br> + </tt></tt> $ds9 -contour convert<br> + $ds9 -contour load levels ds9.ctr<br> + </tt> <tt><tt>$ds9 -contour + save levels ds9.lev<br> + </tt> $ds9 -contour copy<br> + </tt> + <tt><tt>$ds9 -contour paste<br> + </tt></tt> <tt><tt><tt>$ds9 -contour + paste wcs red 2 no<br> + </tt></tt> $ds9 -contour color yellow<br> + $ds9 -contour width 2<br> + $ds9 -contour dash yes<br> + $ds9 -contour smooth 5<br> + $ds9 -contour method smooth<br> + $ds9 -contour nlevels 10<br> + $ds9 -contour scale sqrt<br> + $ds9 -contour log exp 1000<br> + $ds9 -contour mode zscale<br> + $ds9 -contour scope local<br> + $ds9 -contour limits 1 100<br> + $ds9 -contour levels "1 10 100 1000"<br> + $ds9 -contour open<br> + $ds9 -contour close<br> + </tt> + <p><b><a name="crop" id="crop"></a>crop</b></p> + <p>Set current image display area.</p> + <tt>Syntax:<br> + -crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> + </tt> + <tt> [match <coordsys>]<br> + [lock + <coordsys>|none]</tt><br> + <tt><tt> [reset]<br> + [3d zmin zmax <coordsys>]<br> + [open|close]<br> + <br> + </tt> Example:<br> + $ds9 foo.fits -crop 40 30 10 20 # set crop in physical coords<br> + $ds9 foo.fits -crop +104:51:06.915 +68:33:40.761 28.144405 + 22.000204 wcs galactic arcsec<br> + $ds9 foo.fits -crop match wcs<br> + $ds9 foo.fits -crop lock wcs<br> + $ds9 foo.fits -crop reset</tt><br> + <tt>$ds9 foo.fits -crop 3d .25 .5 wcs<br> + $ds9 foo.fits -crop open<br> + $ds9 foo.fits -crop close<br> + </tt> + <p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> + <p>Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set.</p> + <tt>Syntax:<br> + -crosshair [<x> <h> <coordsys> + [<skyframe>]]<br> + </tt><tt> +[match + <coordsys>]<br> + [lock + <coordsys>|none]</tt><br> + <tt> <br> + Example:<br> + $ds9 -crosshair 100 100 physical # set crosshair in physical<br> + $ds9 -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords<br> + $ds9 -crosshair 23:01:00 +58:52:51 wcs fk5<br> + $ds9 -crosshair match<br> + $ds9 -crosshair lock wcs<br> + </tt> + <p><b><a name="cube" id="cube"></a>cube<br> + </b></p> + <p>Controls FITS cube.</p> + <tt>Syntax:<br> + -cube []<br> + [play|stop|next|prev|first|last]<br> + [<slice> + [<coordsys>][<axis>]]<br> + [interval <numeric>]<br> + </tt> + <tt> [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]<br> + </tt> + <tt> [open|close]<br> + <br> + Example:<br> + $ds9 -cube<br> + $ds9 -cube play<br> + $ds9 -cube last<br> + $ds9 -cube 3<br> + $ds9 -cube 4.5 wcs 3<br> + $ds9 -cube interval 2<br> + $ds9 -cube match wcs<br> + $ds9 -cube lock wcs<br> + $ds9 -cube order 123<br> + $ds9 -cube axes lock yes<br> + $ds9 -cube open<br> + $ds9 -cube close</tt><br> + <p><b><a name="cursor" id="cursor"></a>cursor</b></p> + <p>Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also.</p> + <tt>Syntax:<br> + -cursor [<x> <h>]<br> + <br> + Example:<br> + $ds9 -cursor 10 10</tt><tt><br> + </tt> + <p><b><a name="dsssao" id="dsssao"></a>dsssao<br> + dss<br> + </b></p> + <p>Support for Digital Sky Survey at SAO.</p> + <tt>Syntax:<br> + -dsssao []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> + <dec>] + # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update + frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -dsssao<br> + $ds9 -dsssao m31<br> + </tt> <tt><tt>$ds9 -dsssao name + m31<br> + </tt></tt> <tt><tt><tt>$ds9 -dsssao name clear<br> + </tt></tt> + $ds9 -dsssao 00:42:44.404 +41:16:08.78<br> + $ds9 -dsssao size 60 60 arcmin<br> + $ds9 -dsssao save yes<br> + $ds9 -dsssao frame current<br> + $ds9 -dsssao update frame<br> + $ds9 -dsssao open<br> + $ds9 -dsssao close<br> + </tt> + <p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> + <p>Support for Digital Sky Survey at ESO.</p> + <tt>Syntax:<br> + -dsseso []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> + <dec>] + # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update + frame|crosshair]<br> + [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -dsseso<br> + $ds9 -dsseso m31<br> + </tt> <tt><tt>$ds9 -dsseso name + m31<br> + </tt></tt> <tt><tt><tt>$ds9 -dsseso name clear<br> + </tt></tt> + $ds9 -dsseso 00:42:44.404 +41:16:08.78<br> + $ds9 -dsseso size 60 60 arcmin<br> + $ds9 -dsseso save yes<br> + $ds9 -dsseso frame current<br> + $ds9 -dsseso update frame<br> + $ds9 -dsseso survey DSS2-red<br> + $ds9 -dsseso open<br> + </tt> <tt>$ds9 -dsseso close</tt><br> + <p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> + <p>Support for Digital Sky Survey at STSCI.</p> + <tt>Syntax:<br> + -dssstsci []<br> + [<object>]<br> + [name + <object>|clear]<br> + + [<ra> + <dec>] # in wcs fk5<br> + [size + <width> <height> degrees|arcmin|arcsec]<br> + [save + yes|no]<br> + [frame + new|current]<br> + [update + frame|crosshair]<br> + [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> + [survey + poss1_blue|poss1_red]<br> + [survey + all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -dssstsci<br> + $ds9 -dssstsci m31<br> + </tt> <tt><tt>$ds9 -dssstsci name + m31<br> + </tt></tt> <tt><tt><tt>$ds9 -dssstsci name + clear<br> + </tt></tt> $ds9 -dssstsci 00:42:44.404 +41:16:08.78<br> + $ds9 -dssstsci size 60 60 arcmin<br> + $ds9 -dssstsci save yes<br> + $ds9 -dssstsci frame current<br> + $ds9 -dssstsci update frame<br> + $ds9 -dssstsci survey all<br> + $ds9 -dssstsci open<br> + $ds9 -dssstsci close</tt><br> + <p><b><a name="envi" id="envi"></a>envi</b></p> + <p>Load an ENVI header and file. Optional parameter: array + endian.<br> + </p> + <tt>Syntax:<br> + -envi <header> [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt><tt><tt>$ds9 -envi + foo.hdr</tt></tt><tt><tt><tt><tt><tt><tt><br> + </tt></tt></tt></tt></tt></tt></tt></tt> + <tt><tt>$ds9 -envi foo.hdr + foo.bsq</tt></tt><tt><tt><tt><tt><tt><tt><br> + </tt></tt></tt></tt></tt></tt> + <p><b><a name="exit" id="exit"></a>exit<br> + quit</b></p> + <p>Quits DS9.</p> + <tt>Syntax:<br> + -exit<br> + -quit<br> + <br> + Example:<br> + $ds9 -exit<br> + </tt> + <p><b><a name="export" id="export"></a>export<br> + </b></p> + <p>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.<br> + </p> + <tt>Syntax:<br> + -export [array|nrrd|envi|gif|tiff|jpeg|png] + <filename></tt><tt><br> + </tt> <tt><tt>-export array + <filename></tt> <tt>[big|little</tt><tt>|native]<br> + </tt> + -export nrrd <filename></tt> + <tt>[big|little</tt><tt>|native]</tt><br> + <tt>-export envi <header> [<filename>]</tt> + <tt>[big|little</tt><tt>|native]</tt> <tt><br> + </tt> <tt>-export + <filename></tt><tt>.jpeg [1-100]<br> + </tt> <tt>-export + <filename></tt><tt>.tiff + [none|jpeg|packbits|deflate]</tt><br> + <tt> <br> + Example:<br> + $ds9 -export array foo.arr little<br> + $ds9 -export nrrd foo.nrrd little<br> + $ds9 -export envi foo.hdr little<br> + </tt> <tt><tt>$ds9 -export envi + foo.hdr foo.bsq little<br> + </tt> $ds9 -export tiff foo.tiff jpeg<br> + $ds9 -export jpeg foo.jpeg 75<br> + $ds9 -export png foo.png</tt><br> + <p><b><a name="fifo" id="fifo"></a>fifo</b></p> + <p>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.</p> + <tt>Syntax:<br> + -fifo name<br> + <br> + Example:<br> + $ds9 -fifo /dev/imt1</tt> + <p><b><a name="fifo_only" id="fifo_only"></a>fifo_only</b></p> + <p>Only use IRAF input and output fifos. Same as -port 0 -unix + none.</p> + <tt>Syntax:<br> + -fifo_only<br> + <br> + Example:<br> + $ds9 -fifo_only<br> + </tt> + <p><b><a name="fits" id="fits"></a>fits</b></p> + <p>Load a FITS image into the current frame.<br> + </p> + <tt>Syntax:<br> + -fits</tt> <tt><tt><filename></tt></tt><tt><br> + <br> + Example:<br> + </tt> <tt>$ds9 -fits foo.fits<br> + $ds9 -fits bar.fits[bin=detx,dety]<br> + $cat foo.fits | ds9 -fits -<br> + $cat bar.fits | ds9 -fits -[bin=detx,dety]</tt><tt><br> + </tt> + <p><b><a name="frame" id="frame"></a>frame</b></p> + <p>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.</p> + <tt>Syntax:<br> + -frame [center [#|all]]<br> + [clear [#|all]]<br> + [new [rgb]]<br> + [delete [#|all]]<br> + [reset [#|all]]<br> + [refresh [#|all]]<br> + [hide [#|all]]<br> + [show [#|all]]<br> + [move first]<br> + [move back]<br> + [move forward]<br> + [move last]<br> + [first]<br> + [prev]<br> + [next]<br> + [last]<br> + [frameno #]<br> + [#]<br> + [match <coordsys>]<br> + [lock + <coordsys>|none]<br> + <br> + Example:<br> + $ds9 -frame center # center current frame<br> + $ds9 -frame center 1 # center 'Frame1'<br> + $ds9 -frame center all # center all frames<br> + $ds9 -frame clear # clear current frame<br> + $ds9 -frame new # create new frame<br> + $ds9 -frame new rgb # create new rgb frame<br> + $ds9 -frame delete # delete current frame<br> + $ds9 -frame reset # reset current frame<br> + $ds9 -frame refresh # refresh current frame<br> + $ds9 -frame hide # hide current frame<br> + $ds9 -frame show 1 # show frame 'Frame1'<br> + $ds9 -frame move first # move frame to first in order<br> + $ds9 -frame move back # move frame back in order<br> + $ds9 -frame move forward # move frame forward in order<br> + $ds9 -frame move last # move frame to last in order<br> + $ds9 -frame first # goto first frame<br> + $ds9 -frame prev # goto prev frame<br> + $ds9 -frame next # goto next frame<br> + $ds9 -frame last # goto last frame<br> + $ds9 -frame frameno 4 # goto frame 'Frame4', create if needed<br> + $ds9 -frame 3 # goto frame 'Frame3', create if needed<br> + $ds9 -frame lock wcs</tt><br> + <p><b><a name="gif" id="gif"></a>gif</b></p> + <p>Load GIF image into current frame.</p> + <tt>Syntax:<br> + -gif <filename><br> + <br> + Example:<br> + $ds9 -gif foo.gif<br> + $cat foo.gif | ds9 -gif -<br> + </tt> + <p><b><a name="geometry" id="geometry"></a>geometry</b></p> + <p>Define the initial window geometry. This includes all of the + ds9 + window, not just the image space. see X(1).</p> + <tt>Syntax:<br> + -geometry value<br> + <br> + Example:<br> + $ds9 -geometry 640x480</tt> + <p><b><a name="green" id="green"></a>green</b></p> + <p>For RGB frames, sets the current color channel to green.</p> + <tt>Syntax:<br> + -green<br> + <br> + Example:<br> + $ds9 -green foo.fits</tt> + <p><b><a name="grid" id="grid"></a>grid</b></p> + <p>Controls coordinate grid. For grid numeric format syntax, + click <a href="grid.html#Format">here</a>.</p> + <tt>Syntax:<br> + -grid []<br> + [yes|no]<br> + [type analysis|publication]<br> + [system <coordsys>]<br> + [sky <skyframe>]<br> + [skyformat <skyformat>]<br> + [grid yes|no]<br> + [grid color <color>]<br> + [grid width <value>]<br> + [grid dash yes|no]<br> + [grid gap1 <value>]<br> + </tt> + <tt><tt> [grid gap2 + <value>]<br> + </tt></tt> + <tt><tt><tt> [grid gap3 + <value>]<br> + </tt></tt> [axes + yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes dash yes|no]<br> + [axes type + interior|exterior]<br> + </tt> <tt> + [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> + <tt> [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks dash yes|no]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border dash yes|no]<br> + [numerics yes|no]<br> + [numerics font + times|helvetica|courier]<br> + [numerics fontsize + <value>]<br> + [numerics fontweight + normal|bold]<br> + [numerics fontslant + roman|italic]<br> + [numerics color <color>]<br> + [numerics gap1 + <value>]<br> + </tt> <tt><tt> + [numerics gap2 <value>]<br> + </tt></tt> + <tt><tt><tt> [numerics gap3 + <value>]<br> + </tt></tt> + [numerics type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font + times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + [labels text1 <text>]<br> + </tt> + <tt><tt> [labels text2 + <text>]<br> + </tt> [labels def1 + yes|no]<br> + </tt> <tt><tt> [labels + def2 yes|no]<br> + </tt> [labels gap1 + <value>]<br> + [labels gap2 <value>]<br> + [labels font + times|helvetica|courier]<br> + [labels fontsize <value>]<br> + [labels fontweight normal|bold]<br> + [labels fontslant roman|italic]<br> + [labels color <color>]<br> + [reset]<br> + [load <filename>]<br> + [save <filename>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -grid<br> + $ds9 -grid yes<br> + $ds9 -grid type analysis<br> + $ds9 -grid system wcs<br> + $ds9 -grid sky fk5<br> + $ds9 -grid skyformat degrees<br> + $ds9 -grid grid yes<br> + $ds9 -grid grid color red<br> + $ds9 -grid grid width 2<br> + $ds9 -grid grid dash yes<br> + $ds9 -grid grid gap1 10<br> + </tt> <tt><tt>$ds9 -grid grid gap2 + 10<br> + </tt></tt> <tt><tt><tt>$ds9 -grid grid gap3 10<br> + </tt></tt> + $ds9 -grid axes yes<br> + $ds9 -grid axes color red<br> + $ds9 -grid axes width 2<br> + $ds9 -grid axes dash yes<br> + $ds9 -grid axes type exterior<br> + $ds9 -grid axes origin lll<br> + $ds9 -grid format1 d.2<br> + $ds9 -grid format2 d.2<br> + $ds9 -grid tickmarks yes<br> + $ds9 -grid tickmarks color red<br> + $ds9 -grid tickmarks width 2<br> + $ds9 -grid tickmarks dash yes<br> + $ds9 -grid border yes<br> + $ds9 -grid border color red<br> + $ds9 -grid border width 2<br> + $ds9 -grid border dash yes<br> + $ds9 -grid numerics yes<br> + $ds9 -grid numerics font courier<br> + $ds9 -grid numerics fontsize 12<br> + $ds9 -grid numerics fontweight bold<br> + $ds9 -grid numerics fontslant italic<br> + $ds9 -grid numerics color red<br> + $ds9 -grid numerics gap1 10<br> + </tt> <tt><tt>$ds9 -grid numerics + gap2 10<br> + </tt></tt> <tt><tt><tt>$ds9 -grid numerics gap3 + 10<br> + </tt></tt> $ds9 -grid numerics type exterior<br> + $ds9 -grid numerics vertical yes<br> + $ds9 -grid title yes<br> + $ds9 -grid title text {Hello World}<br> + $ds9 -grid title def yes<br> + $ds9 -grid title gap 10<br> + $ds9 -grid title font courier<br> + $ds9 -grid title fontsize 12<br> + $ds9 -grid title fontweight bold<br> + $ds9 -grid title fontslant italic<br> + $ds9 -grid title color red<br> + $ds9 -grid labels yes<br> + $ds9 -grid labels text1 {Hello World}<br> + </tt> <tt><tt>$ds9 -grid + labels text2 {Hello World}<br> + </tt> $ds9 -grid labels def1 yes<br> + $ds9 -grid labels def2 yes<br> + </tt> <tt><tt>$ds9 -grid labels gap1 + 10<br> + </tt> $ds9 -grid labels gap2 10<br> + $ds9 -grid labels font courier<br> + $ds9 -grid labels fontsize 12<br> + $ds9 -grid labels fontweight bold<br> + $ds9 -grid labels fontslant italic<br> + $ds9 -grid labels color red<br> + $ds9 -grid reset<br> + $ds9 -grid load foo.grd<br> + $ds9 -grid save foo.grd<br> + $ds9 -grid open<br> + $ds9 -grid close<br> + </tt> + <p><b><a name="header" id="header"></a>header</b></p> + <p>Display current fits header dialog. Optional extension number + maybe specified.</p> + <tt>Syntax:<br> + -header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] + <filename>]<br> + <br> + Example:<br> + $ds9 -header<br> + $ds9 -header 2<br> + $ds9 -header close<br> + $ds9 -header save 1 foo.txt<br> + </tt> + <p><b><a name="height" id="height"></a>height</b></p> + <p>Set the height of the image display window. Use the <a + href="command.html#geometry">geometry</a> command to set the + overall + width and height of the ds9 window.</p> + <tt>Syntax:<br> + -height [<value>]<br> + <br> + Example:<br> + $ds9 -height 512<br> + </tt> + <p><b><a name="help" id="help"></a>help</b></p> + <p>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.</p> + <tt>Syntax:<br> + -help # Display brief help message and exit.<br> + --help # Display command line options within help facility.<br> + -? # Display command line options within help facility.<br> + <br> + Example:<br> + $ds9 -help # Display brief help message and exit.<br> + $ds9 --help # Display command line options within help facility<br> + $ds9 -? # Display command line options within help + facility.<br> + </tt> + <p><b><a name="histequ" id="histequ"></a>histequ</b></p> + <p>Select histogram equalization scale function for the current + frame.</p> + <tt>Syntax:<br> + -histequ<br> + <br> + Example:<br> + $ds9 -histequ<br> + </tt> + <p><b><a name="iconify" id="iconify"></a>iconify</b></p> + <p>Toggles iconification.</p> + <tt>Syntax:<br> + -iconify []<br> + [yes|no]<br> + <br> + Example:<br> + $ds9 -iconify<br> + $ds9 -iconify yes</tt><br> + <p><b><a name="invert" id="invert"></a>invert</b></p> + <p>Invert Colormap.</p> + <tt>Syntax:<br> + -invert<br> + <br> + Example:<br> + $ds9 -invert<br> + </tt> + <p><b><a name="iis" id="iis"></a>iis</b></p> + <p>Set IIS Filename. Optional mosaic number maybe supplied.</p> + <tt>Syntax:<br> + -iis [filename <filename> [#]]<br> + <br> + Example:<br> + $ds9 -iis filename foo.fits<br> + $ds9 -iis filename bar.fits 4</tt><br> + <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> + <p>Load JPEG image into current frame.</p> + <tt>Syntax:<br> + -jpeg <filename><br> + <br> + Example:<br> + </tt> <tt>$ds9 -jpeg foo.jpeg</tt><br> + <tt>$cat foo.jpeg | ds9 -jpeg -</tt><br> + <p><b><a name="language" id="language"></a>language</b></p> + <p>Select current language.</p> + <tt>Syntax:<br> + -language [locale|da|de|es|en|fr|ja|pt]<br> + <br> + Example:<br> + $ds9 -language fr<br> + </tt> + <p><b><a name="linear" id="linear"></a>linear</b></p> + <p>Select linear scale function for the current frame.</p> + <tt>Syntax:<br> + -linear<br> + <br> + Example:<br> + $ds9 -linear</tt> + <p><b><a name="lock" id="lock"></a>lock</b></p> + <p>Lock all other frames to the current frame.</p> + <tt>Syntax:<br> + </tt> <tt>-lock</tt> <tt>[frame + <coordsys>|none]<br> + </tt> <tt>[crosshair + <coordsys>|none]</tt> <tt><br> + </tt> <tt> + [crop <coordsys>|none]</tt><br> + <tt> [slice + <coordsys>|none]</tt><br> + <tt> [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimits [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + </tt> + <tt> [smooth [yes|no]]</tt><br> + <tt> [3d [yes|no]]</tt><tt><br> + </tt> + <tt><br> + </tt> <tt>Example:</tt> <tt><br> + $ds9 -lock frame wcs</tt><tt><br> + </tt> <tt>$ds9 -lock crosshair + wcs</tt><tt><br> + </tt> <tt>$ds9 -lock crop wcs</tt><br> + <tt>$ds9 -lock slice wcs</tt><br> + <tt>$ds9 -lock bin yes<br> + $ds9 -lock axes yes<br> + </tt> <tt>$ds9 -lock scale yes<br> + $ds9 -lock scalelimits yes<br> + </tt> <tt>$ds9 -lock colorbar + yes</tt><tt><br> + $ds9 -lock block yes</tt><tt><br> + $ds9 -lock smooth yes</tt><tt><br> + $ds9 -lock 3d yes<br> + </tt> <b><a name="log" id="log"></a>log</b> + <p>Select log scale function for the current frame.<br> + </p> + <tt>Syntax:<br> + -log<br> + <br> + Example:<br> + $ds9 -log</tt> + <p><b><a name="lower" id="lower"></a>lower</b></p> + <p>Lower in the window stacking order.</p> + <tt>Syntax:<br> + -lower<br> + <br> + Example:<br> + $ds9 -lower<br> + </tt> + <p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> + <p>Controls the magnifier settings.</p> + <tt>Syntax:<br> + magnifier [color <color>]<br> + [zoom + <value>]<br> + [cursor + yes|no]<br> + [region + yes|no]<br> + <br> + Example:<br> + $ds9 -magnifier color yellow<br> + $ds9 -magnifier zoom 2<br> + $ds9 -magnifier cursor no<br> + $ds9 -magnifier region no<br> + </tt> + <p><b><a name="mask" id="mask"></a>mask<br> + nomask<br> + </b></p> + <p>Controls mask parameters.</p> + <tt>Syntax:<br> + -mask [color <color>]<br> + [mark 1|0]<br> + [transparency <value>]<br> + [clear]<br> + [open|close]<br> + -nomask<br> + <br> + Example:<br> + $ds9 -mask color red<br> + $ds9 -mask mark 0<br> + $ds9 -mask transparency 50<br> + $ds9 -mask clear<br> + $ds9 -mask open<br> + $ds9 -mask close<br> + $ds9 -nomask<br> + </tt> + <p><b><a name="match" id="match"></a>match</b></p> + <p>Match all other frames to the current frame.</p> + <tt>Syntax:<br> + </tt> <tt>-match</tt> <tt>[frame + <coordsys>]<br> + </tt> <tt>[crosshair + <coordsys>]</tt> <tt><br> + </tt> + <tt> [crop + <coordsys>]</tt><br> + <tt> [slice + <coordsys>]</tt><br> + <tt> [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]<br> + </tt> + <tt><tt> [3d]</tt><tt><tt><br> + </tt></tt><br> + Example:<br> + </tt> <tt>$ds9 -match frame wcs<br> + </tt> <tt>$ds9 + -match crosshair wcs<br> + </tt> <tt>$ds9 -match crop wcs</tt><br> + <tt>$ds9 -match slice wcs</tt><br> + <tt>$ds9 -match bin<br> + $ds9 -match axes<br> + $ds9 -match scale<br> + $ds9 -match scalelimits<br> + $ds9 -match colorbar<br> + $ds9 -match block<br> + </tt> <tt><tt>$ds9 -match smooth<br> + </tt> $ds9 + -match 3d</tt><br> + <tt> <br> + </tt> <b><a name="mecube" id="mecube"></a>mecube</b> + <p>Load FITS multiple extension file as data cube.<br> + </p> + <tt>Syntax:<br> + mecube <filename><br> + <br> + Example:<br> + $ds9 -mecube foo.fits</tt><tt><tt><br> + </tt> $cat foo.fits | ds9 + -mecube -</tt><br> + <p><b><a name="minmax" id="minmax"></a>minmax</b></p> + <p>This is how DS9 determines the min and max data values + from the data. <tt>SCAN</tt> will scan all data.</p> + <tt>Syntax:<br> + -minmax [scan|sample|datamin|irafmin]<br> + [mode + scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> + Example:<br> + $ds9 -minmax scan<br> + $ds9 -minmax mode scan<br> + $ds9 -minmax interval 100<br> + </tt> + <p><b><a name="mode" id="mode"></a>mode</b></p> + <p>Select the current mode.</p> + <tt>Syntax:<br> + -mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> + <br> + Example:<br> + $ds9 -mode crosshair</tt><br> + <p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> + <p>Load FITS mosaic segment into current frame.</p> + <tt>Syntax:<br> + -mosaic [wcs|wcsa...wcsz|iraf] <filename><br> + <br> + Example:</tt> <tt><br> + $ds9 -mosaic foo.fits</tt><br> + <tt><tt>$ds9 -mosaic wcs + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | ds9 + -mosaic -</tt><br> + <tt><tt>$cat foo.fits | ds9 -mosaic wcs -</tt></tt><tt><br> + </tt> + <p><b><a name="mosaicimage" id="mosaicimage"></a>mosaicimage</b></p> + <p>Load FITS mosaic image into current frame.</p> + <tt>Syntax:<br> + -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] <filename><br> + <br> + Example:</tt> <tt><br> + $ds9 -mosaicimage foo.fits</tt><br> + <tt><tt>$ds9 -mosaicimage wcs + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | ds9 + -mosaicimage</tt><br> + <tt><tt>$cat foo.fits | ds9 -mosaiimage wcs</tt></tt><tt><br> + </tt> + <p><b><a name="movie" id="movie"></a>movie<br> + savempeg<br> + </b></p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A + <tt>slice</tt> movie cycles though all slices of a cube. A + <tt>frame</tt> movie cycles through all active frames. A + <tt>3d</tt> movie cycles through specified viewing angles. The + default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times.<br> + </p> + <tt>Syntax:<br> + -movie [slice|frame|3d] <filename><br> + -movie 3d <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>]<br> + <br> + Example:<br> + $ds9 -movie slice ds9.mpg<br> + $ds9 -movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate + 1</tt><br> + <p><b><a name="msg" id="msg"></a>msg</b></p> + <p>Specify a directory of translation tables to be loaded.</p> + <tt>Syntax:<br> + -msg <directory><br> + <br> + Example:<br> + $ds9 -msg $HOME/msgs</tt><br> + <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> + <p>Load FITS multiple extension file as multiple images.<br> + </p> + <tt>Syntax:<br> + multiframe <filename><br> + <br> + Example:<br> + $ds9 -multiframe foo.fits</tt><tt><tt><br> + </tt> $cat foo.fits | ds9 + -multiframe -</tt><tt><br> + </tt> + <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> + <p>Support Name Server functions. Coordinates are in fk5.</p> + <tt>Syntax:<br> + -nameserver [<object>]<br> + [name <object>]<br> + [server</tt> + <tt><tt>ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt></tt>]<br> + [skyformat + degrees|sexagesimal]<br> -[pan]<br> + [pan]<br> -[crosshair]<br> + [crosshair]<br> -[open|close]<br> - <br> -Example:<br> -$ds9 -nameserver m31<br> -$ds9 -nameserver name m31<br> -$ds9 -nameserver server ned-sao<br> -$ds9 -nameserver skyformat sexagesimal<br> -$ds9 -nameserver pan<br> -$ds9 -nameserver crosshair<br> -$ds9 -nameserver open<br> -$ds9 -nameserver close<br></tt> -<p><b><a name="nan" id="nan"></a>nan</b></p> -<p>Set image not-a-number color.</p> -<tt>Syntax:<br> --nan <color><br> - <br> -Example:<br> -$ds9 -nan red</tt><br> -<p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> -<p>Load an NRRD (Nearly Raw Raster Data) file.<br></p> -<tt>Syntax:<br> --nrrd <filename><br> - <br> -Example:<br></tt> <tt><tt>$ds9 -nrrd foo.nrrd</tt></tt><br> -<tt>$cat foo.nrrd | xpaset ds9 -nrrd</tt> - <tt><br></tt> -<p><b><a name="nvss" id="nvss"></a>nvss</b></p> -<p>Support for NRAO VLA Sky Survey.</p> -<tt>Syntax:<br> --nvss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -nvss<br> -$ds9 -nvss m31<br></tt> <tt><tt>$ds9 -nvss name m31<br></tt></tt> -<tt><tt><tt>$ds9 -nvss name clear<br></tt></tt> $ds9 -nvss -00:42:44.404 +41:16:08.78<br> -$ds9 -nvss size 60 60 arcmin<br> -$ds9 -nvss save yes<br> -$ds9 -nvss frame current<br> -$ds9 -nvss update frame<br> -$ds9 -nvss open<br> -$ds9 -nvess close<br></tt> -<p><b><a name="orient" id="orient"></a>orient</b></p> -<p>Controls the orientation of the current frame.</p> -<tt>Syntax:<br> --orient [none|x|y|xy]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -orient xy<br> -$ds9 -orient open<br> -$ds9 -orient close<br></tt> -<p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> -<p>Controls Page Setup options.<br></p> -<tt>Syntax:<br> --pagesetup [orient portrait|landscape]<br> - [scale -<numberic>]</tt><br> -<tt> -[size letter|legal|tabloid|poster|a4]</tt><br> -<tt> <br> -Example:<br> -$ds9 -pagesetup orient portrait<br> -$ds9 -pagesetup scale 50<br> -$ds9 -pagesetup size poster</tt><br> -<p><b><a name="pan" id="pan"></a>pan</b></p> -<p>Controls the current image cursor location for the current -frame.</p> -<tt>Syntax:<br> --pan [<x> <h> <coordsys> -[<skyframe>][<skyformat>] # relative<br> - [to <x> <h> <coordsys> -[<skyframe>][<skyformat>] # absolute<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -pan 200 200 image</tt> <tt><tt># pan relative</tt><br> -$ds9 -pan to 400 400 physical</tt> <tt><tt># pan to physical -coords</tt><br> -$ds9 -pan to 13:29:55 47:11:50 wcs fk</tt> <tt><tt># pan to wcs -coords</tt><br> -$ds9 -pan open<br> -$ds9 -pan close</tt><br> -<p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> -<p>Display/Hide the pixel table.</p> -<tt>Syntax:<br> --pixeltable []<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -nameserver m31<br> + $ds9 -nameserver name m31<br> + $ds9 -nameserver server ned-sao<br> + $ds9 -nameserver skyformat sexagesimal<br> + $ds9 -nameserver pan<br> + $ds9 -nameserver crosshair<br> + $ds9 -nameserver open<br> + $ds9 -nameserver close<br> + </tt> + <p><b><a name="nan" id="nan"></a>nan</b></p> + <p>Set image not-a-number color.</p> + <tt>Syntax:<br> + -nan <color><br> + <br> + Example:<br> + $ds9 -nan red</tt><br> + <p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> + <p>Load an NRRD (Nearly Raw Raster Data) file.<br> + </p> + <tt>Syntax:<br> + -nrrd <filename><br> + <br> + Example:<br> + </tt> <tt><tt>$ds9 -nrrd foo.nrrd</tt></tt><br> + <tt>$cat foo.nrrd | xpaset ds9 -nrrd</tt> - <tt><br> + </tt> + <p><b><a name="nvss" id="nvss"></a>nvss</b></p> + <p>Support for NRAO VLA Sky Survey.</p> + <tt>Syntax:<br> + -nvss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -nvss<br> + $ds9 -nvss m31<br> + </tt> <tt><tt>$ds9 -nvss name m31<br> + </tt></tt> + <tt><tt><tt>$ds9 -nvss name clear<br> + </tt></tt> $ds9 -nvss + 00:42:44.404 +41:16:08.78<br> + $ds9 -nvss size 60 60 arcmin<br> + $ds9 -nvss save yes<br> + $ds9 -nvss frame current<br> + $ds9 -nvss update frame<br> + $ds9 -nvss open<br> + $ds9 -nvess close<br> + </tt> + <p><b><a name="orient" id="orient"></a>orient</b></p> + <p>Controls the orientation of the current frame.</p> + <tt>Syntax:<br> + -orient [none|x|y|xy]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -orient xy<br> + $ds9 -orient open<br> + $ds9 -orient close<br> + </tt> + <p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> + <p>Controls Page Setup options.<br> + </p> + <tt>Syntax:<br> + -pagesetup [orient portrait|landscape]<br> + + [scale + <numberic>]</tt><br> + <tt> + [size letter|legal|tabloid|poster|a4]</tt><br> + <tt> <br> + Example:<br> + $ds9 -pagesetup orient portrait<br> + $ds9 -pagesetup scale 50<br> + $ds9 -pagesetup size poster</tt><br> + <p><b><a name="pan" id="pan"></a>pan</b></p> + <p>Controls the current image cursor location for the current + frame.</p> + <tt>Syntax:<br> + -pan [<x> <h> <coordsys> + [<skyframe>]] # relative<br> + [to <x> <h> + <coordsys> + [<skyframe>]] # absolute<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -pan 200 200 image</tt> <tt><tt># pan relative</tt><br> + $ds9 -pan to 400 400 physical</tt> <tt><tt># pan to physical + coords</tt><br> + $ds9 -pan to 13:29:55 47:11:50 wcs fk</tt> <tt><tt># pan to wcs + coords</tt><br> + $ds9 -pan open<br> + $ds9 -pan close</tt><br> + <p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> + <p>Display/Hide the pixel table.</p> + <tt>Syntax:<br> + -pixeltable []<br> -[yes|open]<br> - -[no|close]<br> - <br> -Example:<br> -$ds9 -pixeltable<br> -$ds9 -pixeltable yes<br> -$ds9 -pixeltable open<br> -$ds9 -pixeltable close<br></tt> -<p><b><a name="plot" id="plot"></a>plot</b></p> -<p>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:</p> -<blockquote>xy x and y coordinates<br> -xyex x,y coordinates with x errors<br> -xyey x,y coordinates with y errors<br> -xyexey x,y coordinates with x and y -errors<br></blockquote> -<p>To create a new plot, use the plot new command.</p> -<tt>Syntax:</tt><tt><br></tt> <tt># create new empty plot -window</tt><tt><br></tt> <tt>-plot -[line|bar|scatter]</tt><tt><br></tt> <tt><br></tt> <tt># existing -plot</tt><tt><br></tt> <tt>-plot</tt> <tt>[[<plotname>] load -<filename> xy|xyex|xyey|xyexey]</tt><tt><br></tt> -<tt> [[<plotname>] save -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] clear]</tt><tt><br></tt> <tt> - </tt> <tt>[[<plotname>] duplicate -[#]]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] stats yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] list -yes|no]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] loadconfig -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] saveconfig <filename>]</tt><tt><br></tt> -<tt> [[<plotname>] pagesetup orient -portrait|landscape]</tt><tt><br></tt> <tt> -[[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4]</tt><tt><br></tt> <tt> - [[<plotname>] print]</tt><tt><br></tt> <tt> - [[<plotname>] print destination -printer|file]</tt><tt><br></tt> <tt> -[[<plotname>] print command -<command>]</tt><tt><br></tt> <tt> -[[<plotname>] print filename -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] print color rgb|gray]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -close</tt><tt>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] mode pointer|zoom]</tt><tt><br></tt> -<tt><br></tt> <tt># configure graph</tt><tt><br></tt> <tt>-plot -[[<plotname>] axis x|y grid yes|no]</tt><tt><br></tt> -<tt> [[[<plotname>] axis x|y log -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y flip yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y auto -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y min <value>]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y max -<value>]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y format -<string>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] legend yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] legend position -right|left|top|bottom]</tt><tt><br></tt> <tt> -[[<plotname>] font title|labels|numbers font -times|helvetica|courier]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>size <value>]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>weight normal|bold]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>slant roman|italic]</tt><tt><br></tt> <tt> -[[<plotname>] title <string>]</tt><tt><br></tt> -<tt> [[<plotname>] title x|y -<string>]</tt><tt><br></tt> <tt> -[</tt><tt>[<plotname>] barmode -normal|stacked|aligned|overlap]</tt><tt><br></tt> <tt><br></tt> -<tt># configure current dataset</tt><tt><br></tt> <tt>-plot -[[<plotname>] show yes|no]</tt><tt><br></tt> <tt> - </tt> <tt>[[<plotname>] shape -circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> -</tt> <tt> </tt> -<tt>[[<plotname>] shape fill yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -shape color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -smooth step|linear|cubic|quadratic|catrom]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -dash yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -error yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -error color <value>]</tt><tt><br></tt> -<tt> [[<plotname>] color -<value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -error width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -name <string>]</tt><tt><br></tt> <tt><br></tt> <tt># select -current dataset</tt><tt><br></tt> <tt>-plot [[<plotname>] -select <value>]</tt><tt><br></tt> -<tt> </tt><tt><br></tt> <tt>Example:</tt><tt><br></tt> <tt># -create new empty plot window</tt><tt><br></tt> <tt>$ds9 -plot -bar</tt><tt><br></tt> <tt><br></tt> <tt># existing -plot</tt><tt><br></tt> <tt>$ds9 -plot load xy.dat</tt><tt><br></tt> -<tt>$ds9 -plot save foo.dat</tt><tt><br></tt> <tt>$ds9 -plot -clear</tt><tt><br></tt> <tt>$ds9 -plot duplicate -1</tt><tt><br></tt> <tt>$ds9 -plot stats yes</tt><tt><br></tt> -<tt>$ds9 -plot list yes</tt><tt><br></tt> <tt>$ds9 -plot loadconfig -foo.plt</tt><tt><br></tt> <tt>$ds9 -plot saveconfig -foo.plt</tt><tt><br></tt> <tt>$ds9 -plot pagesetup orient -portrait</tt><tt><br></tt> <tt>$ds9 -plot pagesetup size -letter</tt><tt><br></tt> <tt>$ds9 -plot print</tt><tt><br></tt> -<tt>$ds9 -plot print destination file</tt><tt><br></tt> <tt>$ds9 --plot print command lp</tt><tt><br></tt> <tt>$ds9 -plot print -filename foo.ps</tt><tt><br></tt> <tt>$ds9 -plot print color -rgb</tt><tt><br></tt> <tt>$ds9 -plot close</tt><tt><br></tt> -<tt>$ds9 -plot mode pointer</tt><tt><br></tt> <tt><br></tt> <tt># -configure plot</tt><tt><br></tt> <tt>$ds9 -plot axis x grid -yes</tt><tt><br></tt> <tt>$ds9 -plot axis x log -yes</tt><tt><br></tt> <tt>$ds9 -plot axis x flip -yes</tt><tt><br></tt> <tt>$ds9 -plot axis x auto -no</tt><tt><br></tt> <tt>$ds9 -plot axis x min 1</tt><tt><br></tt> -<tt>$ds9 -plot axis x max 100</tt><tt><br></tt> <tt>$ds9 -plot axis -x format '%f'</tt><tt><br></tt> <tt><br></tt> <tt>$ds9 -plot legend -yes</tt><tt><br></tt> <tt>$ds9 -plot legend position -left</tt><tt><br></tt> <tt><br></tt> <tt>$ds9 -plot font numbers -font times</tt><tt><br></tt> <tt>$ds9 -plot font numbers size -12</tt><tt><br></tt> <tt>$ds9 -plot font numbers weight -bold</tt><tt><br></tt> <tt>$ds9 -plot font numbers slant -italic</tt><tt><br></tt> <tt><br></tt> <tt>$ds9 -plot title 'This -is a Title'</tt><tt><br></tt> <tt>$ds9 -plot title x 'X -Axis'</tt><tt><br></tt> <tt>$ds9 -plot title y 'Y -Axis'</tt><tt><br></tt> <tt>$ds9 -plot title legend 'This is the -Legend'</tt><tt><br></tt> <tt><br></tt> <tt>$ds9 -plot barmode -aligned</tt><tt><br></tt> <tt><br></tt> <tt># configure current -dataset</tt><tt><br></tt> <tt>$ds9 -plot show yes</tt><tt><br></tt> -<tt>$ds9 -plot shape circle</tt><tt><br></tt> <tt>$ds9 -plot shape -fill no</tt><tt><br></tt> <tt>$ds9 -plot shape color -cyan</tt><tt><br></tt> <tt>$ds9 -plot smooth step</tt><tt><br></tt> -<tt>$ds9 -plot color red</tt><tt><br></tt> <tt>$ds9 -plot width -2</tt><tt><br></tt> <tt>$ds9 -plot dash yes</tt><tt><br></tt> -<tt>$ds9 -plot error yes</tt><tt><br></tt> <tt>$ds9 -plot error -color red</tt><tt><br></tt> <tt>$ds9 -plot error width -2</tt><tt><br></tt> <tt>$ds9 -plot name 'My Data'</tt><tt><br></tt> -<tt><br></tt> <tt># select current dataset</tt><tt><br></tt> -<tt>$ds9 -plot select 2</tt> -<p><b><a name="png" id="png"></a>png</b></p> -<p>Load PNG image into current frame.<br></p> -<tt>Syntax:<br> --png <filename><br> - <br> -Example:</tt><br> -<tt>$ds9 png foo.png</tt><tt><tt><tt><br></tt></tt> $cat foo.png | -ds9 -png -</tt><tt><br></tt> -<p><b><a name="port" id="port"></a>port</b></p> -<p>Set the IRAF port number, used by IRAF to communicate with DS9. -The default is 5137, the standard IRAF port used by -<i>ximtool</i>.</p> -<tt>Syntax:<br> --port number<br> - <br> -Example:<br> -$ds9 -port 5137</tt> -<p><b><a name="port_only" id="port_only"></a>port_only<br> -inet_only</b></p> -<p>Only use the IRAF port number. This is the same as -fifo none --unix none.</p> -<tt>Syntax:<br> --port_only<br> - <br> -Example:<br> -$ds9 -port_only<br></tt> -<p><b><a name="pow" id="pow"></a>pow</b></p> -<p>Select power scale function for the current frame.</p> -<tt>Syntax:<br> --pow<br> - <br> -Example:<br> -$ds9 -pow<br></tt> -<p><b><a name="precision" id="precision"></a>precision</b></p> -<p>Set region and coordinate output format precision.</p> -<tt>Syntax:<br> --precision <linear></tt> <tt><tt><degree></tt></tt> -<tt><tt><hms></tt></tt> -<tt><tt><tt><dms></tt></tt></tt> -<tt><tt><tt><tt><arcmin></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><arcsec><br> -<br></tt></tt></tt></tt> Example:<br> -$ds9 -precision 8 10 4 3 5 3</tt><br> -<p><b><a name="prefs" id="prefs"></a>prefs</b></p> -<p>Controls various preference settings.</p> -<tt>Syntax:<br> --prefs [clear]<br> - [irafalign yes|no]<br> - <br> -Example:<br> -$ds9 -prefs clear<br> -$ds9 -prefs irafalign yes<br></tt> -<p><b><a name="preserve" id="preserve"></a>preserve</b></p> -<p>Preserve the follow attributes while loading a new image.</p> -<tt>Syntax:<br> -preserve [pan yes|no]<br> - [regions yes|no]<br> - <br> -Example:<br> -$ds9 -preserve pan yes<br> -$ds9 -preserve regions yes<br></tt> -<p><b><a name="psprint" id="psprint"></a>psprint</b></p> -<p>Invokes postscript printing. Please see <a href= -"file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> -for further details.</p> -<p><b><a name="print" id="print"></a>print</b></p> -<p>Controls printing. Use print option to set printing -options.<br></p> -<tt>Syntax:<br> --print [destination printer|file]<br> - [command <command>]<br> - [filename -<filename>]<br></tt> <tt> -[color rgb|cmyk|gray]<br> - [level 1|2]<br> - [resolution -53|72|75|150|300|600]<br> - <br> -Example:<br> -$ds9 -print<br> -$ds9 -print destination file<br> -$ds9 -print command lp<br> -$ds9 -print filename foo.ps<br> -$ds9 -print color cmyk<br> -$ds9 -print level 2<br> -$ds9 -print resolution 75</tt> -<p><b><a name="raise" id="raise"></a>raise</b></p> -<p>Raise in the window stacking order.</p> -<tt>Syntax:<br> --raise<br> - <br> -Example:<br> -$ds9 -raise<br></tt> -<p><b><a name="regions" id="regions"></a>regions</b></p> -<p>Controls regions in the current frame.</p> -<tt>Syntax:<br> --regions [<filename>]<br> - [load [all] -<filename>]<br> - [save -<filename>]<br> - [list [close]]<br> - [epsilon -<integer>]<br> - [show yes|no]<br> - [showtext yes|no]<br> - [centroid]<br> - [centroid auto -yes|no]<br> - [centroid radius -<value>|iteration <value>]<br> - [getinfo]<br> - [move front]<br> - [move back]<br> - [select all]<br> - [select none]<br> - [select -invert]<br> - [delete all]<br> - [delete select]<br> - [format -ds9|xml|ciao|saotng|saoimage|pros|xy]<br> - [system -image|physical|wcs|wcsa...wcsz]<br> - [sky -fk4|fk5|icrs|galactic|ecliptic]<br> - [skyformat -degrees|sexagesimal]<br> - [strip yes|no]<br> - [shape -<shape>]<br> - [color -<color><br> - [width -<width>]<br></tt> <tt> - [fixed|edit|rotate|delete yes|no]<br> - -[include|exclude|source|background]</tt><br> -<tt> [command -<marker command>]<br> - [composite]<br> - [dissolve]<br> - [template -<filename>]<br> - [template -<filename> at <ra> <dec> <coordsys> -<skyframe>]<br> - [savetemplate -<filename>]<br></tt> <tt> - [group new]<br></tt> -<tt> [group -<tag> new]<br> - [group <tag> -update]<br></tt> <tt> -[group <tag> select]<br></tt> <tt> - [group <tag> color -<color>]<br> - [group <tag> -copy]<br> - [group <tag> -delete]<br> - [group <tag> -cut]<br> - [group <tag> font -<font>]<br> - [group <tag> move -<int> <int>]<br> - [group <tag> -movefront]<br> - [group <tag> -moveback]<br> - [group <tag> -property <property> yes|no]<br> - [copy]<br> - [cut]<br> - [paste -image|physical|wcs|wcsa...wcsz]<br> - [undo]<br> - <br> -Example:<br> -$ds9 -regions foo.reg<br> -$ds9 -regions -format ciao bar.reg # load as ciao format<br> -$ds9 -regions foo.fits # FITS regions files do not need a format -specification<br> -$ds9 -regions load foo.reg # load foo.reg into current frame<br> -$ds9 -regions load all foo.reg # load foo.reg into all frames<br> -$ds9 -regions load '*.reg'# expand *.reg and load into current -frame<br> -$ds9 -regions load all '*.reg' # expand *.reg and load into all -frames<br> -$ds9 -regions save foo.reg<br> -$ds9 -regions list<br> -$ds9 -regions list close<br> -$ds9 -regions epsilon 5<br> -$ds9 -regions show yes<br> -$ds9 -regions showtext no<br> -$ds9 -regions centroid<br> -$ds9 -regions centroid auto yes<br> -$ds9 -regions centroid radius 10<br> -$ds9 -regions centroid iteration 20<br> -$ds9 -regions getinfo<br> -$ds9 -regions move back<br> -$ds9 -regions move front<br> -$ds9 -regions select all<br> -$ds9 -regions select none<br> -$ds9 -regions select invert<br> -$ds9 -regions delete all<br> -$ds9 -regions delete select<br> -$ds9 -regions format ds9<br> -$ds9 -regions system wcs<br> -$ds9 -regions sky fk5<br> -$ds9 -regions skyformat degrees<br> -$ds9 -regions strip yes<br> -$ds9 -regions shape ellipse<br> -$ds9 -regions color red<br> -$ds9 -regions width 3<br></tt> <tt>$ds9 -regions edit yes<br> -$ds9 -regions include<br></tt> <tt>$ds9 -regions command "circle -100 100 20 # color=red"<br> -$ds9 -regions composite<br> -$ds9 -regions dissolve<br> -$ds9 -regions template foo.tpl<br> -$ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> -$ds9 -regions savetemplate foo.tpl<br> -$ds9 -regions group new<br> -$ds9 -regions group foo new<br> -$ds9 -regions group foo update<br> -$ds9 -regions group foo select<br> -$ds9 -regions group foo color red<br> -$ds9 -regions group foo copy<br> -$ds9 -regions group foo delete<br> -$ds9 -regions group foo cut<br> -$ds9 -regions group foo font {times 14 bold}<br> -$ds9 -regions group foo move 100 100<br> -$ds9 -regions group foo movefront<br> -$ds9 -regions group foo moveback<br> -$ds9 -regions group foo property delete no<br> -$ds9 -regions copy<br> -$ds9 -regions cut<br> -$ds9 -regions paste wcs<br> -$ds9 -regions undo<br></tt> -<p><b><a name="red" id="red"></a>red</b></p> -<p>For RGB frames, sets the current color channel to red.</p> -<tt>Syntax:<br> --red<br> - <br> -Example:<br> -$ds9 -red foo.fits<br></tt> -<p><b><a name="restore" id="restore"></a>restore</b></p> -<p>Restore DS9 to a previous state from a backup save set.</p> -<tt>Syntax:<br> --restore <filename><br> - <br> -Example:<br> -$ds9 -restore ds9.bck</tt><br> -<p><b><a name="rgb" id="rgb"></a>rgb</b></p> -<p>Create RGB frame and control RGB frame parameters.</p> -<tt>Syntax:<br> --rgb []<br> - [red|green|blue]<br> - [channel [red|green|blue]]<br> - [view [red|green|blue] [yes|no]]<br> - [system <coordsys>]<br> - [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -rgb # create new rgb frame<br> -$ds9 -rgb red # set current channel to red<br> -$ds9 -rgb channel red # set current channel to red<br> -$ds9 -rgb view blue no # turn off blue channel<br> -$ds9 -rgb system wcs # set rgb coordinate system<br></tt> <tt>$ds9 --rgb lock wcs yes</tt><br> -<tt>$ds9 -rgb lock crop yes</tt><br> -<tt>$ds9 -rgb lock slice yes</tt><br> -<tt>$ds9 -rgb lock bin yes</tt><br> -<tt>$ds9 -rgb lock scale yes<br> -$ds9 -rgb lock scalelimits yes<br> -$ds9 -rgb lock colorbar yes<br> -$ds9 -rgb lock block yes<br> -$ds9 -rgb lock smooth yes<br> -$ds9 -rgb open<br> -$ds9 -rgb close<br></tt><br> -<p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> -<p>Load raw data array cube into rgb frame.<br></p> -<tt>Syntax:<br> --rgbarray + [yes|open]<br> + + [no|close]<br> + <br> + Example:<br> + $ds9 -pixeltable<br> + $ds9 -pixeltable yes<br> + $ds9 -pixeltable open<br> + $ds9 -pixeltable close<br> + </tt> + <p><b><a name="plot" id="plot"></a>plot</b></p> + <p>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:</p> + <blockquote>xy x and y coordinates<br> + xyex x,y coordinates with x errors<br> + xyey x,y coordinates with y errors<br> + xyexey x,y coordinates with x and y + errors<br> + </blockquote> + <p>To create a new plot, use the plot new command.</p> + <tt>Syntax:</tt><tt><br> + </tt> <tt># create new empty plot + window</tt><tt><br> + </tt> <tt>-plot + [line|bar|scatter]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># existing + plot</tt><tt><br> + </tt> <tt>-plot</tt> <tt>[[<plotname>] load + <filename> xy|xyex|xyey|xyexey]</tt><tt><br> + </tt> + <tt> [[<plotname>] save + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] clear]</tt><tt><br> + </tt> <tt> + </tt> <tt>[[<plotname>] duplicate + [#]]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] stats yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] list + yes|no]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] loadconfig + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] saveconfig <filename>]</tt><tt><br> + </tt> + <tt> [[<plotname>] pagesetup orient + portrait|landscape]</tt><tt><br> + </tt> <tt> + [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4]</tt><tt><br> + </tt> <tt> + [[<plotname>] print]</tt><tt><br> + </tt> <tt> + [[<plotname>] print destination + printer|file]</tt><tt><br> + </tt> <tt> + [[<plotname>] print command + <command>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print filename + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print color rgb|gray]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + close</tt><tt>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> + </tt> + <tt><br> + </tt> <tt># configure graph</tt><tt><br> + </tt> <tt>-plot + [[<plotname>] axis x|y grid yes|no]</tt><tt><br> + </tt> + <tt> [[[<plotname>] axis x|y log + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y flip yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y auto + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y min <value>]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y max + <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y format + <string>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] legend yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] legend position + right|left|top|bottom]</tt><tt><br> + </tt> <tt> + [[<plotname>] font title|labels|numbers font + times|helvetica|courier]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>size <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>weight normal|bold]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>slant roman|italic]</tt><tt><br> + </tt> <tt> + [[<plotname>] title <string>]</tt><tt><br> + </tt> + <tt> [[<plotname>] title x|y + <string>]</tt><tt><br> + </tt> <tt> + [</tt><tt>[<plotname>] barmode + normal|stacked|aligned|overlap]</tt><tt><br> + </tt> <tt><br> + </tt> + <tt># configure current dataset</tt><tt><br> + </tt> <tt>-plot + [[<plotname>] show yes|no]</tt><tt><br> + </tt> <tt> + </tt> <tt>[[<plotname>] shape + circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] shape fill yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + shape color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + smooth step|linear|cubic|quadratic|catrom]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + dash yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + error yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + error color <value>]</tt><tt><br> + </tt> + <tt> [[<plotname>] color + <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + error width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + name <string>]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># select + current dataset</tt><tt><br> + </tt> <tt>-plot [[<plotname>] + select <value>]</tt><tt><br> + </tt> + <tt> </tt><tt><br> + </tt> <tt>Example:</tt><tt><br> + </tt> <tt># + create new empty plot window</tt><tt><br> + </tt> <tt>$ds9 -plot + bar</tt><tt><br> + </tt> <tt><br> + </tt> <tt># existing + plot</tt><tt><br> + </tt> <tt>$ds9 -plot load xy.dat</tt><tt><br> + </tt> + <tt>$ds9 -plot save foo.dat</tt><tt><br> + </tt> <tt>$ds9 -plot + clear</tt><tt><br> + </tt> <tt>$ds9 -plot duplicate + 1</tt><tt><br> + </tt> <tt>$ds9 -plot stats yes</tt><tt><br> + </tt> + <tt>$ds9 -plot list yes</tt><tt><br> + </tt> <tt>$ds9 -plot loadconfig + foo.plt</tt><tt><br> + </tt> <tt>$ds9 -plot saveconfig + foo.plt</tt><tt><br> + </tt> <tt>$ds9 -plot pagesetup orient + portrait</tt><tt><br> + </tt> <tt>$ds9 -plot pagesetup size + letter</tt><tt><br> + </tt> <tt>$ds9 -plot print</tt><tt><br> + </tt> + <tt>$ds9 -plot print destination file</tt><tt><br> + </tt> <tt>$ds9 + -plot print command lp</tt><tt><br> + </tt> <tt>$ds9 -plot print + filename foo.ps</tt><tt><br> + </tt> <tt>$ds9 -plot print color + rgb</tt><tt><br> + </tt> <tt>$ds9 -plot close</tt><tt><br> + </tt> + <tt>$ds9 -plot mode pointer</tt><tt><br> + </tt> <tt><br> + </tt> <tt># + configure plot</tt><tt><br> + </tt> <tt>$ds9 -plot axis x grid + yes</tt><tt><br> + </tt> <tt>$ds9 -plot axis x log + yes</tt><tt><br> + </tt> <tt>$ds9 -plot axis x flip + yes</tt><tt><br> + </tt> <tt>$ds9 -plot axis x auto + no</tt><tt><br> + </tt> <tt>$ds9 -plot axis x min 1</tt><tt><br> + </tt> + <tt>$ds9 -plot axis x max 100</tt><tt><br> + </tt> <tt>$ds9 -plot axis + x format '%f'</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$ds9 -plot legend + yes</tt><tt><br> + </tt> <tt>$ds9 -plot legend position + left</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$ds9 -plot font numbers + font times</tt><tt><br> + </tt> <tt>$ds9 -plot font numbers size + 12</tt><tt><br> + </tt> <tt>$ds9 -plot font numbers weight + bold</tt><tt><br> + </tt> <tt>$ds9 -plot font numbers slant + italic</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$ds9 -plot title 'This + is a Title'</tt><tt><br> + </tt> <tt>$ds9 -plot title x 'X + Axis'</tt><tt><br> + </tt> <tt>$ds9 -plot title y 'Y + Axis'</tt><tt><br> + </tt> <tt>$ds9 -plot title legend 'This is the + Legend'</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$ds9 -plot barmode + aligned</tt><tt><br> + </tt> <tt><br> + </tt> <tt># configure current + dataset</tt><tt><br> + </tt> <tt>$ds9 -plot show yes</tt><tt><br> + </tt> + <tt>$ds9 -plot shape circle</tt><tt><br> + </tt> <tt>$ds9 -plot shape + fill no</tt><tt><br> + </tt> <tt>$ds9 -plot shape color + cyan</tt><tt><br> + </tt> <tt>$ds9 -plot smooth step</tt><tt><br> + </tt> + <tt>$ds9 -plot color red</tt><tt><br> + </tt> <tt>$ds9 -plot width + 2</tt><tt><br> + </tt> <tt>$ds9 -plot dash yes</tt><tt><br> + </tt> + <tt>$ds9 -plot error yes</tt><tt><br> + </tt> <tt>$ds9 -plot error + color red</tt><tt><br> + </tt> <tt>$ds9 -plot error width + 2</tt><tt><br> + </tt> <tt>$ds9 -plot name 'My Data'</tt><tt><br> + </tt> + <tt><br> + </tt> <tt># select current dataset</tt><tt><br> + </tt> + <tt>$ds9 -plot select 2</tt> + <p><b><a name="png" id="png"></a>png</b></p> + <p>Load PNG image into current frame.<br> + </p> + <tt>Syntax:<br> + -png <filename><br> + <br> + Example:</tt><br> + <tt>$ds9 png foo.png</tt><tt><tt><tt><br> + </tt></tt> $cat foo.png | + ds9 -png -</tt><tt><br> + </tt> + <p><b><a name="port" id="port"></a>port</b></p> + <p>Set the IRAF port number, used by IRAF to communicate with DS9. + The default is 5137, the standard IRAF port used by + <i>ximtool</i>.</p> + <tt>Syntax:<br> + -port number<br> + <br> + Example:<br> + $ds9 -port 5137</tt> + <p><b><a name="port_only" id="port_only"></a>port_only<br> + inet_only</b></p> + <p>Only use the IRAF port number. This is the same as -fifo none + -unix none.</p> + <tt>Syntax:<br> + -port_only<br> + <br> + Example:<br> + $ds9 -port_only<br> + </tt> + <p><b><a name="pow" id="pow"></a>pow</b></p> + <p>Select power scale function for the current frame.</p> + <tt>Syntax:<br> + -pow<br> + <br> + Example:<br> + $ds9 -pow<br> + </tt> + <p><b><a name="precision" id="precision"></a>precision</b></p> + <p>Set region and coordinate output format precision.</p> + <tt>Syntax:<br> + -precision <linear></tt> <tt><tt><degree></tt></tt> + <tt><tt><hms></tt></tt> + <tt><tt><tt><dms></tt></tt></tt> + <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><arcsec><br> + <br> + </tt></tt></tt></tt> Example:<br> + $ds9 -precision 8 10 4 3 5 3</tt><br> + <p><b><a name="prefs" id="prefs"></a>prefs</b></p> + <p>Controls various preference settings.</p> + <tt>Syntax:<br> + -prefs [clear]<br> + [irafalign yes|no]<br> + <br> + Example:<br> + $ds9 -prefs clear<br> + $ds9 -prefs irafalign yes<br> + </tt> + <p><b><a name="preserve" id="preserve"></a>preserve</b></p> + <p>Preserve the follow attributes while loading a new image.</p> + <tt>Syntax:<br> + preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> + Example:<br> + $ds9 -preserve pan yes<br> + $ds9 -preserve regions yes<br> + </tt> + <p><b><a name="psprint" id="psprint"></a>psprint</b></p> + <p>Invokes postscript printing. Please see <a + href="file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> + for further details.</p> + <p><b><a name="print" id="print"></a>print</b></p> + <p>Controls printing. Use print option to set printing + options.<br> + </p> + <tt>Syntax:<br> + -print [destination printer|file]<br> + [command <command>]<br> + [filename + <filename>]<br> + </tt> <tt> + [color rgb|cmyk|gray]<br> + [level 1|2]<br> + [resolution + 53|72|75|150|300|600]<br> + <br> + Example:<br> + $ds9 -print<br> + $ds9 -print destination file<br> + $ds9 -print command lp<br> + $ds9 -print filename foo.ps<br> + $ds9 -print color cmyk<br> + $ds9 -print level 2<br> + $ds9 -print resolution 75</tt> + <p><b><a name="raise" id="raise"></a>raise</b></p> + <p>Raise in the window stacking order.</p> + <tt>Syntax:<br> + -raise<br> + <br> + Example:<br> + $ds9 -raise<br> + </tt> + <p><b><a name="regions" id="regions"></a>regions</b></p> + <p>Controls regions in the current frame.</p> + <tt>Syntax:<br> + -regions [<filename>]<br> + [load [all] + <filename>]<br> + [save + <filename>]<br> + [list [close]]<br> + [epsilon + <integer>]<br> + [show yes|no]<br> + [showtext yes|no]<br> + [centroid]<br> + [centroid auto + yes|no]<br> + [centroid + radius + <value>|iteration <value>]<br> + [getinfo]<br> + [move front]<br> + [move back]<br> + [select all]<br> + [select none]<br> + [select + invert]<br> + [delete all]<br> + [delete select]<br> + [format + ds9|xml|ciao|saotng|saoimage|pros|xy]<br> + [system + image|physical|wcs|wcsa...wcsz]<br> + [sky + fk4|fk5|icrs|galactic|ecliptic]<br> + [skyformat + degrees|sexagesimal]<br> + [strip yes|no]<br> + [shape + <shape>]<br> + [color + <color><br> + [width + <width>]<br> + </tt> <tt> + [fixed|edit|rotate|delete yes|no]<br> + + [include|exclude|source|background]</tt><br> + <tt> [command + <marker command>]<br> + [composite]<br> + [dissolve]<br> + [template + <filename>]<br> + [template + <filename> at <ra> <dec> <coordsys> + <skyframe>]<br> + [savetemplate + <filename>]<br> + </tt> <tt> + [group new]<br> + </tt> + <tt> [group + <tag> new]<br> + [group + <tag> + update]<br> + </tt> <tt> + [group <tag> select]<br> + </tt> <tt> + [group <tag> color + <color>]<br> + [group <tag> + copy]<br> + [group <tag> + delete]<br> + [group <tag> + cut]<br> + [group <tag> + font + <font>]<br> + [group <tag> + move + <int> <int>]<br> + [group <tag> + movefront]<br> + [group <tag> + moveback]<br> + [group <tag> + property <property> yes|no]<br> + [copy]<br> + [cut]<br> + [paste + image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + <br> + Example:<br> + $ds9 -regions foo.reg<br> + $ds9 -regions -format ciao bar.reg # load as ciao format<br> + $ds9 -regions foo.fits # FITS regions files do not need a format + specification<br> + $ds9 -regions load foo.reg # load foo.reg into current frame<br> + $ds9 -regions load all foo.reg # load foo.reg into all frames<br> + $ds9 -regions load '*.reg'# expand *.reg and load into current + frame<br> + $ds9 -regions load all '*.reg' # expand *.reg and load into all + frames<br> + $ds9 -regions save foo.reg<br> + $ds9 -regions list<br> + $ds9 -regions list close<br> + $ds9 -regions epsilon 5<br> + $ds9 -regions show yes<br> + $ds9 -regions showtext no<br> + $ds9 -regions centroid<br> + $ds9 -regions centroid auto yes<br> + $ds9 -regions centroid radius 10<br> + $ds9 -regions centroid iteration 20<br> + $ds9 -regions getinfo<br> + $ds9 -regions move back<br> + $ds9 -regions move front<br> + $ds9 -regions select all<br> + $ds9 -regions select none<br> + $ds9 -regions select invert<br> + $ds9 -regions delete all<br> + $ds9 -regions delete select<br> + $ds9 -regions format ds9<br> + $ds9 -regions system wcs<br> + $ds9 -regions sky fk5<br> + $ds9 -regions skyformat degrees<br> + $ds9 -regions strip yes<br> + $ds9 -regions shape ellipse<br> + $ds9 -regions color red<br> + $ds9 -regions width 3<br> + </tt> <tt>$ds9 -regions edit yes<br> + $ds9 -regions include<br> + </tt> <tt>$ds9 -regions command "circle + 100 100 20 # color=red"<br> + $ds9 -regions composite<br> + $ds9 -regions dissolve<br> + $ds9 -regions template foo.tpl<br> + $ds9 -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> + $ds9 -regions savetemplate foo.tpl<br> + $ds9 -regions group new<br> + $ds9 -regions group foo new<br> + $ds9 -regions group foo update<br> + $ds9 -regions group foo select<br> + $ds9 -regions group foo color red<br> + $ds9 -regions group foo copy<br> + $ds9 -regions group foo delete<br> + $ds9 -regions group foo cut<br> + $ds9 -regions group foo font {times 14 bold}<br> + $ds9 -regions group foo move 100 100<br> + $ds9 -regions group foo movefront<br> + $ds9 -regions group foo moveback<br> + $ds9 -regions group foo property delete no<br> + $ds9 -regions copy<br> + $ds9 -regions cut<br> + $ds9 -regions paste wcs<br> + $ds9 -regions undo<br> + </tt> + <p><b><a name="red" id="red"></a>red</b></p> + <p>For RGB frames, sets the current color channel to red.</p> + <tt>Syntax:<br> + -red<br> + <br> + Example:<br> + $ds9 -red foo.fits<br> + </tt> + <p><b><a name="restore" id="restore"></a>restore</b></p> + <p>Restore DS9 to a previous state from a backup save set.</p> + <tt>Syntax:<br> + -restore <filename><br> + <br> + Example:<br> + $ds9 -restore ds9.bck</tt><br> + <p><b><a name="rgb" id="rgb"></a>rgb</b></p> + <p>Create RGB frame and control RGB frame parameters.</p> + <tt>Syntax:<br> + -rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -rgb # create new rgb frame<br> + $ds9 -rgb red # set current channel to red<br> + $ds9 -rgb channel red # set current channel to red<br> + $ds9 -rgb view blue no # turn off blue channel<br> + $ds9 -rgb system wcs # set rgb coordinate system<br> + </tt> <tt>$ds9 + -rgb lock wcs yes</tt><br> + <tt>$ds9 -rgb lock crop yes</tt><br> + <tt>$ds9 -rgb lock slice yes</tt><br> + <tt>$ds9 -rgb lock bin yes</tt><br> + <tt>$ds9 -rgb lock scale yes<br> + $ds9 -rgb lock scalelimits yes<br> + $ds9 -rgb lock colorbar yes<br> + $ds9 -rgb lock block yes<br> + $ds9 -rgb lock smooth yes<br> + $ds9 -rgb open<br> + $ds9 -rgb close<br> + </tt><br> + <p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> + <p>Load raw data array cube into rgb frame.<br> + </p> + <tt>Syntax:<br> + -rgbarray <filename>[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br> -$ds9 -rgbarray -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> -<tt>$cat foo.arr | ds9 -rgbarray --[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> -<p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> -<p>Load FITS rgbcube into rgb frame.<br></p> -<tt>Syntax:<br> --rgbcube <filename><br> - <br> -Example:<br> -$ds9 -rgbcube foo.fits</tt><tt><tt><br></tt> $cat foo.fits | ds9 --rgbcube -</tt><br> -<p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> -<p>Load FITS rgbimage into rgb frame.<br></p> -<tt>Syntax:<br> --rgbimage <filename><br> - <br> -Example:<br> -$ds9 -rgbimage foo.fits</tt><tt><tt><br></tt> $cat foo.fits | ds9 --rgbimage -</tt><br> -<p><b><a name="rotate" id="rotate"></a>rotate</b></p> -<p>Controls the rotation angle (in degrees) of the current -frame.<</p> -<tt>Syntax:<br> --rotate [<value>]<br> - [to <value>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -rotate 45<br> -$ds9 -rotate to 30<br> -$ds9 -rotate open<br> -$ds9 -rotate close<br></tt> -<p><b><a name="samp" id="samp"></a>samp</b></p> -<p>Configure SAMP protocol.</p> -<tt>Syntax:<br> --samp [yes|no|connect|disconnect]<br> - [broadcast [image|table]]<br> - [send [image|table] -<application>]<br> - <br> -Example:<br> -$ds9 -samp yes<br></tt> <tt><tt>$ds9 -samp connect<br></tt> $ds9 --samp broadcast image<br> -$ds9 -samp send image aladin</tt><br> -<p><b><a name="save" id="save"></a>save<br></b></p> -<p>Save loaded image data of current frame as FITS.</p> -<tt>Syntax:<br> --save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice]</tt><br> -<tt> <br> -Example:<br> -$ds9 -save foo.fits</tt><br> -<tt>$ds9 -save fits foo.fits image</tt><br> -<tt>$ds9 -save fits foo.fits table<br> -$ds9 -save fits foo.fits slice</tt><br> -<tt>$ds9 -save rgbimage foo.fits<br></tt> <tt>$ds9 -save rgbcube -foo.fits</tt><br> -<tt>$ds9 -save mecube foo.fits</tt><br> -<tt>$ds9 -save mosaic foo.fits</tt><br> -<tt>$ds9 -save mosaicimage foo.fits</tt><br> -<p><b><a name="saveimage" id="saveimage"></a>saveimage</b></p> -<p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> -compression method.</p> -<tt>Syntax:<br> --saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> -<tt><filename><br> --saveimage <filename>.jpeg [1-100]<br> --saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> - <br> -Example:<br> -$ds9 -saveimage ds9.tiff<br> -$ds9 -saveimage jpeg ds9.jpeg 75</tt><tt><br></tt> -<p><b><a name="scale" id="scale"></a>scale</b></p> -<p>Controls the limits and color scale distribution.</p> -<tt>Syntax:<br> --scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [datasec yes|no]<br> - [limits <minvalue> -<maxvalue>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope local|global]<br> - [match]<br> - [match limits]<br> - [lock [yes|no]]<br> - [lock limits [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -scale linear<br> -$ds9 -scale log exp 100<br> -$ds9 -scale datasec yes<br> -$ds9 -scale histequ<br> -$ds9 -scale limits 1 100<br> -$ds9 -scale mode zscale<br> -$ds9 -scale mode 99.5<br> -$ds9 -scale scope local<br> -$ds9 -scale match<br> -$ds9 -scale match limits<br> -$ds9 -scale lock yes<br> -$ds9 -scale lock limits yes<br> -$ds9 -scale open<br> -$ds9 -scale close</tt><tt><br></tt> -<p><b><a name="shm" id="shm"></a>shm</b></p> -<p>Load a shared memory segment into the current frame.</p> -<tt>Syntax:<br> --shm [<key> [<filename>]]<br> - [key <id> [<filename>]]<br> - [shmid <id> [<filename>]]<br> - [fits [key|shmid] <id> -[<filename>]]<br> - [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]]<br> - [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]]<br> - [rgbcube [key|shmid] <id> -[<filename>]]<br> - [rgbimage [key|shmid] <id> -[<filename>]]<br> - [rgbarray [key|shmid] <id> + <br> + Example:<br> + $ds9 -rgbarray + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> + <tt>$cat foo.arr | ds9 -rgbarray + -[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> + <p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> + <p>Load FITS rgbcube into rgb frame.<br> + </p> + <tt>Syntax:<br> + -rgbcube <filename><br> + <br> + Example:<br> + $ds9 -rgbcube foo.fits</tt><tt><tt><br> + </tt> $cat foo.fits | ds9 + -rgbcube -</tt><br> + <p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> + <p>Load FITS rgbimage into rgb frame.<br> + </p> + <tt>Syntax:<br> + -rgbimage <filename><br> + <br> + Example:<br> + $ds9 -rgbimage foo.fits</tt><tt><tt><br> + </tt> $cat foo.fits | ds9 + -rgbimage -</tt><br> + <p><b><a name="rotate" id="rotate"></a>rotate</b></p> + <p>Controls the rotation angle (in degrees) of the current + frame.<</p> + <tt>Syntax:<br> + -rotate [<value>]<br> + [to <value>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -rotate 45<br> + $ds9 -rotate to 30<br> + $ds9 -rotate open<br> + $ds9 -rotate close<br> + </tt> + <p><b><a name="samp" id="samp"></a>samp</b></p> + <p>Configure SAMP protocol.</p> + <tt>Syntax:<br> + -samp [yes|no|connect|disconnect]<br> + [broadcast [image|table]]<br> + [send [image|table] + <application>]<br> + <br> + Example:<br> + $ds9 -samp yes<br> + </tt> <tt><tt>$ds9 -samp connect<br> + </tt> $ds9 + -samp broadcast image<br> + $ds9 -samp send image aladin</tt><br> + <p><b><a name="save" id="save"></a>save<br> + </b></p> + <p>Save loaded image data of current frame as FITS.</p> + <tt>Syntax:<br> + -save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> + [image|table|slice]</tt><br> + <tt> <br> + Example:<br> + $ds9 -save foo.fits</tt><br> + <tt>$ds9 -save fits foo.fits image</tt><br> + <tt>$ds9 -save fits foo.fits table<br> + $ds9 -save fits foo.fits slice</tt><br> + <tt>$ds9 -save rgbimage foo.fits<br> + </tt> <tt>$ds9 -save rgbcube + foo.fits</tt><br> + <tt>$ds9 -save mecube foo.fits</tt><br> + <tt>$ds9 -save mosaic foo.fits</tt><br> + <tt>$ds9 -save mosaicimage foo.fits</tt><br> + <p><b><a name="saveimage" id="saveimage"></a>saveimage</b></p> + <p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> + compression method.</p> + <tt>Syntax:<br> + -saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> + <tt><filename><br> + -saveimage <filename>.jpeg [1-100]<br> + -saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + $ds9 -saveimage ds9.tiff<br> + $ds9 -saveimage jpeg ds9.jpeg 75</tt><tt><br> + </tt> + <p><b><a name="scale" id="scale"></a>scale</b></p> + <p>Controls the limits and color scale distribution.</p> + <tt>Syntax:<br> + -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [datasec yes|no]<br> + [limits <minvalue> + <maxvalue>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -scale linear<br> + $ds9 -scale log exp 100<br> + $ds9 -scale datasec yes<br> + $ds9 -scale histequ<br> + $ds9 -scale limits 1 100<br> + $ds9 -scale mode zscale<br> + $ds9 -scale mode 99.5<br> + $ds9 -scale scope local<br> + $ds9 -scale match<br> + $ds9 -scale match limits<br> + $ds9 -scale lock yes<br> + $ds9 -scale lock limits yes<br> + $ds9 -scale open<br> + $ds9 -scale close</tt><tt><br> + </tt> + <p><b><a name="shm" id="shm"></a>shm</b></p> + <p>Load a shared memory segment into the current frame.</p> + <tt>Syntax:<br> + -shm [<key> [<filename>]]<br> + [key <id> [<filename>]]<br> + [shmid <id> [<filename>]]<br> + [fits [key|shmid] <id> + [<filename>]]<br> + [mosaicimage + [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]]<br> + [mosaic [iraf|wcs|wcsa...wcsz] + [key|shmid] + <id> [<filename>]]<br> + [rgbcube [key|shmid] <id> + [<filename>]]<br> + [rgbimage [key|shmid] <id> + [<filename>]]<br> + [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> - - [array [key|shmid] <id> + [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - - <br> -Example:<br> -$ds9 -shm 102<br> -$ds9 -shm key 102<br> -$ds9 -shm shmid 102 foo<br> -$ds9 -shm fits 100 foo<br> -$ds9 -shm mosaicimage iraf key 100 foo<br> -$ds9 -shm mosaicimage wcs key 100 foo<br> -$ds9 -shm mosaicimage wcsa key 100 foo<br> -$ds9 -shm mosaicimage wfpc2 key 100 foo<br> -$ds9 -shm mosaic iraf key 100 foo<br> -$ds9 -shm mosaic wcs key 100 foo<br> -$ds9 -shm rgbcube key 100 foo<br> -$ds9 -shm rgbimage key 100 foo<br> -$ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32]<br> -$ds9 -shm array shmid 102 [dim=32,bitpix=-32]<br></tt> -<p><b><a name="sia" id="sia"></a>sia<br></b></p> -<p>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.</p> -<tt>Syntax:<br></tt> <tt>-sia</tt> -<tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt><br> - -<br></tt> <tt> </tt><tt> [<ref>] -[cancel]<br></tt> <tt> [<ref>] -[clear]<br></tt> <tt> [<ref>] -[close]</tt><br> -<tt> [<ref>] [coordinate <ra> -<dec> <coordsys>]</tt><tt><br></tt> -<tt> </tt> <tt>[<ref>] -[crosshair]</tt><br> -<tt> [<ref>] [export sb|tsv -<filename>]<br></tt> <tt> [<ref>] -[name <object>]<br></tt> <tt> -[<ref>] [print]</tt><br> -<tt> [<ref>] [retrieve]<br></tt> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] [radius <value> -degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> -[<ref>] [skyformat <skyformat>]<br></tt> -<tt> [<ref>] [system -<coordsys>]</tt><tt><br></tt> -<tt> </tt> <tt>[<ref>] -[update]</tt><br> -<tt><br> -Example:<br></tt> <tt>$ds9 -sia 2mass<br></tt> <tt>$ds9 -sia -cancel<br></tt> <tt>$ds9 -sia clear<br></tt> <tt>$ds9 -sia -close<br></tt> <tt>$ds9 -sia coordinate 202.48 47.21 fk5<br></tt> -<tt>$ds9 -sia crosshair<br></tt> <tt>$ds9 -sia export tsv -bar.tsv<br></tt> <tt>$ds9 -sia name m51<br></tt> <tt>$ds9 -sia -print</tt><br> -<tt>$ds9 -sia retrieve<br></tt> <tt>$ds9 -sia save foo.xml<br></tt> -<tt>$ds9 -sia radius 1 degrees</tt><br> -<tt>$ds9 -sia sky fk5<br> -$ds9 -sia skyformat degrees<br></tt> <tt>$ds9 -sia system -wcs</tt><tt><br></tt> <tt>$ds9 -sia update<br> -<br></tt> <b><a name="single" id="single"></a>single</b> -<p>Set display mode to single.</p> -<tt>Syntax:<br> --single<br> - <br> -Example:<br> -$ds9 -single<br></tt> -<p><b><a name="skyview" id="skyview"></a>skyview</b></p> -<p>Support for SkyView image server at HEASARC.</p> -<tt>Syntax:<br> --skyview []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> -<dec>] # in wcs fk5<br> - [size -<width> <height> degrees|arcmin|arcsec]<br> - [pixels -<width> <height>]<br> - [save yes|no]<br> - [frame -new|current]<br> - [update -frame|crosshair]<br> - [survey <survey>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -skyview<br> -$ds9 -skyview m31<br></tt> <tt><tt>$ds9 -skyview name -m31<br></tt></tt> <tt><tt><tt>$ds9 -skyview name -clear<br></tt></tt> $ds9 -skyview 00:42:44.404 +41:16:08.78<br> -$ds9 -skyview size 60 60 arcmin<br> -$ds9 -skyview pixels 600 600<br> -$ds9 -skyview save yes<br> -$ds9 -skyview frame current<br> -$ds9 -skyview update frame<br> -$ds9 -skyview survey sdssi<br> -$ds9 -skyview open<br> -$ds9 -skyview close<br></tt> -<p><b><a name="sleep" id="sleep"></a>sleep</b></p> -<p>Delays execution for specified number of seconds. Default is 1 -second.</p> -<tt>Syntax:<br> --sleep [#]<br> - <br> -Example:<br> -$ds9 -sleep<br> -$ds9 -sleep 2<br></tt> -<p><b><a name="slice" id="slice"></a>slice<br> -noslice<br></b></p> -<p>Indicates next files loaded are to treated as slices of a cube. -Can be disabled with <tt>noslice</tt> command.<br></p> -<tt>Syntax:<br> --slice <filename><br> --noslice<br> - <br> -Example:<br> -$ds9 -slice *.fits<br> -$ds9 -noslice<br></tt> -<p><b><a name="smooth" id="smooth"></a>smooth</b></p> -<p>Smooth current image or set smooth parameters.<br> -Boxcar width = <i>2*radius+1</i><br> -Tophat diameter = <i>2*radius+1</i><br> -Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> -Elliptical Gaussian diameter = <i>2*radius+1,</i> mean -<i>=0</i><br></p> -<tt>Syntax:<br> --smooth []<br> - [yes|no]<br> - [function -boxcar|tophat|gaussian|elliptic]<br></tt> -<tt> [radius -<value>]<br></tt> -<tt><tt><tt><tt> -[radiusminor <value>]<br></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> -[sigma <value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> -[sigmaminor <value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt> -[angle <value>]<br></tt></tt></tt></tt></tt></tt></tt> - [match]<br> - [lock [yes|no]]<br></tt> -<tt><tt> [open|close]<br> - </tt><br> -Example:<br> -$ds9 -smooth<br> -$ds9 -smooth yes<br> -$ds9 -smooth function tophat<br></tt> <tt>$ds9 -smooth radius -4<br></tt> <tt>$ds9 -smooth radiusminor 4<br></tt> -<tt><tt><tt><tt><tt><tt>$ds9 -smooth sigma -2.0<br></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt>$ds9 --smooth sigmaminor 2.0<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt>$ds9 -smooth angle -45<br></tt></tt></tt></tt></tt></tt></tt> $ds9 -smooth match<br> -$ds9 -smooth lock yes</tt><br> -<tt>$ds9 -smooth open<br> -$ds9 -smooth close<br></tt> -<p><b><a name="squared" id="squared"></a>squared</b></p> -<p>Select squared scale function for the current frame.</p> -<tt>Syntax:<br> --squared<br> - <br> -Example:<br> -$ds9 -squared</tt> -<p><b><a name="sqrt" id="sqrt"></a>sqrt</b></p> -<p>Select square soot scale function for the current frame.</p> -<tt>Syntax:<br> --sqrt<br> - <br> -Example:<br> -$ds9 -sqrt</tt> -<p><b><a name="source" id="source"></a>source</b></p> -<p>Source TCL code from a file.</p> -<tt>Syntax:<br> --source <filename><br> - <br> -Example:<br> -$ds9 -source extensions.tcl<br></tt> -<p><b><a name="tcl" id="tcl"></a>tcl</b></p> -<p>Execute one TCL command. Note: this a different behavior from -previous versions of DS9.<br></p> -<tt>Syntax:<br> --tcl <tcl command><br> - <br> -Example:<br> -$ds9 -tcl 'puts "Hello, World"'</tt><br> -<p><b><a name="threads" id="threads"></a>threads</b></p> -<p>Set number of process threads for functions which are -multi-threaded.</p> -<tt>Syntax:<br> --threads #<br> - <br> -Example:<br> -$ds9 -threads 8</tt><br> -<br> -<b><a name="tiff" id="tiff"></a>tiff</b><br> -<p>Load TIFF image into current frame.<br></p> -<tt>Syntax:<br> --tiff <filename><br> - <br> -Example:<br></tt> <tt>$ds9 -tiff -foo.tiff</tt><tt><tt><tt><tt><br></tt></tt></tt></tt> <tt><tt>$cat -foo.fits | ds9 -tiff -</tt></tt><tt><br></tt> -<p><b><a name="tile" id="tile"></a>tile</b></p> -<p>Controls the tile display mode.</p> -<tt>Syntax:<br> --tile []<br> - [yes|no]<br> - [mode grid|column|row]<br> - [grid]<br> - [grid mode automatic|manual]<br> - [grid direction x|y]<br> - [grid layout <col> -<row>]<br> - [grid gap <pixels>]<br> - [row]<br> - [column]<br> - <br> -Example:<br> -$ds9 -tile<br> -$ds9 -tile yes<br> -$ds9 -tile mode row<br> -$ds9 -tile grid<br> -$ds9 -tile grid mode manual<br> -$ds9 -tile grid direction x<br> -$ds9 -tile grid layout 5 5<br> -$ds9 -tile grid gap 10<br> -$ds9 -tile row<br> -$ds9 -tile column</tt> -<p><b><a name="title" id="title"></a>title</b></p> -<p>Changes the display window title to the specified name.</p> -<tt>Syntax:<br> --title name<br> - <br> -Example:<br> -$ds9 -title Voyager</tt> -<p><b><a name="unix" id="unix"></a>unix</b></p> -<p>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.</p> -<tt>Syntax:<br> --unix name<br> - <br> -Example:<br> -$ds9 -unix "/tmp/.IMT%d"</tt> -<p><b><a name="unix_only" id="unix_only"></a>unix_only</b></p> -<p>Only use the IRAF unix socket name. This is the same as -fifo -none -port 0.</p> -<tt>Syntax:<br> --unix_only<br> - <br> -Example:<br> -$ds9 -unix_only<br></tt> -<p><b><a name="update" id="update"></a>update</b></p> -<p>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.</p> -<tt>Syntax:<br> --update []<br> - [# x1 y1 x2 y2]<br> - [now]<br> - [now # x1 y1 x2 y2]<br> - <br> -Example:<br> -$ds9 -update<br> -$ds9 -update 1 100 100 300 400<br> -$ds9 -update now<br> -$ds9 -update now 1 100 100 300 400</tt><br> -<p><b><a name="url" id="url"></a>url</b></p> -<p>Load FITS from URL into the current frame</p> -<tt>Syntax:<br> --url <url><br> - <br> -Example:<br> -$ds9 -url http://foo.bar.edu/foo.fits</tt> -<p><b><a name="version" id="version"></a>version</b></p> -<p>Returns the current version of DS9 and exits.</p> -<tt>Syntax:<br> --version<br> - <br> -Example:<br> -$ds9 -version</tt> -<p><b><a name="view" id="view"></a>view</b></p> -<p>Controls the GUI and visible RGB frame color channels.</p> -<tt>Syntax:<br> --view [layout horizontal|vertical]<br> - [keyvalue <string>]<br> - [info yes|no]<br> - [panner yes|no]<br> - [magnifier yes|no]<br> - [buttons yes|no]<br> - [colorbar yes|no]<br> - [graph horizontal|vertical -yes|no]<br> - [filename yes|no]<br> - [object yes|no]<br> - [keyword yes|no]<br> - [minmax yes|no]<br> - [lowhigh yes|no]<br> - [units yes|no]<br> - [image|physical|wcs|wcsa...wcsz -yes|no]<br></tt> <tt><tt><tt> [frame -yes|no]<br></tt></tt> [red yes|no]<br> - [green yes|no]<br> - [blue yes|no]</tt><tt><tt><br> - </tt><br> -Example:<br> -$ds9 -view layout vertical<br> -$ds9 -view keyvalue BITPIX<br> -$ds9 -view info yes<br> -$ds9 -view panner yes<br> -$ds9 -view magnifier yes<br> -$ds9 -view buttons yes<br> -$ds9 -view colorbar yes<br> -$ds9 -view graph horizontal yes<br> -$ds9 -view filename yes<br> -$ds9 -view object yes<br> -$ds9 -view keyword yes<br> -$ds9 -view minmax yes<br> -$ds9 -view lowhigh yes<br> -$ds9 -view wcsa yes<br></tt> <tt>$ds9 -view frame yes</tt><br> -<tt>$ds9 -view red yes<br> -$ds9 -view green yes<br> -$ds9 -view blue yes</tt><tt><br></tt> -<p><b><a name="visual" id="visual"></a>visual</b></p> -<p>Force DS9 to use the specified color visual. This argument MUST -be the first argument listed. Requires the visual be available.</p> -<tt>Syntax:<br> --visual [truecolor|truecolor8|truecolor16|truecolor24] <br> -Example:<br> -$ds9 -visual truecolor24<br></tt> -<p><b><a name="vla" id="vla"></a>vla</b></p> -<p>Support for VLA Sky Survey.</p> -<tt>Syntax:<br> --vla []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey first|stripe82]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -vla<br> -$ds9 -vla m31<br></tt> <tt><tt>$ds9 -vla name m31<br></tt></tt> -<tt><tt><tt>$ds9 -vla name clear<br></tt></tt> $ds9 -vla -00:42:44.404 +41:16:08.78<br> -$ds9 -vla size 60 60 arcmin<br> -$ds9 -vla save yes<br> -$ds9 -vla frame current<br> -$ds9 -vla update frame<br> -$ds9 -vla survey stripe82<br> -$ds9 -vla open<br> -$ds9 -vla close</tt><br> -<p><b><a name="vlss" id="vlss"></a>vlss</b></p> -<p>Support for NRAO VLSS Sky Survey.</p> -<tt>Syntax:<br> --vlss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -vlss<br> -$ds9 -vlss m31<br></tt> <tt><tt>$ds9 -vlss name m31<br></tt></tt> -<tt><tt><tt>$ds9 -vlss name clear<br></tt></tt> $ds9 -vlss -00:42:44.404 +41:16:08.78<br> -$ds9 -vlss size 60 60 arcmin<br> -$ds9 -vlss save yes<br> -$ds9 -vlss frame current<br> -$ds9 -vlss update frame<br> -$ds9 -vlss open<br> -$ds9 -nvess close</tt> -<p><b><a name="vo" id="vo"></a>vo</b></p> -<p>Invoke an connection to a Virtual Observatory site.</p> -<tt>Syntax:<br> --vo [method xpa|mime]<br> - [server <url>]<br> - [internal yes|no]<br> - [delay #]<br> - [<url>]<br> - [connect <url>]<br> - [disconnect <url>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -vo method xpa<br> -$ds9 -vo server "http://foo.bar.edu/list.txt"<br> -$ds9 -vo internal yes<br> -$ds9 -vo delay 15 # keep-alive delay<br> -$ds9 -vo chandra-ed<br> -$ds9 -vo connect chandra-ed<br> -$ds9 -vo disconnect chandra-ed<br> -$ds9 -vo open<br> -$ds9 -vo close<br></tt> -<p><b><a name="wcs" id="wcs"></a>wcs</b></p> -<p>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 <a href="file.html#WCS">WCS</a> for more information.</p> -<tt>Syntax:<br> --wcs [[system] wcs|wcsa...wcsz]<br> - [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> - [[skyformat] degrees|sexagesimal]<br> - [align yes|no]<br> - [reset [#]]<br> - [replace [#] <filename>]<br> - [append [#] <filename>]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -wcs wcs<br> -$ds9 -wcs system wcs<br></tt> <tt>$ds9 -wcs fk5<br></tt> <tt>$ds9 --wcs sky fk5<br></tt> <tt>$ds9 -wcs sexagesimal<br></tt> <tt>$ds9 --wcs skyformat sexagesimal<br> -$ds9 -wcs align yes<br> -$ds9 -wcs reset<br> -$ds9 -wcs reset 3<br> -$ds9 -wcs replace foo.wcs<br> -$ds9 -wcs replace 3 foo.wcs<br> -$ds9 -wcs append foo.wcs<br> -$ds9 -wcs append 3 foo.wcs<br> -$ds9 -wcs open<br> -$ds9 -wcs close<br></tt> -<p><b><a name="web" id="web"></a>web</b></p> -<p>Display specified URL in the web display.</p> -<tt>Syntax:<br> --web []<br> - [<url>]<br> - [new <webname> <url>]<br> - [<webname>] [click -back|forward|stop|reload|#]<br> - [<webname>] [clear]<br> - [<webname>] [close]<br> - <br> -Example:<br> -$ds9 -web www.cnn.com<br> -$ds9 -web new www.cnn.com<br> -$ds9 -web hvweb www.apple.com<br> -$ds9 -web click back<br> -$ds9 -web click 2<br> -$ds9 -web clear<br> -$ds9 -web close<br></tt> -<p><b><a name="width" id="width"></a>width</b></p> -<p>Set the width of the image display window. Use the <a href= -"command.html#geometry">geometry</a> command to set the overall -width and height of the ds9 window.</p> -<tt>Syntax:<br> --width [<value>]<br> - <br> -Example:<br> -$ds9 -width 512<br></tt> -<p><b><a name="xpa" id="xpa"></a>xpa</b></p> -<p>Configure XPA.</p> -<tt>Syntax:<br> --xpa [yes|no]<br> - [inet|local|unix|localhost]<br> - [noxpans]<br> - [connect]<br> - [disconnect]<br> - [info]<br> - <br> -Example:<br> -$ds9 -xpa no<br> -$ds9 -xpa local<br> -$ds9 -xpa noxpans<br> -$ds9 -xpa connect<br> -$ds9 -xpa disconnect<br> -$ds9 -xpa info<br></tt> -<p><b><a name="zmax" id="zmax"></a>zmax</b></p> -<p>Set Scale Limits based on the <i>IRAF</i> algorithm and -maximum data value.</p> -<tt>Syntax:<br> --zmax<br> - <br> -Example:<br> -$ds9 -zmax</tt> -<p><b><a name="zscale" id="zscale"></a>zscale</b></p> -<p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> -<tt>Syntax:<br> --zscale []<br> - [contrast]<br> - [sample]<br> - [line]<br> - <br> -Example:<br> -$ds9 -zscale<br> -$ds9 -zscale contrast .25<br> -$ds9 -zscale sample 600<br> -$ds9 -zscale line 120<br></tt> -<p><b><a name="zoom" id="zoom"></a>zoom</b></p> -<p>Controls the current zoom value for the current frame.</p> -<tt>Syntax:<br> --zoom [<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br> - [to fit]<br> - [open|close]<br> - <br> -Example:<br> -$ds9 -zoom 2<br> -$ds9 -zoom 2 4<br> -$ds9 -zoom to 4<br> -$ds9 -zoom to 2 4<br> -$ds9 -zoom in<br> -$ds9 -zoom out<br> -$ds9 -zoom to fit<br> -$ds9 -zoom open<br> -$ds9 -zoom close<br> -<br></tt></blockquote> -</body> + <br> + Example:<br> + $ds9 -shm 102<br> + $ds9 -shm key 102<br> + $ds9 -shm shmid 102 foo<br> + $ds9 -shm fits 100 foo<br> + $ds9 -shm mosaicimage iraf key 100 foo<br> + $ds9 -shm mosaicimage wcs key 100 foo<br> + $ds9 -shm mosaicimage wcsa key 100 foo<br> + $ds9 -shm mosaicimage wfpc2 key 100 foo<br> + $ds9 -shm mosaic iraf key 100 foo<br> + $ds9 -shm mosaic wcs key 100 foo<br> + $ds9 -shm rgbcube key 100 foo<br> + $ds9 -shm rgbimage key 100 foo<br> + $ds9 -shm rgbarray shmid 102 [dim=32,zdim=3,bitpix=-32]<br> + $ds9 -shm array shmid 102 [dim=32,bitpix=-32]<br> + </tt> + <p><b><a name="sia" id="sia"></a>sia<br> + </b></p> + <p>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.</p> + <tt>Syntax:<br> + </tt> <tt>-sia</tt> + <tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt><br> + <br> + </tt> <tt> </tt><tt> [<ref>] + [cancel]<br> + </tt> <tt> [<ref>] + [clear]<br> + </tt> <tt> [<ref>] + [close]</tt><br> + <tt> [<ref>] [coordinate <ra> + <dec> <coordsys>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[<ref>] + [crosshair]</tt><br> + <tt> [<ref>] [export sb|tsv + <filename>]<br> + </tt> <tt> [<ref>] + [name <object>]<br> + </tt> <tt> + [<ref>] [print]</tt><br> + <tt> [<ref>] [retrieve]<br> + </tt> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] [radius <value> + degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> + [<ref>] [skyformat <skyformat>]<br> + </tt> + <tt> [<ref>] [system + <coordsys>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[<ref>] + [update]</tt><br> + <tt><br> + Example:<br> + </tt> <tt>$ds9 -sia 2mass<br> + </tt> <tt>$ds9 -sia + cancel<br> + </tt> <tt>$ds9 -sia clear<br> + </tt> <tt>$ds9 -sia + close<br> + </tt> <tt>$ds9 -sia coordinate 202.48 47.21 fk5<br> + </tt> + <tt>$ds9 -sia crosshair<br> + </tt> <tt>$ds9 -sia export tsv + bar.tsv<br> + </tt> <tt>$ds9 -sia name m51<br> + </tt> <tt>$ds9 -sia + print</tt><br> + <tt>$ds9 -sia retrieve<br> + </tt> <tt>$ds9 -sia save foo.xml<br> + </tt> + <tt>$ds9 -sia radius 1 degrees</tt><br> + <tt>$ds9 -sia sky fk5<br> + $ds9 -sia skyformat degrees<br> + </tt> <tt>$ds9 -sia system + wcs</tt><tt><br> + </tt> <tt>$ds9 -sia update<br> + <br> + </tt> <b><a name="single" id="single"></a>single</b> + <p>Set display mode to single.</p> + <tt>Syntax:<br> + -single<br> + <br> + Example:<br> + $ds9 -single<br> + </tt> + <p><b><a name="skyview" id="skyview"></a>skyview</b></p> + <p>Support for SkyView image server at HEASARC.</p> + <tt>Syntax:<br> + -skyview []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> + <dec>] # in wcs fk5<br> + [size + <width> <height> degrees|arcmin|arcsec]<br> + [pixels + <width> <height>]<br> + [save yes|no]<br> + [frame + new|current]<br> + [update + frame|crosshair]<br> + [survey <survey>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -skyview<br> + $ds9 -skyview m31<br> + </tt> <tt><tt>$ds9 -skyview name + m31<br> + </tt></tt> <tt><tt><tt>$ds9 -skyview name + clear<br> + </tt></tt> $ds9 -skyview 00:42:44.404 +41:16:08.78<br> + $ds9 -skyview size 60 60 arcmin<br> + $ds9 -skyview pixels 600 600<br> + $ds9 -skyview save yes<br> + $ds9 -skyview frame current<br> + $ds9 -skyview update frame<br> + $ds9 -skyview survey sdssi<br> + $ds9 -skyview open<br> + $ds9 -skyview close<br> + </tt> + <p><b><a name="sleep" id="sleep"></a>sleep</b></p> + <p>Delays execution for specified number of seconds. Default is 1 + second.</p> + <tt>Syntax:<br> + -sleep [#]<br> + <br> + Example:<br> + $ds9 -sleep<br> + $ds9 -sleep 2<br> + </tt> + <p><b><a name="slice" id="slice"></a>slice<br> + noslice<br> + </b></p> + <p>Indicates next files loaded are to treated as slices of a cube. + Can be disabled with <tt>noslice</tt> command.<br> + </p> + <tt>Syntax:<br> + -slice <filename><br> + -noslice<br> + <br> + Example:<br> + $ds9 -slice *.fits<br> + $ds9 -noslice<br> + </tt> + <p><b><a name="smooth" id="smooth"></a>smooth</b></p> + <p>Smooth current image or set smooth parameters.<br> + Boxcar width = <i>2*radius+1</i><br> + Tophat diameter = <i>2*radius+1</i><br> + Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> + Elliptical Gaussian diameter = <i>2*radius+1,</i> mean + <i>=0</i><br> + </p> + <tt>Syntax:<br> + -smooth []<br> + [yes|no]<br> + [function + boxcar|tophat|gaussian|elliptic]<br> + </tt> + <tt> [radius + <value>]<br> + </tt> + <tt><tt><tt><tt> + [radiusminor <value>]<br> + </tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigma <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigmaminor <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt> +[angle + <value>]<br> + </tt></tt></tt></tt></tt></tt></tt> + [match]<br> + [lock [yes|no]]<br> + </tt> + <tt><tt> [open|close]<br> + </tt><br> + Example:<br> + $ds9 -smooth<br> + $ds9 -smooth yes<br> + $ds9 -smooth function tophat<br> + </tt> <tt>$ds9 -smooth radius + 4<br> + </tt> <tt>$ds9 -smooth radiusminor 4<br> + </tt> + <tt><tt><tt><tt><tt><tt>$ds9 -smooth sigma + 2.0<br> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt>$ds9 +-smooth + sigmaminor 2.0<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt>$ds9 -smooth angle + 45<br> + </tt></tt></tt></tt></tt></tt></tt> $ds9 -smooth + match<br> + $ds9 -smooth lock yes</tt><br> + <tt>$ds9 -smooth open<br> + $ds9 -smooth close<br> + </tt> + <p><b><a name="squared" id="squared"></a>squared</b></p> + <p>Select squared scale function for the current frame.</p> + <tt>Syntax:<br> + -squared<br> + <br> + Example:<br> + $ds9 -squared</tt> + <p><b><a name="sqrt" id="sqrt"></a>sqrt</b></p> + <p>Select square soot scale function for the current frame.</p> + <tt>Syntax:<br> + -sqrt<br> + <br> + Example:<br> + $ds9 -sqrt</tt> + <p><b><a name="source" id="source"></a>source</b></p> + <p>Source TCL code from a file.</p> + <tt>Syntax:<br> + -source <filename><br> + <br> + Example:<br> + $ds9 -source extensions.tcl<br> + </tt> + <p><b><a name="tcl" id="tcl"></a>tcl</b></p> + <p>Execute one TCL command. Note: this a different behavior from + previous versions of DS9.<br> + </p> + <tt>Syntax:<br> + -tcl <tcl command><br> + <br> + Example:<br> + $ds9 -tcl 'puts "Hello, World"'</tt><br> + <p><b><a name="threads" id="threads"></a>threads</b></p> + <p>Set number of process threads for functions which are + multi-threaded.</p> + <tt>Syntax:<br> + -threads #<br> + <br> + Example:<br> + $ds9 -threads 8</tt><br> + <br> + <b><a name="tiff" id="tiff"></a>tiff</b><br> + <p>Load TIFF image into current frame.<br> + </p> + <tt>Syntax:<br> + -tiff <filename><br> + <br> + Example:<br> + </tt> <tt>$ds9 -tiff + foo.tiff</tt><tt><tt><tt><tt><br> + </tt></tt></tt></tt> <tt><tt>$cat + foo.fits | ds9 -tiff -</tt></tt><tt><br> + </tt> + <p><b><a name="tile" id="tile"></a>tile</b></p> + <p>Controls the tile display mode.</p> + <tt>Syntax:<br> + -tile []<br> + [yes|no]<br> + [mode grid|column|row]<br> + [grid]<br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> + <row>]<br> + [grid gap <pixels>]<br> + [row]<br> + [column]<br> + <br> + Example:<br> + $ds9 -tile<br> + $ds9 -tile yes<br> + $ds9 -tile mode row<br> + $ds9 -tile grid<br> + $ds9 -tile grid mode manual<br> + $ds9 -tile grid direction x<br> + $ds9 -tile grid layout 5 5<br> + $ds9 -tile grid gap 10<br> + $ds9 -tile row<br> + $ds9 -tile column</tt> + <p><b><a name="title" id="title"></a>title</b></p> + <p>Changes the display window title to the specified name.</p> + <tt>Syntax:<br> + -title name<br> + <br> + Example:<br> + $ds9 -title Voyager</tt> + <p><b><a name="unix" id="unix"></a>unix</b></p> + <p>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.</p> + <tt>Syntax:<br> + -unix name<br> + <br> + Example:<br> + $ds9 -unix "/tmp/.IMT%d"</tt> + <p><b><a name="unix_only" id="unix_only"></a>unix_only</b></p> + <p>Only use the IRAF unix socket name. This is the same as -fifo + none -port 0.</p> + <tt>Syntax:<br> + -unix_only<br> + <br> + Example:<br> + $ds9 -unix_only<br> + </tt> + <p><b><a name="update" id="update"></a>update</b></p> + <p>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.</p> + <tt>Syntax:<br> + -update []<br> + [# x1 y1 x2 y2]<br> + [now]<br> + [now # x1 y1 x2 y2]<br> + <br> + Example:<br> + $ds9 -update<br> + $ds9 -update 1 100 100 300 400<br> + $ds9 -update now<br> + $ds9 -update now 1 100 100 300 400</tt><br> + <p><b><a name="url" id="url"></a>url</b></p> + <p>Load FITS from URL into the current frame</p> + <tt>Syntax:<br> + -url <url><br> + <br> + Example:<br> + $ds9 -url http://foo.bar.edu/foo.fits</tt> + <p><b><a name="version" id="version"></a>version</b></p> + <p>Returns the current version of DS9 and exits.</p> + <tt>Syntax:<br> + -version<br> + <br> + Example:<br> + $ds9 -version</tt> + <p><b><a name="view" id="view"></a>view</b></p> + <p>Controls the GUI and visible RGB frame color channels.</p> + <tt>Syntax:<br> + -view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no]<br> + [panner yes|no]<br> + [magnifier yes|no]<br> + [buttons yes|no]<br> + [colorbar yes|no]<br> + [graph horizontal|vertical + yes|no]<br> + [filename yes|no]<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz + yes|no]<br> + </tt> <tt><tt><tt> [frame + yes|no]<br> + </tt></tt> [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]</tt><tt><tt><br> + </tt><br> + Example:<br> + $ds9 -view layout vertical<br> + $ds9 -view keyvalue BITPIX<br> + $ds9 -view info yes<br> + $ds9 -view panner yes<br> + $ds9 -view magnifier yes<br> + $ds9 -view buttons yes<br> + $ds9 -view colorbar yes<br> + $ds9 -view graph horizontal yes<br> + $ds9 -view filename yes<br> + $ds9 -view object yes<br> + $ds9 -view keyword yes<br> + $ds9 -view minmax yes<br> + $ds9 -view lowhigh yes<br> + $ds9 -view wcsa yes<br> + </tt> <tt>$ds9 -view frame yes</tt><br> + <tt>$ds9 -view red yes<br> + $ds9 -view green yes<br> + $ds9 -view blue yes</tt><tt><br> + </tt> + <p><b><a name="visual" id="visual"></a>visual</b></p> + <p>Force DS9 to use the specified color visual. This argument MUST + be the first argument listed. Requires the visual be available.</p> + <tt>Syntax:<br> + -visual [truecolor|truecolor8|truecolor16|truecolor24] <br> + Example:<br> + $ds9 -visual truecolor24<br> + </tt> + <p><b><a name="vla" id="vla"></a>vla</b></p> + <p>Support for VLA Sky Survey.</p> + <tt>Syntax:<br> + -vla []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -vla<br> + $ds9 -vla m31<br> + </tt> <tt><tt>$ds9 -vla name m31<br> + </tt></tt> + <tt><tt><tt>$ds9 -vla name clear<br> + </tt></tt> $ds9 -vla + 00:42:44.404 +41:16:08.78<br> + $ds9 -vla size 60 60 arcmin<br> + $ds9 -vla save yes<br> + $ds9 -vla frame current<br> + $ds9 -vla update frame<br> + $ds9 -vla survey stripe82<br> + $ds9 -vla open<br> + $ds9 -vla close</tt><br> + <p><b><a name="vlss" id="vlss"></a>vlss</b></p> + <p>Support for NRAO VLSS Sky Survey.</p> + <tt>Syntax:<br> + -vlss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -vlss<br> + $ds9 -vlss m31<br> + </tt> <tt><tt>$ds9 -vlss name m31<br> + </tt></tt> + <tt><tt><tt>$ds9 -vlss name clear<br> + </tt></tt> $ds9 -vlss + 00:42:44.404 +41:16:08.78<br> + $ds9 -vlss size 60 60 arcmin<br> + $ds9 -vlss save yes<br> + $ds9 -vlss frame current<br> + $ds9 -vlss update frame<br> + $ds9 -vlss open<br> + $ds9 -nvess close</tt> + <p><b><a name="vo" id="vo"></a>vo</b></p> + <p>Invoke an connection to a Virtual Observatory site.</p> + <tt>Syntax:<br> + -vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -vo method xpa<br> + $ds9 -vo server "http://foo.bar.edu/list.txt"<br> + $ds9 -vo internal yes<br> + $ds9 -vo delay 15 # keep-alive delay<br> + $ds9 -vo chandra-ed<br> + $ds9 -vo connect chandra-ed<br> + $ds9 -vo disconnect chandra-ed<br> + $ds9 -vo open<br> + $ds9 -vo close<br> + </tt> + <p><b><a name="wcs" id="wcs"></a>wcs</b></p> + <p>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 <a href="file.html#WCS">WCS</a> for more information.</p> + <tt>Syntax:<br> + -wcs [[system] wcs|wcsa...wcsz]<br> + [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> + [[skyformat] degrees|sexagesimal]<br> + [align yes|no]<br> + [reset [#]]<br> + [replace [#] <filename>]<br> + [append [#] <filename>]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -wcs wcs<br> + $ds9 -wcs system wcs<br> + </tt> <tt>$ds9 -wcs fk5<br> + </tt> <tt>$ds9 + -wcs sky fk5<br> + </tt> <tt>$ds9 -wcs sexagesimal<br> + </tt> <tt>$ds9 + -wcs skyformat sexagesimal<br> + $ds9 -wcs align yes<br> + $ds9 -wcs reset<br> + $ds9 -wcs reset 3<br> + $ds9 -wcs replace foo.wcs<br> + $ds9 -wcs replace 3 foo.wcs<br> + $ds9 -wcs append foo.wcs<br> + $ds9 -wcs append 3 foo.wcs<br> + $ds9 -wcs open<br> + $ds9 -wcs close<br> + </tt> + <p><b><a name="web" id="web"></a>web</b></p> + <p>Display specified URL in the web display.</p> + <tt>Syntax:<br> + -web []<br> + [<url>]<br> + [new <webname> <url>]<br> + [<webname>] [click + back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> + Example:<br> + $ds9 -web www.cnn.com<br> + $ds9 -web new www.cnn.com<br> + $ds9 -web hvweb www.apple.com<br> + $ds9 -web click back<br> + $ds9 -web click 2<br> + $ds9 -web clear<br> + $ds9 -web close<br> + </tt> + <p><b><a name="width" id="width"></a>width</b></p> + <p>Set the width of the image display window. Use the <a + href="command.html#geometry">geometry</a> command to set the + overall + width and height of the ds9 window.</p> + <tt>Syntax:<br> + -width [<value>]<br> + <br> + Example:<br> + $ds9 -width 512<br> + </tt> + <p><b><a name="xpa" id="xpa"></a>xpa</b></p> + <p>Configure XPA.</p> + <tt>Syntax:<br> + -xpa [yes|no]<br> + [inet|local|unix|localhost]<br> + [noxpans]<br> + [connect]<br> + [disconnect]<br> + [info]<br> + <br> + Example:<br> + $ds9 -xpa no<br> + $ds9 -xpa local<br> + $ds9 -xpa noxpans<br> + $ds9 -xpa connect<br> + $ds9 -xpa disconnect<br> + $ds9 -xpa info<br> + </tt> + <p><b><a name="zmax" id="zmax"></a>zmax</b></p> + <p>Set Scale Limits based on the <i>IRAF</i> algorithm and + maximum data value.</p> + <tt>Syntax:<br> + -zmax<br> + <br> + Example:<br> + $ds9 -zmax</tt> + <p><b><a name="zscale" id="zscale"></a>zscale</b></p> + <p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> + <tt>Syntax:<br> + -zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> + Example:<br> + $ds9 -zscale<br> + $ds9 -zscale contrast .25<br> + $ds9 -zscale sample 600<br> + $ds9 -zscale line 120<br> + </tt> + <p><b><a name="zoom" id="zoom"></a>zoom</b></p> + <p>Controls the current zoom value for the current frame.</p> + <tt>Syntax:<br> + -zoom [<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [open|close]<br> + <br> + Example:<br> + $ds9 -zoom 2<br> + $ds9 -zoom 2 4<br> + $ds9 -zoom to 4<br> + $ds9 -zoom to 2 4<br> + $ds9 -zoom in<br> + $ds9 -zoom out<br> + $ds9 -zoom to fit<br> + $ds9 -zoom open<br> + $ds9 -zoom close<br> + <br> + </tt></blockquote> + </body> </html> diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index a6e0f65..234796d 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -1,3159 +1,3821 @@ <!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> -<head> -<meta name="generator" content= -"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> -<meta http-equiv="Content-Type" content= -"text/html; charset=us-ascii"> -<meta name="GENERATOR" content= -"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> -<title>SAMP</title> -</head> -<body vlink="#551A8B" link="#0000FF" alink="#FF0000"> -<h3><img alt="" src="../sun.gif" width="100" height="98" align= -"middle"> SAMP</h3> -<blockquote> -<p>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 -<a href= -"http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> -<p>The samp implementation for DS9 is based on the <a href= -"xpa.html">XPA</a> model with 2 private calls:</p> -<tt>ds9.get<br> - Arguments<br> - cmd (string) required<br> - url (string) optional<br> - Returned value<br> - OK (samp.result map)<br> - value -(string) optional<br> - - url (string) optional<br> - ERROR (samp.error map)<br> - -samp.errortxt (string)<br> - <br> -ds9.set<br> - Arguments<br> - cmd (string) required<br> - url (string) optional<br> - Returned value<br> - OK<br> - ERROR (samp.error map)<br> - -samp.errortxt (string)<br></tt> -<p><tt>ds9.set</tt> maybe called via notification, call and -call/wait. <tt>ds9.get</tt> can only be called via call and -call/wait. Most of the <tt>ds9.get</tt> calls return a value -string, but a few will return a url instead.</p> -<tt><a href="#2mass">2mass</a><br> -<a href="#3d">3d</a><br> -<a href="#about">about</a><br> -<a href="#analysis">analysis</a><br> -<a href="#array">array</a><br> -<a href="#background">background</a><br> -<a href="#backup">backup</a><br> -<a href="#bin">bin</a><br> -<a href="#blink">blink</a><br> -<a href="#block">block</a><br> -<a href="#catalog">catalog</a><br> -<a href="#cd">cd</a><br> -<a href="#cmap">cmap</a><br> -<a href="#colorbar">colorbar</a><br> -<a href="#console">console</a><br> -<a href="#contour">contour</a><br> -<a href="#crop">crop</a><br> -<a href="#crosshair">crosshair</a><br> -<a href="#cube">cube</a><br> -<a href="#cursor">cursor</a><br> -<a href="#data">data</a><br> -<a href="#dsssao">dsssao</a><br> -<a href="#dsseso">dsseso</a><br> -<a href="#dssstsci">dssstsci</a><br> -<a href="#envi">envi</a><br> -<a href="#exit">exit</a><br> -<a href="#export">export</a><br> -<a href="#file">file</a><br> -<a href="#fits">fits</a><br> -<a href="#frame">frame</a><br> -<a href="#gif">gif</a><br> -<a href="#grid">grid</a><br> -<a href="#header">header</a><br> -<a href="#height">height</a><br> -<a href="#iconify">iconify</a><br></tt> <tt><tt><a href= -"#iexam">iexam</a><br></tt> <a href="#iis">iis</a><br> -<a href="#jpeg">jpeg</a><br> -<a href="#lock">lock</a><br> -<a href="#lower">lower</a><br> -<a href="#magnifier">magnifier</a><br> -<a href="#mask">mask</a><br> -<a href="#match">match</a><br> -<a href="#mecube">mecube</a><br> -<a href="#minmax">minmax</a><br> -<a href="#mode">mode</a><br> -<a href="#mosaic">mosaic</a><br> -<a href="#mosaicimage">mosaicimage</a><br> -<a href="#movie">movie</a><br> -<a href="#multiframe">multiframe</a><br> -<a href="#nameserver">nameserver</a><br> -<a href="#nan">nan</a><br> -<a href="#nrrd">nrrd</a><br> -<a href="#nvss">nvss</a><br> -<a href="#orient">orient</a><br> -<a href="#pagesetup">pagesetup</a><br> -<a href="#pan">pan</a><br> -<a href="#pixeltable">pixeltable</a><br> -<a href="#plot">plot</a><br> -<a href="#png">png</a><br> -<a href="#precision">precision</a><br> -<a href="#prefs">prefs</a><br> -<a href="#preserve">preserve</a><br> -<a href="#psprint">psprint</a><br> -<a href="#print">print</a><br> -<a href="#exit">quit</a><br> -<a href="#raise">raise</a><br> -<a href="#regions">regions</a><br> -<a href="#restore">restore</a><br> -<a href="#rgb">rgb</a><br> -<a href="#rgbarray">rgbarray</a><br> -<a href="#rgbcube">rgbcube</a><br> -<a href="#rgbimage">rgbimage</a><br> -<a href="#rotate">rotate</a><br> -<a href="#samp">samp</a><br> -<a href="#save">save</a><br> -<a href="#saveimage">saveimage</a><br> -<a href="#scale">scale</a><br> -<a href="#shm">shm</a><br></tt> <tt><tt><a href= -"#sia">sia</a><br></tt> <a href="#single">single</a><br> -<a href="#skyview">skyview</a><br> -<a href="#sleep">sleep</a><br> -<a href="#smooth">smooth</a><br> -<a href="#source">source</a><br> -<a href="#tcl">tcl</a><br> -<a href="#threads">threads</a><br> -<a href="#tiff">tiff</a><br> -<a href="#tile">tile</a><br> -<a href="#update">update</a><br> -<a href="#url">url</a><br> -<a href="#version">version</a><br> -<a href="#view">view</a><br> -<a href="#vla">vla</a></tt><br> -<tt><tt><a href="#vlss">vlss</a><br></tt> <a href="#vo">vo</a><br> -<a href="#wcs">wcs</a><br> -<a href="#web">web</a><br> -<a href="#width">width</a><br> -<a href="#zscale">zscale</a><br> -<a href="#zoom">zoom</a><br></tt> -<p><b><a name="2mass"></a>2mass</b></p> -<p>Support for 2MASS Digital Sky Survey.</p> -<tt>Syntax:<br> -2mass []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey j|h|k]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -2mass name<br> -2mass coord<br> -2mass size<br> -2mass save<br> -2mass frame<br> -2mass survey<br> -ds9.set(string cmd)<br> -2mass<br> -2mass m31<br></tt> <tt><tt>2mass name m31<br></tt></tt> -<tt><tt><tt>2mass name clear<br></tt></tt> 2mass 00:42:44.404 -+41:16:08.78<br> -2mass size 60 60 arcmin<br> -2mass save yes<br> -2mass frame current<br> -2mass update frame<br> -2mass survey j<br> -2mass open<br> -2mass close<br></tt> -<p><b><a name="3d"></a>3d</b></p> -<p>Support for 3D frame.</p> -<tt>Syntax:<br></tt> <tt>3d []<br> - [view <az> <el>]<br> - [az <az>]<br> - [el <el>]<br> - [scale <scale>]<br> - [method mip|aip]</tt><br> -<tt><tt> [background none|azimuth|elevation]<br></tt> - </tt><tt> [border yes|no]<br> - [border color <color>]<br></tt> <tt> -[highlite yes|no]<br> - [hightlite color <color>]<br></tt> -<tt><tt> </tt><tt> [compass yes|no]<br> - [compass color <color>]</tt></tt><br> -<tt><tt><tt><tt><tt> [match]<br> - [lock [yes|no]]<br></tt></tt></tt></tt> -[open|close]</tt><tt><br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br></tt> <tt>3d view<br> -3d az<br> -3d el<br> -3d scale<br> -3d method</tt><br> -<tt>3d background<br></tt> <tt>3d border<br> -3d border color<br></tt> <tt>3d highlite<br> -3d highlite color<br></tt> <tt><tt>3d compass<br> -3d compass color<br> -3d lock<br></tt> ds9.set(string cmd)<br></tt> <tt>3d # create new -3D frame<br> -3d view 45 30<br> -3d az 45<br> -3d el 30<br> -3d scale 10<br> -3d method mip</tt><br> -<tt>3d background azimuth<br></tt> <tt>3d border yes<br> -3d border color red<br></tt> <tt>3d highlite yes<br> -3d highlite color red<br></tt> <tt><tt>3d compass yes<br> -3d compass color red<br> -3d match<br> -3d lock yes<br></tt> 3d open<br> -3d close</tt><br> -<p><b><a name="about" id="about"></a>about</b></p> -<p>Get DS9 credits.</p> -<tt>Syntax:<br> -about<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -about<br></tt> -<p><b><a name="align" id="align"></a>align</b></p> -<p>Controls the World Coordinate System alignment for the current -frame.</p> -<tt>Syntax:<br> -align []<br> - [yes|no]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> align<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> -align yes</tt><br> -<p><b><a name="analysis" id="analysis"></a>analysis</b></p> -<p>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.</p> -<tt>Syntax:<br> -analysis [<task number>]<br> - -[<filename>]<br> - [task <task -number>|<task name>]<br> - [load -<filename>]<br> - [clear]<br> - [clear][load -<filename>]<br> - [message -ok|okcancel|yesno <message>]<br> - [entry -<message>]<br> - -[text]</tt><tt><tt><tt><tt><tt><br></tt></tt> </tt></tt><br> -Example:<br> -string value = ds9.get(string cmd)<br> -analysis<br> -analysis task<br> -analysis entry {Please enter something}<br> -analysis entry okcancel {Hello World}<br> -ds9.set(string cmd)<br> -analysis 0 # invoke first analysis task<br> -analysis task 0<br> -analysis task foobar<br> -analysis task {foo bar}<br> -analysis my.ans<br> -analysis load my.ans<br> -analysis clear<br> -analysis clear load my.ans<br> -analysis message {This is a message}<br> -analysis text {this is text}</tt><tt><tt><br></tt> ds9.set(string -cmd, string url)<br> -analysis load<br> -analysis text</tt><b><br></b> -<p><b><a name="array" id="array"></a>array</b></p> -<p>Load raw data array into current frame.<br></p> -<tt>Syntax:<br> -array [native|little|big]<br> -array [new|mask] + <head> + <meta name="generator" content="HTML Tidy for Mac OS X (vers 31 + October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> + <meta http-equiv="Content-Type" content="text/html; + charset=windows-1252"> + <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux + 2.4.7-10 i686) [Netscape]"> + <title>SAMP</title> + </head> + <body vlink="#551A8B" link="#0000FF" alink="#FF0000"> + <h3><img alt="" src="../sun.gif" width="100" height="98" + align="middle"> SAMP</h3> + <blockquote> + <p>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 + <a href="http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> + <p>The samp implementation for DS9 is based on the <a + href="xpa.html">XPA</a> model with 2 private calls:</p> + <tt>ds9.get<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK (samp.result map)<br> + value + (string) optional<br> + + url (string) optional<br> + ERROR (samp.error map)<br> + + samp.errortxt (string)<br> + <br> + ds9.set<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK<br> + ERROR (samp.error map)<br> + + samp.errortxt (string)<br> + </tt> + <p><tt>ds9.set</tt> maybe called via notification, call and + call/wait. <tt>ds9.get</tt> can only be called via call and + call/wait. Most of the <tt>ds9.get</tt> calls return a value + string, but a few will return a url instead.</p> + <tt><a href="#2mass">2mass</a><br> + <a href="#3d">3d</a><br> + <a href="#about">about</a><br> + <a href="#analysis">analysis</a><br> + <a href="#array">array</a><br> + <a href="#background">background</a><br> + <a href="#backup">backup</a><br> + <a href="#bin">bin</a><br> + <a href="#blink">blink</a><br> + <a href="#block">block</a><br> + <a href="#catalog">catalog</a><br> + <a href="#cd">cd</a><br> + <a href="#cmap">cmap</a><br> + <a href="#colorbar">colorbar</a><br> + <a href="#console">console</a><br> + <a href="#contour">contour</a><br> + <a href="#crop">crop</a><br> + <a href="#crosshair">crosshair</a><br> + <a href="#cube">cube</a><br> + <a href="#cursor">cursor</a><br> + <a href="#data">data</a><br> + <a href="#dsssao">dsssao</a><br> + <a href="#dsseso">dsseso</a><br> + <a href="#dssstsci">dssstsci</a><br> + <a href="#envi">envi</a><br> + <a href="#exit">exit</a><br> + <a href="#export">export</a><br> + <a href="#file">file</a><br> + <a href="#fits">fits</a><br> + <a href="#frame">frame</a><br> + <a href="#gif">gif</a><br> + <a href="#grid">grid</a><br> + <a href="#header">header</a><br> + <a href="#height">height</a><br> + <a href="#iconify">iconify</a><br> + </tt> <tt><tt><a href="#iexam">iexam</a><br> + </tt> <a href="#iis">iis</a><br> + <a href="#jpeg">jpeg</a><br> + <a href="#lock">lock</a><br> + <a href="#lower">lower</a><br> + <a href="#magnifier">magnifier</a><br> + <a href="#mask">mask</a><br> + <a href="#match">match</a><br> + <a href="#mecube">mecube</a><br> + <a href="#minmax">minmax</a><br> + <a href="#mode">mode</a><br> + <a href="#mosaic">mosaic</a><br> + <a href="#mosaicimage">mosaicimage</a><br> + <a href="#movie">movie</a><br> + <a href="#multiframe">multiframe</a><br> + <a href="#nameserver">nameserver</a><br> + <a href="#nan">nan</a><br> + <a href="#nrrd">nrrd</a><br> + <a href="#nvss">nvss</a><br> + <a href="#orient">orient</a><br> + <a href="#pagesetup">pagesetup</a><br> + <a href="#pan">pan</a><br> + <a href="#pixeltable">pixeltable</a><br> + <a href="#plot">plot</a><br> + <a href="#png">png</a><br> + <a href="#precision">precision</a><br> + <a href="#prefs">prefs</a><br> + <a href="#preserve">preserve</a><br> + <a href="#psprint">psprint</a><br> + <a href="#print">print</a><br> + <a href="#exit">quit</a><br> + <a href="#raise">raise</a><br> + <a href="#regions">regions</a><br> + <a href="#restore">restore</a><br> + <a href="#rgb">rgb</a><br> + <a href="#rgbarray">rgbarray</a><br> + <a href="#rgbcube">rgbcube</a><br> + <a href="#rgbimage">rgbimage</a><br> + <a href="#rotate">rotate</a><br> + <a href="#samp">samp</a><br> + <a href="#save">save</a><br> + <a href="#saveimage">saveimage</a><br> + <a href="#scale">scale</a><br> + <a href="#shm">shm</a><br> + </tt> <tt><tt><a href="#sia">sia</a><br> + </tt> <a href="#single">single</a><br> + <a href="#skyview">skyview</a><br> + <a href="#sleep">sleep</a><br> + <a href="#smooth">smooth</a><br> + <a href="#source">source</a><br> + <a href="#tcl">tcl</a><br> + <a href="#threads">threads</a><br> + <a href="#tiff">tiff</a><br> + <a href="#tile">tile</a><br> + <a href="#update">update</a><br> + <a href="#url">url</a><br> + <a href="#version">version</a><br> + <a href="#view">view</a><br> + <a href="#vla">vla</a></tt><br> + <tt><tt><a href="#vlss">vlss</a><br> + </tt> <a href="#vo">vo</a><br> + <a href="#wcs">wcs</a><br> + <a href="#web">web</a><br> + <a href="#width">width</a><br> + <a href="#zscale">zscale</a><br> + <a href="#zoom">zoom</a><br> + </tt> + <p><b><a name="2mass"></a>2mass</b></p> + <p>Support for 2MASS Digital Sky Survey.</p> + <tt>Syntax:<br> + 2mass []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + 2mass name<br> + 2mass coord<br> + 2mass size<br> + 2mass save<br> + 2mass frame<br> + 2mass survey<br> + ds9.set(string cmd)<br> + 2mass<br> + 2mass m31<br> + </tt> <tt><tt>2mass name m31<br> + </tt></tt> + <tt><tt><tt>2mass name clear<br> + </tt></tt> 2mass 00:42:44.404 + +41:16:08.78<br> + 2mass size 60 60 arcmin<br> + 2mass save yes<br> + 2mass frame current<br> + 2mass update frame<br> + 2mass survey j<br> + 2mass open<br> + 2mass close<br> + </tt> + <p><b><a name="3d"></a>3d</b></p> + <p>Support for 3D frame.</p> + <tt>Syntax:<br> + </tt> <tt>3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]</tt><br> + <tt><tt> [background none|azimuth|elevation]<br> + </tt> + </tt><tt> [border yes|no]<br> + [border color <color>]<br> + </tt> <tt> + [highlite yes|no]<br> + [hightlite color <color>]<br> + </tt> + <tt><tt> </tt><tt> [compass yes|no]<br> + [compass color <color>]</tt></tt><br> + <tt><tt><tt><tt><tt> [match]<br> + [lock [yes|no]]<br> + </tt></tt></tt></tt> + [open|close]</tt><tt><br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt> <tt>3d view<br> + 3d az<br> + 3d el<br> + 3d scale<br> + 3d method</tt><br> + <tt>3d background<br> + </tt> <tt>3d border<br> + 3d border color<br> + </tt> <tt>3d highlite<br> + 3d highlite color<br> + </tt> <tt><tt>3d compass<br> + 3d compass color<br> + 3d lock<br> + </tt> ds9.set(string cmd)<br> + </tt> <tt>3d # create new + 3D frame<br> + 3d view 45 30<br> + 3d az 45<br> + 3d el 30<br> + 3d scale 10<br> + 3d method mip</tt><br> + <tt>3d background azimuth<br> + </tt> <tt>3d border yes<br> + 3d border color red<br> + </tt> <tt>3d highlite yes<br> + 3d highlite color red<br> + </tt> <tt><tt>3d compass yes<br> + 3d compass color red<br> + 3d match<br> + 3d lock yes<br> + </tt> 3d open<br> + 3d close</tt><br> + <p><b><a name="about" id="about"></a>about</b></p> + <p>Get DS9 credits.</p> + <tt>Syntax:<br> + about<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + about<br> + </tt> + <p><b><a name="align" id="align"></a>align</b></p> + <p>Controls the World Coordinate System alignment for the current + frame.</p> + <tt>Syntax:<br> + align []<br> + [yes|no]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> align<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> + align yes</tt><br> + <p><b><a name="analysis" id="analysis"></a>analysis</b></p> + <p>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.</p> + <tt>Syntax:<br> + analysis [<task number>]<br> + + [<filename>]<br> + [task <task + number>|<task name>]<br> + [load + <filename>]<br> + [clear]<br> + [clear][load + <filename>]<br> + [message + ok|okcancel|yesno <message>]<br> + [entry + <message>]<br> + + [text]</tt><tt><tt><tt><tt><tt><br> + </tt></tt> </tt></tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + analysis<br> + analysis task<br> + analysis entry {Please enter something}<br> + analysis entry okcancel {Hello World}<br> + ds9.set(string cmd)<br> + analysis 0 # invoke first analysis task<br> + analysis task 0<br> + analysis task foobar<br> + analysis task {foo bar}<br> + analysis my.ans<br> + analysis load my.ans<br> + analysis clear<br> + analysis clear load my.ans<br> + analysis message {This is a message}<br> + analysis text {this is text}</tt><tt><tt><br> + </tt> ds9.set(string + cmd, string url)<br> + analysis load<br> + analysis text</tt><b><br> + </b> + <p><b><a name="array" id="array"></a>array</b></p> + <p>Load raw data array into current frame.<br> + </p> + <tt>Syntax:<br> + array [native|little|big]<br> + array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br></tt> <tt><tt>string url = ds9.get(string cmd)<br></tt> -array<br> -array little<br></tt> <tt><tt>ds9.set(string command, string -url)<br></tt> array foo.arr[dim=512,bitpix=-32,endian=little]<br> -array new -foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> -<tt><tt>array mask -foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> -</tt> -<p><b><a name="background" id="background"></a>bg<br> -background</b></p> -<p>Set image background color.</p> -<tt>Syntax:<br> -bg <color><br> - <br> -Example:<br></tt> <tt>string url = ds9.get(string cmd)</tt><tt><br> -bg<br></tt> <tt>ds9.set(string cmd)<br></tt> <tt>bg -red</tt><tt><br></tt> bg red<br> -<p><b><a name="backup" id="backup"></a>backup</b></p> -<p>Create a backup save set.</p> -<tt>Syntax:<br> -backup <filename><br> - <br> -Example:<br></tt> <tt>ds9.set(string cmd)<br></tt> <tt>backup -ds9.bck</tt><br> -<p><b><a name="bin" id="bin"></a>bin</b></p> -<p>Controls binning factor, binning buffer size, and binning -function for binning FITS bin tables. The access point blocking is -provided for backward compatibility.</p> -<tt>Syntax:<br> -bin [about <x> <y>]<br> - [about center]<br> - [buffersize <value>]<br> - [cols <x> <y>]<br> - [colsz <x> <y> <z>]<br> - [factor <value> [<vector>]]<br> - [depth <value>]<br> - [filter <string>]<br></tt> -<tt><tt> [filter clear]<br></tt> - [function average|sum]<br> - [in]<br> - [out]<br> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -bin about<br> -bin buffersize<br> -bin cols<br> -bin factor<br> -bin depth<br> -bin filter<br> -bin function<br> -bin smooth<br> -bin smooth function<br> -bin smooth radius<br> -bin lock<br> -ds9.set(string cmd)<br> -bin about 4096 4096<br> -bin about center<br> -bin buffersize 512<br> -bin cols detx dety<br> -bin colsz detx dety time<br> -bin factor 4<br> -bin factor 4 2<br> -bin depth 10<br> -bin filter 'pha > 5'<br> -bin filter clear<br> -bin function sum<br> -bin in<br> -bin out<br> -bin to fit<br> -bin match<br> -bin lock yes<br> -bin open<br> -bin close<br></tt> -<p><b><a name="blink" id="blink"></a>blink</b></p> -<p>Blink mode parameters. Interval is in seconds.<br></p> -<tt>Syntax:<br> -blink []<br> - [yes|no]<br> - [interval <value>]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -blink<br> -blink interval<br> -ds9.set(string cmd)<br> -blink<br> -blink yes<br> -blink interval 1</tt><br> -<p><b><a name="block" id="block"></a>block</b></p> -<p>Controls blocking parameters.</p> -<tt>Syntax:<br> -block</tt> <tt><tt>[<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br></tt> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> block<br> -block lock<br></tt> <tt><tt>ds9.set(string cmd)<br></tt></tt> -<tt><tt><tt>block</tt></tt> 4<br></tt> <tt><tt><tt>block</tt></tt> -4 2<br></tt> <tt><tt><tt><tt><tt>block</tt></tt> to 4<br></tt> -<tt><tt><tt>block</tt></tt> to 4 2<br></tt></tt> -<tt><tt><tt>block</tt></tt> in<br></tt></tt> -<tt><tt><tt><tt><tt>block</tt></tt> out<br></tt></tt></tt> -<tt><tt><tt>block</tt></tt> to fit<br></tt> -<tt><tt><tt>block</tt></tt> match<br></tt> -<tt><tt><tt>block</tt></tt> lock yes<br></tt> -<tt><tt><tt>block</tt></tt> open<br></tt> -<tt><tt><tt>block</tt></tt> close</tt><tt><br></tt> -<p><b><a name="catalog" id="catalog"></a>catalog<br> -cat<br></b></p> -<p>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.</p> -<tt>Syntax:<br></tt> <tt>catalog [new]<br> - -[ned|simbad|denis|skybot]<br></tt> -<tt><tt> + <br> + Example:<br> + </tt> <tt><tt>string url = ds9.get(string cmd)<br> + </tt> + array<br> + array little<br> + </tt> <tt><tt>ds9.set(string command, string + url)<br> + </tt> array foo.arr[dim=512,bitpix=-32,endian=little]<br> + array new + foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt><tt>array mask + foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> + </tt> + <p><b><a name="background" id="background"></a>bg<br> + background</b></p> + <p>Set image background color.</p> + <tt>Syntax:<br> + bg <color><br> + <br> + Example:<br> + </tt> <tt>string url = ds9.get(string cmd)</tt><tt><br> + bg<br> + </tt> <tt>ds9.set(string cmd)<br> + </tt> <tt>bg + red</tt><tt><br> + </tt> bg red<br> + <p><b><a name="backup" id="backup"></a>backup</b></p> + <p>Create a backup save set.</p> + <tt>Syntax:<br> + backup <filename><br> + <br> + Example:<br> + </tt> <tt>ds9.set(string cmd)<br> + </tt> <tt>backup + ds9.bck</tt><br> + <p><b><a name="bin" id="bin"></a>bin</b></p> + <p>Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables. The access point blocking + is + provided for backward compatibility.</p> + <tt>Syntax:<br> + bin [about <x> <y>]<br> + [about center]<br> + [buffersize <value>]<br> + [cols <x> <y>]<br> + [colsz <x> <y> <z>]<br> + [factor <value> [<vector>]]<br> + [depth <value>]<br> + [filter <string>]<br> + </tt> + <tt><tt> [filter clear]<br> + </tt> + [function average|sum]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + bin about<br> + bin buffersize<br> + bin cols<br> + bin factor<br> + bin depth<br> + bin filter<br> + bin function<br> + bin smooth<br> + bin smooth function<br> + bin smooth radius<br> + bin lock<br> + ds9.set(string cmd)<br> + bin about 4096 4096<br> + bin about center<br> + bin buffersize 512<br> + bin cols detx dety<br> + bin colsz detx dety time<br> + bin factor 4<br> + bin factor 4 2<br> + bin depth 10<br> + bin filter 'pha > 5'<br> + bin filter clear<br> + bin function sum<br> + bin in<br> + bin out<br> + bin to fit<br> + bin match<br> + bin lock yes<br> + bin open<br> + bin close<br> + </tt> + <p><b><a name="blink" id="blink"></a>blink</b></p> + <p>Blink mode parameters. Interval is in seconds.<br> + </p> + <tt>Syntax:<br> + blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + blink<br> + blink interval<br> + ds9.set(string cmd)<br> + blink<br> + blink yes<br> + blink interval 1</tt><br> + <p><b><a name="block" id="block"></a>block</b></p> + <p>Controls blocking parameters.</p> + <tt>Syntax:<br> + block</tt> <tt><tt>[<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> + <value>]<br> + [in]<br> + [out]<br> + </tt> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> block<br> + block lock<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt></tt> + <tt><tt><tt>block</tt></tt> 4<br> + </tt> <tt><tt><tt>block</tt></tt> + 4 2<br> + </tt> <tt><tt><tt><tt><tt>block</tt></tt> to 4<br> + </tt> + <tt><tt><tt>block</tt></tt> to 4 2<br> + </tt></tt> + <tt><tt><tt>block</tt></tt> in<br> + </tt></tt> + <tt><tt><tt><tt><tt>block</tt></tt> out<br> + </tt></tt></tt> + <tt><tt><tt>block</tt></tt> to fit<br> + </tt> + <tt><tt><tt>block</tt></tt> match<br> + </tt> + <tt><tt><tt>block</tt></tt> lock yes<br> + </tt> + <tt><tt><tt>block</tt></tt> open<br> + </tt> + <tt><tt><tt>block</tt></tt> close</tt><tt><br> + </tt> + <p><b><a name="catalog" id="catalog"></a>catalog<br> + cat<br> + </b></p> + <p>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.</p> + <tt>Syntax:<br> + </tt> <tt>catalog [new]<br> + + [ned|simbad|denis|skybot]<br> + </tt> + <tt><tt> [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - -[</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br></tt></tt> -<tt> [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - -[chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds -<catalogid>]<br> -<br> - [load <filename>]<br> - [import sb|tsv -<filename>]<br> -<br></tt> <tt><tt> -[<ref>] [<ra> <dec> -<coordsys>]</tt><tt><br></tt> - [<ref>] [allcols]<br></tt> -<tt> </tt><tt> [<ref>] -[allrows]<br> - </tt><tt> [<ref>] -[cancel]<br></tt> <tt> -[<ref>] [clear]<br></tt> <tt> -[<ref>] [close]</tt><br> -<tt> </tt> -<tt>[<ref>] [crosshair]</tt><br> -<tt> [<ref>] [dec -<col>]</tt><br> -<tt> [<ref>] [edit -yes|no]</tt><br> -<tt> [<ref>] -[export sb|tsv <filename>]<br></tt> -<tt> [<ref>] -[filter <string>]<br> - [<ref>] [filter load -<filename>]</tt><br> -<tt> [<ref>] -[header]</tt><br> -<tt> [<ref>] [location -<code>]</tt><br> -<tt><tt> [<ref>] -[match]<br></tt></tt> -<tt><tt><tt> -[<ref>] [match <ref> <ref>]<br></tt></tt> - </tt> <tt>[<ref>] -[match error <value> degrees|arcmin|arcsec]</tt><br> -<tt> </tt> -<tt>[<ref>] [match function 1and2|1not2|2not1]<br></tt> -<tt> </tt> -<tt>[<ref>] [match return 1and2|1only|2only]</tt><br> -<tt> </tt> -<tt>[<ref>] [match unique yes|no]</tt><br> -<tt> [<ref>] [maxrows -<number>]</tt><br> -<tt> [<ref>] [name -<object>]<br></tt> -<tt> [<ref>] [panto -yes|no]</tt><br> -<tt> [<ref>] [plot -<xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> -<tt> [<ref>] [print]</tt><br> -<tt> [<ref>] [psky -<skyframe>]</tt><br> -<tt> [<ref>] [psystem -<coordsys>]</tt><br> -<tt> [<ref>] [ra -<col>]</tt><br> -<tt> [<ref>] -[regions]</tt><br> -<tt><tt> [<ref>] -[retrieve]</tt><br> - [<ref>] [samp]<br> - [<ref>] [samp -broadcast]<br> - [<ref>] [samp send -<application>]</tt><tt><br></tt> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] -[server</tt> -<tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> - -<tt> [<ref>] [show -yes|no]</tt><br> -<tt> [<ref>] [radius -<value> degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> - [<ref>] [skyformat -<skyformat>]<br></tt> <tt> - [<ref>] [sort <col> -incr|decr]</tt><br> -<tt> [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>]<br></tt> <tt> -[<ref>] [symbol [#] text|size|size2|units|angle -<value>]<br></tt> <tt><tt> - [<ref>] [symbol shape -circle|ellipse|box|text|point]<br> - </tt></tt> -<tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt>circle point|box point|diamond -point|</tt></tt></tt></tt>cross point|x point|arrow point|boxcircle -point]<br></tt> -[<ref>] [symbol add| [#] remove]<br> - [<ref>] [symbol -save|load <filename>]</tt><br> -<tt> [<ref>] [system -<coordsys>]</tt><tt><br></tt> <tt> - </tt> <tt>[<ref>] [update]</tt><br> -<tt> [<ref>] [x -<col>]</tt><br> -<tt> [<ref>] [y -<col>]</tt><br> -<tt> <br> -Example:<br> -string value = ds9.get(string cmd)<br> -catalog<br> -catalog header<br> -<br> -ds9.set(string cmd)<br></tt> <tt><tt>catalog new<br></tt> catalog -2mass<br> -catalog cds 2mass<br> -catalog cds</tt> <tt>{I/252}</tt><br> -<tt><br></tt> <tt>catalog load foo.xml<br> -catalog import tsv foo.tsv<br> -<br></tt> <tt>catalog allrows<br> -catalog allcols<br></tt> <tt>catalog cancel<br></tt> <tt>catalog -clear<br></tt> <tt>catalog close<br></tt> <tt>catalog coordinate -202.48 47.21 fk5<br></tt> <tt>catalog crosshair<br></tt> -<tt>catalog dec DEC<br></tt> <tt>catalog edit yes<br></tt> -<tt>catalog export tsv bar.tsv<br></tt> <tt>catalog filter -{$Jmag>10}<br> -catalog filter load foo.flt<br> -catalog header<br></tt> <tt>catalog location 500</tt><br> -<tt>catalog match error 2 arcsec<br> -catalog match function 1and2<br> -catalog match unique no<br> -catalog match return 1only<br></tt> <tt>catalog match # last two -catalogs loaded<br></tt> <tt>catalog match 2mass csc<br></tt> -<tt>catalog maxrows 2000<br></tt> <tt>catalog name m51<br> -catalog panto no<br></tt> <tt>catalog plot</tt> <tt>{$Jmag} {$Hmag} -{$e_Jmag} {$e_Hmag}</tt><tt><br></tt> <tt>catalog print</tt><br> -<tt>catalog psky fk5</tt><br> -<tt>catalog psystem wcs</tt><br> -<tt>catalog ra RA</tt><br> -<tt>catalog regions<br></tt> <tt>catalog retrieve<br></tt> -<tt>catalog samp broadcast<br> -catalog samp send aladin<br> -catalog save foo.xml<br></tt> <tt>catalog server sao<br></tt> -<tt>catalog show yes</tt><br> -<tt>catalog radius 1 degrees</tt><br> -<tt>catalog symbol condition</tt> <tt>{$Jmag>15}</tt><br> -<tt>catalog symbol 2 shape</tt> <tt>{boxcircle point}</tt><br> -<tt>catalog symbol color red<br> -catalog symbol font times<br></tt> <tt>catalog symbol fontsize -14<br></tt> <tt>catalog symbol fontweight bold<br></tt> <tt>catalog -symbol fontslant italic<br></tt> <tt>catalog symbol add<br> -catalog symbol 2 remove<br> -catalog symbol load foo.sym<br> -catalog symbol save bar.sym</tt><tt><br> -catalog sky fk5<br> -catalog skyformat degrees<br></tt> <tt>catalog sort {Jmag} -incr<br></tt> <tt>catalog system wcs</tt><tt><br></tt> <tt>catalog -update<br></tt> <tt>catalog x RA<br> -catalog y DEC</tt><br> -<p><b><a name="cd" id="cd"></a>cd</b></p> -<p>Sets/Returns the current working directory.</p> -<tt>Syntax:<br> -cd [<directory>]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -cd<br> -ds9.set(string cmd)<br> -cd /home/mrbill<br></tt> -<p><b><a name="cmap" id="cmap"></a>cmap</b></p> -<p>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.</p> -<tt>Syntax:<br> -cmap [<colormap>]<br> - [file]<br> - [load <filename>]<br> - [save <filename>]<br> - [invert yes|no]<br> - [<constrast> <bias>]<br></tt> -<tt> [tag [load|save] <filename>]<br> - [tag delete]</tt><br> -<tt> [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -cmap<br> -cmap file<br> -cmap invert<br> -cmap value<br></tt> <tt>cmap lock</tt><br> -<tt>ds9.set(string cmd)<br> -cmap Heat<br> -cmap load foo.sao<br> -cmap save bar.sao<br> -cmap invert yes<br> -cmap 5 .5<br></tt> <tt>cmap tag load foo.tag<br> -cmap tag save foo.tag<br> -cmap tag delete</tt><br> -<tt>cmap open<br> -cmap close<br></tt> -<p><b><a name="colorbar" id="colorbar"></a>colorbar</b></p> -<p>Controls colorbar parameters.</p> -<tt>Syntax:<br> -colorbar []<br> - [yes|no]<br> - [orientation]<br> - -[horizontal|vertical]<br> - [numerics -yes|no]<br> - [space -value|distance]<br> - [font -times|helvetica|courier]<br> - [fontsize -<value>]<br> - [fontweight -normal|bold]<br> - [fontslant -roman|italic]<br> - [size]<br> - [ticks]</tt><br> -<tt><tt> -[match]<br> - [lock -[yes|no]]</tt><br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -colorbar<br> -colorbar orientation<br> -colorbar numerics<br> -colorbar space<br> -colorbar font<br> -colorbar fontsize<br> -colorbar fontweight<br> -colorbar fontslant<br> -colorbar size<br> -colorbar ticks<br> -ds9.set(string cmd)<br> -colorbar yes<br> -colorbar vertical<br> -colorbar numerics yes<br> -colorbar space value<br> -colorbar font times<br> -colorbar fontsize 14<br> -colorbar fontwieght bold<br> -colorbar fontslant italic<br> -colorbar size 20<br> -colorbar ticks 11</tt><br> -<tt>colorbar match<br> -colorbar lock yes</tt><br> -<p><b><a name="console" id="console"></a>console</b></p> -<p>Display tcl console window.</p> -<tt>Syntax:<br> --console<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -console<br></tt> -<p><b><a name="contour" id="contour"></a>contour</b></p> -<p>Controls contours in the current frame.</p> -<tt>Syntax:<br> -contour []<br> - [yes|no]<br> - [<coordsys> -[<skyframe>]]<br> - [clear]<br> - [generate]<br> - [load -<filename>]<br> - [save <filename> -[<coordsys> <skyframe>]]<br> - [convert]<br></tt> -<tt><tt> [load levels -<filename>]<br></tt></tt> -<tt><tt><tt> [save levels -<filename>]<br></tt></tt> - [copy]<br> - [paste [<coordsys> -<color> <width> yes|no]]<br> - [color <color>]<br> - [width <width>]<br> - [dash yes|no]<br> - [smooth <smooth>]<br> - [method block|smooth]<br> - [nlevels <number of -levels>]<br> - [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> - ]scale log exp -<value>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope global|local]<br> - [limits <min> -<max>]<br> - [levels <value value -value...>]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -contour<br> -contour color<br> -contour width<br> -contour dash<br> -contour smooth<br> -contour method<br> -contour nlevels<br> -contour scale<br> -contour log exp<br> -contour mode<br> -contour scope<br> -contour limits<br> -contour levels<br> -string url = ds9.get(string cmd)<br> -contour wcs fk5<br> -ds9.set(string cmd)<br> -contour<br> -contour yes<br> -contour clear<br> -contour generate<br> -contour load ds9.ctr<br></tt> <tt><tt>contour save -ds9.con<br></tt></tt> <tt><tt><tt>contour save ds9.con wcs -fk5<br></tt></tt> contour convert<br></tt> <tt><tt>contour load -levels ds9.ctr<br></tt></tt> <tt><tt><tt>contour save levels -ds9.lev<br></tt></tt> contour copy<br></tt> <tt><tt>contour -paste<br></tt></tt> <tt><tt><tt>contour paste wcs red 2 -no<br></tt></tt> contour color yellow<br> -contour width 2<br> -contour dash yes<br> -contour smooth 5<br> -contour method smooth<br> -contour nlevels 10<br> -contour scale sqrt<br> -contour log exp 1000<br> -contour mode zscale<br> -contour scope local<br> -contour limits 1 100<br> -contour levels {1 10 100 1000}<br> -contour open<br> -contour close<br></tt> -<p><b><a name="crop" id="crop"></a>crop</b></p> -<p>Set current image display area.</p> -<tt>Syntax:<br> -crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br></tt> -<tt> [match <coordsys>]<br> - [lock -<coordsys>|none]</tt><tt><br> - [reset]<br> - [3d</tt> <tt><tt>zmin zmax -<coordsys>]<br> - [open|close]</tt><br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br></tt> <tt>crop # get crop in -physical coords<br></tt> <tt>crop wcs galactic sexagesimal -arcsec<br> -crop lock<br></tt> <tt>ds9.set(string cmd)</tt><br> -<tt>crop 40 30 10 20 # set crop in physical coords<br> -crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs -galactic arcsec<br> -crop match wcs<br> -crop lock wcs<br> -crop reset<br> -crop 3d .25 .5 wcs<br> -crop open<br> -crop close<br></tt> -<p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> -<p>Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set.</p> -<tt>Syntax:<br> -crosshair [<x> <y> <coordsys> -[<skyframe>]]<br></tt> -<tt> [match -<coordsys>]<br> - [lock -<coordsys>|none]</tt><br> -<tt> <br> -Example:<br> -string value = ds9.get(string cmd)<br> -crosshair # get crosshair in physical coords<br> -crosshair wcs fk4 sexagesimal # get crosshair in wcs coords<br> -crosshair lock<br> -ds9.set(string cmd)<br> -crosshair 100 100 physical # set crosshair in physical<br> -crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords<br> -crosshair 23:01:00 +58:52:51 wcs fk5<br> -crosshair match wcs<br> -crosshair lock wcs<br></tt> -<p><b><a name="cube" id="cube"></a>cube<br></b></p> -<p>Controls FITS cube.</p> -<tt>Syntax:<br> -cube []<br> - [play|stop|next|prev|first|last]<br> - [<slice> -[<coordsys>][<axis>]]<br> - [interval <numeric>]<br></tt> -<tt> [match <coordsys>]<br> - [lock <coordsys>|none]</tt><br> -<tt> [order 123|132|213|231|312|321]<br> - [axes lock [yes|no]]</tt><br> -<tt> [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -cube<br> -cube interval<br> -cube lock<br> -cube order<br> -cube axes lock<br> -ds9.set(string cmd)<br> -cube<br> -cube play<br> -cube last<br> -cube 3<br> -cube 4.5 wcs 3<br> -cube interval 2<br> -cube match wcs<br> -cube lock wcs<br> -cube order 123<br> -cube axes lock yes<br> -cube open<br> -cube close</tt><br> -<p><b><a name="cursor" id="cursor"></a>cursor</b></p> -<p>Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also.</p> -<tt>Syntax:<br> -cursor [<x> <y>]<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -cursor 10 10<br></tt> -<p><b><a name="data" id="data"></a>data</b></p> -<p>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.<br></p> -<tt>Syntax:<br> -data [<coordsys> [<skyframe>] <x> <y> -<width> <height> [yes|no]]<br> - <br> -Example:<br> -string url = ds9.get(string cmd)<br> -data image 450 520 3 3 yes<br> -data physical 899 1039 6 6 no<br> -data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> -data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 -no</tt><tt><br></tt> -<p><b><a name="dsssao" id="dsssao"></a>dsssao<br> -dss<br></b></p> -<p>Support for Digital Sky Survey at SAO.</p> -<tt>Syntax:<br> -dsssao []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -dsssao name<br> -dsssao coord<br> -dsssao size<br> -dsssao save<br> -dsssao frame<br> -ds9.set(string cmd)<br> -dsssao<br> -dsssao m31<br></tt> <tt><tt>dsssao name m31<br></tt></tt> -<tt><tt><tt>dsssao name clear<br></tt></tt> dsssao 00:42:44.404 -+41:16:08.78<br> -dsssao size 60 60 arcmin<br> -dsssao save yes<br> -dsssao frame current<br> -dsssao update frame<br> -dsssao open<br> -dsssao close<br></tt> -<p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> -<p>Support for Digital Sky Survey at ESO.</p> -<tt>Syntax:<br> -dsseso []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -dsseso name<br> -dsseso coord<br> -dsseso size<br> -dsseso save<br> -dsseso frame<br> -dsseso survey<br> -ds9.set(string cmd)<br> -dsseso<br> -dsseso m31<br></tt> <tt><tt>dsseso name m31<br></tt></tt> -<tt><tt><tt>dsseso name clear<br></tt></tt> dsseso 00:42:44.404 -+41:16:08.78<br> -dsseso size 60 60 arcmin<br> -dsseso save yes<br> -dsseso frame current<br> -dsseso update frame<br> -dsseso survey DSS2-red<br> -dsseso open<br> -dsseso close<br></tt> -<p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> -<p>Support for Digital Sky Survey at STSCI.</p> -<tt>Syntax:<br> -dssstsci []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> -<dec>] # in wcs fk5<br> - [size -<width> <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame -new|current]<br> - [update -frame|crosshair]<br> - [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> - [survey -poss1_blue|poss1_red]<br> - [survey -all|quickv|phase2_gsc2|phase2_gsc1]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -dssstsci name<br> -dssstsci coord<br> -dssstsci size<br> -dssstsci save<br> -dssstsci frame<br> -dssstsci survey<br> -ds9.set(string cmd)<br> -dssstsci<br> -dssstsci m31<br></tt> <tt><tt>dssstsci name m31<br></tt></tt> -<tt><tt><tt>dssstsci name clear<br></tt></tt> dssstsci 00:42:44.404 -+41:16:08.78<br> -dssstsci size 60 60 arcmin<br> -dssstsci save yes<br> -dssstsci frame current<br> -dssstsci update frame<br> -dssstsci survey all<br> -dssstsci open<br> -dssstsci close</tt><br> -<p><b><a name="envi" id="envi"></a>envi</b></p> -<p>Load an ENVI header and file. Optional parameter: array -endian.<br></p> -<tt>Syntax:<br> -envi [new] <header> [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>envi foo.hdr</tt></tt><br> -<tt><tt>envi new foo.hdr</tt></tt><br> -<tt><tt><tt><tt><tt><tt>envi foo.hdr foo.bsq</tt></tt><br> -<br></tt></tt></tt></tt> <b><a name="exit" id= -"exit"></a>exit</b><br> -<p><b>quit<br></b></p> -<p>Quits DS9.</p> -<tt>Syntax:<br> -exit<br> -quit<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -exit</tt><br> -<p><b><a name="export" id="export"></a>export<br></b></p> -<p>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.</p> -<tt>Syntax:</tt> <tt><br></tt> <tt>export</tt> -<tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> -<tt><filename></tt><tt><br></tt> <tt>export array -<filename></tt> -<tt>[big|little</tt><tt>|native]</tt><tt><br></tt> <tt>export nrrd -<filename></tt> <tt>[big|little</tt><tt>|native]</tt><br> -<tt>export envi <header> [<filename>]</tt> -<tt>[big|little</tt><tt>|native]</tt><tt><br></tt> <tt>export jpeg -<filename></tt> <tt>[1-100]</tt><tt><br></tt> <tt>export tiff -<filename</tt><tt>></tt> -<tt>[none|jpeg|packbits|deflate]</tt><br> -<tt> <br> -Example:<br></tt> <tt><tt><tt>ds9.set (string cmd)<br></tt> export -array foo.arr little</tt></tt><br> -<tt><tt>export nrrd foo.nrrd little<br> -export envi foo.hdr little<br> -export envi foo.hdr foo.bsq little<br></tt></tt> -<tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> -export jpeg foo.jpeg 75<br> -export png foo.png</tt><br> -<p><b><a name="file" id="file"></a>file</b></p> -<p>Query currently loaded file information.</p> -<tt>Syntax:<br> -file<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -file</tt><tt><br></tt> -<p><b><a name="fits" id="fits"></a>fits</b></p> -<p>Load a FITS image into the current frame or query the currently -loaded image.<br></p> -<tt>Syntax:<br> -fits</tt> <tt><tt>[new|mask|slice] -[<filename>]</tt><tt><br></tt> -[width|height|depth|bitpix|type]<br> - [size [wcs|wcsa...wcsz] -[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword -<string>]]<br> - [image|table|slice]</tt><tt><br> - <br> -Example:</tt><br> -<tt><tt>string value = ds9.get(string cmd)</tt><br> -fits<br> -fits width<br> -fits height<br> -fits depth<br> -fits bitpix</tt><br> -<tt>fits type</tt><br> -<tt><tt>fits size<br></tt> fits size wcs fk5 arcmin<br> -fits header # primary<br> -fits header 2 # hdu 2<br> -fits header -2 # hdu 2 with inherit<br> -fits header keyword BITPIX<br> -fits header 1 keyword BITPIX</tt><br> -<tt><tt>fits image<br> -fits table</tt></tt><tt><br> -fits slice<br> -ds9.set(string cmd, string url)</tt><tt><tt><br></tt> fits -foo.fits<br> -fits new foo.fits<br> -fits bar.fits[bin=detx,dety]<br> -fits slice foo.fits<br> -fits mask foo.fits<br> -fits<br> -fits new<br> -fits -[bin=detx,dety]<br> -fits slice<br> -fits mask</tt> -<p>Syntax:<br></p> -<tt><tt>fits</tt> <tt><tt>[new|mask|slice] -[<filename>]</tt><tt><br></tt> -[width|height|depth|bitpix]<br> - [size [wcs|wcsa...wcsz] -[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword -<string>]]<br> - [image|table|slice]</tt><tt><br> - </tt><br> -Example:<br> -string value = ds9.get(string cmd)<br></tt> <tt><tt>fits width<br> -fits height<br> -fits depth<br> -fits bitpix</tt><br> -<tt><tt>fits size<br></tt> fits size wcs fk5 arcmin<br> -fits header # primary<br> -fits header 2 # hdu 2<br> -fits header -2 # hdu 2 with inherit<br> -fits header keyword BITPIX<br> -fits header 1 keyword BITPIX</tt><br> -fits<br> -fits image<br></tt> <tt><tt>fits table<br></tt></tt> -<tt><tt><tt>fits slice<br></tt></tt> ds9.set(string cmd, string -url)</tt><tt><br> -fits foo.fits<br> -fits new foo.fits<br> -fits bar.fits[bin=detx,dety]<br> -fits slice foo.fits<br> -fits mask foo.fits<br> -<br></tt> <b><a name="frame" id="frame"></a>frame</b> -<p>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.</p> -<tt>Syntax:<br> -frame [center [#|all]]<br> - [clear [#|all]]<br> - [new [rgb|3d]]<br> - [delete [#|all]]<br> - [reset [#|all]]<br> - [refresh [#|all]]<br> - [hide [#|all]]<br> - [show [#|all]]<br> - [move first]<br> - [move back]<br> - [move forward]<br> - [move last]<br> - [first]<br> - [prev]<br> - [next]<br> - [last]<br> - [frameno #]<br> - [#]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [has + + [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> + </tt></tt> + <tt> [2mass|iras]<br> + [csc|xmm|rosat]<br> + [first|nvss]<br> + + [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> + [cds <catalogname>]<br> + [cds + <catalogid>]<br> + <br> + [load <filename>]<br> + [import sb|tsv + <filename>]<br> + <br> + </tt> <tt><tt> + [<ref>] [<ra> <dec> + <coordsys>]</tt><tt><br> + </tt> + [<ref>] [allcols]<br> + </tt> + <tt> </tt><tt> [<ref>] + [allrows]<br> + </tt><tt> [<ref>] + [cancel]<br> + </tt> <tt> + [<ref>] [clear]<br> + </tt> <tt> + [<ref>] [close]</tt><br> + <tt> </tt> + <tt>[<ref>] [crosshair]</tt><br> + <tt> [<ref>] [dec + <col>]</tt><br> + <tt> [<ref>] [edit + yes|no]</tt><br> + <tt> [<ref>] + [export sb|tsv <filename>]<br> + </tt> + <tt> [<ref>] + [filter <string>]<br> + [<ref>] [filter load + <filename>]</tt><br> + <tt> [<ref>] + [header]</tt><br> + <tt> [<ref>] [location + <code>]</tt><br> + <tt><tt> [<ref>] + [match]<br> + </tt></tt> + <tt><tt><tt> + [<ref>] [match <ref> <ref>]<br> + </tt></tt> + </tt> <tt>[<ref>] +[match + error <value> degrees|arcmin|arcsec]</tt><br> + <tt> </tt> + <tt>[<ref>] [match function 1and2|1not2|2not1]<br> + </tt> + <tt> </tt> + <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> + <tt> </tt> + <tt>[<ref>] [match unique yes|no]</tt><br> + <tt> [<ref>] [maxrows + <number>]</tt><br> + <tt> [<ref>] [name + <object>]<br> + </tt> + <tt> [<ref>] + [panto + yes|no]</tt><br> + <tt> [<ref>] [plot + <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> + <tt> [<ref>] [print]</tt><br> + <tt> [<ref>] [psky + <skyframe>]</tt><br> + <tt> [<ref>] [psystem + <coordsys>]</tt><br> + <tt> [<ref>] [ra + <col>]</tt><br> + <tt> [<ref>] + [regions]</tt><br> + <tt><tt> [<ref>] + [retrieve]</tt><br> + [<ref>] [samp]<br> + [<ref>] [samp + broadcast]<br> + [<ref>] [samp + send + <application>]</tt><tt><br> + </tt> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] + [server</tt> + <tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> + <tt> [<ref>] [show + yes|no]</tt><br> + <tt> [<ref>] [radius + <value> degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> + [<ref>] [skyformat + <skyformat>]<br> + </tt> <tt> + [<ref>] [sort <col> + incr|decr]</tt><br> + <tt> [<ref>] [symbol + [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>]<br> + </tt> <tt> + [<ref>] [symbol [#] text|size|size2|units|angle + <value>]<br> + </tt> <tt><tt> + [<ref>] [symbol shape + circle|ellipse|box|text|point]<br> + </tt></tt> + <tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt>circle point|box point|diamond + point|</tt></tt></tt></tt>cross point|x point|arrow + point|boxcircle + point]<br> + </tt> + [<ref>] [symbol add| [#] remove]<br> + [<ref>] [symbol + save|load <filename>]</tt><br> + <tt> [<ref>] [system + <coordsys>]</tt><tt><br> + </tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> + <tt> [<ref>] [x + <col>]</tt><br> + <tt> [<ref>] [y + <col>]</tt><br> + <tt> <br> + Example:<br> + string value = ds9.get(string cmd)<br> + catalog<br> + catalog header<br> + <br> + ds9.set(string cmd)<br> + </tt> <tt><tt>catalog new<br> + </tt> catalog + 2mass<br> + catalog cds 2mass<br> + catalog cds</tt> <tt>{I/252}</tt><br> + <tt><br> + </tt> <tt>catalog load foo.xml<br> + catalog import tsv foo.tsv<br> + <br> + </tt> <tt>catalog allrows<br> + catalog allcols<br> + </tt> <tt>catalog cancel<br> + </tt> <tt>catalog + clear<br> + </tt> <tt>catalog close<br> + </tt> <tt>catalog coordinate + 202.48 47.21 fk5<br> + </tt> <tt>catalog crosshair<br> + </tt> + <tt>catalog dec DEC<br> + </tt> <tt>catalog edit yes<br> + </tt> + <tt>catalog export tsv bar.tsv<br> + </tt> <tt>catalog filter + {$Jmag>10}<br> + catalog filter load foo.flt<br> + catalog header<br> + </tt> <tt>catalog location 500</tt><br> + <tt>catalog match error 2 arcsec<br> + catalog match function 1and2<br> + catalog match unique no<br> + catalog match return 1only<br> + </tt> <tt>catalog match # last two + catalogs loaded<br> + </tt> <tt>catalog match 2mass csc<br> + </tt> + <tt>catalog maxrows 2000<br> + </tt> <tt>catalog name m51<br> + catalog panto no<br> + </tt> <tt>catalog plot</tt> <tt>{$Jmag} {$Hmag} + {$e_Jmag} {$e_Hmag}</tt><tt><br> + </tt> <tt>catalog print</tt><br> + <tt>catalog psky fk5</tt><br> + <tt>catalog psystem wcs</tt><br> + <tt>catalog ra RA</tt><br> + <tt>catalog regions<br> + </tt> <tt>catalog retrieve<br> + </tt> + <tt>catalog samp broadcast<br> + catalog samp send aladin<br> + catalog save foo.xml<br> + </tt> <tt>catalog server sao<br> + </tt> + <tt>catalog show yes</tt><br> + <tt>catalog radius 1 degrees</tt><br> + <tt>catalog symbol condition</tt> <tt>{$Jmag>15}</tt><br> + <tt>catalog symbol 2 shape</tt> <tt>{boxcircle point}</tt><br> + <tt>catalog symbol color red<br> + catalog symbol font times<br> + </tt> <tt>catalog symbol fontsize + 14<br> + </tt> <tt>catalog symbol fontweight bold<br> + </tt> <tt>catalog + symbol fontslant italic<br> + </tt> <tt>catalog symbol add<br> + catalog symbol 2 remove<br> + catalog symbol load foo.sym<br> + catalog symbol save bar.sym</tt><tt><br> + catalog sky fk5<br> + catalog skyformat degrees<br> + </tt> <tt>catalog sort {Jmag} + incr<br> + </tt> <tt>catalog system wcs</tt><tt><br> + </tt> <tt>catalog + update<br> + </tt> <tt>catalog x RA<br> + catalog y DEC</tt><br> + <p><b><a name="cd" id="cd"></a>cd</b></p> + <p>Sets/Returns the current working directory.</p> + <tt>Syntax:<br> + cd [<directory>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + cd<br> + ds9.set(string cmd)<br> + cd /home/mrbill<br> + </tt> + <p><b><a name="cmap" id="cmap"></a>cmap</b></p> + <p>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.</p> + <tt>Syntax:<br> + cmap [<colormap>]<br> + [file]<br> + [load <filename>]<br> + [save <filename>]<br> + [invert yes|no]<br> + [<constrast> <bias>]<br> + </tt> + <tt> [tag [load|save] <filename>]<br> + [tag delete]</tt><br> + <tt> [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + cmap<br> + cmap file<br> + cmap invert<br> + cmap value<br> + </tt> <tt>cmap lock</tt><br> + <tt>ds9.set(string cmd)<br> + cmap Heat<br> + cmap load foo.sao<br> + cmap save bar.sao<br> + cmap invert yes<br> + cmap 5 .5<br> + </tt> <tt>cmap tag load foo.tag<br> + cmap tag save foo.tag<br> + cmap tag delete</tt><br> + <tt>cmap open<br> + cmap close<br> + </tt> + <p><b><a name="colorbar" id="colorbar"></a>colorbar</b></p> + <p>Controls colorbar parameters.</p> + <tt>Syntax:<br> + colorbar []<br> + [yes|no]<br> + [orientation]<br> + + [horizontal|vertical]<br> + [numerics + yes|no]<br> + [space + value|distance]<br> + [font + times|helvetica|courier]<br> + [fontsize + <value>]<br> + [fontweight + normal|bold]<br> + [fontslant + roman|italic]<br> + [size]<br> + [ticks]</tt><br> + <tt><tt> + [match]<br> + [lock + [yes|no]]</tt><br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + colorbar<br> + colorbar orientation<br> + colorbar numerics<br> + colorbar space<br> + colorbar font<br> + colorbar fontsize<br> + colorbar fontweight<br> + colorbar fontslant<br> + colorbar size<br> + colorbar ticks<br> + ds9.set(string cmd)<br> + colorbar yes<br> + colorbar vertical<br> + colorbar numerics yes<br> + colorbar space value<br> + colorbar font times<br> + colorbar fontsize 14<br> + colorbar fontwieght bold<br> + colorbar fontslant italic<br> + colorbar size 20<br> + colorbar ticks 11</tt><br> + <tt>colorbar match<br> + colorbar lock yes</tt><br> + <p><b><a name="console" id="console"></a>console</b></p> + <p>Display tcl console window.</p> + <tt>Syntax:<br> + -console<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + console<br> + </tt> + <p><b><a name="contour" id="contour"></a>contour</b></p> + <p>Controls contours in the current frame.</p> + <tt>Syntax:<br> + contour []<br> + [yes|no]<br> + [<coordsys> + [<skyframe>]]<br> + [clear]<br> + [generate]<br> + [load + <filename>]<br> + [save <filename> + [<coordsys> <skyframe>]]<br> + [convert]<br> + </tt> + <tt><tt> [load levels + <filename>]<br> + </tt></tt> + <tt><tt><tt> [save + levels + <filename>]<br> + </tt></tt> + [copy]<br> + [paste + [<coordsys> + <color> <width> yes|no]]<br> + [color <color>]<br> + [width <width>]<br> + [dash yes|no]<br> + [smooth <smooth>]<br> + [method block|smooth]<br> + [nlevels <number of + levels>]<br> + [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + ]scale log exp + <value>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope global|local]<br> + [limits <min> + <max>]<br> + [levels <value + value + value...>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + contour<br> + contour color<br> + contour width<br> + contour dash<br> + contour smooth<br> + contour method<br> + contour nlevels<br> + contour scale<br> + contour log exp<br> + contour mode<br> + contour scope<br> + contour limits<br> + contour levels<br> + string url = ds9.get(string cmd)<br> + contour wcs fk5<br> + ds9.set(string cmd)<br> + contour<br> + contour yes<br> + contour clear<br> + contour generate<br> + contour load ds9.ctr<br> + </tt> <tt><tt>contour save + ds9.con<br> + </tt></tt> <tt><tt><tt>contour save ds9.con wcs + fk5<br> + </tt></tt> contour convert<br> + </tt> <tt><tt>contour load + levels ds9.ctr<br> + </tt></tt> <tt><tt><tt>contour save levels + ds9.lev<br> + </tt></tt> contour copy<br> + </tt> <tt><tt>contour + paste<br> + </tt></tt> <tt><tt><tt>contour paste wcs red 2 + no<br> + </tt></tt> contour color yellow<br> + contour width 2<br> + contour dash yes<br> + contour smooth 5<br> + contour method smooth<br> + contour nlevels 10<br> + contour scale sqrt<br> + contour log exp 1000<br> + contour mode zscale<br> + contour scope local<br> + contour limits 1 100<br> + contour levels {1 10 100 1000}<br> + contour open<br> + contour close<br> + </tt> + <p><b><a name="crop" id="crop"></a>crop</b></p> + <p>Set current image display area.</p> + <tt>Syntax:<br> + crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> + </tt> + <tt> [match <coordsys>]<br> + [lock + <coordsys>|none]</tt><tt><br> + [reset]<br> + [3d</tt> <tt><tt>zmin zmax + <coordsys>]<br> + [open|close]</tt><br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt> <tt>crop # get crop in + physical coords<br> + </tt> <tt>crop wcs galactic sexagesimal + arcsec<br> + crop lock<br> + </tt> <tt>ds9.set(string cmd)</tt><br> + <tt>crop 40 30 10 20 # set crop in physical coords<br> + crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs + galactic arcsec<br> + crop match wcs<br> + crop lock wcs<br> + crop reset<br> + crop 3d .25 .5 wcs<br> + crop open<br> + crop close<br> + </tt> + <p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> + <p>Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set.</p> + <tt>Syntax:<br> + crosshair [<x> <y> <coordsys> + [<skyframe>]]<br> + </tt> + <tt> [match + <coordsys>]<br> + [lock + <coordsys>|none]</tt><br> + <tt> <br> + Example:<br> + string value = ds9.get(string cmd)<br> + crosshair # get crosshair in physical coords<br> + crosshair wcs fk4 sexagesimal # get crosshair in wcs coords<br> + crosshair lock<br> + ds9.set(string cmd)<br> + crosshair 100 100 physical # set crosshair in physical<br> + crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords<br> + crosshair 23:01:00 +58:52:51 wcs fk5<br> + crosshair match wcs<br> + crosshair lock wcs<br> + </tt> + <p><b><a name="cube" id="cube"></a>cube<br> + </b></p> + <p>Controls FITS cube.</p> + <tt>Syntax:<br> + cube []<br> + [play|stop|next|prev|first|last]<br> + [<slice> + [<coordsys>][<axis>]]<br> + [interval <numeric>]<br> + </tt> + <tt> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><br> + <tt> [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]</tt><br> + <tt> [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + cube<br> + cube interval<br> + cube lock<br> + cube order<br> + cube axes lock<br> + ds9.set(string cmd)<br> + cube<br> + cube play<br> + cube last<br> + cube 3<br> + cube 4.5 wcs 3<br> + cube interval 2<br> + cube match wcs<br> + cube lock wcs<br> + cube order 123<br> + cube axes lock yes<br> + cube open<br> + cube close</tt><br> + <p><b><a name="cursor" id="cursor"></a>cursor</b></p> + <p>Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also.</p> + <tt>Syntax:<br> + cursor [<x> <y>]<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + cursor 10 10<br> + </tt> + <p><b><a name="data" id="data"></a>data</b></p> + <p>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.<br> + </p> + <tt>Syntax:<br> + data [<coordsys> [<skyframe>] <x> <y> + <width> <height> [yes|no]]<br> + <br> + Example:<br> + string url = ds9.get(string cmd)<br> + data image 450 520 3 3 yes<br> + data physical 899 1039 6 6 no<br> + data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> + data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 + 0.00016516669 + no</tt><tt><br> + </tt> + <p><b><a name="dsssao" id="dsssao"></a>dsssao<br> + dss<br> + </b></p> + <p>Support for Digital Sky Survey at SAO.</p> + <tt>Syntax:<br> + dsssao []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dsssao name<br> + dsssao coord<br> + dsssao size<br> + dsssao save<br> + dsssao frame<br> + ds9.set(string cmd)<br> + dsssao<br> + dsssao m31<br> + </tt> <tt><tt>dsssao name m31<br> + </tt></tt> + <tt><tt><tt>dsssao name clear<br> + </tt></tt> dsssao 00:42:44.404 + +41:16:08.78<br> + dsssao size 60 60 arcmin<br> + dsssao save yes<br> + dsssao frame current<br> + dsssao update frame<br> + dsssao open<br> + dsssao close<br> + </tt> + <p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> + <p>Support for Digital Sky Survey at ESO.</p> + <tt>Syntax:<br> + dsseso []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dsseso name<br> + dsseso coord<br> + dsseso size<br> + dsseso save<br> + dsseso frame<br> + dsseso survey<br> + ds9.set(string cmd)<br> + dsseso<br> + dsseso m31<br> + </tt> <tt><tt>dsseso name m31<br> + </tt></tt> + <tt><tt><tt>dsseso name clear<br> + </tt></tt> dsseso 00:42:44.404 + +41:16:08.78<br> + dsseso size 60 60 arcmin<br> + dsseso save yes<br> + dsseso frame current<br> + dsseso update frame<br> + dsseso survey DSS2-red<br> + dsseso open<br> + dsseso close<br> + </tt> + <p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> + <p>Support for Digital Sky Survey at STSCI.</p> + <tt>Syntax:<br> + dssstsci []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> + <dec>] # in wcs fk5<br> + [size + <width> <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame + new|current]<br> + [update + frame|crosshair]<br> + [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> + [survey + poss1_blue|poss1_red]<br> + [survey + all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dssstsci name<br> + dssstsci coord<br> + dssstsci size<br> + dssstsci save<br> + dssstsci frame<br> + dssstsci survey<br> + ds9.set(string cmd)<br> + dssstsci<br> + dssstsci m31<br> + </tt> <tt><tt>dssstsci name m31<br> + </tt></tt> + <tt><tt><tt>dssstsci name clear<br> + </tt></tt> dssstsci 00:42:44.404 + +41:16:08.78<br> + dssstsci size 60 60 arcmin<br> + dssstsci save yes<br> + dssstsci frame current<br> + dssstsci update frame<br> + dssstsci survey all<br> + dssstsci open<br> + dssstsci close</tt><br> + <p><b><a name="envi" id="envi"></a>envi</b></p> + <p>Load an ENVI header and file. Optional parameter: array + endian.<br> + </p> + <tt>Syntax:<br> + envi [new] <header> [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>envi foo.hdr</tt></tt><br> + <tt><tt>envi new foo.hdr</tt></tt><br> + <tt><tt><tt><tt><tt><tt>envi foo.hdr foo.bsq</tt></tt><br> + <br> + </tt></tt></tt></tt> <b><a name="exit" id="exit"></a>exit</b><br> + <p><b>quit<br> + </b></p> + <p>Quits DS9.</p> + <tt>Syntax:<br> + exit<br> + quit<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + exit</tt><br> + <p><b><a name="export" id="export"></a>export<br> + </b></p> + <p>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.</p> + <tt>Syntax:</tt> <tt><br> + </tt> <tt>export</tt> + <tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> + <tt><filename></tt><tt><br> + </tt> <tt>export array + <filename></tt> + <tt>[big|little</tt><tt>|native]</tt><tt><br> + </tt> <tt>export nrrd + <filename></tt> <tt>[big|little</tt><tt>|native]</tt><br> + <tt>export envi <header> [<filename>]</tt> + <tt>[big|little</tt><tt>|native]</tt><tt><br> + </tt> <tt>export jpeg + <filename></tt> <tt>[1-100]</tt><tt><br> + </tt> <tt>export tiff + <filename</tt><tt>></tt> + <tt>[none|jpeg|packbits|deflate]</tt><br> + <tt> <br> + Example:<br> + </tt> <tt><tt><tt>ds9.set (string cmd)<br> + </tt> export + array foo.arr little</tt></tt><br> + <tt><tt>export nrrd foo.nrrd little<br> + export envi foo.hdr little<br> + export envi foo.hdr foo.bsq little<br> + </tt></tt> + <tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> + export jpeg foo.jpeg 75<br> + export png foo.png</tt><br> + <p><b><a name="file" id="file"></a>file</b></p> + <p>Query currently loaded file information.</p> + <tt>Syntax:<br> + file<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + file</tt><tt><br> + </tt> + <p><b><a name="fits" id="fits"></a>fits</b></p> + <p>Load a FITS image into the current frame or query the currently + loaded image.<br> + </p> + <tt>Syntax:<br> + fits</tt> <tt><tt>[new|mask|slice] + [<filename>]</tt><tt><br> + </tt> + [width|height|depth|bitpix|type]<br> + [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword + <string>]]<br> + [image|table|slice]</tt><tt><br> + <br> + Example:</tt><br> + <tt><tt>string value = ds9.get(string cmd)</tt><br> + fits<br> + fits width<br> + fits height<br> + fits depth<br> + fits bitpix</tt><br> + <tt>fits type</tt><br> + <tt><tt>fits size<br> + </tt> fits size wcs fk5 arcmin<br> + fits header # primary<br> + fits header 2 # hdu 2<br> + fits header -2 # hdu 2 with inherit<br> + fits header keyword BITPIX<br> + fits header 1 keyword BITPIX</tt><br> + <tt><tt>fits image<br> + fits table</tt></tt><tt><br> + fits slice<br> + ds9.set(string cmd, string url)</tt><tt><tt><br> + </tt> fits + foo.fits<br> + fits new foo.fits<br> + fits bar.fits[bin=detx,dety]<br> + fits slice foo.fits<br> + fits mask foo.fits<br> + fits<br> + fits new<br> + fits -[bin=detx,dety]<br> + fits slice<br> + fits mask</tt> + <p>Syntax:<br> + </p> + <tt><tt>fits</tt> <tt><tt>[new|mask|slice] + [<filename>]</tt><tt><br> + </tt> + [width|height|depth|bitpix]<br> + [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword + <string>]]<br> + [image|table|slice]</tt><tt><br> + </tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt> <tt><tt>fits width<br> + fits height<br> + fits depth<br> + fits bitpix</tt><br> + <tt><tt>fits size<br> + </tt> fits size wcs fk5 arcmin<br> + fits header # primary<br> + fits header 2 # hdu 2<br> + fits header -2 # hdu 2 with inherit<br> + fits header keyword BITPIX<br> + fits header 1 keyword BITPIX</tt><br> + fits<br> + fits image<br> + </tt> <tt><tt>fits table<br> + </tt></tt> + <tt><tt><tt>fits slice<br> + </tt></tt> ds9.set(string cmd, string + url)</tt><tt><br> + fits foo.fits<br> + fits new foo.fits<br> + fits bar.fits[bin=detx,dety]<br> + fits slice foo.fits<br> + fits mask foo.fits<br> + <br> + </tt> <b><a name="frame" id="frame"></a>frame</b> + <p>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.</p> + <tt>Syntax:<br> + frame [center [#|all]]<br> + [clear [#|all]]<br> + [new [rgb|3d]]<br> + [delete [#|all]]<br> + [reset [#|all]]<br> + [refresh [#|all]]<br> + [hide [#|all]]<br> + [show [#|all]]<br> + [move first]<br> + [move back]<br> + [move forward]<br> + [move last]<br> + [first]<br> + [prev]<br> + [next]<br> + [last]<br> + [frameno #]<br> + [#]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]<br> - - [has contour [aux]]]<br> - [has fits [ |bin|cube|mosaic]]<br> - [has marker -[highlite|paste|select|undo]]<br> - [has system -<coordsys>]<br></tt> -<tt><tt><tt><tt> [has wcs -[<wcssys>]]<br></tt> [has wcs -celestial [<wcssys>]]<br></tt> -[has wcs linear [<wcssys>]]<br> - </tt><br> -Example:<br> -string value = ds9.get(string cmd)<br> -frame # returns the id of the current frame<br> -frame frameno # returns the id of the current frame<br> -frame all # returns the id of all frames<br> -frame active # returns the id of all active frames<br> -frame lock<br> -frame has amplifier<br> -frame has datamin<br> -frame has datasec<br> -frame has detector<br> -frame has grid<br> -frame has iis<br> -frame has irafmin<br> -frame has physical<br> -frame has smooth<br> -frame has contour<br> -frame has contour aux<br> -frame has fits<br> -frame has fits bin<br> -frame has fits cube<br> -frame has fits mosaic<br> -frame has marker highlite<br> -frame has marker paste<br> -frame has marker select<br> -frame has marker undo<br> -frame has system physical<br> -frame has wcs wcsa<br> -frame has wcs celestial wcsa<br> -frame has wcs linear wcsa<br> -ds9.set(string cmd)<br> -frame center # center current frame<br> -frame center 1 # center 'Frame1'<br> -frame center all # center all frames<br> -frame clear # clear current frame<br> -frame new # create new frame<br> -frame new rgb # create new rgb frame<br> -frame delete # delete current frame<br> -frame reset # reset current frame<br> -frame refresh # refresh current frame<br> -frame hide # hide current frame<br> -frame show 1 # show frame 'Frame1'<br> -frame move first # move frame to first in order<br> -frame move back # move frame back in order<br> -frame move forward # move frame forward in order<br> -frame move last # move frame to last in order<br> -frame first # goto first frame<br> -frame prev # goto prev frame<br> -frame next # goto next frame<br> -frame last # goto last frame<br> -frame frameno 4 # goto frame 'Frame4', create if needed<br> -frame 3 # goto frame 'Frame3', create if needed<br> -frame match wcs<br> -frame lock wcs</tt><br> -<p><b><a name="gif" id="gif"></a>gif</b></p> -<p>Load GIF image into current frame.<br></p> -<tt>Syntax:<br> -gif [new|slice] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> gif</tt><br> -<tt><tt>ds9.set(string cmd)<br></tt> gif foo.gif</tt><br> -<tt><tt>gif new foo.gif<br></tt></tt> <tt><tt><tt>gif slice -foo.gif<br></tt></tt> gif</tt><br> -<tt><tt>gif</tt> <tt>new<br></tt> gif</tt> <tt>slice</tt> -<p><b><a name="grid" id="grid"></a>grid</b></p> -<p>Controls coordinate grid. For grid numeric format syntax, -click <a href="grid.html#Format">here</a>.</p> -<tt>Syntax:<br> -grid []<br> - [yes|no]<br> - [type analysis|publication]<br> - [system <coordsys>]<br> - [sky <skyframe>]<br> - [skyformat <skyformat>]<br> - [grid yes|no]<br> - [grid color <color>]<br> - [grid width <value>]<br> - [grid dash yes|no]<br> - [grid gap1 <value>]<br></tt> -<tt><tt> [grid gap2 -<value>]<br></tt></tt> -<tt><tt><tt> [grid gap3 -<value>]<br></tt></tt> [axes -yes|no]<br> - [axes color <color>]<br> - [axes width <value>]<br> - [axes dash yes|no]<br> - [axes type -interior|exterior]<br></tt> <tt> -[axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> -<tt> [format1 <format>]<br> - [format2 <format>]<br> - [tickmarks yes|no]<br> - [tickmarks color <color>]<br> - [tickmarks width <value>]<br> - [tickmarks dash yes|no]<br> - [border yes|no]<br> - [border color <color>]<br> - [border width <value>]<br> - [border dash yes|no]<br> - [numerics yes|no]<br> - [numerics font -times|helvetica|courier]<br> - [numerics fontsize -<value>]<br> - [numerics fontweight -normal|bold]<br> - [numerics fontslant -roman|italic]<br> - [numerics color <color>]<br> - [numerics gap1 -<value>]<br></tt> <tt><tt> -[numerics gap2 <value>]<br></tt></tt> -<tt><tt><tt> [numerics gap3 -<value>]<br></tt></tt> -[numerics type interior|exterior]<br> - [numerics vertical yes|no]<br> - [title yes|no]<br> - [title text <text>]<br> - [title def yes|no]<br> - [title gap <value>]<br> - [title font -times|helvetica|courier]<br> - [title fontsize <value>]<br> - [title fontweight normal|bold]<br> - [title fontslant roman|italic]<br> - [title color <color>]<br> - [labels yes|no]<br> - [labels text1 <text>]<br></tt> -<tt><tt> [labels text2 -<text>]<br></tt> [labels def1 -yes|no]<br> - [labels def2 yes|no]<br></tt> -<tt><tt> [labels gap1 -<value>]<br></tt> [labels gap2 -<value>]<br> - [labels font -times|helvetica|courier]<br> - [labels fontsize <value>]<br> - [labels fontweight normal|bold]<br> - [labels fontslant roman|italic]<br> - [labels color <color>]<br> - [reset]<br> - [load <filename>]<br> - [save <filename>]<br> - [open|close]<br> -<br> -Example:<br> -string value = ds9.get(string cmd)<br> -grid<br> -grid type<br> -grid system<br> -grid sky<br> -grid skyformat<br> -grid grid<br> -grid grid color<br> -grid grid width<br> -grid grid dash<br> -grid grid gap1<br></tt> <tt><tt>grid grid gap2<br></tt></tt> -<tt><tt><tt>grid grid gap3<br></tt></tt> grid axes<br> -grid axes color<br> -grid axes width<br> -grid axes dash<br> -grid axes type<br> -grid axes origin<br> -grid format1<br> -grid format2<br> -grid tickmarks<br> -grid tickmarks color<br> -grid tickmarks width<br> -grid tickmarks dash<br> -grid border<br> -grid border color<br> -grid border width<br> -grid border dash<br> -grid numerics<br> -grid numerics font<br> -grid numerics fontsize<br> -grid numerics fontweight<br> -grid numerics fontslant<br> -grid numerics color<br> -grid numerics gap1<br></tt> <tt><tt>grid numerics -gap2<br></tt></tt> <tt><tt><tt>grid numerics gap3<br></tt></tt> -grid numerics type<br> -grid numerics vertical<br> -grid title<br> -grid title text<br> -grid title def<br> -grid title gap<br> -grid title font<br> -grid title fontsize<br> -grid title fontweight<br> -grid title fontslant<br> -grid title color<br> -grid labels<br> -grid labels text1<br></tt> <tt><tt>grid labels text2<br></tt> grid -labels def1<br> -grid labels def2<br></tt> <tt><tt>grid labels gap1<br></tt> grid -labels gap2<br> -grid labels font<br> -grid labels fontsize<br> -grid labels fontweight<br> -grid labels fontslant<br> -grid labels color<br> -ds9.set(string cmd)<br> -grid<br> -grid yes<br> -grid type analysis<br> -grid system wcs<br> -grid sky fk5<br> -grid skyformat degrees<br> -grid grid yes<br> -grid grid color red<br> -grid grid width 2<br> -grid grid dash yes<br> -grid grid gap1 10<br></tt> <tt><tt>grid grid gap2 10<br></tt></tt> -<tt><tt><tt>grid grid gap3 10<br></tt></tt> grid axes yes<br> -grid axes color red<br> -grid axes width 2<br> -grid axes dash yes<br> -grid axes type exterior<br> -grid axes origin lll<br> -grid format1 d.2<br> -grid format2 d.2<br> -grid tickmarks yes<br> -grid tickmarks color red<br> -grid tickmarks width 2<br> -grid tickmarks dash yes<br> -grid border yes<br> -grid border color red<br> -grid border width 2<br> -grid border dash yes<br> -grid numerics yes<br> -grid numerics font courier<br> -grid numerics fontsize 12<br> -grid numerics fontweight bold<br> -grid numerics fontslant italic<br> -grid numerics color red<br> -grid numerics gap1 10<br></tt> <tt><tt>grid numerics gap2 -10<br></tt></tt> <tt><tt><tt>grid numerics gap3 10<br></tt></tt> -grid numerics type exterior<br> -grid numerics vertical yes<br> -grid title yes<br> -grid title text {Hello World}<br> -grid title def yes<br> -grid title gap 10<br> -grid title fontsize 12<br> -grid title font courier<br> -grid title fontweight bold<br> -grid title fontslant italic<br> -grid title color red<br> -grid labels yes<br> -grid labels text1 {Hello World}<br></tt> <tt><tt>grid labels text2 -{Hello World}<br></tt> grid labels def1 yes<br> -grid labels def2 yes<br></tt> <tt><tt>grid labels gap1 10<br></tt> -grid labels gap2 10<br> -grid labels font courier<br> -grid labels fontsize 12<br> -grid labels fontweight bold<br> -grid labels fontslant italic<br> -grid labels color red<br> -grid reset<br> -grid load foo.grd<br> -grid save foo.grd<br> -grid open<br> -grid close<br></tt> -<p><b><a name="header" id="header"></a>header</b></p> -<p>Display current fits header dialog. Optional extension number -maybe specified. Please note, this differs from samp fits -header.</p> -<tt>Syntax:<br> -header [<ext>]<br> - [close [<ext>]]<br> - [save [<ext>] -<filename>]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -header<br> -header 2<br> -header close<br></tt> -<p><b><a name="height" id="height"></a>height</b></p> -<p>Set the height of the image display window.</p> -<tt>Syntax:<br> -height [<value>]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -height<br> -ds9.set(string cmd)<br> -height 512<br></tt> -<p><b><a name="iconify" id="iconify"></a>iconify</b></p> -<p>Toggles iconification.</p> -<tt>Syntax:<br> -iconify []<br> - [yes|no]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -iconify<br> -ds9.set(string cmd)<br> -iconify<br> -iconify yes</tt><br> -<p><b><a name="iexam" id="iexam"></a>iexam</b></p> -<p>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 -<tt>button</tt>. In the last form, the following macros will be -expanded if present: <tt>$width, $height, $depth, $bitpix, -$filename, $regions, $filename[$regions], $env, $pan, $value, $x, -$y, $z.</tt> See <a href= -"file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis -Macros</a> for more information.</p> -<tt>Syntax:<br> -iexam []<br></tt> <tt><tt> -[[]|button|key|any] coordinate <coordsys> [<skyframe>] -[<skyformat>]<br> - [[]|button|key|any] data -[width][height]<br></tt> <tt><tt> -[[]|button|key|any] <macro string>]<br> - </tt></tt><br> -Example:<br> -string value = ds9.get(string cmd)<br></tt> <tt><tt>iexam<br></tt> -iexam coordinate image<br> -iexam key coordinate image # return coordinate and key event<br> -iexam coordinate wcs fk5 degrees<br> -iexam coordinate wcs galactic sexagesimal<br> -iexam coordinate fk5<br> -iexam data # return data value<br> -iexam key data # return data value and key event<br> -iexam data 3 3 # return all data in 3x3 box about selected -point<br> -iexam {'Click at $x,$y in file $filename'}</tt><br> -<p><b><a name="iis" id="iis"></a>iis</b></p> -<p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> -<tt>Syntax:<br> -iis [filename <filename> [#]]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -iis filename<br> -iis filename 4<br> -ds9.set(string cmd)<br> -iis filename foo.fits<br> -iis filename bar.fits 4</tt><br> -<p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> -<p>Load JPEG image into current frame. Optional parameters: -<tt>jpeg</tt> quality (1-100)</p> -<tt>Syntax:<br> -jpeg [new|slice] [<filename>] [1-100]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> jpeg</tt><br> -<tt><tt>jpeg 100</tt><br></tt> <tt><tt>ds9.set(string cmd)<br></tt> -jpeg foo.jpeg</tt><br> -<tt><tt>jpeg new foo.jpeg<br></tt></tt> <tt><tt><tt>jpeg slice -foo.jpeg<br></tt></tt> jpeg</tt><br> -<tt><tt>jpeg</tt> <tt>new<br></tt> jpeg</tt> <tt>slice</tt> -<p><b><a name="lock" id="lock"></a>lock</b></p> -<p>Lock all other frames to the current frame.</p> -<tt>Syntax:<br></tt> <tt>lock</tt> <tt>[frame -<coordsys>|none]<br> - </tt> <tt>[crosshair -<coordsys>|none]</tt> <tt><br></tt> -<tt> [crop <coordsys>|none]</tt><br> -<tt> [slice <coordsys>|none]</tt><br> -<tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimits [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br></tt> -<tt> [smooth [yes|no]]</tt><tt><br></tt> -<tt> [3d [yes|no]]</tt><tt><br></tt> -<tt> </tt> <tt><br> -Example:<br></tt> <tt>string value = ds9.get(string cmd)<br></tt> -<tt>lock frame<br> -lock crosshair<br></tt> <tt>lock crop</tt><br> -<tt>lock slice</tt><br> -<tt>lock bin<br> -lock axes<br> -lock scale<br> -lock scalelimits<br> -lock color</tt><tt>bar<br> -lock block<br></tt> <tt>lock smooth<br></tt> <tt>lock 3d<br></tt> -<tt>ds9.set(string cmd)<br></tt> <tt>lock frame -wcs</tt><tt><br></tt> <tt>lock crosshair wcs<br></tt> <tt>lock crop -wcs</tt><br> -<tt>lock slice wcs</tt><br> -<tt>lock bin yes<br> -lock axes yes<br></tt> <tt>lock scale yes<br> -lock scalelimits yes<br></tt> <tt>lock colorbar yes</tt><tt><br> -lock block yes</tt><br> -<tt>lock smooth yes<br></tt> <tt>lock 3d yes<br> -<br></tt> <b><a name="lower" id="lower"></a>lower</b> -<p>Lower in the window stacking order.</p> -<tt>Syntax:<br> -lower<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -lower</tt><tt><br></tt> -<p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> -<p>Controls the magnifier settings.</p> -<tt>Syntax:<br> -magnifier [color <color>]<br> - [zoom -<value>]<br> - [cursor -yes|no]<br> - [region -yes|no]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -magnifier color<br> -magnifier zoom<br> -magnifier cursor<br> -magnifier region<br> -ds9.set(string cmd)<br> -magnifier color yellow<br> -magnifier zoom 2<br> -magnifier cursor no<br> -magnifier region no<br></tt> -<p><b><a name="mask" id="mask"></a>mask<br></b></p> -<p>Controls mask parameters.</p> -<tt>Syntax:<br> -mask [color <color>]<br> - [mark 1|0]<br> - [transparency <value>]<br> - [clear]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -mask color<br> -mask mark<br> -mask transparency<br> -ds9.set(string cmd)<br> -mask color red<br> -mask mark 0<br> -mask transparency 50<br> -mask clear<br> -mask open<br> -mask close<br></tt> -<p><b><a name="match" id="match"></a>match</b></p> -<p>Match all other frames to the current frame.</p> -<tt>Syntax:<br></tt> <tt>match</tt> <tt>[frame -<coordsys>]<br> - </tt> <tt>[crosshair -<coordsys>]</tt> <tt><br></tt> -<tt> [crop <coordsys>]<br></tt> -<tt> [slice -<coordsys>]<br></tt> <tt> -[bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]</tt><tt><br> - [3d]<br></tt> <tt> <br> -Example:<br> -ds9.set(string cmd)<br></tt> <tt>match frame wcs<br></tt> <tt>match -crosshair wcs<br></tt> <tt>match crop wcs</tt><br> -<tt>match slice wcs<br> -match bin<br> -match axes<br> -match scale<br> -match scalelimits<br> -match color</tt><tt>bar<br> -match block<br> -match smooth<br> -match 3d<br></tt> -<p><b><a name="mecube" id="mecube"></a>mecube</b></p> -<p>Load FITS multiple extension file as data cube.<br></p> -<tt>Syntax:<br> -mecube [new] [<filename>]<br> - <br> -Example:</tt><br> -<tt>string value = ds9.get(string cmd)</tt><tt><tt><br></tt> -mecube<br></tt> <tt><tt><tt>ds9.set(string cmd)<br></tt></tt> -mecube foo.fits</tt><br> -<tt><tt>mecube new foo.fits<br></tt> mecube</tt><br> -<tt>mecube</tt> <tt>new</tt> -<p><b><a name="minmax" id="minmax"></a>minmax</b></p> -<p>This is how DS9 determines the min and max data values -from the data. <tt>SCAN</tt> will scan all data.</p> -<tt>Syntax:<br> -minmax [scan|sample|datamin|irafmin]<br> - [mode -scan|sample|datamin|irafmin]<br> - [interval #]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -minmax mode<br> -minmax sample<br> -ds9.set(string cmd)<br> -minmax scan<br> -minmax mode scan<br> -minmax interval 100<br></tt> -<p><b><a name="mode" id="mode"></a>mode</b></p> -<p>Controls the first mouse button mode.</p> -<tt>Syntax:<br> -mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> - - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -mode<br> -ds9.set(string cmd)<br> -mode crosshair</tt><br> -<p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> -<p>Load FITS mosaic segment into current frame.</p> -<tt>Syntax:<br> -mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> mosaic</tt><tt><br></tt> <tt><tt>ds9.set(string -cmd)<br></tt> mosaic foo.fits</tt><br> -<tt><tt>mosaic wcs foo.fits</tt></tt><br> -<tt><tt>mosaic wcs new foo.fits</tt></tt><br> -<tt><tt>mosaic wcs mask -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> mosaic</tt><br> -<tt><tt>mosaic wcs<br> -mosaic wcs</tt> <tt>new<br></tt> mosaic wcs</tt> <tt>mask<br></tt> -<p><b><a name="mosaicimage" id= -"mosaicimage"></a>mosaicimage</b></p> -<p>Load FITS mosaic image into current frame.</p> -<tt>Syntax:<br> -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] -[<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> mosaicimage</tt><tt><br></tt> <tt><tt>ds9.set(string -cmd)<br></tt> mosaicimage foo.fits</tt><br> -<tt><tt>mosaicimage wcs foo.fits</tt></tt><br> -<tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> -<tt><tt>mosaicimage wcs mask -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> mosaicimage</tt><br> -<tt><tt>mosaicimage wcs<br> -mosaicimage wcs new</tt><tt><br></tt> mosaicimage wcs mask</tt> -<p><b><a name="movie" id="movie"></a>movie</b></p> -<p>Create mpeg1 movie from snap shots of the DS9 window. A -<tt>slice</tt> movie cycles though all slices of a cube. A -<tt>frame</tt> movie cycles through all active frames. A -<tt>3d</tt> movie cycles through specified viewing angles. The -default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: -number of frames, azimuth from/to, elevation from/to, slice -from/to, oscillate/repeat times.</p> -<tt>Syntax:<br> -movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br></tt> -<tt>movie 3d <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>]</tt><br> -<tt> <br> -Example:<br> -ds9.set(string cmd)<br> -movie slice ds9.mpg<br></tt> <tt>movie 3d ds9.mpg number 10 azfrom --60 azto 60 oscillate 1</tt><br> -<p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> -<p>Load FITS multiple extension file as multiple images.<br></p> -<tt>Syntax:<br> -multiframe [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> multiframe -foo.fits</tt><tt><tt><br></tt> multiframe</tt><br> -<p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> -<p>Support Name Server functions. Coordinates are in fk5.</p> -<tt>Syntax:<br> -nameserver [<object>]<br> - [name -<object>]<br> - -[server -ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> - - -[skyformat degrees|sexagesimal]<br> - -[pan]<br> - -[crosshair]<br> - [close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -nameserver<br> -nameserver server<br> -nameserver skyformat<br> -nameserver m31<br> -ds9.set(string cmd)<br> -nameserver m31<br> -nameserver name m31<br> -nameserver server ned-sao<br> -nameserver skyformat sexagesimal<br> -nameserver pan<br> -nameserver crosshair<br> -nameserver open<br> -nameserver close<br></tt> -<p><b><a name="nan" id="nan"></a>nan</b></p> -<p>Set image not-a-number color.</p> -<tt>Syntax:<br> -nan <color><br> - <br> -Example:<br></tt> <tt>string value = ds9.get(string cmd)<br> -nan</tt><br> -<tt>ds9.set(string cmd)<br> -nan red</tt><br> -<p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> -<p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: -array endian.<br></p> -<tt>Syntax:<br> -nrrd [native|little|big]<br> -nrrd [new|mask] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> nrrd</tt><br> -<tt><tt>nrrd big<br></tt></tt> <tt><tt><tt>ds9.set(string -cmd</tt><tt>, string url</tt><tt>)<br></tt> nrrd -foo.nrrd</tt></tt><br> -<tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> -<tt><tt><tt><tt><tt><tt>nrrd mask -foo.nrrd<br></tt></tt></tt></tt></tt> nrrd</tt><br> -<tt>nrrd</tt> <tt>new<br> -nrrd mask</tt><br> -<p><b><a name="nvss" id="nvss"></a>nvss</b></p> -<p>Support for NRAO VLA Sky Survey.</p> -<tt>Syntax:<br> -nvss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -nvss name<br> -nvss coord<br> -nvss size<br> -nvss save<br> -nvss frame<br> -ds9.set(string cmd)<br> -nvss<br> -nvss m31<br></tt> <tt><tt>nvss name m31<br></tt></tt> -<tt><tt><tt>nvss name clear<br></tt></tt> nvss 00:42:44.404 -+41:16:08.78<br> -nvss size 60 60 arcmin<br> -nvss save yes<br> -nvss frame current<br> -nvss update frame<br> -nvss open<br> -nvss close<br></tt> -<p><b><a name="orient" id="orient"></a>orient</b></p> -<p>Controls the orientation of the current frame.</p> -<tt>Syntax:<br> -orient [none|x|y|xy]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -orient<br> -ds9.set(string cmd)<br> -orient xy<br> -orient open<br> -orient close<br></tt> -<p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> -<p>Controls Page Setup options.</p> -<tt>Syntax:<br> -pagesetup [orient portrait|landscape]</tt><br> -<tt> [scale -<numeric>]</tt><br> -<tt> [size -letter|legal|tabloid|poster|a4]</tt><br> -<tt> <br> -Example:<br> -string value = ds9.get(string cmd)<br> -pagesetup orient<br> -pagesetup scale<br> -pagesetup size<br> -ds9.set(string cmd)<br> -pagesetup orient portrait<br> -pagesetup scale 50<br> -pagesetup size poster<br></tt> -<p><b><a name="pan" id="pan"></a>pan</b></p> -<p>Controls the current image cursor location for the current -frame.</p> -<tt>Syntax:<br> -pan [<x> <y> <coordsys> -[<skyframe>][<skyformat>]] # relative<br> - [to <x> <y> <coordsys> -[<skyframe>][<skyformat>] # absolute<br> - [open|close]<br> - [close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -pan # get current image coords<br> -pan wcs fk4 sexagesimal # get current wcs coords<br> -ds9.set(string cmd)<br> -pan 200 200 image # pan relative<br> -pan to 400 400 physical # pan to physical coords<br> -pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords<br> -pan open<br> -pan close<br></tt> -<p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> -<p>Display/Hide the pixel table.</p> -<tt>Syntax:<br> -pixeltable []<br> - [yes|open]<br> - [no|close]<br> - <br> -Example:<br> -string url = ds9.get(string cmd)<br> -pixeltable<br> -ds9.set(string cmd)<br> -pixeltable<br> -pixeltable yes<br> -pixeltable open<br> -pixeltable close<br></tt> -<p><b><a name="plot" id="plot"></a>plot</b></p> -<p>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:</p> -<blockquote>xy x and y coordinates<br> -xyex x,y coordinates with x errors<br> -xyey x,y coordinates with y errors<br> -xyexey x,y coordinates with x and y -errors<br></blockquote> -<p>To create a new plot, use the plot new command.</p> -<tt>Syntax:</tt><tt><br></tt> <tt># create new empty plot -window</tt><tt><br></tt> <tt>plot []</tt><tt><br></tt> -<tt> [line|bar|scatter]</tt><tt><br></tt> -<tt> [new]</tt><tt><br></tt> -<tt> [new -line|bar|scatter]</tt><tt><br></tt> <tt> -[new name <plotname>]</tt><tt><br></tt> -<tt> [new name <plotname> -line|bar|scatter]</tt><tt><br></tt> <tt><br></tt> <tt>#</tt> -<tt>load data into existing plot from stdin</tt><tt><br></tt> -<tt>plot [[<plotname>] data -xy|xyex|xyey|xyexey]</tt><tt><br></tt> <tt><br></tt> <tt># existing -plot</tt><tt><br></tt> <tt>plot</tt> <tt>[[<plotname>] load -<filename> xy|xyex|xyey|xyexey]</tt><tt><br></tt> -<tt> [[<plotname>] save -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] clear]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] duplicate -[#]]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] stats yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] list -yes|no]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] loadconfig -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] saveconfig <filename>]</tt><tt><br></tt> -<tt> [[<plotname>] pagesetup orient -portrait|landscape]</tt><tt><br></tt> <tt> -[[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4]</tt><tt><br></tt> -<tt> [[<plotname>] -print]</tt><tt><br></tt> <tt> -[[<plotname>] print destination -printer|file]</tt><tt><br></tt> <tt> -[[<plotname>] print command -<command>]</tt><tt><br></tt> <tt> -[[<plotname>] print filename -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] print color rgb|gray]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -close</tt><tt>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] mode pointer|zoom]</tt><tt><br></tt> -<tt><br></tt> <tt># configure graph</tt><tt><br></tt> <tt>plot -[[<plotname>] axis x|y grid yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y log -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y flip yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y auto -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y min <value>]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y max -<value>]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y format -<string>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] legend yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] legend position -right|left|top|bottom]</tt><tt><br></tt> <tt> -[[<plotname>] font title|labels|numbers font -times|helvetica|courier]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>size <value>]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>weight normal|bold]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>slant roman|italic]</tt><tt><br></tt> <tt> -[[<plotname>] title <string>]</tt><tt><br></tt> -<tt> [[<plotname>] title x|y -<string>]</tt><tt><br></tt> <tt> -[</tt><tt>[<plotname>] barmode -normal|stacked|aligned|overlap]</tt><tt><br></tt> <tt><br></tt> -<tt># configure current dataset</tt><tt><br></tt> <tt>plot -[[<plotname>] show yes|no]</tt><tt><br></tt> <tt> - </tt> <tt>[[<plotname>] shape -circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> -</tt> <tt> </tt> <tt>[[<plotname>] -shape fill yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] shape -color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] smooth -step|linear|cubic|quadratic|catrom]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] color -<value>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] dash -yes|no]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] error yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] error -color <value>]</tt><tt><br></tt> <tt> -[[<plotname>] color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] error -width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] name -<string>]</tt><tt><br></tt> <tt><br></tt> <tt># select -current dataset</tt><tt><br></tt> <tt>plot [[<plotname>] -select <value>]</tt><tt><br></tt> <tt> </tt> <tt><br> -</tt> <tt>Example:</tt><tt><br></tt> <tt># return all -plotnames</tt><tt><br></tt> <tt>string value = ds9.get(string -cmd)</tt><tt><br></tt> <tt>plot</tt><tt><br></tt> <tt><br></tt> -<tt># create new empty plot window</tt><tt><br></tt> -<tt>ds9.set(string cmd)</tt><tt><br></tt> -<tt>plot</tt><tt><br></tt> <tt>plot bar</tt><tt><br></tt> <tt>plot -new</tt><tt><br></tt> <tt>plot new bar</tt><tt><br></tt> <tt>plot -new name foo</tt><tt><br></tt> <tt>plot new name foo -bar</tt><tt><br></tt> <tt><br></tt> <tt># load additional dataset -into an existing plot</tt><tt><br></tt> <tt>ds9.set(string cmd, -string url)</tt><tt><br></tt> <tt>plot data xy # plot additional -data</tt><tt><br></tt> <tt>plot foo data xy # plot additional -data</tt><tt><br></tt> <tt><br></tt> <tt>string value = -ds9.get(string cmd)</tt><tt><br></tt> <tt>plot -stats</tt><tt><br></tt> <tt>plot list</tt><tt><br></tt> -<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot load foo.dat -xy</tt><tt><br></tt> <tt>plot save foo.dat</tt><tt><br></tt> -<tt>plot clear</tt><tt><br></tt> <tt>plot duplicate -1</tt><tt><br></tt> <tt>plot stats yes</tt><tt><br></tt> <tt>plot -list yes</tt><tt><br></tt> <tt>plot loadconfig -foo.plt</tt><tt><br></tt> <tt>plot saveconfig -foo.plt</tt><tt><br></tt> <tt>plot pagesetup orient -portrait</tt><tt><br></tt> <tt>plot pagesetup size -letter</tt><tt><br></tt> <tt>plot print</tt><tt><br></tt> <tt>plot -print destination file</tt><tt><br></tt> <tt>plot print command -lp</tt><tt><br></tt> <tt>plot print filename -foo.ps</tt><tt><br></tt> <tt>plot print color rgb</tt><tt><br></tt> -<tt>plot close</tt><tt><br></tt> <tt><br></tt> <tt>string value = -ds9.get(string cmd)</tt><tt><br></tt> <tt>plot -mode</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> -<tt>plot mode pointer</tt><tt><br></tt> <tt><br></tt> <tt># -configure plot</tt><tt><br></tt> <tt>string value = ds9.get(string -cmd)</tt><tt><br></tt> <tt>plot axis x grid</tt><tt><br></tt> -<tt>plot axis x log</tt><tt><br></tt> <tt>plot axis x -flip</tt><tt><br></tt> <tt>plot axis x auto</tt><tt><br></tt> -<tt>plot axis x min</tt><tt><br></tt> <tt>plot axis x -max</tt><tt><br></tt> <tt>plot axis x format</tt><tt><br></tt> -<tt>plot legend</tt><tt><br></tt> <tt>plot legend -position</tt><tt><br></tt> <tt>plot font numbers -font</tt><tt><br></tt> <tt>plot font numbers size</tt><tt><br></tt> -<tt>plot font numbers weight</tt><tt><br></tt> <tt>plot font -numbers slant</tt><tt><br></tt> <tt>plot title</tt><tt><br></tt> -<tt>plot title x</tt><tt><br></tt> <tt>plot -barmode</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> -<tt>plot axis x grid yes</tt><tt><br></tt> <tt>plot axis x log -yes</tt><tt><br></tt> <tt>plot axis x flip yes</tt><tt><br></tt> -<tt>plot axis x auto no</tt><tt><br></tt> <tt>plot axis x min -0</tt><tt><br></tt> <tt>plot axis x max 100</tt><tt><br></tt> -<tt>plot axis x format "%f"</tt><tt><br></tt> <tt><br></tt> -<tt>string value = ds9.get(string cmd)</tt><tt><br></tt> <tt>plot -legend</tt><tt><br></tt> <tt>plot legend position</tt><tt><br></tt> -<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot legend -yes</tt><tt><br></tt> <tt>plot legend position -left</tt><tt><br></tt> <tt><br></tt> <tt>string value = -ds9.get(string cmd)</tt><tt><br></tt> <tt>plot font numbers -font</tt><tt><br></tt> <tt>plot font numbers size</tt><tt><br></tt> -<tt>plot font numbers weight</tt><tt><br></tt> <tt>plot font -numbers slant</tt><tt><br></tt> <tt>ds9.set(string -cmd)</tt><tt><br></tt> <tt>plot font numbers font -times</tt><tt><br></tt> <tt>plot font numbers size -12</tt><tt><br></tt> <tt>plot font numbers weight -bold</tt><tt><br></tt> <tt>plot font numbers slant -italic</tt><tt><br></tt> <tt><br></tt> <tt>string value = -ds9.get(string cmd)</tt><tt><br></tt> <tt>plot -title</tt><tt><br></tt> <tt>plot title xaxis</tt><tt><br></tt> -<tt>plot title yaxis</tt><tt><br></tt> <tt>ds9.set(string -cmd)</tt><tt><br></tt> <tt>plot title "This is a -Title"</tt><tt><br></tt> <tt>plot title x "X -Axis"</tt><tt><br></tt> <tt>plot title y "Y Axis"</tt><tt><br></tt> -<tt>plot title legend "This is the Legend"</tt><tt><br></tt> -<tt><br></tt> <tt>string value = ds9.get(string -cmd)</tt><tt><br></tt> <tt>plot barmode</tt><tt><br></tt> -<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot barmode -aligned</tt><tt><br></tt> <tt><br></tt> <tt># configure current -dataset</tt><tt><br></tt> <tt>string value = ds9.get(string -cmd)</tt><tt><br></tt> <tt>plot show</tt><tt><br></tt> <tt>plot -shape</tt><tt><br></tt> <tt>plot shape fill</tt><tt><br></tt> -<tt>plot shape color</tt><tt><br></tt> <tt>plot -smooth</tt><tt><br></tt> <tt>plot color</tt><tt><br></tt> <tt>plot -width</tt><tt><br></tt> <tt>plot dash</tt><tt><br></tt> <tt>plot -error</tt><tt><br></tt> <tt>plot error color</tt><tt><br></tt> -<tt>plot error width</tt><tt><br></tt> <tt>plot -name</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> -<tt>plot show yes</tt><tt><br></tt> <tt>plot shape -circle</tt><tt><br></tt> <tt>plot shape fill no</tt><tt><br></tt> -<tt>plot shape color cyan</tt><tt><br></tt> <tt>plot smooth -step</tt><tt><br></tt> <tt>plot color red</tt><tt><br></tt> -<tt>plot width 2</tt><tt><br></tt> <tt>plot dash -yes</tt><tt><br></tt> <tt>plot error yes</tt><tt><br></tt> <tt>plot -error color red</tt><tt><br></tt> <tt>plot error width -2</tt><tt><br></tt> <tt>plot name "My Data"</tt><tt><br></tt> -<tt><br></tt> <tt># select current dataset</tt><tt><br></tt> -<tt>string value = ds9.get(string cmd)</tt><tt><br></tt> <tt>plot -select</tt><tt><br></tt> <tt>ds9.set(string cmd)<br> -plot select 2<br> -<br></tt> <b><a name="png" id="png"></a>png</b> -<p>Load PNG image into current frame.<br></p> -<tt>Syntax:<br> -png [new|slice] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> png</tt><br> -<tt><tt>ds9.set(string cmd)<br></tt> png foo.png</tt><br> -<tt><tt>png new foo.png<br></tt></tt> <tt><tt><tt>png slice -foo.png<br></tt></tt> png</tt><br> -<tt><tt>png</tt> <tt>new<br></tt> png</tt> <tt>slice</tt><br> -<p><b><a name="precision" id="precision"></a>precision</b></p> -<p>Set region and coordinate output format precision.</p> -<tt>Syntax:<br> -precision <linear></tt> <tt><tt><degree></tt></tt> -<tt><tt><hms></tt></tt> -<tt><tt><tt><dms></tt></tt></tt> -<tt><tt><tt><tt><arcmin></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><arcsec><br> -<br></tt></tt></tt></tt> Example:<br> -string value = ds9.get(string cmd)<br> -precision<br> -ds9.set(string cmd)<br> -precision 8 10 4 3 5 3</tt><br> -<p><b><a name="prefs" id="prefs"></a>prefs</b></p> -<p>Controls various preference settings.</p> -<tt>Syntax:<br> -prefs [clear]<br> - [irafalign yes|no]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -prefs irafalign<br> -ds9.set(string cmd)<br> -prefs clear<br> -prefs irafalign<br> -<br></tt> <b><a name="preserve" id="preserve"></a>preserve</b> -<p>Preserve the follow attributes while loading a new image.</p> -<tt>Syntax:<br> -preserve [pan yes|no]<br> - [regions yes|no]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -preserve pan<br> -preserve regions<br> -ds9.set(string cmd)<br> -preserve pan yes<br> -preserve regions yes<br></tt> -<p><b><a name="psprint" id="psprint"></a>psprint</b></p> -<p>Invokes postscript printing. Please see <a href= -"file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> -for further details.</p> -<p><b><a name="print" id="print"></a>print</b></p> -<p>Controls printing. Use print option to set printing options.</p> -<tt>Syntax:<br> -print [destination printer|file]<br> - [command <command>]<br> - [filename <filename>]<br> - [color rgb|cmyk|gray]<br> - [level 1|2]<br> - [resolution -53|72|75|150|300|600]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -print destination<br> -print command<br> -print filename<br> -print color<br> -print level<br> -print resolution<br> -ds9.set(string cmd)<br> -print<br> -print destination file<br> -print command lp<br> -print filename foo.ps<br> -print color cmyk<br> -print level 2<br> -print resolution 75</tt> -<p><b><a name="raise" id="raise"></a>raise</b></p> -<p>Raise in the window stacking order.</p> -<tt>Syntax:<br> -raise<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -raise</tt> -<p><b><a name="regions" id="regions"></a>regions</b></p> -<p>Controls regions in the current frame.</p> -<tt>Syntax:<br> -regions [<filename>]<br> - [load [all] -<filename>]<br> - [save -<filename>]<br> - [list [close]]<br> - [epsilon -<integer>]<br> - [show yes|no]<br> - [showtext yes|no]<br> - [centroid]<br> - [centroid auto -yes|no]<br> - [centroid radius -<value>|iteration <value>]<br> - [getinfo]<br> - [move front]<br> - [move back]<br> - [select all]<br> - [select none]<br> - [select invert]<br> - [delete all]<br> - [delete select]<br> - [format -ds9|xml|ciao|saotng|saoimage|pros|xy]<br> - [system -image|physical|wcs|wcsa...wcsz]<br> - [sky -fk4|fk5|icrs|galactic|ecliptic]<br> - [skyformat -degrees|sexagesimal]<br> - [strip yes|no]<br> - [shape -<shape>]<br> - [color -&ltcolor>]<br> - [width -<width>]<br></tt> <tt> -[fixed|edit|rotate|delete yes|no]<br> - -[include|exclude|source|background]</tt><br> -<tt> [command <marker -command>]<br> - [composite]<br> - [dissolve]<br> - [template -<filename>]<br> - [template <filename> at -<ra> <dec> <coordsys> <skyframe>]<br> - [savetemplate -<filename>]<br> - [groups]<br> - [group new]<br> - [group <tag> -new]<br> - [group <tag> -update]<br> - [group <tag> -select]<br> - [group <tag> color -<color>]<br> - [group <tag> copy]<br> - [group <tag> -delete]<br> - [group <tag> cut]<br> - [group <tag> font -<font>]<br> - [group <tag> move -<int> <int>]<br> - [group <tag> -movefront]<br> - [group <tag> -moveback]<br> - [group <tag> property -<property> yes|no]<br> - [copy]<br> - [cut]<br> - [paste -image|physical|wcs|wcsa...wcsz]<br> - [undo]<br> - -[include|exclude|source|background|selected]<br> - [-format -ds9|ciao|saotng|saoimage|pros|xy]<br> - [-system -image|physical|wcs|wcsa...wcsz]<br> - [-sky -fk4|fk5|icrs|galactic|ecliptic]<br> - [-skyformat -degrees|sexagesimal]<br> - [-prop -select|edit|move|rotate|delete|fixed|include|source 1|0]<br> - [-group <tag>]<br> - [-strip yes|no]<br> - [-wcs yes|no]<br> - <br> -Example:<br> -string url = ds9.get(string cmd)<br> -regions<br> -regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal --prop edit 1 -group foo<br> -string value = ds9.get(string cmd)<br> -regions epsilon<br> -regions show<br> -regions showtext<br> -regions centroid<br> -regions centroid auto<br> -regions centroid radius<br> -regions centroid iteration<br> -regions selected<br> -regions format<br> -regions system<br> -regions sky<br> -regions skyformat<br> -regions strip<br> -regions shape<br> -regions color<br> -regions width<br> -regions source<br> -regions background<br> -regions include<br> -regions exclude<br> -regions selected<br> -regions groups<br> -ds9.set(string cmd, string url)<br> -regions -format xy -system wcs -sky fk5<br> -regions -format ds9<br> -ds9.set(string cmd)<br> -regions foo.reg<br> -regions -format ciao bar.reg # load as ciao format<br> -regions foo.fits # FITS regions files do not need a format -specification<br> -regions load foo.reg # load foo.reg into current frame<br> -regions load all foo.reg # load foo.reg into all frames<br> -regions load *.reg# expand *.reg and load into current frame<br> -regions load all *.reg # expand *.reg and load into all frames<br> -regions save foo.reg<br> -regions list<br> -regions list close<br> -regions epsilon 5<br> -regions show yes<br> -regions showtext no<br> -regions centroid<br> -regions centroid auto yes<br> -regions centroid radius 10<br> -regions centroid iteration 20<br> -regions getinfo<br> -regions move back<br> -regions move front<br> -regions select all<br> -regions select none<br> -regions select invert<br> -regions delete all<br> -regions delete select<br> -regions format ds9<br> -regions system wcs<br> -regions sky fk5<br> -regions skyformat degrees<br> -regions strip yes<br> -regions shape ellipse<br> -regions color red<br> -regions width 3<br> -regions edit yes<br> -regions include<br> -regions command "circle 100 100 20 # color=red"<br> -regions composite<br> -regions dissolve<br> -regions template foo.tpl<br> -regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> -regions savetemplate foo.tpl<br> -regions group new<br> -regions group foo new<br> -regions group foo update<br> -regions group foo select<br> -regions group foo color red<br> -regions group foo copy<br> -regions group foo delete<br> -regions group foo cut<br> -regions group foo font 'times 14 bold'<br> -regions group foo move 100 100<br> -regions group foo movefront<br> -regions group foo moveback<br> -regions group foo property delete no<br> -regions copy<br> -regions cut<br> -regions paste wcs<br> -regions undo<br></tt> -<p><b><a name="restore" id="restore"></a>restore</b></p> -<p>Restore DS9 to a previous state from a backup save set.</p> -<tt>Syntax:<br> -restore <filename><br> - <br> -Example:<br> -restore ds9.bck</tt><br> -<p><b><a name="rgb" id="rgb"></a>rgb</b></p> -<p>Create RGB frame and control RGB frame parameters.</p> -<tt>Syntax:<br> -rgb []<br> - [red|green|blue]<br> - [channel [red|green|blue]]<br> - [view [red|green|blue] [yes|no]]<br> - [system <coordsys>]<br> - [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -rgb channel<br></tt> <tt>rgb lock wcs</tt><br> -<tt>rgb lock crop</tt><br> -<tt>rgb lock slice</tt><br> -<tt>rgb lock bin<br> -rgb lock scale<br> -rgb lock scalelimits<br> -rgb lock colorbar<br> -rgb lock block<br> -rgb lock smooth<br> -rgb system<br> -rgb view red<br> -rgb view green<br> -rgb view blue<br> -ds9.set(string cmd)<br> -rgb # create new rgb frame<br> -rgb red # set current channel to red<br> -rgb channel red # set current channel to red<br> -rgb view blue no # turn off blue channel<br> -rgb system wcs # set rgb coordinate system<br></tt> <tt>rgb lock -wcs yes</tt><br> -<tt>rgb lock crop yes</tt><br> -<tt>rgb lock slice yes</tt><br> -<tt>rgb lock bin yes</tt><br> -<tt>rgb lock scale yes<br> -rgb lock scalelimits yes<br> -rgb lock colorbar yes<br> -rgb lock block yes<br> -rgb lock smooth yes<br> -rgb open<br> -rgb close</tt><br> -<p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> -<p>Load raw data array cube into rgb frame.<br></p> -<tt>Syntax:<br> -rgbarray [native|big|little]<br> -rgbarray [new] + [has contour [aux]]]<br> + [has fits [ |bin|cube|mosaic]]<br> + [has marker + [highlite|paste|select|undo]]<br> + [has system + <coordsys>]<br> + </tt> + <tt><tt><tt><tt> [has wcs + [<wcssys>]]<br> + </tt> [has wcs + celestial [<wcssys>]]<br> + </tt> + [has wcs linear [<wcssys>]]<br> + </tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + frame # returns the id of the current frame<br> + frame frameno # returns the id of the current frame<br> + frame all # returns the id of all frames<br> + frame active # returns the id of all active frames<br> + frame lock<br> + frame has amplifier<br> + frame has datamin<br> + frame has datasec<br> + frame has detector<br> + frame has grid<br> + frame has iis<br> + frame has irafmin<br> + frame has physical<br> + frame has smooth<br> + frame has contour<br> + frame has contour aux<br> + frame has fits<br> + frame has fits bin<br> + frame has fits cube<br> + frame has fits mosaic<br> + frame has marker highlite<br> + frame has marker paste<br> + frame has marker select<br> + frame has marker undo<br> + frame has system physical<br> + frame has wcs wcsa<br> + frame has wcs celestial wcsa<br> + frame has wcs linear wcsa<br> + ds9.set(string cmd)<br> + frame center # center current frame<br> + frame center 1 # center 'Frame1'<br> + frame center all # center all frames<br> + frame clear # clear current frame<br> + frame new # create new frame<br> + frame new rgb # create new rgb frame<br> + frame delete # delete current frame<br> + frame reset # reset current frame<br> + frame refresh # refresh current frame<br> + frame hide # hide current frame<br> + frame show 1 # show frame 'Frame1'<br> + frame move first # move frame to first in order<br> + frame move back # move frame back in order<br> + frame move forward # move frame forward in order<br> + frame move last # move frame to last in order<br> + frame first # goto first frame<br> + frame prev # goto prev frame<br> + frame next # goto next frame<br> + frame last # goto last frame<br> + frame frameno 4 # goto frame 'Frame4', create if needed<br> + frame 3 # goto frame 'Frame3', create if needed<br> + frame match wcs<br> + frame lock wcs</tt><br> + <p><b><a name="gif" id="gif"></a>gif</b></p> + <p>Load GIF image into current frame.<br> + </p> + <tt>Syntax:<br> + gif [new|slice] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> gif</tt><br> + <tt><tt>ds9.set(string cmd)<br> + </tt> gif foo.gif</tt><br> + <tt><tt>gif new foo.gif<br> + </tt></tt> <tt><tt><tt>gif slice + foo.gif<br> + </tt></tt> gif</tt><br> + <tt><tt>gif</tt> <tt>new<br> + </tt> gif</tt> <tt>slice</tt> + <p><b><a name="grid" id="grid"></a>grid</b></p> + <p>Controls coordinate grid. For grid numeric format syntax, + click <a href="grid.html#Format">here</a>.</p> + <tt>Syntax:<br> + grid []<br> + [yes|no]<br> + [type analysis|publication]<br> + [system <coordsys>]<br> + [sky <skyframe>]<br> + [skyformat <skyformat>]<br> + [grid yes|no]<br> + [grid color <color>]<br> + [grid width <value>]<br> + [grid dash yes|no]<br> + [grid gap1 <value>]<br> + </tt> + <tt><tt> [grid gap2 + <value>]<br> + </tt></tt> + <tt><tt><tt> [grid gap3 + <value>]<br> + </tt></tt> [axes + yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes dash yes|no]<br> + [axes type + interior|exterior]<br> + </tt> <tt> + [axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> + <tt> [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks dash yes|no]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border dash yes|no]<br> + [numerics yes|no]<br> + [numerics font + times|helvetica|courier]<br> + [numerics fontsize + <value>]<br> + [numerics fontweight + normal|bold]<br> + [numerics fontslant + roman|italic]<br> + [numerics color <color>]<br> + [numerics gap1 + <value>]<br> + </tt> <tt><tt> + [numerics gap2 <value>]<br> + </tt></tt> + <tt><tt><tt> [numerics gap3 + <value>]<br> + </tt></tt> + [numerics type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font + times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + [labels text1 <text>]<br> + </tt> + <tt><tt> [labels text2 + <text>]<br> + </tt> [labels def1 + yes|no]<br> + [labels def2 yes|no]<br> + </tt> + <tt><tt> [labels gap1 + <value>]<br> + </tt> [labels gap2 + <value>]<br> + [labels font + times|helvetica|courier]<br> + [labels fontsize <value>]<br> + [labels fontweight normal|bold]<br> + [labels fontslant roman|italic]<br> + [labels color <color>]<br> + [reset]<br> + [load <filename>]<br> + [save <filename>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + grid<br> + grid type<br> + grid system<br> + grid sky<br> + grid skyformat<br> + grid grid<br> + grid grid color<br> + grid grid width<br> + grid grid dash<br> + grid grid gap1<br> + </tt> <tt><tt>grid grid gap2<br> + </tt></tt> + <tt><tt><tt>grid grid gap3<br> + </tt></tt> grid axes<br> + grid axes color<br> + grid axes width<br> + grid axes dash<br> + grid axes type<br> + grid axes origin<br> + grid format1<br> + grid format2<br> + grid tickmarks<br> + grid tickmarks color<br> + grid tickmarks width<br> + grid tickmarks dash<br> + grid border<br> + grid border color<br> + grid border width<br> + grid border dash<br> + grid numerics<br> + grid numerics font<br> + grid numerics fontsize<br> + grid numerics fontweight<br> + grid numerics fontslant<br> + grid numerics color<br> + grid numerics gap1<br> + </tt> <tt><tt>grid numerics + gap2<br> + </tt></tt> <tt><tt><tt>grid numerics gap3<br> + </tt></tt> + grid numerics type<br> + grid numerics vertical<br> + grid title<br> + grid title text<br> + grid title def<br> + grid title gap<br> + grid title font<br> + grid title fontsize<br> + grid title fontweight<br> + grid title fontslant<br> + grid title color<br> + grid labels<br> + grid labels text1<br> + </tt> <tt><tt>grid labels text2<br> + </tt> grid + labels def1<br> + grid labels def2<br> + </tt> <tt><tt>grid labels gap1<br> + </tt> grid + labels gap2<br> + grid labels font<br> + grid labels fontsize<br> + grid labels fontweight<br> + grid labels fontslant<br> + grid labels color<br> + ds9.set(string cmd)<br> + grid<br> + grid yes<br> + grid type analysis<br> + grid system wcs<br> + grid sky fk5<br> + grid skyformat degrees<br> + grid grid yes<br> + grid grid color red<br> + grid grid width 2<br> + grid grid dash yes<br> + grid grid gap1 10<br> + </tt> <tt><tt>grid grid gap2 10<br> + </tt></tt> + <tt><tt><tt>grid grid gap3 10<br> + </tt></tt> grid axes yes<br> + grid axes color red<br> + grid axes width 2<br> + grid axes dash yes<br> + grid axes type exterior<br> + grid axes origin lll<br> + grid format1 d.2<br> + grid format2 d.2<br> + grid tickmarks yes<br> + grid tickmarks color red<br> + grid tickmarks width 2<br> + grid tickmarks dash yes<br> + grid border yes<br> + grid border color red<br> + grid border width 2<br> + grid border dash yes<br> + grid numerics yes<br> + grid numerics font courier<br> + grid numerics fontsize 12<br> + grid numerics fontweight bold<br> + grid numerics fontslant italic<br> + grid numerics color red<br> + grid numerics gap1 10<br> + </tt> <tt><tt>grid numerics gap2 + 10<br> + </tt></tt> <tt><tt><tt>grid numerics gap3 10<br> + </tt></tt> + grid numerics type exterior<br> + grid numerics vertical yes<br> + grid title yes<br> + grid title text {Hello World}<br> + grid title def yes<br> + grid title gap 10<br> + grid title fontsize 12<br> + grid title font courier<br> + grid title fontweight bold<br> + grid title fontslant italic<br> + grid title color red<br> + grid labels yes<br> + grid labels text1 {Hello World}<br> + </tt> <tt><tt>grid labels text2 + {Hello World}<br> + </tt> grid labels def1 yes<br> + grid labels def2 yes<br> + </tt> <tt><tt>grid labels gap1 10<br> + </tt> + grid labels gap2 10<br> + grid labels font courier<br> + grid labels fontsize 12<br> + grid labels fontweight bold<br> + grid labels fontslant italic<br> + grid labels color red<br> + grid reset<br> + grid load foo.grd<br> + grid save foo.grd<br> + grid open<br> + grid close<br> + </tt> + <p><b><a name="header" id="header"></a>header</b></p> + <p>Display current fits header dialog. Optional extension number + maybe specified. Please note, this differs from samp fits + header.</p> + <tt>Syntax:<br> + header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] + <filename>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + header<br> + header 2<br> + header close<br> + </tt> + <p><b><a name="height" id="height"></a>height</b></p> + <p>Set the height of the image display window.</p> + <tt>Syntax:<br> + height [<value>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + height<br> + ds9.set(string cmd)<br> + height 512<br> + </tt> + <p><b><a name="iconify" id="iconify"></a>iconify</b></p> + <p>Toggles iconification.</p> + <tt>Syntax:<br> + iconify []<br> + [yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + iconify<br> + ds9.set(string cmd)<br> + iconify<br> + iconify yes</tt><br> + <p><b><a name="iexam" id="iexam"></a>iexam</b></p> + <p>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 + <tt>button</tt>. In the last form, the following macros will be + expanded if present: <tt>$width, $height, $depth, $bitpix, + $filename, $regions, $filename[$regions], $env, $pan, $value, + $x, + $y, $z.</tt> See <a + href="file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis + Macros</a> for more information.</p> + <tt>Syntax:<br> + iexam []<br> + </tt> <tt><tt> + [[]|button|key|any] coordinate <coordsys> + [<skyframe>] + [<skyformat>]<br> + [[]|button|key|any] data + [width][height]<br> + </tt> <tt><tt> + [[]|button|key|any] <macro string>]<br> + </tt></tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt> <tt><tt>iexam<br> + </tt> + iexam coordinate image<br> + iexam key coordinate image # return coordinate and key event<br> + iexam coordinate wcs fk5 degrees<br> + iexam coordinate wcs galactic sexagesimal<br> + iexam coordinate fk5<br> + iexam data # return data value<br> + iexam key data # return data value and key event<br> + iexam data 3 3 # return all data in 3x3 box about selected + point<br> + iexam {'Click at $x,$y in file $filename'}</tt><br> + <p><b><a name="iis" id="iis"></a>iis</b></p> + <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> + <tt>Syntax:<br> + iis [filename <filename> [#]]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + iis filename<br> + iis filename 4<br> + ds9.set(string cmd)<br> + iis filename foo.fits<br> + iis filename bar.fits 4</tt><br> + <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> + <p>Load JPEG image into current frame. Optional parameters: + <tt>jpeg</tt> quality (1-100)</p> + <tt>Syntax:<br> + jpeg [new|slice] [<filename>] [1-100]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> jpeg</tt><br> + <tt><tt>jpeg 100</tt><br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> + jpeg foo.jpeg</tt><br> + <tt><tt>jpeg new foo.jpeg<br> + </tt></tt> <tt><tt><tt>jpeg slice + foo.jpeg<br> + </tt></tt> jpeg</tt><br> + <tt><tt>jpeg</tt> <tt>new<br> + </tt> jpeg</tt> <tt>slice</tt> + <p><b><a name="lock" id="lock"></a>lock</b></p> + <p>Lock all other frames to the current frame.</p> + <tt>Syntax:<br> + </tt> <tt>lock</tt> <tt>[frame + <coordsys>|none]<br> + </tt> <tt>[crosshair + <coordsys>|none]</tt> <tt><br> + </tt> + <tt> [crop <coordsys>|none]</tt><br> + <tt> [slice <coordsys>|none]</tt><br> + <tt> [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimits [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + </tt> + <tt> [smooth [yes|no]]</tt><tt><br> + </tt> + <tt> [3d [yes|no]]</tt><tt><br> + </tt> + <tt> </tt> <tt><br> + Example:<br> + </tt> <tt>string value = ds9.get(string cmd)<br> + </tt> + <tt>lock frame<br> + lock crosshair<br> + </tt> <tt>lock crop</tt><br> + <tt>lock slice</tt><br> + <tt>lock bin<br> + lock axes<br> + lock scale<br> + lock scalelimits<br> + lock color</tt><tt>bar<br> + lock block<br> + </tt> <tt>lock smooth<br> + </tt> <tt>lock 3d<br> + </tt> + <tt>ds9.set(string cmd)<br> + </tt> <tt>lock frame + wcs</tt><tt><br> + </tt> <tt>lock crosshair wcs<br> + </tt> <tt>lock crop + wcs</tt><br> + <tt>lock slice wcs</tt><br> + <tt>lock bin yes<br> + lock axes yes<br> + </tt> <tt>lock scale yes<br> + lock scalelimits yes<br> + </tt> <tt>lock colorbar yes</tt><tt><br> + lock block yes</tt><br> + <tt>lock smooth yes<br> + </tt> <tt>lock 3d yes<br> + <br> + </tt> <b><a name="lower" id="lower"></a>lower</b> + <p>Lower in the window stacking order.</p> + <tt>Syntax:<br> + lower<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + lower</tt><tt><br> + </tt> + <p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> + <p>Controls the magnifier settings.</p> + <tt>Syntax:<br> + magnifier [color <color>]<br> + [zoom + <value>]<br> + [cursor + yes|no]<br> + [region + yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + magnifier color<br> + magnifier zoom<br> + magnifier cursor<br> + magnifier region<br> + ds9.set(string cmd)<br> + magnifier color yellow<br> + magnifier zoom 2<br> + magnifier cursor no<br> + magnifier region no<br> + </tt> + <p><b><a name="mask" id="mask"></a>mask<br> + </b></p> + <p>Controls mask parameters.</p> + <tt>Syntax:<br> + mask [color <color>]<br> + [mark 1|0]<br> + [transparency <value>]<br> + [clear]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + mask color<br> + mask mark<br> + mask transparency<br> + ds9.set(string cmd)<br> + mask color red<br> + mask mark 0<br> + mask transparency 50<br> + mask clear<br> + mask open<br> + mask close<br> + </tt> + <p><b><a name="match" id="match"></a>match</b></p> + <p>Match all other frames to the current frame.</p> + <tt>Syntax:<br> + </tt> <tt>match</tt> <tt>[frame + <coordsys>]<br> + </tt> <tt>[crosshair + <coordsys>]</tt> <tt><br> + </tt> + <tt> [crop <coordsys>]<br> + </tt> + <tt> [slice + <coordsys>]<br> + </tt> <tt> + [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]</tt><tt><br> + [3d]<br> + </tt> <tt> <br> + Example:<br> + ds9.set(string cmd)<br> + </tt> <tt>match frame wcs<br> + </tt> <tt>match + crosshair wcs<br> + </tt> <tt>match crop wcs</tt><br> + <tt>match slice wcs<br> + match bin<br> + match axes<br> + match scale<br> + match scalelimits<br> + match color</tt><tt>bar<br> + match block<br> + match smooth<br> + match 3d<br> + </tt> + <p><b><a name="mecube" id="mecube"></a>mecube</b></p> + <p>Load FITS multiple extension file as data cube.<br> + </p> + <tt>Syntax:<br> + mecube [new] [<filename>]<br> + <br> + Example:</tt><br> + <tt>string value = ds9.get(string cmd)</tt><tt><tt><br> + </tt> + mecube<br> + </tt> <tt><tt><tt>ds9.set(string cmd)<br> + </tt></tt> + mecube foo.fits</tt><br> + <tt><tt>mecube new foo.fits<br> + </tt> mecube</tt><br> + <tt>mecube</tt> <tt>new</tt> + <p><b><a name="minmax" id="minmax"></a>minmax</b></p> + <p>This is how DS9 determines the min and max data values + from the data. <tt>SCAN</tt> will scan all data.</p> + <tt>Syntax:<br> + minmax [scan|sample|datamin|irafmin]<br> + [mode + scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + minmax mode<br> + minmax sample<br> + ds9.set(string cmd)<br> + minmax scan<br> + minmax mode scan<br> + minmax interval 100<br> + </tt> + <p><b><a name="mode" id="mode"></a>mode</b></p> + <p>Controls the first mouse button mode.</p> + <tt>Syntax:<br> + mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + mode<br> + ds9.set(string cmd)<br> + mode crosshair</tt><br> + <p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> + <p>Load FITS mosaic segment into current frame.</p> + <tt>Syntax:<br> + mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> mosaic</tt><tt><br> + </tt> <tt><tt>ds9.set(string + cmd)<br> + </tt> mosaic foo.fits</tt><br> + <tt><tt>mosaic wcs foo.fits</tt></tt><br> + <tt><tt>mosaic wcs new foo.fits</tt></tt><br> + <tt><tt>mosaic wcs mask + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> mosaic</tt><br> + <tt><tt>mosaic wcs<br> + mosaic wcs</tt> <tt>new<br> + </tt> mosaic wcs</tt> <tt>mask<br> + </tt> + <p><b><a name="mosaicimage" id="mosaicimage"></a>mosaicimage</b></p> + <p>Load FITS mosaic image into current frame.</p> + <tt>Syntax:<br> + mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] + [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> mosaicimage</tt><tt><br> + </tt> <tt><tt>ds9.set(string + cmd)<br> + </tt> mosaicimage foo.fits</tt><br> + <tt><tt>mosaicimage wcs foo.fits</tt></tt><br> + <tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> + <tt><tt>mosaicimage wcs mask + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> mosaicimage</tt><br> + <tt><tt>mosaicimage wcs<br> + mosaicimage wcs new</tt><tt><br> + </tt> mosaicimage wcs mask</tt> + <p><b><a name="movie" id="movie"></a>movie</b></p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A + <tt>slice</tt> movie cycles though all slices of a cube. A + <tt>frame</tt> movie cycles through all active frames. A + <tt>3d</tt> movie cycles through specified viewing angles. The + default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times.</p> + <tt>Syntax:<br> + movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br> + </tt> + <tt>movie 3d <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>]</tt><br> + <tt> <br> + Example:<br> + ds9.set(string cmd)<br> + movie slice ds9.mpg<br> + </tt> <tt>movie 3d ds9.mpg number 10 azfrom + -60 azto 60 oscillate 1</tt><br> + <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> + <p>Load FITS multiple extension file as multiple images.<br> + </p> + <tt>Syntax:<br> + multiframe [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> multiframe + foo.fits</tt><tt><tt><br> + </tt> multiframe</tt><br> + <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> + <p>Support Name Server functions. Coordinates are in fk5.</p> + <tt>Syntax:<br> + nameserver [<object>]<br> + + [name + <object>]<br> + + [server + ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> + + [skyformat degrees|sexagesimal]<br> + + [pan]<br> + + [crosshair]<br> + [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + nameserver<br> + nameserver server<br> + nameserver skyformat<br> + nameserver m31<br> + ds9.set(string cmd)<br> + nameserver m31<br> + nameserver name m31<br> + nameserver server ned-sao<br> + nameserver skyformat sexagesimal<br> + nameserver pan<br> + nameserver crosshair<br> + nameserver open<br> + nameserver close<br> + </tt> + <p><b><a name="nan" id="nan"></a>nan</b></p> + <p>Set image not-a-number color.</p> + <tt>Syntax:<br> + nan <color><br> + <br> + Example:<br> + </tt> <tt>string value = ds9.get(string cmd)<br> + nan</tt><br> + <tt>ds9.set(string cmd)<br> + nan red</tt><br> + <p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> + <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: + array endian.<br> + </p> + <tt>Syntax:<br> + nrrd [native|little|big]<br> + nrrd [new|mask] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> nrrd</tt><br> + <tt><tt>nrrd big<br> + </tt></tt> <tt><tt><tt>ds9.set(string + cmd</tt><tt>, string url</tt><tt>)<br> + </tt> nrrd + foo.nrrd</tt></tt><br> + <tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt>nrrd mask + foo.nrrd<br> + </tt></tt></tt></tt></tt> nrrd</tt><br> + <tt>nrrd</tt> <tt>new<br> + nrrd mask</tt><br> + <p><b><a name="nvss" id="nvss"></a>nvss</b></p> + <p>Support for NRAO VLA Sky Survey.</p> + <tt>Syntax:<br> + nvss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + nvss name<br> + nvss coord<br> + nvss size<br> + nvss save<br> + nvss frame<br> + ds9.set(string cmd)<br> + nvss<br> + nvss m31<br> + </tt> <tt><tt>nvss name m31<br> + </tt></tt> + <tt><tt><tt>nvss name clear<br> + </tt></tt> nvss 00:42:44.404 + +41:16:08.78<br> + nvss size 60 60 arcmin<br> + nvss save yes<br> + nvss frame current<br> + nvss update frame<br> + nvss open<br> + nvss close<br> + </tt> + <p><b><a name="orient" id="orient"></a>orient</b></p> + <p>Controls the orientation of the current frame.</p> + <tt>Syntax:<br> + orient [none|x|y|xy]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + orient<br> + ds9.set(string cmd)<br> + orient xy<br> + orient open<br> + orient close<br> + </tt> + <p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> + <p>Controls Page Setup options.</p> + <tt>Syntax:<br> + pagesetup [orient portrait|landscape]</tt><br> + <tt> [scale + <numeric>]</tt><br> + <tt> [size + letter|legal|tabloid|poster|a4]</tt><br> + <tt> <br> + Example:<br> + string value = ds9.get(string cmd)<br> + pagesetup orient<br> + pagesetup scale<br> + pagesetup size<br> + ds9.set(string cmd)<br> + pagesetup orient portrait<br> + pagesetup scale 50<br> + pagesetup size poster<br> + </tt> + <p><b><a name="pan" id="pan"></a>pan</b></p> + <p>Controls the current image cursor location for the current + frame.</p> + <tt>Syntax:<br> + </tt><tt><tt>pan [<coordsys> [<skyframe>] + [<skyformat>]] # get current coords<br> + <br> + </tt>pan [<x> <y> <coordsys> + [<skyframe>]] # relative<br> + [to <x> <y> <coordsys> + [<skyframe>]] # absolute<br> + [open|close]<br> + [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + pan # get current image coords<br> + pan wcs fk4 sexagesimal # get current wcs coords<br> + ds9.set(string cmd)<br> + pan 200 200 image # pan relative<br> + pan to 400 400 physical # pan to physical coords<br> + pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords<br> + pan open<br> + pan close<br> + </tt> + <p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> + <p>Display/Hide the pixel table.</p> + <tt>Syntax:<br> + pixeltable []<br> + [yes|open]<br> + [no|close]<br> + <br> + Example:<br> + string url = ds9.get(string cmd)<br> + pixeltable<br> + ds9.set(string cmd)<br> + pixeltable<br> + pixeltable yes<br> + pixeltable open<br> + pixeltable close<br> + </tt> + <p><b><a name="plot" id="plot"></a>plot</b></p> + <p>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:</p> + <blockquote>xy x and y coordinates<br> + xyex x,y coordinates with x errors<br> + xyey x,y coordinates with y errors<br> + xyexey x,y coordinates with x and y + errors<br> + </blockquote> + <p>To create a new plot, use the plot new command.</p> + <tt>Syntax:</tt><tt><br> + </tt> <tt># create new empty plot + window</tt><tt><br> + </tt> <tt>plot []</tt><tt><br> + </tt> + <tt> [line|bar|scatter]</tt><tt><br> + </tt> + <tt> [new]</tt><tt><br> + </tt> + <tt> [new + line|bar|scatter]</tt><tt><br> + </tt> <tt> + [new name <plotname>]</tt><tt><br> + </tt> + <tt> [new name <plotname> + line|bar|scatter]</tt><tt><br> + </tt> <tt><br> + </tt> <tt>#</tt> + <tt>load data into existing plot from stdin</tt><tt><br> + </tt> + <tt>plot [[<plotname>] data + xy|xyex|xyey|xyexey]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># existing + plot</tt><tt><br> + </tt> <tt>plot</tt> <tt>[[<plotname>] load + <filename> xy|xyex|xyey|xyexey]</tt><tt><br> + </tt> + <tt> [[<plotname>] save + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] clear]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + duplicate + [#]]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] stats yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] list + yes|no]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] loadconfig + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] saveconfig <filename>]</tt><tt><br> + </tt> + <tt> [[<plotname>] pagesetup orient + portrait|landscape]</tt><tt><br> + </tt> <tt> + [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4]</tt><tt><br> + </tt> + <tt> [[<plotname>] + print]</tt><tt><br> + </tt> <tt> + [[<plotname>] print destination + printer|file]</tt><tt><br> + </tt> <tt> + [[<plotname>] print command + <command>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print filename + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print color rgb|gray]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + close</tt><tt>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> + </tt> + <tt><br> + </tt> <tt># configure graph</tt><tt><br> + </tt> <tt>plot + [[<plotname>] axis x|y grid yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y log + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y flip yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y auto + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y min <value>]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y max + <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y format + <string>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] legend yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] legend position + right|left|top|bottom]</tt><tt><br> + </tt> <tt> + [[<plotname>] font title|labels|numbers font + times|helvetica|courier]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>size <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>weight normal|bold]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>slant roman|italic]</tt><tt><br> + </tt> <tt> + [[<plotname>] title <string>]</tt><tt><br> + </tt> + <tt> [[<plotname>] title x|y + <string>]</tt><tt><br> + </tt> <tt> + [</tt><tt>[<plotname>] barmode + normal|stacked|aligned|overlap]</tt><tt><br> + </tt> <tt><br> + </tt> + <tt># configure current dataset</tt><tt><br> + </tt> <tt>plot + [[<plotname>] show yes|no]</tt><tt><br> + </tt> <tt> + </tt> <tt>[[<plotname>] shape + circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> + </tt> <tt> </tt> <tt>[[<plotname>] + shape fill yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] shape + color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] smooth + step|linear|cubic|quadratic|catrom]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] color + <value>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] dash + yes|no]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] error yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] error + color <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] error + width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] name + <string>]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># select + current dataset</tt><tt><br> + </tt> <tt>plot [[<plotname>] + select <value>]</tt><tt><br> + </tt> <tt> </tt> <tt><br> + </tt> <tt>Example:</tt><tt><br> + </tt> <tt># return all + plotnames</tt><tt><br> + </tt> <tt>string value = ds9.get(string + cmd)</tt><tt><br> + </tt> <tt>plot</tt><tt><br> + </tt> <tt><br> + </tt> + <tt># create new empty plot window</tt><tt><br> + </tt> + <tt>ds9.set(string cmd)</tt><tt><br> + </tt> + <tt>plot</tt><tt><br> + </tt> <tt>plot bar</tt><tt><br> + </tt> <tt>plot + new</tt><tt><br> + </tt> <tt>plot new bar</tt><tt><br> + </tt> <tt>plot + new name foo</tt><tt><br> + </tt> <tt>plot new name foo + bar</tt><tt><br> + </tt> <tt><br> + </tt> <tt># load additional dataset + into an existing plot</tt><tt><br> + </tt> <tt>ds9.set(string cmd, + string url)</tt><tt><br> + </tt> <tt>plot data xy # plot additional + data</tt><tt><br> + </tt> <tt>plot foo data xy # plot additional + data</tt><tt><br> + </tt> <tt><br> + </tt> <tt>string value = + ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot + stats</tt><tt><br> + </tt> <tt>plot list</tt><tt><br> + </tt> + <tt>ds9.set(string cmd)</tt><tt><br> + </tt> <tt>plot load foo.dat + xy</tt><tt><br> + </tt> <tt>plot save foo.dat</tt><tt><br> + </tt> + <tt>plot clear</tt><tt><br> + </tt> <tt>plot duplicate + 1</tt><tt><br> + </tt> <tt>plot stats yes</tt><tt><br> + </tt> <tt>plot + list yes</tt><tt><br> + </tt> <tt>plot loadconfig + foo.plt</tt><tt><br> + </tt> <tt>plot saveconfig + foo.plt</tt><tt><br> + </tt> <tt>plot pagesetup orient + portrait</tt><tt><br> + </tt> <tt>plot pagesetup size + letter</tt><tt><br> + </tt> <tt>plot print</tt><tt><br> + </tt> <tt>plot + print destination file</tt><tt><br> + </tt> <tt>plot print command + lp</tt><tt><br> + </tt> <tt>plot print filename + foo.ps</tt><tt><br> + </tt> <tt>plot print color rgb</tt><tt><br> + </tt> + <tt>plot close</tt><tt><br> + </tt> <tt><br> + </tt> <tt>string value = + ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot + mode</tt><tt><br> + </tt> <tt>ds9.set(string cmd)</tt><tt><br> + </tt> + <tt>plot mode pointer</tt><tt><br> + </tt> <tt><br> + </tt> <tt># + configure plot</tt><tt><br> + </tt> <tt>string value = ds9.get(string + cmd)</tt><tt><br> + </tt> <tt>plot axis x grid</tt><tt><br> + </tt> + <tt>plot axis x log</tt><tt><br> + </tt> <tt>plot axis x + flip</tt><tt><br> + </tt> <tt>plot axis x auto</tt><tt><br> + </tt> + <tt>plot axis x min</tt><tt><br> + </tt> <tt>plot axis x + max</tt><tt><br> + </tt> <tt>plot axis x format</tt><tt><br> + </tt> + <tt>plot legend</tt><tt><br> + </tt> <tt>plot legend + position</tt><tt><br> + </tt> <tt>plot font numbers + font</tt><tt><br> + </tt> <tt>plot font numbers size</tt><tt><br> + </tt> + <tt>plot font numbers weight</tt><tt><br> + </tt> <tt>plot font + numbers slant</tt><tt><br> + </tt> <tt>plot title</tt><tt><br> + </tt> + <tt>plot title x</tt><tt><br> + </tt> <tt>plot + barmode</tt><tt><br> + </tt> <tt>ds9.set(string cmd)</tt><tt><br> + </tt> + <tt>plot axis x grid yes</tt><tt><br> + </tt> <tt>plot axis x log + yes</tt><tt><br> + </tt> <tt>plot axis x flip yes</tt><tt><br> + </tt> + <tt>plot axis x auto no</tt><tt><br> + </tt> <tt>plot axis x min + 0</tt><tt><br> + </tt> <tt>plot axis x max 100</tt><tt><br> + </tt> + <tt>plot axis x format "%f"</tt><tt><br> + </tt> <tt><br> + </tt> + <tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot + legend</tt><tt><br> + </tt> <tt>plot legend position</tt><tt><br> + </tt> + <tt>ds9.set(string cmd)</tt><tt><br> + </tt> <tt>plot legend + yes</tt><tt><br> + </tt> <tt>plot legend position + left</tt><tt><br> + </tt> <tt><br> + </tt> <tt>string value = + ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot font numbers + font</tt><tt><br> + </tt> <tt>plot font numbers size</tt><tt><br> + </tt> + <tt>plot font numbers weight</tt><tt><br> + </tt> <tt>plot font + numbers slant</tt><tt><br> + </tt> <tt>ds9.set(string + cmd)</tt><tt><br> + </tt> <tt>plot font numbers font + times</tt><tt><br> + </tt> <tt>plot font numbers size + 12</tt><tt><br> + </tt> <tt>plot font numbers weight + bold</tt><tt><br> + </tt> <tt>plot font numbers slant + italic</tt><tt><br> + </tt> <tt><br> + </tt> <tt>string value = + ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot + title</tt><tt><br> + </tt> <tt>plot title xaxis</tt><tt><br> + </tt> + <tt>plot title yaxis</tt><tt><br> + </tt> <tt>ds9.set(string + cmd)</tt><tt><br> + </tt> <tt>plot title "This is a + Title"</tt><tt><br> + </tt> <tt>plot title x "X + Axis"</tt><tt><br> + </tt> <tt>plot title y "Y Axis"</tt><tt><br> + </tt> + <tt>plot title legend "This is the Legend"</tt><tt><br> + </tt> + <tt><br> + </tt> <tt>string value = ds9.get(string + cmd)</tt><tt><br> + </tt> <tt>plot barmode</tt><tt><br> + </tt> + <tt>ds9.set(string cmd)</tt><tt><br> + </tt> <tt>plot barmode + aligned</tt><tt><br> + </tt> <tt><br> + </tt> <tt># configure current + dataset</tt><tt><br> + </tt> <tt>string value = ds9.get(string + cmd)</tt><tt><br> + </tt> <tt>plot show</tt><tt><br> + </tt> <tt>plot + shape</tt><tt><br> + </tt> <tt>plot shape fill</tt><tt><br> + </tt> + <tt>plot shape color</tt><tt><br> + </tt> <tt>plot + smooth</tt><tt><br> + </tt> <tt>plot color</tt><tt><br> + </tt> <tt>plot + width</tt><tt><br> + </tt> <tt>plot dash</tt><tt><br> + </tt> <tt>plot + error</tt><tt><br> + </tt> <tt>plot error color</tt><tt><br> + </tt> + <tt>plot error width</tt><tt><br> + </tt> <tt>plot + name</tt><tt><br> + </tt> <tt>ds9.set(string cmd)</tt><tt><br> + </tt> + <tt>plot show yes</tt><tt><br> + </tt> <tt>plot shape + circle</tt><tt><br> + </tt> <tt>plot shape fill no</tt><tt><br> + </tt> + <tt>plot shape color cyan</tt><tt><br> + </tt> <tt>plot smooth + step</tt><tt><br> + </tt> <tt>plot color red</tt><tt><br> + </tt> + <tt>plot width 2</tt><tt><br> + </tt> <tt>plot dash + yes</tt><tt><br> + </tt> <tt>plot error yes</tt><tt><br> + </tt> <tt>plot + error color red</tt><tt><br> + </tt> <tt>plot error width + 2</tt><tt><br> + </tt> <tt>plot name "My Data"</tt><tt><br> + </tt> + <tt><br> + </tt> <tt># select current dataset</tt><tt><br> + </tt> + <tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt> <tt>plot + select</tt><tt><br> + </tt> <tt>ds9.set(string cmd)<br> + plot select 2<br> + <br> + </tt> <b><a name="png" id="png"></a>png</b> + <p>Load PNG image into current frame.<br> + </p> + <tt>Syntax:<br> + png [new|slice] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> png</tt><br> + <tt><tt>ds9.set(string cmd)<br> + </tt> png foo.png</tt><br> + <tt><tt>png new foo.png<br> + </tt></tt> <tt><tt><tt>png slice + foo.png<br> + </tt></tt> png</tt><br> + <tt><tt>png</tt> <tt>new<br> + </tt> png</tt> <tt>slice</tt><br> + <p><b><a name="precision" id="precision"></a>precision</b></p> + <p>Set region and coordinate output format precision.</p> + <tt>Syntax:<br> + precision <linear></tt> <tt><tt><degree></tt></tt> + <tt><tt><hms></tt></tt> + <tt><tt><tt><dms></tt></tt></tt> + <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><arcsec><br> + <br> + </tt></tt></tt></tt> Example:<br> + string value = ds9.get(string cmd)<br> + precision<br> + ds9.set(string cmd)<br> + precision 8 10 4 3 5 3</tt><br> + <p><b><a name="prefs" id="prefs"></a>prefs</b></p> + <p>Controls various preference settings.</p> + <tt>Syntax:<br> + prefs [clear]<br> + [irafalign yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + prefs irafalign<br> + ds9.set(string cmd)<br> + prefs clear<br> + prefs irafalign<br> + <br> + </tt> <b><a name="preserve" id="preserve"></a>preserve</b> + <p>Preserve the follow attributes while loading a new image.</p> + <tt>Syntax:<br> + preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + preserve pan<br> + preserve regions<br> + ds9.set(string cmd)<br> + preserve pan yes<br> + preserve regions yes<br> + </tt> + <p><b><a name="psprint" id="psprint"></a>psprint</b></p> + <p>Invokes postscript printing. Please see <a + href="file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> + for further details.</p> + <p><b><a name="print" id="print"></a>print</b></p> + <p>Controls printing. Use print option to set printing options.</p> + <tt>Syntax:<br> + print [destination printer|file]<br> + [command <command>]<br> + [filename <filename>]<br> + [color rgb|cmyk|gray]<br> + [level 1|2]<br> + [resolution + 53|72|75|150|300|600]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + print destination<br> + print command<br> + print filename<br> + print color<br> + print level<br> + print resolution<br> + ds9.set(string cmd)<br> + print<br> + print destination file<br> + print command lp<br> + print filename foo.ps<br> + print color cmyk<br> + print level 2<br> + print resolution 75</tt> + <p><b><a name="raise" id="raise"></a>raise</b></p> + <p>Raise in the window stacking order.</p> + <tt>Syntax:<br> + raise<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + raise</tt> + <p><b><a name="regions" id="regions"></a>regions</b></p> + <p>Controls regions in the current frame.</p> + <tt>Syntax:<br> + regions [<filename>]<br> + [load [all] + <filename>]<br> + [save + <filename>]<br> + [list [close]]<br> + [epsilon + <integer>]<br> + [show yes|no]<br> + [showtext yes|no]<br> + [centroid]<br> + [centroid auto + yes|no]<br> + [centroid radius + <value>|iteration <value>]<br> + [getinfo]<br> + [move front]<br> + [move back]<br> + [select all]<br> + [select none]<br> + [select invert]<br> + [delete all]<br> + [delete select]<br> + [format + ds9|xml|ciao|saotng|saoimage|pros|xy]<br> + [system + image|physical|wcs|wcsa...wcsz]<br> + [sky + fk4|fk5|icrs|galactic|ecliptic]<br> + [skyformat + degrees|sexagesimal]<br> + [strip yes|no]<br> + [shape + <shape>]<br> + [color + &ltcolor>]<br> + [width + <width>]<br> + </tt> <tt> + [fixed|edit|rotate|delete yes|no]<br> + + [include|exclude|source|background]</tt><br> + <tt> [command <marker + command>]<br> + [composite]<br> + [dissolve]<br> + [template + <filename>]<br> + [template <filename> + at + <ra> <dec> <coordsys> <skyframe>]<br> + [savetemplate + <filename>]<br> + [groups]<br> + [group new]<br> + [group <tag> + new]<br> + [group <tag> + update]<br> + [group <tag> + select]<br> + [group <tag> color + <color>]<br> + [group <tag> copy]<br> + [group <tag> + delete]<br> + [group <tag> cut]<br> + [group <tag> font + <font>]<br> + [group <tag> move + <int> <int>]<br> + [group <tag> + movefront]<br> + [group <tag> + moveback]<br> + [group <tag> + property + <property> yes|no]<br> + [copy]<br> + [cut]<br> + [paste + image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + + [include|exclude|source|background|selected]<br> + [-format + ds9|ciao|saotng|saoimage|pros|xy]<br> + [-system + image|physical|wcs|wcsa...wcsz]<br> + [-sky + fk4|fk5|icrs|galactic|ecliptic]<br> + [-skyformat + degrees|sexagesimal]<br> + [-prop + select|edit|move|rotate|delete|fixed|include|source 1|0]<br> + [-group <tag>]<br> + [-strip yes|no]<br> + [-wcs yes|no]<br> + <br> + Example:<br> + string url = ds9.get(string cmd)<br> + regions<br> + regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal + -prop edit 1 -group foo<br> + string value = ds9.get(string cmd)<br> + regions epsilon<br> + regions show<br> + regions showtext<br> + regions centroid<br> + regions centroid auto<br> + regions centroid radius<br> + regions centroid iteration<br> + regions selected<br> + regions format<br> + regions system<br> + regions sky<br> + regions skyformat<br> + regions strip<br> + regions shape<br> + regions color<br> + regions width<br> + regions source<br> + regions background<br> + regions include<br> + regions exclude<br> + regions selected<br> + regions groups<br> + ds9.set(string cmd, string url)<br> + regions -format xy -system wcs -sky fk5<br> + regions -format ds9<br> + ds9.set(string cmd)<br> + regions foo.reg<br> + regions -format ciao bar.reg # load as ciao format<br> + regions foo.fits # FITS regions files do not need a format + specification<br> + regions load foo.reg # load foo.reg into current frame<br> + regions load all foo.reg # load foo.reg into all frames<br> + regions load *.reg# expand *.reg and load into current frame<br> + regions load all *.reg # expand *.reg and load into all frames<br> + regions save foo.reg<br> + regions list<br> + regions list close<br> + regions epsilon 5<br> + regions show yes<br> + regions showtext no<br> + regions centroid<br> + regions centroid auto yes<br> + regions centroid radius 10<br> + regions centroid iteration 20<br> + regions getinfo<br> + regions move back<br> + regions move front<br> + regions select all<br> + regions select none<br> + regions select invert<br> + regions delete all<br> + regions delete select<br> + regions format ds9<br> + regions system wcs<br> + regions sky fk5<br> + regions skyformat degrees<br> + regions strip yes<br> + regions shape ellipse<br> + regions color red<br> + regions width 3<br> + regions edit yes<br> + regions include<br> + regions command "circle 100 100 20 # color=red"<br> + regions composite<br> + regions dissolve<br> + regions template foo.tpl<br> + regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> + regions savetemplate foo.tpl<br> + regions group new<br> + regions group foo new<br> + regions group foo update<br> + regions group foo select<br> + regions group foo color red<br> + regions group foo copy<br> + regions group foo delete<br> + regions group foo cut<br> + regions group foo font 'times 14 bold'<br> + regions group foo move 100 100<br> + regions group foo movefront<br> + regions group foo moveback<br> + regions group foo property delete no<br> + regions copy<br> + regions cut<br> + regions paste wcs<br> + regions undo<br> + </tt> + <p><b><a name="restore" id="restore"></a>restore</b></p> + <p>Restore DS9 to a previous state from a backup save set.</p> + <tt>Syntax:<br> + restore <filename><br> + <br> + Example:<br> + restore ds9.bck</tt><br> + <p><b><a name="rgb" id="rgb"></a>rgb</b></p> + <p>Create RGB frame and control RGB frame parameters.</p> + <tt>Syntax:<br> + rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + rgb channel<br> + </tt> <tt>rgb lock wcs</tt><br> + <tt>rgb lock crop</tt><br> + <tt>rgb lock slice</tt><br> + <tt>rgb lock bin<br> + rgb lock scale<br> + rgb lock scalelimits<br> + rgb lock colorbar<br> + rgb lock block<br> + rgb lock smooth<br> + rgb system<br> + rgb view red<br> + rgb view green<br> + rgb view blue<br> + ds9.set(string cmd)<br> + rgb # create new rgb frame<br> + rgb red # set current channel to red<br> + rgb channel red # set current channel to red<br> + rgb view blue no # turn off blue channel<br> + rgb system wcs # set rgb coordinate system<br> + </tt> <tt>rgb lock + wcs yes</tt><br> + <tt>rgb lock crop yes</tt><br> + <tt>rgb lock slice yes</tt><br> + <tt>rgb lock bin yes</tt><br> + <tt>rgb lock scale yes<br> + rgb lock scalelimits yes<br> + rgb lock colorbar yes<br> + rgb lock block yes<br> + rgb lock smooth yes<br> + rgb open<br> + rgb close</tt><br> + <p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> + <p>Load raw data array cube into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbarray [native|big|little]<br> + rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br></tt> <tt><tt><tt>string value = ds9.get(string -cmd)<br></tt></tt> rgbarray<br> -rgbarray little<br></tt> <tt><tt><tt>ds9.set(string -cmd)<br></tt></tt> rgbarray -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> -rgbarray new -foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> -<p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> -<p>Load FITS rgbcube into rgb frame.<br></p> -<tt>Syntax:<br> -rgbcube [new] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> rgbcube<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> -rgbcube foo.fits</tt><br> -<tt><tt>rgbcube new foo.fits<br></tt> rgbcube</tt><br> -<tt>rgbcube</tt> <tt>new</tt><br> -<p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> -<p>Load FITS rgbimage into rgb frame.<br></p> -<tt>Syntax:<br> -rgbimage [new] [<filename>]<br> - <br> -Example:<br></tt> <tt><tt><tt>string value = ds9.get(string -cmd)<br></tt></tt> rgbimage<br></tt> <tt><tt><tt>ds9.set(string -cmd)<br></tt></tt> rgbimage foo.fits</tt><br> -<tt><tt>rgbimage new foo.fits<br></tt> rgbimage</tt><br> -<tt>rgbimage</tt> <tt>new</tt> -<p><b><a name="rotate" id="rotate"></a>rotate</b></p> -<p>Controls the rotation angle (in degrees) of the current -frame.</p> -<tt>Syntax:<br> -rotate [<value>]<br> - [to <value>]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -rotate<br> -ds9.set(string cmd)<br> -rotate 45<br> -rotate to 30<br> -rotate open<br> -rotate close</tt><br> -<p><b><a name="samp" id="samp"></a>samp</b></p> -<p>Configure SAMP protocol.</p> -<tt>Syntax:<br> -samp [no|disconnect]<br> - [broadcast [image|table]]<br> - [send [image|table] -<application>]<br> - <br> -Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> samp -no<br></tt> <tt><tt>samp disconnect<br></tt> samp broadcast -image<br> -samp send image aladin</tt> -<p><b><a name="save" id="save"></a>save<br></b></p> -<p>Save loaded image data of current frame as FITS.</p> -<tt>Syntax:<br> -save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice]</tt><br> -<tt> <br> -Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> save -foo.fits</tt><br> -<tt>save fits foo.fits image</tt><br> -<tt>save fits foo.fits table<br> -save fits foo.fits slice</tt><br> -<tt>save rgbimage foo.fits<br></tt> <tt>save rgbcube -foo.fits</tt><br> -<tt>save mecube foo.fits</tt><br> -<tt>save mosaic foo.fits</tt><br> -<tt>save mosaicimage foo.fits</tt><br> -<p><b><a name="saveimage" id="saveimage"></a>saveimage</b></p> -<p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> -compression method.</p> -<tt>Syntax:<br> -saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> -<tt><filename><br> -saveimage <filename>.jpeg [1-100]<br> -saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -saveimage ds9.tiff<br> -saveimage jpeg ds9.jpeg 75</tt><br> -<p><b><a name="scale" id="scale"></a>scale</b></p> -<p>Controls the limits and color scale distribution.</p> -<tt>Syntax:<br> -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [datasec yes|no]<br> - [limits <minvalue> -<maxvalue>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope local|global]<br> - [match]<br> - [match limits]<br> - [lock [yes|no]]<br> - [lock limits [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -scale<br> -scale log exp<br> -scale datasec<br> -scale limits<br> -scale mode<br> -scale scope<br> -scale lock<br> -scale lock limits<br> -ds9.set(string cmd)<br> -scale linear<br> -scale log exp 100<br> -scale datasec yes<br> -scale histequ<br> -scale limits 1 100<br> -scale mode zscale<br> -scale mode 99.5<br> -scale scope local<br> -scale match<br> -scale match limits<br> -scale lock yes<br> -scale lock limits yes<br> -scale open<br> -scale close<br></tt> -<p><b><a name="shm" id="shm"></a>shm</b></p> -<p>Load a shared memory segment into the current frame.</p> -<tt>Syntax:<br> -shm [<key> [<filename>]]<br> - [key <key> [<filename>]]<br> - [shmid <id> [<filename>]]<br> - [fits [key|shmid] <id> -[<filename>]]<br> - [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]]<br> - [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]]<br> - [rgbcube [key|shmid] <id> -[<filename>]<br> - [rgbimage [key|shmid] <id> -[<filename>]]<br> - [rgbarray [key|shmid] <id> + <br> + Example:<br> + </tt> <tt><tt><tt>string value = ds9.get(string + cmd)<br> + </tt></tt> rgbarray<br> + rgbarray little<br> + </tt> <tt><tt><tt>ds9.set(string + cmd)<br> + </tt></tt> rgbarray + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> + rgbarray new + foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> + <p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> + <p>Load FITS rgbcube into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbcube [new] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> rgbcube<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> + rgbcube foo.fits</tt><br> + <tt><tt>rgbcube new foo.fits<br> + </tt> rgbcube</tt><br> + <tt>rgbcube</tt> <tt>new</tt><br> + <p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> + <p>Load FITS rgbimage into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbimage [new] [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt><tt>string value = ds9.get(string + cmd)<br> + </tt></tt> rgbimage<br> + </tt> <tt><tt><tt>ds9.set(string + cmd)<br> + </tt></tt> rgbimage foo.fits</tt><br> + <tt><tt>rgbimage new foo.fits<br> + </tt> rgbimage</tt><br> + <tt>rgbimage</tt> <tt>new</tt> + <p><b><a name="rotate" id="rotate"></a>rotate</b></p> + <p>Controls the rotation angle (in degrees) of the current + frame.</p> + <tt>Syntax:<br> + rotate [<value>]<br> + [to <value>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + rotate<br> + ds9.set(string cmd)<br> + rotate 45<br> + rotate to 30<br> + rotate open<br> + rotate close</tt><br> + <p><b><a name="samp" id="samp"></a>samp</b></p> + <p>Configure SAMP protocol.</p> + <tt>Syntax:<br> + samp [no|disconnect]<br> + [broadcast [image|table]]<br> + [send [image|table] + <application>]<br> + <br> + Example:<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> samp + no<br> + </tt> <tt><tt>samp disconnect<br> + </tt> samp broadcast + image<br> + samp send image aladin</tt> + <p><b><a name="save" id="save"></a>save<br> + </b></p> + <p>Save loaded image data of current frame as FITS.</p> + <tt>Syntax:<br> + save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice]</tt><br> + <tt> <br> + Example:<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> save + foo.fits</tt><br> + <tt>save fits foo.fits image</tt><br> + <tt>save fits foo.fits table<br> + save fits foo.fits slice</tt><br> + <tt>save rgbimage foo.fits<br> + </tt> <tt>save rgbcube + foo.fits</tt><br> + <tt>save mecube foo.fits</tt><br> + <tt>save mosaic foo.fits</tt><br> + <tt>save mosaicimage foo.fits</tt><br> + <p><b><a name="saveimage" id="saveimage"></a>saveimage</b></p> + <p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> + compression method.</p> + <tt>Syntax:<br> + saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> + <tt><filename><br> + saveimage <filename>.jpeg [1-100]<br> + saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + saveimage ds9.tiff<br> + saveimage jpeg ds9.jpeg 75</tt><br> + <p><b><a name="scale" id="scale"></a>scale</b></p> + <p>Controls the limits and color scale distribution.</p> + <tt>Syntax:<br> + scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [datasec yes|no]<br> + [limits <minvalue> + <maxvalue>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + scale<br> + scale log exp<br> + scale datasec<br> + scale limits<br> + scale mode<br> + scale scope<br> + scale lock<br> + scale lock limits<br> + ds9.set(string cmd)<br> + scale linear<br> + scale log exp 100<br> + scale datasec yes<br> + scale histequ<br> + scale limits 1 100<br> + scale mode zscale<br> + scale mode 99.5<br> + scale scope local<br> + scale match<br> + scale match limits<br> + scale lock yes<br> + scale lock limits yes<br> + scale open<br> + scale close<br> + </tt> + <p><b><a name="shm" id="shm"></a>shm</b></p> + <p>Load a shared memory segment into the current frame.</p> + <tt>Syntax:<br> + shm [<key> [<filename>]]<br> + [key <key> [<filename>]]<br> + [shmid <id> [<filename>]]<br> + [fits [key|shmid] <id> + [<filename>]]<br> + [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]]<br> + [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] + <id> [<filename>]]<br> + [rgbcube [key|shmid] <id> + [<filename>]<br> + [rgbimage [key|shmid] <id> + [<filename>]]<br> + [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> - - [array [key|shmid] <id> + [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -shm<br> -ds9.set(string cmd)<br> -shm 102<br> -shm key 102<br> -shm shmid 102 foo<br> -shm fits key 100 foo<br> -shm mosaicimage iraf key 100 foo<br> -shm mosaicimage wcs key 100 foo<br> -shm mosaicimage wcsa key 100 foo<br> -shm mosaicimage wfpc2 key 100 foo<br> -shm mosaic iraf key 100 foo<br> -shm mosaic wcs key 100 foo<br> -shm rgbcube key 100 foo<br> -shm rgbimage key 100 foo<br> -shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> -shm array shmid 102 [dim=32,bitpix=-32]<br> -<br></tt> <b><a name="sia" id="sia"></a>sia<br></b> -<p>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.</p> -<tt>Syntax:<br> -sia</tt> -<tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> - -<br></tt> <tt> </tt><tt> -[<ref>] [cancel]<br></tt> <tt> - [<ref>] [clear]<br></tt> <tt> - [<ref>] [close]</tt><br> -<tt> [<ref>] [coordinate -<ra> <dec> <coordsys>]</tt><tt><br></tt> -<tt> </tt> -<tt>[<ref>] [crosshair]</tt><br> -<tt> [<ref>] -[export sb|tsv <filename>]<br></tt> <tt> - [<ref>] [name <object>]<br></tt> -<tt> [<ref>] [print]</tt><br> -<tt><tt> [<ref>] -[retrieve]</tt><br></tt> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] [radius -<value> degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> - [<ref>] [skyformat -<skyformat>]<br></tt> <tt> - [<ref>] [system -<coordsys>]</tt><tt><br></tt> <tt> - </tt> <tt>[<ref>] [update]</tt><br> - <tt><br> -Example:<br> -string value = ds9.get(string cmd)<br> -sia<br> -<br> -ds9.set(string cmd)<br> -sia</tt> <tt>2mass<br> -sia</tt> <tt>cancel<br> -sia</tt> <tt>clear<br> -sia</tt> <tt>close<br> -sia</tt> <tt>coordinate 202.48 47.21 fk5<br> -sia</tt> <tt>crosshair<br> -sia</tt> <tt>export tsv bar.tsv<br> -sia</tt> <tt>name m51<br> -sia</tt> <tt>print</tt><br> -<tt>sia</tt> <tt>retrieve<br> -sia</tt> <tt>save foo.xml<br> -sia</tt> <tt>radius 1degrees</tt><br> -<tt>sia</tt> <tt>sky fk5<br> -sia skyformat degrees<br> -sia</tt> <tt>system wcs</tt><tt><br> -sia</tt> <tt>update<br> -<br></tt> <b><a name="single" id="single"></a>single</b> -<p>Select Single Display mode</p> -<tt>Syntax:<br> -single<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -single<br> -ds9.set(string cmd)<br> -single<br></tt> -<p><b><a name="skyview" id="skyview"></a>skyview</b></p> -<p>Support for SkyView image server at HEASARC.</p> -<tt>Syntax:<br> -skyview []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] -# in wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [pixels <width> -<height>]<br> - [save yes|no]<br> - [frame new|current]<br> - [update -frame|crosshair]<br> - [survey <survey>]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -skyview name<br> -skyview coord<br> -skyview size<br> -skyview pixels<br> -skyview save<br> -skyview frame<br> -skyview survey<br> -ds9.set(string cmd)<br> -skyview<br> -skyview m31<br></tt> <tt><tt>skyview name m31<br></tt></tt> -<tt><tt><tt>skyview name clear<br></tt></tt> skyview 00:42:44.404 -+41:16:08.78<br> -skyview size 60 60 arcmin<br> -skyview pixels 600 600<br> -skyview save yes<br> -skyview frame current<br> -skyview update frame<br> -skyview survey sdssi<br> -skyview open<br> -skyview close<br></tt> -<p><b><a name="sleep" id="sleep"></a>sleep</b></p> -<p>Delays execution for specified number of seconds. Default is 1 -second.</p> -<tt>Syntax:<br> -sleep [#]<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -sleep<br> -sleep 2<br></tt> -<p><b><a name="smooth" id="smooth"></a>smooth</b></p> -<p>Smooth current image or set smooth parameters.<br> -Boxcar width = <i>2*radius+1</i><br> -Tophat diameter = <i>2*radius+1</i><br> -Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> -Elliptical Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i> -<tt>Syntax:</tt><br></p> -<tt>smooth []<br> - [yes|no]<br> - [function -boxcar|tophat|gaussian]<br></tt> -<tt> [radius -<value>]<br></tt> -<tt><tt><tt><tt> [radiusminor -<value>]<br></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> [sigma -<value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> -[sigmaminor <value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt> -[angle <value>]<br></tt></tt></tt></tt></tt></tt></tt></tt> -<tt> [match]<br> - [lock [yes|no]]</tt><br> -<tt><tt> [open|close]<br> - </tt><br> -Example:<br> -string value = ds9.get(string cmd)<br> -smooth<br> -smooth function<br></tt> <tt><tt>smooth radius<br></tt></tt> -<tt><tt><tt>smooth radiusminor<br> -smooth sigma<br> -smooth sigmaminor<br> -smooth angle<br></tt></tt> smooth lock<br> -ds9.set(string cmd)<br> -smooth<br> -smooth yes<br> -smooth function tophat<br></tt> <tt><tt>smooth radius -4<br></tt></tt> <tt><tt><tt><tt><tt><tt>smooth radiusminor -4<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigma -2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigmaminor -2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth angle -45<br></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> -smooth open<br> -smooth close<br> -smooth match<br> -smooth lock yes</tt><br> -<tt>smooth open<br> -smooth close<br></tt> -<p><b><a name="source" id="source"></a>source</b></p> -<p>Source TCL code from a file.</p> -<tt>Syntax:<br> -source [filename]<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -source foo.tcl</tt><br> -<p><b><a name="tcl" id="tcl"></a>tcl</b></p> -<p>Execute one TCL command.<br></p> -<tt>Syntax:<br> -tcl <tcl command><br> - <br> -Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> tcl {puts -{Hello, World}}<br></tt> -<p><b><a name="threads" id="threads"></a>threads</b></p> -<p>Set number of process threads for functions which are -multi-threaded.</p> -<tt>Syntax:<br> -threads #<br> - <br> -Example:<br></tt> <tt>string value = ds9.get(string cmd)<br></tt> -<tt>threads</tt><br> -<tt>ds9.set(string cmd)<br></tt> <tt>threads 8</tt><br> -<p><b><a name="tiff" id="tiff"></a>tiff</b></p> -<p>Load TIFF image into current frame. Optional parameters: -<tt>tiff</tt> compression method.</p> -<tt>Syntax:<br> -tiff [new|slice] [<filename>] -[none|jpeg|packbits|deflate]<br> - <br> -Example:<br></tt> <tt><tt>string value = ds9.get(string -cmd)<br></tt> tiff</tt><br> -<tt><tt>tiff jpeg</tt><br></tt> <tt><tt>ds9.set(string -cmd)<br></tt> tiff foo.tiff<br> -tiff new foo.tiff<br> -tiff slice foo.tiff</tt><tt><tt><br></tt> tiff<br> -tiff new<br> -tiff slice</tt><br> -<p><b><a name="tile" id="tile"></a>tile</b></p> -<p>Controls the tile display mode.</p> -<tt>Syntax:<br> -tile []<br> - [yes|no]<br> - [mode grid|column|row]<br> - [grid]<br> - [grid mode automatic|manual]<br> - [grid direction x|y]<br> - [grid layout <col> <row>]<br> - [grid gap <pixels>]<br> - [row]<br> - [column]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -tile<br> -tile mode<br> -tile grid mode<br> -tile grid direction<br> -tile grid layout<br> -tile grid gap<br> -ds9.set(string cmd)<br> -tile<br> -tile yes<br> -tile mode row<br> -tile grid<br> -tile grid mode manual<br> -tile grid direction x<br> -tile grid layout 5 5<br> -tile grid gap 10<br> -tile row<br> -tile column</tt> -<p><b><a name="update" id="update"></a>update</b></p> -<p>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.</p> -<tt>Syntax:<br> -update []<br> - [# x1 y1 x2 y2]<br> - [now]<br> - [now # x1 y1 x2 y2]<br> - <br> -Example:<br> -ds9.set(string cmd)<br> -update<br> -update 1 100 100 300 400<br> -update now<br> -update now 1 100 100 300 400</tt><br> -<p><b><a name="url" id="url"></a>url</b></p> -<p>Load FITS from URL into the current frame</p> -<tt>Syntax:<br> -url <url><br> - <br> -Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> url -http://foo.bar.edu/foo.fits</tt> -<p><b><a name="version" id="version"></a>version</b></p> -<p>Returns the current version of DS9.</p> -<tt>Syntax:<br> -version<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -version</tt> -<p><b><a name="view" id="view"></a>view</b></p> -<p>Controls the GUI.</p> -<tt>Syntax:<br> -view [layout horizontal|vertical]<br> - [keyvalue <string>]<br> - [info yes|no]<br> - [panner yes|no]<br> - [magnifier yes|no]<br> - [buttons yes|no]<br> - [colorbar yes|no]<br> - [colorbar horizontal|vertical]<br> - [colorbar numerics yes|no]<br> - [graph horizontal|vertical -yes|no]<br> - [filename yes|no[<br> - [object yes|no]<br> - [keyword yes|no]<br> - [minmax yes|no]<br> - [lowhigh yes|no]<br> - [units yes|no]<br> - [image|physical|wcs|wcsa...wcsz -yes|no]<br></tt> <tt><tt> [frame -yes|no]<br></tt> [red yes|no]<br> - [green yes|no]<br> - [blue yes|no]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -view layout<br> -view keyvalue<br> -view info<br> -view panner<br> -view magnifier<br> -view buttons<br> -view colorbar<br> -view graph horizontal<br> -view filename<br> -view object<br> -view keyword<br> -view minmax<br> -view lowhigh<br> -view units<br> -view image<br> -view wcsa<br></tt> <tt><tt>view frame<br></tt> view red<br> -ds9.set(string cmd)<br> -view layout vertical<br> -view keyvalue BITPIX<br> -view info yes<br> -view panner yes<br> -view magnifier yes<br> -view buttons yes<br> -view colorbar yes<br> -view graph horizontal yes<br> -view filename yes<br> -view object yes<br> -view keyword yes<br> -view minmax yes<br> -view lowhigh yes<br> -view units yes<br> -view wcsa yes<br></tt> <tt><tt>view frame yes<br></tt> view red -yes<br> -view green yes<br> -view blue yes</tt><br> -<p><b><a name="vla" id="vla"></a>vla</b></p> -<p>Support for VLA Sky Survey.</p> -<tt>Syntax:<br> -vla []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey first|stripe82]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -vla name<br> -vla coord<br> -vla size<br> -vla save<br> -vla frame<br> -vla survey<br> -ds9.set(string cmd)<br> -vla<br> -vla m31<br></tt> <tt><tt>vla name m31<br></tt></tt> <tt><tt><tt>vla -name clear<br></tt></tt> vla 00:42:44.404 +41:16:08.78<br> -vla size 60 60 arcmin<br> -vla save yes<br> -vla frame current<br> -vla update frame<br> -vla survey stripe82<br> -vla open<br> -vla close<br></tt> -<p><b><a name="vlss" id="vlss"></a>vlss</b></p> -<p>Support for NRAO VLSS Sky Survey.</p> -<tt>Syntax:<br> -vlss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -vlss name<br> -vlss coord<br> -vlss size<br> -vlss save<br> -vlss frame<br> -ds9.set(string cmd)<br> -vlss<br> -vlss m31<br></tt> <tt><tt>vlss name m31<br></tt></tt> -<tt><tt><tt>vlss name clear<br></tt></tt> vlss 00:42:44.404 -+41:16:08.78<br> -vlss size 60 60 arcmin<br> -vlss save yes<br> -vlss frame current<br> -vlss update frame<br> -vlss open<br> -vlss close</tt><br> -<p><b><a name="vo" id="vo"></a>vo</b></p> -<p>Invoke an connection to a Virtual Observatory site.</p> -<tt>Syntax:<br> -vo [method xpa|mime]<br> - [server <url>]<br> - [internal yes|no]<br> - [delay #]<br> - [<url>]<br> - [connect <url>]<br> - [disconnect <url>]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -vo<br> -vo method<br> -vo server<br> -vo internal<br> -vo delay<br> -vo connect<br> -ds9.set(string cmd)<br> -vo method xpa<br> -vo server "http://foo.bar.edu/list.txt"<br> -vo internal yes<br> -vo delay 15<br> -vo chandra-ed<br> -vo connect chandra-ed<br> -vo disconnect chandra-ed<br> -vo open<br> -vo close<br></tt> -<p><b><a name="wcs" id="wcs"></a>wcs</b></p> -<p>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 <a href="file.html#WCS">WCS</a> for more -information.</p> -<tt>Syntax:<br> -wcs [[system] wcs|wcsa...wcsz]<br> - [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> - [[skyformat] degrees|sexagesimal]<br> - [align yes|no]<br> - [reset [#]]<br> - [replace [#] <filename>]<br> - [append [#] <filename>]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -wcs<br> -wcs system<br> -wcs sky<br> -wcs skyformat<br> -wcs align<br> -ds9.set(string cmd)<br> -wcs wcs<br> -wcs system wcs<br></tt> <tt>wcs fk5<br></tt> <tt>wcs sky -fk5<br></tt> <tt>wcs sexagesimal<br></tt> <tt>wcs skyformat -sexagesimal<br> -wcs align yes<br> -wcs reset<br> -wcs reset 3<br> -wcs replace foo.wcs<br> -wcs replace 3 foo.wcs<br> -wcs append foo.wcs<br> -wcs append 3 foo.wcs<br> -ds9.set(string cmd, string url)<br> -wcs replace<br> -wcs append<br> -wcs open<br> -wcs close<br></tt> -<p><b><a name="web" id="web"></a>web</b></p> -<p>Display specified URL in the web display.</p> -<tt>Syntax:<br> -web</tt> <tt><tt>[]<br> - [<url>]<br> - [new <webname> <url>]<br></tt> - [<webname>] [click -back|forward|stop|reload|#]<br> - [<webname>] [clear]<br> - [<webname>] [close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -web<br> -ds9.set(string cmd)<br> -web www.cnn.com<br> -web new www.cnn.com<br> -web hvweb www.apple.com<br> -web click back<br> -web click 2<br> -web clear<br> -web close<br></tt> -<p><b><a name="width" id="width"></a>width</b></p> -<p>Set the width of the image display window.</p> -<tt>Syntax:<br> -width [<value>]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -width<br> -ds9.set(string cmd)<br> -width 512<br></tt> -<p><b><a name="zscale" id="zscale"></a>zscale</b></p> -<p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> -<tt>Syntax:<br> -zscale []<br> - [contrast]<br> - [sample]<br> - [line]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -zscale contrast<br> -zscale sample<br> -zscale line<br> -ds9.set(string cmd)<br> -zscale<br> -zscale contrast .25<br> -zscale sample 600<br> -zscale line 120<br></tt> -<p><b><a name="zoom" id="zoom"></a>zoom</b></p> -<p>Controls the current zoom value for the current frame.</p> -<tt>Syntax:<br> -zoom [<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br> - [to fit]<br> - [open|close]<br> - <br> -Example:<br> -string value = ds9.get(string cmd)<br> -zoom<br> -ds9.set(string cmd)<br> -zoom 2<br> -zoom 2 4<br> -zoom to 4<br> -zoom to 2 4<br> -zoom in<br> -zoom out<br> -zoom to fit<br> -zoom open<br> -zoom close<br></tt></blockquote> -</body> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + shm<br> + ds9.set(string cmd)<br> + shm 102<br> + shm key 102<br> + shm shmid 102 foo<br> + shm fits key 100 foo<br> + shm mosaicimage iraf key 100 foo<br> + shm mosaicimage wcs key 100 foo<br> + shm mosaicimage wcsa key 100 foo<br> + shm mosaicimage wfpc2 key 100 foo<br> + shm mosaic iraf key 100 foo<br> + shm mosaic wcs key 100 foo<br> + shm rgbcube key 100 foo<br> + shm rgbimage key 100 foo<br> + shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> + shm array shmid 102 [dim=32,bitpix=-32]<br> + <br> + </tt> <b><a name="sia" id="sia"></a>sia<br> + </b> + <p>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.</p> + <tt>Syntax:<br> + sia</tt> + <tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> + <br> + </tt> <tt> </tt><tt> + [<ref>] [cancel]<br> + </tt> <tt> + [<ref>] [clear]<br> + </tt> <tt> + [<ref>] [close]</tt><br> + <tt> [<ref>] + [coordinate + <ra> <dec> <coordsys>]</tt><tt><br> + </tt> + <tt> </tt> + <tt>[<ref>] [crosshair]</tt><br> + <tt> [<ref>] + [export sb|tsv <filename>]<br> + </tt> <tt> + [<ref>] [name <object>]<br> + </tt> + <tt> [<ref>] [print]</tt><br> + <tt><tt> [<ref>] + [retrieve]</tt><br> + </tt> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] [radius + <value> degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> + [<ref>] [skyformat + <skyformat>]<br> + </tt> <tt> + [<ref>] [system + <coordsys>]</tt><tt><br> + </tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> + <tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + sia<br> + <br> + ds9.set(string cmd)<br> + sia</tt> <tt>2mass<br> + sia</tt> <tt>cancel<br> + sia</tt> <tt>clear<br> + sia</tt> <tt>close<br> + sia</tt> <tt>coordinate 202.48 47.21 fk5<br> + sia</tt> <tt>crosshair<br> + sia</tt> <tt>export tsv bar.tsv<br> + sia</tt> <tt>name m51<br> + sia</tt> <tt>print</tt><br> + <tt>sia</tt> <tt>retrieve<br> + sia</tt> <tt>save foo.xml<br> + sia</tt> <tt>radius 1degrees</tt><br> + <tt>sia</tt> <tt>sky fk5<br> + sia skyformat degrees<br> + sia</tt> <tt>system wcs</tt><tt><br> + sia</tt> <tt>update<br> + <br> + </tt> <b><a name="single" id="single"></a>single</b> + <p>Select Single Display mode</p> + <tt>Syntax:<br> + single<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + single<br> + ds9.set(string cmd)<br> + single<br> + </tt> + <p><b><a name="skyview" id="skyview"></a>skyview</b></p> + <p>Support for SkyView image server at HEASARC.</p> + <tt>Syntax:<br> + skyview []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> + <dec>] + # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [pixels <width> + <height>]<br> + [save yes|no]<br> + [frame new|current]<br> + [update + frame|crosshair]<br> + [survey <survey>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + skyview name<br> + skyview coord<br> + skyview size<br> + skyview pixels<br> + skyview save<br> + skyview frame<br> + skyview survey<br> + ds9.set(string cmd)<br> + skyview<br> + skyview m31<br> + </tt> <tt><tt>skyview name m31<br> + </tt></tt> + <tt><tt><tt>skyview name clear<br> + </tt></tt> skyview 00:42:44.404 + +41:16:08.78<br> + skyview size 60 60 arcmin<br> + skyview pixels 600 600<br> + skyview save yes<br> + skyview frame current<br> + skyview update frame<br> + skyview survey sdssi<br> + skyview open<br> + skyview close<br> + </tt> + <p><b><a name="sleep" id="sleep"></a>sleep</b></p> + <p>Delays execution for specified number of seconds. Default is 1 + second.</p> + <tt>Syntax:<br> + sleep [#]<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + sleep<br> + sleep 2<br> + </tt> + <p><b><a name="smooth" id="smooth"></a>smooth</b></p> + <p>Smooth current image or set smooth parameters.<br> + Boxcar width = <i>2*radius+1</i><br> + Tophat diameter = <i>2*radius+1</i><br> + Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> + Elliptical Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i> + <tt>Syntax:</tt><br> + </p> + <tt>smooth []<br> + [yes|no]<br> + [function + boxcar|tophat|gaussian]<br> + </tt> + <tt> [radius + <value>]<br> + </tt> + <tt><tt><tt><tt> [radiusminor + <value>]<br> + </tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigma + <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigmaminor <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt> +[angle + <value>]<br> + </tt></tt></tt></tt></tt></tt></tt></tt> + <tt> [match]<br> + [lock [yes|no]]</tt><br> + <tt><tt> [open|close]<br> + </tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + smooth<br> + smooth function<br> + </tt> <tt><tt>smooth radius<br> + </tt></tt> + <tt><tt><tt>smooth radiusminor<br> + smooth sigma<br> + smooth sigmaminor<br> + smooth angle<br> + </tt></tt> smooth lock<br> + ds9.set(string cmd)<br> + smooth<br> + smooth yes<br> + smooth function tophat<br> + </tt> <tt><tt>smooth radius + 4<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>smooth radiusminor + 4<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigma + 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigmaminor + 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth angle + 45<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> + smooth open<br> + smooth close<br> + smooth match<br> + smooth lock yes</tt><br> + <tt>smooth open<br> + smooth close<br> + </tt> + <p><b><a name="source" id="source"></a>source</b></p> + <p>Source TCL code from a file.</p> + <tt>Syntax:<br> + source [filename]<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + source foo.tcl</tt><br> + <p><b><a name="tcl" id="tcl"></a>tcl</b></p> + <p>Execute one TCL command.<br> + </p> + <tt>Syntax:<br> + tcl <tcl command><br> + <br> + Example:<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> tcl {puts + {Hello, World}}<br> + </tt> + <p><b><a name="threads" id="threads"></a>threads</b></p> + <p>Set number of process threads for functions which are + multi-threaded.</p> + <tt>Syntax:<br> + threads #<br> + <br> + Example:<br> + </tt> <tt>string value = ds9.get(string cmd)<br> + </tt> + <tt>threads</tt><br> + <tt>ds9.set(string cmd)<br> + </tt> <tt>threads 8</tt><br> + <p><b><a name="tiff" id="tiff"></a>tiff</b></p> + <p>Load TIFF image into current frame. Optional parameters: + <tt>tiff</tt> compression method.</p> + <tt>Syntax:<br> + tiff [new|slice] [<filename>] + [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + </tt> <tt><tt>string value = ds9.get(string + cmd)<br> + </tt> tiff</tt><br> + <tt><tt>tiff jpeg</tt><br> + </tt> <tt><tt>ds9.set(string + cmd)<br> + </tt> tiff foo.tiff<br> + tiff new foo.tiff<br> + tiff slice foo.tiff</tt><tt><tt><br> + </tt> tiff<br> + tiff new<br> + tiff slice</tt><br> + <p><b><a name="tile" id="tile"></a>tile</b></p> + <p>Controls the tile display mode.</p> + <tt>Syntax:<br> + tile []<br> + [yes|no]<br> + [mode grid|column|row]<br> + [grid]<br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> <row>]<br> + [grid gap <pixels>]<br> + [row]<br> + [column]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + tile<br> + tile mode<br> + tile grid mode<br> + tile grid direction<br> + tile grid layout<br> + tile grid gap<br> + ds9.set(string cmd)<br> + tile<br> + tile yes<br> + tile mode row<br> + tile grid<br> + tile grid mode manual<br> + tile grid direction x<br> + tile grid layout 5 5<br> + tile grid gap 10<br> + tile row<br> + tile column</tt> + <p><b><a name="update" id="update"></a>update</b></p> + <p>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.</p> + <tt>Syntax:<br> + update []<br> + [# x1 y1 x2 y2]<br> + [now]<br> + [now # x1 y1 x2 y2]<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + update<br> + update 1 100 100 300 400<br> + update now<br> + update now 1 100 100 300 400</tt><br> + <p><b><a name="url" id="url"></a>url</b></p> + <p>Load FITS from URL into the current frame</p> + <tt>Syntax:<br> + url <url><br> + <br> + Example:<br> + </tt> <tt><tt>ds9.set(string cmd)<br> + </tt> url + http://foo.bar.edu/foo.fits</tt> + <p><b><a name="version" id="version"></a>version</b></p> + <p>Returns the current version of DS9.</p> + <tt>Syntax:<br> + version<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + version</tt> + <p><b><a name="view" id="view"></a>view</b></p> + <p>Controls the GUI.</p> + <tt>Syntax:<br> + view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no]<br> + [panner yes|no]<br> + [magnifier yes|no]<br> + [buttons yes|no]<br> + [colorbar yes|no]<br> + [colorbar horizontal|vertical]<br> + [colorbar numerics yes|no]<br> + [graph horizontal|vertical + yes|no]<br> + [filename yes|no[<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz + yes|no]<br> + </tt> <tt><tt> [frame + yes|no]<br> + </tt> [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + view layout<br> + view keyvalue<br> + view info<br> + view panner<br> + view magnifier<br> + view buttons<br> + view colorbar<br> + view graph horizontal<br> + view filename<br> + view object<br> + view keyword<br> + view minmax<br> + view lowhigh<br> + view units<br> + view image<br> + view wcsa<br> + </tt> <tt><tt>view frame<br> + </tt> view red<br> + ds9.set(string cmd)<br> + view layout vertical<br> + view keyvalue BITPIX<br> + view info yes<br> + view panner yes<br> + view magnifier yes<br> + view buttons yes<br> + view colorbar yes<br> + view graph horizontal yes<br> + view filename yes<br> + view object yes<br> + view keyword yes<br> + view minmax yes<br> + view lowhigh yes<br> + view units yes<br> + view wcsa yes<br> + </tt> <tt><tt>view frame yes<br> + </tt> view red + yes<br> + view green yes<br> + view blue yes</tt><br> + <p><b><a name="vla" id="vla"></a>vla</b></p> + <p>Support for VLA Sky Survey.</p> + <tt>Syntax:<br> + vla []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + vla name<br> + vla coord<br> + vla size<br> + vla save<br> + vla frame<br> + vla survey<br> + ds9.set(string cmd)<br> + vla<br> + vla m31<br> + </tt> <tt><tt>vla name m31<br> + </tt></tt> <tt><tt><tt>vla + name clear<br> + </tt></tt> vla 00:42:44.404 +41:16:08.78<br> + vla size 60 60 arcmin<br> + vla save yes<br> + vla frame current<br> + vla update frame<br> + vla survey stripe82<br> + vla open<br> + vla close<br> + </tt> + <p><b><a name="vlss" id="vlss"></a>vlss</b></p> + <p>Support for NRAO VLSS Sky Survey.</p> + <tt>Syntax:<br> + vlss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + vlss name<br> + vlss coord<br> + vlss size<br> + vlss save<br> + vlss frame<br> + ds9.set(string cmd)<br> + vlss<br> + vlss m31<br> + </tt> <tt><tt>vlss name m31<br> + </tt></tt> + <tt><tt><tt>vlss name clear<br> + </tt></tt> vlss 00:42:44.404 + +41:16:08.78<br> + vlss size 60 60 arcmin<br> + vlss save yes<br> + vlss frame current<br> + vlss update frame<br> + vlss open<br> + vlss close</tt><br> + <p><b><a name="vo" id="vo"></a>vo</b></p> + <p>Invoke an connection to a Virtual Observatory site.</p> + <tt>Syntax:<br> + vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + vo<br> + vo method<br> + vo server<br> + vo internal<br> + vo delay<br> + vo connect<br> + ds9.set(string cmd)<br> + vo method xpa<br> + vo server "http://foo.bar.edu/list.txt"<br> + vo internal yes<br> + vo delay 15<br> + vo chandra-ed<br> + vo connect chandra-ed<br> + vo disconnect chandra-ed<br> + vo open<br> + vo close<br> + </tt> + <p><b><a name="wcs" id="wcs"></a>wcs</b></p> + <p>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 <a href="file.html#WCS">WCS</a> for more + information.</p> + <tt>Syntax:<br> + wcs [[system] wcs|wcsa...wcsz]<br> + [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> + [[skyformat] degrees|sexagesimal]<br> + [align yes|no]<br> + [reset [#]]<br> + [replace [#] <filename>]<br> + [append [#] <filename>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + wcs<br> + wcs system<br> + wcs sky<br> + wcs skyformat<br> + wcs align<br> + ds9.set(string cmd)<br> + wcs wcs<br> + wcs system wcs<br> + </tt> <tt>wcs fk5<br> + </tt> <tt>wcs sky + fk5<br> + </tt> <tt>wcs sexagesimal<br> + </tt> <tt>wcs skyformat + sexagesimal<br> + wcs align yes<br> + wcs reset<br> + wcs reset 3<br> + wcs replace foo.wcs<br> + wcs replace 3 foo.wcs<br> + wcs append foo.wcs<br> + wcs append 3 foo.wcs<br> + ds9.set(string cmd, string url)<br> + wcs replace<br> + wcs append<br> + wcs open<br> + wcs close<br> + </tt> + <p><b><a name="web" id="web"></a>web</b></p> + <p>Display specified URL in the web display.</p> + <tt>Syntax:<br> + web</tt> <tt><tt>[]<br> + [<url>]<br> + [new <webname> <url>]<br> + </tt> + [<webname>] [click + back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + web<br> + ds9.set(string cmd)<br> + web www.cnn.com<br> + web new www.cnn.com<br> + web hvweb www.apple.com<br> + web click back<br> + web click 2<br> + web clear<br> + web close<br> + </tt> + <p><b><a name="width" id="width"></a>width</b></p> + <p>Set the width of the image display window.</p> + <tt>Syntax:<br> + width [<value>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + width<br> + ds9.set(string cmd)<br> + width 512<br> + </tt> + <p><b><a name="zscale" id="zscale"></a>zscale</b></p> + <p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> + <tt>Syntax:<br> + zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + zscale contrast<br> + zscale sample<br> + zscale line<br> + ds9.set(string cmd)<br> + zscale<br> + zscale contrast .25<br> + zscale sample 600<br> + zscale line 120<br> + </tt> + <p><b><a name="zoom" id="zoom"></a>zoom</b></p> + <p>Controls the current zoom value for the current frame.</p> + <tt>Syntax:<br> + zoom [<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + zoom<br> + ds9.set(string cmd)<br> + zoom 2<br> + zoom 2 4<br> + zoom to 4<br> + zoom to 2 4<br> + zoom in<br> + zoom out<br> + zoom to fit<br> + zoom open<br> + zoom close<br> + </tt></blockquote> + </body> </html> diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index 0930a26..44335ff 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -1,3112 +1,3701 @@ <!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> -<head> -<meta name="generator" content= -"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> -<meta http-equiv="Content-Type" content= -"text/html; charset=us-ascii"> -<meta name="GENERATOR" content= -"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> -<title>XPA Access Points</title> -</head> -<body vlink="#551A8B" link="#0000FF" alink="#FF0000"> -<h3><img alt="" src="../sun.gif" width="100" height="98" align= -"middle"> XPA Access Points</h3> -<blockquote> -<p>The <a href= -"http://hea-www.harvard.edu/RD/xpa/index.html">XPA</a> messaging -system provides seamless communication between DS9 and other Unix -programs, including X programs, Perl, <a href= -"http://space.mit.edu/cxc/software/slang/modules/xpa/">S-Lang,</a> -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.</p> -<tt><a href="#2mass">2mass</a><br> -<a href="#3d">3d</a><br> -<a href="#about">about</a><br> -<a href="#align">align</a><br> -<a href="#analysis">analysis</a><br> -<a href="#array">array</a><br> -<a href="#background">background</a><br> -<a href="#backup">backup</a><br> -<a href="#bin">bin</a><br> -<a href="#blink">blink</a><br> -<a href="#block">block</a><br> -<a href="#catalog">catalog</a><br> -<a href="#cd">cd</a><br> -<a href="#cmap">cmap</a><br> -<a href="#colorbar">colorbar</a><br> -<a href="#console">console</a><br> -<a href="#contour">contour</a><br> -<a href="#crop">crop</a><br> -<a href="#crosshair">crosshair</a><br> -<a href="#cube">cube</a><br> -<a href="#cursor">cursor</a><br> -<a href="#data">data</a><br> -<a href="#dsssao">dsssao</a><br> -<a href="#dsseso">dsseso</a><br> -<a href="#dssstsci">dssstsci</a><br> -<a href="#envi">envi</a><br> -<a href="#exit">exit</a><br> -<a href="#export">export</a><br> -<a href="#file">file</a><br> -<a href="#fits">fits</a><br> -<a href="#frame">frame</a><br> -<a href="#gif">gif</a><br> -<a href="#grid">grid</a><br> -<a href="#header">header</a><br> -<a href="#height">height</a><br> -<a href="#iconify">iconify</a><br></tt> <tt><tt><a href= -"#iexam">iexam</a><br></tt> <a href="#iis">iis</a><br> -<a href="#jpeg">jpeg</a><br> -<a href="#lock">lock</a><br> -<a href="#lower">lower</a><br> -<a href="#magnifier">magnifier</a><br> -<a href="#mask">mask</a><br> -<a href="#match">match</a><br> -<a href="#mecube">mecube</a><br> -<a href="#minmax">minmax</a><br> -<a href="#mode">mode</a><br> -<a href="#mosaic">mosaic</a><br> -<a href="#mosaicimage">mosaicimage</a><br> -<a href="#movie">movie</a><br> -<a href="#multiframe">multiframe</a><br> -<a href="#nameserver">nameserver</a><br> -<a href="#nrrd">nrrd</a><br> -<a href="#nvss">nvss</a><br> -<a href="#orient">orient</a><br> -<a href="#pagesetup">pagesetup</a><br> -<a href="#pan">pan</a><br> -<a href="#pixeltable">pixeltable</a><br> -<a href="#plot">plot</a><br> -<a href="#png">png</a><br> -<a href="#precision">precision</a><br> -<a href="#prefs">prefs</a><br> -<a href="#preserve">preserve</a><br> -<a href="#print">psprint</a><br> -<a href="#print">print</a><br> -<a href="#exit">quit</a><br> -<a href="#raise">raise</a><br> -<a href="#regions">regions</a><br> -<a href="#restore">restore</a><br> -<a href="#rgb">rgb</a><br> -<a href="#rgbarray">rgbarray</a><br> -<a href="#rgbcube">rgbcube</a><br> -<a href="#rgbimage">rgbimage</a><br> -<a href="#rotate">rotate</a><br> -<a href="#save">save</a><br> -<a href="#saveimage">saveimage</a><br> -<a href="#scale">scale</a><br> -<a href="#shm">shm</a></tt><br> -<tt><tt><a href="#sia">sia</a><br></tt> <a href= -"#single">single</a><br> -<a href="#skyview">skyview</a><br> -<a href="#sleep">sleep</a><br> -<a href="#smooth">smooth</a><br> -<a href="#source">source</a><br> -<a href="#tcl">tcl</a><br> -<a href="#threads">threads</a><br> -<a href="#tile">tile</a><br> -<a href="#update">update</a><br> -<a href="#url">url</a><br> -<a href="#version">version</a><br> -<a href="#view">view</a><br> -<a href="#vla">vla</a></tt><br> -<tt><tt><a href="#vlss">vlss</a><br></tt> <a href="#vo">vo</a><br> -<a href="#wcs">wcs</a><br> -<a href="#web">web</a><br> -<a href="#width">width</a><br> -<a href="#xpa">xpa</a><br> -<a href="#zscale">zscale</a><br> -<a href="#zoom">zoom</a><br></tt> -<p><b><a name="2mass"></a>2mass</b></p> -<p>Support for 2MASS Digital Sky Survey.</p> -<tt>Syntax:<br> -2mass []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey j|h|k]<br></tt> -<tt> [open|close]<br></tt> -<tt> <br> -Example:<br> -$xpaget ds9 2mass name<br> -$xpaget ds9 2mass coord<br> -$xpaget ds9 2mass size<br> -$xpaget ds9 2mass save<br> -$xpaget ds9 2mass frame<br> -$xpaget ds9 2mass survey<br> -$xpaset -p ds9 2mass<br></tt> <tt>$xpaset -p ds9 2mass m31<br></tt> -<tt><tt>$xpaset -p ds9 2mass name m31<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9 2mass name clear<br></tt></tt> $xpaset --p ds9 2mass 00:42:44.404 +41:16:08.78<br> -$xpaset -p ds9 2mass size 60 60 arcmin<br> -$xpaset -p ds9 2mass save yes<br> -$xpaset -p ds9 2mass frame current<br> -$xpaset -p ds9 2mass update frame<br> -$xpaset -p ds9 2mass survey j<br></tt> <tt>$xpaset -p ds9 2mass -open<br> -$xpaset -p ds9 2mass close</tt><br> -<p><b><a name="3d"></a>3d</b></p> -<p>Support for 3D frame.</p> -<tt>Syntax:<br> -3d []<br> - [view <az> <el>]<br> - [az <az>]<br> - [el <el>]<br> - [scale <scale>]<br> - [method mip|aip]</tt><br> -<tt><tt> [background none|azimuth|elevation]<br></tt> - </tt><tt> [border yes|no]<br> - [border color <color>]</tt><br> -<tt> [highlite yes|no]<br> - [highlite color <color>]<br></tt> -<tt><tt> </tt><tt> [compass yes|no]<br> - [compass color <color>]</tt><br></tt> -<tt><tt><tt> [match]<br> - [lock [yes|no]]<br></tt></tt> -[open|close]<br></tt> <tt> <br> -Example:<br> -$xpaget ds9 3d view<br> -$xpaget ds9 3d az<br> -$xpaget ds9 3d el<br> -$xpaget ds9 3d scale<br> -$xpaget ds9 3d method<br></tt> <tt>$xpaget ds9 3d -background<br></tt> <tt>$xpaget ds9 3d border<br> -$xpaget ds9 3d border color</tt><br> -<tt>$xpaget ds9 3d highlite<br> -$xpaget ds9 3d highlite color<br></tt> <tt><tt>$xpaget ds9 3d -compass<br></tt></tt> <tt><tt><tt><tt>$xpaget ds9 3d compass -color</tt><br></tt></tt></tt> <tt><tt><tt><tt><tt>$xpaget ds9 3d -lock</tt><br></tt></tt></tt> $xpaset -p ds9 3d # create new 3D -frame<br> -$xpaset -p ds9 3d view 45 30<br> -$xpaset -p ds9 3d az 45<br> -$xpaset -p ds9 3d el 30<br> -$xpaset -p ds9 3d scale 10<br> -$xpaset -p ds9 3d method mip</tt><br> -<tt>$xpaset -p ds9 3d background azimuth<br></tt> <tt>$xpaset -p -ds9 3d border yes<br> -$xpaset -p ds9 3d border color red</tt><br> -<tt>$xpaset -p ds9 3d highlite yes<br> -$xpaset -p ds9 3d highlite color red<br></tt> <tt><tt><tt>$xpaset --p ds9 3d compass yes<br></tt></tt></tt> -<tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d compass color -red</tt><br></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d -match</tt></tt></tt></tt></tt></tt></tt></tt><br> -<tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d lock -yes</tt><br></tt></tt></tt></tt></tt></tt></tt></tt></tt> $xpaset --p ds9 3d open<br> -$xpaset -p ds9 3d close<br></tt> -<p><b><a name="about" id="about"></a>about</b></p> -<p>Get DS9 credits.</p> -<tt>Syntax:<br> -about<br> - <br> -Example:<br> -$xpaget ds9 about<br></tt> -<p><b><a name="align" id="align"></a>align</b></p> -<p>Controls the World Coordinate System alignment for the current -frame.</p> -<tt>Syntax:<br> -align []<br> - [yes|no]<br> - <br> -Example:<br> -$xpaget ds9 align<br> -$xpaset -p ds9 align yes<br></tt> -<p><b><a name="analysis" id="analysis"></a>analysis</b></p> -<p>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.</p> -<tt>Syntax:<br> -analysis [<task number>]<br> - -[<filename>]<br> - [task <task -number>|<task name>]<br> - [load -<filename>]<br> - [clear]<br> - [clear][load -<filename>]<br> - [message -ok|okcancel|yesno <message>]<br> - [entry -<message>]<br> - -[text]</tt><tt><tt><br> -<br></tt> Example:<br> -$xpaget ds9 analysis<br> -$xpaget ds9 analysis task<br> -$xpaget ds9 analysis entry {Please enter something}<br> -$xpaget ds9 analysis message okcancel {Hello World}<br> -$xpaset -p ds9 analysis 0 # invoke first analysis task<br> -$xpaset -p ds9 analysis task 0<br> -$xpaset -p ds9 analysis task foobar<br> -$xpaset -p ds9 analysis {foo bar}<br> -$xpaset -p ds9 analysis my.ans<br> -$xpaset -p ds9 analysis load my.ans<br> -$xpaset -p ds9 analysis clear<br> -$xpaset -p ds9 analysis clear load my.ans<br> -$xpaset -p ds9 analysis message {This is a message}<br> -$xpaset -p ds9 analysis text {this is text}<br> -$cat my.ans | xpaset ds9 analysis load<br> -$cat foo.txt | xpaset ds9 analysis text<br></tt> -<p><b><a name="array" id="array"></a>array</b></p> -<p>Load raw data array into current frame.<br></p> -<tt>Syntax:<br> -array [native|little|big]<br> -array [new|mask] + <head> + <meta name="generator" content="HTML Tidy for Mac OS X (vers 31 + October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> + <meta http-equiv="Content-Type" content="text/html; + charset=windows-1252"> + <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux + 2.4.7-10 i686) [Netscape]"> + <title>XPA Access Points</title> + </head> + <body vlink="#551A8B" link="#0000FF" alink="#FF0000"> + <h3><img alt="" src="../sun.gif" width="100" height="98" + align="middle"> XPA Access Points</h3> + <blockquote> + <p>The <a href="http://hea-www.harvard.edu/RD/xpa/index.html">XPA</a> + messaging + system provides seamless communication between DS9 and other + Unix + programs, including X programs, Perl, <a + href="http://space.mit.edu/cxc/software/slang/modules/xpa/">S-Lang,</a> + 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.</p> + <tt><a href="#2mass">2mass</a><br> + <a href="#3d">3d</a><br> + <a href="#about">about</a><br> + <a href="#align">align</a><br> + <a href="#analysis">analysis</a><br> + <a href="#array">array</a><br> + <a href="#background">background</a><br> + <a href="#backup">backup</a><br> + <a href="#bin">bin</a><br> + <a href="#blink">blink</a><br> + <a href="#block">block</a><br> + <a href="#catalog">catalog</a><br> + <a href="#cd">cd</a><br> + <a href="#cmap">cmap</a><br> + <a href="#colorbar">colorbar</a><br> + <a href="#console">console</a><br> + <a href="#contour">contour</a><br> + <a href="#crop">crop</a><br> + <a href="#crosshair">crosshair</a><br> + <a href="#cube">cube</a><br> + <a href="#cursor">cursor</a><br> + <a href="#data">data</a><br> + <a href="#dsssao">dsssao</a><br> + <a href="#dsseso">dsseso</a><br> + <a href="#dssstsci">dssstsci</a><br> + <a href="#envi">envi</a><br> + <a href="#exit">exit</a><br> + <a href="#export">export</a><br> + <a href="#file">file</a><br> + <a href="#fits">fits</a><br> + <a href="#frame">frame</a><br> + <a href="#gif">gif</a><br> + <a href="#grid">grid</a><br> + <a href="#header">header</a><br> + <a href="#height">height</a><br> + <a href="#iconify">iconify</a><br> + </tt> <tt><tt><a href="#iexam">iexam</a><br> + </tt> <a href="#iis">iis</a><br> + <a href="#jpeg">jpeg</a><br> + <a href="#lock">lock</a><br> + <a href="#lower">lower</a><br> + <a href="#magnifier">magnifier</a><br> + <a href="#mask">mask</a><br> + <a href="#match">match</a><br> + <a href="#mecube">mecube</a><br> + <a href="#minmax">minmax</a><br> + <a href="#mode">mode</a><br> + <a href="#mosaic">mosaic</a><br> + <a href="#mosaicimage">mosaicimage</a><br> + <a href="#movie">movie</a><br> + <a href="#multiframe">multiframe</a><br> + <a href="#nameserver">nameserver</a><br> + <a href="#nrrd">nrrd</a><br> + <a href="#nvss">nvss</a><br> + <a href="#orient">orient</a><br> + <a href="#pagesetup">pagesetup</a><br> + <a href="#pan">pan</a><br> + <a href="#pixeltable">pixeltable</a><br> + <a href="#plot">plot</a><br> + <a href="#png">png</a><br> + <a href="#precision">precision</a><br> + <a href="#prefs">prefs</a><br> + <a href="#preserve">preserve</a><br> + <a href="#print">psprint</a><br> + <a href="#print">print</a><br> + <a href="#exit">quit</a><br> + <a href="#raise">raise</a><br> + <a href="#regions">regions</a><br> + <a href="#restore">restore</a><br> + <a href="#rgb">rgb</a><br> + <a href="#rgbarray">rgbarray</a><br> + <a href="#rgbcube">rgbcube</a><br> + <a href="#rgbimage">rgbimage</a><br> + <a href="#rotate">rotate</a><br> + <a href="#save">save</a><br> + <a href="#saveimage">saveimage</a><br> + <a href="#scale">scale</a><br> + <a href="#shm">shm</a></tt><br> + <tt><tt><a href="#sia">sia</a><br> + </tt> <a href="#single">single</a><br> + <a href="#skyview">skyview</a><br> + <a href="#sleep">sleep</a><br> + <a href="#smooth">smooth</a><br> + <a href="#source">source</a><br> + <a href="#tcl">tcl</a><br> + <a href="#threads">threads</a><br> + <a href="#tile">tile</a><br> + <a href="#update">update</a><br> + <a href="#url">url</a><br> + <a href="#version">version</a><br> + <a href="#view">view</a><br> + <a href="#vla">vla</a></tt><br> + <tt><tt><a href="#vlss">vlss</a><br> + </tt> <a href="#vo">vo</a><br> + <a href="#wcs">wcs</a><br> + <a href="#web">web</a><br> + <a href="#width">width</a><br> + <a href="#xpa">xpa</a><br> + <a href="#zscale">zscale</a><br> + <a href="#zoom">zoom</a><br> + </tt> + <p><b><a name="2mass"></a>2mass</b></p> + <p>Support for 2MASS Digital Sky Survey.</p> + <tt>Syntax:<br> + 2mass []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + </tt> + <tt> [open|close]<br> + </tt> + <tt> <br> + Example:<br> + $xpaget ds9 2mass name<br> + $xpaget ds9 2mass coord<br> + $xpaget ds9 2mass size<br> + $xpaget ds9 2mass save<br> + $xpaget ds9 2mass frame<br> + $xpaget ds9 2mass survey<br> + $xpaset -p ds9 2mass<br> + </tt> <tt>$xpaset -p ds9 2mass m31<br> + </tt> + <tt><tt>$xpaset -p ds9 2mass name m31<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9 2mass name clear<br> + </tt></tt> $xpaset + -p ds9 2mass 00:42:44.404 +41:16:08.78<br> + $xpaset -p ds9 2mass size 60 60 arcmin<br> + $xpaset -p ds9 2mass save yes<br> + $xpaset -p ds9 2mass frame current<br> + $xpaset -p ds9 2mass update frame<br> + $xpaset -p ds9 2mass survey j<br> + </tt> <tt>$xpaset -p ds9 2mass + open<br> + $xpaset -p ds9 2mass close</tt><br> + <p><b><a name="3d"></a>3d</b></p> + <p>Support for 3D frame.</p> + <tt>Syntax:<br> + 3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]</tt><br> + <tt><tt> [background none|azimuth|elevation]<br> + </tt> + </tt><tt> [border yes|no]<br> + [border color <color>]</tt><br> + <tt> [highlite yes|no]<br> + [highlite color <color>]<br> + </tt> + <tt><tt> </tt><tt> [compass yes|no]<br> + [compass color <color>]</tt><br> + </tt> + <tt><tt><tt> [match]<br> + [lock [yes|no]]<br> + </tt></tt> + [open|close]<br> + </tt> <tt> <br> + Example:<br> + $xpaget ds9 3d view<br> + $xpaget ds9 3d az<br> + $xpaget ds9 3d el<br> + $xpaget ds9 3d scale<br> + $xpaget ds9 3d method<br> + </tt> <tt>$xpaget ds9 3d + background<br> + </tt> <tt>$xpaget ds9 3d border<br> + $xpaget ds9 3d border color</tt><br> + <tt>$xpaget ds9 3d highlite<br> + $xpaget ds9 3d highlite color<br> + </tt> <tt><tt>$xpaget ds9 3d + compass<br> + </tt></tt> <tt><tt><tt><tt>$xpaget ds9 3d compass + color</tt><br> + </tt></tt></tt> <tt><tt><tt><tt><tt>$xpaget ds9 3d + lock</tt><br> + </tt></tt></tt> $xpaset -p ds9 3d # create new 3D + frame<br> + $xpaset -p ds9 3d view 45 30<br> + $xpaset -p ds9 3d az 45<br> + $xpaset -p ds9 3d el 30<br> + $xpaset -p ds9 3d scale 10<br> + $xpaset -p ds9 3d method mip</tt><br> + <tt>$xpaset -p ds9 3d background azimuth<br> + </tt> <tt>$xpaset -p + ds9 3d border yes<br> + $xpaset -p ds9 3d border color red</tt><br> + <tt>$xpaset -p ds9 3d highlite yes<br> + $xpaset -p ds9 3d highlite color red<br> + </tt> <tt><tt><tt>$xpaset + -p ds9 3d compass yes<br> + </tt></tt></tt> + <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d compass color + red</tt><br> + </tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d + match</tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d lock + yes</tt><br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> + $xpaset + -p ds9 3d open<br> + $xpaset -p ds9 3d close<br> + </tt> + <p><b><a name="about" id="about"></a>about</b></p> + <p>Get DS9 credits.</p> + <tt>Syntax:<br> + about<br> + <br> + Example:<br> + $xpaget ds9 about<br> + </tt> + <p><b><a name="align" id="align"></a>align</b></p> + <p>Controls the World Coordinate System alignment for the current + frame.</p> + <tt>Syntax:<br> + align []<br> + [yes|no]<br> + <br> + Example:<br> + $xpaget ds9 align<br> + $xpaset -p ds9 align yes<br> + </tt> + <p><b><a name="analysis" id="analysis"></a>analysis</b></p> + <p>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.</p> + <tt>Syntax:<br> + analysis [<task number>]<br> + + [<filename>]<br> + [task <task + number>|<task name>]<br> + [load + <filename>]<br> + [clear]<br> + [clear][load + <filename>]<br> + [message + ok|okcancel|yesno <message>]<br> + [entry + <message>]<br> + + [text]</tt><tt><tt><br> + <br> + </tt> Example:<br> + $xpaget ds9 analysis<br> + $xpaget ds9 analysis task<br> + $xpaget ds9 analysis entry {Please enter something}<br> + $xpaget ds9 analysis message okcancel {Hello World}<br> + $xpaset -p ds9 analysis 0 # invoke first analysis task<br> + $xpaset -p ds9 analysis task 0<br> + $xpaset -p ds9 analysis task foobar<br> + $xpaset -p ds9 analysis {foo bar}<br> + $xpaset -p ds9 analysis my.ans<br> + $xpaset -p ds9 analysis load my.ans<br> + $xpaset -p ds9 analysis clear<br> + $xpaset -p ds9 analysis clear load my.ans<br> + $xpaset -p ds9 analysis message {This is a message}<br> + $xpaset -p ds9 analysis text {this is text}<br> + $cat my.ans | xpaset ds9 analysis load<br> + $cat foo.txt | xpaset ds9 analysis text<br> + </tt> + <p><b><a name="array" id="array"></a>array</b></p> + <p>Load raw data array into current frame.<br> + </p> + <tt>Syntax:<br> + array [native|little|big]<br> + array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br> -$xpaget ds9 array > foo.arr<br> -$xpaget ds9 array little > foo.arr<br> -$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]<br> -$xpaset -p ds9 array new -foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> -<tt><tt>$xpaset -p ds9 array mask -foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><br> -<tt>$cat foo.arr | xpaset ds9 array -[dim=512,bitpix=-32,endian=little]</tt><br> -<tt>$cat foo.arr | xpaset ds9 array new -[dim=512,bitpix=-32,endian=little]</tt><br> -<tt>$cat foo.arr | xpaset ds9 array mask -[dim=512,bitpix=-32,endian=little]</tt> -<p><b><a name="background" id="background"></a>bg<br> -background</b></p> -<p>Set image background color.</p> -<tt>Syntax:<br> -bg <color><br> - <br> -Example:<br> -$xpaget ds9 bg</tt><tt><br></tt> $xpaset -p ds9 bg red<br> -<p><b><a name="backup" id="backup"></a>backup</b></p> -<p>Create a backup save set.</p> -<tt>Syntax:<br> -backup <filename><br> - <br> -Example:<br> -$xpaset -p ds9 backup ds9.bck</tt><br> -<p><b><a name="bin" id="bin"></a>bin</b></p> -<p>Controls binning factor, binning buffer size, and binning -function for binning FITS bin tables. The access point blocking is -provided for backward compatibility.</p> -<tt>Syntax:<br> -bin [about <x> <y>]<br> - [about center]<br> - [buffersize <value>]<br> - [cols <x> <y>]<br> - [colsz <x> <y> <z>]<br> - [factor <value> [<vector>]]<br> - [depth <value>]<br> - [filter <string>]<br></tt> -<tt><tt> [filter clear]<br></tt> - [function average|sum]<br> - [in]<br> - [out]<br> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 bin about<br> -$xpaget ds9 bin buffersize<br> -$xpaget ds9 bin cols<br> -$xpaget ds9 bin factor<br> -$xpaget ds9 bin depth<br> -$xpaget ds9 bin filter<br> -$xpaget ds9 bin function<br> -$xpaget ds9 bin smooth<br> -$xpaget ds9 bin smooth function<br> -$xpaget ds9 bin smooth radius<br> -$xpaget ds9 bin lock<br> -$xpaset -p ds9 bin about 4096 4096<br> -$xpaset -p ds9 bin about center<br> -$xpaset -p ds9 bin buffersize 512<br> -$xpaset -p ds9 bin cols detx dety<br> -$xpaset -p ds9 bin colsz detx dety time<br> -$xpaset -p ds9 bin factor 4<br> -$xpaset -p ds9 bin factor 4 2<br> -$xpaset -p ds9 bin depth 10<br> -$xpaset -p ds9 bin filter 'pha > 5'<br> -$xpaset -p ds9 bin filter clear<br> -$xpaset -p ds9 bin function sum<br> -$xpaset -p ds9 bin in<br> -$xpaset -p ds9 bin out<br> -$xpaset -p ds9 bin to fit<br> -$xpaset -p ds9 bin match<br> -$xpaset -p ds9 bin lock yes<br> -$xpaset -p ds9 bin open<br> -$xpaset -p ds9 bin close</tt><tt><br></tt> -<p><b><a name="blink" id="blink"></a>blink</b></p> -<p>Blink mode parameters. Interval is in seconds.<br></p> -<tt>Syntax:<br> -blink []<br> - [yes|no]<br> - [interval <value>]<br> - <br> -Example:<br> -$xpaget ds9 blink<br> -$xpaget ds9 blink interval<br> -$xpaset -p ds9 blink<br> -$xpaset -p ds9 blink yes<br> -$xpaset -p ds9 blink interval 1</tt><br> -<p><b><a name="block" id="block"></a>block</b></p> -<p>Controls blocking parameters.</p> -<tt>Syntax:<br> -block</tt> <tt><tt>[<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br></tt> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 block<br> -$xpaget ds9 block lock<br></tt> <tt>$xpaset -p ds9</tt> -<tt><tt><tt>block</tt></tt> 4<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4 2<br></tt> -<tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to -4<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to 4 2<br></tt> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> in<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> -out<br></tt></tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> -to fit<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> match<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> lock yes<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> open<br> -$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> -close</tt><tt><br></tt> -<p><b><a name="catalog" id="catalog"></a>catalog<br> -cat<br></b></p> -<p>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.</p> -<tt>Syntax:<br> -catalog [new]<br> - -[ned|simbad|denis|skybot]<br> - + <br> + Example:<br> + $xpaget ds9 array > foo.arr<br> + $xpaget ds9 array little > foo.arr<br> + $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]<br> + $xpaset -p ds9 array new + foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt><tt>$xpaset -p ds9 array mask + foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><br> + <tt>$cat foo.arr | xpaset ds9 array + [dim=512,bitpix=-32,endian=little]</tt><br> + <tt>$cat foo.arr | xpaset ds9 array new + [dim=512,bitpix=-32,endian=little]</tt><br> + <tt>$cat foo.arr | xpaset ds9 array mask + [dim=512,bitpix=-32,endian=little]</tt> + <p><b><a name="background" id="background"></a>bg<br> + background</b></p> + <p>Set image background color.</p> + <tt>Syntax:<br> + bg <color><br> + <br> + Example:<br> + $xpaget ds9 bg</tt><tt><br> + </tt> $xpaset -p ds9 bg red<br> + <p><b><a name="backup" id="backup"></a>backup</b></p> + <p>Create a backup save set.</p> + <tt>Syntax:<br> + backup <filename><br> + <br> + Example:<br> + $xpaset -p ds9 backup ds9.bck</tt><br> + <p><b><a name="bin" id="bin"></a>bin</b></p> + <p>Controls binning factor, binning buffer size, and binning + function for binning FITS bin tables. The access point blocking + is + provided for backward compatibility.</p> + <tt>Syntax:<br> + bin [about <x> <y>]<br> + [about center]<br> + [buffersize <value>]<br> + [cols <x> <y>]<br> + [colsz <x> <y> <z>]<br> + [factor <value> [<vector>]]<br> + [depth <value>]<br> + [filter <string>]<br> + </tt> + <tt><tt> [filter clear]<br> + </tt> + [function average|sum]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 bin about<br> + $xpaget ds9 bin buffersize<br> + $xpaget ds9 bin cols<br> + $xpaget ds9 bin factor<br> + $xpaget ds9 bin depth<br> + $xpaget ds9 bin filter<br> + $xpaget ds9 bin function<br> + $xpaget ds9 bin smooth<br> + $xpaget ds9 bin smooth function<br> + $xpaget ds9 bin smooth radius<br> + $xpaget ds9 bin lock<br> + $xpaset -p ds9 bin about 4096 4096<br> + $xpaset -p ds9 bin about center<br> + $xpaset -p ds9 bin buffersize 512<br> + $xpaset -p ds9 bin cols detx dety<br> + $xpaset -p ds9 bin colsz detx dety time<br> + $xpaset -p ds9 bin factor 4<br> + $xpaset -p ds9 bin factor 4 2<br> + $xpaset -p ds9 bin depth 10<br> + $xpaset -p ds9 bin filter 'pha > 5'<br> + $xpaset -p ds9 bin filter clear<br> + $xpaset -p ds9 bin function sum<br> + $xpaset -p ds9 bin in<br> + $xpaset -p ds9 bin out<br> + $xpaset -p ds9 bin to fit<br> + $xpaset -p ds9 bin match<br> + $xpaset -p ds9 bin lock yes<br> + $xpaset -p ds9 bin open<br> + $xpaset -p ds9 bin close</tt><tt><br> + </tt> + <p><b><a name="blink" id="blink"></a>blink</b></p> + <p>Blink mode parameters. Interval is in seconds.<br> + </p> + <tt>Syntax:<br> + blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> + Example:<br> + $xpaget ds9 blink<br> + $xpaget ds9 blink interval<br> + $xpaset -p ds9 blink<br> + $xpaset -p ds9 blink yes<br> + $xpaset -p ds9 blink interval 1</tt><br> + <p><b><a name="block" id="block"></a>block</b></p> + <p>Controls blocking parameters.</p> + <tt>Syntax:<br> + block</tt> <tt><tt>[<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> + <value>]<br> + [in]<br> + [out]<br> + </tt> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 block<br> + $xpaget ds9 block lock<br> + </tt> <tt>$xpaset -p ds9</tt> + <tt><tt><tt>block</tt></tt> 4<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4 2<br> + </tt> + <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to + 4<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to 4 2<br> + </tt> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> in<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> + out<br> + </tt></tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> + to fit<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> match<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> lock yes<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> open<br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> + close</tt><tt><br> + </tt> + <p><b><a name="catalog" id="catalog"></a>catalog<br> + cat<br> + </b></p> + <p>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.</p> + <tt>Syntax:<br> + catalog [new]<br> + + [ned|simbad|denis|skybot]<br> + [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - -[</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> - [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - -[chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds -<catalogid>]<br> -<br> - [load <filename>]<br> - [import sb|tsv -<filename>]<br> -<br></tt> <tt><tt> -[<ref>] [<ra> <dec> -<coordsys>]</tt><tt><br></tt> - [<ref>] [allcols]<br></tt> -<tt> </tt><tt> [<ref>] -[allrows]<br> - </tt><tt> [<ref>] -[cancel]<br></tt> <tt> -[<ref>] [clear]<br></tt> <tt> -[<ref>] [close]</tt><br> -<tt> </tt> -<tt>[<ref>] [crosshair]</tt><br> -<tt> [<ref>] [dec -<col>]</tt><br> -<tt> [<ref>] [edit -yes|no]</tt><br> -<tt> [<ref>] -[export sb|tsv <filename>]<br></tt> -<tt> [<ref>] -[filter <string>]<br> - [<ref>] [filter load -<filename>]</tt><br> -<tt> [<ref>] -[header]</tt><br> -<tt> [<ref>] [location -<code>]</tt><br> -<tt><tt> [<ref>] -[match]<br></tt></tt> -<tt><tt><tt> -[<ref>] [match <ref> <ref>]<br></tt></tt> - </tt> <tt>[<ref>] -[match error <value> degrees|arcmin|arcsec]</tt><br> -<tt> </tt> -<tt>[<ref>] [match function 1and2|1not2|2not1]<br></tt> -<tt> </tt> -<tt>[<ref>] [match return 1and2|1only|2only]</tt><br> -<tt> </tt> -<tt>[<ref>] [match unique yes|no]</tt><br> -<tt> [<ref>] [maxrows -<number>]</tt><br> -<tt> [<ref>] [name -<object>]<br></tt> -<tt> [<ref>] [panto -yes|no]</tt><br> -<tt> [<ref>] [plot -<xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> -<tt> [<ref>] [print]</tt><br> -<tt> [<ref>] [psky -<skyframe>]</tt><br> -<tt> [<ref>] [psystem -<coordsys>]</tt><br> -<tt> [<ref>] [ra -<col>]<br> - [<ref>] -[regions]</tt><br> -<tt> [<ref>] -[retrieve]</tt><br> -<tt> [<ref>] [samp]<br> - [<ref>] [samp -broadcast]<br> - [<ref>] [samp send -<application>]</tt><tt><br></tt> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] -[server -cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><br> -<tt> [<ref>] [show -yes|no]</tt><br> -<tt> [<ref>] [radius -<value> degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> - [<ref>] [skyformat -<skyformat>]<br></tt> <tt> - [<ref>] [sort <col> -incr|decr]</tt><br> -<tt> [<ref>] [symbol [#] -condition|shape|color|text|font|fontsize|fontweight|fontslant -<value>]<br></tt> <tt> -[<ref>] [symbol [#] text|size|size2|units|angle -<value>]<br></tt> <tt> -[<ref>] [symbol shape circle|ellipse|box|text|point]<br> - </tt> <tt><tt>[<ref>] -[symbol shape</tt></tt> <tt><tt>circle point|box point|diamond -point|</tt>cross point|x point|arrow point|boxcircle point]<br> - [<ref>] [symbol -add| [#] remove]<br> - [<ref>] [symbol -save|load <filename>]</tt><br> -<tt> [<ref>] [system -<coordsys>]</tt><tt><br></tt> <tt> - </tt> <tt>[<ref>] [update]</tt><br> -<tt> [<ref>] [x -<col>]</tt><br> -<tt> [<ref>] [y -<col>]</tt><br> -<tt> <br> -Example:<br> -$xpaget ds9 catalog<br></tt> <tt>$xpaget ds9 catalog -header</tt><br> -<tt><br></tt> <tt><tt>$xpaset -p ds9 catalog new<br></tt> $xpaset --p ds9 catalog 2mass<br> -$xpaset -p ds9 catalog cds 2mass<br> -$xpaset -p ds9 catalog cds {I/252}<br> -<br></tt> <tt>$xpaset -p ds9 catalog load foo.xml<br> -$xpaset -p ds9 catalog import tsv foo.tsv<br> -<br></tt> <tt><tt>$xpaset -p ds9 catalog 202.48 47.21 fk5<br></tt> -$xpaset -p ds9 catalog allrows<br> -$xpaset -p ds9 catalog allcols<br></tt> <tt>$xpaset -p ds9 catalog -cancel<br></tt> <tt>$xpaset -p ds9 catalog clear<br></tt> -<tt>$xpaset -p ds9 catalog close<br></tt> <tt>$xpaset -p ds9 -catalog crosshair<br></tt> <tt>$xpaset -p ds9 catalog dec -DEC<br></tt> <tt>$xpaset -p ds9 catalog edit yes<br></tt> -<tt>$xpaset -p ds9 catalog export tsv bar.tsv<br></tt> <tt>$xpaset --p ds9 catalog filter '$Jmag>10'<br> -$xpaset -p ds9 catalog filter load foo.flt<br> -$xpaset -p ds9 catalog header<br></tt> <tt>$xpaset -p ds9 catalog -location 500</tt><br> -<tt>$xpaset -p ds9 catalog match error 2 arcsec<br> -$xpaset -p ds9 catalog match function 1and2<br> -$xpaset -p ds9 catalog match unique no<br> -$xpaset -p ds9 catalog match return 1only<br></tt> <tt>$xpaset -p -ds9 catalog match # last two catalogs loaded<br></tt> <tt>$xpaset --p ds9 catalog match 2mass csc<br></tt> <tt>$xpaset -p ds9 catalog -maxrows 2000<br></tt> <tt>$xpaset -p ds9 catalog name m51<br> -$xpaset -p ds9 catalog panto no<br></tt> <tt>$xpaset -p ds9 catalog -plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag'<br></tt> <tt>$xpaset -p -ds9 catalog print</tt><br> -<tt>$xpaset -p ds9 catalog psky fk5</tt><br> -<tt>$xpaset -p ds9 catalog psystem wcs</tt><br> -<tt>$xpaset -p ds9 catalog ra RA<br> -$xpaset -p ds9 catalog regions</tt><br> -<tt>$xpaset -p ds9 catalog retrieve<br></tt> <tt>$xpaset -p ds9 -catalog samp broadcast<br> -$xpaset -p ds9 catalog samp send aladin<br> -$xpaset -p ds9 catalog save foo.xml<br></tt> <tt>$xpaset -p ds9 -catalog server sao<br></tt> <tt>$xpaset -p ds9 catalog show -yes</tt><br> -<tt>$xpaset -p ds9 catalog radius 1 degrees</tt><br> -<tt>$xpaset -p ds9 catalog symbol condition '$Jmag>15'<br> -$xpaset -p ds9 catalog symbol 2 shape {boxcircle point}<br> -$xpaset -p ds9 catalog symbol color red<br> -$xpaset -p ds9 catalog symbol font times<br></tt> <tt>$xpaset -p -ds9 catalog symbol fontsize 14<br></tt> <tt>$xpaset -p ds9 catalog -symbol fontweight bold<br></tt> <tt>$xpaset -p ds9 catalog symbol -fontslant italic<br></tt> <tt>$xpaset -p ds9 catalog symbol add<br> -$xpaset -p ds9 catalog symbol 2 remove<br> -$xpaset -p ds9 catalog symbol load foo.sym<br> -$xpaset -p ds9 catalog symbol save bar.sym</tt><tt><br> -$xpaset -p ds9 catalog sky fk5<br> -$xpaset -p ds9 catalog skyformat degrees<br></tt> <tt>$xpaset -p -ds9 catalog sort {Jmag} incr<br></tt> <tt>$xpaset -p ds9 catalog -system wcs</tt><tt><br></tt> <tt>$xpaset -p ds9 catalog -update<br></tt> <tt>$xpaset -p ds9 catalog x RA<br> -$xpaset -p ds9 catalog y DEC</tt><br> -<p><b><a name="cd" id="cd"></a>cd</b></p> -<p>Sets/Returns the current working directory.</p> -<tt>Syntax:<br> -cd [<directory>]<br> - <br> -Example:<br> -$xpaget ds9 cd<br> -$xpaset -p ds9 cd /home/mrbill<br></tt> -<p><b><a name="cmap" id="cmap"></a>cmap</b></p> -<p>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.</p> -<tt>Syntax:<br> -cmap [<colormap>]<br> - [file]<br> - [load <filename>]<br></tt> -<tt> [save <filename>]<br></tt> -<tt> [invert yes|no]<br> - [<constrast> <bias>]<br> - [tag [load|save] <filename>]<br> - [tag delete]<br></tt> -<tt> [open|close]<br> - <br> -Example:<br> -$xpaget ds9 cmap<br> -$xpaget ds9 cmap file<br> -$xpaget ds9 cmap invert<br> -$xpaget ds9 cmap value<br></tt> <tt>$xpaset -p ds9 cmap Heat<br> -$xpaset -p ds9 cmap load foo.sao<br></tt> <tt>$xpaset -p ds9 cmap -save bar.sao<br></tt> <tt>$xpaset -p ds9 cmap invert yes<br> -$xpaset -p ds9 cmap 5 .5<br> -$xpaset -p ds9 cmap tag load foo.tag<br> -$xpaset -p ds9 cmap tag save foo.tag<br> -$xpaset -p ds9 cmap tag delete<br></tt> <tt>$xpaset -p ds9 cmap -open<br> -$xpaset -p ds9 cmap close<br></tt> -<p><b><a name="colorbar" id="colorbar"></a>colorbar<br></b></p> -<p>Controls colorbar parameters.</p> -<tt>Syntax:<br> -colorbar []<br> - [yes|no]<br> - [orientation]<br> - -[horizontal|vertical]<br> - [numerics -yes|no]<br> - [space -value|distance]<br> - [font -times|helvetica|courier]<br> - [fontsize -<value>]<br> - [fontweight -normal|bold]<br> - [fontslant -roman|italic]<br> - [size]<br> - [ticks]</tt><br> -<tt><tt> -[match]<br> - [lock -[yes|no]]</tt><br></tt> <tt> </tt><br> -Example:<br> -$xpaget ds9 colorbar<br> -$xpaget ds9 colorbar orientation<br> -$xpaget ds9 colorbar numerics<br> -$xpaget ds9 colorbar space<br> -$xpaget ds9 colorbar font<br> -$xpaget ds9 colorbar fontsize<br> -$xpaget ds9 colorbar fontweight<br> -$xpaget ds9 colorbar fontslant<br> -$xpaget ds9 colorbar size<br> -$xpaget ds9 colorbar ticks<br> -<tt><tt>$xpaget ds9 colorbar lock</tt><br> -$xpaset -p ds9 colorbar yes<br> -$xpaset -p ds9 colorbar vertical<br> -$xpaset -p ds9 colorbar orientation vertical<br> -$xpaset -p ds9 colorbar numerics yes<br> -$xpaset -p ds9 colorbar space value<br> -$xpaset -p ds9 colorbar font times<br> -$xpaset -p ds9 colorbar fontsize 14<br> -$xpaset -p ds9 colorbar fontweight bold<br> -$xpaset -p ds9 colorbar fontslant italic<br> -$xpaset -p ds9 colorbar size 20<br> -$xpaset -p ds9 colorbar ticks 11</tt><br> -<tt><tt>$xpaset -p ds9 colorbar match<br> -$xpaset -p ds9 colorbar lock yes</tt><br></tt> -<p><b><a name="console" id="console"></a>console</b></p> -<p>Display tcl console window.</p> -<tt>Syntax:<br> --console<br> - <br> -Example:<br> -$xpaset -p ds9 console<br></tt> -<p><b><a name="contour" id="contour"></a>contour<br></b></p> -<p>Controls contours in the current frame.</p> -<tt>Syntax:<br> -contour []<br> - [yes|no]<br> - [<coordsys> -[<skyframe>]]<br> - [clear]<br> - [generate]<br> - [load -<filename>]<br> - [save <filename> -[<coordsys> <skyframe>]]<br> - [convert]<br> - [load levels -<filename>]<br> - [save levels -<filename>]<br> - [copy]<br> - [paste [<coordsys> -<color> <width> yes|no]]<br> - [color <color>]<br> - [width <width>]<br> - [dash yes|no]<br> - [smooth <smooth>]<br> - [method block|smooth]<br> - [nlevels <number of -levels>]<br> - [scale -linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope global|local]<br> - [limits <min> -<max>]<br> - [levels <value value -value...>]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 contour<br> -$xpaget ds9 contour wcs fk5<br> -$xpaget ds9 contour color<br> -$xpaget ds9 contour width<br> -$xpaget ds9 contour dash<br> -$xpaget ds9 contour smooth<br> -$xpaget ds9 contour method<br> -$xpaget ds9 contour nlevels<br> -$xpaget ds9 contour scale<br> -$xpaget ds9 contour log exp<br> -$xpaget ds9 contour mode<br> -$xpaget ds9 contour scope<br> -$xpaget ds9 contour limits<br> -$xpaget ds9 contour levels<br> -$xpaset -p ds9 contour<br> -$xpaset -p ds9 contour yes<br> -$xpaset -p ds9 contour clear<br> -$xpaset -p ds9 contour generate<br></tt> <tt><tt>$xpaset -p ds9 -contour load ds9.ctr<br></tt></tt> <tt><tt>$xpaset -p ds9 contour -save ds9.ctr<br></tt> $xpaset -p ds9 contour save ds9.ctr wcs -fk5<br> -$xpaset -p ds9 contour convert<br> -$xpaset -p ds9 contour load levels ds9.ctr</tt><br> -<tt><tt>$xpaset -p ds9 contour save levels ds9.lev<br></tt> $xpaset --p ds9 contour copy<br></tt> <tt><tt>$xpaset -p ds9 contour -paste<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 contour paste wcs -red 2 no<br></tt></tt> $xpaset -p ds9 contour color yellow<br> -$xpaset -p ds9 contour width 2<br> -$xpaset -p ds9 contour dash yes<br> -$xpaset -p ds9 contour smooth 5<br> -$xpaset -p ds9 contour method smooth<br> -$xpaset -p ds9 contour nlevels 10<br> -$xpaset -p ds9 contour scale sqrt<br> -$xpaset -p ds9 contour log exp 1000<br> -$xpaset -p ds9 contour mode zscale<br> -$xpaset -p ds9 contour scope local<br> -$xpaset -p ds9 contour limits 1 100<br> -$xpaset -p ds9 contour levels {1 10 100 1000}<br> -$xpaset -p ds9 contour open<br> -$xpaset -p ds9 contour close<br></tt> -<p><b><a name="crop" id="crop"></a>crop</b></p> -<p>Set current image display area.</p> -<tt>Syntax:<br> -crop [<x> <y> <width> <height> -[<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [reset]<br> - [3d zmin zmax <coordsys>]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 crop # get crop in physical coords<br> -$xpaget ds9 crop wcs galactic sexagesimal arcsec<br> -$xpaget ds9 crop lock<br> -$xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords<br> -$xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 -22.000204 wcs galactic arcsec<br> -$xpaset -p ds9 crop match wcs<br> -$xpaset -p ds9 crop lock wcs<br></tt> <tt>$xpaset -p ds9 crop -reset<br></tt> <tt><tt>$xpaset -p ds9 crop 3d .25 .50 -wcs</tt></tt><br> -<tt>$xpaset -p ds9 crop open</tt><br> -<tt>$xpaset -p ds9 crop close</tt> -<p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> -<p>Controls the current position of the crosshair in the current -frame. DS9 is placed in crosshair mode when the crosshair is -set.</p> -<tt>Syntax:<br> -crosshair [<x> <y> <coordsys> -[<skyframe>]]<br> - [match -<coordsys>]<br> - [lock -<coordsys>|none]<br> - <br> -Example:<br> -$xpaget ds9 crosshair # get crosshair in physical coords<br> -$xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs -coords<br> -$xpaget ds9 crosshair lock<br> -$xpaset -p ds9 crosshair 100 100 physical # set crosshair in -physical<br> -$xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs -coords<br> -$xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5<br> -$xpaset -p ds9 crosshair match wcs<br> -$xpaset -p ds9 crosshair lock wcs<br></tt> -<p><b><a name="cube" id="cube"></a>cube<br></b></p> -<p>Controls FITS cube dialog.</p> -<tt>Syntax:<br> -cube []<br> - [play|stop|next|prev|first|last]<br> - [<slice> -[<coordsys>][<axis>]]<br> - [interval <numeric>]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [order 123|132|213|231|312|321]<br> - [axes lock [yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 cube<br> -$xpaget ds9 cube interval<br> -$xpaget ds9 cube lock<br> -$xpaget ds9 cube order<br> -$xpaget ds9 cube axes lock<br> -$xpaset -p ds9 cube<br> -$xpaset -p ds9 cube play<br> -$xpaset -p ds9 cube last<br> -$xpaset -p ds9 cube 3<br> -$xpaset -p ds9 cube 4.4 wcs 3<br> -$xpaset -p ds9 cube interval 2<br> -$xpaset -p ds9 cube match wcs<br> -$xpaset -p ds9 cube lock wcs<br> -$xpaset -p ds9 cube order 123<br> -$xpaset -p ds9 cube axes lock yes<br> -$xpaset -p ds9 cube open<br> -$xpaset -p ds9 cube close</tt><br> -<p><b><a name="cursor" id="cursor"></a>cursor</b></p> -<p>Move mouse pointer or crosshair in image pixels in the current -frame. Note, this will move selected Regions also.</p> -<tt>Syntax:<br> -cursor [<x> <y>]<br> - <br> -Example:<br> -$xpaset -p ds9 cursor 10 10<br></tt> -<p><b><a name="data" id="data"></a>data</b></p> -<p>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.</p> -<tt>Syntax:<br> -data [<coordsys> [<skyframe>] <x> <y> -<width> <height> [yes|no]]<br> - <br> -Example:<br> -$xpaget ds9 data image 450 520 3 3 yes<br> -$xpaget ds9 data physical 899 1039 6 6 no<br> -$xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 -0.00016516669 no<br> -$xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 -0.00016516669 no</tt><tt><br></tt> -<p><b><a name="dsssao" id="dsssao"></a>dsssao<br> -dss<br></b></p> -<p>Support for Digital Sky Survey at SAO.</p> -<tt>Syntax:<br> -dsssao []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 dsssao name<br> -$xpaget ds9 dsssao coord<br> -$xpaget ds9 dsssao size<br> -$xpaget ds9 dsssao save<br> -$xpaget ds9 dsssao frame<br> -$xpaset -p ds9 dsssao<br> -$xpaset -p ds9 dsssao m31<br></tt> <tt><tt>$xpaset -p ds9 dsssao -name m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 dsssao name -clear<br></tt></tt> $xpaset -p ds9 dsssao 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 dsssao size 60 60 arcmin<br> -$xpaset -p ds9 dsssao save yes<br> -$xpaset -p ds9 dsssao frame current<br> -$xpaset -p ds9 dsssao update frame<br> -$xpaset -p ds9 dsssao open<br></tt> <tt>$xpaset -p ds9 dsssao -close</tt><br> -<p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> -<p>Support for Digital Sky Survey at ESO.</p> -<tt>Syntax:<br> -dsseso []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] # in -wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey -DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 dsseso name<br> -$xpaget ds9 dsseso coord<br> -$xpaget ds9 dsseso size<br> -$xpaget ds9 dsseso save<br> -$xpaget ds9 dsseso frame<br> -$xpaget ds9 dsseso survey<br> -$xpaset -p ds9 dsseso<br> -$xpaset -p ds9 dsseso m31<br></tt> <tt><tt>$xpaset -p ds9 dsseso -name m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 dsseso name -clear<br></tt></tt> $xpaset -p ds9 dsseso 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 dsseso size 60 60 arcmin<br> -$xpaset -p ds9 dsseso save yes<br> -$xpaset -p ds9 dsseso frame current<br> -$xpaset -p ds9 dsseso update frame<br> -$xpaset -p ds9 dsseso survey DSS2-red<br> -$xpaset -p ds9 dsseso open<br></tt> <tt>$xpaset -p ds9 dsseso -close</tt><br> -<p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> -<p>Support for Digital Sky Survey at STSCI.</p> -<tt>Syntax:<br> -dssstsci []<br> - -[<object>]<br> - [name <object>|clear]<br> - [<ra> -<dec>] # in wcs fk5<br> - [size -<width> <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame -new|current]<br> - [update -frame|crosshair]<br> - [survey -poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> - [survey -poss1_blue|poss1_red]<br> - [survey -all|quickv|phase2_gsc2|phase2_gsc1]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 dssstsci name<br> -$xpaget ds9 dssstsci coord<br> -$xpaget ds9 dssstsci size<br> -$xpaget ds9 dssstsci save<br> -$xpaget ds9 dssstsci frame<br> -$xpaget ds9 dssstsci survey<br> -$xpaset -p ds9 dssstsci<br> -$xpaset -p ds9 dssstsci m31<br></tt> <tt><tt>$xpaset -p ds9 -dssstsci name m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 dssstsci -name clear<br></tt></tt> $xpaset -p ds9 dssstsci 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 dssstsci size 60 60 arcmin<br> -$xpaset -p ds9 dssstsci save yes<br> -$xpaset -p ds9 dssstsci frame current<br> -$xpaset -p ds9 dssstsci update frame<br> -$xpaset -p ds9 dssstsci survey all<br> -$xpaset -p ds9 dssstsci open<br> -$xpaset -p ds9 dssstsci close</tt><br> -<p><b><a name="envi" id="envi"></a>envi</b></p> -<p>Load an ENVI header and file. Optional parameter: array -endian.<br></p> -<tt>Syntax:<br> -envi [new] <header> [<filename>]<br> - <br> -Example:<br></tt> <tt><tt>$xpaset -p ds9 envi foo.hdr</tt></tt><br> -<tt><tt>$xpaset -p ds9 envi new foo.hdr<br></tt></tt> -<tt><tt><tt><tt><tt><tt>$xpaset -p ds9 envi foo.hdr -foo.bsq</tt></tt><br> -<br></tt></tt></tt></tt> <b><a name="exit" id= -"exit"></a>exit</b><br> -<p><b>quits<br></b></p> -<p>Quits DS9.</p> -<tt>Syntax:<br> -exit<br> -quit<br> - <br> -Example:<br> -$xpaset -p ds9 exit<br></tt> -<p><b><a name="export" id="export"></a>export<br></b></p> -<p>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.</p> -<tt>Syntax:</tt> <tt><br></tt> <tt>export</tt> -<tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> -<tt><filename></tt><tt><br></tt> <tt>export array -<filename></tt> <tt>[big|little</tt><tt>|native]<br></tt> -<tt>export nrrd <filename></tt> -<tt>[big|little</tt><tt>|native]</tt><tt><br> -export envi <header> [<filename>]</tt> -<tt>[big|little</tt><tt>|native]</tt> <tt><br> -export jpeg <filename></tt> <tt>[1-100]</tt><tt><br></tt> -<tt>export tiff <filename</tt><tt>></tt> -<tt>[none|jpeg|packbits|deflate]</tt><br> -<tt> <br> -Example:<br></tt> <tt><tt>$xpaset -p ds9 export array foo.arr -little</tt></tt><br> -<tt><tt>$xpaset -p ds9 export nrrd foo.nrrd little</tt></tt><br> -<tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi foo.hdr -little</tt></tt><br></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi -foo.hdr foo.bsq little</tt></tt><br></tt></tt></tt></tt> $xpaset -p -ds9 export tiff foo.tiff jpeg</tt></tt></tt><br> -$xpaset -p ds9 export jpeg foo.jpeg 75<br> -$xpaset -p ds9 export png foo.png</tt><br> -<p><b><a name="file" id="file"></a>file</b></p> -<p>Query currently loaded file information.</p> -<tt>Syntax:<br> -file<br> - <br> -Example:<br> -$xpaget ds9 file</tt><br> -<p><b><a name="fits" id="fits"></a>fits</b></p> -<p>Load a FITS image into the current frame or query the currently -loaded image.<br></p> -<tt>Syntax:<br> -fits</tt> <tt><tt>[new|mask|slice] -[<filename>]</tt><tt><br></tt> -[width|height|depth|bitpix]<br> - [size [wcs|wcsa...wcsz] -[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword -<string>]]<br> - [image|table|slice]</tt><tt><br> - <br> -Example:<br> -$xpaget ds9 fits > foo.fits<br> -$xpaget ds9 fits width<br> -$xpaget ds9 fits height<br> -$xpaget ds9 fits depth<br> -$xpaget ds9 fits bitpix</tt><br> -<tt><tt>$xpaget ds9 fits size<br></tt> $xpaget ds9 fits size wcs -fk5 arcmin<br> -$xpaget ds9 fits header # primary<br> -$xpaget ds9 fits header 2 # hdu 2<br> -$xpaget ds9 fits header -2 # hdu 2 with inherit<br> -$xpaget ds9 fits header keyword BITPIX<br> -$xpaget ds9 fits header 1 keyword BITPIX</tt><br> -<tt><tt>$xpaget ds9 fits image > foo.fits<br> -$xpaget ds9 fits table > bar.fits<br> -$xpaget ds9 fits slice > foo.fits<br></tt> $xpaset -p ds9 fits -foo.fits<br> -$xpaset -p ds9 fits new foo.fits<br> -$xpaset -p ds9 fits bar.fits[bin=detx,dety]<br> -$xpaset -p ds9 fits slice foo.fits<br> -$xpaset -p ds9 fits mask foo.fits<br> -$cat foo.fits | xpaset ds9 fits<br> -$cat foo.fits | xpaset ds9 fits new<br> -$cat bar.fits | xpaset ds9 fits -[bin=detx,dety]<br> -$cat foo.fits | xpaset ds9 fits slice<br> -$cat foo.fits | xpaset ds9 fits mask<br></tt> -<p><b><a name="frame" id="frame"></a>frame</b></p> -<p>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.</p> -<tt>Syntax:<br> -frame [center [#|all]]<br> - [clear [#|all]]<br> - [new [rgb|3d]]<br> - [delete [#|all]]<br> - [reset [#|all]]<br> - [refresh [#|all]]<br> - [hide [#|all]]<br> - [show [#|all]]<br> - [move first]<br> - [move back]<br> - [move forward]<br> - [move last]<br> - [first]<br> - [prev]<br> - [next]<br> - [last]<br> - [frameno #]<br> - [#]<br></tt> -<tt> [match <coordsys>]<br> - [lock -<coordsys>|none]</tt><br> -<tt> [has + + [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> + [2mass|iras]<br> + [csc|xmm|rosat]<br> + [first|nvss]<br> + + [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> + [cds <catalogname>]<br> + [cds + <catalogid>]<br> + <br> + [load <filename>]<br> + [import sb|tsv + <filename>]<br> + <br> + </tt> <tt><tt> + [<ref>] [<ra> <dec> + <coordsys>]</tt><tt><br> + </tt> + [<ref>] [allcols]<br> + </tt> + <tt> </tt><tt> [<ref>] + [allrows]<br> + </tt><tt> [<ref>] + [cancel]<br> + </tt> <tt> + [<ref>] [clear]<br> + </tt> <tt> + [<ref>] [close]</tt><br> + <tt> </tt> + <tt>[<ref>] [crosshair]</tt><br> + <tt> [<ref>] [dec + <col>]</tt><br> + <tt> [<ref>] [edit + yes|no]</tt><br> + <tt> [<ref>] + [export sb|tsv <filename>]<br> + </tt> + <tt> [<ref>] + [filter <string>]<br> + [<ref>] [filter load + <filename>]</tt><br> + <tt> [<ref>] + [header]</tt><br> + <tt> [<ref>] [location + <code>]</tt><br> + <tt><tt> [<ref>] + [match]<br> + </tt></tt> + <tt><tt><tt> + [<ref>] [match <ref> <ref>]<br> + </tt></tt> + </tt> <tt>[<ref>] +[match + error <value> degrees|arcmin|arcsec]</tt><br> + <tt> </tt> + <tt>[<ref>] [match function 1and2|1not2|2not1]<br> + </tt> + <tt> </tt> + <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> + <tt> </tt> + <tt>[<ref>] [match unique yes|no]</tt><br> + <tt> [<ref>] [maxrows + <number>]</tt><br> + <tt> [<ref>] [name + <object>]<br> + </tt> + <tt> [<ref>] + [panto + yes|no]</tt><br> + <tt> [<ref>] [plot + <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> + <tt> [<ref>] [print]</tt><br> + <tt> [<ref>] [psky + <skyframe>]</tt><br> + <tt> [<ref>] [psystem + <coordsys>]</tt><br> + <tt> [<ref>] [ra + <col>]<br> + [<ref>] + [regions]</tt><br> + <tt> [<ref>] + [retrieve]</tt><br> + <tt> [<ref>] [samp]<br> + [<ref>] [samp + broadcast]<br> + [<ref>] [samp + send + <application>]</tt><tt><br> + </tt> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] + [server + cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><br> + <tt> [<ref>] [show + yes|no]</tt><br> + <tt> [<ref>] [radius + <value> degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> + [<ref>] [skyformat + <skyformat>]<br> + </tt> <tt> + [<ref>] [sort <col> + incr|decr]</tt><br> + <tt> [<ref>] [symbol + [#] + condition|shape|color|text|font|fontsize|fontweight|fontslant + <value>]<br> + </tt> <tt> + [<ref>] [symbol [#] text|size|size2|units|angle + <value>]<br> + </tt> <tt> + [<ref>] [symbol shape circle|ellipse|box|text|point]<br> + </tt> <tt><tt>[<ref>] +[symbol + shape</tt></tt> <tt><tt>circle point|box point|diamond + point|</tt>cross point|x point|arrow point|boxcircle point]<br> + [<ref>] [symbol + add| [#] remove]<br> + [<ref>] [symbol + save|load <filename>]</tt><br> + <tt> [<ref>] [system + <coordsys>]</tt><tt><br> + </tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> + <tt> [<ref>] [x + <col>]</tt><br> + <tt> [<ref>] [y + <col>]</tt><br> + <tt> <br> + Example:<br> + $xpaget ds9 catalog<br> + </tt> <tt>$xpaget ds9 catalog + header</tt><br> + <tt><br> + </tt> <tt><tt>$xpaset -p ds9 catalog new<br> + </tt> $xpaset + -p ds9 catalog 2mass<br> + $xpaset -p ds9 catalog cds 2mass<br> + $xpaset -p ds9 catalog cds {I/252}<br> + <br> + </tt> <tt>$xpaset -p ds9 catalog load foo.xml<br> + $xpaset -p ds9 catalog import tsv foo.tsv<br> + <br> + </tt> <tt><tt>$xpaset -p ds9 catalog 202.48 47.21 fk5<br> + </tt> + $xpaset -p ds9 catalog allrows<br> + $xpaset -p ds9 catalog allcols<br> + </tt> <tt>$xpaset -p ds9 catalog + cancel<br> + </tt> <tt>$xpaset -p ds9 catalog clear<br> + </tt> + <tt>$xpaset -p ds9 catalog close<br> + </tt> <tt>$xpaset -p ds9 + catalog crosshair<br> + </tt> <tt>$xpaset -p ds9 catalog dec + DEC<br> + </tt> <tt>$xpaset -p ds9 catalog edit yes<br> + </tt> + <tt>$xpaset -p ds9 catalog export tsv bar.tsv<br> + </tt> <tt>$xpaset + -p ds9 catalog filter '$Jmag>10'<br> + $xpaset -p ds9 catalog filter load foo.flt<br> + $xpaset -p ds9 catalog header<br> + </tt> <tt>$xpaset -p ds9 catalog + location 500</tt><br> + <tt>$xpaset -p ds9 catalog match error 2 arcsec<br> + $xpaset -p ds9 catalog match function 1and2<br> + $xpaset -p ds9 catalog match unique no<br> + $xpaset -p ds9 catalog match return 1only<br> + </tt> <tt>$xpaset -p + ds9 catalog match # last two catalogs loaded<br> + </tt> <tt>$xpaset + -p ds9 catalog match 2mass csc<br> + </tt> <tt>$xpaset -p ds9 catalog + maxrows 2000<br> + </tt> <tt>$xpaset -p ds9 catalog name m51<br> + $xpaset -p ds9 catalog panto no<br> + </tt> <tt>$xpaset -p ds9 catalog + plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag'<br> + </tt> <tt>$xpaset -p + ds9 catalog print</tt><br> + <tt>$xpaset -p ds9 catalog psky fk5</tt><br> + <tt>$xpaset -p ds9 catalog psystem wcs</tt><br> + <tt>$xpaset -p ds9 catalog ra RA<br> + $xpaset -p ds9 catalog regions</tt><br> + <tt>$xpaset -p ds9 catalog retrieve<br> + </tt> <tt>$xpaset -p ds9 + catalog samp broadcast<br> + $xpaset -p ds9 catalog samp send aladin<br> + $xpaset -p ds9 catalog save foo.xml<br> + </tt> <tt>$xpaset -p ds9 + catalog server sao<br> + </tt> <tt>$xpaset -p ds9 catalog show + yes</tt><br> + <tt>$xpaset -p ds9 catalog radius 1 degrees</tt><br> + <tt>$xpaset -p ds9 catalog symbol condition '$Jmag>15'<br> + $xpaset -p ds9 catalog symbol 2 shape {boxcircle point}<br> + $xpaset -p ds9 catalog symbol color red<br> + $xpaset -p ds9 catalog symbol font times<br> + </tt> <tt>$xpaset -p + ds9 catalog symbol fontsize 14<br> + </tt> <tt>$xpaset -p ds9 catalog + symbol fontweight bold<br> + </tt> <tt>$xpaset -p ds9 catalog symbol + fontslant italic<br> + </tt> <tt>$xpaset -p ds9 catalog symbol add<br> + $xpaset -p ds9 catalog symbol 2 remove<br> + $xpaset -p ds9 catalog symbol load foo.sym<br> + $xpaset -p ds9 catalog symbol save bar.sym</tt><tt><br> + $xpaset -p ds9 catalog sky fk5<br> + $xpaset -p ds9 catalog skyformat degrees<br> + </tt> <tt>$xpaset -p + ds9 catalog sort {Jmag} incr<br> + </tt> <tt>$xpaset -p ds9 catalog + system wcs</tt><tt><br> + </tt> <tt>$xpaset -p ds9 catalog + update<br> + </tt> <tt>$xpaset -p ds9 catalog x RA<br> + $xpaset -p ds9 catalog y DEC</tt><br> + <p><b><a name="cd" id="cd"></a>cd</b></p> + <p>Sets/Returns the current working directory.</p> + <tt>Syntax:<br> + cd [<directory>]<br> + <br> + Example:<br> + $xpaget ds9 cd<br> + $xpaset -p ds9 cd /home/mrbill<br> + </tt> + <p><b><a name="cmap" id="cmap"></a>cmap</b></p> + <p>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.</p> + <tt>Syntax:<br> + cmap [<colormap>]<br> + [file]<br> + [load <filename>]<br> + </tt> + <tt> [save <filename>]<br> + </tt> + <tt> [invert yes|no]<br> + [<constrast> <bias>]<br> + [tag [load|save] <filename>]<br> + [tag delete]<br> + </tt> + <tt> [open|close]<br> + <br> + Example:<br> + $xpaget ds9 cmap<br> + $xpaget ds9 cmap file<br> + $xpaget ds9 cmap invert<br> + $xpaget ds9 cmap value<br> + </tt> <tt>$xpaset -p ds9 cmap Heat<br> + $xpaset -p ds9 cmap load foo.sao<br> + </tt> <tt>$xpaset -p ds9 cmap + save bar.sao<br> + </tt> <tt>$xpaset -p ds9 cmap invert yes<br> + $xpaset -p ds9 cmap 5 .5<br> + $xpaset -p ds9 cmap tag load foo.tag<br> + $xpaset -p ds9 cmap tag save foo.tag<br> + $xpaset -p ds9 cmap tag delete<br> + </tt> <tt>$xpaset -p ds9 cmap + open<br> + $xpaset -p ds9 cmap close<br> + </tt> + <p><b><a name="colorbar" id="colorbar"></a>colorbar<br> + </b></p> + <p>Controls colorbar parameters.</p> + <tt>Syntax:<br> + colorbar []<br> + [yes|no]<br> + [orientation]<br> + + [horizontal|vertical]<br> + [numerics + yes|no]<br> + [space + value|distance]<br> + [font + times|helvetica|courier]<br> + [fontsize + <value>]<br> + [fontweight + normal|bold]<br> + [fontslant + roman|italic]<br> + [size]<br> + [ticks]</tt><br> + <tt><tt> + [match]<br> + [lock + [yes|no]]</tt><br> + </tt> <tt> </tt><br> + Example:<br> + $xpaget ds9 colorbar<br> + $xpaget ds9 colorbar orientation<br> + $xpaget ds9 colorbar numerics<br> + $xpaget ds9 colorbar space<br> + $xpaget ds9 colorbar font<br> + $xpaget ds9 colorbar fontsize<br> + $xpaget ds9 colorbar fontweight<br> + $xpaget ds9 colorbar fontslant<br> + $xpaget ds9 colorbar size<br> + $xpaget ds9 colorbar ticks<br> + <tt><tt>$xpaget ds9 colorbar lock</tt><br> + $xpaset -p ds9 colorbar yes<br> + $xpaset -p ds9 colorbar vertical<br> + $xpaset -p ds9 colorbar orientation vertical<br> + $xpaset -p ds9 colorbar numerics yes<br> + $xpaset -p ds9 colorbar space value<br> + $xpaset -p ds9 colorbar font times<br> + $xpaset -p ds9 colorbar fontsize 14<br> + $xpaset -p ds9 colorbar fontweight bold<br> + $xpaset -p ds9 colorbar fontslant italic<br> + $xpaset -p ds9 colorbar size 20<br> + $xpaset -p ds9 colorbar ticks 11</tt><br> + <tt><tt>$xpaset -p ds9 colorbar match<br> + $xpaset -p ds9 colorbar lock yes</tt><br> + </tt> + <p><b><a name="console" id="console"></a>console</b></p> + <p>Display tcl console window.</p> + <tt>Syntax:<br> + -console<br> + <br> + Example:<br> + $xpaset -p ds9 console<br> + </tt> + <p><b><a name="contour" id="contour"></a>contour<br> + </b></p> + <p>Controls contours in the current frame.</p> + <tt>Syntax:<br> + contour []<br> + [yes|no]<br> + [<coordsys> + [<skyframe>]]<br> + [clear]<br> + [generate]<br> + [load + <filename>]<br> + [save <filename> + [<coordsys> <skyframe>]]<br> + [convert]<br> + [load levels + <filename>]<br> + [save levels + <filename>]<br> + [copy]<br> + [paste + [<coordsys> + <color> <width> yes|no]]<br> + [color <color>]<br> + [width <width>]<br> + [dash yes|no]<br> + [smooth <smooth>]<br> + [method block|smooth]<br> + [nlevels <number of + levels>]<br> + [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope global|local]<br> + [limits <min> + <max>]<br> + [levels <value + value + value...>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 contour<br> + $xpaget ds9 contour wcs fk5<br> + $xpaget ds9 contour color<br> + $xpaget ds9 contour width<br> + $xpaget ds9 contour dash<br> + $xpaget ds9 contour smooth<br> + $xpaget ds9 contour method<br> + $xpaget ds9 contour nlevels<br> + $xpaget ds9 contour scale<br> + $xpaget ds9 contour log exp<br> + $xpaget ds9 contour mode<br> + $xpaget ds9 contour scope<br> + $xpaget ds9 contour limits<br> + $xpaget ds9 contour levels<br> + $xpaset -p ds9 contour<br> + $xpaset -p ds9 contour yes<br> + $xpaset -p ds9 contour clear<br> + $xpaset -p ds9 contour generate<br> + </tt> <tt><tt>$xpaset -p ds9 + contour load ds9.ctr<br> + </tt></tt> <tt><tt>$xpaset -p ds9 contour + save ds9.ctr<br> + </tt> $xpaset -p ds9 contour save ds9.ctr wcs + fk5<br> + $xpaset -p ds9 contour convert<br> + $xpaset -p ds9 contour load levels ds9.ctr</tt><br> + <tt><tt>$xpaset -p ds9 contour save levels ds9.lev<br> + </tt> $xpaset + -p ds9 contour copy<br> + </tt> <tt><tt>$xpaset -p ds9 contour + paste<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 contour paste wcs + red 2 no<br> + </tt></tt> $xpaset -p ds9 contour color yellow<br> + $xpaset -p ds9 contour width 2<br> + $xpaset -p ds9 contour dash yes<br> + $xpaset -p ds9 contour smooth 5<br> + $xpaset -p ds9 contour method smooth<br> + $xpaset -p ds9 contour nlevels 10<br> + $xpaset -p ds9 contour scale sqrt<br> + $xpaset -p ds9 contour log exp 1000<br> + $xpaset -p ds9 contour mode zscale<br> + $xpaset -p ds9 contour scope local<br> + $xpaset -p ds9 contour limits 1 100<br> + $xpaset -p ds9 contour levels {1 10 100 1000}<br> + $xpaset -p ds9 contour open<br> + $xpaset -p ds9 contour close<br> + </tt> + <p><b><a name="crop" id="crop"></a>crop</b></p> + <p>Set current image display area.</p> + <tt>Syntax:<br> + crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [reset]<br> + [3d zmin zmax <coordsys>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 crop # get crop in physical coords<br> + $xpaget ds9 crop wcs galactic sexagesimal arcsec<br> + $xpaget ds9 crop lock<br> + $xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords<br> + $xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 + 22.000204 wcs galactic arcsec<br> + $xpaset -p ds9 crop match wcs<br> + $xpaset -p ds9 crop lock wcs<br> + </tt> <tt>$xpaset -p ds9 crop + reset<br> + </tt> <tt><tt>$xpaset -p ds9 crop 3d .25 .50 + wcs</tt></tt><br> + <tt>$xpaset -p ds9 crop open</tt><br> + <tt>$xpaset -p ds9 crop close</tt> + <p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> + <p>Controls the current position of the crosshair in the current + frame. DS9 is placed in crosshair mode when the crosshair is + set.</p> + <tt>Syntax:<br> + crosshair [<x> <y> <coordsys> + [<skyframe>]]<br> + [match + <coordsys>]<br> + [lock + <coordsys>|none]<br> + <br> + Example:<br> + $xpaget ds9 crosshair # get crosshair in physical coords<br> + $xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs + coords<br> + $xpaget ds9 crosshair lock<br> + $xpaset -p ds9 crosshair 100 100 physical # set crosshair in + physical<br> + $xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs + coords<br> + $xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5<br> + $xpaset -p ds9 crosshair match wcs<br> + $xpaset -p ds9 crosshair lock wcs<br> + </tt> + <p><b><a name="cube" id="cube"></a>cube<br> + </b></p> + <p>Controls FITS cube dialog.</p> + <tt>Syntax:<br> + cube []<br> + [play|stop|next|prev|first|last]<br> + [<slice> + [<coordsys>][<axis>]]<br> + [interval <numeric>]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 cube<br> + $xpaget ds9 cube interval<br> + $xpaget ds9 cube lock<br> + $xpaget ds9 cube order<br> + $xpaget ds9 cube axes lock<br> + $xpaset -p ds9 cube<br> + $xpaset -p ds9 cube play<br> + $xpaset -p ds9 cube last<br> + $xpaset -p ds9 cube 3<br> + $xpaset -p ds9 cube 4.4 wcs 3<br> + $xpaset -p ds9 cube interval 2<br> + $xpaset -p ds9 cube match wcs<br> + $xpaset -p ds9 cube lock wcs<br> + $xpaset -p ds9 cube order 123<br> + $xpaset -p ds9 cube axes lock yes<br> + $xpaset -p ds9 cube open<br> + $xpaset -p ds9 cube close</tt><br> + <p><b><a name="cursor" id="cursor"></a>cursor</b></p> + <p>Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also.</p> + <tt>Syntax:<br> + cursor [<x> <y>]<br> + <br> + Example:<br> + $xpaset -p ds9 cursor 10 10<br> + </tt> + <p><b><a name="data" id="data"></a>data</b></p> + <p>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.</p> + <tt>Syntax:<br> + data [<coordsys> [<skyframe>] <x> <y> + <width> <height> [yes|no]]<br> + <br> + Example:<br> + $xpaget ds9 data image 450 520 3 3 yes<br> + $xpaget ds9 data physical 899 1039 6 6 no<br> + $xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 + 0.00016516669 no<br> + $xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 + 0.00016516669 no</tt><tt><br> + </tt> + <p><b><a name="dsssao" id="dsssao"></a>dsssao<br> + dss<br> + </b></p> + <p>Support for Digital Sky Survey at SAO.</p> + <tt>Syntax:<br> + dsssao []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 dsssao name<br> + $xpaget ds9 dsssao coord<br> + $xpaget ds9 dsssao size<br> + $xpaget ds9 dsssao save<br> + $xpaget ds9 dsssao frame<br> + $xpaset -p ds9 dsssao<br> + $xpaset -p ds9 dsssao m31<br> + </tt> <tt><tt>$xpaset -p ds9 dsssao + name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsssao name + clear<br> + </tt></tt> $xpaset -p ds9 dsssao 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 dsssao size 60 60 arcmin<br> + $xpaset -p ds9 dsssao save yes<br> + $xpaset -p ds9 dsssao frame current<br> + $xpaset -p ds9 dsssao update frame<br> + $xpaset -p ds9 dsssao open<br> + </tt> <tt>$xpaset -p ds9 dsssao + close</tt><br> + <p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> + <p>Support for Digital Sky Survey at ESO.</p> + <tt>Syntax:<br> + dsseso []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> <dec>] # + in + wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 dsseso name<br> + $xpaget ds9 dsseso coord<br> + $xpaget ds9 dsseso size<br> + $xpaget ds9 dsseso save<br> + $xpaget ds9 dsseso frame<br> + $xpaget ds9 dsseso survey<br> + $xpaset -p ds9 dsseso<br> + $xpaset -p ds9 dsseso m31<br> + </tt> <tt><tt>$xpaset -p ds9 dsseso + name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsseso name + clear<br> + </tt></tt> $xpaset -p ds9 dsseso 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 dsseso size 60 60 arcmin<br> + $xpaset -p ds9 dsseso save yes<br> + $xpaset -p ds9 dsseso frame current<br> + $xpaset -p ds9 dsseso update frame<br> + $xpaset -p ds9 dsseso survey DSS2-red<br> + $xpaset -p ds9 dsseso open<br> + </tt> <tt>$xpaset -p ds9 dsseso + close</tt><br> + <p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> + <p>Support for Digital Sky Survey at STSCI.</p> + <tt>Syntax:<br> + dssstsci []<br> + + [<object>]<br> + [name <object>|clear]<br> + [<ra> + <dec>] # in wcs fk5<br> + [size + <width> <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame + new|current]<br> + [update + frame|crosshair]<br> + [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> + [survey + poss1_blue|poss1_red]<br> + [survey + all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 dssstsci name<br> + $xpaget ds9 dssstsci coord<br> + $xpaget ds9 dssstsci size<br> + $xpaget ds9 dssstsci save<br> + $xpaget ds9 dssstsci frame<br> + $xpaget ds9 dssstsci survey<br> + $xpaset -p ds9 dssstsci<br> + $xpaset -p ds9 dssstsci m31<br> + </tt> <tt><tt>$xpaset -p ds9 + dssstsci name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dssstsci + name clear<br> + </tt></tt> $xpaset -p ds9 dssstsci 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 dssstsci size 60 60 arcmin<br> + $xpaset -p ds9 dssstsci save yes<br> + $xpaset -p ds9 dssstsci frame current<br> + $xpaset -p ds9 dssstsci update frame<br> + $xpaset -p ds9 dssstsci survey all<br> + $xpaset -p ds9 dssstsci open<br> + $xpaset -p ds9 dssstsci close</tt><br> + <p><b><a name="envi" id="envi"></a>envi</b></p> + <p>Load an ENVI header and file. Optional parameter: array + endian.<br> + </p> + <tt>Syntax:<br> + envi [new] <header> [<filename>]<br> + <br> + Example:<br> + </tt> <tt><tt>$xpaset -p ds9 envi foo.hdr</tt></tt><br> + <tt><tt>$xpaset -p ds9 envi new foo.hdr<br> + </tt></tt> + <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 envi foo.hdr + foo.bsq</tt></tt><br> + <br> + </tt></tt></tt></tt> <b><a name="exit" id="exit"></a>exit</b><br> + <p><b>quits<br> + </b></p> + <p>Quits DS9.</p> + <tt>Syntax:<br> + exit<br> + quit<br> + <br> + Example:<br> + $xpaset -p ds9 exit<br> + </tt> + <p><b><a name="export" id="export"></a>export<br> + </b></p> + <p>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.</p> + <tt>Syntax:</tt> <tt><br> + </tt> <tt>export</tt> + <tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> + <tt><filename></tt><tt><br> + </tt> <tt>export array + <filename></tt> <tt>[big|little</tt><tt>|native]<br> + </tt> + <tt>export nrrd <filename></tt> + <tt>[big|little</tt><tt>|native]</tt><tt><br> + export envi <header> [<filename>]</tt> + <tt>[big|little</tt><tt>|native]</tt> <tt><br> + export jpeg <filename></tt> <tt>[1-100]</tt><tt><br> + </tt> + <tt>export tiff <filename</tt><tt>></tt> + <tt>[none|jpeg|packbits|deflate]</tt><br> + <tt> <br> + Example:<br> + </tt> <tt><tt>$xpaset -p ds9 export array foo.arr + little</tt></tt><br> + <tt><tt>$xpaset -p ds9 export nrrd foo.nrrd little</tt></tt><br> + <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi foo.hdr + little</tt></tt><br> + </tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi + foo.hdr foo.bsq little</tt></tt><br> + </tt></tt></tt></tt> $xpaset -p + ds9 export tiff foo.tiff jpeg</tt></tt></tt><br> + $xpaset -p ds9 export jpeg foo.jpeg 75<br> + $xpaset -p ds9 export png foo.png</tt><br> + <p><b><a name="file" id="file"></a>file</b></p> + <p>Query currently loaded file information.</p> + <tt>Syntax:<br> + file<br> + <br> + Example:<br> + $xpaget ds9 file</tt><br> + <p><b><a name="fits" id="fits"></a>fits</b></p> + <p>Load a FITS image into the current frame or query the currently + loaded image.<br> + </p> + <tt>Syntax:<br> + fits</tt> <tt><tt>[new|mask|slice] + [<filename>]</tt><tt><br> + </tt> + [width|height|depth|bitpix]<br> + [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword + <string>]]<br> + [image|table|slice]</tt><tt><br> + <br> + Example:<br> + $xpaget ds9 fits > foo.fits<br> + $xpaget ds9 fits width<br> + $xpaget ds9 fits height<br> + $xpaget ds9 fits depth<br> + $xpaget ds9 fits bitpix</tt><br> + <tt><tt>$xpaget ds9 fits size<br> + </tt> $xpaget ds9 fits size wcs + fk5 arcmin<br> + $xpaget ds9 fits header # primary<br> + $xpaget ds9 fits header 2 # hdu 2<br> + $xpaget ds9 fits header -2 # hdu 2 with inherit<br> + $xpaget ds9 fits header keyword BITPIX<br> + $xpaget ds9 fits header 1 keyword BITPIX</tt><br> + <tt><tt>$xpaget ds9 fits image > foo.fits<br> + $xpaget ds9 fits table > bar.fits<br> + $xpaget ds9 fits slice > foo.fits<br> + </tt> $xpaset -p ds9 fits + foo.fits<br> + $xpaset -p ds9 fits new foo.fits<br> + $xpaset -p ds9 fits bar.fits[bin=detx,dety]<br> + $xpaset -p ds9 fits slice foo.fits<br> + $xpaset -p ds9 fits mask foo.fits<br> + $cat foo.fits | xpaset ds9 fits<br> + $cat foo.fits | xpaset ds9 fits new<br> + $cat bar.fits | xpaset ds9 fits -[bin=detx,dety]<br> + $cat foo.fits | xpaset ds9 fits slice<br> + $cat foo.fits | xpaset ds9 fits mask<br> + </tt> + <p><b><a name="frame" id="frame"></a>frame</b></p> + <p>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.</p> + <tt>Syntax:<br> + frame [center [#|all]]<br> + [clear [#|all]]<br> + [new [rgb|3d]]<br> + [delete [#|all]]<br> + [reset [#|all]]<br> + [refresh [#|all]]<br> + [hide [#|all]]<br> + [show [#|all]]<br> + [move first]<br> + [move back]<br> + [move forward]<br> + [move last]<br> + [first]<br> + [prev]<br> + [next]<br> + [last]<br> + [frameno #]<br> + [#]<br> + </tt> + <tt> [match <coordsys>]<br> + [lock + <coordsys>|none]</tt><br> + <tt> [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]<br> - - [has contour [aux]]]<br> - [has fits [bin|cube|mosaic]]<br> - [has marker -[highlite|paste|select|undo]]<br> - [has system -<coordsys>]<br></tt> -<tt><tt><tt> [has wcs -[<wcssys>]]<br></tt> [has wcs -celestial [<wcssys>]]<br></tt> -[has wcs linear [<wcssys>]]<br> - <br> -Example:<br> -$xpaget ds9 frame # returns the id of the current frame<br> -$xpaget ds9 frame frameno # returns the id of the current frame<br> -$xpaget ds9 frame all # returns the id of all frames<br> -$xpaget ds9 frame active # returns the id of all active -frames<br></tt> <tt>$xpaget ds9 frame lock</tt><br> -<tt>$xpaget ds9 frame has amplifier<br> -$xpaget ds9 frame has datamin<br> -$xpaget ds9 frame has datasec<br> -$xpaget ds9 frame has detector<br> -$xpaget ds9 frame has grid<br> -$xpaget ds9 frame has iis<br> -$xpaget ds9 frame has irafmin<br> -$xpaget ds9 frame has physical<br> -$xpaget ds9 frame has smooth<br> -$xpaget ds9 frame has contour<br> -$xpaget ds9 frame has contour aux<br> -$xpaget ds9 frame has fits<br> -$xpaget ds9 frame has fits bin<br> -$xpaget ds9 frame has fits cube<br> -$xpaget ds9 frame has fits mosaic<br> -$xpaget ds9 frame has marker highlite<br> -$xpaget ds9 frame has marker paste<br> -$xpaget ds9 frame has marker select<br> -$xpaget ds9 frame has marker undo<br> -$xpaget ds9 frame has system physical<br> -$xpaget ds9 frame has wcs wcsa<br> -$xpaget ds9 frame has wcs celestial wcsa<br> -$xpaget ds9 frame has wcs linear wcsa<br> -$xpaset -p ds9 frame center # center current frame<br> -$xpaset -p ds9 frame center 1 # center 'Frame1'<br> -$xpaset -p ds9 frame center all # center all frames<br> -$xpaset -p ds9 frame clear # clear current frame<br> -$xpaset -p ds9 frame new # create new frame<br> -$xpaset -p ds9 frame new rgb # create new rgb frame<br> -$xpaset -p ds9 frame delete # delete current frame<br> -$xpaset -p ds9 frame reset # reset current frame<br> -$xpaset -p ds9 frame refresh # refresh current frame<br> -$xpaset -p ds9 frame hide # hide current frame<br> -$xpaset -p ds9 frame show 1 # show frame 'Frame1'<br> -$xpaset -p ds9 frame move first # move frame to first in order<br> -$xpaset -p ds9 frame move back # move frame back in order<br> -$xpaset -p ds9 frame move forward # move frame forward in order<br> -$xpaset -p ds9 frame move last # move frame to last in order<br> -$xpaset -p ds9 frame first # goto first frame<br> -$xpaset -p ds9 frame prev # goto prev frame<br> -$xpaset -p ds9 frame next # goto next frame<br> -$xpaset -p ds9 frame last # goto last frame<br> -$xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if -needed<br> -$xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed<br> -$xpaset -p ds9 frame match wcs<br> -$xpaset -p ds9 frame lock wcs</tt><br> -<p><b><a name="gif" id="gif"></a>gif</b></p> -<p>Load GIF image into current frame.<br></p> -<tt>Syntax:<br> -gif [new|slice] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 gif > foo.gif</tt><br> -<tt>$xpaset -p ds9 gif foo.gif</tt><br> -<tt><tt>$xpaset -p ds9 gif new foo.gif<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9 gif slice foo.gif<br></tt></tt> $cat -foo.gif | xpaset ds9 gif # not available windows</tt><br> -<tt><tt>$cat foo.gif | xpaset ds9 gif</tt> <tt>new # not available -windows<br></tt> $cat foo.gif | xpaset ds9 gif</tt> <tt>slice</tt> -<tt><tt><tt># not available windows</tt></tt></tt> -<p><b><a name="grid" id="grid"></a>grid</b></p> -<p>Controls coordinate grid. For grid numeric format syntax, -click <a href="grid.html#Format">here</a>.</p> -<tt>Syntax:<br> -grid []<br> - [yes|no]<br> - [type analysis|publication]<br> - [system <coordsys>]<br> - [sky <skyframe>]<br> - [skyformat <skyformat>]<br> - [grid yes|no]<br> - [grid color <color>]<br> - [grid width <value>]<br> - [grid dash yes|no]<br> - [grid gap1 <value>]<br></tt> -<tt><tt> [grid gap2 -<value>]<br></tt></tt> -<tt><tt><tt> [grid gap3 -<value>]<br></tt></tt> [axes -yes|no]<br> - [axes color <color>]<br> - [axes width <value>]<br> - [axes dash yes|no]<br> - [axes type interior|exterior]<br> - [axes origin -lll|llu|lul|luu|ull|ulu|uul|uuu]<br> - [format1 <format>]<br> - [format2 <format>]<br> - [tickmarks yes|no]<br> - [tickmarks color <color>]<br> - [tickmarks width <value>]<br> - [tickmarks dash yes|no]<br> - [border yes|no]<br> - [border color <color>]<br> - [border width <value>]<br> - [border dash yes|no]<br> - [numerics yes|no]<br> - [numerics font -times|helvetica|courier]<br> - [numerics fontsize -<value>]<br> - [numerics fontweight -normal|bold]<br> - [numerics fontslant -roman|italic]<br> - [numerics color <color>]<br> - [numerics gap1 -<value>]<br></tt> <tt><tt> -[numerics gap2 <value>]<br></tt></tt> -<tt><tt><tt> [numerics gap3 -<value>]<br></tt></tt> -[numerics type interior|exterior]<br> - [numerics vertical yes|no]<br> - [title yes|no]<br> - [title text <text>]<br> - [title def yes|no]<br> - [title gap <value>]<br> - [title font -times|helvetica|courier]<br> - [title fontsize <value>]<br> - [title fontweight normal|bold]<br> - [title fontslant roman|italic]<br> - [title color <color>]<br> - [labels yes|no]<br></tt> -<tt><tt> [labels def1 yes|no]<br> - [labels def2 yes|no]<br></tt> - [labels text1 <text>]<br></tt> -<tt><tt> [labels text2 -<text>]<br></tt></tt> <tt><tt> -[labels gap1 <value>]<br></tt> -[labels gap2 <value>]<br></tt> -<tt> [labels font -times|helvetica|courier]<br> - [labels fontsize <value>]<br> - [labels fontweight normal|bold]<br> - [labels fontslant roman|italic]<br> - [labels color <color>]<br> - [reset]<br> - [load <filename>]<br> - [save <filename>]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 grid<br> -$xpaget ds9 grid type<br> -$xpaget ds9 grid system<br> -$xpaget ds9 grid sky<br> -$xpaget ds9 grid skyformat<br> -$xpaget ds9 grid grid<br> -$xpaget ds9 grid grid color<br> -$xpaget ds9 grid grid width<br> -$xpaget ds9 grid grid dash<br> -$xpaget ds9 grid grid gap1<br></tt> <tt><tt>$xpaget ds9 grid grid -gap2<br></tt></tt> <tt><tt><tt>$xpaget ds9 grid grid -gap3<br></tt></tt> $xpaget ds9 grid axes<br> -$xpaget ds9 grid axes color<br> -$xpaget ds9 grid axes width<br> -$xpaget ds9 grid axes dash<br> -$xpaget ds9 grid axes type<br> -$xpaget ds9 grid axes origin<br> -$xpaget ds9 grid format1<br> -$xpaget ds9 grid format2<br> -$xpaget ds9 grid tickmarks<br> -$xpaget ds9 grid tickmarks color<br> -$xpaget ds9 grid tickmarks width<br> -$xpaget ds9 grid tickmarks dash<br> -$xpaget ds9 grid border<br> -$xpaget ds9 grid border color<br> -$xpaget ds9 grid border width<br> -$xpaget ds9 grid border dash<br> -$xpaget ds9 grid numerics<br> -$xpaget ds9 grid numerics font<br> -$xpaget ds9 grid numerics fontsize<br> -$xpaget ds9 grid numerics fontweight<br> -$xpaget ds9 grid numerics fontslant<br> -$xpaget ds9 grid numerics color<br> -$xpaget ds9 grid numerics gap1<br></tt> <tt><tt>$xpaget ds9 grid -numerics gap2<br></tt></tt> <tt><tt><tt>$xpaget ds9 grid numerics -gap3<br></tt></tt> $xpaget ds9 grid numerics type<br> -$xpaget ds9 grid numerics vertical<br> -$xpaget ds9 grid title<br> -$xpaget ds9 grid title text<br> -$xpaget ds9 grid title def<br> -$xpaget ds9 grid title gap<br> -$xpaget ds9 grid title font<br> -$xpaget ds9 grid title fontsize<br> -$xpaget ds9 grid title fontweight<br> -$xpaget ds9 grid title fontslant<br> -$xpaget ds9 grid title color<br> -$xpaget ds9 grid labels<br> -$xpaget ds9 grid labels text1<br> -$xpaget ds9 grid labels def1<br> -$xpaget ds9 grid labels gap1<br> -$xpaget ds9 grid labels text2<br> -$xpaget ds9 grid labels def2<br> -$xpaget ds9 grid labels gap2<br> -$xpaget ds9 grid labels font<br> -$xpaget ds9 grid labels fontsize<br> -$xpaget ds9 grid labels fontweight<br> -$xpaget ds9 grid labels fontslant<br> -$xpaget ds9 grid labels color<br> -$xpaset -p ds9 grid<br> -$xpaset -p ds9 grid yes<br> -$xpaset -p ds9 grid type analysis<br> -$xpaset -p ds9 grid system wcs<br> -$xpaset -p ds9 grid sky fk5<br> -$xpaset -p ds9 grid skyformat degrees<br> -$xpaset -p ds9 grid grid yes<br> -$xpaset -p ds9 grid grid color red<br> -$xpaset -p ds9 grid grid width 2<br> -$xpaset -p ds9 grid grid dash yes<br> -$xpaset -p ds9 grid grid gap1 10<br> -$xpaset -p ds9 grid grid gap2 10<br></tt> <tt><tt>$xpaset -p ds9 -grid grid gap3 10<br></tt> $xpaset -p ds9 grid axes yes<br> -$xpaset -p ds9 grid axes color red<br> -$xpaset -p ds9 grid axes width 2<br> -$xpaset -p ds9 grid axes dash yes<br> -$xpaset -p ds9 grid axes type exterior<br> -$xpaset -p ds9 grid axes origin lll<br> -$xpaset -p ds9 grid format1 d.2<br> -$xpaset -p ds9 grid format2 d.2<br> -$xpaset -p ds9 grid tickmarks yes<br> -$xpaset -p ds9 grid tickmarks color red<br> -$xpaset -p ds9 grid tickmarks width 2<br> -$xpaset -p ds9 grid tickmarks dash yes<br> -$xpaset -p ds9 grid border yes<br> -$xpaset -p ds9 grid border color red<br> -$xpaset -p ds9 grid border width 2<br> -$xpaset -p ds9 grid border dash yes<br> -$xpaset -p ds9 grid numerics yes<br> -$xpaset -p ds9 grid numerics font courier<br> -$xpaset -p ds9 grid numerics fontsize 12<br> -$xpaset -p ds9 grid numerics fontweight bold<br> -$xpaset -p ds9 grid numerics fontslant italic<br> -$xpaset -p ds9 grid numerics color red<br> -$xpaset -p ds9 grid numerics gap1 10<br></tt> <tt><tt>$xpaset -p -ds9 grid numerics gap2 10<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 -grid numerics gap3 10<br></tt></tt> $xpaset -p ds9 grid numerics -type exterior<br> -$xpaset -p ds9 grid numerics vertical yes<br> -$xpaset -p ds9 grid title yes<br> -$xpaset -p ds9 grid title text {Hello World}<br> -$xpaset -p ds9 grid title def yes<br> -$xpaset -p ds9 grid title gap 10<br> -$xpaset -p ds9 grid title font courier<br> -$xpaset -p ds9 grid title fontsize 12<br> -$xpaset -p ds9 grid title fontweight bold<br> -$xpaset -p ds9 grid title fontslant italic<br> -$xpaset -p ds9 grid title color red<br> -$xpaset -p ds9 grid labels yes<br> -$xpaset -p ds9 grid labels text1 {Hello World}<br> -$xpaset -p ds9 grid labels def1 yes<br> -$xpaset -p ds9 grid labels gap1 10<br> -$xpaset -p ds9 grid labels text2 {Hello World}<br> -$xpaset -p ds9 grid labels def2 yes<br> -$xpaset -p ds9 grid labels gap2 10<br> -$xpaset -p ds9 grid labels font courier<br> -$xpaset -p ds9 grid labels fontsize 12<br> -$xpaset -p ds9 grid labels fontweight boldj<br> -$xpaset -p ds9 grid labels fontslant italic<br> -$xpaset -p ds9 grid labels color red<br> -$xpaset -p ds9 grid reset<br> -$xpaset -p ds9 grid load foo.grd<br> -$xpaset -p ds9 grid save foo.grd<br> -$xpaset -p ds9 grid open<br> -$xpaset -p ds9 grid close<br></tt> -<p><b><a name="header" id="header"></a>header</b></p> -<p>Display current fits header dialog. Optional extension number -maybe specified. Please note, this differs from xpa fits -header.</p> -<tt>Syntax:<br> -header [<ext>]<br> - [close [<ext>]]<br> - [save [<ext>] -<filename>]<br> - <br> -Example:<br> -$xpaset -p ds9 header<br> -$xpaset -p ds9 header 2<br> -$xpaset -p ds9 header close<br> -$xpaset -p ds9 header save 1 foo.txt<br></tt> -<p><b><a name="height" id="height"></a>height</b></p> -<p>Set the height of the image display window.</p> -<tt>Syntax:<br> -height [<value>]<br> - <br> -Example:<br> -$xpaget ds9 height<br> -$xpaset -p ds9 height 512<br></tt> -<p><b><a name="iconify" id="iconify"></a>iconify</b></p> -<p>Toggles iconification.</p> -<tt>Syntax:<br> -iconify []<br> - [yes|no]<br> - <br> -Example:<br> -$xpaget ds9 iconify<br> -$xpaset -p ds9 iconify</tt><br> -<tt>$xpaset -p ds9 iconify yes</tt><br> -<p><b><a name="iexam" id="iexam"></a>iexam</b></p> -<p>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 -<tt>button</tt>. In the last form, the following macros will be -expanded if present: <tt>$width, $height, $depth, $bitpix, -$filename, $regions, $filename[$regions], $env, $pan, $value, $x, -$y, $z.</tt> See <a href="analysis.html#macros">Analysis Macros</a> -for more information.<br></p> -<tt>Syntax:<br> -iexam []<br> - [[]|button|key|any] coordinate -<coordsys> [<skyframe>] [<skyformat>]<br> - [[]|button|key|any] data -[width][height]<br></tt> <tt><tt> -[[]|button|key|any] <macro string>]<br> - </tt><br> -Example:<br> -$xpaget ds9 iexam # image coordinates<br></tt> <tt><tt>$xpaget ds9 -iexam coordinate image<br></tt> $xpaget ds9 iexam key coordinate -image # return coordinate and key event<br> -$xpaget ds9 iexam coordinate wcs fk5 degrees<br> -$xpaget ds9 iexam coordinate wcs galactic sexagesimal<br> -$xpaget ds9 iexam coordinate fk5<br> -$xpaget ds9 iexam data # return data value<br> -$xpaget ds9 iexam key data # return data value and key event<br> -$xpaget ds9 iexam data 3 3 # return all data in 3x3 box about -selected point<br> -$xpaget ds9 iexam {'Click at $x,$y in file $filename'}</tt><br> -<p><b><a name="iis" id="iis"></a>iis</b></p> -<p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> -<tt>Syntax:<br> -iis [filename <filename> [#]]<br> - <br> -Example:<br> -$xpaget ds9 iis filename<br> -$xpaget ds9 iis filename 4<br> -$xpaset -p ds9 iis filename foo.fits<br> -$xpaset -p ds9 iis filename bar.fits 4</tt><br> -<p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> -<p>Load JPEG image into current frame. Optional parameters: -<tt>jpeg</tt> quality (1-100)</p> -<tt>Syntax:<br> -jpeg [new|slice] [<filename>] [1-100]<br> - <br> -Example:<br> -$xpaget ds9 jpeg > foo.jpeg</tt><br> -<tt><tt>$xpaget ds9 jpeg 100 > foo.jpeg</tt><br> -$xpaset -p ds9 jpeg foo.jpeg</tt><br> -<tt><tt>$xpaset -p ds9 jpeg new foo.jpeg<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9 jpeg slice foo.jpeg<br></tt></tt> $cat -foo.jpeg | xpaset ds9 jpeg</tt> <tt><tt><tt># not available -windows</tt></tt></tt><br> -<tt><tt>$cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>new</tt></tt> -<tt><tt><tt><tt># not available windows</tt></tt><br></tt> $cat -foo.jpeg | xpaset ds9 jpeg</tt> <tt>slice</tt> <tt><tt><tt># not -available windows</tt></tt></tt> -<p><b><a name="lock" id="lock"></a>lock</b></p> -<p>Lock all other frames to the current frame.</p> -<tt>Syntax:<br> -lock</tt> <tt>[frame <coordsys>|none]<br> - </tt> <tt>[crosshair -<coordsys>|none]</tt> <tt><br></tt> -<tt> [crop <coordsys>|none]</tt><br> -<tt> [slice -<coordsys>|none]]<br></tt> <tt> [bin -[yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimites [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br></tt> -<tt> [smooth [yes|no]]</tt><br> -<tt> [3d [yes|no]]</tt><br> -<tt><tt> </tt><br> -Example:<br> -$xpaget -p ds9 lock frame<br> -$xpaget -p ds9 lock crosshair<br></tt> <tt>$xpaget -p ds9 lock -crop</tt><br> -<tt>$xpaget -p ds9 lock slice</tt><br> -<tt>$xpaget -p ds9 lock bin<br> -$xpaget -p ds9 lock axes<br> -$xpaget -p ds9 lock scale<br> -$xpaget -p ds9 lock scalelimits<br> -$xpaget -p ds9 lock colorbar<br> -$xpaget -p ds9 lock block<br></tt> <tt><tt>$xpaget -p ds9 lock -smooth<br></tt></tt> <tt><tt><tt>$xpaget -p ds9 lock -3d<br></tt></tt> $xpaset -p ds9 lock frame wcs</tt><tt><br></tt> -<tt>$xpaset -p ds9 lock crosshair wcs<br></tt> <tt>$xpaset -p ds9 -lock crop wcs</tt><br> -<tt>$xpaset -p ds9 lock slice wcs</tt><br> -<tt>$xpaset -p ds9 lock bin yes<br> -$xpaset -p ds9 lock axes yes<br></tt> <tt>$xpaset -p ds9 lock scale -yes<br> -$xpaset -p ds9 lock scalelimits yes<br></tt> <tt>$xpaset -p ds9 -lock colorbar yes<br> -$xpaset -p ds9 lock block yes</tt><br> -<tt>$xpaset -p ds9 lock smooth yes</tt><br> -<tt>$xpaset -p ds9 lock 3d yes<br> -<br></tt> <b><a name="lower" id="lower"></a>lower</b> -<p>Lower in the window stacking order.</p> -<tt>Syntax:<br> -lower<br> - <br> -Example:<br> -$xpaset -p ds9 lower</tt><tt><br></tt> -<p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> -<p>Controls the magnifier settings.</p> -<tt>Syntax:<br> -magnifier [color <color>]<br> - [zoom -<value>]<br> - [cursor -yes|no]<br> - [region -yes|no]<br> - <br> -Example:<br> -$xpaget ds9 magnifier color<br> -$xpaget ds9 magnifier zoom<br> -$xpaget ds9 magnifier cursor<br> -$xpaget ds9 magnifier region<br> -$xpaset -p ds9 magnifier color yellow<br> -$xpaset -p ds9 magnifier zoom 2<br> -$xpaset -p ds9 magnifier cursor no<br> -$xpaset -p ds9 magnifier region no</tt><br> -<p><b><a name="mask" id="mask"></a>mask<br></b></p> -<p>Controls mask parameters.</p> -<tt>Syntax:<br> -mask [color <color>]<br> - [mark 1|0]<br> - [transparency <value>]<br> - [clear]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 mask color<br> -$xpaget ds9 mask mark<br> -$xpaget ds9 mask transparency<br> -$xpaset -p ds9 mask color red<br> -$xpaset -p ds9 mask mark 0<br> -$xpaset -p ds9 mask transparency 50<br> -$xpaset -p ds9 mask clear<br> -$xpaset -p ds9 mask open<br> -$xpaset -p ds9 mask close<br></tt> -<p><b><a name="match" id="match"></a>match</b></p> -<p>Match all other frames to the current frame.</p> -<tt>Syntax:<br></tt> <tt>match</tt> <tt>[frame -<coordsys>]<br> - </tt> <tt>[crosshair -<coordsys>]</tt> <tt><br></tt> -<tt> [crop <coordsys>]</tt><br> -<tt> [slice -<coordsys>]</tt><br> -<tt> [bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]<br> - [3d]<br></tt> <tt><tt><br></tt> -Example:<br> -$xpaset -p ds9 match frame wcs<br></tt> <tt>$xpaset -p ds9 match -crosshair wcs<br></tt> <tt>$xpaset -p ds9 match crop wcs</tt><br> -<tt>$xpaset -p ds9 match slice</tt> <tt>wcs<br></tt> <tt>$xpaset -p -ds9 match bin<br> -$xpaset -p ds9 match axes<br> -$xpaset -p ds9 match scale<br> -$xpaset -p ds9 match scalelimits<br> -$xpaset -p ds9 match colorbar<br> -$xpaset -p ds9 match block<br> -$xpaset -p ds9 match smooth<br> -$xpaset -p ds9 match 3d<br> -<br></tt> <b><a name="mecube" id="mecube"></a>mecube</b> -<p>Load FITS multiple extension file as data cube.<br></p> -<tt>Syntax:<br> -mecube [new] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 mecube > foo.fits<br> -$xpaset -p ds9 mecube foo.fits</tt><br> -<tt><tt>$xpaset -p ds9 mecube new foo.fits<br></tt> $cat foo.fits | -xpaset ds9 mecube</tt><br> -<tt>$cat foo.fits | xpaset ds9 mecube</tt> <tt>new</tt> -<p><b><a name="minmax" id="minmax"></a>minmax</b></p> -<p>This is how DS9 determines the min and max data values -from the data. <tt>SCAN</tt> will scan all -data. <tt>DATAMIN</tt> and <tt>IRAFMIN</tt> will use the -values of the keywords if present.<br></p> -<tt>Syntax:<br> -minmax [scan|sample|datamin|irafmin]<br> - [mode -scan|sample|datamin|irafmin]<br> - [interval #]<br> - <br> -Example:<br> -$xpaget ds9 minmax mode<br> -$xpaget ds9 minmax interval<br> -$xpaset -p ds9 minmax scan<br> -$xpaset -p ds9 minmax mode scan<br> -$xpaset -p ds9 minmax interval 100<br></tt> -<p><b><a name="mode" id="mode"></a>mode</b></p> -<p>Controls the first mouse button mode.</p> -<tt>Syntax:<br> -mode -[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> - - <br> -Example:<br> -$xpaget ds9 mode<br> -$xpaset -p ds9 mode crosshair</tt><br> -<p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> -<p>Load FITS mosaic segment into current frame.</p> -<tt>Syntax:<br> -mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 mosaic > foo.fits</tt><tt><br> -$xpaset -p ds9 mosaic foo.fits</tt><br> -<tt><tt>$xpaset -p ds9 mosaic wcs foo.fits</tt></tt><br> -<tt><tt>$xpaset -p ds9 mosaic wcs new foo.fits</tt></tt><br> -<tt><tt>$xpaset -p ds9 mosaic wcs mask -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> $cat foo.fits | xpaset -ds9 mosaic</tt><br> -<tt><tt>$cat foo.fits | xpaset ds9 mosaic wcs<br> -$cat foo.fits | xpaset ds9 mosaic wcs</tt> <tt>new<br></tt> $cat -foo.fits | xpaset ds9 mosaic wcs</tt> <tt>mask<br></tt> -<p><b><a name="mosaicimage" id= -"mosaicimage"></a>mosaicimage</b></p> -<p>Load FITS mosaic image into current frame.</p> -<tt>Syntax:<br> -mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] -[<filename>]<br> - <br> -Example:<br> -$xpaget ds9 mosaicimage > foo.fits</tt><tt><br> -$xpaset -p ds9 mosaicimage foo.fits</tt><br> -<tt><tt>$xpaset -p ds9 mosaicimage wcs foo.fits</tt></tt><br> -<tt><tt>$xpaset -p ds9 mosaicimage wcs new foo.fits</tt></tt><br> -<tt><tt>$xpaset -p ds9 mosaicimage wcs mask -foo.fits</tt></tt><tt><tt><tt><br></tt></tt> $cat foo.fits | xpaset -ds9 mosaicimage</tt><br> -<tt><tt>$cat foo.fits | xpaset ds9 mosaicimage wcs<br> -$cat foo.fits | xpaset ds9 mosaicimage wcs new</tt><tt><br></tt> -$cat foo.fits | xpaset ds9 mosaicimage wcs mask</tt><br> -<p><b><a name="movie" id="movie"></a>movie<br> -savempeg<br></b></p> -<p>Create mpeg1 movie from snap shots of the DS9 window. A -<tt>slice</tt> movie cycles though all slices of a cube. A -<tt>frame</tt> movie cycles through all active frames. A -<tt>3d</tt> movie cycles through specified viewing angles. The -default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: -number of frames, azimuth from/to, elevation from/to, slice -from/to, oscillate/repeat times.</p> -<tt>Syntax:<br> -movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br></tt> -<tt>movie 3d <filename> -[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat -<#>]</tt><br> -<tt> <br> -Example:<br> -$xpaset -p ds9 movie slice ds9.mpg<br></tt> <tt>$xpaset -p ds9 -movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> -<p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> -<p>Load FITS multiple extension file as multiple images.<br></p> -<tt>Syntax:<br> -multiframe [<filename>]<br> - <br> -Example:<br> -$xpaset -p ds9 multiframe foo.fits</tt><tt><tt><br></tt> $cat -foo.fits | xpaset ds9 multiframe</tt> <tt><tt><tt># not available -windows</tt></tt></tt><br> -<p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> -<p>Support Name Server functions. Coordinates are in fk5.</p> -<tt>Syntax:<br> -nameserver [<object>]<br> - [name -<object>]<br> - -[server</tt> -<tt><tt>ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt></tt>]<br> - - -[skyformat degrees|sexagesimal]<br> - -[pan]<br> - -[crosshair]<br> - -[open|close]<br> -<br> -Example:<br> -$xpaget ds9 nameserver<br> -$xpaget ds9 nameserver server<br> -$xpaget ds9 nameserver skyformat<br> -$xpaget ds9 nameserver m31<br> -$xpaset -p ds9 nameserver m31<br> -$xpaset -p ds9 nameserver name m31<br> -$xpaset -p ds9 nameserver server ned-sao<br> -$xpaset -p ds9 nameserver skyformat sexagesimal<br> -$xpaset -p ds9 nameserver pan<br> -$xpaset -p ds9 nameserver crosshair<br> -$xpaset -p ds9 nameserver open<br> -$xpaset -p ds9 nameserver close<br></tt> -<p><b><a name="nan" id="nan"></a>nan</b></p> -<p>Set image not-a-number color.</p> -<tt>Syntax:<br> -nan <color><br> - <br> -Example:<br> -$xpaget ds9 nan<br> -$xpaset -p ds9 nan red</tt><tt><br></tt> -<p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> -<p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: -array endian.<br></p> -<tt>Syntax:<br> -nrrd [native|little|big]<br> -nrrd [new|mask] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 nrrd</tt><br> -<tt><tt>$xpaget ds9 nrrd big<br> -$xpaset -p ds9 nrrd foo.nrrd</tt></tt><br> -<tt><tt><tt><tt>$xpaset -p ds9 nrrd new -foo.nrrd</tt></tt></tt></tt><br> -<tt><tt><tt><tt><tt><tt>$xpaset -p ds9 nrrd mask -foo.nrrd<br></tt></tt></tt></tt></tt> $cat foo.nrrd | xpaset ds9 -nrrd</tt><br> -<tt>$cat foo.nrrd | xpaset ds9 nrrd</tt> <tt>new<br> -$cat foo.nrrd | xpaset ds9 nrrd mask</tt> -<p><b><a name="nvss" id="nvss"></a>nvss</b></p> -<p>Support for NRAO VLA Sky Survey.</p> -<tt>Syntax:<br> -nvss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 nvss name<br> -$xpaget ds9 nvss coord<br> -$xpaget ds9 nvss size<br> -$xpaget ds9 nvss save<br> -$xpaget ds9 nvss frame<br> -$xpaset -p ds9 nvss<br> -$xpaset -p ds9 nvss m31<br></tt> <tt><tt>$xpaset -p ds9 nvss name -m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 nvss name -clear<br></tt></tt> $xpaset -p ds9 nvss 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 nvss size 60 60 arcmin<br> -$xpaset -p ds9 nvss save yes<br> -$xpaset -p ds9 nvss frame current<br> -$xpaset -p ds9 nvss update frame<br> -$xpaset -p ds9 nvss open<br></tt> <tt>$xpaset -p ds9 nvss -close</tt><br> -<p><b><a name="orient" id="orient"></a>orient</b></p> -<p>Controls the orientation of the current frame.</p> -<tt>Syntax:<br> -orient [none|x|y|xy]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 orient<br> -$xpaset -p ds9 orient xy<br> -$xpaset -p ds9 orient open<br> -$xpaset -p ds9 orient close<br></tt> -<p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> -<p>Controls Page Setup options.<br></p> -<tt>Syntax:<br> -pagesetup [orient portrait|landscape]<br> - [scale -<numberic>]</tt><br> -<tt> [size -letter|legal|tabloid|poster|a4]</tt><br> -<tt> <br> -Example:<br> -$xpaget ds9 pagesetup orient<br> -$xpaget ds9 pagesetup scale<br> -$xpaget ds9 pagesetup size<br> -$xpaset -p ds9 pagesetup orient portrait<br> -$xpaset -p ds9 pagesetup scale 50<br> -$xpaset -p ds9 pagesetup size poster<br></tt> -<p><b><a name="pan" id="pan"></a>pan</b></p> -<p>Controls the current image cursor location for the current -frame.</p> -<tt>Syntax:<br> -pan [<x> <y> <coordsys> -[<skyframe>][<skyformat>]] # relative<br> - [to <x> <y> <coordsys> -[<skyframe>][<skyformat>] # absolute<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 pan # get current image coords<br> -$xpaget ds9 pan wcs fk4 sexagesimal # get current wcs coords<br> -$xpaset -p ds9 pan 200 200 image # pan relative<br> -$xpaset -p ds9 pan to 400 400 physical # pan to physical coords<br> -$xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs -coords<br> -$xpaset -p ds9 pan open<br> -$xpaset -p ds9 pan close<br></tt> -<p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> -<p>Display/Hide the pixel table.</p> -<tt>Syntax:<br> -pixeltable []<br> - [yes|open]<br> - -[no|close]<br> - <br> -Example:<br> -$xpaget ds9 pixeltable<br> -$xpaset -p ds9 pixeltable<br> -$xpaset -p ds9 pixeltable yes<br> -$xpaset -p ds9 pixeltable open<br> -$xpaset -p ds9 pixeltable close</tt><br> -<p><b><a name="plot" id="plot"></a>plot</b></p> -<p>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:</p> -<blockquote>xy x and y coordinates<br> -xyex x,y coordinates with x errors<br> -xyey x,y coordinates with y errors<br> -xyexey x,y coordinates with x and y -errors<br></blockquote> -<p>To create a new plot, use the plot new command.</p> -<tt>Syntax:</tt><tt><br></tt> <tt># create new empty plot -window</tt><tt><br></tt> <tt>plot []</tt><tt><br></tt> -<tt> [line|bar|scatter]</tt><tt><br></tt> -<tt> [new]</tt><tt><br></tt> -<tt> [new -line|bar|scatter]</tt><tt><br></tt> <tt> -[new name <plotname>]</tt><tt><br></tt> -<tt> [new name <plotname> -line|bar|scatter]</tt><tt><br></tt> <tt><br></tt> <tt># create new -plot with data from stdin</tt><tt><br></tt> <tt>plot</tt> <tt>[new -<title> <xaxis label> <yaxis label></tt> -<tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br></tt> -<tt> </tt> <tt>[new [line|bar|scatter] -<title> <xaxis label> <yaxis label></tt> -<tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br></tt> -<tt> </tt> <tt>[new</tt> <tt>name -<plotname></tt> <tt><title> <xaxis label> -<yaxis label></tt> -<tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br></tt> -<tt> </tt> <tt>[new</tt> <tt>name -<plotname></tt> <tt>line|bar|scatter <title> <xaxis -label> <yaxis label></tt> -<tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br></tt> <tt><br></tt> -<tt># create new plot with data from stdin which includes title/dim -headers</tt><tt><br></tt> <tt>plot [new -stdin</tt><tt>]</tt><tt><br></tt> <tt> </tt> -<tt>[new</tt> <tt>[line|bar|scatter]</tt> -<tt>stdin</tt><tt>]</tt><tt><br></tt> -<tt> </tt> <tt>[new name <plotname> -stdin</tt><tt>]</tt><tt><br></tt> <tt> </tt> -<tt>[new name <plotname></tt> <tt>line|bar|scatter</tt> -<tt>stdin</tt><tt>]</tt><tt><br></tt> <tt><br></tt> <tt>#</tt> -<tt>load data into existing plot from stdin</tt><tt><br></tt> -<tt>plot [[<plotname>] data -xy|xyex|xyey|xyexey]</tt><tt><br></tt> <tt><br></tt> <tt># existing -plot</tt><tt><br></tt> <tt>plot</tt> <tt>[[<plotname>] load -<filename> xy|xyex|xyey|xyexey]</tt><tt><br></tt> -<tt> [[<plotname>] save -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] clear]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] duplicate -[#]]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] stats yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] list -yes|no]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] loadconfig -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] saveconfig <filename>]</tt><tt><br></tt> -<tt> [[<plotname>] pagesetup orient -portrait|landscape]</tt><tt><br></tt> <tt> -[[<plotname>] pagesetup size -letter|legal|tabloid|poster|a4]</tt><tt><br></tt> -<tt> [[<plotname>] -print]</tt><tt><br></tt> <tt> -[[<plotname>] print destination -printer|file]</tt><tt><br></tt> <tt> -[[<plotname>] print command -<command>]</tt><tt><br></tt> <tt> -[[<plotname>] print filename -<filename>]</tt><tt><br></tt> <tt> -[[<plotname>] print color rgb|gray]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] -close</tt><tt>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] mode pointer|zoom]</tt><tt><br></tt> -<tt><br></tt> <tt># configure graph</tt><tt><br></tt> <tt>plot -[[<plotname>] axis x|y grid yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y log -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y flip yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y auto -yes|no]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y min <value>]</tt><tt><br></tt> -<tt> [[<plotname>] axis x|y max -<value>]</tt><tt><br></tt> <tt> -[[<plotname>] axis x|y format -<string>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] legend yes|no]</tt><tt><br></tt> -<tt> [[<plotname>] legend position -right|left|top|bottom]</tt><tt><br></tt> <tt> -[[<plotname>] font title|labels|numbers font -times|helvetica|courier]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>size <value>]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>weight normal|bold]</tt><tt><br></tt> <tt> -[[<plotname>] font</tt> <tt>title|labels|numbers</tt> -<tt>slant roman|italic]</tt><tt><br></tt> <tt> -[[<plotname>] title <string>]</tt><tt><br></tt> -<tt> [[<plotname>] title x|y -<string>]</tt><tt><br></tt> <tt> -[</tt><tt>[<plotname>] barmode -normal|stacked|aligned|overlap]</tt><tt><br></tt> <tt><br></tt> -<tt># configure current dataset</tt><tt><br></tt> <tt>plot -[[<plotname>] show yes|no]</tt><tt><br></tt> <tt> - </tt> <tt>[[<plotname>] shape -circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> -</tt> <tt> </tt> <tt>[[<plotname>] -shape fill yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] shape -color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] smooth -step|linear|cubic|quadratic|catrom]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] color -<value>]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] dash -yes|no]</tt><tt><br></tt> <tt> </tt> -<tt>[[<plotname>] error yes|no]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] error -color <value>]</tt><tt><br></tt> <tt> -[[<plotname>] color <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] error -width <value>]</tt><tt><br></tt> -<tt> </tt> <tt>[[<plotname>] name -<string>]</tt><tt><br></tt> <tt><br></tt> <tt># select -current dataset</tt><tt><br></tt> <tt>plot [[<plotname>] -select <value>]</tt><tt><br></tt> -<tt> </tt><tt><br></tt> <tt>Example:</tt><tt><br></tt> <tt># -return all plotnames</tt><tt><br></tt> <tt>$xpaget ds9 -plot</tt><tt><br></tt> <tt><br></tt> <tt># create new empty plot -window</tt><tt><br></tt> <tt>$xpaset -p ds9 plot</tt><tt><br></tt> -<tt>$xpaset -p ds9 plot bar</tt><tt><br></tt> <tt>$xpaset -p ds9 -plot new</tt><tt><br></tt> <tt>$xpaset -p ds9 plot new -bar</tt><tt><br></tt> <tt>$xpaset -p ds9 plot new name -foo</tt><tt><br></tt> <tt>$xpaset -p ds9 plot new name foo -bar</tt><tt><br></tt> <tt><br></tt> <tt># create new plot with data -from stdin</tt><tt><br></tt> <tt>$cat xy.dat | xpaset ds9 plot new -{The Title} {X Axis} {Y Axis} xy</tt><tt><br></tt> <tt>$cat xy.dat -| xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} -xy</tt><tt><br></tt> <tt>$cat xy.dat | xpaset ds9 plot new name foo -{The Title} {X Axis} {Y Axis} xy</tt><tt><br></tt> <tt>$cat xy.dat -| xpaset ds9 plot new name foo bar {The Title} {X Axis} {Y Axis} -xy</tt><tt><br></tt> <tt><br></tt> <tt># create new plot with data -from stdin which includes title/dim headers</tt><tt><br></tt> -<tt>$cat stdin.2.dat | xpaset ds9 plot new stdin</tt><tt><br></tt> -<tt>$cat stdin.2.dat | xpaset ds9 plot new line -stdin</tt><tt><br></tt> <tt>$cat stdin.2.dat | xpaset ds9 plot new -name foo stdin</tt><tt><br></tt> <tt>$cat stdin.2.dat | xpaset ds9 -plot new name foo line stdin</tt><tt><br></tt> <tt><br></tt> -<tt>#</tt> <tt>load data into existing plot from -stdin</tt><tt><br></tt> <tt>$cat xy.dat | xpaset ds9 plot data -xy</tt><tt><br></tt> <tt>$cat xy.dat | xpaset ds9 plot foo data -xy</tt><tt><br></tt> <tt><br></tt> <tt># existing -plot</tt><tt><br></tt> <tt>$xpaget ds9 plot stats</tt><tt><br></tt> -<tt>$xpaget ds9 plot list</tt><tt><br></tt> <tt>$xpaset -p ds9 plot -load xy.dat xy</tt><tt><br></tt> <tt>$xpaset -p ds9 plot save -foo.dat</tt><tt><br></tt> <tt>$xpaset -p ds9 plot -clear</tt><tt><br></tt> <tt>$xpaset -p ds9 plot duplicate -1</tt><tt><br></tt> <tt>$xpaset -p ds9 plot stats -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot list -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot loadconfig -foo.plt</tt><tt><br></tt> <tt>$xpaset -p ds9 plot saveconfig -foo.plt</tt><tt><br></tt> <tt>$xpaset -p ds9 plot pagesetup orient -portrait</tt><tt><br></tt> <tt>$xpaset -p ds9 plot pagesetup size -letter</tt><tt><br></tt> <tt>$xpaset -p ds9 plot -print</tt><tt><br></tt> <tt>$xpaset -p ds9 plot print destination -file</tt><tt><br></tt> <tt>$xpaset -p ds9 plot print command -lp</tt><tt><br></tt> <tt>$xpaset -p ds9 plot print filename -foo.ps</tt><tt><br></tt> <tt>$xpaset -p ds9 plot print color -rgb</tt><tt><br></tt> <tt>$xpaset -p ds9 plot -close</tt><tt><br></tt> <tt>$xpaget ds9 plot mode</tt><tt><br></tt> -<tt>$xpaset -p ds9 plot mode pointer</tt><tt><br></tt> <tt><br> -</tt> <tt># configure plot</tt><tt><br></tt> <tt>$xpaget ds9 plot -axis x grid</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -log</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -flip</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -auto</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -min</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -max</tt><tt><br></tt> <tt>$xpaget ds9 plot axis x -format</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x grid -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x log -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x flip -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x auto -no</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x min -1</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x max -100</tt><tt><br></tt> <tt>$xpaset -p ds9 plot axis x format -{%f}</tt><tt><br></tt> <tt><br></tt> <tt>$xpaget ds9 plot -legend</tt><tt><br></tt> <tt>$xpaget ds9 plot legend -position</tt><tt><br></tt> <tt>$xpaset -p ds9 plot legend -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot legend position -left</tt><tt><br></tt> <tt><br></tt> <tt>$xpaget ds9 plot font -numbers font</tt><tt><br></tt> <tt>$xpaget ds9 plot font numbers -size</tt><tt><br></tt> <tt>$xpaget ds9 plot font numbers -weight</tt><tt><br></tt> <tt>$xpaget ds9 plot font numbers -slant</tt><tt><br></tt> <tt>$xpaset -p ds9 plot font numbers font -times</tt><tt><br></tt> <tt>$xpaset -p ds9 plot font numbers size -12</tt><tt><br></tt> <tt>$xpaset -p ds9 plot font numbers weight -bold</tt><tt><br></tt> <tt>$xpaset -p ds9 plot font numbers slant -italic</tt><tt><br></tt> <tt><br></tt> <tt>$xpaget ds9 plot -title</tt><tt><br></tt> <tt>$xpaget ds9 plot title -xaxis</tt><tt><br></tt> <tt>$xpaget ds9 plot title -yaxis</tt><tt><br></tt> <tt>$xpaset -p ds9 plot title {This is a -Title}</tt><tt><br></tt> <tt>$xpaset -p ds9 plot title x {X -Axis}</tt><tt><br></tt> <tt>$xpaset -p ds9 plot title y {Y -Axis}</tt><tt><br></tt> <tt>$xpaset -p ds9 plot title legend {This -is the Legend}</tt><tt><br></tt> <tt><br></tt> <tt>$xpaget ds9 plot -barmode</tt><tt><br></tt> <tt>$xpaset -p ds9 plot barmode -aligned</tt><tt><br></tt> <tt><br></tt> <tt># configure current -dataset</tt><tt><br></tt> <tt>$xpaget ds9 plot -show</tt><tt><br></tt> <tt>$xpaget ds9 plot shape</tt><tt><br></tt> -<tt>$xpaget ds9 plot shape fill</tt><tt><br></tt> <tt>$xpaget ds9 -plot shape color</tt><tt><br></tt> <tt>$xpaget ds9 plot -smooth</tt><tt><br></tt> <tt>$xpaget ds9 plot -color</tt><tt><br></tt> <tt>$xpaget ds9 plot -width</tt><tt><br></tt> <tt>$xpaget ds9 plot dash</tt><tt><br></tt> -<tt>$xpaget ds9 plot error</tt><tt><br></tt> <tt>$xpaget ds9 plot -error color</tt><tt><br></tt> <tt>$xpaget ds9 plot error -width</tt><tt><br></tt> <tt>$xpaget ds9 plot name</tt><tt><br></tt> -<tt>$xpaset -p ds9 plot show yes</tt><tt><br></tt> <tt>$xpaset -p -ds9 plot shape circle</tt><tt><br></tt> <tt>$xpaset -p ds9 plot -shape fill no</tt><tt><br></tt> <tt>$xpaset -p ds9 plot shape color -cyan</tt><tt><br></tt> <tt>$xpaset -p ds9 plot smooth -step</tt><tt><br></tt> <tt>$xpaset -p ds9 plot color -red</tt><tt><br></tt> <tt>$xpaset -p ds9 plot width -2</tt><tt><br></tt> <tt>$xpaset -p ds9 plot dash -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot error -yes</tt><tt><br></tt> <tt>$xpaset -p ds9 plot error color -red</tt><tt><br></tt> <tt>$xpaset -p ds9 plot error width -2</tt><tt><br></tt> <tt>$xpaset -p ds9 plot name {My -Data}</tt><tt><br></tt> <tt><br></tt> <tt># select current -dataset</tt><tt><br></tt> <tt>$xpaget ds9 plot -select</tt><tt><br></tt> <tt>$xpaset -p ds9 plot select 2</tt><br> -<p><b><a name="png" id="png"></a>png</b></p> -<p>Load PNG image into current frame.<br></p> -<tt>Syntax:<br> -png [new|slice] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 png > foo.png</tt><br> -<tt>$xpaset -p ds9 png foo.png</tt><br> -<tt><tt>$xpaset -p ds9 png new foo.png<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9 png slice foo.png<br></tt></tt> $cat -foo.png | xpaset ds9 png</tt> <tt><tt><tt># not available -windows</tt></tt></tt><br> -<tt><tt>$cat foo.png | xpaset ds9 png</tt> <tt>new</tt></tt> -<tt><tt><tt><tt># not available windows</tt></tt><br></tt> $cat -foo.png | xpaset ds9 png</tt> <tt>slice</tt> <tt><tt><tt># not -available windows<br></tt></tt></tt> -<p><b><a name="precision" id="precision"></a>precision</b></p> -<p>Set region and coordinate output format precision.</p> -<tt>Syntax:<br> -precision <linear></tt> <tt><tt><degree></tt></tt> -<tt><tt><hms></tt></tt> -<tt><tt><tt><dms></tt></tt></tt> -<tt><tt><tt><tt><arcmin></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><arcsec><br> -<br></tt></tt></tt></tt> Example:<br> -$xpaget ds9 precision<br> -$xpaset -p ds9 precision 8 10 4 3 5 3</tt><br> -<p><b><a name="prefs" id="prefs"></a>prefs</b></p> -<p>Controls various preference settings.</p> -<tt>Syntax:<br> -prefs [clear]<br> - [irafalign yes|no]<br> - <br> -Example:<br> -$xpaget ds9 prefs irafalign<br> -$xpaset -p ds9 prefs clear<br> -$xpaset -p ds9 prefs iraf yes<br></tt> -<p><b><a name="preserve" id="preserve"></a>preserve</b></p> -<p>Preserve the follow attributes while loading a new image.</p> -<tt>Syntax:<br> -preserve [pan yes|no]<br> - [regions yes|no]<br> - <br> -Example:<br> -$xpaget ds9 preserve pan<br> -$xpaget ds9 preserve regions<br> -$xpaset -p ds9 preserve pan yes<br> -$xpaset -p ds9 preserve regions yes<br></tt> -<p><b><a name="psprint" id="psprint"></a>psprint</b></p> -<p>Invokes postscript printing. Please see <a href= -"command.html#print">print</a> for further details.</p> -<p><b><a name="print" id="print"></a>print</b></p> -<p>Controls printing. Use print option to set printing options. -Only available for <tt>XPA_METHOD local.</tt></p> -<tt>Syntax:<br> -print [destination printer|file]<br> - [command <command>]<br> - [filename <filename>]<br> - [color rgb|cmyk|gray]<br> - [level 1|2]<br> - [resolution -53|72|75|150|300|600]<br> - <br> -Example:<br> -$xpaget ds9 print destination<br> -$xpaget ds9 print command<br> -$xpaget ds9 print filename<br> -$xpaget ds9 print color<br> -$xpaget ds9 print level<br> -$xpaget ds9 print resolution<br> -$xpaset -p ds9 print<br> -$xpaset -p ds9 print destination file<br> -$xpaset -p ds9 print command lp<br> -$xpaset -p ds9 print filename foo.ps<br> -$xpaset -p ds9 print color cmyk<br> -$xpaset -p ds9 print level 2<br> -$xpaset -p ds9 print resolution 75</tt> -<p><b><a name="raise" id="raise"></a>raise</b></p> -<p>Raise in the window stacking order.</p> -<tt>Syntax:<br> -raise<br> - <br> -Example:<br> -$xpaset -p ds9 raise</tt> -<p><b><a name="regions" id="regions"></a>regions</b></p> -<p>Controls regions in the current frame.</p> -<tt>Syntax:<br> -regions [<filename>]<br> - [load [all] -<filename>]<br> - [save -<filename>]<br> - [list [close]]<br> - [epsilon <integer>]<br> - [show yes|no]<br> - [showtext yes|no]<br> - [centroid]<br> - [centroid auto -yes|no]<br> - [centroid radius -<value>|iteration <value>]<br> - [getinfo]<br> - [move front]<br> - [move back]<br> - [select all]<br> - [select none]<br> - [select invert]<br> - [delete all]<br> - [delete select]<br> - [format -ds9|xml|ciao|saotng|saoimage|pros|xy]<br> - [system -image|physical|wcs|wcsa...wcsz]<br> - [sky -fk4|fk5|icrs|galactic|ecliptic]<br> - [skyformat -degrees|sexagesimal]<br> - [strip yes|no]<br> - [shape -<shape>]<br> - [color -&ltcolor>]<br> - [width -<width>]<br></tt> <tt> -[fixed|edit|rotate|delete yes|no]<br> - -[include|exclude|source|background]</tt><br> -<tt> [command <marker -command>]<br> - [composite]<br> - [dissolve]<br> - [template -<filename>]<br> - [template <filename> at -<ra> <dec> <coordsys> <skyframe>]<br> - [savetemplate -<filename>]<br> - [groups]<br> - [group new]<br> - [group <tag> -new]<br> - [group <tag> -update]<br> - [group <tag> -select]<br> - [group <tag> color -&ltcolor>]<br> - [group <tag> copy]<br> - [group <tag> -delete]<br> - [group <tag> cut]<br> - [group <tag> font -<font>]<br> - [group <tag> move -<int> <int>]<br> - [group <tag> -movefront]<br> - [group <tag> -moveback]<br> - [group <tag> property -<property> yes|no]<br> - [copy]<br> - [cut]<br> - [paste -image|physical|wcs|wcsa...wcsz]<br> - [undo]<br> - [-format -ds9|ciao|saotng|saoimage|pros|xy]<br> - [-system -image|physical|wcs|wcsa...wcsz]<br> - [-sky -fk4|fk5|icrs|galactic|ecliptic]<br> - [-skyformat -degrees|sexagesimal]<br> - [-delim -[nl|<char>]]<br> - [-prop -select|edit|move|rotate|delete|fixed|include|source 1|0]<br> - [-group <tag>]<br> - [-strip yes|no]<br> - [-wcs yes|no]<br> - <br> -Example:<br> -$xpaget ds9 regions<br> -$xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat -sexagesimal -prop edit 1 -group foo<br> -$xpaget ds9 regions epsilon<br> -$xpaget ds9 regions show<br> -$xpaget ds9 regions showtext<br> -$xpaget ds9 regions centroid auto<br> -$xpaget ds9 regions centroid radius<br> -$xpaget ds9 regions centroid iteration<br> -$xpaget ds9 regions selected<br> -$xpaget ds9 regions format<br> -$xpaget ds9 regions system<br> -$xpaget ds9 regions sky<br> -$xpaget ds9 regions skyformat<br> -$xpaget ds9 regions strip<br> -$xpaget ds9 regions shape<br> -$xpaget ds9 regions color<br> -$xpaget ds9 regions width<br> -$xpaget ds9 regions source<br> -$xpaget ds9 regions background<br> -$xpaget ds9 regions include<br> -$xpaget ds9 regions exclude<br> -$xpaget ds9 regions selected<br> -$xpaget ds9 regions groups<br> -$cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky -fk5<br> -$cat bar.reg | xpaset ds9 regions -format ds9<br> -$echo "image; circle 100 100 20" | xpaset ds9 regions<br> -$echo "image; circle 100 100 20" | xpaset ds9 regions<br> -$echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions<br> -$echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions<br> -$echo "box 100 100 20 40 25" | xpaset ds9 regions<br> -$echo "image; line 100 100 200 400" | xpaset ds9 regions<br> -$echo "physical; ruler 200 300 200 400" | xpaset ds9 regions<br> -$echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 -regions<br> -$echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 -regions<br> -$xpaset -p ds9 regions foo.reg<br> -$xpaset -p ds9 regions -format ciao bar.reg # load as ciao -format<br> -$xpaset -p ds9 regions foo.fits # FITS regions files do not need a -format specification<br> -$xpaset -p ds9 regions load foo.reg # load foo.reg into current -frame<br> -$xpaset -p ds9 regions load all foo.reg # load foo.reg into all -frames<br> -$xpaset -p ds9 regions load '*.reg'# expand *.reg and load into -current frame<br> -$xpaset -p ds9 regions load all '*.reg' # expand *.reg and load -into all frames<br> -$xpaset -p ds9 regions save foo.reg<br> -$xpaset -p ds9 regions list<br> -$xpaset -p ds9 regions list close<br> -$xpaset -p ds9 regions epsilon 5<br> -$xpaset -p ds9 regions show yes<br> -$xpaset -p ds9 regions showtext no<br> -$xpaset -p ds9 regions centroid<br> -$xpaset -p ds9 regions centroid auto yes<br> -$xpaset -p ds9 regions centroid radius 10<br> -$xpaset -p ds9 regions centroid iteration 20<br> -$xpaset -p ds9 regions getinfo<br> -$xpaset -p ds9 regions move back<br> -$xpaset -p ds9 regions move front<br> -$xpaset -p ds9 regions select all<br> -$xpaset -p ds9 regions select none<br> -$xpaset -p ds9 regions select invert<br> -$xpaset -p ds9 regions delete all<br> -$xpaset -p ds9 regions delete select<br> -$xpaset -p ds9 regions format ds9<br> -$xpaset -p ds9 regions system wcs<br> -$xpaset -p ds9 regions sky fk5<br> -$xpaset -p ds9 regions skyformat degrees<br> -$xpaset -p ds9 regions strip yes<br> -$xpaset -p ds9 regions shape ellipse<br> -$xpaset -p ds9 regions color red<br> -$xpaset -p ds9 regions width 3<br> -$xpaset -p ds9 regions edit yes<br> -$xpaset -p ds9 regions include<br> -$xpaset -p ds9 regions command '{circle 100 100 20 # -color=red}'<br> -$xpaset -p ds9 regions composite<br> -$xpaset -p ds9 regions dissolve<br> -$xpaset -p ds9 regions template foo.tpl<br> -$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 +47:12:48.02 -fk5<br> -$xpaset -p ds9 regions savetemplate foo.tpl<br> -$xpaset -p ds9 regions group new<br> -$xpaset -p ds9 regions group foo new<br></tt> <tt>$xpaset -p ds9 -regions group foo update</tt><br> -<tt>$xpaset -p ds9 regions group foo select</tt><br> -<tt>$xpaset -p ds9 regions group foo color red<br> -$xpaset -p ds9 regions group foo copy<br> -$xpaset -p ds9 regions group foo delete<br> -$xpaset -p ds9 regions group foo cut<br> -$xpaset -p ds9 regions group foo font {times 14 bold}<br> -$xpaset -p ds9 regions group foo move 100 100<br> -$xpaset -p ds9 regions group foo movefront<br> -$xpaset -p ds9 regions group foo moveback<br> -$xpaset -p ds9 regions group foo property delete no<br> -<br> -$xpaset -p ds9 regions copy<br> -$xpaset -p ds9 regions cut<br> -$xpaset -p ds9 regions paste wcs<br> -$xpaset -p ds9 regions undo<br></tt> -<p><b><a name="restore" id="restore"></a>restore</b></p> -<p>Restore DS9 to a previous state from a backup save set.</p> -<tt>Syntax:<br> -restore <filename><br> - <br> -Example:<br> -$xpaset -p ds9 restore ds9.bck</tt><br> -<p><b><a name="rgb" id="rgb"></a>rgb</b></p> -<p>Create RGB frame and control RGB frame parameters.</p> -<tt>Syntax:<br> -rgb []<br> - [red|green|blue]<br> - [channel [red|green|blue]]<br> - [view [red|green|blue] [yes|no]]<br> - [system <coordsys>]<br> - [lock -wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth -[yes|no]]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 rgb channel<br></tt> <tt>$xpaget ds9 rgb lock -wcs</tt><br> -<tt>$xpaget ds9 rgb lock crop</tt><br> -<tt>$xpaget ds9 rgb lock slice</tt><br> -<tt>$xpaget ds9 rgb lock bin<br> -$xpaget ds9 rgb lock scale<br> -$xpaset ds9 rgb lock scalelimits<br> -$xpaget ds9 rgb lock colorbar<br> -$xpaget ds9 rgb lock block<br> -$xpaget ds9 rgb lock smooth<br> -$xpaget ds9 rgb system<br> -$xpaget ds9 rgb view red<br> -$xpaget ds9 rgb view green<br> -$xpaget ds9 rgb view blue<br> -$xpaset -p ds9 rgb # create new rgb frame<br> -$xpaset -p ds9 rgb red # set current channel to red<br> -$xpaset -p ds9 rgb channel red # set current channel to red<br> -$xpaset -p ds9 rgb view blue no # turn off blue channel<br> -$xpaset -p ds9 rgb system wcs # set rgb coordinate system<br></tt> -<tt>$xpaset -p ds9 rgb lock wcs yes</tt><br> -<tt>$xpaset -p ds9 rgb lock crop yes</tt><br> -<tt>$xpaset -p ds9 rgb lock slice yes</tt><br> -<tt>$xpaset -p ds9 rgb lock bin yes</tt><br> -<tt>$xpaset -p ds9 rgb lock scale yes<br> -$xpaset -p ds9 rgb lock scalelimits yes<br> -$xpaset -p ds9 rgb lock colorbar yes<br> -$xpaset -p ds9 rgb lock block yes<br> -$xpaset -p ds9 rgb lock smooth yes<br> -$xpaset -p ds9 rgb open<br> -$xpaset -p ds9 rgb close</tt><br> -<p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> -<p>Load raw data array cube into rgb frame.<br></p> -<tt>Syntax:<br> -rgbarray [native|big|little]<br> -rgbarray [new] + [has contour [aux]]]<br> + [has fits [bin|cube|mosaic]]<br> + [has marker + [highlite|paste|select|undo]]<br> + [has system + <coordsys>]<br> + </tt> + <tt><tt><tt> [has wcs + [<wcssys>]]<br> + </tt> [has wcs + celestial [<wcssys>]]<br> + </tt> + [has wcs linear [<wcssys>]]<br> + <br> + Example:<br> + $xpaget ds9 frame # returns the id of the current frame<br> + $xpaget ds9 frame frameno # returns the id of the current frame<br> + $xpaget ds9 frame all # returns the id of all frames<br> + $xpaget ds9 frame active # returns the id of all active + frames<br> + </tt> <tt>$xpaget ds9 frame lock</tt><br> + <tt>$xpaget ds9 frame has amplifier<br> + $xpaget ds9 frame has datamin<br> + $xpaget ds9 frame has datasec<br> + $xpaget ds9 frame has detector<br> + $xpaget ds9 frame has grid<br> + $xpaget ds9 frame has iis<br> + $xpaget ds9 frame has irafmin<br> + $xpaget ds9 frame has physical<br> + $xpaget ds9 frame has smooth<br> + $xpaget ds9 frame has contour<br> + $xpaget ds9 frame has contour aux<br> + $xpaget ds9 frame has fits<br> + $xpaget ds9 frame has fits bin<br> + $xpaget ds9 frame has fits cube<br> + $xpaget ds9 frame has fits mosaic<br> + $xpaget ds9 frame has marker highlite<br> + $xpaget ds9 frame has marker paste<br> + $xpaget ds9 frame has marker select<br> + $xpaget ds9 frame has marker undo<br> + $xpaget ds9 frame has system physical<br> + $xpaget ds9 frame has wcs wcsa<br> + $xpaget ds9 frame has wcs celestial wcsa<br> + $xpaget ds9 frame has wcs linear wcsa<br> + $xpaset -p ds9 frame center # center current frame<br> + $xpaset -p ds9 frame center 1 # center 'Frame1'<br> + $xpaset -p ds9 frame center all # center all frames<br> + $xpaset -p ds9 frame clear # clear current frame<br> + $xpaset -p ds9 frame new # create new frame<br> + $xpaset -p ds9 frame new rgb # create new rgb frame<br> + $xpaset -p ds9 frame delete # delete current frame<br> + $xpaset -p ds9 frame reset # reset current frame<br> + $xpaset -p ds9 frame refresh # refresh current frame<br> + $xpaset -p ds9 frame hide # hide current frame<br> + $xpaset -p ds9 frame show 1 # show frame 'Frame1'<br> + $xpaset -p ds9 frame move first # move frame to first in order<br> + $xpaset -p ds9 frame move back # move frame back in order<br> + $xpaset -p ds9 frame move forward # move frame forward in order<br> + $xpaset -p ds9 frame move last # move frame to last in order<br> + $xpaset -p ds9 frame first # goto first frame<br> + $xpaset -p ds9 frame prev # goto prev frame<br> + $xpaset -p ds9 frame next # goto next frame<br> + $xpaset -p ds9 frame last # goto last frame<br> + $xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if + needed<br> + $xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed<br> + $xpaset -p ds9 frame match wcs<br> + $xpaset -p ds9 frame lock wcs</tt><br> + <p><b><a name="gif" id="gif"></a>gif</b></p> + <p>Load GIF image into current frame.<br> + </p> + <tt>Syntax:<br> + gif [new|slice] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 gif > foo.gif</tt><br> + <tt>$xpaset -p ds9 gif foo.gif</tt><br> + <tt><tt>$xpaset -p ds9 gif new foo.gif<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9 gif slice foo.gif<br> + </tt></tt> $cat + foo.gif | xpaset ds9 gif # not available windows</tt><br> + <tt><tt>$cat foo.gif | xpaset ds9 gif</tt> <tt>new # not + available + windows<br> + </tt> $cat foo.gif | xpaset ds9 gif</tt> <tt>slice</tt> + <tt><tt><tt># not available windows</tt></tt></tt> + <p><b><a name="grid" id="grid"></a>grid</b></p> + <p>Controls coordinate grid. For grid numeric format syntax, + click <a href="grid.html#Format">here</a>.</p> + <tt>Syntax:<br> + grid []<br> + [yes|no]<br> + [type analysis|publication]<br> + [system <coordsys>]<br> + [sky <skyframe>]<br> + [skyformat <skyformat>]<br> + [grid yes|no]<br> + [grid color <color>]<br> + [grid width <value>]<br> + [grid dash yes|no]<br> + [grid gap1 <value>]<br> + </tt> + <tt><tt> [grid gap2 + <value>]<br> + </tt></tt> + <tt><tt><tt> [grid gap3 + <value>]<br> + </tt></tt> [axes + yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes dash yes|no]<br> + [axes type interior|exterior]<br> + [axes origin + lll|llu|lul|luu|ull|ulu|uul|uuu]<br> + [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks dash yes|no]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border dash yes|no]<br> + [numerics yes|no]<br> + [numerics font + times|helvetica|courier]<br> + [numerics fontsize + <value>]<br> + [numerics fontweight + normal|bold]<br> + [numerics fontslant + roman|italic]<br> + [numerics color <color>]<br> + [numerics gap1 + <value>]<br> + </tt> <tt><tt> + [numerics gap2 <value>]<br> + </tt></tt> + <tt><tt><tt> [numerics gap3 + <value>]<br> + </tt></tt> + [numerics type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font + times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + </tt> + <tt><tt> [labels def1 yes|no]<br> + [labels def2 yes|no]<br> + </tt> + [labels text1 <text>]<br> + </tt> + <tt><tt> [labels text2 + <text>]<br> + </tt></tt> <tt><tt> + [labels gap1 <value>]<br> + </tt> + [labels gap2 <value>]<br> + </tt> + <tt> [labels font + times|helvetica|courier]<br> + [labels fontsize <value>]<br> + [labels fontweight normal|bold]<br> + [labels fontslant roman|italic]<br> + [labels color <color>]<br> + [reset]<br> + [load <filename>]<br> + [save <filename>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 grid<br> + $xpaget ds9 grid type<br> + $xpaget ds9 grid system<br> + $xpaget ds9 grid sky<br> + $xpaget ds9 grid skyformat<br> + $xpaget ds9 grid grid<br> + $xpaget ds9 grid grid color<br> + $xpaget ds9 grid grid width<br> + $xpaget ds9 grid grid dash<br> + $xpaget ds9 grid grid gap1<br> + </tt> <tt><tt>$xpaget ds9 grid grid + gap2<br> + </tt></tt> <tt><tt><tt>$xpaget ds9 grid grid + gap3<br> + </tt></tt> $xpaget ds9 grid axes<br> + $xpaget ds9 grid axes color<br> + $xpaget ds9 grid axes width<br> + $xpaget ds9 grid axes dash<br> + $xpaget ds9 grid axes type<br> + $xpaget ds9 grid axes origin<br> + $xpaget ds9 grid format1<br> + $xpaget ds9 grid format2<br> + $xpaget ds9 grid tickmarks<br> + $xpaget ds9 grid tickmarks color<br> + $xpaget ds9 grid tickmarks width<br> + $xpaget ds9 grid tickmarks dash<br> + $xpaget ds9 grid border<br> + $xpaget ds9 grid border color<br> + $xpaget ds9 grid border width<br> + $xpaget ds9 grid border dash<br> + $xpaget ds9 grid numerics<br> + $xpaget ds9 grid numerics font<br> + $xpaget ds9 grid numerics fontsize<br> + $xpaget ds9 grid numerics fontweight<br> + $xpaget ds9 grid numerics fontslant<br> + $xpaget ds9 grid numerics color<br> + $xpaget ds9 grid numerics gap1<br> + </tt> <tt><tt>$xpaget ds9 grid + numerics gap2<br> + </tt></tt> <tt><tt><tt>$xpaget ds9 grid numerics + gap3<br> + </tt></tt> $xpaget ds9 grid numerics type<br> + $xpaget ds9 grid numerics vertical<br> + $xpaget ds9 grid title<br> + $xpaget ds9 grid title text<br> + $xpaget ds9 grid title def<br> + $xpaget ds9 grid title gap<br> + $xpaget ds9 grid title font<br> + $xpaget ds9 grid title fontsize<br> + $xpaget ds9 grid title fontweight<br> + $xpaget ds9 grid title fontslant<br> + $xpaget ds9 grid title color<br> + $xpaget ds9 grid labels<br> + $xpaget ds9 grid labels text1<br> + $xpaget ds9 grid labels def1<br> + $xpaget ds9 grid labels gap1<br> + $xpaget ds9 grid labels text2<br> + $xpaget ds9 grid labels def2<br> + $xpaget ds9 grid labels gap2<br> + $xpaget ds9 grid labels font<br> + $xpaget ds9 grid labels fontsize<br> + $xpaget ds9 grid labels fontweight<br> + $xpaget ds9 grid labels fontslant<br> + $xpaget ds9 grid labels color<br> + $xpaset -p ds9 grid<br> + $xpaset -p ds9 grid yes<br> + $xpaset -p ds9 grid type analysis<br> + $xpaset -p ds9 grid system wcs<br> + $xpaset -p ds9 grid sky fk5<br> + $xpaset -p ds9 grid skyformat degrees<br> + $xpaset -p ds9 grid grid yes<br> + $xpaset -p ds9 grid grid color red<br> + $xpaset -p ds9 grid grid width 2<br> + $xpaset -p ds9 grid grid dash yes<br> + $xpaset -p ds9 grid grid gap1 10<br> + $xpaset -p ds9 grid grid gap2 10<br> + </tt> <tt><tt>$xpaset -p ds9 + grid grid gap3 10<br> + </tt> $xpaset -p ds9 grid axes yes<br> + $xpaset -p ds9 grid axes color red<br> + $xpaset -p ds9 grid axes width 2<br> + $xpaset -p ds9 grid axes dash yes<br> + $xpaset -p ds9 grid axes type exterior<br> + $xpaset -p ds9 grid axes origin lll<br> + $xpaset -p ds9 grid format1 d.2<br> + $xpaset -p ds9 grid format2 d.2<br> + $xpaset -p ds9 grid tickmarks yes<br> + $xpaset -p ds9 grid tickmarks color red<br> + $xpaset -p ds9 grid tickmarks width 2<br> + $xpaset -p ds9 grid tickmarks dash yes<br> + $xpaset -p ds9 grid border yes<br> + $xpaset -p ds9 grid border color red<br> + $xpaset -p ds9 grid border width 2<br> + $xpaset -p ds9 grid border dash yes<br> + $xpaset -p ds9 grid numerics yes<br> + $xpaset -p ds9 grid numerics font courier<br> + $xpaset -p ds9 grid numerics fontsize 12<br> + $xpaset -p ds9 grid numerics fontweight bold<br> + $xpaset -p ds9 grid numerics fontslant italic<br> + $xpaset -p ds9 grid numerics color red<br> + $xpaset -p ds9 grid numerics gap1 10<br> + </tt> <tt><tt>$xpaset -p + ds9 grid numerics gap2 10<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 + grid numerics gap3 10<br> + </tt></tt> $xpaset -p ds9 grid numerics + type exterior<br> + $xpaset -p ds9 grid numerics vertical yes<br> + $xpaset -p ds9 grid title yes<br> + $xpaset -p ds9 grid title text {Hello World}<br> + $xpaset -p ds9 grid title def yes<br> + $xpaset -p ds9 grid title gap 10<br> + $xpaset -p ds9 grid title font courier<br> + $xpaset -p ds9 grid title fontsize 12<br> + $xpaset -p ds9 grid title fontweight bold<br> + $xpaset -p ds9 grid title fontslant italic<br> + $xpaset -p ds9 grid title color red<br> + $xpaset -p ds9 grid labels yes<br> + $xpaset -p ds9 grid labels text1 {Hello World}<br> + $xpaset -p ds9 grid labels def1 yes<br> + $xpaset -p ds9 grid labels gap1 10<br> + $xpaset -p ds9 grid labels text2 {Hello World}<br> + $xpaset -p ds9 grid labels def2 yes<br> + $xpaset -p ds9 grid labels gap2 10<br> + $xpaset -p ds9 grid labels font courier<br> + $xpaset -p ds9 grid labels fontsize 12<br> + $xpaset -p ds9 grid labels fontweight boldj<br> + $xpaset -p ds9 grid labels fontslant italic<br> + $xpaset -p ds9 grid labels color red<br> + $xpaset -p ds9 grid reset<br> + $xpaset -p ds9 grid load foo.grd<br> + $xpaset -p ds9 grid save foo.grd<br> + $xpaset -p ds9 grid open<br> + $xpaset -p ds9 grid close<br> + </tt> + <p><b><a name="header" id="header"></a>header</b></p> + <p>Display current fits header dialog. Optional extension number + maybe specified. Please note, this differs from xpa fits + header.</p> + <tt>Syntax:<br> + header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] + <filename>]<br> + <br> + Example:<br> + $xpaset -p ds9 header<br> + $xpaset -p ds9 header 2<br> + $xpaset -p ds9 header close<br> + $xpaset -p ds9 header save 1 foo.txt<br> + </tt> + <p><b><a name="height" id="height"></a>height</b></p> + <p>Set the height of the image display window.</p> + <tt>Syntax:<br> + height [<value>]<br> + <br> + Example:<br> + $xpaget ds9 height<br> + $xpaset -p ds9 height 512<br> + </tt> + <p><b><a name="iconify" id="iconify"></a>iconify</b></p> + <p>Toggles iconification.</p> + <tt>Syntax:<br> + iconify []<br> + [yes|no]<br> + <br> + Example:<br> + $xpaget ds9 iconify<br> + $xpaset -p ds9 iconify</tt><br> + <tt>$xpaset -p ds9 iconify yes</tt><br> + <p><b><a name="iexam" id="iexam"></a>iexam</b></p> + <p>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 + <tt>button</tt>. In the last form, the following macros will be + expanded if present: <tt>$width, $height, $depth, $bitpix, + $filename, $regions, $filename[$regions], $env, $pan, $value, + $x, + $y, $z.</tt> See <a href="analysis.html#macros">Analysis + Macros</a> + for more information.<br> + </p> + <tt>Syntax:<br> + iexam []<br> + [[]|button|key|any] coordinate + <coordsys> [<skyframe>] [<skyformat>]<br> + [[]|button|key|any] data + [width][height]<br> + </tt> <tt><tt> + [[]|button|key|any] <macro string>]<br> + </tt><br> + Example:<br> + $xpaget ds9 iexam # image coordinates<br> + </tt> <tt><tt>$xpaget ds9 + iexam coordinate image<br> + </tt> $xpaget ds9 iexam key coordinate + image # return coordinate and key event<br> + $xpaget ds9 iexam coordinate wcs fk5 degrees<br> + $xpaget ds9 iexam coordinate wcs galactic sexagesimal<br> + $xpaget ds9 iexam coordinate fk5<br> + $xpaget ds9 iexam data # return data value<br> + $xpaget ds9 iexam key data # return data value and key event<br> + $xpaget ds9 iexam data 3 3 # return all data in 3x3 box about + selected point<br> + $xpaget ds9 iexam {'Click at $x,$y in file $filename'}</tt><br> + <p><b><a name="iis" id="iis"></a>iis</b></p> + <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> + <tt>Syntax:<br> + iis [filename <filename> [#]]<br> + <br> + Example:<br> + $xpaget ds9 iis filename<br> + $xpaget ds9 iis filename 4<br> + $xpaset -p ds9 iis filename foo.fits<br> + $xpaset -p ds9 iis filename bar.fits 4</tt><br> + <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> + <p>Load JPEG image into current frame. Optional parameters: + <tt>jpeg</tt> quality (1-100)</p> + <tt>Syntax:<br> + jpeg [new|slice] [<filename>] [1-100]<br> + <br> + Example:<br> + $xpaget ds9 jpeg > foo.jpeg</tt><br> + <tt><tt>$xpaget ds9 jpeg 100 > foo.jpeg</tt><br> + $xpaset -p ds9 jpeg foo.jpeg</tt><br> + <tt><tt>$xpaset -p ds9 jpeg new foo.jpeg<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9 jpeg slice foo.jpeg<br> + </tt></tt> $cat + foo.jpeg | xpaset ds9 jpeg</tt> <tt><tt><tt># not available + windows</tt></tt></tt><br> + <tt><tt>$cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>new</tt></tt> + <tt><tt><tt><tt># not available windows</tt></tt><br> + </tt> $cat + foo.jpeg | xpaset ds9 jpeg</tt> <tt>slice</tt> <tt><tt><tt># + not + available windows</tt></tt></tt> + <p><b><a name="lock" id="lock"></a>lock</b></p> + <p>Lock all other frames to the current frame.</p> + <tt>Syntax:<br> + lock</tt> <tt>[frame <coordsys>|none]<br> + </tt> <tt>[crosshair + <coordsys>|none]</tt> <tt><br> + </tt> + <tt> [crop <coordsys>|none]</tt><br> + <tt> [slice + <coordsys>|none]]<br> + </tt> <tt> [bin + [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimites [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + </tt> + <tt> [smooth [yes|no]]</tt><br> + <tt> [3d [yes|no]]</tt><br> + <tt><tt> </tt><br> + Example:<br> + $xpaget -p ds9 lock frame<br> + $xpaget -p ds9 lock crosshair<br> + </tt> <tt>$xpaget -p ds9 lock + crop</tt><br> + <tt>$xpaget -p ds9 lock slice</tt><br> + <tt>$xpaget -p ds9 lock bin<br> + $xpaget -p ds9 lock axes<br> + $xpaget -p ds9 lock scale<br> + $xpaget -p ds9 lock scalelimits<br> + $xpaget -p ds9 lock colorbar<br> + $xpaget -p ds9 lock block<br> + </tt> <tt><tt>$xpaget -p ds9 lock + smooth<br> + </tt></tt> <tt><tt><tt>$xpaget -p ds9 lock + 3d<br> + </tt></tt> $xpaset -p ds9 lock frame wcs</tt><tt><br> + </tt> + <tt>$xpaset -p ds9 lock crosshair wcs<br> + </tt> <tt>$xpaset -p ds9 + lock crop wcs</tt><br> + <tt>$xpaset -p ds9 lock slice wcs</tt><br> + <tt>$xpaset -p ds9 lock bin yes<br> + $xpaset -p ds9 lock axes yes<br> + </tt> <tt>$xpaset -p ds9 lock scale + yes<br> + $xpaset -p ds9 lock scalelimits yes<br> + </tt> <tt>$xpaset -p ds9 + lock colorbar yes<br> + $xpaset -p ds9 lock block yes</tt><br> + <tt>$xpaset -p ds9 lock smooth yes</tt><br> + <tt>$xpaset -p ds9 lock 3d yes<br> + <br> + </tt> <b><a name="lower" id="lower"></a>lower</b> + <p>Lower in the window stacking order.</p> + <tt>Syntax:<br> + lower<br> + <br> + Example:<br> + $xpaset -p ds9 lower</tt><tt><br> + </tt> + <p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> + <p>Controls the magnifier settings.</p> + <tt>Syntax:<br> + magnifier [color <color>]<br> + [zoom + <value>]<br> + [cursor + yes|no]<br> + [region + yes|no]<br> + <br> + Example:<br> + $xpaget ds9 magnifier color<br> + $xpaget ds9 magnifier zoom<br> + $xpaget ds9 magnifier cursor<br> + $xpaget ds9 magnifier region<br> + $xpaset -p ds9 magnifier color yellow<br> + $xpaset -p ds9 magnifier zoom 2<br> + $xpaset -p ds9 magnifier cursor no<br> + $xpaset -p ds9 magnifier region no</tt><br> + <p><b><a name="mask" id="mask"></a>mask<br> + </b></p> + <p>Controls mask parameters.</p> + <tt>Syntax:<br> + mask [color <color>]<br> + [mark 1|0]<br> + [transparency <value>]<br> + [clear]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 mask color<br> + $xpaget ds9 mask mark<br> + $xpaget ds9 mask transparency<br> + $xpaset -p ds9 mask color red<br> + $xpaset -p ds9 mask mark 0<br> + $xpaset -p ds9 mask transparency 50<br> + $xpaset -p ds9 mask clear<br> + $xpaset -p ds9 mask open<br> + $xpaset -p ds9 mask close<br> + </tt> + <p><b><a name="match" id="match"></a>match</b></p> + <p>Match all other frames to the current frame.</p> + <tt>Syntax:<br> + </tt> <tt>match</tt> <tt>[frame + <coordsys>]<br> + </tt> <tt>[crosshair + <coordsys>]</tt> <tt><br> + </tt> + <tt> [crop <coordsys>]</tt><br> + <tt> [slice + <coordsys>]</tt><br> + <tt> [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]<br> + [3d]<br> + </tt> <tt><tt><br> + </tt> + Example:<br> + $xpaset -p ds9 match frame wcs<br> + </tt> <tt>$xpaset -p ds9 match + crosshair wcs<br> + </tt> <tt>$xpaset -p ds9 match crop wcs</tt><br> + <tt>$xpaset -p ds9 match slice</tt> <tt>wcs<br> + </tt> <tt>$xpaset -p + ds9 match bin<br> + $xpaset -p ds9 match axes<br> + $xpaset -p ds9 match scale<br> + $xpaset -p ds9 match scalelimits<br> + $xpaset -p ds9 match colorbar<br> + $xpaset -p ds9 match block<br> + $xpaset -p ds9 match smooth<br> + $xpaset -p ds9 match 3d<br> + <br> + </tt> <b><a name="mecube" id="mecube"></a>mecube</b> + <p>Load FITS multiple extension file as data cube.<br> + </p> + <tt>Syntax:<br> + mecube [new] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 mecube > foo.fits<br> + $xpaset -p ds9 mecube foo.fits</tt><br> + <tt><tt>$xpaset -p ds9 mecube new foo.fits<br> + </tt> $cat foo.fits | + xpaset ds9 mecube</tt><br> + <tt>$cat foo.fits | xpaset ds9 mecube</tt> <tt>new</tt> + <p><b><a name="minmax" id="minmax"></a>minmax</b></p> + <p>This is how DS9 determines the min and max data values + from the data. <tt>SCAN</tt> will scan all + data. <tt>DATAMIN</tt> and <tt>IRAFMIN</tt> will use the + values of the keywords if present.<br> + </p> + <tt>Syntax:<br> + minmax [scan|sample|datamin|irafmin]<br> + [mode + scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> + Example:<br> + $xpaget ds9 minmax mode<br> + $xpaget ds9 minmax interval<br> + $xpaset -p ds9 minmax scan<br> + $xpaset -p ds9 minmax mode scan<br> + $xpaset -p ds9 minmax interval 100<br> + </tt> + <p><b><a name="mode" id="mode"></a>mode</b></p> + <p>Controls the first mouse button mode.</p> + <tt>Syntax:<br> + mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> + <br> + Example:<br> + $xpaget ds9 mode<br> + $xpaset -p ds9 mode crosshair</tt><br> + <p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> + <p>Load FITS mosaic segment into current frame.</p> + <tt>Syntax:<br> + mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 mosaic > foo.fits</tt><tt><br> + $xpaset -p ds9 mosaic foo.fits</tt><br> + <tt><tt>$xpaset -p ds9 mosaic wcs foo.fits</tt></tt><br> + <tt><tt>$xpaset -p ds9 mosaic wcs new foo.fits</tt></tt><br> + <tt><tt>$xpaset -p ds9 mosaic wcs mask + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | xpaset + ds9 mosaic</tt><br> + <tt><tt>$cat foo.fits | xpaset ds9 mosaic wcs<br> + $cat foo.fits | xpaset ds9 mosaic wcs</tt> <tt>new<br> + </tt> $cat + foo.fits | xpaset ds9 mosaic wcs</tt> <tt>mask<br> + </tt> + <p><b><a name="mosaicimage" id="mosaicimage"></a>mosaicimage</b></p> + <p>Load FITS mosaic image into current frame.</p> + <tt>Syntax:<br> + mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] + [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 mosaicimage > foo.fits</tt><tt><br> + $xpaset -p ds9 mosaicimage foo.fits</tt><br> + <tt><tt>$xpaset -p ds9 mosaicimage wcs foo.fits</tt></tt><br> + <tt><tt>$xpaset -p ds9 mosaicimage wcs new foo.fits</tt></tt><br> + <tt><tt>$xpaset -p ds9 mosaicimage wcs mask + foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | xpaset + ds9 mosaicimage</tt><br> + <tt><tt>$cat foo.fits | xpaset ds9 mosaicimage wcs<br> + $cat foo.fits | xpaset ds9 mosaicimage wcs new</tt><tt><br> + </tt> + $cat foo.fits | xpaset ds9 mosaicimage wcs mask</tt><br> + <p><b><a name="movie" id="movie"></a>movie<br> + savempeg<br> + </b></p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A + <tt>slice</tt> movie cycles though all slices of a cube. A + <tt>frame</tt> movie cycles through all active frames. A + <tt>3d</tt> movie cycles through specified viewing angles. The + default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: + number of frames, azimuth from/to, elevation from/to, slice + from/to, oscillate/repeat times.</p> + <tt>Syntax:<br> + movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br> + </tt> + <tt>movie 3d <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>]</tt><br> + <tt> <br> + Example:<br> + $xpaset -p ds9 movie slice ds9.mpg<br> + </tt> <tt>$xpaset -p ds9 + movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> + <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> + <p>Load FITS multiple extension file as multiple images.<br> + </p> + <tt>Syntax:<br> + multiframe [<filename>]<br> + <br> + Example:<br> + $xpaset -p ds9 multiframe foo.fits</tt><tt><tt><br> + </tt> $cat + foo.fits | xpaset ds9 multiframe</tt> <tt><tt><tt># not + available + windows</tt></tt></tt><br> + <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> + <p>Support Name Server functions. Coordinates are in fk5.</p> + <tt>Syntax:<br> + nameserver [<object>]<br> + + [name + <object>]<br> + + [server</tt> + <tt><tt>ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt></tt>]<br> + + [skyformat degrees|sexagesimal]<br> + + [pan]<br> + + [crosshair]<br> + + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 nameserver<br> + $xpaget ds9 nameserver server<br> + $xpaget ds9 nameserver skyformat<br> + $xpaget ds9 nameserver m31<br> + $xpaset -p ds9 nameserver m31<br> + $xpaset -p ds9 nameserver name m31<br> + $xpaset -p ds9 nameserver server ned-sao<br> + $xpaset -p ds9 nameserver skyformat sexagesimal<br> + $xpaset -p ds9 nameserver pan<br> + $xpaset -p ds9 nameserver crosshair<br> + $xpaset -p ds9 nameserver open<br> + $xpaset -p ds9 nameserver close<br> + </tt> + <p><b><a name="nan" id="nan"></a>nan</b></p> + <p>Set image not-a-number color.</p> + <tt>Syntax:<br> + nan <color><br> + <br> + Example:<br> + $xpaget ds9 nan<br> + $xpaset -p ds9 nan red</tt><tt><br> + </tt> + <p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> + <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: + array endian.<br> + </p> + <tt>Syntax:<br> + nrrd [native|little|big]<br> + nrrd [new|mask] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 nrrd</tt><br> + <tt><tt>$xpaget ds9 nrrd big<br> + $xpaset -p ds9 nrrd foo.nrrd</tt></tt><br> + <tt><tt><tt><tt>$xpaset -p ds9 nrrd new + foo.nrrd</tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 nrrd mask + foo.nrrd<br> + </tt></tt></tt></tt></tt> $cat foo.nrrd | xpaset ds9 + nrrd</tt><br> + <tt>$cat foo.nrrd | xpaset ds9 nrrd</tt> <tt>new<br> + $cat foo.nrrd | xpaset ds9 nrrd mask</tt> + <p><b><a name="nvss" id="nvss"></a>nvss</b></p> + <p>Support for NRAO VLA Sky Survey.</p> + <tt>Syntax:<br> + nvss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 nvss name<br> + $xpaget ds9 nvss coord<br> + $xpaget ds9 nvss size<br> + $xpaget ds9 nvss save<br> + $xpaget ds9 nvss frame<br> + $xpaset -p ds9 nvss<br> + $xpaset -p ds9 nvss m31<br> + </tt> <tt><tt>$xpaset -p ds9 nvss name + m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 nvss name + clear<br> + </tt></tt> $xpaset -p ds9 nvss 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 nvss size 60 60 arcmin<br> + $xpaset -p ds9 nvss save yes<br> + $xpaset -p ds9 nvss frame current<br> + $xpaset -p ds9 nvss update frame<br> + $xpaset -p ds9 nvss open<br> + </tt> <tt>$xpaset -p ds9 nvss + close</tt><br> + <p><b><a name="orient" id="orient"></a>orient</b></p> + <p>Controls the orientation of the current frame.</p> + <tt>Syntax:<br> + orient [none|x|y|xy]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 orient<br> + $xpaset -p ds9 orient xy<br> + $xpaset -p ds9 orient open<br> + $xpaset -p ds9 orient close<br> + </tt> + <p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> + <p>Controls Page Setup options.<br> + </p> + <tt>Syntax:<br> + pagesetup [orient portrait|landscape]<br> + [scale + <numberic>]</tt><br> + <tt> [size + letter|legal|tabloid|poster|a4]</tt><br> + <tt> <br> + Example:<br> + $xpaget ds9 pagesetup orient<br> + $xpaget ds9 pagesetup scale<br> + $xpaget ds9 pagesetup size<br> + $xpaset -p ds9 pagesetup orient portrait<br> + $xpaset -p ds9 pagesetup scale 50<br> + $xpaset -p ds9 pagesetup size poster<br> + </tt> + <p><b><a name="pan" id="pan"></a>pan</b></p> + <p>Controls the current image cursor location for the current + frame.</p> + <tt>Syntax:<br> + pan [<coordsys> [<skyframe>] [<skyformat>]] # + get current coords<br> + <br> + pan [<x> <y> <coordsys> + [<skyframe>]] # relative<br> + [to <x> <y> <coordsys> + [<skyframe>]] # absolute<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 pan # get current image coords<br> + $xpaget ds9 pan wcs fk4 sexagesimal # get current coords<br> + $xpaset -p ds9 pan 200 200 image # pan relative<br> + $xpaset -p ds9 pan to 400 400 physical # pan to physical coords<br> + $xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs + coords<br> + $xpaset -p ds9 pan open<br> + $xpaset -p ds9 pan close<br> + </tt> + <p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> + <p>Display/Hide the pixel table.</p> + <tt>Syntax:<br> + pixeltable []<br> + [yes|open]<br> + + [no|close]<br> + <br> + Example:<br> + $xpaget ds9 pixeltable<br> + $xpaset -p ds9 pixeltable<br> + $xpaset -p ds9 pixeltable yes<br> + $xpaset -p ds9 pixeltable open<br> + $xpaset -p ds9 pixeltable close</tt><br> + <p><b><a name="plot" id="plot"></a>plot</b></p> + <p>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:</p> + <blockquote>xy x and y coordinates<br> + xyex x,y coordinates with x errors<br> + xyey x,y coordinates with y errors<br> + xyexey x,y coordinates with x and y + errors<br> + </blockquote> + <p>To create a new plot, use the plot new command.</p> + <tt>Syntax:</tt><tt><br> + </tt> <tt># create new empty plot + window</tt><tt><br> + </tt> <tt>plot []</tt><tt><br> + </tt> + <tt> [line|bar|scatter]</tt><tt><br> + </tt> + <tt> [new]</tt><tt><br> + </tt> + <tt> [new + line|bar|scatter]</tt><tt><br> + </tt> <tt> + [new name <plotname>]</tt><tt><br> + </tt> + <tt> [new name <plotname> + line|bar|scatter]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># create new + plot with data from stdin</tt><tt><br> + </tt> <tt>plot</tt> <tt>[new + <title> <xaxis label> <yaxis label></tt> + <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[new [line|bar|scatter] + <title> <xaxis label> <yaxis label></tt> + <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[new</tt> <tt>name + <plotname></tt> <tt><title> <xaxis label> + <yaxis label></tt> + <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[new</tt> <tt>name + <plotname></tt> <tt>line|bar|scatter <title> + <xaxis + label> <yaxis label></tt> + <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt> <tt><br> + </tt> + <tt># create new plot with data from stdin which includes + title/dim + headers</tt><tt><br> + </tt> <tt>plot [new + stdin</tt><tt>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[new</tt> <tt>[line|bar|scatter]</tt> + <tt>stdin</tt><tt>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[new name <plotname> + stdin</tt><tt>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[new name <plotname></tt> <tt>line|bar|scatter</tt> + <tt>stdin</tt><tt>]</tt><tt><br> + </tt> <tt><br> + </tt> <tt>#</tt> + <tt>load data into existing plot from stdin</tt><tt><br> + </tt> + <tt>plot [[<plotname>] data + xy|xyex|xyey|xyexey]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># existing + plot</tt><tt><br> + </tt> <tt>plot</tt> <tt>[[<plotname>] load + <filename> xy|xyex|xyey|xyexey]</tt><tt><br> + </tt> + <tt> [[<plotname>] save + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] clear]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + duplicate + [#]]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] stats yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] list + yes|no]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] loadconfig + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] saveconfig <filename>]</tt><tt><br> + </tt> + <tt> [[<plotname>] pagesetup orient + portrait|landscape]</tt><tt><br> + </tt> <tt> + [[<plotname>] pagesetup size + letter|legal|tabloid|poster|a4]</tt><tt><br> + </tt> + <tt> [[<plotname>] + print]</tt><tt><br> + </tt> <tt> + [[<plotname>] print destination + printer|file]</tt><tt><br> + </tt> <tt> + [[<plotname>] print command + <command>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print filename + <filename>]</tt><tt><br> + </tt> <tt> + [[<plotname>] print color rgb|gray]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] + close</tt><tt>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> + </tt> + <tt><br> + </tt> <tt># configure graph</tt><tt><br> + </tt> <tt>plot + [[<plotname>] axis x|y grid yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y log + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y flip yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y auto + yes|no]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y min <value>]</tt><tt><br> + </tt> + <tt> [[<plotname>] axis x|y max + <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] axis x|y format + <string>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] legend yes|no]</tt><tt><br> + </tt> + <tt> [[<plotname>] legend position + right|left|top|bottom]</tt><tt><br> + </tt> <tt> + [[<plotname>] font title|labels|numbers font + times|helvetica|courier]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>size <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>weight normal|bold]</tt><tt><br> + </tt> <tt> + [[<plotname>] font</tt> <tt>title|labels|numbers</tt> + <tt>slant roman|italic]</tt><tt><br> + </tt> <tt> + [[<plotname>] title <string>]</tt><tt><br> + </tt> + <tt> [[<plotname>] title x|y + <string>]</tt><tt><br> + </tt> <tt> + [</tt><tt>[<plotname>] barmode + normal|stacked|aligned|overlap]</tt><tt><br> + </tt> <tt><br> + </tt> + <tt># configure current dataset</tt><tt><br> + </tt> <tt>plot + [[<plotname>] show yes|no]</tt><tt><br> + </tt> <tt> + </tt> <tt>[[<plotname>] shape + circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> + </tt> <tt> </tt> <tt>[[<plotname>] + shape fill yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] shape + color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] smooth + step|linear|cubic|quadratic|catrom]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] color + <value>]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] dash + yes|no]</tt><tt><br> + </tt> <tt> </tt> + <tt>[[<plotname>] error yes|no]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] error + color <value>]</tt><tt><br> + </tt> <tt> + [[<plotname>] color <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] error + width <value>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[[<plotname>] name + <string>]</tt><tt><br> + </tt> <tt><br> + </tt> <tt># select + current dataset</tt><tt><br> + </tt> <tt>plot [[<plotname>] + select <value>]</tt><tt><br> + </tt> + <tt> </tt><tt><br> + </tt> <tt>Example:</tt><tt><br> + </tt> <tt># + return all plotnames</tt><tt><br> + </tt> <tt>$xpaget ds9 + plot</tt><tt><br> + </tt> <tt><br> + </tt> <tt># create new empty plot + window</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot</tt><tt><br> + </tt> + <tt>$xpaset -p ds9 plot bar</tt><tt><br> + </tt> <tt>$xpaset -p ds9 + plot new</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot new + bar</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot new name + foo</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot new name foo + bar</tt><tt><br> + </tt> <tt><br> + </tt> <tt># create new plot with data + from stdin</tt><tt><br> + </tt> <tt>$cat xy.dat | xpaset ds9 plot new + {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt> <tt>$cat xy.dat + | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} + xy</tt><tt><br> + </tt> <tt>$cat xy.dat | xpaset ds9 plot new name foo + {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt> <tt>$cat xy.dat + | xpaset ds9 plot new name foo bar {The Title} {X Axis} {Y Axis} + xy</tt><tt><br> + </tt> <tt><br> + </tt> <tt># create new plot with data + from stdin which includes title/dim headers</tt><tt><br> + </tt> + <tt>$cat stdin.2.dat | xpaset ds9 plot new stdin</tt><tt><br> + </tt> + <tt>$cat stdin.2.dat | xpaset ds9 plot new line + stdin</tt><tt><br> + </tt> <tt>$cat stdin.2.dat | xpaset ds9 plot new + name foo stdin</tt><tt><br> + </tt> <tt>$cat stdin.2.dat | xpaset ds9 + plot new name foo line stdin</tt><tt><br> + </tt> <tt><br> + </tt> + <tt>#</tt> <tt>load data into existing plot from + stdin</tt><tt><br> + </tt> <tt>$cat xy.dat | xpaset ds9 plot data + xy</tt><tt><br> + </tt> <tt>$cat xy.dat | xpaset ds9 plot foo data + xy</tt><tt><br> + </tt> <tt><br> + </tt> <tt># existing + plot</tt><tt><br> + </tt> <tt>$xpaget ds9 plot stats</tt><tt><br> + </tt> + <tt>$xpaget ds9 plot list</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot + load xy.dat xy</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot save + foo.dat</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot + clear</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot duplicate + 1</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot stats + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot list + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot loadconfig + foo.plt</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot saveconfig + foo.plt</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot pagesetup orient + portrait</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot pagesetup size + letter</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot + print</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot print destination + file</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot print command + lp</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot print filename + foo.ps</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot print color + rgb</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot + close</tt><tt><br> + </tt> <tt>$xpaget ds9 plot mode</tt><tt><br> + </tt> + <tt>$xpaset -p ds9 plot mode pointer</tt><tt><br> + </tt> <tt><br> + </tt> <tt># configure plot</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + axis x grid</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + log</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + flip</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + auto</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + min</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + max</tt><tt><br> + </tt> <tt>$xpaget ds9 plot axis x + format</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x grid + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x log + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x flip + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x auto + no</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x min + 1</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x max + 100</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot axis x format + {%f}</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$xpaget ds9 plot + legend</tt><tt><br> + </tt> <tt>$xpaget ds9 plot legend + position</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot legend + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot legend position + left</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$xpaget ds9 plot font + numbers font</tt><tt><br> + </tt> <tt>$xpaget ds9 plot font numbers + size</tt><tt><br> + </tt> <tt>$xpaget ds9 plot font numbers + weight</tt><tt><br> + </tt> <tt>$xpaget ds9 plot font numbers + slant</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot font numbers font + times</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot font numbers size + 12</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot font numbers weight + bold</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot font numbers slant + italic</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$xpaget ds9 plot + title</tt><tt><br> + </tt> <tt>$xpaget ds9 plot title + xaxis</tt><tt><br> + </tt> <tt>$xpaget ds9 plot title + yaxis</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot title {This is a + Title}</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot title x {X + Axis}</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot title y {Y + Axis}</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot title legend {This + is the Legend}</tt><tt><br> + </tt> <tt><br> + </tt> <tt>$xpaget ds9 plot + barmode</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot barmode + aligned</tt><tt><br> + </tt> <tt><br> + </tt> <tt># configure current + dataset</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + show</tt><tt><br> + </tt> <tt>$xpaget ds9 plot shape</tt><tt><br> + </tt> + <tt>$xpaget ds9 plot shape fill</tt><tt><br> + </tt> <tt>$xpaget ds9 + plot shape color</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + smooth</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + color</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + width</tt><tt><br> + </tt> <tt>$xpaget ds9 plot dash</tt><tt><br> + </tt> + <tt>$xpaget ds9 plot error</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + error color</tt><tt><br> + </tt> <tt>$xpaget ds9 plot error + width</tt><tt><br> + </tt> <tt>$xpaget ds9 plot name</tt><tt><br> + </tt> + <tt>$xpaset -p ds9 plot show yes</tt><tt><br> + </tt> <tt>$xpaset -p + ds9 plot shape circle</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot + shape fill no</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot shape color + cyan</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot smooth + step</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot color + red</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot width + 2</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot dash + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot error + yes</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot error color + red</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot error width + 2</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot name {My + Data}</tt><tt><br> + </tt> <tt><br> + </tt> <tt># select current + dataset</tt><tt><br> + </tt> <tt>$xpaget ds9 plot + select</tt><tt><br> + </tt> <tt>$xpaset -p ds9 plot select 2</tt><br> + <p><b><a name="png" id="png"></a>png</b></p> + <p>Load PNG image into current frame.<br> + </p> + <tt>Syntax:<br> + png [new|slice] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 png > foo.png</tt><br> + <tt>$xpaset -p ds9 png foo.png</tt><br> + <tt><tt>$xpaset -p ds9 png new foo.png<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9 png slice foo.png<br> + </tt></tt> $cat + foo.png | xpaset ds9 png</tt> <tt><tt><tt># not available + windows</tt></tt></tt><br> + <tt><tt>$cat foo.png | xpaset ds9 png</tt> <tt>new</tt></tt> + <tt><tt><tt><tt># not available windows</tt></tt><br> + </tt> $cat + foo.png | xpaset ds9 png</tt> <tt>slice</tt> <tt><tt><tt># not + available windows<br> + </tt></tt></tt> + <p><b><a name="precision" id="precision"></a>precision</b></p> + <p>Set region and coordinate output format precision.</p> + <tt>Syntax:<br> + precision <linear></tt> <tt><tt><degree></tt></tt> + <tt><tt><hms></tt></tt> + <tt><tt><tt><dms></tt></tt></tt> + <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><arcsec><br> + <br> + </tt></tt></tt></tt> Example:<br> + $xpaget ds9 precision<br> + $xpaset -p ds9 precision 8 10 4 3 5 3</tt><br> + <p><b><a name="prefs" id="prefs"></a>prefs</b></p> + <p>Controls various preference settings.</p> + <tt>Syntax:<br> + prefs [clear]<br> + [irafalign yes|no]<br> + <br> + Example:<br> + $xpaget ds9 prefs irafalign<br> + $xpaset -p ds9 prefs clear<br> + $xpaset -p ds9 prefs iraf yes<br> + </tt> + <p><b><a name="preserve" id="preserve"></a>preserve</b></p> + <p>Preserve the follow attributes while loading a new image.</p> + <tt>Syntax:<br> + preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> + Example:<br> + $xpaget ds9 preserve pan<br> + $xpaget ds9 preserve regions<br> + $xpaset -p ds9 preserve pan yes<br> + $xpaset -p ds9 preserve regions yes<br> + </tt> + <p><b><a name="psprint" id="psprint"></a>psprint</b></p> + <p>Invokes postscript printing. Please see <a + href="command.html#print">print</a> for further details.</p> + <p><b><a name="print" id="print"></a>print</b></p> + <p>Controls printing. Use print option to set printing options. + Only available for <tt>XPA_METHOD local.</tt></p> + <tt>Syntax:<br> + print [destination printer|file]<br> + [command <command>]<br> + [filename <filename>]<br> + [color rgb|cmyk|gray]<br> + [level 1|2]<br> + [resolution + 53|72|75|150|300|600]<br> + <br> + Example:<br> + $xpaget ds9 print destination<br> + $xpaget ds9 print command<br> + $xpaget ds9 print filename<br> + $xpaget ds9 print color<br> + $xpaget ds9 print level<br> + $xpaget ds9 print resolution<br> + $xpaset -p ds9 print<br> + $xpaset -p ds9 print destination file<br> + $xpaset -p ds9 print command lp<br> + $xpaset -p ds9 print filename foo.ps<br> + $xpaset -p ds9 print color cmyk<br> + $xpaset -p ds9 print level 2<br> + $xpaset -p ds9 print resolution 75</tt> + <p><b><a name="raise" id="raise"></a>raise</b></p> + <p>Raise in the window stacking order.</p> + <tt>Syntax:<br> + raise<br> + <br> + Example:<br> + $xpaset -p ds9 raise</tt> + <p><b><a name="regions" id="regions"></a>regions</b></p> + <p>Controls regions in the current frame.</p> + <tt>Syntax:<br> + regions [<filename>]<br> + [load [all] + <filename>]<br> + [save + <filename>]<br> + [list [close]]<br> + [epsilon <integer>]<br> + [show yes|no]<br> + [showtext yes|no]<br> + [centroid]<br> + [centroid auto + yes|no]<br> + [centroid radius + <value>|iteration <value>]<br> + [getinfo]<br> + [move front]<br> + [move back]<br> + [select all]<br> + [select none]<br> + [select invert]<br> + [delete all]<br> + [delete select]<br> + [format + ds9|xml|ciao|saotng|saoimage|pros|xy]<br> + [system + image|physical|wcs|wcsa...wcsz]<br> + [sky + fk4|fk5|icrs|galactic|ecliptic]<br> + [skyformat + degrees|sexagesimal]<br> + [strip yes|no]<br> + [shape + <shape>]<br> + [color + &ltcolor>]<br> + [width + <width>]<br> + </tt> <tt> + [fixed|edit|rotate|delete yes|no]<br> + + [include|exclude|source|background]</tt><br> + <tt> [command <marker + command>]<br> + [composite]<br> + [dissolve]<br> + [template + <filename>]<br> + [template <filename> + at + <ra> <dec> <coordsys> <skyframe>]<br> + [savetemplate + <filename>]<br> + [groups]<br> + [group new]<br> + [group <tag> + new]<br> + [group <tag> + update]<br> + [group <tag> + select]<br> + [group <tag> color + &ltcolor>]<br> + [group <tag> copy]<br> + [group <tag> + delete]<br> + [group <tag> cut]<br> + [group <tag> font + <font>]<br> + [group <tag> move + <int> <int>]<br> + [group <tag> + movefront]<br> + [group <tag> + moveback]<br> + [group <tag> + property + <property> yes|no]<br> + [copy]<br> + [cut]<br> + [paste + image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + [-format + ds9|ciao|saotng|saoimage|pros|xy]<br> + [-system + image|physical|wcs|wcsa...wcsz]<br> + [-sky + fk4|fk5|icrs|galactic|ecliptic]<br> + [-skyformat + degrees|sexagesimal]<br> + [-delim + [nl|<char>]]<br> + [-prop + select|edit|move|rotate|delete|fixed|include|source 1|0]<br> + [-group <tag>]<br> + [-strip yes|no]<br> + [-wcs yes|no]<br> + <br> + Example:<br> + $xpaget ds9 regions<br> + $xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat + sexagesimal -prop edit 1 -group foo<br> + $xpaget ds9 regions epsilon<br> + $xpaget ds9 regions show<br> + $xpaget ds9 regions showtext<br> + $xpaget ds9 regions centroid auto<br> + $xpaget ds9 regions centroid radius<br> + $xpaget ds9 regions centroid iteration<br> + $xpaget ds9 regions selected<br> + $xpaget ds9 regions format<br> + $xpaget ds9 regions system<br> + $xpaget ds9 regions sky<br> + $xpaget ds9 regions skyformat<br> + $xpaget ds9 regions strip<br> + $xpaget ds9 regions shape<br> + $xpaget ds9 regions color<br> + $xpaget ds9 regions width<br> + $xpaget ds9 regions source<br> + $xpaget ds9 regions background<br> + $xpaget ds9 regions include<br> + $xpaget ds9 regions exclude<br> + $xpaget ds9 regions selected<br> + $xpaget ds9 regions groups<br> + $cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky + fk5<br> + $cat bar.reg | xpaset ds9 regions -format ds9<br> + $echo "image; circle 100 100 20" | xpaset ds9 regions<br> + $echo "image; circle 100 100 20" | xpaset ds9 regions<br> + $echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions<br> + $echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions<br> + $echo "box 100 100 20 40 25" | xpaset ds9 regions<br> + $echo "image; line 100 100 200 400" | xpaset ds9 regions<br> + $echo "physical; ruler 200 300 200 400" | xpaset ds9 regions<br> + $echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 + regions<br> + $echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 + regions<br> + $xpaset -p ds9 regions foo.reg<br> + $xpaset -p ds9 regions -format ciao bar.reg # load as ciao + format<br> + $xpaset -p ds9 regions foo.fits # FITS regions files do not need + a + format specification<br> + $xpaset -p ds9 regions load foo.reg # load foo.reg into current + frame<br> + $xpaset -p ds9 regions load all foo.reg # load foo.reg into all + frames<br> + $xpaset -p ds9 regions load '*.reg'# expand *.reg and load into + current frame<br> + $xpaset -p ds9 regions load all '*.reg' # expand *.reg and load + into all frames<br> + $xpaset -p ds9 regions save foo.reg<br> + $xpaset -p ds9 regions list<br> + $xpaset -p ds9 regions list close<br> + $xpaset -p ds9 regions epsilon 5<br> + $xpaset -p ds9 regions show yes<br> + $xpaset -p ds9 regions showtext no<br> + $xpaset -p ds9 regions centroid<br> + $xpaset -p ds9 regions centroid auto yes<br> + $xpaset -p ds9 regions centroid radius 10<br> + $xpaset -p ds9 regions centroid iteration 20<br> + $xpaset -p ds9 regions getinfo<br> + $xpaset -p ds9 regions move back<br> + $xpaset -p ds9 regions move front<br> + $xpaset -p ds9 regions select all<br> + $xpaset -p ds9 regions select none<br> + $xpaset -p ds9 regions select invert<br> + $xpaset -p ds9 regions delete all<br> + $xpaset -p ds9 regions delete select<br> + $xpaset -p ds9 regions format ds9<br> + $xpaset -p ds9 regions system wcs<br> + $xpaset -p ds9 regions sky fk5<br> + $xpaset -p ds9 regions skyformat degrees<br> + $xpaset -p ds9 regions strip yes<br> + $xpaset -p ds9 regions shape ellipse<br> + $xpaset -p ds9 regions color red<br> + $xpaset -p ds9 regions width 3<br> + $xpaset -p ds9 regions edit yes<br> + $xpaset -p ds9 regions include<br> + $xpaset -p ds9 regions command '{circle 100 100 20 # + color=red}'<br> + $xpaset -p ds9 regions composite<br> + $xpaset -p ds9 regions dissolve<br> + $xpaset -p ds9 regions template foo.tpl<br> + $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 + +47:12:48.02 + fk5<br> + $xpaset -p ds9 regions savetemplate foo.tpl<br> + $xpaset -p ds9 regions group new<br> + $xpaset -p ds9 regions group foo new<br> + </tt> <tt>$xpaset -p ds9 + regions group foo update</tt><br> + <tt>$xpaset -p ds9 regions group foo select</tt><br> + <tt>$xpaset -p ds9 regions group foo color red<br> + $xpaset -p ds9 regions group foo copy<br> + $xpaset -p ds9 regions group foo delete<br> + $xpaset -p ds9 regions group foo cut<br> + $xpaset -p ds9 regions group foo font {times 14 bold}<br> + $xpaset -p ds9 regions group foo move 100 100<br> + $xpaset -p ds9 regions group foo movefront<br> + $xpaset -p ds9 regions group foo moveback<br> + $xpaset -p ds9 regions group foo property delete no<br> + <br> + $xpaset -p ds9 regions copy<br> + $xpaset -p ds9 regions cut<br> + $xpaset -p ds9 regions paste wcs<br> + $xpaset -p ds9 regions undo<br> + </tt> + <p><b><a name="restore" id="restore"></a>restore</b></p> + <p>Restore DS9 to a previous state from a backup save set.</p> + <tt>Syntax:<br> + restore <filename><br> + <br> + Example:<br> + $xpaset -p ds9 restore ds9.bck</tt><br> + <p><b><a name="rgb" id="rgb"></a>rgb</b></p> + <p>Create RGB frame and control RGB frame parameters.</p> + <tt>Syntax:<br> + rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 rgb channel<br> + </tt> <tt>$xpaget ds9 rgb lock + wcs</tt><br> + <tt>$xpaget ds9 rgb lock crop</tt><br> + <tt>$xpaget ds9 rgb lock slice</tt><br> + <tt>$xpaget ds9 rgb lock bin<br> + $xpaget ds9 rgb lock scale<br> + $xpaset ds9 rgb lock scalelimits<br> + $xpaget ds9 rgb lock colorbar<br> + $xpaget ds9 rgb lock block<br> + $xpaget ds9 rgb lock smooth<br> + $xpaget ds9 rgb system<br> + $xpaget ds9 rgb view red<br> + $xpaget ds9 rgb view green<br> + $xpaget ds9 rgb view blue<br> + $xpaset -p ds9 rgb # create new rgb frame<br> + $xpaset -p ds9 rgb red # set current channel to red<br> + $xpaset -p ds9 rgb channel red # set current channel to red<br> + $xpaset -p ds9 rgb view blue no # turn off blue channel<br> + $xpaset -p ds9 rgb system wcs # set rgb coordinate system<br> + </tt> + <tt>$xpaset -p ds9 rgb lock wcs yes</tt><br> + <tt>$xpaset -p ds9 rgb lock crop yes</tt><br> + <tt>$xpaset -p ds9 rgb lock slice yes</tt><br> + <tt>$xpaset -p ds9 rgb lock bin yes</tt><br> + <tt>$xpaset -p ds9 rgb lock scale yes<br> + $xpaset -p ds9 rgb lock scalelimits yes<br> + $xpaset -p ds9 rgb lock colorbar yes<br> + $xpaset -p ds9 rgb lock block yes<br> + $xpaset -p ds9 rgb lock smooth yes<br> + $xpaset -p ds9 rgb open<br> + $xpaset -p ds9 rgb close</tt><br> + <p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> + <p>Load raw data array cube into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbarray [native|big|little]<br> + rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> - - <br> -Example:<br> -$xpaget ds9 rgbarray > foo.arr<br> -$xpaget ds9 rgbarray little > foo.arr<br> -$xpaset -p ds9 rgbarray -foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> -$xpaset -p ds9 rgbarray new -foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> -<tt>$cat foo.arr | xpaset ds9 rgbarray -[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> -<tt>$cat foo.arr | xpaset ds9 rgbarray new -[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> -<p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> -<p>Load FITS rgbcube into rgb frame.<br></p> -<tt>Syntax:<br> -rgbcube [new] [<filename>]<br> -<br> -Example:<br> -$xpaget ds9 rgbcube > foo.fits<br> -$xpaset -p ds9 rgbcube foo.fits</tt><br> -<tt><tt>$xpaset -p ds9 rgbcube new foo.fits<br></tt> $cat foo.fits -| xpaset ds9 rgbcube</tt><br> -<tt>$cat foo.fits | xpaset ds9 rgbcube</tt> <tt>new</tt><br> -<p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> -<p>Load FITS rgbimage into rgb frame.<br></p> -<tt>Syntax:<br> -rgbimage [new] [<filename>]<br> - <br> -Example:<br> -$xpaget ds9 rgbimage > foo.fits<br> -$xpaset -p ds9 rgbimage foo.fits</tt><br> -<tt><tt>$xpaset -p ds9 rgbimage new foo.fits<br></tt> $cat foo.fits -| xpaset ds9 rgbimage</tt><br> -<tt>$cat foo.fits | xpaset ds9 rgbimage</tt> <tt>new<br></tt> -<p><b><a name="rotate" id="rotate"></a>rotate</b></p> -<p>Controls the rotation angle (in degrees) of the current -frame.</p> -<tt>Syntax:<br> -rotate [<value>]<br> - [to <value>]<br> - [open|close]<br> -<br> -Example:<br> -$xpaget ds9 rotate<br> -$xpaset -p ds9 rotate 45<br> -$xpaset -p ds9 rotate to 30<br> -$xpaset -p ds9 rotate open<br> -$xpaset -p ds9 rotate close<br></tt> -<p><b><a name="save" id="save"></a>save<br></b></p> -<p>Save loaded image data of current frame as FITS.</p> -<tt>Syntax:<br> -save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] -<filename> [image|table|slice]</tt><br> -<tt> <br> -Example:<br> -$xpaset -p ds9 save foo.fits</tt><br> -<tt>$xpaset -p ds9 save fits foo.fits image</tt><br> -<tt>$xpaset -p ds9 save fits foo.fits table<br> -$xpaset -p ds9 save fits foo.fits slice</tt><br> -<tt>$xpaset -p ds9 save rgbimage foo.fits<br></tt> <tt>$xpaset -p -ds9 save rgbcube foo.fits</tt><br> -<tt>$xpaset -p ds9 save mecube foo.fits</tt><br> -<tt>$xpaset -p ds9 save mosaic foo.fits</tt><br> -<tt>$xpaset -p ds9 save mosaicimage foo.fits</tt><br> -<p><b><a name="saveimage" id="saveimage"></a>saveimage<br></b></p> -<p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> -compression method.</p> -<tt>Syntax:<br> -saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> -<tt><filename><br> -saveimage <filename>.jpeg [1-100]<br> -saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> - <br> -Example:<br> -$xpaset -p ds9 saveimage ds9.tiff<br> -$xpaset -p ds9 saveimage jpeg ds9.jpeg 75</tt><br> -<p><b><a name="scale" id="scale"></a>scale</b></p> -<p>Controls the limits and color scale distribution.</p> -<tt>Syntax:<br> -scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [datasec yes|no]<br> - [limits <minvalue> -<maxvalue>]<br> - [mode -minmax|<value>|zscale|zmax]<br> - [scope local|global]<br> - [match]<br> - [match limits]<br> - [lock [yes|no]]<br> - [lock limits [yes|no]]<br> - [open|close]<br> -<br> -Example:<br> -$xpaget ds9 scale<br> -$xpaget ds9 scale log exp<br> -$xpaget ds9 scale datasec<br> -$xpaget ds9 scale limits<br> -$xpaget ds9 scale mode<br> -$xpaget ds9 scale scope<br> -$xpaget ds9 scale lock<br> -$xpaget ds9 scale lock limits<br> -$xpaset -p ds9 scale linear<br> -$xpaset -p ds9 scale log exp 100<br> -$xpaset -p ds9 scale datasec yes<br> -$xpaset -p ds9 scale histequ<br> -$xpaset -p ds9 scale limits 1 100<br> -$xpaset -p ds9 scale mode zscale<br> -$xpaset -p ds9 scale mode 99.5<br> -$xpaset -p ds9 scale scope local<br> -$xpaset -p ds9 scale match<br> -$xpaset -p ds9 scale match limits<br> -$xpaset -p ds9 scale lock yes<br> -$xpaset -p ds9 scale lock limits yes<br> -$xpaset -p ds9 scale open<br> -$xpaset -p ds9 scale close<br></tt> -<p><b><a name="shm" id="shm"></a>shm</b></p> -<p>Load a shared memory segment into the current frame.</p> -<tt>Syntax:<br> -shm [<key> [<filename>]]<br> - [key <key> [<filename>]]<br> - [shmid <id> [<filename>]]<br> - [fits [key|shmid] <id> -[<filename>]]<br> - [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] -[key|shmid] <id> [<filename>]]<br> - [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] -<id> [<filename>]]<br> - [rgbcube [key|shmid] <id> -[<filename>]<br> - [rgbimage [key|shmid] <id> -[<filename>]]<br> - [rgbarray [key|shmid] <id> + <br> + Example:<br> + $xpaget ds9 rgbarray > foo.arr<br> + $xpaget ds9 rgbarray little > foo.arr<br> + $xpaset -p ds9 rgbarray + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> + $xpaset -p ds9 rgbarray new + foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt>$cat foo.arr | xpaset ds9 rgbarray + [dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> + <tt>$cat foo.arr | xpaset ds9 rgbarray new + [dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> + <p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> + <p>Load FITS rgbcube into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbcube [new] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 rgbcube > foo.fits<br> + $xpaset -p ds9 rgbcube foo.fits</tt><br> + <tt><tt>$xpaset -p ds9 rgbcube new foo.fits<br> + </tt> $cat foo.fits + | xpaset ds9 rgbcube</tt><br> + <tt>$cat foo.fits | xpaset ds9 rgbcube</tt> <tt>new</tt><br> + <p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> + <p>Load FITS rgbimage into rgb frame.<br> + </p> + <tt>Syntax:<br> + rgbimage [new] [<filename>]<br> + <br> + Example:<br> + $xpaget ds9 rgbimage > foo.fits<br> + $xpaset -p ds9 rgbimage foo.fits</tt><br> + <tt><tt>$xpaset -p ds9 rgbimage new foo.fits<br> + </tt> $cat foo.fits + | xpaset ds9 rgbimage</tt><br> + <tt>$cat foo.fits | xpaset ds9 rgbimage</tt> <tt>new<br> + </tt> + <p><b><a name="rotate" id="rotate"></a>rotate</b></p> + <p>Controls the rotation angle (in degrees) of the current + frame.</p> + <tt>Syntax:<br> + rotate [<value>]<br> + [to <value>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 rotate<br> + $xpaset -p ds9 rotate 45<br> + $xpaset -p ds9 rotate to 30<br> + $xpaset -p ds9 rotate open<br> + $xpaset -p ds9 rotate close<br> + </tt> + <p><b><a name="save" id="save"></a>save<br> + </b></p> + <p>Save loaded image data of current frame as FITS.</p> + <tt>Syntax:<br> + save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice]</tt><br> + <tt> <br> + Example:<br> + $xpaset -p ds9 save foo.fits</tt><br> + <tt>$xpaset -p ds9 save fits foo.fits image</tt><br> + <tt>$xpaset -p ds9 save fits foo.fits table<br> + $xpaset -p ds9 save fits foo.fits slice</tt><br> + <tt>$xpaset -p ds9 save rgbimage foo.fits<br> + </tt> <tt>$xpaset -p + ds9 save rgbcube foo.fits</tt><br> + <tt>$xpaset -p ds9 save mecube foo.fits</tt><br> + <tt>$xpaset -p ds9 save mosaic foo.fits</tt><br> + <tt>$xpaset -p ds9 save mosaicimage foo.fits</tt><br> + <p><b><a name="saveimage" id="saveimage"></a>saveimage<br> + </b></p> + <p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> + compression method.</p> + <tt>Syntax:<br> + saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> + <tt><filename><br> + saveimage <filename>.jpeg [1-100]<br> + saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + $xpaset -p ds9 saveimage ds9.tiff<br> + $xpaset -p ds9 saveimage jpeg ds9.jpeg 75</tt><br> + <p><b><a name="scale" id="scale"></a>scale</b></p> + <p>Controls the limits and color scale distribution.</p> + <tt>Syntax:<br> + scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [datasec yes|no]<br> + [limits <minvalue> + <maxvalue>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 scale<br> + $xpaget ds9 scale log exp<br> + $xpaget ds9 scale datasec<br> + $xpaget ds9 scale limits<br> + $xpaget ds9 scale mode<br> + $xpaget ds9 scale scope<br> + $xpaget ds9 scale lock<br> + $xpaget ds9 scale lock limits<br> + $xpaset -p ds9 scale linear<br> + $xpaset -p ds9 scale log exp 100<br> + $xpaset -p ds9 scale datasec yes<br> + $xpaset -p ds9 scale histequ<br> + $xpaset -p ds9 scale limits 1 100<br> + $xpaset -p ds9 scale mode zscale<br> + $xpaset -p ds9 scale mode 99.5<br> + $xpaset -p ds9 scale scope local<br> + $xpaset -p ds9 scale match<br> + $xpaset -p ds9 scale match limits<br> + $xpaset -p ds9 scale lock yes<br> + $xpaset -p ds9 scale lock limits yes<br> + $xpaset -p ds9 scale open<br> + $xpaset -p ds9 scale close<br> + </tt> + <p><b><a name="shm" id="shm"></a>shm</b></p> + <p>Load a shared memory segment into the current frame.</p> + <tt>Syntax:<br> + shm [<key> [<filename>]]<br> + [key <key> [<filename>]]<br> + [shmid <id> [<filename>]]<br> + [fits [key|shmid] <id> + [<filename>]]<br> + [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] + [key|shmid] <id> [<filename>]]<br> + [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] + <id> [<filename>]]<br> + [rgbcube [key|shmid] <id> + [<filename>]<br> + [rgbimage [key|shmid] <id> + [<filename>]]<br> + [rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> - - [array [key|shmid] <id> + [array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - - <br> -Example:<br> -$xpaget ds9 shm<br> -$xpaset -p ds9 shm 102<br> -$xpaset -p ds9 shm key 102<br> -$xpaset -p ds9 shm shmid 102 foo<br> -$xpaset -p ds9 shm fits key 100 foo<br> -$xpaset -p ds9 shm mosaicimage iraf key 100 foo<br> -$xpaset -p ds9 shm mosaicimage wcs key 100 foo<br> -$xpaset -p ds9 shm mosaicimage wcsa key 100 foo<br> -$xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo<br> -$xpaset -p ds9 shm mosaic iraf key 100 foo<br> -$xpaset -p ds9 shm mosaic wcs key 100 foo<br> -$xpaset -p ds9 shm rgbcube key 100 foo<br> -$xpaset -p ds9 shm rgbimage key 100 foo<br> -$xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> -$xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32]<br> -<br></tt> <b><a name="sia" id="sia"></a>sia<br></b> -<p>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.</p> -<tt>Syntax:<br> -sia -[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]<br> - -<br></tt> <tt> </tt><tt> [<ref>] -[cancel]<br></tt> <tt> [<ref>] -[clear]<br></tt> <tt> [<ref>] -[close]</tt><br> -<tt> [<ref>] [coordinate <ra> -<dec> <coordsys>]</tt><tt><br></tt> -<tt> </tt> <tt>[<ref>] [crosshair]</tt><br> -<tt> [<ref>] [export sb|tsv -<filename>]<br></tt> <tt> [<ref>] -[name <object>]<br></tt> <tt> [<ref>] -[print]</tt><br> -<tt> [<ref>] [retrieve]</tt><br> -<tt> [<ref>] [save -<filename>]</tt><br> -<tt> [<ref>] [radius <value> -degrees|arcmin|arcsec]</tt><br> -<tt> [<ref>] [sky -<skyframe>]<br></tt> <tt> [<ref>] -[skyformat <skyformat>]<br></tt> <tt> -[<ref>] [system <coordsys>]</tt><tt><br></tt> -<tt> </tt> <tt>[<ref>] [update]</tt><br> - <tt><br> -Example:<br> -$xpaget ds9 sia<br></tt> <tt><br> -$xpaset -p ds9 sia 2mass<br></tt> <tt>$xpaset -p ds9 sia -cancel<br></tt> <tt>$xpaset -p ds9 sia clear<br></tt> <tt>$xpaset --p ds9 sia close<br></tt> <tt>$xpaset -p ds9 sia coordinate 202.48 -47.21 fk5<br></tt> <tt>$xpaset -p ds9 sia crosshair<br></tt> -<tt>$xpaset -p ds9 sia export tsv bar.tsv<br></tt> <tt>$xpaset -p -ds9 sia name m51<br></tt> <tt>$xpaset -p ds9 sia print</tt><br> -<tt>$xpaset -p ds9 sia retrieve<br> -$xpaset -p ds9 sia save foo.xml<br></tt> <tt>$xpaset -p ds9 sia -radius 1 degrees</tt><br> -<tt>$xpaset -p ds9 sia sky fk5<br> -$xpaset -p ds9 sia skyformat degrees<br></tt> <tt>$xpaset -p ds9 -sia system wcs</tt><tt><br></tt> <tt>$xpaset -p ds9 sia update<br> -<br></tt> <b><a name="single" id="single"></a>single</b> -<p>Select Single Display mode</p> -<tt>Syntax:<br> -single<br> - <br> -Example:<br> -$xpaget ds9 single<br> -$xpaset -p ds9 single<br></tt> -<p><b><a name="skyview" id="skyview"></a>skyview</b></p> -<p>Support for SkyView image server at HEASARC.</p> -<tt>Syntax:<br> -skyview []<br> - [<object>]<br> - [name -<object>|clear]<br> - [<ra> <dec>] -# in wcs fk5<br> - [size <width> -<height> degrees|arcmin|arcsec]<br> - [pixels <width> -<height>]<br> - [save yes|no]<br> - [frame new|current]<br> - [update -frame|crosshair]<br> - [survey <survey>]<br> - [open|close]<br> -<br> -Example:<br> -$xpaget ds9 skyview name<br> -$xpaget ds9 skyview coord<br> -$xpaget ds9 skyview size<br> -$xpaget ds9 skyview pixels<br> -$xpaget ds9 skyview save<br> -$xpaget ds9 skyview frame<br> -$xpaget ds9 skyview survey<br> -$xpaset -p ds9 skyview<br> -$xpaset -p ds9 skyview m31<br></tt> <tt><tt>$xpaset -p ds9 skyview -name m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 skyview name -clear<br></tt></tt> $xpaset -p ds9 skyview 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 skyview size 60 60 arcmin<br> -$xpaset -p ds9 skyview pixels 600 600<br> -$xpaset -p ds9 skyview save yes<br> -$xpaset -p ds9 skyview frame current<br> -$xpaset -p ds9 skyview update frame<br> -$xpaset -p ds9 skyview survey sdssi<br> -$xpaset -p ds9 skyview open<br></tt> <tt>$xpaset -p ds9 skyview -close</tt><br> -<p><b><a name="sleep" id="sleep"></a>sleep</b></p> -<p>Delays execution for specified number of seconds. Default is 1 -second.<br></p> -<tt>Syntax:<br> -sleep [#]<br> - <br> -Example:<br> -$xpaset -p ds9 sleep<br> -$xpaset -p ds9 sleep 2<br></tt> -<p><b><a name="smooth" id="smooth"></a>smooth</b></p> -<p>Smooth current image or set smooth parameters.<br> -Boxcar width = <i>2*radius+1</i><br> -Tophat diameter = <i>2*radius+1</i><br> -Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> -Elliptical Gaussian diameter = <i>2*radius+1,</i> mean -<i>=0<br></i> <br> -<tt>Syntax:</tt><br></p> -<tt>smooth []<br> - [yes|no]<br> - [function -boxcar|tophat|gaussian]<br></tt> -<tt> [radius -<value>]<br></tt> -<tt><tt><tt><tt> [radiusminor -<value>]<br></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> [sigma -<value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt> -[sigmaminor <value>]<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt> -[angle <value>]<br></tt></tt></tt></tt></tt></tt></tt></tt> -<tt> [match]<br> - [lock [yes|no]]</tt><br> -<tt><tt> [open|close]<br> -<br></tt> Example:<br> -$xpaget ds9 smooth<br> -$xpaget ds9 smooth function<br></tt> <tt><tt>$xpaget ds9 smooth -radius<br></tt></tt> <tt><tt>$xpaget ds9 smooth -radiusminor<br></tt></tt> <tt><tt><tt><tt><tt><tt>$xpaget ds9 -smooth sigma<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaget ds9 smooth -sigmaminor<br></tt></tt></tt></tt></tt></tt></tt></tt> $xpaget ds9 -smooth lock<br> -$xpaset -p ds9 smooth<br> -$xpaset -p ds9 smooth yes<br> -$xpaset -p ds9 smooth function tophat<br></tt> <tt><tt>$xpaset -p -ds9 smooth radius 4<br></tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset --p ds9 smooth radiusminor 4<br></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth sigma -2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth -sigmaminor 2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> -<tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 -smooth angle -45<br></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> -$xpaset -p ds9 smooth match<br> -$xpaset -p ds9 smooth lock yes</tt><br> -<tt>$xpaset -p ds9 smooth open<br> -$xpaset -p ds9 smooth close<br></tt> -<p><b><a name="source" id="source"></a>source</b></p> -<p>Source TCL code from a file. Only available for <tt>XPA_METHOD -local.</tt></p> -<tt>Syntax:<br> -source [<filename>]<br> - <br> -Example:<br> -$xpaset -p ds9 source foo.tcl</tt> -<p><b><a name="tcl" id="tcl"></a>tcl</b></p> -<p>Execute one tcl command. Only available for <tt>XPA_METHOD -local.</tt></p> -<tt>Syntax:<br> -tcl [<tcl command>]<br> - <br> -Example:<br> -$echo 'puts "Hello, World"' | xpaset ds9 tcl<br> -$xpaset -p ds9 tcl {puts {Hello, World}}</tt><tt><br></tt> -<p><b><a name="threads" id="threads"></a>threads</b></p> -<p>Set number of process threads for functions which are -multi-threaded.<br></p> -<tt>Syntax:<br> -threads #<br> - <br> -Example:<br> -$xpaget ds9 threads<br> -$xpaset -p ds9 threads 8</tt><br> -<p><b><a name="tiff" id="tiff"></a>tiff</b></p> -<p>Load TIFF image into current frame. Optional parameters: -<tt>tiff</tt> compression method.</p> -<tt>Syntax:<br> -tiff [new|slice] [<filename>] -[none|jpeg|packbits|deflate]<br> - <br> -Example:<br> -$xpaget ds9 tiff > foo.tiff</tt><br> -<tt><tt>$xpaget ds9 tiff jpeg > foo.tiff</tt><br> -$xpaset -p ds9 tiff foo.tiff</tt><br> -<tt><tt>$xpaset -p ds9 tiff new foo.tiff<br></tt></tt> -<tt><tt><tt>$xpaset -p ds9 tiff slice foo.tiff<br></tt></tt> $cat -foo.tiff | xpaset ds9 tiff</tt> <tt><tt><tt># not available -windows</tt></tt></tt><br> -<tt><tt>$cat foo.tiff | xpaset ds9 tiff</tt> <tt>new</tt></tt> -<tt><tt><tt><tt># not available windows</tt></tt><br></tt> $cat -foo.tiff | xpaset ds9 tiff</tt> <tt>slice</tt> <tt><tt><tt># not -available windows</tt></tt></tt> -<p><b><a name="tile" id="tile"></a>tile</b></p> -<p>Controls the tile display mode.</p> -<tt>Syntax:<br> -tile []<br> - [yes|no]<br> - [mode grid|column|row]<br> - [grid]<br> - [grid mode automatic|manual]<br> - [grid direction x|y]<br> - [grid layout <col> <row>]<br> - [grid gap <pixels>]<br> - [row]<br> - [column]<br> - <br> -Example:<br> -$xpaget ds9 tile<br> -$xpaget ds9 tile mode<br> -$xpaget ds9 tile grid mode<br> -$xpaget ds9 tile grid direction<br> -$xpaget ds9 tile grid layout<br> -$xpaget ds9 tile grid gap<br> -$xpaset -p ds9 tile<br> -$xpaset -p ds9 tile yes<br> -$xpaset -p ds9 tile mode row<br> -$xpaset -p ds9 tile grid<br> -$xpaset -p ds9 tile grid mode manual<br> -$xpaset -p ds9 tile grid direction x<br> -$xpaset -p ds9 tile grid layout 5 5<br> -$xpaset -p ds9 tile grid gap 10<br> -$xpaset -p ds9 tile row<br> -$xpaset -p ds9 tile column</tt> -<p><b><a name="update" id="update"></a>update</b></p> -<p>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.</p> -<tt>Syntax:<br> -update []<br> - [# x1 y1 x2 y2]<br> - [now]<br> - [now # x1 y1 x2 y2]<br> - <br> -Example:<br> -$xpaset -p ds9 update<br> -$xpaset -p ds9 update 1 100 100 300 400<br> -$xpaset -p ds9 update now<br> -$xpaset -p ds9 update now 1 100 100 300 400</tt><br> -<p><b><a name="url" id="url"></a>url</b></p> -<p>Load FITS from URL into the current frame</p> -<tt>Syntax:<br> -url <url><br> - <br> -Example:<br> -$xpaset -p ds9 url http://foo.bar.edu/foo.fits<br></tt> -<p><b><a name="version" id="version"></a>version</b></p> -<p>Returns the current version of DS9.</p> -<tt>Syntax:<br> -version<br> - <br> -Example:<br> -$xpaget ds9 version</tt> -<p><b><a name="view" id="view"></a>view</b></p> -<p>Controls the GUI.</p> -<tt>Syntax:<br> -view [layout horizontal|vertical]<br> - [keyvalue <string>]<br> - [info yes|no]<br> - [panner yes|no]<br> - [magnifier yes|no]<br> - [buttons yes|no]<br> - [colorbar yes|no]<br> - [colorbar horizontal|vertical]<br> - [colorbar numerics yes|no]<br> - [graph horizontal|vertical -yes|no]<br> - [filename yes|no[<br> - [object yes|no]<br> - [keyword yes|no]<br> - [minmax yes|no]<br> - [lowhigh yes|no]<br> - [units yes|no]<br> - [image|physical|wcs|wcsa...wcsz -yes|no]<br></tt> <tt><tt><tt> [frame -yes|no]<br></tt></tt> [red yes|no]<br> - [green yes|no]<br> - [blue yes|no]</tt><br> -<tt><tt> </tt><br> -Example:<br> -$xpaget ds9 view layout<br> -$xpaget ds9 view keyvalue<br> -$xpaget ds9 view info<br> -$xpaget ds9 view panner<br> -$xpaget ds9 view magnifier<br> -$xpaget ds9 view buttons<br> -$xpaget ds9 view colorbar<br> -$xpaget ds9 view graph horizontal<br> -$xpaget ds9 view filename<br> -$xpaget ds9 view object<br> -$xpaget ds9 view keyword<br> -$xpaget ds9 view minmax<br> -$xpaget ds9 view lowhigh<br> -$xpaget ds9 view units<br> -$xpaget ds9 view image<br> -$xpaget ds9 view wcsa</tt><br> -<tt>$xpaget ds9 view red<br></tt> <tt><tt><tt>$xpaget ds9 view -frame<br></tt></tt> $xpaset -p ds9 view layout vertical<br> -$xpaset -p ds9 view keyvalue BITPIX<br> -$xpaset -p ds9 view info yes<br> -$xpaset -p ds9 view panner yes<br> -$xpaset -p ds9 view magnifier yes<br> -$xpaset -p ds9 view buttons yes<br> -$xpaset -p ds9 view colorbar yes<br> -$xpaset -p ds9 view graph horizontal yes<br> -$xpaset -p ds9 view filename yes<br> -$xpaset -p ds9 view object yes<br> -$xpaset -p ds9 view keyword yes<br> -$xpaset -p ds9 view minmax yes<br> -$xpaset -p ds9 view lowhigh yes<br> -$xpaset -p ds9 view units yes<br> -$xpaset -p ds9 view wcsa yes<br></tt> <tt><tt>$xpaset -p ds9 view -frame yes</tt></tt><br> -<tt>$xpaset -p ds9 view red yes<br> -$xpaset -p ds9 view green yes<br> -$xpaset -p ds9 view blue yes</tt><br> -<br> -<b><a name="vla" id="vla"></a>vla</b> -<p>Support for VLA Sky Survey.</p> -<tt>Syntax:<br> -vla []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs -fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey first|stripe82]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 vla name<br> -$xpaget ds9 vla coord<br> -$xpaget ds9 vla size<br> -$xpaget ds9 vla save<br> -$xpaget ds9 vla frame<br> -$xpaget ds9 vla survey<br> -$xpaset -p ds9 vla<br> -$xpaset -p ds9 vla m31<br></tt> <tt><tt>$xpaset -p ds9 vla name -m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 vla name -clear<br></tt></tt> $xpaset -p ds9 vla 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 vla size 60 60 arcmin<br> -$xpaset -p ds9 vla save yes<br> -$xpaset -p ds9 vla frame current<br> -$xpaset -p ds9 vla update frame<br> -$xpaset -p ds9 vla survey stripe82<br> -$xpaset -p ds9 vla open<br></tt> <tt>$xpaset -p ds9 vla -close<br></tt> -<p><b><a name="vlss" id="vlss"></a>vlss</b></p> -<p>Support for NRAO VLSS Sky Survey.</p> -<tt>Syntax:<br> -vlss []<br> - [<object>]<br> - [name <object>]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> -degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 vlss name<br> -$xpaget ds9 vlss coord<br> -$xpaget ds9 vlss size<br> -$xpaget ds9 vlss save<br> -$xpaget ds9 vlss frame<br> -$xpaset -p ds9 vlss<br> -$xpaset -p ds9 vlss m31<br></tt> <tt><tt>$xpaset -p ds9 vlss name -m31<br></tt></tt> <tt><tt><tt>$xpaset -p ds9 vlss name -clear<br></tt></tt> $xpaset -p ds9 vlss 00:42:44.404 -+41:16:08.78<br> -$xpaset -p ds9 vlss size 60 60 arcmin<br> -$xpaset -p ds9 vlss save yes<br> -$xpaset -p ds9 vlss frame current<br> -$xpaset -p ds9 vlss update frame<br> -$xpaset -p ds9 vlss open<br></tt> <tt>$xpaset -p ds9 vlss -close</tt><br> -<br> -<p><b><a name="vo" id="vo"></a>vo</b></p> -<p>Invoke an connection to a Virtual Observatory site.</p> -<tt>Syntax:<br> -vo [method xpa|mime]<br> - [server <url>]<br> - [internal yes|no]<br> - [delay #]<br> - [<url>]<br> - [connect <url>]<br> - [disconnect <url>]<br> - [open|close]<br> -<br> -Example:<br> -$xpaget ds9 vo<br> -$xpaget ds9 vo method<br> -$xpaget ds9 vo server<br> -$xpaget ds9 vo internal<br> -$xpaget ds9 vo delay<br> -$xpaget ds9 vo connect<br> -$xpaset -p ds9 vo method xpa<br> -$xpaset -p ds9 vo server http://foo.bar.edu/list.txt<br> -$xpaset -p ds9 vo internal yes<br> -$xpaset -p ds9 vo delay 15 # keep-alive delay<br> -$xpaset -p ds9 vo chandra-ed<br> -$xpaset -p ds9 vo connect chandra-ed<br> -$xpaset -p ds9 vo disconnect chandra-ed<br> -$xpaset -p ds9 vo open<br> -$xpaset -p ds9 vo close<br></tt> -<p><b><a name="wcs" id="wcs"></a>wcs</b></p> -<p>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 <a href="file.html#WCS">WCS</a> for more -information.</p> -<tt>Syntax:<br> -wcs [[system] wcs|wcsa...wcsz]<br> - [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> - [[skyformat] degrees|sexagesimal]<br> - [align yes|no]<br> - [reset [#]]<br> - [replace [#] <filename>]<br> - [append [#] <filename>]<br> - [open|close]<br> -<br> -Example:<br> -$xpaget ds9 wcs<br> -$xpaget ds9 wcs system<br> -$xpaget ds9 wcs sky<br> -$xpaget ds9 wcs skyformat<br> -$xpaget ds9 wcs align<br> -$xpaset -p ds9 wcs wcs<br> -$xpaset -p ds9 wcs system wcs<br> -$xpaset -p ds9 wcs fk5<br></tt> <tt>$xpaset -p ds9 wcs sky -fk5<br></tt> <tt>$xpaset -p ds9 wcs sexagesimal<br></tt> -<tt>$xpaset -p ds9 wcs skyformat sexagesimal<br> -$xpaset -p ds9 wcs align yes<br> -$xpaset -p ds9 wcs reset<br> -$xpaset -p ds9 wcs reset 3<br> -$xpaset -p ds9 wcs replace foo.wcs<br> -$xpaset -p ds9 wcs replace 3 foo.wcs<br> -$xpaset -p ds9 wcs append foo.wcs<br> -$xpaset -p ds9 wcs append 3 foo.wcs<br> -$cat foo.wcs | xpaset ds9 wcs replace<br> -$cat foo.wcs | xpaset ds9 wcs append<br> -$echo "OBJECT = 'foobar'" | xpaset ds9 wcs append<br> -$xpaset -p ds9 open<br> -$xpaset -p ds9 close<br></tt> -<p><b><a name="web" id="web"></a>web</b></p> -<p>Display specified URL in the web display.</p> -<tt>Syntax:<br> -web []<br> - [<url>]<br> - [new <webname> <url>]<br> - [<webname>] [click -back|forward|stop|reload|#]<br> - [<webname>] [clear]<br> - [<webname>] [close]<br> - <br> -Example:<br> -$xpaget ds9 web<br> -$xpaset -p ds9 web www.cnn.com<br> -$xpaset -p ds9 web new www.cnn.com<br> -$xpaset -p ds9 web hvweb www.apple.com<br> -$xpaset -p ds9 web click back<br> -$xpaset -p ds9 web click 2<br> -$xpaset -p ds9 web clear<br> -$xpaset -p ds9 web close<br></tt> -<p><b><a name="width" id="width"></a>width</b></p> -<p>Set the width of the image display window.</p> -<tt>Syntax:<br> -width [<value>]<br> - <br> -Example:<br> -$xpaget ds9 width<br> -$xpaset -p ds9 width 512</tt><br> -<p><b><a name="xpa" id="xpa"></a>xpa</b></p> -<p>Configure XPA.</p> -<tt>Syntax:<br> --xpa [disconnect]<br> - [info]<br> - <br> -Example:<br> -$xpaget ds9 info<br> -$xpaset -p ds9 disconnect<br> -$xpaset -p ds9 info<br></tt> -<p><b><a name="zscale" id="zscale"></a>zscale</b></p> -<p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> -<tt>Syntax:<br> -zscale []<br> - [contrast]<br> - [sample]<br> - [line]<br> - <br> -Example:<br> -$xpaget ds9 zscale contrast<br> -$xpaget ds9 zscale sample<br> -$xpaget ds9 zscale line<br> -$xpaset -p ds9 zscale<br> -$xpaset -p ds9 zscale contrast .25<br> -$xpaset -p ds9 zscale sample 600<br> -$xpaset -p ds9 zscale line 120<br></tt> -<p><b><a name="zoom" id="zoom"></a>zoom</b></p> -<p>Controls the current zoom value for the current frame.</p> -<tt>Syntax:<br> -zoom [<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br> - [to fit]<br> - [open|close]<br> - <br> -Example:<br> -$xpaget ds9 zoom<br> -$xpaset -p ds9 zoom 2<br> -$xpaset -p ds9 zoom 2 4<br> -$xpaset -p ds9 zoom to 4<br> -$xpaset -p ds9 zoom to 2 4<br> -$xpaset -p ds9 zoom in<br> -$xpaset -p ds9 zoom out<br> -<$xpaset -p ds9 zoom to fit<br> -$xpaset -p ds9 zoom open<br> -$xpaset -p ds9 zoom close<br></tt></blockquote> -</body> + <br> + Example:<br> + $xpaget ds9 shm<br> + $xpaset -p ds9 shm 102<br> + $xpaset -p ds9 shm key 102<br> + $xpaset -p ds9 shm shmid 102 foo<br> + $xpaset -p ds9 shm fits key 100 foo<br> + $xpaset -p ds9 shm mosaicimage iraf key 100 foo<br> + $xpaset -p ds9 shm mosaicimage wcs key 100 foo<br> + $xpaset -p ds9 shm mosaicimage wcsa key 100 foo<br> + $xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo<br> + $xpaset -p ds9 shm mosaic iraf key 100 foo<br> + $xpaset -p ds9 shm mosaic wcs key 100 foo<br> + $xpaset -p ds9 shm rgbcube key 100 foo<br> + $xpaset -p ds9 shm rgbimage key 100 foo<br> + $xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> + $xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32]<br> + <br> + </tt> <b><a name="sia" id="sia"></a>sia<br> + </b> + <p>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.</p> + <tt>Syntax:<br> + sia + [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]<br> + <br> + </tt> <tt> </tt><tt> [<ref>] + [cancel]<br> + </tt> <tt> [<ref>] + [clear]<br> + </tt> <tt> [<ref>] + [close]</tt><br> + <tt> [<ref>] [coordinate <ra> + <dec> <coordsys>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[<ref>] [crosshair]</tt><br> + <tt> [<ref>] [export sb|tsv + <filename>]<br> + </tt> <tt> [<ref>] + [name <object>]<br> + </tt> <tt> [<ref>] + [print]</tt><br> + <tt> [<ref>] [retrieve]</tt><br> + <tt> [<ref>] [save + <filename>]</tt><br> + <tt> [<ref>] [radius <value> + degrees|arcmin|arcsec]</tt><br> + <tt> [<ref>] [sky + <skyframe>]<br> + </tt> <tt> [<ref>] + [skyformat <skyformat>]<br> + </tt> <tt> + [<ref>] [system <coordsys>]</tt><tt><br> + </tt> + <tt> </tt> <tt>[<ref>] [update]</tt><br> + <tt><br> + Example:<br> + $xpaget ds9 sia<br> + </tt> <tt><br> + $xpaset -p ds9 sia 2mass<br> + </tt> <tt>$xpaset -p ds9 sia + cancel<br> + </tt> <tt>$xpaset -p ds9 sia clear<br> + </tt> <tt>$xpaset + -p ds9 sia close<br> + </tt> <tt>$xpaset -p ds9 sia coordinate 202.48 + 47.21 fk5<br> + </tt> <tt>$xpaset -p ds9 sia crosshair<br> + </tt> + <tt>$xpaset -p ds9 sia export tsv bar.tsv<br> + </tt> <tt>$xpaset -p + ds9 sia name m51<br> + </tt> <tt>$xpaset -p ds9 sia print</tt><br> + <tt>$xpaset -p ds9 sia retrieve<br> + $xpaset -p ds9 sia save foo.xml<br> + </tt> <tt>$xpaset -p ds9 sia + radius 1 degrees</tt><br> + <tt>$xpaset -p ds9 sia sky fk5<br> + $xpaset -p ds9 sia skyformat degrees<br> + </tt> <tt>$xpaset -p ds9 + sia system wcs</tt><tt><br> + </tt> <tt>$xpaset -p ds9 sia update<br> + <br> + </tt> <b><a name="single" id="single"></a>single</b> + <p>Select Single Display mode</p> + <tt>Syntax:<br> + single<br> + <br> + Example:<br> + $xpaget ds9 single<br> + $xpaset -p ds9 single<br> + </tt> + <p><b><a name="skyview" id="skyview"></a>skyview</b></p> + <p>Support for SkyView image server at HEASARC.</p> + <tt>Syntax:<br> + skyview []<br> + [<object>]<br> + [name + <object>|clear]<br> + [<ra> + <dec>] + # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [pixels <width> + <height>]<br> + [save yes|no]<br> + [frame new|current]<br> + [update + frame|crosshair]<br> + [survey <survey>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 skyview name<br> + $xpaget ds9 skyview coord<br> + $xpaget ds9 skyview size<br> + $xpaget ds9 skyview pixels<br> + $xpaget ds9 skyview save<br> + $xpaget ds9 skyview frame<br> + $xpaget ds9 skyview survey<br> + $xpaset -p ds9 skyview<br> + $xpaset -p ds9 skyview m31<br> + </tt> <tt><tt>$xpaset -p ds9 skyview + name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 skyview name + clear<br> + </tt></tt> $xpaset -p ds9 skyview 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 skyview size 60 60 arcmin<br> + $xpaset -p ds9 skyview pixels 600 600<br> + $xpaset -p ds9 skyview save yes<br> + $xpaset -p ds9 skyview frame current<br> + $xpaset -p ds9 skyview update frame<br> + $xpaset -p ds9 skyview survey sdssi<br> + $xpaset -p ds9 skyview open<br> + </tt> <tt>$xpaset -p ds9 skyview + close</tt><br> + <p><b><a name="sleep" id="sleep"></a>sleep</b></p> + <p>Delays execution for specified number of seconds. Default is 1 + second.<br> + </p> + <tt>Syntax:<br> + sleep [#]<br> + <br> + Example:<br> + $xpaset -p ds9 sleep<br> + $xpaset -p ds9 sleep 2<br> + </tt> + <p><b><a name="smooth" id="smooth"></a>smooth</b></p> + <p>Smooth current image or set smooth parameters.<br> + Boxcar width = <i>2*radius+1</i><br> + Tophat diameter = <i>2*radius+1</i><br> + Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> + Elliptical Gaussian diameter = <i>2*radius+1,</i> mean + <i>=0<br> + </i> <br> + <tt>Syntax:</tt><br> + </p> + <tt>smooth []<br> + [yes|no]<br> + [function + boxcar|tophat|gaussian]<br> + </tt> + <tt> [radius + <value>]<br> + </tt> + <tt><tt><tt><tt> [radiusminor + <value>]<br> + </tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigma + <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt> + [sigmaminor <value>]<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt> +[angle + <value>]<br> + </tt></tt></tt></tt></tt></tt></tt></tt> + <tt> [match]<br> + [lock [yes|no]]</tt><br> + <tt><tt> [open|close]<br> + <br> + </tt> Example:<br> + $xpaget ds9 smooth<br> + $xpaget ds9 smooth function<br> + </tt> <tt><tt>$xpaget ds9 smooth + radius<br> + </tt></tt> <tt><tt>$xpaget ds9 smooth + radiusminor<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaget ds9 + smooth sigma<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaget ds9 smooth + sigmaminor<br> + </tt></tt></tt></tt></tt></tt></tt></tt> $xpaget + ds9 + smooth lock<br> + $xpaset -p ds9 smooth<br> + $xpaset -p ds9 smooth yes<br> + $xpaset -p ds9 smooth function tophat<br> + </tt> <tt><tt>$xpaset -p + ds9 smooth radius 4<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset + -p ds9 smooth radiusminor 4<br> + </tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth sigma + 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth + sigmaminor 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 + smooth angle + 45<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> + $xpaset -p ds9 smooth match<br> + $xpaset -p ds9 smooth lock yes</tt><br> + <tt>$xpaset -p ds9 smooth open<br> + $xpaset -p ds9 smooth close<br> + </tt> + <p><b><a name="source" id="source"></a>source</b></p> + <p>Source TCL code from a file. Only available for <tt>XPA_METHOD + local.</tt></p> + <tt>Syntax:<br> + source [<filename>]<br> + <br> + Example:<br> + $xpaset -p ds9 source foo.tcl</tt> + <p><b><a name="tcl" id="tcl"></a>tcl</b></p> + <p>Execute one tcl command. Only available for <tt>XPA_METHOD + local.</tt></p> + <tt>Syntax:<br> + tcl [<tcl command>]<br> + <br> + Example:<br> + $echo 'puts "Hello, World"' | xpaset ds9 tcl<br> + $xpaset -p ds9 tcl {puts {Hello, World}}</tt><tt><br> + </tt> + <p><b><a name="threads" id="threads"></a>threads</b></p> + <p>Set number of process threads for functions which are + multi-threaded.<br> + </p> + <tt>Syntax:<br> + threads #<br> + <br> + Example:<br> + $xpaget ds9 threads<br> + $xpaset -p ds9 threads 8</tt><br> + <p><b><a name="tiff" id="tiff"></a>tiff</b></p> + <p>Load TIFF image into current frame. Optional parameters: + <tt>tiff</tt> compression method.</p> + <tt>Syntax:<br> + tiff [new|slice] [<filename>] + [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + $xpaget ds9 tiff > foo.tiff</tt><br> + <tt><tt>$xpaget ds9 tiff jpeg > foo.tiff</tt><br> + $xpaset -p ds9 tiff foo.tiff</tt><br> + <tt><tt>$xpaset -p ds9 tiff new foo.tiff<br> + </tt></tt> + <tt><tt><tt>$xpaset -p ds9 tiff slice foo.tiff<br> + </tt></tt> $cat + foo.tiff | xpaset ds9 tiff</tt> <tt><tt><tt># not available + windows</tt></tt></tt><br> + <tt><tt>$cat foo.tiff | xpaset ds9 tiff</tt> <tt>new</tt></tt> + <tt><tt><tt><tt># not available windows</tt></tt><br> + </tt> $cat + foo.tiff | xpaset ds9 tiff</tt> <tt>slice</tt> <tt><tt><tt># + not + available windows</tt></tt></tt> + <p><b><a name="tile" id="tile"></a>tile</b></p> + <p>Controls the tile display mode.</p> + <tt>Syntax:<br> + tile []<br> + [yes|no]<br> + [mode grid|column|row]<br> + [grid]<br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> <row>]<br> + [grid gap <pixels>]<br> + [row]<br> + [column]<br> + <br> + Example:<br> + $xpaget ds9 tile<br> + $xpaget ds9 tile mode<br> + $xpaget ds9 tile grid mode<br> + $xpaget ds9 tile grid direction<br> + $xpaget ds9 tile grid layout<br> + $xpaget ds9 tile grid gap<br> + $xpaset -p ds9 tile<br> + $xpaset -p ds9 tile yes<br> + $xpaset -p ds9 tile mode row<br> + $xpaset -p ds9 tile grid<br> + $xpaset -p ds9 tile grid mode manual<br> + $xpaset -p ds9 tile grid direction x<br> + $xpaset -p ds9 tile grid layout 5 5<br> + $xpaset -p ds9 tile grid gap 10<br> + $xpaset -p ds9 tile row<br> + $xpaset -p ds9 tile column</tt> + <p><b><a name="update" id="update"></a>update</b></p> + <p>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.</p> + <tt>Syntax:<br> + update []<br> + [# x1 y1 x2 y2]<br> + [now]<br> + [now # x1 y1 x2 y2]<br> + <br> + Example:<br> + $xpaset -p ds9 update<br> + $xpaset -p ds9 update 1 100 100 300 400<br> + $xpaset -p ds9 update now<br> + $xpaset -p ds9 update now 1 100 100 300 400</tt><br> + <p><b><a name="url" id="url"></a>url</b></p> + <p>Load FITS from URL into the current frame</p> + <tt>Syntax:<br> + url <url><br> + <br> + Example:<br> + $xpaset -p ds9 url http://foo.bar.edu/foo.fits<br> + </tt> + <p><b><a name="version" id="version"></a>version</b></p> + <p>Returns the current version of DS9.</p> + <tt>Syntax:<br> + version<br> + <br> + Example:<br> + $xpaget ds9 version</tt> + <p><b><a name="view" id="view"></a>view</b></p> + <p>Controls the GUI.</p> + <tt>Syntax:<br> + view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no]<br> + [panner yes|no]<br> + [magnifier yes|no]<br> + [buttons yes|no]<br> + [colorbar yes|no]<br> + [colorbar horizontal|vertical]<br> + [colorbar numerics yes|no]<br> + [graph horizontal|vertical + yes|no]<br> + [filename yes|no[<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz + yes|no]<br> + </tt> <tt><tt><tt> [frame + yes|no]<br> + </tt></tt> [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]</tt><br> + <tt><tt> </tt><br> + Example:<br> + $xpaget ds9 view layout<br> + $xpaget ds9 view keyvalue<br> + $xpaget ds9 view info<br> + $xpaget ds9 view panner<br> + $xpaget ds9 view magnifier<br> + $xpaget ds9 view buttons<br> + $xpaget ds9 view colorbar<br> + $xpaget ds9 view graph horizontal<br> + $xpaget ds9 view filename<br> + $xpaget ds9 view object<br> + $xpaget ds9 view keyword<br> + $xpaget ds9 view minmax<br> + $xpaget ds9 view lowhigh<br> + $xpaget ds9 view units<br> + $xpaget ds9 view image<br> + $xpaget ds9 view wcsa</tt><br> + <tt>$xpaget ds9 view red<br> + </tt> <tt><tt><tt>$xpaget ds9 view + frame<br> + </tt></tt> $xpaset -p ds9 view layout vertical<br> + $xpaset -p ds9 view keyvalue BITPIX<br> + $xpaset -p ds9 view info yes<br> + $xpaset -p ds9 view panner yes<br> + $xpaset -p ds9 view magnifier yes<br> + $xpaset -p ds9 view buttons yes<br> + $xpaset -p ds9 view colorbar yes<br> + $xpaset -p ds9 view graph horizontal yes<br> + $xpaset -p ds9 view filename yes<br> + $xpaset -p ds9 view object yes<br> + $xpaset -p ds9 view keyword yes<br> + $xpaset -p ds9 view minmax yes<br> + $xpaset -p ds9 view lowhigh yes<br> + $xpaset -p ds9 view units yes<br> + $xpaset -p ds9 view wcsa yes<br> + </tt> <tt><tt>$xpaset -p ds9 view + frame yes</tt></tt><br> + <tt>$xpaset -p ds9 view red yes<br> + $xpaset -p ds9 view green yes<br> + $xpaset -p ds9 view blue yes</tt><br> + <br> + <b><a name="vla" id="vla"></a>vla</b> + <p>Support for VLA Sky Survey.</p> + <tt>Syntax:<br> + vla []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs + fk5<br> + [size <width> + <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 vla name<br> + $xpaget ds9 vla coord<br> + $xpaget ds9 vla size<br> + $xpaget ds9 vla save<br> + $xpaget ds9 vla frame<br> + $xpaget ds9 vla survey<br> + $xpaset -p ds9 vla<br> + $xpaset -p ds9 vla m31<br> + </tt> <tt><tt>$xpaset -p ds9 vla name + m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 vla name + clear<br> + </tt></tt> $xpaset -p ds9 vla 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 vla size 60 60 arcmin<br> + $xpaset -p ds9 vla save yes<br> + $xpaset -p ds9 vla frame current<br> + $xpaset -p ds9 vla update frame<br> + $xpaset -p ds9 vla survey stripe82<br> + $xpaset -p ds9 vla open<br> + </tt> <tt>$xpaset -p ds9 vla + close<br> + </tt> + <p><b><a name="vlss" id="vlss"></a>vlss</b></p> + <p>Support for NRAO VLSS Sky Survey.</p> + <tt>Syntax:<br> + vlss []<br> + [<object>]<br> + [name <object>]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 vlss name<br> + $xpaget ds9 vlss coord<br> + $xpaget ds9 vlss size<br> + $xpaget ds9 vlss save<br> + $xpaget ds9 vlss frame<br> + $xpaset -p ds9 vlss<br> + $xpaset -p ds9 vlss m31<br> + </tt> <tt><tt>$xpaset -p ds9 vlss name + m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 vlss name + clear<br> + </tt></tt> $xpaset -p ds9 vlss 00:42:44.404 + +41:16:08.78<br> + $xpaset -p ds9 vlss size 60 60 arcmin<br> + $xpaset -p ds9 vlss save yes<br> + $xpaset -p ds9 vlss frame current<br> + $xpaset -p ds9 vlss update frame<br> + $xpaset -p ds9 vlss open<br> + </tt> <tt>$xpaset -p ds9 vlss + close</tt><br> + <br> + <p><b><a name="vo" id="vo"></a>vo</b></p> + <p>Invoke an connection to a Virtual Observatory site.</p> + <tt>Syntax:<br> + vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 vo<br> + $xpaget ds9 vo method<br> + $xpaget ds9 vo server<br> + $xpaget ds9 vo internal<br> + $xpaget ds9 vo delay<br> + $xpaget ds9 vo connect<br> + $xpaset -p ds9 vo method xpa<br> + $xpaset -p ds9 vo server http://foo.bar.edu/list.txt<br> + $xpaset -p ds9 vo internal yes<br> + $xpaset -p ds9 vo delay 15 # keep-alive delay<br> + $xpaset -p ds9 vo chandra-ed<br> + $xpaset -p ds9 vo connect chandra-ed<br> + $xpaset -p ds9 vo disconnect chandra-ed<br> + $xpaset -p ds9 vo open<br> + $xpaset -p ds9 vo close<br> + </tt> + <p><b><a name="wcs" id="wcs"></a>wcs</b></p> + <p>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 <a href="file.html#WCS">WCS</a> for more + information.</p> + <tt>Syntax:<br> + wcs [[system] wcs|wcsa...wcsz]<br> + [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> + [[skyformat] degrees|sexagesimal]<br> + [align yes|no]<br> + [reset [#]]<br> + [replace [#] <filename>]<br> + [append [#] <filename>]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 wcs<br> + $xpaget ds9 wcs system<br> + $xpaget ds9 wcs sky<br> + $xpaget ds9 wcs skyformat<br> + $xpaget ds9 wcs align<br> + $xpaset -p ds9 wcs wcs<br> + $xpaset -p ds9 wcs system wcs<br> + $xpaset -p ds9 wcs fk5<br> + </tt> <tt>$xpaset -p ds9 wcs sky + fk5<br> + </tt> <tt>$xpaset -p ds9 wcs sexagesimal<br> + </tt> + <tt>$xpaset -p ds9 wcs skyformat sexagesimal<br> + $xpaset -p ds9 wcs align yes<br> + $xpaset -p ds9 wcs reset<br> + $xpaset -p ds9 wcs reset 3<br> + $xpaset -p ds9 wcs replace foo.wcs<br> + $xpaset -p ds9 wcs replace 3 foo.wcs<br> + $xpaset -p ds9 wcs append foo.wcs<br> + $xpaset -p ds9 wcs append 3 foo.wcs<br> + $cat foo.wcs | xpaset ds9 wcs replace<br> + $cat foo.wcs | xpaset ds9 wcs append<br> + $echo "OBJECT = 'foobar'" | xpaset ds9 wcs append<br> + $xpaset -p ds9 open<br> + $xpaset -p ds9 close<br> + </tt> + <p><b><a name="web" id="web"></a>web</b></p> + <p>Display specified URL in the web display.</p> + <tt>Syntax:<br> + web []<br> + [<url>]<br> + [new <webname> <url>]<br> + [<webname>] [click + back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> + Example:<br> + $xpaget ds9 web<br> + $xpaset -p ds9 web www.cnn.com<br> + $xpaset -p ds9 web new www.cnn.com<br> + $xpaset -p ds9 web hvweb www.apple.com<br> + $xpaset -p ds9 web click back<br> + $xpaset -p ds9 web click 2<br> + $xpaset -p ds9 web clear<br> + $xpaset -p ds9 web close<br> + </tt> + <p><b><a name="width" id="width"></a>width</b></p> + <p>Set the width of the image display window.</p> + <tt>Syntax:<br> + width [<value>]<br> + <br> + Example:<br> + $xpaget ds9 width<br> + $xpaset -p ds9 width 512</tt><br> + <p><b><a name="xpa" id="xpa"></a>xpa</b></p> + <p>Configure XPA.</p> + <tt>Syntax:<br> + -xpa [disconnect]<br> + [info]<br> + <br> + Example:<br> + $xpaget ds9 info<br> + $xpaset -p ds9 disconnect<br> + $xpaset -p ds9 info<br> + </tt> + <p><b><a name="zscale" id="zscale"></a>zscale</b></p> + <p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> + <tt>Syntax:<br> + zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> + Example:<br> + $xpaget ds9 zscale contrast<br> + $xpaget ds9 zscale sample<br> + $xpaget ds9 zscale line<br> + $xpaset -p ds9 zscale<br> + $xpaset -p ds9 zscale contrast .25<br> + $xpaset -p ds9 zscale sample 600<br> + $xpaset -p ds9 zscale line 120<br> + </tt> + <p><b><a name="zoom" id="zoom"></a>zoom</b></p> + <p>Controls the current zoom value for the current frame.</p> + <tt>Syntax:<br> + zoom [<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [open|close]<br> + <br> + Example:<br> + $xpaget ds9 zoom<br> + $xpaset -p ds9 zoom 2<br> + $xpaset -p ds9 zoom 2 4<br> + $xpaset -p ds9 zoom to 4<br> + $xpaset -p ds9 zoom to 2 4<br> + $xpaset -p ds9 zoom in<br> + $xpaset -p ds9 zoom out<br> + <$xpaset -p ds9 zoom to fit<br> + $xpaset -p ds9 zoom open<br> + $xpaset -p ds9 zoom close<br> + </tt></blockquote> + </body> </html> |