TABLE OF CONTENTS


TEMANEJO

[ Top ] [ Modules ]

NAME

TEMANEJO - display and interaction with *Ss' task graph

DESCRIPTION

TEMANEJO connects as a client to a socket provided by AYUDAME. It performs the following tasks:

USAGE

TEMANEJO can either connect to a running SMPSs application ("remote"), which is waiting for a client or start the application itself and make all the necessary adjustments ("local").

Find help on the command line option by typing

     temanejo.py -h

-- Local connection --

To let TEMANEJO start the application run

     temanejo.py [-l <layout>] [-d <layout_direction>]\
                 [-v[v[v]]|-q] [-z|-Z] [smpss_app [smpss_app_args]]
                 [-t <title>] [-n NODE_COL] [-m MARGIN_COL] 
                 [-e EDGE_COL] [-s SHAPES] [-L LIB_FILE]

<layout> is one of dot, twopi. This option determines the graphical layout of the graph. We recommend to go with the default 'dot'.

<layout_direction> is one of t2b, l2r, b2t, r2l and determines whether to draw the graph from top to bottom, left to right and so forth.

The option -z (-Z) switches on autozoom off (on).

The options -q, -v, -vv, -vvv set the verbosity level from quiet to very, very verbose.

With -t you can set a name for the window (usually displayed in the title bar of the window decoration).

-n, -m, -e and -s control which information to display as node colour, margin colour, edge colour and shape. Please see temanejo.py --help for details.

-L will load a specific (AYUDAME) library for communication with the application.

The main window and the connect dialog will open where you can edit the adjustments for the application (resp. choose it if it was not passed as command line argument), the ayudame library (defaults to libayudame.so in the working directory), the configure file for SMPSs, the socket port and the number of cores to be used. Connect by clicking "Connect".

-- Remote connection --

To let TEMANEJO connect to a running application (either remote or at localhost) type:

     temanejo.py [-l <layout>] [-d <layout_direction>] [-z]

See above for a description of the options

The main window and the connect dialog will open where you can edit the adjustments for the host and the socket port. make sure, the application is running, LD_PRELOAD was set to libayudame.so and it is waiting for a client. Connect by clicking "Connect".

-- Running the application --

The execution will initially stop whan css_init() is reached, i.e. when the pragma

     #pragma css start

is reached. Choose one or more event on which you want to pause on using the checkbuttons at the lower left of the window. Then you run until a pause condition is reached by clicking on the "play" button in the toolbar.

PORTABILITY

The following modules are imported:

TODO

AUTHOR

Steffen Brinkmann, HLRS <brinkmann@hlrs.de>

COPYRIGHT

(C) 2010-2012, HLRS, University of Stuttgart temanejo.py is published under the terms of the BSD license. See the LICENSE file for details. temanejo.py uses code of xdot.py, ver. 0.4 (C) 2008 Jose Fonseca which is published under the terms of the GNU Lesser General Public License temanejo.py uses code of NetworkX, (C) 2004-2009 by Aric Hagberg, Dan Schult and Pieter Swart. Published under the BSD license.


AboutDialog

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

AboutDialog - dialog displaying information about TEMANEJO

DESCRIPTION

This Dialog displays license information about TEMANEJO

DERIVED FROM

   gtk.Dialog

METHODS

   __init__

Communicator

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

Communicator - thread class for receiving messages from AYUDAME

DESCRIPTION

This class opens a thread for receiving mesages from AYUDAME. It implements a socket cleint. Furthermore it precesses the received messages.

DERIVED FROM

   Thread

METHODS

   __init__
   print_and_log
   run
   send_request
   terminate

ConnectDialog

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

ConnectDialog - dialog for connecting to an AYUDAME server

DESCRIPTION

The class implements a dialog where the user can choose an executable, the location of the libayudame.so, a configuration file, port number and number of cores. On pressing the connect button the executable will be executed and pause when reaching css_init.

DERIVED FROM

   gtk.Dialog

METHODS

   __init__
   callback_choose_cfg
   callback_choose_exec
   callback_choose_lib
   get_cfg
   get_cpus
   get_exec
   get_exec_args
   get_host
   get_lib
   get_local_remote
   get_port

ExportDialog

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

ExportDialog - dialog for choosing the export file format

DESCRIPTION

With this Dialog one can choose the export file format name

DERIVED FROM

   gtk.Dialog

METHODS

   __init__
   callback_choose_file
   callback_radio_format
   get_filename
   get_format

HelpDialog

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

HelpDialog - dialog displaying a short help screen about TEMANEJO

DESCRIPTION

This Dialog displays some helping information about TEMANEJO. For an extensive documentation refer to the files in Tools/doc/

DERIVED FROM

   gtk.Dialog

METHODS

   __init__

SettingsDialog

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

SettingsDialog - dialog for adjusting the setting of TEMANEJO

DESCRIPTION

This Dialog contains switches for adjusting the behaviour of TEMANEJO

DERIVED FROM

   gtk.Dialog

METHODS

   __init__
   get_check_autozoom
   get_check_key
   get_edge_colours
   get_graph_direction
   get_spin_margin_width
   get_spin_edge_width
   get_spin_node_size
   get_spin_nsteps

Temanejo_main

[ Top ] [ TEMANEJO ] [ Functions ]

NAME

Temanejo_main - the main application class

DESCRIPTION

This class is the main application class. It implements the main function and a parser for command line options. The main function creates a TemanejoWindow and run gtk.main()

METHODS

   init_optparser
   main

TemanejoWindow

[ Top ] [ TEMANEJO ] [ Classes ]

NAME

TemanejoWindow - python class for the window of TEMANEJO

DESCRIPTION

This represents the main window and user interface of TEMANEJO.

DERIVED FROM

   gtk.Window

METHODS

   __init__
   cleanup
   get_active_text
   highlight_checkbox
   on_about
   on_clearmarked
   on_connect
   on_controlcheckbutton
   on_debug
   on_debugfunction
   on_export
   on_gototask
   on_margcollist
   on_nodecollist
   on_quit
   on_refresh
   on_run
   on_run_nsteps
   on_settings
   on_shapelist
   push_statusbar
   register_function
   start_gdb
   update_ui

ATTRIBUTES

   ui