ADD-TO-MAP

Insert the spectrum currently held in the X-register into the open map. Evaluates the nominal position by adding the RA and Dec. offsets from the map header to the ``map_centre'' position stored in the header -- then determines the offset from the actual center of` the map, and attempts to put the spectrum in the pixel nearest to this calculated offset.

Before inserting the spectrum in the map file, the routine checks that the positional discrepancy (in pixels) is less than the maximum ``tolerance'' set by SET-MAP-ACCEPT; if the discrepancy is greater than MAP_TOL then an error message is issued. An existing spectrum is replaced by the new one only if REPLACE is TRUE, as defined in SET-MAP-ACCEPT.

If the map is currently empty, and no map center was specified in the OPEN-MAP command, then the ``map-center'' of the spectrum header is used as the center of the map also.

Relevant flags:

REPLACE	L4	True if scan should overwrite one already in the map.
MAP_TOL	R4	Maximum permitted offset from a map grid point in pixels.

Examples:

  >> add-to-map<CR>
  Total RA, Dec offsets (arcsec):   0.0000000E+00  0.0000000E+00
  Total X, Y offsets (cells):   0.0000000E+00  0.0000000E+00
  Spectrum position is 0.0 arcsec in X and 0.0 arcsec in Y from nearest pixel
  Spectrum placed in cell (  0.0,  0.0)