mcGDB custom version of HLRS Ayudame/Temanejo

Kevin Pouget ba7f61a987 start disabling seqdiag generation 4 years ago
Ayudame 5156116d71 start merge towards Temanejo2 preview 4 years ago
Temanejo2 ba7f61a987 start disabling seqdiag generation 4 years ago
modulefile ae39b34c9d initial import of Ayudame/Temanejo 5 years ago
.gitignore 254c5ce373 merge 5 years ago
.tarball-version 618850028c update to temanejo-2.0a-1f25379 4 years ago
AUTHORS ae39b34c9d initial import of Ayudame/Temanejo 5 years ago
INSTALL ae39b34c9d initial import of Ayudame/Temanejo 5 years ago
Makefile.am ae39b34c9d initial import of Ayudame/Temanejo 5 years ago
README 780c6668d9 Initial empty commit 5 years ago
configure.ac ae39b34c9d initial import of Ayudame/Temanejo 5 years ago
git-version-gen ae39b34c9d initial import of Ayudame/Temanejo 5 years ago

README

See the manual ./doc/Temanejo_manual.pdf for detailed documentation.

Temanejo -- a debugger for task-parallel programming
-----------------------------------------------------

Temanejo is a graphical debugger for task-based programming models as SMPSs and
OmpSs, but also OpenMP tasks and StarPU. Temanejo is developed at the
High Performance Computing Center (HLRS), University of Stuttgart, Germany.

The tool consists of two components: 1) the graphical fronted "Temanejo GUI"
(but mostly simply Temanejo), and 2) the supporting library "Ayudame" which is
sandwiched between Temanejo and the parallel tasking runtime system.

More information and the latest release of Temanejo can be found at
http://www.hlrs.de/temanejo/. The developers may be contacted at the email
temanejo@hlrs.de. Announcements and user discussion are done through the mailing
list temanejo-users@hlrs.de (see the webpage on subscription instructions).


Short Install Instructions
----------------------------

See the user manual at ./doc/Temanejo_manual.pdf for full installation
and usage instructions. See the file INSTALL in this directory for generic
autotools installation instructions.

Temanejo is a Python application and requires a Python v2.7 installation.
More recent versions from the v3 series have not been tested yet.

In addition Temanejo depends on the following Python modules:
- gtk
- cairo
- networkx (http://networkx.lanl.gov/)

Ayudame requires a C++ compiler. It is tested with GCC v4.7.2.

We assume that you will install Temanejo into the directory $TEMANEJO_HOME.
In the simplest case installation proceeds as:
1. ./configure --prefix=$TEMANEJO_HOME
2. make && make install

In case the configure complains about a missing python installation, make sure
it is available in the search path. On many HPC systems you might need to load
a python module
0a. module load python

In case the configure scripts returns other errors, try to regenerate the
configure script with:
0b. autoreconf -fiv

After installation you might want to add $TEMANEJO_HOME/bin the search path
$PATH, and $TEMANEJO_HOME/lib to the library search path $LD_LIBRARY_PATH.
On bash, e.g.:
3. export PATH=$TEMENEJO_HOME/bin:$PATH
export LD_LIBRARY_PATH=$TEMENEJO_HOME/lib:$LD_LIBRARY_QPATH

If necessary you might disable the installation of the Temanejo GUI or the
Ayudame library, respectivey, with the configure options:
--disable-temanejo
--disable-ayudame
In particular, building the Ayudame library on Mac OS is not suported yet
and you will have to disable it.

You can also ask the build system to install a modulefile from a user-provided
template with
--enable-modulefile[=template_file]

If no template file is provided, it will use modulefile/example_modulefile.in.

See the output of ./configure --help for further ways to control the building
and installation process.

See