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

Magnitude Calculations


This topic describes how the Aperture Photometry package calculates the magnitudes and their random errors (or "uncertainties"). These quantities, as related to the table of photometry results, are also described in the topics Photometric Measurement Definitions and Photometric Error Definitions. This topic describes the math behind the calculations and how apertures are measured on an image.

Calculating the Magnitude

Mira computes the magnitude as

     m = K – 2.5 log ( Flux )

where

  • K is the photometric "zero point"

  • Flux = Gain * Counts / Exptime.

The camera gain ("Gain") and exposure time ("Exptime") are obtained from the FITS keywords GAIN and EXPTIME. The value of Counts is the net signal from the object, above the sky background, and measured in the raw pixel value units (often called "ADU's"). The Flux therefore represents a total number of electrons per second attributable to the object, above the sky. To compute the Flux, the image signal is summed over all pixels inside the innermost aperture, including the partially filled pixels along the rim of the aperture (see below). From this sum is subtracted the estimated sky brightness which is computed from pixels in the sky annulus formed between the 2 outer apertures. If the GAIN and EXPTIME keywords are not present in the image header, or they are wrong, you can add them or edit them using the Image Information page of the Aperture Photometry Properties dialog. Also see the topic Fixing Header Problems in Photometric Data. You can also change the names used for fetching the GAIN, EXPTIME, and RDNOISE values using the Photometry Keywords dialog.

The value K is the photometric zero point. The zero point is assumed to be 0 or the value of the ZERO-PT keyword in the image header. If the value is 0, then the magnitude may be called a "raw magnitude". If a zero point value is computed for a particular instrumental setup and used in the calculation, the result is called "instrumental magnitude". If the zero point value, K, is unknown, it may be calculated using standard stars of known magnitude.

Magnitude Errors

The uncertainty of the magnitude measurement is calculated in two ways: an empirical error, listed in the Report Window as Error, and a theoretical value listed as Error(T). The reported values may or may not include the uncertainty in the photometric zero point, which is calculated when more than 1 standard star is used. This option is controlled by the Include Zero Point Error check box on the Other Properties page. If checked, the reported error is the Root Sum Square ("RSS") value of the internal error of the measurement and the error of the mean of the zero point. The latter value is reported in the Photometry Results window.

The empirical error involves the noise measured in the sky annulus as well as the values of GAIN, RDNOISE, and EXPTIME from the image header. The theoretical error uses the keywords but not the measured sky noise. The theoretical error estimate is the minimum possible uncertainty that could be measured at a given magnitude. You can change the values of GAIN, EXPTIME, and RDNOISE on the Image Information page. Doing so will change the error values by a small amount.

Description of the Apertures

The aperture photometry procedure uses 3 apertures to measure an object:

  • The central aperture measures the total signal for the object. It does not have to enclose all the light from the object, so long as all objects on the image are measured using the same aperture.

  • The outer 2 apertures forms a ring, or annulus, inside of which the local sky (background) is measured. This is subtracted from the total signal inside the object aperture.

 

Diagram of a "measuring aperture" formed by an object aperture and a sky sampling region between two outer apertures.

The inner sky aperture should begin beyond the light in the star profile. However, the sky measuring ring should not be placed so far that it includes many other stars or that it samples sky that is not the same as that underneath the object.

The inner, object measuring aperture can be adjusted to any radius but, generally, it should not extend all the way to the point where the star appears to merge into the sky noise. Use the following guidelines to size the object aperture:

  • The fraction of the object's total light being measured does not vary over the region of the image(s) being measured.

  • The same size aperture is used foe measuring every object. Mira automatically handles this.

Regarding item 1, the object aperture can cut onto the star profile so long as it does the same for all star profiles. You can be totally safe by making the object aperture large enough to contain "all the light", but this adds more sky noise, which lowers the precision of the measurement and makes the magnitude errors larger. On the other hand, if the star profile varies over the region being measured, you might use an object aperture large enough to hold all the light for bright objects, or as the only option for measuring the field of view.

The aperture photometry procedure uses 3 apertures to measure the object. The central aperture measures the total signal for the object while the local background is measure in the annulus between the outer two apertures. The apertures may be circular or elliptical, with any ellipticity and angle of rotation, but all three apertures have the same shape and are concentric. Elliptical apertures are used to measure objects when the Point Spread Function ("PSF") is elongated by poor tracking or other reasons. Matching the ellipse to the PSF shape gives a better measurement by maximizing the signal through the aperture of a given area, which in turn maximizes the signal to noise ratio.

Small Apertures

The general placement of a measuring aperture on the pixel grid is shown below. In general, the object aperture, whether elliptical or circular, or at whatever angle, will have partially sampled pixels along its rim. For small apertures, a good measurement depends upon correctly accounting for the partial pixel coverage. Mira properly accounts for this case using a mathematically complex, but exact partial pixel algorithm—the only one of its kind.

Enlarged view of the object aperture. The star's light profile is assumed to extend outside the picture. so the aperture does not contain all the light from the star. Many pixels fall along the rim and are only partially measured by the aperture.

Yellow: Fully sampled pixels.

Blue: Partially sampled pixels.

The Ellipticity parameter is defined in terms of the axis ratio of the ellipse: for semimajor axis a and semiminor axis b, the Ellipticity is

     E = 1 - b/a.

A circle has an ellipticity of 0. The major axis orientation and the "size" are adjustable using the Aperture Tool window. The size of an aperture is set as the "radius" defined as follows:

     Radius = square root( semimajor axis * semiminor axis ) = square root ( a * b ).

All 3 apertures use the same Properties for every measurement. If measuring an image set, the Properties are the same for all images.

Related Topics

Aperture Photometry

Photometric Measurement Definitions

Photometric Error Definitions


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