diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2019-04-30 19:26:44 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2019-04-30 19:26:44 (GMT) |
commit | 1483b8287731dc837c3839152379b51a0aa8a685 (patch) | |
tree | ecb8f4883f91599634b50cee3aa038504f017eff /ds9 | |
parent | 4781e982ab072d80667c382bb69280ab16ab0e42 (diff) | |
download | blt-1483b8287731dc837c3839152379b51a0aa8a685.zip blt-1483b8287731dc837c3839152379b51a0aa8a685.tar.gz blt-1483b8287731dc837c3839152379b51a0aa8a685.tar.bz2 |
clean up doc
Diffstat (limited to 'ds9')
-rw-r--r-- | ds9/doc/ref/analysis.html | 146 |
1 files changed, 98 insertions, 48 deletions
diff --git a/ds9/doc/ref/analysis.html b/ds9/doc/ref/analysis.html index 651d2c5..efc921f 100644 --- a/ds9/doc/ref/analysis.html +++ b/ds9/doc/ref/analysis.html @@ -73,93 +73,124 @@ file:/home/joye/index.html<br></tt></blockquote> $height<br> $depth</b></p> <p>Substitute the width, height, or depth of the data file in the command line.</p> -<tt>Syntax:<br> $width</tt><br> +<tt>Syntax:<br> + $width</tt><br> <tt> $height</tt><br> <br> -<tt>Example:<br> echo "$width $height $depth" | $text</tt><br> +<tt>Example:<br> + echo "$width $height $depth" | $text</tt><br> <p><b>$bitpix</b></p> <p>Substitute the bitpix of the data file in the command line.</p> -<tt>Syntax:<br> $bitpix</tt><br> +<tt>Syntax:<br> + $bitpix</tt><br> <br> -<tt>Example:<br> echo "$bitpix" | $text</tt> +<tt>Example:<br> + echo "$bitpix" | $text</tt> <p><b>$data</b></p> <p>Data from the current frame becomes the input data to the command string. This data is in the form of a FITS image. This macro can only used at the beginning of the command string.</p> -<tt>Syntax:<br> $data</tt><br> +<tt>Syntax:<br> + $data</tt><br> <br> -<tt>Example:<br> $data | dosomething | $text</tt> +<tt>Example:<br> + $data | dosomething | $text</tt> <p><b>$entry</b></p> <p>Display an entry modal dialog. The returned string is substituted. If <tt>cancel</tt> is selected, the command line is not executed.</p> -<tt>Syntax:<br> $entry(<message>)</tt><br> +<tt>Syntax:<br> + $entry(<message>)</tt><br> <br> -<tt>Example:<br> echo "$entry(Enter something here)" | $text</tt> +<tt>Example:<br> + echo "$entry(Enter something here)" | $text</tt> <p><b>$env</b></p> <p>Substitute the value of a shell environment variable.</p> -<tt>Syntax:<br> $env(<shell variable>)</tt><br> +<tt>Syntax:<br> + $env(<shell variable>)</tt><br> <br> -<tt>Example:<br> echo "$env(PATH)" | $text</tt> +<tt>Example:<br> + echo "$env(PATH)" | $text</tt> <p><b>$filedialog</b></p> <p>Display the standard file dialog. Substitutes the returned pathname. Argument specifies if an open file or save file dialog is invoked.</p> -<tt>Syntax:<br> $filedialog([open|save])</tt><br> +<tt>Syntax:<br> + $filedialog([open|save])</tt><br> <br> -<tt>Example:<br> echo "$filedialog(open)" | $text</tt><br> +<tt>Example:<br> + echo "$filedialog(open)" | $text</tt><br> <p><b>$filename</b></p> <p>Substitute the filename of the data file in the command line. A full filename includes any absolute or relative path. A root filename contains no path. A (2D) subsection defines a subimage from <tt>xmin,ymin</tt> to <tt>xmax,ymax</tt>. For Frame3D, a 2D subsection will also include the current slice (PLANE=) parameter if not 1. A 3D subsection defines a subimage from <tt>xmin,ymin,zmin</tt> to <tt>xmax,ymax,zmax</tt> and no PLANE parameter.<br></p> -<tt>Syntax:<br> $filename # filename with extname, (2d) subsections, filters</tt><br> +<tt>Syntax:<br> + $filename # filename with extname, (2d) subsections, filters</tt><br> <tt> $filename(root|root,base) # root filename withwith extname,no subsections, no filters)</tt><br> <tt> $filename(full|full,base) # full filenamewith extname,no subsections, no filters)</tt><br> <br> -<tt>Example:<br> dosomething $filename | $text</tt><br> +<tt>Example:<br> + dosomething $filename | $text</tt><br> <tt> dosomething $filename(root) | $text<br></tt><br> <b>$filename[$regions]</b> <p>Combination of <tt>$filename</tt> and <tt>$regions</tt> macros. Generates a series of filenames, each with a region.</p> -<tt>Syntax:<br> $filename[$regions]</tt><br> +<tt>Syntax:<br> + $filename[$regions]</tt><br> <tt> $filename[$regions(<options>)]</tt><br> <br> -<tt>Example:<br> dosomething $filename[$regions] | $text</tt> +<tt>Example:<br> + dosomething $filename[$regions] | $text</tt> <p><b>$geturl</b></p> <p>This macro differs from all other macros, including $<tt>url</tt>, in that no subprocess pipe is created. Only HTTP is supported. The contents of the url are retrieved and sent to $<tt>text</tt>, $<tt>plot</tt>, or $<tt>image.</tt> No other processing is allowed. The primary purpose of this macro is to support external analysis for the Windows platform, which has no subprocess support.</p> -<tt>Syntax:<br> $geturl(http://<hostname>:<port>/<query>)</tt><br> +<tt>Syntax:<br> + $geturl(http://<hostname>:<port>/<query>)</tt><br> <br> -<tt>Example:<br> $geturl(http://foo.bar.edu/foo.html) | $text</tt><br> +<tt>Example:<br> + $geturl(http://foo.bar.edu/foo.html) | $text</tt><br> <p><b>$image</b></p> <p>The resulting image data is display in a DS9 frame. This macro should be the last macro of a command line. Optional parameter indicates if a new frame and what type of frame is created for the new data. The macro is removed from the command line before execution.</p> -<tt>Syntax:<br> $image</tt><br> +<tt>Syntax:<br> + $image</tt><br> <tt> $image([new|rgb|3d|current])</tt><br> <br> -<tt>Example:<br> doit | $image(new)</tt> +<tt>Example:<br> + doit | $image(new)</tt> <p><b>$message</b></p> <p>Display a message dialog box, with option buttons. After displaying the message, the macro is removed from the command line before execution. If <tt>cancel</tt> or <tt>no</tt> is selected, the command line is not executed.</p> -<tt>Syntax:<br> $message(<message>)</tt><br> +<tt>Syntax:<br> + $message(<message>)</tt><br> <tt> $message([ok|okcancel|yesno],<message>)</tt><br> <br> -<tt>Example:<br> $message(okcancel,This is a Message)| doit | $text</tt> +<tt>Example:<br> + $message(okcancel,This is a Message)| doit | $text</tt> <p><b>$null</b></p> <p>Expect no output or results from analysis task. Note: no error message will be returned if the analysis task fails to execute correctly.</p> -<tt>Syntax:<br> $null</tt><br> +<tt>Syntax:<br> + $null</tt><br> <br> -<tt>Example:<br> echo "Hello, world" > foo | $null</tt> +<tt>Example:<br> + echo "Hello, world" > foo | $null</tt> <p><b>$pan</b></p> <p>Substitute current pan location of the particular data file are returned. The default coordinate system is <tt>physical</tt>.</p> -<tt>Syntax:<br> $pan<br> $pan(<coordinate system>,<format>)</tt><br> +<tt>Syntax:<br> + $pan<br> + $pan(<coordinate system>,<format>)</tt><br> <p>where:</p> <tt> coordinate system = [image|physical|detector|amplifier|wcs|wcsa...wcsz]</tt><br> <tt> sky frame = [fk4|fk5|icrs|galactic|ecliptic]</tt><br> <tt> sky format = [hms|sexagesimal|degrees]</tt><br> <br> -<tt>Example:<br> echo $pan(fk5,sexagesimal) | $text</tt><br> +<tt>Example:<br> + echo $pan(fk5,sexagesimal) | $text</tt><br> <p><b>$plot</b></p> <p>Display data in plot window. This macro should be the last macro of a command line. The data is read via <tt>STDIN</tt> and consist of a pair of coordinates, with option error values. (<tt>xy, xyex, xyey, xyexe</tt>y) Default dimension is <tt>xy.</tt> The macro is removed from the command line before execution.</p> <p>For <tt>$plot(stdin)</tt> only:</p> <p>The title, x axis label, and y axis label are assumed to be on the first line of input, delimited with a new-line. However, if the data starts with $<tt>BEGINTEXT</tt>, all text between $<tt>BEGINTEXT</tt> and $<tt>ENDTEXT</tt> will be removed from the data and displayed in a separate text dialog window, with the remaining data, including the title, x axis label, and y axis label, will be displayed in a plot window. Furthermore, if the data contains the string $<tt>ERROR,</tt> an error is assumed to have occurred and a text dialog window is displayed only.</p> -<tt>Syntax:<br> $plot</tt><br> +<tt>Syntax:<br> + $plot</tt><br> <tt> $plot(,,,)</tt><br> <tt> $plot(<title>,<x axis label>,<y axis label>,[xy|xyex|xyey|xyexey])</tt><br> <tt> $plot(stdin)</tt><br> <br> -<tt>Example:<br> doit | $plot(This is aTitle,X Axis,Y Axis)<br> doit | $plot(stdin)</tt> +<tt>Example:<br> + doit | $plot(This is aTitle,X Axis,Y Axis)<br> + doit | $plot(stdin)</tt> <p><b>$regions</b></p> <p>Substitute region definition in specified region format, coordinate system, and coordinate format. The default coordinate system is <tt>physical</tt>, default coordinate format <tt>degrees</tt>, and default region format <tt>DS9</tt>. Arguments may appear in any order, as long as they are separated by ',' and no spaces. If one or more properties are specified, only regions with all of the specified properties will be substituted.</p> -<tt>Syntax:<br> $regions</tt><br> +<tt>Syntax:<br> + $regions</tt><br> <tt> $regions(<options>)</tt> <p>where options are one of the following:</p> <tt> regions format = [ds9|ciao|saotng|saoimage|pros|xy]</tt><br> @@ -179,31 +210,39 @@ $depth</b></p> <tt> $exclude_regions_pixels</tt><br> <tt> $exclude_regions_degrees</tt><br> <tt> $exclude_regions_hms<br></tt><br> -<tt>Example:<br> dosomething $regions | $text</tt><br> +<tt>Example:<br> + dosomething $regions | $text</tt><br> <tt> dosomething $regions(pros) | $text</tt><br> <tt> dosomething $regions(source,wcs,fk5) | $text</tt><br> <tt> dosomething $regions(saotng,background,exclude,ecliptic,sexagesimal) | $text</tt> <p><b>$text</b></p> <p>Display text in a text dialog window. This macro should be the last macro of a command line. To display text from only STDOUT use '|' as the pipe command. To display text from both STDOUT and STDERR, use '|&' as the pipe command. No parameters are required. The macro is removed from the command line before execution.</p> -<tt>Syntax:<br> $text</tt><br> +<tt>Syntax:<br> + $text</tt><br> <br> -<tt>Example:<br> doit | $text # stdout<br> +<tt>Example:<br> + doit | $text # stdout<br> doit |& $text # stdout and stderr<br></tt> <p><b>$url</b></p> <p>URLs are processed and stored in a temporary file. Only HTTP and anonymous FTP are supported.</p> -<tt>Syntax:<br> $url(http://<hostname>:<port>/<query>)</tt><br> +<tt>Syntax:<br> + $url(http://<hostname>:<port>/<query>)</tt><br> <tt> $url(ftp://<hostname>/<filename>)</tt><br> <br> -<tt>Example:<br> $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image</tt><br> +<tt>Example:<br> + $url(http://legacy.gsfc.nasa.gov/rosat/data/p000s26b.img.Z) | uncompress | $image</tt><br> <tt> $url(ftp://legacy.gsfc.nasa.gov/rosat/data/hri/images/rh100193_img.fits) | $image<br></tt> <p><b>$vo_method</b></p> <p>Returns the vo method.</p> -<tt>Syntax:<br> $vo_method</tt><br> +<tt>Syntax:<br> + $vo_method</tt><br> <br> -<tt>Example:<br> echo '$vo_method' | $text</tt><br> +<tt>Example:<br> + echo '$vo_method' | $text</tt><br> <p><b>$value<br></b></p> <p>Substitute the value at the location of the cursor of an bind event.<br></p> -<tt>Syntax:<br> $value<br> +<tt>Syntax:<br> + $value<br> <br> Example:<br> echo "$value" | $text</tt><br> @@ -211,7 +250,8 @@ Example:<br> $y<br> $z<br></b></p> <p>Substitute coordinates of an bind event. When a bind event is triggered, the <i>x,y</i> coordinates of the mouse of the particular data file are returned. The default coordinate system is <tt>physical</tt>. This macro is only available for bind commands. For datacubes, the z coordinate is returned based on the current slice selected.<br></p> -<tt>Syntax:<br> $x</tt><br> +<tt>Syntax:<br> + $x</tt><br> <tt> $x(<coordinate system>,<format>)</tt><br> <tt> $y</tt><br> <tt> $y(<coordinate system>,<format>)<br> @@ -222,19 +262,25 @@ $z<br></b></p> <tt> sky frame = [fk4|fk5|icrs|galactic|ecliptic]</tt><br> <tt> sky format = [hms|sexagesimal|degrees]</tt><br> <br> -<tt>Example:<br> echo "$x $y" | $text<br> +<tt>Example:<br> + echo "$x $y" | $text<br> echo "$x $y $z" | $text<br> - echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text<br> echo "$x(wcs) $y(wcs) $z(wcs)" | $text</tt><br> + echo "$x(fk5,sexagesimal) $y(fk5,sexagesimal)" | $text<br> + echo "$x(wcs) $y(wcs) $z(wcs)" | $text</tt><br> <p><b>$xpa</b></p> <p>Returns the xpa access point name.</p> -<tt>Syntax:<br> $xpa</tt><br> +<tt>Syntax:<br> + $xpa</tt><br> <br> -<tt>Example:<br> echo '$xpa' | $text</tt> +<tt>Example:<br> + echo '$xpa' | $text</tt> <p><b>$xpa_method</b></p> <p>Returns the xpa method.</p> -<tt>Syntax:<br> $xpa_method</tt><br> +<tt>Syntax:<br> + $xpa_method</tt><br> <br> -<tt>Example:<br> echo '$xpa_method' | $text</tt> +<tt>Example:<br> + echo '$xpa_method' | $text</tt> <p><b><a name="Help" id="Help"></a>Help</b></p> <p>The user may define his own <tt>HELP</tt> message. This message will be available to the user as a menu item. An optional label maybe specified. The default label is <tt>Help</tt>. When invoked, an text dialog window will appear, containing the message. Multiple <tt>HELP</tt> items maybe defined within a menu or across hierarchical menus.</p> <tt>Example:</tt> @@ -364,12 +410,14 @@ hmenu Test Basics<br> Test $xpa_method<br> *<br> menu<br> - echo $xpa_method | $text<br><br> + echo $xpa_method | $text<br> +<br> Test $vo_method<br> *<br> menu<br> echo $vo_method | $text<br> -<br> Test $filename<br> +<br> + Test $filename<br> *.fits<br> menu<br> echo $filename | $text<br> @@ -383,11 +431,13 @@ hmenu Test Basics<br> *.fits<br> menu<br> echo "$xdim $ydim $bitpix" | $text<br> -<br> Test $xcen $ycen<br> +<br> + Test $xcen $ycen<br> *.fits<br> menu<br> echo "$xcen $ycen" | $text<br> -<br> Test $env<br> +<br> + Test $env<br> *<br> menu<br> echo $env(PATH) | $text<br> |