Um Configuration and Structure 1-2 1.1. Configuration of Program Package UM 1-2
Um Configuration and Structure 1-2 1.1. Configuration of Program Package UM 1-2
Um Configuration and Structure 1-2 1.1. Configuration of Program Package UM 1-2
1.1.1. UM location
The UM kernel is located in several directories, which are situated in the UM main
directory with an arbitrary name (hereinafter - .\). These directories cannot be renamed; it is not
allowed to remove files from them.
• .\bin – includes executable files of UM;
• .\help –includes help files (*.hlp);
• .\com – includes files necessary for compilation of equations and programming in
the UM environment.
Every object (model) created by UM is situated in a separate directory. The name of the
directory is used as the object name. There exist syntactical restrictions on the name: it can
contain Latin letters, digits, the character ‘_’, the first symbol must be a letter. If the user
renames an object directory manually, he must generate and compile equations anew.
File input.dat contains the description of object parameters. If the user does not use the
Control File as well as own files for programming in the UM environment, the input.dat file is
the only file which is necessary to keep the model. If user uses programming in the UM
environment then it is necessary to keep the input.dat, control file and user’s files used in control
file (see Chapter 6).
Thus, the above files are only essential to transfer the model to another computer, to send
the model by e-mail and so on. All other files, which are necessary for simulation of the model,
can be generated by UM.
1.2. UM structure
UM consists of two main executable modules located in the .\bin directory.
• Data input module (uminput.exe)
The program is used for description and modification of objects, for generation of
equation of motion. This module has a multi-project environment: the user can open and modify
several objects simultaneously.
• Simulation module (umsimul.exe)
The module implements: the numeric integration of equations of motion with the parallel
animation of the object motion and plotting graphs; linear analysis of the object equations;
multivariant projects and parametric optimization and so on. The module imports equations of
motion created by the input module in the umtask.dll file.
The simulation module can be used separately from the input module for simulation of
previously prepared models. The simulation module has a single project environment.
1.2.1. UM configurations
1.2.2. UM Demo
UM Demo is free for non-commercial use. The demo version has the following
restrictions:
• 2 subsystems at most;
• 5 elements of any other types (bodies, joints, forces of each type) at most.
The user may generate the object data file input.dat with the help of some external
program (for example, MAPLE, MATLAB, MATEMATICA). In this case the equations of
motion can be generated and/or compiled by UMInput.exe program in an automatic mode.
Parameters and options of the command line:
“[path to uminput.exe]\uminput.exe” [path to object] [options]
Options Comments
/g Generate equations of motion. If the object contains
external subsystems, the completeness of description and
generation of equations for each the subsystem is verified.
If equations are not prepared, generation is fulfilled
automatically.
/b Forced generation of equation
/c Compile equations of motion
/n Rewrite old control file. The option is valid if one of the
options /c/b/g is presented
/i Display generation messages in a separate window. If the
option is not presented the UMINPUT is executed in a full
console mode without visualization of messages. The
option is valid if one of the options /c/b/g is presented
/f[path to file] All messages are directed into the file. The option is valid
if one of the options /c/b/g is presented
The command line allows running the umsimul.exe module in an automatic mode of
solving object equations. The command line indicates files, which contain initial conditions,
identifier values, configurations and so on. Unlike the usual mode, simulation process starts right
after the program start. Simulation results can be stored in user’s defined files. The simulation
module closes right after the simulation finish or interruption.
The automatic mode allows the user to organize the simulation and results processing
with the help of an external program.
Syntax of the command line:
1-5 Chapter 1. Configuration and structure
“[path to UmSimul.Exe]\UmSimul.exe” [path to object] [options]
Options Comments
/s Sets the automatic mode
/c[Name].icf Name of configuration file (program desktop, parameters
of solver)
/p[Name].par File with values of identifiers
/r[Name].rwc Rail vehicle configuration file (wheel/rail profiles, track
profiles etc.)
/i[Name].xv File with initial conditions (values of coordinates and their
time derivatives at t=0)
/v[Name].var Name of file with automatically calculated variables
/x[Name].xva Switches on the XVA mode. Data will be saved in the
specified file.
/f[Path\name of file] Text file for UMSimul output messages.
Remark. Files *.icf, *.xv, *.rwc, *.par, *.var should be created beforehand and saved in
the directory of the object. If one of the files is not presented in the command line, the
corresponding last.* file is used (if it exists).
Examples
“D:\um\bin\umsimul.exe” “d:\My Objects\UMObject”
Run the Simulation module in a usual mode and load the model UMObject, located in the
“d:\My Objects” directory.