NAME

 
 RtdImagePick - widget to select an object in an image using a centroid alg.

NAMESPACE

 
 rtd

PARENT CLASS

 
 util::TopLevelWidget

SYNOPSIS

 
 RtdImagePick <path> ?options?

DESCRIPTION

 
 RtdImagePick is an itcl widget to select an object (a star, for
 example) in an image and get statistics for it. It is based on the
 rtdimage(3) "statistics" subcommand, which uses a centroid algorithm to
 locate the center of the object.

ITK COMPONENTS

 
 angle
        LabelValue(n) widget for "Angle of X axis".

 background
        LabelValue(n) widget for "Background level".

 buttons
        Dialog buttons frame.

 cancel
        Cancel button.

 close
        Close button.

 dec
        LabelValue(n) widget for DEC (delta).

 equinox
        LabelValue(n) widget for equinox.

 fwhm
        LabelValue(n) for "FWHM X:Y".

 nsize
        LabelValue(n) widget for number of "Pixels in x,y".

 object
        LabelValue(n) widget for "Peak object level above bg".

 pick
        "Pick Object" button.

 ra
        LabelValue(n) widget for RA (alpha).

 x
        LabelValue(n) widget: "Image X" .

 y
        LabelValue(n) widget: "Image Y".

 zoomView
        This component displays the section of the image that will be used
        for the centroid algorithm and statistics.

WIDGET OPTIONS

 
 -command
        Command to evaluate when a selection is made or canceled.

 -debug
        Debugging flag.

 -factor
        Default zoom magnification factor.

 -labelfont
        Font to use for labels.

 -labelwidth
        Set the width for  displaying labels and values.

 -maxsize
        Set the max size of the image sample area (screen dist).

 -orient
        Specify the orientation of image and panel, one of {vertical
        horizontal}.

 -target_image
        Target (main) RtdImage itcl widget.

 -usexshm
        X shared memory option.

 -usexsync
        X synchronisation option.

 -valuefont
        Font to use for values.

 -valuewidth
        Set the width for  displaying labels and values.

 -verbose
        Flag: if true, print diagnostic messages.

 -wcsfont
        Font to use for ra,dec labels (alpha, delta).

PUBLIC METHODS

 
 cancel {{with_pick 1}}
        Cancel the current pick operation.

 cancel_pick {}
        Cancel the wait for the pick_object method and reset the cursor.

 close {}
        Close this window.

 pick_object {{parms ""} {wait 0}}
        Let the user select a point in the image and get the statistics on
        the area. The optional argument "parms" may be set to {x0, y0},
        the size of the image box. If given, pick_object returns the
        result without user interaction. .

 picked_object {}
        This method is called when the user clicks in the image to select
        an object or star for the "pick_object" method. .

 picked_special_object {x y ra dec equinox}
        This method is called when the user clicks in the image to select
        an object or star for the "pick_object" method. In this case, the
        x,y and ra,dec position are fixed and only the other info should
        be calculated (used).

 picked_wcs_object {retval}
        This method can be called when the user has selected an object or
        star for the "pick_object" method.  The argument should be the
        value returned from the rtdimage "statistics" subcommand.

 update_scale {{fx 1} {fy 1}}
        Dummy (called by RtdImage.tcl which assumes that the scaling is
        propagated).

PROTECTED METHODS

 
 add_buttons {}
        Add a row of dialog buttons at the bottom of the window.

 blink_mark {canvas tags {color 0}}
        This method is used to make the marker given by "tags" blink on
        and off.

 format_val {val}
        Format a floating point value (which may also be empty).

 init {}
        This method is called after the options have been evaluated.

 make_labels {w {side left}}
        Create the window for displaying the statistics in the given
        frame.  The optional "side" arg is used for packing.

 make_layout {}
        This method is responsible for the window layout.

 make_rect {w {side left}}
        Create the window used to display the part of the image being
        examined.  $w is the parent frame.  The optional "side" arg is
        used for packing.

 mark_spot {imagex imagey image canvas angle width height {blink 0}}
        Mark the given x,y image coordinate point in the given
        image/canvas with a cross with the given width, height (image
        pixels) and angle (deg).

 pick_object_in_image {}
        This method is called to allow the user to pick an object in the
        main image.  The return value is a list of:  "ra dec equinox fwhmX
        fwhmY angle objectPeak meanBackground" as returned from the
        rtdimage "statistics" subcommand, or an error.

 scale_changed {}
        Callback from isrtdZoomView when the scaling was changed.

 set_result_value {}
        Set the set_result_ variable to 1.

 set_values {list {with_rmt 1}}
        Set the values of the labels from the list (results of
        "pick_object" call).  If list is empty the labels are cleared.  If
        the list is not empty, mark the ra,dec spot in the image.

 update_now {}
        Returns statistics after image event.

PROTECTED VARIABLES

 
 afterId_
        Id for blink after job.

 canvas_
        Internal canvas widget.

 imageX_
        X coord of last picked object.

 imageY_
        Y coord of last picked object.

 image_
        Internal zoomView rtd image.

 initialized_
        Set to 1 after init {} was called.

 list_
        Output of last statistics command after scaling and pick object
        command.

 target_canvas_
        Internal target canvas.

 target_image_
        Internal target image.

 waiting_
        Waiting for image event before returning result.

SEE ALSO

 
 TopLevelWidget(n)

 


- - - - - -
Last change: 07 May 99