Index: unk/Ohana/src/opihi/help/! =================================================================== --- /trunk/Ohana/src/opihi/help/! (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - exec (line) - - perform a system call. this can also be invoked with "!". - don't use ! in a macro or input script as it is interpreted as a - comment character. Index: unk/Ohana/src/opihi/help/Graphics =================================================================== --- /trunk/Ohana/src/opihi/help/Graphics (revision 4684) +++ (revision ) @@ -1,20 +1,0 @@ - - Kapa, the graphics window. - - Kapa is the program which Status uses to display plots on an X -terminal. There are actually 5 graphics windows available to Status, -though several functions write to specific windows by default. All -plots of sky coordinates are displayed on window 0, while -functions which plot other types of data use window 1. Most functions -have an option -n which allows the user to specify which Kapa window. -If it is not specified, the last window used will receive the action. - - Below are the available Resources. - - kii*Foreground: white - kii*Background: maroon - kii*geometry: 540x540+10+10 - - See Also: box, clear, limits, plot - - Index: unk/Ohana/src/opihi/help/Kii =================================================================== --- /trunk/Ohana/src/opihi/help/Kii (revision 4684) +++ (revision ) @@ -1,57 +1,0 @@ - - - Kii (= "picture" in Hawaiian) is the program which Mana uses to -display images on an X terminal. The window consists of a main region -where the image is displayed, a small "zoom box" where a magnified -view of the region around the cursor is shown, a colorbar showing the -current color map across the top of the window, a status box where the -coordinates and pixel values are displayed, and several buttons. -Clicking with the mounse in the different regions produces different -effects. - - Image Window: Clicking with the left mouse button (mouse-1) -recenters the image at the specified location. Clicking with the -right button (mouse-3) also recenters, but increases the zoom factor -by one. Clicking with the middle button centers and decreases the -zoom factor. - - Colorbar: Clicking and draging with the left button (mouse-1) alters -the color mapping. Moving left-to-right slides the center of the -color scale with the mouse. Moving up-and-down squeezes or expands -the color scale. The middle button resets the color mapping. -Clicking and dragging side-to-side with the right button expands or -squeezes the color mapping. **Note: the dynamic colormap cannot be -used with a 24 or 32 bit visual. The standard Linux XFree86 server -does not support 8 bit visuals in 24 or 32 bit/pixel mode. In this -case, the Kii window must resort to a static colormap with the -colorbar disabled. In Linux, it is possible to run startx with the -following command-line options to force the 8 bit/pixel mode: -# startx -- -bpp 8 -This assumes that you have an 8bpp Display mode set in the XF86Config -file. If not, you can just duplicate the 24 or 32 bpp Display modes -which will enable this option. - - Buttons: - PS: this button creates a PostScript version of the image. - Grey: this button makes the colormap a greyscale. - Rainbow: this button makes the colormap a rainbow. - Puns: this button make the colormap a blue and yellow mapping. - Recenter: this button recenters the image and resets the zoom. - - Kii also recognizes several X Resource values: - - Below are the available Resources (with Gene's default values). Unlike -most standard X programs, the geometry resource specifies the size of -the Image Window, not the borders of the entire window. Valid values -for the colormap are: greyscale, grayscale (photonegative), -greyscale, --grayscale (photopositive), Puns, GoBears (buff 'n blue colormap), -Rainbow (a rainbow map). - - kii*Foreground: white - kii*Background: maroon - kii*Colormap: greyscale - kii*geometry: 540x540+10+10 - - - See Also: tv, cursor - Index: unk/Ohana/src/opihi/help/Math =================================================================== --- /trunk/Ohana/src/opihi/help/Math (revision 4684) +++ (revision ) @@ -1,58 +1,0 @@ - - Opihi shell math operations: - - Mana will evaluate scalar (1D) arithmetic expresions in two -situations. To set a variable equal to a math operation, use the -syntax is: - - $foo = expression - -where "expression" is an arithmetic expression on numbers and -variables, including a variety of functions (see below). After -performing the arithmetic and setting the variable to the resulting -value, mana returns the prompts without performing any further -command. Mana will also evaluate any arithmetic expression enclosed -in curly brackets before attempting to perform the given command. For -example, if the variables $MEAN and $SIGMA contain the mean and -standard deviation of an image, it would be possible to display the -image with a zero and range based on $MEAN and $SIGMA like this: - - tv image {$MEAN - 1.5*$SIGMA} {5*$SIGMA} - - -The two expressions in curly brackets are evaluated and the resulting -numbers passed as arguments to the "tv" command. - - See Also: Variables, tv - - -list of valid math operations: - - binary operators: - * (times) - / (divided by) - + (plus) - - (minus) - ^ (to the power of: 2^3 = 8) - - unary operators: - exp (e to the power of) - ten (10 to the power of) - ln (natural logarithm) - log (log base 10) - - angles in radians: - sin (sine) - cos (cosine) - tan (tangent) - asin (arcsin) - acos (arccos) - atan (arctan) - - angles in degrees: - dsin (sine) - dcos (cosine) - dtan (tangent) - dasin (arcsin) - dacos (arccos) - datan (arctan) Index: unk/Ohana/src/opihi/help/Opihi =================================================================== --- /trunk/Ohana/src/opihi/help/Opihi (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - - Opihi - - Index: unk/Ohana/src/opihi/help/Photometry =================================================================== --- /trunk/Ohana/src/opihi/help/Photometry (revision 4684) +++ (revision ) @@ -1,26 +1,0 @@ - -cals: Plot residuals for reference stars. - - This function takes the currently displayed region and looks for all - stars which have 'reference' photometry and plots the difference - between the reference magnitude (in the given filter) and the - observed magnitude (same filter) versus one of several options: the - star color (based on the 'reference' photometry), the star magnitude, - the airmass, time, secqunce, etc. - - These plots can use one of two options for the 'observed' magnitude. - Either, the magnitude for individual measurement, using the currently - set values for the CCD zeropoints (from the photometry database), or - using the relative photometry determined for the particular star. - - -dmags: plot difference between two measured magnitudes - -resid: - -abszero - -zeropts - -cmd - Index: unk/Ohana/src/opihi/help/Shell =================================================================== --- /trunk/Ohana/src/opihi/help/Shell (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - - Opihi - - Index: unk/Ohana/src/opihi/help/Variables =================================================================== --- /trunk/Ohana/src/opihi/help/Variables (revision 4684) +++ (revision ) @@ -1,17 +1,0 @@ - - Opihi shell variables (scalars): - - The Opihi shell can have variables which are designated by a word -following a dollar sign: $foo. Certain Mana function create and set -variables (ie, stats, cursor). You can also set a variable to the -result of an arithmetic expression or just a number like this: - - $foo = 10.0 - $bar = 5*$foo + 0.6 - -Mana will replace the variables on a line before executing a command. -See also "Math" for more description of arithmetic operations. - - See Also: Math - - Index: unk/Ohana/src/opihi/help/applyfit =================================================================== --- /trunk/Ohana/src/opihi/help/applyfit (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - applyfit x y - - apply the results of a polynomial fit (stored in variables - $C0, $C1, etc, with $Cn representing the order of the fit). - The second vector will contain the function value at the - corresponding x coordinates of the first vector. - - See also: fit - Index: unk/Ohana/src/opihi/help/biassub =================================================================== --- /trunk/Ohana/src/opihi/help/biassub (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - biassub buffer sx sy nx ny dir [-v N V] - - Apply a bias correction. The region defines a vector - (median is taken perpendicular to the dir direction) which - is subtracted from the image. - - - Index: unk/Ohana/src/opihi/help/box =================================================================== --- /trunk/Ohana/src/opihi/help/box (revision 4684) +++ (revision ) @@ -1,11 +1,0 @@ - - box [-n Nwindow] - - draw a coordinate box on the current kapa window, or on the window -specified by -n (0 - 4). - - See also: Kapa - - - - Index: unk/Ohana/src/opihi/help/break =================================================================== --- /trunk/Ohana/src/opihi/help/break (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - break - - halts macro, if, or for processes and returns to the basic prompt. - - See also: macro, if, for - Index: unk/Ohana/src/opihi/help/buffers =================================================================== --- /trunk/Ohana/src/opihi/help/buffers (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - buffers - - buffers gives information about the currently allocated buffers. -A * next to the filename means the data has been altered from the -originally read in image. - - See also: memory - Index: unk/Ohana/src/opihi/help/catalog =================================================================== --- /trunk/Ohana/src/opihi/help/catalog (revision 4684) +++ (revision ) @@ -1,74 +1,0 @@ - - catalog (filename/-all) [many options!] - - plot the star positions from any of several possible catalogs. By -default, the photometry database (see Database) is used, but the HST -Guide Star Catalog and a simple ASCII file may also be used. The -plotting is done on window 0, with the current point type. The point -size can be scaled by the magnitude of the star or by the number -of observations (-n). - -There are many options to this function. Here they are all: - --e epoch: given ASCII catalog has this epoch, plot in J2000 - --ID ID: plot only measurements with this ID number - ID may be one of: - 0 - star - 4 - variable - 5 - transient - 100 - ghost image - 101 - trail (satellite) - 102 - bright star garbage - note that numbers < 50 are static objects, - and numbers > 100 are bad data. - --all: plot all data for the current display region - --g: use the HST GSC instead of the photometry database - --a RA DEC MAG: the given file is an ASCII file with - RA, DEC, and MAG in columns given by the three numbers - --v ra dec scale: save the values in vectors with the three names given - the ra and dec are always used, but the third is the size of - the points plotted, based on whatever the scaling is. - --m m1 m2: scale points by magnitude, with smallest points having - magnitude m2. - -+n n1 n2: scale points by number of measurements, with smallest points - having number n1. - --n n1 n2: scale points by number of missing values, with smallest points - having number n1. - -Note that if two of -m, -n, +n are given, the first determines the - scaling of the points. the second provides an allowed range, so - points are only plotted if the second parameter has a value in the - given range. - -Examples: - - catalog -all -m 12 18 - plot all stars in current region with magnitude 12 having the - biggest points and magnitude 18 having the smallest. - - catalog -all -m 12 18 +n 2 4 - plot all stars in current region with magnitude 12 having the - biggest points and magnitude 18 having the smallest, but only - if the stars have 2-4 measurements each - - catalog -all -m 12 18 +n 0 1 -ID 101 - plot all stars in current region with magnitude 12 having the - biggest points and magnitude 18 having the smallest, but only - if the stars have 1 measurements each, and if the object is - found to be a trail. - - catalog n2230/1819.cpt -n 2 8 - plot all stars in catalog n2230/1819.cpt with the biggest points - having 8 measurements and the smallest having only 2. - - See Also: lcat, pcat, style, region - - Index: unk/Ohana/src/opihi/help/cd =================================================================== --- /trunk/Ohana/src/opihi/help/cd (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - cd (path) - - change current working directory. - - Note that Kii or Kapa will be launched in the original - directory, which means PS files created by Kii or Kapa - will land in that directory (perhaps an unexpected result). - Index: unk/Ohana/src/opihi/help/center =================================================================== --- /trunk/Ohana/src/opihi/help/center (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - center (xpix) (ypix) [magnification] - - "center" centers the Kii window at the specified pixel coordinates. -Specifying a magnification will change the image scale to the -specified magnification. If you do not specify a magnification -(default), the image scale will remain the same. - - See also: Kii, tv - Index: unk/Ohana/src/opihi/help/cgrid =================================================================== --- /trunk/Ohana/src/opihi/help/cgrid (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - cgrid - - draws a grid in RA and DEC on window 0 approriate for the current - region. - Index: unk/Ohana/src/opihi/help/clear =================================================================== --- /trunk/Ohana/src/opihi/help/clear (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - clear - - clear the Kapa window - Index: unk/Ohana/src/opihi/help/clip =================================================================== --- /trunk/Ohana/src/opihi/help/clip (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - clip (buffer) [min Vmin max Vmax] [-inf val] [-nan val] - - clip values in an image. A min/max clip can be applied, - in which case all values above max are set to Vmax and all - below min are set to Vmin. -nan and -inf flags will set all - instances of NaN or any non-finite values to the given value. - Index: unk/Ohana/src/opihi/help/concat =================================================================== --- /trunk/Ohana/src/opihi/help/concat (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - concat v1 v2 - - concatenates the values of vector v2 to the end of vector - v1, increasing the length of v1. - - See also: subset, set - Index: unk/Ohana/src/opihi/help/contour =================================================================== --- /trunk/Ohana/src/opihi/help/contour (revision 4684) +++ (revision ) @@ -1,13 +1,0 @@ - - contour (overlay) level [Npix] - - "contour" makes a contour plot from the given at the -specified level. If Npix is specified, the image is rebinned by a -factor of Npix in each direction. The contour is drawn as a series of -lines on the specified overlay. The new lines are added to any -existing shapes. (Use "erase" first to erase all objects if desired). - -Valid overlays may be: 0, red, 1, green, 2, blue, 3, yellow. - - See also: load, save, erase - Index: unk/Ohana/src/opihi/help/coords =================================================================== --- /trunk/Ohana/src/opihi/help/coords (revision 4684) +++ (revision ) @@ -1,19 +1,0 @@ - - coords (filename) - - "coords" loads astrometric parameters for the given buffer from the -header of the named file. The parameters are applied to the buffer, -and will register in the Ki'i window if the buffer it tv'ed again. -This is particularly convenient for intercomparing coordinate system -or in the event the astrometry is stored in a different file (eg, a -stripped off header). Currently, the only format of coordinate -information that is looked for are gene's linear transformation: RA_O, -RA_X, RA_Y, DEC_O, DEC_X, DEC_Y such that the RA,DEC of an object is -given by: - -RA = RA_O + x*RA_X + y*RA_Y -DEC = DEC_O + x*DEC_X + y*DEC_Y. - - - See also: rd, tv - Index: unk/Ohana/src/opihi/help/create =================================================================== --- /trunk/Ohana/src/opihi/help/create (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - create vector start end [delta] - - create a vector of uniformly spaced values, starting at - start and going to end. By default the spacing is 1, but - may be chosen with the delta option. - Index: unk/Ohana/src/opihi/help/cursor =================================================================== --- /trunk/Ohana/src/opihi/help/cursor (revision 4684) +++ (revision ) @@ -1,13 +1,0 @@ - - cursor - - place cursor coordinates (and values ??) into Mana variables. to do -this, type cursor, then place the cursor on the desired spot in the -Ki'i window and type a digit (0 - 9). The coordinates of the cursor -are then placed in the variables $Xn and $Yn (where n is the digit you -typed). To exit the cursor mode, type "q" (or "Q") in the Ki'i -window. - - See Also: Kii, tv, center - - Index: unk/Ohana/src/opihi/help/cut =================================================================== --- /trunk/Ohana/src/opihi/help/cut (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - cut buffer sx sy nx ny - - take a cut from an image and place it in a pair of vectors. - the gets the pixel coordinate in the given direction, - the gets the pixel values. specifies the - direction of the cut. the region sx, sy, nx, ny specifies the - region for the cut, with summation in the cross-direction. - Index: unk/Ohana/src/opihi/help/datafile =================================================================== --- /trunk/Ohana/src/opihi/help/datafile (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - datafile (filename) - - define a data file for subsequent vector reads. - - See also: read Index: unk/Ohana/src/opihi/help/delete =================================================================== --- /trunk/Ohana/src/opihi/help/delete (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - delete - - delete the named buffer. Warning: no second chances are given! - Index: unk/Ohana/src/opihi/help/echo =================================================================== --- /trunk/Ohana/src/opihi/help/echo (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - echo [anything] - - prints the rest of the line, after variables and math expressions -are parsed. - - - See Also: Opihi, math - - Index: unk/Ohana/src/opihi/help/erase =================================================================== --- /trunk/Ohana/src/opihi/help/erase (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - erase (overlay) - - "erase" erases all objects on the specified overlay. - Valid overlays may be: all, red, green, blue, yellow. - - See also: load, save, contour - Index: unk/Ohana/src/opihi/help/exec =================================================================== --- /trunk/Ohana/src/opihi/help/exec (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - exec (or !) system function - - perform a UNIX system call. variables are parsed before - the commands is passed to the UNIX shell. - Index: unk/Ohana/src/opihi/help/extract =================================================================== --- /trunk/Ohana/src/opihi/help/extract (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - extract sx sy nx ny sx sy nx ny - - extract takes a portion of an image (buffer ) and creates a -new image (buffer ). The source region is defined by the first -set of (sx sy nx ny), the resulting image and the location of the -extracted image are defined by the second (sx sy nx ny). This allows -a portion of an image to be overlayed at a particular location in a -larger image. - - See also: Kii, tv - Index: unk/Ohana/src/opihi/help/fit =================================================================== --- /trunk/Ohana/src/opihi/help/fit (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - fit x y order [-dy wt] - - perform a lease-square polynomial fit to the data defined - by vectors x and y. the coefficients are placed in the variables - $C0, $C1, ..., and the order is placed in $Cn. - - See also: applyfit - Index: unk/Ohana/src/opihi/help/flux =================================================================== --- /trunk/Ohana/src/opihi/help/flux (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - flux buffer (file) - - calculate the flux enclosed by the contour given in the file. The - file contains the coordinates of the polygon corners. - - Index: unk/Ohana/src/opihi/help/for =================================================================== --- /trunk/Ohana/src/opihi/help/for (revision 4684) +++ (revision ) @@ -1,19 +1,0 @@ - - for var (start) (stop) [delta] - - perform a loop, with $var as the loop variable. - the value of $var runs from (start) to (stop) inclusive, - and is incremented by [delta] (1 by default). - - The loop commands are entered until the appropriate "end" is typed; - if there are nested loops, macro definitions, or logical blocks, - the correct "end" is used! - - for may be used at the command line, in a macro, or in an input - file with no ill effects. - - the variable $var may be accessed during the loop execution. if - the variable $var is assigned a value beyond (stop) during the - loop, the loop execution will end. - - See also: macro, if Index: unk/Ohana/src/opihi/help/gauss =================================================================== --- /trunk/Ohana/src/opihi/help/gauss (revision 4684) +++ (revision ) @@ -1,15 +1,0 @@ - - gauss Npix [Nspots] [-border N] [-sat cnts] - - calculate statistics on stars, assuming a Gaussian profile. The - user types a key on a star in the Kii window, and the resulting - information is printed on the screen. This is really aperture - photometry. Npix defines the aperture width (square aperture), the - optional -border defines the number of pixels in an annulus used to - find the background, -sat defines the value of a saturated pixel. - If the Nspots option is given, exactly Nspots stars are chosen. - Otherwise, the user may type on stars until the 'q' is typed. The - results of the last star are stored the a set of Mana variables. - - See also: star, cursor - Index: unk/Ohana/src/opihi/help/grid =================================================================== --- /trunk/Ohana/src/opihi/help/grid (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - grid (overlay) (buffer) - - draw a coordinate grid for the given buffer in the - given overlay in Kii. - Index: unk/Ohana/src/opihi/help/header =================================================================== --- /trunk/Ohana/src/opihi/help/header (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - header (buffer) - - print the header information for the given buffer. The header - information is Meta-information associated with an image. It is - well-defined for the FITS images, but may not exist for some of the - other possible data types. - Index: unk/Ohana/src/opihi/help/help =================================================================== --- /trunk/Ohana/src/opihi/help/help (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - help (function) - - print the contents of the help file. - typing "help" without an argument will list the available help - files. - Index: unk/Ohana/src/opihi/help/histogram =================================================================== --- /trunk/Ohana/src/opihi/help/histogram (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - histogram [-region sx sy nx ny] [-range min max] - - calculate a histogram of the image pixel values in the given - buffer, optionally constrained to the given region, with optional - max and min values. the results are placed in the vectors x and y, - which contain the pixel values and the number of occurences. - Index: unk/Ohana/src/opihi/help/if =================================================================== --- /trunk/Ohana/src/opihi/help/if (revision 4684) +++ (revision ) @@ -1,22 +1,0 @@ - - if (logic) - (commands) - end - - or: - - if (logic) - (commands) - else - (commnds) - end - - logical block. The commands are performed subject to the logical - condition. The syntax is simplified C: - examples: (x = 6), (x < 6) , (x ! 6), ((x = 6) | (x > 10)) - - there are no delimiter characters. - - See also: for, macro - - Index: unk/Ohana/src/opihi/help/images =================================================================== --- /trunk/Ohana/src/opihi/help/images (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - images - - plot the outlines of images in the photometry database and list - along with relevant information. An example of relevant data is the - image time, which can be used in other functions to define a specific - image or a range of images relevant for the function. - - See also: Database, lcat, pcat Index: unk/Ohana/src/opihi/help/imstats =================================================================== --- /trunk/Ohana/src/opihi/help/imstats (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - imstats - - list interesting statistics for a set of images. - Index: unk/Ohana/src/opihi/help/input =================================================================== --- /trunk/Ohana/src/opihi/help/input (revision 4684) +++ (revision ) @@ -1,15 +1,0 @@ - - input (filename) - - execute a series of commands given in the file. - - Two special examples: - ~/.manarc is loaded on startup, which give the user a place to - define personal macros, or interesting variables, etc. - - If mana is called in the form "mana file", the file is loaded - (after .manarc) before the user is given the command-line prompt. - This can be used to invoke mana in a shell script, but care should - be taken in a shell-script that the file ends with the word "exit" - or "quit", or strange things may happen... - Index: unk/Ohana/src/opihi/help/kern =================================================================== --- /trunk/Ohana/src/opihi/help/kern (revision 4684) +++ (revision ) @@ -1,4 +1,0 @@ - - kern buffer (kernel file or -) - - apply a 3x3 kernel to the image. Index: unk/Ohana/src/opihi/help/keyword =================================================================== --- /trunk/Ohana/src/opihi/help/keyword (revision 4684) +++ (revision ) @@ -1,11 +1,0 @@ - - keyword (KEYWORD) [variable] [-w value] - - "keyword" extracts the specified keyword from the header of the - specified buffer. If a third word is listed, the value of the - keyword is stored in a variable with the given name. If the -w - option is given, the value is written to the header keyword. - - The header Meta-data is well-defined for FITS, but not necessarily - for other data types. - Index: unk/Ohana/src/opihi/help/labels =================================================================== --- /trunk/Ohana/src/opihi/help/labels (revision 4684) +++ (revision ) @@ -1,23 +1,0 @@ - - labels - - write a label on the Kapa window. there are many options: - - -fn font size -- define the font (may be times, helvetica, courier) - - -x "a long line" -- label on the bottom x-axis - - +x "a long line" -- label on the top x-axis - - -y "a long line" -- label on the left y-axis - - +y "a long line" -- label on the right y-axis - - -ul "a long line" -- label on the upper left of plot - - -ll "a long line" -- label on the lower left of plot - - -ur "a long line" -- label on the upper right of plot - - -lr "a long line" -- label on the lower right of plot - Index: unk/Ohana/src/opihi/help/lcat =================================================================== --- /trunk/Ohana/src/opihi/help/lcat (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - lcat [-all] - - list photometry database files in the current region. if the option - -all is given, all database in the region are listed, along with a - comment to show if there is data in the file or not. if the option - is not given, only those files with data are listed. - - See also: region, pcat - Index: unk/Ohana/src/opihi/help/lcurve =================================================================== --- /trunk/Ohana/src/opihi/help/lcurve (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - lcurve RA DEC Radius [-l] - - plot light curves for all stars within Radius of the given - coordinates. The units for all three are decimal degrees. - The option -l autoscales the limits of the plot. - - See also: limits Index: unk/Ohana/src/opihi/help/limits =================================================================== --- /trunk/Ohana/src/opihi/help/limits (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - limits min max min max - limits x y - limits x min max - limits min max y - - set Kapa plot limits. The x and y axis limits may be explicitly - set (first example), or they may be assigned based on the range of - values in a pair of vectors (second examples), or one range may be - explicit and the other range assigned from a vector. - - Index: unk/Ohana/src/opihi/help/load =================================================================== --- /trunk/Ohana/src/opihi/help/load (revision 4684) +++ (revision ) @@ -1,20 +1,0 @@ - - load (overlay) (filename) - - "load" reads a file with objects in SAOimage style into the - specified overlay. If the specified overlay is already used, the - new objects are added to the old. If you do not want this, use - "erase" to erase all objects in the overlay first. Valid overlays - may be: 0, red, 1, green, 2, blue, 3, yellow. - -Examples of SAOimage style objects: -BOX 300 200 100 50 : draws a box centered at pixel 300,200 that - is 100 pixels wide, and 50 pixels high - -CIRCLE 500 400 200 : draws a circle centered at pixel 500,400 with a - radius of 200 pixels - -LINE 100 100 200 200 : draws a line from (100,100) with length (200,200) - - See also: save, erase, contour - Index: unk/Ohana/src/opihi/help/macro =================================================================== --- /trunk/Ohana/src/opihi/help/macro (revision 4684) +++ (revision ) @@ -1,11 +1,0 @@ - - macro (name) - - create a macro. the commands are entered until the word 'end' is - reached. nested if, for, and macro definitions use the - appropriately matched occurances of the 'end'. - - Within a macro, the command-line arguments are refered to as $1, - $2, etc. The number of command-line arguments is given by $0. - - Index: unk/Ohana/src/opihi/help/memory =================================================================== --- /trunk/Ohana/src/opihi/help/memory (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - memory [x] - - list the currently used memory. This gives a (possibly very) long - listing of the size of every allocated piece of memory. Placing - anything after the word "memory" gives a summary also. This is - useful to see just how close you are to filling your computer's - entire memory (Does not include memory allocated to Kii!) - - See Also: buffers - - Index: unk/Ohana/src/opihi/help/mextract =================================================================== --- /trunk/Ohana/src/opihi/help/mextract (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - mextract (filename) (value) [-g / -a Ncol] - - extracts a vector from the photometry database. The name also - specifies the type of data extracted (and is case insensitive). Only - certain names may be used. - - The possible values are: - ra, dec, mag, dmag, Mcal, Mrel, source, time, dR, dD - - - Note: this routine extracts the individual measurements. Index: unk/Ohana/src/opihi/help/output =================================================================== --- /trunk/Ohana/src/opihi/help/output (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - output (filename or "stdout") - - redirect the output to a file (concat to the end of the file). This - can also be done with the UNIX ">". However, this command is useful - to send information to a file for a part of a Mana session. For - example, you can save results of a "stats" command. - - See Also: input, stats - Index: unk/Ohana/src/opihi/help/pause =================================================================== --- /trunk/Ohana/src/opihi/help/pause (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - pause (N) - - pause N seconds. This suspends Mana (not Ki'i) for N seconds. Be -careful: Typing pause 100000 may be a bad idea! (you can only get -out of this with a cntl-C, which also kills Mana). - - See Also: wait - Index: unk/Ohana/src/opihi/help/pcat =================================================================== --- /trunk/Ohana/src/opihi/help/pcat (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - pcat [-all] - - plot outlines of photometry database files in the current region. - if the option -all is given, all database in the region are listed. - if the option is not given, only those files with data are listed. - - See also: region, lcat - Index: unk/Ohana/src/opihi/help/plot =================================================================== --- /trunk/Ohana/src/opihi/help/plot (revision 4684) +++ (revision ) @@ -1,13 +1,0 @@ - - plot [-dx dx] [-dy dy] [+dx dx] [+dy dy] - - plot a pair of vectors. the options allow for errorbars. If only - one of -dy or +dy is given, the given vector is used for the - errorbar. If both are given, -dy defines the lower errorbar, while - +dy defines the upper errorbar. This allows for assymetric errors - in a trivial fashion. The same applies to the -dx, +dx values. - - The vectors are plotted with the current plot style. See style for - all of the options. - - Index: unk/Ohana/src/opihi/help/print =================================================================== --- /trunk/Ohana/src/opihi/help/print (revision 4684) +++ (revision ) @@ -1,4 +1,0 @@ - - print X Y - - write a pair of vectors to a disk file. Index: unk/Ohana/src/opihi/help/profile =================================================================== --- /trunk/Ohana/src/opihi/help/profile (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - profile x y N - - Find the radial profile of an image at the location x, y. the - radius is placed in the X vector and the pixel value is placed in - the Y vector. Index: unk/Ohana/src/opihi/help/ps =================================================================== --- /trunk/Ohana/src/opihi/help/ps (revision 4684) +++ (revision ) @@ -1,8 +1,0 @@ - - ps [-g] - - create a PostScript file from the Kii window (or Kapa window if -g - is given). Kii produces a file called Ximage.ps, while Kapa - produces a file called Xgraph.ps - - Color postscript is an obvious, but unimplemented extension... Index: unk/Ohana/src/opihi/help/pwd =================================================================== --- /trunk/Ohana/src/opihi/help/pwd (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - pwd - - print current working directory - Index: unk/Ohana/src/opihi/help/rd =================================================================== --- /trunk/Ohana/src/opihi/help/rd (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - rd (buffer) (filename) - - "rd" reads a file into the specified buffer, creating the buffer if - none exists. A buffer name may consist of any letters, numbers, and - some limited other characters. However, the name may not start with - a digit. - - See also: wd, tv - Index: unk/Ohana/src/opihi/help/read =================================================================== --- /trunk/Ohana/src/opihi/help/read (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - read vect col [vect col, ...] - - read vector values from a file. An arbitrary number of vectors can - be specified, and the (whitespace-separated) field number given for - each vector. Data is read from the file defined by "datafile". - - See also: datafile - - Index: unk/Ohana/src/opihi/help/rebin =================================================================== --- /trunk/Ohana/src/opihi/help/rebin (revision 4684) +++ (revision ) @@ -1,9 +1,0 @@ - - rebin scale - - "rebin" rebins the specified buffer by the given scale factor and - places the result in the buffer. Negative integer values imply - expansion, positive numbers imply compression. - - See also: extract - Index: unk/Ohana/src/opihi/help/region =================================================================== --- /trunk/Ohana/src/opihi/help/region (revision 4684) +++ (revision ) @@ -1,11 +1,0 @@ - - region RA DEC Radius [projection] - - define the current sky region and optionally the projection. - RA, DEC and Radius are all values in decimal degrees. The possible - values for "projection" are: - - TAN - a tangent plane projection (default, and typical for optical images) - SIN - a sine plane projection (more appropriate for polar regions) - AIT - aitoff projection (good for the full sky) - GLS - ?? (also good for the full sky) Index: unk/Ohana/src/opihi/help/resid =================================================================== --- /trunk/Ohana/src/opihi/help/resid (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - resid [-im time] [-X] [-l] (photometry file) - - plot the photometry residuals for a photometry database file. - For every star in the database, the average magnitude is plotted - vs the difference between the average magnitude and each existing - measurement for that star. - - -l automatically set the plot limits. - -X plot residual divided by photometric error - -im time only plot the residuals for one of the images - in the database, specified by the obseravation time. Index: unk/Ohana/src/opihi/help/resize =================================================================== --- /trunk/Ohana/src/opihi/help/resize (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - resize Nx Ny - - change the size of the Kii window to have image dimensions Nx x - Ny. - Index: unk/Ohana/src/opihi/help/rotate =================================================================== --- /trunk/Ohana/src/opihi/help/rotate (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - rotate (buffer) (angle) [-center x y] - - rotate the buffer by the given angle. The angle may also be one of - the following special words: - - -flipx - flip in the x direction - -flipy - flip in the y direction - - if the optional center is given the rotation is about this position. Index: unk/Ohana/src/opihi/help/save =================================================================== --- /trunk/Ohana/src/opihi/help/save (revision 4684) +++ (revision ) @@ -1,16 +1,0 @@ - save (overlay) (filename) - - "save" stores the objects from the specified overlay into the named -file. Valid overlays may be: 0, red, 1, green, 2, blue, 3, yellow. - -Examples of SAOimage style objects: -BOX 300 200 100 50 : draws a box centered at pixel 300,200 that - is 100 pixels wide, and 50 pixels high - -CIRCLE 500 400 200 : draws a circle centered at pixel 500,400 with a - radius of 200 pixels - -LINE 100 100 200 200 : draws a line from (100,100) with length (200,200) - - See also: load, erase, contour - Index: unk/Ohana/src/opihi/help/scan =================================================================== --- /trunk/Ohana/src/opihi/help/scan (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - scan (filename) (variable) [Nline] - - place the Nth line in the file in the named variable - Index: unk/Ohana/src/opihi/help/set =================================================================== --- /trunk/Ohana/src/opihi/help/set (revision 4684) +++ (revision ) @@ -1,41 +1,0 @@ - - set (buffer) = expression.. - - perform math operations on images. there are several allowed - operators. the standard math functions are + - * /. Exponentiation - is performed with ^ (set c = a ^ b). There are several "logic" - operators which need some explanation. - - set c = a < b -- c is 1 if a < b, 0 otherwise - set c = a > b -- c is 1 if a > b, 0 otherwise - set c = m1 & m1 - c is 1 if m1 AND m2 true (non-zero is true) - set c = m1 | m1 - c is 1 if m1 OR m2 true (non-zero is true) - set c = a << b -- c is the minimum of a and b - set c = a >> b -- c is maximum of a and b - - complex operations may be performed: - - set c = a*(a < b) + c*((a < c) | (c < d)) - - unary operators also exist: - - exp(a) - e to the power of a - ten(a) - 10 to the power of a - ln(a) - log base e of a - log(a) - log base 10 of a - sqrt(a) - square root of a - sin(a) - sin of a - cos(a) - sin of a - tan(a) - sin of a - not(a) - logical inverse of a - abs(a) - absolute value of a - int(a) - integer value of a - - Examples: - - set a = b + 10 (add 10 to every pixel in b and put the answer in a) - set a = a / b (divide every pixel in a by the corresponding pixel - b and put the answer in a) - set b = 10 / a (divide 10 by every pixel in a and put the answer - in b) - Index: unk/Ohana/src/opihi/help/shift =================================================================== --- /trunk/Ohana/src/opihi/help/shift (revision 4684) +++ (revision ) @@ -1,6 +1,0 @@ - - shift buffer dx dy - - shift image by dx,dy pixels (may be fractional values). - - Index: unk/Ohana/src/opihi/help/simage =================================================================== --- /trunk/Ohana/src/opihi/help/simage (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - simage (filename) - - plot the positions of stars in a CMP file. This function is a - useful test for image comparisons, and astrometry must be determined - before the function is run. - Index: unk/Ohana/src/opihi/help/stats =================================================================== --- /trunk/Ohana/src/opihi/help/stats (revision 4684) +++ (revision ) @@ -1,10 +1,0 @@ - - stats (buffer) (x) (y) (nx) (ny) - - report the statistics on a portion of an image. (x) and (y) specify -the starting corner of the region, (nx) and (ny) specify the width and -height of the region. stats reports the mean, sigma, and number of -pixels in the region. - - See Also: ?? - Index: unk/Ohana/src/opihi/help/style =================================================================== --- /trunk/Ohana/src/opihi/help/style (revision 4684) +++ (revision ) @@ -1,36 +1,0 @@ - - style -- many options - - define or check the Kapa plotting style. without any command-line arguments, - style prints the current style. - - option definitions: - - -n window number (0-4), can also be used to change active window. - -pt point style: - 0 = filled box - 1 = open box - 2 = + - 3 = X - 4 = filled triangle - 5 = blank - 6 = open triangle - 7 = open circle - 100 = connect pair of points - -x plotting method: - 0 = connect - 1 = histogram - 2 = points - -lt line type: - 0 = solid - 1 = dashed - 2 = dotted?? - -lw line weight (0-10) - -sz point size - -c color: - black, white, red, orange, - yellow, green, blue, indigo, violet - -eb errorbar with no top - +eb errorbar with top - - See also: plot, box Index: unk/Ohana/src/opihi/help/subset =================================================================== --- /trunk/Ohana/src/opihi/help/subset (revision 4684) +++ (revision ) @@ -1,12 +1,0 @@ - - subset vec = vec if (logic expression) - - reduce the length of a vector based on logical expression. The - logic expression is some function of vectors of equal length to the - main vector. - - for example, we have vectors x and y of the same length: - - subset X = x if ((y > 100) | (x < 10)) - - Index: unk/Ohana/src/opihi/help/textline =================================================================== --- /trunk/Ohana/src/opihi/help/textline (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - textline x y (line) [-fn (font) size] [-rot angle] - - write the string at the given coordinates and rotation, - in the given font. - - (enclose long strings with spaces in quotes) Index: unk/Ohana/src/opihi/help/tv =================================================================== --- /trunk/Ohana/src/opihi/help/tv (revision 4684) +++ (revision ) @@ -1,13 +1,0 @@ - - tv [-log] (buffer) [zero range] - - display an image in the Ki'i window (X display program). zero and - range specify the data values corresponding to the color mapping. - If they are not specified, the old values are used (default is 0, - 1024). - - If -log is specified the color mapping scale will be logarithmic. - - - See Also: Kii, rd, cursor - Index: unk/Ohana/src/opihi/help/unsign =================================================================== --- /trunk/Ohana/src/opihi/help/unsign (revision 4684) +++ (revision ) @@ -1,20 +1,0 @@ - unsign - - "unsign" toggles the status of the UNSIGN mode. Warning: This is a -non-FITS standard implementation. The FITS standard does not allow -for unsigned integer data values, but many sites write CCD images with -16 bit UNSIGNED data. Mana looks for a FITS keyword "UNSIGN" to -determine if an image which is read in has signed or unsigned -integers. However, since this is a non-standard concept, many sites -do not use the UNSIGN flag, yet still write unsigned data. If the -user knows the data in the file is unsigned (ie, the user must have -apriori knowledge -- a FITS no-no!), then the user should set the -UNSIGN mode to true. In the event that the UNSIGN mode is set, if a -FITS file is encountered which contains integers, but which does not -contain the UNSIGN keyword, Mana will make the default assumption that -the data is unsigned. If the SIGNED mode is set, Mana will assume all -integer FITS files contain signed integers. - -((( should be able to say "unsign " to convert the status of a -buffer to UNSIGN or to toggle the buffer's status, but not yet -implemented))) Index: unk/Ohana/src/opihi/help/vectors =================================================================== --- /trunk/Ohana/src/opihi/help/vectors (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - vectors - - list the currently defined vectors and lengths - Index: unk/Ohana/src/opihi/help/wait =================================================================== --- /trunk/Ohana/src/opihi/help/wait (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - wait [anything] - - wait echos the rest of the line and waits for to be typed. -Very useful for pausing the processing of an input file or a macro. Index: unk/Ohana/src/opihi/help/wd =================================================================== --- /trunk/Ohana/src/opihi/help/wd (revision 4684) +++ (revision ) @@ -1,29 +1,0 @@ - - wd (buffer) (filename) [BITPIX] - - wd writes a buffer to the specified file in FITS format. (You may -need quotes around the filename if there are any /'s in the path). -The FITS keyword BITPIX may be specified. Valid values are 8, 16, 32 -(integer formats) and -32, -64 (floating point formats). If BITPIX is -unspecified, the original value of the image is used. The image is -converted blindly to the format and written out. This may mean that -values are rounded (integers), or wrapped by the range of the number -of bits. Also beware of the issue of signed vs unsigned images. - - See Also: rd - -bitpix bzero bscale file range data range -16 0 1 -32k : 32k -32k : 32k -16 32k 1 -32k : 32k 0 : 64k -16 0 2 -32k : 32k -64k : 64k -16 0 0.001 -32k : 32k -32. : 32. -32 0 1 -2e9 : 2e9 -2e9 : 2e9 -8 0 1 -128 : 128 -128 : 128 - -so for example, a file with a data range of -128k to +128k written -with bitpix 16, bzero 0, bscale 1 will have all data outside -32k : -+32k wrapped back in that range. - -note: on write, bzero is subtracted from the data before the data is - divided by bscale. - Index: unk/Ohana/src/opihi/help/which =================================================================== --- /trunk/Ohana/src/opihi/help/which (revision 4684) +++ (revision ) @@ -1,5 +1,0 @@ - - which (command) - - give a short summary info line on a command - Index: unk/Ohana/src/opihi/help/zplot =================================================================== --- /trunk/Ohana/src/opihi/help/zplot (revision 4684) +++ (revision ) @@ -1,7 +1,0 @@ - - zplot x y z min max - - plot the vector pair x and y as a series of points with size scaled - by the values in the vector z, with the smallest point having - values <= min and the largest having values >= max. -