+gcat -- get catalog at location +gimages -- get images at location +gstar -- get star statistics +extract -- extract average vectors from catalogs +mextract -- extract measurement vectors from catalogs +imstats -- plot image statistics +imextract -- extract image vectors from database +lcat -- list catalogs in display region +cmatch -- match two catalogs ++ +
+There are a variety of other commands which directly refer to the +photometry database. Some of these functions extract data of various +types from the database, others perform more complex plotting +operations. The commands listed above are those which simply extract +data from the database. The first three list information relevant to +a specific RA, DEC location on the sky: gcat (RA) (DEC) lists +the catalog at the specified location and places the name in the +variable $CATNAME, gimages (RA) (DEC) lists all images +which overlap the specified location, gstars (RA) (DEC) (RADIUS) +lists data about the stars within a specified radius of the specified +location (all numbers above are given in decimal degrees). Similarly, +lcat lists the catalogs in the region. Imstats lists statistics +about each image + +
+The next three commands extract a specific piece of information from +the photometry database and places it in a vector. First, +extract will extract average values for each star and place +it in a vector. Next, mextract will extract measurement +values for each star and place it in a vector: as a result a single +star may have multiple entries in the measurement vectors. Finally, +imextract will extract image statistics into vectors (not yet +implemented). + + +
+catalog -- plot catalog stars +cgrid -- plot sky coordinate grid +cplot -- plot vectors in sky coordinates +czplot -- plot scaled vectors in sky coordinates +images -- plot image boxes +imdense -- image density plot +lcurve -- plot lightcurve for a star +pcat -- plot catalog boundaries +region -- define sky region for plot +resid -- plot residuals +simage -- plot stars in an image ++ +
+There are two types of database plotting functions: those that display +or refer to the spatial charateristics of the data and those that +refer to other types of charatersitics, such as the time domain. The +graphics window 0 is reserved for all plots of objects on the sky. +The command region defines the current sky coordinates for plots +in graphic window 0. The command pcat plots the outline of all +photometry database files which are within the currently defined +region (and by default, only those with data). images plots the +outline of the images in the image database, while imdense shows +the number of images at a location by randomly spacing dots within the +boundary of the images. The command cgrid +draws a grid in celestial coordinates on the for the current region. + +
+The most complex, but also one of the most useful command is +catalog, which plots the positions of stars in the photometry +database (and others) on the sky. There are many options to this +command. One set allows the user to plot stars from the photometry +database (the default), from the HST GSC, or from an ASCII text file +with RA, DEC, and Mag in specified columns. If the ASCII file has a +fixed number of bytes per line, the data can be more quickly loaded. +The size of the points may be scaled by the star magnitude, by the +number of observations of the star, or by the number of missing +datapoints for the star. In addition, points may be plotted only if +they land in specified magnitude ranges, or with specified numbers of +measurements, or missed measurements. Also, objects may be plotted +only if they have a specified Average.code, so that only asteroids or +only perfect stars may be plotted. The plotted vectors may be saved, +if desired, and the source catalog epoch may be specified as different +from J2000 (only valid for ASCII data). + +
+Several other commands relate to non-spatial charateristics of images +and stars. lcurve will plot a light curve for all stars within +some radius of a point. resid plots the photometry residuals +for a particular region file. + +
+Fig.~\ref{allsky} shows a map of the entire sky, and the location +of the images currently in the database. This picture was made with +the following commands: (output is not shown) + +
+dvo: region 0 0 90 gls +dvo: cgrid +dvo: style -lw 2 -c red +dvo: images +dvo: ps ++ +
+In this example, on the graphics window, the image boxes are shown in +red. The user now has the possiblitiy of using the cursor command to +narrow in on a specific region, and so forth. + +\begin{figure} +%\psfig{file=polar.ps,width=16cm} +\caption{\label{polar} \small + Map of the sky in polar project, and images added to database. } +\end{figure} + +
+Fig.~\ref{allsky} shows a map of the entire sky, and the location of +the images currently in the database from a polar project. This +picture was made with the following commands: (output is not shown) + +
+dvo: region 0 0 90 zea +dvo: cgrid +dvo: style -lw 2 -c red +dvo: images +dvo: ps ++ +
+In this example, on the graphics window, the image boxes are shown in +red. The user now has the possiblitiy of using the cursor command to +narrow in on a specific region, and so forth. + +\begin{figure} +%\psfig{file=catalog.ps,width=9cm} +\caption{\label{catalog} \small + Comparison between HST GSC and photometry database astrometry. } +\end{figure} + +
+Fig.~\ref{catalog} shows an example comparison of the photometry +database star positions and the HST Guide Star Catalog star positions. +The crosses are all objects in the photometry database, while the +boxes are only the stars identified as USNO stars. The circles are +the stars from the HST GSC. The size of both points is a function of +brightness. This plot was made with the following commands (starting +from the previous image): + +
+dvo: cursor (typed 1 on region of interest) +1 137.097858 22.698305 +q 137.097858 22.698305 +dvo: region $R1 $D1 0.2 TAN +dvo: cgrid +dvo: box +dvo: style -pt 0 +dvo: gcat $R1 $D1 + 0 n2230/1951.cpt * +dvo: style -pt 2; cat -all -m 12 18 +dvo: style -pt 1; cat -all -m 12 18 -ID $USNO +dvo: style -pt 7; cat -all -m 12 18 -g +Index: unk/Ohana/doc/www/html/DVO/cmd-summary.htm =================================================================== --- /trunk/Ohana/doc/www/html/DVO/cmd-summary.htm (revision 4734) +++ (revision ) @@ -1,111 +1,0 @@ - - - - -
| abszero | find filter zeropts |
| applyfit | apply fit to new vector |
| applyfit2d | apply 2-d fit to new vector |
| badimages | look for images with anomalous astrometry |
| box | draw a box on the plot |
| buffers | list the currently allocated buffers |
| calextract | extract photometry calibration |
| calmextract | extract photometry calibration |
| cals | plot calibration data |
| catalog | plot catalog stars |
| ccd | plot color-color diagram |
| ccdextract | extract star coords from color-color diagram |
| center | center image on coords |
| cgrid | plot sky coordinate grid |
| clear | erase plot |
| cmatch | match two catalogs |
| cmd | plot cmd of stars in current region |
| cmdextract | extract stars based on cmd regions |
| cmpread | read data from cmp format files |
| concat | reduce vector dimension |
| contour | create contour from image |
| cplot | plot vectors in sky coordinates |
| create | create a new vector |
| csystem | convert between coordinate systems |
| ctimes | convert between time formats |
| cursor | get coords from cursor |
| czplot | plot scaled vectors in sky coordinates |
| datafile | define file to read vectors |
| date | get current date |
| ddmagextr | plot magnitude differences |
| ddmags | plot magnitude differences |
| delete | delete vectors or matrices |
| device | set / get current graphics device |
| dmagextract | extract stars based on differential magnitudes between filters |
| dmags | plot differential magnitudes between filters |
| dmt | plot mag scatter |
| dumpmags | custom dB dumping thingy |
| elixir | get status info from elixir |
| extract | extract vectors from catalogs |
| file | test for a file |
| fit | fit polynomial to vector pair |
| fit2d | fit 2-d polynomial to vector triplet |
| gaussj | solve Ax = B (N-D)\n |
| gcat | get catalog at location |
| gimages | get images at location |
| grid | plot cartesian grid |
| gstar | get star statistics |
| gtypes | get type fractions |
| histogram | generate histogram from vector |
| images | plot image boxes |
| imbox | plot expected image box |
| imdata | extract data for specific images |
| imdense | image density plot |
| imextract | extract vectors from catalogs |
| imlist | list image info |
| imphot | image photometry info |
| imrough | get info from imruf database |
| imsearch | get info from imreg database |
| imstats | plot image statistics |
| interpolate | interpolate between vector pairs |
| jpeg | write text line on graph |
| labels | define labels for plot |
| lcat | list catalogs in region |
| lcurve | plot lightcurve for a star |
| limits | define plot limits |
| mcreate | create a matrix |
| mextract | extract vectors from catalogs |
| mget | extract a vector from a matrix |
| mset | insert a vector in a matrix |
| pcat | plot catalog boundaries |
| photcodes | list photometry codes |
| photresid | plot photometry residuals |
| plot | plot a pair of vectors |
| pmeasure | plot individual measurements |
| precess | precess coordinates |
| write vectors to file | |
| procks | plot rocks |
| ps | define labels for plot |
| rd | load fits image |
| read | read vectors from datafile |
| region | define sky region for plot |
| resid | plot residuals |
| resize | set graphics/image window size |
| section | define section of graph |
| set | vector math |
| simage | plot stars in an image |
| sort | sort list of vectors |
| sprintf | formated print to variable |
| stats | give statistics on a portion of a buffer |
| style | set the style for graph plots |
| subpix | get subpixel positions |
| subraster | subraster of fits image |
| subset | expand vector dimension |
| textline | write text line on graph |
| tv | display an image on the Kii window |
| uniq | create a uniq vector subset from a vector |
| vclip | clip a vector |
| vectobuf | convert vector triplet to buffer |
| vectors | list vectors |
| vstat | get info from imreg database |
| wd | write an image to a file |
| write | write vectors to datafile |
| zap | delete pixels |
| zeropts | show filter zeropts |
| zplot | plot x y with size scaled by z |
| abszero | find filter zeropts |
| applyfit | apply fit to new vector |
| applyfit2d | apply 2-d fit to new vector |
| badimages | look for images with anomalous astrometry |
| box | draw a box on the plot |
| buffers | list the currently allocated buffers |
| calextract | extract photometry calibration |
| calmextract | extract photometry calibration |
| cals | plot calibration data |
| catalog | plot catalog stars |
| ccd | plot color-color diagram |
| ccdextract | extract star coords from color-color diagram |
| center | center image on coords |
| cgrid | plot sky coordinate grid |
| clear | erase plot |
| cmatch | match two catalogs |
| cmd | plot cmd of stars in current region |
| cmdextract | extract stars based on cmd regions |
| cmpread | read data from cmp format files |
| concat | reduce vector dimension |
| contour | create contour from image |
| cplot | plot vectors in sky coordinates |
| create | create a new vector |
| csystem | convert between coordinate systems |
| ctimes | convert between time formats |
| cursor | get coords from cursor |
| czplot | plot scaled vectors in sky coordinates |
| datafile | define file to read vectors |
| date | get current date |
| ddmagextr | plot magnitude differences |
| ddmags | plot magnitude differences |
| delete | delete vectors or matrices |
| device | set / get current graphics device |
| dmagextract | extract stars based on differential magnitudes between filters |
| dmags | plot differential magnitudes between filters |
| dmt | plot mag scatter |
| dumpmags | custom dB dumping thingy |
| elixir | get status info from elixir |
| extract | extract vectors from catalogs |
| file | test for a file |
| fit | fit polynomial to vector pair |
| fit2d | fit 2-d polynomial to vector triplet |
| gaussj | solve Ax = B (N-D)\n |
| gcat | get catalog at location |
| gimages | get images at location |
| grid | plot cartesian grid |
| gstar | get star statistics |
| gtypes | get type fractions |
| histogram | generate histogram from vector |
| images | plot image boxes |
| imbox | plot expected image box |
| imdata | extract data for specific images |
| imdense | image density plot |
| imextract | extract vectors from catalogs |
| imlist | list image info |
| imphot | image photometry info |
| imrough | get info from imruf database |
| imsearch | get info from imreg database |
| imstats | plot image statistics |
| interpolate | interpolate between vector pairs |
| jpeg | write text line on graph |
| labels | define labels for plot |
| lcat | list catalogs in region |
| lcurve | plot lightcurve for a star |
| limits | define plot limits |
| mcreate | create a matrix |
| mextract | extract vectors from catalogs |
| mget | extract a vector from a matrix |
| mset | insert a vector in a matrix |
| pcat | plot catalog boundaries |
| photcodes | list photometry codes |
| photresid | plot photometry residuals |
| plot | plot a pair of vectors |
| pmeasure | plot individual measurements |
| precess | precess coordinates |
| write vectors to file | |
| procks | plot rocks |
| ps | define labels for plot |
| rd | load fits image |
| read | read vectors from datafile |
| region | define sky region for plot |
| resid | plot residuals |
| resize | set graphics/image window size |
| section | define section of graph |
| set | vector math |
| simage | plot stars in an image |
| sort | sort list of vectors |
| sprintf | formated print to variable |
| stats | give statistics on a portion of a buffer |
| style | set the style for graph plots |
| subpix | get subpixel positions |
| subraster | subraster of fits image |
| subset | expand vector dimension |
| textline | write text line on graph |
| tv | display an image on the Kii window |
| uniq | create a uniq vector subset from a vector |
| vclip | clip a vector |
| vectobuf | convert vector triplet to buffer |
| vectors | list vectors |
| vstat | get info from imreg database |
| wd | write an image to a file |
| write | write vectors to datafile |
| zap | delete pixels |
| zeropts | show filter zeropts |
| zplot | plot x y with size scaled by z |
-gcat -- get catalog at location -gimages -- get images at location -gstar -- get star statistics -extract -- extract average vectors from catalogs -mextract -- extract measurement vectors from catalogs -imstats -- plot image statistics -imextract -- extract image vectors from database -lcat -- list catalogs in display region -cmatch -- match two catalogs -- -
-There are a variety of other commands which directly refer to the -photometry database. Some of these functions extract data of various -types from the database, others perform more complex plotting -operations. The commands listed above are those which simply extract -data from the database. The first three list information relevant to -a specific RA, DEC location on the sky: gcat (RA) (DEC) lists -the catalog at the specified location and places the name in the -variable $CATNAME, gimages (RA) (DEC) lists all images -which overlap the specified location, gstars (RA) (DEC) (RADIUS) -lists data about the stars within a specified radius of the specified -location (all numbers above are given in decimal degrees). Similarly, -lcat lists the catalogs in the region. Imstats lists statistics -about each image - -
-The next three commands extract a specific piece of information from -the photometry database and places it in a vector. First, -extract will extract average values for each star and place -it in a vector. Next, mextract will extract measurement -values for each star and place it in a vector: as a result a single -star may have multiple entries in the measurement vectors. Finally, -imextract will extract image statistics into vectors (not yet -implemented). - - -
-catalog -- plot catalog stars -cgrid -- plot sky coordinate grid -cplot -- plot vectors in sky coordinates -czplot -- plot scaled vectors in sky coordinates -images -- plot image boxes -imdense -- image density plot -lcurve -- plot lightcurve for a star -pcat -- plot catalog boundaries -region -- define sky region for plot -resid -- plot residuals -simage -- plot stars in an image -- -
-There are two types of database plotting functions: those that display -or refer to the spatial charateristics of the data and those that -refer to other types of charatersitics, such as the time domain. The -graphics window 0 is reserved for all plots of objects on the sky. -The command region defines the current sky coordinates for plots -in graphic window 0. The command pcat plots the outline of all -photometry database files which are within the currently defined -region (and by default, only those with data). images plots the -outline of the images in the image database, while imdense shows -the number of images at a location by randomly spacing dots within the -boundary of the images. The command cgrid -draws a grid in celestial coordinates on the for the current region. - -
-The most complex, but also one of the most useful command is -catalog, which plots the positions of stars in the photometry -database (and others) on the sky. There are many options to this -command. One set allows the user to plot stars from the photometry -database (the default), from the HST GSC, or from an ASCII text file -with RA, DEC, and Mag in specified columns. If the ASCII file has a -fixed number of bytes per line, the data can be more quickly loaded. -The size of the points may be scaled by the star magnitude, by the -number of observations of the star, or by the number of missing -datapoints for the star. In addition, points may be plotted only if -they land in specified magnitude ranges, or with specified numbers of -measurements, or missed measurements. Also, objects may be plotted -only if they have a specified Average.code, so that only asteroids or -only perfect stars may be plotted. The plotted vectors may be saved, -if desired, and the source catalog epoch may be specified as different -from J2000 (only valid for ASCII data). - -
-Several other commands relate to non-spatial charateristics of images -and stars. lcurve will plot a light curve for all stars within -some radius of a point. resid plots the photometry residuals -for a particular region file. - -
-Fig.~\ref{allsky} shows a map of the entire sky, and the location -of the images currently in the database. This picture was made with -the following commands: (output is not shown) - -
-dvo: region 0 0 90 gls -dvo: cgrid -dvo: style -lw 2 -c red -dvo: images -dvo: ps -- -
-In this example, on the graphics window, the image boxes are shown in -red. The user now has the possiblitiy of using the cursor command to -narrow in on a specific region, and so forth. - -\begin{figure} -%\psfig{file=polar.ps,width=16cm} -\caption{\label{polar} \small - Map of the sky in polar project, and images added to database. } -\end{figure} - -
-Fig.~\ref{allsky} shows a map of the entire sky, and the location of -the images currently in the database from a polar project. This -picture was made with the following commands: (output is not shown) - -
-dvo: region 0 0 90 zea -dvo: cgrid -dvo: style -lw 2 -c red -dvo: images -dvo: ps -- -
-In this example, on the graphics window, the image boxes are shown in -red. The user now has the possiblitiy of using the cursor command to -narrow in on a specific region, and so forth. - -\begin{figure} -%\psfig{file=catalog.ps,width=9cm} -\caption{\label{catalog} \small - Comparison between HST GSC and photometry database astrometry. } -\end{figure} - -
-Fig.~\ref{catalog} shows an example comparison of the photometry -database star positions and the HST Guide Star Catalog star positions. -The crosses are all objects in the photometry database, while the -boxes are only the stars identified as USNO stars. The circles are -the stars from the HST GSC. The size of both points is a function of -brightness. This plot was made with the following commands (starting -from the previous image): - -
-dvo: cursor (typed 1 on region of interest) -1 137.097858 22.698305 -q 137.097858 22.698305 -dvo: region $R1 $D1 0.2 TAN -dvo: cgrid -dvo: box -dvo: style -pt 0 -dvo: gcat $R1 $D1 - 0 n2230/1951.cpt * -dvo: style -pt 2; cat -all -m 12 18 -dvo: style -pt 1; cat -all -m 12 18 -ID $USNO -dvo: style -pt 7; cat -all -m 12 18 -g -Index: /trunk/Ohana/doc/www/html/IPP-subsystems/pclient/index.htm =================================================================== --- /trunk/Ohana/doc/www/html/IPP-subsystems/pclient/index.htm (revision 4734) +++ /trunk/Ohana/doc/www/html/IPP-subsystems/pclient/index.htm (revision 4735) @@ -32,18 +32,19 @@ samping pcontrol with output from the jobs. -
pclient has a very limited command set, as follows: -
+job : start the job (UNIX command) in the background. +check : return the current job status +status : return the current job status (?) +stdout : dump the stdout stream accumulated from the job + back to the calling program. +stderr : dump the stderr stream accumulated from the job + back to the calling program. +reset : kill (if needed) the job and reset to accept + another job. ++ Index: /trunk/Ohana/doc/www/html/IPP-subsystems/pcontrol/index.htm =================================================================== --- /trunk/Ohana/doc/www/html/IPP-subsystems/pcontrol/index.htm (revision 4734) +++ /trunk/Ohana/doc/www/html/IPP-subsystems/pcontrol/index.htm (revision 4735) @@ -245,2 +245,17 @@ IPP Image Server. +
+check -- get job or host status +delete -- delete job +host -- add / delete / modify host +job -- add job +jobstack -- list jobs for a single stack +kill -- kill job +pulse -- set system pulse +status -- get system status +stderr -- get stderr buffer for job +stdout -- get stdout buffer for job +verbose -- set the verbose mode for job +Index: /trunk/Ohana/doc/www/html/IPP-subsystems/psched/index.htm =================================================================== --- /trunk/Ohana/doc/www/html/IPP-subsystems/psched/index.htm (revision 4734) +++ /trunk/Ohana/doc/www/html/IPP-subsystems/psched/index.htm (revision 4735) @@ -363,2 +363,23 @@ task and job lists with the command pulse (usec)Command Summary + +
+controller -- controller commands +task -- define a schedulable task +host -- define host machine for a task +nmax -- define maximum number of jobs for a task +trange -- define valid/invalid time periods for a task +task.exit -- define exit macros for a task +task.exec -- define pre-exec macro for a task +command -- define executed command for a task +periods -- define time scales for a task +run -- run the scheduler +stop -- stop the scheduler +pulse -- set the scheduler update period +status -- get system status +kill -- kill job +delete -- delete job +verbose -- set/toggle verbose mode +Index: /trunk/Ohana/doc/www/html/Opihi-Programs/DIMM/commands.htm =================================================================== --- /trunk/Ohana/doc/www/html/Opihi-Programs/DIMM/commands.htm (revision 4735) +++ /trunk/Ohana/doc/www/html/Opihi-Programs/DIMM/commands.htm (revision 4735) @@ -0,0 +1,59 @@ + + + + +
| altaz | altaz / celestial coord conversions |
| box | draw a box on the plot |
| buffers | list the currently allocated buffers |
| camera | camera functions |
| center | center the Kii window at coords |
| clear | erase plot |
| clip | clip values in a buffer to be within a range |
| concat | expand vector dimension |
| coords | load coordinates for buffer from file |
| create | create a new vector |
| cursor | get coordinates from the Kii window |
| cut | extract a cut across an image |
| datafile | define file to read vectors |
| delete | delete a buffer |
| erase | erase objects on an overlay |
| extract | extract a portion of a buffer into another buffer |
| file | test file |
| findstars | find objects on image |
| focus | skyprobe focus |
| gauss | get statistics on a star, assuming gaussian profile |
| getchr | find character in string |
| header | print buffer header |
| histogram | histogram of vector |
| imhist | histogram of an image region |
| jpeg | interpolate between vector pairs |
| keyword | extract a FITS keyword from buffer header |
| labels | define labels for plot |
| limits | define plot limits |
| load | load an SAOimage style overlay |
| mcreate | create a matrix |
| plot | plot a pair of vectors |
| ps | make PS file from Kii |
| rd | read an image from a file |
| read | read vectors from datafile |
| rebin | rebin data by factor of N |
| resize | change Kii window size |
| save | save an SAOimage style overlay |
| set | do image arithmetic |
| sort | sort vectors by key |
| sprintf | formatted print to a variable |
| star | star stats at rough coords |
| stats | give statistics on a portion of a buffer |
| strlen | string length |
| style | set the style for graph plots |
| subset | reduce vector dimension |
| substr | substring |
| telescope | telescope communications |
| textline | write text on Kapa window |
| tv | display an image on the Kii window |
| vectors | list vectors |
| vstat | vector statistics |
| wd | write an image to a file |
| write | write vectors to datafile |
+altaz -- altaz / celestial coord conversions +camera -- camera functions +findstars -- find objects on image +telescope -- telescope communications +Index: unk/Ohana/doc/www/html/Opihi-Programs/DIMM/userguide.htm =================================================================== --- /trunk/Ohana/doc/www/html/Opihi-Programs/DIMM/userguide.htm (revision 4734) +++ (revision ) @@ -1,59 +1,0 @@ - - - - -
| altaz | altaz / celestial coord conversions |
| box | draw a box on the plot |
| buffers | list the currently allocated buffers |
| camera | camera functions |
| center | center the Kii window at coords |
| clear | erase plot |
| clip | clip values in a buffer to be within a range |
| concat | expand vector dimension |
| coords | load coordinates for buffer from file |
| create | create a new vector |
| cursor | get coordinates from the Kii window |
| cut | extract a cut across an image |
| datafile | define file to read vectors |
| delete | delete a buffer |
| erase | erase objects on an overlay |
| extract | extract a portion of a buffer into another buffer |
| file | test file |
| findstars | find objects on image |
| focus | skyprobe focus |
| gauss | get statistics on a star, assuming gaussian profile |
| getchr | find character in string |
| header | print buffer header |
| histogram | histogram of vector |
| imhist | histogram of an image region |
| jpeg | interpolate between vector pairs |
| keyword | extract a FITS keyword from buffer header |
| labels | define labels for plot |
| limits | define plot limits |
| load | load an SAOimage style overlay |
| mcreate | create a matrix |
| plot | plot a pair of vectors |
| ps | make PS file from Kii |
| rd | read an image from a file |
| read | read vectors from datafile |
| rebin | rebin data by factor of N |
| resize | change Kii window size |
| save | save an SAOimage style overlay |
| set | do image arithmetic |
| sort | sort vectors by key |
| sprintf | formatted print to a variable |
| star | star stats at rough coords |
| stats | give statistics on a portion of a buffer |
| strlen | string length |
| style | set the style for graph plots |
| subset | reduce vector dimension |
| substr | substring |
| telescope | telescope communications |
| textline | write text on Kapa window |
| tv | display an image on the Kii window |
| vectors | list vectors |
| vstat | vector statistics |
| wd | write an image to a file |
| write | write vectors to datafile |
| accum | accumulate vector values in another vector | |
| applyfit | apply fit coeffs to generate vector | |
| applyfit2d | apply fit coeffs to generate vector | |
| biassub | subtract medianed overscan row or column | |
| box | draw a box on the plot | |
| buffers | list the currently allocated buffers | |
| buftovec | convert an image buffer to a single vector | |
| center | center the Kii window at coords | |
| clear | erase plot | |
| clip | clip values in a buffer to be within a range | |
| cmpload | load stars from a cmp file on overlay | |
| concat | expand vector dimension | |
| contour | send contour to overlay | |
| coords | load coordinates for buffer from file | |
| create | create a new vector | |
| cursor | get coordinates from the Kii window | |
| cut | extract a cut across an image | |
| cval | small median image | |
| datafile | define file to read vectors | |
| delete | delete a buffer | |
| demux | demux an image pixels interleaved in Nx by Ny sections | |
| device | set / get current graphics device | |
| dimendown | convert matrix to vector | |
| dimenup | convert vector to matrix | |
| drizzle | transform image to image | |
| erase | erase objects on an overlay | |
| extract | extract a portion of a buffer into another buffer | |
| fft1d | fft on the pixel-stream in an image | |
| fft2d | fft on an image | |
| file | test file | |
| fit | least-squares fit to vectors | |
| fit2d | least-squares fit to vectors | |
| flux | flux in a convex contour | |
| gauss | get statistics on a star, assuming gaussian profile | |
| gaussj | solve Ax = B (N-D) | |
| getchr | find character in string | |
| grid | wait until return is typed | |
| header | print buffer header | |
| histogram | histogram of vector | |
| imfit | fit function | |
| imhist | histogram of an image region | |
| integrate | integrate a vector | |
| interpolate | interpolate between vector pairs | |
| jpeg | interpolate between vector pairs | |
| kern | convolve with 3x3 kernel | |
| keyword | extract a FITS keyword from buffer header | |
| labels | define labels for plot | |
| limits | define plot limits | |
| load | load an SAOimage style overlay | |
| mcreate | create a matrix | |
| medianmap | small median image | |
| memory | long listing of the allocated memory | |
| mget | extract a vector from a matrix | |
| minterp | interpolate image pixels | |
| mkgauss | insert a gaussian in an image | |
| mset | insert a vector in a matrix | |
| multifit | solve for overlapping orders in ESI data | |
| objload | load stars from an obj file on overlay | |
| outline | vector statistics | |
| peak | find vector peak in range | |
| plot | plot a pair of vectors | |
| point | load overlay with single point | |
| profile | radial profile at X, Y | |
| ps | make PS file from Kii | |
| rd | read an image from a file | |
| read | read vectors from datafile | |
| rebin | rebin data by factor of N | |
| resize | change Kii window size | |
| roll | roll image to new start point | |
| rotate | rotate image | |
| save | save an SAOimage style overlay | |
| scalen | get / set real bzero / bscale values | |
| section | define section of graph | |
| select | selective vector assignment | |
| set | do image arithmetic | |
| sexigesimal | convert to/from sexigesimal/decimal | |
| shift | shift data in an image | |
| simsignal | simulate sine-wave with Nbit A/D and given S/N | |
| sort | sort vectors by key | |
| spline.apply | apply spline fit to generate an image | |
| spline.construct | create spline 2nd deriv. terms | |
| sprintf | formatted print to a variable | |
| star | star stats at rough coords | |
| stats | give statistics on a portion of a buffer | |
| strlen | string length | |
| style | set the style for graph plots | |
| subset | reduce vector dimension | |
| substr | substring | |
| svd | singular value decomposition of a matrix | |
| swapbytes | byte swap thing | |
| textline | write text on Kapa window | |
| tv | display an image on the Kii window | |
| uniq | create a uniq vector subset from a vector | |
| unsign | toggle the UNSIGN status | |
| vclip | clip values in a vector to be within a range | |
| vcontour | create contour vectors | |
| vectors | list vectors | |
| vstat | vector statistics | |
| wd | write an image to a file | |
| write | write vectors to datafile | |
| zap | delete pixels | |
| zplot | plot x y with size scaled by z |
| accum | accumulate vector values in another vector | |
| applyfit | apply fit coeffs to generate vector | |
| applyfit2d | apply fit coeffs to generate vector | |
| biassub | subtract medianed overscan row or column | |
| box | draw a box on the plot | |
| buffers | list the currently allocated buffers | |
| buftovec | convert an image buffer to a single vector | |
| center | center the Kii window at coords | |
| clear | erase plot | |
| clip | clip values in a buffer to be within a range | |
| cmpload | load stars from a cmp file on overlay | |
| concat | expand vector dimension | |
| contour | send contour to overlay | |
| coords | load coordinates for buffer from file | |
| create | create a new vector | |
| cursor | get coordinates from the Kii window | |
| cut | extract a cut across an image | |
| cval | small median image | |
| datafile | define file to read vectors | |
| delete | delete a buffer | |
| demux | demux an image pixels interleaved in Nx by Ny sections | |
| device | set / get current graphics device | |
| dimendown | convert matrix to vector | |
| dimenup | convert vector to matrix | |
| drizzle | transform image to image | |
| erase | erase objects on an overlay | |
| extract | extract a portion of a buffer into another buffer | |
| fft1d | fft on the pixel-stream in an image | |
| fft2d | fft on an image | |
| file | test file | |
| fit | least-squares fit to vectors | |
| fit2d | least-squares fit to vectors | |
| flux | flux in a convex contour | |
| gauss | get statistics on a star, assuming gaussian profile | |
| gaussj | solve Ax = B (N-D) | |
| getchr | find character in string | |
| grid | wait until return is typed | |
| header | print buffer header | |
| histogram | histogram of vector | |
| imfit | fit function | |
| imhist | histogram of an image region | |
| integrate | integrate a vector | |
| interpolate | interpolate between vector pairs | |
| jpeg | interpolate between vector pairs | |
| kern | convolve with 3x3 kernel | |
| keyword | extract a FITS keyword from buffer header | |
| labels | define labels for plot | |
| limits | define plot limits | |
| load | load an SAOimage style overlay | |
| mcreate | create a matrix | |
| medianmap | small median image | |
| memory | long listing of the allocated memory | |
| mget | extract a vector from a matrix | |
| minterp | interpolate image pixels | |
| mkgauss | insert a gaussian in an image | |
| mset | insert a vector in a matrix | |
| multifit | solve for overlapping orders in ESI data | |
| objload | load stars from an obj file on overlay | |
| outline | vector statistics | |
| peak | find vector peak in range | |
| plot | plot a pair of vectors | |
| point | load overlay with single point | |
| profile | radial profile at X, Y | |
| ps | make PS file from Kii | |
| rd | read an image from a file | |
| read | read vectors from datafile | |
| rebin | rebin data by factor of N | |
| resize | change Kii window size | |
| roll | roll image to new start point | |
| rotate | rotate image | |
| save | save an SAOimage style overlay | |
| scalen | get / set real bzero / bscale values | |
| section | define section of graph | |
| select | selective vector assignment | |
| set | do image arithmetic | |
| sexigesimal | convert to/from sexigesimal/decimal | |
| shift | shift data in an image | |
| simsignal | simulate sine-wave with Nbit A/D and given S/N | |
| sort | sort vectors by key | |
| spline.apply | apply spline fit to generate an image | |
| spline.construct | create spline 2nd deriv. terms | |
| sprintf | formatted print to a variable | |
| star | star stats at rough coords | |
| stats | give statistics on a portion of a buffer | |
| strlen | string length | |
| style | set the style for graph plots | |
| subset | reduce vector dimension | |
| substr | substring | |
| svd | singular value decomposition of a matrix | |
| swapbytes | byte swap thing | |
| textline | write text on Kapa window | |
| tv | display an image on the Kii window | |
| uniq | create a uniq vector subset from a vector | |
| unsign | toggle the UNSIGN status | |
| vclip | clip values in a vector to be within a range | |
| vcontour | create contour vectors | |
| vectors | list vectors | |
| vstat | vector statistics | |
| wd | write an image to a file | |
| write | write vectors to datafile | |
| zap | delete pixels | |
| zplot | plot x y with size scaled by z |
+ findpeaks -- find image peaks + fitcontour -- fit ellipse contour + starcontour -- object contour + rawstars -- find raw star stats + biassub -- subtract medianed overscan row or column + cgrid -- plot sky coordinate grid + coords -- load coordinates for buffer from file + cplot -- plot vectors in sky coordinates + csystem -- convert between coordinate systems + ctimes -- convert between time formats + cval -- cosmic ray flux? + czplot -- plot scaled vectors in sky coordinates + drizzle -- transform image to image + flux -- flux in a convex contour + gauss -- get statistics on a star, assuming gaussian profile + getvel -- rotcurve to velocities + imfit -- fit function + imsub -- subtract function + medianmap -- small median image + mkgauss -- generate a 2-D gaussian centered in image + multifit -- fit multi-order spectrum + objload -- plot obj data on Ximage + outline -- fit outline region + polar -- convert polar image to cartesian + precess -- precess coordinates + profile -- radial profile at X, Y + region -- define sky region for plot + rotcurve -- convert CO images to polar coords + scale -- get / set real bzero / bscale values + sexigesimal -- convert to/from sexigesimal/decimal + spec -- extract a spectrum + star -- star stats at rough coords + transform -- geometric transformation of image +Index: /trunk/Ohana/doc/www/html/Opihi-Programs/index.htm =================================================================== --- /trunk/Ohana/doc/www/html/Opihi-Programs/index.htm (revision 4734) +++ /trunk/Ohana/doc/www/html/Opihi-Programs/index.htm (revision 4735) @@ -28,5 +28,5 @@
The command-line interaction is based on the readline libraries and -behaves like #tcsh/#. Arrows can be used for editing. There is both +behaves like tcsh. Arrows can be used for editing. There is both command and file completion with the TAB key. You can also use emacs-like commands such as ctrl-a to reach the beginning of the line @@ -59,11 +59,12 @@ consist of the standard math operators (+,-,*,/) as well as any already-defined variables and the functions log(), ln(), sqrt(), -exp(), ten() ($10^x$), sin(), cos(), etc. Other special operators are -the carret (^) for exponetiation (eg, 2^3 is 8) and the @ symbol as a -binary arc-tangent (eg, 1@3 is 18.43 degrees). In addition, the -operator #<>/# returns the maximum. Variables can be numeric or character -strings. If the shell does not understand the syntax of the line as a -math expression, it is assumed to be a string. +exp(), ten() (10x), sin(), cos(), etc. Other special +operators are the carret (^) for exponetiation (eg, 2^3 is 8) and the +@ symbol as a binary arc-tangent (eg, 1@3 is 18.43 degrees). In +addition, the operator << returns the minimum of the two +surrounding values, and >> returns the maximum. Variables +can be numeric or character strings. If the shell does not understand +the syntax of the line as a math expression, it is assumed to be a +string. local variables @@ -82,8 +83,8 @@ would give the response 7.07107 if $fred had the value of 10.0. There -are math functions #cos/#, #sin/#, and #tan/#, which operate on radian -expressions, and also #dcos/#, #dsin/#, #dtan/#, which operate on +are math functions cos, sin, and tan, which operate on radian +expressions, and also dcos, dsin, dtan, which operate on degree expressions. There are also the equivalent inverse functions: -eg., #asin/# and #dasin/# return radians and degrees, respectively. +eg., asin and dasin return radians and degrees, respectively. The help section on Math defines all of the available math functions. @@ -130,4 +131,13 @@
+queuelist -- list existing queues +queuesize -- return the length of the given queue +queueinit -- create a zero-length queues +queuedelete -- delete a queues +queuepush -- add an item to the end of the queue +queuepop -- remove and return the first item in the queue +A queue is a data construct consisting of a sequence of lines from @@ -267,41 +277,115 @@ exit -- exit program help -- get help on a function +config -- reload configuration information +exit -- exit program +quit -- exit program +wait -- wait until return is typed +sleep -- sleep for N seconds +usleep -- sleep for N microseconds +which -- show command +cd -- change current working directory +pwd -- report current working directory +date -- return the current date +file -- test file existence +memory -- long listing of the allocated memory +version -- list version information + + +Most of these commands should be clear from the simple descriptions +above, or from the online help. The command ?? prints the system +variables. The help command will provide help on a single +command or, without any arguments, will list all available help files +(this includes general help not associated with a specific command). + +
+local -- define local variables output -- redirect output to file -quit -- exit program scan -- scan line from keyboard or file to variable -wait -- wait until return is typed -which -- show command -- -Most of these are self-explanatory. The command ?? prints the system -variables. The help command will provide help on a single -command or, without any arguments, will list all available help -files (this includes general help not associated with a specific -command). - -output - -scan - -
+create -- create a new vector +hist -- create histogram from a vector +print -- write vectors to file +vectors -- list vectors +accum -- accumulate vector values in another vector +applyfit -- apply fit to new vector +applyfit2d -- apply 2-d fit to new vector +circstats -- circular statistics +concat -- reduce vector dimension +datafile -- define file to read vectors +delete -- delete vectors or matrices +fft1d -- fft on the pixel-stream in an image +fit -- fit polynomial to vector pair +gaussdev -- generate a gaussian deviate vector +gaussint -- return the integrated gaussian vector +histogram -- generate histogram from vector +integrate -- integrate a vector +interpolate -- interpolate between vector pairs +vectors -- list vectors +medacc -- accumulate vector values in another vector +peak -- find vector peak in range +read -- read vectors from datafile +set -- image and vector math +sort -- sort list of vectors +subset -- expand vector dimension +uniq -- create a uniq vector subset from a vector +vbin -- bin values in a vector to be within a range +vclip -- clip values in a vector to be within a range +select -- selective vector assignment +vgauss +vgrid +vload -- load vectors on Kii +vstat -- get info from imreg database +vsmooth -- gaussian smooth of a vector +vroll -- roll vector elements +vpop -- remove first element +write -- write vectors to datafile ++ +
box -- draw a box on the plot clear -- erase plot -create -- create a new vector cursor -- get coords from cursor grid -- plot cartesian grid -hist -- create histogram from a vector labels -- define labels for plot limits -- define plot limits plot -- plot a pair of vectors -print -- write vectors to file ps -- define labels for plot -set -- vector math style -- set the style for graph plots -vectors -- list vectors zplot -- plot scaled points +device -- set / get current graphics device +jpeg -- write text line on graph +line -- plot line +dot -- plot a single point +resize -- set graphics/image window size +section -- define section of graph +textline -- write text line on graph +zplot -- plot x y with size scaled by z@@ -314,17 +398,13 @@
-In addition to scalar variables, status can manipulate and -display 1-D vector variables. Many of the commands which extract data -from the photometry database place the data in vectors as well as -plotting them. A vector can also be created based on a number -sequence with the command create name Nelements start delta. -The resulting vector has $Nelements$ entries, starting at a value of -$start$ and running until $start + delta*Nelements$. If $delta$ is -0.0, all elements will have the value of $start$. A histogram of a vector -may be made with the command hist, which creates a new vector -containing the histogram of the first vector. The data range and bin -size of the histogram are defined in same way as with create. This -makes it easy to create the index vector that goes with a histogram -vector: +A vector can be created based on a number sequence with the command +create name Nelements start delta. The resulting vector has +#Nelements/# entries, starting at a value of #start/# and running +until #start + delta*Nelements/#. If #delta/# is 0.0, all elements +will have the value of #start/#. A histogram of a vector may be made +with the command hist, which creates a new vector containing +the histogram of the first vector. The data range and bin size of the +histogram are defined in same way as with create. This makes it easy +to create the index vector that goes with a histogram vector:
@@ -411,6 +491,73 @@ green, blue, and yellow overlays. -programming considerations
+Image Manipulation Functions
+ ++clip -- clip values in a buffer to be within a range +contour -- create contour from image +cut -- extract a cut across an image +extract -- extract a portion of a buffer into another buffer +fft2d -- fft on an image +fit2d -- fit 2-d polynomial to vector triplet +header -- print buffer header +imcut -- linear image cut between arbitrary coords +imhist -- histogram of an image region +imsmooth -- circular gaussian smoothing +kern -- convolve with 3x3 kernel +keyword -- extract a FITS keyword from buffer header +buffers -- list the currently allocated buffers +mcreate -- create a matrix +minterp -- interpolate image pixels +rd -- load fits image +rdseg -- read a segment of an image from a file +rebin -- rebin data by factor of N +roll -- roll image to new start point +rotate -- rotate image +set -- image and vector math +shift -- shift data in an image +spline.apply -- apply spline fit to generate an image +spline.const -- create spline 2nd deriv. terms +stats -- give statistics on a portion of a buffer +subraster -- subraster of fits image +unsign -- toggle the UNSIGN status +wd -- write an image to a file +zap -- delete pixels ++ +The Image Display Window (Kii)
+ ++ps -- define labels for plot +center -- center image on coords +device -- set / get current graphics device +erase -- erase objects on an overlay +jpeg -- write text line on graph +load -- load an SAOimage style overlay +point -- load overlay with single point +save -- save an SAOimage style overlay +resize -- set graphics/image window size +tv -- display an image on the Kii window +tvcontour -- send contour to overlay +tvgrid -- wait until return is typed ++ + +Other data functions
+ ++gaussj -- solve Ax = B (N-D) +gridify -- convert vector triplet to buffer +ungridify -- convert buffer region to vector triplet +dimendown -- convert matrix to vector +dimenup -- convert vector to matrix +mget -- extract a vector from a matrix +mset -- insert a vector in a matrix +svd -- singular value decomposition of a matrix +swapbytes -- byte swap thing ++ + + +Programming Considerations
The programming structure of the Opihi front-end -makes it very easy to add commands to the package; more about this -later. +makes it very easy to add commands to the package.