sand_align_master

NAME

sand_align_master - align candidate sequences in parallel

SYNOPSIS

sand_align_master [options] sand_align_kernel candidates.cand sequences.cfa overlaps.ovl

DESCRIPTION

sand_align_master is the second step in the SAND assembler. It reads in a list of sequences and a list of candidate pairs to consider, generated by sand_filter_master(1). It then performs all of the comparisons and produces a list of overlaps (in OVL format) that exceed a quality threshhold.

This program uses the Work Queue system to distributed tasks among processors. After starting sand_align_master, you must start a number of work_queue_worker(1) processes on remote machines. The workers will then connect back to the master process and begin executing tasks. The actual alignments are performed by sand_align_kernel(1) on each machine.

OPTIONS

 

-p <port>

Port number for work queue master to listen on. (default: 9123)  

-n <number>

Maximum number of candidates per task. (default is 10000)  

-e <args>

Extra arguments to pass to the alignment program.  

-d <subsystem>

Enable debugging for this subsystem. (Try -d all to start.)  

-F <mult>

Work Queue fast abort multiplier.(default is 10.)  

-Z <file>

Select port at random and write it out to this file.  

-o <file>

Send debugging to this file.

	-v		Show version string.
	-h		Show help text.

EXIT STATUS

On success, returns zero. On failure, returns non-zero.

EXAMPLES

Suppose that you begin with a compressed FASTA file (mydata.cfa) and a list of candidate reads (mydata.cand) generated by sand_filter_master(1). First, start a single work_queue_worker(1) process in the background. Then, invoke sand_align_master() as follows:

% work_queue_worker localhost 9123 &

% sand_align_master sand_align_kernel mydata.cand mydata.cfa mydata.ovl

To speed up the process, run more work_queue_worker() processes on other machines, or use condor_submit_workers(1) or sge_submit_workers(1) to start hundreds of workers in your local batch system.

COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.

SEE ALSO

	•		Cooperative Computing Tools Documentation
	•		SAND User Manual
	•		sand_filter_master(1) sand_filter_kernel(1) sand_align_master(1) sand_align_kernel(1) sand_compress_reads(1) sand_uncompress_reads(1) work_queue_worker(1)