; IRING ;--------------------------------------------------------------- ;! integrates intensity / flux in rings / ellipses ;# TASK ANALYSIS SPECTRAL PLOT ;----------------------------------------------------------------------- ;; Copyright (C) 1995-1996, 1999-2001, 2008-2009 ;; Associated Universities, Inc. Washington DC, USA. ;; ;; This program is free software; you can redistribute it and/or ;; modify it under the terms of the GNU General Public License as ;; published by the Free Software Foundation; either version 2 of ;; the License, or (at your option) any later version. ;; ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; ;; You should have received a copy of the GNU General Public ;; License along with this program; if not, write to the Free ;; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, ;; MA 02139, USA. ;; ;; Correspondence concerning AIPS should be addressed as follows: ;; Internet email: aipsmail@nrao.edu. ;; Postal address: AIPS Project Office ;; National Radio Astronomy Observatory ;; 520 Edgemont Road ;; Charlottesville, VA 22903-2475 USA ;----------------------------------------------------------------------- IRING LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC IRING: Task to integrate in confocal ellipses. USERID -32000.0 32000.0 User ID - ignored INNAME Image name (name) INCLASS Image name (class) INSEQ 0.0 9999.0 Image name (seq. #) INDISK 0.0 9.0 Disk drive # BLC 0.0 4096.0 Bottom left corner of image 0=>entire image TRC 0.0 4096.0 Top right corner of image 0=>entire image APARM Orientation parameters: 1: x - coordinate center wrt reference point in pixels 2: y - coordinate center wrt reference point in pixels 3: position angle major axis, degrees 4: inclination of rings to plane of sky, deg. 5: full range of azimuthal angles to consider, deg. 0 => 360 degrees 6: central azimuthal angle of the range specified in APARM(5), deg. CPARM Specification of rings: 1 : radius inner ring (") 2 : radius outer ring (") 3 : width of each ring (") 4 : 1=>treat blanks as zero 5 : 1=>plot radial intensity 2=>plot integrated radial intensity, from inner ring outwards. 6 : 1 => CPARM(1-3) in pixels 7 : scale X axis by CPARM(7) 8 > 0 => y limits in 9, 10 KEYSTRNG X axis type if CPARM(7) > 0 SYMBOL -24.0 24.0 Plot symbol number: 1 - 24 FACTOR -20.0 20.0 Scale plot symbols by FACTOR <0 => connect points too DOTV -1.0 1.0 > 0 Do plot on the TV, else make a plot file GRCHAN 0.0 8.0 Graphics channel 0 => 1. OUTTEXT Not blank => write list x,y plot points to text file ---------------------------------------------------------------- IRING Type: Task Use: Integrates a map in concentric annulli projected onto the sky according to the orientation parameters in APARM. As well the mean value per ring is given, as the total cumulative flux in the right units. The latter is only possible if information about the (Gaussian) beam is present in the header. The RA-dec coordinates should be the first two axes. Adverbs: USERID......User ID of owner of image. Ignored INNAME......Image name(name). blank=>any INCLASS.....Image name(class). blank=>any INSEQ.......Image name(seq. #). 0=>any INDISK......Disk drive # of image. 0=>any BLC.........The Bottom Left-hand pixel of the subarray of the image to be analysed. The value (0,0) means (1,1). TRC.........The Top Right-hand pixel of the subarray of the image to be analysed. The value (0,0) means the top right hand corner of the entire image. APARM.......Orientation parameters : (1) : x pixel central position relative to the image reference point in pixels. (2) : y pixel central position relative to the image reference point in pixels. APARM(1) AND (2) are added to the pixel position of the reference point (use IMHEADER to see those pixel coordinates) to obtain the pixel coordinate of the center of the ellipses. (3) : position angle (degrees) receding major axis; East from North. (4) : inclination (degrees) of orbital plane to plane of sky. A face on galaxy is thus at inclination 0 degrees. (5) : full-width of range of azimuthal angles (degrees) over which distributions should be computed 0 => use all azimuthal angles (6) : central azimuthal angle (degrees) for the range specified in APARM(5); East from North. CPARM.......(1) : Radius inner circle of first annulus ("), default is 0 (2) : Radius outer circle of last annulus ("), defaults to min(mapsize x,mapsize y) (3) : Width of each annulus, defaults to 10 annuli (4) : 0 => disregard blanks, 1 => treat blanks as zero (5) : 1 => plot radial intensity distribution. : 2 => plot summed intensity from first annulus outwards. (6) : 1 => CPARM(1-3) in pixels. (7) : >0 => scale the X axis by CPARM(7) and use KEYSTRNG as the label KEYSTRNG...Label to use on X axis when CPARM(7) > 0 SYMBOL.....1: Plus sign (default) 12: Five pointed star 2: Cross (X) 13: Star of David 3: Circle 14: Seven-pointed star 4: Box 15: Eight-pointed star 5: Triangle 16: Nine-pointed star 6: Diamond 17: Ten-pointed star 7: Pentagon 18: 11-pointed star 8: Hexagon 19: 12-pointed star 9: Septagon 20: 13-pointed star 10: Octagon 21: 14-pointed star 11: Nine-gon 22: Plus with gap 23: vertical line 24: Cross with gap SYMBOL <= 0 => do not plot error bars. FACTOR.....Scale plot symbols by FACTOR 0 -> 1. If FACTOR < 0, draw lines between the points and use abs(FACTOR) to scale the points plotted. DOTV........> 0 => plot directly on the TV device, otherwise make a plot file for later display on one or more devices (including the TV if desired). GRCHAN......Graphics channel (1 - 8) to use for line drawing. 0 => 1 OUTTEXT.....Not blank => write a list of the X and Y plot points to a text file specified, in the usual manner, by OUTTEXT . ----------------------------------------------------------------