6.2.15. BASIC PARAMETER OPTION, [P]

next, previous Section / Table of Contents / Index [P] This option allows you to redefine a number of basic control parameters provided by the initialization file (default name is 'balsac2.ini') when BALSAC is started. All control parameter values are valid until changed further or until the BALSAC session is finished. The complete set of (modified) control parameters can be saved on a separate file and may be used as initialization file for subsequent BALSAC sessions. In addition, control parameter sets can be read in from external files within this option. The basic parameter menu P reads ========== BASIC PARAMETER OPTIONS =================================== [M]ouse(fms) [H]elp(fhl) [T]each(ftc) me[N]u(fme) [E]ltb(fel) [I]ndex(fin) [O]rder(frd) [W]indow : (Ox,Oy)= ( ox, oy) (Lwx,Lwy)= ( lwx, lwy) Qyx= qyx [A]dapter : Int= int, Colmx= colmx, Chx,Chy= chx chy [P]aint : basic colors= ncb, tones= nsh, palette= nptot wor[K]b ste[R]eo [L]oadini [S]avini [B]ackup(fbu) [X]plot [?,]esc ================================================================ 38 == The first two lines of the menu include options characterized by flags given in parentheses and reading "on" or "off" depending on whether the respective option is set or unset. The line starting with "[W]indow ..." gives the complete window definition. This includes the origin (upper left corner) of the graphics window (ox, oy) which is relevant only for the Unix/X.11 version of BALSAC. Further, (lwx, lwy) gives the x/y (graphics) window size in pixels and qyx shows the y/x pixel distortion for screens with pixel shapes other than square. "[A]dapter ..." gives the complete adapter information and is relevant mostly for the DOS version of BALSAC. Here int denotes the interrupt number used to choose the graphics mode of the PC graphics adapter, colmx is the maximum number of colors available from the adapter, and chx/chy define the pixel width/length used for characters in graphics mode. "[P]aint ..." gives the number of basic colors, ncb, used to paint atoms and nsh denotes the number of tones available for each basic color. Further, nptot gives the number of entries in the color palette determining the sequence of paint colors used to paint atoms. Note that certain control parameter values can lead to unwanted results if defined incorrectly. Therefore, the choice of control parameters should be considered with care. All parameters are identical for BALSAC/LATTICE and BALSAC/CLUSTER sessions. > [M] selected from submenu P switches the mouse selection flag fms in the above menu between "on" and "off" (default is "on" for DOS, "off" for Unix version). For fms = "on" (DOS/VGA version) selecting an option key, e.g. [x], becomes possible by pointing the mouse text cursor (black or white rectangle) at the character between the [ ] brackets and L-clicking the left mouse button. However, direct keyboard input is still possible. (Unix/X.11 version) a separate menu window named "Options Menu" is opened and remains open until numerical input is requested, mouse selection mode is turned off (see below), or BALSAC finishes. The menu window lists all entries of a given menu as " X: Option text " with X denoting the option key in keyboard mode and the option text being in most cases more explanatory than that of the keyboard menu, see Secs. 3.3.8, 10. Pointing and L-clicking with the mouse inside a rectangle will select the respective key code. With this option direct keyboard input becomes impossible and can be reactivated only by turning mouse mode "off", see above. For further information on the mouse menu selection mode see Sec. 3.3.8. Note that mouse selection mode can also be reset by selecting [@] in any BALSAC option menu (DOS) or by L-clicking the button to the right of the entry "Menu off" in any menu window, see Sec. 3.3.8. > [H] selected from submenu P switches the on-line help flag fhl between "on" and "off" (default is "on") and shows the updated submenu P. Selecting [H] with fhl = "on" switches the flag to "off" and on-line help becomes unavailable which is confirmed by On-line help off in the text window (Unix/X.11 version only) and the escape prompt of all option menus changes to "[,]Quit" and "[,]esc" respectively. Turning off on-line help may be needed if the on-line help file has become corrupt or if customized help file is to be loaded. Selecting [H] with fhl = "off" shows the prompt Help file name ("+"=def,"-"=esc): asking for a character string fname (up to 72 characters) which defines the file name, e.g. "myown.hlp", of an on-line help format file, see Sec. 6.4.11. Here the one-character filename "+" denotes the default on-line help file 'balsac2.hlp', see Sec. 6.4.11.1, while dummy input "-" returns to submenu P. After a valid file name is given the flag fhl is switched to "on" and on-line help becomes available as indicated by "... [?]Help [?,]Quit" in the main option menus and by "[?,]esc" in all other menus. For further details see Secs. 3.3.3, 3.3.8. > [T] selected from submenu P switches the teach mode flag ftc between "on" and "off" (default is "off") and shows the updated submenu P. Selecting [T] (twice) with ftc = "on" switches the flag to "off" and returns to default run mode which is confirmed by Teach mode off, help active in the text window (Unix/X.11 version only) and the escape prompt of all option menus changes to "... [?]Help [?,]Quit" and "[?,]esc" respectively. Alternatively, teach mode can be turned off in any menu by selecting [%] with the same result as using option [T] of the present submenu P. Selecting [T] with ftc = "off" shows the prompt Teach file name ("+"=def,"-"=esc): asking for a character string fname (up to 72 characters) which defines the file name, e.g. "myteach.hlp", of an on-line help format file, see Sec. 6.4.11 used in teach mode. Here the one-character filename "+" denotes the default on-line help file 'balsac2.hlp', see Sec. 6.4.11.1, while dummy input "-" returns to submenu P. After a valid file name is given the flag ftc is switched to "on" and BALSAC runs in teach mode as indicated by "... (teach) [%,]Quit" in the main option menus and by "[%,]esc" in all other menus. Selecting an option in teach mode does not immediately execute the option. Instead, a short explanatory text taken from the on-line help file is shown and a prompt asks to confirm or reject the selection. For further details see Secs. 3.3.9, 3.3.8. > [N] selected from submenu P switches the immediate menu flag fme between "on" and "off" (default is "on") and shows the updated submenu P. For fme = "on" the main option menu in graphics mode shows at the bottom of the screen/window immediately after a plot is finished. For fme = "off" any plot finishes without showing the option menu waiting for keyboard or mouse input. Selecting [C] or L-click will then display the menu. This allows you to take photographic pictures of a plot or save the image with frame capturing tools without being disturbed by the menu line. > [E] selected from submenu P switches the element table flag fel between "on" and "off" (default is "off") and shows the updated submenu P. For fel = "on" plots of lattice sections or clusters will be completed by a table at the right top of the screen/window which contains color assignments to elements or layer numbers depending on the paint mode, see Sec. 6.2.7.2. Note that this table will not be shown on PostScript output. > [I] selected from submenu P switches the menu index flag fin between "on" and "off" (default is "off") and shows the updated submenu P. For fin = "off" most menus will show with a double line =================================================== at the end for better readability. For fin = "on" menus finishing with a double line will include the internal menu index im inside the line reading ============================================= im == where im refers to an internal numbering scheme which is also used to address menu help text in the on-line help file, see Sec. 6.4.11. Further, for fin = "on" index im shows in all menu windows (Unix/X.11 version only) at the bottom entry reading " ?: LATTICE Menu No. im " or " ?: CLUSTER Menu No. im " The use of this option is meaningful only for testing purposes or if the on-line help file is to be modified. Note that all BALSAC menus which come with a double line at the end are shown in Secs. 6.0-3 with the menu index added. > [O] selected from submenu P switches the menu order flag frd between "on" and "off" (default is "on") and shows the updated submenu P. This option is meaningful ONLY for the Unix/X.11 version of BALSAC. For fin = "off" menu windows list options in an order determined by the internal programming sequence which may sometimes be confusing. For fin = "on" menu windows list options in alphabetic (ASCII) order of the key codes which helps to find options in long lists. The order means in particular that "[+] comes before [:] comes before [A] - [Z] comes before [a] - [z]". > [W] selected from submenu P allows you to redefine size and position of the graphics screen/window as well as compensate for pixel shapes other than square on your screen. This option is useful mainly for the Unix/X.11 version of BALSAC. The prompt Window definition OX,OY,LX,LY,QYX (ox,oy,lwx,lwy,qyx |"/"=esc) : asks for five numbers, ox, oy, lwx, lwy, qyx, defining graphics window parameters after which BALSAC returns to submenu P. Here (ox, oy) denotes the window origin (upper left corner) on the screen, lwx, lwy are window width and height, and qyx gives the y/x pixel distortion for screens with pixel shapes other than square. The present window parameter values are shown in the above prompt in parentheses and are conserved with dummy input "/". A distortion value qyx = q assumes that a line of 100 pixels in y direction (up-down) is of the same length as one of 100*q pixels in x direction (left-right). Modifying qyx in an interactive BALSAC run may be required to correct for y/x distortions in the graphics output if different monitors are used or if graphics output is to be saved for subsequent printing on a printer with an x/y pixel size ratio different from that of the screen. > [A] selected from submenu P allows you to reset the basic adapter definition of the graphics screen. This option is useful and available ONLY with the DOS version of BALSAC. The prompt Adapter definition INT,COLMX,CHX,CHY (int,colmx,chx,chy | "/"=esc) : asks for four numbers int, colmx, chx, chy, defining basic parameters of your PC graphics adapter after which BALSAC moves to option [W] above allowing you to redefine size and position of the graphics screen/window. Here int denotes the interrupt number used to choose the graphics mode of the PC graphics adapter, colmx is the maximum number of colors available with the adapter, and chx/chy defines the pixel size (width/height) of characters used in graphics mode. The present adapter parameter values are shown in the above prompt in parentheses and are conserved with dummy input "/". Adapter parameters depend on each other and should be chosen with care. The following table gives standard values for the most common graphics modes which work with VGA adapters -------------------------------------------------- mode lwx lwy int colmx chx chy -------------------------------------------------- CGA 640 200 14 16 8 8 EGA 640 350 16 16 8 14 VGA 640 480 18 16 8 16 -------------------------------------------------- Apart from these standard settings graphics modes with higher resolution and more colors are available with enhanced VGA adapters. For appropriate interrupt and parameter settings consult your adapter manual. Note that some enhanced graphics modes may require special mouse drivers for the graphical mouse analysis to work. NOTE that false interrupt values may lead to strange graphics results and may even destroy your adapter. > [P] selected from submenu P allows you to reset all relevant parameters defining color and fonts used in graphics screens/windows of BALSAC sessions. Details of the paint menu are described in Sec. 6.2.15.1. > [K] selected from submenu P moves to the color/shading workbench switching to graphics mode (DOS) or opening a graphics window (Unix). This allows you to change all basic and paint colors as well as ball shading angles in a very intuitive way using the mouse or a graphics pointer. Further details are given in Sec. 6.2.15.2. > [R] selected from submenu P allows you to redefine distortion, plot shift and color codes used for stereo graphics of BALSAC. The stereo menu PR reads ====================================================================== Stereo: [D]istortion/shift (pu, deye) [R]ed/blue/white (isr isb isw) [?,]esc ================================================================ 43 == where pu, deye give the present values of the eye distance and picture shift parameters explained below. Further, isr, isb, isw, are color codes referring to colors red, blue, and white used in red/blue stereo mode, see Sec. 6.2.7. Full color stereo mode allows you to get a more realistic 3-dimensional impression of the lattice section or cluster using optical stereo glasses, see Sec. 6.2.7. In this mode, a lattice section or cluster is shown by two pictures on the screen. The pictures are reduced to 50% in size (with respect to their mono equivalents), are horizontally displaced by a picture shift deye, and differ slightly in their projection geometry reflecting the viewer's eye distance and his distance from the object. Here the eye distance pu is measured in units of the diameter D of the lattice section or cluster where meaningful values of pu lie between 0.1 and 1.0 (pu = 0.3 is default). The picture shift deye which determines the shift between the centers of the two stereo pictures on the screen/window can assume positive and negative values where for deye > 0 the left (right) picture simulates the left (right) eye view required for viewing with optical stereo glasses. deye < 0 the left (right) picture simulates the right (left) eye view required for cross eyed stereo viewing without glasses. Meaningful values for |deye| lie between 100 and 600 (deye = -320 is default). Red/blue stereo mode allows you to get a 3-dimensional impression of the lattice section or cluster using red/blue stereo filter glasses, see Sec. 6.2.7. In this mode, the atoms of a lattice section or cluster are shown by two horizontally shifted circles of equal radius and of colors blue (left circle) and red (right circle). The distance between the circles (stereo distortion) is determined by the distance z of the center from the viewer and the eye distance of the viewer. Analogously, all lines of the plot are visualized as red and blue lines accounting for the stereo distortion. As in full color stereo mode the stereo impression is controlled, apart from the perspective projection, by the eye distance pu, see above. > > [D] selected from submenu PR allows you to redefine the eye distance and picture shift used for stereo views. The prompt Stereo distortion,shift PU,DEYE (pu, deye | "/"=esc) : asks for two numbers, pu, deye, defining new values of the eye distance and picture shift after which BALSAC returns to submenu PR. Dummy input "/" will keep the old values given with the prompt (in parenthesis). Note that parameter deye is ignored in red/blue stereo plots, see above. > > [R] selected from submenu PR allows you to redefine the color codes used for colors red, blue, and white in red/blue stereo mode. The prompt Stereo red/blue/white ISR,ISB,ISW ( isr, isb, isw | "/"=esc) : asks for three numbers, isr, isb, isw, defining new color codes for stereo red, blue, and white after which BALSAC returns to submenu PR. Dummy input "/" will keep the old values given with the prompt (in parenthesis). The stereo color codes refer to the full color table of nctot colors, see Sec. 5.4. However, only colors adjusted to the stereo filter glasses are meaningful. Otherwise, the plot looks very confusing and can even lead to headaches if viewed for an extended time. > > [,] selected from submenu PR returns immediately to submenu P. > [L] selected from submenu P allows you to load an external initialization file replacing all basic parameter values by those contained in the file. The prompt Init file name for input ("+"=def,"-"=esc): asks for a character string fname (up to 72 characters) which defines the file name, e.g. "myown.ini", of an external initialization file, see Sec. 6.4.10. Here the one-character filename "+" denotes the default initialization file on-line help file 'balsac2.ini', while dummy input "-" returns to submenu P without file input. After a valid file name is given BALSAC reads and replaces all basic parameter values and returns to submenu P. External initialization files may be created with option [S] below. Note that structure input files may contain the complete initialization data, cp. option [I] of the file output menu, Sec. 6.2.8, which overwrite all defaults when the files are loaded at the beginning of a BALSAC session. The present option allows you to restore the parameter values of the default initialization file. > [S] selected from submenu P allows you to save all basic parameter values of the present BALSAC session in an external initialization file for later use. The prompt Init file name for output ("-"=esc): asks for a character string fname (up to 72 characters) which defines the file name, e.g. "myown.ini", of an external initialization file, see Sec. 6.4.10. Note that choosing the name 'balsac2.ini' in the above prompt defines the default initialization file for output which should be avoided. For a valid file name BALSAC stores all control parameter values of the present session in the file and returns to submenu P. The one-character dummy filename "-" returns to submenu P without file output. Alternatively, initialization information can also be saved with LATUSE and PLOT3D format structure files, see Secs. 6.2.8, 6.3.6, and Secs. 6.4.2-3. External initialization files may be read in by BALSAC with option [L], see above, or given on the command line when BALSAC is started, see Sec. 6.1. > [B] selected from submenu P switches the safety backup flag fbu between "on" and "off" (default is "on") and shows the updated submenu P. For fbu = "on" any exit from a BALSAC session by finish or transfer or loading a new structure file is preceded by saving the present structure/graphics data including a complete copy of the initialization file in the (LATUSE format) safety backup file 'balsac.svl' or in the (PLOT3D format) file 'balsac.svc'. This allows you to resume a previous BALSAC session exactly at the point where it was finished, see Secs. 6.1, 6.2. File 'balsac.svl' or 'balsac.svc' will be updated with every session exit or transfer, or whenever an external structure input file is loaded in a BALSAC session. Thus, it represents always the latest state of a session. For fbu = "off" no safety backup will be performed. > [X] selected from submenu P plots the lattice section (switching to graphics mode (DOS) or opening a graphics window (Unix)) or lists its atom coordinates depending on the plot/list mode defined in the present graphics option, see Sec. 6.2.7. > [,] selected from submenu P returns immediately to the BALSAC/LATTICE main option menu. NOTE that all parameter values modified inside the parameter option are valid only for the present BALSAC session unless they are saved on separate initialization files for input to a subsequent BALSAC session. Restarting BALSAC always results in control parameter values taken from the initialization file defined on the command line or defaulted to 'balsac2.ini'. next, previous Section / Table of Contents / Index