diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2019-04-26 20:08:14 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2019-04-26 20:08:14 (GMT) |
commit | 608d1942c190fd615027e49c766083f65526818a (patch) | |
tree | b310d7c2bac51ccbae42e83af3cc9a879d1f168c /ds9 | |
parent | 3de51ebd8f1c533d7cc1fb62ac93682eb03229ee (diff) | |
download | blt-608d1942c190fd615027e49c766083f65526818a.zip blt-608d1942c190fd615027e49c766083f65526818a.tar.gz blt-608d1942c190fd615027e49c766083f65526818a.tar.bz2 |
clean up html
Diffstat (limited to 'ds9')
-rw-r--r-- | ds9/doc/ref/xpa.html | 6890 |
1 files changed, 2994 insertions, 3896 deletions
diff --git a/ds9/doc/ref/xpa.html b/ds9/doc/ref/xpa.html index fdde311..28ac728 100644 --- a/ds9/doc/ref/xpa.html +++ b/ds9/doc/ref/xpa.html @@ -1,3907 +1,3005 @@ <!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> - <head> - <meta name="generator" content="HTML Tidy for Mac OS X (vers 31 - October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> - <meta http-equiv="Content-Type" content="text/html; - charset=windows-1252"> - <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux - 2.4.7-10 i686) [Netscape]"> - <title>XPA Access Points</title> - </head> - <body vlink="#551A8B" alink="#FF0000" link="#0000FF"> - <h3><img alt="" src="../sun.gif" width="100" align="middle" - height="98"> XPA Access Points</h3> - <blockquote> - <p>The <a href="http://hea-www.harvard.edu/RD/xpa/index.html">XPA</a> - messaging system provides seamless communication between DS9 and - other Unix programs, including X programs, Perl, <a - href="http://space.mit.edu/cxc/software/slang/modules/xpa/">S-Lang,</a> - and Tcl/Tk. It also provides an easy way for users to - communicate with DS9 by executing XPA client commands in the - shell or by utilizing such commands in scripts. Because XPA - works both at the programming level and the shell level, it is a - powerful tool for unifying any analysis environment.</p> - <tt><a href="#2mass">2mass</a><br> - <a href="#3d">3d</a><br> - <a href="#about">about</a><br> - <a href="#align">align</a><br> - <a href="#analysis">analysis</a><br> - <a href="#array">array</a><br> - <a href="#background">background</a><br> - <a href="#backup">backup</a><br> - <a href="#bin">bin</a><br> - <a href="#blink">blink</a><br> - <a href="#block">block</a><br> - <a href="#catalog">catalog</a><br> - <a href="#cd">cd</a><br> - <a href="#cmap">cmap</a><br> - <a href="#colorbar">colorbar</a><br> - <a href="#console">console</a><br> - <a href="#contour">contour</a><br> - <a href="#crop">crop</a><br> - <a href="#crosshair">crosshair</a><br> - <a href="#cube">cube</a><br> - <a href="#cursor">cursor</a><br> - <a href="#data">data</a><br> - <a href="#dsssao">dsssao</a><br> - <a href="#dsseso">dsseso</a><br> - <a href="#dssstsci">dssstsci</a><br> - <a href="#envi">envi</a><br> - <a href="#exit">exit</a><br> - <a href="#export">export</a><br> - <a href="#file">file</a><br> - <a href="#fits">fits</a><br> - <a href="#frame">frame</a><br> - <a href="#gif">gif</a><br> - <a href="#grid">grid</a><br> - <a href="#header">header</a><br> - <a href="#height">height</a><br> - <a href="#iconify">iconify</a><br> - </tt> <tt><tt><a href="#iexam">iexam</a><br> - </tt> <a href="#iis">iis</a><br> - <a href="#jpeg">jpeg</a><br> - <a href="#lock">lock</a><br> - <a href="#lower">lower</a><br> - <a href="#magnifier">magnifier</a><br> - <a href="#mask">mask</a><br> - <a href="#match">match</a><br> - <a href="#mecube">mecube</a><br> - <a href="#minmax">minmax</a><br> - <a href="#mode">mode</a><br> - <a href="#mosaic">mosaic</a><br> - <a href="#mosaicimage">mosaicimage</a><br> - <a href="#movie">movie</a><br> - <a href="#multiframe">multiframe</a><br> - <a href="#nameserver">nameserver</a><br> - <a href="#nrrd">nrrd</a><br> - <a href="#nvss">nvss</a><br> - <a href="#orient">orient</a><br> - <a href="#pagesetup">pagesetup</a><br> - <a href="#pan">pan</a><br> - <a href="#pixeltable">pixeltable</a><br> - <a href="#plot">plot</a><br> - <a href="#png">png</a><br> - <a href="#precision">precision</a><br> - <a href="#prefs">prefs</a><br> - <a href="#preserve">preserve</a><br> - <a href="#print">psprint</a><br> - <a href="#print">print</a><br> - <a href="#exit">quit</a><br> - <a href="#raise">raise</a><br> - <a href="#regions">regions</a><br> - <a href="#restore">restore</a><br> - <a href="#rgb">rgb</a><br> - <a href="#rgbarray">rgbarray</a><br> - <a href="#rgbcube">rgbcube</a><br> - <a href="#rgbimage">rgbimage</a><br> - <a href="#rotate">rotate</a><br> - <a href="#save">save</a><br> - <a href="#saveimage">saveimage</a><br> - <a href="#scale">scale</a><br> - <a href="#shm">shm</a></tt><br> - <tt><tt><a href="#sia">sia</a><br> - </tt> <a href="#single">single</a><br> - <a href="#skyview">skyview</a><br> - <a href="#sleep">sleep</a><br> - <a href="#smooth">smooth</a><br> - <a href="#source">source</a><br> - <a href="#tcl">tcl</a><br> - <a href="#threads">threads</a><br> - <a href="#tile">tile</a><br> - <a href="#update">update</a><br> - <a href="#url">url</a><br> - <a href="#version">version</a><br> - <a href="#view">view</a><br> - <a href="#vla">vla</a></tt><br> - <tt><tt><a href="#vlss">vlss</a><br> - </tt> <a href="#vo">vo</a><br> - <a href="#wcs">wcs</a><br> - <a href="#web">web</a><br> - <a href="#width">width</a><br> - <a href="#xpa">xpa</a><br> - <a href="#zscale">zscale</a><br> - <a href="#zoom">zoom</a><br> - </tt> - <p><b><a name="2mass"></a>2mass</b></p> - <p>Support for 2MASS Digital Sky Survey.</p> - <tt>Syntax:<br> - 2mass []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs - fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey j|h|k]<br> - </tt> <tt> [open|close]<br> - </tt> <tt> <br> - Example:<br> - $xpaget ds9 2mass name<br> - $xpaget ds9 2mass coord<br> - $xpaget ds9 2mass size<br> - $xpaget ds9 2mass save<br> - $xpaget ds9 2mass frame<br> - $xpaget ds9 2mass survey<br> - $xpaset -p ds9 2mass<br> - </tt> <tt>$xpaset -p ds9 2mass m31<br> - </tt> <tt><tt>$xpaset -p ds9 2mass name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 2mass name clear<br> - </tt></tt> $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 2mass size 60 60 arcmin<br> - $xpaset -p ds9 2mass save yes<br> - $xpaset -p ds9 2mass frame current<br> - $xpaset -p ds9 2mass update frame<br> - $xpaset -p ds9 2mass survey j<br> - </tt> <tt>$xpaset -p ds9 2mass open<br> - $xpaset -p ds9 2mass close</tt><br> - <p><b><a name="3d"></a>3d</b></p> - <p>Support for 3D frame.</p> - <tt>Syntax:<br> - 3d []<br> - [view <az> <el>]<br> - [az <az>]<br> - [el <el>]<br> - [scale <scale>]<br> - [method mip|aip]</tt><br> - <tt><tt> [background none|azimuth|elevation]<br> - </tt> </tt><tt> [border yes|no]<br> - [border color <color>]</tt><br> - <tt> [highlite yes|no]<br> - [highlite color <color>]<br> - </tt> <tt><tt> </tt><tt> [compass yes|no]<br> - [compass color <color>]</tt><br> - </tt> <tt><tt><tt> [match]<br> - [lock [yes|no]]<br> - </tt></tt> [open|close]<br> - </tt> <tt> <br> - Example:<br> - $xpaget ds9 3d view<br> - $xpaget ds9 3d az<br> - $xpaget ds9 3d el<br> - $xpaget ds9 3d scale<br> - $xpaget ds9 3d method<br> - </tt> <tt>$xpaget ds9 3d background<br> - </tt> <tt>$xpaget ds9 3d border<br> - $xpaget ds9 3d border color</tt><br> - <tt>$xpaget ds9 3d highlite<br> - $xpaget ds9 3d highlite color<br> - </tt> <tt><tt>$xpaget ds9 3d compass<br> - </tt></tt> <tt><tt><tt><tt>$xpaget ds9 3d compass color</tt><br> - </tt></tt></tt> <tt><tt><tt><tt><tt>$xpaget ds9 3d lock</tt><br> - </tt></tt></tt> $xpaset -p ds9 3d # create new 3D frame<br> - $xpaset -p ds9 3d view 45 30<br> - $xpaset -p ds9 3d az 45<br> - $xpaset -p ds9 3d el 30<br> - $xpaset -p ds9 3d scale 10<br> - $xpaset -p ds9 3d method mip</tt><br> - <tt>$xpaset -p ds9 3d background azimuth<br> - </tt> <tt>$xpaset -p ds9 3d border yes<br> - $xpaset -p ds9 3d border color red</tt><br> - <tt>$xpaset -p ds9 3d highlite yes<br> - $xpaset -p ds9 3d highlite color red<br> - </tt> <tt><tt><tt>$xpaset -p ds9 3d compass yes<br> - </tt></tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d - compass color red</tt><br> - </tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt>$xpaset - - - - - - - - - - - - - -p ds9 3d match</tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset -p ds9 3d lock - yes</tt><br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> - $xpaset -p ds9 3d open<br> - $xpaset -p ds9 3d close<br> - </tt> - <p><b><a name="about" id="about"></a>about</b></p> - <p>Get DS9 credits.</p> - <tt>Syntax:<br> - about<br> - <br> - Example:<br> - $xpaget ds9 about<br> - </tt> - <p><b><a name="align" id="align"></a>align</b></p> - <p>Controls the World Coordinate System alignment for the current - frame.</p> - <tt>Syntax:<br> - align []<br> - [yes|no]<br> - <br> - Example:<br> - $xpaget ds9 align<br> - $xpaset -p ds9 align yes<br> - </tt> - <p><b><a name="analysis" id="analysis"></a>analysis</b></p> - <p>Control external analysis tasks. Tasks are numbered as they are - loaded, starting with 0. Can also be used to display a message - and display text in the text dialog window.</p> - <tt>Syntax:<br> - analysis [<task number>]<br> - - [<filename>]<br> - [task <task - number>|<task name>]<br> - [load - <filename>]<br> - [clear]<br> - [clear][load - <filename>]<br> - [message - ok|okcancel|yesno <message>]<br> - [entry - <message>]<br> - [text]</tt><tt><tt><br> - <br> - </tt> Example:<br> - $xpaget ds9 analysis<br> - $xpaget ds9 analysis task<br> - $xpaget ds9 analysis entry {Please enter something}<br> - $xpaget ds9 analysis message okcancel {Hello World}<br> - $xpaset -p ds9 analysis 0 # invoke first analysis task<br> - $xpaset -p ds9 analysis task 0<br> - $xpaset -p ds9 analysis task foobar<br> - $xpaset -p ds9 analysis {foo bar}<br> - $xpaset -p ds9 analysis my.ans<br> - $xpaset -p ds9 analysis load my.ans<br> - $xpaset -p ds9 analysis clear<br> - $xpaset -p ds9 analysis clear load my.ans<br> - $xpaset -p ds9 analysis message {This is a message}<br> - $xpaset -p ds9 analysis text {this is text}<br> - $cat my.ans | xpaset ds9 analysis load<br> - $cat foo.txt | xpaset ds9 analysis text<br> - </tt> - <p><b><a name="array" id="array"></a>array</b></p> - <p>Load raw data array into current frame.<br> - </p> - <tt>Syntax:<br> - array [native|little|big]<br> - array [new|mask] +<head> +<meta name="generator" content= +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 16.1), see www.w3.org"> +<meta http-equiv="Content-Type" content= +"text/html; charset=us-ascii"> +<meta name="GENERATOR" content= +"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> +<title>XPA Access Points</title> +</head> +<body vlink="#551A8B" link="#0000FF" alink="#FF0000"> +<h3><img alt="" src="../sun.gif" width="100" height="98" align= +"middle"> XPA Access Points</h3> +<blockquote> +<p>The <a href= +"http://hea-www.harvard.edu/RD/xpa/index.html">XPA</a> messaging +system provides seamless communication between DS9 and other Unix +programs, including X programs. 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.<br></p> +<tt><a href="#2mass">2mass</a><br> +<a href="#3d">3d</a><br> +<a href="#about">about</a><br> +<a href="#align">align</a><br> +<a href="#analysis">analysis</a><br> +<a href="#array">array</a><br> +<a href="#background">background</a><br> +<a href="#backup">backup</a><br> +<a href="#bin">bin</a><br> +<a href="#blink">blink</a><br> +<a href="#block">block</a><br> +<a href="#catalog">catalog</a><br> +<a href="#cd">cd</a><br> +<a href="#cmap">cmap</a><br> +<a href="#colorbar">colorbar</a><br> +<a href="#console">console</a><br> +<a href="#contour">contour</a><br> +<a href="#crop">crop</a><br> +<a href="#crosshair">crosshair</a><br> +<a href="#cube">cube</a><br> +<a href="#cursor">cursor</a><br> +<a href="#data">data</a><br> +<a href="#dsssao">dsssao</a><br> +<a href="#dsseso">dsseso</a><br> +<a href="#dssstsci">dssstsci</a><br> +<a href="#envi">envi</a><br> +<a href="#exit">exit</a><br> +<a href="#export">export</a><br> +<a href="#file">file</a><br> +<a href="#fits">fits</a><br> +<a href="#frame">frame</a><br> +<a href="#gif">gif</a><br> +<a href="#grid">grid</a><br> +<a href="#header">header</a><br> +<a href="#height">height</a><br> +<a href="#iconify">iconify</a><br> +<a href="#iexam">iexam</a><br> +<a href="#iis">iis</a><br> +<a href="#jpeg">jpeg</a><br> +<a href="#lock">lock</a><br> +<a href="#lower">lower</a><br> +<a href="#magnifier">magnifier</a><br> +<a href="#mask">mask</a><br> +<a href="#match">match</a><br> +<a href="#mecube">mecube</a><br> +<a href="#minmax">minmax</a><br> +<a href="#mode">mode</a><br> +<a href="#mosaic">mosaic</a><br> +<a href="#mosaicimage">mosaicimage</a><br> +<a href="#movie">movie</a><br> +<a href="#multiframe">multiframe</a><br> +<a href="#nameserver">nameserver</a><br> +<a href="#nrrd">nrrd</a><br> +<a href="#nvss">nvss</a><br> +<a href="#orient">orient</a><br> +<a href="#pagesetup">pagesetup</a><br> +<a href="#pan">pan</a><br> +<a href="#pixeltable">pixeltable</a><br> +<a href="#plot">plot</a><br> +<a href="#png">png</a><br> +<a href="#precision">precision</a><br> +<a href="#prefs">prefs</a><br> +<a href="#preserve">preserve</a><br> +<a href="#print">psprint</a><br> +<a href="#print">print</a><br> +<a href="#exit">quit</a><br> +<a href="#raise">raise</a><br> +<a href="#regions">regions</a><br> +<a href="#restore">restore</a><br> +<a href="#rgb">rgb</a><br> +<a href="#rgbarray">rgbarray</a><br> +<a href="#rgbcube">rgbcube</a><br> +<a href="#rgbimage">rgbimage</a><br> +<a href="#rotate">rotate</a><br> +<a href="#save">save</a><br> +<a href="#saveimage">saveimage</a><br> +<a href="#scale">scale</a><br> +<a href="#shm">shm</a><br> +<a href="#sia">sia</a><br> +<a href="#single">single</a><br> +<a href="#skyview">skyview</a><br> +<a href="#sleep">sleep</a><br> +<a href="#smooth">smooth</a><br> +<a href="#source">source</a><br> +<a href="#tcl">tcl</a><br> +<a href="#threads">threads</a><br> +<a href="#tile">tile</a><br> +<a href="#update">update</a><br> +<a href="#url">url</a><br> +<a href="#version">version</a><br> +<a href="#view">view</a><br> +<a href="#vla">vla</a><br> +<a href="#vlss">vlss</a><br> +<a href="#vo">vo</a><br> +<a href="#wcs">wcs</a><br> +<a href="#web">web</a><br> +<a href="#width">width</a><br> +<a href="#xpa">xpa</a><br> +<a href="#zscale">zscale</a><br> +<a href="#zoom">zoom</a><br></tt> +<p><b><a name="2mass"></a>2mass</b></p> +<p>Support for 2MASS Digital Sky Survey.</p> +<tt>Syntax:<br> +2mass []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 2mass name<br> +$xpaget ds9 2mass coord<br> +$xpaget ds9 2mass size<br> +$xpaget ds9 2mass save<br> +$xpaget ds9 2mass frame<br> +$xpaget ds9 2mass survey<br> +$xpaset -p ds9 2mass<br> +$xpaset -p ds9 2mass m31<br> +$xpaset -p ds9 2mass name m31<br> +$xpaset -p ds9 2mass name clear<br> +$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> +$xpaset -p ds9 2mass open<br> +$xpaset -p ds9 2mass close</tt><br> +<p><b><a name="3d"></a>3d</b></p> +<p>Support for 3D frame.</p> +<tt>Syntax:<br> +3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]<br> + [background none|azimuth|elevation]<br> + [border yes|no]<br> + [border color <color>]<br> + [highlite yes|no]<br> + [highlite color <color>]<br> + [compass yes|no]<br> + [compass color <color>]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 3d view<br> +$xpaget ds9 3d az<br> +$xpaget ds9 3d el<br> +$xpaget ds9 3d scale<br> +$xpaget ds9 3d method<br> +$xpaget ds9 3d background<br> +$xpaget ds9 3d border<br> +$xpaget ds9 3d border color<br> +$xpaget ds9 3d highlite<br> +$xpaget ds9 3d highlite color<br> +$xpaget ds9 3d compass<br> +$xpaget ds9 3d compass color<br> +$xpaget ds9 3d lock<br> +$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<br> +$xpaset -p ds9 3d background azimuth<br> +$xpaset -p ds9 3d border yes<br> +$xpaset -p ds9 3d border color red<br> +$xpaset -p ds9 3d highlite yes<br> +$xpaset -p ds9 3d highlite color red<br> +$xpaset -p ds9 3d compass yes<br> +$xpaset -p ds9 3d compass color red<br> +$xpaset -p ds9 3d match<br> +$xpaset -p ds9 3d lock yes<br> +$xpaset -p ds9 3d open<br> +$xpaset -p ds9 3d close</tt><br> +<p><b><a name="about" id="about"></a>about</b></p> +<p>Get DS9 credits.</p> +<tt>Syntax:<br> +about<br> + <br> +Example:<br> +$xpaget ds9 about<br></tt> +<p><b><a name="align" id="align"></a>align</b></p> +<p>Controls the World Coordinate System alignment for the current +frame.</p> +<tt>Syntax:<br> +align []<br> + [yes|no]<br> + <br> +Example:<br> +$xpaget ds9 align<br> +$xpaset -p ds9 align yes<br></tt> +<p><b><a name="analysis" id="analysis"></a>analysis</b></p> +<p>Control external analysis tasks. Tasks are numbered as they are +loaded, starting with 0. Can also be used to display a message and +display text in the text dialog window.</p> +<tt>Syntax:<br> +analysis [<task number>]<br> + [<filename>]<br> + [task <task number>|<task name>]<br> + [load <filename>]<br> + [clear]<br> + [clear][load <filename>]<br> + [message ok|okcancel|yesno <message>]<br> + [entry <message>]<br> + [text]<br> +<br> +Example:<br> +$xpaget ds9 analysis<br> +$xpaget ds9 analysis task<br> +$xpaget ds9 analysis entry {Please enter something}<br> +$xpaget ds9 analysis message okcancel {Hello World}<br> +$xpaset -p ds9 analysis 0 # invoke first analysis task<br> +$xpaset -p ds9 analysis task 0<br> +$xpaset -p ds9 analysis task foobar<br> +$xpaset -p ds9 analysis {foo bar}<br> +$xpaset -p ds9 analysis my.ans<br> +$xpaset -p ds9 analysis load my.ans<br> +$xpaset -p ds9 analysis clear<br> +$xpaset -p ds9 analysis clear load my.ans<br> +$xpaset -p ds9 analysis message {This is a message}<br> +$xpaset -p ds9 analysis text {this is text}<br> +$cat my.ans | xpaset ds9 analysis load<br> +$cat foo.txt | xpaset ds9 analysis text</tt><br> +<p><b><a name="array" id="array"></a>array</b></p> +<p>Load raw data array into current frame.<br></p> +<tt>Syntax:<br> +array [native|little|big]<br> +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> - <br> - Example:<br> - $xpaget ds9 array > foo.arr<br> - $xpaget ds9 array little > foo.arr<br> - $xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]<br> - $xpaset -p ds9 array new foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> - <tt><tt>$xpaset -p ds9 array mask foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><br> - <tt>$cat foo.arr | xpaset ds9 array - [dim=512,bitpix=-32,endian=little]</tt><br> - <tt>$cat foo.arr | xpaset ds9 array new - [dim=512,bitpix=-32,endian=little]</tt><br> - <tt>$cat foo.arr | xpaset ds9 array mask - [dim=512,bitpix=-32,endian=little]</tt> - <p><b><a name="background" id="background"></a>bg<br> - background</b></p> - <p>Set image background color.</p> - <tt>Syntax:<br> - bg <color><br> - <br> - Example:<br> - $xpaget ds9 bg</tt><tt><br> - </tt> $xpaset -p ds9 bg red<br> - <p><b><a name="backup" id="backup"></a>backup</b></p> - <p>Create a backup save set.</p> - <tt>Syntax:<br> - backup <filename><br> - <br> - Example:<br> - $xpaset -p ds9 backup ds9.bck</tt><br> - <p><b><a name="bin" id="bin"></a>bin</b></p> - <p>Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility.</p> - <tt>Syntax:<br> - bin [about <x> <y>]<br> - [about center]<br> - [buffersize <value>]<br> - [cols <x> <y>]<br> - [colsz <x> <y> <z>]<br> - [factor <value> [<vector>]]<br> - [depth <value>]<br> - [filter <string>]<br> - </tt> <tt><tt> [filter clear]<br> - </tt> [function average|sum]<br> - [in]<br> - [out]<br> - [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 bin about<br> - $xpaget ds9 bin buffersize<br> - $xpaget ds9 bin cols<br> - $xpaget ds9 bin factor<br> - $xpaget ds9 bin depth<br> - $xpaget ds9 bin filter<br> - $xpaget ds9 bin function<br> - $xpaget ds9 bin smooth<br> - $xpaget ds9 bin smooth function<br> - $xpaget ds9 bin smooth radius<br> - $xpaget ds9 bin lock<br> - $xpaset -p ds9 bin about 4096 4096<br> - $xpaset -p ds9 bin about center<br> - $xpaset -p ds9 bin buffersize 512<br> - $xpaset -p ds9 bin cols detx dety<br> - $xpaset -p ds9 bin colsz detx dety time<br> - $xpaset -p ds9 bin factor 4<br> - $xpaset -p ds9 bin factor 4 2<br> - $xpaset -p ds9 bin depth 10<br> - $xpaset -p ds9 bin filter 'pha > 5'<br> - $xpaset -p ds9 bin filter clear<br> - $xpaset -p ds9 bin function sum<br> - $xpaset -p ds9 bin in<br> - $xpaset -p ds9 bin out<br> - $xpaset -p ds9 bin to fit<br> - $xpaset -p ds9 bin match<br> - $xpaset -p ds9 bin lock yes<br> - $xpaset -p ds9 bin open<br> - $xpaset -p ds9 bin close</tt><tt><br> - </tt> - <p><b><a name="blink" id="blink"></a>blink</b></p> - <p>Blink mode parameters. Interval is in seconds.<br> - </p> - <tt>Syntax:<br> - blink []<br> - [yes|no]<br> - [interval <value>]<br> - <br> - Example:<br> - $xpaget ds9 blink<br> - $xpaget ds9 blink interval<br> - $xpaset -p ds9 blink<br> - $xpaset -p ds9 blink yes<br> - $xpaset -p ds9 blink interval 1</tt><br> - <p><b><a name="block" id="block"></a>block</b></p> - <p>Controls blocking parameters.</p> - <tt>Syntax:<br> - block</tt> <tt><tt>[<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> - <value>]<br> - [in]<br> - [out]<br> - </tt> [to fit]<br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 block<br> - $xpaget ds9 block lock<br> - </tt> <tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> 4 2<br> - </tt> <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> - to 4<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to 4 2<br> - </tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> in<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> - out<br> - </tt></tt> $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> to - fit<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> match<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> lock yes<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> open<br> - $xpaset -p ds9</tt> <tt><tt><tt>block</tt></tt> close</tt><tt><br> - </tt> - <p><b><a name="catalog" id="catalog"></a>catalog<br> - cat<br> - </b></p> - <p>Support for catalogs. The first three commands will create a - new catalog search. All other commands operated on the last - search created, unless indicated otherwise.</p> - <tt>Syntax:<br> - catalog [new]<br> - - [ned|simbad|denis|skybot]<br> - -[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> - [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - - [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds - <catalogid>]<br> - <br> - [load <filename>]<br> - [import sb|tsv - <filename>]<br> - <br> - </tt> <tt><tt> [<ref>] - [<ra> <dec> <coordsys>]</tt><tt><br> - </tt> [<ref>] [allcols]<br> - </tt> <tt> </tt><tt> - [<ref>] [allrows]<br> - </tt><tt> [<ref>] - [cancel]<br> - </tt> <tt> [<ref>] - [clear]<br> - </tt> <tt> [<ref>] [close]</tt><br> - <tt> </tt> <tt>[<ref>] - - - - - - - - - - - - - [crosshair]</tt><br> - <tt> [<ref>] [dec - <col>]</tt><br> - <tt> [<ref>] [edit - yes|no]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt> <tt> - [<ref>] [filter <string>]<br> - [<ref>] [filter load - <filename>]</tt><br> - <tt> [<ref>] - [header]</tt><br> - <tt> [<ref>] [location - <code>]</tt><br> - <tt><tt> [<ref>] - [match]<br> - </tt></tt> <tt><tt><tt> - - - - - - - - - - - - - - [<ref>] [match <ref> <ref>]<br> - </tt></tt> </tt> <tt>[<ref>] -[match - - - - - - - - - - - - - - error <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt> <tt>[<ref>] - - - - - - - - - - - - - [match function 1and2|1not2|2not1]<br> - </tt> <tt> </tt> <tt>[<ref>] - - - - - - - - - - - - [match return 1and2|1only|2only]</tt><br> - <tt> </tt> <tt>[<ref>] - - - - - - - - - - - - - [match unique yes|no]</tt><br> - <tt> [<ref>] [maxrows - <number>]</tt><br> - <tt> [<ref>] [name - <object>]<br> - </tt> <tt> - [<ref>] [panto yes|no]</tt><br> - <tt> [<ref>] [plot - <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> - <tt> [<ref>] [print]</tt><br> - <tt> [<ref>] [psky - <skyframe>]</tt><br> - <tt> [<ref>] [psystem - <coordsys>]</tt><br> - <tt> [<ref>] [ra - <col>]<br> - [<ref>] [regions]</tt><br> - <tt> [<ref>] [retrieve]</tt><br> - <tt> [<ref>] [samp]<br> - [<ref>] [samp - broadcast]<br> - [<ref>] [samp - send <application>]</tt><tt><br> - </tt> <tt> - [<ref>] [save <filename>]</tt><br> - <tt> [<ref>] - [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt><br> - <tt> [<ref>] [show - yes|no]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> [<ref>] [sky - <skyframe>]<br> - </tt> <tt> [<ref>] - [skyformat <skyformat>]<br> - </tt> <tt> [<ref>] - [sort <col> incr|decr]</tt><br> - <tt> [<ref>] [symbol - [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>]<br> - </tt> <tt> [<ref>] - [symbol [#] text|size|size2|units|angle <value>]<br> - </tt> <tt> [<ref>] - [symbol shape circle|ellipse|box|text|point]<br> - </tt> <tt><tt>[<ref>] -[symbol - - - - - - - - - - - - - - shape</tt></tt> <tt><tt>circle point|box point|diamond point|</tt>cross - - - - - - - - - - - - - point|x point|arrow point|boxcircle point]<br> - [<ref>] [symbol - add| [#] remove]<br> - [<ref>] [symbol - save|load <filename>]</tt><br> - <tt> [<ref>] [system - <coordsys>]</tt><tt><br> - </tt> <tt> </tt> <tt>[<ref>] - - - - - - - - - - - - - [update]</tt><br> - <tt> [<ref>] [x - <col>]</tt><br> - <tt> [<ref>] [y - <col>]</tt><br> - <tt> <br> - Example:<br> - $xpaget ds9 catalog<br> - </tt> <tt>$xpaget ds9 catalog header</tt><br> - <tt><br> - </tt> <tt><tt>$xpaset -p ds9 catalog new<br> - </tt> $xpaset -p ds9 catalog 2mass<br> - $xpaset -p ds9 catalog cds 2mass<br> - $xpaset -p ds9 catalog cds {I/252}<br> - <br> - </tt> <tt>$xpaset -p ds9 catalog load foo.xml<br> - $xpaset -p ds9 catalog import tsv foo.tsv<br> - <br> - </tt> <tt><tt>$xpaset -p ds9 catalog 202.48 47.21 fk5<br> - </tt> $xpaset -p ds9 catalog allrows<br> - $xpaset -p ds9 catalog allcols<br> - </tt> <tt>$xpaset -p ds9 catalog cancel<br> - </tt> <tt>$xpaset -p ds9 catalog clear<br> - </tt> <tt>$xpaset -p ds9 catalog close<br> - </tt> <tt>$xpaset -p ds9 catalog crosshair<br> - </tt> <tt>$xpaset -p ds9 catalog dec DEC<br> - </tt> <tt>$xpaset -p ds9 catalog edit yes<br> - </tt> <tt>$xpaset -p ds9 catalog export tsv bar.tsv<br> - </tt> <tt>$xpaset -p ds9 catalog filter '$Jmag>10'<br> - $xpaset -p ds9 catalog filter load foo.flt<br> - $xpaset -p ds9 catalog header<br> - </tt> <tt>$xpaset -p ds9 catalog location 500</tt><br> - <tt>$xpaset -p ds9 catalog match error 2 arcsec<br> - $xpaset -p ds9 catalog match function 1and2<br> - $xpaset -p ds9 catalog match unique no<br> - $xpaset -p ds9 catalog match return 1only<br> - </tt> <tt>$xpaset -p ds9 catalog match # last two catalogs loaded<br> - </tt> <tt>$xpaset -p ds9 catalog match 2mass csc<br> - </tt> <tt>$xpaset -p ds9 catalog maxrows 2000<br> - </tt> <tt>$xpaset -p ds9 catalog name m51<br> - $xpaset -p ds9 catalog panto no<br> - </tt> <tt>$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' - '$e_Hmag'<br> - </tt> <tt>$xpaset -p ds9 catalog print</tt><br> - <tt>$xpaset -p ds9 catalog psky fk5</tt><br> - <tt>$xpaset -p ds9 catalog psystem wcs</tt><br> - <tt>$xpaset -p ds9 catalog ra RA<br> - $xpaset -p ds9 catalog regions</tt><br> - <tt>$xpaset -p ds9 catalog retrieve<br> - </tt> <tt>$xpaset -p ds9 catalog samp broadcast<br> - $xpaset -p ds9 catalog samp send aladin<br> - $xpaset -p ds9 catalog save foo.xml<br> - </tt> <tt>$xpaset -p ds9 catalog server sao<br> - </tt> <tt>$xpaset -p ds9 catalog show yes</tt><br> - <tt>$xpaset -p ds9 catalog radius 1 degrees</tt><br> - <tt>$xpaset -p ds9 catalog symbol condition '$Jmag>15'<br> - $xpaset -p ds9 catalog symbol 2 shape {boxcircle point}<br> - $xpaset -p ds9 catalog symbol color red<br> - $xpaset -p ds9 catalog symbol font times<br> - </tt> <tt>$xpaset -p ds9 catalog symbol fontsize 14<br> - </tt> <tt>$xpaset -p ds9 catalog symbol fontweight bold<br> - </tt> <tt>$xpaset -p ds9 catalog symbol fontslant italic<br> - </tt> <tt>$xpaset -p ds9 catalog symbol add<br> - $xpaset -p ds9 catalog symbol 2 remove<br> - $xpaset -p ds9 catalog symbol load foo.sym<br> - $xpaset -p ds9 catalog symbol save bar.sym</tt><tt><br> - $xpaset -p ds9 catalog sky fk5<br> - $xpaset -p ds9 catalog skyformat degrees<br> - </tt> <tt>$xpaset -p ds9 catalog sort {Jmag} incr<br> - </tt> <tt>$xpaset -p ds9 catalog system wcs</tt><tt><br> - </tt> <tt>$xpaset -p ds9 catalog update<br> - </tt> <tt>$xpaset -p ds9 catalog x RA<br> - $xpaset -p ds9 catalog y DEC</tt><br> - <p><b><a name="cd" id="cd"></a>cd</b></p> - <p>Sets/Returns the current working directory.</p> - <tt>Syntax:<br> - cd [<directory>]<br> - <br> - Example:<br> - $xpaget ds9 cd<br> - $xpaset -p ds9 cd /home/mrbill<br> - </tt> - <p><b><a name="cmap" id="cmap"></a>cmap</b></p> - <p>Controls the colormap for the current frame. The colormap name - is not case sensitive. A valid contrast value is from 0 to - 10 and bias value from 0 to 1.</p> - <tt>Syntax:<br> - cmap [<colormap>]<br> - [file]<br> - [load <filename>]<br> - </tt> <tt> [save <filename>]<br> - </tt> <tt> [invert yes|no]<br> - [<constrast> <bias>]<br> - [tag [load|save] <filename>]<br> - [tag delete]<br> - </tt> <tt> [open|close]<br> - <br> - Example:<br> - $xpaget ds9 cmap<br> - $xpaget ds9 cmap file<br> - $xpaget ds9 cmap invert<br> - $xpaget ds9 cmap value<br> - </tt> <tt>$xpaset -p ds9 cmap Heat<br> - $xpaset -p ds9 cmap load foo.sao<br> - </tt> <tt>$xpaset -p ds9 cmap save bar.sao<br> - </tt> <tt>$xpaset -p ds9 cmap invert yes<br> - $xpaset -p ds9 cmap 5 .5<br> - $xpaset -p ds9 cmap tag load foo.tag<br> - $xpaset -p ds9 cmap tag save foo.tag<br> - $xpaset -p ds9 cmap tag delete<br> - </tt> <tt>$xpaset -p ds9 cmap open<br> - $xpaset -p ds9 cmap close<br> - </tt> - <p><b><a name="colorbar" id="colorbar"></a>colorbar<br> - </b></p> - <p>Controls colorbar parameters.</p> - <tt>Syntax:<br> - colorbar []<br> - [yes|no]<br> - [orientation]<br> - - [horizontal|vertical]<br> - [numerics - yes|no]<br> - [space - value|distance]<br> - [font - times|helvetica|courier]<br> - [fontsize - <value>]<br> - [fontweight - normal|bold]<br> - [fontslant - roman|italic]<br> - [size]<br> - [ticks]</tt><br> - <tt><tt> [match]<br> - [lock - [yes|no]]</tt><br> - </tt> <tt> </tt><br> - <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> - $xpaset -p ds9 colorbar orientation vertical<br> - $xpaset -p ds9 colorbar numerics yes<br> - $xpaset -p ds9 colorbar space value<br> - $xpaset -p ds9 colorbar font times<br> - $xpaset -p ds9 colorbar fontsize 14<br> - $xpaset -p ds9 colorbar fontweight bold<br> - $xpaset -p ds9 colorbar fontslant italic<br> - $xpaset -p ds9 colorbar size 20<br> - $xpaset -p ds9 colorbar ticks 11</tt><br> - <tt><tt>$xpaset -p ds9 colorbar match<br> - $xpaset -p ds9 colorbar lock yes</tt><br> - </tt> - <p><b><a name="console" id="console"></a>console</b></p> - <p>Display tcl console window.</p> - <tt>Syntax:<br> - -console<br> - <br> - Example:<br> - $xpaset -p ds9 console<br> - </tt> - <p><b><a name="contour" id="contour"></a>contour<br> - </b></p> - <p>Controls contours in the current frame.</p> - <tt>Syntax:<br> - contour []<br> - [yes|no]<br> - [<coordsys> - [<skyframe>]]<br> - [clear]<br> - [generate]<br> - [load - <filename>]<br> - [save <filename> - [<coordsys> <skyframe>]]<br> - [convert]<br> - [load levels - <filename>]<br> - [save levels - <filename>]<br> - [copy]<br> - [paste - [<coordsys> <color> <width> yes|no]]<br> - [color <color>]<br> - [width <width>]<br> - [dash yes|no]<br> - [smooth <smooth>]<br> - [method block|smooth]<br> - [nlevels <number of - levels>]<br> - [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [mode - minmax|<value>|zscale|zmax]<br> - [scope global|local]<br> - [limits <min> - <max>]<br> - [levels <value - value value...>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 contour<br> - $xpaget ds9 contour wcs fk5<br> - $xpaget ds9 contour color<br> - $xpaget ds9 contour width<br> - $xpaget ds9 contour dash<br> - $xpaget ds9 contour smooth<br> - $xpaget ds9 contour method<br> - $xpaget ds9 contour nlevels<br> - $xpaget ds9 contour scale<br> - $xpaget ds9 contour log exp<br> - $xpaget ds9 contour mode<br> - $xpaget ds9 contour scope<br> - $xpaget ds9 contour limits<br> - $xpaget ds9 contour levels<br> - $xpaset -p ds9 contour<br> - $xpaset -p ds9 contour yes<br> - $xpaset -p ds9 contour clear<br> - $xpaset -p ds9 contour generate<br> - </tt> <tt><tt>$xpaset -p ds9 contour load ds9.ctr<br> - </tt></tt> <tt><tt>$xpaset -p ds9 contour save ds9.ctr<br> - </tt> $xpaset -p ds9 contour save ds9.ctr wcs fk5<br> - $xpaset -p ds9 contour convert<br> - $xpaset -p ds9 contour load levels ds9.ctr</tt><br> - <tt><tt>$xpaset -p ds9 contour save levels ds9.lev<br> - </tt> $xpaset -p ds9 contour copy<br> - </tt> <tt><tt>$xpaset -p ds9 contour paste<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 contour paste wcs red 2 - no<br> - </tt></tt> $xpaset -p ds9 contour color yellow<br> - $xpaset -p ds9 contour width 2<br> - $xpaset -p ds9 contour dash yes<br> - $xpaset -p ds9 contour smooth 5<br> - $xpaset -p ds9 contour method smooth<br> - $xpaset -p ds9 contour nlevels 10<br> - $xpaset -p ds9 contour scale sqrt<br> - $xpaset -p ds9 contour log exp 1000<br> - $xpaset -p ds9 contour mode zscale<br> - $xpaset -p ds9 contour scope local<br> - $xpaset -p ds9 contour limits 1 100<br> - $xpaset -p ds9 contour levels 1 10 100 1000<br> - $xpaset -p ds9 contour open<br> - $xpaset -p ds9 contour close<br> - </tt> - <p><b><a name="crop" id="crop"></a>crop</b></p> - <p>Set current image display area.</p> - <tt>Syntax:<br> - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [reset]<br> - [3d zmin zmax <coordsys>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 crop # get crop in physical coords<br> - $xpaget ds9 crop wcs galactic sexagesimal arcsec<br> - $xpaget ds9 crop lock<br> - $xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords<br> - $xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 - 22.000204 wcs galactic arcsec<br> - $xpaset -p ds9 crop match wcs<br> - $xpaset -p ds9 crop lock wcs<br> - </tt> <tt>$xpaset -p ds9 crop reset<br> - </tt> <tt><tt>$xpaset -p ds9 crop 3d .25 .50 wcs</tt></tt><br> - <tt>$xpaset -p ds9 crop open</tt><br> - <tt>$xpaset -p ds9 crop close</tt> - <p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> - <p>Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set.</p> - <tt>Syntax:<br> - crosshair [<x> <y> <coordsys> - [<skyframe>]]<br> - [match - <coordsys>]<br> - [lock - <coordsys>|none]<br> - <br> - Example:<br> - $xpaget ds9 crosshair # get crosshair in physical coords<br> - $xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs - coords<br> - $xpaget ds9 crosshair lock<br> - $xpaset -p ds9 crosshair 100 100 physical # set crosshair in - physical<br> - $xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs - coords<br> - $xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5<br> - $xpaset -p ds9 crosshair match wcs<br> - $xpaset -p ds9 crosshair lock wcs<br> - </tt> - <p><b><a name="cube" id="cube"></a>cube<br> - </b></p> - <p>Controls FITS cube dialog.</p> - <tt>Syntax:<br> - cube []<br> - [play|stop|next|prev|first|last]<br> - [<slice> [<coordsys>]]<br> - [interval <numeric>]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [order 123|132|213|231|312|321]<br> - [axes lock [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 cube<br> - $xpaget ds9 cube wcs<br> - $xpaget ds9 cube interval<br> - $xpaget ds9 cube lock<br> - $xpaget ds9 cube order<br> - $xpaget ds9 cube axes lock<br> - $xpaset -p ds9 cube<br> - $xpaset -p ds9 cube play<br> - $xpaset -p ds9 cube last<br> - $xpaset -p ds9 cube 3<br> - $xpaset -p ds9 cube 4.4 wcs<br> - $xpaset -p ds9 cube interval 2<br> - $xpaset -p ds9 cube match wcs<br> - $xpaset -p ds9 cube lock wcs<br> - $xpaset -p ds9 cube order 123<br> - $xpaset -p ds9 cube axes lock yes<br> - $xpaset -p ds9 cube open<br> - $xpaset -p ds9 cube close</tt><br> - <p><b><a name="cursor" id="cursor"></a>cursor</b></p> - <p>Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also.</p> - <tt>Syntax:<br> - cursor [<x> <y>]<br> - <br> - Example:<br> - $xpaset -p ds9 cursor 10 10<br> - </tt> - <p><b><a name="data" id="data"></a>data</b></p> - <p>Return an array of data values given a lower left corner and a - width and height in specified coordinate system. The last - argument of yes indicates to strip the coordinates from the - output and just list the data values. The default is yes.</p> - <tt>Syntax:<br> - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]]<br> - <br> - Example:<br> - $xpaget ds9 data image 450 520 3 3 yes<br> - $xpaget ds9 data physical 899 1039 6 6 no<br> - $xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 - 0.00016516669 no<br> - $xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no</tt><tt><br> - </tt> - <p><b><a name="dsssao" id="dsssao"></a>dsssao<br> - dss<br> - </b></p> - <p>Support for Digital Sky Survey at SAO.</p> - <tt>Syntax:<br> - dsssao []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # - in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 dsssao name<br> - $xpaget ds9 dsssao coord<br> - $xpaget ds9 dsssao size<br> - $xpaget ds9 dsssao save<br> - $xpaget ds9 dsssao frame<br> - $xpaset -p ds9 dsssao<br> - $xpaset -p ds9 dsssao m31<br> - </tt> <tt><tt>$xpaset -p ds9 dsssao name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsssao name clear<br> - </tt></tt> $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 dsssao size 60 60 arcmin<br> - $xpaset -p ds9 dsssao save yes<br> - $xpaset -p ds9 dsssao frame current<br> - $xpaset -p ds9 dsssao update frame<br> - $xpaset -p ds9 dsssao open<br> - </tt> <tt>$xpaset -p ds9 dsssao close</tt><br> - <p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> - <p>Support for Digital Sky Survey at ESO.</p> - <tt>Syntax:<br> - dsseso []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # - in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 dsseso name<br> - $xpaget ds9 dsseso coord<br> - $xpaget ds9 dsseso size<br> - $xpaget ds9 dsseso save<br> - $xpaget ds9 dsseso frame<br> - $xpaget ds9 dsseso survey<br> - $xpaset -p ds9 dsseso<br> - $xpaset -p ds9 dsseso m31<br> - </tt> <tt><tt>$xpaset -p ds9 dsseso name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dsseso name clear<br> - </tt></tt> $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 dsseso size 60 60 arcmin<br> - $xpaset -p ds9 dsseso save yes<br> - $xpaset -p ds9 dsseso frame current<br> - $xpaset -p ds9 dsseso update frame<br> - $xpaset -p ds9 dsseso survey DSS2-red<br> - $xpaset -p ds9 dsseso open<br> - </tt> <tt>$xpaset -p ds9 dsseso close</tt><br> - <p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> - <p>Support for Digital Sky Survey at STSCI.</p> - <tt>Syntax:<br> - dssstsci []<br> - - [<object>]<br> - [name <object>|clear]<br> - [<ra> - <dec>] # in wcs fk5<br> - [size - <width> <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame - new|current]<br> - [update - frame|crosshair]<br> - [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> - [survey - poss1_blue|poss1_red]<br> - [survey - all|quickv|phase2_gsc2|phase2_gsc1]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 dssstsci name<br> - $xpaget ds9 dssstsci coord<br> - $xpaget ds9 dssstsci size<br> - $xpaget ds9 dssstsci save<br> - $xpaget ds9 dssstsci frame<br> - $xpaget ds9 dssstsci survey<br> - $xpaset -p ds9 dssstsci<br> - $xpaset -p ds9 dssstsci m31<br> - </tt> <tt><tt>$xpaset -p ds9 dssstsci name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 dssstsci name clear<br> - </tt></tt> $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 dssstsci size 60 60 arcmin<br> - $xpaset -p ds9 dssstsci save yes<br> - $xpaset -p ds9 dssstsci frame current<br> - $xpaset -p ds9 dssstsci update frame<br> - $xpaset -p ds9 dssstsci survey all<br> - $xpaset -p ds9 dssstsci open<br> - $xpaset -p ds9 dssstsci close</tt><br> - <p><b><a name="envi" id="envi"></a>envi</b></p> - <p>Load an ENVI header and file. Optional parameter: array endian.<br> - </p> - <tt>Syntax:<br> - envi [new] <header> [<filename>]<br> - <br> - Example:<br> - </tt> <tt><tt>$xpaset -p ds9 envi foo.hdr</tt></tt><br> - <tt><tt>$xpaset -p ds9 envi new foo.hdr<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 envi foo.hdr - foo.bsq</tt></tt><br> - <br> - </tt></tt></tt></tt> <b><a name="exit" id="exit"></a>exit</b><br> - <p><b>quits<br> - </b></p> - <p>Quits DS9.</p> - <tt>Syntax:<br> - exit<br> - quit<br> - <br> - Example:<br> - $xpaset -p ds9 exit<br> - </tt> - <p><b><a name="export" id="export"></a>export<br> - </b></p> - <p>Export loaded image data of current frame in specified image - format. Optional parameters: array endian, nrrd endian, jpeg - quality (1-100) and tiff compression method.</p> - <tt>Syntax:</tt><tt> </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> - $xpaset -p ds9 export jpeg foo.jpeg 75<br> - $xpaset -p ds9 export png foo.png</tt><br> - <p><b><a name="file" id="file"></a>file</b></p> - <p>Query currently loaded file information.</p> - <tt>Syntax:<br> - file<br> - <br> - Example:<br> - $xpaget ds9 file</tt><br> - <p><b><a name="fits" id="fits"></a>fits</b></p> - <p>Load a FITS image into the current frame or query the currently - loaded image.<br> - </p> - <tt>Syntax:<br> - fits</tt> <tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> - </tt> [width|height|depth|bitpix]<br> - [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword - <string>]]<br> - [image|table|slice]</tt><tt><br> - <br> - Example:<br> - $xpaget ds9 fits > foo.fits<br> - $xpaget ds9 fits width<br> - $xpaget ds9 fits height<br> - $xpaget ds9 fits depth<br> - $xpaget ds9 fits bitpix</tt><br> - <tt><tt>$xpaget ds9 fits size<br> - </tt> $xpaget ds9 fits size wcs fk5 arcmin<br> - $xpaget ds9 fits header # primary<br> - $xpaget ds9 fits header 2 # hdu 2<br> - $xpaget ds9 fits header -2 # hdu 2 with inherit<br> - $xpaget ds9 fits header keyword BITPIX<br> - $xpaget ds9 fits header 1 keyword BITPIX</tt><br> - <tt><tt>$xpaget ds9 fits image > foo.fits<br> - $xpaget ds9 fits table > bar.fits<br> - $xpaget ds9 fits slice > foo.fits<br> - </tt> $xpaset -p ds9 fits foo.fits<br> - $xpaset -p ds9 fits new foo.fits<br> - $xpaset -p ds9 fits bar.fits[bin=detx,dety]<br> - $xpaset -p ds9 fits slice foo.fits<br> - $xpaset -p ds9 fits mask foo.fits<br> - $cat foo.fits | xpaset ds9 fits<br> - $cat foo.fits | xpaset ds9 fits new<br> - $cat bar.fits | xpaset ds9 fits -[bin=detx,dety]<br> - $cat foo.fits | xpaset ds9 fits slice<br> - $cat foo.fits | xpaset ds9 fits mask<br> - </tt> - <p><b><a name="frame" id="frame"></a>frame</b></p> - <p>Controls frame functions. Frames may be created, deleted, - reset, and centered. While return the current frame number. If - you goto a frame that does not exists, it will be created. If - the frame is hidden, it will be shown. The 'frameno' option is - available for backward compatibility.</p> - <tt>Syntax:<br> - frame [center [#|all]]<br> - [clear [#|all]]<br> - [new [rgb|3d]]<br> - [delete [#|all]]<br> - [reset [#|all]]<br> - [refresh [#|all]]<br> - [hide [#|all]]<br> - [show [#|all]]<br> - [move first]<br> - [move back]<br> - [move forward]<br> - [move last]<br> - [first]<br> - [prev]<br> - [next]<br> - [last]<br> - [frameno #]<br> - [#]<br> - </tt> <tt> [match <coordsys>]<br> - [lock <coordsys>|none]</tt><br> - <tt> [has + <br> +Example:<br> +$xpaget ds9 array > foo.arr<br> +$xpaget ds9 array little > foo.arr<br> +$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]<br> +$xpaset -p ds9 array new +foo.arr[dim=512,bitpix=-32,endian=little]<br> +$xpaset -p ds9 array mask +foo.arr[dim=512,bitpix=-32,endian=little]<br> +$cat foo.arr | xpaset ds9 +array[dim=512,bitpix=-32,endian=little]<br> +$cat foo.arr | xpaset ds9 array +new[dim=512,bitpix=-32,endian=little]<br> +$cat foo.arr | xpaset ds9 array mask +[dim=512,bitpix=-32,endian=little]</tt> +<p><b><a name="background" id="background"></a>bg<br> +background</b></p> +<p>Set image background color.</p> +<tt>Syntax:<br> +bg <color><br> + <br> +Example:<br> +$xpaget ds9 bg<br> +$xpaset -p ds9 bg red</tt><br> +<p><b><a name="backup" id="backup"></a>backup</b></p> +<p>Create a backup save set.</p> +<tt>Syntax:<br> +backup <filename><br> + <br> +Example:<br> +$xpaset -p ds9 backup ds9.bck</tt><br> +<p><b><a name="bin" id="bin"></a>bin</b></p> +<p><tt>Controls binning factor, binning buffer size, and +binning function for binning FITS bin tables. The access point +blocking is provided for backward compatibility.</tt></p> +<tt>Syntax:<br> +bin [about <x> <y>]<br> + [about center]<br> + [buffersize <value>]<br> + [cols <x> <y>]<br> + [colsz <x> <y> <z>]<br> + [factor <value> [<vector>]]<br> + [depth <value>]<br> + [filter <string>]<br> + [filter clear]<br> + [function average|sum]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 bin about<br> +$xpaget ds9 bin buffersize<br> +$xpaget ds9 bin cols<br> +$xpaget ds9 bin factor<br> +$xpaget ds9 bin depth<br> +$xpaget ds9 bin filter<br> +$xpaget ds9 bin function<br> +$xpaget ds9 bin smooth<br> +$xpaget ds9 bin smooth function<br> +$xpaget ds9 bin smooth radius<br> +$xpaget ds9 bin lock<br> +$xpaset -p ds9 bin about 4096 4096<br> +$xpaset -p ds9 bin about center<br> +$xpaset -p ds9 bin buffersize 512<br> +$xpaset -p ds9 bin cols detx dety<br> +$xpaset -p ds9 bin colsz detx dety time<br> +$xpaset -p ds9 bin factor 4<br> +$xpaset -p ds9 bin factor 4 2<br> +$xpaset -p ds9 bin depth 10<br> +$xpaset -p ds9 bin filter 'pha > 5'<br> +$xpaset -p ds9 bin filter clear<br> +$xpaset -p ds9 bin function sum<br> +$xpaset -p ds9 bin in<br> +$xpaset -p ds9 bin out<br> +$xpaset -p ds9 bin to fit<br> +$xpaset -p ds9 bin match<br> +$xpaset -p ds9 bin lock yes<br> +$xpaset -p ds9 bin open<br> +$xpaset -p ds9 bin close</tt><br> +<p><b><a name="blink" id="blink"></a>blink</b></p> +<p>Blink mode parameters. Interval is in seconds.<br></p> +<tt>Syntax:<br> +blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> +Example:<br> +$xpaget ds9 blink<br> +$xpaget ds9 blink interval<br> +$xpaset -p ds9 blink<br> +$xpaset -p ds9 blink yes<br> +$xpaset -p ds9 blink interval 1</tt><br> +<p><b><a name="block" id="block"></a>block</b></p> +<p>Controls blocking parameters.</p> +<tt>Syntax:<br> +block[<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value><value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 block<br> +$xpaget ds9 block lock<br> +$xpaset -p ds9 block 4<br> +$xpaset -p ds9 block 4 2<br> +$xpaset -p ds9 block to 4<br> +$xpaset -p ds9 block to 4 2<br> +$xpaset -p ds9 block in<br> +$xpaset -p ds9block out<br> +$xpaset -p ds9 block to fit<br> +$xpaset -p ds9 block match<br> +$xpaset -p ds9 block lock yes<br> +$xpaset -p ds9 block open<br> +$xpaset -p ds9 block close</tt><br> +<p><b><a name="catalog" id="catalog"></a>catalog<br> +cat<br></b></p> +<p>Support for catalogs. The first three commands will create a new +catalog search. All other commands operated on the last search +created, unless indicated otherwise.</p> +<tt>Syntax:<br> +catalog [new]<br> + [ned|simbad|denis|skybot]<br> + +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho]<br> + + [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1]<br> + [2mass|iras]<br> + [csc|xmm|rosat]<br> + [first|nvss]<br> + [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> + [cds <catalogname>]<br> + [cds <catalogid>]<br> +<br> + [load <filename>]<br> + [import sb|tsv <filename>]<br> +<br> + [<ref>] [<ra> <dec> +<coordsys>]<br> + [<ref>] [allcols]<br> + [<ref>] [allrows]<br> + [<ref>] [cancel]<br> + [<ref>] [clear]<br> + [<ref>] [close]<br> + [<ref>] [crosshair]<br> + [<ref>] [dec <col>]<br> + [<ref>] [edit yes|no]<br> + [<ref>] [export sb|tsv +<filename>]<br> + [<ref>] [filter <string>]<br> + [<ref>] [filter load <filename>]<br> + [<ref>] [header]<br> + [<ref>] [location <code>]<br> + [<ref>] [match]<br> + [<ref>] [match <ref> +<ref>]<br> + [<ref>] [match error <value> +degrees|arcmin|arcsec]<br> + [<ref>] [match function +1and2|1not2|2not1]<br> + [<ref>] [match return +1and2|1only|2only]<br> + [<ref>] [match unique yes|no]<br> + [<ref>] [maxrows <number>]<br> + [<ref>] [name <object>]<br> + [<ref>] [panto yes|no]<br> + [<ref>] [plot <xcol> <ycol> +<xerrcol> <yerrcol>]<br> + [<ref>] [print]<br> + [<ref>] [psky <skyframe>]<br> + [<ref>] [psystem <coordsys>]<br> + [<ref>] [ra <col>]<br> + [<ref>] [regions]<br> + [<ref>] [retrieve]<br> + [<ref>] [samp]<br> + [<ref>] [samp broadcast]<br> + [<ref>] [samp send +<application>]<br> + [<ref>] [save <filename>]<br> + [<ref>] [server +cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]<br> + [<ref>] [show yes|no]<br> + [<ref>] [radius <value> +degrees|arcmin|arcsec]<br> + [<ref>] [sky <skyframe>]<br> + [<ref>] [skyformat <skyformat>]<br> + [<ref>] [sort <col> incr|decr]<br> + [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>]<br> + [<ref>] [symbol [#] +text|size|size2|units|angle <value>]<br> + [<ref>] [symbol shape +circle|ellipse|box|text|point]<br> + [<ref>] [symbol shapecircle point|box +point|diamond point|cross point|x point|arrow point|boxcircle +point]<br> + [<ref>] [symbol add| [#] remove]<br> + [<ref>] [symbol save|load +<filename>]<br> + [<ref>] [system <coordsys>]<br> + [<ref>] [update]<br> + [<ref>] [x <col>]<br> + [<ref>] [y <col>]<br> + <br> +Example:<br> +$xpaget ds9 catalog<br> +$xpaget ds9 catalog header<br> +<br> +$xpaset -p ds9 catalog new<br> +$xpaset -p ds9 catalog 2mass<br> +$xpaset -p ds9 catalog cds 2mass<br> +$xpaset -p ds9 catalog cds {I/252}<br> +<br> +$xpaset -p ds9 catalog load foo.xml<br> +$xpaset -p ds9 catalog import tsv foo.tsv<br> +<br> +$xpaset -p ds9 catalog 202.48 47.21 fk5<br> +$xpaset -p ds9 catalog allrows<br> +$xpaset -p ds9 catalog allcols<br> +$xpaset -p ds9 catalog cancel<br> +$xpaset -p ds9 catalog clear<br> +$xpaset -p ds9 catalog close<br> +$xpaset -p ds9 catalog crosshair<br> +$xpaset -p ds9 catalog dec DEC<br> +$xpaset -p ds9 catalog edit yes<br> +$xpaset -p ds9 catalog export tsv bar.tsv<br> +$xpaset -p ds9 catalog filter '$Jmag>10'<br> +$xpaset -p ds9 catalog filter load foo.flt<br> +$xpaset -p ds9 catalog header<br> +$xpaset -p ds9 catalog location 500<br> +$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> +$xpaset -p ds9 catalog match # last two catalogs loaded<br> +$xpaset -p ds9 catalog match 2mass csc<br> +$xpaset -p ds9 catalog maxrows 2000<br> +$xpaset -p ds9 catalog name m51<br> +$xpaset -p ds9 catalog panto no<br> +$xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag'<br> +$xpaset -p ds9 catalog print<br> +$xpaset -p ds9 catalog psky fk5<br> +$xpaset -p ds9 catalog psystem wcs<br> +$xpaset -p ds9 catalog ra RA<br> +$xpaset -p ds9 catalog regions<br> +$xpaset -p ds9 catalog retrieve<br> +$xpaset -p ds9 catalog samp broadcast<br> +$xpaset -p ds9 catalog samp send aladin<br> +$xpaset -p ds9 catalog save foo.xml<br> +$xpaset -p ds9 catalog server sao<br> +$xpaset -p ds9 catalog show yes<br> +$xpaset -p ds9 catalog radius 1 degrees<br> +$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> +$xpaset -p ds9 catalog symbol fontsize 14<br> +$xpaset -p ds9 catalog symbol fontweight bold<br> +$xpaset -p ds9 catalog symbol fontslant italic<br> +$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<br> +$xpaset -p ds9 catalog sky fk5<br> +$xpaset -p ds9 catalog skyformat degrees<br> +$xpaset -p ds9 catalog sort {Jmag} incr<br> +$xpaset -p ds9 catalog system wcs<br> +$xpaset -p ds9 catalog update<br> +$xpaset -p ds9 catalog x RA<br> +$xpaset -p ds9 catalog y DEC</tt><br> +<p><b><a name="cd" id="cd"></a>cd</b></p> +<p>Sets/Returns the current working directory.</p> +<tt>Syntax:<br> +cd [<directory>]<br> + <br> +Example:<br> +$xpaget ds9 cd<br> +$xpaset -p ds9 cd /home/mrbill<br></tt> +<p><b><a name="cmap" id="cmap"></a>cmap</b></p> +<p>Controls the colormap for the current frame. The colormap name +is not case sensitive. A valid contrast value is from 0 to 10 +and bias value from 0 to 1.</p> +<tt>Syntax:<br> +cmap [<colormap>]<br> + [file]<br> + [load <filename>]<br> + [save <filename>]<br> + [invert yes|no]<br> + [<constrast> <bias>]<br> + [tag [load|save] <filename>]<br> + [tag delete]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 cmap<br> +$xpaget ds9 cmap file<br> +$xpaget ds9 cmap invert<br> +$xpaget ds9 cmap value<br> +$xpaset -p ds9 cmap Heat<br> +$xpaset -p ds9 cmap load foo.sao<br> +$xpaset -p ds9 cmap save bar.sao<br> +$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> +$xpaset -p ds9 cmap open<br> +$xpaset -p ds9 cmap close<br></tt> +<p><b><a name="colorbar" id="colorbar"></a>colorbar<br></b></p> +<p>Controls colorbar parameters.</p> +<tt>Syntax:<br> +colorbar []<br> + [yes|no]<br> + [orientation]<br> + [horizontal|vertical]<br> + [numerics yes|no]<br> + [space value|distance]<br> + [font times|helvetica|courier]<br> + [fontsize <value>]<br> + [fontweight normal|bold]<br> + [fontslant roman|italic]<br> + [size]<br> + [ticks]<br> + [match]<br> + [lock [yes|no]]<br> + </tt><br> +<tt>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> +$xpaget ds9 colorbar lock<br> +$xpaset -p ds9 colorbar yes<br> +$xpaset -p ds9 colorbar vertical<br> +$xpaset -p ds9 colorbar orientation vertical<br> +$xpaset -p ds9 colorbar numerics yes<br> +$xpaset -p ds9 colorbar space value<br> +$xpaset -p ds9 colorbar font times<br> +$xpaset -p ds9 colorbar fontsize 14<br> +$xpaset -p ds9 colorbar fontweight bold<br> +$xpaset -p ds9 colorbar fontslant italic<br> +$xpaset -p ds9 colorbar size 20<br> +$xpaset -p ds9 colorbar ticks 11<br> +$xpaset -p ds9 colorbar match<br> +$xpaset -p ds9 colorbar lock yes<br></tt> +<p><b><a name="console" id="console"></a>console</b></p> +<p>Display tcl console window.</p> +<tt>Syntax:<br> +-console<br> + <br> +Example:<br> +$xpaset -p ds9 console<br></tt> +<p><b><a name="contour" id="contour"></a>contour<br></b></p> +<p>Controls contours in the current frame.</p> +<tt>Syntax:<br> +contour []<br> + [yes|no]<br> + [<coordsys> [<skyframe>]]<br> + [clear]<br> + [generate]<br> + [load <filename>]<br> + [save <filename> [<coordsys> +<skyframe>]]<br> + [convert]<br> + [load levels <filename>]<br> + [save levels <filename>]<br> + [copy]<br> + [paste [<coordsys> <color> +<width> yes|no]]<br> + [color <color>]<br> + [width <width>]<br> + [dash yes|no]<br> + [smooth <smooth>]<br> + [method block|smooth]<br> + [nlevels <number of levels>]<br> + [scale +linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [mode minmax|<value>|zscale|zmax]<br> + [scope global|local]<br> + [limits <min> <max>]<br> + [levels <value value value...>]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 contour<br> +$xpaget ds9 contour wcs fk5<br> +$xpaget ds9 contour color<br> +$xpaget ds9 contour width<br> +$xpaget ds9 contour dash<br> +$xpaget ds9 contour smooth<br> +$xpaget ds9 contour method<br> +$xpaget ds9 contour nlevels<br> +$xpaget ds9 contour scale<br> +$xpaget ds9 contour log exp<br> +$xpaget ds9 contour mode<br> +$xpaget ds9 contour scope<br> +$xpaget ds9 contour limits<br> +$xpaget ds9 contour levels<br> +$xpaset -p ds9 contour<br> +$xpaset -p ds9 contour yes<br> +$xpaset -p ds9 contour clear<br> +$xpaset -p ds9 contour generate<br> +$xpaset -p ds9 contour load ds9.ctr<br> +$xpaset -p ds9 contour save ds9.ctr<br> +$xpaset -p ds9 contour save ds9.ctr wcs fk5<br> +$xpaset -p ds9 contour convert<br> +$xpaset -p ds9 contour load levels ds9.ctr<br> +$xpaset -p ds9 contour save levels ds9.lev<br> +$xpaset -p ds9 contour copy<br> +$xpaset -p ds9 contour paste<br> +$xpaset -p ds9 contour paste wcs red 2 no<br> +$xpaset -p ds9 contour color yellow<br> +$xpaset -p ds9 contour width 2<br> +$xpaset -p ds9 contour dash yes<br> +$xpaset -p ds9 contour smooth 5<br> +$xpaset -p ds9 contour method smooth<br> +$xpaset -p ds9 contour nlevels 10<br> +$xpaset -p ds9 contour scale sqrt<br> +$xpaset -p ds9 contour log exp 1000<br> +$xpaset -p ds9 contour mode zscale<br> +$xpaset -p ds9 contour scope local<br> +$xpaset -p ds9 contour limits 1 100<br> +$xpaset -p ds9 contour levels 1 10 100 1000<br> +$xpaset -p ds9 contour open<br> +$xpaset -p ds9 contour close</tt><br> +<p><b><a name="crop" id="crop"></a>crop</b></p> +<p>Set current image display area.</p> +<tt>Syntax:<br> +crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [reset]<br> + [3d zmin zmax <coordsys>]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 crop # get crop in physical coords<br> +$xpaget ds9 crop wcs galactic sexagesimal arcsec<br> +$xpaget ds9 crop lock<br> +$xpaset -p ds9 crop 40 30 10 20 # set crop in physical coords<br> +$xpaset -p ds9 crop +104:51:06.915 +68:33:40.761 28.144405 +22.000204 wcs galactic arcsec<br> +$xpaset -p ds9 crop match wcs<br> +$xpaset -p ds9 crop lock wcs<br> +$xpaset -p ds9 crop reset<br></tt> $xpaset -p ds9 crop 3d .25 .50 +wcs<br> +<tt>$xpaset -p ds9 crop open</tt><br> +<tt>$xpaset -p ds9 crop close</tt> +<p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> +<p>Controls the current position of the crosshair in the current +frame. DS9 is placed in crosshair mode when the crosshair is +set.</p> +<tt>Syntax:<br> +crosshair [<x> <y> <coordsys> +[<skyframe>]]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + <br> +Example:<br> +$xpaget ds9 crosshair # get crosshair in physical coords<br> +$xpaget ds9 crosshair wcs fk4 sexagesimal # get crosshair in wcs +coords<br> +$xpaget ds9 crosshair lock<br> +$xpaset -p ds9 crosshair 100 100 physical # set crosshair in +physical<br> +$xpaset -p ds9 crosshair 345 58.8 wcs fk5 # set crosshair in wcs +coords<br> +$xpaset -p ds9 crosshair 23:01:00 +58:52:51 wcs fk5<br> +$xpaset -p ds9 crosshair match wcs<br> +$xpaset -p ds9 crosshair lock wcs<br></tt> +<p><b><a name="cube" id="cube"></a>cube<br></b></p> +<p>Controls FITS cube dialog.</p> +<tt>Syntax:<br> +cube []<br> + [play|stop|next|prev|first|last]<br> + [<slice> [<coordsys>]]<br> + [interval <numeric>]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 cube<br> +$xpaget ds9 cube wcs<br> +$xpaget ds9 cube interval<br> +$xpaget ds9 cube lock<br> +$xpaget ds9 cube order<br> +$xpaget ds9 cube axes lock<br> +$xpaset -p ds9 cube<br> +$xpaset -p ds9 cube play<br> +$xpaset -p ds9 cube last<br> +$xpaset -p ds9 cube 3<br> +$xpaset -p ds9 cube 4.4 wcs<br> +$xpaset -p ds9 cube interval 2<br> +$xpaset -p ds9 cube match wcs<br> +$xpaset -p ds9 cube lock wcs<br> +$xpaset -p ds9 cube order 123<br> +$xpaset -p ds9 cube axes lock yes<br> +$xpaset -p ds9 cube open<br> +$xpaset -p ds9 cube close</tt><br> +<p><b><a name="cursor" id="cursor"></a>cursor</b></p> +<p>Move mouse pointer or crosshair in image pixels in the current +frame. Note, this will move selected Regions also.</p> +<tt>Syntax:<br> +cursor [<x> <y>]<br> + <br> +Example:<br> +$xpaset -p ds9 cursor 10 10<br></tt> +<p><b><a name="data" id="data"></a>data</b></p> +<p>Return an array of data values given a lower left corner and a +width and height in specified coordinate system. The last argument +of yes indicates to strip the coordinates from the output and just +list the data values. The default is yes.</p> +<tt>Syntax:<br> +data [<coordsys> [<skyframe>] <x> <y> +<width> <height> [yes|no]]<br> + <br> +Example:<br> +$xpaget ds9 data image 450 520 3 3 yes<br> +$xpaget ds9 data physical 899 1039 6 6 no<br> +$xpaget ds9 data fk5 202.47091 47.196811 0.00016516669 +0.00016516669 no<br> +$xpaget ds9 data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 +0.00016516669 no<br></tt> +<p><b><a name="dsssao" id="dsssao"></a>dsssao<br> +dss<br></b></p> +<p>Support for Digital Sky Survey at SAO.</p> +<tt>Syntax:<br> +dsssao []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 dsssao name<br> +$xpaget ds9 dsssao coord<br> +$xpaget ds9 dsssao size<br> +$xpaget ds9 dsssao save<br> +$xpaget ds9 dsssao frame<br> +$xpaset -p ds9 dsssao<br> +$xpaset -p ds9 dsssao m31<br> +$xpaset -p ds9 dsssao name m31<br> +$xpaset -p ds9 dsssao name clear<br> +$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> +$xpaset -p ds9 dsssao close</tt><br> +<p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> +<p>Support for Digital Sky Survey at ESO.</p> +<tt>Syntax:<br> +dsseso []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey +DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 dsseso name<br> +$xpaget ds9 dsseso coord<br> +$xpaget ds9 dsseso size<br> +$xpaget ds9 dsseso save<br> +$xpaget ds9 dsseso frame<br> +$xpaget ds9 dsseso survey<br> +$xpaset -p ds9 dsseso<br> +$xpaset -p ds9 dsseso m31<br> +$xpaset -p ds9 dsseso name m31<br> +$xpaset -p ds9 dsseso name clear<br> +$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> +$xpaset -p ds9 dsseso close</tt><br> +<p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> +<p>Support for Digital Sky Survey at STSCI.</p> +<tt>Syntax:<br> +dssstsci []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey +poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> + [survey poss1_blue|poss1_red]<br> + [survey all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 dssstsci name<br> +$xpaget ds9 dssstsci coord<br> +$xpaget ds9 dssstsci size<br> +$xpaget ds9 dssstsci save<br> +$xpaget ds9 dssstsci frame<br> +$xpaget ds9 dssstsci survey<br> +$xpaset -p ds9 dssstsci<br> +$xpaset -p ds9 dssstsci m31<br> +$xpaset -p ds9 dssstsci name m31<br> +$xpaset -p ds9 dssstsci name clear<br> +$xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78<br> +$xpaset -p ds9 dssstsci size 60 60 arcmin<br> +$xpaset -p ds9 dssstsci save yes<br> +$xpaset -p ds9 dssstsci frame current<br> +$xpaset -p ds9 dssstsci update frame<br> +$xpaset -p ds9 dssstsci survey all<br> +$xpaset -p ds9 dssstsci open<br> +$xpaset -p ds9 dssstsci close</tt><br> +<p><b><a name="envi" id="envi"></a>envi</b></p> +<p>Load an ENVI header and file. Optional parameter: array +endian.<br></p> +<tt>Syntax:<br> +envi [new] <header> [<filename>]<br> + <br> +Example:<br> +$xpaset -p ds9 envi foo.hdr<br> +$xpaset -p ds9 envi new foo.hdr</tt><br> +$xpaset -p ds9 envi foo.hdr foo.bsq<br> +<br> +<b><a name="exit" id="exit"></a>exit</b><br> +<p><b>quits<br></b></p> +<p>Quits DS9.</p> +<tt>Syntax:<br> +exit<br> +quit<br> + <br> +Example:<br> +$xpaset -p ds9 exit<br></tt> +<p><b><a name="export" id="export"></a>export<br></b></p> +<p>Export loaded image data of current frame in specified image +format. Optional parameters: array endian, nrrd endian, jpeg +quality (1-100) and tiff compression method.</p> +<tt>Syntax:<br> +export[array|nrrd|envi|gif|tiff|jpeg|png]<filename><br> +export array <filename>[big|little|native]<br> +export nrrd <filename>[big|little|native]<br> +export envi <header> +[<filename>][big|little|native]<br> +export jpeg <filename>[1-100]<br> +export tiff <filename>[none|jpeg|packbits|deflate]<br> + <br> +Example:<br> +$xpaset -p ds9 export array foo.arr little<br> +$xpaset -p ds9 export nrrd foo.nrrd little<br> +$xpaset -p ds9 export envi foo.hdr little<br> +$xpaset -p ds9 export envi foo.hdr foo.bsq little<br> +$xpaset -p ds9 export tiff foo.tiff jpeg<br> +$xpaset -p ds9 export jpeg foo.jpeg 75<br> +$xpaset -p ds9 export png foo.png</tt><br> +<p><b><a name="file" id="file"></a>file</b></p> +<p>Query currently loaded file information.</p> +<tt>Syntax:<br> +file<br> + <br> +Example:<br> +$xpaget ds9 file</tt><br> +<p><b><a name="fits" id="fits"></a>fits</b></p> +<p>Load a FITS image into the current frame or query the currently +loaded image.<br></p> +<tt>Syntax:<br> +fits[new|mask|slice] [<filename>]<br> + [width|height|depth|bitpix]<br> + [size [wcs|wcsa...wcsz] +[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword +<string>]]<br> + [image|table|slice]<br> + <br> +Example:<br> +$xpaget ds9 fits > foo.fits<br> +$xpaget ds9 fits width<br> +$xpaget ds9 fits height<br> +$xpaget ds9 fits depth<br> +$xpaget ds9 fits bitpix<br> +$xpaget ds9 fits size<br> +$xpaget ds9 fits size wcs fk5 arcmin<br> +$xpaget ds9 fits header # primary<br> +$xpaget ds9 fits header 2 # hdu 2<br> +$xpaget ds9 fits header -2 # hdu 2 with inherit<br> +$xpaget ds9 fits header keyword BITPIX<br> +$xpaget ds9 fits header 1 keyword BITPIX<br> +$xpaget ds9 fits image > foo.fits<br> +$xpaget ds9 fits table > bar.fits<br> +$xpaget ds9 fits slice > foo.fits<br> +$xpaset -p ds9 fits foo.fits<br> +$xpaset -p ds9 fits new foo.fits<br> +$xpaset -p ds9 fits bar.fits[bin=detx,dety]<br> +$xpaset -p ds9 fits slice foo.fits<br> +$xpaset -p ds9 fits mask foo.fits<br> +$cat foo.fits | xpaset ds9 fits<br> +$cat foo.fits | xpaset ds9 fits new<br> +$cat bar.fits | xpaset ds9 fits -[bin=detx,dety]<br> +$cat foo.fits | xpaset ds9 fits slice<br> +$cat foo.fits | xpaset ds9 fits mask<br></tt> +<p><b><a name="frame" id="frame"></a>frame</b></p> +<p>Controls frame functions. Frames may be created, deleted, reset, +and centered. While return the current frame number. If you goto a +frame that does not exists, it will be created. If the frame is +hidden, it will be shown. The 'frameno' option is available for +backward compatibility.</p> +<tt>Syntax:<br> +frame [center [#|all]]<br> + [clear [#|all]]<br> + [new [rgb|3d]]<br> + [delete [#|all]]<br> + [reset [#|all]]<br> + [refresh [#|all]]<br> + [hide [#|all]]<br> + [show [#|all]]<br> + [move first]<br> + [move back]<br> + [move forward]<br> + [move last]<br> + [first]<br> + [prev]<br> + [next]<br> + [last]<br> + [frameno #]<br> + [#]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]<br> - [has contour [aux]]]<br> - [has fits [bin|cube|mosaic]]<br> - [has marker - [highlite|paste|select|undo]]<br> - [has system <coordsys>]<br> - </tt> <tt><tt><tt> [has wcs - [<wcssys>]]<br> - </tt> [has wcs celestial - [<wcssys>]]<br> - </tt> [has wcs linear - [<wcssys>]]<br> - <br> - Example:<br> - $xpaget ds9 frame # returns the id of the current frame<br> - $xpaget ds9 frame frameno # returns the id of the current frame<br> - $xpaget ds9 frame all # returns the id of all frames<br> - $xpaget ds9 frame active # returns the id of all active frames<br> - </tt> <tt>$xpaget ds9 frame lock</tt><br> - <tt>$xpaget ds9 frame has amplifier<br> - $xpaget ds9 frame has datamin<br> - $xpaget ds9 frame has datasec<br> - $xpaget ds9 frame has detector<br> - $xpaget ds9 frame has grid<br> - $xpaget ds9 frame has iis<br> - $xpaget ds9 frame has irafmin<br> - $xpaget ds9 frame has physical<br> - $xpaget ds9 frame has smooth<br> - $xpaget ds9 frame has contour<br> - $xpaget ds9 frame has contour aux<br> - $xpaget ds9 frame has fits<br> - $xpaget ds9 frame has fits bin<br> - $xpaget ds9 frame has fits cube<br> - $xpaget ds9 frame has fits mosaic<br> - $xpaget ds9 frame has marker highlite<br> - $xpaget ds9 frame has marker paste<br> - $xpaget ds9 frame has marker select<br> - $xpaget ds9 frame has marker undo<br> - $xpaget ds9 frame has system physical<br> - $xpaget ds9 frame has wcs wcsa<br> - $xpaget ds9 frame has wcs celestial wcsa<br> - $xpaget ds9 frame has wcs linear wcsa<br> - $xpaset -p ds9 frame center # center current frame<br> - $xpaset -p ds9 frame center 1 # center 'Frame1'<br> - $xpaset -p ds9 frame center all # center all frames<br> - $xpaset -p ds9 frame clear # clear current frame<br> - $xpaset -p ds9 frame new # create new frame<br> - $xpaset -p ds9 frame new rgb # create new rgb frame<br> - $xpaset -p ds9 frame delete # delete current frame<br> - $xpaset -p ds9 frame reset # reset current frame<br> - $xpaset -p ds9 frame refresh # refresh current frame<br> - $xpaset -p ds9 frame hide # hide current frame<br> - $xpaset -p ds9 frame show 1 # show frame 'Frame1'<br> - $xpaset -p ds9 frame move first # move frame to first in order<br> - $xpaset -p ds9 frame move back # move frame back in order<br> - $xpaset -p ds9 frame move forward # move frame forward in order<br> - $xpaset -p ds9 frame move last # move frame to last in order<br> - $xpaset -p ds9 frame first # goto first frame<br> - $xpaset -p ds9 frame prev # goto prev frame<br> - $xpaset -p ds9 frame next # goto next frame<br> - $xpaset -p ds9 frame last # goto last frame<br> - $xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if - needed<br> - $xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed<br> - $xpaset -p ds9 frame match wcs<br> - $xpaset -p ds9 frame lock wcs</tt><br> - <p><b><a name="gif" id="gif"></a>gif</b></p> - <p>Load GIF image into current frame.<br> - </p> - <tt>Syntax:<br> - gif [new|slice] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 gif > foo.gif</tt><br> - <tt>$xpaset -p ds9 gif foo.gif</tt><br> - <tt><tt>$xpaset -p ds9 gif new foo.gif<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 gif slice foo.gif<br> - </tt></tt> $cat foo.gif | xpaset ds9 gif # not available - windows</tt><br> - <tt><tt>$cat foo.gif | xpaset ds9 gif</tt> <tt>new # not - available windows<br> - </tt> $cat foo.gif | xpaset ds9 gif</tt> <tt>slice</tt> <tt><tt><tt># - not available windows</tt></tt></tt> - <p><b><a name="grid" id="grid"></a>grid</b></p> - <p>Controls coordinate grid. For grid numeric format syntax, - click <a href="grid.html#Format">here</a>.</p> - <tt>Syntax:<br> - grid []<br> - [yes|no]<br> - [type analysis|publication]<br> - [system <coordsys>]<br> - [sky <skyframe>]<br> - [skyformat <skyformat>]<br> - [grid yes|no]<br> - [grid color <color>]<br> - [grid width <value>]<br> - [grid dash yes|no]<br> - [grid gap1 <value>]<br> - </tt> <tt><tt> [grid gap2 - <value>]<br> - </tt></tt> <tt><tt><tt> [grid - gap3 <value>]<br> - </tt></tt> [axes yes|no]<br> - [axes color <color>]<br> - [axes width <value>]<br> - [axes dash yes|no]<br> - [axes type interior|exterior]<br> - [axes origin - lll|llu|lul|luu|ull|ulu|uul|uuu]<br> - [format1 <format>]<br> - [format2 <format>]<br> - [tickmarks yes|no]<br> - [tickmarks color <color>]<br> - [tickmarks width <value>]<br> - [tickmarks dash yes|no]<br> - [border yes|no]<br> - [border color <color>]<br> - [border width <value>]<br> - [border dash yes|no]<br> - [numerics yes|no]<br> - [numerics font - times|helvetica|courier]<br> - [numerics fontsize <value>]<br> - [numerics fontweight normal|bold]<br> - [numerics fontslant roman|italic]<br> - [numerics color <color>]<br> - [numerics gap1 <value>]<br> - </tt> <tt><tt> [numerics gap2 - <value>]<br> - </tt></tt> <tt><tt><tt> [numerics - gap3 <value>]<br> - </tt></tt> [numerics type - interior|exterior]<br> - [numerics vertical yes|no]<br> - [title yes|no]<br> - [title text <text>]<br> - [title def yes|no]<br> - [title gap <value>]<br> - [title font - times|helvetica|courier]<br> - [title fontsize <value>]<br> - [title fontweight normal|bold]<br> - [title fontslant roman|italic]<br> - [title color <color>]<br> - [labels yes|no]<br> - </tt> <tt><tt> [labels def1 yes|no]<br> - [labels def2 yes|no]<br> - </tt> [labels text1 <text>]<br> - </tt> <tt><tt> [labels text2 - <text>]<br> - </tt></tt> <tt><tt> [labels gap1 - <value>]<br> - </tt> [labels gap2 <value>]<br> - </tt> <tt> [labels font - times|helvetica|courier]<br> - [labels fontsize <value>]<br> - [labels fontweight normal|bold]<br> - [labels fontslant roman|italic]<br> - [labels color <color>]<br> - [reset]<br> - [load <filename>]<br> - [save <filename>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 grid<br> - $xpaget ds9 grid type<br> - $xpaget ds9 grid system<br> - $xpaget ds9 grid sky<br> - $xpaget ds9 grid skyformat<br> - $xpaget ds9 grid grid<br> - $xpaget ds9 grid grid color<br> - $xpaget ds9 grid grid width<br> - $xpaget ds9 grid grid dash<br> - $xpaget ds9 grid grid gap1<br> - </tt> <tt><tt>$xpaget ds9 grid grid gap2<br> - </tt></tt> <tt><tt><tt>$xpaget ds9 grid grid gap3<br> - </tt></tt> $xpaget ds9 grid axes<br> - $xpaget ds9 grid axes color<br> - $xpaget ds9 grid axes width<br> - $xpaget ds9 grid axes dash<br> - $xpaget ds9 grid axes type<br> - $xpaget ds9 grid axes origin<br> - $xpaget ds9 grid format1<br> - $xpaget ds9 grid format2<br> - $xpaget ds9 grid tickmarks<br> - $xpaget ds9 grid tickmarks color<br> - $xpaget ds9 grid tickmarks width<br> - $xpaget ds9 grid tickmarks dash<br> - $xpaget ds9 grid border<br> - $xpaget ds9 grid border color<br> - $xpaget ds9 grid border width<br> - $xpaget ds9 grid border dash<br> - $xpaget ds9 grid numerics<br> - $xpaget ds9 grid numerics font<br> - $xpaget ds9 grid numerics fontsize<br> - $xpaget ds9 grid numerics fontweight<br> - $xpaget ds9 grid numerics fontslant<br> - $xpaget ds9 grid numerics color<br> - $xpaget ds9 grid numerics gap1<br> - </tt> <tt><tt>$xpaget ds9 grid numerics gap2<br> - </tt></tt> <tt><tt><tt>$xpaget ds9 grid numerics gap3<br> - </tt></tt> $xpaget ds9 grid numerics type<br> - $xpaget ds9 grid numerics vertical<br> - $xpaget ds9 grid title<br> - $xpaget ds9 grid title text<br> - $xpaget ds9 grid title def<br> - $xpaget ds9 grid title gap<br> - $xpaget ds9 grid title font<br> - $xpaget ds9 grid title fontsize<br> - $xpaget ds9 grid title fontweight<br> - $xpaget ds9 grid title fontslant<br> - $xpaget ds9 grid title color<br> - $xpaget ds9 grid labels<br> - $xpaget ds9 grid labels text1<br> - $xpaget ds9 grid labels def1<br> - $xpaget ds9 grid labels gap1<br> - $xpaget ds9 grid labels text2<br> - $xpaget ds9 grid labels def2<br> - $xpaget ds9 grid labels gap2<br> - $xpaget ds9 grid labels font<br> - $xpaget ds9 grid labels fontsize<br> - $xpaget ds9 grid labels fontweight<br> - $xpaget ds9 grid labels fontslant<br> - $xpaget ds9 grid labels color<br> - $xpaset -p ds9 grid<br> - $xpaset -p ds9 grid yes<br> - $xpaset -p ds9 grid type analysis<br> - $xpaset -p ds9 grid system wcs<br> - $xpaset -p ds9 grid sky fk5<br> - $xpaset -p ds9 grid skyformat degrees<br> - $xpaset -p ds9 grid grid yes<br> - $xpaset -p ds9 grid grid color red<br> - $xpaset -p ds9 grid grid width 2<br> - $xpaset -p ds9 grid grid dash yes<br> - $xpaset -p ds9 grid grid gap1 10<br> - $xpaset -p ds9 grid grid gap2 10<br> - </tt> <tt><tt>$xpaset -p ds9 grid grid gap3 10<br> - </tt> $xpaset -p ds9 grid axes yes<br> - $xpaset -p ds9 grid axes color red<br> - $xpaset -p ds9 grid axes width 2<br> - $xpaset -p ds9 grid axes dash yes<br> - $xpaset -p ds9 grid axes type exterior<br> - $xpaset -p ds9 grid axes origin lll<br> - $xpaset -p ds9 grid format1 d.2<br> - $xpaset -p ds9 grid format2 d.2<br> - $xpaset -p ds9 grid tickmarks yes<br> - $xpaset -p ds9 grid tickmarks color red<br> - $xpaset -p ds9 grid tickmarks width 2<br> - $xpaset -p ds9 grid tickmarks dash yes<br> - $xpaset -p ds9 grid border yes<br> - $xpaset -p ds9 grid border color red<br> - $xpaset -p ds9 grid border width 2<br> - $xpaset -p ds9 grid border dash yes<br> - $xpaset -p ds9 grid numerics yes<br> - $xpaset -p ds9 grid numerics font courier<br> - $xpaset -p ds9 grid numerics fontsize 12<br> - $xpaset -p ds9 grid numerics fontweight bold<br> - $xpaset -p ds9 grid numerics fontslant italic<br> - $xpaset -p ds9 grid numerics color red<br> - $xpaset -p ds9 grid numerics gap1 10<br> - </tt> <tt><tt>$xpaset -p ds9 grid numerics gap2 10<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 grid numerics gap3 10<br> - </tt></tt> $xpaset -p ds9 grid numerics type exterior<br> - $xpaset -p ds9 grid numerics vertical yes<br> - $xpaset -p ds9 grid title yes<br> - $xpaset -p ds9 grid title text {Hello World}<br> - $xpaset -p ds9 grid title def yes<br> - $xpaset -p ds9 grid title gap 10<br> - $xpaset -p ds9 grid title font courier<br> - $xpaset -p ds9 grid title fontsize 12<br> - $xpaset -p ds9 grid title fontweight bold<br> - $xpaset -p ds9 grid title fontslant italic<br> - $xpaset -p ds9 grid title color red<br> - $xpaset -p ds9 grid labels yes<br> - $xpaset -p ds9 grid labels text1 {Hello World}<br> - $xpaset -p ds9 grid labels def1 yes<br> - $xpaset -p ds9 grid labels gap1 10<br> - $xpaset -p ds9 grid labels text2 {Hello World}<br> - $xpaset -p ds9 grid labels def2 yes<br> - $xpaset -p ds9 grid labels gap2 10<br> - $xpaset -p ds9 grid labels font courier<br> - $xpaset -p ds9 grid labels fontsize 12<br> - $xpaset -p ds9 grid labels fontweight boldj<br> - $xpaset -p ds9 grid labels fontslant italic<br> - $xpaset -p ds9 grid labels color red<br> - $xpaset -p ds9 grid reset<br> - $xpaset -p ds9 grid load foo.grd<br> - $xpaset -p ds9 grid save foo.grd<br> - $xpaset -p ds9 grid open<br> - $xpaset -p ds9 grid close<br> - </tt> - <p><b><a name="header" id="header"></a>header</b></p> - <p>Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from xpa fits header.</p> - <tt>Syntax:<br> - header [<ext>]<br> - [close [<ext>]]<br> - [save [<ext>] - <filename>]<br> - <br> - Example:<br> - $xpaset -p ds9 header<br> - $xpaset -p ds9 header 2<br> - $xpaset -p ds9 header close<br> - $xpaset -p ds9 header save 1 foo.txt<br> - </tt> - <p><b><a name="height" id="height"></a>height</b></p> - <p>Set the height of the image display window.</p> - <tt>Syntax:<br> - height [<value>]<br> - <br> - Example:<br> - $xpaget ds9 height<br> - $xpaset -p ds9 height 512<br> - </tt> - <p><b><a name="iconify" id="iconify"></a>iconify</b></p> - <p>Toggles iconification.</p> - <tt>Syntax:<br> - iconify []<br> - [yes|no]<br> - <br> - Example:<br> - $xpaget ds9 iconify<br> - $xpaset -p ds9 iconify</tt><br> - <tt>$xpaset -p ds9 iconify yes</tt><br> - <p><b><a name="iexam" id="iexam"></a>iexam</b></p> - <p>Interactive examine function. A blinking cursor will indicate - to the user to click on a point on an image. The specified - information will be returned at that time. The default event is - <tt>button</tt>. In the last form, the following macros will be - expanded if present: <tt>$width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z.</tt> See <a href="analysis.html#macros">Analysis - Macros</a> for more information.<br> - </p> - <tt>Syntax:<br> - iexam []<br> - [[]|button|key|any] coordinate - <coordsys> [<skyframe>] [<skyformat>]<br> - [[]|button|key|any] data - [width][height]<br> - </tt> <tt><tt> [[]|button|key|any] - <macro string>]<br> - </tt><br> - Example:<br> - $xpaget ds9 iexam # image coordinates<br> - </tt> <tt><tt>$xpaget ds9 iexam coordinate image<br> - </tt> $xpaget ds9 iexam key coordinate image # return coordinate - and key event<br> - $xpaget ds9 iexam coordinate wcs fk5 degrees<br> - $xpaget ds9 iexam coordinate wcs galactic sexagesimal<br> - $xpaget ds9 iexam coordinate fk5<br> - $xpaget ds9 iexam data # return data value<br> - $xpaget ds9 iexam key data # return data value and key event<br> - $xpaget ds9 iexam data 3 3 # return all data in 3x3 box about - selected point<br> - $xpaget ds9 iexam {'Click at $x,$y in file $filename'}</tt><br> - <p><b><a name="iis" id="iis"></a>iis</b></p> - <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> - <tt>Syntax:<br> - iis [filename <filename> [#]]<br> - <br> - Example:<br> - $xpaget ds9 iis filename<br> - $xpaget ds9 iis filename 4<br> - $xpaset -p ds9 iis filename foo.fits<br> - $xpaset -p ds9 iis filename bar.fits 4</tt><br> - <p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> - <p>Load JPEG image into current frame. Optional parameters: <tt>jpeg</tt> - quality (1-100)</p> - <tt>Syntax:<br> - jpeg [new|slice] [<filename>] [1-100]<br> - <br> - Example:<br> - $xpaget ds9 jpeg > foo.jpeg</tt><br> - <tt><tt>$xpaget ds9 jpeg 100 > foo.jpeg</tt><br> - $xpaset -p ds9 jpeg foo.jpeg</tt><br> - <tt><tt>$xpaset -p ds9 jpeg new foo.jpeg<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 jpeg slice foo.jpeg<br> - </tt></tt> $cat foo.jpeg | xpaset ds9 jpeg</tt> <tt><tt><tt># - not available windows</tt></tt></tt><br> - <tt><tt>$cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>new</tt></tt> <tt><tt><tt><tt># - not available windows</tt></tt><br> - </tt> $cat foo.jpeg | xpaset ds9 jpeg</tt> <tt>slice</tt> <tt><tt><tt># - not available windows</tt></tt></tt> - <p><b><a name="lock" id="lock"></a>lock</b></p> - <p>Lock all other frames to the current frame.</p> - <tt>Syntax:<br> - lock</tt> <tt>[frame <coordsys>|none]<br> - </tt> <tt>[crosshair - <coordsys>|none]</tt> <tt><br> - </tt> <tt> [crop <coordsys>|none]</tt><br> - <tt> [slice <coordsys>|none]]<br> - </tt> <tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimites [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br> - </tt> <tt> [smooth [yes|no]]</tt><br> - <tt> [3d [yes|no]]</tt><br> - <tt><tt> </tt><br> - Example:<br> - $xpaget -p ds9 lock frame<br> - $xpaget -p ds9 lock crosshair<br> - </tt> <tt>$xpaget -p ds9 lock crop</tt><br> - <tt>$xpaget -p ds9 lock slice</tt><br> - <tt>$xpaget -p ds9 lock bin<br> - $xpaget -p ds9 lock axes<br> - $xpaget -p ds9 lock scale<br> - $xpaget -p ds9 lock scalelimits<br> - $xpaget -p ds9 lock colorbar<br> - $xpaget -p ds9 lock block<br> - </tt> <tt><tt>$xpaget -p ds9 lock smooth<br> - </tt></tt> <tt><tt><tt>$xpaget -p ds9 lock 3d<br> - </tt></tt> $xpaset -p ds9 lock frame wcs</tt><tt><br> - </tt> <tt>$xpaset -p ds9 lock crosshair wcs<br> - </tt> <tt>$xpaset -p ds9 lock crop wcs</tt><br> - <tt>$xpaset -p ds9 lock slice wcs</tt><br> - <tt>$xpaset -p ds9 lock bin yes<br> - $xpaset -p ds9 lock axes yes<br> - </tt> <tt>$xpaset -p ds9 lock scale yes<br> - $xpaset -p ds9 lock scalelimits yes<br> - </tt> <tt>$xpaset -p ds9 lock colorbar yes<br> - $xpaset -p ds9 lock block yes</tt><br> - <tt>$xpaset -p ds9 lock smooth yes</tt><br> - <tt>$xpaset -p ds9 lock 3d yes<br> - <br> - </tt> <b><a name="lower" id="lower"></a>lower</b> - <p>Lower in the window stacking order.</p> - <tt>Syntax:<br> - lower<br> - <br> - Example:<br> - $xpaset -p ds9 lower</tt><tt><br> - </tt> - <p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> - <p>Controls the magnifier settings.</p> - <tt>Syntax:<br> - magnifier [color <color>]<br> - [zoom - <value>]<br> - [cursor - yes|no]<br> - [region - yes|no]<br> - <br> - Example:<br> - $xpaget ds9 magnifier color<br> - $xpaget ds9 magnifier zoom<br> - $xpaget ds9 magnifier cursor<br> - $xpaget ds9 magnifier region<br> - $xpaset -p ds9 magnifier color yellow<br> - $xpaset -p ds9 magnifier zoom 2<br> - $xpaset -p ds9 magnifier cursor no<br> - $xpaset -p ds9 magnifier region no</tt><br> - <p><b><a name="mask" id="mask"></a>mask<br> - </b></p> - <p>Controls mask parameters.</p> - <tt>Syntax:<br> - mask [color <color>]<br> - [mark zero|nonzero|nan|nonnan|range]<br> - [range <low> <high>]<br> - [transparency <value>]<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 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> - </tt> - <p><b><a name="match" id="match"></a>match</b></p> - <p>Match all other frames to the current frame.</p> - <tt>Syntax:<br> - </tt> <tt>match</tt> <tt>[frame <coordsys>]<br> - </tt> <tt>[crosshair - <coordsys>]</tt> <tt><br> - </tt> <tt> [crop <coordsys>]</tt><br> - <tt> [slice <coordsys>]</tt><br> - <tt> [bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]<br> - [3d]<br> - </tt> <tt><tt><br> - </tt> Example:<br> - $xpaset -p ds9 match frame wcs<br> - </tt> <tt>$xpaset -p ds9 match crosshair wcs<br> - </tt> <tt>$xpaset -p ds9 match crop wcs</tt><br> - <tt>$xpaset -p ds9 match slice</tt> <tt>wcs<br> - </tt> <tt>$xpaset -p ds9 match bin<br> - $xpaset -p ds9 match axes<br> - $xpaset -p ds9 match scale<br> - $xpaset -p ds9 match scalelimits<br> - $xpaset -p ds9 match colorbar<br> - $xpaset -p ds9 match block<br> - $xpaset -p ds9 match smooth<br> - $xpaset -p ds9 match 3d<br> - <br> - </tt> <b><a name="mecube" id="mecube"></a>mecube</b> - <p>Load FITS multiple extension file as data cube.<br> - </p> - <tt>Syntax:<br> - mecube [new] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 mecube > foo.fits<br> - $xpaset -p ds9 mecube foo.fits</tt><br> - <tt><tt>$xpaset -p ds9 mecube new foo.fits<br> - </tt> $cat foo.fits | xpaset ds9 mecube</tt><br> - <tt>$cat foo.fits | xpaset ds9 mecube</tt> <tt>new</tt> - <p><b><a name="minmax" id="minmax"></a>minmax</b></p> - <p>This is how DS9 determines the min and max data values - from the data. <tt>SCAN</tt> will scan all data. <tt>DATAMIN</tt> - and <tt>IRAFMIN</tt> will use the values of the keywords if - present.<br> - </p> - <tt>Syntax:<br> - minmax [scan|sample|datamin|irafmin]<br> - [mode - scan|sample|datamin|irafmin]<br> - [interval #]<br> - <br> - Example:<br> - $xpaget ds9 minmax mode<br> - $xpaget ds9 minmax interval<br> - $xpaset -p ds9 minmax scan<br> - $xpaset -p ds9 minmax mode scan<br> - $xpaset -p ds9 minmax interval 100<br> - </tt> - <p><b><a name="mode" id="mode"></a>mode</b></p> - <p>Controls the first mouse button mode.</p> - <tt>Syntax:<br> - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d]<br> - <br> - Example:<br> - $xpaget ds9 mode<br> - $xpaset -p ds9 mode crosshair</tt><br> - <p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> - <p>Load FITS mosaic segment into current frame.</p> - <tt>Syntax:</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> - <tt>Syntax:<br> - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 mosaicimage > foo.fits</tt><tt><br> - $xpaset -p ds9 mosaicimage foo.fits</tt><br> - <tt><tt>$xpaset -p ds9 mosaicimage wcs foo.fits</tt></tt><br> - <tt><tt>$xpaset -p ds9 mosaicimage wcs new foo.fits</tt></tt><br> - <tt><tt>$xpaset -p ds9 mosaicimage wcs mask foo.fits</tt></tt><tt><tt><tt><br> - </tt></tt> $cat foo.fits | xpaset ds9 mosaicimage</tt><br> - <tt><tt>$cat foo.fits | xpaset ds9 mosaicimage wcs<br> - $cat foo.fits | xpaset ds9 mosaicimage wcs new</tt><tt><br> - </tt> $cat foo.fits | xpaset ds9 mosaicimage wcs mask</tt><br> - <p><b><a name="movie" id="movie"></a>movie<br> - </b></p> - <p>Create a movie from snap shots of the DS9 window. A <tt>slice</tt> - movie cycles though all slices of a cube. A <tt>frame</tt> - movie cycles through all active frames. A <tt>3d</tt> movie - cycles through specified viewing angles. The default action is <tt>slice</tt>. - Movie types are either <tt>MPEG</tt> or <tt>Animated GIF</tt>, - with default <tt>MPEG</tt>. Optional parameters for <tt>3d</tt>: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.</p> - <tt>Syntax:<br> - movie</tt> <tt>[slice|frame|3d]</tt> <tt>[mpeg|gif] - <filename><br> - </tt> <tt>movie 3d [mpeg|gif] <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>]</tt><br> - <tt> <br> - Example:<br> - </tt><tt><tt>$xpaset -p ds9 movie slice mpeg ds9.mpg<br> - </tt> $xpaset -p ds9 movie frame gif ds9.gif<br> - </tt><tt>$xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 - azto 60 oscillate 1</tt><br> - <p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> - <p>Load FITS multiple extension file as multiple images.<br> - </p> - <tt>Syntax:<br> - multiframe [<filename>]<br> - <br> - Example:<br> - $xpaset -p ds9 multiframe foo.fits</tt><tt><tt><br> - </tt> $cat foo.fits | xpaset ds9 multiframe</tt> <tt><tt><tt># - not available windows</tt></tt></tt><br> - <p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> - <p>Support Name Server functions. Coordinates are in fk5.</p> - <tt>Syntax:<br> - nameserver [<object>]<br> - - [name <object>]<br> - - [server</tt> <tt><tt>ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt></tt>]<br> - - [skyformat degrees|sexagesimal]<br> - - [pan]<br> - - [crosshair]<br> - - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 nameserver<br> - $xpaget ds9 nameserver server<br> - $xpaget ds9 nameserver skyformat<br> - $xpaget ds9 nameserver m31<br> - $xpaset -p ds9 nameserver m31<br> - $xpaset -p ds9 nameserver name m31<br> - $xpaset -p ds9 nameserver server ned-sao<br> - $xpaset -p ds9 nameserver skyformat sexagesimal<br> - $xpaset -p ds9 nameserver pan<br> - $xpaset -p ds9 nameserver crosshair<br> - $xpaset -p ds9 nameserver open<br> - $xpaset -p ds9 nameserver close<br> - </tt> - <p><b><a name="nan" id="nan"></a>nan</b></p> - <p>Set image not-a-number color.</p> - <tt>Syntax:<br> - nan <color><br> - <br> - Example:<br> - $xpaget ds9 nan<br> - $xpaset -p ds9 nan red</tt><tt><br> - </tt> - <p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> - <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian.<br> - </p> - <tt>Syntax:</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> - nvss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> - degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 nvss name<br> - $xpaget ds9 nvss coord<br> - $xpaget ds9 nvss size<br> - $xpaget ds9 nvss save<br> - $xpaget ds9 nvss frame<br> - $xpaset -p ds9 nvss<br> - $xpaset -p ds9 nvss m31<br> - </tt> <tt><tt>$xpaset -p ds9 nvss name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 nvss name clear<br> - </tt></tt> $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 nvss size 60 60 arcmin<br> - $xpaset -p ds9 nvss save yes<br> - $xpaset -p ds9 nvss frame current<br> - $xpaset -p ds9 nvss update frame<br> - $xpaset -p ds9 nvss open<br> - </tt> <tt>$xpaset -p ds9 nvss close</tt><br> - <p><b><a name="orient" id="orient"></a>orient</b></p> - <p>Controls the orientation of the current frame.</p> - <tt>Syntax:<br> - orient [none|x|y|xy]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 orient<br> - $xpaset -p ds9 orient xy<br> - $xpaset -p ds9 orient open<br> - $xpaset -p ds9 orient close<br> - </tt> - <p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> - <p>Controls Page Setup options.<br> - </p> - <tt>Syntax:<br> - pagesetup [orient portrait|landscape]<br> - [scale - <numberic>]</tt><br> - <tt> [size - letter|legal|tabloid|poster|a4]</tt><br> - <tt> <br> - Example:<br> - $xpaget ds9 pagesetup orient<br> - $xpaget ds9 pagesetup scale<br> - $xpaget ds9 pagesetup size<br> - $xpaset -p ds9 pagesetup orient portrait<br> - $xpaset -p ds9 pagesetup scale 50<br> - $xpaset -p ds9 pagesetup size poster<br> - </tt> - <p><b><a name="pan" id="pan"></a>pan</b></p> - <p>Controls the current image cursor location for the current - frame.</p> - <tt>Syntax:<br> - pan [<coordsys> [<skyframe>] [<skyformat>]] # - get current coords<br> - <br> - pan [<x> <y> <coordsys> [<skyframe>]] # - relative<br> - [to <x> <y> <coordsys> - [<skyframe>]] # absolute<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 pan # get current image coords<br> - $xpaget ds9 pan wcs fk4 sexagesimal # get current coords<br> - $xpaset -p ds9 pan 200 200 image # pan relative<br> - $xpaset -p ds9 pan to 400 400 physical # pan to physical coords<br> - $xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs - coords<br> - $xpaset -p ds9 pan open<br> - $xpaset -p ds9 pan close<br> - </tt> - <p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> - <p>Display/Hide the pixel table.</p> - <tt>Syntax:<br> - pixeltable []<br> - [yes|open]<br> - - [no|close]<br> - <br> - Example:<br> - $xpaget ds9 pixeltable<br> - $xpaset -p ds9 pixeltable<br> - $xpaset -p ds9 pixeltable yes<br> - $xpaset -p ds9 pixeltable open<br> - $xpaset -p ds9 pixeltable close</tt><br> - <p><b><a name="plot" id="plot"></a>plot</b></p> - <p>Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions:</p> - <blockquote>xy x and y coordinates<br> - xyex x,y coordinates with x errors<br> - xyey x,y coordinates with y errors<br> - xyexey x,y coordinates with x and y - errors<br> - </blockquote> - <p>To create a new plot, use the plot new command.</p> - <tt>Syntax:</tt><tt><br> - </tt><tt> </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> </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> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># existing plot</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>plot</tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - load <filename> xy|xyex|xyey|xyexey]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] save <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] clear]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - duplicate [#]]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - stats yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - list yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - loadconfig <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] saveconfig <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] pagesetup orient portrait|landscape]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print destination printer|file]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print command <command>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print filename <filename>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] print color rgb|gray]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - close</tt><tt>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - mode pointer|zoom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><tt><tt><tt># export image</tt><tt><br> - </tt><tt> </tt><tt> </tt>plot</tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - </tt>export</tt><tt> </tt><tt>[gif|tiff|jpeg|png]</tt><tt> </tt><tt><filename></tt><tt><br> - </tt><tt></tt></tt><tt><tt> [<tt>[<plotname>] - - - - - - - - - - - - </tt>export jpeg <filename></tt><tt> </tt><tt>[1-100]</tt><tt><br> - </tt><tt> </tt><tt> </tt></tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - </tt>export tiff <filename</tt><tt>></tt><tt> </tt><tt>[none|jpeg|packbits|deflate]</tt><tt><br> - </tt><tt> <br> - </tt># configure graph</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>plot [[<plotname>] axis x|y - grid yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y log yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y flip yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y auto yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y min <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y max <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] axis x|y format <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><tt> </tt><tt> - </tt><tt>[[<plotname>] background <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - legend yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] legend position right|left|top|bottom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font title|labels|numbers font - times|helvetica|courier]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>size <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>weight normal|bold]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] font</tt><tt> </tt><tt>title|labels|numbers</tt><tt> - </tt><tt>slant roman|italic]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] title <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> - [[<plotname>] title x|y <string>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> [</tt><tt>[<plotname>] - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt># configure current dataset</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>plot [[<plotname>] show - yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - shape - none|circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - shape fill yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - shape color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - smooth step|linear|cubic|quadratic|catrom]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - width <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - dash yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - error yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - error color <value>]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - error cap yes|no]</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt> </tt><tt> </tt><tt>[[<plotname>] - - - - - - - - - - - - - error width <value>]</tt><br> - <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> </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>$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> </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> </tt><tt> </tt><tt>$xpaset -p ds9 plot saveconfig - foo.plt</tt><tt><br> - </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> </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> </tt><tt> </tt><tt>$xpaset -p ds9 plot print filename - foo.ps</tt><tt><br> - </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><tt><tt><tt><tt># export plot</tt><tt><br> - </tt></tt></tt><tt><tt><tt><tt>$xpaset -p ds9 plot export - tiff foo.tiff jpeg</tt></tt></tt><br> - $xpaset -p ds9 plot export jpeg foo.jpeg 75<br> - $xpaset -p ds9 plot export png foo.png</tt><br> - <br> - </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> </tt><tt> </tt><tt><br> - </tt><tt> </tt><tt> </tt><tt><tt>$xpaget ds9 plot background</tt><tt><br> - </tt><tt> </tt><tt> </tt><tt>$xpaset -p ds9 plot background - white</tt><tt><br> - </tt><tt> </tt><tt> </tt><br> - $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> </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> </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> </tt><tt> </tt><tt>$xpaset -p ds9 plot title y {Y - Axis}</tt><tt><br> - </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> - $xpaget ds9 plot error cap<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> </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> - $xpaset -p ds9 plot error cap yes<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> - <tt>Syntax:<br> - png [new|slice] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 png > foo.png</tt><br> - <tt>$xpaset -p ds9 png foo.png</tt><br> - <tt><tt>$xpaset -p ds9 png new foo.png<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 png slice foo.png<br> - </tt></tt> $cat foo.png | xpaset ds9 png</tt> <tt><tt><tt># - not available windows</tt></tt></tt><br> - <tt><tt>$cat foo.png | xpaset ds9 png</tt> <tt>new</tt></tt> <tt><tt><tt><tt># - not available windows</tt></tt><br> - </tt> $cat foo.png | xpaset ds9 png</tt> <tt>slice</tt> <tt><tt><tt># - not available windows<br> - </tt></tt></tt> - <p><b><a name="precision" id="precision"></a>precision</b></p> - <p>Set region and coordinate output format precision.</p> - <tt>Syntax:<br> - precision <linear></tt> <tt><tt><degree></tt></tt> - <tt><tt><hms></tt></tt> <tt><tt><tt><dms></tt></tt></tt> - <tt><tt><tt><tt><arcmin></tt></tt></tt></tt> <tt><tt><tt><tt><tt><arcsec><br> - <br> - </tt></tt></tt></tt> Example:<br> - $xpaget ds9 precision<br> - $xpaset -p ds9 precision 8 10 4 3 5 3</tt><br> - <p><b><a name="prefs" id="prefs"></a>prefs</b></p> - <p>Controls various preference settings.</p> - <tt>Syntax:<br> - prefs [clear]<br> - [irafalign yes|no]<br> - <br> - Example:<br> - $xpaget ds9 prefs irafalign<br> - $xpaset -p ds9 prefs clear<br> - $xpaset -p ds9 prefs iraf yes<br> - </tt> - <p><b><a name="preserve" id="preserve"></a>preserve</b></p> - <p>Preserve the follow attributes while loading a new image.</p> - <tt>Syntax:<br> - preserve [pan yes|no]<br> - [regions yes|no]<br> - <br> - Example:<br> - $xpaget ds9 preserve pan<br> - $xpaget ds9 preserve regions<br> - $xpaset -p ds9 preserve pan yes<br> - $xpaset -p ds9 preserve regions yes<br> - </tt> - <p><b><a name="psprint" id="psprint"></a>psprint</b></p> - <p>Invokes postscript printing. Please see <a - href="command.html#print">print</a> for further details.</p> - <p><b><a name="print" id="print"></a>print</b></p> - <p>Controls printing. Use print option to set printing options. - Only available for <tt>XPA_METHOD local.</tt></p> - <tt>Syntax:<br> - print [destination printer|file]<br> - [command <command>]<br> - [filename <filename>]<br> - [color rgb|cmyk|gray]<br> - [level 1|2|3]<br> - [resolution - 72|screen|96|144|150|225|300|600|1200]<br> - <br> - Example:<br> - $xpaget ds9 print destination<br> - $xpaget ds9 print command<br> - $xpaget ds9 print filename<br> - $xpaget ds9 print color<br> - $xpaget ds9 print level<br> - $xpaget ds9 print resolution<br> - $xpaset -p ds9 print<br> - $xpaset -p ds9 print destination file<br> - $xpaset -p ds9 print command lp<br> - $xpaset -p ds9 print filename foo.ps<br> - $xpaset -p ds9 print color cmyk<br> - $xpaset -p ds9 print level 2<br> - $xpaset -p ds9 print resolution 96</tt> - <p><b><a name="raise" id="raise"></a>raise</b></p> - <p>Raise in the window stacking order.</p> - <tt>Syntax:<br> - raise<br> - <br> - Example:<br> - $xpaset -p ds9 raise</tt> - <p><b><a name="regions" id="regions"></a>regions</b></p> - <p>Controls regions in the current frame.</p> - <tt>Syntax:<br> - regions [<filename>]<br> - [load [all] - <filename>]<br> - [save - <filename>]<br> - [list [close]]<br> - [epsilon <integer>]<br> - [show yes|no]<br> - [showtext yes|no]<br> - [centroid]<br> - [centroid auto - yes|no]<br> - [centroid radius - <value>|iteration <value>]<br> - [getinfo]<br> - [move front]<br> - [move back]<br> - [select all]<br> - [select none]<br> - [select invert]<br> - [delete all]<br> - [delete select]<br> - [format - ds9|xml|ciao|saotng|saoimage|pros|xy]<br> - [system - image|physical|wcs|wcsa...wcsz]<br> - [sky - fk4|fk5|icrs|galactic|ecliptic]<br> - [skyformat - degrees|sexagesimal]<br> - [strip yes|no]<br> - [shape <shape>]<br> - [color - &ltcolor>]<br> - [width <width>]<br> - </tt> <tt> - [fixed|edit|rotate|delete yes|no]<br> - - [include|exclude|source|background]</tt><br> - <tt> [command <marker - command>]<br> - [composite]<br> - [dissolve]<br> - [template - <filename>]<br> - [template <filename> - at <ra> <dec> <coordsys> <skyframe>]<br> - [savetemplate - <filename>]<br> - [groups]<br> - [group new]<br> - [group <tag> - new]<br> - [group <tag> update]<br> - [group <tag> - select]<br> - [group <tag> color - &ltcolor>]<br> - [group <tag> copy]<br> - [group <tag> delete]<br> - [group <tag> cut]<br> - [group <tag> font - <font>]<br> - [group <tag> move - <int> <int>]<br> - [group <tag> - movefront]<br> - [group <tag> - moveback]<br> - [group <tag> - property <property> yes|no]<br> - [copy]<br> - [cut]<br> - [paste - image|physical|wcs|wcsa...wcsz]<br> - [undo]<br> - [-format - ds9|ciao|saotng|saoimage|pros|xy]<br> - [-system - image|physical|wcs|wcsa...wcsz]<br> - [-sky - fk4|fk5|icrs|galactic|ecliptic]<br> - [-skyformat - degrees|sexagesimal]<br> - [-delim [nl|<char>]]<br> - [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0]<br> - [-group <tag>]<br> - [-strip yes|no]<br> - [-wcs yes|no]<br> - <br> - Example:<br> - $xpaget ds9 regions<br> - $xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat - sexagesimal -prop edit 1 -group foo<br> - $xpaget ds9 regions epsilon<br> - $xpaget ds9 regions show<br> - $xpaget ds9 regions showtext<br> - $xpaget ds9 regions centroid auto<br> - $xpaget ds9 regions centroid radius<br> - $xpaget ds9 regions centroid iteration<br> - $xpaget ds9 regions selected<br> - $xpaget ds9 regions format<br> - $xpaget ds9 regions system<br> - $xpaget ds9 regions sky<br> - $xpaget ds9 regions skyformat<br> - $xpaget ds9 regions strip<br> - $xpaget ds9 regions shape<br> - $xpaget ds9 regions color<br> - $xpaget ds9 regions width<br> - $xpaget ds9 regions source<br> - $xpaget ds9 regions background<br> - $xpaget ds9 regions include<br> - $xpaget ds9 regions exclude<br> - $xpaget ds9 regions selected<br> - $xpaget ds9 regions groups<br> - $cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky - fk5<br> - $cat bar.reg | xpaset ds9 regions -format ds9<br> - $echo "image; circle 100 100 20" | xpaset ds9 regions<br> - $echo "image; circle 100 100 20" | xpaset ds9 regions<br> - $echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions<br> - $echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions<br> - $echo "box 100 100 20 40 25" | xpaset ds9 regions<br> - $echo "image; line 100 100 200 400" | xpaset ds9 regions<br> - $echo "physical; ruler 200 300 200 400" | xpaset ds9 regions<br> - $echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 - regions<br> - $echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 - regions<br> - $xpaset -p ds9 regions foo.reg<br> - $xpaset -p ds9 regions -format ciao bar.reg # load as ciao - format<br> - $xpaset -p ds9 regions foo.fits # FITS regions files do not need - a format specification<br> - $xpaset -p ds9 regions load foo.reg # load foo.reg into current - frame<br> - $xpaset -p ds9 regions load all foo.reg # load foo.reg into all - frames<br> - $xpaset -p ds9 regions load '*.reg'# expand *.reg and load into - current frame<br> - $xpaset -p ds9 regions load all '*.reg' # expand *.reg and load - into all frames<br> - $xpaset -p ds9 regions save foo.reg<br> - $xpaset -p ds9 regions list<br> - $xpaset -p ds9 regions list close<br> - $xpaset -p ds9 regions epsilon 5<br> - $xpaset -p ds9 regions show yes<br> - $xpaset -p ds9 regions showtext no<br> - $xpaset -p ds9 regions centroid<br> - $xpaset -p ds9 regions centroid auto yes<br> - $xpaset -p ds9 regions centroid radius 10<br> - $xpaset -p ds9 regions centroid iteration 20<br> - $xpaset -p ds9 regions getinfo<br> - $xpaset -p ds9 regions move back<br> - $xpaset -p ds9 regions move front<br> - $xpaset -p ds9 regions select all<br> - $xpaset -p ds9 regions select none<br> - $xpaset -p ds9 regions select invert<br> - $xpaset -p ds9 regions delete all<br> - $xpaset -p ds9 regions delete select<br> - $xpaset -p ds9 regions format ds9<br> - $xpaset -p ds9 regions system wcs<br> - $xpaset -p ds9 regions sky fk5<br> - $xpaset -p ds9 regions skyformat degrees<br> - $xpaset -p ds9 regions strip yes<br> - $xpaset -p ds9 regions shape ellipse<br> - $xpaset -p ds9 regions color red<br> - $xpaset -p ds9 regions width 3<br> - $xpaset -p ds9 regions edit yes<br> - $xpaset -p ds9 regions include<br> - $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}'<br> - $xpaset -p ds9 regions composite<br> - $xpaset -p ds9 regions dissolve<br> - $xpaset -p ds9 regions template foo.tpl<br> - $xpaset -p ds9 regions template foo.tpl at 13:29:55.92 - +47:12:48.02 fk5<br> - $xpaset -p ds9 regions savetemplate foo.tpl<br> - $xpaset -p ds9 regions group new<br> - $xpaset -p ds9 regions group foo new<br> - </tt> <tt>$xpaset -p ds9 regions group foo update</tt><br> - <tt>$xpaset -p ds9 regions group foo select</tt><br> - <tt>$xpaset -p ds9 regions group foo color red<br> - $xpaset -p ds9 regions group foo copy<br> - $xpaset -p ds9 regions group foo delete<br> - $xpaset -p ds9 regions group foo cut<br> - $xpaset -p ds9 regions group foo font {times 14 bold}<br> - $xpaset -p ds9 regions group foo move 100 100<br> - $xpaset -p ds9 regions group foo movefront<br> - $xpaset -p ds9 regions group foo moveback<br> - $xpaset -p ds9 regions group foo property delete no<br> - <br> - $xpaset -p ds9 regions copy<br> - $xpaset -p ds9 regions cut<br> - $xpaset -p ds9 regions paste wcs<br> - $xpaset -p ds9 regions undo<br> - </tt> - <p><b><a name="restore" id="restore"></a>restore</b></p> - <p>Restore DS9 to a previous state from a backup save set.</p> - <tt>Syntax:<br> - restore <filename><br> - <br> - Example:<br> - $xpaset -p ds9 restore ds9.bck</tt><br> - <p><b><a name="rgb" id="rgb"></a>rgb</b></p> - <p>Create RGB frame and control RGB frame parameters.</p> - <tt>Syntax:<br> - rgb []<br> - [red|green|blue]<br> - [channel [red|green|blue]]<br> - [view [red|green|blue] [yes|no]]<br> - [system <coordsys>]<br> - [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 rgb channel<br> - </tt> <tt>$xpaget ds9 rgb lock wcs</tt><br> - <tt>$xpaget ds9 rgb lock crop</tt><br> - <tt>$xpaget ds9 rgb lock slice</tt><br> - <tt>$xpaget ds9 rgb lock bin<br> - $xpaget ds9 rgb lock scale<br> - $xpaset ds9 rgb lock scalelimits<br> - $xpaget ds9 rgb lock colorbar<br> - $xpaget ds9 rgb lock block<br> - $xpaget ds9 rgb lock smooth<br> - $xpaget ds9 rgb system<br> - $xpaget ds9 rgb view red<br> - $xpaget ds9 rgb view green<br> - $xpaget ds9 rgb view blue<br> - $xpaset -p ds9 rgb # create new rgb frame<br> - $xpaset -p ds9 rgb red # set current channel to red<br> - $xpaset -p ds9 rgb channel red # set current channel to red<br> - $xpaset -p ds9 rgb view blue no # turn off blue channel<br> - $xpaset -p ds9 rgb system wcs # set rgb coordinate system<br> - </tt> <tt>$xpaset -p ds9 rgb lock wcs yes</tt><br> - <tt>$xpaset -p ds9 rgb lock crop yes</tt><br> - <tt>$xpaset -p ds9 rgb lock slice yes</tt><br> - <tt>$xpaset -p ds9 rgb lock bin yes</tt><br> - <tt>$xpaset -p ds9 rgb lock scale yes<br> - $xpaset -p ds9 rgb lock scalelimits yes<br> - $xpaset -p ds9 rgb lock colorbar yes<br> - $xpaset -p ds9 rgb lock block yes<br> - $xpaset -p ds9 rgb lock smooth yes<br> - $xpaset -p ds9 rgb open<br> - $xpaset -p ds9 rgb close</tt><br> - <p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> - <p>Load raw data array cube into rgb frame.<br> - </p> - <tt>Syntax:<br> - rgbarray [native|big|little]<br> - rgbarray [new] + [has contour [aux]]]<br> + [has fits [bin|cube|mosaic]]<br> + [has marker [highlite|paste|select|undo]]<br> + [has system <coordsys>]<br> + [has wcs [<wcssys>]]<br> + [has wcs celestial [<wcssys>]]<br> + [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 lock<br> +$xpaget ds9 frame has amplifier<br> +$xpaget ds9 frame has datamin<br> +$xpaget ds9 frame has datasec<br> +$xpaget ds9 frame has detector<br> +$xpaget ds9 frame has grid<br> +$xpaget ds9 frame has iis<br> +$xpaget ds9 frame has irafmin<br> +$xpaget ds9 frame has physical<br> +$xpaget ds9 frame has smooth<br> +$xpaget ds9 frame has contour<br> +$xpaget ds9 frame has contour aux<br> +$xpaget ds9 frame has fits<br> +$xpaget ds9 frame has fits bin<br> +$xpaget ds9 frame has fits cube<br> +$xpaget ds9 frame has fits mosaic<br> +$xpaget ds9 frame has marker highlite<br> +$xpaget ds9 frame has marker paste<br> +$xpaget ds9 frame has marker select<br> +$xpaget ds9 frame has marker undo<br> +$xpaget ds9 frame has system physical<br> +$xpaget ds9 frame has wcs wcsa<br> +$xpaget ds9 frame has wcs celestial wcsa<br> +$xpaget ds9 frame has wcs linear wcsa<br> +$xpaset -p ds9 frame center # center current frame<br> +$xpaset -p ds9 frame center 1 # center 'Frame1'<br> +$xpaset -p ds9 frame center all # center all frames<br> +$xpaset -p ds9 frame clear # clear current frame<br> +$xpaset -p ds9 frame new # create new frame<br> +$xpaset -p ds9 frame new rgb # create new rgb frame<br> +$xpaset -p ds9 frame delete # delete current frame<br> +$xpaset -p ds9 frame reset # reset current frame<br> +$xpaset -p ds9 frame refresh # refresh current frame<br> +$xpaset -p ds9 frame hide # hide current frame<br> +$xpaset -p ds9 frame show 1 # show frame 'Frame1'<br> +$xpaset -p ds9 frame move first # move frame to first in order<br> +$xpaset -p ds9 frame move back # move frame back in order<br> +$xpaset -p ds9 frame move forward # move frame forward in order<br> +$xpaset -p ds9 frame move last # move frame to last in order<br> +$xpaset -p ds9 frame first # goto first frame<br> +$xpaset -p ds9 frame prev # goto prev frame<br> +$xpaset -p ds9 frame next # goto next frame<br> +$xpaset -p ds9 frame last # goto last frame<br> +$xpaset -p ds9 frame frameno 4 # goto frame 'Frame4', create if +needed<br> +$xpaset -p ds9 frame 3 # goto frame 'Frame3', create if needed<br> +$xpaset -p ds9 frame match wcs<br> +$xpaset -p ds9 frame lock wcs<br></tt> +<p><tt><b><a name="gif" id="gif"></a>gif</b></tt></p> +<p><tt>Load GIF image into current frame.<br></tt></p> +<tt>Syntax:<br> +gif [new|slice] [<filename>]<br> + <br> +Example:<br> +$xpaget ds9 gif > foo.gif<br> +$xpaset -p ds9 gif foo.gif<br> +$xpaset -p ds9 gif new foo.gif<br> +$xpaset -p ds9 gif slice foo.gif<br> +$cat foo.gif | xpaset ds9 gif # not available windows<br> +$cat foo.gif | xpaset ds9 gifnew # not available windows<br> +$cat foo.gif | xpaset ds9 gifslice# not available windows</tt> +<p><b><a name="grid" id="grid"></a>grid</b></p> +<p>Controls coordinate grid. For grid numeric format syntax, +click <a href="grid.html#Format">here</a>.</p> +<tt>Syntax:<br> +grid []<br> + [yes|no]<br> + [type analysis|publication]<br> + [system <coordsys>]<br> + [sky <skyframe>]<br> + [skyformat <skyformat>]<br> + [grid yes|no]<br> + [grid color <color>]<br> + [grid width <value>]<br> + [grid dash yes|no]<br> + [grid gap1 <value>]<br> + [grid gap2 <value>]<br> + [grid gap3 <value>]<br> + [axes yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes dash yes|no]<br> + [axes type interior|exterior]<br> + [axes origin +lll|llu|lul|luu|ull|ulu|uul|uuu]<br> + [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks dash yes|no]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border dash yes|no]<br> + [numerics yes|no]<br> + [numerics font times|helvetica|courier]<br> + [numerics fontsize <value>]<br> + [numerics fontweight normal|bold]<br> + [numerics fontslant roman|italic]<br> + [numerics color <color>]<br> + [numerics gap1 <value>]<br> + [numerics gap2 <value>]<br> + [numerics gap3 <value>]<br> + [numerics type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + [labels def1 yes|no]<br> + [labels def2 yes|no]<br> + [labels text1 <text>]<br> + [labels text2 <text>]<br> + [labels gap1 <value>]<br> + [labels gap2 <value>]<br> + [labels font times|helvetica|courier]<br> + [labels fontsize <value>]<br> + [labels fontweight normal|bold]<br> + [labels fontslant roman|italic]<br> + [labels color <color>]<br> + [reset]<br> + [load <filename>]<br> + [save <filename>]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 grid<br> +$xpaget ds9 grid type<br> +$xpaget ds9 grid system<br> +$xpaget ds9 grid sky<br> +$xpaget ds9 grid skyformat<br> +$xpaget ds9 grid grid<br> +$xpaget ds9 grid grid color<br> +$xpaget ds9 grid grid width<br> +$xpaget ds9 grid grid dash<br> +$xpaget ds9 grid grid gap1<br> +$xpaget ds9 grid grid gap2<br> +$xpaget ds9 grid grid gap3<br> +$xpaget ds9 grid axes<br> +$xpaget ds9 grid axes color<br> +$xpaget ds9 grid axes width<br> +$xpaget ds9 grid axes dash<br> +$xpaget ds9 grid axes type<br> +$xpaget ds9 grid axes origin<br> +$xpaget ds9 grid format1<br> +$xpaget ds9 grid format2<br> +$xpaget ds9 grid tickmarks<br> +$xpaget ds9 grid tickmarks color<br> +$xpaget ds9 grid tickmarks width<br> +$xpaget ds9 grid tickmarks dash<br> +$xpaget ds9 grid border<br> +$xpaget ds9 grid border color<br> +$xpaget ds9 grid border width<br> +$xpaget ds9 grid border dash<br> +$xpaget ds9 grid numerics<br> +$xpaget ds9 grid numerics font<br> +$xpaget ds9 grid numerics fontsize<br> +$xpaget ds9 grid numerics fontweight<br> +$xpaget ds9 grid numerics fontslant<br> +$xpaget ds9 grid numerics color<br> +$xpaget ds9 grid numerics gap1<br> +$xpaget ds9 grid numerics gap2<br> +$xpaget ds9 grid numerics gap3<br> +$xpaget ds9 grid numerics type<br> +$xpaget ds9 grid numerics vertical<br> +$xpaget ds9 grid title<br> +$xpaget ds9 grid title text<br> +$xpaget ds9 grid title def<br> +$xpaget ds9 grid title gap<br> +$xpaget ds9 grid title font<br> +$xpaget ds9 grid title fontsize<br> +$xpaget ds9 grid title fontweight<br> +$xpaget ds9 grid title fontslant<br> +$xpaget ds9 grid title color<br> +$xpaget ds9 grid labels<br> +$xpaget ds9 grid labels text1<br> +$xpaget ds9 grid labels def1<br> +$xpaget ds9 grid labels gap1<br> +$xpaget ds9 grid labels text2<br> +$xpaget ds9 grid labels def2<br> +$xpaget ds9 grid labels gap2<br> +$xpaget ds9 grid labels font<br> +$xpaget ds9 grid labels fontsize<br> +$xpaget ds9 grid labels fontweight<br> +$xpaget ds9 grid labels fontslant<br> +$xpaget ds9 grid labels color<br> +$xpaset -p ds9 grid<br> +$xpaset -p ds9 grid yes<br> +$xpaset -p ds9 grid type analysis<br> +$xpaset -p ds9 grid system wcs<br> +$xpaset -p ds9 grid sky fk5<br> +$xpaset -p ds9 grid skyformat degrees<br> +$xpaset -p ds9 grid grid yes<br> +$xpaset -p ds9 grid grid color red<br> +$xpaset -p ds9 grid grid width 2<br> +$xpaset -p ds9 grid grid dash yes<br> +$xpaset -p ds9 grid grid gap1 10<br> +$xpaset -p ds9 grid grid gap2 10<br> +$xpaset -p ds9 grid grid gap3 10<br> +$xpaset -p ds9 grid axes yes<br> +$xpaset -p ds9 grid axes color red<br> +$xpaset -p ds9 grid axes width 2<br> +$xpaset -p ds9 grid axes dash yes<br> +$xpaset -p ds9 grid axes type exterior<br> +$xpaset -p ds9 grid axes origin lll<br> +$xpaset -p ds9 grid format1 d.2<br> +$xpaset -p ds9 grid format2 d.2<br> +$xpaset -p ds9 grid tickmarks yes<br> +$xpaset -p ds9 grid tickmarks color red<br> +$xpaset -p ds9 grid tickmarks width 2<br> +$xpaset -p ds9 grid tickmarks dash yes<br> +$xpaset -p ds9 grid border yes<br> +$xpaset -p ds9 grid border color red<br> +$xpaset -p ds9 grid border width 2<br> +$xpaset -p ds9 grid border dash yes<br> +$xpaset -p ds9 grid numerics yes<br> +$xpaset -p ds9 grid numerics font courier<br> +$xpaset -p ds9 grid numerics fontsize 12<br> +$xpaset -p ds9 grid numerics fontweight bold<br> +$xpaset -p ds9 grid numerics fontslant italic<br> +$xpaset -p ds9 grid numerics color red<br> +$xpaset -p ds9 grid numerics gap1 10<br> +$xpaset -p ds9 grid numerics gap2 10<br> +$xpaset -p ds9 grid numerics gap3 10<br> +$xpaset -p ds9 grid numerics type exterior<br> +$xpaset -p ds9 grid numerics vertical yes<br> +$xpaset -p ds9 grid title yes<br> +$xpaset -p ds9 grid title text {Hello World}<br> +$xpaset -p ds9 grid title def yes<br> +$xpaset -p ds9 grid title gap 10<br> +$xpaset -p ds9 grid title font courier<br> +$xpaset -p ds9 grid title fontsize 12<br> +$xpaset -p ds9 grid title fontweight bold<br> +$xpaset -p ds9 grid title fontslant italic<br> +$xpaset -p ds9 grid title color red<br> +$xpaset -p ds9 grid labels yes<br> +$xpaset -p ds9 grid labels text1 {Hello World}<br> +$xpaset -p ds9 grid labels def1 yes<br> +$xpaset -p ds9 grid labels gap1 10<br> +$xpaset -p ds9 grid labels text2 {Hello World}<br> +$xpaset -p ds9 grid labels def2 yes<br> +$xpaset -p ds9 grid labels gap2 10<br> +$xpaset -p ds9 grid labels font courier<br> +$xpaset -p ds9 grid labels fontsize 12<br> +$xpaset -p ds9 grid labels fontweight boldj<br> +$xpaset -p ds9 grid labels fontslant italic<br> +$xpaset -p ds9 grid labels color red<br> +$xpaset -p ds9 grid reset<br> +$xpaset -p ds9 grid load foo.grd<br> +$xpaset -p ds9 grid save foo.grd<br> +$xpaset -p ds9 grid open<br> +$xpaset -p ds9 grid close</tt><br> +<p><b><a name="header" id="header"></a>header</b></p> +<p>Display current fits header dialog. Optional extension number +maybe specified. Please note, this differs from xpa fits +header.</p> +<tt>Syntax:<br> +header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] <filename>]<br> + <br> +Example:<br> +$xpaset -p ds9 header<br> +$xpaset -p ds9 header 2<br> +$xpaset -p ds9 header close<br> +$xpaset -p ds9 header save 1 foo.txt<br></tt> +<p><b><a name="height" id="height"></a>height</b></p> +<p>Set the height of the image display window.</p> +<tt>Syntax:<br> +height [<value>]<br> + <br> +Example:<br> +$xpaget ds9 height<br> +$xpaset -p ds9 height 512<br></tt> +<p><b><a name="iconify" id="iconify"></a>iconify</b></p> +<p>Toggles iconification.</p> +<tt>Syntax:<br> +iconify []<br> + [yes|no]<br> + <br> +Example:<br> +$xpaget ds9 iconify<br> +$xpaset -p ds9 iconify<br> +$xpaset -p ds9 iconify yes<br></tt> +<p><b><a name="iexam" id="iexam"></a>iexam</b></p> +<p>Interactive examine function. A blinking cursor will indicate to +the user to click on a point on an image. The specified information +will be returned at that time. The default event is +<tt>button</tt>. In the last form, the following macros will be +expanded if present: <tt>$width, $height, $depth, $bitpix, +$filename, $regions, $filename[$regions], $env, $pan, $value, $x, +$y, $z.</tt> See <a href="analysis.html#macros">Analysis Macros</a> +for more information.<br></p> +<tt>Syntax:<br> +iexam []<br> + [[]|button|key|any] coordinate <coordsys> +[<skyframe>] [<skyformat>]<br> + [[]|button|key|any] data +[width][height]<br> + [[]|button|key|any] <macro +string>]<br> + <br> +Example:<br> +$xpaget ds9 iexam # image coordinates<br> +$xpaget ds9 iexam coordinate image<br> +$xpaget ds9 iexam key coordinate image # return coordinate and key +event<br> +$xpaget ds9 iexam coordinate wcs fk5 degrees<br> +$xpaget ds9 iexam coordinate wcs galactic sexagesimal<br> +$xpaget ds9 iexam coordinate fk5<br> +$xpaget ds9 iexam data # return data value<br> +$xpaget ds9 iexam key data # return data value and key event<br> +$xpaget ds9 iexam data 3 3 # return all data in 3x3 box about +selected point<br> +$xpaget ds9 iexam {'Click at $x,$y in file $filename'}</tt><br> +<p><b><a name="iis" id="iis"></a>iis</b></p> +<p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> +<tt>Syntax:<br> +iis [filename <filename> [#]]<br> + <br> +Example:<br> +$xpaget ds9 iis filename<br> +$xpaget ds9 iis filename 4<br> +$xpaset -p ds9 iis filename foo.fits<br> +$xpaset -p ds9 iis filename bar.fits 4</tt><br> +<p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> +<p>Load JPEG image into current frame. Optional parameters: +<tt>jpeg</tt> quality (1-100)</p> +<tt>Syntax:<br> +jpeg [new|slice] [<filename>] [1-100]<br> + <br> +Example:<br> +$xpaget ds9 jpeg > foo.jpeg<br> +$xpaget ds9 jpeg 100 > foo.jpeg<br> +$xpaset -p ds9 jpeg foo.jpeg<br> +$xpaset -p ds9 jpeg new foo.jpeg<br> +$xpaset -p ds9 jpeg slice foo.jpeg<br> +$cat foo.jpeg | xpaset ds9 jpeg# not available windows<br> +$cat foo.jpeg | xpaset ds9 jpegnew# not available windows<br> +$cat foo.jpeg | xpaset ds9 jpegslice# not available windows</tt> +<p><b><a name="lock" id="lock"></a>lock</b></p> +<p>Lock all other frames to the current frame.</p> +<tt>Syntax:<br> +lock[frame <coordsys>|none]<br> + [crosshair <coordsys>|none]<br> + [crop <coordsys>|none]<br> + [slice <coordsys>|none]]<br> + [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimites [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + [smooth [yes|no]]<br> + [3d [yes|no]]<br> + <br> +Example:<br> +$xpaget -p ds9 lock frame<br> +$xpaget -p ds9 lock crosshair<br> +$xpaget -p ds9 lock crop<br> +$xpaget -p ds9 lock slice<br> +$xpaget -p ds9 lock bin<br> +$xpaget -p ds9 lock axes<br> +$xpaget -p ds9 lock scale<br> +$xpaget -p ds9 lock scalelimits<br> +$xpaget -p ds9 lock colorbar<br> +$xpaget -p ds9 lock block<br> +$xpaget -p ds9 lock smooth<br> +$xpaget -p ds9 lock 3d<br> +$xpaset -p ds9 lock frame wcs<br> +$xpaset -p ds9 lock crosshair wcs<br> +$xpaset -p ds9 lock crop wcs<br> +$xpaset -p ds9 lock slice wcs<br> +$xpaset -p ds9 lock bin yes<br> +$xpaset -p ds9 lock axes yes<br> +$xpaset -p ds9 lock scale yes<br> +$xpaset -p ds9 lock scalelimits yes<br> +$xpaset -p ds9 lock colorbar yes<br> +$xpaset -p ds9 lock block yes<br> +$xpaset -p ds9 lock smooth yes<br> +$xpaset -p ds9 lock 3d yes<br> +<br></tt> <b><a name="lower" id="lower"></a>lower</b> +<p>Lower in the window stacking order.</p> +<tt>Syntax:<br> +lower<br> + <br> +Example:<br> +$xpaset -p ds9 lower<br></tt> +<p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> +<p>Controls the magnifier settings.</p> +<tt>Syntax:<br> +magnifier [color <color>]<br> + [zoom <value>]<br> + [cursor yes|no]<br> + [region yes|no]<br> + <br> +Example:<br> +$xpaget ds9 magnifier color<br> +$xpaget ds9 magnifier zoom<br> +$xpaget ds9 magnifier cursor<br> +$xpaget ds9 magnifier region<br> +$xpaset -p ds9 magnifier color yellow<br> +$xpaset -p ds9 magnifier zoom 2<br> +$xpaset -p ds9 magnifier cursor no<br> +$xpaset -p ds9 magnifier region no</tt><br> +<p><b><a name="mask" id="mask"></a>mask<br></b></p> +<p>Controls mask parameters.</p> +<tt>Syntax:<br> +mask [color <color>]<br> + [mark zero|nonzero|nan|nonnan|range]<br> + [range <low> <high>]<br> + [transparency <value>]<br> + [system <coordsys>]<br> + [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 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</tt><br> +<p><b><a name="match" id="match"></a>match</b></p> +<p>Match all other frames to the current frame.</p> +<tt>Syntax:<br> +match[frame <coordsys>]<br> + [crosshair <coordsys>]<br> + [crop <coordsys>]<br> + [slice <coordsys>]<br> + [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]<br> + [3d]<br> +<br> +Example:<br> +$xpaset -p ds9 match frame wcs<br> +$xpaset -p ds9 match crosshair wcs<br> +$xpaset -p ds9 match crop wcs<br> +$xpaset -p ds9 match slicewcs<br> +$xpaset -p ds9 match bin<br> +$xpaset -p ds9 match axes<br> +$xpaset -p ds9 match scale<br> +$xpaset -p ds9 match scalelimits<br> +$xpaset -p ds9 match colorbar<br> +$xpaset -p ds9 match block<br> +$xpaset -p ds9 match smooth<br> +$xpaset -p ds9 match 3d<br> +<br></tt> <b><a name="mecube" id="mecube"></a>mecube</b> +<p>Load FITS multiple extension file as data cube.<br></p> +<tt>Syntax:<br> +mecube [new] [<filename>]<br> + <br> +Example:<br> +$xpaget ds9 mecube > foo.fits<br> +$xpaset -p ds9 mecube foo.fits<br> +$xpaset -p ds9 mecube new foo.fits<br> +$cat foo.fits | xpaset ds9 mecube<br> +$cat foo.fits | xpaset ds9 mecubenew</tt> +<p><b><a name="minmax" id="minmax"></a>minmax</b></p> +<p>This is how DS9 determines the min and max data values +from the data. <tt>SCAN</tt> will scan all +data. <tt>DATAMIN</tt> and <tt>IRAFMIN</tt> will use the +values of the keywords if present.<br></p> +<tt>Syntax:<br> +minmax [scan|sample|datamin|irafmin]<br> + [mode scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> +Example:<br> +$xpaget ds9 minmax mode<br> +$xpaget ds9 minmax interval<br> +$xpaset -p ds9 minmax scan<br> +$xpaset -p ds9 minmax mode scan<br> +$xpaset -p ds9 minmax interval 100<br></tt> +<p><b><a name="mode" id="mode"></a>mode</b></p> +<p>Controls the first mouse button mode.</p> +<tt>Syntax:<br> +mode +[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d]<br> + + <br> +Example:<br> +$xpaget ds9 mode<br> +$xpaset -p ds9 mode crosshair</tt><br> +<p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> +<p>Load FITS mosaic segment into current frame.</p> +<tt>Syntax:<br> +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> + <br> +Example:<br> +$xpaget ds9 mosaic > foo.fits<br> +$xpaset -p ds9 mosaic foo.fits<br> +$xpaset -p ds9 mosaic wcs foo.fits<br> +$xpaset -p ds9 mosaic wcs new foo.fits<br> +$xpaset -p ds9 mosaic wcs mask foo.fits<br> +$cat foo.fits | xpaset ds9 mosaic<br> +$cat foo.fits | xpaset ds9 mosaic wcs<br> +$cat foo.fits | xpaset ds9 mosaic wcsnew<br> +$cat foo.fits | xpaset ds9 mosaic wcsmask<br></tt> +<p><b><a name="mosaicimage" id= +"mosaicimage"></a>mosaicimage</b></p> +<p>Load FITS mosaic image into current frame.</p> +<tt>Syntax:<br> +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] +[<filename>]<br> + <br> +Example:<br> +$xpaget ds9 mosaicimage > foo.fits<br> +$xpaset -p ds9 mosaicimage foo.fits<br> +$xpaset -p ds9 mosaicimage wcs foo.fits<br> +$xpaset -p ds9 mosaicimage wcs new foo.fits<br> +$xpaset -p ds9 mosaicimage wcs mask foo.fits<br> +$cat foo.fits | xpaset ds9 mosaicimage<br> +$cat foo.fits | xpaset ds9 mosaicimage wcs<br> +$cat foo.fits | xpaset ds9 mosaicimage wcs new<br> +$cat foo.fits | xpaset ds9 mosaicimage wcs mask<br></tt> +<p><b><a name="movie" id="movie"></a>movie<br></b></p> +<p>Create a movie from snap shots of the DS9 window. A +<tt>slice</tt> movie cycles though all slices of a cube. A +<tt>frame</tt> movie cycles through all active frames. A +<tt>3d</tt> movie cycles through specified viewing angles. The +default action is <tt>slice</tt>. Movie types are either +<tt>MPEG</tt> or <tt>Animated GIF</tt>, with default <tt>MPEG</tt>. +Optional parameters for <tt>3d</tt>: number of frames, azimuth +from/to, elevation from/to, slice from/to, oscillate/repeat +times.</p> +<tt>Syntax:<br> +movie [slice|frame|3d][mpeg|gif] <filename><br> +movie 3d [mpeg|gif] <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>]<br> + <br> +Example:<br> +$xpaset -p ds9 movie slice mpeg ds9.mpg<br> +$xpaset -p ds9 movie frame gif ds9.gif<br> +$xpaset -p ds9 movie 3d mpeg ds9.mpg number 10 azfrom -60 azto 60 +oscillate 1<br></tt> +<p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> +<p>Load FITS multiple extension file as multiple images.<br></p> +<tt>Syntax:<br> +multiframe [<filename>]<br> + <br> +Example:<br> +$xpaset -p ds9 multiframe foo.fits<br> +$cat foo.fits | xpaset ds9 multiframe# not available +windows</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> + +[serverned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds]<br> + + [skyformat degrees|sexagesimal]<br> + [pan]<br> + [crosshair]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 nameserver<br> +$xpaget ds9 nameserver server<br> +$xpaget ds9 nameserver skyformat<br> +$xpaget ds9 nameserver m31<br> +$xpaset -p ds9 nameserver m31<br> +$xpaset -p ds9 nameserver name m31<br> +$xpaset -p ds9 nameserver server ned-sao<br> +$xpaset -p ds9 nameserver skyformat sexagesimal<br> +$xpaset -p ds9 nameserver pan<br> +$xpaset -p ds9 nameserver crosshair<br> +$xpaset -p ds9 nameserver open<br> +$xpaset -p ds9 nameserver close</tt><br> +<p><b><a name="nan" id="nan"></a>nan</b></p> +<p>Set image not-a-number color.</p> +<tt>Syntax:<br> +nan <color><br> + <br> +Example:<br> +$xpaget ds9 nan<br> +$xpaset -p ds9 nan red<br></tt> +<p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> +<p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: +array endian.<br></p> +<tt>Syntax:<br> +nrrd [native|little|big]<br> +nrrd [new|mask] [<filename>]<br> + <br> +Example:<br> +$xpaget ds9 nrrd<br> +$xpaget ds9 nrrd big<br> +$xpaset -p ds9 nrrd foo.nrrd<br> +$xpaset -p ds9 nrrd new foo.nrrd<br> +$xpaset -p ds9 nrrd mask foo.nrrd<br> +$cat foo.nrrd | xpaset ds9 nrrd<br> +$cat foo.nrrd | xpaset ds9 nrrdnew<br> +$cat foo.nrrd | xpaset ds9 nrrd mask</tt> +<p><b><a name="nvss" id="nvss"></a>nvss</b></p> +<p>Support for NRAO VLA Sky Survey.</p> +<tt>Syntax:<br> +nvss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 nvss name<br> +$xpaget ds9 nvss coord<br> +$xpaget ds9 nvss size<br> +$xpaget ds9 nvss save<br> +$xpaget ds9 nvss frame<br> +$xpaset -p ds9 nvss<br> +$xpaset -p ds9 nvss m31<br> +$xpaset -p ds9 nvss name m31<br> +$xpaset -p ds9 nvss name clear<br> +$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> +$xpaset -p ds9 nvss close</tt><br> +<p><b><a name="orient" id="orient"></a>orient</b></p> +<p>Controls the orientation of the current frame.</p> +<tt>Syntax:<br> +orient [none|x|y|xy]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 orient<br> +$xpaset -p ds9 orient xy<br> +$xpaset -p ds9 orient open<br> +$xpaset -p ds9 orient close<br></tt> +<p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> +<p>Controls Page Setup options.<br></p> +<tt>Syntax:<br> +pagesetup [orient portrait|landscape]<br> + [scale <numberic>]<br> + [size letter|legal|tabloid|poster|a4]<br> + <br> +Example:<br> +$xpaget ds9 pagesetup orient<br> +$xpaget ds9 pagesetup scale<br> +$xpaget ds9 pagesetup size<br> +$xpaset -p ds9 pagesetup orient portrait<br> +$xpaset -p ds9 pagesetup scale 50<br> +$xpaset -p ds9 pagesetup size poster<br></tt> +<p><b><a name="pan" id="pan"></a>pan</b></p> +<p>Controls the current image cursor location for the current +frame.</p> +<tt>Syntax:<br> +pan [<coordsys> [<skyframe>] [<skyformat>]] # get +current coords<br> +<br> +pan [<x> <y> <coordsys> [<skyframe>]] # +relative<br> + [to <x> <y> <coordsys> +[<skyframe>]] # absolute<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 pan # get current image coords<br> +$xpaget ds9 pan wcs fk4 sexagesimal # get current coords<br> +$xpaset -p ds9 pan 200 200 image # pan relative<br> +$xpaset -p ds9 pan to 400 400 physical # pan to physical coords<br> +$xpaset -p ds9 pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs +coords<br> +$xpaset -p ds9 pan open<br> +$xpaset -p ds9 pan close<br></tt> +<p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> +<p>Display/Hide the pixel table.</p> +<tt>Syntax:<br> +pixeltable []<br> + [yes|open]<br> + [no|close]<br> + <br> +Example:<br> +$xpaget ds9 pixeltable<br> +$xpaset -p ds9 pixeltable<br> +$xpaset -p ds9 pixeltable yes<br> +$xpaset -p ds9 pixeltable open<br> +$xpaset -p ds9 pixeltable close</tt><br> +<p><b><a name="plot" id="plot"></a>plot</b></p> +<p>Display and configure data plots. All plot commands take an +optional second command, the plot name. If no plot name is +specified, the last plot created is assumed. Plot data is assumed +to be a pair of coordinates, with optional error values. The follow +are valid data descriptions:</p> +<blockquote><tt>xy x and y coordinates<br> +xyex x,y coordinates with x errors<br> +xyey x,y coordinates with y errors<br> +xyexey x,y coordinates with x and y +errors<br></tt></blockquote> +<p><tt>To create a new plot, use the plot new command.</tt></p> +<tt>Syntax:<br> +# create new empty plot window<br> +plot []<br> + [line|bar|scatter]<br> + [new]<br> + [new line|bar|scatter]<br> + [new name <plotname>]<br> + [new name <plotname> line|bar|scatter]<br> +<br> +# create new plot with data from stdin<br> +plot[new <title> <xaxis label> <yaxis +label>xy|xyex|xyey|xyexey]<br> + [new [line|bar|scatter] <title> <xaxis +label> <yaxis label>xy|xyex|xyey|xyexey]<br> + [newname <plotname><title> <xaxis +label> <yaxis label>xy|xyex|xyey|xyexey]<br> + [newname <plotname>line|bar|scatter +<title> <xaxis label> <yaxis +label>xy|xyex|xyey|xyexey]<br> +<br> +# create new plot with data from stdin which includes title/dim +headers<br> +plot [new stdin]<br> + [new[line|bar|scatter]stdin]<br> + [new name <plotname> stdin]<br> + [new name +<plotname>line|bar|scatterstdin]<br> +<br> +#load data into existing plot from stdin<br> +plot [[<plotname>] data xy|xyex|xyey|xyexey]<br> +<br> +# existing plot<br> +plot[[<plotname>] load <filename> +xy|xyex|xyey|xyexey]<br> + [[<plotname>] save <filename>]<br> + [[<plotname>] clear]<br> + [[<plotname>] duplicate [#]]<br> + [[<plotname>] stats yes|no]<br> + [[<plotname>] list yes|no]<br> + [[<plotname>] loadconfig +<filename>]<br> + [[<plotname>] saveconfig +<filename>]<br> + [[<plotname>] pagesetup orient +portrait|landscape]<br> + [[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4]<br> + [[<plotname>] print]<br> + [[<plotname>] print destination +printer|file]<br> + [[<plotname>] print command +<command>]<br> + [[<plotname>] print filename +<filename>]<br> + [[<plotname>] print color rgb|gray]<br> + [[<plotname>] close]<br> + [[<plotname>] mode pointer|zoom]<br> +<br> +# export image<br> +plot[[<plotname>] +export[gif|tiff|jpeg|png]<filename><br> + [[<plotname>] export jpeg +<filename>[1-100]<br> + [[<plotname>]export tiff +<filename>[none|jpeg|packbits|deflate]<br> + <br> +# configure graph<br> +plot [[<plotname>] axis x|y grid yes|no]<br> + [[<plotname>] axis x|y log yes|no]<br> + [[<plotname>] axis x|y flip yes|no]<br> + [[<plotname>] axis x|y auto yes|no]<br> + [[<plotname>] axis x|y min +<value>]<br> + [[<plotname>] axis x|y max +<value>]<br> + [[<plotname>] axis x|y format +<string>]<br> + [[<plotname>] background +<value>]<br> + [[<plotname>] legend yes|no]<br> + [[<plotname>] legend position +right|left|top|bottom]<br> + [[<plotname>] font title|labels|numbers +font times|helvetica|courier]<br> + [[<plotname>] fonttitle|labels|numberssize +<value>]<br> + [[<plotname>] +fonttitle|labels|numbersweight normal|bold]<br> + [[<plotname>] +fonttitle|labels|numbersslant roman|italic]<br> + [[<plotname>] title <string>]<br> + [[<plotname>] title x|y +<string>]<br> + [[<plotname>] barmode +normal|stacked|aligned|overlap]<br> +<br> +# configure current dataset<br> +plot [[<plotname>] show yes|no]<br> + [[<plotname>] shape +none|circle|square|diamond|plus|splus|scross|triangle|arrow]<br> + [[<plotname>] shape fill yes|no]<br> + [[<plotname>] shape color +<value>]<br> + [[<plotname>] smooth +step|linear|cubic|quadratic|catrom]<br> + [[<plotname>] color +<value>]<br></tt> <tt> [[<plotname>] +width <value>]<br> + [[<plotname>] dash yes|no]<br> + [[<plotname>] error yes|no]<br> + [[<plotname>] error color +<value>]<br> + [[<plotname>] error cap yes|no]<br> + [[<plotname>] error width +<value>]<br> + [[<plotname>] name <string>]<br> +<br> +# select current dataset<br> +plot [[<plotname>] select <value>]<br> + <br> +Example:<br> +# return all plotnames<br> +$xpaget ds9 plot<br> +<br> +# create new empty plot window<br> +$xpaset -p ds9 plot<br> +$xpaset -p ds9 plot bar<br> +$xpaset -p ds9 plot new<br> +$xpaset -p ds9 plot new bar<br> +$xpaset -p ds9 plot new name foo<br> +$xpaset -p ds9 plot new name foo bar<br> +<br> +# create new plot with data from stdin<br> +$cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} {Y Axis} +xy<br> +$cat xy.dat | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} +xy<br> +$cat xy.dat | xpaset ds9 plot new name foo {The Title} {X Axis} {Y +Axis} xy<br> +$cat xy.dat | xpaset ds9 plot new name foo bar {The Title} {X Axis} +{Y Axis} xy<br> +<br> +# create new plot with data from stdin which includes title/dim +headers<br> +$cat stdin.2.dat | xpaset ds9 plot new stdin<br> +$cat stdin.2.dat | xpaset ds9 plot new line stdin<br> +$cat stdin.2.dat | xpaset ds9 plot new name foo stdin<br> +$cat stdin.2.dat | xpaset ds9 plot new name foo line stdin<br> +<br> +#load data into existing plot from stdin<br> +$cat xy.dat | xpaset ds9 plot data xy<br> +$cat xy.dat | xpaset ds9 plot foo data xy<br> +<br> +# existing plot<br> +$xpaget ds9 plot stats<br> +$xpaget ds9 plot list<br> +$xpaset -p ds9 plot load xy.dat xy<br> +$xpaset -p ds9 plot save foo.dat<br> +$xpaset -p ds9 plot clear<br> +$xpaset -p ds9 plot duplicate 1<br> +$xpaset -p ds9 plot stats yes<br> +$xpaset -p ds9 plot list yes<br> +$xpaset -p ds9 plot loadconfig foo.plt<br> +$xpaset -p ds9 plot saveconfig foo.plt<br> +$xpaset -p ds9 plot pagesetup orient portrait<br> +$xpaset -p ds9 plot pagesetup size letter<br> +$xpaset -p ds9 plot print<br> +$xpaset -p ds9 plot print destination file<br> +$xpaset -p ds9 plot print command lp<br> +$xpaset -p ds9 plot print filename foo.ps<br> +$xpaset -p ds9 plot print color rgb<br> +$xpaset -p ds9 plot close<br> +$xpaget ds9 plot mode<br> +$xpaset -p ds9 plot mode pointer<br> +<br> +# export plot<br> +$xpaset -p ds9 plot export tiff foo.tiff jpeg<br> +$xpaset -p ds9 plot export jpeg foo.jpeg 75<br> +$xpaset -p ds9 plot export png foo.png<br> +<br> +# configure plot<br> +$xpaget ds9 plot axis x grid<br> +$xpaget ds9 plot axis x log<br> +$xpaget ds9 plot axis x flip<br> +$xpaget ds9 plot axis x auto<br> +$xpaget ds9 plot axis x min<br> +$xpaget ds9 plot axis x max<br> +$xpaget ds9 plot axis x format<br> +$xpaset -p ds9 plot axis x grid yes<br> +$xpaset -p ds9 plot axis x log yes<br> +$xpaset -p ds9 plot axis x flip yes<br> +$xpaset -p ds9 plot axis x auto no<br> +$xpaset -p ds9 plot axis x min 1<br> +$xpaset -p ds9 plot axis x max 100<br> +$xpaset -p ds9 plot axis x format {%f}<br> +<br> +$xpaget ds9 plot background<br> +$xpaset -p ds9 plot background white<br> +<br> +$xpaget ds9 plot legend<br> +$xpaget ds9 plot legend position<br> +$xpaset -p ds9 plot legend yes<br> +$xpaset -p ds9 plot legend position left<br> +<br> +$xpaget ds9 plot font numbers font<br> +$xpaget ds9 plot font numbers size<br> +$xpaget ds9 plot font numbers weight<br> +$xpaget ds9 plot font numbers slant<br> +$xpaset -p ds9 plot font numbers font times<br> +$xpaset -p ds9 plot font numbers size 12<br> +$xpaset -p ds9 plot font numbers weight bold<br> +$xpaset -p ds9 plot font numbers slant italic<br> +<br> +$xpaget ds9 plot title<br> +$xpaget ds9 plot title xaxis<br> +$xpaget ds9 plot title yaxis<br> +$xpaset -p ds9 plot title {This is a Title}<br> +$xpaset -p ds9 plot title x {X Axis}<br> +$xpaset -p ds9 plot title y {Y Axis}<br> +$xpaset -p ds9 plot title legend {This is the Legend}<br> +<br> +$xpaget ds9 plot barmode<br> +$xpaset -p ds9 plot barmode aligned<br> +<br> +# configure current dataset<br> +$xpaget ds9 plot show<br> +$xpaget ds9 plot shape<br> +$xpaget ds9 plot shape fill<br> +$xpaget ds9 plot shape color<br> +$xpaget ds9 plot smooth<br> +$xpaget ds9 plot color<br> +$xpaget ds9 plot width<br> +$xpaget ds9 plot dash<br> +$xpaget ds9 plot error<br> +$xpaget ds9 plot error color<br> +$xpaget ds9 plot error cap<br> +$xpaget ds9 plot error width<br> +$xpaget ds9 plot name<br> +$xpaset -p ds9 plot show yes<br> +$xpaset -p ds9 plot shape circle<br> +$xpaset -p ds9 plot shape fill no<br> +$xpaset -p ds9 plot shape color cyan<br> +$xpaset -p ds9 plot smooth step<br> +$xpaset -p ds9 plot color red<br> +$xpaset -p ds9 plot width 2<br> +$xpaset -p ds9 plot dash yes<br> +$xpaset -p ds9 plot error yes<br> +$xpaset -p ds9 plot error color red<br> +$xpaset -p ds9 plot error cap yes<br> +$xpaset -p ds9 plot error width 2<br> +$xpaset -p ds9 plot name {My Data}<br> +<br> +# select current dataset<br> +$xpaget ds9 plot select<br> +$xpaset -p ds9 plot select 2</tt><br> +<p><b><a name="png" id="png"></a>png</b></p> +<p>Load PNG image into current frame.<br></p> +<tt>Syntax:<br> +png [new|slice] [<filename>]<br> + <br> +Example:<br> +$xpaget ds9 png > foo.png<br> +$xpaset -p ds9 png foo.png<br> +$xpaset -p ds9 png new foo.png<br> +$xpaset -p ds9 png slice foo.png<br> +$cat foo.png | xpaset ds9 png<br> +$cat foo.png | xpaset ds9 png new<br> +$cat foo.png | xpaset ds9 png 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><degree><hms><dms><arcmin><arcsec><br> + +<br> +Example:<br> +$xpaget ds9 precision<br> +$xpaset -p ds9 precision 8 10 4 3 5 3</tt><br> +<p><b><a name="prefs" id="prefs"></a>prefs</b></p> +<p>Controls various preference settings.</p> +<tt>Syntax:<br> +prefs [clear]<br> + [irafalign yes|no]<br> + <br> +Example:<br> +$xpaget ds9 prefs irafalign<br> +$xpaset -p ds9 prefs clear<br> +$xpaset -p ds9 prefs iraf yes<br></tt> +<p><b><a name="preserve" id="preserve"></a>preserve</b></p> +<p>Preserve the follow attributes while loading a new image.</p> +<tt>Syntax:<br> +preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> +Example:<br> +$xpaget ds9 preserve pan<br> +$xpaget ds9 preserve regions<br> +$xpaset -p ds9 preserve pan yes<br> +$xpaset -p ds9 preserve regions yes<br></tt> +<p><b><a name="psprint" id="psprint"></a>psprint</b></p> +<p>Invokes postscript printing. Please see <a href= +"command.html#print">print</a> for further details.</p> +<p><b><a name="print" id="print"></a>print</b></p> +<p>Controls printing. Use print option to set printing options. +Only available for <tt>XPA_METHOD local.</tt></p> +<tt>Syntax:<br> +print [destination printer|file]<br> + [command <command>]<br> + [filename <filename>]<br> + [color rgb|cmyk|gray]<br> + [level 1|2|3]<br> + [resolution +72|screen|96|144|150|225|300|600|1200]<br> + <br> +Example:<br> +$xpaget ds9 print destination<br> +$xpaget ds9 print command<br> +$xpaget ds9 print filename<br> +$xpaget ds9 print color<br> +$xpaget ds9 print level<br> +$xpaget ds9 print resolution<br> +$xpaset -p ds9 print<br> +$xpaset -p ds9 print destination file<br> +$xpaset -p ds9 print command lp<br> +$xpaset -p ds9 print filename foo.ps<br> +$xpaset -p ds9 print color cmyk<br> +$xpaset -p ds9 print level 2<br> +$xpaset -p ds9 print resolution 96</tt> +<p><b><a name="raise" id="raise"></a>raise</b></p> +<p>Raise in the window stacking order.</p> +<tt>Syntax:<br> +raise<br> + <br> +Example:<br> +$xpaset -p ds9 raise</tt> +<p><b><a name="regions" id="regions"></a>regions</b></p> +<p>Controls regions in the current frame.</p> +<tt>Syntax:<br> +regions [<filename>]<br> + [load [all] <filename>]<br> + [save <filename>]<br> + [list [close]]<br> + [epsilon <integer>]<br> + [show yes|no]<br> + [showtext yes|no]<br> + [centroid]<br> + [centroid auto yes|no]<br> + [centroid radius <value>|iteration +<value>]<br> + [getinfo]<br> + [move front]<br> + [move back]<br> + [select all]<br> + [select none]<br> + [select invert]<br> + [delete all]<br> + [delete select]<br> + [format +ds9|xml|ciao|saotng|saoimage|pros|xy]<br> + [system image|physical|wcs|wcsa...wcsz]<br></tt> +<tt> [sky fk4|fk5|icrs|galactic|ecliptic]<br> + [skyformat degrees|sexagesimal]<br> + [strip yes|no]<br> + [shape <shape>]<br> + [color &ltcolor>]<br> + [width <width>]<br> + [fixed|edit|rotate|delete yes|no]<br> + [include|exclude|source|background]<br> + [command <marker command>]<br> + [composite]<br> + [dissolve]<br> + [template <filename>]<br> + [template <filename> at <ra> +<dec> <coordsys> <skyframe>]<br> + [savetemplate <filename>]<br> + [groups]<br> + [group new]<br> + [group <tag> new]<br> + [group <tag> update]<br> + [group <tag> select]<br> + [group <tag> color &ltcolor>]<br> + [group <tag> copy]<br> + [group <tag> delete]<br> + [group <tag> cut]<br> + [group <tag> font <font>]<br> + [group <tag> move <int> +<int>]<br> + [group <tag> movefront]<br> + [group <tag> moveback]<br> + [group <tag> property <property> +yes|no]<br> + [copy]<br> + [cut]<br> + [paste image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + [-format ds9|ciao|saotng|saoimage|pros|xy]<br> + [-system image|physical|wcs|wcsa...wcsz]<br> + [-sky fk4|fk5|icrs|galactic|ecliptic]<br> + [-skyformat degrees|sexagesimal]<br> + [-delim [nl|<char>]]<br> + [-prop +select|edit|move|rotate|delete|fixed|include|source 1|0]<br> + [-group <tag>]<br> + [-strip yes|no]<br> + [-wcs yes|no]<br> + <br> +Example:<br> +$xpaget ds9 regions<br> +$xpaget ds9 regions -format ds9 -system wcs -sky fk5 -skyformat +sexagesimal -prop edit 1 -group foo<br> +$xpaget ds9 regions epsilon<br> +$xpaget ds9 regions show<br> +$xpaget ds9 regions showtext<br> +$xpaget ds9 regions centroid auto<br> +$xpaget ds9 regions centroid radius<br> +$xpaget ds9 regions centroid iteration<br> +$xpaget ds9 regions selected<br> +$xpaget ds9 regions format<br> +$xpaget ds9 regions system<br> +$xpaget ds9 regions sky<br> +$xpaget ds9 regions skyformat<br> +$xpaget ds9 regions strip<br> +$xpaget ds9 regions shape<br> +$xpaget ds9 regions color<br> +$xpaget ds9 regions width<br> +$xpaget ds9 regions source<br> +$xpaget ds9 regions background<br> +$xpaget ds9 regions include<br> +$xpaget ds9 regions exclude<br> +$xpaget ds9 regions selected<br> +$xpaget ds9 regions groups<br> +$cat foo.reg | xpaset ds9 regions -format xy -system wcs -sky +fk5<br> +$cat bar.reg | xpaset ds9 regions -format ds9<br> +$echo "image; circle 100 100 20" | xpaset ds9 regions<br> +$echo "image; circle 100 100 20" | xpaset ds9 regions<br> +$echo "fk5; circle 13:29:55 47:11:50 .5'" | xpaset ds9 regions<br> +$echo "physical; ellipse 100 100 20 40" | xpaset ds9 regions<br> +$echo "box 100 100 20 40 25" | xpaset ds9 regions<br> +$echo "image; line 100 100 200 400" | xpaset ds9 regions<br> +$echo "physical; ruler 200 300 200 400" | xpaset ds9 regions<br> +$echo "image; text 100 100 # text={Hello, World}" | xpaset ds9 +regions<br> +$echo "fk4; boxcircle point 13:29:55 47:11:50" | xpaset ds9 +regions<br> +$xpaset -p ds9 regions foo.reg<br> +$xpaset -p ds9 regions -format ciao bar.reg # load as ciao +format<br> +$xpaset -p ds9 regions foo.fits # FITS regions files do not need a +format specification<br> +$xpaset -p ds9 regions load foo.reg # load foo.reg into current +frame<br> +$xpaset -p ds9 regions load all foo.reg # load foo.reg into all +frames<br> +$xpaset -p ds9 regions load '*.reg'# expand *.reg and load into +current frame<br> +$xpaset -p ds9 regions load all '*.reg' # expand *.reg and load +into all frames<br> +$xpaset -p ds9 regions save foo.reg<br> +$xpaset -p ds9 regions list<br> +$xpaset -p ds9 regions list close<br> +$xpaset -p ds9 regions epsilon 5<br> +$xpaset -p ds9 regions show yes<br> +$xpaset -p ds9 regions showtext no<br> +$xpaset -p ds9 regions centroid<br> +$xpaset -p ds9 regions centroid auto yes<br> +$xpaset -p ds9 regions centroid radius 10<br> +$xpaset -p ds9 regions centroid iteration 20<br> +$xpaset -p ds9 regions getinfo<br> +$xpaset -p ds9 regions move back<br> +$xpaset -p ds9 regions move front<br> +$xpaset -p ds9 regions select all<br> +$xpaset -p ds9 regions select none<br> +$xpaset -p ds9 regions select invert<br> +$xpaset -p ds9 regions delete all<br> +$xpaset -p ds9 regions delete select<br> +$xpaset -p ds9 regions format ds9<br> +$xpaset -p ds9 regions system wcs<br> +$xpaset -p ds9 regions sky fk5<br> +$xpaset -p ds9 regions skyformat degrees<br> +$xpaset -p ds9 regions strip yes<br> +$xpaset -p ds9 regions shape ellipse<br> +$xpaset -p ds9 regions color red<br> +$xpaset -p ds9 regions width 3<br> +$xpaset -p ds9 regions edit yes<br> +$xpaset -p ds9 regions include<br> +$xpaset -p ds9 regions command '{circle 100 100 20 # +color=red}'<br> +$xpaset -p ds9 regions composite<br> +$xpaset -p ds9 regions dissolve<br> +$xpaset -p ds9 regions template foo.tpl<br> +$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 +47:12:48.02 +fk5<br> +$xpaset -p ds9 regions savetemplate foo.tpl<br> +$xpaset -p ds9 regions group new<br> +$xpaset -p ds9 regions group foo new<br> +$xpaset -p ds9 regions group foo update<br> +$xpaset -p ds9 regions group foo select<br> +$xpaset -p ds9 regions group foo color red<br> +$xpaset -p ds9 regions group foo copy<br> +$xpaset -p ds9 regions group foo delete<br> +$xpaset -p ds9 regions group foo cut<br> +$xpaset -p ds9 regions group foo font {times 14 bold}<br> +$xpaset -p ds9 regions group foo move 100 100<br> +$xpaset -p ds9 regions group foo movefront<br> +$xpaset -p ds9 regions group foo moveback<br> +$xpaset -p ds9 regions group foo property delete no<br> +<br> +$xpaset -p ds9 regions copy<br> +$xpaset -p ds9 regions cut<br> +$xpaset -p ds9 regions paste wcs<br> +$xpaset -p ds9 regions undo<br></tt> +<p><b><a name="restore" id="restore"></a>restore</b></p> +<p>Restore DS9 to a previous state from a backup save set.</p> +<tt>Syntax:<br> +restore <filename><br> + <br> +Example:<br> +$xpaset -p ds9 restore ds9.bck</tt><br> +<p><b><a name="rgb" id="rgb"></a>rgb</b></p> +<p>Create RGB frame and control RGB frame parameters.</p> +<tt>Syntax:<br> +rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock +wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth +[yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 rgb channel<br> +$xpaget ds9 rgb lock wcs<br> +$xpaget ds9 rgb lock crop<br> +$xpaget ds9 rgb lock slice<br> +$xpaget ds9 rgb lock bin<br> +$xpaget ds9 rgb lock scale<br> +$xpaset ds9 rgb lock scalelimits<br> +$xpaget ds9 rgb lock colorbar<br> +$xpaget ds9 rgb lock block<br> +$xpaget ds9 rgb lock smooth<br> +$xpaget ds9 rgb system<br> +$xpaget ds9 rgb view red<br> +$xpaget ds9 rgb view green<br> +$xpaget ds9 rgb view blue<br> +$xpaset -p ds9 rgb # create new rgb frame<br> +$xpaset -p ds9 rgb red # set current channel to red<br> +$xpaset -p ds9 rgb channel red # set current channel to red<br> +$xpaset -p ds9 rgb view blue no # turn off blue channel<br> +$xpaset -p ds9 rgb system wcs # set rgb coordinate system<br> +$xpaset -p ds9 rgb lock wcs yes<br> +$xpaset -p ds9 rgb lock crop yes<br> +$xpaset -p ds9 rgb lock slice yes<br> +$xpaset -p ds9 rgb lock bin yes<br> +$xpaset -p ds9 rgb lock scale yes<br> +$xpaset -p ds9 rgb lock scalelimits yes<br> +$xpaset -p ds9 rgb lock colorbar yes<br> +$xpaset -p ds9 rgb lock block yes<br> +$xpaset -p ds9 rgb lock smooth yes<br> +$xpaset -p ds9 rgb open<br> +$xpaset -p ds9 rgb close</tt><br> +<p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> +<p>Load raw data array cube into rgb frame.<br></p> +<tt>Syntax:<br> +rgbarray [native|big|little]<br> +rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> - <br> - Example:<br> - $xpaget ds9 rgbarray > foo.arr<br> - $xpaget ds9 rgbarray little > foo.arr<br> - $xpaset -p ds9 rgbarray - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> - $xpaset -p ds9 rgbarray new foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> - <tt>$cat foo.arr | xpaset ds9 rgbarray - [dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> - <tt>$cat foo.arr | xpaset ds9 rgbarray new - [dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> - <p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> - <p>Load FITS rgbcube into rgb frame.<br> - </p> - <tt>Syntax:<br> - rgbcube [new] [<filename>]<br> - <br> - Example:<br> - $xpaget ds9 rgbcube > foo.fits<br> - $xpaset -p ds9 rgbcube foo.fits</tt><br> - <tt><tt>$xpaset -p ds9 rgbcube new foo.fits<br> - </tt> $cat foo.fits | xpaset ds9 rgbcube</tt><br> - <tt>$cat foo.fits | xpaset ds9 rgbcube</tt> <tt>new</tt><br> - <p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> - <p>Load FITS rgbimage into rgb frame.<br> - </p> - <tt>Syntax:</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> - <tt>Syntax:<br> - rotate [<value>]<br> - [to <value>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 rotate<br> - $xpaset -p ds9 rotate 45<br> - $xpaset -p ds9 rotate to 30<br> - $xpaset -p ds9 rotate open<br> - $xpaset -p ds9 rotate close<br> - </tt> - <p><b><a name="save" id="save"></a>save<br> - </b></p> - <p>Save loaded image data of current frame as FITS.</p> - <tt>Syntax:<br> - save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice]</tt><br> - <tt> <br> - Example:<br> - $xpaset -p ds9 save foo.fits</tt><br> - <tt>$xpaset -p ds9 save fits foo.fits image</tt><br> - <tt>$xpaset -p ds9 save fits foo.fits table<br> - $xpaset -p ds9 save fits foo.fits slice</tt><br> - <tt>$xpaset -p ds9 save rgbimage foo.fits<br> - </tt> <tt>$xpaset -p ds9 save rgbcube foo.fits</tt><br> - <tt>$xpaset -p ds9 save mecube foo.fits</tt><br> - <tt>$xpaset -p ds9 save mosaic foo.fits</tt><br> - <tt>$xpaset -p ds9 save mosaicimage foo.fits</tt><br> - <p><b><a name="saveimage" id="saveimage"></a>saveimage<br> - </b></p> - <p>Create a snap shot of the current DS9 window and save in - specified image format. If no format specified, the file name - extension is used to determine the output format. Optional - parameters: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> - compression method.</p> - <tt>Syntax:<br> - saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> <tt><filename><br> - saveimage <filename>.jpeg [1-100]<br> - saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> - <br> - Example:<br> - $xpaset -p ds9 saveimage ds9.tiff<br> - $xpaset -p ds9 saveimage jpeg ds9.jpeg 75</tt><br> - <p><b><a name="scale" id="scale"></a>scale</b></p> - <p>Controls the limits and color scale distribution.</p> - <tt>Syntax:<br> - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> - [log exp <value>]<br> - [datasec yes|no]<br> - [limits <minvalue> - <maxvalue>]<br> - [mode - minmax|<value>|zscale|zmax]<br> - [scope local|global]<br> - [match]<br> - [match limits]<br> - [lock [yes|no]]<br> - [lock limits [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 scale<br> - $xpaget ds9 scale log exp<br> - $xpaget ds9 scale datasec<br> - $xpaget ds9 scale limits<br> - $xpaget ds9 scale mode<br> - $xpaget ds9 scale scope<br> - $xpaget ds9 scale lock<br> - $xpaget ds9 scale lock limits<br> - $xpaset -p ds9 scale linear<br> - $xpaset -p ds9 scale log exp 100<br> - $xpaset -p ds9 scale datasec yes<br> - $xpaset -p ds9 scale histequ<br> - $xpaset -p ds9 scale limits 1 100<br> - $xpaset -p ds9 scale mode zscale<br> - $xpaset -p ds9 scale mode 99.5<br> - $xpaset -p ds9 scale scope local<br> - $xpaset -p ds9 scale match<br> - $xpaset -p ds9 scale match limits<br> - $xpaset -p ds9 scale lock yes<br> - $xpaset -p ds9 scale lock limits yes<br> - $xpaset -p ds9 scale open<br> - $xpaset -p ds9 scale close<br> - </tt> - <p><b><a name="shm" id="shm"></a>shm</b></p> - <p>Load a shared memory segment into the current frame.</p> - <tt>Syntax:<br> - shm [<key> [<filename>]]<br> - [key <key> [<filename>]]<br> - [shmid <id> [<filename>]]<br> - [fits [key|shmid] <id> - [<filename>]]<br> - [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]]<br> - [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]]<br> - [rgbcube [key|shmid] <id> - [<filename>]<br> - [rgbimage [key|shmid] <id> - [<filename>]]<br> - [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> - [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - <br> - Example:<br> - $xpaget ds9 shm<br> - $xpaset -p ds9 shm 102<br> - $xpaset -p ds9 shm key 102<br> - $xpaset -p ds9 shm shmid 102 foo<br> - $xpaset -p ds9 shm fits key 100 foo<br> - $xpaset -p ds9 shm mosaicimage iraf key 100 foo<br> - $xpaset -p ds9 shm mosaicimage wcs key 100 foo<br> - $xpaset -p ds9 shm mosaicimage wcsa key 100 foo<br> - $xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo<br> - $xpaset -p ds9 shm mosaic iraf key 100 foo<br> - $xpaset -p ds9 shm mosaic wcs key 100 foo<br> - $xpaset -p ds9 shm rgbcube key 100 foo<br> - $xpaset -p ds9 shm rgbimage key 100 foo<br> - $xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> - $xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32]<br> - <br> - </tt> <b><a name="sia" id="sia"></a>sia<br> - </b> - <p>Support for VO Simple Image Access protocol. The first command - will create a new search. All other commands operated on the - last search created, unless indicated otherwise.</p> - <tt>Syntax:</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 clear<br> - </tt> <tt>$xpaset -p ds9 sia close<br> - </tt> <tt>$xpaset -p ds9 sia coordinate 202.48 47.21 fk5<br> - </tt> <tt>$xpaset -p ds9 sia crosshair<br> - </tt> <tt>$xpaset -p ds9 sia export tsv bar.tsv<br> - </tt> <tt>$xpaset -p ds9 sia name m51<br> - </tt> <tt>$xpaset -p ds9 sia print</tt><br> - <tt>$xpaset -p ds9 sia retrieve<br> - $xpaset -p ds9 sia save foo.xml<br> - </tt> <tt>$xpaset -p ds9 sia radius 1 degrees</tt><br> - <tt>$xpaset -p ds9 sia sky fk5<br> - $xpaset -p ds9 sia skyformat degrees<br> - </tt> <tt>$xpaset -p ds9 sia system wcs</tt><tt><br> - </tt> <tt>$xpaset -p ds9 sia update<br> - <br> - </tt> <b><a name="single" id="single"></a>single</b> - <p>Select Single Display mode</p> - <tt>Syntax:<br> - single<br> - <br> - Example:<br> - $xpaget ds9 single<br> - $xpaset -p ds9 single<br> - </tt> - <p><b><a name="skyview" id="skyview"></a>skyview</b></p> - <p>Support for SkyView image server at HEASARC.</p> - <tt>Syntax:<br> - skyview []<br> - [<object>]<br> - [name - <object>|clear]<br> - [<ra> - <dec>] # in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [pixels <width> - <height>]<br> - [save yes|no]<br> - [frame new|current]<br> - [update - frame|crosshair]<br> - [survey <survey>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 skyview name<br> - $xpaget ds9 skyview coord<br> - $xpaget ds9 skyview size<br> - $xpaget ds9 skyview pixels<br> - $xpaget ds9 skyview save<br> - $xpaget ds9 skyview frame<br> - $xpaget ds9 skyview survey<br> - $xpaset -p ds9 skyview<br> - $xpaset -p ds9 skyview m31<br> - </tt> <tt><tt>$xpaset -p ds9 skyview name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 skyview name clear<br> - </tt></tt> $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 skyview size 60 60 arcmin<br> - $xpaset -p ds9 skyview pixels 600 600<br> - $xpaset -p ds9 skyview save yes<br> - $xpaset -p ds9 skyview frame current<br> - $xpaset -p ds9 skyview update frame<br> - $xpaset -p ds9 skyview survey sdssi<br> - $xpaset -p ds9 skyview open<br> - </tt> <tt>$xpaset -p ds9 skyview close</tt><br> - <p><b><a name="sleep" id="sleep"></a>sleep</b></p> - <p>Delays execution for specified number of seconds. Default is 1 - second.<br> - </p> - <tt>Syntax:<br> - sleep [#]<br> - <br> - Example:<br> - $xpaset -p ds9 sleep<br> - $xpaset -p ds9 sleep 2<br> - </tt> - <p><b><a name="smooth" id="smooth"></a>smooth</b></p> - <p>Smooth current image or set smooth parameters.<br> - Boxcar width = <i>2*radius+1</i><br> - Tophat diameter = <i>2*radius+1</i><br> - Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> - Elliptical Gaussian diameter = <i>2*radius+1,</i> mean <i>=0<br> - </i> <br> - <tt>Syntax:</tt><br> - </p> - <tt>smooth []<br> - [yes|no]<br> - [function - boxcar|tophat|gaussian]<br> - </tt> <tt> [radius - <value>]<br> - </tt> <tt><tt><tt><tt> - [radiusminor <value>]<br> - </tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - [sigma <value>]<br> - </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - [sigmaminor <value>]<br> - </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt> -[angle - - - - - - - - - - - - - - <value>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt> <tt> - - - - - - - - - - - - - [match]<br> - [lock [yes|no]]</tt><br> - <tt><tt> [open|close]<br> - <br> - </tt> Example:<br> - $xpaget ds9 smooth<br> - $xpaget ds9 smooth function<br> - </tt> <tt><tt>$xpaget ds9 smooth radius<br> - </tt></tt> <tt><tt>$xpaget ds9 smooth radiusminor<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaget ds9 smooth sigma<br> - </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaget - - - - - - - - - - - - - ds9 smooth sigmaminor<br> - </tt></tt></tt></tt></tt></tt></tt></tt> $xpaget - ds9 smooth lock<br> - $xpaset -p ds9 smooth<br> - $xpaset -p ds9 smooth yes<br> - $xpaset -p ds9 smooth function tophat<br> - </tt> <tt><tt>$xpaset -p ds9 smooth radius 4<br> - </tt></tt> <tt><tt><tt><tt><tt><tt>$xpaset -p ds9 smooth - radiusminor 4<br> - </tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset - - - - - - - - - - - - - -p ds9 smooth sigma 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset - - - - - - - - - - - - - -p ds9 smooth sigmaminor 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt> <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>$xpaset - - - - - - - - - + <br> +Example:<br> +$xpaget ds9 rgbarray > foo.arr<br> +$xpaget ds9 rgbarray little > foo.arr<br> +$xpaset -p ds9 rgbarray +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> +$xpaset -p ds9 rgbarray new +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> +$cat foo.arr | xpaset ds9 rgbarray +[dim=512,zdim=3,bitpix=-32,endian=little]<br> +$cat foo.arr | xpaset ds9 rgbarray new +[dim=512,zdim=3,bitpix=-32,endian=little]</tt><br> +<p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> +<p>Load FITS rgbcube into rgb frame.<br></p> +<tt>Syntax:<br> +rgbcube [new] [<filename>]<br> +<br> +Example:<br> +$xpaget ds9 rgbcube > foo.fits<br> +$xpaset -p ds9 rgbcube foo.fits<br> +$xpaset -p ds9 rgbcube new foo.fits<br> +$cat foo.fits | xpaset ds9 rgbcube<br> +$cat foo.fits | xpaset ds9 rgbcubenew</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<br> +$xpaset -p ds9 rgbimage new foo.fits<br> +$cat foo.fits | xpaset ds9 rgbimage<br> +$cat foo.fits | xpaset ds9 rgbimage new<br></tt> +<p><b><a name="rotate" id="rotate"></a>rotate</b></p> +<p>Controls the rotation angle (in degrees) of the current +frame.</p> +<tt>Syntax:<br> +rotate [<value>]<br> + [to <value>]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 rotate<br> +$xpaset -p ds9 rotate 45<br> +$xpaset -p ds9 rotate to 30<br> +$xpaset -p ds9 rotate open<br> +$xpaset -p ds9 rotate close<br></tt> +<p><b><a name="save" id="save"></a>save<br></b></p> +<p>Save loaded image data of current frame as FITS.</p> +<tt>Syntax:<br> +save [fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice]<br> + <br> +Example:<br> +$xpaset -p ds9 save foo.fits<br> +$xpaset -p ds9 save fits foo.fits image<br> +$xpaset -p ds9 save fits foo.fits table<br> +$xpaset -p ds9 save fits foo.fits slice<br> +$xpaset -p ds9 save rgbimage foo.fits<br> +$xpaset -p ds9 save rgbcube foo.fits<br> +$xpaset -p ds9 save mecube foo.fits<br> +$xpaset -p ds9 save mosaic foo.fits<br> +$xpaset -p ds9 save mosaicimage foo.fits</tt><br> +<p><b><a name="saveimage" id="saveimage"></a>saveimage<br></b></p> +<p>Create a snap shot of the current DS9 window and save in +specified image format. If no format specified, the file name +extension is used to determine the output format. Optional +parameters: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> +compression method.</p> +<tt>Syntax:<br> +saveimage [fits|eps|gif|tiff|jpeg|png]<filename><br> +saveimage <filename>.jpeg [1-100]<br> +saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> +Example:<br> +$xpaset -p ds9 saveimage ds9.tiff<br> +$xpaset -p ds9 saveimage jpeg ds9.jpeg 75</tt><br> +<p><b><a name="scale" id="scale"></a>scale</b></p> +<p>Controls the limits and color scale distribution.</p> +<tt>Syntax:<br> +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [datasec yes|no]<br> + [limits <minvalue> <maxvalue>]<br> + [mode minmax|<value>|zscale|zmax]<br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 scale<br> +$xpaget ds9 scale log exp<br> +$xpaget ds9 scale datasec<br> +$xpaget ds9 scale limits<br> +$xpaget ds9 scale mode<br> +$xpaget ds9 scale scope<br> +$xpaget ds9 scale lock<br> +$xpaget ds9 scale lock limits<br> +$xpaset -p ds9 scale linear<br> +$xpaset -p ds9 scale log exp 100<br> +$xpaset -p ds9 scale datasec yes<br> +$xpaset -p ds9 scale histequ<br> +$xpaset -p ds9 scale limits 1 100<br> +$xpaset -p ds9 scale mode zscale<br> +$xpaset -p ds9 scale mode 99.5<br> +$xpaset -p ds9 scale scope local<br> +$xpaset -p ds9 scale match<br> +$xpaset -p ds9 scale match limits<br> +$xpaset -p ds9 scale lock yes<br> +$xpaset -p ds9 scale lock limits yes<br> +$xpaset -p ds9 scale open<br> +$xpaset -p ds9 scale close<br></tt> +<p><b><a name="shm" id="shm"></a>shm</b></p> +<p>Load a shared memory segment into the current frame.</p> +<tt>Syntax:<br> +shm [<key> [<filename>]]<br> + [key <key> [<filename>]]<br> + [shmid <id> [<filename>]]<br> + [fits [key|shmid] <id> +[<filename>]]<br> + [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] +[key|shmid] <id> [<filename>]]<br> + [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] +<id> [<filename>]]<br> + [rgbcube [key|shmid] <id> +[<filename>]<br> + [rgbimage [key|shmid] <id> +[<filename>]]<br> + [rgbarray [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> + [array [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - -p ds9 smooth angle 45<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> - $xpaset -p ds9 smooth match<br> - $xpaset -p ds9 smooth lock yes</tt><br> - <tt>$xpaset -p ds9 smooth open<br> - $xpaset -p ds9 smooth close<br> - </tt> - <p><b><a name="source" id="source"></a>source</b></p> - <p>Source TCL code from a file. Only available for <tt>XPA_METHOD - local.</tt></p> - <tt>Syntax:<br> - source [<filename>]<br> - <br> - Example:<br> - $xpaset -p ds9 source foo.tcl</tt> - <p><b><a name="tcl" id="tcl"></a>tcl</b></p> - <p>Execute one tcl command. Only available for <tt>XPA_METHOD - local.</tt></p> - <tt>Syntax:<br> - tcl [<tcl command>]<br> - <br> - Example:<br> - $echo 'puts "Hello, World"' | xpaset ds9 tcl<br> - $xpaset -p ds9 tcl {puts {Hello, World}}</tt><tt><br> - </tt> - <p><b><a name="threads" id="threads"></a>threads</b></p> - <p>Set number of process threads for functions which are - multi-threaded.<br> - </p> - <tt>Syntax:<br> - threads #<br> - <br> - Example:<br> - $xpaget ds9 threads<br> - $xpaset -p ds9 threads 8</tt><br> - <p><b><a name="tiff" id="tiff"></a>tiff</b></p> - <p>Load TIFF image into current frame. Optional parameters: <tt>tiff</tt> - compression method.</p> - <tt>Syntax:</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> - tile []<br> - [yes|no]<br> - [mode grid|column|row]<br> - [grid]<br> - [grid mode automatic|manual]<br> - [grid direction x|y]<br> - [grid layout <col> <row>]<br> - [grid gap <pixels>]<br> - [row]<br> - [column]<br> - <br> - Example:<br> - $xpaget ds9 tile<br> - $xpaget ds9 tile mode<br> - $xpaget ds9 tile grid mode<br> - $xpaget ds9 tile grid direction<br> - $xpaget ds9 tile grid layout<br> - $xpaget ds9 tile grid gap<br> - $xpaset -p ds9 tile<br> - $xpaset -p ds9 tile yes<br> - $xpaset -p ds9 tile mode row<br> - $xpaset -p ds9 tile grid<br> - $xpaset -p ds9 tile grid mode manual<br> - $xpaset -p ds9 tile grid direction x<br> - $xpaset -p ds9 tile grid layout 5 5<br> - $xpaset -p ds9 tile grid gap 10<br> - $xpaset -p ds9 tile row<br> - $xpaset -p ds9 tile column</tt> - <p><b><a name="update" id="update"></a>update</b></p> - <p>Updates the current frame or region of frame. In the second - form, the first argument is the number of the fits HDU (starting - with 1) and the remaining args are a bounding box in IMAGE - coordinates. By default, the screen is updated the next - available idle cycle. However, you may force an immediate update - by specifying the NOW option.</p> - <tt>Syntax:<br> - update []<br> - [# x1 y1 x2 y2]<br> - [now]<br> - [now # x1 y1 x2 y2]<br> - <br> - Example:<br> - $xpaset -p ds9 update<br> - $xpaset -p ds9 update 1 100 100 300 400<br> - $xpaset -p ds9 update now<br> - $xpaset -p ds9 update now 1 100 100 300 400</tt><br> - <p><b><a name="url" id="url"></a>url</b></p> - <p>Load FITS from URL into the current frame</p> - <tt>Syntax:<br> - url <url><br> - <br> - Example:<br> - $xpaset -p ds9 url http://foo.bar.edu/foo.fits<br> - </tt> - <p><b><a name="version" id="version"></a>version</b></p> - <p>Returns the current version of DS9.</p> - <tt>Syntax:<br> - version<br> - <br> - Example:<br> - $xpaget ds9 version</tt> - <p><b><a name="view" id="view"></a>view</b></p> - <p>Controls the GUI.</p> - <tt>Syntax:<br> - view [layout horizontal|vertical]<br> - [keyvalue <string>]<br> - [info yes|no]<br> - [panner yes|no]<br> - [magnifier yes|no]<br> - [buttons yes|no]<br> - [colorbar yes|no]<br> - [colorbar horizontal|vertical]<br> - [colorbar numerics yes|no]<br> - [graph horizontal|vertical - yes|no]<br> - [filename yes|no[<br> - [object yes|no]<br> - [keyword yes|no]<br> - [minmax yes|no]<br> - [lowhigh yes|no]<br> - [units yes|no]<br> - [image|physical|wcs|wcsa...wcsz - yes|no]<br> - </tt> <tt><tt><tt> [frame yes|no]<br> - </tt></tt> [red yes|no]<br> - [green yes|no]<br> - [blue yes|no]</tt><br> - <tt><tt> </tt><br> - Example:<br> - $xpaget ds9 view layout<br> - $xpaget ds9 view keyvalue<br> - $xpaget ds9 view info<br> - $xpaget ds9 view panner<br> - $xpaget ds9 view magnifier<br> - $xpaget ds9 view buttons<br> - $xpaget ds9 view colorbar<br> - $xpaget ds9 view graph horizontal<br> - $xpaget ds9 view filename<br> - $xpaget ds9 view object<br> - $xpaget ds9 view keyword<br> - $xpaget ds9 view minmax<br> - $xpaget ds9 view lowhigh<br> - $xpaget ds9 view units<br> - $xpaget ds9 view image<br> - $xpaget ds9 view wcsa</tt><br> - <tt>$xpaget ds9 view red<br> - </tt> <tt><tt><tt>$xpaget ds9 view frame<br> - </tt></tt> $xpaset -p ds9 view layout vertical<br> - $xpaset -p ds9 view keyvalue BITPIX<br> - $xpaset -p ds9 view info yes<br> - $xpaset -p ds9 view panner yes<br> - $xpaset -p ds9 view magnifier yes<br> - $xpaset -p ds9 view buttons yes<br> - $xpaset -p ds9 view colorbar yes<br> - $xpaset -p ds9 view graph horizontal yes<br> - $xpaset -p ds9 view filename yes<br> - $xpaset -p ds9 view object yes<br> - $xpaset -p ds9 view keyword yes<br> - $xpaset -p ds9 view minmax yes<br> - $xpaset -p ds9 view lowhigh yes<br> - $xpaset -p ds9 view units yes<br> - $xpaset -p ds9 view wcsa yes<br> - </tt> <tt><tt>$xpaset -p ds9 view frame yes</tt></tt><br> - <tt>$xpaset -p ds9 view red yes<br> - $xpaset -p ds9 view green yes<br> - $xpaset -p ds9 view blue yes</tt><br> - <br> - <b><a name="vla" id="vla"></a>vla</b> - <p>Support for VLA Sky Survey.</p> - <tt>Syntax:<br> - vla []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs - fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey first|stripe82]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 vla name<br> - $xpaget ds9 vla coord<br> - $xpaget ds9 vla size<br> - $xpaget ds9 vla save<br> - $xpaget ds9 vla frame<br> - $xpaget ds9 vla survey<br> - $xpaset -p ds9 vla<br> - $xpaset -p ds9 vla m31<br> - </tt> <tt><tt>$xpaset -p ds9 vla name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 vla name clear<br> - </tt></tt> $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 vla size 60 60 arcmin<br> - $xpaset -p ds9 vla save yes<br> - $xpaset -p ds9 vla frame current<br> - $xpaset -p ds9 vla update frame<br> - $xpaset -p ds9 vla survey stripe82<br> - $xpaset -p ds9 vla open<br> - </tt> <tt>$xpaset -p ds9 vla close<br> - </tt> - <p><b><a name="vlss" id="vlss"></a>vlss</b></p> - <p>Support for NRAO VLSS Sky Survey.</p> - <tt>Syntax:<br> - vlss []<br> - [<object>]<br> - [name <object>]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> - degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 vlss name<br> - $xpaget ds9 vlss coord<br> - $xpaget ds9 vlss size<br> - $xpaget ds9 vlss save<br> - $xpaget ds9 vlss frame<br> - $xpaset -p ds9 vlss<br> - $xpaset -p ds9 vlss m31<br> - </tt> <tt><tt>$xpaset -p ds9 vlss name m31<br> - </tt></tt> <tt><tt><tt>$xpaset -p ds9 vlss name clear<br> - </tt></tt> $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78<br> - $xpaset -p ds9 vlss size 60 60 arcmin<br> - $xpaset -p ds9 vlss save yes<br> - $xpaset -p ds9 vlss frame current<br> - $xpaset -p ds9 vlss update frame<br> - $xpaset -p ds9 vlss open<br> - </tt> <tt>$xpaset -p ds9 vlss close</tt><br> - <p><b><a name="vo" id="vo"></a>vo</b></p> - <p>Invoke an connection to a Virtual Observatory site.</p> - <tt>Syntax:<br> - vo [method xpa|mime]<br> - [server <url>]<br> - [internal yes|no]<br> - [delay #]<br> - [<url>]<br> - [connect <url>]<br> - [disconnect <url>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 vo<br> - $xpaget ds9 vo method<br> - $xpaget ds9 vo server<br> - $xpaget ds9 vo internal<br> - $xpaget ds9 vo delay<br> - $xpaget ds9 vo connect<br> - $xpaset -p ds9 vo method xpa<br> - $xpaset -p ds9 vo server http://foo.bar.edu/list.txt<br> - $xpaset -p ds9 vo internal yes<br> - $xpaset -p ds9 vo delay 15 # keep-alive delay<br> - $xpaset -p ds9 vo chandra-ed<br> - $xpaset -p ds9 vo connect chandra-ed<br> - $xpaset -p ds9 vo disconnect chandra-ed<br> - $xpaset -p ds9 vo open<br> - $xpaset -p ds9 vo close<br> - </tt> - <p><b><a name="wcs" id="wcs"></a>wcs</b></p> - <p>Controls the World Coordinate System for the current frame. If - the wcs system, skyframe, or skyformat is modified, the info - panel, compass, grid, and alignment will be modified - accordingly. Also, using this access point, a new WCS - specification can be loaded and used by the current image - regardless of the WCS that was contained in the image file. WCS - specification can be sent to DS9 as an ASCII file . Please see <a - href="file.html#WCS">WCS</a> for more information.</p> - <tt>Syntax:<br> - wcs [[system] wcs|wcsa...wcsz]<br> - [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> - [[skyformat] degrees|sexagesimal]<br> - [align yes|no]<br> - [reset [#]]<br> - [replace [#] <filename>]<br> - [append [#] <filename>]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 wcs<br> - $xpaget ds9 wcs system<br> - $xpaget ds9 wcs sky<br> - $xpaget ds9 wcs skyformat<br> - $xpaget ds9 wcs align<br> - $xpaset -p ds9 wcs wcs<br> - $xpaset -p ds9 wcs system wcs<br> - $xpaset -p ds9 wcs fk5<br> - </tt> <tt>$xpaset -p ds9 wcs sky fk5<br> - </tt> <tt>$xpaset -p ds9 wcs sexagesimal<br> - </tt> <tt>$xpaset -p ds9 wcs skyformat sexagesimal<br> - $xpaset -p ds9 wcs align yes<br> - $xpaset -p ds9 wcs reset<br> - $xpaset -p ds9 wcs reset 3<br> - $xpaset -p ds9 wcs replace foo.wcs<br> - $xpaset -p ds9 wcs replace 3 foo.wcs<br> - $xpaset -p ds9 wcs append foo.wcs<br> - $xpaset -p ds9 wcs append 3 foo.wcs<br> - $cat foo.wcs | xpaset ds9 wcs replace<br> - $cat foo.wcs | xpaset ds9 wcs append<br> - $echo "OBJECT = 'foobar'" | xpaset ds9 wcs append<br> - $xpaset -p ds9 open<br> - $xpaset -p ds9 close<br> - </tt> - <p><b><a name="web" id="web"></a>web</b></p> - <p>Display specified URL in the web display.</p> - <tt>Syntax:<br> - web []<br> - [<url>]<br> - [new <webname> <url>]<br> - [<webname>] [click - back|forward|stop|reload|#]<br> - [<webname>] [clear]<br> - [<webname>] [close]<br> - <br> - Example:<br> - $xpaget ds9 web<br> - $xpaset -p ds9 web www.cnn.com<br> - $xpaset -p ds9 web new www.cnn.com<br> - $xpaset -p ds9 web hvweb www.apple.com<br> - $xpaset -p ds9 web click back<br> - $xpaset -p ds9 web click 2<br> - $xpaset -p ds9 web clear<br> - $xpaset -p ds9 web close<br> - </tt> - <p><b><a name="width" id="width"></a>width</b></p> - <p>Set the width of the image display window.</p> - <tt>Syntax:<br> - width [<value>]<br> - <br> - Example:<br> - $xpaget ds9 width<br> - $xpaset -p ds9 width 512</tt><br> - <p><b><a name="xpa" id="xpa"></a>xpa</b></p> - <p>Configure XPA.</p> - <tt>Syntax:<br> - -xpa [disconnect]<br> - [info]<br> - <br> - Example:<br> - $xpaget ds9 info<br> - $xpaset -p ds9 disconnect<br> - $xpaset -p ds9 info<br> - </tt> - <p><b><a name="zscale" id="zscale"></a>zscale</b></p> - <p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> - <tt>Syntax:<br> - zscale []<br> - [contrast]<br> - [sample]<br> - [line]<br> - <br> - Example:<br> - $xpaget ds9 zscale contrast<br> - $xpaget ds9 zscale sample<br> - $xpaget ds9 zscale line<br> - $xpaset -p ds9 zscale<br> - $xpaset -p ds9 zscale contrast .25<br> - $xpaset -p ds9 zscale sample 600<br> - $xpaset -p ds9 zscale line 120<br> - </tt> - <p><b><a name="zoom" id="zoom"></a>zoom</b></p> - <p>Controls the current zoom value for the current frame.</p> - <tt>Syntax:<br> - zoom [<value>]<br> - [<value> <value>]<br> - [to <value>]<br> - [to <value> <value>]<br> - [in]<br> - [out]<br> - [to fit]<br> - [open|close]<br> - <br> - Example:<br> - $xpaget ds9 zoom<br> - $xpaset -p ds9 zoom 2<br> - $xpaset -p ds9 zoom 2 4<br> - $xpaset -p ds9 zoom to 4<br> - $xpaset -p ds9 zoom to 2 4<br> - $xpaset -p ds9 zoom in<br> - $xpaset -p ds9 zoom out<br> - $xpaset -p ds9 zoom to fit<br> - $xpaset -p ds9 zoom open<br> - $xpaset -p ds9 zoom close<br> - </tt></blockquote> - </body> + <br> +Example:<br> +$xpaget ds9 shm<br> +$xpaset -p ds9 shm 102<br> +$xpaset -p ds9 shm key 102<br> +$xpaset -p ds9 shm shmid 102 foo<br> +$xpaset -p ds9 shm fits key 100 foo<br> +$xpaset -p ds9 shm mosaicimage iraf key 100 foo<br> +$xpaset -p ds9 shm mosaicimage wcs key 100 foo<br> +$xpaset -p ds9 shm mosaicimage wcsa key 100 foo<br> +$xpaset -p ds9 shm mosaicimage wfpc2 key 100 foo<br> +$xpaset -p ds9 shm mosaic iraf key 100 foo<br> +$xpaset -p ds9 shm mosaic wcs key 100 foo<br> +$xpaset -p ds9 shm rgbcube key 100 foo<br> +$xpaset -p ds9 shm rgbimage key 100 foo<br> +$xpaset -p ds9 shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> +$xpaset -p ds9 shm array shmid 102 [dim=32,bitpix=-32]<br> +<br></tt> <b><a name="sia" id="sia"></a>sia<br></b> +<p>Support for VO Simple Image Access protocol. The first command +will create a new search. All other commands operated on the last +search created, unless indicated otherwise.</p> +<tt>Syntax:<br> +sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]<br> + [<ref>] [cancel]<br> + [<ref>] [clear]<br> + [<ref>] [close]<br> + [<ref>] [coordinate <ra> <dec> +<coordsys>]<br> + [<ref>] [crosshair]<br> + [<ref>] [export sb|tsv +<filename>]<br> + [<ref>] [name <object>]<br> + [<ref>] [print]<br> + [<ref>] [retrieve]<br> + [<ref>] [save <filename>]<br> + [<ref>] [radius <value> +degrees|arcmin|arcsec]<br> + [<ref>] [sky <skyframe>]<br> + [<ref>] [skyformat <skyformat>]<br> + [<ref>] [system <coordsys>]<br> + [<ref>] [update]<br> + <br> +Example:<br> +$xpaget ds9 sia<br> +<br> +$xpaset -p ds9 sia 2mass<br> +$xpaset -p ds9 sia cancel<br> +$xpaset -p ds9 sia clear<br> +$xpaset -p ds9 sia close<br> +$xpaset -p ds9 sia coordinate 202.48 47.21 fk5<br> +$xpaset -p ds9 sia crosshair<br> +$xpaset -p ds9 sia export tsv bar.tsv<br> +$xpaset -p ds9 sia name m51<br> +$xpaset -p ds9 sia print<br> +$xpaset -p ds9 sia retrieve<br> +$xpaset -p ds9 sia save foo.xml<br> +$xpaset -p ds9 sia radius 1 degrees<br> +$xpaset -p ds9 sia sky fk5<br> +$xpaset -p ds9 sia skyformat degrees<br> +$xpaset -p ds9 sia system wcs<br> +$xpaset -p ds9 sia update<br> +<br></tt> <b><a name="single" id="single"></a>single</b> +<p>Select Single Display mode</p> +<tt>Syntax:<br> +single<br> +<br> +Example:<br> +$xpaget ds9 single<br> +$xpaset -p ds9 single<br></tt> +<p><b><a name="skyview" id="skyview"></a>skyview</b></p> +<p>Support for SkyView image server at HEASARC.</p> +<tt>Syntax:<br> +skyview []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [pixels <width> <height>]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey <survey>]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 skyview name<br> +$xpaget ds9 skyview coord<br> +$xpaget ds9 skyview size<br> +$xpaget ds9 skyview pixels<br> +$xpaget ds9 skyview save<br> +$xpaget ds9 skyview frame<br> +$xpaget ds9 skyview survey<br> +$xpaset -p ds9 skyview<br> +$xpaset -p ds9 skyview m31<br> +$xpaset -p ds9 skyview name m31<br> +$xpaset -p ds9 skyview name clear<br> +$xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78<br> +$xpaset -p ds9 skyview size 60 60 arcmin<br> +$xpaset -p ds9 skyview pixels 600 600<br> +$xpaset -p ds9 skyview save yes<br> +$xpaset -p ds9 skyview frame current<br> +$xpaset -p ds9 skyview update frame<br> +$xpaset -p ds9 skyview survey sdssi<br> +$xpaset -p ds9 skyview open<br> +$xpaset -p ds9 skyview close</tt><br> +<p><b><a name="sleep" id="sleep"></a>sleep</b></p> +<p>Delays execution for specified number of seconds. Default is 1 +second.<br></p> +<tt>Syntax:<br> +sleep [#]<br> + <br> +Example:<br> +$xpaset -p ds9 sleep<br> +$xpaset -p ds9 sleep 2<br></tt> +<p><b><a name="smooth" id="smooth"></a>smooth</b></p> +<p>Smooth current image or set smooth parameters.<br> +Boxcar width = <i>2*radius+1</i><br> +Tophat diameter = <i>2*radius+1</i><br> +Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> +Elliptical Gaussian diameter = <i>2*radius+1,</i> mean +<i>=0<br></i><br> +<tt>Syntax:<br> +smooth []<br> + [yes|no]<br> + [function boxcar|tophat|gaussian]<br> + [radius <value>]<br> + [radiusminor <value>]<br> + [sigma <value>]<br> + [sigmaminor <value>]<br> + [angle <value>]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br></tt></p> +<p><tt>Example:<br> +$xpaget ds9 smooth<br> +$xpaget ds9 smooth function<br> +$xpaget ds9 smooth radius<br> +$xpaget ds9 smooth radiusminor<br> +$xpaget ds9 smooth sigma<br> +$xpaget ds9 smooth sigmaminor<br> +$xpaget ds9 smooth lock<br> +$xpaset -p ds9 smooth<br> +$xpaset -p ds9 smooth yes<br> +$xpaset -p ds9 smooth function tophat<br> +$xpaset -p ds9 smooth radius 4<br> +$xpaset -p ds9 smooth radiusminor 4<br> +$xpaset -p ds9 smooth sigma 2.0<br> +$xpaset -p ds9 smooth sigmaminor 2.0<br> +$xpaset -p ds9 smooth angle 45<br> +$xpaset -p ds9 smooth match<br> +$xpaset -p ds9 smooth lock yes<br> +$xpaset -p ds9 smooth open<br> +$xpaset -p ds9 smooth close</tt></p> +<p><b><a name="source" id="source"></a>source</b></p> +<p>Source TCL code from a file. Only available for <tt>XPA_METHOD +local.</tt></p> +<tt>Syntax:<br> +source [<filename>]<br> + <br> +Example:<br> +$xpaset -p ds9 source foo.tcl</tt> +<p><b><a name="tcl" id="tcl"></a>tcl</b></p> +<p>Execute one tcl command. Only available for <tt>XPA_METHOD +local.</tt></p> +<tt>Syntax:<br> +tcl [<tcl command>]<br> + <br> +Example:<br> +$echo 'puts "Hello, World"' | xpaset ds9 tcl<br> +$xpaset -p ds9 tcl {puts {Hello, World}}<br></tt> +<p><b><a name="threads" id="threads"></a>threads</b></p> +<p>Set number of process threads for functions which are +multi-threaded.<br></p> +<tt>Syntax:<br> +threads #<br> + <br> +Example:<br> +$xpaget ds9 threads<br> +$xpaset -p ds9 threads 8</tt><br> +<p><b><a name="tiff" id="tiff"></a>tiff</b></p> +<p>Load TIFF image into current frame. Optional parameters: +<tt>tiff</tt> compression method.</p> +<tt>Syntax:<br> +tiff [new|slice] [<filename>] +[none|jpeg|packbits|deflate]<br> + <br> +Example:<br> +$xpaget ds9 tiff > foo.tiff<br> +$xpaget ds9 tiff jpeg > foo.tiff<br> +$xpaset -p ds9 tiff foo.tiff<br> +$xpaset -p ds9 tiff new foo.tiff<br> +$xpaset -p ds9 tiff slice foo.tiff<br> +$cat foo.tiff | xpaset ds9 tiff# not available windows<br> +$cat foo.tiff | xpaset ds9 tiffnew# not available windows<br> +$cat foo.tiff | xpaset ds9 tiffslice# 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> +tile []<br> + [yes|no]<br> + [mode grid|column|row]<br> + [grid]<br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> <row>]<br> + [grid gap <pixels>]<br> + [row]<br> + [column]<br> + <br> +Example:<br> +$xpaget ds9 tile<br> +$xpaget ds9 tile mode<br> +$xpaget ds9 tile grid mode<br> +$xpaget ds9 tile grid direction<br> +$xpaget ds9 tile grid layout<br> +$xpaget ds9 tile grid gap<br> +$xpaset -p ds9 tile<br> +$xpaset -p ds9 tile yes<br> +$xpaset -p ds9 tile mode row<br> +$xpaset -p ds9 tile grid<br> +$xpaset -p ds9 tile grid mode manual<br> +$xpaset -p ds9 tile grid direction x<br> +$xpaset -p ds9 tile grid layout 5 5<br> +$xpaset -p ds9 tile grid gap 10<br> +$xpaset -p ds9 tile row<br> +$xpaset -p ds9 tile column</tt> +<p><b><a name="update" id="update"></a>update</b></p> +<p>Updates the current frame or region of frame. In the second +form, the first argument is the number of the fits HDU (starting +with 1) and the remaining args are a bounding box in IMAGE +coordinates. By default, the screen is updated the next available +idle cycle. However, you may force an immediate update by +specifying the NOW option.</p> +<tt>Syntax:<br> +update []<br> + [# x1 y1 x2 y2]<br> + [now]<br> + [now # x1 y1 x2 y2]<br> + <br> +Example:<br> +$xpaset -p ds9 update<br> +$xpaset -p ds9 update 1 100 100 300 400<br> +$xpaset -p ds9 update now<br> +$xpaset -p ds9 update now 1 100 100 300 400</tt><br> +<p><b><a name="url" id="url"></a>url</b></p> +<p>Load FITS from URL into the current frame</p> +<tt>Syntax:<br> +url <url><br> + <br> +Example:<br> +$xpaset -p ds9 url http://foo.bar.edu/foo.fits<br></tt> +<p><b><a name="version" id="version"></a>version</b></p> +<p>Returns the current version of DS9.</p> +<tt>Syntax:<br> +version<br> + <br> +Example:<br> +$xpaget ds9 version</tt> +<p><b><a name="view" id="view"></a>view</b></p> +<p>Controls the GUI.</p> +<tt>Syntax:<br> +view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no]<br> + [panner yes|no]<br> + [magnifier yes|no]<br> + [buttons yes|no]<br> + [colorbar yes|no]<br> + [colorbar horizontal|vertical]<br> + [colorbar numerics yes|no]<br> + [graph horizontal|vertical yes|no]<br> + [filename yes|no[<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz yes|no]<br> + [frame yes|no]<br> + [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]<br> + <br> +Example:<br> +$xpaget ds9 view layout<br> +$xpaget ds9 view keyvalue<br> +$xpaget ds9 view info<br> +$xpaget ds9 view panner<br> +$xpaget ds9 view magnifier<br> +$xpaget ds9 view buttons<br> +$xpaget ds9 view colorbar<br> +$xpaget ds9 view graph horizontal<br> +$xpaget ds9 view filename<br> +$xpaget ds9 view object<br> +$xpaget ds9 view keyword<br> +$xpaget ds9 view minmax<br> +$xpaget ds9 view lowhigh<br> +$xpaget ds9 view units<br> +$xpaget ds9 view image<br> +$xpaget ds9 view wcsa<br> +$xpaget ds9 view red<br> +$xpaget ds9 view frame<br> +$xpaset -p ds9 view layout vertical<br> +$xpaset -p ds9 view keyvalue BITPIX<br> +$xpaset -p ds9 view info yes<br> +$xpaset -p ds9 view panner yes<br> +$xpaset -p ds9 view magnifier yes<br> +$xpaset -p ds9 view buttons yes<br> +$xpaset -p ds9 view colorbar yes<br> +$xpaset -p ds9 view graph horizontal yes<br> +$xpaset -p ds9 view filename yes<br> +$xpaset -p ds9 view object yes<br> +$xpaset -p ds9 view keyword yes<br> +$xpaset -p ds9 view minmax yes<br> +$xpaset -p ds9 view lowhigh yes<br> +$xpaset -p ds9 view units yes<br> +$xpaset -p ds9 view wcsa yes<br> +$xpaset -p ds9 view frame yes<br> +$xpaset -p ds9 view red yes<br> +$xpaset -p ds9 view green yes<br> +$xpaset -p ds9 view blue yes</tt><br> +<br> +<b><a name="vla" id="vla"></a>vla</b> +<p>Support for VLA Sky Survey.</p> +<tt>Syntax:<br> +vla []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 vla name<br> +$xpaget ds9 vla coord<br> +$xpaget ds9 vla size<br> +$xpaget ds9 vla save<br> +$xpaget ds9 vla frame<br> +$xpaget ds9 vla survey<br> +$xpaset -p ds9 vla<br> +$xpaset -p ds9 vla m31<br> +$xpaset -p ds9 vla name m31<br> +$xpaset -p ds9 vla name clear<br> +$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> +$xpaset -p ds9 vla close</tt><br> +<p><b><a name="vlss" id="vlss"></a>vlss</b></p> +<p>Support for NRAO VLSS Sky Survey.</p> +<tt>Syntax:<br> +vlss []<br> + [<object>]<br> + [name <object>]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 vlss name<br> +$xpaget ds9 vlss coord<br> +$xpaget ds9 vlss size<br> +$xpaget ds9 vlss save<br> +$xpaget ds9 vlss frame<br> +$xpaset -p ds9 vlss<br> +$xpaset -p ds9 vlss m31<br> +$xpaset -p ds9 vlss name m31<br> +$xpaset -p ds9 vlss name clear<br> +$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> +$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> +vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 vo<br> +$xpaget ds9 vo method<br> +$xpaget ds9 vo server<br> +$xpaget ds9 vo internal<br> +$xpaget ds9 vo delay<br> +$xpaget ds9 vo connect<br> +$xpaset -p ds9 vo method xpa<br> +$xpaset -p ds9 vo server http://foo.bar.edu/list.txt<br> +$xpaset -p ds9 vo internal yes<br> +$xpaset -p ds9 vo delay 15 # keep-alive delay<br> +$xpaset -p ds9 vo chandra-ed<br> +$xpaset -p ds9 vo connect chandra-ed<br> +$xpaset -p ds9 vo disconnect chandra-ed<br> +$xpaset -p ds9 vo open<br> +$xpaset -p ds9 vo close<br></tt> +<p><b><a name="wcs" id="wcs"></a>wcs</b></p> +<p>Controls the World Coordinate System for the current frame. If +the wcs system, skyframe, or skyformat is modified, the info panel, +compass, grid, and alignment will be modified accordingly. Also, +using this access point, a new WCS specification can be loaded and +used by the current image regardless of the WCS that was contained +in the image file. WCS specification can be sent to DS9 as an ASCII +file . Please see <a href="file.html#WCS">WCS</a> for more +information.</p> +<tt>Syntax:<br> +wcs [[system] wcs|wcsa...wcsz]<br> + [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> + [[skyformat] degrees|sexagesimal]<br> + [align yes|no]<br> + [reset [#]]<br> + [replace [#] <filename>]<br> + [append [#] <filename>]<br> + [open|close]<br> +<br> +Example:<br> +$xpaget ds9 wcs<br> +$xpaget ds9 wcs system<br> +$xpaget ds9 wcs sky<br> +$xpaget ds9 wcs skyformat<br> +$xpaget ds9 wcs align<br> +$xpaset -p ds9 wcs wcs<br> +$xpaset -p ds9 wcs system wcs<br> +$xpaset -p ds9 wcs fk5<br> +$xpaset -p ds9 wcs sky fk5<br> +$xpaset -p ds9 wcs sexagesimal<br> +$xpaset -p ds9 wcs skyformat sexagesimal<br> +$xpaset -p ds9 wcs align yes<br> +$xpaset -p ds9 wcs reset<br> +$xpaset -p ds9 wcs reset 3<br> +$xpaset -p ds9 wcs replace foo.wcs<br> +$xpaset -p ds9 wcs replace 3 foo.wcs<br> +$xpaset -p ds9 wcs append foo.wcs<br> +$xpaset -p ds9 wcs append 3 foo.wcs<br> +$cat foo.wcs | xpaset ds9 wcs replace<br> +$cat foo.wcs | xpaset ds9 wcs append<br> +$echo "OBJECT = 'foobar'" | xpaset ds9 wcs append<br> +$xpaset -p ds9 open<br> +$xpaset -p ds9 close<br></tt> +<p><b><a name="web" id="web"></a>web</b></p> +<p>Display specified URL in the web display.</p> +<tt>Syntax:<br> +web []<br> + [<url>]<br> + [new <webname> <url>]<br> + [<webname>] [click +back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> +Example:<br> +$xpaget ds9 web<br> +$xpaset -p ds9 web www.cnn.com<br> +$xpaset -p ds9 web new www.cnn.com<br> +$xpaset -p ds9 web hvweb www.apple.com<br> +$xpaset -p ds9 web click back<br> +$xpaset -p ds9 web click 2<br> +$xpaset -p ds9 web clear<br> +$xpaset -p ds9 web close<br></tt> +<p><b><a name="width" id="width"></a>width</b></p> +<p>Set the width of the image display window.</p> +<tt>Syntax:<br> +width [<value>]<br> + <br> +Example:<br> +$xpaget ds9 width<br> +$xpaset -p ds9 width 512</tt><br> +<p><b><a name="xpa" id="xpa"></a>xpa</b></p> +<p>Configure XPA.</p> +<tt>Syntax:<br> +-xpa [disconnect]<br> + [info]<br> + <br> +Example:<br> +$xpaget ds9 info<br> +$xpaset -p ds9 disconnect<br> +$xpaset -p ds9 info<br></tt> +<p><b><a name="zscale" id="zscale"></a>zscale</b></p> +<p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> +<tt>Syntax:<br> +zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> +Example:<br> +$xpaget ds9 zscale contrast<br> +$xpaget ds9 zscale sample<br> +$xpaget ds9 zscale line<br> +$xpaset -p ds9 zscale<br> +$xpaset -p ds9 zscale contrast .25<br> +$xpaset -p ds9 zscale sample 600<br> +$xpaset -p ds9 zscale line 120<br></tt> +<p><b><a name="zoom" id="zoom"></a>zoom</b></p> +<p>Controls the current zoom value for the current frame.</p> +<tt>Syntax:<br> +zoom [<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [open|close]<br> + <br> +Example:<br> +$xpaget ds9 zoom<br> +$xpaset -p ds9 zoom 2<br> +$xpaset -p ds9 zoom 2 4<br> +$xpaset -p ds9 zoom to 4<br> +$xpaset -p ds9 zoom to 2 4<br> +$xpaset -p ds9 zoom in<br> +$xpaset -p ds9 zoom out<br> +$xpaset -p ds9 zoom to fit<br> +$xpaset -p ds9 zoom open<br> +$xpaset -p ds9 zoom close<br></tt></blockquote> +</body> </html> |