mido2.sh
Updated: June13,2020

Compute photometric parameters for each region listed in the local ds9 regions file of a FITS image. This is an updated version of the older mido.sh code which had no options or error checking and very little documentation. This version was begun in Jun2020 when I installed the option to use fixed inner and outer annuli for the background area for each region. Some new features of mido2.sh are:

  1. The basic input is the FITS image name (blah.fits) and automatic checking is done to confirm that a corresponding ds9 regions file (blah.rg) is present.
  2. The input FITS image can reside anywhere, and a local version is copied over to allow creation of the local info file (blah.info) that will contain the photometry.
  3. Error checks are performed, and if an exit is required, then this is performed gracefully and a local file named ERROR.mido2 is created that gives an explanation of what failed.
  4. The user can invoke the usual "-v", _"-h", "--help" flags to get more info at runtime.
  5. There are more flags available for setting the background subtraction area.
As with the old code, photometry lists are easily made with the *.info file using the midodata routine.

 
%  mido2.sh --help  

usage: mido2.sh a.fits [-v] [-h] [-r1 10.0] [-r2 20.0]   
arg1 = FITS image to be processed (must have *.reg file) 
Additional options: 
     -v  = print verbose comments and run in debug mode 
     -h  = show a help file and then exit 
     -c  = name of configuration file with parameter values  
     -r1 = inner radius of background annulus in pixels 
     -r2 = outer radius of background annulus in pixels 

Exammple where we set the inner and outer radii of the background annulus: 
% mido2.sh /home/sco/AUTO_match_for_wcs/S/20191018T024545.3_acm_sci.fits -r1 55.0 -r2 60.0  

Related subjects of interest
  1. Background annulus.



Background annulus.

The default mode in mido2.sh (and mido.sh) is to set the background annulus using fractions of the ds9 region used to locate each source to me measured. If we use a cicle, the annulus is circuluar, if we used an ellipse region the annuulus is elliptical, etc... We can specifically set the inner and outer radii of the background annulus in mido2.sh, but this feature is only available fro circle markers. This was developed for use in making profile calcilations for imgcat0-detected sources. These profiles are used to establish a mean half-light radius and a mean growth curve for the measured image.


The background annuli for circular apertures have been set to fixed value for every source marked with a circel aperture.
 

% ls  
20191018T024545.3_acm_sci.reg
% mido2.sh /home/sco/S/20191018T024545.3_acm_sci.fits -r1 55.0 -r2 60.0  
% ls  
20191018T024545.3_acm_sci_bkgannuli.reg  20191018T024545.3_acm_sci.fits  20191018T024545.3_acm_sci.reg
20191018T024545.3_acm_sci.cdfp		 20191018T024545.3_acm_sci.info  

Notice that the one ellipse aperture has the usual annulus that is scaled to the size and shape of the original aperture.

Return to top of page.



Back to calling page