TABLE OF CONTENTS
- TEMANEJO
TEMANEJO
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:
- display the task graph
- pause the execution on user request
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:
- optparse
- os
- sys
- subprocess
- struct
- types
- gtk
- gtk.gdk
- gtk.keysyms
- socket
- threading
- temanejo_graph
- temanejo_graphWidget
TODO
- connect and disconnect to AYUDAME
- connect to several hosts (nodes)
- set next task to run
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