AIPS NRAO AIPS HELP file for MFPRT in 31DEC25



As of Mon Dec 9 12:41:30 2024


MFPRT: Task to print MF tables in modelling software format.

INPUTS

INNAME                             Image name (name)
INCLASS                            Image name (class)
INSEQ             0.0    9999.0    Image name (seq. #)
INDISK            0.0       9.0    Disk drive #
INVERS            0.0              Start MF extension to list
IN2VER            0.0              Final MF extension to list
XINC              0.0   32767.     Increment between extensions
DOCRT            -3.0     132.0    If > 0, write to CRT
                                   > 72 => CRT line width
OUTPRINT
                                   Printer disk file to save
FLUX                               Flux level below which to
                                   ignore components.
                                   0 => accept all cpts
IMSIZE          0.0                Min, max allowed component
                                   size (asec.)
SORT                               Sort order: ' ' => '-F'
OPTYPE                             ' ' => basic list format
                                   'USER' => BOX sets cols
                                   'LIST' => source list format
                                   as for BOXES, SETFC, FACES
                                   'STAR' => STARS format
                                   'STDE' => STARS w deconvolved
DOHMS           -2.0         1.0   > 0 => coordinates displayed
                                          in sexagesimal RA/DEC
                                   -1 => degrees offset
                                   -2 => asec offsets
FORMAT          -1.0         3.0   = -1 => omit row numbers
DOALL           -1.0         3.0   1, 2, 3 scale by primary beam
                                   and bandwidth smearing
                                   see help.
CLEV                               STARS: >0 scale by flux/CLEV
SYMBOL                             STARS: symbol type
                                   < 0 => function of flux
BOX                                List of columns to be printed
                                   0 -> all.

HELP SECTION

MFPRT
Type:  Task
Use:   MFPRT prints on the line printer or terminal the rows of an MF
       extension file.  If the line width is too small to hold all
       columns, it will print as many as it can and then loop back to
       the beginning to print the next set of columns.  OPTYPE='STAR'
       and OPTYPE='STDE' print in the format used by task STARS to
       make an ST file to appear on image plots.  OPTYPE='LIST' allows
       you to print an MF table in the special format used for source
       lists by such tasks as SETFC, FACES, and BOXES.  The angular
       units are degrees, arc seconds, or milli arc seconds, depending
       on the cell size.  The flux scale is Jy or milliJy or even
       microJy as needed.
Adverbs:
  INNAME.....Image name (name).           Standard defaults.
  INCLASS....Image name (class).          Standard defaults.
  INSEQ......Image name (seq. #).         0 => highest.
  INDISK.....Disk drive # of image.       0 => any.
  INVERS.....First MF extension to list.  0 => 1.
             Enables the user to run through all available MF tables
             attached to a given file and list the values in one output
             file.
  IN2VER.....Last MF extension to list    < INVERS => to end.
  XINC.......Increment between MF extension files.     <= 0 => 1.
  DOCRT......False (<= 0) use the line printer if OUTPRINT = ' '
                   else write named OUTPRINT file only.
                   When OUTPRINT is not blank, DOCRT=-2 suppresses the
                   page-feed character on page headers and DOCRT=-3
                   suppresses page headers and most other header
                   information.  When OUTPRINT is blank, the line
                   printer will be used.  MFPRT now counts the lines
                   to be printed before printing any and asks for
                   permission to continue if the count > 500.
             True  (> 0) use the terminal interactively.  The task will
                   use the actual terminal width as a display limit
                   unless 72 < DOCRT < width.  In that case, the display
                   limit will be DOCRT characters.
  OUTPRINT...Disk file name in which to save the line printer output.
             ' ' => use scratch and print immediately for interactive
             jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
             (jjj= job #, nnn = user #).  When OUTPRINT is not blank,
             multiple outputs are concatenated, and the file is not
             actually printed.
  FLUX.......Flux level below which to ignore components.  The column
             used is the total flux in I polarization, column 3.
             0 => accept all components.
  IMSIZE.....Minumum and maximum size allowed for components in arc
             seconds.  IMSIZE(2) <= 0 => accept all components.  If not
             given, then large, non-physical components may slip
             through.  The columns tested are the fit major and minor
             axis sizes, columns, 6 and 7.
  SORT.......Sort order to use: 'C', 'F', 'T', 'X', 'Y', 'J', 'N', 'P'
             for channel, peak flux, total flux, X position, Y
             position, major axis, minor axis, position angle.  Use
             '-C' etc for inverse order.  ' ' => '-F'
  OPTYPE.....'    ' yields two different outputs depending on whether
                the data have multiple spectral channels.  The multi-
                channel one may be forced with OPTYPE='LINE' and the
                continuum one may be forced with OPTYPE='CONT'.
             'USER' prints the columns specified in BOX like PRTAB but
                with more appropriate units.  See EXPLAIN for details.
             'LIST' causes the output to be in the format used by
                SETFC, BOXES and other tasks reading source lists.
                These tasks expect the flux column to be in milliJy
                but MFPRT may use microJy if the source total fluxes
                are all less than 1 Jy and the lowest included flux is
                less than 1 milliJy.  The source diameter column is
                the sqrt(Bmaj*Bmin) in arc sec and the format is
                RA,Dec,Flux,Width as F9.5,1X,F9.5,I7,F10.4.
             'LIDE' as 'LIST' but using deconvolved widths
             'STAR' causes the output to be in the format used by
                STARS: Ra, Dec (in sexagesimal), Major, Minor, PA,
                Type, label.  Size is fit size.
             'STDE' causes the output to be in the format used by
                STARS: Ra, Dec (in sexagesimal), Major, Minor, PA,
                Type, label.  Size is deconvolved size.
  DOHMS......> 0 => give full source positions in sexagesimal format
             <=0 => give source positions as offsets from the
                    reference in asec if DOHMS <= -1.5 otherwise in
                    degrees - for OPTYPE='STAR' DOHMS = -1 produces RA
                    and DEC in decimal degrees while -2 produces
                    offsets in arcsec
            (not used in LIST, for OPTYPE 'STAR' task STARS can use
            all values of DOHMS = 1, -1, and -2 -> set DECIMAL = 0, 1,
            2, resp. in STARS)
  FORMAT.....= -1 => omit row numbers.  Otherwise all OPTYPEs except
             'LIST', 'LIDE', 'STAR', and 'STDE' will print the
             (sorted) row number with each row.
  DOALL......= 1 or 3 scale Peaks and fluxes for primary beam
                      correction stored in MF table
             = 2 or 3 scale Peaks for bandwidth smearing correction
                      stored in table
  CLEV.......> 0 => ('STAR', 'STDE' only) scale source sizes by total
                    flux divided by CLEV.
             <=0 => ('STAR', 'STDE' only) no scaling of source size
  SYMBOL.....Symbol type used for sources ('STAR' only)
             1: Plus sign           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: Cross (X) with gap
                                     23: Vertical line
             If SYMBOL < 0, then the symbol used is
                 flux/(-SYMBOL) + 1
  BOX........To select the column numbers to be printed including their
             order.  Up to 40 may be selected.  0 => all columns in
             basic order.

EXPLAIN SECTION

The MF table has a great many columns.  They are
   1. Plane                            integer
   2. Peak intensity                   Jy or milli-Jy / beam
   3. Integrated I flux                Jy or milli-Jy
   4. X offset of center               degrees or sexagesimal
   5. Y offset of center               degrees or sexagesimal
   6. Major axis                       angle
   7. Minor axis                       angle
   8. position angle                   degrees
   9. Integrated Q flux                Jy or milli-Jy
  10. Integrated U flux                Jy or milli-Jy
  11. Integrated V flux                Jy or milli-Jy
  12. Error in peak intensity          Jy or milli-Jy / beam
  13. Error in I flux                  Jy or milli-Jy
  14. Error in X offset                angle
  15. Error in Y offset                angle
  16. Error in major axis              angle
  17. Error in minor axis              angle
  18. Error in position angle          degrees
  19. Error in Q flux                  Jy or milli-Jy
  20. Error in U flux                  Jy or milli-Jy
  21. Error in V flux                  Jy or milli-Jy
  22. Type of model                    integer
  23. Deconvolved major axis           angle
  24. Deconvolved minor axis           angle
  25. Deconvolved position angle       degrees
  26. Deconvolved major axis lower limit       angle
  27. Deconvolved minor axis lower limit       angle
  28. Deconvolved position angle lower limit   degrees
  29. Deconvolved major axis upper limit       angle
  30. Deconvolved minor axis upper limit       angle
  31. Deconvolved position angle upper limit   degrees
  32. Residual image rms                Jy or milli-Jy / beam
  33. Residual image peak               Jy or milli-Jy / beam
  34. Residual image flux               Jy or milli-Jy
  35. X pixel of center                 pixels
  36. Y pixel of center                 pixels
  37. Major axis in pixels              pixels
  38. Minor axis in pixels              pixels
  39. Position angle in pixel space     degrees
  40. Primary beam factor to apply             ----
  41. Bandwidth smearing factor to apply       ----
  42. Computed velocity (from column 1 actually)    km/s

Note that the beam and delay factors have not been applied to the
brightnesses stored in the MF table.

OPTYPE='LINE': displays independent of number spectral channels
OPTYPE= something not recognized: displays for multi-channel images
   columns 1, 2, 4, 5, 6, 7, 8, 23, 24, 25 1
   with columns 4, 5, 6, 7, 23, and 24 scaled by the angular scale
   appropriate to the image: degrees, arc seconds, milli-arcseconds,
   columns 4 and 5 are in hexidecimal if requested, column 2 may be in
   Jy, milli-Jy, or micro-Jy depending on the peak values, and column
   1 will be listed normally and in velocity if possible.

OPTYPE='CONT': displays independent of number spectral channels
OPTYPE= something not recognized: displays for single-channel images
   columns 2, 3, 4, 5, 6, 7, 8, 23, 24, 25
   with columns 4, 5, 6, 7, 23, and 24 scaled by the angular scale
   appropriate to the image: degrees, arc seconds, milli-arcseconds,
   columns 4 and 5 are in hexidecimal if requested, and column 2 and 3
   may be in Jy, milli-Jy, or micro-Jy depending on the peak values.

OPTYPE='USER' displays
   columns as set by BOX in the order set by BOX.  The units are as
   listed above for each column with "angle" meaning degrees,
   arc-seconds, or milli-arcsec depending on the scale of the image.

OPTYPE='LIST' displays
   columns 35, 36, 3, 6, 7
   with columns 35 and 36 converted to center coordinate in degrees,
   column 3 in milli-Jy (or perhaps micro-Jy), and columns 6 and 7
   combined into a size parameter [sqrt(bmaj*bmin)] in arcsec.  The
   output form,at is suitable for input to SETFC, BOXES, and other
   source-list using tasks.

OPTYPE='STAR' displays
   columns 3, 4, 5, 6, 7, 8
   with columns 4,5 converted into a sexagesimal coordinate pair,
   column 3 used to set the symbol and potentially to scale the
   component size initially set by columns 6 and 7.  The printed
   display is suitable for STARS an gives RA, Dec, Major, Minor, PA,
   type, and label with Major ind Minor in arcsec.

OPTYPE 'STDE' displays
   columns 3, 4, 5, 23, 24, 25
   with columns 4,5 converted into a sexagesimal coordinate pair,
   column 3 used to set the symbol and potentially to scale the
   component size initially set by columns 23 and 24.  The printed
   display is suitable for STARS an gives RA, Dec, Major, Minor, PA,
   type, and label with Major ind Minor in arcsec.

AIPS