next up previous contents
Next: &INIT Up: No Title Previous: Files

Input Records

 

To run SESAME an input file containing all parameter specifications necessary to describe the current application must be provided by the user, either by writing it using an text editor or by creating it by means of the graphics user interface (GUI) described in Chapter 5.

The input language of SESAME uses the NAMELIST extension of FORTRAN. Each NAMELIST record (here called ``input record'') contains a set of input variables. The input records are specified in the input file (see also Chapter 8), starting with line 3. The first two lines of the INP.DAT file are comments and skipped by the program. An input record starts in column 2 of the input file with an &, followed by the name of the namelist record and the entities (variables) to be given values. It ends with &END. According to different FORTRAN dialects deviating formats are possible. (e. g. replacing & by $ might be required.) A typical input record reads

 &name entity1=value1,entity2=value2,...  ,&END
with the first character being a blank. &name is the name of the NAMELIST record, entityi is the i-th variable name, and valuei the value to be assigned to entityi. Values of logical variables may either be T (true) or F (false). Entries of an array may be specified after the = sign separated by commas:
 &name arrayentity=value1,value2,...  ,&END
As a very convenient feature of NAMELIST inputs, only those entities have to be specified whose predefined default values (given by the program before reading the NAMELIST record) are to be changed. All variables known by SESAME are assigned to 9 different namelists which were chosen and named in such a way that a logical and consistent structure of the input deck can be achieved. This should support the generation of easy-to-read and well structured input decks.

There is an &INIT record which includes all parameters which might be useful for overall description and initialization of an application. Electron specific parameters, like the initial electron energy or the total number of electrons to simulate, are combined in the &ETRNS record, whereas electronbeam specific parameters, like beam divergence or spot size, are to be found in the &EBEAM record. The target, specified by, for instance, a geometry file name, the target atoms, the density, etc., is described in the &TARGET namelist. Simulation model specific adjustments can be made using the &MODEL record. Parameters describing the measurement set-up, excluding those specifying the electron column, the instrument and the detector itself, are combined in the &MSETUP namelist. This record contains variables describing, for example, the magnification, the lateral electron impact position, or all detector and electron beam angles. The INSTR namelist contains some instrument specific parameters, like the pixel distance on the CRT, whereas the &DETECT record combines x-ray and electron detector specific variables, like the thickness and the material of the detector window or the transmission of the electron analyser. Finally, he &OUTPUT record contains all variables needed to control SESAMEs output.

It should be also mentioned here that only three variables are obligatory, this means they have to be specified explicitly. These are the initial energy E0 of the impinging electrons NETRN, the total number of electrons, both in the &ETRNS record, and the file name of the file containing the geometry description CGFILE in the &TARGET namelist.

An interesting feature, which should be explicitly outlined, is the option to specify files containing namelists in the "master" input file. This can be done in the &INIT record. For more information see Chapter 9.1 ( FINSTR, FDETCT and FMYDEF).

Examples of input files may be found in this manual, Chapter 4 and Chapter gif.





next up previous contents
Next: &INIT Up: No Title Previous: Files



Horst Wagner
Tue Mar 19 10:24:55 MET 1996