|
@@ -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.
|