Home    Search    Reference Manuals    Return    Intro Menu

Initialization of the PC version

The search path

In order to make the programs in GENSYS accessible from a DOS-command prompt, the directory %gensys%\scripts must be included in the environment variable PATH defined in the file AUTOEXEC.BAT.


The scripts in the directory %gensys%\scripts calls the script ~edit.bat every time a file is opened for reading or writing. The user can choose which editor is to be used in ~edit by the environment variable %EDITOR%. Haven't %EDITOR% been set, the old DOS-editor EDIT will be used.

Environment variables

The scripts and programs in GENSYS use a number of so-called "environment variables" which the user will define in the file autoexec.bat with the help of the DOS-command SET. The following environment variables are used:

GENSYS  Indicates in which directory the gensys programs are located
        during the installation of the programs.
PATH    Defines search path to the gensys scripts.
TEMP    Defines directory space for temporary files.
DOS4G   To restrain the compiler's start-up banner.
EDITOR  Defines desired editor which the gensys scripts should use.
        If the EDITOR is not defined, the DOS-editor EDIT will be used.
GENDIR  Defines whether or not the result files should be stored on
        sub-directories according to the file wd_org.bat.

The following rows can be copied into autoexec.bat or any another bat-fil in order to prepare GENSYS for calculations:

SET GENSYS=c:\gensys
SET DOS4G=quiet
SET EDITOR=C:\dos\edit

GENSYS from the DOS-prompt

Should the user wish to operate GENSYS using the commands from a process with DOS-prompt, this can be done quite simply by moving to the directory where the indata-file has been written using the DOS-command "cd". In the directory the user enters the command for the program he/she wishes to use, and as argument the indata-file and calculation ident can be given. If no indata-file is given as argument, the program script will demand an indata-file. As default value, the indata-file which was used in the previous calculation with the same program, will be activated. If no calculation ident is given, the program script will demand an ident.

All programs which have graphic presentation have an indata variable called ISCREN. With this variable the user can choose which solution is the most appropriate for the computer and screen in question. If the variable ISCREN is allocated the value 0, no plotting will take place on the screen. To demand graphics on the screen in a PC environment, ISCREN must be given one of the following values:

  ISCREN          Resolution      No. of colours     Graphic
    11             320 x 200             4             CGA
    12             320 x 200            16             EGA
    13             640 x 480            16             VGA
    14             800 x 600            16            SVGA
    15            1024 x 768            16            SVGA

In order to change the picture in a graphic window, press the key ENTER.

GENSYS in WINDOWS-environment

The WINDOWS environment can be useful for long calculations in GENSYS as it does not block the computer. It enables the user to work with word processing at the same time as calculations can continue in the background. To enable calculations to be carried out in the background, start the PIF-editor and change in the file \windows\_default.pif so that the program can continue to work, whilst all new processes are operated in a WINDOWS window. When starting a calculation activity in GENSYS, start the WINDOWS file management system and open at least three windows simultaneously beside each other. Move the marker in the three windows so that the following information is shown:

Window 1:
Work directory containing the input data files.
Window 2:
Directory %gensys%\scripts containing all the scripts.
Window 3:
A HTML-browser reading the GENSYS-documentation.

The input data files have extensions. INP, which is an abbreviation of INPut data The user can associate these files with an editor, so they easily can be opened for editing by only double-clicking on them. In order to start the execution of a program, select input data file in window number 1, drag it over to window number 2 and drop it over the appropriate program. If several calculations are to be run in sequence, the user can write a bat-file containing all the commands which are necessary for the calculations. Starting a program in the GENSYS-package must preceede by the DOS "call"-command. As arguments to the GENSYS-programs are input data file and ident given. A bat-file in DOS or Windows must have the extension .BAT. Example:

call tsim  calc_a1.inp at1
call mplot mplot_t.inp at1
call tsim  calc_a2.inp at2
call mplot mplot_t.inp at2
call tsim  calc_a3.inp at3
call mplot mplot_t.inp at3   . . . etc.

The results of the calculations will be located initially in the same directory as the input data files. However, at the end of the program script the file will call the script wd_org.bat which will transfer the files to sub-directories. This permits a more comprehensive view of the result files in the Windows system. To enable the script wd-org.bat to move the files, the environment variable %gendir% must be set to "yes. If plotting is desired in the WINDOWS-window, place ISCREN to the value 13, as WINDOWS is not able to show a higher resolution.

Analysis of railway vehicles

The following sub-directories are available under the directory %gensys%\analys:


Model of a railway vehicle designed by ERRI, which is an abbreviation of European Rail Research institute. ERRI B 176/DT 290 contains the full description of the benchmark problem.


Contains the same vehicle geometry as under directory erri_176 with the following exceptions: The contact point geometry is non-linear and is taken from an UIC S1002 wheel profile and a SJ50 track profile with a inclination of 1/30. The calculation of creep forces in the contact point is carried out by interpolation in a four-dimensional lookup-table, which has been calculated according to Kalker's simplified theory of contact.


Directory containing insert-files to the CALC program. Insert-files are files which the user can call in his/her runf-file. The contents of the file is inserted in the same location as the insert-command appears in the input data file, in the same way as the include-command does in C-compilers. The input data file's readability will be increased by writing the input data built-up of insert-files. Documentation regarding the insert-files in the directory ins_filc is available at the beginning of each file. In addition there is a document %gensys%\docw_eng\analys\ins_filc which provides a summary of all available insert-files.


Contains different wheel-rail geometry functions.


Contains different track data files.

Before running a new project or vehicle it is preferable to create a directory in parallel to %gensys% named ANALYSE for example. Under the directory ANALYSE sub-directorys shall be created containing different projects and vehicles which the user have worked with. Because when a new release of the gensys-package are unpacked by the user the old gensys-directory will be overwritten.