+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/DVO/cmd-summary.htm =================================================================== --- trunk/Ohana/doc/www/html/DVO/cmd-summary.htm (revision 4733) +++ (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 -