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: