Latest version of the gui scripts, this is a combination of tools by github OpenRadioss contributors: hotaosa and PaulAltair
NEW Gui Scripts available 23rd July 2023
In order to facilitate easier working with OpenRadioss, some simple python/tk based guis (.exe versions available for windows) have been created for running jobs, queuing jobs and converting anim files to vtk and converting T01 files to csv. The gui job submission tool sets all required environment variables, so it makes getting started with OpenRadioss much easier!
The linked tools include a combination of the features available in earlier scripts from hotaosa and PaulAltair
The zip files linked below contain scripts for windows and for linux
Windows gui scripts zip Download (8.4MB)
Linux gui Scripts zip download (9KB)
Installation and Launch
Windows Installation and Launch
The script folder (win_scripts_mk3) should be extracted to the installation folder of OpenRadioss (same level as exec, hm_cfg_files etc), the scripts work only from this directory level currently
The initial contents of the folder appear as below, for the windows version, python is not a pre-requisite, there is an .exe version of the gui that may be used directly without a python installation, the main gui tool is ‘openradioss_run_script_for_windows_mpi_ps.exe’ and can be launched from windows explorer on double click, the python code is still included for information and the .py script may still be used if python is installed (the 'openradioss_run_script_for_windows_mpi_ps.py’ files is the main python script)
Windows Desktop Shortcut (Optional)
It is possible to create shortcut Links for the exe or python tools with the form e.g.:
Target for exe:
full_path_to\win_scripts_mk3\openradioss_run_script_for_windows_mpi_ps.exe
Target for Python:
C:\Windows\pyw.exe “full_path_to\win_scripts_mk3\openradioss_run_script_for_windows_mpi_ps.py"
Start In Folder
full_path_to\win_scripts_mk3\
You may also ‘change icon’ to the one in the included icon folder
Linux Installation and Launch
The script folder (linux_scripts_mk3) should be extracted to the installation folder of OpenRadioss (same level as exec, hm_cfg_files etc), the scripts work only from this directory level currently
bash shell, and python with tk is a pre-requisite in linux
not all linux distros necessarily include python/tk by default, e.g. lubuntu has it, but for ubuntu-mate following is needed
sudo apt-get install python3-tk
In linux, the content of the linux_scripts_mk3 folder is as below, the ‘openradioss_run_script_for_linux_mpi_ps.py’ file is the main gui,
in order to launch it, enter the linux_scripts_mk3 folder in a terminal window open it with python3, e.g. :
python3 openradioss_run_script_for_linux_mpi_ps.py
Linux Desktop Shortcut (Optional)
It is possible to create a clickable desktop/menu icon for linux:
add/create a file: ./local/share/applications/openradioss.desktop (make executable)
content of form e.g.:
[Desktop Entry] Type=Application Name=OpenRadioss Exec=bash -c "cd /home/user/OpenRadioss/linux_scripts_mk3 && /usr/bin/python3 /home/user/OpenRadioss/linux_scripts_mk3/openradioss_run_script_for_linux_mpi_ps.py" Icon=/home/user/OpenRadioss/linux_scripts_mk3/icon/ross.png
This will add a shortcut to desktop, menus: then can be pinned to desktop also:
Script Usage (windows/linux)
The gui usage is the same in both linux and windows, the gui takes input file and a number of OMP/MPI processors (-nt, -np) as arguments, there are also options for running single precision version, and having Anim-vtk and/or TH-csv conversion performed at end of the run.
Submission gui
Job Input file can be Radioss format Starter (_0000.rad) Radioss format Engine (_0001.rad, _0002.rad etc.) or Dyna format .k or .key file
All files for a run present in a folder will be submitted, e.g. if Starter, and Engine(s) exist, they will automatically be run sequentially starting from the file chosen. If a Dyna format file is chosen, the ‘engine’ phase (automatically created) will be run automatically if interpretation of the keyword file was successful.
If an engine file is selected, a restart run can be performed from that engine file.
If -np is 1 then the SMP (OMP) version of OpenRadioss is run, if -np is > 1 then the SPMD (MPI) version of OpenRadioss is run
If ‘sp’ box is checked, the extended single precision version of OpenRadioss will be run (if self compiling, this version is not compiled by default, see compilation guides)
If ‘Anim - vtk’ box is checked, at the conclusion of the run, all animation files will be converted to vtk
If ‘TH - csv’ box is checked, at the conclusion of the run, all time history files will be converted to csv
The ‘info’ drop down has links to the downloads section of github and an ‘About’ credit to the script creators
Note: In Windows version only: On first attempt to submit an mpi run (-np > 1) you will be prompted to locate a suitable vars.bat file on your machine, once selected, this is remembered (to reset, delete the created ‘path_to_mpi_vars.txt’ file from the install directory, or edit its contents)
Run Window
The job runs in a window titled with the run name, with some option buttons at the bottom:
Stop, stops the job writing a restart file
Kill, kills the job (no restart written)
Anim, writes an Anim file at the current cycle
h3d, writes/updates the h3d file at the current cycle
Close, becomes available when job is completed, and closes the run window
Queue Window
it is possible to submit further jobs from the submission gui after the first and they will be queued for running when the currently running job completes, the queue can be checked and edited, by clicking the ‘Show Queue’ button in the submission gui.
The Job Queue shows jobs queued along with the options chosen, with the buttons in the window it is possible to cancel the next or last job from the queue, or to manually start the next or last job from the queue (this happens in addition to the queue being processed, jobs will open another run window and run at same time as any running job, queue will continue to automatically run any remaining jobs only when 1st one finishes)
