next up previous contents
Next: Postprocessing Up: Input Records Previous: &DETECT

&OUTPUT

 

This record is used to specify the amount of output to be written to output files or visualized on screen. A list of all possible three-character-long short-cuts (acronyms) necessary for the specification of output information can be found below. We have striven to use the following abbreviations consistently for output short-cuts: SE for Secondary Electrons, BE for Backscattered Electrons, TE for Transmitted Electrons, AE for Auger Electrons, XC for Characteristic X-rays,

IO for Ionisation, T for Trajectory, E for Energy distribution, P for Polar angle Distribution, A for Azimuthal angle distribution, W for polar and azimuthal angle Distribution, D for energy, polar angle and azimuthal angle distribution, S for Spectrum, and Y for Yield. A Yield is always plotted as a function of lateral electron beam position and therefore makes sense only if the electron beam is scanned over the sample. For example, PET stands for Primary Electron Trajectories, XCS for characteristic X-Ray Spectrum and SEE for Energy distribution of Secondary Electrons. Generally the output to up to 20 windows on the screen, up to 6 PostScript files, up to 10 binary PROMIS SAVE files, and up to 10 1D, 2D and 3D ASCII histogram files can be controlled by the &OUTPUT record. However, it is highly recommended not to use these output options extensively since this might lead to high consumption of CPU time as well as memory and disk space.

LIST OF SUPPORTED OUTPUT SHORT-CUTS:

CGRDFL --- Grid File Name

This variable specifies the name of a grid file. The required syntax is described in Chapter 8. This grid is used for the following output: IOD, XGD, XDD. If no grid is specified then a grid is automatically generated.

FETAB --- Tabulated Electrons

This variable specifies a file name of a file containing the starting point, the direction and the energy of electrons. If specified, electrons are not generated but starting points (X,Y,Z), directions (DIRX,DIRY,DIRZ) and energies of electrons (E) are read from the file and simulation is performed by calculating the trajectories of these electrons. This may be used to read the information of secondary electrons generated during a previous simulation. Specifying a file , electrons are not generated but starting point,direction and energy read out of the file. FRAC is .... File Format : X Y Z DIRX DIRY DIRZ E FRAC

FETRBK --- Backup File Name

This variable specifies the backup file name to which the backup information should be written. The default file name is JOB.BCK. For more information see Chapter 6.9.

HIST --- Output to Histogram File

All data specified by HIST is written to an ASCII histogram file. For each histogram file the following character string must be secified.

SHORT_CUT,[N1],[MN1],[MX1],[N2],[MN2],[MX2],[N3],[MN3],[MX3];[FILE_NAME]; [SHELL/LINE/PEAK_SPEC];[DETECTOR#]

Valid SHORT_CUTs are listed below under 'Range:'. All quantities in brackets "[ ]" are optional, i.e. they do not need to be explicitly specified because there exist default values for them. MN# and MX# are the minimum and maximum value of axis #, respectively, and N# is the number of intervals for axis #. For none space-dependent distributions higher than one-dimensional the sequence of specifying the ranges is important. This sequence is: energy, azimuthal angle, polar angle. This means, for example, that SCREEN(1)='BED,,,,,30,,,,45' specifies that backscattered electrons should be visualized in dependence of their energy (default values), their azimuthal angle between 30 degrees and the default value and of their polar angle between the default value and 45 degrees. The default ranges are: 0 to E0 keV for energy, 0 to 360 degrees for azimuthal angle and 0 to 180 degrees for polar angle. In cases where distributions in dependence of space coordinates are defined the ranges [MN1],[MX1],[MN2],[MX2] are real space coordinates ( XCY, ION). In this case, the default values are the dimensions of the actual simulation geometry.

Separated by a first semicolon (";"), file names for the histogram files may be specified. The default file names are 'job_name'_xxx.H#D. The 'job_name' is either the name of the input deck (default) or may be specified explicitly by the JOB variable in the &INIT namelist. xxx is one of the 3 character SHORT_CUTs. # may be 1, 2 or 3 and indicates the dimensionality of the distribution.

In some cases it is also necessary to specify a shell, an characteristic x-ray line or an Auger peak ( IOL, IO2, IO3, IOD, XCY, AEY). This string (SHELL/LINE/PEAK_SPEC) is separated by a second semicolon (";") and contains the chemical abbreviation of an element separated by a comma from either the ionized shell, the characteristic x-ray line or an Auger peak. For more information on such specifications and their default values see Tables 9.4 to 9.6. All supported shells, characteristic x-ray lines, and Auger peaks are listed in Tables 9.7 to 9.8.

Whenever x-rays and/or electrons must be detected (distributions, scans) a detector number may be specified (DETECTOR#) after the third semicolon. Up to 5 different x-ray and electron detectors may be specified. If no detector number is explicitly declared then the default detector ( detector number 0) will be taken. For mor information on x-ray and electron detectors see Chapter 6.3 and 6.4, respectively.

LGRAY --- Gray Scale Visualization for Histograms

When set to T spacial dependent histograms (scans) will be visualized on screen in a gray scale mode. This might ease comparisons to measured scans.

LGRID --- Draw Grid for X-ray Distributions

When set to T the grid is drawn on the screen in every window containing spacial output. For more information concerning the grid see Chapter 6.8.

LQUAD --- Draw the QuadTree

When set to T the quadtree is drawn on the screen in every window containing spacial output.

LSCDEF --- Default Output to Screen

When set to T, then default output according to the specification of SIGNAL and/or TECHQU in the &INIT namelist is visualized on screen. The default output to screen is XCS for SIGNAL=XC and ION for SIGNAL=IO. If SCAN in &EBEAM is set to T then the default screen output is BEY for SIGNAL=BE, SEY for SIGNAL=SE, TEY for SIGNAL=TE, and AEY for SIGNAL=AE. If SCAN is set to F then the default output tp screen is BEE for SIGNAL=BE, SEE for SIGNAL=SE, TEE for SIGNAL=TE, and AES for SIGNAL=AE (see also Table 9.9).

LSCRN --- Output to Screen

When set to F, then no output, neither the SESAME status window nor the output specified by the SCREEN array, will be visualized on screen. The default value is T.

LSTATW --- Status Window to Screen

When set to F, then no SESAME status window will be visualized on screen. If LSCRN is explicitly specified to F then LSTATW is also automatically set to F and no status window will appear on the screen. The default value is T.

NETRBK --- Number of Electrons for Backup

This variable specifies the number of electrons after which a backup file shall be written/updated. NETRNBK=0 means that no backup file shall be written. The default file name is JOB.BCK.

NSCRUP --- Number of Electrons for Screen Update

This variable specifies the number of electrons after which the screen shall be updated. This variable has no influence on electron trajectories visualized on the screen since these are updated continuously.

PMSAV --- Output to Binary file

All data specified by PMSAV is written to a POSTMINI SAV (PROMIS SAVE format) file. For each POSTMINI SAV file the following character string must be secified. For space dependent output: ( IOD, XGD, XDD)

SHORT_CUT,[MN1],[MX1],[MN2],[MX2];[FILE_NAME];[SHELL/LINE/PEAK_SPEC]; [DETECTOR#]

For all other output (histograms):

SHORT_CUT,[N1],[MN1],[MX1],[N2],[MN2],[MX2];[FILE_NAME]; [SHELL/LINE/PEAK_SPEC];[DETECTOR#]

Valid SHORT_CUTs are listed below under 'Range:'. All quantities in brackets "[ ]" are optional, i.e. they do not need to be explicitly specified because default values preexist. MN# and MX# are the minimum and maximum value of axis #, respectively, and N# is the number of intervals for axis #. For non-space-dependent distributions higher than one-dimensional the sequence of specifying the ranges is important. This sequence is: azimuthal angle, polar angle. This means, for example, that SCREEN(1)='BEW,,30,,,,45' specifies that backscattered electrons should be stored in dependence of their azimuthal angle between 30 degrees and the default value and of their polar angle between the default value and 45 degrees. The default ranges are: 0 to 360 degrees for azimuthal angle and 0 to 180 degrees for polar angle. In cases where distributions in dependence of space coordinates are defined the ranges [MN1],[MX1],[MN2],[MX2] are real space coordinates. In this case, the default values are the dimensions of the actual simulation geometry.

Separated by a first semicolon (";"), file names for the POSTMINI SAV files may be specified. The default file names are 'job_name'_xxx.SAV. The 'job_name' is either the name of the input deck (default) or may be specified explicitly by the JOB variable in the &INIT namelist. xxx is one of the 3 character SHORT_CUTs.

In some cases it is also necessary to specify a shell, a characteristic x-ray line or an Auger peak ( ION, IO2, IOD, XGD, XDD, AGD, ADD). This string (SHELL/LINE/PEAK_SPEC) is separated by a second semicolon (";") and contains the chemical abbreviation of an element separated by a comma from either the ionized shell, the characteristic x-ray line or an Auger peak. For more information on such specifications and their default values see Tables 9.4 to 9.6. All supported shells, characteristic x-ray lines, and Auger peaks are listed in Tables 9.7 to 9.8 .

Whenever x-rays and/or electrons must be detected (distributions, scans) a detector number may be specified (DETECTOR#) after the third semicolon. Up to 5 different x-ray and electron detectors may be specified. If no detector number is explicitly declared then the default detector ( detector number 0) will be taken. For mor information on x-ray and electron detectors see Chapter 6.3 and 6.4, respectively.

POST --- Output to PostScript File

All data specified by POST is written to a PostScript file. For each output to a PostScript file the following character string must be secified.

SHORT_CUT,[PS_FILE#],[MN1],[MX1],[MN2],[MX2];[FILE_NAME];[WIDTH],[HEIGHT]; [SHELL/LINE/PEAK_SPEC];[DETECTOR#]

Valid SHORT_CUTs are listed below under 'Range:'. All quantities in brackets "[ ]" are optional, i.e. they do not need to be explicitly specified since there already exist default values for them. MN# and MX# are the minimum and maximum value of axis #, respectively. The default values are the dimensions of the actual simulation geometry. It is also possible to specify a PostScript file number ( PS_FILE#) since more than one information may be written to one PostScript file. This number ( PS_FILE#) must point to an already specified POST(PS_FILE#) variable.

Separated by a first semicolon (";"), file names for the PostScript files may be specified. The default file names are 'job_name'_xxx.ps. The 'job_name' is either the name of the input deck (default) or may be specified explicitly by the JOB variable in the &INIT namelist. xxx is one of the 3 character SHORT_CUTs.

Additionally, separated by a second semicolon (";"), the width and height of the PS picture may be appended to the character string. If WIDTH and HEIGHT are explicitly specified then the output is probably distorted, i.e. the x- and z-direction do not have the same dimension. This may be undesirable in cases where the output contains the simulation geometry, which is the case for space-dependent outputs. In such cases it is recommended to specify only one parameter, WIDTH or HEIGHT, or none of both. Then the output will be adjusted to avoid distortion. The dimension for all these parameters is 1/72 inch. The default values are "720,540".

In some cases it is also necessary to specify a shell, a characteristic x-ray line or an Auger peak ( ION, IOD, XGD, XDD, AGD, ADD). This string (SHELL/LINE/PEAK_SPEC) is separated by a third semicolon (";") and contains the chemical abbreviation of an element separated by a comma from either the ionized shell, the characteristic x-ray line or an Auger peak. For more information on such specifications and their default values see Tables 9.4 to 9.6. All supported shells, characteristic x-ray lines, and Auger peaks are listed in Tables 9.7 to 9.8.

Whenever x-rays and/or electrons must be detected (distributions, scans) a detector number may be specified (DETECTOR#) after the fourth semicolon. Up to 5 different x-ray and electron detectors may be specified. If no detector number is explicitly declared then the default detector ( detector number 0) will be taken. For mor information on x-ray and electron detectors see Chapter 6.3 and 6.4, respectively.

SCREEN --- Visualization on Screen

All data specified by SCREEN is visualized on the screen. For each output to a window on the screen the following character string must be specified. For space-dependent output: ( PET, PEB, BET, TET, SET, ION, IOD, XGD, XDD, AGD, ADD)

SHORT_CUT,[SCREEN#],[MN1],[MX1],[MN2],[MX2];[XH],[XV],[WIDTH],[HEIGHT]; [SHELL/LINE/PEAK_SPEC][DETECTOR#]

For all other output (histograms):

SHORT_CUT,[N1],[MN1],[MX1],[N2],[MN2],[MX2],[N3],[MN3],[MX3];[XH],[XV], [WIDTH],[HEIGHT];[SHELL/LINE/PEAK_SPEC];[DETECTOR#]

Valid SHORT_CUTs (acronyms) are listed below under 'Range:'. All quantities in brackets "[ ]" are optional, i.e. they do not need to be explicitly specified because there exist default values for them. MN# and MX# are the minimum and maximum value of axis #, respectively, and N# is the number of intervals for axis #. For none space-dependent distributions higher than one-dimensional the sequence of specifying the ranges is important. This sequence is: energy, azimuthal angle, polar angle. This means, for example, that SCREEN(1)='BED,,,,,30,,,,45' specifies that backscattered electrons should be visualized in dependence of energy (default values), of their azimuthal angle between 30 degrees and the default value and of their polar angle between the default value and 45 degrees. The default ranges are: 0 to E0 keV for energy, 0 to 360 degrees for azimuthal angle and 0 to 180 degrees for polar angle. In cases where distributions in dependence of space coordinates are defined the ranges [MN1],[MX1],[MN2],[MX2] are real space coordinates. In this case, the default values are the dimensions of the actual simulation geometry. The default value for N# is 30 for all cases. It is also possible to specify a screen number (SCREEN#) for space dependent output since more than one information may be visualized in one window on the screen. This number ( SCREEN#) must point to an already specified SCREEN(SCREEN#).

Additionally, separated by a first semicolon (";"), the coordinates of a window's upper left corner and its width and heights may be appended to the character string. If WIDTH and HEIGHT are explicitly specified then the output is probably distorted, i.e. the x- and z-direction do not have the same dimension. This may be undesirable in cases where the output contains the simulation geometry, which is the case for space-dependent outputs. In such cases it is recommended to specify only one parameter, WIDTH or HEIGHT, or none of both. Then the screen will be adjusted to avoid distortion. The dimension for all these parameters is pixel. The default values are "1,1,720,540" for the first window. Every additional window is slightly shifted to avoid complete overlapping. XH and XV may have no effect on some machines. We experienced, for example, that it works fine on our X-terminals but not on our workstations.

SCREEN --- continued

In some cases it is also necessary to specify a shell, a characteristic x-ray line or an Auger peak ( ION, IOV, IOL, IOD, XCY, XGD, XDD, AEY, AGD, ADD). This string (SHELL/LINE/PEAK_SPEC) is separated by a second semicolon (";") and contains the chemical abbreviation of an element separated by a comma from either the ionized shell, the characteristic x-ray line or an Auger peak. For more information on such specifications and their default values see Tables 9.4 to 9.6. All supported shells, characteristic x-ray lines, and Auger peaks are listed in Tables 9.7 to 9.8. Whenever x-rays and/or electrons must be detected (distributions, scans) a detector number may be specified (DETECTOR#) after the third semicolon. Up to 5 different x-ray and electron detectors may be specified. If no detector number is explicitly declared then the default detector ( detector number 0) will be taken. For mor information on x-ray and electron detectors see Chapter 6.3 and 6.4, respectively.

  
Table 9.4: Specification of Shells

  
Table 9.5: Specification of characteristic x-ray lines

  
Table 9.6: Specification of Auger peaks

  
Table 9.7: Supported shells for ionization

  
Table 9.8: Supported characteristic x-ray lines

  
Table 9.9: Default output for LSCDEF=T

  
Table 9.10: Output short-cuts and their output options (Y=YES,N=NO) [1]

  
Table 9.11: Output short-cuts and their output options (Y=YES,N=NO) [2]



next up previous contents
Next: Postprocessing Up: Input Records Previous: &DETECT



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