Module hocort.aligners.bowtie2
Expand source code
import logging
import os
import sys
import hocort.execute as exe
from hocort.parse.parser import ArgParser
from hocort.parse.parser import validate_args
logger = logging.getLogger(__file__)
class Bowtie2():
"""
Bowtie2 implementation of the Aligner abstract base class.
"""
def build_index(self, path_out, fasta_in, options=[], **kwargs):
"""
Builds an index.
Parameters
----------
path_out : string
Path where the output index is written.
fasta_in : string
Path where the input FASTA file is located.
threads : int
Number of threads to use.
options : list
An options list where additional arguments may be specified.
Returns
-------
[cmd] : list
List of commands to be executed.
Raises
------
ValueError
Raised if no input FASTA file is given, or no output file is given.
If disallowed characters are found in input.
"""
# validate input
valid, arg, chars = validate_args([path_out, fasta_in] + options)
if not valid:
raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}')
if not fasta_in:
raise ValueError(f'No input FASTA file was given.')
if not path_out:
raise ValueError(f'No output path was given.')
cmd = ['bowtie2-build'] + options + [fasta_in, path_out]
return [cmd]
def align(self, index, seq1, output=None, seq2=None, threads=1, options=[]):
"""
Aligns FastQ sequences to reference genome and outputs a SAM file.
Parameters
----------
index : string
Path where the aligner index is located.
seq1 : string
Path where the first input FastQ file is located.
output : string
Path where the output SAM file is written.
If output is None, the output is written to stdout.
seq2 : string
Path where the second input FastQ file is located.
threads : int
Number of threads to use.
options : list
An options list where additional arguments may be specified.
Returns
-------
[cmd] : list
List of commands to be executed.
Raises
------
ValueError
Raised if no input index path is given, or no input FastQ file is given.
If disallowed characters are found in input.
"""
# validate input
valid, arg, chars = validate_args([index, seq1, output, seq2] + options)
if not valid:
raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}')
if not index:
raise ValueError(f'No index path was given.')
if not seq1:
raise ValueError(f'No input FastQ was given.')
cmd = ['bowtie2', '-p', str(threads), '-x', index, '-q']
if output:
cmd += ['-S', output]
cmd += options
if seq2:
cmd += ['-1', seq1, '-2', seq2]
else: cmd += ['-U', seq1]
return [cmd]
def index_interface(self, args):
"""
Main function for the index generation interface. Parses arguments and generates the index.
Parameters
----------
args : list
This list is parsed by ArgumentParser.
Returns
-------
None
"""
parser = ArgParser(
description=f'{self.__class__.__name__} aligner',
usage=f'hocort index {self.__class__.__name__} [-h] -i <fasta> -o <index>'
)
parser.add_argument(
'-i',
'--input',
required=True,
type=str,
metavar=('<fasta>'),
help='str: path to sequence files (required)'
)
parser.add_argument(
'-o',
'--output',
required=True,
type=str,
metavar=('<index>'),
help='str: path to output index (dir/basename) (required)'
)
parsed = parser.parse_args(args=args)
ref = parsed.input
out = parsed.output
s = os.path.split(out)
out_dir = s[0]
basename = s[1]
if basename == '' or basename == out:
logger.error(f'No basename was provided for output path (dir/basename): {basename}')
sys.exit(1)
if not os.path.isdir(out_dir):
logger.error(f'Output path does not exist: {out}')
sys.exit(1)
cmd = self.build_index(out, ref)
logger.warning(f'Generating index for: {self.__class__.__name__}')
returncode = exe.execute(cmd, pipe=False, merge_stdout_stderr=True)
return returncode[0]Classes
class Bowtie2-
Bowtie2 implementation of the Aligner abstract base class.
Expand source code
class Bowtie2(): """ Bowtie2 implementation of the Aligner abstract base class. """ def build_index(self, path_out, fasta_in, options=[], **kwargs): """ Builds an index. Parameters ---------- path_out : string Path where the output index is written. fasta_in : string Path where the input FASTA file is located. threads : int Number of threads to use. options : list An options list where additional arguments may be specified. Returns ------- [cmd] : list List of commands to be executed. Raises ------ ValueError Raised if no input FASTA file is given, or no output file is given. If disallowed characters are found in input. """ # validate input valid, arg, chars = validate_args([path_out, fasta_in] + options) if not valid: raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}') if not fasta_in: raise ValueError(f'No input FASTA file was given.') if not path_out: raise ValueError(f'No output path was given.') cmd = ['bowtie2-build'] + options + [fasta_in, path_out] return [cmd] def align(self, index, seq1, output=None, seq2=None, threads=1, options=[]): """ Aligns FastQ sequences to reference genome and outputs a SAM file. Parameters ---------- index : string Path where the aligner index is located. seq1 : string Path where the first input FastQ file is located. output : string Path where the output SAM file is written. If output is None, the output is written to stdout. seq2 : string Path where the second input FastQ file is located. threads : int Number of threads to use. options : list An options list where additional arguments may be specified. Returns ------- [cmd] : list List of commands to be executed. Raises ------ ValueError Raised if no input index path is given, or no input FastQ file is given. If disallowed characters are found in input. """ # validate input valid, arg, chars = validate_args([index, seq1, output, seq2] + options) if not valid: raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}') if not index: raise ValueError(f'No index path was given.') if not seq1: raise ValueError(f'No input FastQ was given.') cmd = ['bowtie2', '-p', str(threads), '-x', index, '-q'] if output: cmd += ['-S', output] cmd += options if seq2: cmd += ['-1', seq1, '-2', seq2] else: cmd += ['-U', seq1] return [cmd] def index_interface(self, args): """ Main function for the index generation interface. Parses arguments and generates the index. Parameters ---------- args : list This list is parsed by ArgumentParser. Returns ------- None """ parser = ArgParser( description=f'{self.__class__.__name__} aligner', usage=f'hocort index {self.__class__.__name__} [-h] -i <fasta> -o <index>' ) parser.add_argument( '-i', '--input', required=True, type=str, metavar=('<fasta>'), help='str: path to sequence files (required)' ) parser.add_argument( '-o', '--output', required=True, type=str, metavar=('<index>'), help='str: path to output index (dir/basename) (required)' ) parsed = parser.parse_args(args=args) ref = parsed.input out = parsed.output s = os.path.split(out) out_dir = s[0] basename = s[1] if basename == '' or basename == out: logger.error(f'No basename was provided for output path (dir/basename): {basename}') sys.exit(1) if not os.path.isdir(out_dir): logger.error(f'Output path does not exist: {out}') sys.exit(1) cmd = self.build_index(out, ref) logger.warning(f'Generating index for: {self.__class__.__name__}') returncode = exe.execute(cmd, pipe=False, merge_stdout_stderr=True) return returncode[0]Methods
def align(self, index, seq1, output=None, seq2=None, threads=1, options=[])-
Aligns FastQ sequences to reference genome and outputs a SAM file.
Parameters
index:string- Path where the aligner index is located.
seq1:string- Path where the first input FastQ file is located.
output:string- Path where the output SAM file is written. If output is None, the output is written to stdout.
seq2:string- Path where the second input FastQ file is located.
threads:int- Number of threads to use.
options:list- An options list where additional arguments may be specified.
Returns
[cmd] : list List of commands to be executed.
Raises
ValueError- Raised if no input index path is given, or no input FastQ file is given. If disallowed characters are found in input.
Expand source code
def align(self, index, seq1, output=None, seq2=None, threads=1, options=[]): """ Aligns FastQ sequences to reference genome and outputs a SAM file. Parameters ---------- index : string Path where the aligner index is located. seq1 : string Path where the first input FastQ file is located. output : string Path where the output SAM file is written. If output is None, the output is written to stdout. seq2 : string Path where the second input FastQ file is located. threads : int Number of threads to use. options : list An options list where additional arguments may be specified. Returns ------- [cmd] : list List of commands to be executed. Raises ------ ValueError Raised if no input index path is given, or no input FastQ file is given. If disallowed characters are found in input. """ # validate input valid, arg, chars = validate_args([index, seq1, output, seq2] + options) if not valid: raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}') if not index: raise ValueError(f'No index path was given.') if not seq1: raise ValueError(f'No input FastQ was given.') cmd = ['bowtie2', '-p', str(threads), '-x', index, '-q'] if output: cmd += ['-S', output] cmd += options if seq2: cmd += ['-1', seq1, '-2', seq2] else: cmd += ['-U', seq1] return [cmd] def build_index(self, path_out, fasta_in, options=[], **kwargs)-
Builds an index.
Parameters
path_out:string- Path where the output index is written.
fasta_in:string- Path where the input FASTA file is located.
threads:int- Number of threads to use.
options:list- An options list where additional arguments may be specified.
Returns
[cmd] : list List of commands to be executed.
Raises
ValueError- Raised if no input FASTA file is given, or no output file is given. If disallowed characters are found in input.
Expand source code
def build_index(self, path_out, fasta_in, options=[], **kwargs): """ Builds an index. Parameters ---------- path_out : string Path where the output index is written. fasta_in : string Path where the input FASTA file is located. threads : int Number of threads to use. options : list An options list where additional arguments may be specified. Returns ------- [cmd] : list List of commands to be executed. Raises ------ ValueError Raised if no input FASTA file is given, or no output file is given. If disallowed characters are found in input. """ # validate input valid, arg, chars = validate_args([path_out, fasta_in] + options) if not valid: raise ValueError(f'Input with disallowed characters detected: "{arg}" - {chars}') if not fasta_in: raise ValueError(f'No input FASTA file was given.') if not path_out: raise ValueError(f'No output path was given.') cmd = ['bowtie2-build'] + options + [fasta_in, path_out] return [cmd] def index_interface(self, args)-
Main function for the index generation interface. Parses arguments and generates the index.
Parameters
args:list- This list is parsed by ArgumentParser.
Returns
None
Expand source code
def index_interface(self, args): """ Main function for the index generation interface. Parses arguments and generates the index. Parameters ---------- args : list This list is parsed by ArgumentParser. Returns ------- None """ parser = ArgParser( description=f'{self.__class__.__name__} aligner', usage=f'hocort index {self.__class__.__name__} [-h] -i <fasta> -o <index>' ) parser.add_argument( '-i', '--input', required=True, type=str, metavar=('<fasta>'), help='str: path to sequence files (required)' ) parser.add_argument( '-o', '--output', required=True, type=str, metavar=('<index>'), help='str: path to output index (dir/basename) (required)' ) parsed = parser.parse_args(args=args) ref = parsed.input out = parsed.output s = os.path.split(out) out_dir = s[0] basename = s[1] if basename == '' or basename == out: logger.error(f'No basename was provided for output path (dir/basename): {basename}') sys.exit(1) if not os.path.isdir(out_dir): logger.error(f'Output path does not exist: {out}') sys.exit(1) cmd = self.build_index(out, ref) logger.warning(f'Generating index for: {self.__class__.__name__}') returncode = exe.execute(cmd, pipe=False, merge_stdout_stderr=True) return returncode[0]