/  This is an example which introduces the various help facilities and
/  the use of MENU input mode.

System PSLC (vms 4.3)

Username: SHADOW
Password: 
        Welcome to VAX/VMS Version 4.3
       University of Wisconsin - Madison
         Physical Sciences Laboratory 

CMS 2.1 has been installed.  $BULLETIN for details.
The RS/1 demo has been installed. Enter $BULLETIN for details.
Phone lines have been installed in PSLB.
     $HELP @PSL TELEPHONES for details.

    Last interactive login on Thursday,  3-APR-1986 14:18
    Last non-interactive login on Tuesday, 25-FEB-1986 21:46

You are logged into _RTA2:





Graphic device [ e.g. TTB3: ] : tt:

All logical names and commands defined.
Enter $GO to activate SHADOW.
Enter HELPSHA for help.
Type NEWS for recent modification.: NEWS 





-------------------------------------------------------------------------------

SHADOW

-------------------------------------------------------------------------------

 For online HELP, enter:  

                 >>>>>>>>   $HELPSHA    <<<<<<<<<

 SHADOW is a set of several programs, still in evolution and growth. In order to
access them, several commands have been defined. These programs are listed in
the online help, under the 'commands' heading. There are three types of 
programs:

 a. Pre-processors, used in order to create some files needed by the 
    ray-tracing main program, SHADOW.

 b. Ray-tracing programs, that actually perform the tracings.

 c. Post-processors, that examine and display or otherwise process the output 
    from SHADOW.

 Notice that (a) and (c) are invoked at DCL (VAX) level, while (b) are invoked
 by the command:
     $GO [specifier]

 where 'specifier' = Menu, Trace, Source, Help, or <blank>.

 To get started, examine the xxxx.demo files in the [.demo] directory.



 The programs are now located in the following directories at PSL. On other
installation the root name may be different but the structure must be the same.

 D2:[shadow.SHADOW]Main programs

 D2:[shadow.UTIL]Utilities

 D2:[shadow.GRAPHICS]Graphics packages

 D2:[shadow.OPCON]Optical constants

 D2:[shadow.MENU]Menu
 D2:[shadow.DEMO]Demo runs

 All the files are accessible to any user. The protections are set for reading,
not for writing, so you will have to run them from your directory. 

 Some of the commands may give rise to errors until the transfer is complete.
Please notify me at:

               PSLA::[CERRINA]       ---    DECNET

            cerrina@wiscpsla         ---    BITNET, JNET, ARPANET

            Department of Electrical and Computer Engineering
            1415 Johnson Dr., MADISON -- WI 53706

            608 - 263 - 4955


 
 

//  The former has been a simple introduction.

$ HELPSHA
//  Invokes SHADOW help



HELP

  This facility describes the utility programs used to analyze the output
  from SHADOW.

   BEAM refers to a Binary Output File created by SHADOW, i.e., of the type
  STAR.xx, MIRR.xx, etc. and containing a double precision array describing
  a collection of rays defining the beam at that particular location.



  Additional information available:

  Analysis   COMMANDS   DEFINITIONS           DIRECTORIES           Graphics
  Gratings   help       Miscellaneous         Output_files
  Physical_optics       Pre-processors        SUGGESTIONS
  Translation

Topic? commands 


COMMANDS

    Many programs can be accessed by simple commands (usually the same as
    the file-name). For example, to run SHADOW the command
                            $ GO
    will start the program. All the outputs will be directed to the default
    directory where the program is run from.

    Additional information:



  Additional information available:

  SHADOW     GO         MINMAX     PLOTXY     PREPLOT    TRANSLATE  HISTO1
  H2KOL      HISTO2     VARIANCE   FOCNEW     GRAPHICS   OPTICS
  Utility_programs      FMAX       INTENS     MIRINFO    SOURCEINFO PP
  RECOLOR    RETRACE    SR*        SYSPLOT    TOPATH     VOPER      BOXAREA

COMMANDS Subtopic? 
Topic? 

//  To initiate the ray-tracing programs we type " GO ".
$ GO



  :::::::  :::    ::            :::    :::::::        :::::     :::  ::  ::
 ::::::::  :::    ::           ::::    ::::::::      :::::::    :::  ::  ::
:::        :::    ::          ::: :    :::   :::    :::    ::   :::  ::  ::
:::        :::    ::         ::: ::    :::    ::    :::    ::   :::  ::  ::
 :::::::   :::::::::        :::  ::    :::    ::    :::    ::   :::  ::  ::
  :::::::  :::::::::       :::   ::    :::    ::    :::    ::   :::  ::  ::
       ::  :::    ::      :::    ::    :::    ::    :::    ::   :::  ::  ::
      :::  :::    ::     :::     ::    :::   :::    :::   :::   ::: ::: :::
::::::::   :::    ::    :::      ::    ::::::::      :::::::     :::::::::
:::::::    :::    ::   :::       ::    :::::::        :::::       ::: :::




VERSION     86.4                                                19 JAN 1986




Hit <RETURN> when ready: 








                            S H A D O W


Commands Available at this level:

HELP              More informations on the following commands
INIT              Defines scratch directories and set default to scratch
MENU              Begins the process of defining an Optical System
TRACE             Starts the tracing of an Optical System from a specified
                  source file
SOURCE            Generates a source file
EXIT              Returns to DCL



//  Investigate HELP resource.



Shadow:: HELP




HELP


                          SHADOW command interpreter


  Additional information available:

  COMMANDS   Getting_started       HELP       LEVELS_nesting

Topic? commands


COMMANDS


    The following commands are accepted at this level:



  Additional information available:

  MENU       SOURCE     TRACE     EXIT       INIT

COMMANDS Subtopic? 
Topic? 
//  A list of commands is also given by typing " ? " in response to the prompt.
Shadow:: SOURCE
Source selected. Begin procedure.
This procedure generates a SOURCE for SHADOW.
Mode selected [ ? <ret> for HELP ] ? : MENU
Prepare MENU ...

Ready::
 
//  The prompt at MENU level is " Ready:: ".

Ready:: ?

//  Investigate  helpful information at this level.
  Information available:

  DEFINE     DELETE     GOTO       LIST       LOAD       Overview   SAVE
  SELECT     SPAWN

Topic? OVERVIEW

OVERVIEW


    The program is subdivided in a COMMAND interpreter and in a set of screen
    oriented menus.



  Additional information available:

  MENU

OVERVIEW Subtopic? MENU

OVERVIEW

  MENU


      The MENU programs uses the arrows of a DEC type terminal to position the
      cursor in the menu. The program works best on a VT100-VT200 type
      terminal.

      ^   |
      | , v  are used to move between the menu lines

      -->    is used to enter a submenu or to move between OE's.

      <--    to go back to next higher menu. If none, the program returns to
      the command level. It is equivalent to an EXECUTE command.

      ^W     refreshes the screen.

       ?     will give a description of the variable where the cursor is
             currently located.

      ^C, as well as EXIT, STOP, RETURN, QUIT will return the menu to the
             command level.

           Unrecognized inputs will result in a brief listing of valid entries.
           When in doubt, enter some gibberish.


OVERVIEW Subtopic? 
Topic? ?

  Information available:

  DEFINE     DELETE     GOTO       LIST       LOAD       Overview   SAVE
  SELECT     SPAWN

Topic? DEFINE

DEFINE


    qualifiers: OE SCREEN

    Adds new OEs or SCREENs to the System. If the OE already exists, the list
  is moved up to make room for the new OE. For example, if the system consists
  of 4 OE, the command
      $DEFINE OE
       element number? 1

  will generate a system as:

       OE    1     ---> new OE (empty)
       OE    2          old OE    1
       OE    3          old OE    2
       OE    4          old OE    3

   Same for SCREENs.



  Additional information available:

  OE         SCREEN

DEFINE Subtopic? 
Topic? 
Ready:: SELECT SOURCE
	Source Definition
	File to store the rays		    BEGIN
	Source Type (+)			    RAN/RAN
	Number of random rays		    1000
	Spatial Type (+)  		    POINT
	Depth				    OFF
	Angle Distribution (+)              FLAT
	Photon Energy Distribution (+)      OFF
	Store Optical Path                  NO
	Polarization (+)		    NO
	Coherence                           COHERENT
/  To exit the menu hit left arrow ( <== ).  We have changed nothing.  The
   default characterizes a random point source with zero angular distribution.

Ready:: SAVE SOURCE
               Save Source Description
	Directory name 			    SYS$START:
	File name			    START
/  Again, exit by hitting <==.  The default for file name of the source is
/  START.00.  The SOURCE is saved in START.00.
Writing to file SYS$START:START.00
Ready:: DEFINE OE 
Element: 1
Ready:: LIST
The Optical system consists of    1 OE
OE number    1 has    0 screens defined.
Currently set at OE:    1
Ready:: DEF OE 
Element: 2
Ready:: LIST

The Optical system consists of    2 OE
OE number    1 has    0 screens defined.
OE number    2 has    0 screens defined.
Currently set at OE:    2

Ready:: GOTO
New OE: 1
Ready:: LIST

The Optical system consists of    2 OE
OE number    1 has    0 screens defined.
OE number    2 has    0 screens defined.
Currently set at OE:    1
Ready:: DEF SCREEN
Screen/Slit: 1
Ready:: LIST

The Optical system consists of    2 OE
OE number    1 has    1 screens defined.
OE number    2 has    0 screens defined.
Currently set at OE:    1
/  Notice how the pointer works when you add screens/slits.  The screen was
/  placed on OE #1.
Ready:: SELECT OE
Number of element: 1
	Reference Axis and Type			     Optical element   1
	Source plane distance                 0.00	30
	Image plane distance 		      0.00	40
	Incidence angle			      0.00	20
	Reflection angle		      0.00	20
	Mirror orientation angle	      0.00
	Source file			      BEGIN
	 --- Sub-menus available ---
	Type of element (+)		      REFLECTOR
	Figure (+)			      PLANE
	Diffraction (+)			      MIRROR
	Crystal (+)			      NO
	Mirror Movement (+)		      NO
	Ripple Surface (+)		      NO
	Exit Slit (+)			      NO
	Source Movement (+)		      NO
	    Goto OE (+)
/  Enter 30 <CR> for source plane distance,
/        10          image plane distance,
/        20          incidence angle,
/        20	      reflection angle.
/  Hit <== to exit.
Ready:: SAVE OE
 		Save Optical Element Description
	The file is specified as xxxxx.yy
	where xxxxx is the root, yy the
	position sounter in the system.
	Directory name			      SYS$START
	 File name			      START
	Current OE number		      1
	OE number for disk file [ 1-10]       0			1
/  The displayed value for " current OE number " is that which we chose using
/  the SELECT command, and for " OE number for disk file " must be corrected.
/  Enter 1 for START.01.  Hit <== to exit.  OE #1 is saved in START.01.
  
	Writing to file SYS$START:START.01
Ready:: SEL SCREEN
Number screen/slit: 1
/  Note we had to position the pointer to OE #1 (which was accomplished by
/  SELECTing it) in order to SELECT a screen at OE #1.
	View Screen/Slit Data		Optical Element 1	Screen 1
	Position rel. to mirror		BEFORE
	Distance (abs) from mirror      0.00		5
	Aperturing			NO
	Open slit/ solid stop	    n/a SLIT
	Aperture stop		    n/a RECTANGULAR
	Slit width/ x-axis	    n/a 10.0
	Slit height/ z-axis	    n/a 10.0
	Absorption		        NO
	Thickness [ CM ]	    n/a 0.00
	Opt. Const. Filename        n/a NONE SPECIFIED
	     Goto Screen/Slit (+)
/  Enter 5 <CR> for distance from mirror.  Hit <==.  You don't have the option 
/  to issue SAVE SCREEN.  The file containing screen info is generated during 
/  TRACE.
Ready:: SEL OE
Number of element: 2
	Reference Axis and Type			     Optical element   1
	Source plane distance                 0.00	10
	Image plane distance 		      0.00	10
	Incidence angle			      0.00	45
	Reflection angle		      0.00	45
	Mirror orientation angle	      0.00
	Source file			      BEGIN
	 --- Sub-menus available ---
	Type of element (+)		      REFLECTOR
	Figure (+)			      PLANE
	Diffraction (+)			      MIRROR
	Crystal (+)			      NO
	Mirror Movement (+)		      NO
	Ripple Surface (+)		      NO
	Exit Slit (+)			      NO
	Source Movement (+)		      NO
	    Goto OE (+)
/  Enter 10 <CR> for source plane distance,
/        10          image plane distance,
/        45          incidence angle,
/        45	      reflection angle.
/  Hit <== to exit.

Ready:: SAVE SYSTEM
/  This command applies to OEs only.  You must SAVE SOURCE seperately.
		Save Optical System Description
	Directory name			      SYS$START
	File name			      START
Writing to file SYS$START:START.01
Writing to file SYS$START:START.02
/  Creates file SYSTEMFILE.DAT which contains the parameter files for all OEs.
/  Note that OE #2 was not saved specifically though it is now saved.  
 
Ready:: EXIT
Generated		250  rays out of	1000
		500
		750
	       1000
Exit from Source.
SOURCE => Source has been successfully generated.
Source procedure completed.

Shadow:: TRACE 
Ray Tracing Selected. Begin procedure.
Mode selected [ ? <ret> for HELP ] ? : menu
MENU selected.

Execute existing SYSTEMFILE ? : Y
Call to RESET
Exit from RESET

Mode selected is: 
MENU                                                                        
Options: to start anew                 [ 0 ] 
            to restart from a given OE [ 1 ] 
Then ? 
0
Tracing optical element #            1
Call to SETSOUR
Exit from SETSOUR
Call to IMREF
Exit from IMREF
Call to OPTAXIS
Exit from OPTAXIS
Call to MSETUP
Exit from MSETUP
Call to RESTART
Exit from RESTART
Call to SCREEN
Exit from SCREEN
Call to MIRROR
Exit from MIRROR
Call to IMAGE
Exit from IMAGE
Call to RESET
Exit from RESET

Tracing optical element #            2
Call to SETSOUR
Exit from SETSOUR
Call to IMREF
Exit from IMREF
Call to OPTAXIS
Exit from OPTAXIS
Call to MSETUP
Exit from MSETUP
Call to RESTART
Exit from RESTART
Call to MIRROR
Exit from MIRROR
Call to IMAGE
Exit from IMAGE
Call to RESET
Exit from RESET

 
Procedure completed. Return to COMMAND level
Procedure completed.

Shadow:: EXIT
Exit to DCL

$ dir
Directory D9:[SHADOW.DEMO]

BEGIN.DAT;1             188   3-FEB-1987 15:49  (RWED,RWED,RE,RE)
EFFIC.01;1                1   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
EFFIC.02;1                1   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
END.00;1                  6   3-FEB-1987 15:49  (RWED,RWED,RE,RE)
END.01;1                 11   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
END.02;1                 11   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
MIRR.01;1               188   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
MIRR.02;1               188   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
OPTAX.01;1                2   3-FEB-1987 16:05  (RWED,RWED,RE,RE)
OPTAX.02;1                3   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
SCREEN.0101;1           188   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
STAR.01;1               188   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
STAR.02;1               188   3-FEB-1987 16:06  (RWED,RWED,RE,RE)
START.00;1                6   3-FEB-1987 15:46  (RWED,RWED,RE,RE)
START.01;2               11   3-FEB-1987 15:48  (RWED,RWED,RE,RE)
START.02;1               11   3-FEB-1987 15:48  (RWED,RWED,RE,RE)
SYSTEMFILE.DAT;1          1   3-FEB-1987 15:48  (RWED,RWED,RE,RE)

Total of 18 files, 1192 blocks.
