|  | @@ -1,66 +1,64 @@
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -################################################################################
 | 
	
		
			
				|  |  |  INTRODUCTION
 | 
	
		
			
				|  |  |  ------------
 | 
	
		
			
				|  |  | -This module provides a basic interface to allow your users to utilize your 
 | 
	
		
			
				|  |  | +This module provides a basic interface to allow your users to utilize your
 | 
	
		
			
				|  |  |  server's NCBI BLAST+.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -Specifically it provides two forms, one for nucleotide queries and another for 
 | 
	
		
			
				|  |  | -protein queries. Currently only blastn and blastp are supported but in the future 
 | 
	
		
			
				|  |  | -you will be able to select either a nucleotide or a protein database to BLAST 
 | 
	
		
			
				|  |  | -against regardless of the type of query and this module will decide which BLAST 
 | 
	
		
			
				|  |  | -program to use based on the combination of query/database type (ie: if you 
 | 
	
		
			
				|  |  | -selected a protein database on the nucleotide BLAST form then blastx would 
 | 
	
		
			
				|  |  | +Specifically it provides two forms, one for nucleotide queries and another for
 | 
	
		
			
				|  |  | +protein queries. Currently only blastn and blastp are supported but in the future
 | 
	
		
			
				|  |  | +you will be able to select either a nucleotide or a protein database to BLAST
 | 
	
		
			
				|  |  | +against regardless of the type of query and this module will decide which BLAST
 | 
	
		
			
				|  |  | +program to use based on the combination of query/database type (ie: if you
 | 
	
		
			
				|  |  | +selected a protein database on the nucleotide BLAST form then blastx would
 | 
	
		
			
				|  |  |  be used).
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -BLAST submissions result in the creation of Tripal jobs which then need to run 
 | 
	
		
			
				|  |  | -from the command-line. This ensures that long running BLASTS will not cause 
 | 
	
		
			
				|  |  | -page time-outs but does add some management overhead and might result in longer 
 | 
	
		
			
				|  |  | -waits for users depending on how often you have cron set to run Tripal jobs. 
 | 
	
		
			
				|  |  | -A Tripal Jobs Daemon is under development to allow these jobs to be run almost 
 | 
	
		
			
				|  |  | +BLAST submissions result in the creation of Tripal jobs which then need to run
 | 
	
		
			
				|  |  | +from the command-line. This ensures that long running BLASTS will not cause
 | 
	
		
			
				|  |  | +page time-outs but does add some management overhead and might result in longer
 | 
	
		
			
				|  |  | +waits for users depending on how often you have cron set to run Tripal jobs.
 | 
	
		
			
				|  |  | +A Tripal Jobs Daemon is under development to allow these jobs to be run almost
 | 
	
		
			
				|  |  |  as soon as they are submitted.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -The BLAST results page is an expandable summary table with each hit being 
 | 
	
		
			
				|  |  | -listed as a row in the table with query/hit/e-value information. The row can 
 | 
	
		
			
				|  |  | -then be expanded to include additional information including the alignment. 
 | 
	
		
			
				|  |  | -Download formats are under development to allow users to download these 
 | 
	
		
			
				|  |  | +The BLAST results page is an expandable summary table with each hit being
 | 
	
		
			
				|  |  | +listed as a row in the table with query/hit/e-value information. The row can
 | 
	
		
			
				|  |  | +then be expanded to include additional information including the alignment.
 | 
	
		
			
				|  |  | +Download formats are under development to allow users to download these
 | 
	
		
			
				|  |  |  results in the familiar tabular or HTML NCBI formats.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Highlighted Functionality
 | 
	
		
			
				|  |  |  -------------------------
 | 
	
		
			
				|  |  | - - Supports blastn and blastp with separate forms depending upon the query 
 | 
	
		
			
				|  |  | + - Supports blastn and blastp with separate forms depending upon the query
 | 
	
		
			
				|  |  |     type.
 | 
	
		
			
				|  |  | - - Simple interface allowing users to paste or upload a query sequence and 
 | 
	
		
			
				|  |  | -   then select from available databases. Additionally, a FASTA file can be 
 | 
	
		
			
				|  |  | + - Simple interface allowing users to paste or upload a query sequence and
 | 
	
		
			
				|  |  | +   then select from available databases. Additionally, a FASTA file can be
 | 
	
		
			
				|  |  |     uploaded for use as a database to BLAST against.
 | 
	
		
			
				|  |  |   - Tabular Results listing with alignment information available.
 | 
	
		
			
				|  |  | - - Completely integrated with Tripal Jobs providing administrators with a 
 | 
	
		
			
				|  |  | -   way to track BLAST jobs and ensuring long running BLASTs will not cause 
 | 
	
		
			
				|  |  | + - Completely integrated with Tripal Jobs providing administrators with a
 | 
	
		
			
				|  |  | +   way to track BLAST jobs and ensuring long running BLASTs will not cause
 | 
	
		
			
				|  |  |     page time-outs
 | 
	
		
			
				|  |  | - - BLAST databases are made available to the module by creating Drupal Pages 
 | 
	
		
			
				|  |  | -   describing them. This allows administrators to use the Drupal Field API to 
 | 
	
		
			
				|  |  | + - BLAST databases are made available to the module by creating Drupal Pages
 | 
	
		
			
				|  |  | +   describing them. This allows administrators to use the Drupal Field API to
 | 
	
		
			
				|  |  |     add any information they want to these pages.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Installation
 | 
	
		
			
				|  |  |  ------------
 | 
	
		
			
				|  |  | -1. Install NCBI BLAST+ on your server (Tested with 2.2.26+). There is a 
 | 
	
		
			
				|  |  | +1. Install NCBI BLAST+ on your server (Tested with 2.2.26+). There is a
 | 
	
		
			
				|  |  |     package available for Ubuntu to ease installation.
 | 
	
		
			
				|  |  | -2. Install this module as you would any Drupal module (ie: download, unpack 
 | 
	
		
			
				|  |  | +2. Install this module as you would any Drupal module (ie: download, unpack
 | 
	
		
			
				|  |  |     in sites/all/modules and enable through http://[your site]/admin/modules)
 | 
	
		
			
				|  |  | -3. Create "Blast Database" nodes for each dataset you want to make available 
 | 
	
		
			
				|  |  | -   for your users to BLAST against. BLAST databases should first be created 
 | 
	
		
			
				|  |  | +3. Create "Blast Database" nodes for each dataset you want to make available
 | 
	
		
			
				|  |  | +   for your users to BLAST against. BLAST databases should first be created
 | 
	
		
			
				|  |  |     using the command-line makeblastdb program with the -parse_seqids flag.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Customization
 | 
	
		
			
				|  |  |  -------------
 | 
	
		
			
				|  |  | -The BLAST module forms can be styled using CSS stylesheets in your own theme. 
 | 
	
		
			
				|  |  | -By default it will use the default form themeing provided by your particular 
 | 
	
		
			
				|  |  | -Drupal site allowing it to feel consistent with the look-and-feel of your 
 | 
	
		
			
				|  |  | +The BLAST module forms can be styled using CSS stylesheets in your own theme.
 | 
	
		
			
				|  |  | +By default it will use the default form themeing provided by your particular
 | 
	
		
			
				|  |  | +Drupal site allowing it to feel consistent with the look-and-feel of your
 | 
	
		
			
				|  |  |  Tripal site without customization being needed.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -Additionally, the results page, waiting pages and the alignment section of 
 | 
	
		
			
				|  |  | -the results page have their own template files (blast_report.tpl.php, 
 | 
	
		
			
				|  |  | -blast_report_pending.tpl.php, and blast_report_alignment_row.tpl.php, 
 | 
	
		
			
				|  |  | -respectively) which can easily be overridden in your own theme providing 
 | 
	
		
			
				|  |  | +Additionally, the results page, waiting pages and the alignment section of
 | 
	
		
			
				|  |  | +the results page have their own template files (blast_report.tpl.php,
 | 
	
		
			
				|  |  | +blast_report_pending.tpl.php, and blast_report_alignment_row.tpl.php,
 | 
	
		
			
				|  |  | +respectively) which can easily be overridden in your own theme providing
 | 
	
		
			
				|  |  |  complete control over the look of the BLAST results.
 |