AIPS NRAO AIPS HELP file for SPXMD in 31DEC25



As of Wed Mar 26 15:37:05 2025


SPXMD: Task to alter image adding models w spectral index

INPUTS

INNAME                             Input I image name (name).
INCLASS                            Input I image name (class).
INSEQ             0.0     9999.0   Input I image name (seq. #).
INDISK            0.0        9.0   Input I image disk unit #.
OUTNAME                            Output image name (name).
OUTCLASS                           poutput image name (class)
OUTSEQ           -1.0     9999.0   Output image name (seq. #).
OUTDISK           0.0        9.0   Output image disk unit #.
BLC                                Bottom left corner of input.
TRC                                Top right corner of input.
FLUX                               Noise level to add
FACTOR                             Multiplication factor.
REFREQ                             Reference frequency in GHz
INLIST                             List of sources up to 9999
                New image parameters:
COORDINA                           Ra, Dec coordinates
IMSIZE                             Ra, Dec number of pixels
CELLSIZE                           Ra, Dec increments in asec
APARM                              (1) Frequency (GHz) plane 1
                                   (2) increment (GHz)
                                   (3) number channels
FPARM                              Start channel: offset
RPARM                              End channel: offset
VPARM                              Scale amplitude
DOFIT                              Scale noise

HELP SECTION

SPXMD
Type: TASK
Use: This task can be used to modify an existing image cube adding
     Gaussian components with spectral index.
Adverbs:
  INNAME.....Input image name (name).     No default.
  INCLASS....Input image name (class).    Standard defaults.
  INSEQ......Input image name (seq. #).   0 => highest.
  INDISK.....Disk drive # of input image. 0 => any.
  OUTNAME....Output image name (name).    Standard defaults.
  OUTCLASS...Output image name (class).    Standard defaults.
  OUTSEQ.....Output image name (seq. #).  0 => highest unique.
  OUTDISK....Disk drive # of output image.  0 => highest
             number with sufficient space.
  BLC........Bottom right corner in input image of desired
             subimage.  Default is entire image.
  TRC........Top right corner in input image of desired
             subimage.  Default is entire image.
  FLUX.......Noise level to be added (in the units of the image)
  FACTOR.....Factor by which the original data is multiplied
             before it is added to the model.  0 => drop original
             data.
  REFREQ.....Reference frequency in GHz.  0 -> header or APARM(1)
             for a new image cube.
  INLIST.....Text file containing one line per source, giving

             Peak, X, Y, Maj, Min, PA, type, spectral index, curvature

             blank separated free format and all values must be
             specified even if zero.  The resulting NGAUS will be the
             number of non-comment lines in INLIST.  Limit 9999.

             (1) The is in Jy/beam;
             (2) The component coordinates and size are X, Y, Maj
                 and Min are in pixels, PA in degrees;
             (3) Types are point, Gaussian, uniform disk, uniform
                 rectangle, optically thin sphere, and exponential for
                 code numbers 1 through 6.  Other values -> 2.

             Blank lines and lines beginning with # or ; (semi-colon)
             are taken as comments
  COORDINA...RA (hours minutes seconds of time), declination (degrees,
             minutes, seconds of arc) for reference pixel (at image
             center).
  IMSIZE.....X, Y image size in pixels
  CELLSIZE...X, Y image spacing in arc sec
  APARM......(1) Reference frequency at first output plane in GHz
             (2) Increment in frequency in GHz
             (3) Number of frequency pixels
  FPARM......Start channel number for group i
  RPARM......End channel number for group i
  VPARM......Multiply amplitude for group i
  DOFIT......Multiply noise (FLUX) for group i

To offset 3 groups in amplitude and 2 in noise for example
   FPARM   1  20  88
   RPARM   7  33  99
   VPARM  0.8 1.2 0.9
   DOFIT   1  3   2


If making a new image  set INNAME blank.  COORDINA, IMSIZE, CELLSIZE
are required for a new image, ignored for an existing image.
APARM is rquired for a new image, APARM(3) is ignored for an
existing image unless there is only one plane.  APARM(1) and (2)
are used if set even with an existing image.


EXPLAIN SECTION


AIPS