diff options
Diffstat (limited to 'ds9/doc')
| -rw-r--r-- | ds9/doc/acknowledgment.html | 61 | ||||
| -rw-r--r-- | ds9/doc/ref/command.html | 1927 | ||||
| -rw-r--r-- | ds9/doc/ref/samp.html | 2238 | ||||
| -rw-r--r-- | ds9/doc/ref/xpa.html | 2091 | ||||
| -rw-r--r-- | ds9/doc/release/r8.1.html | 32 |
5 files changed, 2923 insertions, 3426 deletions
diff --git a/ds9/doc/acknowledgment.html b/ds9/doc/acknowledgment.html index 6dd0935..49c5f1e 100644 --- a/ds9/doc/acknowledgment.html +++ b/ds9/doc/acknowledgment.html @@ -1,33 +1,34 @@ <!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> -<head> -<meta name="generator" content= -"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> -<meta http-equiv="Content-Type" content= -"text/html; charset=us-ascii"> -<meta name="GENERATOR" content= -"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> -<title>DS9 Acknowledgment</title> -</head> -<body vlink="#551A8B" text="#000000" link="#0000EE" bgcolor= -"#FFFFFF" alink="#FF0000"> -<h3><img alt="" src="sun.gif" width="100" height="98" align= -"middle"> SAOImageDS9 Acknowledgment</h3> -<blockquote> -<p>DS9 development has been made possible by funding from the -Chandra X-ray Science Center (CXC) (NAS8-03060) and the High Energy -Astrophysics Science Archive Center (HEASARC) (NCC5-568). -Additional funding was provided by the JWST Mission office at Space -Telescope Science Institute (NAS-03127) to improve capabilities for -3-D data visualization.<br></p> -<p>If you have found DS9 to be helpful in your research, the -following acknowledgment would be appreciated</p> -<blockquote> -<p><i>"This research has made use of SAOImageDS9, developed by -Smithsonian Astrophysical Observatory"</i></p> -</blockquote> -<p>or reference the following paper<a href= -"http://adsabs.harvard.edu/cgi-bin/nph-bib_query?bibcode=2003adass..12..489J">2003adass..12..489J</a></p> -</blockquote> -</body> + <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>DS9 Acknowledgment</title> + </head> + <body vlink="#551A8B" text="#000000" link="#0000EE" bgcolor="#FFFFFF" + alink="#FF0000"> + <h3><img alt="" src="sun.gif" width="100" height="98" align="middle"> + SAOImageDS9 Acknowledgment</h3> + <blockquote> + <p>DS9 development has been made possible by funding from the + Chandra X-ray Science Center (CXC) (NAS8-03060) and the High + Energy Astrophysics Science Archive Center (HEASARC) (NCC5-568). + Additional funding was provided by the JWST Mission office at + Space Telescope Science Institute (NAS-03127) to improve + capabilities for 3-D data visualization.<br> + </p> + <p>If you have found DS9 to be helpful in your research, the + following acknowledgment would be appreciated</p> + <blockquote> + <p><i>"This research has made use of SAOImageDS9, developed by + Smithsonian Astrophysical Observatory"</i></p> + </blockquote> + <p>or reference the following paper <a + href="http://adsabs.harvard.edu/abs/2003ASPC..295..489J">2003adass..295..489J</a></p> + </blockquote> + </body> </html> diff --git a/ds9/doc/ref/command.html b/ds9/doc/ref/command.html index 2b84c66..bd400b6 100644 --- a/ds9/doc/ref/command.html +++ b/ds9/doc/ref/command.html @@ -9,20 +9,17 @@ 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> + <body alink="#FF0000" link="#0000FF" vlink="#551A8B"> + <h3><img alt="" src="../sun.gif" align="middle" height="98" + width="100"> 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> + 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> + 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> @@ -159,11 +156,9 @@ <tt>Syntax:<br> -2mass []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -176,10 +171,8 @@ $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> + </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> @@ -197,21 +190,16 @@ [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> + <tt><tt> [background none|azimuth|elevation]<br> + </tt> </tt><tt> [border yes|no]<br> [border color]<br> - </tt> <tt> - [highlite yes|no]<br> + </tt> <tt> [highlite yes|no]<br> [highlite color]<br> - </tt> - <tt><tt> </tt><tt> [compass yes|no]<br> + </tt> <tt><tt> </tt><tt> [compass yes|no]<br> [compass color]<br> [match]<br> [lock [yes|no]]<br> - </tt> - [open|close]<br> + </tt> [open|close]<br> </tt> <tt> <br> Example:<br> $ds9 -3d # create new 3D frame<br> @@ -221,13 +209,11 @@ $ds9 -3d scale 10<br> $ds9 -3d method mip</tt><br> <tt>$ds9 -3d background azimuth<br> - </tt> <tt>$ds9 -3d border - yes<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> + </tt> <tt><tt>$ds9 -3d compass yes<br> $ds9 -3d compass color red<br> $ds9 -3d match<br> $ds9 -3d lock yes<br> @@ -253,8 +239,7 @@ <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> + and display text in the text dialog window.</p> <tt>Syntax:<br> -analysis [<task number>]<br> @@ -265,20 +250,17 @@ <filename>]<br> [clear]<br> - [clear][load - <filename>]<br> + [clear][load <filename>]<br> [message ok|okcancel|yesno <message>]<br> [entry <message>]<br> - - [text]</tt><tt><tt><tt><tt><tt><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 foobar<br> </tt> <tt>$ds9 -analysis task {foo bar}<br> $ds9 -analysis my.ans<br> $ds9 -analysis load my.ans<br> @@ -296,8 +278,7 @@ <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>$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> @@ -334,10 +315,8 @@ [factor <value> [<value>]]<br> [depth <value>]<br> [filter <string>]<br> - </tt> - <tt><tt> [filter clear]<br> - </tt> - [function average|sum]<br> + </tt> <tt><tt> [filter clear]<br> + </tt> [function average|sum]<br> [in]<br> [out]<br> [to fit]<br> @@ -378,37 +357,36 @@ $ds9 -blink interval 1</tt><br> <p><b><a name="block" id="block"></a>block</b></p> <p>Controls blocking parameters.</p> - <tt>Syntax:<br> - -block</tt> <tt><tt>[<value>]<br> - [<value> - <value>]<br> - [to <value>]<br> - [to <value> - <value>]<br> - [in]<br> - [out]<br> - </tt> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - </tt> <tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> 4<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> 4 2<br> - </tt> - <tt><tt><tt>$ds9</tt> <tt><tt><tt>-block</tt></tt> to 4<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> to 4 2<br> - </tt> $ds9</tt> - <tt><tt><tt>-block</tt></tt> in<br> - </tt></tt> <tt><tt><tt>$ds9</tt> - <tt><tt><tt>-block</tt></tt> out<br> - </tt></tt> $ds9</tt> - <tt><tt><tt>-block</tt></tt> to fit<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> match<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> lock yes<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> open<br> - $ds9</tt> <tt><tt><tt>-block</tt></tt> close</tt><tt><br> + <tt>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> @@ -421,237 +399,235 @@ <p><b><a name="catalog" id="catalog"></a>catalog<br> cat</b></p> <p>Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.</p> - <tt>Syntax:<br> - </tt> <tt>-catalog [new]<br> - - [ned|simbad|denis|skybot]<br> - </tt> - <tt><tt> -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> - </tt> - [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - - [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds - <catalogid>]<br> - <br> - [load <filename>]<br> - [import sb|tsv - <filename>]<br> - <br> - </tt> <tt><tt> - [<ref>] [<ra> <dec> - <coordsys>]</tt><tt><br> - </tt> - [<ref>] [allcols]<br> - </tt> - <tt> </tt><tt> [<ref>] - [allrows]<br> - </tt><tt> [<ref>] - [cancel]<br> - </tt> <tt> - [<ref>] [clear]<br> - </tt> <tt> - [<ref>] [close]</tt><br> - <tt> </tt> - <tt>[<ref>] [crosshair]</tt><br> - <tt> [<ref>] [dec - <col>]</tt><br> - <tt> [<ref>] [edit - yes|no]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt> - <tt> [<ref>] - [filter <string>]<br> - [<ref>] [filter load - <filename>]</tt><br> - <tt> [<ref>] - [header]</tt><br> - <tt> [<ref>] [location - <code>]</tt><br> - <tt><tt> [<ref>] - [match <ref> <ref>]<br> - </tt></tt> - <tt><tt><tt> - [<ref>] [match]<br> - </tt></tt> - </tt> <tt>[<ref>] -[match - error <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt> - <tt>[<ref>] [match function 1and2|1not2|2not1]<br> - </tt> - <tt> </tt> - <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> - <tt> </tt> - <tt>[<ref>] [match unique yes|no]</tt><br> - <tt> [<ref>] [maxrows - <number>]</tt><br> - <tt> [<ref>] [name - <object>]<br> - </tt> - <tt> [<ref>] - [panto - yes|no]</tt><br> - <tt> [<ref>] [plot - <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> - <tt> [<ref>] [print]</tt><br> - <tt> [<ref>] [psky - <skyframe>]</tt><br> - <tt> [<ref>] [psystem - <coordsys>]</tt><br> - <tt> [<ref>] [ra - <col>]</tt><br> - <tt><tt> [<ref>] - [regions]</tt><br> - [<ref>] - [retrieve]<br> - </tt> <tt> - [<ref>] [samp]<br> - [<ref>] [samp - broadcast]<br> - [<ref>] [samp - send - <application>]</tt><tt><br> - </tt> - <tt> [<ref>] [save - <filename>]</tt><br> - <tt> [<ref>] - [server</tt> - <tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> - <tt> [<ref>] [show - yes|no]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> - [<ref>] [skyformat - <skyformat>]<br> - </tt> <tt> - [<ref>] [sort <col> - incr|decr]</tt><br> - <tt> [<ref>] [symbol - [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>]<br> - </tt> <tt> - [<ref>] [symbol [#] text|size|size2|units|angle - <value>]</tt><br> - <tt><tt> [<ref>] - [symbol - shape circle|ellipse|box|text|point]<br> - </tt></tt> - <tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt>circle point|box point|diamond - point|</tt></tt></tt></tt>cross point|x point|arrow - point|boxcircle - point]<br> - </tt></tt> <tt> - [<ref>] [symbol add| [#] remove]<br> - [<ref>] [symbol - save|load <filename>]</tt><br> - <tt> [<ref>] [system + 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>] [update]</tt><br> - <tt> [<ref>] [x - <col>]</tt><br> - <tt> [<ref>] [y - <col>]</tt><br> - <tt><br> - Example:<br> - </tt> <tt><tt>$ds9 -catalog new<br> - </tt> $ds9 -catalog - 2mass<br> - $ds9 -catalog cds 2mass<br> - $ds9 -catalog cds "I/252"<br> - <br> - </tt> <tt>$ds9 -catalog load foo.xml<br> - $ds9 -catalog import tsv foo.tsv<br> - <br> - </tt> <tt><tt>$ds9 -catalog 202.48 47.21 fk5<br> - </tt> $ds9 - -catalog allrows<br> - $ds9 -catalog allcols<br> - </tt> <tt>$ds9 -catalog cancel<br> - </tt> - <tt>$ds9 -catalog clear<br> - </tt> <tt>$ds9 -catalog close<br> - </tt> - <tt>$ds9 -catalog crosshair<br> - </tt> <tt>$ds9 -catalog dec - DEC<br> - </tt> <tt>$ds9 -catalog edit yes<br> - </tt> <tt>$ds9 -catalog - export tsv bar.tsv<br> - </tt> <tt>$ds9 -catalog filter</tt> - <tt>'\$Jmag>15'</tt><tt><br> - $ds9 -catalog filter load foo.flt<br> - $ds9 -catalog header<br> - </tt> <tt>$ds9 -catalog location - 500</tt><br> - <tt>$ds9 -catalog match error 2 arcsec<br> - $ds9 -catalog match function 1and2<br> - $ds9 -catalog match unique no<br> - $ds9 -catalog match return 1only<br> - </tt> <tt>$ds9 -catalog match # - last two catalogs loaded<br> - </tt> <tt>$ds9 -catalog match 2mass - csc<br> - </tt> <tt>$ds9 -catalog maxrows 2000<br> - </tt> <tt>$ds9 - -catalog name m51<br> - $ds9 -catalog panto no<br> - </tt> <tt>$ds9 -catalog plot</tt> - <tt>'\$Jmag' '\$Hmag' '\$e_Jmag' '\$e_Hmag'</tt><tt><br> - </tt> - <tt>$ds9 -catalog print</tt><br> - <tt>$ds9 -catalog psky fk5</tt><br> - <tt>$ds9 -catalog psystem wcs</tt><br> - <tt>$ds9 -catalog ra RA</tt><br> - <tt><tt>$ds9 -catalog regions<br> - </tt> $ds9 -catalog - retrieve<br> - </tt> <tt>$ds9 -catalog samp broadcast<br> - $ds9 -catalog samp send aladin<br> - $ds9 -catalog save foo.xml<br> - </tt> <tt>$ds9 -catalog server - sao<br> - </tt> <tt>$ds9 -catalog show yes</tt><br> - <tt>$ds9 -catalog radius 1 degrees</tt><br> - <tt>$ds9 -catalog symbol condition '\$Jmag>15'<br> - $ds9 -catalog symbol 2 shape "boxcircle point"<br> - $ds9 -catalog symbol color red<br> - $ds9 -catalog symbol font times<br> - </tt> <tt>$ds9 -catalog symbol - fontsize 14<br> - </tt> <tt>$ds9 -catalog symbol fontweight - bold<br> - </tt> <tt>$ds9 -catalog symbol fontslant italic<br> - </tt> - <tt>$ds9 -catalog symbol add<br> - $ds9 -catalog symbol 2 remove<br> - $ds9 -catalog symbol load foo.sym<br> - $ds9 -catalog symbol save bar.sym</tt><tt><br> - $ds9 -catalog sky fk5<br> - $ds9 -catalog skyformat degrees<br> - </tt> <tt>$ds9 -catalog sort - "Jmag" incr<br> - </tt> <tt>$ds9 -catalog system wcs</tt><tt><br> - </tt> - <tt>$ds9 -catalog update<br> - </tt> <tt>$ds9 -catalog x RA<br> - $ds9 -catalog y DEC</tt><br> + </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> @@ -663,17 +639,15 @@ <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> + 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> + [<contrast> <bias>]<br> + </tt> <tt> [tag [load|save] + <filename>]<br> [tag delete]</tt><br> <tt> [open|close]<br> <br> @@ -705,14 +679,17 @@ [fontsize <value>]<br> - [fontweight - normal|bold]<br> + [fontweight normal|bold]<br> [fontslant roman|italic]<br> [size]<br> [ticks]<br> - </tt> - <tt><tt> + </tt> <tt><tt> + + + + + [match]<br> [lock [yes|no]]</tt><br> @@ -749,15 +726,13 @@ [load <filename>]<br> [save - <filename> - [<coordsys> <skyframe>]]<br> + <filename> [<coordsys> <skyframe>]]<br> [convert]<br> [load levels <filename>]</tt><br> <tt><tt> [save levels <filename>]<br> - </tt> - [copy]<br> + </tt> [copy]<br> [paste [<coordsys> <color> <width> yes|no]]<br> [color @@ -770,21 +745,18 @@ [method block|smooth]<br> [nlevels <number - of - levels>]<br> + 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> + [scope global|local]<br> [limits <min> <max>]<br> [levels - <value - value value...>]<br> + <value value value...>]<br> [open|close]<br> <br> Example:<br> @@ -793,19 +765,14 @@ $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><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> <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><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> @@ -817,7 +784,7 @@ $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 levels 1 10 100 1000<br> $ds9 -contour open<br> $ds9 -contour close<br> </tt> @@ -826,10 +793,8 @@ <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> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><br> <tt><tt> [reset]<br> [3d zmin zmax <coordsys>]<br> [open|close]<br> @@ -854,6 +819,11 @@ [<skyframe>]]<br> </tt><tt> [match + + + + + <coordsys>]<br> [lock <coordsys>|none]</tt><br> @@ -874,13 +844,11 @@ [<slice> [<coordsys>][<axis>]]<br> [interval <numeric>]<br> - </tt> - <tt> [match <coordsys>]<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> + </tt> <tt> [open|close]<br> <br> Example:<br> $ds9 -cube<br> @@ -914,8 +882,7 @@ [name <object>|clear]<br> [<ra> - <dec>] - # in wcs fk5<br> + <dec>] # in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -927,11 +894,9 @@ Example:<br> $ds9 -dsssao<br> $ds9 -dsssao m31<br> - </tt> <tt><tt>$ds9 -dsssao name - 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> + </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> @@ -947,8 +912,7 @@ [name <object>|clear]<br> [<ra> - <dec>] - # in wcs fk5<br> + <dec>] # in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -962,11 +926,9 @@ Example:<br> $ds9 -dsseso<br> $ds9 -dsseso m31<br> - </tt> <tt><tt>$ds9 -dsseso name - 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> + </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> @@ -982,8 +944,7 @@ [name <object>|clear]<br> - [<ra> - <dec>] # in wcs fk5<br> + [<ra> <dec>] # in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save @@ -1003,10 +964,8 @@ 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><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> @@ -1016,18 +975,19 @@ $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>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>$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> @@ -1044,42 +1004,42 @@ <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> + 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] + <tt>Syntax:</tt><tt><br> + </tt><tt> -export [array|nrrd|envi|gif|tiff|jpeg|png] <filename></tt><tt><br> - </tt> <tt><tt>-export array - <filename></tt> <tt>[big|little</tt><tt>|native]<br> - </tt> - -export nrrd <filename></tt> - <tt>[big|little</tt><tt>|native]</tt><br> - <tt>-export envi <header> [<filename>]</tt> - <tt>[big|little</tt><tt>|native]</tt> <tt><br> - </tt> <tt>-export - <filename></tt><tt>.jpeg [1-100]<br> - </tt> <tt>-export - <filename></tt><tt>.tiff - [none|jpeg|packbits|deflate]</tt><br> - <tt> <br> - Example:<br> - $ds9 -export array foo.arr little<br> - $ds9 -export nrrd foo.nrrd little<br> - $ds9 -export envi foo.hdr little<br> - </tt> <tt><tt>$ds9 -export envi - foo.hdr foo.bsq little<br> - </tt> $ds9 -export tiff foo.tiff jpeg<br> - $ds9 -export jpeg foo.jpeg 75<br> - $ds9 -export png foo.png</tt><br> + </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> + /dev/imt1. These fifos are used by IRAF to communicate with DS9.</p> <tt>Syntax:<br> -fifo name<br> <br> @@ -1108,12 +1068,10 @@ </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> + 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> @@ -1171,8 +1129,7 @@ </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> + ds9 window, not just the image space. see X(1).</p> <tt>Syntax:<br> -geometry value<br> <br> @@ -1200,21 +1157,17 @@ [grid width <value>]<br> [grid dash yes|no]<br> [grid gap1 <value>]<br> - </tt> - <tt><tt> [grid gap2 + </tt> <tt><tt> [grid gap2 <value>]<br> - </tt></tt> - <tt><tt><tt> [grid gap3 - <value>]<br> - </tt></tt> [axes - yes|no]<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> + [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> @@ -1228,22 +1181,17 @@ [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 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 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> @@ -1257,15 +1205,11 @@ [title color <color>]<br> [labels yes|no]<br> [labels text1 <text>]<br> - </tt> - <tt><tt> [labels text2 + </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> + </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> @@ -1290,11 +1234,9 @@ $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>$ds9 -grid grid gap2 10<br> </tt></tt> <tt><tt><tt>$ds9 -grid grid gap3 10<br> - </tt></tt> - $ds9 -grid axes yes<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> @@ -1317,10 +1259,8 @@ $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><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> @@ -1334,12 +1274,10 @@ $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> <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> <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> @@ -1370,8 +1308,7 @@ <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> + overall width and height of the ds9 window.</p> <tt>Syntax:<br> -height [<value>]<br> <br> @@ -1391,8 +1328,7 @@ 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> + $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 @@ -1453,41 +1389,39 @@ $ds9 -linear</tt> <p><b><a name="lock" id="lock"></a>lock</b></p> <p>Lock all other frames to the current frame.</p> - <tt>Syntax:<br> - </tt> <tt>-lock</tt> <tt>[frame - <coordsys>|none]<br> - </tt> <tt>[crosshair - <coordsys>|none]</tt> <tt><br> - </tt> <tt> - [crop <coordsys>|none]</tt><br> - <tt> [slice - <coordsys>|none]</tt><br> - <tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimits [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br> - </tt> - <tt> [smooth [yes|no]]</tt><br> - <tt> [3d [yes|no]]</tt><tt><br> - </tt> - <tt><br> - </tt> <tt>Example:</tt> <tt><br> - $ds9 -lock frame wcs</tt><tt><br> - </tt> <tt>$ds9 -lock crosshair - wcs</tt><tt><br> - </tt> <tt>$ds9 -lock crop wcs</tt><br> - <tt>$ds9 -lock slice wcs</tt><br> - <tt>$ds9 -lock bin yes<br> - $ds9 -lock axes yes<br> - </tt> <tt>$ds9 -lock scale yes<br> - $ds9 -lock scalelimits yes<br> - </tt> <tt>$ds9 -lock colorbar - yes</tt><tt><br> - $ds9 -lock block yes</tt><tt><br> - $ds9 -lock smooth yes</tt><tt><br> + <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> @@ -1527,16 +1461,22 @@ <p>Controls mask parameters.</p> <tt>Syntax:<br> -mask [color <color>]<br> - [mark 1|0]<br> + [mark + zero|nonzero|nan|nonnan|range]<br> + [range <low> <high>]<br> [transparency <value>]<br> - [clear]<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 0<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> @@ -1544,41 +1484,48 @@ </tt> <p><b><a name="match" id="match"></a>match</b></p> <p>Match all other frames to the current frame.</p> - <tt>Syntax:<br> - </tt> <tt>-match</tt> <tt>[frame - <coordsys>]<br> - </tt> <tt>[crosshair - <coordsys>]</tt> <tt><br> - </tt> - <tt> [crop - <coordsys>]</tt><br> - <tt> [slice - <coordsys>]</tt><br> - <tt> [bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]<br> - </tt> - <tt><tt> [3d]</tt><tt><tt><br> - </tt></tt><br> - Example:<br> - </tt> <tt>$ds9 -match frame wcs<br> - </tt> <tt>$ds9 - -match crosshair wcs<br> - </tt> <tt>$ds9 -match crop wcs</tt><br> - <tt>$ds9 -match slice wcs</tt><br> - <tt>$ds9 -match bin<br> - $ds9 -match axes<br> - $ds9 -match scale<br> - $ds9 -match scalelimits<br> - $ds9 -match colorbar<br> - $ds9 -match block<br> - </tt> <tt><tt>$ds9 -match smooth<br> - </tt> $ds9 - -match 3d</tt><br> + <tt>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> @@ -1588,8 +1535,7 @@ <br> Example:<br> $ds9 -mecube foo.fits</tt><tt><tt><br> - </tt> $cat foo.fits | ds9 - -mecube -</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> @@ -1619,10 +1565,8 @@ <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>$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> @@ -1632,22 +1576,20 @@ <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>$ds9 -mosaicimage wcs foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | ds9 -mosaicimage</tt><br> <tt><tt>$cat foo.fits | ds9 -mosaiimage wcs</tt></tt><tt><br> </tt> <p><b><a name="movie" id="movie"></a>movie<br> savempeg<br> </b></p> - <p>Create mpeg1 movie from snap shots of the DS9 window. A - <tt>slice</tt> movie cycles though all slices of a cube. A - <tt>frame</tt> movie cycles through all active frames. A - <tt>3d</tt> movie cycles through specified viewing angles. The - default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.<br> + <p>Create mpeg1 movie from snap shots of the DS9 window. A <tt>slice</tt> + movie cycles though all slices of a cube. A <tt>frame</tt> + movie cycles through all active frames. A <tt>3d</tt> movie + cycles through specified viewing angles. The default is <tt>frame</tt>. + Optional parameters for <tt>3d</tt>: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.<br> </p> <tt>Syntax:<br> -movie [slice|frame|3d] <filename><br> @@ -1657,8 +1599,7 @@ <br> Example:<br> $ds9 -movie slice ds9.mpg<br> - $ds9 -movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate - 1</tt><br> + $ds9 -movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> <p><b><a name="msg" id="msg"></a>msg</b></p> <p>Specify a directory of translation tables to be loaded.</p> <tt>Syntax:<br> @@ -1674,23 +1615,36 @@ <br> Example:<br> $ds9 -multiframe foo.fits</tt><tt><tt><br> - </tt> $cat foo.fits | ds9 - -multiframe -</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> + [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> @@ -1729,8 +1683,7 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> @@ -1740,10 +1693,8 @@ $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> + </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> @@ -1768,8 +1719,7 @@ <tt>Syntax:<br> -pagesetup [orient portrait|landscape]<br> - [scale - <numberic>]</tt><br> + [scale <numberic>]</tt><br> <tt> [size letter|legal|tabloid|poster|a4]</tt><br> <tt> <br> @@ -1780,27 +1730,32 @@ <p><b><a name="pan" id="pan"></a>pan</b></p> <p>Controls the current image cursor location for the current frame.</p> - <tt>Syntax:<br> - -pan [<x> <h> <coordsys> - [<skyframe>]] # relative<br> - [to <x> <h> - <coordsys> - [<skyframe>]] # absolute<br> - [open|close]<br> - <br> - Example:<br> - $ds9 -pan 200 200 image</tt> <tt><tt># pan relative</tt><br> - $ds9 -pan to 400 400 physical</tt> <tt><tt># pan to physical - coords</tt><br> - $ds9 -pan to 13:29:55 47:11:50 wcs fk</tt> <tt><tt># pan to wcs - coords</tt><br> - $ds9 -pan open<br> - $ds9 -pan close</tt><br> + <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> @@ -1815,10 +1770,8 @@ <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> + 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> @@ -1827,258 +1780,206 @@ </blockquote> <p>To create a new plot, use the plot new command.</p> <tt>Syntax:</tt><tt><br> - </tt> <tt># create new empty plot - window</tt><tt><br> - </tt> <tt>-plot - [line|bar|scatter]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># existing - plot</tt><tt><br> - </tt> <tt>-plot</tt> <tt>[[<plotname>] load - <filename> xy|xyex|xyey|xyexey]</tt><tt><br> - </tt> - <tt> [[<plotname>] save - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] duplicate - [#]]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] stats yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] list - yes|no]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] loadconfig - <filename>]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] pagesetup orient - portrait|landscape]</tt><tt><br> - </tt> <tt> + </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> - [[<plotname>] print]</tt><tt><br> - </tt> <tt> - [[<plotname>] print destination - printer|file]</tt><tt><br> - </tt> <tt> - [[<plotname>] print command - <command>]</tt><tt><br> - </tt> <tt> - [[<plotname>] print filename - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + close</tt><tt>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> - </tt> - <tt><br> - </tt> <tt># configure graph</tt><tt><br> - </tt> <tt>-plot - [[<plotname>] axis x|y grid yes|no]</tt><tt><br> - </tt> - <tt> [[[<plotname>] axis x|y log - yes|no]</tt><tt><br> - </tt> <tt> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + mode pointer|zoom]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </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> [[<plotname>] axis x|y auto - yes|no]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] axis x|y max - <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] axis x|y format - <string>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] legend yes|no]</tt><tt><br> - </tt> - <tt> [[<plotname>] legend position - right|left|top|bottom]</tt><tt><br> - </tt> <tt> + </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> + </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> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>size <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>weight normal|bold]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>slant roman|italic]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] title x|y - <string>]</tt><tt><br> - </tt> <tt> - [</tt><tt>[<plotname>] barmode - normal|stacked|aligned|overlap]</tt><tt><br> - </tt> <tt><br> - </tt> - <tt># configure current dataset</tt><tt><br> - </tt> <tt>-plot - [[<plotname>] show yes|no]</tt><tt><br> - </tt> <tt> - </tt> <tt>[[<plotname>] shape + </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 circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] shape fill yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - shape color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - smooth step|linear|cubic|quadratic|catrom]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - dash yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - error yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - error color <value>]</tt><tt><br> - </tt> - <tt> [[<plotname>] color + </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> + [[<plotname>] color <value>]</tt><tt><br> + </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>[[<plotname>] - error width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] - name <string>]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># select - current dataset</tt><tt><br> - </tt> <tt>-plot [[<plotname>] - select <value>]</tt><tt><br> - </tt> - <tt> </tt><tt><br> - </tt> <tt>Example:</tt><tt><br> - </tt> <tt># - create new empty plot window</tt><tt><br> - </tt> <tt>$ds9 -plot - bar</tt><tt><br> - </tt> <tt><br> - </tt> <tt># existing - plot</tt><tt><br> - </tt> <tt>$ds9 -plot load xy.dat</tt><tt><br> - </tt> - <tt>$ds9 -plot save foo.dat</tt><tt><br> - </tt> <tt>$ds9 -plot - clear</tt><tt><br> - </tt> <tt>$ds9 -plot duplicate - 1</tt><tt><br> - </tt> <tt>$ds9 -plot stats yes</tt><tt><br> - </tt> - <tt>$ds9 -plot list yes</tt><tt><br> - </tt> <tt>$ds9 -plot loadconfig - foo.plt</tt><tt><br> - </tt> <tt>$ds9 -plot saveconfig - foo.plt</tt><tt><br> - </tt> <tt>$ds9 -plot pagesetup orient + </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>$ds9 -plot pagesetup size - letter</tt><tt><br> - </tt> <tt>$ds9 -plot print</tt><tt><br> - </tt> - <tt>$ds9 -plot print destination file</tt><tt><br> - </tt> <tt>$ds9 - -plot print command lp</tt><tt><br> - </tt> <tt>$ds9 -plot print - filename foo.ps</tt><tt><br> - </tt> <tt>$ds9 -plot print color - rgb</tt><tt><br> - </tt> <tt>$ds9 -plot close</tt><tt><br> - </tt> - <tt>$ds9 -plot mode pointer</tt><tt><br> - </tt> <tt><br> - </tt> <tt># - configure plot</tt><tt><br> - </tt> <tt>$ds9 -plot axis x grid - yes</tt><tt><br> - </tt> <tt>$ds9 -plot axis x log - yes</tt><tt><br> - </tt> <tt>$ds9 -plot axis x flip - yes</tt><tt><br> - </tt> <tt>$ds9 -plot axis x auto - no</tt><tt><br> - </tt> <tt>$ds9 -plot axis x min 1</tt><tt><br> - </tt> - <tt>$ds9 -plot axis x max 100</tt><tt><br> - </tt> <tt>$ds9 -plot axis - x format '%f'</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$ds9 -plot legend - yes</tt><tt><br> - </tt> <tt>$ds9 -plot legend position - left</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$ds9 -plot font numbers - font times</tt><tt><br> - </tt> <tt>$ds9 -plot font numbers size - 12</tt><tt><br> - </tt> <tt>$ds9 -plot font numbers weight - bold</tt><tt><br> - </tt> <tt>$ds9 -plot font numbers slant + </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><tt><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><tt><br> + </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><br> - </tt> <tt>$ds9 -plot title 'This - is a Title'</tt><tt><br> - </tt> <tt>$ds9 -plot title x 'X - Axis'</tt><tt><br> - </tt> <tt>$ds9 -plot title y 'Y - Axis'</tt><tt><br> - </tt> <tt>$ds9 -plot title legend 'This is the - Legend'</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$ds9 -plot barmode - aligned</tt><tt><br> - </tt> <tt><br> - </tt> <tt># configure current - dataset</tt><tt><br> - </tt> <tt>$ds9 -plot show yes</tt><tt><br> - </tt> - <tt>$ds9 -plot shape circle</tt><tt><br> - </tt> <tt>$ds9 -plot shape - fill no</tt><tt><br> - </tt> <tt>$ds9 -plot shape color - cyan</tt><tt><br> - </tt> <tt>$ds9 -plot smooth step</tt><tt><br> - </tt> - <tt>$ds9 -plot color red</tt><tt><br> - </tt> <tt>$ds9 -plot width - 2</tt><tt><br> - </tt> <tt>$ds9 -plot dash yes</tt><tt><br> - </tt> - <tt>$ds9 -plot error yes</tt><tt><br> - </tt> <tt>$ds9 -plot error - color red</tt><tt><br> - </tt> <tt>$ds9 -plot error width - 2</tt><tt><br> - </tt> <tt>$ds9 -plot name 'My Data'</tt><tt><br> - </tt> - <tt><br> - </tt> <tt># select current dataset</tt><tt><br> - </tt> - <tt>$ds9 -plot select 2</tt> + </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> + </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> @@ -2087,13 +1988,11 @@ <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></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> + The default is 5137, the standard IRAF port used by <i>ximtool</i>.</p> <tt>Syntax:<br> -port number<br> <br> @@ -2121,10 +2020,8 @@ <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> + <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> @@ -2153,28 +2050,31 @@ 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>Controls printing. Use print option to set printing options.<br> </p> - <tt>Syntax:<br> - -print [destination printer|file]<br> - [command <command>]<br> - [filename - <filename>]<br> - </tt> <tt> - [color rgb|cmyk|gray]<br> - [level 1|2]<br> - [resolution - 53|72|75|150|300|600]<br> - <br> - Example:<br> - $ds9 -print<br> - $ds9 -print destination file<br> - $ds9 -print command lp<br> - $ds9 -print filename foo.ps<br> - $ds9 -print color cmyk<br> - $ds9 -print level 2<br> - $ds9 -print resolution 75</tt> + <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]</tt><tt><br> + </tt><tt> [resolution + 53|72|75|150|300|600]</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 75</tt> <p><b><a name="raise" id="raise"></a>raise</b></p> <p>Raise in the window stacking order.</p> <tt>Syntax:<br> @@ -2200,15 +2100,13 @@ [centroid auto yes|no]<br> [centroid - radius - <value>|iteration <value>]<br> + radius <value>|iteration <value>]<br> [getinfo]<br> [move front]<br> [move back]<br> [select all]<br> [select none]<br> - [select - invert]<br> + [select invert]<br> [delete all]<br> [delete select]<br> [format @@ -2226,8 +2124,8 @@ <color><br> [width <width>]<br> - </tt> <tt> - [fixed|edit|rotate|delete yes|no]<br> + </tt> <tt> + [fixed|edit|rotate|delete yes|no]<br> [include|exclude|source|background]</tt><br> <tt> [command @@ -2241,19 +2139,15 @@ <skyframe>]<br> [savetemplate <filename>]<br> - </tt> <tt> - [group new]<br> - </tt> - <tt> [group + </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> + <tag> update]<br> + </tt> <tt> [group + <tag> select]<br> + </tt> <tt> [group + <tag> color <color>]<br> [group <tag> copy]<br> [group <tag> @@ -2261,11 +2155,9 @@ [group <tag> cut]<br> [group <tag> - font - <font>]<br> + font <font>]<br> [group <tag> - move - <int> <int>]<br> + move <int> <int>]<br> [group <tag> movefront]<br> [group <tag> @@ -2317,8 +2209,7 @@ $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> + </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> @@ -2376,8 +2267,7 @@ $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> <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> @@ -2387,8 +2277,7 @@ $ds9 -rgb lock block yes<br> $ds9 -rgb lock smooth yes<br> $ds9 -rgb open<br> - $ds9 -rgb close<br> - </tt><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> @@ -2397,8 +2286,7 @@ <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> + $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> @@ -2409,8 +2297,7 @@ <br> Example:<br> $ds9 -rgbcube foo.fits</tt><tt><tt><br> - </tt> $cat foo.fits | ds9 - -rgbcube -</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> @@ -2419,8 +2306,7 @@ <br> Example:<br> $ds9 -rgbimage foo.fits</tt><tt><tt><br> - </tt> $cat foo.fits | ds9 - -rgbimage -</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> @@ -2446,8 +2332,7 @@ Example:<br> $ds9 -samp yes<br> </tt> <tt><tt>$ds9 -samp connect<br> - </tt> $ds9 - -samp broadcast image<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> @@ -2455,6 +2340,11 @@ <tt>Syntax:<br> -save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] <filename> + + + + + [image|table|slice]</tt><br> <tt> <br> Example:<br> @@ -2463,8 +2353,7 @@ <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> <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> @@ -2475,8 +2364,7 @@ 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</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> @@ -2526,11 +2414,10 @@ [fits [key|shmid] <id> [<filename>]]<br> [mosaicimage - [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]]<br> + [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> + [<filename>]]<br> [mosaic [iraf|wcs|wcsa...wcsz] - [key|shmid] - <id> [<filename>]]<br> + [key|shmid] <id> [<filename>]]<br> [rgbcube [key|shmid] <id> [<filename>]]<br> [rgbimage [key|shmid] <id> @@ -2560,70 +2447,67 @@ </b></p> <p>Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.</p> - <tt>Syntax:<br> - </tt> <tt>-sia</tt> - <tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt><br> - <br> - </tt> <tt> </tt><tt> [<ref>] - [cancel]<br> - </tt> <tt> [<ref>] - [clear]<br> - </tt> <tt> [<ref>] - [close]</tt><br> - <tt> [<ref>] [coordinate <ra> - <dec> <coordsys>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[<ref>] - [crosshair]</tt><br> - <tt> [<ref>] [export sb|tsv - <filename>]<br> - </tt> <tt> [<ref>] - [name <object>]<br> - </tt> <tt> - [<ref>] [print]</tt><br> - <tt> [<ref>] [retrieve]<br> - </tt> - <tt> [<ref>] [save - <filename>]</tt><br> - <tt> [<ref>] [radius <value> - degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> - [<ref>] [skyformat <skyformat>]<br> - </tt> - <tt> [<ref>] [system - <coordsys>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[<ref>] - [update]</tt><br> - <tt><br> - Example:<br> - </tt> <tt>$ds9 -sia 2mass<br> - </tt> <tt>$ds9 -sia - cancel<br> - </tt> <tt>$ds9 -sia clear<br> - </tt> <tt>$ds9 -sia - close<br> - </tt> <tt>$ds9 -sia coordinate 202.48 47.21 fk5<br> - </tt> - <tt>$ds9 -sia crosshair<br> - </tt> <tt>$ds9 -sia export tsv - bar.tsv<br> - </tt> <tt>$ds9 -sia name m51<br> - </tt> <tt>$ds9 -sia - print</tt><br> - <tt>$ds9 -sia retrieve<br> - </tt> <tt>$ds9 -sia save foo.xml<br> - </tt> - <tt>$ds9 -sia radius 1 degrees</tt><br> - <tt>$ds9 -sia sky fk5<br> - $ds9 -sia skyformat degrees<br> - </tt> <tt>$ds9 -sia system - wcs</tt><tt><br> - </tt> <tt>$ds9 -sia update<br> + 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> @@ -2657,10 +2541,8 @@ 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><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> @@ -2700,52 +2582,66 @@ 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> + 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 + </tt> <tt> [radius <value>]<br> - </tt> - <tt><tt><tt><tt> + </tt> <tt><tt><tt><tt> [radiusminor <value>]<br> - </tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt> + </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> + </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> + </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> <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 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>$ds9 -smooth sigma 2.0<br> </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt>$ds9 -smooth + + + + + sigmaminor 2.0<br> - </tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt>$ds9 -smooth angle - 45<br> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt>$ds9 + + + + + -smooth angle 45<br> </tt></tt></tt></tt></tt></tt></tt> $ds9 -smooth match<br> $ds9 -smooth lock yes</tt><br> @@ -2799,10 +2695,8 @@ -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> <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> @@ -2860,9 +2754,8 @@ 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> + 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> @@ -2908,8 +2801,7 @@ [units yes|no]<br> [image|physical|wcs|wcsa...wcsz yes|no]<br> - </tt> <tt><tt><tt> [frame - 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> @@ -2947,11 +2839,9 @@ <tt>Syntax:<br> -vla []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -2964,10 +2854,8 @@ $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> + </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> @@ -2984,8 +2872,7 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> @@ -2995,10 +2882,8 @@ $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> + </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> @@ -3031,14 +2916,11 @@ <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> + 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> @@ -3053,11 +2935,9 @@ $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 sky fk5<br> </tt> <tt>$ds9 -wcs sexagesimal<br> - </tt> <tt>$ds9 - -wcs skyformat sexagesimal<br> + </tt> <tt>$ds9 -wcs skyformat sexagesimal<br> $ds9 -wcs align yes<br> $ds9 -wcs reset<br> $ds9 -wcs reset 3<br> @@ -3091,8 +2971,7 @@ <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> + overall width and height of the ds9 window.</p> <tt>Syntax:<br> -width [<value>]<br> <br> diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index 234796d..df90178 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -9,19 +9,19 @@ 2.4.7-10 i686) [Netscape]"> <title>SAMP</title> </head> - <body vlink="#551A8B" link="#0000FF" alink="#FF0000"> - <h3><img alt="" src="../sun.gif" width="100" height="98" - align="middle"> SAMP</h3> + <body alink="#FF0000" link="#0000FF" vlink="#551A8B"> + <h3><img alt="" src="../sun.gif" align="middle" height="98" + width="100"> SAMP</h3> <blockquote> <p>SAMP is a messaging protocol that enables astronomy software tools to interoperate and communicate. Broadly speaking, SAMP is - an - abstract framework for loosely-coupled, asynchronous, RPC-like - and/or event-based communication, based on a central service - providing multi-directional publish/subscribe message brokering. - The message semantics are extensible and use structured but - weakly-typed data. For more information on SAMP, please click - <a href="http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> + an abstract framework for loosely-coupled, asynchronous, + RPC-like and/or event-based communication, based on a central + service providing multi-directional publish/subscribe message + brokering. The message semantics are extensible and use + structured but weakly-typed data. For more information on SAMP, + please click <a + href="http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> <p>The samp implementation for DS9 is based on the <a href="xpa.html">XPA</a> model with 2 private calls:</p> <tt>ds9.get<br> @@ -163,8 +163,7 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> @@ -183,10 +182,8 @@ 2mass<br> 2mass m31<br> </tt> <tt><tt>2mass name m31<br> - </tt></tt> - <tt><tt><tt>2mass name clear<br> - </tt></tt> 2mass 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>2mass name clear<br> + </tt></tt> 2mass 00:42:44.404 +41:16:08.78<br> 2mass size 60 60 arcmin<br> 2mass save yes<br> 2mass frame current<br> @@ -205,19 +202,15 @@ [scale <scale>]<br> [method mip|aip]</tt><br> <tt><tt> [background none|azimuth|elevation]<br> - </tt> - </tt><tt> [border yes|no]<br> + </tt> </tt><tt> [border yes|no]<br> [border color <color>]<br> - </tt> <tt> - [highlite yes|no]<br> + </tt> <tt> [highlite yes|no]<br> [hightlite color <color>]<br> - </tt> - <tt><tt> </tt><tt> [compass yes|no]<br> + </tt> <tt><tt> </tt><tt> [compass yes|no]<br> [compass color <color>]</tt></tt><br> <tt><tt><tt><tt><tt> [match]<br> [lock [yes|no]]<br> - </tt></tt></tt></tt> - [open|close]</tt><tt><br> + </tt></tt></tt></tt> [open|close]</tt><tt><br> <br> Example:<br> string value = ds9.get(string cmd)<br> @@ -235,8 +228,7 @@ 3d compass color<br> 3d lock<br> </tt> ds9.set(string cmd)<br> - </tt> <tt>3d # create new - 3D frame<br> + </tt> <tt>3d # create new 3D frame<br> 3d view 45 30<br> 3d az 45<br> 3d el 30<br> @@ -270,17 +262,14 @@ [yes|no]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> align<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> - align yes</tt><br> + </tt> align yes</tt><br> <p><b><a name="analysis" id="analysis"></a>analysis</b></p> <p>Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message - and - display text in the text dialog window.</p> + and display text in the text dialog window.</p> <tt>Syntax:<br> analysis [<task number>]<br> @@ -296,8 +285,7 @@ ok|okcancel|yesno <message>]<br> [entry <message>]<br> - - [text]</tt><tt><tt><tt><tt><tt><br> + [text]</tt><tt><tt><tt><tt><tt><br> </tt></tt> </tt></tt><br> Example:<br> string value = ds9.get(string cmd)<br> @@ -316,8 +304,7 @@ analysis clear load my.ans<br> analysis message {This is a message}<br> analysis text {this is text}</tt><tt><tt><br> - </tt> ds9.set(string - cmd, string url)<br> + </tt> ds9.set(string cmd, string url)<br> analysis load<br> analysis text</tt><b><br> </b> @@ -331,16 +318,12 @@ <br> Example:<br> </tt> <tt><tt>string url = ds9.get(string cmd)<br> - </tt> - array<br> + </tt> array<br> array little<br> - </tt> <tt><tt>ds9.set(string command, string - url)<br> + </tt> <tt><tt>ds9.set(string command, string url)<br> </tt> array foo.arr[dim=512,bitpix=-32,endian=little]<br> - array new - foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> - <tt><tt>array mask - foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> + array new foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt><tt>array mask foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> </tt> <p><b><a name="background" id="background"></a>bg<br> background</b></p> @@ -352,8 +335,7 @@ </tt> <tt>string url = ds9.get(string cmd)</tt><tt><br> bg<br> </tt> <tt>ds9.set(string cmd)<br> - </tt> <tt>bg - red</tt><tt><br> + </tt> <tt>bg red</tt><tt><br> </tt> bg red<br> <p><b><a name="backup" id="backup"></a>backup</b></p> <p>Create a backup save set.</p> @@ -362,13 +344,11 @@ <br> Example:<br> </tt> <tt>ds9.set(string cmd)<br> - </tt> <tt>backup - ds9.bck</tt><br> + </tt> <tt>backup ds9.bck</tt><br> <p><b><a name="bin" id="bin"></a>bin</b></p> <p>Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking - is - provided for backward compatibility.</p> + is provided for backward compatibility.</p> <tt>Syntax:<br> bin [about <x> <y>]<br> [about center]<br> @@ -378,10 +358,8 @@ [factor <value> [<vector>]]<br> [depth <value>]<br> [filter <string>]<br> - </tt> - <tt><tt> [filter clear]<br> - </tt> - [function average|sum]<br> + </tt> <tt><tt> [filter clear]<br> + </tt> [function average|sum]<br> [in]<br> [out]<br> [to fit]<br> @@ -448,274 +426,269 @@ <value>]<br> [in]<br> [out]<br> - </tt> - [to fit]<br> + </tt> [to fit]<br> [match]<br> [lock [yes|no]]<br> [open|close]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> block<br> block lock<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt></tt> - <tt><tt><tt>block</tt></tt> 4<br> - </tt> <tt><tt><tt>block</tt></tt> - 4 2<br> + </tt></tt> <tt><tt><tt>block</tt></tt> 4<br> + </tt> <tt><tt><tt>block</tt></tt> 4 2<br> </tt> <tt><tt><tt><tt><tt>block</tt></tt> to 4<br> - </tt> - <tt><tt><tt>block</tt></tt> to 4 2<br> - </tt></tt> - <tt><tt><tt>block</tt></tt> in<br> - </tt></tt> - <tt><tt><tt><tt><tt>block</tt></tt> out<br> - </tt></tt></tt> - <tt><tt><tt>block</tt></tt> to fit<br> - </tt> - <tt><tt><tt>block</tt></tt> match<br> - </tt> - <tt><tt><tt>block</tt></tt> lock yes<br> - </tt> - <tt><tt><tt>block</tt></tt> open<br> - </tt> - <tt><tt><tt>block</tt></tt> close</tt><tt><br> + </tt> <tt><tt><tt>block</tt></tt> to 4 2<br> + </tt></tt> <tt><tt><tt>block</tt></tt> in<br> + </tt></tt> <tt><tt><tt><tt><tt>block</tt></tt> out<br> + </tt></tt></tt> <tt><tt><tt>block</tt></tt> to fit<br> + </tt> <tt><tt><tt>block</tt></tt> match<br> + </tt> <tt><tt><tt>block</tt></tt> lock yes<br> + </tt> <tt><tt><tt>block</tt></tt> open<br> + </tt> <tt><tt><tt>block</tt></tt> close</tt><tt><br> </tt> <p><b><a name="catalog" id="catalog"></a>catalog<br> cat<br> </b></p> <p>Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.</p> - <tt>Syntax:<br> - </tt> <tt>catalog [new]<br> - - [ned|simbad|denis|skybot]<br> - </tt> - <tt><tt> -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> - </tt></tt> - <tt> [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - - [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds - <catalogid>]<br> - <br> - [load <filename>]<br> - [import sb|tsv - <filename>]<br> - <br> - </tt> <tt><tt> - [<ref>] [<ra> <dec> - <coordsys>]</tt><tt><br> - </tt> - [<ref>] [allcols]<br> - </tt> - <tt> </tt><tt> [<ref>] - [allrows]<br> - </tt><tt> [<ref>] - [cancel]<br> - </tt> <tt> - [<ref>] [clear]<br> - </tt> <tt> - [<ref>] [close]</tt><br> - <tt> </tt> - <tt>[<ref>] [crosshair]</tt><br> - <tt> [<ref>] [dec - <col>]</tt><br> - <tt> [<ref>] [edit - yes|no]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt> - <tt> [<ref>] - [filter <string>]<br> - [<ref>] [filter load - <filename>]</tt><br> - <tt> [<ref>] - [header]</tt><br> - <tt> [<ref>] [location - <code>]</tt><br> - <tt><tt> [<ref>] - [match]<br> - </tt></tt> - <tt><tt><tt> - [<ref>] [match <ref> <ref>]<br> - </tt></tt> - </tt> <tt>[<ref>] -[match - error <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt> - <tt>[<ref>] [match function 1and2|1not2|2not1]<br> - </tt> - <tt> </tt> - <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> - <tt> </tt> - <tt>[<ref>] [match unique yes|no]</tt><br> - <tt> [<ref>] [maxrows - <number>]</tt><br> - <tt> [<ref>] [name - <object>]<br> - </tt> - <tt> [<ref>] - [panto - yes|no]</tt><br> - <tt> [<ref>] [plot - <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> - <tt> [<ref>] [print]</tt><br> - <tt> [<ref>] [psky - <skyframe>]</tt><br> - <tt> [<ref>] [psystem - <coordsys>]</tt><br> - <tt> [<ref>] [ra - <col>]</tt><br> - <tt> [<ref>] - [regions]</tt><br> - <tt><tt> [<ref>] - [retrieve]</tt><br> - [<ref>] [samp]<br> - [<ref>] [samp - broadcast]<br> - [<ref>] [samp - send - <application>]</tt><tt><br> - </tt> - <tt> [<ref>] [save - <filename>]</tt><br> - <tt> [<ref>] - [server</tt> - <tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> - <tt> [<ref>] [show - yes|no]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> - [<ref>] [skyformat - <skyformat>]<br> - </tt> <tt> - [<ref>] [sort <col> - incr|decr]</tt><br> - <tt> [<ref>] [symbol - [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>]<br> - </tt> <tt> - [<ref>] [symbol [#] text|size|size2|units|angle - <value>]<br> - </tt> <tt><tt> - [<ref>] [symbol shape - circle|ellipse|box|text|point]<br> - </tt></tt> - <tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt>circle point|box point|diamond - point|</tt></tt></tt></tt>cross point|x point|arrow - point|boxcircle - point]<br> - </tt> - [<ref>] [symbol add| [#] remove]<br> - [<ref>] [symbol - save|load <filename>]</tt><br> - <tt> [<ref>] [system + 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> </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>] [update]</tt><br> - <tt> [<ref>] [x - <col>]</tt><br> - <tt> [<ref>] [y - <col>]</tt><br> - <tt> <br> - Example:<br> - string value = ds9.get(string cmd)<br> - catalog<br> - catalog header<br> - <br> - ds9.set(string cmd)<br> - </tt> <tt><tt>catalog new<br> - </tt> catalog - 2mass<br> - catalog cds 2mass<br> - catalog cds</tt> <tt>{I/252}</tt><br> - <tt><br> - </tt> <tt>catalog load foo.xml<br> - catalog import tsv foo.tsv<br> - <br> - </tt> <tt>catalog allrows<br> - catalog allcols<br> - </tt> <tt>catalog cancel<br> - </tt> <tt>catalog - clear<br> - </tt> <tt>catalog close<br> - </tt> <tt>catalog coordinate - 202.48 47.21 fk5<br> - </tt> <tt>catalog crosshair<br> - </tt> - <tt>catalog dec DEC<br> - </tt> <tt>catalog edit yes<br> - </tt> - <tt>catalog export tsv bar.tsv<br> - </tt> <tt>catalog filter - {$Jmag>10}<br> - catalog filter load foo.flt<br> - catalog header<br> - </tt> <tt>catalog location 500</tt><br> - <tt>catalog match error 2 arcsec<br> - catalog match function 1and2<br> - catalog match unique no<br> - catalog match return 1only<br> - </tt> <tt>catalog match # last two - catalogs loaded<br> - </tt> <tt>catalog match 2mass csc<br> - </tt> - <tt>catalog maxrows 2000<br> - </tt> <tt>catalog name m51<br> - catalog panto no<br> - </tt> <tt>catalog plot</tt> <tt>{$Jmag} {$Hmag} - {$e_Jmag} {$e_Hmag}</tt><tt><br> - </tt> <tt>catalog print</tt><br> - <tt>catalog psky fk5</tt><br> - <tt>catalog psystem wcs</tt><br> - <tt>catalog ra RA</tt><br> - <tt>catalog regions<br> - </tt> <tt>catalog retrieve<br> - </tt> - <tt>catalog samp broadcast<br> - catalog samp send aladin<br> - catalog save foo.xml<br> - </tt> <tt>catalog server sao<br> - </tt> - <tt>catalog show yes</tt><br> - <tt>catalog radius 1 degrees</tt><br> - <tt>catalog symbol condition</tt> <tt>{$Jmag>15}</tt><br> - <tt>catalog symbol 2 shape</tt> <tt>{boxcircle point}</tt><br> - <tt>catalog symbol color red<br> - catalog symbol font times<br> - </tt> <tt>catalog symbol fontsize - 14<br> - </tt> <tt>catalog symbol fontweight bold<br> - </tt> <tt>catalog - symbol fontslant italic<br> - </tt> <tt>catalog symbol add<br> - catalog symbol 2 remove<br> - catalog symbol load foo.sym<br> - catalog symbol save bar.sym</tt><tt><br> - catalog sky fk5<br> - catalog skyformat degrees<br> - </tt> <tt>catalog sort {Jmag} - incr<br> - </tt> <tt>catalog system wcs</tt><tt><br> - </tt> <tt>catalog - update<br> - </tt> <tt>catalog x RA<br> - catalog y DEC</tt><br> + </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]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> + + + + + + [<ref>] [match <ref> <ref>]</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> </tt><tt> + [<ref>] [retrieve]</tt><tt><br> + </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> </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> + [<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> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> catalog</tt><tt><br> + </tt><tt> catalog header</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog new</tt><tt><br> + </tt><tt> </tt><tt> catalog 2mass</tt><tt><br> + </tt><tt> catalog cds 2mass</tt><tt><br> + </tt><tt> catalog cds</tt><tt> </tt><tt>{I/252}</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog load foo.xml</tt><tt><br> + </tt><tt> catalog import tsv foo.tsv</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog allrows</tt><tt><br> + </tt><tt> catalog allcols</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog cancel</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog clear</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog close</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog coordinate 202.48 47.21 fk5</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog crosshair</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog dec DEC</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog edit yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog export tsv bar.tsv</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog filter {$Jmag>10}</tt><tt><br> + </tt><tt> catalog filter load foo.flt</tt><tt><br> + </tt><tt> catalog header</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog location 500</tt><tt><br> + </tt><tt> </tt><tt>catalog match error 2 arcsec</tt><tt><br> + </tt><tt> catalog match function 1and2</tt><tt><br> + </tt><tt> catalog match unique no</tt><tt><br> + </tt><tt> catalog match return 1only</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog match # last two catalogs + loaded</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog match 2mass csc</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog maxrows 2000</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog name m51</tt><tt><br> + </tt><tt> catalog panto no</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog plot</tt><tt> </tt><tt>{$Jmag} + + + + {$Hmag} {$e_Jmag} {$e_Hmag}</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog print</tt><tt><br> + </tt><tt> </tt><tt>catalog psky fk5</tt><tt><br> + </tt><tt> </tt><tt>catalog psystem wcs</tt><tt><br> + </tt><tt> </tt><tt>catalog ra RA</tt><tt><br> + </tt><tt> </tt><tt>catalog regions</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog retrieve</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog samp broadcast</tt><tt><br> + </tt><tt> catalog samp send aladin</tt><tt><br> + </tt><tt> catalog save foo.xml</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog server sao</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog show yes</tt><tt><br> + </tt><tt> </tt><tt>catalog radius 1 degrees</tt><tt><br> + </tt><tt> </tt><tt>catalog symbol condition</tt><tt> </tt><tt>{$Jmag>15}</tt><tt><br> + </tt><tt> </tt><tt>catalog symbol 2 shape</tt><tt> </tt><tt>{boxcircle + + + + point}</tt><tt><br> + </tt><tt> </tt><tt>catalog symbol color red</tt><tt><br> + </tt><tt> catalog symbol font times</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog symbol fontsize 14</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog symbol fontweight bold</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog symbol fontslant italic</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog symbol add</tt><tt><br> + </tt><tt> catalog symbol 2 remove</tt><tt><br> + </tt><tt> catalog symbol load foo.sym</tt><tt><br> + </tt><tt> catalog symbol save bar.sym</tt><tt><br> + </tt><tt> catalog sky fk5</tt><tt><br> + </tt><tt> catalog skyformat degrees</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog sort {Jmag} incr</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog system wcs</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog update</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>catalog x RA</tt><tt><br> + </tt><tt> catalog y DEC</tt><br> <p><b><a name="cd" id="cd"></a>cd</b></p> <p>Sets/Returns the current working directory.</p> <tt>Syntax:<br> @@ -730,8 +703,7 @@ <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> + 10 and bias value from 0 to 1.</p> <tt>Syntax:<br> cmap [<colormap>]<br> [file]<br> @@ -739,8 +711,8 @@ [save <filename>]<br> [invert yes|no]<br> [<constrast> <bias>]<br> - </tt> - <tt> [tag [load|save] <filename>]<br> + </tt> <tt> [tag [load|save] + <filename>]<br> [tag delete]</tt><br> <tt> [open|close]<br> <br> @@ -785,8 +757,7 @@ roman|italic]<br> [size]<br> [ticks]</tt><br> - <tt><tt> - [match]<br> + <tt><tt> [match]<br> [lock [yes|no]]</tt><br> <br> @@ -838,18 +809,17 @@ [save <filename> [<coordsys> <skyframe>]]<br> [convert]<br> - </tt> - <tt><tt> [load levels - <filename>]<br> - </tt></tt> - <tt><tt><tt> [save - levels - <filename>]<br> - </tt></tt> - [copy]<br> + </tt> <tt><tt> [load + levels <filename>]<br> + </tt></tt> <tt><tt><tt> + + + + + [save levels <filename>]<br> + </tt></tt> [copy]<br> [paste - [<coordsys> - <color> <width> yes|no]]<br> + [<coordsys> <color> <width> yes|no]]<br> [color <color>]<br> [width <width>]<br> [dash yes|no]<br> @@ -867,8 +837,7 @@ [limits <min> <max>]<br> [levels <value - value - value...>]<br> + value value...>]<br> [open|close]<br> <br> Example:<br> @@ -894,20 +863,14 @@ contour clear<br> contour generate<br> contour load ds9.ctr<br> - </tt> <tt><tt>contour save - ds9.con<br> - </tt></tt> <tt><tt><tt>contour save ds9.con wcs - fk5<br> + </tt> <tt><tt>contour save ds9.con<br> + </tt></tt> <tt><tt><tt>contour save ds9.con wcs fk5<br> </tt></tt> contour convert<br> - </tt> <tt><tt>contour load - levels ds9.ctr<br> - </tt></tt> <tt><tt><tt>contour save levels - ds9.lev<br> + </tt> <tt><tt>contour load levels ds9.ctr<br> + </tt></tt> <tt><tt><tt>contour save levels ds9.lev<br> </tt></tt> contour copy<br> - </tt> <tt><tt>contour - paste<br> - </tt></tt> <tt><tt><tt>contour paste wcs red 2 - no<br> + </tt> <tt><tt>contour paste<br> + </tt></tt> <tt><tt><tt>contour paste wcs red 2 no<br> </tt></tt> contour color yellow<br> contour width 2<br> contour dash yes<br> @@ -919,33 +882,35 @@ contour mode zscale<br> contour scope local<br> contour limits 1 100<br> - contour levels {1 10 100 1000}<br> + contour levels 1 10 100 1000<br> contour open<br> contour close<br> </tt> <p><b><a name="crop" id="crop"></a>crop</b></p> <p>Set current image display area.</p> - <tt>Syntax:<br> - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> - </tt> - <tt> [match <coordsys>]<br> - [lock + <tt>Syntax:</tt><tt><br> + </tt><tt> crop [<x> <y> <width> <height> + [<coordsys>][<skyframe>][degrees|arcmin|arcsec]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> + [match <coordsys>]</tt><tt><br> + </tt><tt> [lock <coordsys>|none]</tt><tt><br> - [reset]<br> - [3d</tt> <tt><tt>zmin zmax - <coordsys>]<br> - [open|close]</tt><br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - </tt> <tt>crop # get crop in - physical coords<br> - </tt> <tt>crop wcs galactic sexagesimal - arcsec<br> - crop lock<br> - </tt> <tt>ds9.set(string cmd)</tt><br> - <tt>crop 40 30 10 20 # set crop in physical coords<br> + </tt><tt> [reset]</tt><tt><br> + </tt><tt> [3d</tt><tt> </tt><tt>zmin + + + + zmax <coordsys>]</tt><tt><br> + </tt><tt> [open|close]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>crop # get crop in physical coords</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>crop wcs galactic sexagesimal + arcsec</tt><tt><br> + </tt><tt> crop lock</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> crop 40 30 10 20 # set crop in physical coords<br> crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs galactic arcsec<br> crop match wcs<br> @@ -962,9 +927,8 @@ <tt>Syntax:<br> crosshair [<x> <y> <coordsys> [<skyframe>]]<br> - </tt> - <tt> [match - <coordsys>]<br> + </tt> <tt> + [match <coordsys>]<br> [lock <coordsys>|none]</tt><br> <tt> <br> @@ -989,8 +953,7 @@ [<slice> [<coordsys>][<axis>]]<br> [interval <numeric>]<br> - </tt> - <tt> [match <coordsys>]<br> + </tt> <tt> [match <coordsys>]<br> [lock <coordsys>|none]</tt><br> <tt> [order 123|132|213|231|312|321]<br> [axes lock [yes|no]]</tt><br> @@ -1029,10 +992,8 @@ <p><b><a name="data" id="data"></a>data</b></p> <p>Return an array of data values given a lower left corner and a width and height in specified coordinate system. The last - argument - of yes indicates to strip the coordinates from the output and - just - list the data values. The default is yes.<br> + argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes.<br> </p> <tt>Syntax:<br> data [<coordsys> [<skyframe>] <x> <y> @@ -1044,8 +1005,7 @@ data physical 899 1039 6 6 no<br> data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 - no</tt><tt><br> + 0.00016516669 no</tt><tt><br> </tt> <p><b><a name="dsssao" id="dsssao"></a>dsssao<br> dss<br> @@ -1054,11 +1014,9 @@ <tt>Syntax:<br> dsssao []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -1077,10 +1035,8 @@ dsssao<br> dsssao m31<br> </tt> <tt><tt>dsssao name m31<br> - </tt></tt> - <tt><tt><tt>dsssao name clear<br> - </tt></tt> dsssao 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>dsssao name clear<br> + </tt></tt> dsssao 00:42:44.404 +41:16:08.78<br> dsssao size 60 60 arcmin<br> dsssao save yes<br> dsssao frame current<br> @@ -1093,11 +1049,9 @@ <tt>Syntax:<br> dsseso []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -1119,10 +1073,8 @@ dsseso<br> dsseso m31<br> </tt> <tt><tt>dsseso name m31<br> - </tt></tt> - <tt><tt><tt>dsseso name clear<br> - </tt></tt> dsseso 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>dsseso name clear<br> + </tt></tt> dsseso 00:42:44.404 +41:16:08.78<br> dsseso size 60 60 arcmin<br> dsseso save yes<br> dsseso frame current<br> @@ -1166,10 +1118,8 @@ dssstsci<br> dssstsci m31<br> </tt> <tt><tt>dssstsci name m31<br> - </tt></tt> - <tt><tt><tt>dssstsci name clear<br> - </tt></tt> dssstsci 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>dssstsci name clear<br> + </tt></tt> dssstsci 00:42:44.404 +41:16:08.78<br> dssstsci size 60 60 arcmin<br> dssstsci save yes<br> dssstsci frame current<br> @@ -1178,8 +1128,7 @@ dssstsci open<br> dssstsci close</tt><br> <p><b><a name="envi" id="envi"></a>envi</b></p> - <p>Load an ENVI header and file. Optional parameter: array - endian.<br> + <p>Load an ENVI header and file. Optional parameter: array endian.<br> </p> <tt>Syntax:<br> envi [new] <header> [<filename>]<br> @@ -1205,34 +1154,29 @@ <p>Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method.</p> - <tt>Syntax:</tt> <tt><br> - </tt> <tt>export</tt> - <tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> - <tt><filename></tt><tt><br> - </tt> <tt>export array - <filename></tt> - <tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt> <tt>export nrrd - <filename></tt> <tt>[big|little</tt><tt>|native]</tt><br> - <tt>export envi <header> [<filename>]</tt> - <tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt> <tt>export jpeg - <filename></tt> <tt>[1-100]</tt><tt><br> - </tt> <tt>export tiff - <filename</tt><tt>></tt> - <tt>[none|jpeg|packbits|deflate]</tt><br> - <tt> <br> - Example:<br> - </tt> <tt><tt><tt>ds9.set (string cmd)<br> - </tt> export - array foo.arr little</tt></tt><br> - <tt><tt>export nrrd foo.nrrd little<br> - export envi foo.hdr little<br> - export envi foo.hdr foo.bsq little<br> - </tt></tt> - <tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> - export jpeg foo.jpeg 75<br> - export png foo.png</tt><br> + <tt>Syntax:</tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>export</tt><tt> </tt><tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt><tt> + </tt><tt><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> </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><br> + </tt><tt> </tt><tt> </tt><tt>export jpeg <filename></tt><tt> + </tt><tt>[1-100]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>export tiff <filename</tt><tt>></tt><tt> + </tt><tt>[none|jpeg|packbits|deflate]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set (string cmd)</tt><tt><br> + </tt><tt> </tt><tt> export array foo.arr little</tt><tt><br> + </tt><tt> </tt><tt>export nrrd foo.nrrd little</tt><tt><br> + </tt><tt> export envi foo.hdr little</tt><tt><br> + </tt><tt> export envi foo.hdr foo.bsq little</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>export tiff foo.tiff jpeg</tt><tt><br> + </tt><tt> export jpeg foo.jpeg 75</tt><tt><br> + </tt><tt> export png foo.png</tt><br> <p><b><a name="file" id="file"></a>file</b></p> <p>Query currently loaded file information.</p> <tt>Syntax:<br> @@ -1247,10 +1191,8 @@ loaded image.<br> </p> <tt>Syntax:<br> - fits</tt> <tt><tt>[new|mask|slice] - [<filename>]</tt><tt><br> - </tt> - [width|height|depth|bitpix|type]<br> + fits</tt> <tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> + </tt> [width|height|depth|bitpix|type]<br> [size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> [header [<ext>] [keyword @@ -1276,8 +1218,7 @@ fits table</tt></tt><tt><br> fits slice<br> ds9.set(string cmd, string url)</tt><tt><tt><br> - </tt> fits - foo.fits<br> + </tt> fits foo.fits<br> fits new foo.fits<br> fits bar.fits[bin=detx,dety]<br> fits slice foo.fits<br> @@ -1289,10 +1230,8 @@ fits mask</tt> <p>Syntax:<br> </p> - <tt><tt>fits</tt> <tt><tt>[new|mask|slice] - [<filename>]</tt><tt><br> - </tt> - [width|height|depth|bitpix]<br> + <tt><tt>fits</tt> <tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> + </tt> [width|height|depth|bitpix]<br> [size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> [header [<ext>] [keyword @@ -1315,10 +1254,8 @@ fits<br> fits image<br> </tt> <tt><tt>fits table<br> - </tt></tt> - <tt><tt><tt>fits slice<br> - </tt></tt> ds9.set(string cmd, string - url)</tt><tt><br> + </tt></tt> <tt><tt><tt>fits slice<br> + </tt></tt> ds9.set(string cmd, string url)</tt><tt><br> fits foo.fits<br> fits new foo.fits<br> fits bar.fits[bin=detx,dety]<br> @@ -1327,12 +1264,10 @@ <br> </tt> <b><a name="frame" id="frame"></a>frame</b> <p>Controls frame functions. Frames may be created, deleted, - reset, - and centered. While return the current frame number. If you goto - a - frame that does not exists, it will be created. If the frame is - hidden, it will be shown. The 'frameno' option is available for - backward compatibility.</p> + 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> @@ -1360,15 +1295,13 @@ [has fits [ |bin|cube|mosaic]]<br> [has marker [highlite|paste|select|undo]]<br> - [has system - <coordsys>]<br> - </tt> - <tt><tt><tt><tt> [has wcs + [has system <coordsys>]<br> + </tt> <tt><tt><tt><tt> [has wcs [<wcssys>]]<br> - </tt> [has wcs - celestial [<wcssys>]]<br> - </tt> - [has wcs linear [<wcssys>]]<br> + </tt> [has wcs celestial + [<wcssys>]]<br> + </tt> [has wcs linear + [<wcssys>]]<br> </tt><br> Example:<br> string value = ds9.get(string cmd)<br> @@ -1431,14 +1364,12 @@ gif [new|slice] [<filename>]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> gif</tt><br> <tt><tt>ds9.set(string cmd)<br> </tt> gif foo.gif</tt><br> <tt><tt>gif new foo.gif<br> - </tt></tt> <tt><tt><tt>gif slice - foo.gif<br> + </tt></tt> <tt><tt><tt>gif slice foo.gif<br> </tt></tt> gif</tt><br> <tt><tt>gif</tt> <tt>new<br> </tt> gif</tt> <tt>slice</tt> @@ -1457,21 +1388,17 @@ [grid width <value>]<br> [grid dash yes|no]<br> [grid gap1 <value>]<br> - </tt> - <tt><tt> [grid gap2 + </tt> <tt><tt> [grid gap2 <value>]<br> - </tt></tt> - <tt><tt><tt> [grid gap3 - <value>]<br> - </tt></tt> [axes - yes|no]<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> + [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> @@ -1485,22 +1412,17 @@ [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 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 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> @@ -1514,17 +1436,13 @@ [title color <color>]<br> [labels yes|no]<br> [labels text1 <text>]<br> - </tt> - <tt><tt> [labels text2 + </tt> <tt><tt> [labels text2 <text>]<br> - </tt> [labels def1 - yes|no]<br> + </tt> [labels def1 yes|no]<br> [labels def2 yes|no]<br> - </tt> - <tt><tt> [labels gap1 + </tt> <tt><tt> [labels gap1 <value>]<br> - </tt> [labels gap2 - <value>]<br> + </tt> [labels gap2 <value>]<br> [labels font times|helvetica|courier]<br> [labels fontsize <value>]<br> @@ -1549,8 +1467,7 @@ grid grid dash<br> grid grid gap1<br> </tt> <tt><tt>grid grid gap2<br> - </tt></tt> - <tt><tt><tt>grid grid gap3<br> + </tt></tt> <tt><tt><tt>grid grid gap3<br> </tt></tt> grid axes<br> grid axes color<br> grid axes width<br> @@ -1574,11 +1491,9 @@ grid numerics fontslant<br> grid numerics color<br> grid numerics gap1<br> - </tt> <tt><tt>grid numerics - gap2<br> + </tt> <tt><tt>grid numerics gap2<br> </tt></tt> <tt><tt><tt>grid numerics gap3<br> - </tt></tt> - grid numerics type<br> + </tt></tt> grid numerics type<br> grid numerics vertical<br> grid title<br> grid title text<br> @@ -1592,12 +1507,10 @@ grid labels<br> grid labels text1<br> </tt> <tt><tt>grid labels text2<br> - </tt> grid - labels def1<br> + </tt> grid labels def1<br> grid labels def2<br> </tt> <tt><tt>grid labels gap1<br> - </tt> grid - labels gap2<br> + </tt> grid labels gap2<br> grid labels font<br> grid labels fontsize<br> grid labels fontweight<br> @@ -1616,8 +1529,7 @@ grid grid dash yes<br> grid grid gap1 10<br> </tt> <tt><tt>grid grid gap2 10<br> - </tt></tt> - <tt><tt><tt>grid grid gap3 10<br> + </tt></tt> <tt><tt><tt>grid grid gap3 10<br> </tt></tt> grid axes yes<br> grid axes color red<br> grid axes width 2<br> @@ -1641,11 +1553,9 @@ grid numerics fontslant italic<br> grid numerics color red<br> grid numerics gap1 10<br> - </tt> <tt><tt>grid numerics gap2 - 10<br> + </tt> <tt><tt>grid numerics gap2 10<br> </tt></tt> <tt><tt><tt>grid numerics gap3 10<br> - </tt></tt> - grid numerics type exterior<br> + </tt></tt> grid numerics type exterior<br> grid numerics vertical yes<br> grid title yes<br> grid title text {Hello World}<br> @@ -1658,13 +1568,11 @@ grid title color red<br> grid labels yes<br> grid labels text1 {Hello World}<br> - </tt> <tt><tt>grid labels text2 - {Hello World}<br> + </tt> <tt><tt>grid labels text2 {Hello World}<br> </tt> grid labels def1 yes<br> grid labels def2 yes<br> </tt> <tt><tt>grid labels gap1 10<br> - </tt> - grid labels gap2 10<br> + </tt> grid labels gap2 10<br> grid labels font courier<br> grid labels fontsize 12<br> grid labels fontweight bold<br> @@ -1717,41 +1625,40 @@ iconify yes</tt><br> <p><b><a name="iexam" id="iexam"></a>iexam</b></p> <p>Interactive examine function. A blinking cursor will indicate - to - the user to click on a point on an image. The specified - information - will be returned at that time. The default event is + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is <tt>button</tt>. In the last form, the following macros will be expanded if present: <tt>$width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, - $y, $z.</tt> See <a + $x, $y, $z.</tt> See <a href="file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis + + + + + Macros</a> for more information.</p> <tt>Syntax:<br> iexam []<br> - </tt> <tt><tt> - [[]|button|key|any] coordinate <coordsys> - [<skyframe>] + </tt> <tt><tt> [[]|button|key|any] + coordinate <coordsys> [<skyframe>] [<skyformat>]<br> [[]|button|key|any] data [width][height]<br> - </tt> <tt><tt> - [[]|button|key|any] <macro string>]<br> + </tt> <tt><tt> [[]|button|key|any] + <macro string>]<br> </tt></tt><br> Example:<br> string value = ds9.get(string cmd)<br> </tt> <tt><tt>iexam<br> - </tt> - iexam coordinate image<br> + </tt> iexam coordinate image<br> iexam key coordinate image # return coordinate and key event<br> iexam coordinate wcs fk5 degrees<br> iexam coordinate wcs galactic sexagesimal<br> iexam coordinate fk5<br> iexam data # return data value<br> iexam key data # return data value and key event<br> - iexam data 3 3 # return all data in 3x3 box about selected - point<br> + iexam data 3 3 # return all data in 3x3 box about selected point<br> iexam {'Click at $x,$y in file $filename'}</tt><br> <p><b><a name="iis" id="iis"></a>iis</b></p> <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> @@ -1766,78 +1673,71 @@ iis filename foo.fits<br> iis filename bar.fits 4</tt><br> <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> - <p>Load JPEG image into current frame. Optional parameters: - <tt>jpeg</tt> quality (1-100)</p> + <p>Load JPEG image into current frame. Optional parameters: <tt>jpeg</tt> + quality (1-100)</p> <tt>Syntax:<br> jpeg [new|slice] [<filename>] [1-100]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> jpeg</tt><br> <tt><tt>jpeg 100</tt><br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> - jpeg foo.jpeg</tt><br> + </tt> jpeg foo.jpeg</tt><br> <tt><tt>jpeg new foo.jpeg<br> - </tt></tt> <tt><tt><tt>jpeg slice - foo.jpeg<br> + </tt></tt> <tt><tt><tt>jpeg slice foo.jpeg<br> </tt></tt> jpeg</tt><br> <tt><tt>jpeg</tt> <tt>new<br> </tt> jpeg</tt> <tt>slice</tt> <p><b><a name="lock" id="lock"></a>lock</b></p> <p>Lock all other frames to the current frame.</p> - <tt>Syntax:<br> - </tt> <tt>lock</tt> <tt>[frame - <coordsys>|none]<br> - </tt> <tt>[crosshair - <coordsys>|none]</tt> <tt><br> - </tt> - <tt> [crop <coordsys>|none]</tt><br> - <tt> [slice <coordsys>|none]</tt><br> - <tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimits [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br> - </tt> - <tt> [smooth [yes|no]]</tt><tt><br> - </tt> - <tt> [3d [yes|no]]</tt><tt><br> - </tt> - <tt> </tt> <tt><br> - Example:<br> - </tt> <tt>string value = ds9.get(string cmd)<br> - </tt> - <tt>lock frame<br> - lock crosshair<br> - </tt> <tt>lock crop</tt><br> - <tt>lock slice</tt><br> - <tt>lock bin<br> - lock axes<br> - lock scale<br> - lock scalelimits<br> - lock color</tt><tt>bar<br> - lock block<br> - </tt> <tt>lock smooth<br> - </tt> <tt>lock 3d<br> - </tt> - <tt>ds9.set(string cmd)<br> - </tt> <tt>lock frame - wcs</tt><tt><br> - </tt> <tt>lock crosshair wcs<br> - </tt> <tt>lock crop - wcs</tt><br> - <tt>lock slice wcs</tt><br> - <tt>lock bin yes<br> - lock axes yes<br> - </tt> <tt>lock scale yes<br> - lock scalelimits yes<br> - </tt> <tt>lock colorbar yes</tt><tt><br> - lock block yes</tt><br> - <tt>lock smooth yes<br> - </tt> <tt>lock 3d yes<br> + <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> </tt><tt> [3d + [yes|no]]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock frame</tt><tt><br> + </tt><tt> lock crosshair</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock crop</tt><tt><br> + </tt><tt> </tt><tt>lock slice</tt><tt><br> + </tt><tt> </tt><tt>lock bin</tt><tt><br> + </tt><tt> lock axes</tt><tt><br> + </tt><tt> lock scale</tt><tt><br> + </tt><tt> lock scalelimits</tt><tt><br> + </tt><tt> lock color</tt><tt>bar</tt><tt><br> + </tt><tt> lock block</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock smooth</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock 3d</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock frame wcs</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock crosshair wcs</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock crop wcs</tt><tt><br> + </tt><tt> </tt><tt>lock slice wcs</tt><tt><br> + </tt><tt> </tt><tt>lock bin yes</tt><tt><br> + </tt><tt> lock axes yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock scale yes</tt><tt><br> + </tt><tt> lock scalelimits yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>lock colorbar yes</tt><tt><br> + </tt><tt> lock block yes</tt><tt><br> + </tt><tt> </tt><tt>lock smooth yes</tt><tt><br> + </tt><tt> </tt><tt> lock 3d yes<br> <br> </tt> <b><a name="lower" id="lower"></a>lower</b> <p>Lower in the window stacking order.</p> @@ -1876,8 +1776,10 @@ <p>Controls mask parameters.</p> <tt>Syntax:<br> mask [color <color>]<br> - [mark 1|0]<br> + [mark zero|nonzero|nan|nonnan|range]<br> + [range <low> <high>]<br> [transparency <value>]<br> + [system <coordsys>]<br> [clear]<br> [open|close]<br> <br> @@ -1885,11 +1787,15 @@ string value = ds9.get(string cmd)<br> mask color<br> mask mark<br> + mask range<br> + mask system<br> mask transparency<br> ds9.set(string cmd)<br> mask color red<br> - mask mark 0<br> + mask mark zero<br> + mask range 10 100<br> mask transparency 50<br> + mask system wcs<br> mask clear<br> mask open<br> mask close<br> @@ -1897,17 +1803,12 @@ <p><b><a name="match" id="match"></a>match</b></p> <p>Match all other frames to the current frame.</p> <tt>Syntax:<br> - </tt> <tt>match</tt> <tt>[frame - <coordsys>]<br> + </tt> <tt>match</tt> <tt>[frame <coordsys>]<br> </tt> <tt>[crosshair <coordsys>]</tt> <tt><br> - </tt> - <tt> [crop <coordsys>]<br> - </tt> - <tt> [slice - <coordsys>]<br> - </tt> <tt> - [bin]<br> + </tt> <tt> [crop <coordsys>]<br> + </tt> <tt> [slice <coordsys>]<br> + </tt> <tt> [bin]<br> [axes]<br> [scale]<br> [scalelimits]<br> @@ -1919,8 +1820,7 @@ Example:<br> ds9.set(string cmd)<br> </tt> <tt>match frame wcs<br> - </tt> <tt>match - crosshair wcs<br> + </tt> <tt>match crosshair wcs<br> </tt> <tt>match crop wcs</tt><br> <tt>match slice wcs<br> match bin<br> @@ -1940,11 +1840,9 @@ <br> Example:</tt><br> <tt>string value = ds9.get(string cmd)</tt><tt><tt><br> - </tt> - mecube<br> + </tt> mecube<br> </tt> <tt><tt><tt>ds9.set(string cmd)<br> - </tt></tt> - mecube foo.fits</tt><br> + </tt></tt> mecube foo.fits</tt><br> <tt><tt>mecube new foo.fits<br> </tt> mecube</tt><br> <tt>mecube</tt> <tt>new</tt> @@ -1983,16 +1881,13 @@ mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> mosaic</tt><tt><br> - </tt> <tt><tt>ds9.set(string - cmd)<br> + </tt> <tt><tt>ds9.set(string cmd)<br> </tt> mosaic foo.fits</tt><br> <tt><tt>mosaic wcs foo.fits</tt></tt><br> <tt><tt>mosaic wcs new foo.fits</tt></tt><br> - <tt><tt>mosaic wcs mask - foo.fits</tt></tt><tt><tt><tt><br> + <tt><tt>mosaic wcs mask foo.fits</tt></tt><tt><tt><tt><br> </tt></tt> mosaic</tt><br> <tt><tt>mosaic wcs<br> mosaic wcs</tt> <tt>new<br> @@ -2005,40 +1900,36 @@ [<filename>]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> mosaicimage</tt><tt><br> - </tt> <tt><tt>ds9.set(string - cmd)<br> + </tt> <tt><tt>ds9.set(string cmd)<br> </tt> mosaicimage foo.fits</tt><br> <tt><tt>mosaicimage wcs foo.fits</tt></tt><br> <tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> - <tt><tt>mosaicimage wcs mask - foo.fits</tt></tt><tt><tt><tt><br> + <tt><tt>mosaicimage wcs mask foo.fits</tt></tt><tt><tt><tt><br> </tt></tt> mosaicimage</tt><br> <tt><tt>mosaicimage wcs<br> mosaicimage wcs new</tt><tt><br> </tt> mosaicimage wcs mask</tt> <p><b><a name="movie" id="movie"></a>movie</b></p> - <p>Create mpeg1 movie from snap shots of the DS9 window. A - <tt>slice</tt> movie cycles though all slices of a cube. A - <tt>frame</tt> movie cycles through all active frames. A - <tt>3d</tt> movie cycles through specified viewing angles. The - default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.</p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A <tt>slice</tt> + movie cycles though all slices of a cube. A <tt>frame</tt> + movie cycles through all active frames. A <tt>3d</tt> movie + cycles through specified viewing angles. The default is <tt>frame</tt>. + Optional parameters for <tt>3d</tt>: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.</p> <tt>Syntax:<br> movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br> - </tt> - <tt>movie 3d <filename> + </tt> <tt>movie 3d <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>]</tt><br> <tt> <br> Example:<br> ds9.set(string cmd)<br> movie slice ds9.mpg<br> - </tt> <tt>movie 3d ds9.mpg number 10 azfrom - -60 azto 60 oscillate 1</tt><br> + </tt> <tt>movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate + 1</tt><br> <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> <p>Load FITS multiple extension file as multiple images.<br> </p> @@ -2047,19 +1938,16 @@ <br> Example:<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> multiframe - foo.fits</tt><tt><tt><br> + </tt> multiframe foo.fits</tt><tt><tt><br> </tt> multiframe</tt><br> <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> <p>Support Name Server functions. Coordinates are in fk5.</p> <tt>Syntax:<br> nameserver [<object>]<br> - [name - <object>]<br> + [name <object>]<br> - [server - ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> + [server ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> [skyformat degrees|sexagesimal]<br> @@ -2103,17 +1991,13 @@ nrrd [new|mask] [<filename>]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> nrrd</tt><br> <tt><tt>nrrd big<br> - </tt></tt> <tt><tt><tt>ds9.set(string - cmd</tt><tt>, string url</tt><tt>)<br> - </tt> nrrd - foo.nrrd</tt></tt><br> + </tt></tt> <tt><tt><tt>ds9.set(string cmd</tt><tt>, string url</tt><tt>)<br> + </tt> nrrd foo.nrrd</tt></tt><br> <tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt>nrrd mask - foo.nrrd<br> + <tt><tt><tt><tt><tt><tt>nrrd mask foo.nrrd<br> </tt></tt></tt></tt></tt> nrrd</tt><br> <tt>nrrd</tt> <tt>new<br> nrrd mask</tt><br> @@ -2142,10 +2026,8 @@ nvss<br> nvss m31<br> </tt> <tt><tt>nvss name m31<br> - </tt></tt> - <tt><tt><tt>nvss name clear<br> - </tt></tt> nvss 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>nvss name clear<br> + </tt></tt> nvss 00:42:44.404 +41:16:08.78<br> nvss size 60 60 arcmin<br> nvss save yes<br> nvss frame current<br> @@ -2231,10 +2113,8 @@ <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> + 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> @@ -2243,423 +2123,372 @@ </blockquote> <p>To create a new plot, use the plot new command.</p> <tt>Syntax:</tt><tt><br> - </tt> <tt># create new empty plot - window</tt><tt><br> - </tt> <tt>plot []</tt><tt><br> - </tt> - <tt> [line|bar|scatter]</tt><tt><br> - </tt> - <tt> [new]</tt><tt><br> - </tt> - <tt> [new - line|bar|scatter]</tt><tt><br> - </tt> <tt> - [new name <plotname>]</tt><tt><br> - </tt> - <tt> [new name <plotname> + </tt><tt> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot []</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> + [line|bar|scatter]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new line|bar|scatter]</tt><tt><br> - </tt> <tt><br> - </tt> <tt>#</tt> - <tt>load data into existing plot from stdin</tt><tt><br> - </tt> - <tt>plot [[<plotname>] data + </tt><tt> </tt><tt> </tt><tt> [new name + <plotname>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new name + <plotname> line|bar|scatter]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>#</tt><tt> </tt><tt>load data into + existing plot from stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot [[<plotname>] data xy|xyex|xyey|xyexey]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># existing - plot</tt><tt><br> - </tt> <tt>plot</tt> <tt>[[<plotname>] load - <filename> xy|xyex|xyey|xyexey]</tt><tt><br> - </tt> - <tt> [[<plotname>] save - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] - duplicate - [#]]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] stats yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] list - yes|no]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] loadconfig - <filename>]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] pagesetup orient - portrait|landscape]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] - print]</tt><tt><br> - </tt> <tt> - [[<plotname>] print destination - printer|file]</tt><tt><br> - </tt> <tt> - [[<plotname>] print command - <command>]</tt><tt><br> - </tt> <tt> - [[<plotname>] print filename - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + close</tt><tt>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> - </tt> - <tt><br> - </tt> <tt># configure graph</tt><tt><br> - </tt> <tt>plot - [[<plotname>] axis x|y grid yes|no]</tt><tt><br> - </tt> - <tt> [[<plotname>] axis x|y log - yes|no]</tt><tt><br> - </tt> <tt> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + + mode pointer|zoom]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </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> [[<plotname>] axis x|y auto - yes|no]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] axis x|y max - <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] axis x|y format - <string>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] legend yes|no]</tt><tt><br> - </tt> - <tt> [[<plotname>] legend position - right|left|top|bottom]</tt><tt><br> - </tt> <tt> + </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> + </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> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>size <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>weight normal|bold]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>slant roman|italic]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] title x|y - <string>]</tt><tt><br> - </tt> <tt> - [</tt><tt>[<plotname>] barmode - normal|stacked|aligned|overlap]</tt><tt><br> - </tt> <tt><br> - </tt> - <tt># configure current dataset</tt><tt><br> - </tt> <tt>plot - [[<plotname>] show yes|no]</tt><tt><br> - </tt> <tt> - </tt> <tt>[[<plotname>] shape - circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> - </tt> <tt> </tt> <tt>[[<plotname>] - shape fill yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] shape - color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] smooth - step|linear|cubic|quadratic|catrom]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] color - <value>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] dash + </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>[[<plotname>] error yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] error + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + shape 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> - [[<plotname>] color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] error + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] name - <string>]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># select - current dataset</tt><tt><br> - </tt> <tt>plot [[<plotname>] - select <value>]</tt><tt><br> - </tt> <tt> </tt> <tt><br> - </tt> <tt>Example:</tt><tt><br> - </tt> <tt># return all - plotnames</tt><tt><br> - </tt> <tt>string value = ds9.get(string - cmd)</tt><tt><br> - </tt> <tt>plot</tt><tt><br> - </tt> <tt><br> - </tt> - <tt># create new empty plot window</tt><tt><br> - </tt> - <tt>ds9.set(string cmd)</tt><tt><br> - </tt> - <tt>plot</tt><tt><br> - </tt> <tt>plot bar</tt><tt><br> - </tt> <tt>plot - new</tt><tt><br> - </tt> <tt>plot new bar</tt><tt><br> - </tt> <tt>plot - new name foo</tt><tt><br> - </tt> <tt>plot new name foo - bar</tt><tt><br> - </tt> <tt><br> - </tt> <tt># load additional dataset - into an existing plot</tt><tt><br> - </tt> <tt>ds9.set(string cmd, - string url)</tt><tt><br> - </tt> <tt>plot data xy # plot additional - data</tt><tt><br> - </tt> <tt>plot foo data xy # plot additional + </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> + [[<plotname>] color <value>]</tt><tt><br> + </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> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>Example:</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># return all plotnames</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot bar</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot new</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot new bar</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot new name foo</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot new name foo bar</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># load additional dataset into an + existing plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd, string url)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot data xy # plot additional data</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot foo data xy # plot additional data</tt><tt><br> - </tt> <tt><br> - </tt> <tt>string value = - ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot - stats</tt><tt><br> - </tt> <tt>plot list</tt><tt><br> - </tt> - <tt>ds9.set(string cmd)</tt><tt><br> - </tt> <tt>plot load foo.dat - xy</tt><tt><br> - </tt> <tt>plot save foo.dat</tt><tt><br> - </tt> - <tt>plot clear</tt><tt><br> - </tt> <tt>plot duplicate - 1</tt><tt><br> - </tt> <tt>plot stats yes</tt><tt><br> - </tt> <tt>plot - list yes</tt><tt><br> - </tt> <tt>plot loadconfig - foo.plt</tt><tt><br> - </tt> <tt>plot saveconfig - foo.plt</tt><tt><br> - </tt> <tt>plot pagesetup orient - portrait</tt><tt><br> - </tt> <tt>plot pagesetup size - letter</tt><tt><br> - </tt> <tt>plot print</tt><tt><br> - </tt> <tt>plot - print destination file</tt><tt><br> - </tt> <tt>plot print command - lp</tt><tt><br> - </tt> <tt>plot print filename - foo.ps</tt><tt><br> - </tt> <tt>plot print color rgb</tt><tt><br> - </tt> - <tt>plot close</tt><tt><br> - </tt> <tt><br> - </tt> <tt>string value = - ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot - mode</tt><tt><br> - </tt> <tt>ds9.set(string cmd)</tt><tt><br> - </tt> - <tt>plot mode pointer</tt><tt><br> - </tt> <tt><br> - </tt> <tt># - configure plot</tt><tt><br> - </tt> <tt>string value = ds9.get(string - cmd)</tt><tt><br> - </tt> <tt>plot axis x grid</tt><tt><br> - </tt> - <tt>plot axis x log</tt><tt><br> - </tt> <tt>plot axis x - flip</tt><tt><br> - </tt> <tt>plot axis x auto</tt><tt><br> - </tt> - <tt>plot axis x min</tt><tt><br> - </tt> <tt>plot axis x - max</tt><tt><br> - </tt> <tt>plot axis x format</tt><tt><br> - </tt> - <tt>plot legend</tt><tt><br> - </tt> <tt>plot legend - position</tt><tt><br> - </tt> <tt>plot font numbers - font</tt><tt><br> - </tt> <tt>plot font numbers size</tt><tt><br> - </tt> - <tt>plot font numbers weight</tt><tt><br> - </tt> <tt>plot font - numbers slant</tt><tt><br> - </tt> <tt>plot title</tt><tt><br> - </tt> - <tt>plot title x</tt><tt><br> - </tt> <tt>plot - barmode</tt><tt><br> - </tt> <tt>ds9.set(string cmd)</tt><tt><br> - </tt> - <tt>plot axis x grid yes</tt><tt><br> - </tt> <tt>plot axis x log - yes</tt><tt><br> - </tt> <tt>plot axis x flip yes</tt><tt><br> - </tt> - <tt>plot axis x auto no</tt><tt><br> - </tt> <tt>plot axis x min - 0</tt><tt><br> - </tt> <tt>plot axis x max 100</tt><tt><br> - </tt> - <tt>plot axis x format "%f"</tt><tt><br> - </tt> <tt><br> - </tt> - <tt>string value = ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot - legend</tt><tt><br> - </tt> <tt>plot legend position</tt><tt><br> - </tt> - <tt>ds9.set(string cmd)</tt><tt><br> - </tt> <tt>plot legend - yes</tt><tt><br> - </tt> <tt>plot legend position - left</tt><tt><br> - </tt> <tt><br> - </tt> <tt>string value = - ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot font numbers - font</tt><tt><br> - </tt> <tt>plot font numbers size</tt><tt><br> - </tt> - <tt>plot font numbers weight</tt><tt><br> - </tt> <tt>plot font - numbers slant</tt><tt><br> - </tt> <tt>ds9.set(string - cmd)</tt><tt><br> - </tt> <tt>plot font numbers font - times</tt><tt><br> - </tt> <tt>plot font numbers size - 12</tt><tt><br> - </tt> <tt>plot font numbers weight - bold</tt><tt><br> - </tt> <tt>plot font numbers slant - italic</tt><tt><br> - </tt> <tt><br> - </tt> <tt>string value = - ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot - title</tt><tt><br> - </tt> <tt>plot title xaxis</tt><tt><br> - </tt> - <tt>plot title yaxis</tt><tt><br> - </tt> <tt>ds9.set(string - cmd)</tt><tt><br> - </tt> <tt>plot title "This is a - Title"</tt><tt><br> - </tt> <tt>plot title x "X - Axis"</tt><tt><br> - </tt> <tt>plot title y "Y Axis"</tt><tt><br> - </tt> - <tt>plot title legend "This is the Legend"</tt><tt><br> - </tt> - <tt><br> - </tt> <tt>string value = ds9.get(string - cmd)</tt><tt><br> - </tt> <tt>plot barmode</tt><tt><br> - </tt> - <tt>ds9.set(string cmd)</tt><tt><br> - </tt> <tt>plot barmode - aligned</tt><tt><br> - </tt> <tt><br> - </tt> <tt># configure current - dataset</tt><tt><br> - </tt> <tt>string value = ds9.get(string - cmd)</tt><tt><br> - </tt> <tt>plot show</tt><tt><br> - </tt> <tt>plot - shape</tt><tt><br> - </tt> <tt>plot shape fill</tt><tt><br> - </tt> - <tt>plot shape color</tt><tt><br> - </tt> <tt>plot - smooth</tt><tt><br> - </tt> <tt>plot color</tt><tt><br> - </tt> <tt>plot - width</tt><tt><br> - </tt> <tt>plot dash</tt><tt><br> - </tt> <tt>plot - error</tt><tt><br> - </tt> <tt>plot error color</tt><tt><br> - </tt> - <tt>plot error width</tt><tt><br> - </tt> <tt>plot - name</tt><tt><br> - </tt> <tt>ds9.set(string cmd)</tt><tt><br> - </tt> - <tt>plot show yes</tt><tt><br> - </tt> <tt>plot shape - circle</tt><tt><br> - </tt> <tt>plot shape fill no</tt><tt><br> - </tt> - <tt>plot shape color cyan</tt><tt><br> - </tt> <tt>plot smooth - step</tt><tt><br> - </tt> <tt>plot color red</tt><tt><br> - </tt> - <tt>plot width 2</tt><tt><br> - </tt> <tt>plot dash - yes</tt><tt><br> - </tt> <tt>plot error yes</tt><tt><br> - </tt> <tt>plot - error color red</tt><tt><br> - </tt> <tt>plot error width - 2</tt><tt><br> - </tt> <tt>plot name "My Data"</tt><tt><br> - </tt> - <tt><br> - </tt> <tt># select current dataset</tt><tt><br> - </tt> - <tt>string value = ds9.get(string cmd)</tt><tt><br> - </tt> <tt>plot - select</tt><tt><br> - </tt> <tt>ds9.set(string cmd)<br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot stats</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot list</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot load foo.dat xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot save foo.dat</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot clear</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot duplicate 1</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot stats yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot list yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot loadconfig foo.plt</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot saveconfig foo.plt</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot pagesetup orient portrait</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot pagesetup size letter</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot print</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot print destination file</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot print command lp</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot print filename foo.ps</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot print color rgb</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot close</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot mode</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot mode pointer</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># configure plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x grid</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x log</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x flip</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x auto</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x min</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x max</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x format</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend position</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers font</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers size</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers weight</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers slant</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title x</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot barmode</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x grid yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x log yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x flip yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x auto no</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x min 0</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x max 100</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot axis x format "%f"</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend position</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot legend position left</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers font</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers size</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers weight</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers slant</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers font times</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers size 12</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers weight bold</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot font numbers slant italic</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title xaxis</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title yaxis</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title "This is a Title"</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title x "X Axis"</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title y "Y Axis"</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot title legend "This is the + Legend"</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot barmode</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>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>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot show</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape fill</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot smooth</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot width</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot dash</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error width</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot name</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot show yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape circle</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape fill no</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot shape color cyan</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot smooth step</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot color red</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot width 2</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot dash yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error color red</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot error width 2</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>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>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot select</tt><tt><br> + </tt><tt> </tt><tt> ds9.set(string cmd)<br> plot select 2<br> <br> </tt> <b><a name="png" id="png"></a>png</b> <p>Load PNG image into current frame.<br> </p> - <tt>Syntax:<br> - png [new|slice] [<filename>]<br> - <br> - Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> - </tt> png</tt><br> - <tt><tt>ds9.set(string cmd)<br> - </tt> png foo.png</tt><br> - <tt><tt>png new foo.png<br> - </tt></tt> <tt><tt><tt>png slice - foo.png<br> - </tt></tt> png</tt><br> - <tt><tt>png</tt> <tt>new<br> - </tt> png</tt> <tt>slice</tt><br> + <tt>Syntax:</tt><tt><br> + </tt><tt> png [new|slice] [<filename>]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> png</tt><tt><br> + </tt><tt> </tt><tt>ds9.set(string cmd)</tt><tt><br> + </tt><tt> </tt><tt> png foo.png</tt><tt><br> + </tt><tt> </tt><tt>png new foo.png</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>png slice foo.png</tt><tt><br> + </tt><tt> </tt><tt> png</tt><tt><br> + </tt><tt> </tt><tt>png</tt><tt> </tt><tt>new</tt><tt><br> + </tt><tt> </tt><tt> png</tt><tt> </tt><tt>slice</tt><br> <p><b><a name="precision" id="precision"></a>precision</b></p> <p>Set region and coordinate output format precision.</p> <tt>Syntax:<br> precision <linear></tt> <tt><tt><degree></tt></tt> - <tt><tt><hms></tt></tt> - <tt><tt><tt><dms></tt></tt></tt> - <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><arcsec><br> + <tt><tt><hms></tt></tt> <tt><tt><tt><dms></tt></tt></tt> + <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> <tt><tt><tt><tt><tt><arcsec><br> <br> </tt></tt></tt></tt> Example:<br> string value = ds9.get(string cmd)<br> @@ -2705,8 +2534,7 @@ [filename <filename>]<br> [color rgb|cmyk|gray]<br> [level 1|2]<br> - [resolution - 53|72|75|150|300|600]<br> + [resolution 53|72|75|150|300|600]<br> <br> Example:<br> string value = ds9.get(string cmd)<br> @@ -2767,12 +2595,10 @@ [skyformat degrees|sexagesimal]<br> [strip yes|no]<br> - [shape - <shape>]<br> + [shape <shape>]<br> [color &ltcolor>]<br> - [width - <width>]<br> + [width <width>]<br> </tt> <tt> [fixed|edit|rotate|delete yes|no]<br> @@ -2784,8 +2610,7 @@ [template <filename>]<br> [template <filename> - at - <ra> <dec> <coordsys> <skyframe>]<br> + at <ra> <dec> <coordsys> <skyframe>]<br> [savetemplate <filename>]<br> [groups]<br> @@ -2794,13 +2619,11 @@ new]<br> [group <tag> update]<br> - [group <tag> - select]<br> + [group <tag> select]<br> [group <tag> color <color>]<br> [group <tag> copy]<br> - [group <tag> - delete]<br> + [group <tag> delete]<br> [group <tag> cut]<br> [group <tag> font <font>]<br> @@ -2811,8 +2634,7 @@ [group <tag> moveback]<br> [group <tag> - property - <property> yes|no]<br> + property <property> yes|no]<br> [copy]<br> [cut]<br> [paste @@ -2968,8 +2790,7 @@ rgb channel red # set current channel to red<br> rgb view blue no # turn off blue channel<br> rgb system wcs # set rgb coordinate system<br> - </tt> <tt>rgb lock - wcs yes</tt><br> + </tt> <tt>rgb lock wcs yes</tt><br> <tt>rgb lock crop yes</tt><br> <tt>rgb lock slice yes</tt><br> <tt>rgb lock bin yes</tt><br> @@ -2989,16 +2810,13 @@ [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> <br> Example:<br> - </tt> <tt><tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt><tt>string value = ds9.get(string cmd)<br> </tt></tt> rgbarray<br> rgbarray little<br> - </tt> <tt><tt><tt>ds9.set(string - cmd)<br> + </tt> <tt><tt><tt>ds9.set(string cmd)<br> </tt></tt> rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> - rgbarray new - foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> + rgbarray new foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> <p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> <p>Load FITS rgbcube into rgb frame.<br> </p> @@ -3006,12 +2824,10 @@ rgbcube [new] [<filename>]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> rgbcube<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> - rgbcube foo.fits</tt><br> + </tt> rgbcube foo.fits</tt><br> <tt><tt>rgbcube new foo.fits<br> </tt> rgbcube</tt><br> <tt>rgbcube</tt> <tt>new</tt><br> @@ -3022,18 +2838,15 @@ rgbimage [new] [<filename>]<br> <br> Example:<br> - </tt> <tt><tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt><tt>string value = ds9.get(string cmd)<br> </tt></tt> rgbimage<br> - </tt> <tt><tt><tt>ds9.set(string - cmd)<br> + </tt> <tt><tt><tt>ds9.set(string cmd)<br> </tt></tt> rgbimage foo.fits</tt><br> <tt><tt>rgbimage new foo.fits<br> </tt> rgbimage</tt><br> <tt>rgbimage</tt> <tt>new</tt> <p><b><a name="rotate" id="rotate"></a>rotate</b></p> - <p>Controls the rotation angle (in degrees) of the current - frame.</p> + <p>Controls the rotation angle (in degrees) of the current frame.</p> <tt>Syntax:<br> rotate [<value>]<br> [to <value>]<br> @@ -3057,11 +2870,9 @@ <br> Example:<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> samp - no<br> + </tt> samp no<br> </tt> <tt><tt>samp disconnect<br> - </tt> samp broadcast - image<br> + </tt> samp broadcast image<br> samp send image aladin</tt> <p><b><a name="save" id="save"></a>save<br> </b></p> @@ -3072,14 +2883,12 @@ <tt> <br> Example:<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> save - foo.fits</tt><br> + </tt> save foo.fits</tt><br> <tt>save fits foo.fits image</tt><br> <tt>save fits foo.fits table<br> save fits foo.fits slice</tt><br> <tt>save rgbimage foo.fits<br> - </tt> <tt>save rgbcube - foo.fits</tt><br> + </tt> <tt>save rgbcube foo.fits</tt><br> <tt>save mecube foo.fits</tt><br> <tt>save mosaic foo.fits</tt><br> <tt>save mosaicimage foo.fits</tt><br> @@ -3090,8 +2899,7 @@ 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</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> @@ -3186,69 +2994,67 @@ </b> <p>Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.</p> - <tt>Syntax:<br> - sia</tt> - <tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> - <br> - </tt> <tt> </tt><tt> - [<ref>] [cancel]<br> - </tt> <tt> - [<ref>] [clear]<br> - </tt> <tt> - [<ref>] [close]</tt><br> - <tt> [<ref>] - [coordinate - <ra> <dec> <coordsys>]</tt><tt><br> - </tt> - <tt> </tt> - <tt>[<ref>] [crosshair]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt> <tt> - [<ref>] [name <object>]<br> - </tt> - <tt> [<ref>] [print]</tt><br> - <tt><tt> [<ref>] - [retrieve]</tt><br> - </tt> - <tt> [<ref>] [save - <filename>]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> - [<ref>] [skyformat - <skyformat>]<br> - </tt> <tt> - [<ref>] [system + last search created, unless indicated otherwise.</p> + <tt>Syntax:</tt><tt><br> + </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>[<ref>] [update]</tt><br> - <tt><br> - Example:<br> - string value = ds9.get(string cmd)<br> - sia<br> - <br> - ds9.set(string cmd)<br> - sia</tt> <tt>2mass<br> - sia</tt> <tt>cancel<br> - sia</tt> <tt>clear<br> - sia</tt> <tt>close<br> - sia</tt> <tt>coordinate 202.48 47.21 fk5<br> - sia</tt> <tt>crosshair<br> - sia</tt> <tt>export tsv bar.tsv<br> - sia</tt> <tt>name m51<br> - sia</tt> <tt>print</tt><br> - <tt>sia</tt> <tt>retrieve<br> - sia</tt> <tt>save foo.xml<br> - sia</tt> <tt>radius 1degrees</tt><br> - <tt>sia</tt> <tt>sky fk5<br> - sia skyformat degrees<br> - sia</tt> <tt>system wcs</tt><tt><br> - sia</tt> <tt>update<br> + </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> string value = ds9.get(string cmd)</tt><tt><br> + </tt><tt> sia</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> ds9.set(string cmd)</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>2mass</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>cancel</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>clear</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>close</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>coordinate 202.48 47.21 fk5</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>crosshair</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>export tsv bar.tsv</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>name m51</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>print</tt><tt><br> + </tt><tt> </tt><tt>sia</tt><tt> </tt><tt>retrieve</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>save foo.xml</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>radius 1degrees</tt><tt><br> + </tt><tt> </tt><tt>sia</tt><tt> </tt><tt>sky fk5</tt><tt><br> + </tt><tt> sia skyformat degrees</tt><tt><br> + </tt><tt> sia</tt><tt> </tt><tt>system wcs</tt><tt><br> + </tt><tt> sia</tt><tt> update<br> <br> </tt> <b><a name="single" id="single"></a>single</b> <p>Select Single Display mode</p> @@ -3269,8 +3075,7 @@ [name <object>|clear]<br> [<ra> - <dec>] - # in wcs fk5<br> + <dec>] # in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [pixels <width> @@ -3295,10 +3100,8 @@ skyview<br> skyview m31<br> </tt> <tt><tt>skyview name m31<br> - </tt></tt> - <tt><tt><tt>skyview name clear<br> - </tt></tt> skyview 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>skyview name clear<br> + </tt></tt> skyview 00:42:44.404 +41:16:08.78<br> skyview size 60 60 arcmin<br> skyview pixels 600 600<br> skyview save yes<br> @@ -3331,25 +3134,38 @@ [yes|no]<br> [function boxcar|tophat|gaussian]<br> - </tt> - <tt> [radius + </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> + </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> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt> [angle + + + + + <value>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt> - <tt> [match]<br> + </tt></tt></tt></tt></tt></tt></tt></tt> <tt> + + + + + [match]<br> [lock [yes|no]]</tt><br> <tt><tt> [open|close]<br> </tt><br> @@ -3358,8 +3174,7 @@ smooth<br> smooth function<br> </tt> <tt><tt>smooth radius<br> - </tt></tt> - <tt><tt><tt>smooth radiusminor<br> + </tt></tt> <tt><tt><tt>smooth radiusminor<br> smooth sigma<br> smooth sigmaminor<br> smooth angle<br> @@ -3368,19 +3183,26 @@ smooth<br> smooth yes<br> smooth function tophat<br> - </tt> <tt><tt>smooth radius - 4<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>smooth radiusminor - 4<br> - </tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigma - 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigmaminor - 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth angle - 45<br> + </tt> <tt><tt>smooth radius 4<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>smooth radiusminor 4<br> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth + + + + + sigma 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth + + + + + sigmaminor 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth + + + + + angle 45<br> </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> smooth open<br> smooth close<br> @@ -3405,8 +3227,7 @@ <br> Example:<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> tcl {puts - {Hello, World}}<br> + </tt> tcl {puts {Hello, World}}<br> </tt> <p><b><a name="threads" id="threads"></a>threads</b></p> <p>Set number of process threads for functions which are @@ -3416,24 +3237,20 @@ <br> Example:<br> </tt> <tt>string value = ds9.get(string cmd)<br> - </tt> - <tt>threads</tt><br> + </tt> <tt>threads</tt><br> <tt>ds9.set(string cmd)<br> </tt> <tt>threads 8</tt><br> <p><b><a name="tiff" id="tiff"></a>tiff</b></p> - <p>Load TIFF image into current frame. Optional parameters: - <tt>tiff</tt> compression method.</p> + <p>Load TIFF image into current frame. Optional parameters: <tt>tiff</tt> + compression method.</p> <tt>Syntax:<br> - tiff [new|slice] [<filename>] - [none|jpeg|packbits|deflate]<br> + tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate]<br> <br> Example:<br> - </tt> <tt><tt>string value = ds9.get(string - cmd)<br> + </tt> <tt><tt>string value = ds9.get(string cmd)<br> </tt> tiff</tt><br> <tt><tt>tiff jpeg</tt><br> - </tt> <tt><tt>ds9.set(string - cmd)<br> + </tt> <tt><tt>ds9.set(string cmd)<br> </tt> tiff foo.tiff<br> tiff new foo.tiff<br> tiff slice foo.tiff</tt><tt><tt><br> @@ -3478,9 +3295,8 @@ 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> + 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> @@ -3500,8 +3316,7 @@ <br> Example:<br> </tt> <tt><tt>ds9.set(string cmd)<br> - </tt> url - http://foo.bar.edu/foo.fits</tt> + </tt> url http://foo.bar.edu/foo.fits</tt> <p><b><a name="version" id="version"></a>version</b></p> <p>Returns the current version of DS9.</p> <tt>Syntax:<br> @@ -3532,8 +3347,7 @@ [units yes|no]<br> [image|physical|wcs|wcsa...wcsz yes|no]<br> - </tt> <tt><tt> [frame - yes|no]<br> + </tt> <tt><tt> [frame yes|no]<br> </tt> [red yes|no]<br> [green yes|no]<br> [blue yes|no]<br> @@ -3575,8 +3389,7 @@ view units yes<br> view wcsa yes<br> </tt> <tt><tt>view frame yes<br> - </tt> view red - yes<br> + </tt> view red yes<br> view green yes<br> view blue yes</tt><br> <p><b><a name="vla" id="vla"></a>vla</b></p> @@ -3588,8 +3401,7 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> @@ -3608,8 +3420,7 @@ vla<br> vla m31<br> </tt> <tt><tt>vla name m31<br> - </tt></tt> <tt><tt><tt>vla - name clear<br> + </tt></tt> <tt><tt><tt>vla name clear<br> </tt></tt> vla 00:42:44.404 +41:16:08.78<br> vla size 60 60 arcmin<br> vla save yes<br> @@ -3644,10 +3455,8 @@ vlss<br> vlss m31<br> </tt> <tt><tt>vlss name m31<br> - </tt></tt> - <tt><tt><tt>vlss name clear<br> - </tt></tt> vlss 00:42:44.404 - +41:16:08.78<br> + </tt></tt> <tt><tt><tt>vlss name clear<br> + </tt></tt> vlss 00:42:44.404 +41:16:08.78<br> vlss size 60 60 arcmin<br> vlss save yes<br> vlss frame current<br> @@ -3688,16 +3497,12 @@ <p><b><a name="wcs" id="wcs"></a>wcs</b></p> <p>Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info - panel, - compass, grid, and alignment will be modified accordingly. Also, - using this access point, a new WCS specification can be loaded - and - used by the current image regardless of the WCS that was - contained - in the image file. WCS specification can be sent to DS9 as an - ASCII - file . Please see <a href="file.html#WCS">WCS</a> for more - information.</p> + panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see <a + href="file.html#WCS">WCS</a> for more information.</p> <tt>Syntax:<br> wcs [[system] wcs|wcsa...wcsz]<br> [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> @@ -3719,11 +3524,9 @@ wcs wcs<br> wcs system wcs<br> </tt> <tt>wcs fk5<br> - </tt> <tt>wcs sky - fk5<br> + </tt> <tt>wcs sky fk5<br> </tt> <tt>wcs sexagesimal<br> - </tt> <tt>wcs skyformat - sexagesimal<br> + </tt> <tt>wcs skyformat sexagesimal<br> wcs align yes<br> wcs reset<br> wcs reset 3<br> @@ -3743,8 +3546,7 @@ web</tt> <tt><tt>[]<br> [<url>]<br> [new <webname> <url>]<br> - </tt> - [<webname>] [click + </tt> [<webname>] [click back|forward|stop|reload|#]<br> [<webname>] [clear]<br> [<webname>] [close]<br> diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index 44335ff..9fd8f80 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -9,23 +9,19 @@ 2.4.7-10 i686) [Netscape]"> <title>XPA Access Points</title> </head> - <body vlink="#551A8B" link="#0000FF" alink="#FF0000"> - <h3><img alt="" src="../sun.gif" width="100" height="98" - align="middle"> XPA Access Points</h3> + <body alink="#FF0000" link="#0000FF" vlink="#551A8B"> + <h3><img alt="" src="../sun.gif" align="middle" height="98" + width="100"> XPA Access Points</h3> <blockquote> <p>The <a href="http://hea-www.harvard.edu/RD/xpa/index.html">XPA</a> - messaging - system provides seamless communication between DS9 and other - Unix - programs, including X programs, Perl, <a + messaging system provides seamless communication between DS9 and + other Unix programs, including X programs, Perl, <a href="http://space.mit.edu/cxc/software/slang/modules/xpa/">S-Lang,</a> and Tcl/Tk. It also provides an easy way for users to - communicate - with DS9 by executing XPA client commands in the shell or by - utilizing such commands in scripts. Because XPA works both at - the - programming level and the shell level, it is a powerful tool for - unifying any analysis environment.</p> + communicate with DS9 by executing XPA client commands in the + shell or by utilizing such commands in scripts. Because XPA + works both at the programming level and the shell level, it is a + powerful tool for unifying any analysis environment.</p> <tt><a href="#2mass">2mass</a><br> <a href="#3d">3d</a><br> <a href="#about">about</a><br> @@ -136,16 +132,13 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> [survey j|h|k]<br> - </tt> - <tt> [open|close]<br> - </tt> - <tt> <br> + </tt> <tt> [open|close]<br> + </tt> <tt> <br> Example:<br> $xpaget ds9 2mass name<br> $xpaget ds9 2mass coord<br> @@ -155,19 +148,15 @@ $xpaget ds9 2mass survey<br> $xpaset -p ds9 2mass<br> </tt> <tt>$xpaset -p ds9 2mass m31<br> - </tt> - <tt><tt>$xpaset -p ds9 2mass name m31<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9 2mass name clear<br> - </tt></tt> $xpaset - -p ds9 2mass 00:42:44.404 +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 2mass name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 2mass name clear<br> + </tt></tt> $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 2mass size 60 60 arcmin<br> $xpaset -p ds9 2mass save yes<br> $xpaset -p ds9 2mass frame current<br> $xpaset -p ds9 2mass update frame<br> $xpaset -p ds9 2mass survey j<br> - </tt> <tt>$xpaset -p ds9 2mass - open<br> + </tt> <tt>$xpaset -p ds9 2mass open<br> $xpaset -p ds9 2mass close</tt><br> <p><b><a name="3d"></a>3d</b></p> <p>Support for 3D frame.</p> @@ -179,19 +168,15 @@ [scale <scale>]<br> [method mip|aip]</tt><br> <tt><tt> [background none|azimuth|elevation]<br> - </tt> - </tt><tt> [border yes|no]<br> + </tt> </tt><tt> [border yes|no]<br> [border color <color>]</tt><br> <tt> [highlite yes|no]<br> [highlite color <color>]<br> - </tt> - <tt><tt> </tt><tt> [compass yes|no]<br> + </tt> <tt><tt> </tt><tt> [compass yes|no]<br> [compass color <color>]</tt><br> - </tt> - <tt><tt><tt> [match]<br> + </tt> <tt><tt><tt> [match]<br> [lock [yes|no]]<br> - </tt></tt> - [open|close]<br> + </tt></tt> [open|close]<br> </tt> <tt> <br> Example:<br> $xpaget ds9 3d view<br> @@ -199,44 +184,38 @@ $xpaget ds9 3d el<br> $xpaget ds9 3d scale<br> $xpaget ds9 3d method<br> - </tt> <tt>$xpaget ds9 3d - background<br> + </tt> <tt>$xpaget ds9 3d background<br> </tt> <tt>$xpaget ds9 3d border<br> $xpaget ds9 3d border color</tt><br> <tt>$xpaget ds9 3d highlite<br> $xpaget ds9 3d highlite color<br> - </tt> <tt><tt>$xpaget ds9 3d - compass<br> - </tt></tt> <tt><tt><tt><tt>$xpaget ds9 3d compass - color</tt><br> - </tt></tt></tt> <tt><tt><tt><tt><tt>$xpaget ds9 3d - lock</tt><br> - </tt></tt></tt> $xpaset -p ds9 3d # create new 3D - frame<br> + </tt> <tt><tt>$xpaget ds9 3d compass<br> + </tt></tt> <tt><tt><tt><tt>$xpaget ds9 3d compass color</tt><br> + </tt></tt></tt> <tt><tt><tt><tt><tt>$xpaget ds9 3d lock</tt><br> + </tt></tt></tt> $xpaset -p ds9 3d # create new 3D frame<br> $xpaset -p ds9 3d view 45 30<br> $xpaset -p ds9 3d az 45<br> $xpaset -p ds9 3d el 30<br> $xpaset -p ds9 3d scale 10<br> $xpaset -p ds9 3d method mip</tt><br> <tt>$xpaset -p ds9 3d background azimuth<br> - </tt> <tt>$xpaset -p - ds9 3d border yes<br> + </tt> <tt>$xpaset -p ds9 3d border yes<br> $xpaset -p ds9 3d border color red</tt><br> <tt>$xpaset -p ds9 3d highlite yes<br> $xpaset -p ds9 3d highlite color red<br> - </tt> <tt><tt><tt>$xpaset - -p ds9 3d compass yes<br> - </tt></tt></tt> - <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d compass color - red</tt><br> - </tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d - match</tt></tt></tt></tt></tt></tt></tt></tt><br> + </tt> <tt><tt><tt>$xpaset -p ds9 3d compass yes<br> + </tt></tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d + compass color red</tt><br> + </tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt>$xpaset + + + + + -p ds9 3d match</tt></tt></tt></tt></tt></tt></tt></tt><br> <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d lock yes</tt><br> </tt></tt></tt></tt></tt></tt></tt></tt></tt> - $xpaset - -p ds9 3d open<br> + $xpaset -p ds9 3d open<br> $xpaset -p ds9 3d close<br> </tt> <p><b><a name="about" id="about"></a>about</b></p> @@ -261,8 +240,7 @@ <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> + and display text in the text dialog window.</p> <tt>Syntax:<br> analysis [<task number>]<br> @@ -278,8 +256,7 @@ ok|okcancel|yesno <message>]<br> [entry <message>]<br> - - [text]</tt><tt><tt><br> + [text]</tt><tt><tt><br> <br> </tt> Example:<br> $xpaget ds9 analysis<br> @@ -311,10 +288,8 @@ $xpaget ds9 array > foo.arr<br> $xpaget ds9 array little > foo.arr<br> $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]<br> - $xpaset -p ds9 array new - foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> - <tt><tt>$xpaset -p ds9 array mask - foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><br> + $xpaset -p ds9 array new foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt><tt>$xpaset -p ds9 array mask foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><br> <tt>$cat foo.arr | xpaset ds9 array [dim=512,bitpix=-32,endian=little]</tt><br> <tt>$cat foo.arr | xpaset ds9 array new @@ -340,8 +315,7 @@ <p><b><a name="bin" id="bin"></a>bin</b></p> <p>Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking - is - provided for backward compatibility.</p> + is provided for backward compatibility.</p> <tt>Syntax:<br> bin [about <x> <y>]<br> [about center]<br> @@ -351,10 +325,8 @@ [factor <value> [<vector>]]<br> [depth <value>]<br> [filter <string>]<br> - </tt> - <tt><tt> [filter clear]<br> - </tt> - [function average|sum]<br> + </tt> <tt><tt> [filter clear]<br> + </tt> [function average|sum]<br> [in]<br> [out]<br> [to fit]<br> @@ -417,8 +389,7 @@ <value>]<br> [in]<br> [out]<br> - </tt> - [to fit]<br> + </tt> [to fit]<br> [match]<br> [lock [yes|no]]<br> [open|close]<br> @@ -426,41 +397,34 @@ Example:<br> $xpaget ds9 block<br> $xpaget ds9 block lock<br> - </tt> <tt>$xpaset -p ds9</tt> - <tt><tt><tt>block</tt></tt> 4<br> + </tt> <tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4<br> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4 2<br> - </tt> - <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to - 4<br> + </tt> <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> + to 4<br> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to 4 2<br> - </tt> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> in<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> + </tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> in<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> out<br> - </tt></tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> - to fit<br> + </tt></tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to + fit<br> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> match<br> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> lock yes<br> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> open<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> - close</tt><tt><br> + $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> close</tt><tt><br> </tt> <p><b><a name="catalog" id="catalog"></a>catalog<br> cat<br> </b></p> <p>Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.</p> + new catalog search. All other commands operated on the last + search created, unless indicated otherwise.</p> <tt>Syntax:<br> catalog [new]<br> [ned|simbad|denis|skybot]<br> [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - - [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> + [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> [2mass|iras]<br> [csc|xmm|rosat]<br> [first|nvss]<br> @@ -474,31 +438,30 @@ [import sb|tsv <filename>]<br> <br> - </tt> <tt><tt> - [<ref>] [<ra> <dec> - <coordsys>]</tt><tt><br> - </tt> - [<ref>] [allcols]<br> - </tt> - <tt> </tt><tt> [<ref>] - [allrows]<br> + </tt> <tt><tt> [<ref>] + [<ra> <dec> <coordsys>]</tt><tt><br> + </tt> [<ref>] [allcols]<br> + </tt> <tt> </tt><tt> + [<ref>] [allrows]<br> </tt><tt> [<ref>] [cancel]<br> - </tt> <tt> - [<ref>] [clear]<br> - </tt> <tt> - [<ref>] [close]</tt><br> - <tt> </tt> - <tt>[<ref>] [crosshair]</tt><br> + </tt> <tt> [<ref>] + [clear]<br> + </tt> <tt> [<ref>] [close]</tt><br> + <tt> </tt> <tt>[<ref>] + + + + + [crosshair]</tt><br> <tt> [<ref>] [dec <col>]</tt><br> <tt> [<ref>] [edit yes|no]</tt><br> <tt> [<ref>] [export sb|tsv <filename>]<br> - </tt> - <tt> [<ref>] - [filter <string>]<br> + </tt> <tt> + [<ref>] [filter <string>]<br> [<ref>] [filter load <filename>]</tt><br> <tt> [<ref>] @@ -507,28 +470,45 @@ <code>]</tt><br> <tt><tt> [<ref>] [match]<br> - </tt></tt> - <tt><tt><tt> + </tt></tt> <tt><tt><tt> + + + + + [<ref>] [match <ref> <ref>]<br> - </tt></tt> - </tt> <tt>[<ref>] + </tt></tt> </tt> <tt>[<ref>] [match + + + + + error <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt> - <tt>[<ref>] [match function 1and2|1not2|2not1]<br> - </tt> - <tt> </tt> - <tt>[<ref>] [match return 1and2|1only|2only]</tt><br> - <tt> </tt> - <tt>[<ref>] [match unique yes|no]</tt><br> + <tt> </tt> <tt>[<ref>] + + + + + [match function 1and2|1not2|2not1]<br> + </tt> <tt> </tt> <tt>[<ref>] + + + + + [match return 1and2|1only|2only]</tt><br> + <tt> </tt> <tt>[<ref>] + + + + + [match unique yes|no]</tt><br> <tt> [<ref>] [maxrows <number>]</tt><br> <tt> [<ref>] [name <object>]<br> - </tt> - <tt> [<ref>] - [panto - yes|no]</tt><br> + </tt> <tt> + [<ref>] [panto yes|no]</tt><br> <tt> [<ref>] [plot <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> <tt> [<ref>] [print]</tt><br> @@ -538,55 +518,60 @@ <coordsys>]</tt><br> <tt> [<ref>] [ra <col>]<br> - [<ref>] - [regions]</tt><br> - <tt> [<ref>] - [retrieve]</tt><br> + [<ref>] [regions]</tt><br> + <tt> [<ref>] [retrieve]</tt><br> <tt> [<ref>] [samp]<br> [<ref>] [samp broadcast]<br> [<ref>] [samp - send - <application>]</tt><tt><br> - </tt> - <tt> [<ref>] [save - <filename>]</tt><br> + send <application>]</tt><tt><br> + </tt> <tt> + [<ref>] [save <filename>]</tt><br> <tt> [<ref>] - [server - cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><br> + [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><br> <tt> [<ref>] [show yes|no]</tt><br> <tt> [<ref>] [radius <value> degrees|arcmin|arcsec]</tt><br> <tt> [<ref>] [sky <skyframe>]<br> - </tt> <tt> - [<ref>] [skyformat - <skyformat>]<br> - </tt> <tt> - [<ref>] [sort <col> - incr|decr]</tt><br> + </tt> <tt> [<ref>] + [skyformat <skyformat>]<br> + </tt> <tt> [<ref>] + [sort <col> incr|decr]</tt><br> <tt> [<ref>] [symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>]<br> - </tt> <tt> - [<ref>] [symbol [#] text|size|size2|units|angle - <value>]<br> - </tt> <tt> - [<ref>] [symbol shape circle|ellipse|box|text|point]<br> + </tt> <tt> [<ref>] + [symbol [#] text|size|size2|units|angle <value>]<br> + </tt> <tt> [<ref>] + [symbol shape circle|ellipse|box|text|point]<br> </tt> <tt><tt>[<ref>] [symbol - shape</tt></tt> <tt><tt>circle point|box point|diamond - point|</tt>cross point|x point|arrow point|boxcircle point]<br> + + + + + + shape</tt></tt> <tt><tt>circle point|box point|diamond point|</tt>cross + + + + + point|x point|arrow point|boxcircle point]<br> [<ref>] [symbol add| [#] remove]<br> [<ref>] [symbol save|load <filename>]</tt><br> <tt> [<ref>] [system <coordsys>]</tt><tt><br> - </tt> <tt> - </tt> <tt>[<ref>] [update]</tt><br> + </tt> <tt> </tt> <tt>[<ref>] + + + + + [update]</tt><br> <tt> [<ref>] [x <col>]</tt><br> <tt> [<ref>] [y @@ -594,12 +579,10 @@ <tt> <br> Example:<br> $xpaget ds9 catalog<br> - </tt> <tt>$xpaget ds9 catalog - header</tt><br> + </tt> <tt>$xpaget ds9 catalog header</tt><br> <tt><br> </tt> <tt><tt>$xpaset -p ds9 catalog new<br> - </tt> $xpaset - -p ds9 catalog 2mass<br> + </tt> $xpaset -p ds9 catalog 2mass<br> $xpaset -p ds9 catalog cds 2mass<br> $xpaset -p ds9 catalog cds {I/252}<br> <br> @@ -607,79 +590,58 @@ $xpaset -p ds9 catalog import tsv foo.tsv<br> <br> </tt> <tt><tt>$xpaset -p ds9 catalog 202.48 47.21 fk5<br> - </tt> - $xpaset -p ds9 catalog allrows<br> + </tt> $xpaset -p ds9 catalog allrows<br> $xpaset -p ds9 catalog allcols<br> - </tt> <tt>$xpaset -p ds9 catalog - cancel<br> + </tt> <tt>$xpaset -p ds9 catalog cancel<br> </tt> <tt>$xpaset -p ds9 catalog clear<br> - </tt> - <tt>$xpaset -p ds9 catalog close<br> - </tt> <tt>$xpaset -p ds9 - catalog crosshair<br> - </tt> <tt>$xpaset -p ds9 catalog dec - DEC<br> + </tt> <tt>$xpaset -p ds9 catalog close<br> + </tt> <tt>$xpaset -p ds9 catalog crosshair<br> + </tt> <tt>$xpaset -p ds9 catalog dec DEC<br> </tt> <tt>$xpaset -p ds9 catalog edit yes<br> - </tt> - <tt>$xpaset -p ds9 catalog export tsv bar.tsv<br> - </tt> <tt>$xpaset - -p ds9 catalog filter '$Jmag>10'<br> + </tt> <tt>$xpaset -p ds9 catalog export tsv bar.tsv<br> + </tt> <tt>$xpaset -p ds9 catalog filter '$Jmag>10'<br> $xpaset -p ds9 catalog filter load foo.flt<br> $xpaset -p ds9 catalog header<br> - </tt> <tt>$xpaset -p ds9 catalog - location 500</tt><br> + </tt> <tt>$xpaset -p ds9 catalog location 500</tt><br> <tt>$xpaset -p ds9 catalog match error 2 arcsec<br> $xpaset -p ds9 catalog match function 1and2<br> $xpaset -p ds9 catalog match unique no<br> $xpaset -p ds9 catalog match return 1only<br> - </tt> <tt>$xpaset -p - ds9 catalog match # last two catalogs loaded<br> - </tt> <tt>$xpaset - -p ds9 catalog match 2mass csc<br> - </tt> <tt>$xpaset -p ds9 catalog - maxrows 2000<br> + </tt> <tt>$xpaset -p ds9 catalog match # last two catalogs loaded<br> + </tt> <tt>$xpaset -p ds9 catalog match 2mass csc<br> + </tt> <tt>$xpaset -p ds9 catalog maxrows 2000<br> </tt> <tt>$xpaset -p ds9 catalog name m51<br> $xpaset -p ds9 catalog panto no<br> - </tt> <tt>$xpaset -p ds9 catalog - plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag'<br> - </tt> <tt>$xpaset -p - ds9 catalog print</tt><br> + </tt> <tt>$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' + '$e_Hmag'<br> + </tt> <tt>$xpaset -p ds9 catalog print</tt><br> <tt>$xpaset -p ds9 catalog psky fk5</tt><br> <tt>$xpaset -p ds9 catalog psystem wcs</tt><br> <tt>$xpaset -p ds9 catalog ra RA<br> $xpaset -p ds9 catalog regions</tt><br> <tt>$xpaset -p ds9 catalog retrieve<br> - </tt> <tt>$xpaset -p ds9 - catalog samp broadcast<br> + </tt> <tt>$xpaset -p ds9 catalog samp broadcast<br> $xpaset -p ds9 catalog samp send aladin<br> $xpaset -p ds9 catalog save foo.xml<br> - </tt> <tt>$xpaset -p ds9 - catalog server sao<br> - </tt> <tt>$xpaset -p ds9 catalog show - yes</tt><br> + </tt> <tt>$xpaset -p ds9 catalog server sao<br> + </tt> <tt>$xpaset -p ds9 catalog show yes</tt><br> <tt>$xpaset -p ds9 catalog radius 1 degrees</tt><br> <tt>$xpaset -p ds9 catalog symbol condition '$Jmag>15'<br> $xpaset -p ds9 catalog symbol 2 shape {boxcircle point}<br> $xpaset -p ds9 catalog symbol color red<br> $xpaset -p ds9 catalog symbol font times<br> - </tt> <tt>$xpaset -p - ds9 catalog symbol fontsize 14<br> - </tt> <tt>$xpaset -p ds9 catalog - symbol fontweight bold<br> - </tt> <tt>$xpaset -p ds9 catalog symbol - fontslant italic<br> + </tt> <tt>$xpaset -p ds9 catalog symbol fontsize 14<br> + </tt> <tt>$xpaset -p ds9 catalog symbol fontweight bold<br> + </tt> <tt>$xpaset -p ds9 catalog symbol fontslant italic<br> </tt> <tt>$xpaset -p ds9 catalog symbol add<br> $xpaset -p ds9 catalog symbol 2 remove<br> $xpaset -p ds9 catalog symbol load foo.sym<br> $xpaset -p ds9 catalog symbol save bar.sym</tt><tt><br> $xpaset -p ds9 catalog sky fk5<br> $xpaset -p ds9 catalog skyformat degrees<br> - </tt> <tt>$xpaset -p - ds9 catalog sort {Jmag} incr<br> - </tt> <tt>$xpaset -p ds9 catalog - system wcs</tt><tt><br> - </tt> <tt>$xpaset -p ds9 catalog - update<br> + </tt> <tt>$xpaset -p ds9 catalog sort {Jmag} incr<br> + </tt> <tt>$xpaset -p ds9 catalog system wcs</tt><tt><br> + </tt> <tt>$xpaset -p ds9 catalog update<br> </tt> <tt>$xpaset -p ds9 catalog x RA<br> $xpaset -p ds9 catalog y DEC</tt><br> <p><b><a name="cd" id="cd"></a>cd</b></p> @@ -694,21 +656,17 @@ <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> + 10 and bias value from 0 to 1.</p> <tt>Syntax:<br> cmap [<colormap>]<br> [file]<br> [load <filename>]<br> - </tt> - <tt> [save <filename>]<br> - </tt> - <tt> [invert yes|no]<br> + </tt> <tt> [save <filename>]<br> + </tt> <tt> [invert yes|no]<br> [<constrast> <bias>]<br> [tag [load|save] <filename>]<br> [tag delete]<br> - </tt> - <tt> [open|close]<br> + </tt> <tt> [open|close]<br> <br> Example:<br> $xpaget ds9 cmap<br> @@ -717,15 +675,13 @@ $xpaget ds9 cmap value<br> </tt> <tt>$xpaset -p ds9 cmap Heat<br> $xpaset -p ds9 cmap load foo.sao<br> - </tt> <tt>$xpaset -p ds9 cmap - save bar.sao<br> + </tt> <tt>$xpaset -p ds9 cmap save bar.sao<br> </tt> <tt>$xpaset -p ds9 cmap invert yes<br> $xpaset -p ds9 cmap 5 .5<br> $xpaset -p ds9 cmap tag load foo.tag<br> $xpaset -p ds9 cmap tag save foo.tag<br> $xpaset -p ds9 cmap tag delete<br> - </tt> <tt>$xpaset -p ds9 cmap - open<br> + </tt> <tt>$xpaset -p ds9 cmap open<br> $xpaset -p ds9 cmap close<br> </tt> <p><b><a name="colorbar" id="colorbar"></a>colorbar<br> @@ -751,22 +707,21 @@ roman|italic]<br> [size]<br> [ticks]</tt><br> - <tt><tt> - [match]<br> + <tt><tt> [match]<br> [lock [yes|no]]</tt><br> </tt> <tt> </tt><br> - Example:<br> - $xpaget ds9 colorbar<br> - $xpaget ds9 colorbar orientation<br> - $xpaget ds9 colorbar numerics<br> - $xpaget ds9 colorbar space<br> - $xpaget ds9 colorbar font<br> - $xpaget ds9 colorbar fontsize<br> - $xpaget ds9 colorbar fontweight<br> - $xpaget ds9 colorbar fontslant<br> - $xpaget ds9 colorbar size<br> - $xpaget ds9 colorbar ticks<br> + <tt>Example:</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar orientation</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar numerics</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar space</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar font</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar fontsize</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar fontweight</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar fontslant</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar size</tt><tt><br> + </tt><tt> $xpaget ds9 colorbar ticks</tt><br> <tt><tt>$xpaget ds9 colorbar lock</tt><br> $xpaset -p ds9 colorbar yes<br> $xpaset -p ds9 colorbar vertical<br> @@ -811,8 +766,7 @@ <filename>]<br> [copy]<br> [paste - [<coordsys> - <color> <width> yes|no]]<br> + [<coordsys> <color> <width> yes|no]]<br> [color <color>]<br> [width <width>]<br> [dash yes|no]<br> @@ -829,8 +783,7 @@ [limits <min> <max>]<br> [levels <value - value - value...>]<br> + value value...>]<br> [open|close]<br> <br> Example:<br> @@ -852,21 +805,16 @@ $xpaset -p ds9 contour yes<br> $xpaset -p ds9 contour clear<br> $xpaset -p ds9 contour generate<br> - </tt> <tt><tt>$xpaset -p ds9 - contour load ds9.ctr<br> - </tt></tt> <tt><tt>$xpaset -p ds9 contour - save ds9.ctr<br> - </tt> $xpaset -p ds9 contour save ds9.ctr wcs - fk5<br> + </tt> <tt><tt>$xpaset -p ds9 contour load ds9.ctr<br> + </tt></tt> <tt><tt>$xpaset -p ds9 contour save ds9.ctr<br> + </tt> $xpaset -p ds9 contour save ds9.ctr wcs fk5<br> $xpaset -p ds9 contour convert<br> $xpaset -p ds9 contour load levels ds9.ctr</tt><br> <tt><tt>$xpaset -p ds9 contour save levels ds9.lev<br> - </tt> $xpaset - -p ds9 contour copy<br> - </tt> <tt><tt>$xpaset -p ds9 contour - paste<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 contour paste wcs - red 2 no<br> + </tt> $xpaset -p ds9 contour copy<br> + </tt> <tt><tt>$xpaset -p ds9 contour paste<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 contour paste wcs red 2 + no<br> </tt></tt> $xpaset -p ds9 contour color yellow<br> $xpaset -p ds9 contour width 2<br> $xpaset -p ds9 contour dash yes<br> @@ -878,7 +826,7 @@ $xpaset -p ds9 contour mode zscale<br> $xpaset -p ds9 contour scope local<br> $xpaset -p ds9 contour limits 1 100<br> - $xpaset -p ds9 contour levels {1 10 100 1000}<br> + $xpaset -p ds9 contour levels 1 10 100 1000<br> $xpaset -p ds9 contour open<br> $xpaset -p ds9 contour close<br> </tt> @@ -902,10 +850,8 @@ 22.000204 wcs galactic arcsec<br> $xpaset -p ds9 crop match wcs<br> $xpaset -p ds9 crop lock wcs<br> - </tt> <tt>$xpaset -p ds9 crop - reset<br> - </tt> <tt><tt>$xpaset -p ds9 crop 3d .25 .50 - wcs</tt></tt><br> + </tt> <tt>$xpaset -p ds9 crop reset<br> + </tt> <tt><tt>$xpaset -p ds9 crop 3d .25 .50 wcs</tt></tt><br> <tt>$xpaset -p ds9 crop open</tt><br> <tt>$xpaset -p ds9 crop close</tt> <p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> @@ -978,10 +924,8 @@ <p><b><a name="data" id="data"></a>data</b></p> <p>Return an array of data values given a lower left corner and a width and height in specified coordinate system. The last - argument - of yes indicates to strip the coordinates from the output and - just - list the data values. The default is yes.</p> + argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes.</p> <tt>Syntax:<br> data [<coordsys> [<skyframe>] <x> <y> <width> <height> [yes|no]]<br> @@ -1001,11 +945,9 @@ <tt>Syntax:<br> dsssao []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -1021,29 +963,23 @@ $xpaget ds9 dsssao frame<br> $xpaset -p ds9 dsssao<br> $xpaset -p ds9 dsssao m31<br> - </tt> <tt><tt>$xpaset -p ds9 dsssao - name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsssao name - clear<br> - </tt></tt> $xpaset -p ds9 dsssao 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 dsssao name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsssao name clear<br> + </tt></tt> $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 dsssao size 60 60 arcmin<br> $xpaset -p ds9 dsssao save yes<br> $xpaset -p ds9 dsssao frame current<br> $xpaset -p ds9 dsssao update frame<br> $xpaset -p ds9 dsssao open<br> - </tt> <tt>$xpaset -p ds9 dsssao - close</tt><br> + </tt> <tt>$xpaset -p ds9 dsssao close</tt><br> <p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> <p>Support for Digital Sky Survey at ESO.</p> <tt>Syntax:<br> dsseso []<br> [<object>]<br> - [name - <object>|clear]<br> + [name <object>|clear]<br> [<ra> <dec>] # - in - wcs fk5<br> + in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> @@ -1062,20 +998,16 @@ $xpaget ds9 dsseso survey<br> $xpaset -p ds9 dsseso<br> $xpaset -p ds9 dsseso m31<br> - </tt> <tt><tt>$xpaset -p ds9 dsseso - name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsseso name - clear<br> - </tt></tt> $xpaset -p ds9 dsseso 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 dsseso name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsseso name clear<br> + </tt></tt> $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 dsseso size 60 60 arcmin<br> $xpaset -p ds9 dsseso save yes<br> $xpaset -p ds9 dsseso frame current<br> $xpaset -p ds9 dsseso update frame<br> $xpaset -p ds9 dsseso survey DSS2-red<br> $xpaset -p ds9 dsseso open<br> - </tt> <tt>$xpaset -p ds9 dsseso - close</tt><br> + </tt> <tt>$xpaset -p ds9 dsseso close</tt><br> <p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> <p>Support for Digital Sky Survey at STSCI.</p> <tt>Syntax:<br> @@ -1109,12 +1041,9 @@ $xpaget ds9 dssstsci survey<br> $xpaset -p ds9 dssstsci<br> $xpaset -p ds9 dssstsci m31<br> - </tt> <tt><tt>$xpaset -p ds9 - dssstsci name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dssstsci - name clear<br> - </tt></tt> $xpaset -p ds9 dssstsci 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 dssstsci name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 dssstsci name clear<br> + </tt></tt> $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 dssstsci size 60 60 arcmin<br> $xpaset -p ds9 dssstsci save yes<br> $xpaset -p ds9 dssstsci frame current<br> @@ -1123,8 +1052,7 @@ $xpaset -p ds9 dssstsci open<br> $xpaset -p ds9 dssstsci close</tt><br> <p><b><a name="envi" id="envi"></a>envi</b></p> - <p>Load an ENVI header and file. Optional parameter: array - endian.<br> + <p>Load an ENVI header and file. Optional parameter: array endian.<br> </p> <tt>Syntax:<br> envi [new] <header> [<filename>]<br> @@ -1132,8 +1060,7 @@ Example:<br> </tt> <tt><tt>$xpaset -p ds9 envi foo.hdr</tt></tt><br> <tt><tt>$xpaset -p ds9 envi new foo.hdr<br> - </tt></tt> - <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 envi foo.hdr + </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 envi foo.hdr foo.bsq</tt></tt><br> <br> </tt></tt></tt></tt> <b><a name="exit" id="exit"></a>exit</b><br> @@ -1152,33 +1079,31 @@ <p>Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method.</p> - <tt>Syntax:</tt> <tt><br> - </tt> <tt>export</tt> - <tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> - <tt><filename></tt><tt><br> - </tt> <tt>export array - <filename></tt> <tt>[big|little</tt><tt>|native]<br> - </tt> - <tt>export nrrd <filename></tt> - <tt>[big|little</tt><tt>|native]</tt><tt><br> - export envi <header> [<filename>]</tt> - <tt>[big|little</tt><tt>|native]</tt> <tt><br> - export jpeg <filename></tt> <tt>[1-100]</tt><tt><br> - </tt> - <tt>export tiff <filename</tt><tt>></tt> - <tt>[none|jpeg|packbits|deflate]</tt><br> - <tt> <br> - Example:<br> - </tt> <tt><tt>$xpaset -p ds9 export array foo.arr - little</tt></tt><br> + <tt>Syntax:</tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>export</tt><tt> </tt><tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt><tt> + </tt><tt><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> </tt><tt>export nrrd <filename></tt><tt> + </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> + </tt><tt> export envi <header> [<filename>]</tt><tt> </tt><tt>[big|little</tt><tt>|native]</tt><tt> + </tt><tt><br> + </tt><tt> export jpeg <filename></tt><tt> </tt><tt>[1-100]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>export tiff <filename</tt><tt>></tt><tt> + </tt><tt>[none|jpeg|packbits|deflate]</tt><tt><br> + </tt><tt> <br> + Example:<br> + </tt> <tt><tt>$xpaset -p ds9 export array foo.arr little</tt></tt><br> <tt><tt>$xpaset -p ds9 export nrrd foo.nrrd little</tt></tt><br> - <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi foo.hdr - little</tt></tt><br> - </tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi - foo.hdr foo.bsq little</tt></tt><br> - </tt></tt></tt></tt> $xpaset -p - ds9 export tiff foo.tiff jpeg</tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 export envi foo.hdr little</tt></tt><br> + </tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset + + + + + -p ds9 export envi foo.hdr foo.bsq little</tt></tt><br> + </tt></tt></tt></tt> $xpaset -p ds9 export tiff + foo.tiff jpeg</tt></tt></tt><br> $xpaset -p ds9 export jpeg foo.jpeg 75<br> $xpaset -p ds9 export png foo.png</tt><br> <p><b><a name="file" id="file"></a>file</b></p> @@ -1193,10 +1118,8 @@ loaded image.<br> </p> <tt>Syntax:<br> - fits</tt> <tt><tt>[new|mask|slice] - [<filename>]</tt><tt><br> - </tt> - [width|height|depth|bitpix]<br> + fits</tt> <tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> + </tt> [width|height|depth|bitpix]<br> [size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> [header [<ext>] [keyword @@ -1210,8 +1133,7 @@ $xpaget ds9 fits depth<br> $xpaget ds9 fits bitpix</tt><br> <tt><tt>$xpaget ds9 fits size<br> - </tt> $xpaget ds9 fits size wcs - fk5 arcmin<br> + </tt> $xpaget ds9 fits size wcs fk5 arcmin<br> $xpaget ds9 fits header # primary<br> $xpaget ds9 fits header 2 # hdu 2<br> $xpaget ds9 fits header -2 # hdu 2 with inherit<br> @@ -1220,8 +1142,7 @@ <tt><tt>$xpaget ds9 fits image > foo.fits<br> $xpaget ds9 fits table > bar.fits<br> $xpaget ds9 fits slice > foo.fits<br> - </tt> $xpaset -p ds9 fits - foo.fits<br> + </tt> $xpaset -p ds9 fits foo.fits<br> $xpaset -p ds9 fits new foo.fits<br> $xpaset -p ds9 fits bar.fits[bin=detx,dety]<br> $xpaset -p ds9 fits slice foo.fits<br> @@ -1234,12 +1155,10 @@ </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> + 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> @@ -1259,32 +1178,27 @@ [last]<br> [frameno #]<br> [#]<br> - </tt> - <tt> [match <coordsys>]<br> - [lock - <coordsys>|none]</tt><br> + </tt> <tt> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><br> <tt> [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]<br> [has contour [aux]]]<br> [has fits [bin|cube|mosaic]]<br> [has marker [highlite|paste|select|undo]]<br> - [has system - <coordsys>]<br> - </tt> - <tt><tt><tt> [has wcs + [has system <coordsys>]<br> + </tt> <tt><tt><tt> [has wcs [<wcssys>]]<br> - </tt> [has wcs - celestial [<wcssys>]]<br> - </tt> - [has wcs linear [<wcssys>]]<br> + </tt> [has wcs celestial + [<wcssys>]]<br> + </tt> [has wcs linear + [<wcssys>]]<br> <br> Example:<br> $xpaget ds9 frame # returns the id of the current frame<br> $xpaget ds9 frame frameno # returns the id of the current frame<br> $xpaget ds9 frame all # returns the id of all frames<br> - $xpaget ds9 frame active # returns the id of all active - frames<br> + $xpaget ds9 frame active # returns the id of all active frames<br> </tt> <tt>$xpaget ds9 frame lock</tt><br> <tt>$xpaget ds9 frame has amplifier<br> $xpaget ds9 frame has datamin<br> @@ -1343,15 +1257,13 @@ $xpaget ds9 gif > foo.gif</tt><br> <tt>$xpaset -p ds9 gif foo.gif</tt><br> <tt><tt>$xpaset -p ds9 gif new foo.gif<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9 gif slice foo.gif<br> - </tt></tt> $cat - foo.gif | xpaset ds9 gif # not available windows</tt><br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 gif slice foo.gif<br> + </tt></tt> $cat foo.gif | xpaset ds9 gif # not available + windows</tt><br> <tt><tt>$cat foo.gif | xpaset ds9 gif</tt> <tt>new # not - available - windows<br> - </tt> $cat foo.gif | xpaset ds9 gif</tt> <tt>slice</tt> - <tt><tt><tt># not available windows</tt></tt></tt> + available windows<br> + </tt> $cat foo.gif | xpaset ds9 gif</tt> <tt>slice</tt> <tt><tt><tt># + not available windows</tt></tt></tt> <p><b><a name="grid" id="grid"></a>grid</b></p> <p>Controls coordinate grid. For grid numeric format syntax, click <a href="grid.html#Format">here</a>.</p> @@ -1367,14 +1279,11 @@ [grid width <value>]<br> [grid dash yes|no]<br> [grid gap1 <value>]<br> - </tt> - <tt><tt> [grid gap2 + </tt> <tt><tt> [grid gap2 <value>]<br> - </tt></tt> - <tt><tt><tt> [grid gap3 - <value>]<br> - </tt></tt> [axes - yes|no]<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> @@ -1394,22 +1303,17 @@ [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 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 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> @@ -1422,20 +1326,15 @@ [title fontslant roman|italic]<br> [title color <color>]<br> [labels yes|no]<br> - </tt> - <tt><tt> [labels def1 yes|no]<br> + </tt> <tt><tt> [labels def1 yes|no]<br> [labels def2 yes|no]<br> - </tt> - [labels text1 <text>]<br> - </tt> - <tt><tt> [labels text2 + </tt> [labels text1 <text>]<br> + </tt> <tt><tt> [labels text2 <text>]<br> - </tt></tt> <tt><tt> - [labels gap1 <value>]<br> - </tt> - [labels gap2 <value>]<br> - </tt> - <tt> [labels font + </tt></tt> <tt><tt> [labels gap1 + <value>]<br> + </tt> [labels gap2 <value>]<br> + </tt> <tt> [labels font times|helvetica|courier]<br> [labels fontsize <value>]<br> [labels fontweight normal|bold]<br> @@ -1457,10 +1356,8 @@ $xpaget ds9 grid grid width<br> $xpaget ds9 grid grid dash<br> $xpaget ds9 grid grid gap1<br> - </tt> <tt><tt>$xpaget ds9 grid grid - gap2<br> - </tt></tt> <tt><tt><tt>$xpaget ds9 grid grid - gap3<br> + </tt> <tt><tt>$xpaget ds9 grid grid gap2<br> + </tt></tt> <tt><tt><tt>$xpaget ds9 grid grid gap3<br> </tt></tt> $xpaget ds9 grid axes<br> $xpaget ds9 grid axes color<br> $xpaget ds9 grid axes width<br> @@ -1484,10 +1381,8 @@ $xpaget ds9 grid numerics fontslant<br> $xpaget ds9 grid numerics color<br> $xpaget ds9 grid numerics gap1<br> - </tt> <tt><tt>$xpaget ds9 grid - numerics gap2<br> - </tt></tt> <tt><tt><tt>$xpaget ds9 grid numerics - gap3<br> + </tt> <tt><tt>$xpaget ds9 grid numerics gap2<br> + </tt></tt> <tt><tt><tt>$xpaget ds9 grid numerics gap3<br> </tt></tt> $xpaget ds9 grid numerics type<br> $xpaget ds9 grid numerics vertical<br> $xpaget ds9 grid title<br> @@ -1523,8 +1418,7 @@ $xpaset -p ds9 grid grid dash yes<br> $xpaset -p ds9 grid grid gap1 10<br> $xpaset -p ds9 grid grid gap2 10<br> - </tt> <tt><tt>$xpaset -p ds9 - grid grid gap3 10<br> + </tt> <tt><tt>$xpaset -p ds9 grid grid gap3 10<br> </tt> $xpaset -p ds9 grid axes yes<br> $xpaset -p ds9 grid axes color red<br> $xpaset -p ds9 grid axes width 2<br> @@ -1548,12 +1442,9 @@ $xpaset -p ds9 grid numerics fontslant italic<br> $xpaset -p ds9 grid numerics color red<br> $xpaset -p ds9 grid numerics gap1 10<br> - </tt> <tt><tt>$xpaset -p - ds9 grid numerics gap2 10<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 - grid numerics gap3 10<br> - </tt></tt> $xpaset -p ds9 grid numerics - type exterior<br> + </tt> <tt><tt>$xpaset -p ds9 grid numerics gap2 10<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 grid numerics gap3 10<br> + </tt></tt> $xpaset -p ds9 grid numerics type exterior<br> $xpaset -p ds9 grid numerics vertical yes<br> $xpaset -p ds9 grid title yes<br> $xpaset -p ds9 grid title text {Hello World}<br> @@ -1584,8 +1475,7 @@ </tt> <p><b><a name="header" id="header"></a>header</b></p> <p>Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from xpa fits - header.</p> + maybe specified. Please note, this differs from xpa fits header.</p> <tt>Syntax:<br> header [<ext>]<br> [close [<ext>]]<br> @@ -1619,17 +1509,13 @@ <tt>$xpaset -p ds9 iconify yes</tt><br> <p><b><a name="iexam" id="iexam"></a>iexam</b></p> <p>Interactive examine function. A blinking cursor will indicate - to - the user to click on a point on an image. The specified - information - will be returned at that time. The default event is + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is <tt>button</tt>. In the last form, the following macros will be expanded if present: <tt>$width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, - $y, $z.</tt> See <a href="analysis.html#macros">Analysis - Macros</a> - for more information.<br> + $x, $y, $z.</tt> See <a href="analysis.html#macros">Analysis + Macros</a> for more information.<br> </p> <tt>Syntax:<br> iexam []<br> @@ -1637,15 +1523,14 @@ <coordsys> [<skyframe>] [<skyformat>]<br> [[]|button|key|any] data [width][height]<br> - </tt> <tt><tt> - [[]|button|key|any] <macro string>]<br> + </tt> <tt><tt> [[]|button|key|any] + <macro string>]<br> </tt><br> Example:<br> $xpaget ds9 iexam # image coordinates<br> - </tt> <tt><tt>$xpaget ds9 - iexam coordinate image<br> - </tt> $xpaget ds9 iexam key coordinate - image # return coordinate and key event<br> + </tt> <tt><tt>$xpaget ds9 iexam coordinate image<br> + </tt> $xpaget ds9 iexam key coordinate image # return coordinate + and key event<br> $xpaget ds9 iexam coordinate wcs fk5 degrees<br> $xpaget ds9 iexam coordinate wcs galactic sexagesimal<br> $xpaget ds9 iexam coordinate fk5<br> @@ -1665,8 +1550,8 @@ $xpaset -p ds9 iis filename foo.fits<br> $xpaset -p ds9 iis filename bar.fits 4</tt><br> <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> - <p>Load JPEG image into current frame. Optional parameters: - <tt>jpeg</tt> quality (1-100)</p> + <p>Load JPEG image into current frame. Optional parameters: <tt>jpeg</tt> + quality (1-100)</p> <tt>Syntax:<br> jpeg [new|slice] [<filename>] [1-100]<br> <br> @@ -1675,43 +1560,34 @@ <tt><tt>$xpaget ds9 jpeg 100 > foo.jpeg</tt><br> $xpaset -p ds9 jpeg foo.jpeg</tt><br> <tt><tt>$xpaset -p ds9 jpeg new foo.jpeg<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9 jpeg slice foo.jpeg<br> - </tt></tt> $cat - foo.jpeg | xpaset ds9 jpeg</tt> <tt><tt><tt># not available - windows</tt></tt></tt><br> - <tt><tt>$cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>new</tt></tt> - <tt><tt><tt><tt># not available windows</tt></tt><br> - </tt> $cat - foo.jpeg | xpaset ds9 jpeg</tt> <tt>slice</tt> <tt><tt><tt># - not - available windows</tt></tt></tt> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 jpeg slice foo.jpeg<br> + </tt></tt> $cat foo.jpeg | xpaset ds9 jpeg</tt> <tt><tt><tt># + not available windows</tt></tt></tt><br> + <tt><tt>$cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>new</tt></tt> <tt><tt><tt><tt># + not available windows</tt></tt><br> + </tt> $cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>slice</tt> <tt><tt><tt># + not available windows</tt></tt></tt> <p><b><a name="lock" id="lock"></a>lock</b></p> <p>Lock all other frames to the current frame.</p> <tt>Syntax:<br> lock</tt> <tt>[frame <coordsys>|none]<br> </tt> <tt>[crosshair <coordsys>|none]</tt> <tt><br> - </tt> - <tt> [crop <coordsys>|none]</tt><br> - <tt> [slice - <coordsys>|none]]<br> - </tt> <tt> [bin - [yes|no]]<br> + </tt> <tt> [crop <coordsys>|none]</tt><br> + <tt> [slice <coordsys>|none]]<br> + </tt> <tt> [bin [yes|no]]<br> [axes [yes|no]]<br> [scale [yes|no]]<br> [scalelimites [yes|no]]<br> [colorbar [yes|no]]<br> [block [yes|no]]<br> - </tt> - <tt> [smooth [yes|no]]</tt><br> + </tt> <tt> [smooth [yes|no]]</tt><br> <tt> [3d [yes|no]]</tt><br> <tt><tt> </tt><br> Example:<br> $xpaget -p ds9 lock frame<br> $xpaget -p ds9 lock crosshair<br> - </tt> <tt>$xpaget -p ds9 lock - crop</tt><br> + </tt> <tt>$xpaget -p ds9 lock crop</tt><br> <tt>$xpaget -p ds9 lock slice</tt><br> <tt>$xpaget -p ds9 lock bin<br> $xpaget -p ds9 lock axes<br> @@ -1719,23 +1595,17 @@ $xpaget -p ds9 lock scalelimits<br> $xpaget -p ds9 lock colorbar<br> $xpaget -p ds9 lock block<br> - </tt> <tt><tt>$xpaget -p ds9 lock - smooth<br> - </tt></tt> <tt><tt><tt>$xpaget -p ds9 lock - 3d<br> + </tt> <tt><tt>$xpaget -p ds9 lock smooth<br> + </tt></tt> <tt><tt><tt>$xpaget -p ds9 lock 3d<br> </tt></tt> $xpaset -p ds9 lock frame wcs</tt><tt><br> - </tt> - <tt>$xpaset -p ds9 lock crosshair wcs<br> - </tt> <tt>$xpaset -p ds9 - lock crop wcs</tt><br> + </tt> <tt>$xpaset -p ds9 lock crosshair wcs<br> + </tt> <tt>$xpaset -p ds9 lock crop wcs</tt><br> <tt>$xpaset -p ds9 lock slice wcs</tt><br> <tt>$xpaset -p ds9 lock bin yes<br> $xpaset -p ds9 lock axes yes<br> - </tt> <tt>$xpaset -p ds9 lock scale - yes<br> + </tt> <tt>$xpaset -p ds9 lock scale yes<br> $xpaset -p ds9 lock scalelimits yes<br> - </tt> <tt>$xpaset -p ds9 - lock colorbar yes<br> + </tt> <tt>$xpaset -p ds9 lock colorbar yes<br> $xpaset -p ds9 lock block yes</tt><br> <tt>$xpaset -p ds9 lock smooth yes</tt><br> <tt>$xpaset -p ds9 lock 3d yes<br> @@ -1773,18 +1643,24 @@ <p>Controls mask parameters.</p> <tt>Syntax:<br> mask [color <color>]<br> - [mark 1|0]<br> + [mark zero|nonzero|nan|nonnan|range]<br> + [range <low> <high>]<br> [transparency <value>]<br> - [clear]<br> + </tt><tt><tt> [system <coordsys>]<br> + </tt> [clear]<br> [open|close]<br> <br> Example:<br> $xpaget ds9 mask color<br> $xpaget ds9 mask mark<br> + $xpaget ds9 mask range<br> + $xpaget ds9 mask system<br> $xpaget ds9 mask transparency<br> $xpaset -p ds9 mask color red<br> - $xpaset -p ds9 mask mark 0<br> + $xpaset -p ds9 mask mark zero<br> + $xpaset -p ds9 mask range 10 100<br> $xpaset -p ds9 mask transparency 50<br> + $xpaset -p ds9 mask system wcs<br> $xpaset -p ds9 mask clear<br> $xpaset -p ds9 mask open<br> $xpaset -p ds9 mask close<br> @@ -1792,14 +1668,11 @@ <p><b><a name="match" id="match"></a>match</b></p> <p>Match all other frames to the current frame.</p> <tt>Syntax:<br> - </tt> <tt>match</tt> <tt>[frame - <coordsys>]<br> + </tt> <tt>match</tt> <tt>[frame <coordsys>]<br> </tt> <tt>[crosshair <coordsys>]</tt> <tt><br> - </tt> - <tt> [crop <coordsys>]</tt><br> - <tt> [slice - <coordsys>]</tt><br> + </tt> <tt> [crop <coordsys>]</tt><br> + <tt> [slice <coordsys>]</tt><br> <tt> [bin]<br> [axes]<br> [scale]<br> @@ -1809,15 +1682,12 @@ [smooth]<br> [3d]<br> </tt> <tt><tt><br> - </tt> - Example:<br> + </tt> Example:<br> $xpaset -p ds9 match frame wcs<br> - </tt> <tt>$xpaset -p ds9 match - crosshair wcs<br> + </tt> <tt>$xpaset -p ds9 match crosshair wcs<br> </tt> <tt>$xpaset -p ds9 match crop wcs</tt><br> <tt>$xpaset -p ds9 match slice</tt> <tt>wcs<br> - </tt> <tt>$xpaset -p - ds9 match bin<br> + </tt> <tt>$xpaset -p ds9 match bin<br> $xpaset -p ds9 match axes<br> $xpaset -p ds9 match scale<br> $xpaset -p ds9 match scalelimits<br> @@ -1836,14 +1706,13 @@ $xpaget ds9 mecube > foo.fits<br> $xpaset -p ds9 mecube foo.fits</tt><br> <tt><tt>$xpaset -p ds9 mecube new foo.fits<br> - </tt> $cat foo.fits | - xpaset ds9 mecube</tt><br> + </tt> $cat foo.fits | xpaset ds9 mecube</tt><br> <tt>$cat foo.fits | xpaset ds9 mecube</tt> <tt>new</tt> <p><b><a name="minmax" id="minmax"></a>minmax</b></p> <p>This is how DS9 determines the min and max data values - from the data. <tt>SCAN</tt> will scan all - data. <tt>DATAMIN</tt> and <tt>IRAFMIN</tt> will use the - values of the keywords if present.<br> + from the data. <tt>SCAN</tt> will scan all data. <tt>DATAMIN</tt> + and <tt>IRAFMIN</tt> will use the values of the keywords if + present.<br> </p> <tt>Syntax:<br> minmax [scan|sample|datamin|irafmin]<br> @@ -1869,22 +1738,21 @@ $xpaset -p ds9 mode crosshair</tt><br> <p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> <p>Load FITS mosaic segment into current frame.</p> - <tt>Syntax:<br> - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 mosaic > foo.fits</tt><tt><br> - $xpaset -p ds9 mosaic foo.fits</tt><br> - <tt><tt>$xpaset -p ds9 mosaic wcs foo.fits</tt></tt><br> - <tt><tt>$xpaset -p ds9 mosaic wcs new foo.fits</tt></tt><br> - <tt><tt>$xpaset -p ds9 mosaic wcs mask - foo.fits</tt></tt><tt><tt><tt><br> - </tt></tt> $cat foo.fits | xpaset - ds9 mosaic</tt><br> - <tt><tt>$cat foo.fits | xpaset ds9 mosaic wcs<br> - $cat foo.fits | xpaset ds9 mosaic wcs</tt> <tt>new<br> - </tt> $cat - foo.fits | xpaset ds9 mosaic wcs</tt> <tt>mask<br> + <tt>Syntax:</tt><tt><br> + </tt><tt> mosaic [wcs|wcsa...wcsz|iraf] [new|mask] + [<filename>]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> $xpaget ds9 mosaic > foo.fits</tt><tt><br> + </tt><tt> $xpaset -p ds9 mosaic foo.fits</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 mosaic wcs foo.fits</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 mosaic wcs new foo.fits</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 mosaic wcs mask foo.fits</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.fits | xpaset ds9 mosaic</tt><tt><br> + </tt><tt> </tt><tt>$cat foo.fits | xpaset ds9 mosaic wcs</tt><tt><br> + </tt><tt> $cat foo.fits | xpaset ds9 mosaic wcs</tt><tt> </tt><tt>new</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.fits | xpaset ds9 mosaic wcs</tt><tt> + mask<br> </tt> <p><b><a name="mosaicimage" id="mosaicimage"></a>mosaicimage</b></p> <p>Load FITS mosaic image into current frame.</p> @@ -1897,35 +1765,31 @@ $xpaset -p ds9 mosaicimage foo.fits</tt><br> <tt><tt>$xpaset -p ds9 mosaicimage wcs foo.fits</tt></tt><br> <tt><tt>$xpaset -p ds9 mosaicimage wcs new foo.fits</tt></tt><br> - <tt><tt>$xpaset -p ds9 mosaicimage wcs mask - foo.fits</tt></tt><tt><tt><tt><br> - </tt></tt> $cat foo.fits | xpaset - ds9 mosaicimage</tt><br> + <tt><tt>$xpaset -p ds9 mosaicimage wcs mask foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt> $cat foo.fits | xpaset ds9 mosaicimage</tt><br> <tt><tt>$cat foo.fits | xpaset ds9 mosaicimage wcs<br> $cat foo.fits | xpaset ds9 mosaicimage wcs new</tt><tt><br> - </tt> - $cat foo.fits | xpaset ds9 mosaicimage wcs mask</tt><br> + </tt> $cat foo.fits | xpaset ds9 mosaicimage wcs mask</tt><br> <p><b><a name="movie" id="movie"></a>movie<br> savempeg<br> </b></p> - <p>Create mpeg1 movie from snap shots of the DS9 window. A - <tt>slice</tt> movie cycles though all slices of a cube. A - <tt>frame</tt> movie cycles through all active frames. A - <tt>3d</tt> movie cycles through specified viewing angles. The - default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.</p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A <tt>slice</tt> + movie cycles though all slices of a cube. A <tt>frame</tt> + movie cycles through all active frames. A <tt>3d</tt> movie + cycles through specified viewing angles. The default is <tt>frame</tt>. + Optional parameters for <tt>3d</tt>: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.</p> <tt>Syntax:<br> movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br> - </tt> - <tt>movie 3d <filename> + </tt> <tt>movie 3d <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>]</tt><br> <tt> <br> Example:<br> $xpaset -p ds9 movie slice ds9.mpg<br> - </tt> <tt>$xpaset -p ds9 - movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> + </tt> <tt>$xpaset -p ds9 movie 3d ds9.mpg number 10 azfrom -60 + azto 60 oscillate 1</tt><br> <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> <p>Load FITS multiple extension file as multiple images.<br> </p> @@ -1934,20 +1798,16 @@ <br> Example:<br> $xpaset -p ds9 multiframe foo.fits</tt><tt><tt><br> - </tt> $cat - foo.fits | xpaset ds9 multiframe</tt> <tt><tt><tt># not - available - windows</tt></tt></tt><br> + </tt> $cat foo.fits | xpaset ds9 multiframe</tt> <tt><tt><tt># + not available windows</tt></tt></tt><br> <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> <p>Support Name Server functions. Coordinates are in fk5.</p> <tt>Syntax:<br> nameserver [<object>]<br> - [name - <object>]<br> + [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> + [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> @@ -1984,22 +1844,19 @@ <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: array endian.<br> </p> - <tt>Syntax:<br> - nrrd [native|little|big]<br> - nrrd [new|mask] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 nrrd</tt><br> - <tt><tt>$xpaget ds9 nrrd big<br> - $xpaset -p ds9 nrrd foo.nrrd</tt></tt><br> - <tt><tt><tt><tt>$xpaset -p ds9 nrrd new - foo.nrrd</tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 nrrd mask - foo.nrrd<br> - </tt></tt></tt></tt></tt> $cat foo.nrrd | xpaset ds9 - nrrd</tt><br> - <tt>$cat foo.nrrd | xpaset ds9 nrrd</tt> <tt>new<br> - $cat foo.nrrd | xpaset ds9 nrrd mask</tt> + <tt>Syntax:</tt><tt><br> + </tt><tt> nrrd [native|little|big]</tt><tt><br> + </tt><tt> nrrd [new|mask] [<filename>]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> $xpaget ds9 nrrd</tt><tt><br> + </tt><tt> </tt><tt>$xpaget ds9 nrrd big</tt><tt><br> + </tt><tt> $xpaset -p ds9 nrrd foo.nrrd</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 nrrd new foo.nrrd</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 nrrd mask foo.nrrd</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.nrrd | xpaset ds9 nrrd</tt><tt><br> + </tt><tt> </tt><tt>$cat foo.nrrd | xpaset ds9 nrrd</tt><tt> </tt><tt>new</tt><tt><br> + </tt><tt> $cat foo.nrrd | xpaset ds9 nrrd mask</tt> <p><b><a name="nvss" id="nvss"></a>nvss</b></p> <p>Support for NRAO VLA Sky Survey.</p> <tt>Syntax:<br> @@ -2022,19 +1879,15 @@ $xpaget ds9 nvss frame<br> $xpaset -p ds9 nvss<br> $xpaset -p ds9 nvss m31<br> - </tt> <tt><tt>$xpaset -p ds9 nvss name - m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 nvss name - clear<br> - </tt></tt> $xpaset -p ds9 nvss 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 nvss name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 nvss name clear<br> + </tt></tt> $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 nvss size 60 60 arcmin<br> $xpaset -p ds9 nvss save yes<br> $xpaset -p ds9 nvss frame current<br> $xpaset -p ds9 nvss update frame<br> $xpaset -p ds9 nvss open<br> - </tt> <tt>$xpaset -p ds9 nvss - close</tt><br> + </tt> <tt>$xpaset -p ds9 nvss close</tt><br> <p><b><a name="orient" id="orient"></a>orient</b></p> <p>Controls the orientation of the current frame.</p> <tt>Syntax:<br> @@ -2072,8 +1925,8 @@ pan [<coordsys> [<skyframe>] [<skyformat>]] # get current coords<br> <br> - pan [<x> <y> <coordsys> - [<skyframe>]] # relative<br> + pan [<x> <y> <coordsys> [<skyframe>]] # + relative<br> [to <x> <y> <coordsys> [<skyframe>]] # absolute<br> [open|close]<br> @@ -2106,10 +1959,8 @@ <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> + 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> @@ -2118,426 +1969,396 @@ </blockquote> <p>To create a new plot, use the plot new command.</p> <tt>Syntax:</tt><tt><br> - </tt> <tt># create new empty plot - window</tt><tt><br> - </tt> <tt>plot []</tt><tt><br> - </tt> - <tt> [line|bar|scatter]</tt><tt><br> - </tt> - <tt> [new]</tt><tt><br> - </tt> - <tt> [new + </tt><tt> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot []</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> + [line|bar|scatter]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new line|bar|scatter]</tt><tt><br> - </tt> <tt> - [new name <plotname>]</tt><tt><br> - </tt> - <tt> [new name <plotname> - line|bar|scatter]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># create new - plot with data from stdin</tt><tt><br> - </tt> <tt>plot</tt> <tt>[new - <title> <xaxis label> <yaxis label></tt> - <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[new [line|bar|scatter] - <title> <xaxis label> <yaxis label></tt> - <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[new</tt> <tt>name - <plotname></tt> <tt><title> <xaxis label> - <yaxis label></tt> - <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[new</tt> <tt>name - <plotname></tt> <tt>line|bar|scatter <title> - <xaxis - label> <yaxis label></tt> - <tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> - </tt> <tt><br> - </tt> - <tt># create new plot with data from stdin which includes - title/dim - headers</tt><tt><br> - </tt> <tt>plot [new - stdin</tt><tt>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[new</tt> <tt>[line|bar|scatter]</tt> - <tt>stdin</tt><tt>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[new name <plotname> - stdin</tt><tt>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[new name <plotname></tt> <tt>line|bar|scatter</tt> - <tt>stdin</tt><tt>]</tt><tt><br> - </tt> <tt><br> - </tt> <tt>#</tt> - <tt>load data into existing plot from stdin</tt><tt><br> - </tt> - <tt>plot [[<plotname>] data + </tt><tt> </tt><tt> </tt><tt> [new name + <plotname>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> [new name + <plotname> line|bar|scatter]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new plot with data from + stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot</tt><tt> </tt><tt>[new + <title> <xaxis label> <yaxis label></tt><tt> </tt><tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new + + + + + [line|bar|scatter] <title> <xaxis label> <yaxis + label></tt><tt> </tt><tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new</tt><tt> + </tt><tt>name <plotname></tt><tt> </tt><tt><title> + <xaxis label> <yaxis label></tt><tt> </tt><tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new</tt><tt> + </tt><tt>name <plotname></tt><tt> </tt><tt>line|bar|scatter + <title> <xaxis label> <yaxis label></tt><tt> </tt><tt>xy|xyex|xyey|xyexey</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new plot with data from + stdin which includes title/dim headers</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot [new stdin</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new</tt><tt> + </tt><tt>[line|bar|scatter]</tt><tt> </tt><tt>stdin</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new + + + + name <plotname> stdin</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[new + + + + name <plotname></tt><tt> </tt><tt>line|bar|scatter</tt><tt> + </tt><tt>stdin</tt><tt>]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>#</tt><tt> </tt><tt>load data into + existing plot from stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>plot [[<plotname>] data xy|xyex|xyey|xyexey]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># existing - plot</tt><tt><br> - </tt> <tt>plot</tt> <tt>[[<plotname>] load - <filename> xy|xyex|xyey|xyexey]</tt><tt><br> - </tt> - <tt> [[<plotname>] save - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] - duplicate - [#]]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] stats yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] list - yes|no]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] loadconfig - <filename>]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] pagesetup orient - portrait|landscape]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] - print]</tt><tt><br> - </tt> <tt> - [[<plotname>] print destination - printer|file]</tt><tt><br> - </tt> <tt> - [[<plotname>] print command - <command>]</tt><tt><br> - </tt> <tt> - [[<plotname>] print filename - <filename>]</tt><tt><br> - </tt> <tt> + </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>[[<plotname>] + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + close</tt><tt>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] mode pointer|zoom]</tt><tt><br> - </tt> - <tt><br> - </tt> <tt># configure graph</tt><tt><br> - </tt> <tt>plot - [[<plotname>] axis x|y grid yes|no]</tt><tt><br> - </tt> - <tt> [[<plotname>] axis x|y log - yes|no]</tt><tt><br> - </tt> <tt> + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + + mode pointer|zoom]</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </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> [[<plotname>] axis x|y auto - yes|no]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] axis x|y max - <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] axis x|y format - <string>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] legend yes|no]</tt><tt><br> - </tt> - <tt> [[<plotname>] legend position - right|left|top|bottom]</tt><tt><br> - </tt> <tt> + </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> + </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> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>size <value>]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>weight normal|bold]</tt><tt><br> - </tt> <tt> - [[<plotname>] font</tt> <tt>title|labels|numbers</tt> - <tt>slant roman|italic]</tt><tt><br> - </tt> <tt> + </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> [[<plotname>] title x|y - <string>]</tt><tt><br> - </tt> <tt> - [</tt><tt>[<plotname>] barmode - normal|stacked|aligned|overlap]</tt><tt><br> - </tt> <tt><br> - </tt> - <tt># configure current dataset</tt><tt><br> - </tt> <tt>plot - [[<plotname>] show yes|no]</tt><tt><br> - </tt> <tt> - </tt> <tt>[[<plotname>] shape - circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> - </tt> <tt> </tt> <tt>[[<plotname>] - shape fill yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] shape - color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] smooth - step|linear|cubic|quadratic|catrom]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] color - <value>]</tt><tt><br> - </tt> <tt> </tt> - <tt>[[<plotname>] width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] dash + </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>[[<plotname>] error yes|no]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] error + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + shape 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> - [[<plotname>] color <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] error + </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] + + + + width <value>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[[<plotname>] name - <string>]</tt><tt><br> - </tt> <tt><br> - </tt> <tt># select - current dataset</tt><tt><br> - </tt> <tt>plot [[<plotname>] - select <value>]</tt><tt><br> - </tt> - <tt> </tt><tt><br> - </tt> <tt>Example:</tt><tt><br> - </tt> <tt># - return all plotnames</tt><tt><br> - </tt> <tt>$xpaget ds9 - plot</tt><tt><br> - </tt> <tt><br> - </tt> <tt># create new empty plot - window</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot</tt><tt><br> - </tt> - <tt>$xpaset -p ds9 plot bar</tt><tt><br> - </tt> <tt>$xpaset -p ds9 - plot new</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot new - bar</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot new name - foo</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot new name foo + </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> + [[<plotname>] color <value>]</tt><tt><br> + </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># return all plotnames</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new empty plot window</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot bar</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot new</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot new bar</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot new name foo</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot new name foo bar</tt><tt><br> - </tt> <tt><br> - </tt> <tt># create new plot with data - from stdin</tt><tt><br> - </tt> <tt>$cat xy.dat | xpaset ds9 plot new - {The Title} {X Axis} {Y Axis} xy</tt><tt><br> - </tt> <tt>$cat xy.dat - | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} - xy</tt><tt><br> - </tt> <tt>$cat xy.dat | xpaset ds9 plot new name foo - {The Title} {X Axis} {Y Axis} xy</tt><tt><br> - </tt> <tt>$cat xy.dat - | xpaset ds9 plot new name foo bar {The Title} {X Axis} {Y Axis} - xy</tt><tt><br> - </tt> <tt><br> - </tt> <tt># create new plot with data - from stdin which includes title/dim headers</tt><tt><br> - </tt> - <tt>$cat stdin.2.dat | xpaset ds9 plot new stdin</tt><tt><br> - </tt> - <tt>$cat stdin.2.dat | xpaset ds9 plot new line - stdin</tt><tt><br> - </tt> <tt>$cat stdin.2.dat | xpaset ds9 plot new - name foo stdin</tt><tt><br> - </tt> <tt>$cat stdin.2.dat | xpaset ds9 - plot new name foo line stdin</tt><tt><br> - </tt> <tt><br> - </tt> - <tt>#</tt> <tt>load data into existing plot from + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new plot with data from stdin</tt><tt><br> - </tt> <tt>$cat xy.dat | xpaset ds9 plot data - xy</tt><tt><br> - </tt> <tt>$cat xy.dat | xpaset ds9 plot foo data + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot new + {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot new + bar {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot new + name foo {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot new + name foo bar {The Title} {X Axis} {Y Axis} xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># create new plot with data from + stdin which includes title/dim headers</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat stdin.2.dat | xpaset ds9 plot + new stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat stdin.2.dat | xpaset ds9 plot + new line stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat stdin.2.dat | xpaset ds9 plot + new name foo stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat stdin.2.dat | xpaset ds9 plot + new name foo line stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>#</tt><tt> </tt><tt>load data into + existing plot from stdin</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot data xy</tt><tt><br> - </tt> <tt><br> - </tt> <tt># existing - plot</tt><tt><br> - </tt> <tt>$xpaget ds9 plot stats</tt><tt><br> - </tt> - <tt>$xpaget ds9 plot list</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot - load xy.dat xy</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot save - foo.dat</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot - clear</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot duplicate - 1</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot stats - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot list - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot loadconfig + </tt><tt> </tt><tt> </tt><tt>$cat xy.dat | xpaset ds9 plot foo + data xy</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>$xpaget ds9 plot stats</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot list</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot load xy.dat xy</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot save foo.dat</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot clear</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot duplicate 1</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot stats yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot list yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot loadconfig foo.plt</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot saveconfig + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot saveconfig foo.plt</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot pagesetup orient - portrait</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot pagesetup size + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot pagesetup + orient portrait</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot pagesetup size letter</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot - print</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot print destination - file</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot print command + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot print</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot print + destination file</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot print command lp</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot print filename + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot print filename foo.ps</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot print color - rgb</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot - close</tt><tt><br> - </tt> <tt>$xpaget ds9 plot mode</tt><tt><br> - </tt> - <tt>$xpaset -p ds9 plot mode pointer</tt><tt><br> - </tt> <tt><br> - </tt> <tt># configure plot</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - axis x grid</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - log</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - flip</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - auto</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - min</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - max</tt><tt><br> - </tt> <tt>$xpaget ds9 plot axis x - format</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x grid - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x log - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x flip - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x auto - no</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x min - 1</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x max - 100</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot axis x format + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot print color rgb</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot close</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot mode</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot mode pointer</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt># configure plot</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x grid</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x log</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x flip</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x auto</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x min</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x max</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot axis x format</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x grid yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x log yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x flip yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x auto no</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x min 1</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x max 100</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot axis x format {%f}</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$xpaget ds9 plot - legend</tt><tt><br> - </tt> <tt>$xpaget ds9 plot legend - position</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot legend - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot legend position + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot legend</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot legend position</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot legend yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot legend position left</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$xpaget ds9 plot font - numbers font</tt><tt><br> - </tt> <tt>$xpaget ds9 plot font numbers - size</tt><tt><br> - </tt> <tt>$xpaget ds9 plot font numbers + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot font numbers font</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot font numbers size</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot font numbers weight</tt><tt><br> - </tt> <tt>$xpaget ds9 plot font numbers - slant</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot font numbers font - times</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot font numbers size - 12</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot font numbers weight - bold</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot font numbers slant - italic</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$xpaget ds9 plot - title</tt><tt><br> - </tt> <tt>$xpaget ds9 plot title - xaxis</tt><tt><br> - </tt> <tt>$xpaget ds9 plot title - yaxis</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot title {This is a - Title}</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot title x {X + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot font numbers slant</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot font numbers + font times</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot font numbers + size 12</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot font numbers + weight bold</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot font numbers + slant italic</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot title</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot title xaxis</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot title yaxis</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot title {This is + a Title}</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot title x {X Axis}</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot title y {Y + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot title y {Y Axis}</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot title legend {This - is the Legend}</tt><tt><br> - </tt> <tt><br> - </tt> <tt>$xpaget ds9 plot - barmode</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot barmode - aligned</tt><tt><br> - </tt> <tt><br> - </tt> <tt># configure current - dataset</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - show</tt><tt><br> - </tt> <tt>$xpaget ds9 plot shape</tt><tt><br> - </tt> - <tt>$xpaget ds9 plot shape fill</tt><tt><br> - </tt> <tt>$xpaget ds9 - plot shape color</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - smooth</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - color</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - width</tt><tt><br> - </tt> <tt>$xpaget ds9 plot dash</tt><tt><br> - </tt> - <tt>$xpaget ds9 plot error</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - error color</tt><tt><br> - </tt> <tt>$xpaget ds9 plot error - width</tt><tt><br> - </tt> <tt>$xpaget ds9 plot name</tt><tt><br> - </tt> - <tt>$xpaset -p ds9 plot show yes</tt><tt><br> - </tt> <tt>$xpaset -p - ds9 plot shape circle</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot - shape fill no</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot shape color + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot title legend + {This is the Legend}</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot barmode</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p 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>$xpaget ds9 plot show</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot shape</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot shape fill</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot shape color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot smooth</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot width</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot dash</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot error</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot error color</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot error width</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaget ds9 plot name</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot show yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot shape circle</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot shape fill no</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot shape color cyan</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot smooth - step</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot color - red</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot width - 2</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot dash - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot error - yes</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot error color - red</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot error width - 2</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot name {My - Data}</tt><tt><br> - </tt> <tt><br> - </tt> <tt># select current - dataset</tt><tt><br> - </tt> <tt>$xpaget ds9 plot - select</tt><tt><br> - </tt> <tt>$xpaset -p ds9 plot select 2</tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot smooth step</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot color red</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot width 2</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot dash yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot error yes</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot error color red</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot error width 2</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p 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>$xpaget ds9 plot select</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot select 2</tt><br> <p><b><a name="png" id="png"></a>png</b></p> <p>Load PNG image into current frame.<br> </p> @@ -2548,25 +2369,20 @@ $xpaget ds9 png > foo.png</tt><br> <tt>$xpaset -p ds9 png foo.png</tt><br> <tt><tt>$xpaset -p ds9 png new foo.png<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9 png slice foo.png<br> - </tt></tt> $cat - foo.png | xpaset ds9 png</tt> <tt><tt><tt># not available - windows</tt></tt></tt><br> - <tt><tt>$cat foo.png | xpaset ds9 png</tt> <tt>new</tt></tt> - <tt><tt><tt><tt># not available windows</tt></tt><br> - </tt> $cat - foo.png | xpaset ds9 png</tt> <tt>slice</tt> <tt><tt><tt># not - available windows<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 png slice foo.png<br> + </tt></tt> $cat foo.png | xpaset ds9 png</tt> <tt><tt><tt># + not available windows</tt></tt></tt><br> + <tt><tt>$cat foo.png | xpaset ds9 png</tt> <tt>new</tt></tt> <tt><tt><tt><tt># + not available windows</tt></tt><br> + </tt> $cat foo.png | xpaset ds9 png</tt> <tt>slice</tt> <tt><tt><tt># + not available windows<br> </tt></tt></tt> <p><b><a name="precision" id="precision"></a>precision</b></p> <p>Set region and coordinate output format precision.</p> <tt>Syntax:<br> precision <linear></tt> <tt><tt><degree></tt></tt> - <tt><tt><hms></tt></tt> - <tt><tt><tt><dms></tt></tt></tt> - <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><arcsec><br> + <tt><tt><hms></tt></tt> <tt><tt><tt><dms></tt></tt></tt> + <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> <tt><tt><tt><tt><tt><arcsec><br> <br> </tt></tt></tt></tt> Example:<br> $xpaget ds9 precision<br> @@ -2606,8 +2422,7 @@ [filename <filename>]<br> [color rgb|cmyk|gray]<br> [level 1|2]<br> - [resolution - 53|72|75|150|300|600]<br> + [resolution 53|72|75|150|300|600]<br> <br> Example:<br> $xpaget ds9 print destination<br> @@ -2664,12 +2479,10 @@ [skyformat degrees|sexagesimal]<br> [strip yes|no]<br> - [shape - <shape>]<br> + [shape <shape>]<br> [color &ltcolor>]<br> - [width - <width>]<br> + [width <width>]<br> </tt> <tt> [fixed|edit|rotate|delete yes|no]<br> @@ -2681,23 +2494,20 @@ [template <filename>]<br> [template <filename> - at - <ra> <dec> <coordsys> <skyframe>]<br> + at <ra> <dec> <coordsys> <skyframe>]<br> [savetemplate <filename>]<br> [groups]<br> [group new]<br> [group <tag> new]<br> - [group <tag> - update]<br> + [group <tag> update]<br> [group <tag> select]<br> [group <tag> color &ltcolor>]<br> [group <tag> copy]<br> - [group <tag> - delete]<br> + [group <tag> delete]<br> [group <tag> cut]<br> [group <tag> font <font>]<br> @@ -2708,8 +2518,7 @@ [group <tag> moveback]<br> [group <tag> - property - <property> yes|no]<br> + property <property> yes|no]<br> [copy]<br> [cut]<br> [paste @@ -2723,8 +2532,7 @@ fk4|fk5|icrs|galactic|ecliptic]<br> [-skyformat degrees|sexagesimal]<br> - [-delim - [nl|<char>]]<br> + [-delim [nl|<char>]]<br> [-prop select|edit|move|rotate|delete|fixed|include|source 1|0]<br> [-group <tag>]<br> @@ -2774,8 +2582,7 @@ $xpaset -p ds9 regions -format ciao bar.reg # load as ciao format<br> $xpaset -p ds9 regions foo.fits # FITS regions files do not need - a - format specification<br> + a format specification<br> $xpaset -p ds9 regions load foo.reg # load foo.reg into current frame<br> $xpaset -p ds9 regions load all foo.reg # load foo.reg into all @@ -2812,19 +2619,16 @@ $xpaset -p ds9 regions width 3<br> $xpaset -p ds9 regions edit yes<br> $xpaset -p ds9 regions include<br> - $xpaset -p ds9 regions command '{circle 100 100 20 # - color=red}'<br> + $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}'<br> $xpaset -p ds9 regions composite<br> $xpaset -p ds9 regions dissolve<br> $xpaset -p ds9 regions template foo.tpl<br> $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 - +47:12:48.02 - fk5<br> + +47:12:48.02 fk5<br> $xpaset -p ds9 regions savetemplate foo.tpl<br> $xpaset -p ds9 regions group new<br> $xpaset -p ds9 regions group foo new<br> - </tt> <tt>$xpaset -p ds9 - regions group foo update</tt><br> + </tt> <tt>$xpaset -p ds9 regions group foo update</tt><br> <tt>$xpaset -p ds9 regions group foo select</tt><br> <tt>$xpaset -p ds9 regions group foo color red<br> $xpaset -p ds9 regions group foo copy<br> @@ -2863,8 +2667,7 @@ <br> Example:<br> $xpaget ds9 rgb channel<br> - </tt> <tt>$xpaget ds9 rgb lock - wcs</tt><br> + </tt> <tt>$xpaget ds9 rgb lock wcs</tt><br> <tt>$xpaget ds9 rgb lock crop</tt><br> <tt>$xpaget ds9 rgb lock slice</tt><br> <tt>$xpaget ds9 rgb lock bin<br> @@ -2882,8 +2685,7 @@ $xpaset -p ds9 rgb channel red # set current channel to red<br> $xpaset -p ds9 rgb view blue no # turn off blue channel<br> $xpaset -p ds9 rgb system wcs # set rgb coordinate system<br> - </tt> - <tt>$xpaset -p ds9 rgb lock wcs yes</tt><br> + </tt> <tt>$xpaset -p ds9 rgb lock wcs yes</tt><br> <tt>$xpaset -p ds9 rgb lock crop yes</tt><br> <tt>$xpaset -p ds9 rgb lock slice yes</tt><br> <tt>$xpaset -p ds9 rgb lock bin yes</tt><br> @@ -2907,8 +2709,7 @@ $xpaget ds9 rgbarray little > foo.arr<br> $xpaset -p ds9 rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> - $xpaset -p ds9 rgbarray new - foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> + $xpaset -p ds9 rgbarray new foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> <tt>$cat foo.arr | xpaset ds9 rgbarray [dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> <tt>$cat foo.arr | xpaset ds9 rgbarray new @@ -2923,26 +2724,23 @@ $xpaget ds9 rgbcube > foo.fits<br> $xpaset -p ds9 rgbcube foo.fits</tt><br> <tt><tt>$xpaset -p ds9 rgbcube new foo.fits<br> - </tt> $cat foo.fits - | xpaset ds9 rgbcube</tt><br> + </tt> $cat foo.fits | xpaset ds9 rgbcube</tt><br> <tt>$cat foo.fits | xpaset ds9 rgbcube</tt> <tt>new</tt><br> <p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> <p>Load FITS rgbimage into rgb frame.<br> </p> - <tt>Syntax:<br> - rgbimage [new] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 rgbimage > foo.fits<br> - $xpaset -p ds9 rgbimage foo.fits</tt><br> - <tt><tt>$xpaset -p ds9 rgbimage new foo.fits<br> - </tt> $cat foo.fits - | xpaset ds9 rgbimage</tt><br> - <tt>$cat foo.fits | xpaset ds9 rgbimage</tt> <tt>new<br> - </tt> + <tt>Syntax:</tt><tt><br> + </tt><tt> rgbimage [new] [<filename>]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> $xpaget ds9 rgbimage > foo.fits</tt><tt><br> + </tt><tt> $xpaset -p ds9 rgbimage foo.fits</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 rgbimage new foo.fits</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.fits | xpaset ds9 rgbimage</tt><tt><br> + </tt><tt> </tt><tt>$cat foo.fits | xpaset ds9 rgbimage</tt><tt> </tt><tt>new</tt><tt><br> + </tt><tt> </tt><tt> </tt> <p><b><a name="rotate" id="rotate"></a>rotate</b></p> - <p>Controls the rotation angle (in degrees) of the current - frame.</p> + <p>Controls the rotation angle (in degrees) of the current frame.</p> <tt>Syntax:<br> rotate [<value>]<br> [to <value>]<br> @@ -2968,8 +2766,7 @@ <tt>$xpaset -p ds9 save fits foo.fits table<br> $xpaset -p ds9 save fits foo.fits slice</tt><br> <tt>$xpaset -p ds9 save rgbimage foo.fits<br> - </tt> <tt>$xpaset -p - ds9 save rgbcube foo.fits</tt><br> + </tt> <tt>$xpaset -p ds9 save rgbcube foo.fits</tt><br> <tt>$xpaset -p ds9 save mecube foo.fits</tt><br> <tt>$xpaset -p ds9 save mosaic foo.fits</tt><br> <tt>$xpaset -p ds9 save mosaicimage foo.fits</tt><br> @@ -2981,8 +2778,7 @@ 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</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> @@ -3072,67 +2868,65 @@ </b> <p>Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.</p> - <tt>Syntax:<br> - sia - [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]<br> - <br> - </tt> <tt> </tt><tt> [<ref>] - [cancel]<br> - </tt> <tt> [<ref>] - [clear]<br> - </tt> <tt> [<ref>] - [close]</tt><br> - <tt> [<ref>] [coordinate <ra> - <dec> <coordsys>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[<ref>] [crosshair]</tt><br> - <tt> [<ref>] [export sb|tsv - <filename>]<br> - </tt> <tt> [<ref>] - [name <object>]<br> - </tt> <tt> [<ref>] - [print]</tt><br> - <tt> [<ref>] [retrieve]</tt><br> - <tt> [<ref>] [save - <filename>]</tt><br> - <tt> [<ref>] [radius <value> - degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> [<ref>] - [skyformat <skyformat>]<br> - </tt> <tt> - [<ref>] [system <coordsys>]</tt><tt><br> - </tt> - <tt> </tt> <tt>[<ref>] [update]</tt><br> + last search created, unless indicated otherwise.</p> + <tt>Syntax:</tt><tt><br> + </tt><tt> sia + [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> [<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><br> <tt><br> Example:<br> $xpaget ds9 sia<br> </tt> <tt><br> $xpaset -p ds9 sia 2mass<br> - </tt> <tt>$xpaset -p ds9 sia - cancel<br> + </tt> <tt>$xpaset -p ds9 sia cancel<br> </tt> <tt>$xpaset -p ds9 sia clear<br> - </tt> <tt>$xpaset - -p ds9 sia close<br> - </tt> <tt>$xpaset -p ds9 sia coordinate 202.48 - 47.21 fk5<br> + </tt> <tt>$xpaset -p ds9 sia close<br> + </tt> <tt>$xpaset -p ds9 sia coordinate 202.48 47.21 fk5<br> </tt> <tt>$xpaset -p ds9 sia crosshair<br> - </tt> - <tt>$xpaset -p ds9 sia export tsv bar.tsv<br> - </tt> <tt>$xpaset -p - ds9 sia name m51<br> + </tt> <tt>$xpaset -p ds9 sia export tsv bar.tsv<br> + </tt> <tt>$xpaset -p ds9 sia name m51<br> </tt> <tt>$xpaset -p ds9 sia print</tt><br> <tt>$xpaset -p ds9 sia retrieve<br> $xpaset -p ds9 sia save foo.xml<br> - </tt> <tt>$xpaset -p ds9 sia - radius 1 degrees</tt><br> + </tt> <tt>$xpaset -p ds9 sia radius 1 degrees</tt><br> <tt>$xpaset -p ds9 sia sky fk5<br> $xpaset -p ds9 sia skyformat degrees<br> - </tt> <tt>$xpaset -p ds9 - sia system wcs</tt><tt><br> + </tt> <tt>$xpaset -p ds9 sia system wcs</tt><tt><br> </tt> <tt>$xpaset -p ds9 sia update<br> <br> </tt> <b><a name="single" id="single"></a>single</b> @@ -3152,8 +2946,7 @@ [name <object>|clear]<br> [<ra> - <dec>] - # in wcs fk5<br> + <dec>] # in wcs fk5<br> [size <width> <height> degrees|arcmin|arcsec]<br> [pixels <width> @@ -3175,12 +2968,9 @@ $xpaget ds9 skyview survey<br> $xpaset -p ds9 skyview<br> $xpaset -p ds9 skyview m31<br> - </tt> <tt><tt>$xpaset -p ds9 skyview - name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 skyview name - clear<br> - </tt></tt> $xpaset -p ds9 skyview 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 skyview name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 skyview name clear<br> + </tt></tt> $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 skyview size 60 60 arcmin<br> $xpaset -p ds9 skyview pixels 600 600<br> $xpaset -p ds9 skyview save yes<br> @@ -3188,8 +2978,7 @@ $xpaset -p ds9 skyview update frame<br> $xpaset -p ds9 skyview survey sdssi<br> $xpaset -p ds9 skyview open<br> - </tt> <tt>$xpaset -p ds9 skyview - close</tt><br> + </tt> <tt>$xpaset -p ds9 skyview close</tt><br> <p><b><a name="sleep" id="sleep"></a>sleep</b></p> <p>Delays execution for specified number of seconds. Default is 1 second.<br> @@ -3206,8 +2995,7 @@ Boxcar width = <i>2*radius+1</i><br> Tophat diameter = <i>2*radius+1</i><br> Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> - Elliptical Gaussian diameter = <i>2*radius+1,</i> mean - <i>=0<br> + Elliptical Gaussian diameter = <i>2*radius+1,</i> mean <i>=0<br> </i> <br> <tt>Syntax:</tt><br> </p> @@ -3215,60 +3003,79 @@ [yes|no]<br> [function boxcar|tophat|gaussian]<br> - </tt> - <tt> [radius + </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> + </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> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt> [angle + + + + + <value>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt> - <tt> [match]<br> + </tt></tt></tt></tt></tt></tt></tt></tt> <tt> + + + + + [match]<br> [lock [yes|no]]</tt><br> <tt><tt> [open|close]<br> <br> </tt> Example:<br> $xpaget ds9 smooth<br> $xpaget ds9 smooth function<br> - </tt> <tt><tt>$xpaget ds9 smooth - radius<br> - </tt></tt> <tt><tt>$xpaget ds9 smooth - radiusminor<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaget ds9 - smooth sigma<br> - </tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaget ds9 smooth - sigmaminor<br> + </tt> <tt><tt>$xpaget ds9 smooth radius<br> + </tt></tt> <tt><tt>$xpaget ds9 smooth radiusminor<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaget ds9 smooth sigma<br> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaget + + + + + ds9 smooth sigmaminor<br> </tt></tt></tt></tt></tt></tt></tt></tt> $xpaget - ds9 - smooth lock<br> + ds9 smooth lock<br> $xpaset -p ds9 smooth<br> $xpaset -p ds9 smooth yes<br> $xpaset -p ds9 smooth function tophat<br> - </tt> <tt><tt>$xpaset -p - ds9 smooth radius 4<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset - -p ds9 smooth radiusminor 4<br> - </tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth sigma - 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth - sigmaminor 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 - smooth angle - 45<br> + </tt> <tt><tt>$xpaset -p ds9 smooth radius 4<br> + </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth + radiusminor 4<br> + </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset + + + + + -p ds9 smooth sigma 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset + + + + + -p ds9 smooth sigmaminor 2.0<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset + + + + + -p ds9 smooth angle 45<br> </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> $xpaset -p ds9 smooth match<br> $xpaset -p ds9 smooth lock yes</tt><br> @@ -3304,28 +3111,24 @@ $xpaget ds9 threads<br> $xpaset -p ds9 threads 8</tt><br> <p><b><a name="tiff" id="tiff"></a>tiff</b></p> - <p>Load TIFF image into current frame. Optional parameters: - <tt>tiff</tt> compression method.</p> - <tt>Syntax:<br> - tiff [new|slice] [<filename>] - [none|jpeg|packbits|deflate]<br> - <br> - Example:<br> - $xpaget ds9 tiff > foo.tiff</tt><br> - <tt><tt>$xpaget ds9 tiff jpeg > foo.tiff</tt><br> - $xpaset -p ds9 tiff foo.tiff</tt><br> - <tt><tt>$xpaset -p ds9 tiff new foo.tiff<br> - </tt></tt> - <tt><tt><tt>$xpaset -p ds9 tiff slice foo.tiff<br> - </tt></tt> $cat - foo.tiff | xpaset ds9 tiff</tt> <tt><tt><tt># not available - windows</tt></tt></tt><br> - <tt><tt>$cat foo.tiff | xpaset ds9 tiff</tt> <tt>new</tt></tt> - <tt><tt><tt><tt># not available windows</tt></tt><br> - </tt> $cat - foo.tiff | xpaset ds9 tiff</tt> <tt>slice</tt> <tt><tt><tt># - not - available windows</tt></tt></tt> + <p>Load TIFF image into current frame. Optional parameters: <tt>tiff</tt> + compression method.</p> + <tt>Syntax:</tt><tt><br> + </tt><tt> tiff [new|slice] [<filename>] + [none|jpeg|packbits|deflate]</tt><tt><br> + </tt><tt> </tt><tt><br> + </tt><tt> Example:</tt><tt><br> + </tt><tt> $xpaget ds9 tiff > foo.tiff</tt><tt><br> + </tt><tt> </tt><tt>$xpaget ds9 tiff jpeg > foo.tiff</tt><tt><br> + </tt><tt> $xpaset -p ds9 tiff foo.tiff</tt><tt><br> + </tt><tt> </tt><tt>$xpaset -p ds9 tiff new foo.tiff</tt><tt><br> + </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 tiff slice foo.tiff</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.tiff | xpaset ds9 tiff</tt><tt> </tt><tt># + not available windows</tt><tt><br> + </tt><tt> </tt><tt>$cat foo.tiff | xpaset ds9 tiff</tt><tt> </tt><tt>new</tt><tt> + </tt><tt># not available windows</tt><tt><br> + </tt><tt> </tt><tt> $cat foo.tiff | xpaset ds9 tiff</tt><tt> </tt><tt>slice</tt><tt> + </tt><tt># not available windows</tt> <p><b><a name="tile" id="tile"></a>tile</b></p> <p>Controls the tile display mode.</p> <tt>Syntax:<br> @@ -3362,9 +3165,8 @@ 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> + 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> @@ -3413,8 +3215,7 @@ [units yes|no]<br> [image|physical|wcs|wcsa...wcsz yes|no]<br> - </tt> <tt><tt><tt> [frame - yes|no]<br> + </tt> <tt><tt><tt> [frame yes|no]<br> </tt></tt> [red yes|no]<br> [green yes|no]<br> [blue yes|no]</tt><br> @@ -3437,8 +3238,7 @@ $xpaget ds9 view image<br> $xpaget ds9 view wcsa</tt><br> <tt>$xpaget ds9 view red<br> - </tt> <tt><tt><tt>$xpaget ds9 view - frame<br> + </tt> <tt><tt><tt>$xpaget ds9 view frame<br> </tt></tt> $xpaset -p ds9 view layout vertical<br> $xpaset -p ds9 view keyvalue BITPIX<br> $xpaset -p ds9 view info yes<br> @@ -3454,8 +3254,7 @@ $xpaset -p ds9 view lowhigh yes<br> $xpaset -p ds9 view units yes<br> $xpaset -p ds9 view wcsa yes<br> - </tt> <tt><tt>$xpaset -p ds9 view - frame yes</tt></tt><br> + </tt> <tt><tt>$xpaset -p ds9 view frame yes</tt></tt><br> <tt>$xpaset -p ds9 view red yes<br> $xpaset -p ds9 view green yes<br> $xpaset -p ds9 view blue yes</tt><br> @@ -3469,8 +3268,7 @@ [<ra> <dec>] # in wcs fk5<br> [size <width> - <height> - degrees|arcmin|arcsec]<br> + <height> degrees|arcmin|arcsec]<br> [save yes|no]<br> [frame new|current]<br> [update frame|crosshair]<br> @@ -3486,20 +3284,16 @@ $xpaget ds9 vla survey<br> $xpaset -p ds9 vla<br> $xpaset -p ds9 vla m31<br> - </tt> <tt><tt>$xpaset -p ds9 vla name - m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 vla name - clear<br> - </tt></tt> $xpaset -p ds9 vla 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 vla name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 vla name clear<br> + </tt></tt> $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 vla size 60 60 arcmin<br> $xpaset -p ds9 vla save yes<br> $xpaset -p ds9 vla frame current<br> $xpaset -p ds9 vla update frame<br> $xpaset -p ds9 vla survey stripe82<br> $xpaset -p ds9 vla open<br> - </tt> <tt>$xpaset -p ds9 vla - close<br> + </tt> <tt>$xpaset -p ds9 vla close<br> </tt> <p><b><a name="vlss" id="vlss"></a>vlss</b></p> <p>Support for NRAO VLSS Sky Survey.</p> @@ -3523,20 +3317,15 @@ $xpaget ds9 vlss frame<br> $xpaset -p ds9 vlss<br> $xpaset -p ds9 vlss m31<br> - </tt> <tt><tt>$xpaset -p ds9 vlss name - m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 vlss name - clear<br> - </tt></tt> $xpaset -p ds9 vlss 00:42:44.404 - +41:16:08.78<br> + </tt> <tt><tt>$xpaset -p ds9 vlss name m31<br> + </tt></tt> <tt><tt><tt>$xpaset -p ds9 vlss name clear<br> + </tt></tt> $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78<br> $xpaset -p ds9 vlss size 60 60 arcmin<br> $xpaset -p ds9 vlss save yes<br> $xpaset -p ds9 vlss frame current<br> $xpaset -p ds9 vlss update frame<br> $xpaset -p ds9 vlss open<br> - </tt> <tt>$xpaset -p ds9 vlss - close</tt><br> - <br> + </tt> <tt>$xpaset -p ds9 vlss close</tt><br> <p><b><a name="vo" id="vo"></a>vo</b></p> <p>Invoke an connection to a Virtual Observatory site.</p> <tt>Syntax:<br> @@ -3569,16 +3358,12 @@ <p><b><a name="wcs" id="wcs"></a>wcs</b></p> <p>Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info - panel, - compass, grid, and alignment will be modified accordingly. Also, - using this access point, a new WCS specification can be loaded - and - used by the current image regardless of the WCS that was - contained - in the image file. WCS specification can be sent to DS9 as an - ASCII - file . Please see <a href="file.html#WCS">WCS</a> for more - information.</p> + panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see <a + href="file.html#WCS">WCS</a> for more information.</p> <tt>Syntax:<br> wcs [[system] wcs|wcsa...wcsz]<br> [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> @@ -3598,11 +3383,9 @@ $xpaset -p ds9 wcs wcs<br> $xpaset -p ds9 wcs system wcs<br> $xpaset -p ds9 wcs fk5<br> - </tt> <tt>$xpaset -p ds9 wcs sky - fk5<br> + </tt> <tt>$xpaset -p ds9 wcs sky fk5<br> </tt> <tt>$xpaset -p ds9 wcs sexagesimal<br> - </tt> - <tt>$xpaset -p ds9 wcs skyformat sexagesimal<br> + </tt> <tt>$xpaset -p ds9 wcs skyformat sexagesimal<br> $xpaset -p ds9 wcs align yes<br> $xpaset -p ds9 wcs reset<br> $xpaset -p ds9 wcs reset 3<br> @@ -3693,7 +3476,7 @@ $xpaset -p ds9 zoom to 2 4<br> $xpaset -p ds9 zoom in<br> $xpaset -p ds9 zoom out<br> - <$xpaset -p ds9 zoom to fit<br> + $xpaset -p ds9 zoom to fit<br> $xpaset -p ds9 zoom open<br> $xpaset -p ds9 zoom close<br> </tt></blockquote> diff --git a/ds9/doc/release/r8.1.html b/ds9/doc/release/r8.1.html new file mode 100644 index 0000000..bd1180e --- /dev/null +++ b/ds9/doc/release/r8.1.html @@ -0,0 +1,32 @@ +<!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<meta name="generator" content= +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> +<meta http-equiv="Content-Type" content= +"text/html; charset=us-ascii"> +<meta name="GENERATOR" content= +"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> +<title>DS9 Version 8.1 Release Notes</title> +</head> +<body vlink="#551A8B" text="#000000" link="#0000EE" bgcolor= +"#FFFFFF" alink="#FF0000"> +<h3><img alt="" src="../sun.gif" width="100" height="98" align= +"middle"> SAOImageDS9 Version 8.0 Release Notes</h3> +<div style="margin-left: 2em"> +<ol> +<li><tt>10.29.2018 BLOCK: all supported WCSs now updated to reflect blocking.</tt></li> +<li><tt>10.30.2018 WFPC2: fixed an issue with blocking and WFPC2 images.</tt></li> +<li><tt>11.06.2018 SAVEIMAGE: all supported WCSs now updated to reflect current rotation, orientation, pan, and zoom.</tt></li> +<li><tt>11.26.2018 TCL/TK: updated to version 8.6.9.</tt></li> +<li><tt>12.07.2018 CONTOUR: merge old and new contour parsers so that regardless of file extension, the file will be correctly parsed.</tt></li> +<li><tt>12.10.2018 CONTOUR: LEVELS command now takes one numeric in addition to a string.</tt></li> +<li><tt>12.14.2018 GRID: add checks to avoid NULL pointers in cases of odd WCS defs.</tt></li> +<li><tt>12.14.2018 BINNING: bring forward any 3rd column WCS defines for binned 3d cubes.</tt></li> +<li><tt>12.14.2018 PLOT3D: verify 3D WCS, reset to IMAGE if not available.</tt></li> +<li><tt>12.19.2018 SAVEIMAGE: is now supported under Windows.</tt></li> +<li><tt><b>xx.xx.2018 RELEASE version 8.1b1</b></tt></li> +</ol> +</div> +</body> +</html> |