Differences between revisions 12 and 14 (spanning 2 versions)
⇤ ← Revision 12 as of 2012-04-19 19:40:09 →
Size: 3464
Editor: JohnFlanagan
Comment:
← Revision 14 as of 2012-04-19 19:54:40 → ⇥
Size: 4475
Editor: JohnFlanagan
Comment:
Deletions are marked like this. Additions are marked like this.
Line 22: Line 22:
            This is an exmaple program """             This is an example program """
Line 42: Line 42:
 1. The option PPID must be added to enable cross platform PPID support
Line 45: Line 46:
 1. column="", this specifies what column the widget should appear in  1. col="", this specifies what column the widget should appear in
Line 47: Line 48:
 1. columnspan="", this specifies how many columns the widget should span
 1. browser="", if the widget represnts and option that refers to a file, this keyword argument lists a filebrowser to use.		  1. colspan="", this specifies how many columns the widget should span
 1. browser="", if the widget represents and option that refers to a file, this keyword argument lists a filebrowser to use.
Line 62: Line 63:
            This is an exmaple program """             This is an example program """
Line 65: Line 66:
    parser.add_argument("--option1",type=str,help="This is the first option",default="myvalue")
    parser.add_argument("--option2",type=int,help="This is the second option",default=1)
    parser.add_argument("--option3",type=float,help="This is the third option",default=3.14)
    parser.add_argument("--option4",action="store_true",help="This is the fourth option",default=False)
     #For the add_pos_Argument and add_header methods, you must add the name="" keyword argument. For the add_argument method, the 'name' is taken from the --option argument
    parser.add_pos_argument(name="argument1",help="First argument, this will be a file", default="", guitype='filetype', browser="EMBrowserWidget(withmodal=True,multiselect=True)", row=0, col=0,rowspan=1,colspan=2)
    parser.add_header(name="header1", help="Use the header to display useful info in the GUI", title="### Actual info goes here ###", row=1, col=0,rowspan=1,colspan=2)
    parser.add_argument("--option1",type=str,help="This is the first option",default="myvalue",guitype='strbox', row=2,col=0,rowspan=1,colspan=1)
    parser.add_argument("--option2",type=int,help="This is the second option",default=1,guitype='intbox',row=2,col=1,rowspan=1,colspan=1)
    parser.add_argument("--option3",type=float,help="This is the third option",default=3.14,guitype='floatbox',row=3,col=0,rowspan=1,colspan=1)
    parser.add_argument("--option4",action="store_true",help="This is the fourth option",default=False,guitype='boolbox',row=3,col=1,rowspan=1,colspan=1)
    # This is needed by all e2programs that run on the GUI
    parser.add_argument("--ppid",type=int,help="Set the PID of the parent process, used for cross platform PPID",default=-1)

Tutorial to aid adding a new e2program to the e2projectmanager.py

This tutorial covers the necessary steps to incorporate a e2program into the projectmanager.

Modifications to the e2program itself

Canonical e2programs must maintain the following standards

  1. Options are handled via EMArgumentParser, which is a subclass of Python's argparse module (version 2.7 and higher). For more information on argparse, see the python documentation. http://docs.python.org/dev/library/argparse.html

  2. Arguments are handled via EMArgumentParser.
  3. A line usage = """blah, blah, blah...""" must be present to give help info on the e2program
  4. A line progname = os.path.basename(sys.argv[0]) must be present

To illustrate what an e2program should look like, here is an example program: 

   1 #!/usr/bin/env python
   2 #
   3 # GPL licensing info goes here
   4 #
   5 
   6 from EMAN2 import *
   7 
   8 def main():
   9     progname = os.path.basename(sys.argv[0])
  10     usage = """prog arg1, arg2, [options] 
  11             This is an example program """
  12 
  13     parser = EMArgumentParser(usage=usage,version=EMANVERSION)
  14     parser.add_argument("--option1",type=str,help="This is the first option",default="myvalue")
  15     parser.add_argument("--option2",type=int,help="This is the second option",default=1)
  16     parser.add_argument("--option3",type=float,help="This is the third option",default=3.14)
  17     parser.add_argument("--option4",action="store_true",help="This is the fourth option",default=False)
  18 
  19     (options, args) = parser.parse_args()
  20 
  21     print "Arguments are", args
  22     print "Options are", options
  23 
  24 if __name__ == __main__:
  25     main()

To enable this program to be integrated into the GUI the following item must be implemented:

  1. For each argument the method: parser.add_pos_argument()
  2. To add dividing lines with help info into the GUI, add the method: parser.add_header()
  3. The option PPID must be added to enable cross platform PPID support
  4. To all parser 'add' methods the following keyword arguments must be added
  5. guitype="", this specifies what type of widget we want to use for this GUI
  6. row="", this specifies what row the widget should appear in
  7. col="", this specifies what column the widget should appear in
  8. rowspan="", this specifies how many rows the widget should span
  9. colspan="", this specifies how many columns the widget should span
  10. browser="", if the widget represents and option that refers to a file, this keyword argument lists a filebrowser to use.

To illustrate how to integrate the above example e2program int the GUI, the following example is given: 

   1 #!/usr/bin/env python
   2 #
   3 # GPL licensing info goes here
   4 #
   5 
   6 from EMAN2 import *
   7 
   8 def main():
   9     progname = os.path.basename(sys.argv[0])
  10     usage = """prog arg1, arg2, [options] 
  11             This is an example program """
  12 
  13     parser = EMArgumentParser(usage=usage,version=EMANVERSION)
  14     #For the add_pos_Argument and add_header methods, you must add the name="" keyword argument. For the add_argument method, the 'name' is taken from the --option argument
  15     parser.add_pos_argument(name="argument1",help="First argument, this will be a file", default="", guitype='filetype', browser="EMBrowserWidget(withmodal=True,multiselect=True)", row=0, col=0,rowspan=1,colspan=2)
  16     parser.add_header(name="header1", help="Use the header to display useful info in the GUI", title="### Actual info goes here ###", row=1, col=0,rowspan=1,colspan=2)
  17     parser.add_argument("--option1",type=str,help="This is the first option",default="myvalue",guitype='strbox', row=2,col=0,rowspan=1,colspan=1)
  18     parser.add_argument("--option2",type=int,help="This is the second option",default=1,guitype='intbox',row=2,col=1,rowspan=1,colspan=1)
  19     parser.add_argument("--option3",type=float,help="This is the third option",default=3.14,guitype='floatbox',row=3,col=0,rowspan=1,colspan=1)
  20     parser.add_argument("--option4",action="store_true",help="This is the fourth option",default=False,guitype='boolbox',row=3,col=1,rowspan=1,colspan=1)
  21     # This is needed by all e2programs that run on the GUI
  22     parser.add_argument("--ppid",type=int,help="Set the PID of the parent process, used for cross platform PPID",default=-1)
  23     (options, args) = parser.parse_args()
  24 
  25     print "Arguments are", args
  26     print "Options are", options
  27 
  28 if __name__ == __main__:
  29     main()

EMAN2PMWorkflow (last edited 2012-04-19 20:22:10 by JohnFlanagan)