Contents 

Mira Pro x64
Contents
New Features
Getting Application Help
About this Document
Tech Support
Getting Started
Glossary of Terms
Selecting Source Images
Setting Application Properties
Command Dialogs
Screen Capture
Mira's Special Folders
Changing the GUI Theme
Critical Concepts
Tip of the Day
Tutorials
Overview
Displaying an Image
Displaying an Image Set
Creating Plots from Images
Introduction to Image Registration
Making a Scatter Plot of Measurements
Using FITS Keywords to Analyze Image Data
Introduction to Aperture Photometry
Doing Time Series Photometry
Introduction to File Event Scripting
Cleaning Artifacts from an Image Set
Introduction to Source Extraction
Introduction to Astrometric Calibration
Examples
File Lists
Creating File Lists
Opening Files from File Lists
Images
The Boost Transfer Function Option
Image Rotation
Adding Labels to an Image
Editing the FITS Header
Image Registration
Plots
Plot Windows
Plotting Examples
Plotting an Averaged Line
Row Plots
Adding Series to a Line Profile Plot
Changing Plot Series Attributes
Plotting in World Coordinates
Comparison of Histogram Preferences
Contour Plotting Smoothing
3-D Plots
3-D Pixel Representations
3-D Z-Scaling
Measurements
Distance and Angle
Selecting Cells in a Grid Control
Tutorial: Making a Scatter Plot of Measurements
Fixing Header Problems in Photometric Data
Importing a Photometry Catalog
Image Basics
Image Types
Image Sets
Overview
Image Set Flags
Image Set Properties
Image Set Toolbar
Image Set Applications
Image Sets Menu
Duplicating an Image Set
File Lists
Overview
Creating file lists
Editing file lists
Opening files from file lists
Opening Images
Overview
File opening and saving commands
Using Drag & Drop
Opening image files
Creating an image catalog
Duplicating an Image
Duplicating an Image Set
Opening files from file Lists
Using File Opening Plug-ins
Selecting Source Images
Importing a Binary Image
Importing a Text Image
Saving Images
Saving a single image
Saving an image set
Saving all image set members
Saving an image set to a Folder
Saving an image set with a filename Suffix
Saving an image set to a file list
Exporting as a binary image
Exporting as a text image
Palettes
Overview
Image Palettes
Palette Pane
Palette Properties
Using the Palette Property Trackbars
Rubber Banding the Palette Graph
Importing Palettes
Transfer Functions
Overview
Choosing Transfer Function Properties
Using the Boost Transfer Function Option
Default Transfer Function Properties
Transfer Function Pane
Transfer Function Popup Menus
Image Cursor
Overview
Image Cursor Properties
Setting default and local properties
Image Window Properties
Image Plot Properties
Histogram Properties
Centroid Properties
FWHM Preferences
Radial Profile Properties
Palette Properties
Transfer Function Properties
General Properties
Selecting source images for commands
Overview
Image Display
Image Windows
Image Bar
Animation Bar
User Interface
User Interface Overview
Working with Toolbars
Initializing Toolbars and Docking Panes
Docking Panes
Command Dialogs
Command Toolbars
Main Message Pane
Image Cursor Toolbar
Image Keys Pane
Status Bar
Accelerator Keys
Profile Control
Status Bar
Save Window Position
GUI Theme
Changing the GUI theme
Context Menus
Image Context Menu
Image Context Menu for an image set
Plot Context Menu
3-D Plot Context Menu
Grid Context Menu
Dialog Styles
Command Dialogs
Dialog Buttons
Docking Panes
Overview of Docking Panes
Docking Panes Toolbar
Image Bar
Animation Bar
Image Keys Pane
Measurement Panes
Initializing Toolbars and Docking Panes
Property Profiles for Commands
Overview
Profile Control
Grid Controls
Overview
Report Windows
Grid Context Menu
Measurement Panes
Table Properties
Overview
Table Appearance Properties
Table Printing Properties
Menus
Tear-off menus
Main Context Menu
Default Menu Bar
Align Images Menu
Pictures of Menus
Creating new text documents
Default File Menu
Calibration Menu
Diagnostics menu
Edit Menu
File Menu
Measure Menu
Mira Windows
Image Windows
Plot Windows
Grid Controls
Image
Overview
Animation Pane
Image Bar
Image Set Toolbar
Image Window Keystroke Commands
Image Keys Pane
Adjusting the Image Cursor
Command Modes
Cursor Command Modes
Roam Mode
Cursor Mode
Plot
Overview
Plotting Images and Data
Creating a Plot from Table Data
Plotting Examples
Plot Bar
Plot Animation Bar
Plot Properties
Plot Series Properties
Plot Marker Properties
Image Plot Properties
Save Window Position
Chart
Chart Windows
Plotting Images and Data
Creating a Chart from Table Data
Chart Command Menu
Chart Axis Limits
Chart Properties Pane
Chart Series Properties
Chart Titles
Chart Legend Properties
Save Window Position
3-D Plot
Overview
3-D Animation Toolbar
3-D Rotation Toolbar
3-D Drawing Attributes
3-D Light Source Dialog
3-D Viewpoint Dialog
3-D Window Dialog
Save Window Position
File Open
Open Command
Opening & Saving Files
Opening Files from File Lists
Report
Overview
Grid Controls
Report Commands
Report Window Menu
Save Window Position
Grid Properties
Overview
Table Appearance Properties
Table Printing Properties
Text Editor
Overview
Creating a new text document
Text Editor Edit Menu
Text Editor View Menu
Save Window Position
Script Editor Window
Script Editor Toolbar
Script Editor Context Menu
Script Editor View Menu
Save Window Position
Plug-ins
File Opening Plug-ins
Image Processing Plug-ins
Toolbars
Working with Toolbars
Command Toolbars
Image Keys Pane
3-D Animation Toolbar
3-D Rotation Toolbar
Cursor Tools Toolbar
Image Cursor Toolbar
Image Plot Toolbar
Image Set Toolbar
Image Tools Toolbar
Image Bar
Calibration Tools Toolbar
Interactive Repair Toolbar
Main Toolbar
Measurements Toolbar
Working with FITS Format
Overview
FITS Format Definition
FITS keywords
FITS Header Editor
FITS Header Pane
FITS image orientation
List COMMENT Keywords
List HISTORY Keywords
List Statistics Keywords
List WCS keywords
MIRAPROC keyword
Editing the FITS header
Modifying keywords
Adding metadata at file open or file save
Creating an image list from keywords
Searching images for keyword values
Viewing the FITS File Header
Fixing Header Problems in Photometric Data
Image Information Editor (RGB images)
Coordinate Systems
Overview
Image Coordinate System
Pixel Coordinate Definition
Subpixel Coordinate Definition
World Coordinate System
Image Display Orientation
FITS Image Orientation
Image Coordinate Display
Coordinate Commands
Go to cursor coordinates
Go To Object
Astrometric Calibration
Set an arcsecond scale
Set an equatorial scale
Set a linear scale
Set independent linear scales
Set linear world coordinate units
Setting brightness units
Alignment Commands
High precision image registration
Align on Object
Align on Point
Align by WCS
Coordinate Readout
Set X-Axis Linear Format
Set Y-Axis Linear Format
Set Pixel Value Format
Select Image Properties
World Coordinate System
Overview
World Coordinate System Keywords
Deleting the WCS
Astrometric Calibration
Overview
Tutorial
Entering coordinate data
Changing reference point data
Calibration Preferences dialog
Plate Solution Strategy
Other preferences
Measuring Images
Overview
Measurement Panes
Image Measurements Toolbar
Image Cursor Toolbar
Image Keys Pane
Moving the image cursor to a coordinate
Setting Application Properties
Testing using synthetic images
Setting statistical estimator properties
Opening a table in Microsoft Excel
Tutorial: Working with Measurements in a Grid
Angle Measurements
Command overview
Marker properties
Aperture Photometry
Overview of aperture photometry
Apphot Pane for photometry results
Tutorial: Introduction to Aperture Photometry
Tutorial: Doing Time Series Photometry
How Magnitude and Errors are calculated
Editing target data and standard star data
Automatic detection of objects
Plotting a light curve
Kwee - van Woerden
Setting marker attributes
Preparing a report for the AAVSO
Setting the aperture size and shape
Setting photometry keywords
Fixing header problems in photometric data
Importing a photometry catalog
Calculate Julian Date
Definitions of measurements
Definitions of errors
Understanding signal to noise ratio
Aperture Photometry Toolbar
Aperture Photometry Properties
Aperture Photometry Properties dialog
Point Markers
Calibration Results
Image Information
Photometry Keywords
AAVSO Reporting
Other Properties
Measurement Output
Astrometric Calibration
Overview
Tutorial
Plate Solution Strategy
Centroid Measurements
Command overview
Centroid properties
Distance & Angle Measurements
Command overview
Measuring Distance and Angle
Example
Angle Measurement Definition
FWHM Measurements
Command overview
FWHM properties
PSF Fit Properties
Labeling Images
Overview
Label Properties
Examples
Line Measurements
Command overview
Marker properties
Plot Line Measurements
Command overview
Marker Properties
Plot Point Measurements
Plot Point Measurements
Marker Properties
Shape Properties
Point Measurements
Command overview
Marker properties
Region Measurements
Command overview
Marker properties
Region properties
Statistics Measurements
Command overview
Statistics Measurements
Statistics properties
List Statistics Keywords
Remove Statistics Keywords
Marker Properties
Overview
Drawing Properties
Centroid Properties
Region Properties
Copying & Pasting Markers
Copy Markers
Paste Markers
Scatter Plots
Scatter Plot command
Tutorial: Making a Scatter Plot of Measurements
Selecting Cells in a Grid Control
Point Sampling
Overview
Pixel Table Pane
Viewing and editing pixel values
Report Windows
Overview
Grid Controls
Grid Context Menu
Optimizing the column width
Opening a table in Excel
Table Properties
Table Printing Properties
Table Appearance Properties
Plotting Images and Data
Overview
Plot Bar Pane
Creating a Chart from Table Data
Creating a Plot from Table Data
Examples of plot types
Examples of row plots
Setting Application Properties
Horizontal Slice Plot
Vertical Slice Plot
Plot Windows
Overview
Creating a Plot from Table Data
Plot Bar
Plot Animation Bar
Plot Keys Pane
Plot Context Menu
Set X-Axis Format
Set Y-Axis Format
Plot Series Data
Plot Measurements
Go to Source Image
Plot Averaging Modes
Saving a plot as a text file
Save Window Position
Window Properties
Plot Properties
Plot Series Properties
Chart Windows
Chart Windows
Creating a Chart from Table Data
Chart Command Menu
Chart Axis Limits
Chart Properties Pane
Chart Series Properties
Chart Titles
Chart Legend Properties
Save Window Position
Working with Plot Series
Changing Plot Series Attributes
Overplotting & Animating
Go to Source Image
Copying & pasting plot series
Adding series to a line profile plot
Plot Default Marker Properties
Setting marker attributes before the plot
Default Series Properties
Plot Series Properties
Plot Series Data
Column and Row Profile Plots
Column profile plots
Making a column profile plot
Row profile plots
Making a row profile plot
Plotting an averaged line
Overview
Plot Averaging Modes
Changing the Plot Appearance
Changing Plot Attributes
The Plot Attributes dialog
Using a dialog shortcut
X Axis Properties
Y Axis Properties
Plot Labels
Frame Properties
Selecting a Coordinate System
Plot coordinate systems
Using World Coordinates
Comparison of coordinate systems
Line profile plots
Command
Creating a Line Profile plot
Adding series along different lines
Adding parallel series
Preferences
Setting Line Profile preferences
Centroid Preferences
Marker Properties
Radial profile plots
Making a radial profile plot
Radial Profile Properties
PSF Fit Properties
Histogram plots
Making a Histogram plot
Histogram Properties
Comparison of Histogram Preferences
Making a Bit Histogram plot
Plot Measurements
Overview
Plot Point Measurements
Plot Line Measurements
Statistics Measurements
Statistics Properties
Mark Statistic
Plot Marker Properties
Plot Notes Pane
Scatter plots
Scatter Plot command
Tutorial: Making a Scatter Plot of Measurements
Selecting Cells in a Grid Control
Pixel Series plots
Plotting a value through an image set
3-D plots
3-D Surface Plot command
3-D Plot Type Examples
3-D Z-Scaling Examples
Preferences
3-D Viewpoint
3-D Window Dialog
3-D Drawing Attributes
3-D Light Source
Surface Plot Z Limits
Contour plots
Contour Plot command
Contour Plot Properties
Contour Drawing Properties
Interactive Contour Plot command
Interactive Contour Properties
Contour Plot Smoothing
Copy & Paste
Example
Copying plot data to the clipboard
Pasting plots from the clipboard
Copying the window bitmap
Printing Plots
Overview
Properties
Overview
Printing Placement Properties
Printing Overlay Properties
Printing Heading Properties
Printing Text Properties
Calibrating Images
Selecting Source Images
Overview
Creating synthetic images
Trimming an image section
Adding metadata at File Open or Save
Modifying header keywords
Creating a Pixel Mask
Applying a Pixel Mask
Image Combining Strategy
Editing and Creating a Blemish Mask
Applying a Blemish Mask
File Event Scripting
Astrometric Calibration
Express Image Calibration
Express Image Calibration
Bias Correction Properties
Dark Correction Properties
Flat Correction Properties
Cosmetic Correction Properties
Creating a Master Bias
Create Master Bias
Image Combining Strategy
Creating a Master Dark
Create Master Dark
Image Combining Strategy
Create Master Flat
Create Master Flat
Flat Frame Selection Criteria
Image Combining Strategy
Create Illumination Flat
Create Illumination Flat
Flat Correction Properties
Image Combining Strategy
Create Pixel Flat
Create Pixel Flat
Flat Correction Properties
Image Combining Strategy
Repairing Artefacts and Cosmetic Defects
Overview of Methods
Cleaning artefacts from an image set
Interactively Repairing Defects
Evaluating repair techniques using synthetic images
Blemish Masks
Creating and editing a blemish mask
Applying a Blemish Mask
Pixel Masks
Creating a Pixel Mask
Editing a Pixel Mask
Applying a Pixel Mask
Removing Stars from Images
Overview
Changing the aperture properties
Viewing data for template samples
Properties
Overview
Point Properties
Other Properties
Processing Images
Overview
Command Dialogs
Selecting Source Images
Image Types
Image Region Commands
Testing calibration strategies using synthetic images
Image Keys Pane
File Event Scripting
Adding metadata at File Open or Save
Creating an image list from keywords
Searching images for keyword values
Cosmetic Repairs
Interactive Repair
Interactive Repair Properties
Removing cosmic rays from an image set
Blemish Masks
Creating and editing a blemish mask
Applying a blemish mask
Pixel Masks
Creating a pixel mask from an image
Editing a pixel mask
Applying a pixel mask
Removing Stars from Images
Overview
Changing the aperture properties
Viewing data for template samples
Properties
Overview
Markers
Background
Sample Data
Combining Images
Combine Image Set
Combine Files
Image combining methods
Setting normalization preferences
Region Statistics
Aligning Images
Overview
Aligning on a point
Aligning on an extended object
Aligning using the WCS calibration
High Precision Registration command
Overview
Tutorial: Introduction to Image Registration
Example using Point Tracking
Image Registration Properties
Image Registration Properties Dialog
Resampling
Background
Image Registration Residuals
Marker Properties
Resampling Properties
Tracking Properties
Image Region Statistics
Overview
Estimators
Editing & Copying
Overview
Duplicating to a new window
Emptying the Clipboard
Math Commands
Overview
Arithmetic Operations
Change Pixel Type
Combine Image Set
Fit Background
Image Arithmetic
Normalize Image
Region Statistics
Value Arithmetic
Using Plug-ins
Geometry Commands
Overview
Rotating Images
Rotation Menu
Affine Transformation
Expand Image
Imbed Image
Mirror
Reverse
Rotate
Rotate by angle (from Image Toolbar)
Scale
Shift
Transpose
Cropping to specified bounds
Cropping to the Image Cursor
Cropping by a rectangle
Align Horizontal
Align Vertical
Commands for RGB data
Working with RGB Images
Applying a palette to the pixels
Converting to RGB
Converting to Grayscale
Converting to 16 bit Luminance
Converting to 8 bit Luminance
Removing color noise
Extracting channels
Making an LRGB Image
Making an RGB Image
Commands for Intensity data
Extracting byte planes
Converting the data type
Converting to RGB
Undo
Using undo
Filtering Images
Overview
Removing Extreme Pixel Values
Cosmic Ray Filter
De-speckle Filter command
Clip High Values
Clip Low Values
Rank Filtering
Rank Filter
Median Filter
Minimum Filter
Maximum Filter
Smoothing Image Details
Rectangle Filter
Elliptical Filter
Binomial Filter
Gaussian Filter
Block Average Filter
Block Sum Filter
Sharpening Image Details
High Pass Filter
Unsharp Mask
Maximum Entropy command
Maximum Entropy example
Enhancing Edges
Gradient Filter
Rotational Gradient Filter
Rotational Gradient example
Laplacian Filter
Miscellaneous Kernel Filters
Custom Filter Kernel
3x3 Custom Filter command
Extracting Sources from Images
Using the MExtract Module
Definitions of Extracted Properties
Running the Pipeline
Tutorial
Preferences
Properties for the Source Extraction Tutorial
Source Extraction dialog
Procedure page
Background page
Detect page
Filter page
Match page
Difference page
Post Process page
Post Processing Options
Centroid Properties (Source Extraction)
FWHM Properties (Source Extraction)
PSF Fit Properties
Aperture Photometry Properties
Variability Properties
Image Diagnostics and Calculations
Overview
Create Synthetic Image
Bit Histogram Plot
Calculate Airmass
Calculate Gain
Calculate Image Scale
Calculate Julian Date
Calculate Readout Noise
Using the Pro Script Module
Working with scripts
Using the Script Editor Window
Using the Script Manager
Editing script keywords
Save Window Position
Related Topics
Script Editor Toolbar
Script Editor View Menu
Script Editor Context Menu
File Event Scripting
File Event Scripting
Tutorial: Introduction to File Event Scripting

Mira Pro x64 User's Guide

Prev Page Next Page

Extracting Sources from Images


 nThe MExtract Module contains a suite of functions that extract information about sources in images by detecting and measuring their properties in the image. These functions act as a "pipeline" that can be configured to handle a wide variety of tasks. Sources, or "blobs", of any shape may be found and characterized using this package. Extracted properties includes coordinates, intensity, intensity moments, ellipticity, and many other attributes. Applications for source extraction range from generating coordinate lists for objects of similar size, to mapping optical distortions and CCD artifacts, quantifying the characteristics of "blobs", and detecting transient objects among a pattern of fixed sources, as well as many others. Source Extraction may also be run using the CImExtract class in the Pro Script Module. See the Mira Pro x64 Script User's Guide.

When multiple images are loaded as an image set, you can switch between processing the entire image set or just the active image by setting the active state of the Measure Image Set flag using, for example, the button on the Image Bar.

Loading the MExtract Module:

Overview

The extraction processing is controlled by Properties in the Source Extraction Properties. A profile control manages collections of properties that apply to any number of different extraction strategies. For example, you might have one profile for creating a collection of blobs that are highly elongated, another profile for detecting transient sources in image sets from a particular experimental setup, or other profiles that identify objects that are tiny and of high brightness. Since your source extraction procedure will always be executed in a particular sequence of commands that each take their input from prior results, it is known as a "pipeline". The pipeline can process just one image or a stack of images, depending on the state of the Process mage Set flag for the image window.

Other Information:

Source Extraction Toolbar

The and buttons are discussed under "Working with Multiple Images", below.

The Source Extraction Pipeline

The extraction processing involves a "pipeline" that connects a number of steps. Each of these steps is optional:

  • Calculating the Background threshold for identifying sources.

  • Detecting sources above the threshold and calculating their properties.

  • Filtering the detected sources according to selection criteria.

  • Merging the source lists (for an image set) to retain only those sources found in all images.

  • Differencing the source lists (for an image set) to retain only those sources found in some images.

  • Labeling the final source collection by drawing markers on the images./P>

  • Reporting the extracted properties for the final source list(s).

Note that the Merging and Differencing steps pertain only to processing of image sets. These operations work with the lists of objects extracted from the images by matching the source coordinates. These operations are also available after the pipeline has been executed. See "Working with Multiple Images", below.

Listing Results

After completion of the extraction pipeline, the final sources may be listed and marked. To choose how this will be done, choose an option under the Reporting section of the procedure on the Procedure page.

After the extraction pipeline has been run, you can list the results using one of these methods:

  • Click on the toolbar or click [List] on the Procedure page to list results in a Report Window.

  • Click [Save] on the Procedure page to list the results into a text file.

How Source Extraction Works

Source Detection involves identifying all pixels above a threshold, then growing them into isolated sources and measuring the properties of the sources. This involves a process known as image segmentation. As mentioned in "Overview", above, this process involves 4 operations, but all 4 are optional. To select which phases are performed, check boxes on the Procedure page of the Source Extraction Properties.

Detecting source pixels depends upon two values:

  1. The background value, which must be subtracted from each pixel, and

  2. The threshold value, which each pixel must exceed to be included in a source.

The Background may vary over the image, but the threshold is a fixed amount above the local background. Any pixel value that exceeds the Detection threshold above the background is included in a source. Sources are allowed to grow and absorb other sources if they are found to be "8-connected". this definition of connectivity considers a pixel connected to another pixel if they meet on any one of the 8 eight possible points or sides surrounding the pixel. Sources are merged until the source list consists only of isolated "islands" that are not 8-connected with any other sources.

After the detection phase, a set of more than 20 properties is computed for each source. If the image has a World Coordinate System calibration, this set includes the world coordinates of the source center. If the Filter operation is enabled, then the list of sources is culled according to the specified filtering properties, keeping only those sources that meet the Filter criteria. After passing the filtering phase, the optional precision measurement options may be applied as Post-process steps. Of these, the FWHM is an especially CPU intensive operation, so it is advisable not to use it unless the FWHM value is needed (notice the CPU time listed for various steps in the Message window shown above). The final set of extracted sources and their properties may be marked on the image, tabulated in a Report Window, or saved in a text file for external processing. Select the destination under the Reporting option on the Procedure page.

Working with Multiple Images

When the image window contains an image set, you can use source extraction to identify only those sources that appear in all images or only those sources that appear in some of the images (i.e., transient or moving sources). These options exist in addition to simply finding all sources matching your extraction criteria. On the Procedure page, the Procedure box lists 3 choices under the Multiple Image Options heading: Find all Sources, Match Sources, and Difference Sources. The latter two options correspond to Properties that are set on the Match and Diff pages of the Extract Sources dialog. These three options are defined in the table below.

Multiple Image Options

Find All Sources

Choose this option to detect and measure all sources in all images.

Match Sources

Choose this option to match source lists using the coordinates of the extracted objects. This option deletes all sources that are not detected at a similar position in every image of the image set. Matching Properties are specified on the Match page.

Difference Sources

Choose this option to difference the source lists by their coordinates. This removes from the results all sources that are not detected at a similar coordinate in the entire image set. Matching Properties are specified on the Difference page.

If you choose the Find all Sources option, then the sources detected on each image will not necessarily correspond, since each image is processed independently of the others. Use this option if you do not need to establish a link between the sources in different images, such as when searching for variability or when searching for either transient or moving sources. Conversely, when the Match or Difference option is selected as part of the procedure, they are applied during the pipeline processing. Using these options, the sources that are post-processed and/or labeled on the images will be a reduced to a smaller set and the details of "all" sources will be lost.

To give you more versatility when extracting from multiple images, the Merge and Difference operations are also available as buttons on the toolbar which can be used after the pipeline has been run using the Find all Sources option. The (match) and (difference) buttons are enabled only if the image window contains an image set. These buttons duplicate theMatch Sources and Difference Sources steps in the procedure. These are used after a procedure has been run on an image set with the Find all Sources option selected to identify and label all sources in all images. Using these buttons, you can then cull the final source list to leave only the sources that are matched in all images or the sources that appear in only some of the images.

Evaluating Results

When source properties are listed in a Report window, Mira provides several tools for doing quick evaluation of the results. These options include scatter plots and other adjustments of the table (see Working with Report Data). However, note that the Report Window lists most, but not all, of the calculated properties of the extracted sources. All properties are, however, saved when you choose the Save to File option in theReporting options for the procedure.

See Source Extraction Definitions for a description of all measured source properties.

Related Topics

Contents

Measuring Images

Running the Source Extraction Pipeline

Source Extraction Properties

Source Extraction Definitions

Introduction to Source Extraction

Report Windows

Find Objects


Mira Pro x64 User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.