How to Run SNAPIN

To run SNAPIN:

    $ SNAPIN

SNAPIN is organized as a set of hierarchical menus. To select an item in a menu, you can type either the number which appears just to its left, or you can type the first few characters of the menu item itself. You will probably find it more convenient to make selections with characters. Often a single character is enough, sometimes 2, 3, or 4 are required to provide uniqueness. The menu usually indicates unique character prefixes in uppercase. The main menu in SNAPIN is:

   <0=MO> Option for SHOT 58505 @ 3.400 s? <Sh>:

   \* Options are:

    1) Read a SNAP input file
    2) Shot, time, dt           INVALID

    3) Physics controls         VALID
    4) Model for Ti             VALID

    5) Magnetics                VALID

    6) Ne                       VALID
    7) Te                       VALID
    8) Ti                       VALID
    9) Vphi                     VALID
   10) Prad                     VALID
   11) Zeff                     VALID
   12) Xi (Chii)                VALID

   13) Beams                    VALID
   14) RF heating               VALID

   15) Impurities               VALID

   16) Comments                 VALID
   17) Write a SNAP input file

   18) List old update messages
   19) Find sources?
   20) Autosnap?

   <0=MO> Option for SHOT 58505 @ 3.400 s? <Sh>: ,

Generally you will visit the major submenus (Shot, time, dt through Impurities) in the order indicated. When you are finished with a particular menu and wish to return to a higher menu level, enter semicolon (;). If you have changed the shot number since last reading a SNAP input file, SNAPIN will force you to visit all of the major submenus. In this case, typing semicolon will advance you to the next major submenu item.

Whenever you enter a menu, its options are displayed and you are prompted for the option you want. If you want to see the menu again, enter RETURN at the menu prompt.

Important: If you enter backslash, \, you will usually back-up to the previous question. This is sometimes useful if you select an option by mistake. When leaving menus, both ; and \ will work, however there is a difference between these two commands in SNAPIN. The ; causes some consistency checking and some SNAP parameters to be set on the way out of a menu--the \ does not! When leaving menus in SNAPIN use ;. If you are confused about whether ; is required, look at the beginning of the prompt--there will be a ; in it, e.g., <2=T;> Set time of analysis is a menu prompt and requires ; to leave that menu.

When you enter >file.com as the response to any prompt, where file.com is a file name of your choice, your responses will be written into that file until you type > or until you leave the program with \x or ^z. You can then invoke this command procedure in a subsequent SNAPIN session, by typing @file.com in response to the same prompt where you started writing the command procedure initially.

SNAPIN uses the TK-UREAD user interface (also used by LOCUS)--a summary of its commands is given in Table 1. Additional capabilities which allow you to pass variable names, etc., are described in the UREAD documentation.

 

 
Table 1: Summary of the TK-UREAD User Interface Commands

The following sections describe the major submenus.