diff options
Diffstat (limited to 'ds9/doc/ref/command.html')
-rw-r--r-- | ds9/doc/ref/command.html | 5936 |
1 files changed, 2574 insertions, 3362 deletions
diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index ef5a8c9..0694f7d 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -1,3370 +1,2582 @@ <!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=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" alink="#FF0000" link="#0000FF"> - <h3><img alt="" src="../sun.gif" width="100" align="middle" - height="98"> 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:</tt><tt><br> - </tt><tt> -block</tt><tt> </tt><tt>[<value>]</tt><tt><br> - </tt><tt> [<value> - <value>]</tt><tt><br> - </tt><tt> [to <value>]</tt><tt><br> - </tt><tt> [to <value> - <value>]</tt><tt><br> - </tt><tt> [in]</tt><tt><br> - </tt><tt> [out]</tt><tt><br> - </tt><tt> </tt><tt> [to fit]</tt><tt><br> - </tt><tt> [match]</tt><tt><br> - </tt><tt> [lock [yes|no]]</tt><tt><br> - </tt><tt> [open|close]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9</tt><tt> </tt><tt>-block</tt><tt> - 4</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> 4 2</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9</tt><tt> </tt><tt>-block</tt><tt> - to 4</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> to 4 2</tt><tt><br> - </tt><tt> </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> in</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9</tt><tt> </tt><tt>-block</tt><tt> - out</tt><tt><br> - </tt><tt> </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> to - fit</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> match</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> lock yes</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> open</tt><tt><br> - </tt><tt> $ds9</tt><tt> </tt><tt>-block</tt><tt> close<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:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-catalog [new]</tt><tt><br> - </tt><tt> - [ned|simbad|denis|skybot]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]</tt><tt><br> - </tt><tt> [</tt><tt>ua2|ub1|</tt><tt>ucac2|ucac2sup|ucac3|ucac4|urat1]</tt><tt><br> - </tt><tt> </tt><tt> - [2mass|iras]</tt><tt><br> - </tt><tt> - [csc|xmm|rosat]</tt><tt><br> - </tt><tt> [first|nvss]</tt><tt><br> - </tt><tt> - [chandralog|cfhtlog|esolog|stlog|xmmlog]</tt><tt><br> - </tt><tt> [cds - <catalogname>]</tt><tt><br> - </tt><tt> [cds - <catalogid>]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> [load - <filename>]</tt><tt><br> - </tt><tt> [import sb|tsv - <filename>]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [<ra> <dec> - <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [allcols]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - [<ref>] [allrows]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [cancel]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [clear]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [close]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[<ref>] [crosshair]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [dec <col>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [edit yes|no]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [export sb|tsv <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - - [<ref>] [filter <string>]</tt><tt><br> - </tt><tt> [<ref>] - [filter load <filename>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [header]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [location <code>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [match <ref> <ref>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - - - [<ref>] [match]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[<ref>] [match error <value> - degrees|arcmin|arcsec]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[<ref>] [match function 1and2|1not2|2not1]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[<ref>] [match return 1and2|1only|2only]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[<ref>] [match unique yes|no]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [maxrows <number>]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] - [name <object>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - - [<ref>] [panto yes|no]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [plot <xcol> <ycol> <xerrcol> - <yerrcol>]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] - [print]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [psky <skyframe>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [psystem <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [ra <col>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [regions]</tt><tt><br> - </tt><tt> [<ref>] - [retrieve]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [samp]</tt><tt><br> - </tt><tt> [<ref>] - [samp broadcast]</tt><tt><br> - </tt><tt> [<ref>] - [samp send <application>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - - [<ref>] [save <filename>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [server</tt><tt> </tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [show yes|no]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] - [radius <value> degrees|arcmin|arcsec]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [sky <skyframe>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [skyformat <skyformat>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [sort <col> incr|decr]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [symbol [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [symbol [#] - text|size|size2|units|angle <value>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [symbol shape circle|ellipse|box|text|point]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - [symbol shape</tt><tt> </tt><tt>circle point|box point|diamond - point|</tt><tt>cross point|x point|arrow point|boxcircle point]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - - [<ref>] [symbol add| [#] remove]</tt><tt><br> - </tt><tt> [<ref>] - [symbol save|load <filename>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [system <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - </tt><tt> </tt><tt>[<ref>] [update]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [x <col>]</tt><tt><br> - </tt><tt> </tt><tt> - [<ref>] [y <col>]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog new</tt><tt><br> - </tt><tt> </tt><tt> $ds9 -catalog 2mass</tt><tt><br> - </tt><tt> $ds9 -catalog cds 2mass</tt><tt><br> - </tt><tt> $ds9 -catalog cds "I/252"</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog load foo.xml</tt><tt><br> - </tt><tt> $ds9 -catalog import tsv foo.tsv</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog 202.48 47.21 fk5</tt><tt><br> - </tt><tt> </tt><tt> $ds9 -catalog allrows</tt><tt><br> - </tt><tt> $ds9 -catalog allcols</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog cancel</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog clear</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog close</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog crosshair</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog dec DEC</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog edit yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog export tsv bar.tsv</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog filter</tt><tt> </tt><tt>'\$Jmag>15'</tt><tt><br> - </tt><tt> $ds9 -catalog filter load foo.flt</tt><tt><br> - </tt><tt> $ds9 -catalog header</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog location 500</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog match error 2 arcsec</tt><tt><br> - </tt><tt> $ds9 -catalog match function 1and2</tt><tt><br> - </tt><tt> $ds9 -catalog match unique no</tt><tt><br> - </tt><tt> $ds9 -catalog match return 1only</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog match # last two - catalogs loaded</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog match 2mass csc</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog maxrows 2000</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog name m51</tt><tt><br> - </tt><tt> $ds9 -catalog panto no</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog plot</tt><tt> </tt><tt>'\$Jmag' - - - - - - - - - - - - '\$Hmag' '\$e_Jmag' '\$e_Hmag'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog print</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog psky fk5</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog psystem wcs</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog ra RA</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog regions</tt><tt><br> - </tt><tt> </tt><tt> $ds9 -catalog retrieve</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog samp broadcast</tt><tt><br> - </tt><tt> $ds9 -catalog samp send aladin</tt><tt><br> - </tt><tt> $ds9 -catalog save foo.xml</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog server sao</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog show yes</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog radius 1 degrees</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -catalog symbol condition '\$Jmag>15'</tt><tt><br> - </tt><tt> $ds9 -catalog symbol 2 shape "boxcircle point"</tt><tt><br> - </tt><tt> $ds9 -catalog symbol color red</tt><tt><br> - </tt><tt> $ds9 -catalog symbol font times</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog symbol fontsize 14</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog symbol fontweight - bold</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog symbol fontslant - italic</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog symbol add</tt><tt><br> - </tt><tt> $ds9 -catalog symbol 2 remove</tt><tt><br> - </tt><tt> $ds9 -catalog symbol load foo.sym</tt><tt><br> - </tt><tt> $ds9 -catalog symbol save bar.sym</tt><tt><br> - </tt><tt> $ds9 -catalog sky fk5</tt><tt><br> - </tt><tt> $ds9 -catalog skyformat degrees</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog sort "Jmag" incr</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog system wcs</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog update</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -catalog x RA</tt><tt><br> - </tt><tt> $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>]]<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<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:</tt><tt><br> - </tt><tt> -export [array|nrrd|envi|gif|tiff|jpeg|png] - <filename></tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-export array <filename></tt><tt> - </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt><tt> </tt><tt> -export nrrd <filename></tt><tt> </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt><tt> </tt><tt>-export envi <header> [<filename>]</tt><tt> - </tt><tt>[big|little</tt><tt>|native]</tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-export <filename></tt><tt>.jpeg - - - - - - - - - - - - [1-100]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-export <filename></tt><tt>.tiff - - - - - - - - - - - - - [none|jpeg|packbits|deflate]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> $ds9 -export array foo.arr little</tt><tt><br> - </tt><tt> $ds9 -export nrrd foo.nrrd little</tt><tt><br> - </tt><tt> $ds9 -export envi foo.hdr little</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -export envi foo.hdr foo.bsq - little</tt><tt><br> - </tt><tt> </tt><tt> $ds9 -export tiff foo.tiff jpeg</tt><tt><br> - </tt><tt> $ds9 -export jpeg foo.jpeg 75</tt><tt><br> - </tt><tt> $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:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-lock</tt><tt> </tt><tt>[frame - <coordsys>|none]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>[crosshair - <coordsys>|none]</tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [crop - <coordsys>|none]</tt><tt><br> - </tt><tt> </tt><tt> [slice - <coordsys>|none]</tt><tt><br> - </tt><tt> </tt><tt> [bin [yes|no]]</tt><tt><br> - </tt><tt> [axes [yes|no]]</tt><tt><br> - </tt><tt> [scale [yes|no]]</tt><tt><br> - </tt><tt> [scalelimits [yes|no]]</tt><tt><br> - </tt><tt> [colorbar [yes|no]]</tt><tt><br> - </tt><tt> [block [yes|no]]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [smooth [yes|no]]</tt><tt><br> - </tt><tt> </tt><tt> [3d [yes|no]]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>Example:</tt><tt> </tt><tt><br> - </tt><tt> $ds9 -lock frame wcs</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -lock crosshair wcs</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -lock crop wcs</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -lock slice wcs</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -lock bin yes</tt><tt><br> - </tt><tt> $ds9 -lock axes yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -lock scale yes</tt><tt><br> - </tt><tt> $ds9 -lock scalelimits yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -lock colorbar yes</tt><tt><br> - </tt><tt> $ds9 -lock block yes</tt><tt><br> - </tt><tt> $ds9 -lock smooth yes<br> - $ds9 -lock 3d yes<br> - <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 - zero|nonzero|nan|nonnan|range]<br> - [range <low> <high>]<br> - [transparency <value>]<br> - </tt><tt><tt><tt> [system - <coordsys>]<br> - </tt></tt> [clear]<br> - [open|close]<br> - -nomask<br> - <br> - Example:<br> - $ds9 -mask color red<br> - $ds9 -mask mark zero<br> - $ds9 -mask range 10 100<br> - $ds9 -mask transparency 50<br> - $ds9 -mask system wcs<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:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-match</tt><tt> </tt><tt>[frame - <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>[crosshair - - - - - - - - - - - - - <coordsys>]</tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - [crop <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> [slice - <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> [bin]</tt><tt><br> - </tt><tt> [axes]</tt><tt><br> - </tt><tt> [scale]</tt><tt><br> - </tt><tt> [scalelimits]</tt><tt><br> - </tt><tt> [colorbar]</tt><tt><br> - </tt><tt> [block]</tt><tt><br> - </tt><tt> [smooth]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - [3d]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -match frame wcs</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -match crosshair wcs</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -match crop wcs</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -match slice wcs</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -match bin</tt><tt><br> - </tt><tt> $ds9 -match axes</tt><tt><br> - </tt><tt> $ds9 -match scale</tt><tt><br> - </tt><tt> $ds9 -match scalelimits</tt><tt><br> - </tt><tt> $ds9 -match colorbar</tt><tt><br> - </tt><tt> $ds9 -match block</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -match smooth</tt><tt><br> - </tt><tt> </tt><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|3d]<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> - </b></p> - <p>Create a 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 action is <tt>slice</tt>. - Movie types are either <tt>MPEG</tt> or <tt>Animated GIF</tt>, - with default <tt>MPEG</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 [slice|frame|3d] [mpeg|gif] <filename><br> - -movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>]<br> - <br> - Example:<br> - </tt><tt><tt>$ds9 -movie slice mpeg ds9.mpg<br> - </tt> $ds9 -movie frame gif ds9.gif<br> - </tt><tt>$ds9 -movie 3d mpeg 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> - - - - - - - - - - - - - - - [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:</tt><tt><br> - </tt><tt> -pan [<x> <h> <coordsys> - [<skyframe>]] # relative</tt><tt><br> - </tt><tt> [to <x> <h> - <coordsys> [<skyframe>]] # absolute</tt><tt><br> - </tt><tt> [open|close]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> $ds9 -pan 200 200 image</tt><tt> </tt><tt># pan - relative</tt><tt><br> - </tt><tt> $ds9 -pan to 400 400 physical</tt><tt> </tt><tt># pan - to physical coords</tt><tt><br> - </tt><tt> $ds9 -pan to 13:29:55 47:11:50 wcs fk</tt><tt> </tt><tt># - pan to wcs coords</tt><tt><br> - </tt><tt> $ds9 -pan open</tt><tt><br> - </tt><tt> $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> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-plot [line|bar|scatter]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># existing plot</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-plot</tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - load <filename> xy|xyex|xyey|xyexey]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] save <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] clear]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] duplicate [#]]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] stats yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] list yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - loadconfig <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] saveconfig <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] pagesetup orient portrait|landscape]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print destination printer|file]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print command <command>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print filename <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print color rgb|gray]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - close</tt><tt>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - mode pointer|zoom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><br> - <tt><tt><tt><tt># export image</tt><tt><br> - </tt><tt> </tt><tt> </tt>plot</tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - </tt>export</tt><tt> </tt><tt>[gif|tiff|jpeg|png]</tt><tt> </tt><tt><filename></tt><tt><br> - </tt></tt><tt><tt> [<tt>[<plotname>] - - - - - - - - - - - - </tt>export jpeg <filename></tt><tt> </tt><tt>[1-100]</tt><tt><br> - </tt><tt> </tt><tt> </tt></tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - </tt>export tiff <filename</tt><tt>></tt><tt> </tt><tt>[none|jpeg|packbits|deflate]</tt><tt><br> - </tt><tt> <br> - </tt></tt><tt> </tt><tt> </tt><tt># configure graph</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-plot [[<plotname>] axis x|y - grid yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y log yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y flip yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y auto yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y min <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y max <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y format <string>]</tt><tt><br> - [[<plotname>] background - <value>]<br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - legend yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] legend position right|left|top|bottom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font title|labels|numbers font - times|helvetica|courier]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>size <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>weight normal|bold]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>slant roman|italic]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] title <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] title x|y <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [</tt><tt>[<plotname>] - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># configure current dataset</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-plot [[<plotname>] show - yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] shape fill yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] shape color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] smooth - step|linear|cubic|quadratic|catrom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] width <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] dash yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] error yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] error color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><tt> </tt><tt> - </tt><tt>[[<plotname>] error cap yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt></tt><tt> </tt><tt> - </tt><tt>[[<plotname>] error width <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - </tt><tt>[[<plotname>] name <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># select current dataset</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-plot [[<plotname>] select - <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>Example:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot bar</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># existing plot</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot load xy.dat</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot save foo.dat</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot clear</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot duplicate 1</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot stats yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot list yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot loadconfig foo.plt</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot saveconfig foo.plt</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot pagesetup orient - portrait</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot pagesetup size letter</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot print</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot print destination file</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot print command lp</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot print filename foo.ps</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot print color rgb</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot close</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot mode pointer</tt><tt><br> - </tt><tt> </tt><tt> </tt><br> - <tt><tt><tt><tt><tt># export plot</tt><tt><br> - </tt></tt></tt><tt><tt><tt><tt>$ds9 -plot export tiff - foo.tiff jpeg</tt></tt></tt><br> - $ds9 -plot export jpeg foo.jpeg 75<br> - $ds9 -plot export png foo.png<br> - <br> - </tt></tt></tt><tt></tt><tt># configure plot</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x grid yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x log yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x flip yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x auto no</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x min 1</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x max 100</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot axis x format '%f'</tt><tt><br> - </tt><tt> </tt><tt> </tt><br> - <tt><tt>$ds9 -plot background white<br> - <br> - </tt><tt> </tt><tt> </tt><tt> </tt>$ds9 -plot legend yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot legend position left</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot font numbers font times</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot font numbers size 12</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot font numbers weight bold</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot font numbers slant - italic</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot title 'This is a Title'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot title x 'X Axis'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot title y 'Y Axis'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot title legend 'This is - the Legend'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot barmode aligned</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># configure current dataset</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot show yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot shape circle</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot shape fill no</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot shape color cyan</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot smooth step</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot color red</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot width 2</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot dash yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot error yes</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot error color red</tt><tt><br> - $ds9 -plot error cap yes<br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot error width 2</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -plot name 'My Data'</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># select current dataset</tt><tt><br> - </tt><tt> </tt><tt> </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:</tt><tt><br> - </tt><tt> -print [destination printer|file]</tt><tt><br> - </tt><tt> [command - <command>]</tt><tt><br> - </tt><tt> [filename - <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - - - - - - - - - - - - [color rgb|cmyk|gray]</tt><tt><br> - </tt><tt> [level 1|2|3]</tt><tt><br> - </tt><tt> [resolution </tt><tt><tt>72|screen|96|144|150|225|300|600|1200]</tt></tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> $ds9 -print</tt><tt><br> - </tt><tt> $ds9 -print destination file</tt><tt><br> - </tt><tt> $ds9 -print command lp</tt><tt><br> - </tt><tt> $ds9 -print filename foo.ps</tt><tt><br> - </tt><tt> $ds9 -print color cmyk</tt><tt><br> - </tt><tt> $ds9 -print level 2</tt><tt><br> - </tt><tt> $ds9 -print resolution 96</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</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 +<head> +<meta name="generator" content= +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.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> +<a href="#sia">sia</a><br> +<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> +<a href="#vlss">vlss</a><br> +<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></tt><br> +<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> +$ds9 -2mass name m31<br> +$ds9 -2mass name clear<br> +$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> +-3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]<br> + [background none|azimuth|elevation]<br> + [border yes|no]<br> + [border color]<br> + [highlite yes|no]<br> + [highlite color]<br> + [compass yes|no]<br> + [compass color]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <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<br> +$ds9 -3d background azimuth<br> +$ds9 -3d border yes<br> +$ds9 -3d border color red<br> +$ds9 -3d highlite yes<br> +$ds9 -3d highlite color red<br> +$ds9 -3d compass yes<br> +$ds9 -3d compass color red<br> +$ds9 -3d match<br> +$ds9 -3d lock yes<br> +$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]<br> + <br> +Example:<br> +$ds9 -analysis 0 # invoke first analysis task<br> +$ds9 -analysis task 0<br> +$ds9 -analysis task foobar<br> +$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}<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]<br> +$cat foo.arr | ds9 -array +-[dim=512,bitpix=-32,endian=little]<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> + [filter clear]<br> + [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> +$ds9 -bin in<br> +$ds9 -bin out<br> +$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[<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$ds9-block4<br> +$ds9-block4 2<br> +$ds9-blockto 4<br> +$ds9-blockto 4 2<br> +$ds9-blockin<br> +$ds9-blockout<br> +$ds9-blockto fit<br> +$ds9-blockmatch<br> +$ds9-blocklock yes<br> +$ds9-blockopen<br> +$ds9-blockclose<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> +-catalog [new]<br> + [ned|simbad|denis|skybot]<br> + +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho]<br> + + [ua2|ub1|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> + [<ref>] [<ra> <dec> +<coordsys>]<br> + [<ref>] [allcols]<br> + [<ref>] [allrows]<br> + [<ref>] [cancel]<br> + [<ref>] [clear]<br> + [<ref>] [close]<br> + [<ref>] [crosshair]<br> + [<ref>] [dec <col>]<br> + [<ref>] [edit yes|no]<br> + [<ref>] [export sb|tsv +<filename>]<br> + [<ref>] [filter <string>]<br> + [<ref>] [filter load <filename>]<br> + [<ref>] [header]<br> + [<ref>] [location <code>]<br> + [<ref>] [match <ref> +<ref>]<br> + [<ref>] [match]<br> + [<ref>] [match error <value> +degrees|arcmin|arcsec]<br> + [<ref>] [match function +1and2|1not2|2not1]<br> + [<ref>] [match return +1and2|1only|2only]<br> + [<ref>] [match unique yes|no]<br> + [<ref>] [maxrows <number>]<br> + [<ref>] [name <object>]<br> + [<ref>] [panto yes|no]<br> + [<ref>] [plot <xcol> <ycol> +<xerrcol> <yerrcol>]<br> + [<ref>] [print]<br> + [<ref>] [psky <skyframe>]<br> + [<ref>] [psystem <coordsys>]<br> + [<ref>] [ra <col>]<br> + [<ref>] [regions]<br> + [<ref>] [retrieve]<br> + [<ref>] [samp]<br> + [<ref>] [samp broadcast]<br> + [<ref>] [samp send +<application>]<br> + [<ref>] [save <filename>]<br> + [<ref>] +[servercds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]<br> + [<ref>] [show yes|no]<br> + [<ref>] [radius <value> +degrees|arcmin|arcsec]<br> + [<ref>] [sky <skyframe>]<br> + [<ref>] [skyformat <skyformat>]<br> + [<ref>] [sort <col> incr|decr]<br> + [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>]<br> + [<ref>] [symbol [#] +text|size|size2|units|angle <value>]<br> + [<ref>] [symbol shape +circle|ellipse|box|text|point]<br> + [<ref>] [symbol shapecircle point|box +point|diamond point|cross point|x point|arrow point|boxcircle +point]<br> + [<ref>] [symbol add| [#] remove]<br> + [<ref>] [symbol save|load +<filename>]<br> + [<ref>] [system <coordsys>]<br> + [<ref>] [update]<br> + [<ref>] [x <col>]<br> + [<ref>] [y <col>]<br> +<br> +Example:<br> +$ds9 -catalog new<br> +$ds9 -catalog 2mass<br> +$ds9 -catalog cds 2mass<br> +$ds9 -catalog cds "I/252"<br> +<br> +$ds9 -catalog load foo.xml<br> +$ds9 -catalog import tsv foo.tsv<br> +<br> +$ds9 -catalog 202.48 47.21 fk5<br> +$ds9 -catalog allrows<br> +$ds9 -catalog allcols<br> +$ds9 -catalog cancel<br> +$ds9 -catalog clear<br> +$ds9 -catalog close<br> +$ds9 -catalog crosshair<br> +$ds9 -catalog dec DEC<br> +$ds9 -catalog edit yes<br> +$ds9 -catalog export tsv bar.tsv<br> +$ds9 -catalog filter'\$Jmag>15'<br> +$ds9 -catalog filter load foo.flt<br> +$ds9 -catalog header<br> +$ds9 -catalog location 500<br> +$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> +$ds9 -catalog match # last two catalogs loaded<br> +$ds9 -catalog match 2mass csc<br> +$ds9 -catalog maxrows 2000<br> +$ds9 -catalog name m51<br> +$ds9 -catalog panto no<br> +$ds9 -catalog plot'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag'<br> +$ds9 -catalog print<br> +$ds9 -catalog psky fk5<br> +$ds9 -catalog psystem wcs<br> +$ds9 -catalog ra RA<br> +$ds9 -catalog regions<br> +$ds9 -catalog retrieve<br> +$ds9 -catalog samp broadcast<br> +$ds9 -catalog samp send aladin<br> +$ds9 -catalog save foo.xml<br> +$ds9 -catalog server sao<br> +$ds9 -catalog show yes<br> +$ds9 -catalog radius 1 degrees<br> +$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> +$ds9 -catalog symbol fontsize 14<br> +$ds9 -catalog symbol fontweight bold<br> +$ds9 -catalog symbol fontslant italic<br> +$ds9 -catalog symbol add<br> +$ds9 -catalog symbol 2 remove<br> +$ds9 -catalog symbol load foo.sym<br> +$ds9 -catalog symbol save bar.sym<br> +$ds9 -catalog sky fk5<br> +$ds9 -catalog skyformat degrees<br> +$ds9 -catalog sort "Jmag" incr<br> +$ds9 -catalog system wcs<br> +$ds9 -catalog update<br> +$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> + [tag [load|save] <filename>]<br> + [tag delete]<br> + [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> +$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> + [match]<br> + [lock [yes|no]]<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<br> +$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>]<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> +$ds9 -contour<br> +$ds9 -contour yes<br> +$ds9 -contour generate<br> +$ds9 -contour clear<br> +$ds9 -contour load ds9.ctr<br> +$ds9 -contour save ds9.ctr<br> +$ds9 -contour save ds9.ctr wcs fk5<br> +$ds9 -contour convert<br> +$ds9 -contour load levels ds9.ctr<br> +$ds9 -contour save levels ds9.lev<br> +$ds9 -contour copy<br> +$ds9 -contour paste<br> +$ds9 -contour paste wcs red 2 no<br> +$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> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [reset]<br> + [3d zmin zmax <coordsys>]<br> + [open|close]<br> +<br> +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<br> +$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> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + <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>]]<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> +$ds9 -cube<br> +$ds9 -cube play<br> +$ds9 -cube last<br> +$ds9 -cube 3<br> +$ds9 -cube 4.5 wcs<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<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> +$ds9 -dsssao name m31<br> +$ds9 -dsssao name clear<br> +$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> +$ds9 -dsseso name m31<br> +$ds9 -dsseso name clear<br> +$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> +$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> +$ds9 -dssstsci name m31<br> +$ds9 -dssstsci name clear<br> +$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> +$ds9 -envi foo.hdr<br> +$ds9 -envi foo.hdr foo.bsq<br></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><br> +-export array <filename>[big|little|native]<br> +-export nrrd <filename>[big|little|native]<br> +-export envi <header> +[<filename>][big|little|native]<br> +-export <filename>.jpeg [1-100]<br> +-export <filename>.tiff [none|jpeg|packbits|deflate]<br> +<br> +Example:<br> +$ds9 -export array foo.arr little<br> +$ds9 -export nrrd foo.nrrd little<br> +$ds9 -export envi foo.hdr little<br> +$ds9 -export envi foo.hdr foo.bsq little<br> +$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<filename><br> + <br> +Example:<br> +$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]<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> + [grid gap2 <value>]<br> + [grid gap3 <value>]<br> + [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> + [numerics gap2 <value>]<br> + [numerics gap3 <value>]<br> + [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> + [labels text2 <text>]<br> + [labels def1 yes|no]<br> + [labels def2 yes|no]<br> + [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> +$ds9 -grid grid gap2 10<br> +$ds9 -grid grid gap3 10<br> +$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> +$ds9 -grid numerics gap2 10<br> +$ds9 -grid numerics gap3 10<br> +$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> +$ds9 -grid labels text2 {Hello World}<br> +$ds9 -grid labels def1 yes<br> +$ds9 -grid labels def2 yes<br> +$ds9 -grid labels gap1 10<br> +$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> +$ds9 -jpeg foo.jpeg<br> +$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> +-lock[frame <coordsys>|none]<br> + [crosshair <coordsys>|none]<br> + [crop <coordsys>|none]<br> + [slice <coordsys>|none]<br> + [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimits [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + [smooth [yes|no]]<br> + [3d [yes|no]]<br> +<br> +Example:<br> +$ds9 -lock frame wcs<br> +$ds9 -lock crosshair wcs<br> +$ds9 -lock crop wcs<br> +$ds9 -lock slice wcs<br> +$ds9 -lock bin yes<br> +$ds9 -lock axes yes<br> +$ds9 -lock scale yes<br> +$ds9 -lock scalelimits yes<br> +$ds9 -lock colorbar yes<br> +$ds9 -lock block yes<br> +$ds9 -lock smooth yes<br> +$ds9 -lock 3d yes<br> +<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 zero|nonzero|nan|nonnan|range]<br> + [range <low> <high>]<br> + [transparency <value>]<br> + [system <coordsys>]<br> + [clear]<br> + [open|close]<br> +-nomask<br> + <br> +Example:<br> +$ds9 -mask color red<br> +$ds9 -mask mark zero<br> +$ds9 -mask range 10 100<br> +$ds9 -mask transparency 50<br> +$ds9 -mask system wcs<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> +-match[frame <coordsys>]<br> + [crosshair <coordsys>]<br> + [crop <coordsys>]<br> + [slice <coordsys>]<br> + [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]<br> + [3d]<br> + <br> +Example:<br> +$ds9 -match frame wcs<br> +$ds9 -match crosshair wcs<br> +$ds9 -match crop wcs<br> +$ds9 -match slice wcs<br> +$ds9 -match bin<br> +$ds9 -match axes<br> +$ds9 -match scale<br> +$ds9 -match scalelimits<br> +$ds9 -match colorbar<br> +$ds9 -match block<br> +$ds9 -match smooth<br> +$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<br> +$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|3d]<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:<br> +$ds9 -mosaic foo.fits<br> +$ds9 -mosaic wcs foo.fits<br> +$cat foo.fits | ds9 -mosaic -<br> +$cat foo.fits | ds9 -mosaic wcs -<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:<br> +$ds9 -mosaicimage foo.fits<br> +$ds9 -mosaicimage wcs foo.fits<br> +$cat foo.fits | ds9 -mosaicimage<br> +$cat foo.fits | ds9 -mosaiimage wcs<br></tt> +<p><b><a name="movie" id="movie"></a>movie<br></b></p> +<p>Create a 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 action is <tt>slice</tt>. Movie types are either +<tt>MPEG</tt> or <tt>Animated GIF</tt>, with default <tt>MPEG</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 [slice|frame|3d] [mpeg|gif] <filename><br> +-movie 3d [mpeg|gif] <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>]<br> + <br> +Example:<br> +$ds9 -movie slice mpeg ds9.mpg<br> +$ds9 -movie frame gif ds9.gif<br> +$ds9 -movie 3d mpeg 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<br> +$cat foo.fits | ds9 -multiframe -<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> + [skyformat degrees|sexagesimal]<br> + [pan]<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> +$ds9 -nrrd foo.nrrd<br> +$cat foo.nrrd | xpaset ds9 -nrrd-<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> +$ds9 -nvss name m31<br> +$ds9 -nvss name clear<br> +$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>]<br> + [size letter|legal|tabloid|poster|a4]<br> + <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# pan relative<br> +$ds9 -pan to 400 400 physical# pan to physical coords<br> +$ds9 -pan to 13:29:55 47:11:50 wcs fk# pan to wcs coords<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><tt>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></tt></blockquote> +<p><tt>To create a new plot, use the plot new command.</tt></p> +<tt>Syntax:<br> +# create new empty plot window<br> +-plot [line|bar|scatter]<br> +<br> +# existing plot<br> +-plot[[<plotname>] load <filename> +xy|xyex|xyey|xyexey]<br> + [[<plotname>] save <filename>]<br> + [[<plotname>] clear]<br> + [[<plotname>] duplicate [#]]<br> + [[<plotname>] stats yes|no]<br> + [[<plotname>] list yes|no]<br> + [[<plotname>] loadconfig +<filename>]<br> + [[<plotname>] saveconfig +<filename>]<br> + [[<plotname>] pagesetup orient +portrait|landscape]<br> + [[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4]<br> + [[<plotname>] print]<br> + [[<plotname>] print destination +printer|file]<br> + [[<plotname>] print command +<command>]<br> + [[<plotname>] print filename +<filename>]<br> + [[<plotname>] print color rgb|gray]<br> + [[<plotname>] close]<br> + [[<plotname>] mode pointer|zoom]<br> +<br> +# export image<br> +plot[[<plotname>]export[gif|tiff|jpeg|png]<filename><br> + + [[<plotname>]export jpeg +<filename>[1-100]<br> + [[<plotname>]export tiff +<filename>[none|jpeg|packbits|deflate]<br> + <br> +# configure graph<br> +-plot [[<plotname>] axis x|y grid yes|no]<br> + [[<plotname>] axis x|y log yes|no]<br> + [[<plotname>] axis x|y flip yes|no]<br> + [[<plotname>] axis x|y auto yes|no]<br> + [[<plotname>] axis x|y min +<value>]<br> + [[<plotname>] axis x|y max +<value>]<br> + [[<plotname>] axis x|y format +<string>]<br> + [[<plotname>] background +<value>]<br> + [[<plotname>] legend yes|no]<br> + [[<plotname>] legend position +right|left|top|bottom]<br> + [[<plotname>] font title|labels|numbers +font times|helvetica|courier]<br> + [[<plotname>] fonttitle|labels|numberssize +<value>]<br> + [[<plotname>] +fonttitle|labels|numbersweight normal|bold]<br> + [[<plotname>] +fonttitle|labels|numbersslant roman|italic]<br> + [[<plotname>] title <string>]<br> + [[<plotname>] title x|y +<string>]<br> + [[<plotname>] barmode +normal|stacked|aligned|overlap]<br> +<br> +# configure current dataset<br> +-plot [[<plotname>] show yes|no]<br> + [[<plotname>] shape +none|circle|square|diamond|plus|splus|scross|triangle|arrow]<br> + [[<plotname>] shape fill yes|no]<br> + [[<plotname>] shape color +<value>]<br> + [[<plotname>] smooth +step|linear|cubic|quadratic|catrom]<br> + [[<plotname>] color <value>]<br> + [[<plotname>] width <value>]<br> + [[<plotname>] dash yes|no]<br> + [[<plotname>] error yes|no]<br> + [[<plotname>] error color +<value>]<br> + [[<plotname>] error cap yes|no]<br> + [[<plotname>] error width +<value>]<br> + [[<plotname>] name <string>]<br> +<br> +# select current dataset<br> +-plot [[<plotname>] select <value>]<br> + <br> +Example:<br> +# create new empty plot window<br> +$ds9 -plot bar<br> +<br> +# existing plot<br> +$ds9 -plot load xy.dat<br> +$ds9 -plot save foo.dat<br> +$ds9 -plot clear<br> +$ds9 -plot duplicate 1<br> +$ds9 -plot stats yes<br> +$ds9 -plot list yes<br> +$ds9 -plot loadconfig foo.plt<br> +$ds9 -plot saveconfig foo.plt<br> +$ds9 -plot pagesetup orient portrait<br> +$ds9 -plot pagesetup size letter<br> +$ds9 -plot print<br> +$ds9 -plot print destination file<br> +$ds9 -plot print command lp<br> +$ds9 -plot print filename foo.ps<br> +$ds9 -plot print color rgb<br> +$ds9 -plot close<br> +$ds9 -plot mode pointer<br> +<br> +# export plot<br> +$ds9 -plot export tiff foo.tiff jpeg<br> +$ds9 -plot export jpeg foo.jpeg 75<br> +$ds9 -plot export png foo.png<br> +<br> +# configure plot<br> +$ds9 -plot axis x grid yes<br> +$ds9 -plot axis x log yes<br> +$ds9 -plot axis x flip yes<br> +$ds9 -plot axis x auto no<br> +$ds9 -plot axis x min 1<br> +$ds9 -plot axis x max 100<br> +$ds9 -plot axis x format '%f'<br> +<br> +$ds9 -plot background white<br> +<br> +$ds9 -plot legend yes<br> +$ds9 -plot legend position left<br> +<br> +$ds9 -plot font numbers font times<br> +$ds9 -plot font numbers size 12<br> +$ds9 -plot font numbers weight bold<br> +$ds9 -plot font numbers slant italic<br> +<br> +$ds9 -plot title 'This is a Title'<br> +$ds9 -plot title x 'X Axis'<br> +$ds9 -plot title y 'Y Axis'<br> +$ds9 -plot title legend 'This is the Legend'<br> +<br> +$ds9 -plot barmode aligned<br> +<br> +# configure current dataset<br> +$ds9 -plot show yes<br> +$ds9 -plot shape circle<br> +$ds9 -plot shape fill no<br> +$ds9 -plot shape color cyan<br> +$ds9 -plot smooth step<br> +$ds9 -plot color red<br> +$ds9 -plot width 2<br> +$ds9 -plot dash yes<br> +$ds9 -plot error yes<br> +$ds9 -plot error color red<br> +$ds9 -plot error cap yes<br> +$ds9 -plot error width 2<br> +$ds9 -plot name 'My Data'<br> +<br> +# select current dataset<br> +$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:<br> +$ds9 png foo.png<br> +$cat foo.png | ds9 -png -<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><degree><hms><dms><arcmin><arcsec><br> + +<br> +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> + [color rgb|cmyk|gray]<br> + [level 1|2|3]<br> + +[resolution72|screen|96|144|150|225|300|600|1200]<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 96</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> + [fixed|edit|rotate|delete yes|no]<br> + [include|exclude|source|background]<br> + [command <marker command>]<br> + [composite]<br> + [dissolve]<br> + [template <filename>]<br> + [template <filename> at <ra> +<dec> <coordsys> <skyframe>]<br> + [savetemplate <filename>]<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> + <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> +$ds9 -regions edit yes<br> +$ds9 -regions include<br> +$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> +$ds9 -rgb lock wcs yes<br> +$ds9 -rgb lock crop yes<br> +$ds9 -rgb lock slice yes<br> +$ds9 -rgb lock bin yes<br> +$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</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]<br> +$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<br> +$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<br> +$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> +$ds9 -samp connect<br> +$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[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice]<br> +<br> +Example:<br> +$ds9 -save foo.fits<br> +$ds9 -save fits foo.fits image<br> +$ds9 -save fits foo.fits table<br> +$ds9 -save fits foo.fits slice<br> +$ds9 -save rgbimage foo.fits<br> +$ds9 -save rgbcube foo.fits<br> +$ds9 -save mecube foo.fits<br> +$ds9 -save mosaic foo.fits<br> +$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[fits|eps|gif|tiff|jpeg|png]<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<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<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> -[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:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>-sia</tt><tt> </tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> - [<ref>] [cancel]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [clear]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [<ref>] - [close]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] - [coordinate <ra> <dec> <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - [crosshair]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] [export - sb|tsv <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [<ref>] - [name <object>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [<ref>] - [print]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] - [retrieve]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [save <filename>]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><tt><br> - </tt><tt> </tt><tt> [<ref>] [sky - <skyframe>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [skyformat <skyformat>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [<ref>] [system <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - [update]</tt><tt><br> - </tt><tt> </tt><tt><br> - </tt><tt> Example:</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia 2mass</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia cancel</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia clear</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia close</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia coordinate 202.48 47.21 - fk5</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia crosshair</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia export tsv bar.tsv</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia name m51</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia print</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -sia retrieve</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia save foo.xml</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia radius 1 degrees</tt><tt><br> - </tt><tt> </tt><tt>$ds9 -sia sky fk5</tt><tt><br> - </tt><tt> $ds9 -sia skyformat degrees</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$ds9 -sia system wcs</tt><tt><br> - </tt><tt> </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 - - - - - - - - - - + [array [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - -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> +-sia[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]<br> + [<ref>] [cancel]<br> + [<ref>] [clear]<br> + [<ref>] [close]<br> + [<ref>] [coordinate <ra> <dec> +<coordsys>]<br> + [<ref>] [crosshair]<br> + [<ref>] [export sb|tsv +<filename>]<br> + [<ref>] [name <object>]<br> + [<ref>] [print]<br> + [<ref>] [retrieve]<br> + [<ref>] [save <filename>]<br> + [<ref>] [radius <value> +degrees|arcmin|arcsec]<br> + [<ref>] [sky <skyframe>]<br> + [<ref>] [skyformat <skyformat>]<br> + [<ref>] [system <coordsys>]<br> + [<ref>] [update]<br> +<br> +Example:<br> +$ds9 -sia 2mass<br> +$ds9 -sia cancel<br> +$ds9 -sia clear<br> +$ds9 -sia close<br> +$ds9 -sia coordinate 202.48 47.21 fk5<br> +$ds9 -sia crosshair<br> +$ds9 -sia export tsv bar.tsv<br> +$ds9 -sia name m51<br> +$ds9 -sia print<br> +$ds9 -sia retrieve<br> +$ds9 -sia save foo.xml<br> +$ds9 -sia radius 1 degrees<br> +$ds9 -sia sky fk5<br> +$ds9 -sia skyformat degrees<br> +$ds9 -sia system wcs<br> +$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> +$ds9 -skyview name m31<br> +$ds9 -skyview name clear<br> +$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.</p> +<p><tt>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></tt></p> +<tt>Syntax:<br> +-smooth []<br> + [yes|no]<br> + [function boxcar|tophat|gaussian|elliptic]<br> + [radius <value>]<br> + [radiusminor <value>]<br> + [sigma <value>]<br> + [sigmaminor <value>]<br> + [angle <value>]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$ds9 -smooth<br> +$ds9 -smooth yes<br> +$ds9 -smooth function tophat<br> +$ds9 -smooth radius 4<br> +$ds9 -smooth radiusminor 4<br> +$ds9 -smooth sigma 2.0<br> +$ds9 -smooth sigmaminor 2.0<br> +$ds9 -smooth angle 45<br> +$ds9 -smooth match<br> +$ds9 -smooth lock yes<br> +$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> +$ds9 -tiff foo.tiff<br> +$cat foo.fits | ds9 -tiff -</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> + [frame yes|no]<br> + [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]<br> + <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> +$ds9 -view frame yes<br> +$ds9 -view red yes<br> +$ds9 -view green yes<br> +$ds9 -view blue yes<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> +$ds9 -vla name m31<br> +$ds9 -vla name clear<br> +$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> +$ds9 -vlss name m31<br> +$ds9 -vlss name clear<br> +$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> +$ds9 -wcs fk5<br> +$ds9 -wcs sky fk5<br> +$ds9 -wcs sexagesimal<br> +$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> |