Differences between revisions 9 and 10
Revision 9 as of 2012-10-09 15:40:02
Size: 2491
Editor: mark
Comment:
Revision 10 as of 2012-11-23 16:43:29
Size: 2911
Editor: mark
Comment:
Deletions are marked like this. Additions are marked like this.
Line 26: Line 26:
These are NOT error messages, as long as the window above appeared all is well. The output on the terminal falls into three categories, information, warnings and errors. Here the lines refering to the missing {{{MySQLdb}}} module are warning that a module required for some optional (and very obscure) feature was not found.
Line 28: Line 27:
In the first instance all output on the terminal may be safely ignored, most of the time you can get rid of it entirely by invoking ScrumPy as These are not error messages, but internal diagnostic information. In particular, the {{{MySQLdb}}} message refers to an unused feature in a third party package, ignore it, as long as the window above appeared all is well. If libsbml cannot be found the following diagnostic will be seen
{{{#!highlight bash
 !!
 !! couldn't import libsbml
 !! sbml not available
 !!
}}}
Under these circumstances, {{{ScrumPy}}} remains entirely functional, except yuo will not be able to read or write sbml files.

In use {{{ScrumPy}}} will generate quite a lot of output on the terminal, and it is generally safe to ignore it. This output can be surpressed by redirecting stdout and stderr, e.g.
Line 33: Line 41:
There occaissions when output on the terminal is useful in diagnosing specific problems in models, but these will be mentioned in the relevant parts of the documentation.
If you wish to keep the output, simply redirect to a file:
{{{#!highlight bash
mark@Mark:~/model/work/
Tomato$ ScrumPy 2&>MyLogFile.txt
}}}

T
here occaissions when output on the terminal is useful in diagnosing specific problems in models, and these will be mentioned in the relevant parts of the documentation.
Line 36: Line 50:
A model is brought into existence by loading it into the modelling environment:
Line 37: Line 52:
A model is brought into existence by loading it into the modelling environment:
{{{#! highlight python
>>> m = ScrumPy.Model("FileName") }}}
{{{#!highlight python
>>> m = ScrumPy.Model("FileName")
}}}
Line 43: Line 57:
If you have [[ScrumPy/Instalation#SBML | SBML]] installed the file will be converted {{{ScrumPy}}} format and it is then treated as a normal {{{ScrumPy}}} file. If you have [[ScrumPy/Instalation#SBML|libsbml]] installed the file is in sbml format, it will be converted {{{ScrumPy}}} format, saved with a".spy" extension and it is then loaded as a normal {{{ScrumPy}}} file.

The ScrumPy Modelling Environment

Running ScrumPy

Once installed, ScrumPy is simply run from your favourite shell:

   1 mark@Mark:~/model/work/Tomato$ ScrumPy

This will result in the appearance of this window.

ScreenShot1.png

The first text, in blue, is a greeting message from ScrumPy, followed by version information, the text in black serves a similar purpose giving information about the version of python you are using. Details will, of course vary between installations. The cursor (>>>) indicates that ScrumPy is waiting for you type something.The menu items will be described later.

You will also see a certain ammount of diagnostic text appear in your terminal, something like this:

   1 StartScrumPy !!!
   2 /usr/lib/python2.6/site-packages /usr/lib/python2.6/site-packages/ScrumPy/tkGUI/StartScrumPy.py
   3 importing parser
   4  MySQLdb module could not be loaded
   5 No module named MySQLdb
   6 importing parser

These are not error messages, but internal diagnostic information. In particular, the MySQLdb message refers to an unused feature in a third party package, ignore it, as long as the window above appeared all is well. If libsbml cannot be found the following diagnostic will be seen

   1  !! 
   2  !! couldn't import libsbml
   3  !! sbml not available
   4  !! 

Under these circumstances, ScrumPy remains entirely functional, except yuo will not be able to read or write sbml files.

In use ScrumPy will generate quite a lot of output on the terminal, and it is generally safe to ignore it. This output can be surpressed by redirecting stdout and stderr, e.g.

   1 mark@Mark:~/model/work/Tomato$ ScrumPy 2&>/dev/null

If you wish to keep the output, simply redirect to a file:

   1 mark@Mark:~/model/work/Tomato$ ScrumPy 2&>MyLogFile.txt

There occaissions when output on the terminal is useful in diagnosing specific problems in models, and these will be mentioned in the relevant parts of the documentation.

Loading a Model

A model is brought into existence by loading it into the modelling environment:

   1 >>> m = ScrumPy.Model("FileName")

Note that "FileName" must be quoted. If FileName exists, ScrumPy will read it and present you with its' contents in an editor window. If FileName does not exist, ScrumPy will create a new, empty file, and open an editor window for you. Finally, if you do not specify FileName at all you will be presented with a file selection dialogue.

If you have libsbml installed the file is in sbml format, it will be converted ScrumPy format, saved with a".spy" extension and it is then loaded as a normal ScrumPy file.

None: ScrumPy/Doc/ModEnv (last edited 2012-11-23 16:43:29 by mark)