Help for SPOT

PURPOSE

   SPOT is a VICAR*2 applications program to generate spots of various
   profiles and sizes. SPOT currently creates only byte images. If you
   want HALF, FULL or real follow the SPOT call with a cform to translate
   it to those formats.

    To make a uniform disk of DN =  255 you have to call spot with
    with DISK shape

 EXECUTION:
  
  spot OUT=sp.dat SIZE=(1,1,24,24) SHAPE=GAUSSIAN X0=10 Y0=10   SIGMAX=1 SIGMAY=1

   This example will create a 24 x 24 data set 'SP.DAT' with
   a gaussian profile centered at line=10, sample=10.

  NOTE that non-circular symetrical spots can be created by making
  SIGMAX not equal to SIGMAY.

   The SHAPE keyword has six values;
   'GAUSSIAN' FOR GAUSSIAN spot
   'CONICAL'  FOR CONICAL spot
   'RECPROCL' FOR RECIPROCAL spot
   'RECPSQRE' FOR RECIPROCAL SQUARED spot
   'EXPONENT' FOR EXPONENTIAL spot
   'DOME'     FOR DOME spot
   'DISK'     FOR UNIFORM DISK spot
   Other keywords are defined in the TUTOR mode.
 RESTRICTIONS:
  1. BYTE DATA ONLY. Follow SPOT with cform to convert to other formats
  2. MAX SIZE IS 2048 LINE BY 2048 SAMPLES.
  3. SL=1 SS=1 ARE FIXED; THEY ARE IGNORED IN PROGRAM.

 PROGRAM HISTORY:

  04 Nov 2010   R. J. Bambery - added uniform disk model
  02 Nov 2010   R. J. Bambery - expand to 2048x2048, fix
                bug that prevented nl and ns from overriding
                size parameter, changed default nl,ns = 1024
                to nl,ns = 0
  10 Mar 2009   M. Smyth - add to core vicar - 64 bit
  28 MAR  1994  CRI  MSTP S/W CONVERSION (VICAR PORTING) 
  15 AUG  1984...M.E.MORRILL...CONVERTED TO VAX-VICAR*2
  27 JUNE 1975...D.A.HASS...CHANGES FOR CONVERSION TO 360/OS
  12 APRIL 1973...F.G.STAUDHAMMER...DOCUMENTED
  15 MARCH 1973...Y.K.CHEN...ORIGINAL RELEASE

  CURRENT COGNIZANT PROGRAMMER:  L. W. Kamp

PARAMETERS:


OUT

An output data set

SIZE

The standard Vicar size field

SL

Starting line: INTERNALLY SET=1

SS

Starting sample: INTERNALLY SET=1

NL

Number of lines Valid: 1-2048

NS

Number of samples Valid: 1-2048

SHAPE

KEYWORD-OPTIONAL Valid: GAUSSIAN,CONICAL,DISK, RECPROCAL,RECPSQRE,EXPONENT,DOME

DNMAX

INTEGER-OPTIONAL - Maximum DN (255)

SIGMAX

KEYWORD-OPTIONAL - Variance in Sample direction - Default NS/8

SIGMAY

KEYWORD-OPTIONAL - Variance in Line direction - Default NL/8

X0

KEYWORD-OPTIONAL - Sample coordinate of spot center relative to 1,1 - Default NS/2

Y0

KEYWORD-OPTIONAL - Line coordinate of spot center relative to 1,1 -Default NL/2

See Examples:


Cognizant Programmer: