Developers guide¶

This guide is primarily intended to help noobs to both Appion and Programming in general get up and running in the development environment that we have created at AMI.
It is a good place to add notes, however basic, that may help someone else accomplish a task related to Appion software development.
Parts of this guide are specific to machines and the environment that we have at AMI. Our apologies.

1. System Overview
   1. Leginon
      1. Scope
      2. Windows Machine
   2. Appion
      1. Web Parts - web server
      2. Python Parts - processing server
      3. 3rd party apps
   3. Clusters
   4. Myami code module diagram
       
2. Development Tools
   1. Redmine quick start
      1. Issue reporting and life-cycle
         1. Issue Workflow Tutorial: A guide to setting the Issue status.
      2. Adding Documentation
   2. Eclipse
   3. Subversion (SVN)
      1. Checking your code into the main trunk
          
3. Languages and Technology
   1. html, css, PHP, Python, Javascript, mySQL
   2. best practices for these
   3. Object Oriented Programming
   4. Useful shell commands
   5. Getting started with MySQL
       
4. Installing Appion for development
   1. Running the code from your sandbox
       
5. Adding a new program to the pipeline
   1. General Instructions
      1. Processing parts (Python)
         1. database access
      2. Web Parts (PHP)
         1. launch page
         2. reporting page
            1. Using basicReport.inc for very simple PHP report pages
         3. database accesss
   2. Adding a refinement method (single and multi model)
      1. Python wrapper for 3rd party programs (Anchi)
      2. Modifications to runJob.py (Christopher)
      3. Uploading results to the databse (Dmitry)
      4. Adding the user interface (Amber)
          
6. Testing
   1. Test datasets at AMI
   2. Create Appion Session for testing purposes
   3. How to set up AMI databases on your local machine: Handy if you want to play with the databases without affecting anyone else.
   4. Automated testing
   5. How to test upload images with your own sandbox
   6. How to run manual picking and mask making
       
7. Error Handling
   1. Error handling guide
       
8. Adding pop-up Help
   1. adding popup help
       
9. Other stuff
   1. Where to find help
   2. Common variables used
   3. Appion Developer's Workshops
   4. 2010 Appion Developer Workshop