==============
Welcome to ULM
==============

In this session we will work with the ULM (Ulm Lecture Machine).  Here a link
to the __Instruction Set of the ULM__.

We provide you this computer in form of a virtual machine. And actually we have
a whole set of ULMs:

- The comand line tool `ulm` on theon. In upcoming sessions this will be the
  virtual machine that we will use most often. For using it simply write the
  machine code as hex-code into a text file, say `my-code` and run this code
  with `ulm my-code`.
- The graphical user interface `ulm-qui` (short for "ULM cute
  interface" which is implemented using the toolkit __QT__ which is pronounced
  "cute"). It supports the full instruction set.
- The web interface __mini-ulm__ which currently only supports a subset of the
  instruction set, has only 8 registers and 256 bytes of memory. But it will do
  (and pretty much just do) for the hello world example.

Furthermore, we will do some simple examples on `theon` with the ULM assembler
`ulmas`.

#  Note:
#
#  - `ulm-qui` is only available on `heim` not on `theon`.
#  - Use the `-X` flag for `ssh` so that you have X11 forwarding.
#  - `ulm-qui` is installed in `/home/numerik/pub/bin`. By default this directory
#    is not in your `PATH` variable. So for example, add the following line to
#    your `.bashrc` in the home directory:
#
#    ---- CODE(type=txt) ----------------
#    PATH=$PATH:/home/numerik/pub/bin
#    ------------------------------------
#
#    You can do this with your favorite text editor or on the command line with
#
#    ---- CODE(type=txt) ------------------------------------
#    echo 'PATH=$PATH:/home/numerik/pub/bin' >> $HOME/.bashrc
#    --------------------------------------------------------
#
#    This will take affect after you login the next time or if you source your
#    bashrc file manually with
#    
#    ---- CODE(type=txt) ------------------------------------
#    source $HOME/.bashrc
#    --------------------------------------------------------



:links: mini-ulm -> http://www.mathematik.uni-ulm.de/numerik/hpc/ss20/hpc0/mini-ulm.html
	QT -> https://en.wikipedia.org/wiki/Qt_(software)
	Instruction Set of the ULM -> http://www.mathematik.uni-ulm.de/numerik/hpc/ss20/hpc0/ulm.pdf

:navigate:  up      -> doc:index
            next    -> doc:session05/page02