News Rel.2501 deb

Installation of Gensys on a computer running on a Debian Linux based operating system. The installation file is written in deb-format.

Only the necessary steps in the below list needs to be done:
1) Can be skipped if all extra packages already are installed.
2) Can be skipped if you don't want to update the documentation and the verification examples.

1) Installation of extra packages

Gensys relies on a number of packages that normally are not installed be default. Please, install these packages before installing the Gensys deb-file.

Refresh the list of available packages by giving the following command in a terminal window:

GNU Octave language for co-simulations, numerical computations, plotting,,, etc.:

2) Download and uncompress the documentation and the verification examples

N.B. In this step you will create the following three directories: free_models, homepage and verif. If you have old versions of these directories, they will be overritten.
If you want to keep your old versions of free_models, homepage and verif, please rename or remove your old directories before continuing.

Create a directory where you want to keep Gensys documentation files and verification examples. E.g.; ~/gensys
(If Gensys has been installed via a Virtual Machine, directory ~/gensys is a Folder Shared with the host computer)
In the newly created work directory. Also create a directory where you want to keep your own work files.
E.g.: "~/gensys/analyse"

In directory "~/gensys" download the following files:

free_models-2501.7z   = Free vehicle models
homepage-2501.7z      = Documentation and tutorials
verif-2501.7z         = Verification directory

Webpage mega.nz requires a webbrowser that handles HTML5 and allows JavaScript to create and write to files. Currently Chrome and Firefox works best.
Also make sure that no firewall prevents you from downloading files from the Internet.

The SHA256 message digest algorithm should give you the following output:

b13e7d25f35198c9d906bdb92b3d80a934ba4f87000c99f52d5a7d80921ebdba  free_models-2501.7z
6fecd9f341377d6cf157d50d62239514b5d6aff2573021dd5c41195acd974f82  homepage-2501.7z
9b67cac9283fcd47dc2cd3404880483e81cc3dd4296153ae7422a270a6d10b2f  verif-2501.7z

The above output can be created with the following commands:

UNIX:	sha256sum [a-z]*7z
Windows:	certutil.exe -hashfile free_models-2301.7z SHA256 certutil.exe -hashfile homepage-2301.7z SHA256 certutil.exe -hashfile verif-2301.7z SHA256

Move the downloaded files to the location which you created under item 1 above.
Uncompress the files with program "7z" with the following commands:
```
7z x free_models-2301.7z
7z x homepage-2301.7z
7z x verif-2301.7z
```
Program "7z" can be found in package "p7zip-full".
File ~/.profile_gensys defines two environment variables: $genhomepage and $genverif.
Environment variable $genhomepage shall point to the location where the Gensys documentation "homepage" is located.
Environment variable $genverif shall point to the location where the verification examples "verif" are located.
The directory free_models can be stored anywhere. Use this directory to copy examples from.
The three files free_models-2301.7z, homepage-2301.7z and verif-2301.7z can now be removed.

3) Download and install gensys from a deb-file

Download the deb-file:
Depending your C library version, you must chose the deb-file that fits to your system. To see your C library version, please write:
ldd --version

Curently there is only one deb-file to choose, and this version is compiled for C library version 2.39 gensys-2501_250516_2.39_amd64.deb
(If you have problems with downloading the file. Please check the following:
- Make sure that no firewall prevents you from downloading files from the Internet.
- Try different web-browsers, including modern versions of Firefox and Chrome.)

If the file has been successfully downloaded:
The size of the deb-files should be:

 Bytes:         File:
 89934484       gensys-2501_250516_2.39_amd64.deb

The sha256sum message digest of the deb-files should be:

sha256sum gensys-2501_250516_2.39_amd64.deb
40b1022765bbeb716ce440f8f1f39775acaa9d24e1eb9988d7edc4316b8e69a2  gensys-2501_250516_2.39_amd64.deb

Unpack the deb-files with command:

sudo gdebi gensys-2501_250516_2.39_amd64.deb 2>&1 | tee -a /tmp/gdebi.out

Gensys is now installed in directory "/opt/gensys/gensys-2501"

4) Set search path and other initilization files

Download the setup files:
gensys_setup_files.sh
gensys_setup_files.tgz
Move the two files to your home directory.

Make sure file gensys_setup_files.sh has execute permissions:

chmod +x gensys_setup_files.sh

Then launch script ./gensys_setup_files.sh:

./gensys_setup_files.sh

Log out an in again, to make the changes to take effect.
You should now be able to launch genfile-gtk, genfile and genterm, by double clicking on the Gensys icons in the background menu.

5) Install the license file

Start a webbrowser (Preferable firefox, because not all webbrowsers permitts downloading files from the Internet)
Enter the link you have got from info@gensys.se
Download the file to your HOME-directory.

Open a terminal and give the following commands:

Go to your HOME directory:

cd $HOME

Remove the old license file:

sudo rm $gensys/bin/gen_processor_ID_check

Move the new license file to $gensys/bin:

sudo mv gen_processor_ID_check $gensys/bin

Add execute permissions to the license file:

sudo chmod +x $gensys/bin/gen_processor_ID_check

Test the new license file:

gen_processor_ID_check

6) Install the shared objects for CONTACT

In order to use CONTACT for calculating the wheel/rail-forces, do the following steps:

Download file clibrary_contact_v23.2.tgz to your home directory $HOME.
Uncompress the tar file tar -xvzkpf clibrary_contact_v23.2.tgz
Go to directory ~/clibrary_contact_v23.2/bin
Create a license file for CONTACT with the following command:
```
LD_LIBRARY_PATH="linux64:."  ./caddon_license_linux64
```
Give command: activate followed by your "License ID" and "Activation Password", which can be obtained by Edwin Vollebregt.
To include CONTACT when calculating the wheel/rail-forces, launch tsim with the following command:
```
LD_LIBRARY_PATH=~/clibrary_contact_v23.2/lib  tsim  runf/tang_ideal_contact.tsimf
```

7) After the installation

The installation is now finished. Please test your installation by running the tutorial examples: ../../tutorial/README.html

tcl	A high-level, general-purpose programming language.
tk	Toolkit for Tcl and X11

apt-file	An APT package searching utility
eom	Eye of mate. View image files: jpeg, bmp, png, etc.
evince	View pdf-files.
ffmpeg	Create videos
gimp	Gnu Image Manipulation Program
imagemagick	A free open-source sortware suite for the creation, modification and display of bitmap images.
meld	A graphical diff viewer and merge application
pcregrep	Perl-compatible regexp.
xdotool	Lets you programmatically (or manually) simulate keyboard input and mouse activity, move and resize windows, etc. E.g. "xdotool getmouselocation --shell" gives mouse position.
xclip	Command line interface to X selections (cc=pipe output from terminal to clipboard).

octave	The main package.
octave-signal	Signal processing functions for Octave.
octave-sockets	Communication through Internet sockets. To enable Co-simulations and Hardware-in-the-loop simulations.
octave-statistics	Additional statistical functions for Octave.
gnuplot	An interactive plotting program.
gnuplot-x11	A sub-package to gnuplot which generates X11-output.

openssh-server	SSH server, for secure access from remote machines.
openssh-client	SSH client, for secure access to remote machines.
lftp	Sophisticated command-line FTP/HTTP/BitTorrent client program.
filezilla	Full-featured graphical FTP/FTPS/SFTP client with GUI.
samba	Mounting and mapping shares between Windows and Linux.
megatools	Command-line client for the Mega cloud storage service.
git	A distributed revision control system.
gitk	A tcl/tk revision tree visualizer.

munge	MUNGE credential encoder.
slurm-wlm	Slurm Workload Manager.
sview	Graphical user interface to view and modify Slurm state.

gcc-14	C-compiler
g++-14	C++-compiler
gfortran-14	Fortran-compiler
gfortran-doc	Fortran documentation
cmake	A free and open-source software for build automation, testing, packaging and installation of software by using a compiler-independent method
libreadline-dev	Development libraries.
libncurses5-dev	– " –
libxpm-dev	– " –
libxmu-dev	– " –
libxext-dev	– " –
libgl1-mesa-dev	– " –
libglu1-mesa-dev	– " –
libpcre3-dev	– " –
libvte-2.91-dev	– " –
libgtk-3-dev	– " –
libgtk2.0-dev	– " –
libfm-dev	– " –
libfm-gtk-dev	– " –
libvte-dev	– " –
libstartup-notification0-dev	– " –
libgamin-dev	– " –
intltool	Automatically extracts translatable strings from oaf, glade, bonobo ui, nautilus theme and other XML files into the po files.
gamin	File and directory monitoring system
python3-pip	The Python package installer
texlive	The TeX Live software distribution offers the complete TeX system.