5.6. FILE SYSTEM USED BY BALSAC

next, previous Section / Table of Contents / Index BALSAC uses several external and internal files for its operation which will be described in the following. STRUCTURE INPUT to both BALSAC sessions uses fixed format files where input to a LATTICE session must be LATUSE format, see Sec. 6.4.2, while a CLUSTER session requires PLOT3D format file input, see Sec. 6.4.3. File names can be anything accepted by DOS or Unix (up to 72 characters). However, it is good practice to use names which suggest both the structure and file format. The present BALSAC system uses file names '*.lat' for LATUSE format files and '*.plt' for PLOT3D format files. STRUCTURE/GRAPHICS OUTPUT to external files can be of different format depending on the file output option, see Secs. 6.2.8, 6.3.6. BALSAC accepts any valid DOS or Unix file name with up to 72 characters. The following table lists suggested file names to be used with the present BALSAC system ---------------------------------------------------------- format suggested file name ---------------------------------------------------------- LATUSE *.lat PLOT3D *.plt SARCH *.sar SCHAKAL *.sch gray scale PostScript *.ps or *.eps color PostScript *.cps or *.eps raw binary format (pixel images) *.bin ---------------------------------------------------------- SAFETY BACKUP of the present BALSAC session occurs whenever the session is finished: by quitting BALSAC, by loading a new structure (from the stack or externally) or starting from scratch within a session, by transfer between sessions. The safety backup files are called 'balsac.svl' (LATUSE format, closing a LATTICE session) or 'balsac.svc' (PLOT3D format, closing a CLUSTER session). They contain structure/graphics as well as all initialization data such that the session can be resumed without loss. QUICKSAVE of the present BALSAC session is available as a simplified file output option. Here default file names 'balsac.lat' (LATUSE format, from a LATTICE session) or 'balsac.plt' (PLOT3D format, from a CLUSTER session) are used. These files can be loaded at startup of BALSAC by a simplified call "balsac -lr" (LATTICE session) or "balsac -cr" (CLUSTER session). Further, the default file names are used inside the file input option of BALSAC if the dummy name "+" is given. The FILE STACK uses external files 'stckFFF#.lat' (LATUSE format, LATTICE session) and 'stckFFF#.plt' (PLOT3D format, CLUSTER session) with # =0...9 to hold up to 10 different structures for each session type. These files are created and loaded with the stack option, see Secs. 6.2.16, 6.3.14. They can also be loaded at startup of BALSAC by a simplified call "balsac -l#" (LATTICE session) or "balsac -c#" (CLUSTER session) with # = 0...9. TRANSFER of a crystal block created in a LATTICE session to a CLUSTER session (converting the block to a cluster without periodicity) uses an external transfer file 'balsac.trc' of PLOT3D format which can also be loaded in a subsequent CLUSTER session, e. g. with "balsac -c balsac.trc". Transfer of a cluster created in a CLUSTER session to a LATTICE session (using the cluster as an elementary cell of a fictitious simple cubic lattice) uses an external transfer file 'balsac.trl' of LATUSE format which can be also loaded in a subsequent LATTICE session, e. g. with "balsac -l balsac.trl". The INITIALIZATION file contains all relevant basic control parameters determining graphics settings (windows, adapters, colors, shading). The default name used by BALSAC is 'balsac2.ini' but any valid DOS or Unix file name with up to 72 characters is acceptable. The present BALSAC system suggests '*.ini' for initialization files. The ON-LINE HELP file holds all text used with the on-line help feature of BALSAC. The default name used by BALSAC is 'balsac2.hlp' but any valid DOS or Unix file name with up to 72 characters is acceptable. The present BALSAC system suggests '*.hlp' for on-line help files. The default file name 'balsac2.hlp' is also used when the on-line help option is (re)activated and the dummy name "+" is given as the help file name. TEACH MODE of BALSAC uses a help file which has to be loaded when this mode is (re)activated. The default file name is 'balsac2.hlp' (if the dummy name "+" is given in the file name prompt) but any valid DOS or Unix file name with up to 72 characters is acceptable. The present BALSAC system suggests '*.hlp' for help files used with teach mode. The following table lists default names of all files used by BALSAC. ---------------------------------------------------------------------------- file names format use ---------------------------------------------------------------------------- balsac.lat LATUSE output from a LATTICE session using quicksave, input to a LATTICE session, e.g. with "balsac -lr". balsac.svl LATUSE output from a LATTICE session using safety backup input to a LATTICE session, e.g. with "balsac -lp". balsac.trl LATUSE output of a CLUSTER session transferring structure data to a LATTICE session, input to a separate LATTICE session, e.g. with "balsac -l balsac.trl". stckFFF#.lat LATUSE # = 0...9, internal stack file system to hold up to 10 structure files used for in/output in LATTICE sessions. balsac.plt PLOT3D output from a CLUSTER session using quicksave, input to a CLUSTER session, e.g. with "balsac -cr". balsac.svc PLOT3D output of a CLUSTER session using safety backup, input to a CLUSTER session, e.g. with "balsac -cp". balsac.trc PLOT3D output from a LATTICE session transferring structure data to a CLUSTER session, input to a separate CLUSTER session, e.g. with "balsac -c balsac.trc". stckFFF#.plt PLOT3D # = 0...9, internal stack file system to hold up to 10 structure files used for in/output in CLUSTER sessions. balsac2.ini ASCII default initialization file containing basic control parameters. balsac2.hlp ASCII default on-line help file containing all help text. This file is also used in teach mode by default. ---------------------------------------------------------------------------- Missing or incorrect input files used with BALSAC lead to either - an error message ERROR: opening file for structure input File = filename followed by another input file name prompt in interactive mode, or a program exit if a false input file name was used in batch mode, or - a program crash with unpredictable results if incorrect input format was used. Here a restart of BALSAC is strongly advised. next, previous Section / Table of Contents / Index