next up previous contents
Next: 7. Commands G-R Up: XIMAGE User's Guide Previous: 5. Mosaics   Contents

Subsections

6. Commands A-F

6.1 alias - rename a command string

    alias [name] [command_string]

Rename a command string to an alias name. name specifies the new name, command_string is that to be renamed. The command string is exactly as it would be given on the command line.

From session to session, aliases are not saved. In order to retain an alias definition from one session to the next, edit or create ~/.ximagerc to contain alias commands which will be executed at each startup.

Examples:
     
    alias ls "syscall ls"   ! alias ls to run the ls command in the shell

6.2 background - calculate average image background

    background[/qualifiers]

The method used consists in dividing the image in n equal small square boxes where the local background intensity is estimated. The event distribution in each box is checked for spatial uniformity and consistency with the expected statistical distribution (Poisson). If inconsistency between the observed and expected distribution is found the box is rejected. The distribution of the average background values in all boxes is then compared to a Gaussian distribution with mean equal to the mean of all the background values found. All boxes where the background level is more than sigmult (default=3.0) standard deviations away from the mean are rejected. If more than 80% of the boxes are rejected the background routine stops and an error message is generated. The value of the background intensity returned is the average of the values measured in all accepted boxes.

The default box size used in the calculation ranges between 1/8 of the image size up to a maximum of 64 pixels. The minimum box size is 8 pixels. The qualifier box_size allows to input an arbitrary value, while the qualifier optimize determines the best box size to have the smaller background rate.

Changing the chatter to 20 or higher (command chatter 20 20 ) and using the background/draw, all the boxes, in which the image has been divided, will be drawn and numbered on the display. The rejected boxes will be colored, and the reason why they have been rejected will be printed on the screen. If the rejection of boxes is not satisfactory, it is recommended, for a given box size, to use the qualifiers bxhprob, sigmult, barylim.

Some commands, such as excess, smooth, remove_sources, and psf may require the calculation of the background. The results of the last execution of the background command is used by default in these commands However, if the background command has not been executed or background/reset has been run, these commands may calculate the background with their own default parameters. When a new image is read or restore from memory, the previous calculation of background is cleared from memory.

background/draw_rej_back_boxes
Display all background boxes which have NOT been used for the estimation of the background. If the chatter is higher than 20, all the boxes will be drawn but only the rejected boxes will have a color different from white.

background/box_size=n
Defines the size (in image pixels) of the boxes where the image background is estimated. Recommended background box sizes are powers of two, such as 16, 32, 64, and 128.

background/optimize
Go through a range of background boxes and determine the optimum box size to give a minimum background counting rate.

background/barylim=x
This box rejection criteria checks a box's spatial uniformity by calculating the barycenter of the box based on the pixel weights. If the barycenter deviates from the physical center of the box by more than x it is rejected. The units for x are such that 1.0 is the width of the box. The default value is 0.35. At high chatter the boxes rejected by this criteria are identified by the message barycenter greater than x from the center. This rejects boxes that contain 'excess counts' away from the center. This is the second rejection criteria used, and it is applied on the residual boxes after the first rejection criteria.

background/bxhprob=x
This box rejection criteria compares the population of the left half of the box with the right half and the top half with the bottom half using a chi-square test. The value x is the minimum acceptable probability. For example, 1.0 is the most restrictive. The default value for bxhprob is 0.0, which never rejects a box. At high chatter the boxes rejected by this criteria are identified by the message Box half max prob > x . This is the first rejection criterion used in established to good background boxes.

background/sigmult=x
The final rejection criteria for background boxes calculates the distribution of the average background values in all the remaining boxes and compares them to a Gaussian distribution with mean equal to the mean of all the background values found. All boxes where the background level is more than x standard deviations away from the mean are rejected. The default value is 3.0. Using lower value for x will force to reject more boxes. At high chatter the boxes rejected by this criteria are identified by the message Background too far from avg.

background/outfile=filename
The results of the background command are saved as text into a file.

background/infile=filename
The results of the background command are read in from a text file generated by using the outfile qualifier. This is useful to avoid a re-run of the background calculation on the same image.

background/flat_value=x
The background results are set to x, a constant value. The value of x is in units of count for original pixel, e.g. it is the background value of the unbinned image.

background/reset
The background results are erased, as if the background calculation was never performed. Commands requiring a background calculation will either perform the calculation internally or fail with an error.

background/npd=n
A count distribution, P(D), is obtained from the residual boxes used to calculate the background. The qualifier npd=n is the number of count intervals (bins) into which the distribution is divided. This qualifier has only effect if used in conjunction with /plot_pd to get a plot of the distribution or with /file_pd=[filename] to write out the distribution.

background/plot_pd
This calculates, plots and writes out the distribution, P(D), of count intervals for the residuals boxes used in the background calculation. The number of bin for the distribution can be input using the qualifier /npd=n, otherwise a default of 8 is used. The P(D) distribution is written to a file by default named pd.qdp. Different output filename can be selected with /file_pd=[filename].

background/file_pd=[filename]
This calculates and writes out in the filename the distribution, P(D), of counts interval for the residual boxes used to determine the background. The default number of bin for the distribution is 8. The qualifier /npd=n allows to change the default number to n.

Examples:
    background/opt                ! calculate the optimum background
     
    background/box=32             ! calculate the average image background
                                  ! using square boxes of size=32 image pixels.
     
    background/draw               ! use the default box size and draw the
                                  ! boxes that have been rejected
     
    background/npd=20/plot        ! do a P(D), count distribution in 20 bins
                                  ! ct bins and plot the result

6.3 bglevels - calculate background levels

      bglevels[/qualifiers]

Primarily for internal use by contour/statistic. Calculates levels based on background calculation. If the background command has been executed, that background is used, otherwise the background command is run automatically with no options. Calling bglevels with no options is equivalent to bglevels/sigma_levels="2 3 4 6 9 12 18 35 100"

bglevels/background=[value]
Set flat background value to use in levels calculation. Note: background is in units of cnts/image-pixel.

contour/statistic/mult_levels=[levels list]
Calculates contour levels such that cont_levels = mult_levels*background

contour/statistic/sigma_levels=[levels list]
Calculates contour levels such that cont_levels = background + sigma_levels*sqrt(background) Note: if background is less than 20, a poisson upper limit approximation is used.

6.4 boxreg - select a box region

      boxreg[/qualifiers] [regionfile]

A box shaped region is selected using the cursor. The results of the selection are written to a region file. A box region is defined as (x-center, y-center, x-size, y-size) where x-center and y-center are the box center and x-size and y-size the size in the X and Y dimension. This is compatible with the SAOimage definition. The X, Y and size values are in original unbinned pixel coordinates even if the image has been rebinned. The default region filename is the same name as the image file, with the extension .reg. A different region filename can be specified using the /regionfile qualifier. The regions are by default inclusive. The /exclusive qualifier will create an exclusive region. Each new region selection is added to the region file, unless the /new qualifier is given. This applies to all region selections, including circlereg.

boxreg/excluded
The selected region will be excluded.

boxreg/regionfile=filename
Specify the name of the region file. Otherwise the default will be the image name with a reg extension. The filename may also be specified after the qualifiers.

boxreg/new
Start a new region definition. If /new is not specified, then regions will be added to the existing file.

boxreg/displayonly
Draw the contents of a region file on the current image

boxreg/color=n
Set the color for the drawn regions. By default, included regions are green and excluded regions are red. The value set for /color is inherited by the excluded region unless /excolor is set.

boxreg/excolor=n
Set the color for the excluded regions.

boxreg/lstyle=n
Set the style of the line used to draw regions: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot). By default, all regions are drawn with a solid line. The value set for /style is inherited by the excluded region unless /exlstyle is set.

boxreg/exlstyle=n
Set the style of the line used to draw excluded regions: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

boxreg/lwidth=n
Set the width of the line used to draw regions. By default, all regions are drawn with a line width of 1. The value set for /lwidth is inherited by excluded regions unless /exlwidth is set.

boxreg/exlwidth=n
Set the width of the line used to draw excluded regions.

Examples:
    box/new hello.reg           ! select a box region, writing it into
                                ! hello.reg, creating a new file or
                                ! overwriting an existing one
     
    box/disp/color=7/exlstyle=4 ! draw the default region file in yellow,
                                ! where the included regions are solid
                                ! lines and excluded are dotted lines

6.5 cct - change color table

      cct[/qualifiers] [table name]

Can change color table for the currently displayed image, or through /set can set the color table for the next image to be displayed. A question mark in place of the table name gives the list of all available tables. The current state of the color tables can be seen with the show command.

cct/set [table name]
Sets table name to be the default color table when next image is displayed. If table name is not given the current color table will be set as default. To revert the /set effect use /reset Current brightness and contrast settings are also applied.

cct/reset
Revert to original startup color table for current and following images.

cct/brightness=x
Set brightness of displayed color table. The default is 0.5 with available values ranging from 0.0 to 1.0. If a scale is displayed, the colors will appear to shift to the right if the brightness is lower than 0.5 (darkening the image) and the colors will shift to the left for brightness higher than 0.5 (lightening the image).

cct/contrast=x
Set contrast of displayed color table. The default is 1.0 but can have a wide range of values. If a scale is displayed, the colors will appear to compress for higher contrast values (bright spots get brighter and dark spots get darker) and spread out for lower contrast values. A negative value flips the direction of the color table.

cct/reverse
Sets brightness=1-brightness and contrast=-contrast, reversing the sense of the color table.

cct/bcreset
Resets the brightness and contrast to their standard values.

cct/cursor
Try out various combinations of brightness and contrast by clicking with the left button. The image center corresponds to the standard brightness/contrast values, with brightness increasing from left to right across the image and contrast increasing from bottom to top. Clicking the center button resets the brightness and contrast to their standard values. Clicking the right button ends the cursor mode.

cct/loop
Loop through each of the installed color tables.

cct/no_break
Go through each color table without stopping. Used only in conjunction with /loop qualifier.

cct/user_col [filename]
Specify user color table from a user-supplied file. The color table is an ascii file with the columns (R, B, G). The values for each color should range from 0 to 1. In general, this qualifier is not necessary as local files matching the filename will automatically be used. If, however, there is an ambiguity between an installed color table and a user-supplied table, the installed table is assumed. This qualifier forces XIMAGE to use the user-supplied version.

cct/outfile=[filename]
Write the color values currently being used to display the image into a file. These values include the effects of the current contrast and brightness settings, as well as any color interpolating done by PGPLOT.

Examples:
    cct/con=1.2 bb      ! load the bb color table with a slightly tweaked
                        ! contrast for the current image
     
    cct/set invgray     ! set the invgray table as the default for
                        ! future images, which is useful for plotting
                        ! to Postscript devices
     
    cct ?               ! lists all available color tables
     
    cct/loop            ! loop through all the available color tables

6.6 centroid - calculate centroid

      centroid[/qualifiers]

It calculates the centroid for a given area (box). The area can be selected via cursor or specifying the qualifiers /xpix, /ypix and /boxradius. Centroid first calculates the first guess for the centroid, using 2 possible methods, and after uses this best guess for the final calculation. The first guess for the centroid is obtained via a subsequent rebinned by 2 of the selected area until the location of maximum is the same as the last rebin. The alternative method, using the qualifier /hist, determines as first best guess, the X and Y maximum for the distributions obtained by summing the counts in the pixels along the X and Y directions. The first best guess for the centroid is used as new center for the final centroid calculation. This is achieved by interactively re-evaluating the barycenter in boxes reduced by 80% each time from the original selected area. At each step if the barycenter is the same as the box center, the box size is reduced, however if the barycenter differs, the barycenter is recalculated using the last barycenter as the box center. An alternate method for performing the last step of the centroid calculation, selected through the /deriv option, uses the derivative of partial sums method.

centroid/xpix=x
Define the x coordinate of box center in original pixel coordinates. To use with ypix=y.

centroid/ypix=y
Define the y coordinate of box center in original pixel coordinates. To use with /xpix=x.

centroid/boxradius=r
Define the half-width of the box in arcmin.

centroid/pixboxrad=r
Define the half-width of the box in detector pixels.

centroid/cursor
Define center and size of box with mouse. If /boxrad or /xpix and /ypix have been entered, only the selections for the unspecified parameters will be necessary.

centroid/hist
It calculates the first best guess of the centroid using the X and Y maximum of histograms obtained by summing the counts in the pixels along the X and Y directions. This first best guess location for the centroid is used to calculate the final value.

centroid/deriv
Use derivative of partial sums method. Within a square centered on the location of the maximum, the centroid is computed as the value at which the derivatives of the partial sums of the input image over (y,x) with respect to (x,y) = 0.

centroid/symbol=n
Set or change the symbol for the centroid location plotted on the image display. The default value is 5, and corresponds to an X. The available symbols are those from pgplot and can be viewed from the ximage web page.

centroid/csize=x
Set the character size of the symbol. Standard character size is 1.0.

centroid/color=n
Set the color used to plot the box and symbol.

centroid/lwidth=n
Set the width of the lines used to draw the box and symbol. The default value is 2.

Example:
    centroid/box=1.5/cur        !  Calculate centroid for box with
                                !  half-width of 1.5 arcmin and center
                                !  selected by cursor, plotting the result

6.7 cey - change the equinox

      cey [equinox]

Set or change the current ximage equinox. All commands dealing with celestial coordinates calculate, expect and/or return coordinates using the equinox set by this command (e.g. detect, read, ra_dec_to_pixel, and pixel_to_ra_dec). The command show reports the current value set and in use for the equinox. The alias of cey is the command equinox. The equinox setting is preserved between ximage sessions.

Example:
    cey 2000                   ! Change the equinox year to 2000

6.8 chheader - change header information

      chheader[/qualifiers] [template]

Modify or show the header information for the current image in memory. The header of the image or event file read is kept in memory using a FITS structure. The content of the header information is described below. Typing chheader all all the keywords associated with the current map are shown. Typing chheader only a subset is listed. All keywords can have their values modified, however it is recommended to change only the keyword values listed by chheader. The others listed with chheader all are mostly for internal usage.

chheader/show
Prints the current values for the specified header, listing those keywords specified in the template.

chheader/template=[template_name]
Sets the template which defines the keywords to be shown. The template file contains a subset of keyword available in the header. This is maily for internal usage. If a ? is given, the available templates will be listed.

chheader/mapid=[string]
Selects the header to be modified or displayed. By default the mapid is MAP, which corresponds to the header for the current image map. EXMAP corresponds to the current exposure map, MAPSV to the saved map, EXMAPSV to the saved exposure map, and BGMAP to the background map.

chheader/key=[keyname]
Sets the keyname whose value is being modified. To see a list of "safely" editable keynames, run the chheader with no arguments. Note: Changes to coordinate keywords will not take effect unless wcs upwcs is also run, updating the internal wcs information.

chheader/value=[keyval]
Sets the value for the key defined by the /key qualifier.

Examples:
    chh                            ! Show "safely" editable header keywords
     
    chh all                        ! Show all header keywords, whether
                                   ! they are "safe" to edit or not
     
    chh/key=telescop/val=rosat     ! Set the telescop and instrume
    chh/key=instrume/val=pspc      ! to rosat/pspc

6.9 chmdb - change mission information

      chmdb[/qualifiers] [input_mdbfile]

Modify or show default information defined for known missions. If no qualifiers are given, the information for the mission of the loaded image is displayed. The information for a single mission may also be shown by specifying only the /telescop, /instrume, and /detnam. In general, if /detnam is blank it need not be specified.

chmdb/list
Lists all the currently defined missions.

chmdb/showall
Displays the mission information for all defined missions.

chmdb/telescop=[string]
Defines the telescope to be displayed, modified, or copied.

chmdb/instrume=[string]
Defines the instrument to be displayed, modified, or copied.

chmdb/detnam=[string]
Defines the name of the detector to be displayed, modified, or copied.

chmdb/add
Add a new mission specified with /telescop, /instrume, and /detnam.

chmdb/key=[keyname]
Sets the keyname to be modified.

chmdb/value=[keyval]
Sets the value for the key defined by the /key qualifier and the mission specified with /telescop, /instrume, and /detnam. If the mission is not specified, the currently loaded mission is assumed.

chmdb/copy
Copy info for mission specified with /telescop, /instrume, and /detnam to mission specified with /totelescop, /toinstrume, and /todetnam. If /telescop, /instrume, and /detnam are not specified, the currently loaded mission is assumed. If "to"-mission exists, it is overwritten. If it doesn't exist it is added.

chmdb/totelescop=[string]
Defines the telescope for the information to be copied to. Only used with /copy qualifier.

chmdb/toinstrume=[string]
Defines the instrument for the information to be copied to. Only used with /copy qualifier.

chmdb/todetnam=[string]
Defines the name of the detector for the information to be copied to. Only used with /copy qualifier.

chmdb/reset
Remove any changes to the mission information by reloading the installed mission info file.

chmdb/infile=[filename]
Specify a mission information file to be input. By default, new missions are added and existing missions are updated. With the /replace qualifier, existing information is deleted, and only the missions and values listed in the file are loaded. An input file may also be specified as the last argument of the command.

chmdb/replace
Replace the current mission information with the contents of the specified input file.

chmdb/outfile=[filename]
Write the currently loaded mission information into a file.

Examples:
     
    chmdb                                  ! Display mission info for
                                           ! current mission
     
    chmdb/tel=rosat/inst=pspc              ! Display mission info for
                                           ! one mission
     
    chmdb/key=defszx/val=1024              ! Set default size for currently
                                           ! loaded mission
     
    chmdb/out=custom.mdb                   ! Write out all mission info
     
    chmdb/tel=rosat/inst=pspc/out=pspc.mdb ! Write out mission info for
                                           ! one mission
     
    chmdb/replace custom.mdb               ! Replace mission info with
                                           ! custom file
     
    chmdb/copy/totel=dumtel/toinst=duminst ! Copy the mission info for the
                                           ! current mission to new or
                                           ! existing mission dumtel:duminst

6.10 circlereg - select a circular region

      circlereg[/qualifiers] [regionfile]

A circular region is selected using the cursor. The results of the selection are written to a region file. A circle region is defined as (x-center, y-center, rad) where x-center and y-center are the X and Y coordinates of the circle center and rad is the radius of the circle. This is compatible with the SAOimage definition. The X, Y and the radius values are in original unbinned pixel coordinates even if the image has been rebinned. The default region filename is the same name as the image file, with the extension .reg. A different region filename can be specified using the /regionfile qualifier. The regions are by default inclusive. The /exclusive qualifier will create an exclusive region. Each new region selection is added to the region file, unless the /new qualifier is given. This applies to all region selections, including boxreg.

circlereg/excluded
The selected region will be excluded.

circlereg/regionfile=[filename]
Specify the name of the region file. Otherwise the default will be the image name with a reg extension. The filename may also be specified after the qualifiers.

circlereg/new
Start a new region definition. If /new is not specified, then regions will be added to the existing file.

circlereg/displayonly
Draw the contents of a region file on the current image

circlereg/color=n
Set the color index for the drawn regions. By default, included regions are green and excluded regions are red. The value set for /color is inherited by the excluded region unless /excolor is set.

circlereg/excolor=n
Set the color index for the excluded regions.

circlereg/lstyle=n
Set the style of the line used to draw regions: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot). By default, all regions are drawn with a solid line. The value set for /lstyle is inherited by the excluded region unless /exlstyle is set.

circlereg/exlstyle=n
Set the style of the line used to draw excluded regions: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

circlereg/lwidth=n
Set the width of the line used to draw regions. By default, all regions are drawn with a line width of 1. The value set for /lwidth is inherited by excluded regions unless /exlwidth is set.

circlereg/exlwidth=n
Set the width of the line used to draw excluded regions.

Examples:
    circle/excluded              ! make an excluded circle region selection
     
    circle/new fred.reg          ! select a circle region, writing it
                                 ! over fred.reg, a new or existing file
     
    circle/file=fred.reg/disp    ! display the region file fred.reg

6.11 close_pg_window - close the pgplot device

      close_pg_window

Close the current pgplot device. Useful for closing a displayed image or finishing a file. When using a file-based device, such as a GIF or Postscript file, the file remains open so that labels, scales, etc. may be plotted. The file is not ready to use in other programs while it remains open. If another image is displayed or XIMAGE is quit, the file is automatically closed. This command allows the user to force a close, so that the file may be viewed or printed immediately.

Example:
     
    close_pg              ! close the current window

6.12 colors - display and modify available colors

      colors[/qualifiers]

This command is used to display and modify colors available to use with commands that have the color qualifier, such as in the label command. Standard colors range from 0 to 15 and they are reserved colors. e.g. do not change based on the color table set with the cct command. These reserved colors may be changed by this command, using the qualifier /set in conjunction with one of the following qualifiers /copycolor, /rgbcolor, /namecolor, and /swapcolor. Color indices greater than 15 are associated with the image color table and cannot by modified on an individual basis.

colors/plot
Plot a color legend on an open device on the right side of the viewport.

colors/clear
Clear the color legend from open device, by drawing a box the same color as the background color over it.

colors/reset
Reset standard colors back to their original values.

colors/setcolor=n
Set the color index to modify. Valid values are 0 to 15. This qualifier has effect only if used in conjunction with one of the following qualifiers /copycolor, /rgbcolor, /namecolor, and /swapcolor.

colors/copycolor=n
Set the color index to copy from. Any defined color index is valid, even those which correspond to image color table. The /plot qualifier shows the color index mappings for all available colors. This qualifier has effect only if used in conjunction with /set.

colors/rgbcolor=r,g,b
Set RGB value to assign to setcolor with a comma-delimited list of values in the range 0.0 to 1.0. This qualifier has effect only if used in conjunction with /set.

colors/namecolor=[colorname]
The name of the color to assign to setcolor. Color names are defined through an rgb file specified through the PGPLOT_RGB variable. If this variable is not set, only black and white are supported. This qualifier has effect only if used in conjunction with /set.

colors/swapcolor=n
The color index with which to swap. Valid values are 0 to 15. This qualifier has effect only if used in conjunction with /set.

colors/null=n
The color index used to draw null pixels. By default, this is set to the first color of the current color table, 16, usually black. The current value is printed in the show command under "Null pixel color."

Examples:
    color/set=0/swap=1       !  Swap the colors for index 0 and 1
    color/set=0/name=black   !  Set color 0 to black
    color/set=1/rgb=1,0.5,0  !  Set color 1 to orange
    color/set=5/copy=25      !  Copy color 25 into color 5

6.13 contour - display iso-intensity contour levels

      contour[/qualifiers] [mapid]

This command draws a contour plot. By default the contours are calculated using an image histogram divided in 10 levels, but user can specify the number of histogram levels with the qualifier /no_of_cont_levels. The option /first_contour_drawn defines the first (lowest) level to display and by default the lowest 5 levels are not displayed. The contours can be calculated also using a linear, logarithmic or square-root scale (qualifier /linear, /log, /sqrt respectively). Arbitrary iso-intensity values can be input via a file in the command levels and used within contour specifying contours/loaded. It is recommended to smooth and/or rebin the image before calculating contours. This command can be used to overlay contours over an image already plotted onto the display. If the contour's coordinates differ from the underlying image, a transformation will be automatically calculated to align the contours with the image.

contour/mapid=[idstring]
Plot contours for a specified map. Without this qualifier, the current map is plotted.

contour/linear
Contouring image with linear scale histogram

contour/log
Contouring image with logarithmic histogram

contour/histo
Contouring image using histogram equalization to define levels. This is the default option for command contour.

contour/sqrt
Contouring image with square root scaled histogram.

contour/loaded
Contouring image with current levels. Use levels/show to see current levels.

contour/div_map
Contours calculated on the map ratio obtained dividing the current image by the saved image.

contour/div_saved
Contours calculated on the map ratio obtained dividing the saved image by the current image.

contour/sub_map
Contours calculated on the image obtained from the current minus the saved image. If the result is a negative number, it will reset it to zero.

contour/exposure_map
Exposure map contours are plotted.

contour/saved_image
Saved image contours are plotted.

contour/correct_exposure
Contours calculated on the current map corrected by the exposure map.

contour/noframe
The contours are plotted without axis label frame. This qualifier is useful when the contours plot are overlayed (see /overlay) on a pre-display image.

contour/nobox
The contours are plotted without a bounding box. This qualifier is useful when the contours plot are overlayed (see /overlay) on a pre-display image. Nobox implies noframe.

contour/font=[fontname]
Sets the font of the title and axis labels. Use font=? to see available fonts.

contour/csize=x
Sets the character size of the title and axis labels. Standard character size is 1.0.

contour/no_of_cont_levels=nn
This defines the number of contour levels, nn, to be used.

contour/first_contour_drawn=nn
This defines the number of the lower contour used for display.

contour/color=n
The color index to be used in plotting the contours.

contour/lwidth=n
The width of the contour lines. Possible values range from thinnest of 1 up to 201.

contour/lstyle=n
The style of the contour lines: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

contour/overlay
The contour plot is overlayed to the pre-displayed image. The default is that the contour plot is drawn on a new Pgplot page.

contour/nocoortrf
If the overlay qualifier is used to place a contour on top of an image, the default behavior is to rotate, resize and recenter the contour map to match the coordinates of the underlying image. If, however, this behavior is not desired, the nocoortrf qualifier can be used to plot the contour as it is with no transformation.

contour/left
This qualifier plots the contour lines on the lefthand side of the screen. Subsequent interactions with the Pgplot screen will act on the lefthand side. If a contour plot is already displayed on the righthand side of the screen, a second contour plot can be displayed on the lefthand side with the /overlay qualifier, which prevents Pgplot from starting a new page.

contour/right
This qualifier plots the contour lines on the righthand side of the screen. Subsequent interactions with the Pgplot screen will act on the righthand side. If a contour plot is already displayed on the lefthand side of the screen, a second contour plot can be displayed on the righthand side with the /overlay qualifier, which prevents Pgplot from starting a new page.

contour/v1=x/v2=x/v3=x/v4=x
Specify the viewport where the contour plot is displayed. Viewport coordinates number the entire device from 0.0 at the left to 1.0 at the right and 0.0 at the bottom to 1.0 at the top. The parameter /v1 corresponds to the left side of the viewport, /v2 to the right, /v3 to the bottom, and /v4 to the top. The viewport command may also be used prior to plotting to set the viewport, however if these values are set in this command, they will override the values set through the viewport command.

contour/statistic
Calculates contour levels based on background calculation. If the background command has been executed, that background is used, otherwise the background command is run automatically with no options. Using this qualifier alone is equivalent to contour/statistic/sigma_levels="2 3 4 6 9 12 18 35 100"

contour/statistic/background=[value]
Set flat background value to use in levels calculation. Note: background is in units of cnts/image-pixel.

contour/statistic/mult_levels=[levels list]
Calculates contour levels such that cont_levels = mult_levels*background

contour/statistic/sigma_levels=[levels list]
Calculates contour levels such that cont_levels = background + sigma_levels*sqrt(background) Note: if background is less than 20, a poisson upper limit approximation is used.

Examples:
     
    contour/no_of_cont_levels=20/first_contour=4   ! generate a contour plot with
                                                   ! 20 levels, and level 4 to
                                                   ! level 20
     
    contour/no_of=20/first=4/overlay/col=5         ! same as before but also
                                                   ! overlay the contour on the
                                                   ! previous image using color 5
     
    contour/stat/sig={2 3 4 5 10}                  ! calculate and plot
                                                   ! five contour levels
                                                   ! based on sigma values
     
    contour/map=3                                  ! Plot contour for MAP3

6.14 coord - coordinate conversions

      coord[/qualifiers]

This command quietly performs coordinate conversions based on the input qualifiers and saves results in Tcl array, coord. Intended primarily for usage in scripts.

Output array:

coord/mapid=[idstring]
Specify the map for which the coordinate conversion applies.

coord/cursor
Select point to convert with mouse.

coord/xpix=[value]/ypix=[value]
Specify point to convert in detector coordinates.

coord/ysky=[value]/ysky=[value]
Specify point to convert in sky coordinates of original image. Acceptable coordinate syntaxes include: ddd.ddd, dd:mm:ss.s, dd mm ss.s

coord/ra=[value]/dec=[value]
Aliases for xsky/ysky.

coord/equinox=[value]
Specify equinox of input sky coordinates.

coord/ximg=[value]/yimg=[value]
Specify point to convert in image coordinates.

Examples:
    coord/xpix=7000/ypix=8000  ! Sets coord array with detector
                               ! location in various coord systems

6.15 ccorr - coordinate correction based guide sources

      ccorr[/qualifiers] [filename]

This command takes an RA and Dec list representing guide sources and plots them on the existing image. The user then interactively selects (i.e. left-clicks) a plotted source and its visual counterpart in the image, repeating this at least three times with different sources. Clicking the right mouse button ends selections and a correction is made to the internal keywords of the image based on the input.

It is recommended that a visual inspection of the image be made to observe the general problem with the image coordinates. For example, all are shifted in a particular direction. Then, a small number of key guide sources distributed throughout the image with distinct image counterparts should be chosen. In order to improve precision, it is possible to zoom the image in and out during the selection process while using the /xtk device. Pressing and holding the Shift key at any time during the selection of sources temporarily restores the usual behavior of the /xtk device (i.e. right-click zooms in, middle-click recenters, and left-click zooms out). Once the desired guide source is in view, click the left button on or near a plotted source. A line will be anchored to the point. Then, click the left button on the source in the image. Repeat this for at least three sources, then click the right button anywhere on the image to indicate that all selections have been made. If at any point, a mistake is made, the center button can be used to forget the last entered point.

ccorr/filename=[file location]
A text file containing RA and Dec of guide sources in the first and second column, delimited by spaces. For example, each line can be of the form "ddd.ddd ddd.ddd" or "hh:mm:ss.s dd:mm:ss.s".

ccorr/ralist=[list]/declist=[list]
Instead of a file, RA and Dec of guide sources may be given as Tcl lists. The rdarray command may be used to read any file format into a Tcl array of lists.

ccorr/norot
Restrict the fitting algorithm to keep the rotation fixed, allowing only a translational correction. By default, x and y offset as well as rotation may be varied to perform the fit.

ccorr/disponly
Plot the guide sources without doing the correction. This useful for plotting the new location of the guide sources after a correction has been made.

ccorr/color=n
Set the color used to draw the guide sources. The index of each color can be found by plotting a color legend with the colors command.

ccorr/csize=x
Set the character size for the guide source label. By default this is set to 0, meaning that no label is printed.

ccorr/symbol=n
Set the symbol style used to plot the guide sources.

ccorr/symcsize=x
Set the character size of the symbol used to plot the guide sources. The default value is 0.9. Values more than 2.0 will tend to be too large.

ccorr/symlwidth=x
Set the line width of the symbol used to plot the guide sources. The default value is 1.

ccorr/savefile=[file location]
Write a file containing the source selections used in the correction for later re-use with the matchfile qualifier.

ccorr/matchfile=[file location]
Read in a file written with the savefile qualifer, to re-execute the same correction.

Examples:
    ccorr radec_list.txt                  !  Correct based on sources in file
    ccorr/save=select.txt radec_list.txt  !  Save results of correction
    ccorr/match=select.txt                !  Re-run prior correction

6.16 counts - sum counts in a given area

      counts[/qualifiers] [regionfile]

This command sums counts in a given area. By default this area is a box if selected via a cursor or defined by the qualifiers /xmin/xmax/ymin/ymax. More complicated area can be specified using a region file created via the circle or box commands. The region file may be input with the /regionfile qualifier. By default counts uses the cursor.

counts/regionfile=[filename]
Sum the counts within the area defined by a region file. A region file may also be specified as the last argument of the command.

counts/xmin=x/xmax=x/ymin=x/ymax=x
Sum the counts within the box defined by the minimum and maximum x and y values in original detector coordinates.

counts/noplot
By default the selected region is plotted on the screen. This qualifier turns off the plotting.

counts/color=n
The color index to be used in plotting the counted region.

counts/lwidth=n
The width of the line used to draw the counted region. Possible values range from thinnest of 1 up to 201.

counts/lstyle=n
The style of the line used to draw the counted region: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

Examples:
    counts                    ! Select box with cursor to sum
     
    counts inner.reg          ! Sum counts in `inner.reg` region

6.17 cpd - change plot device

      cpd[/leaveopen] [device-name]

This command defines the device where all graphic output is directed. cpd ? gives a list of all available devices. The specified device is preserved between ximage sessions.

cpd/leaveopen
Leave /xtk device open when changing device. Primarily for internal use by the /xtk device's Print... option.

Examples:
     
    cpd /xw              ! change the current plot device to X-Windows
     
    cpd test.ps/ps       ! direct the graphic output to the
                         ! postscript file test.ps
     
    cpd /gif             ! direct the graphic output to the
                           GIF file pgplot.gif

6.18 crop - crop image

      crop[/qualifiers]

This command creates a new image based on a portion of the existing image. Cropping occurs only on existing pixel boundaries with no resampling.

crop/inmap=[idstring]
Specify image map to crop. The current map is used by default.

crop/outmap=[idstring]
Specify where the cropped image is to be written. If no outmap is given, the inmap location is assumed and the original input map will be overwritten. If outmap is specified and differs from inmap, the original input map will remain untouched and the cropped image will be written to the outmap location.

crop/xpix=[value]/ypix=[value]
Center the cropped area at xpix, ypix in original pixel coordinates. Note: a size must also be specified.

crop/xsky=[value]/ysky=[value]
Center the cropped area at xsky, ysky in the sky coordinates of the original image. Input must be in decimal format. Note: a size must also be specified.

crop/ra=[value]/dec=[value]
Alias for xsky, ysky, except the R.A. value can be specified either as ra="hh mm ss" (hour minute and second) or ra=deg.ddd (in degrees), the declination can be specified either as dec="deg mm ss" or dec=deg.ddd (in degrees). Note: a size must also be specified.

crop/equinox=n
Specify the equinox if the requested image center is given in sky coordinates. By default the current XIMAGE equinox (defined with the cey command) is assumed.

crop/size=n
Specify the size of the cropped area in image pixels. If an odd number is given for the size, size-1 will be used. The value set through this qualifier is assumed for both the x and y directions. If a non-square image is desired, use the /szx and /szy qualifiers.

crop/szx=n/szy=n
These qualifiers are identical to the /size qualifier except they specify the image size in the x and y direction independently.

Examples:
    crop                       ! Select box with cursor to crop
     
    crop/xp=256/yp=256/size=50 ! Crop image with center at 256,256 and
                               ! size 50x50

6.19 curve - draw curve between two sky positions

      curve[/qualifiers]

This command draws the path of shortest distance (i.e. a geodesic curve) between two sky positions.

curve/x1sky=[value]/y1sky=[value]/x2sky=[value]/y2sky=[value]
Specify the sky positions x1sky,y1sky and x2sky,y2sky to connect with a geodesic curve. The values must be given in decimal notation.

curve/color=n
Set the color index for curve.

curve/lwidth=n
The width of the line used to draw the curve. Possible values range from thinnest of 1 up to 201.

curve/lstyle=n
The style of the line used to draw the curve: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

6.20 detect - source detection

      detect[/qualifiers]

Locates point sources in the current image using a sliding-cell method. The average background intensity is estimated in several small square boxes uniformly located within the image (see background command for a more detailed description). The position and intensity of each detected source are calculated in a box whose size maximizes the signal-to-noise ratio. If the source is not pointlike the estimated count rate is in general inaccurate and likely to be under-estimated. A good estimate of the intensity of extended sources can be obtained with command COUNTS.

Corrections to the net counts are applied if the proper calibration information are available for that instrument. The corrections applied are dead times, vignetting and psf (the fraction of the source counts that fall outside the box where the net counts are estimated). Count rate errors include both statistical and systematic uncertainties added quadratically. To minimize the number of spurious sources detected the threshold used by detect is somewhat conservative. Consequently, some sources with intensity just above the image background can be missed. In order to allow detect to obtain a sufficiently good estimate of the background only images of size 128x128 pixels or larger should be used. Maximum accuracy is obtained running detect on full resolution images.

The functionality of the detect command may also be accessed by executing the background, excess, and search commands in succession. Running the process in pieces allows for finer control of each step. For example, the background calculation may be tweaked, the output of each step can be written out and/or read in, and the image may be altered between steps.

detect/draw_rej_back_boxes
This displays all background boxes which have NOT been used for the estimation of the background. Different colors correspond to different reasons for rejection.

detect/back_box_size=m
Defines the size (in image pixels) of the boxes where the image background is estimated. Recommended background box sizes are powers of two, such as 16, 32, 64, and 128.

detect/flat_value=x
Set the background to a constant. By default the background is calculating with the same method in the background command.

detect/source_box_size=n
This defines the size (in original detector pixels) of the search cell. The default value of the search cell size depends on the instrument PSF and on the image pixel size. Try increasing it to reduce confusion.

detect/bright
Do not merge the excesses before optimizing the box centroid. This is slower, but can be better for crowded fields and fields containing bright sources.

detect/plot_excesses
Plot the excesses. This is a useful diagnostic if things go wrong.

detect/prob_limit=x
Change the background probability limit from the default value (1E-04).

detect/snr_threshold=x
Change the signal to noise acceptance threshold from its default value of 2.

detect/thr_scaling=x
Scale the threshold for detecting source excesses. Try increasing it to 1.1 or 1.2 or 1.3 to reduce problems with fluctuations from extended emission.

detect/nolabel
Omit the number label when plotting the detected source boxes.

detect/color=n
Set the color index for the detected source boxes and labels.

detect/lwidth=n
The width of the line used to draw the detected source boxes. Possible values range from thinnest of 1 up to 201.

detect/lstyle=n
The style of the line used to draw the detected source boxes: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

detect/font=[fontname]
Sets the font of the detected source labels. Use font=? to see available fonts.

detect/filedet=[filename]
Specify an output filename containing the detect results. The default value is the input filename with extension .det. The output file from detect is plain ascii.

detect/fitsdet=[filename]
Specify an output FITS file containing the detect results. By default no FITS file is written, only the ascii .det file. If no extension is provided in the filename, .fits will be appended. The detect results are written to a FITS table with the following column names: SRCRATE, SRCRATE_ERR, X, Y, VIGNET, RA, DEC, ERRRAD, HBOXSIZE, PROB, and SNR.

Examples:
    detect              ! Search for all point sources using the default values.
     
    detect/source=10    ! Search for point sources using a search cell size of
                        ! 10 original pixels
     
    detect/draw_rej     ! Draw the background boxes that have been rejected to
                        ! be drawn onto the image (if this has been displayed).
                        ! All other parameters are set to default values.
     
    detect/back=32      ! Estimate the image background using boxes of size 32
                        ! image pixels. All other parameters are set to default
                        ! values.

6.21 display - display the current image

      display[/qualifiers] [mapid]

Display an image on the plotting device via PGPLOT. The default number of colors used is 16, but this can be adjusted with the levels/number command. A grayscale image is plotted if the plot device does not support colors. To determine the color levels by default a histogram of the image is calculated. Other scaling are linear (/lin), logarithmic (/log), or square-root (/sqrt). Several color tables are available via the command cct. Arbitrary images location can be defined via the viewport command, or using the /v1 /v2 /v3 /v4  qualifiers. To plot on the left or on the right of the screen use the qualifiers /left and /right.

display/mapid=[idstring]
Plot image for a specified map. Without this qualifier, the current map is plotted.

display/linear
Display image with linear scale for color levels.

display/log
Display image with logarithmic scale for color levels.

display/histo
Display image using histogram equalization to define color levels. This is the default option for the display command.

display/sqrt
Display image with square root scaling for color levels.

display/minlevel=x
Sets the value of the lowest level. Scaling begins after this value.

display/maxlevel=x
Sets the value of the highest level. Scaling ends before this value.

display/loaded
Display image using current levels. Use levels/show command to see current levels.

display/correct_exposure
Display the image corrected for the exposure map.

display/exposure_map
Display the exposure map.

display/div_map
Display the current image divided by the saved image.

display/div_saved
Display the saved image divided by the current image.

display/saved_image
Display the saved image.

display/sub_map
Display the current image minus the saved image. Any pixels resulting in a negative number will reset to zero.

display/noframe
Suppress the display of the image's axis label frame. Only the image and title are displayed.

display/nobox
Suppress the display of bounding box around the image. Only the image and title are displayed. Nobox implies noframe.

display/font=[fontname]
Sets the font of the title and axis labels. Use font=? to see available fonts.

display/csize=x
Sets the character size of the title and axis labels. Standard character size is 1.0.

display/overlay
This qualifier allow to have multiple images plotted on the same page. If an image has been previously displayed on one side of the screen,e.g. left, specifying this qualifier in combination with the opposite qualifier, e.g. /right/overlay, allows the images to appear on the same page. See /left and /right for usage. Each execution of the display command starts a new Pgplot page unless this qualifier is specified or a viewport configuration has been set with the viewport command.

display/left
This qualifier displays the image on the lefthand side of the screen. Subsequent interactions with the Pgplot screen will act on the lefthand side. If an image is already displayed on the righthand side of the screen, a second image can be displayed on the lefthand side with the /overlay qualifier, which prevents Pgplot from starting a new page.

display/right
This qualifier displays the image on the righthand side of the screen. Subsequent interactions with the Pgplot screen will act on the righthand side. If an image is already displayed on the lefthand side of the screen, a second image can be displayed on the righthand side with the /overlay qualifier, which prevents Pgplot from starting a new page.

display/v1=x/v2=x/v3=x/v4=x
Specify the viewport where the image is displayed. Viewport coordinates number the entire device from 0.0 at the left to 1.0 at the right and 0.0 at the bottom to 1.0 at the top. The parameter /v1 corresponds to the left side of the viewport, /v2 to the right, /v3 to the bottom, and /v4 to the top. The viewport command may also be used prior to plotting to set the viewport, however if these values are set in this command, they will override the values set through the viewport command.

display/spectrogram
Display images which contain spectra obtained at different time and formatted as an image array. This option only affects the labeling of the image frame.

Examples:
     
    disp               ! display an image with a histogram
     
    disp/log           ! display an image with log scaling
     
    disp/exp           ! display the exposure map
     
    disp/lin           ! display with a linear scaling
     
    disp/left          ! display an image on the left
    disp/right/overlay ! display an image on the right, and keep the previous
                       ! image
     
    disp/v1=0.317/v2=0.617/v3=0.4/v4=0.7 ! display into a specific area of the
                                         ! the screen
     
    disp/map=3         ! display image for MAP3

6.22 draw - draw shapes

      draw[/qualifiers] [shape parameters]

Draw shapes specified with detector coordinates on the currently displayed plot.

draw/arrow [x1] [y1] [x2] [y2]
Draw an arrow from (x1,y1) pointing to (x2,y2).

draw/oarrow [x1] [y1] [x2] [y2]
Draw an arrow with an outline arrowhead from (x1,y1) pointing to (x2,y2).

draw/circle [x] [y] [r]
Draw circle with center (x,y) and radius r in detector coordinates.

draw/box [xcen] [ycen] [xwid] [ywid] [angle]
Draw box with center (xcen,ycen) and dimensions xwid by ywid in detector coordinates, rotated by angle degrees.

draw/polygon [x1] [y1] ... [xn] [yn]
Draw polygon by connecting points x1,y1 through xn,yn in detector coordinates. The last point also connects to the first point.

draw/line [x1] [y1] ... [xn] [yn]
Draw line by connecting points x1,y1 through xn,yn in detector coordinates. Unlike polygon, the last point does not connect to the first point.

draw/color=[n]
Specify color index used to draw shape.

draw/lwidth=[n]
Specify line width used to draw shape.

draw/lstyle=[n]
Specify line style used to draw shape: 1 (solid line), 2 (dashed), 3 (dot-dash-dot-dash), 4 (dotted), 5 (dash-dot-dot-dot).

Example:
    draw/circ 1000 1000 20      ! Draw circle centered at (1000,1000)
                                ! with radius of 20

6.23 excess - find excesses

      excess[/qualifiers]

Searches the image for excesses. The excesses are found comparing the counts in the search box with the background counts. The background command needs to be run before using excess. The commands, background, excess, and search run in succession are functionally equivalent to executing the detect command.

excess/source_box_size=n
This defines the size (in original detector pixels) of the search cell. The default value of the search cell size depends on the instrument PSF and on the image pixel size. Try increasing it to reduce confusion.

excess/bright
Do not merge the excesses before optimizing the box centroid. This is slower, but can be better for crowded fields and fields containing bright sources.

excess/plot_excesses
Plot the excesses. This is a useful diagnostic if things go wrong.

excess/thr_scaling=x
Scale the threshold for detecting source excesses. Try increasing it to 1.1 or 1.2 or 1.3 to reduce problems with fluctuations from extended emission.

excess/outfile=filename
The results of the excess command are saved as text into a file.

excess/infile=filename
The results of the excess command are read in from a text file generated by using the outfile qualifier.

Example:
    back                ! Search for point sources using a search cell size of
    excess/source=10    ! 10 original pixels
    search

6.24 exit - quit

Return to the operating system. A $ can be used to spawn to the operating system without losing the current session.

You can exit from XIMAGE also by typing quit or bye

6.25 extract - extract a spectrum or lightcurve

    extract[/qualifiers] [event_filename]

The extract command extracts a spectrum and/or a lightcurve for the selected region or constructs a color-color diagrams for detected sources from the detect or search command. This command can be used only with event files.

A spectrum or a lightcurve can be extracted using the qualifiers /engfile and /qdpfile, respectively, from a region given via the qualifier /regionfile. The region file can be created using saoimage or from XIMAGE using the circ and box commands. If it is created within XIMAGE the pixel values are those corresponding to the unrebinned image. If instead it is created within saoimage the pixel values are those corresponding to a rebinned image. The region given to the extract commands needs to be in original (unrebinned) pixels.

The spectra are ASCII files containing the number of events per channel. The lightcurves are also ASCII files. Both files can be plotted via QDP and are mainly for internal usage. The ASCII spectrum is used internally to calculate the energy dependence of the psf via the command PSF. A direct way to get a spectrum and a lightcurve is using XSELECT.

The extract command also calculates a set of hardness/softness ratios for sources included in the previous run of detect. This is possible using extract/detect.These color-color results are written in a output file.

extract/c1=n/c2=n/c3=n/c4=n
Specify the channels to be used to generate hardness and softness ratios. Hardness ratio is (c3-c4/c2-c3). Softness ratio is (c1-c2/c2-c3). Default values for channels are taken from the EXCHAN keyword in the mission information database.

extract/detect
Use the positions from a previous run of detect and generate the hardness and softness ratios for each source.

extract/detect/colorfile=[filename]
The name of the output file with the HR and SR data. The default is the input filename.col. Use /plot_color to plot a color-color diagram.

extract/detect/cl3file=[filename]
The name of the output file with the HR and SR data. The default is the input filename.cl3. Use /plot_color to plot a color-color diagram. Same as colorfile, except it outputs the color-color results with additional columns, which contain the mean channel for each of the channel ranges.

extract/plot_color/detect
Plot a color-color diagram for all the detected sources.

extract/qdpfile=[filename]
Extract a lightcurve and write to a file in QDP format.

extract/region=[filename]
Enter an SAOIMAGE style region file. If not specified the regionfile name is equal to the events file .reg. If filename begins with a @ this cues the entered file to be treated as a list of regionfiles which define sources for which hardness and softness ratios will be generated.

extract/windowfile=[filename]
Enter a XRONOS style timing window file.

extract/eminqdp=n
Specifies the minimum pha channels to use when constructing a lightcurve (i.e. /qdpfile).

extract/emaxqdp=m
Specifies the maximum pha channels to use when constructing a lightcurve (i.e. /qdpfile).

extract/variability
Calculate a statistical variability test for detected sources. Values greater than 100 are probably variable.

extract/ecol=[colname]
When making a color-color diagram it will default to use the PI (pulse invariant) channel. The ecol qualifier will set the column name to use instead.

extract/psf_pha
The qualifier /psf_pha is obsolete. See /engfile.

extract/engfile=[filename]
Extract a spectrum and write an ASCII pha file, which can be used by the command psf/engfile=.

Examples:
     
    extract/reg=agn.reg rp200123.fits     ! Extract a spectrum from the rosat
                                          ! style fits file
     
    extract/detect/plot                   ! plot a color-color diagram for
                                          ! all the detected sources

6.26 finding_chart - query STScI DSS for image

      finding_chart[/qualifiers]

Query online STSci Digitized Sky Survey for image centered on selected point with a width in arcmin designated by /field_width (2 arcmin by default). The resulting image will be saved to a file named st.fits.

finding_chart/cursor
Use cursor to select center of field. By default the user is interactively asked for the x and y of the center in original detector pixels.

finding_chart/field_width=x
The width of the field being queried in arcminutes. By default the value is 2.0 arcmin.

Example:
     
    find/field=5/cur   !  Return a 5 arcmin field centered at the
                       !  position selected with the mouse

6.27 flip - flips image array

      flip[/qualifiers]

This command performs simple manipulations on the current image. Unlike the rotate command, individual pixels are preserved, only their order is changed.

flip/horizontal
Flips image horizontally, as if the image were rotated on an axis positioned through the image's center going from top to bottom.

flip/vertical
Flips image vertically, as if the image were rotated on an axis positioned through the image's center going from left to right.

flip/+90
Rotates image by exactly 90 degrees in the clockwise direction, the upper right corner becomes the lower right and the upper left becomes the upper right.

flip/-90
Rotates image by exactly 90 degrees in the counterclockwise direction, the upper right corner becomes the upper left and the upper left becomes the lower left.

6.28 free_saved - free the saved image

      free_saved

In tight memory situations, images saved with the save_image command or the first image in an XIMAGE session, which is automatically saved, can be freed with this command.

Note, free_saved actually runs map free sav The command is provided mainly for backwards compatibility with existing scripts. If the map command is used directly, the continued use of free_saved is not recommended.


next up previous contents
Next: 7. Commands G-R Up: XIMAGE User's Guide Previous: 5. Mosaics   Contents
Micah Johnson 2006-07-19