    The following is an example of a run of SHADOWIT. Before this, SHADOW
has been run for an optical system of 4 mirrors. 200 rays were used, with a
random point source.

    All the comments are preceded by a " // "; anything else is exactly as a
screen session. 

$  
$ //                  S H A D O W I T 
$  
$  
$ SHADOWIT 
Interactive [ Y ] or batch session ? 
Y
//  Selects interactive mode. If [ N ], the program will prompt for the name of 
//  a namelist file; see below.
Parameters input. This version is interactive.
How many files to read in ?
//  Up to 10 files can be used. This time, use 4 files.
4 		
File-name : 
BEGIN.DAT 						//  The source
File-name : 
MIRR.01 						//  First mirror
File-name : 
MIRR.02 						//  Second mirror
File-name : 
STAR.04 						//  Final image
How many of the following files: 
   1    BEGIN.DAT
   2    MIRR.01            
   3    MIRR.02            
   4    STAR.04            
do you want to use as defining apertures?
//  SHADOWIT ignores all the losses as computed by SHADOW. We can define up to
//  10 'apertures', i.e., limits, at the files selected. In this case, we want
//  to see the acceptance of the system and the effect on the final image by
//  the two mirrors #1 and #2. The others are assumed 'large'. We will use 
//  two mirrors.
2
Please define which ones [ enter index number ] ? 
File #            1				//  Index of mirror 
//  SHADOWIT keeps track of rays and files in arrays.
 Then ? 
2 						//  2nd of the 4 files available
Column to use for intercept testing ? 
" X "-column:
1
//  Any row is available; here use the x, i.e., the sagittal coordinate.
" Y "-column: 
2 					//  Tangential coordinate.
Rectangular             1		//  Shapes availables
Elliptical              2		//  i.e., round
Elliptical with hole    3 		//  i.e., like a Cassegrain primary.
Aperture type [1-3] ? 
1 					//  The mirror will be rectangular
Xmin = 					//  Dimensions. Must be SIGNED
-0.4 
Xmax = 
0.4 
Ymin = 
-5 
Ymax = 
5 
File #            2			//  Now again. Which other file to use?
 Then ? 
3 				        //  The third (i.e., MIRR.02).See above
Column to use for intercept testing ?   //  all the same
" X "-column: 
1 
" Y "-column: 
2 
Rectangular             1
Elliptical              2
Elliptical with hole    3 
Aperture type [1-3] ? 
1 
Xmin = 
-0.2 
Xmax = 
0.2 
Ymin = 
-2 
Ymax = 
2 
Use how many rays ? 
200
//  How many rays to use. The arrays built by SHADOWIT are large, so caution
//  may be advisable. Do some ^T, to test your Page faulting rate. If too high,
//  increase the working set.
Read from BEGIN.DAT          		//  List of files. If not found, an 
					//  error message will be printed.
Read from MIRR.01            
Read from MIRR.02            
Read from STAR.04            
Array is ready.
Accounting situation:			//  Result of first pass.
Total rays :          200
Good ones  :    71.00000    		//  Only two were succesfully
					//  transmitted.
Lost ones  :    129.0000    
Transm.	   :   0.3550000    		//  Efficiency

Options. Enter :				//  What to do now.
2	file out  (e.g., for TOPDRAWER)		//  This command will write out
						//  the rays that have been
						//  lost in a file xxxx.NHT and
						//  the succesfull ones in
						//  xxxx.HIT (see below).

3	redefine the limits			//  This will modify the
						//  specified limits using a
						//  NAMELIST input.

4	restart with other files		//  Equivalent to restart from
						//  scratch.

5	rewrite the RAYs files			//  <Do not use>
6	exit.
<?> 
2 						//  Elect to write out for
						//  later plotting and/or
						//  processing.
The HIT rays will be in a file of type *.HIT
the others in a file type *.NHT
Files available:				//  Any row of any of the files
						//  may be used to write out.
          1  BEGIN.DAT          		//  In this way it is possible
          2  MIRR.01            		//  to determine e.g. what part 
          3  MIRR.02            		//  of the source will be
          4  STAR.04       			//  transmitted.     
Index of file to prepare ? 
1 						//  Source file
Which columns to write to file ? 
First :: 
4 						//  X' -- we want to see what
						//  part of the angle
						//  distribution is within the
						//  limits.
Second:: 
6 						//  Z'
Filename (max 9 letters, no specifier) ?
SOURCE 
Options. Enter :				//  all done
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
2 						//  another plottable file
The HIT rays will be in a file of type *.HIT
the others in a file type *.NHT
Files available:
          1  BEGIN.DAT          
          2  MIRR.01            
          3  MIRR.02            
          4  STAR.04            
Index of file to prepare ? 
4 						//  Final image
Which columns to write to file ? 
First :: 
1 						//  Sagittal direction
Second:: 
3 						//  Tangential
Filename (max 9 letters, no specifier) ?
F_IMAGE 		
Options. Enter :				//  done
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
3 						//  Now modify limits
Enter the new limits, please. Namelist is INPUT
$INPUT
FILEIN  = 'BEGIN.DAT    ', 'MIRR.01    ', 'MIRR.02    ', 'STAR.04    '
XMAX    =  0.4000000    ,  0.2000000    , 8*0.0000000E+00,
YMAX    =   5.000000    ,   2.000000    , 8*0.0000000E+00,
XMIN    = -0.4000000    , -0.2000000    , 8*0.0000000E+00,
YMIN    =  -5.000000    ,  -2.000000    , 8*0.0000000E+00,
KIND    = 2*1, 8*0,
NFILE   =           4,
NPOINT  =         200,
IFILE   =           2,           3, 8*0,
KOL     = 2*0,           1,           2,           1,           2,
14*0,
NCHECK  =           2,
TRANS   =  0.3550000    
$END					//  This is the status of the parameters
					//  internal to shadowit. The only ones
					//  of importance here are the XMIN,
					//  XMAX,YMIN,YMAX. They are arrays,
					//  and the index is the one of the
					//  files specified above.

 $INPUT 				//  New values; remember that NAMELIST
  YMIN(2) = -4 				//  MUST have the format as shown; 
  YMAX(2) = 4 				//  <SPACE> before $INPUT and 
					//  <SPACE><SPACE> before variables are
 					//  MANDATORY. Also NO SPACES BETWEEN
					//  variables and parenthesis.
					//  i.e., X  (1) is forbidden.
 $END

Accounting situation:			//  New values
Total rays :          200
Good ones  :    139.0000    		//  <<<<---- notice change
Lost ones  :    61.00000    
Transm.	   :   0.6950000    		//  <<<<----
Options. Enter :			//  same as above
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
2 
The HIT rays will be in a file of type *.HIT
the others in a file type *.NHT
Files available:
          1  BEGIN.DAT          
          2  MIRR.01            
          3  MIRR.02            
          4  STAR.04            
Index of file to prepare ? 
4 
Which columns to write to file ? 
First :: 
1 
Second:: 
3 
Filename (max 9 letters, no specifier) ?
F_IMAG 
Options. Enter :
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
2 
The HIT rays will be in a file of type *.HIT
the others in a file type *.NHT
Files available:
          1  BEGIN.DAT          
          2  MIRR.01            
          3  MIRR.02            
          4  STAR.04            
Index of file to prepare ? 
1 
Which columns to write to file ? 
First :: 
4 
Second:: 
6 
Filename (max 9 letters, no specifier) ?
SOURCE 
Options. Enter :
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
2 
The HIT rays will be in a file of type *.HIT
the others in a file type *.NHT
Files available:
          1  BEGIN.DAT          
          2  MIRR.01            
          3  MIRR.02            
          4  STAR.04            
Index of file to prepare ? 			//  This time look at mirror
2 
Which columns to write to file ? 
First :: 
1 
Second:: 
2 
Filename (max 9 letters, no specifier) ?
MIRR2 
Options. Enter :
2	file out  (e.g., for TOPDRAWER)
3	redefine the limits
4	restart with other files
5	rewrite the RAYs files
6	exit.
<?> 
6 
$
$  
$ //  This concludes the SHADOWIT run; let's have a look at the results
$ //  Compare with above commands
$
$ dir/since=-1:00 

Directory D2:[SHADOW.SHADOW.TEST2]

F_IMAG.HIT;1              9  	//  Results on the final image of the mirrors
F_IMAG.NHT;1              4  	//  finite dimensions
F_IMAGE.HIT;1             5  
F_IMAGE.NHT;1             9  

MIRR2.HIT;1               9  
MIRR2.NHT;1               4  

SHADOWIT.NML;13           2  	//  Parameters used in the two runs; they can
SHADOWIT.NML;12           2  	//  be used as direct input, without the I/O
				//  session [ see top ]
SOURCE.HIT;4              9     //  Part of source transmitted
SOURCE.HIT;3              5  
SOURCE.NHT;4              4  	//  Part of source NOT transmitted
SOURCE.NHT;3              9  

Total of 13 files, 71 blocks.
$
$ logo 
  CERRINA      logged out at 18-JAN-1986 21:06:17.01
