astropy:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- imexam v0.5 »
- Imexam User Documentation »
- IRAF imexamine capabilities

# IRAF imexamine capabilities

These are the capabilities of the IRAF version of the imexam task, called with imexamine [input [frame]], which lives in images.tv.imexamine. The following are imexamines input options:

> - input is an optional list of images to be examined. If specified, images are examined in turn, displaying them automatically. If no images are specfied the images currently loaded into the image display are examined.
> - output contains the rootname for output images created with the “t” key. If no name is specified then the name of the input image is used. A three digit numver is appended to the rootname, such as ”.001”, starting with 1 until no image is found with that name. Successive output images are numbered sequentially
> - ncoutput and nloutput are the size of the output image created when the “t” key is pressed, where the output image is centered on the cursor location
> - frame specifies which frame should be used
> - logfile is the filename which records output of the commands producing text, if no filename is given no logfile will be produced
> - defkey is the default key for cursor x-y input list. This key is applied to input cursor lists which do not have a cursor key specified. It is used to repetitively apply a cursor command to a list of positions typically obtained from another task
> - allframes, if true then images from an input list are loaded by cycling through the available frames, otherwise the last frame loaded is reused
> - nframes is then number of display frames to use when automatically loading images. It should not exceed the number of frames provided by the display device. If the number of frames is set to 0 then the task will query the display device to determine how many frames are currently allocated. New frames may be allocated during program execution by displaying images with the ‘d’ key.
> - ncstat, nlstat correlate with the statistics command which computes values from a box centered on the specified cursor position with the number of columns and lines given by these parameters.

The following is a list of available cursor and colon commands while imexamine is active in the display, many but not all are available in this python imexam package:

    			    -- IMEXAMINE COMMANDS --

    			   CURSOR KEY COMMAND SUMMARY

    ? Help              h Histogram         p Previous frame    x Coordinates
    a Aperture Sum      i Image cursor      q Quit              y Set origin
    b Box coords        j Line gauss fit    r Radial plot       z Print grid
    c Column plot       k Col gauss fit     s Surface plot      , Quick phot
    d Load display      l Line plot         t Output image      . Quick prof fit
    e Contour plot      m Statistics        u Vector plot
    f Redraw            n Next frame        v Vector plot
    g Graphics cursor   o Overplot          w Toggle logfile

    			     COLON COMMAND SUMMARY

    allframes    ceiling      iterations   naverage     pointmode    width
    angh         center       label        nbins        radius       x
    angv         constant     logfile      ncolumns     round        xformat
    autoredraw   dashpat      logx         ncontours    rplot        xlabel
    autoscale    defkey       logy         ncoutput     select       xorder
    background   eparam       magzero      ncstat       szmarker     y
    banner       fill         majrx        nhi          ticklabel    yformat
    beta         fitplot      majry        nlines       title        ylabel
    boundary     fittype      marker       nloutput     top_closed   yorder
    box          floor        minrx        nlstat       unlearn      z1,z2
    buffer       interval     minry        output       wcs          zero

                               OUTPUT OF 'a' AND 'r' KEYS

    The 'a' key and logfile output has column labels and each object has one
    line of measurements in the logfile and two lines on the terminal.  The 'r'
    key shows only the second line on the status line and the information from
    the first line is in the graph title.  The first line contains the x and y
    center coordinates and optional world coordinates.  The second line
    contains the aperture magnitude and flux, the estimated background sky, the
    profile fit peak, the ellipticity and position angle from the moment
    analysis, and four estimates of the profile width.  The four estimates are
    from the moment analysis, the full-width enclosing half the flux, the
    profile fit, and a direct estimate of the full width at half-maximum.

    			      CURSOR KEY COMMANDS

    ?	Print help
    a	Aperture radial photometry measurement (see above for output)
    b	Box coordinates for two cursor positions - c1 c2 l1 l2
    c	Column plot
    d	Load the image display
    e	Contour plot
    f	Redraw the last graph
    g	Graphics cursor
    h	Histogram plot
    i	Image cursor
    j	Fit 1D gaussian to image lines
    k	Fit 1D gaussian to image columns
    l	Line plot
    m	Statistics
    	    image[section] npixels mean median stddev min max
    n	Next frame or image
    o	Overplot
    p	Previous frame or image
    q	Quit
    r	Radial profile plot (see above for output)
    s	Surface plot
    t	Output image centered on cursor (parameters output, ncoutput, nloutput)
    u	Centered vector plot from two cursor positions
    v	Vector plot between two cursor positions
    w	Toggle write to logfile
    x	Print coordinates
    	    col line pixval [xorign yorigin dx dy r theta]
    y	Set origin for relative positions
    z	Print grid of pixel values - 10 x 10 grid
    ,	Quick profile photometry measurement (Gaussian or Moffat)
    .	Quick radial profile plot and fit (Gaussian or Moffat)

    				COLON COMMANDS

    Explicit image coordinates may be entered using the colon command syntax:

    	:column line key

    where column and line are the image coordinates and the key is one
    of the cursor keys.  A special syntax for line or column plots is also
    available as :c# or :l# where # is a column or line and no space is
    allowed.

    Other colon commands set or show parameters governing the plots and other
    features of the task.  Each graph type has it's own set of parameters.
    When a parameter applies to more than one graph the current graph is assumed.
    If the current graph is not applicable then a warning is given.  The
    "eparam" and "unlearn" commands may be used to change many parameters and
    without an argument the current graph parameters are modified while with
    the graph key as an argument the appropriate parameter set is modified.
    In the list below the graph key(s) to which a parameter applies are shown.

    allframes               Cycle through all display frames to display images
    angh        s           Horizontal angle for surface plot
    angv        s           Vertical angle for surface plot
    autoredraw  cehlrsuv.   Automatically redraw graph after colon command?
    autoscale   h           Adjust number of histogram bins to avoid aliasing
    axes        s           Draw axes in surface plot?
    background  jkr.        Subtract background for radial plot and photometry?
    banner      cehjklrsuv. Include standard banner on plots?
    beta        ar		Moffat beta parameter (INDEF to fit or value to fix)
    boundary    uv          Boundary extension type for vector plots
    box         cehjklruv.  Draw box around graph?
    buffer      r.          Buffer distance for background subtraction
    ceiling     es          Data ceiling for contour and surface plots
    center      jkr.        Find center for radial plot and photometry?
    constant    uv          Constant value for boundry extension in vector plots
    dashpat     e           Dash pattern for contour plot
    eparam      cehjklrsuv. Edit parameters
    fill        e           Fill viewport vs enforce unity aspect ratio?
    fitplot     r           Overplot profile fit on data?
    fittype     ar          Profile fitting type (gaussian|moffat)
    floor       es          Data floor for contour and surface plots
    interval    e           Contour interval (0 for default)
    iterations  ar          Iterations on fitting radius
    label       e           Draw axis labels for contour plot?
    logfile                 Log file name
    logx        chjklruv.   Plot x axis logrithmically?
    logy        chjklruv.   Plot y axis logrithmically?
    magzero     r.          Magnitude zero for photometry
    majrx       cehjklruv.  Number of major tick marks on x axis
    majry       cehjklruv.  Number of major tick marks on y axis
    marker      chjklruv.   Marker type for graph
    minrx       cehjklruv.  Number of minor tick marks on x axis
    minry       cehjklruv.  Number of minor tick marks on y axis
    naverage    cjkluv      Number of columns, lines, vectors to average
    nbins       h           Number of histogram bins
    ncolumns    ehs         Number of columns in contour, histogram, or surface plot
    ncontours   e           Number of contours (0 for default)
    ncoutput                Number of columns in output image
    ncstat                  Number of columns in statistics box
    nhi         e           hi/low marking option for contours
    nlines      ehs         Number of lines in contour, histogram, or surface plot
    nloutput                Number of lines in output image
    nlstat                  Number of lines in statistics box
    output			Output image root name
    pointmode   chjkluv     Plot points instead of lines?
    radius      r.          Radius of object aperture for radial plot and photmetry
    round       cehjklruv.  Round axes to nice values?
    rplot       jkr.        Radius to plot in 1D and radial profile plots
    select                  Select image or display frame
    sigma       jk          Initial sigma for 1D gaussian fits
    szmarker    chjklruv.   Size of marks for point mode
    ticklabels  cehjklruv.  Label ticks?
    title       cehjklrsuv. Optional title for graph
    top_closed  h           Close last bin of histogram
    unlearn     cehjklrsuv. Unlearn parameters to default values
    wcs                     World coordinate system for axis labels and readback
    width       jkr.        Width of background region
    x [min max] chjklruv.   Range of x to be plotted (no values for autoscaling)
    xformat			Coordinate format for column world coordinates
    xlabel      cehjklrsuv. Optional label for x axis
    xorder      jkr.        X order of surface for background subtraction
    y [min max] chjklruv.   Range of y to be plotted (no values for autoscaling)
    yformat			Coordinate format for line world coordinates
    ylabel      cehjklrsuv. Optional label for y axis
    yorder      r.          Y order of surface for background subtraction
    z1          h           Lower intensity value limit of histogram
    z2          h           Upper intensity value limit of histogram
    zero        e           Zero level for contour plot