diff options
Diffstat (limited to 'ds9/doc/ref/samp.html')
-rw-r--r-- | ds9/doc/ref/samp.html | 6367 |
1 files changed, 6367 insertions, 0 deletions
diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html new file mode 100644 index 0000000..485d76e --- /dev/null +++ b/ds9/doc/ref/samp.html @@ -0,0 +1,6367 @@ +<!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en"> +<html> + <head> + <meta http-equiv="Content-Type" content="text/html; + charset=windows-1252"> + <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux + 2.4.7-10 i686) [Netscape]"> + <title>SAMP</title> + </head> + <body alink="#ff0000" link="#0000ff" vlink="#551a8b"> + <h3><img alt="" src="../sun.gif" align="middle" height="98" + width="100"> SAMP</h3> + <blockquote> + <p>SAMP is a messaging protocol that enables astronomy software + tools to interoperate and communicate. Broadly speaking, SAMP is + an abstract framework for loosely-coupled, asynchronous, + RPC-like and/or event-based communication, based on a central + service providing multi-directional publish/subscribe message + brokering. The message semantics are extensible and use + structured but weakly-typed data. For more information on SAMP, + please click <a + href="http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> + <p>The samp implementation for DS9 is based on the <a + href="xpa.html">XPA</a> model with 2 private calls:</p> + <tt> ds9.get<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK (samp.result map)<br> + value + (string) optional<br> + + url (string) optional<br> + ERROR (samp.error map)<br> + + samp.errortxt (string)<br> + <br> + ds9.set<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK<br> + ERROR (samp.error map)<br> + + samp.errortxt (string)<br> + </tt> + <p><tt>ds9.set</tt> maybe called via notification, call and + call/wait. <tt>ds9.get</tt> can only be called via call and + call/wait. Most of the <tt>ds9.get</tt> calls return a value + string, but a few will return a url instead.</p> + <tt> <a href="#2mass">2mass</a><br> + <a href="#3d">3d</a><br> + <a href="#about">about</a><br> + <a href="#analysis">analysis</a><br> + <a href="#array">array</a><br> + <a href="#background">background</a><br> + <a href="#backup">backup</a><br> + <a href="#bin">bin</a><br> + <a href="#blink">blink</a><br> + <a href="#block">block</a><br> + <a href="#catalog">catalog</a><br> + <a href="#cd">cd</a><br> + <a href="#cmap">cmap</a><br> + <a href="#colorbar">colorbar</a><br> + <a href="#console">console</a><br> + <a href="#contour">contour</a><br> + <a href="#crop">crop</a><br> + <a href="#crosshair">crosshair</a><br> + <a href="#cube">cube</a><br> + <a href="#cursor">cursor</a><br> + <a href="#data">data</a><br> + <a href="#dsssao">dsssao</a><br> + <a href="#dsseso">dsseso</a><br> + <a href="#dssstsci">dssstsci</a><br> + <a href="#envi">envi</a><br> + <a href="#exit">exit</a><br> + <a href="#export">export</a><br> + <a href="#file">file</a><br> + <a href="#fits">fits</a><br> + <a href="#frame">frame</a><br> + <a href="#gif">gif</a><br> + <a href="#grid">grid</a><br> + <a href="#header">header</a><br> + <a href="#height">height</a><br> + <a href="#iconify">iconify</a><br> + </tt><tt><tt><a href="#iexam">iexam</a><br> + </tt><a href="#iis">iis</a><br> + <a href="#jpeg">jpeg</a><br> + <a href="#lock">lock</a><br> + <a href="#lower">lower</a><br> + <a href="#magnifier">magnifier</a><br> + <a href="#mask">mask</a><br> + <a href="#match">match</a><br> + <a href="#mecube">mecube</a><br> + <a href="#minmax">minmax</a><br> + <a href="#mode">mode</a><br> + <a href="#mosaic">mosaic</a><br> + <a href="#mosaicimage">mosaicimage</a><br> + <a href="#movie">movie</a><br> + <a href="#multiframe">multiframe</a><br> + <a href="#nameserver">nameserver</a><br> + <a href="#nan">nan</a><br> + <a href="#nrrd">nrrd</a><br> + <a href="#nvss">nvss</a><br> + <a href="#orient">orient</a><br> + <a href="#pagesetup">pagesetup</a><br> + <a href="#pan">pan</a><br> + <a href="#pixeltable">pixeltable</a><br> + <a href="#plot">plot</a><br> + <a href="#png">png</a><br> + <a href="#prefs">prefs</a><br> + <a href="#preserve">preserve</a><br> + <a href="#psprint">psprint</a><br> + <a href="#print">print</a><br> + <a href="#exit">quit</a><br> + <a href="#raise">raise</a><br> + <a href="#regions">regions</a><br> + <a href="#restore">restore</a><br> + <a href="#rgb">rgb</a><br> + <a href="#rgbarray">rgbarray</a><br> + <a href="#rgbcube">rgbcube</a><br> + <a href="#rgbimage">rgbimage</a><br> + <a href="#rotate">rotate</a><br> + <a href="#samp">samp</a><br> + <a href="#save">save</a><br> + <a href="#saveimage">saveimage</a><br> + <a href="#scale">scale</a><br> + <a href="#shm">shm</a><br> + </tt><tt><tt><a href="#sia">sia</a><br> + </tt><a href="#single">single</a><br> + <a href="#skyview">skyview</a><br> + <a href="#sleep">sleep</a><br> + <a href="#smooth">smooth</a><br> + <a href="#source">source</a><br> + <a href="#tcl">tcl</a><br> + <a href="#threads">threads</a><br> + <a href="#tiff">tiff</a><br> + <a href="#tile">tile</a><br> + <a href="#update">update</a><br> + <a href="#url">url</a><br> + <a href="#version">version</a><br> + <a href="#view">view</a><br> + <a href="#vla">vla</a></tt><br> + <tt><tt><a href="#vlss">vlss</a><br> + </tt> <a href="#vo">vo</a><br> + <a href="#wcs">wcs</a><br> + <a href="#web">web</a><br> + <a href="#width">width</a><br> + <a href="#zscale">zscale</a><br> + <a href="#zoom">zoom</a><br> + </tt> + <p><b> <a name="2mass"></a>2mass</b></p> + <p>Support for 2MASS Digital Sky Survey.</p> + <tt> Syntax: <br> + 2mass []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> <dec> + degrees|sexagesimal] # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + 2mass name <br> + 2mass coord <br> + 2mass size<br> + 2mass save<br> + 2mass frame<br> + 2mass survey <br> + ds9.set(string cmd)<br> + 2mass<br> + 2mass m31 <br> + 2mass name m31 <br> + 2mass coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + 2mass size 60 60 arcmin<br> + 2mass save yes<br> + 2mass frame current<br> + 2mass update frame<br> + 2mass survey j<br> + 2mass open<br> + 2mass close<br> + </tt> + <p><b> <a name="3d"></a>3d</b></p> + <p>Support for 3D frame.</p> + <tt> Syntax: <br> + </tt><tt>3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]</tt><br> + <tt><tt> [background none|azimuth|elevation]<br> + </tt> </tt><tt> [border yes|no]<br> + [border color <color>]<br> + </tt><tt> [highlite yes|no]<br> + [hightlite color <color>]<br> + </tt><tt> [open|close]</tt><tt><br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt><tt>3d view<br> + 3d az<br> + 3d el<br> + 3d scale<br> + 3d method</tt><br> + <tt>3d background<br> + </tt><tt>3d border<br> + 3d border color<br> + </tt> <tt> </tt><tt>3d highlite<br> + 3d highlite color<br> + </tt> <tt> ds9.set(string cmd)<br> + </tt><tt>3d # create new 3D frame<br> + 3d view 45 30<br> + 3d az 45<br> + 3d el 30<br> + 3d scale 10<br> + 3d method mip</tt><br> + <tt>3d background azimuth<br> + </tt><tt>3d border yes<br> + 3d border color red<br> + </tt><tt>3d highlite yes<br> + 3d highlite color red<br> + 3d open<br> + 3d close</tt><br> + <p><b><a name="about"></a>about</b></p> + <p>Get DS9 credits.</p> + <tt> Syntax: <br> + about <br> + <br> + Example:<br> + string value = ds9.get(string cmd) <br> + about<br> + </tt> + <p><b> <a name="align"></a>align</b></p> + <p>Controls the World Coordinate System alignment for the current + frame.</p> + <tt> Syntax: <br> + align []<br> + [yes|no]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd) <br> + </tt>align<br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>align yes</tt><br> + <p><b> <a name="analysis"></a>analysis</b></p> + <p>Control external analysis tasks. Tasks are numbered as they are + loaded, starting with 0. Can also be used to display a message + and display text in the text dialog window. </p> + <tt> Syntax: <br> + analysis [<task number>]<br> + + [<filename>]<br> + [task <task + number>|<task name>]<br> + [load + <filename>]<br> + [clear]<br> + [clear][load + <filename>]<br> + [message + ok|okcancel|yesno <message>]<br> + [entry + <message>]<br> + [text]</tt><tt><tt><tt><tt><tt><br> + </tt></tt> </tt></tt> <br> + Example:<br> + string value = ds9.get(string cmd) <br> + analysis<br> + analysis task<br> + analysis entry Please enter something<br> + analysis entry okcancel Please enter something<br> + ds9.set(string cmd)<br> + analysis 0 # invoke first analysis task<br> + analysis task 0<br> + analysis task foobar<br> + analysis task {foo bar}<br> + analysis my.ans<br> + analysis load my.ans <br> + analysis clear <br> + analysis clear load my.ans<br> + analysis message ok {This is a message}<br> + analysis text {this is text}</tt><tt><tt><br> + </tt> ds9.set(string cmd, string url)<br> + analysis load <br> + analysis text</tt><b><br> + </b> + <p><b> <a name="array"></a>array</b></p> + <p>Load raw data array into current frame.<br> + </p> + <tt> Syntax:<br> + array [native|big|little]<br> + array [new|mask] +[[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> + <br> + Example: <br> + </tt><tt><tt>string url = ds9.get(string cmd)<br> + </tt>array<br> + array little<br> + </tt><tt><tt>ds9.set(string command, string url)<br> + </tt>array foo.arr[dim=512,bitpix=-32,endian=little]<br> + array new foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> + <tt><tt>array mask foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> + </tt> + <p><b> <a name="background"></a>bg<br> + background</b></p> + <p>Set image background color. </p> + <tt> Syntax: <br> + bg <color><br> + <br> + Example:<br> + </tt><tt>string url = ds9.get(string cmd)</tt><tt><br> + bg<br> + </tt><tt>ds9.set(string cmd)<br> + </tt><tt>bg red</tt><tt><br> + <tt>bg red</tt></tt><br> + <p><b> <a name="backup"></a>backup</b></p> + <p>Create a backup save set. </p> + <tt> Syntax: <br> + backup <filename><br> + <br> + Example:<br> + </tt><tt>ds9.set(string cmd)<br> + </tt><tt>backup ds9.bck</tt><br> + <p><b> <a name="bin"></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> + [function average|sum] <br> + [in]<br> + [out]<br> + [to fit] <br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd) <br> + bin about<br> + bin buffersize<br> + bin cols<br> + bin factor<br> + bin depth<br> + bin filter<br> + bin function<br> + bin smooth<br> + bin smooth function<br> + bin smooth radius<br> + bin lock<br> + ds9.set(string cmd)<br> + bin about 4096 4096<br> + bin about center<br> + bin buffersize 512<br> + bin cols detx dety<br> + bin colsz detx dety time<br> + bin factor 4<br> + bin factor 4 2<br> + bin depth 10<br> + bin filter 'pha > 5'<br> + bin filter ''<br> + bin function sum<br> + bin in<br> + bin out<br> + bin to fit<br> + bin match<br> + bin lock yes<br> + bin open<br> + bin close<br> + </tt> + <p><b> <a name="blink"></a>blink</b></p> + <p>Blink mode parameters. Interval is in seconds. <br> + </p> + <tt> Syntax: <br> + blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + blink<br> + blink interval<br> + ds9.set(string cmd)<br> + blink<br> + blink yes<br> + blink interval 1</tt><br> + <p><b> <a name="block"></a>block</b></p> + <p>Controls blocking parameters. </p> + <tt> Syntax: <br> + block</tt><tt><tt> [<value>] <br> + [<value> <value>]<br> + [to <value>] <br> + [to <value> + <value>]<br> + [in]<br> + [out]<br> + </tt> [to fit] <br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>block<br> + block lock<br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt></tt><tt><tt><tt>block</tt></tt> 4<br> + </tt><tt><tt><tt>block</tt></tt> 4 2<br> + </tt><tt><tt><tt><tt><tt>block</tt></tt> to 4<br> + </tt><tt><tt><tt>block</tt></tt> to 4 2<br> + </tt></tt><tt><tt><tt>block</tt></tt> in<br> + </tt></tt><tt><tt><tt><tt><tt>block</tt></tt> out<br> + </tt></tt></tt><tt><tt><tt>block</tt></tt> to fit<br> + </tt><tt><tt><tt>block</tt></tt> match<br> + </tt><tt><tt><tt>block</tt></tt> lock yes<br> + </tt><tt><tt><tt>block</tt></tt> open<br> + </tt><tt><tt><tt>block</tt></tt> close</tt><tt><br> + </tt> + <p><b> <a name="catalog"></a>catalog<br> + cat<br> + </b></p> + <p>Support for catalogs. The first three commands will create a + new catalog search. All other commands operated on the last + search created, unless indicated otherwise.</p> + <tt> Syntax:<br> + </tt><tt>catalog []<br> + + [ned|simbad|denis|skybot]<br> + + [ascss|cmc|gsc1|gsc2|gsc3|ac|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>tycho|ua2|ub1|ucac2]<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> [<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> [<ref>] + [coordinate <ra> <dec> <coordsys>]</tt><tt><br> + </tt><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>] [hide]</tt><br> + <tt> [<ref>] [location + <code>]</tt><br> + <tt> [<ref>] + [match <ref> <ref>]<br> + </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [match error <value> degrees|arcmin|arcsec]</tt><br> + <tt> </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [match function 1and2|1not2|2not1]<br> + </tt><tt> </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [match return 1and2|1only|2only]</tt><br> + <tt> </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [match unique yes|no]</tt><br> + <tt> [<ref>] [maxrows + <number>]</tt><br> + <tt> [<ref>] [name + <object>]<br> + </tt><tt> [<ref>] + [panto yes|no]</tt><br> + <tt> [<ref>] [plot + <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> + <tt> [<ref>] [print]</tt><br> + <tt> [<ref>] [psky + <skyframe>]</tt><br> + <tt> [<ref>] [psystem + <coordsys>]</tt><br> + <tt> [<ref>] [ra + <col>]</tt><br> + <tt> [<ref>] [regions]</tt><br> + <tt> </tt><tt><tt> + [<ref>] [retrieve]</tt><br> + <tt> </tt> [<ref>] + [samp]<br> + [<ref>] [samp + broadcast]<br> + [<ref>] [samp + send <application>]</tt><tt><br> + </tt><tt> [<ref>] + [save <filename>]</tt><br> + <tt> [<ref>] + [server cds|sao|cadc|adac|iucaa|bejing|cambridge|ukirt]</tt><br> + <tt> [<ref>] [show]</tt><br> + <tt> [<ref>] [size + <width> <height> degrees|arcmin|arcsec]</tt><br> + <tt> </tt><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 point}|{box point}|{diamond point}|<br> + + {cross point}|{x point}|{arrow + point}|{boxcircle point}|<br> + + circle|ellipse|box|text]<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> + string value = ds9.get(string cmd) <br> + catalog<br> + catalog header<br> + <br> + ds9.set(string cmd)<br> + </tt><tt>catalog<br> + catalog 2mass<br> + catalog cds 2mass<br> + catalog cds </tt><tt>{I/252}</tt><br> + <tt> <br> + </tt><tt>catalog load foo.xml<br> + catalog import tsv foo.tsv<br> + <br> + </tt><tt>catalog allrows<br> + catalog allcols<br> + </tt><tt>catalog cancel<br> + </tt><tt>catalog clear<br> + </tt><tt>catalog close<br> + </tt><tt>catalog coordinate 202.48 47.21 fk5<br> + </tt><tt>catalog crosshair<br> + </tt><tt>catalog dec DEC<br> + </tt><tt>catalog edit yes<br> + </tt><tt>catalog export tsv bar.tsv<br> + </tt><tt>catalog filter {$Jmag>10}<br> + catalog filter load foo.flt<br> + catalog header<br> + </tt><tt>catalog hide<br> + </tt><tt>catalog location 500</tt><br> + <tt>catalog match error 2 arcsec<br> + catalog match function 1and2<br> + catalog match unique no<br> + catalog match return 1only<br> + catalog match 2mass csc<br> + </tt><tt>catalog maxrows 2000<br> + </tt><tt>catalog name m51<br> + catalog panto no<br> + </tt><tt>catalog plot </tt><tt>{$Jmag} {$Hmag} {$e_Jmag} + {$e_Hmag}</tt><tt><br> + </tt><tt>catalog print</tt><br> + <tt>catalog psky fk5</tt><br> + <tt>catalog psystem wcs</tt><br> + <tt>catalog ra RA</tt><br> + <tt>catalog regions<br> + </tt><tt>catalog retrieve<br> + </tt><tt> </tt><tt>catalog samp broadcast<br> + catalog samp send aladin<br> + catalog save foo.xml<br> + </tt><tt>catalog server sao<br> + </tt><tt>catalog show</tt><br> + <tt> catalog size 1 1 degrees</tt><br> + <tt>catalog symbol condition </tt><tt>{$Jmag>15}</tt><br> + <tt> catalog symbol 2 shape </tt><tt>{boxcircle point}</tt><br> + <tt> catalog symbol color red<br> + catalog symbol font times<br> + </tt><tt>catalog symbol fontsize 14<br> + </tt><tt>catalog symbol fontweight bold<br> + </tt><tt>catalog symbol fontslant italic<br> + </tt><tt>catalog symbol add<br> + catalog symbol 2 remove<br> + catalog symbol load foo.sym<br> + catalog symbol save bar.sym</tt><tt><br> + catalog sky fk5<br> + catalog skyformat degrees<br> + </tt><tt>catalog sort {Jmag} incr<br> + </tt><tt>catalog system wcs</tt><tt><br> + </tt><tt>catalog update<br> + </tt><tt>catalog x RA<br> + catalog y DEC</tt><br> + <p><b><a name="cd"></a>cd</b></p> + <p>Sets/Returns the current working directory. </p> + <tt> Syntax: <br> + cd [<directory>] <br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + cd<br> + ds9.set(string cmd)<br> + cd /home/mrbill<br> + </tt> + <p><b> <a name="cmap"></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> + [value <constrast> <bias>] + <br> + </tt><tt> [tag [load|save] + <filename>]<br> + [tag delete]</tt><br> + <tt> [match]<br> + [lock [yes|no]]</tt><br> + <tt> [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + cmap <br> + cmap file <br> + cmap invert <br> + cmap value <br> + </tt><tt>cmap lock</tt><br> + <tt> ds9.set(string cmd)<br> + cmap Heat <br> + cmap load foo.sao <br> + cmap save bar.sao<br> + cmap invert yes <br> + cmap value 5 .5<br> + </tt><tt>cmap tag load foo.tag<br> + cmap tag save foo.tag<br> + cmap tag delete</tt><br> + <tt>cmap match<br> + cmap lock yes</tt><br> + <tt> cmap open<br> + cmap close<br> + </tt> + <p><b><a name="colorbar"></a>colorbar</b></p> + <p>Controls colorbar parameters.</p> + <tt> Syntax: <br> + colorbar []<br> + [yes|no]<br> + + [horizontal|vertical]<br> + [orientation + 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> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + colorbar<br> + colorbar orientation<br> + colorbar numerics<br> + colorbar space<br> + colorbar font<br> + colorbar fontsize<br> + colorbar fontweight<br> + colorbar fontslant<br> + colorbar size<br> + colorbar ticks<br> + ds9.set(string cmd)<br> + colorbar yes<br> + colorbar vertical<br> + colorbar orientation vertical<br> + colorbar numerics yes<br> + colorbar space value<br> + colorbar font times<br> + colorbar fontsize 14<br> + colorbar fontwieght bold<br> + colorbar fontslant italic<br> + colorbar size 20<br> + colorbar ticks 11<br> + </tt> + <p><b> <a name="console"></a>console</b></p> + <p>Display tcl console window.</p> + <tt> Syntax: <br> + -console<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + console<br> + </tt> + <p><b> <a name="contour"></a>contour</b></p> + <p>Controls contours in the current frame. </p> + <tt> Syntax: <br> + contour []<br> + [yes|no]<br> + [<coordsys> + [<skyframe>]]<br> + [clear]<br> + [generate]<br> + [load + <filename> [<color> <width> yes|no]]<br> + [save <filename> + <coordsys> <skyframe>]<br> + [convert]<br> + </tt><tt><tt> + [loadlevels <filename>]<br> + </tt></tt><tt><tt><tt> + [savelevels <filename>]<br> + </tt></tt> [copy]<br> + [paste + <coordsys> [<color> <width> yes|no]]<br> + [color <color>]<br> + [width <width>]<br> + [dash yes|no]<br> + [smooth <smooth>]<br> + [method block|smooth]<br> + [nlevels <number of + levels>]<br> + [scale + linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + ]scale log exp + <value>]<br> + [mode + minmax|<value>|zscale|zmax]<br> + [limits <min> + <max>]<br> + [levels <value + value value...>] <br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + contour<br> + contour color<br> + contour width<br> + contour dash<br> + contour smooth<br> + contour method<br> + contour nlevels<br> + contour scale<br> + contour log exp<br> + contour mode<br> + contour limits<br> + contour levels<br> + string url = ds9.get(string cmd)<br> + contour wcs fk5<br> + ds9.set(string cmd)<br> + contour<br> + contour yes<br> + contour clear<br> + contour generate<br> + contour load ds9.ctr<br> + contour load ds9.ctr red 2 yes<br> + contour save ds9.con wcs fk5<br> + contour convert<br> + </tt><tt><tt>contour loadlevels ds9.ctr<br> + </tt></tt><tt><tt><tt>contour savelevels ds9.lev<br> + </tt></tt>contour copy<br> + contour paste wcs red 2 no<br> + contour color yellow<br> + contour width 2<br> + contour dash yes<br> + contour smooth 5<br> + contour method smooth<br> + contour nlevels 10<br> + contour scale sqrt<br> + contour log exp 1000<br> + contour mode zscale<br> + contour limits 1 100<br> + contour levels "{1 10 100 1000}"<br> + contour open<br> + contour close<br> + </tt> + <p><b><a name="crop"></a>crop</b> </p> + <p>Set current image display area. </p> + <tt> Syntax: <br> + crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][<skyformat>][degrees|arcmin|arcsec]<br> + </tt><tt> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><tt><br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + </tt><tt>crop # get crop in physical coords <br> + </tt><tt>crop wcs galactic sexagesimal arcsec<br> + crop lock<br> + </tt><tt>ds9.set(string cmd)</tt><br> + <tt> crop 40 30 10 20 # set crop in physical coords<br> + crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs + galactic arcsec<br> + crop match wcs<br> + crop lock wcs</tt><br> + <p><b> <a name="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>][<skyformat>]] <br> + </tt><tt> + [match <coordsys>]<br> + [lock + <coordsys>|none]</tt><br> + <tt> <br> + Example:<br> + string value = ds9.get(string cmd)<br> + crosshair # get crosshair in physical coords <br> + crosshair wcs fk4 sexagesimal # get crosshair in wcs coords <br> + crosshair lock<br> + ds9.set(string cmd)<br> + crosshair 100 100 physical # set crosshair in physical <br> + crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords <br> + crosshair 23:01:00 +58:52:51 wcs fk5<br> + crosshair match wcs<br> + crosshair lock wcs<br> + </tt> + <p><b><a name="cube"></a>cube<br> + </b></p> + <p>Controls FITS cube. </p> + <tt> Syntax: <br> + cube [play|stop|next|prev|first|last]<br> + [<slice> + [<coordsys>][<axis>]]<br> + [interval <numeric>]<br> + [axis <axis>]<br> + </tt><tt> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><br> + <tt> [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]</tt><br> + <tt> [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + cube<br> + cube interval<br> + cube lock<br> + cube order<br> + cube axes lock<br> + ds9.set(string cmd)<br> + cube play<br> + cube last<br> + cube 3<br> + cube 4.5 wcs 3<br> + cube interval 2<br> + cube axis 3<br> + cube match wcs<br> + cube lock wcs<br> + cube order 123<br> + cube axes lock yes<br> + cube open<br> + cube close</tt><br> + <p><b> <a name="cursor"></a>cursor</b></p> + <p>Move mouse pointer or crosshair in image pixels in the current + frame. Note, this will move selected Regions also. </p> + <tt> Syntax: <br> + cursor [<x> <y>] <br> + <br> + Example:<br> + ds9.set(string cmd)<br> + cursor 10 10<br> + </tt> + <p><b><a name="data"></a>data</b></p> + <p>Return an array of data values given a lower left corner and a + width and height in specified coordinate system. The last + argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes.<br> + </p> + <tt> Syntax: <br> + data [<coordsys> [<skyframe>] <x> <y> + <width> <height> [yes|no]]<br> + <br> + Example:<br> + string url = ds9.get(string cmd) <br> + data image 450 520 3 3 yes<br> + data physical 899 1039 6 6 no<br> + data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> + data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 + 0.00016516669 no</tt><tt><br> + </tt> + <p><b> <a name="dsssao"></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>]<br> + [coord <ra> + <dec> degrees|sexagesimal] # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dsssao name <br> + dsssao coord <br> + dsssao size<br> + dsssao save<br> + dsssao frame<br> + ds9.set(string cmd)<br> + dsssao<br> + dsssao m31 <br> + dsssao name m31 <br> + dsssao coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + dsssao size 60 60 arcmin<br> + dsssao save yes<br> + dsssao frame current<br> + dsssao update frame<br> + dsssao open<br> + dsssao close<br> + </tt> + <p><b> <a name="dsseso"></a>dsseso</b></p> + <p>Support for Digital Sky Survey at ESO. </p> + <tt> Syntax:<br> + dsseso []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> + <dec> degrees|sexagesimal] # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey + DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dsseso name <br> + dsseso coord <br> + dsseso size<br> + dsseso save<br> + dsseso frame<br> + dsseso survey<br> + ds9.set(string cmd)<br> + dsseso<br> + dsseso m31 <br> + dsseso name m31 <br> + dsseso coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + dsseso size 60 60 arcmin<br> + dsseso save yes<br> + dsseso frame current<br> + dsseso update frame<br> + dsseso survey DSS2-red <br> + dsseso open<br> + dsseso close<br> + </tt> + <p><b> <a name="dssstsci"></a>dssstsci</b></p> + <p>Support for Digital Sky Survey at STSCI.</p> + <tt> Syntax:<br> + dssstsci []<br> + [<object>]<br> + [name <object>]<br> + [coord + <ra> <dec> degrees|sexagesimal] # in wcs fk5<br> + [size + <width> <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame + new|current]<br> + [update + frame|crosshair]<br> + [survey + poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] <br> + [survey + poss1_blue|poss1_red]<br> + [survey + all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + dssstsci name <br> + dssstsci coord <br> + dssstsci size<br> + dssstsci save<br> + dssstsci frame<br> + dssstsci survey<br> + ds9.set(string cmd)<br> + dssstsci<br> + dssstsci m31 <br> + dssstsci name m31 <br> + dssstsci coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + dssstsci size 60 60 arcmin<br> + dssstsci save yes<br> + dssstsci frame current<br> + dssstsci update frame<br> + dssstsci survey all<br> + dssstsci open<br> + dssstsci close</tt><br> + <p><b> <a name="envi"></a>envi</b></p> + <p>Load an ENVI header and file. Optional parameter: array endian.<br> + </p> + <tt> Syntax: <br> + envi <header> [<filename>]<br> + <br> + Example:<br> + </tt><tt><tt>envi foo.hdr</tt></tt><br> + <tt><tt><tt><tt><tt><tt>envi foo.hdr foo.bsq</tt></tt><br> + envi new foo.hdr foo.bsq</tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><br> + </tt></tt></tt></tt></tt></tt> + <p><b> <a name="exit"></a>exit<br> + quit<br> + </b></p> + <p>Quits DS9. </p> + <tt> Syntax: <br> + exit<br> + quit<br> + <br> + Example:<br> + ds9.set(string cmd)<br> + exit</tt><br> + <p><b> <a name="export"></a>export<br> + </b></p> + <p>Export loaded image data of current frame in specified image + format. Optional parameters: array endian, nrrd endian, jpeg + quality (1-100) and tiff compression method.</p> + <tt> Syntax: </tt><tt><br> + </tt><tt> export </tt><tt>[array|nrrd|envi|gif|tiff|jpeg|png] </tt><tt><filename></tt><tt><br> + </tt><tt>export array <filename></tt><tt> </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> + </tt><tt>export nrrd <filename> </tt><tt>[big|little</tt><tt>|native]</tt><br> + <tt>export envi <header> [<filename>] </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> + </tt><tt> </tt><tt>export jpeg <filename></tt><tt> [1-100]</tt><tt><br> + </tt><tt> </tt><tt>export tiff <filename</tt><tt>></tt><tt> + [none|jpeg|packbits|deflate]</tt><br> + <tt> <br> + Example: <br> + </tt><tt><tt><tt>ds9.set (string cmd)<br> + </tt>export array foo.arr little</tt></tt><br> + <tt><tt>export nrrd foo.nrrd little<br> + export envi foo.hdr little<br> + export envi foo.hdr foo.bsq little<br> + </tt></tt> <tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> + export jpeg foo.jpeg 75<br> + export png foo.png</tt><br> + <p><b> <a name="file"></a>file</b></p> + <p>Query currently loaded file information. </p> + <tt> Syntax:<br> + file <br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + file</tt><tt><br> + </tt> + <p><b> <a name="fits"></a>fits</b></p> + <p>Load a FITS image into the current frame or query the currently + loaded image.<br> + </p> + <tt> Syntax: <br> + fits </tt><tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> + </tt> [width|height|depth|bitpix|type]<br> + [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword + <string>]]<br> + [image|table|slice]</tt><tt><br> + <br> + Example: </tt><br> + <tt><tt>string value = ds9.get(string cmd)</tt><br> + fits<br> + fits width<br> + fits height<br> + fits depth<br> + fits bitpix</tt><br> + <tt>fits type </tt><br> + <tt><tt>fits size<br> + </tt> fits size wcs fk5 arcmin<br> + fits header # primary<br> + fits header 2 # hdu 2<br> + fits header -2 # hdu 2 with inherit<br> + fits header keyword "'BITPIX'"<br> + fits header 1 keyword "'BITPIX'"</tt><br> + <tt><tt>fits image<br> + fits table</tt></tt><tt><br> + fits slice<br> + ds9.set(string cmd, string url)</tt><tt><tt><br> + </tt> fits foo.fits<br> + fits new foo.fits<br> + fits bar.fits[bin=detx,dety]<br> + fits slice foo.fits<br> + fits mask foo.fits<br> + fits <br> + fits new<br> + fits -[bin=detx,dety]<br> + fits slice<br> + fits mask</tt> + <p>Syntax: <br> + </p> + <tt> fits [size|width|height|depth|bitpix]<br> + [size [wcs|wcsa...wcsz] + [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [type]<br> + [header [<ext>] [keyword + <string>]]<br> + [image|table|resample] [gz] <br> + [new|mask][<options>]<br> + [new][slice <options>]<br> + [new][mecube <options>]<br> + [new|mask][mosaicimage + [iraf|wcs|wcsa...wcsz|wfpc2] <options>]<br> + [new|mask][mosaic + [iraf|wcs|wcsa...wcsz] <options>]<br> + [new][rgbcube <options>]<br> + [new][rgbimage <options>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + fits size<br> + fits width<br> + fits height<br> + fits depth<br> + fits bitpix<br> + fits size wcs fk5 arcmin<br> + fits type <br> + fits header keyword BITPIX<br> + fits header 1 keyword BITPIX<br> + string url = ds9.get(string cmd)<br> + fits<br> + fits image<br> + fits image gz<br> + fits table<br> + fits table gz<br> + fits resample<br> + fits resample gz<br> + fits header # primary<br> + fits header 2 # hdu 2<br> + fits header -2 # hdu 2 with inherit<br> + ds9.set(string cmd, string url)<br> + fits <br> + fits [2] <br> + fits new [bin=detx,dety]<br> + fits slice<br> + fits mecube <br> + fits mosaicimage iraf<br> + fits mosaicimage wcs<br> + fits mosaicimage wcsa<br> + fits mosaicimage wfpc2<br> + fits mosaic iraf<br> + fits mosaic wcs<br> + fits rgbcube<br> + fits rgbimage </tt> + <p><b> <a name="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> + [has wcs + [<wcssys>|equatorial <wcssys>|linear + <wcssys>]]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + frame # returns the id of the current frame <br> + frame frameno # returns the id of the current frame <br> + frame all # returns the id of all frames <br> + frame active # returns the id of all active frames<br> + frame lock<br> + frame has amplifier<br> + frame has datamin<br> + frame has datasec<br> + frame has detector<br> + frame has grid<br> + frame has iis<br> + frame has irafmin<br> + frame has physical<br> + frame has smooth<br> + frame has contour<br> + frame has contour aux<br> + frame has fits<br> + frame has fits bin<br> + frame has fits cube<br> + frame has fits mosaic<br> + frame has marker highlite<br> + frame has marker paste<br> + frame has marker select<br> + frame has marker undo<br> + frame has system physical<br> + frame has wcs wcsa<br> + frame has wcs equatorial wcsa<br> + frame has wcs linear wcsa<br> + ds9.set(string cmd)<br> + frame center # center current frame<br> + frame center 1 # center 'Frame1' <br> + frame center all # center all frames <br> + frame clear # clear current frame<br> + frame new # create new frame <br> + frame new rgb # create new rgb frame<br> + frame delete # delete current frame <br> + frame reset # reset current frame <br> + frame refresh # refresh current frame <br> + frame hide # hide current frame <br> + frame show 1 # show frame 'Frame1'<br> + frame move first # move frame to first in order<br> + frame move back # move frame back in order<br> + frame move forward # move frame forward in order<br> + frame move last # move frame to last in order<br> + frame first # goto first frame <br> + frame prev # goto prev frame <br> + frame next # goto next frame<br> + frame last # goto last frame<br> + frame frameno 4 # goto frame 'Frame4', create if needed<br> + frame 3 # goto frame 'Frame3', create if needed <br> + frame match wcs<br> + frame lock wcs</tt><br> + <p><b> <a name="gif"></a>gif</b></p> + <p>Load GIF image into current frame.<br> + </p> + <tt> Syntax:<br> + gif [new|slice] [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>gif</tt><br> + <tt><tt>ds9.set(string cmd)<br> + </tt>gif foo.gif</tt><br> + <tt><tt>gif new foo.gif<br> + </tt></tt><tt><tt><tt>gif slice foo.gif<br> + </tt></tt>gif</tt><br> + <tt><tt>gif</tt><tt> new<br> + </tt>gif</tt><tt> slice</tt> + <p><b> <a name="grid"></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 style 0|1]<br> + [grid gap1 <value>]<br> + [grid gap2 <value>]<br> + [axes yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes style 0|1]<br> + [axes type interior|exterior]<br> + </tt><tt> [axes origin + lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> + <tt> [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks style 0|1]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border style 0|1]<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 type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font + times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + [labels text1 <text>]<br> + [labels def1 yes|no]<br> + [labels gap1 <value>]<br> + [labels text2 <text>]<br> + [labels def2 yes|no]<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> + string value = ds9.get(string cmd)<br> + grid <br> + grid type <br> + grid system <br> + grid sky <br> + grid skyformat <br> + grid grid <br> + grid grid color <br> + grid grid width <br> + grid grid style <br> + grid grid gap1 <br> + grid grid gap2 <br> + grid axes <br> + grid axes color <br> + grid axes width <br> + grid axes style <br> + grid axes type <br> + grid axes origin<br> + grid format1<br> + grid format2<br> + grid tickmarks <br> + grid tickmarks color <br> + grid tickmarks width <br> + grid tickmarks style <br> + grid border <br> + grid border color <br> + grid border width <br> + grid border style <br> + grid numerics <br> + grid numerics font <br> + grid numerics fontsize <br> + grid numerics fontweight<br> + grid numerics fontslant<br> + grid numerics color <br> + grid numerics gap1 <br> + grid numerics gap2 <br> + grid numerics type <br> + grid numerics vertical <br> + grid title <br> + grid title text<br> + grid title def <br> + grid title gap <br> + grid title font <br> + grid title fontsize <br> + grid title fontweight<br> + grid title fontslant<br> + grid title color <br> + grid labels <br> + grid labels text1 <br> + grid labels def1 <br> + grid labels gap1 <br> + grid labels text2 <br> + grid labels def2 <br> + grid labels gap2 <br> + grid labels font <br> + grid labels fontsize <br> + grid labels fontweight<br> + grid labels fontslant<br> + grid labels color <br> + ds9.set(string cmd)<br> + grid <br> + grid yes<br> + grid type analysis <br> + grid system wcs <br> + grid sky fk5 <br> + grid skyformat degrees<br> + grid grid yes<br> + grid grid color red<br> + grid grid width 2<br> + grid grid style 1<br> + grid grid gap1 10<br> + grid grid gap2 10<br> + grid axes yes<br> + grid axes color red<br> + grid axes width 2<br> + grid axes style 1<br> + grid axes type exterior<br> + grid axes origin lll<br> + grid format1 d.2<br> + grid format2 d.2<br> + grid tickmarks yes<br> + grid tickmarks color red<br> + grid tickmarks width 2<br> + grid tickmarks style 1<br> + grid border yes<br> + grid border color red<br> + grid border width 2<br> + grid border style 1<br> + grid numerics yes<br> + grid numerics font courier<br> + grid numerics fontsize 12<br> + grid numerics fontweight bold<br> + grid numerics fontslant italic<br> + grid numerics color red<br> + grid numerics gap1 10<br> + grid numerics gap2 10<br> + grid numerics type exterior<br> + grid numerics vertical yes<br> + grid title yes<br> + grid title text {Hello World}<br> + grid title def yes<br> + grid title gap 10<br> + grid title fontsize 12<br> + grid title font courier<br> + grid title fontweight bold<br> + grid title fontslant italic<br> + grid title color red<br> + grid labels yes<br> + grid labels text1 {Hello World}<br> + grid labels def1 yes<br> + grid labels gap1 10<br> + grid labels text2 {Hello World}<br> + grid labels def2 yes<br> + grid labels gap2 10<br> + grid labels font courier<br> + grid labels fontsize 12<br> + grid labels fontweight bold<br> + grid labels fontslant italic<br> + grid labels color red<br> + grid reset<br> + grid load foo.grd <br> + grid save foo.grd<br> + grid open<br> + grid close<br> + </tt> + <p><b> <a name="header"></a>header</b></p> + <p>Display current fits header dialog. Optional extension number + maybe specified. Please note, this differs from samp fits + header.</p> + <tt> Syntax: <br> + header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] + <filename>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + header<br> + header 2<br> + header close<br> + </tt> + <p><b> <a name="height"></a>height</b></p> + <p>Set the height of the image display window. </p> + <tt> Syntax: <br> + height [<value>]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + height<br> + ds9.set(string cmd)<br> + height 512<br> + </tt> + <p><b> <a name="iconify"></a>iconify</b></p> + <p>Toggles iconification. </p> + <tt> Syntax: <br> + iconify []<br> + [yes|no] <br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + iconify <br> + ds9.set(string cmd)<br> + iconify<br> + iconify yes</tt><br> + <p><b><a name="iexam"></a>iexam</b></p> + <p>Interactive examine function. A blinking cursor will indicate + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is + <tt>button</tt>. In the last form, the following macros will be + expanded if present: <tt>$width, $height, $depth, $bitpix, + $filename, $regions, $filename[$regions], $env, $pan, $value, + $x, $y, $z.</tt> See <a + href="file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis + + + + + + + + + + + + + + + + + + + + + + + + Macros</a> for more information.</p> + <tt> Syntax: <br> + iexam []<br> + </tt><tt><tt> [[]|button|key|any] + coordinate <coordsys> [<skyframe>] + [<skyformat>]<br> + [[]|button|key|any] data + [width][height]<br> + </tt><tt><tt> [[]|button|key|any] + <macro string>]<br> + </tt></tt><br> + Example:<br> + string value = ds9.get(string cmd)<br> + </tt><tt><tt>iexam<br> + </tt>iexam coordinate image<br> + iexam key coordinate image # return coordinate and key event<br> + iexam coordinate wcs fk5 degrees<br> + iexam coordinate wcs galactic sexagesimal<br> + iexam coordinate fk5<br> + iexam data # return data value<br> + iexam key data # return data value and key event<br> + iexam data 3 3 # return all data in 3x3 box about selected point<br> + iexam {Click at $x,$y in file $filename}</tt><br> + <p><b><a name="iis"></a>iis</b></p> + <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> + <tt> Syntax: <br> + iis [filename <filename> [#]]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + iis filename<br> + iis filename 4<br> + ds9.set(string cmd)<br> + iis filename foo.fits<br> + iis filename bar.fits 4</tt><br> + <p><b> <a name="jpeg"></a>jpeg</b></p> + <p>Load JPEG image into current frame. Optional parameters: <tt>jpeg + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + </tt>quality (1-100) </p> + <tt> Syntax:<br> + jpeg [new|slice] [<filename>] [1-100]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>jpeg</tt><br> + <tt><tt>jpeg 100</tt><br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>jpeg foo.jpeg</tt><br> + <tt><tt>jpeg new foo.jpeg<br> + </tt></tt><tt><tt><tt>jpeg slice foo.jpeg<br> + </tt></tt>jpeg</tt><br> + <tt><tt>jpeg</tt><tt> new<br> + </tt>jpeg</tt><tt> slice</tt> + <p><b> <a name="lock"></a>lock</b></p> + <p>Lock all other frames to the current frame. </p> + <tt> Syntax: <br> + </tt><tt>lock</tt><tt> </tt><tt>[frame <coordsys>|none]<br> + </tt><tt>[crosshair + <coordsys>|none] </tt><tt><br> + </tt><tt> [crop <coordsys>|none]</tt><br> + <tt> [slice <coordsys>|none]</tt><br> + <tt> </tt><tt> [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimits [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br> + [smooth [yes|no]]</tt><tt><br> + </tt><tt> </tt><tt><br> + Example:<br> + </tt><tt>string value = ds9.get(string cmd) <br> + </tt><tt>lock frame<br> + lock crosshair<br> + </tt><tt>lock crop</tt><br> + <tt> lock slice</tt><br> + <tt>lock bin<br> + lock axes<br> + lock scale<br> + lock scalelimits<br> + lock color</tt><tt>bar<br> + lock block<br> + lock smooth<br> + </tt><tt>ds9.set(string cmd)<br> + </tt><tt>lock frame wcs</tt><tt><br> + </tt><tt>lock crosshair wcs<br> + </tt><tt>lock crop wcs</tt><br> + <tt>lock slice wcs</tt><br> + <tt>lock bin yes<br> + lock axes yes<br> + </tt><tt>lock scale yes<br> + lock scalelimits yes<br> + </tt><tt>lock colorbar yes</tt><tt><br> + lock block yes<br> + lock smooth yes<br> + <br> + </tt><b><a name="lower"></a>lower</b> + <p>Lower in the window stacking order. </p> + <tt> Syntax: <br> + lower <br> + <br> + Example: <br> + ds9.set(string cmd)<br> + lower</tt><tt><br> + </tt> + <p><b> <a name="magnifier"></a>magnifier</b></p> + <p>Controls the magnifier settings. </p> + <tt> Syntax: <br> + magnifier [color <color>]<br> + [zoom + <value>]<br> + [cursor + yes|no]<br> + [region + yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd) <br> + magnifier color<br> + magnifier zoom<br> + magnifier cursor<br> + magnifier region<br> + ds9.set(string cmd)<br> + magnifier color yellow<br> + magnifier zoom 2<br> + magnifier cursor no<br> + magnifier region no<br> + </tt> + <p><b><a name="mask"></a>mask<br> + </b></p> + <p>Controls mask parameters. </p> + <tt> Syntax: <br> + mask [color <color>]<br> + [mark 1|0]<br> + [transparency <value>]<br> + [clear]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + mask color<br> + mask mark<br> + mask transparency<br> + ds9.set(string cmd)<br> + mask color red<br> + mask mark 0<br> + mask transparency 50<br> + mask clear<br> + mask open<br> + mask close<br> + </tt> + <p><b> <a name="match"></a>match</b></p> + <p>Match all other frames to the current frame. </p> + <tt> Syntax: <br> + </tt><tt>match </tt><tt>[frame <coordsys>]<br> + </tt><tt>[crosshair + <coordsys>] </tt><tt><br> + </tt><tt> [crop <coordsys>]<br> + </tt><tt> [slice <coordsys>]<br> + </tt><tt> [bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]</tt><tt><br> + </tt><tt> <br> + Example:<br> + ds9.set(string cmd)<br> + </tt><tt>match frame wcs <br> + </tt><tt>match crosshair wcs<br> + </tt><tt>match crop wcs</tt><br> + <tt> match slice wcs<br> + match bin<br> + match axes<br> + match scale<br> + match scalelimits<br> + match color</tt><tt>bar<br> + match block<br> + match smooth</tt><br> + <p><b> <a name="mecube"></a>mecube</b></p> + <p>Load FITS multiple extension file as data cube.<br> + </p> + <tt> Syntax:<br> + mecube [new] [<filename>]<br> + <br> + Example: </tt><br> + <tt>string value = ds9.get(string cmd)</tt><tt><tt><br> + </tt>mecube<br> + </tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt></tt>mecube foo.fits</tt><br> + <tt><tt>mecube new foo.fits<br> + </tt>mecube</tt><br> + <tt>mecube</tt><tt> new</tt> + <p><b> <a name="minmax"></a>minmax</b></p> + <p>This is how DS9 determines the min and max data values + from the data. <tt>SCAN</tt> will scan all data.</p> + <tt> Syntax: <br> + minmax [scan|sample|datamin|irafmin] <br> + [mode + scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + minmax mode<br> + minmax sample <br> + ds9.set(string cmd)<br> + minmax scan <br> + minmax mode scan<br> + minmax interval 100<br> + </tt> + <p><b> <a name="mode"></a>mode</b></p> + <p>Controls the first mouse button mode. </p> + <tt> Syntax: <br> + mode + [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine] + <br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + mode <br> + ds9.set(string cmd)<br> + mode crosshair</tt><br> + <p><b> <a name="mosaic"></a>mosaic</b></p> + <p>Load FITS mosaic segment into current frame.</p> + <tt> Syntax:<br> + mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>mosaic</tt><tt><br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>mosaic foo.fits</tt><br> + <tt><tt>mosaic wcs foo.fits</tt></tt><br> + <tt><tt>mosaic wcs new foo.fits</tt></tt><br> + <tt><tt>mosaic wcs mask foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt>mosaic</tt><br> + <tt><tt>mosaic wcs<br> + mosaic wcs</tt><tt> new<br> + </tt>mosaic wcs</tt><tt> mask<br> + </tt> + <p><b> <a name="mosaicimage"></a>mosaicimage</b></p> + <p>Load FITS mosaic image into current frame.</p> + <tt> Syntax:<br> + mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] + [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>mosaicimage</tt><tt><br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>mosaicimage foo.fits</tt><br> + <tt><tt>mosaicimage wcs foo.fits</tt></tt><br> + <tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> + <tt><tt>mosaicimage wcs mask foo.fits</tt></tt><tt><tt><tt><br> + </tt></tt>mosaicimage</tt><br> + <tt><tt>mosaicimage wcs<br> + mosaicimage wcs new</tt><tt><br> + </tt>mosaicimage wcs mask</tt> + <p><b><a name="movie"></a>movie</b></p> + <p>Create mpeg1 movie from snap shots of the DS9 window. A <tt>slice</tt> + movie cycles though all slices of a cube. A <tt>frame</tt> + movie cycles through all active frames. A <tt>3d</tt> movie + cycles through specified viewing angles. The default is <tt>frame</tt>. + Optional parameters for <tt>3d</tt>: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.</p> + <tt> Syntax:<br> + movie </tt><tt>[slice|frame|3d] </tt><tt><filename><br> + </tt><tt>movie 3d <filename> + [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat + <#>]</tt><br> + <tt> <br> + Example:<br> + ds9.set(string cmd)<br> + movie slice ds9.mpg<br> + </tt><tt>movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> + <p><b> <a name="multiframe"></a>multiframe</b></p> + <p>Load FITS multiple extension file as multiple images.<br> + </p> + <tt> Syntax:<br> + multiframe [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>multiframe foo.fits</tt><tt><tt><br> + </tt>multiframe</tt><br> + <p><b> <a name="nameserver"></a>nameserver</b></p> + <p>Support Name Server functions. Coordinates are in fk5. </p> + <tt> Syntax: <br> + nameserver [<object>] <br> + + [name <object>]<br> + + [server ned-sao|ned-eso|simbad-sao|simbad-eso]<br> + + [skyformat degrees|sexagesimal]<br> + + [pan]<br> + + [crosshair]<br> + [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + nameserver<br> + nameserver server<br> + nameserver skyformat<br> + nameserver m31<br> + ds9.set(string cmd)<br> + nameserver m31 <br> + nameserver name m31 <br> + nameserver server ned-sao <br> + nameserver skyformat sexagesimal<br> + nameserver pan<br> + nameserver crosshair<br> + nameserver open<br> + nameserver close<br> + </tt> + <p><b> <a name="nan"></a>nan</b></p> + <p>Set image not-a-number color. </p> + <tt> Syntax: <br> + nan <color><br> + <br> + Example:<br> + </tt><tt>string value = ds9.get(string cmd)<br> + nan</tt><br> + <tt>ds9.set(string cmd)<br> + nan red</tt><br> + <p><b> <a name="nrrd"></a>nrrd</b></p> + <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: + array endian.<br> + </p> + <tt> Syntax: <br> + nrrd [<filename>] [little|big]<br> + <br> + Example:<br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>nrrd</tt><br> + <tt><tt>nrrd big<br> + </tt></tt><tt><tt><tt>ds9.set(string cmd</tt><tt>, string url</tt><tt>)<br> + </tt>nrrd foo.nrrd</tt></tt><br> + <tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt>nrrd mask foo.nrrd<br> + </tt></tt></tt></tt></tt>nrrd</tt><br> + <tt>nrrd</tt><tt> new<br> + nrrd mask</tt><br> + <p><b> <a name="nvss"></a>nvss</b></p> + <p>Support for NRAO VLA Sky Survey.</p> + <tt> Syntax: <br> + nvss []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> <dec> + degrees|sexagesimal] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + nvss name <br> + nvss coord <br> + nvss size<br> + nvss save<br> + nvss frame<br> + ds9.set(string cmd)<br> + nvss<br> + nvss m31 <br> + nvss name m31 <br> + nvss coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + nvss size 60 60 arcmin<br> + nvss save yes<br> + nvss frame current<br> + nvss update frame<br> + nvss open<br> + nvss close<br> + </tt> + <p><b> <a name="orient"></a>orient</b></p> + <p>Controls the orientation of the current frame. </p> + <tt> Syntax: <br> + orient [none|x|y|xy] <br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + orient <br> + ds9.set(string cmd)<br> + orient xy<br> + orient open<br> + orient close<br> + </tt> + <p><b> <a name="pagesetup"></a>pagesetup</b></p> + <p>Controls Page Setup options. </p> + <tt> Syntax: <br> + pagesetup [orient portrait|landscape]</tt><br> + <tt> [scale + <numeric>]</tt><br> + <tt> [size + letter|legal|tabloid|poster|a4]</tt><br> + <tt> <br> + Example:<br> + string value = ds9.get(string cmd)<br> + pagesetup orient<br> + pagesetup scale <br> + pagesetup size <br> + ds9.set(string cmd)<br> + pagesetup orient portrait <br> + pagesetup scale 50<br> + pagesetup size poster<br> + </tt> + <p><b> <a name="pan"></a>pan</b></p> + <p>Controls the current image cursor location for the current + frame. </p> + <tt> Syntax: <br> + pan [<x> <y> <coordsys> + [<skyframe>][<skyformat>]] # relative<br> + [to <x> <y> <coordsys> + [<skyframe>][<skyformat>] # absolute<br> + [open|close]<br> + [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + pan # get current image coords <br> + pan wcs fk4 sexagesimal # get current wcs coords <br> + ds9.set(string cmd)<br> + pan 200 200 image # pan relative <br> + pan to 400 400 physical # pan to physical coords <br> + pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords<br> + pan open<br> + pan close<br> + </tt> + <p><b> <a name="pixeltable"></a>pixeltable</b></p> + <p>Display/Hide the pixel table. </p> + <tt> Syntax: <br> + pixeltable []<br> + [yes|open] <br> + [no|close]<br> + <br> + Example:<br> + string url = ds9.get(string cmd)<br> + pixeltable <br> + ds9.set(string cmd)<br> + pixeltable<br> + pixeltable yes<br> + pixeltable open<br> + pixeltable close<br> + </tt> + <p><b> <a name="plot"></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: <br> + # create new empty plot window<br> + plot<br> + plot [bar|scatter]<br> + [new [name <plotname>] + [line|bar|scatter]]<br> + [new [name <plotname>] + [line|bar|scatter] <title> <xaxis label> <yaxis + label> </tt><tt>xy|xyex|xyey|xyexey</tt><tt>]<br> + <br> + # create new plot with data<br> + plot [new [name <plotname>] </tt><tt>[line|bar|scatter] </tt><tt>stdin] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + # title, title xaxis, title yaxis, dimension on line 1<br> + [new [name <plotname>] + [line|bar|scatter] <title> <xaxis label> <yaxis + label> xy|xyex|xyey|xyexey]<br> + <br> + # load dataset into an existing plot<br> + plot [<plotname>] [data xy|xyex|xyey|xyexey]<br> + </tt><tt><tt><br> + plot [<plotname>] load <filename> + [xy|xyex|xyey|xyexey]<br> + [<plotname>] save + <filename><br> + </tt> [<plotname>] clear<br> + </tt><tt><tt><tt><tt><tt><tt> </tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + duplicate<br> + </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + </tt>[<plotname>] stats<br> + </tt></tt> </tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + list<br> + </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + loadconfig <filename><br> + [<plotname>] saveconfig + <filename><br> + </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [<plotname>] pagesetup orient [portrait|landscape]<br> + [<plotname>] pagesetup + size [letter|legal|tabloid|poster|a4]</tt><br> + <tt> </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [<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> + </tt> </tt>[<plotname>] + close<br> + </tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><br> + plot </tt>[<plotname>] mode [pointer|zoom]<br> + </tt></tt></tt></tt></tt></tt><tt><br> + # configure graph<br> + plot [<plotname>] axis [x|y] grid [yes|no]<br> + [<plotname>] axis [x|y] log + [yes|no]<br> + </tt><tt> [<plotname>] axis [x|y] + flip [yes|no]</tt><br> + <tt><tt> [<plotname>] axis [x|y] auto + [yes|no]<br> + [<plotname>] axis [x|y] min + <value><br> + [<plotname>] axis [x|y] max + <value></tt><tt><br> + </tt><tt><tt> [<plotname>] axis [x|y] + format <string></tt><tt><br> + </tt></tt> </tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + legend [yes|no]<br> + [<plotname>] legend position + [right|left|top|bottom]</tt><br> + </tt><tt><tt> [<plotname>] font + [title|labels|numbers] font [times|helvetica|courier]<br> + [<plotname>] font </tt></tt><tt><tt><tt><tt>[title|labels|numbers]</tt></tt> + size <value><br> + [<plotname>] font </tt></tt><tt><tt><tt><tt>[title|labels|numbers]</tt></tt> + weight [normal|bold]<br> + [<plotname>] font </tt></tt><tt><tt><tt><tt>[title|labels|numbers]</tt></tt> + slant [roman|italic]<br> + </tt></tt><tt> [<plotname>] title + <string></tt><br> + <tt><tt> [<plotname>] title [x|y] + <string><br> + [<plotname>] barmode + [normal|stacked|aligned|overlap]<br> + </tt></tt><tt><tt><tt><br> + # configure current dataset<br> + </tt>plot [<plotname>] show [yes|no]<br> + </tt> </tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + shape + [circle|square|diamond|plus|splus|scross|triangle|arrow]</tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt> <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + shape fill [yes|no]</tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt> <tt> + </tt></tt><tt><tt><tt><tt>[<plotname>] + shape color <value></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + smooth + [step|linear|cubic|quadratic|catrom]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + color + <value></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + width + <value><br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + dash [yes|no]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error [yes|no]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error color + <value></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + color + <value></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error width + <value></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> + <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tt> </tt></tt><tt><tt><tt><tt>[<plotname>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + name + <string><br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><br> + # select current dataset<br> + </tt></tt></tt>plot [<plotname>] select <value><br> + </tt><tt> <br> + Example: <br> + # return all plotnames<br> + string value = ds9.get(string cmd)<br> + plot<br> + <br> + # create new empty plot window<br> + ds9.set(string cmd)<br> + plot<br> + plot scatter<br> + plot new<br> + plot new bar<br> + plot new name foo<br> + plot new name foo scatter<br> + <br> + # create new plot with data<br> + ds9.set(string cmd, string url)<br> + plot new stdin <br> + plot new name foo stdin<br> + plot new "{The Title}" "{X}" "{Y}" xy<br> + plot new name foo "{The Title}" "{X}" "{Y}" xy<br> + <br> + # load additional dataset into an existing plot<br> + ds9.set(string cmd, string url)<br> + plot data xy # plot additional data<br> + plot foo data xy # plot additional data<br> + </tt><tt><tt><tt><tt><tt><tt><tt><br> + </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + value = ds9.get(string cmd)<br> + </tt></tt></tt></tt></tt></tt>plot + stats<br> + plot list<br> + </tt></tt></tt>ds9.set(string cmd)<br> + </tt></tt></tt></tt>plot load foo.dat xy # load new + dataset with dimension xy<br> + plot save bar.dat # save current dataset<br> + </tt></tt><tt><tt>plot clear # clear all datasets<br> + plot duplicate # duplicate current dataset<br> + plot stats<br> + plot list<br> + </tt></tt><tt><tt>plot loadconfig foo.plt # load plot + configuration <br> + plot saveconfig bar.plt # save current plot configuration<br> + </tt></tt><tt><tt>plot pagesetup orient portrait<br> + plot pagesetup size letter<br> + </tt></tt><tt><tt>plot print<br> + plot print destination file<br> + plot print command "lp"<br> + plot print filename "foo.ps"<br> + plot print color rgb<br> + </tt>plot close # close current plot<br> + </tt></tt><tt><tt><tt><tt><br> + string value = ds9.get(string cmd)<br> + </tt>plot mode<br> + </tt></tt></tt><tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt>plot mode pointer</tt><br> + </tt><tt><br> + # configure plot<br> + </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string + cmd)<br> + </tt></tt></tt></tt>plot axis x grid<br> + </tt><tt><tt>plot axis x log<br> + </tt></tt><tt><tt><tt>plot axis x flip</tt></tt></tt><br> + </tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + axis x auto<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + axis x min<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + axis x max<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + axis x format<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + legend<br> + </tt></tt></tt></tt><tt><tt><tt><tt><tt>plot legend + position<br> + </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt>plot + font numbers font<br> + </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + font numbers size<br> + </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + font numbers weight<br> + </tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + font numbers slant<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + title<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + title x<br> + plot barmode<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> + </tt></tt></tt></tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt>plot axis x grid yes<br> + plot axis x log yes</tt><br> + <tt>plot axis x flip yes</tt><tt><br> + </tt></tt><tt><tt><tt><tt>plot axis x auto no<br> + plot axis x min 0<br> + plot axis x max 100<br> + </tt></tt><tt><tt><tt><tt>plot axis x format {%f}<br> + </tt></tt></tt></tt>plot legend yes # show legend<br> + </tt><tt>plot legend position left</tt><tt><tt><tt><tt><br> + </tt></tt>plot font numbers font times<br> + plot font numbers size 12<br> + plot font numbers weight bold<br> + plot font numbers slant italic<br> + </tt></tt></tt><tt><tt>plot title {The Title}<br> + plot title x {X Axis}<br> + plot barmode aligned<br> + <br> + # configure current dataset<br> + </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string + cmd)<br> + </tt></tt></tt></tt>plot show<br> + plot shape</tt> <br> + <tt><tt>plot shape fill<br> + </tt></tt><tt><tt><tt>plot shape color<br> + </tt></tt></tt><tt><tt><tt><tt>plot smooth<br> + </tt></tt></tt></tt><tt><tt><tt><tt><tt>plot color<br> + </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt>plot + width<br> + </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + dash<br> + </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error color<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + error width<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + name<br> + </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt>ds9.set(string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + cmd)<br> + </tt>plot show yes<br> + plot shape circle<br> + </tt><tt><tt>plot shape fill no<br> + </tt></tt><tt><tt><tt>plot shape color cyan<br> + </tt></tt></tt><tt><tt>plot smooth step<br> + </tt>plot color red<br> + plot width 2<br> + plot dash yes<br> + plot error yes<br> + plot error color red</tt><br> + <tt>plot error width 2</tt><br> + <tt>plot name {My Data}</tt><br> + <tt><br> + # select current dataset<br> + </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string + cmd)<br> + </tt></tt></tt></tt>plot select<br> + </tt></tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt>plot select 2</tt><br> + <br> + </tt><b><b><a name="png"></a></b>png</b> + <p>Load PNG image into current frame.<br> + </p> + <tt> Syntax:<br> + png [new|slice] [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>png</tt><br> + <tt><tt>ds9.set(string cmd)<br> + </tt>png foo.png</tt><br> + <tt><tt>png new foo.png<br> + </tt></tt><tt><tt><tt>png slice foo.png<br> + </tt></tt>png</tt><br> + <tt><tt>png</tt><tt> new<br> + </tt>png</tt><tt> slice</tt><br> + <p><b> <a name="prefs"></a>prefs</b></p> + <p>Controls various preference settings. </p> + <tt> Syntax: <br> + prefs [clear]<br> + [irafalign yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + prefs irafalign<br> + ds9.set(string cmd)<br> + prefs clear<br> + prefs irafalign<br> + <br> + </tt><b><a name="preserve"></a>preserve</b> + <p>Preserve the follow attributes while loading a new image. </p> + <tt> Syntax: <br> + preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> + Example: <br> + string value = ds9.get(string cmd) <br> + preserve pan<br> + preserve regions<br> + ds9.set(string cmd)<br> + preserve pan yes<br> + preserve regions yes<br> + </tt> + <p><b><a name="psprint"></a>psprint</b></p> + <p>Invokes postscript printing. Please see <a + href="file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> + for further details.</p> + <p><b> <a name="print"></a>print</b></p> + <p>Controls printing. Use print option to set printing options.</p> + <tt> Syntax: <br> + print [destination printer|file] <br> + [command <command>] <br> + [filename <filename>]<br> + [color rgb|cmyk|gray] <br> + [level 1|2] <br> + [resolution 53|72|75|150|300|600] + <br> + <br> + Example: <br> + string value = ds9.get(string cmd) <br> + print destination <br> + print command <br> + print filename <br> + print color<br> + print level <br> + print resolution <br> + ds9.set(string cmd)<br> + print <br> + print destination file <br> + print command '{gv -}' <br> + print filename foo.ps <br> + print color cmyk <br> + print level 2 <br> + print resolution 75 </tt> + <p><b> <a name="raise"></a>raise</b></p> + <p>Raise in the window stacking order. </p> + <tt> Syntax: <br> + raise <br> + <br> + Example: <br> + ds9.set(string cmd)<br> + raise </tt> + <p><b> <a name="regions"></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> </tt><tt> [delim + [nl|<char>]]<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 + <color>] <br> + [group <tag> copy] <br> + [group <tag> delete] + <br> + [group <tag> cut]<br> + [group <tag> font + <font>] <br> + [group <tag> move + <int> <int>]<br> + [group <tag> + movefront] <br> + [group <tag> + moveback] <br> + [group <tag> + property <property> yes|no] <br> + [copy]<br> + [cut]<br> + [paste + image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + + [include|exclude|source|background|selected]<br> + [-format + ds9|ciao|saotng|saoimage|pros|xy]<br> + [-system + image|physical|wcs|wcsa...wcsz]<br> + [-sky + fk4|fk5|icrs|galactic|ecliptic] <br> + [-skyformat + degrees|sexagesimal]<br> + [-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> + string url = ds9.get(string cmd)<br> + regions<br> + regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal + -prop edit 1 -group foo <br> + string value = ds9.get(string cmd) <br> + regions epsilon<br> + regions show<br> + regions showtext<br> + regions centroid<br> + regions centroid auto<br> + regions centroid radius<br> + regions centroid iteration<br> + regions selected<br> + regions format <br> + regions system <br> + regions sky <br> + regions skyformat <br> + regions strip<br> + regions shape <br> + regions color <br> + regions width<br> + regions delim<br> + regions source <br> + regions background <br> + regions include <br> + regions exclude <br> + regions selected<br> + regions groups<br> + ds9.set(string cmd, string url)<br> + regions -format xy -system wcs -sky fk5<br> + regions -format ds9<br> + ds9.set(string cmd)<br> + regions foo.reg <br> + regions -format ciao bar.reg # load as ciao format<br> + regions foo.fits # FITS regions files do not need a format + specification<br> + regions load foo.reg # load foo.reg into current frame<br> + regions load all foo.reg # load foo.reg into all frames<br> + regions load *.reg# expand *.reg and load into current frame<br> + regions load all *.reg # expand *.reg and load into all frames<br> + regions save foo.reg<br> + regions list <br> + regions list close<br> + regions epsilon 5<br> + regions show yes<br> + regions showtext no<br> + regions centroid<br> + regions centroid auto yes<br> + regions centroid radius 10<br> + regions centroid iteration 20<br> + regions getinfo<br> + regions move back <br> + regions move front <br> + regions select all <br> + regions select none <br> + regions select invert<br> + regions delete all <br> + regions delete select <br> + regions format ds9 <br> + regions system wcs<br> + regions sky fk5 <br> + regions skyformat degrees <br> + regions delim nl <br> + regions strip yes<br> + regions shape ellipse <br> + regions color red <br> + regions width 3<br> + regions edit yes<br> + regions include<br> + regions command "circle 100 100 20 # color=red"<br> + regions composite<br> + regions dissolve<br> + regions template foo.tpl<br> + regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> + regions savetemplate foo.tpl<br> + regions group new<br> + regions group foo new<br> + regions group foo update<br> + regions group foo select<br> + regions group foo color red<br> + regions group foo copy<br> + regions group foo delete<br> + regions group foo cut<br> + regions group foo font 'times 14 bold'<br> + regions group foo move 100 100 <br> + regions group foo movefront <br> + regions group foo moveback <br> + regions group foo property delete no <br> + regions copy<br> + regions cut<br> + regions paste wcs<br> + regions undo<br> + </tt> + <p><b> <a name="restore"></a>restore</b></p> + <p>Restore DS9 to a previous state from a backup save set. </p> + <tt> Syntax: <br> + restore <filename><br> + <br> + Example:<br> + restore ds9.bck</tt><br> + <p><b> <a name="rgb"></a>rgb</b></p> + <p>Create RGB frame and control RGB frame parameters.</p> + <tt> Syntax: <br> + rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock + wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth + [yes|no]]<br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + rgb channel<br> + </tt><tt>rgb lock wcs</tt><br> + <tt>rgb lock crop</tt><br> + <tt>rgb lock slice</tt><br> + <tt> rgb lock bin<br> + rgb lock scale<br> + rgb lock scalelimits<br> + rgb lock colorbar<br> + rgb lock block<br> + rgb lock smooth<br> + rgb system<br> + rgb view red<br> + rgb view green<br> + rgb view blue<br> + ds9.set(string cmd)<br> + rgb # create new rgb frame<br> + rgb red # set current channel to red<br> + rgb channel red # set current channel to red<br> + rgb view blue no # turn off blue channel<br> + rgb system wcs # set rgb coordinate system<br> + </tt><tt>rgb lock wcs yes</tt><br> + <tt>rgb lock crop yes</tt><br> + <tt>rgb lock slice yes</tt><br> + <tt>rgb lock bin yes</tt><br> + <tt> rgb lock scale yes<br> + rgb lock scalelimits yes<br> + rgb lock colorbar yes<br> + rgb lock block yes<br> + rgb lock smooth yes<br> + rgb open<br> + rgb close</tt><br> + <p><b> <a name="rgbarray"></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|mask] +[[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> + <br> + Example: <br> + </tt><tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt></tt>rgbarray<br> + rgbarray little<br> + </tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt></tt>rgbarray + foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> + rgbarray new foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> + <p><b> <a name="rgbcube"></a>rgbcube</b></p> + <p>Load FITS rgbcube into rgb frame.<br> + </p> + <tt> Syntax:<br> + rgbcube [new] [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>rgbcube<br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>rgbcube foo.fits</tt><br> + <tt><tt>rgbcube new foo.fits<br> + </tt>rgbcube</tt><br> + <tt>rgbcube</tt><tt> new</tt><br> + <p><b> <a name="rgbimage"></a>rgbimage</b></p> + <p>Load FITS rgbimage into rgb frame.<br> + </p> + <tt> Syntax:<br> + rgbimage [new] [<filename>]<br> + <br> + Example: <br> + </tt><tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt></tt>rgbimage<br> + </tt><tt><tt><tt>ds9.set(string cmd)<br> + </tt></tt>rgbimage foo.fits</tt><br> + <tt><tt>rgbimage new foo.fits<br> + </tt>rgbimage</tt><br> + <tt>rgbimage</tt><tt> new</tt> + <p><b> <a name="rotate"></a>rotate</b></p> + <p>Controls the rotation angle (in degrees) of the current frame. + </p> + <tt> Syntax: <br> + rotate [<value>] <br> + [to <value>] <br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + rotate <br> + ds9.set(string cmd)<br> + rotate 45 <br> + rotate to 30<br> + rotate open<br> + rotate close</tt><br> + <p><b><a name="samp"></a>samp</b></p> + <p>Configure SAMP protocol. </p> + <tt> Syntax: <br> + samp [no|disconnect] <br> + [broadcast [image|table]]<br> + [send [image|table] + <application>]<br> + <br> + Example: <br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>samp no<br> + </tt><tt><tt>samp disconnect<br> + </tt>samp broadcast image<br> + samp send image aladin</tt> + <p><b> <a name="save"></a>save<br> + </b></p> + <p>Save loaded image data of current frame as FITS.</p> + <tt> Syntax: <br> + save </tt><tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] + <filename> [image|table|slice]</tt> <br> + <tt> <br> + Example: <br> + </tt><tt><tt>ds9.set(string cmd) <br> + </tt>save foo.fits</tt><br> + <tt>save fits foo.fits image</tt><br> + <tt>save fits foo.fits table<br> + save fits foo.fits slice</tt><br> + <tt>save rgbimage foo.fits<br> + </tt><tt>save rgbcube foo.fits</tt><br> + <tt>save mecube foo.fits</tt><br> + <tt>save mosaic foo.fits</tt><br> + <tt>save mosaicimage foo.fits</tt><br> + <p><b> <a name="saveimage"></a>saveimage</b></p> + <p>Create a snap shot of the current DS9 window and save in + specified image format. If no format specified, the file name + extension is used to determine the output format. Optional + parameters: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> + compression method. </p> + <tt> Syntax: <br> + saveimage </tt><tt>[fits|eps|gif|tiff|jpeg|png] </tt><tt><filename><br> + saveimage <filename>.jpeg [1-100]<br> + saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> + Example:<br> + ds9.set(string cmd) <br> + saveimage ds9.tiff<br> + saveimage jpeg ds9.jpeg 75</tt><br> + <p><b> <a name="scale"></a>scale</b></p> + <p>Controls the limits and color scale distribution. </p> + <tt> Syntax: <br> + scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>] <br> + [datasec yes|no] <br> + [limits <minvalue> + <maxvalue>] <br> + [mode + minmax|<value>|zscale|zmax] <br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + scale<br> + scale log exp <br> + scale datasec <br> + scale limits <br> + scale mode <br> + scale scope <br> + scale lock<br> + scale lock limits<br> + ds9.set(string cmd)<br> + scale linear<br> + scale log exp 100<br> + scale datasec yes <br> + scale histequ <br> + scale limits 1 100 <br> + scale mode zscale <br> + scale mode 99.5 <br> + scale scope local<br> + scale match<br> + scale match limits<br> + scale lock yes<br> + scale lock limits yes<br> + scale open<br> + scale close<br> + </tt> + <p><b> <a name="shm"></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> + [mosaicimagenext [wcs|wcsa...wcsz] + [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> + [startload|finishload]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + shm <br> + ds9.set(string cmd)<br> + shm 102 <br> + shm key 102<br> + shm shmid 102 foo<br> + shm fits key 100 foo <br> + shm mosaicimage iraf key 100 foo <br> + shm mosaicimage wcs key 100 foo <br> + shm mosaicimage wcsa key 100 foo <br> + shm mosaicimage wfpc2 key 100 foo <br> + shm mosaicimagenext wcs key 100 foo<br> + shm mosaic iraf key 100 foo <br> + shm mosaic wcs key 100 foo <br> + shm rgbcube key 100 foo <br> + shm rgbimage key 100 foo<br> + shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> + shm array shmid 102 [dim=32,bitpix=-32]<br> + shm startload # start a multiple load sequence without updating + the display<br> + shm finishload # finish multiple load sequence</tt><br> + <p><b> <a name="sia"></a>sia<br> + </b></p> + <p>Support for VO Simple Image Access protocol. The first command + will create a new search. All other commands operated on the + last search created, unless indicated otherwise.</p> + <tt> Syntax:<br> + sia</tt><tt> </tt><tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> + <br> + </tt><tt> </tt><tt> + [<ref>] [cancel]<br> + </tt><tt> [<ref>] + [clear]<br> + </tt><tt> [<ref>] [close]</tt><br> + <tt> [<ref>] + [coordinate <ra> <dec> <coordsys>]</tt><tt><br> + </tt><tt> </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [crosshair]</tt><br> + <tt> [<ref>] + [export sb|tsv <filename>]<br> + </tt><tt> [<ref>] [name + <object>]<br> + </tt><tt> [<ref>] [print]</tt><br> + <tt><tt> [<ref>] + [retrieve]</tt><br> + <tt> </tt></tt><tt> + [<ref>] [save <filename>]</tt><br> + <tt> [<ref>] [size + <width> <height> degrees|arcmin|arcsec]</tt><br> + <tt> </tt><tt> [<ref>] + [sky <skyframe>]<br> + </tt><tt> [<ref>] + [skyformat <skyformat>]<br> + </tt><tt> [<ref>] + [system <coordsys>]</tt><tt><br> + </tt><tt> </tt><tt>[<ref>] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [update]</tt><br> + <tt><br> + Example:<br> + string value = ds9.get(string cmd) <br> + sia<br> + <br> + ds9.set(string cmd)<br> + sia</tt><tt> 2mass<br> + sia</tt><tt> cancel<br> + sia</tt><tt> clear<br> + sia</tt><tt> close<br> + sia</tt><tt> coordinate 202.48 47.21 fk5<br> + sia</tt><tt> crosshair<br> + sia</tt><tt> export tsv bar.tsv<br> + sia</tt><tt> name m51<br> + sia</tt><tt> print</tt><br> + <tt>sia</tt><tt> retrieve<br> + sia</tt><tt> save foo.xml<br> + sia</tt><tt> size 1 1 degrees</tt><br> + <tt>sia</tt><tt> sky fk5<br> + sia skyformat degrees<br> + sia</tt><tt> system wcs</tt><tt><br> + sia</tt><tt> update<br> + <br> + </tt><b><a name="single"></a>single</b> + <p>Select Single Display mode </p> + <tt> Syntax: <br> + single <br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + single <br> + ds9.set(string cmd)<br> + single<br> + </tt> + <p><b><a name="skyview"></a>skyview </b></p> + <p>Support for SkyView image server at HEASARC. </p> + <p> </p> + <tt> Syntax: <br> + skyview []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> + <dec> degrees|sexagesimal] # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [pixels <width> + <height>]<br> + [save yes|no]<br> + [frame new|current]<br> + [update + frame|crosshair]<br> + [survey <survey>] <br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + skyview name <br> + skyview coord <br> + skyview size<br> + skyview pixels<br> + skyview save<br> + skyview frame<br> + skyview survey<br> + ds9.set(string cmd)<br> + skyview<br> + skyview m31 <br> + skyview name m31 <br> + skyview coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + skyview size 60 60 arcmin<br> + skyview pixels 600 600<br> + skyview save yes<br> + skyview frame current<br> + skyview update frame<br> + skyview survey sdssi<br> + skyview open<br> + skyview close<br> + </tt> + <p><b><a name="sleep"></a>sleep </b></p> + <p>Delays execution for specified number of seconds. Default is 1 + second. </p> + <p> </p> + <tt> Syntax: <br> + sleep [#]<br> + <br> + Example: <br> + ds9.set(string cmd)<br> + sleep<br> + sleep 2<br> + </tt> + <p><b><a name="smooth"></a>smooth</b></p> + <p>Smooth current image or set smooth parameters.</p> + <tt> Syntax:<br> + smooth []<br> + [yes|no]<br> + [function + boxcar|tophat|gaussian]<br> + [radius <int>]<br> + [open|close]<br> + [match]<br> + [lock [yes|no]]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + smooth<br> + smooth function<br> + smooth radius<br> + smooth lock<br> + ds9.set(string cmd)<br> + smooth<br> + smooth yes<br> + smooth function tophat<br> + smooth radius 4<br> + smooth open<br> + smooth close<br> + smooth match<br> + smooth lock yes<br> + </tt> + <p><b> <a name="source"></a>source</b></p> + <p>Source TCL code from a file. </p> + <tt> Syntax: <br> + source [filename] <br> + <br> + Example: <br> + ds9.set(string cmd)<br> + source foo.tcl</tt><br> + <p><b> <a name="tcl"></a>tcl</b></p> + <p>Execute one TCL command.<br> + </p> + <tt> Syntax:<br> + tcl <tcl command><br> + <br> + Example: <br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>tcl puts "Hello, World"<br> + </tt> + <p><b> <a name="threads"></a>threads</b></p> + <p>Set number of process threads for functions which are + multi-threaded. </p> + <tt> Syntax:<br> + threads #<br> + <br> + Example: <br> + </tt><tt>string value = ds9.get(string cmd)<br> + </tt><tt>threads</tt><br> + <tt>ds9.set(string cmd)<br> + </tt><tt>threads 8</tt><br> + <p><b> <a name="tiff"></a>tiff</b></p> + <p>Load TIFF image into current frame. Optional parameters: <tt>tiff + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + </tt>compression method. </p> + <tt> Syntax:<br> + tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate]<br> + <br> + Example: <br> + </tt><tt><tt>string value = ds9.get(string cmd)<br> + </tt>tiff</tt><br> + <tt><tt>tiff jpeg</tt><br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>tiff foo.tiff<br> + tiff new foo.tiff<br> + tiff slice foo.tiff</tt><tt><tt><br> + </tt>tiff<br> + tiff new<br> + tiff slice</tt><br> + <p><b> <a name="tile"></a>tile</b></p> + <p>Controls the tile display mode. </p> + <tt> Syntax: <br> + tile []<br> + [yes|no] <br> + [mode grid|column|row] <br> + [grid] <br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> <row>] <br> + [grid gap <pixels>] <br> + [row] <br> + [column] <br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + tile <br> + tile mode <br> + tile grid mode<br> + tile grid direction <br> + tile grid layout <br> + tile grid gap <br> + ds9.set(string cmd)<br> + tile<br> + tile yes <br> + tile mode row <br> + tile grid <br> + tile grid mode manual<br> + tile grid direction x <br> + tile grid layout 5 5 <br> + tile grid gap 10 <br> + tile row <br> + tile column </tt> + <p><b> <a name="update"></a>update</b></p> + <p>Updates the current frame or region of frame. In the second + form, the first argument is the number of the fits HDU (starting + with 1) and the remaining args are a bounding box in IMAGE + coordinates. By default, the screen is updated the next + available idle cycle. However, you may force an immediate update + by specifying the NOW option. </p> + <tt> Syntax: <br> + update [] <br> + [# x1 y1 x2 y2] <br> + [now] <br> + [now # x1 y1 x2 y2]<br> + <br> + Example: <br> + ds9.set(string cmd)<br> + update <br> + update 1 100 100 300 400 <br> + update now <br> + update now 1 100 100 300 400</tt><br> + <p><b> <a name="url"></a>url</b></p> + <p>Load FITS from URL into the current frame</p> + <tt> Syntax: <br> + url <url><br> + <br> + Example: <br> + </tt><tt><tt>ds9.set(string cmd)<br> + </tt>url http://foo.bar.edu/foo.fits </tt> + <p><b> <a name="version"></a>version</b></p> + <p>Returns the current version of DS9. </p> + <tt> Syntax: <br> + version <br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + version </tt> + <p><b> <a name="view"></a>view</b></p> + <p>Controls the GUI. </p> + <tt> Syntax: <br> + view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no] <br> + [panner yes|no] <br> + [magnifier yes|no] <br> + [buttons yes|no] <br> + [colorbar yes|no]<br> + [colorbar horizontal|vertical]<br> + [colorbar numerics yes|no]<br> + [graph horizontal|vertical + yes|no]<br> + [filename yes|no[<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz + yes|no]<br> + </tt><tt><tt> [frame yes|no] <br> + </tt> [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + view layout<br> + view keyvalue<br> + view info <br> + view panner<br> + view magnifier<br> + view buttons<br> + view colorbar<br> + view graph horizontal<br> + view filename<br> + view object<br> + view keyword<br> + view minmax<br> + view lowhigh<br> + view units<br> + view image<br> + view wcsa<br> + </tt><tt><tt>view frame<br> + </tt>view red<br> + ds9.set(string cmd)<br> + view layout vertical<br> + view keyvalue BITPIX<br> + view info yes<br> + view panner yes<br> + view magnifier yes<br> + view buttons yes<br> + view colorbar yes<br> + view graph horizontal yes<br> + view filename yes<br> + view object yes<br> + view keyword yes<br> + view minmax yes<br> + view lowhigh yes<br> + view units yes<br> + view wcsa yes<br> + </tt><tt><tt>view frame yes <br> + </tt>view red yes<br> + view green yes<br> + view blue yes</tt><br> + <p><b> <a name="vla"></a>vla</b></p> + <p>Support for VLA Sky Survey. </p> + <tt> Syntax:<br> + vla []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> <dec> + degrees|sexagesimal] # in wcs fk5<br> + [size <width> + <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + vla name <br> + vla coord <br> + vla size<br> + vla save<br> + vla frame<br> + vla survey<br> + ds9.set(string cmd)<br> + vla<br> + vla m31 <br> + vla name m31 <br> + vla coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + vla size 60 60 arcmin<br> + vla save yes<br> + vla frame current<br> + vla update frame <br> + vla survey stripe82<br> + vla open<br> + vla close<br> + </tt> + <p><b> <a name="vlss"></a>vlss</b></p> + <p>Support for NRAO VLSS Sky Survey.</p> + <tt> Syntax: <br> + vlss []<br> + [<object>]<br> + [name <object>]<br> + [coord <ra> <dec> + degrees|sexagesimal] # in wcs fk5<br> + [size <width> <height> + degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + vlss name <br> + vlss coord <br> + vlss size<br> + vlss save<br> + vlss frame<br> + ds9.set(string cmd)<br> + vlss<br> + vlss m31 <br> + vlss name m31 <br> + vlss coord 00:42:44.404 +41:16:08.78 sexagesimal<br> + vlss size 60 60 arcmin<br> + vlss save yes<br> + vlss frame current<br> + vlss update frame<br> + vlss open<br> + vlss close</tt><br> + <p><b> <a name="vo"></a>vo</b></p> + <p>Invoke an connection to a Virtual Observatory site. </p> + <tt> Syntax: <br> + vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + vo<br> + vo method<br> + vo server<br> + vo internal<br> + vo delay<br> + vo connect<br> + ds9.set(string cmd)<br> + vo method xpa<br> + vo server "http://foo.bar.edu/list.txt"<br> + vo internal yes<br> + vo delay 15<br> + vo chandra-ed<br> + vo connect chandra-ed<br> + vo disconnect chandra-ed<br> + vo open<br> + vo close<br> + </tt> + <p><b> <a name="wcs"></a>wcs</b></p> + <p>Controls the World Coordinate System for the current frame. If + the wcs system, skyframe, or skyformat is modified, the info + panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see <a + href="file.html#WCS">WCS</a> for more information. </p> + <tt> Syntax: <br> + wcs [[system] wcs|wcsa...wcsz] <br> + [[sky] fk4|fk5|icrs|galactic|ecliptic] <br> + [[skyformat] degrees|sexagesimal] <br> + [align yes|no] <br> + [reset [#]] <br> + [replace [#] <filename>] <br> + [append [#] <filename>] <br> + [open|close]<br> + <br> + Example: <br> + string value = ds9.get(string cmd)<br> + wcs <br> + wcs system <br> + wcs sky <br> + wcs skyformat <br> + wcs align <br> + ds9.set(string cmd)<br> + wcs wcs <br> + wcs system wcs<br> + </tt><tt>wcs fk5<br> + </tt><tt>wcs sky fk5<br> + </tt><tt>wcs sexagesimal <br> + </tt><tt>wcs skyformat sexagesimal <br> + wcs align yes <br> + wcs reset <br> + wcs reset 3<br> + wcs replace foo.wcs <br> + wcs replace 3 foo.wcs <br> + wcs append foo.wcs <br> + wcs append 3 foo.wcs <br> + ds9.set(string cmd, string url)<br> + wcs replace <br> + wcs append<br> + wcs open<br> + wcs close<br> + </tt> + <p><b> <a name="web"></a>web</b></p> + <p>Display specified URL in the web display. </p> + <tt> Syntax:<br> + web [new|<webname>] [<url>]<br> + [<webname>] [click + back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + web <br> + ds9.set(string cmd)<br> + web www.cnn.com<br> + web new www.cnn.com<br> + web hvweb www.apple.com<br> + web click back<br> + web click 2<br> + web clear<br> + web close<br> + </tt> + <p><b> <a name="width"></a>width</b></p> + <p>Set the width of the image display window.</p> + <tt> Syntax: <br> + width [<value>]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + width<br> + ds9.set(string cmd)<br> + width 512<br> + </tt> + <p><b> <a name="zscale"></a>zscale</b></p> + <p>Set Scale Limits based on the <i>IRAF</i> algorithm. </p> + <tt> Syntax: <br> + zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> + Example:<br> + string value = ds9.get(string cmd)<br> + zscale contrast<br> + zscale sample<br> + zscale line<br> + ds9.set(string cmd)<br> + zscale<br> + zscale contrast .25<br> + zscale sample 600<br> + zscale line 120<br> + </tt> + <p><b> <a name="zoom"></a>zoom</b></p> + <p>Controls the current zoom value for the current frame. </p> + <tt> Syntax: <br> + zoom [<value>] <br> + [<value> <value>]<br> + [to <value>] <br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit] <br> + [open|close]<br> + <br> + Example:<br> + string value = ds9.get(string cmd) <br> + zoom <br> + ds9.set(string cmd)<br> + zoom 2 <br> + zoom 2 4<br> + zoom to 4 <br> + zoom to 2 4<br> + zoom in<br> + zoom out<br> + zoom to fit<br> + zoom open<br> + zoom close<br> + </tt> </blockquote> + </body> +</html> |