News Rel.2309

Gensys-2309

Pre-installation of extra packages

The Linux operating system contains of many software packages. They can be installed from a deb-file on your hard drive, or they can be installed from the Internet.

To install from a deb-file write the following command:
sudo gdebi <package_name.deb>

To install a package from the internet, you can use program synaptic, or in a terminal you can write the following command:
sudo apt-get -y install <package_name>

In a standard Linux-installation only the most common packages will follow, and there are some packages that Gensys is using but can be missing in a standard Linux-installation. These extra packages are:

Packages that must be installed, to make Gensys to work properly:

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

Packages that are convenient, but not necessary:

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).

Packages that require configurations:

unison	A file-synchronization tool
unison-gtk	A GUI-tool for unison.

After installation of unison write the following in a terminal:

mkdir ~/.unison
echo "
# Unison preferences file

perms=0
merge= Name * -> meld CURRENT1 CURRENT2
#iff = /usr/bin/meld CURRENT1 CURRENT2
diff = opdiff CURRENT1 CURRENT2
confirmmerge= true

ignore= Name *~

ignore= Path .unison" > ~/.unison/default.prf

GNU Octave language for numerical computations (mostly MATLAB compatible):

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.

Communication:

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.

Queue systems:

Execute commands when system load levels permit
sudo apt-get -y install at
SLURM workload manager:
sudo apt-get -y install munge
sudo apt-get -y install slurm-wlm
sudo apt-get -y install sview

Programming tools: (only necessary if you want to write own source code)

gcc-12	C-compiler
g++-12	C++-compiler
gfortran-12	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	Different 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.

To install everything write:

sudo apt-get install \
  tcl                          \
  tk                           \
  apt-file                     \
  eom                          \
  evince                       \
  ffmpeg                       \
  gimp                         \
  imagemagick                  \
  meld                         \
  pcregrep                     \
  xdotool                      \
  xclip                        \
  unison                       \
  unison-gtk                   \
  octave                       \
  octave-signal                \
  octave-sockets               \
  octave-statistics            \
  gnuplot                      \
  gnuplot-x11                  \
  openssh-server               \
  openssh-client               \
  lftp                         \
  filezilla                    \
  samba                        \
  megatools                    \
  git                          \
  gitk                         \
  at                           \
  munge                        \
  slurm-wlm                    \
  sview                        \
  gcc-12                       \
  g++-12                       \
  gfortran-12                  \
  gfortran-doc                 \
  cmake                        \
  libreadline-dev              \
  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                     \
  gamin                        \
  python3-pip                  \
  texlive

Download and install gensys-2309_230930_amd64.deb

Download the deb-file:
gensys-2309_230930_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 file gensys-2309_230930_amd64.deb should be 72953060.
The sha256sum message digest can be evaluated with the command:
sha256sum gensys-2309_230930_amd64.deb
The output from the command should be:
8fa1f64476ee32b6c66ddc6391f24ef581902b564f542997e8860dc4dd86ef1d gensys-2309_230930_amd64.deb
Unpack the deb-file with command:
sudo gdebi gensys-2309_230930_amd64.deb 2>&1 | tee -a /tmp/gdebi.out
Gensys is now installed in directory "/opt/gensys/gensys-2309"

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, you can skip this part. Alternatively you can uncompress these files in another directory, and compare them with your old existing directories using script opdiff_dir.

Create a directory where you want to keep Gensys documentation files and verification examples. E.g.; "~/gensys"
In the newly created work directory. Also create a directory where you want to keep your own work files.
E.g.: "~/gensys/analyze"

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

free_models-2301.7z    = Free vehicle models
homepage-2301.7z       = Documentation and tutorials
verif-2301.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:

ec00a0676f1475ad6d416b67e13e771a51494886678ccfe3706df6b4ca58915a  free_models-2301.7z
e464fe7ffa0ff80de930ea86ddcad3904ac68404be1ad8491594a90d92a2c6ec  homepage-2301.7z
fd87572e0d809aaa1b3806f624320dfafe36422fabefb95554f23c35a90a25ab  verif-2301.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" which 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 files free_models-2301.7z, homepage-2301.7z and verif-2301.7z can now be removed.

Set search path and other initilization files

Download the setup file:
gensys_setup_files.tgz
Move the file to your home directory.
List the contents the tar archive with command:

tar -tzkpf gensys_setup_files.tgz | sed -e "s@^./@@" -e "/\/$/ d" -e "/^$/ d" > /tmp/gensys_setup_files.txt

Check if any file from the tar-archive already exists with command:

for file in `cat /tmp/gensys_setup_files.txt`; do
 /bin/ls $file > /dev/null 2>&1
 exit_status=$?
 if [ $exit_status = 0 ]; then
  echo -e "Existing file= $file"
 fi
done

Please rename all files that already exists on your hard drive. Above command should generate no output.

Unpack the tar archive with command.

tar -xzvkpf gensys_setup_files.tgz

Make a symbolic link to file ~/.Xdefaults

ln -s .Xdefaults .Xdefaults-`hostname`

In the end of file ~/.bashrc, add the following line:

test -f ~/.profile_gensys && . ~/.profile_gensys

In the end of file ~/.bashrc, add the following line:

test -f ~/.profile_gensys && . ~/.profile_gensys

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