2 '''unit testing code for pysam.
4 Execute in the :file:`tests` directory as it requires the Makefile
5 and data files located there.
16 def checkBinaryEqual( filename1, filename2 ):
17 '''return true if the two files are binary equal.'''
18 if os.path.getsize( filename1 ) != os.path.getsize( filename2 ):
21 infile1 = open(filename1, "rb")
22 infile2 = open(filename2, "rb")
24 def chariter( infile ):
31 for c1,c2 in itertools.izip( chariter( infile1), chariter( infile2) ):
40 def runSamtools( cmd ):
41 '''run a samtools command'''
44 retcode = subprocess.call(cmd, shell=True)
46 print >>sys.stderr, "Child was terminated by signal", -retcode
48 print >>sys.stderr, "Execution failed:", e
50 def getSamtoolsVersion():
51 '''return samtools version'''
53 pipe = subprocess.Popen("samtools", shell=True, stderr=subprocess.PIPE).stderr
54 lines = "".join(pipe.readlines())
55 return re.search( "Version:\s+(\S+)", lines).groups()[0]
57 class BinaryTest(unittest.TestCase):
58 '''test samtools command line commands and compare
59 against pysam commands.
61 Tests fail, if the output is not binary identical.
66 # a list of commands to test
70 ("ex1.fa.fai", "samtools faidx ex1.fa"),
71 ("pysam_ex1.fa.fai", (pysam.faidx, "ex1.fa") ),
75 ("ex1.bam", "samtools import ex1.fa.fai ex1.sam.gz ex1.bam" ),
76 ("pysam_ex1.bam", (pysam.samimport, "ex1.fa.fai ex1.sam.gz pysam_ex1.bam") ),
80 ("ex1.bam.bai", "samtools index ex1.bam" ),
81 ("pysam_ex1.bam.bai", (pysam.index, "pysam_ex1.bam" ) ),
85 ("ex1.pileup", "samtools pileup -cf ex1.fa ex1.bam > ex1.pileup" ),
86 ("pysam_ex1.pileup", (pysam.pileup, "-c -f ex1.fa ex1.bam" ) )
90 ("ex1.glf", "samtools pileup -gf ex1.fa ex1.bam > ex1.glf" ),
91 ("pysam_ex1.glf", (pysam.pileup, "-g -f ex1.fa ex1.bam" ) )
95 ("ex1.glfview", "samtools glfview ex1.glf > ex1.glfview"),
96 ("pysam_ex1.glfview", (pysam.glfview, "ex1.glf" ) ),
100 ("ex1.view", "samtools view ex1.bam > ex1.view"),
101 ("pysam_ex1.view", (pysam.view, "ex1.bam" ) ),
105 # some tests depend on others. The order specifies in which order
106 # the samtools commands are executed.
107 mOrder = ('faidx', 'import', 'index', 'pileup1', 'pileup2', 'glfview', 'view' )
112 For setup, all commands will be run before the first test is
113 executed. Individual tests will then just compare the output
116 if BinaryTest.first_time:
118 shutil.copy( "ex1.fa", "pysam_ex1.fa" )
120 for label in self.mOrder:
121 command = self.mCommands[label]
122 samtools_target, samtools_command = command[0]
123 pysam_target, pysam_command = command[1]
124 runSamtools( samtools_command )
125 pysam_method, pysam_options = pysam_command
126 output = pysam_method( *pysam_options.split(" "), raw=True)
127 if ">" in samtools_command:
128 outfile = open( pysam_target, "w" )
129 for line in output: outfile.write( line )
132 BinaryTest.first_time = False
134 samtools_version = getSamtoolsVersion()
135 if samtools_version != pysam.__samtools_version__:
136 raise ValueError("versions of pysam/samtools and samtools differ: %s != %s" % \
137 (pysam.__samtools_version__,
140 def checkCommand( self, command ):
143 samtools_target, pysam_target = self.mCommands[command][0][0], self.mCommands[command][1][0]
144 self.assertTrue( checkBinaryEqual( samtools_target, pysam_target ),
145 "%s failed: files %s and %s are not the same" % (command, samtools_target, pysam_target) )
147 def testImport( self ):
148 self.checkCommand( "import" )
150 def testIndex( self ):
151 self.checkCommand( "index" )
153 def testPileup1( self ):
154 self.checkCommand( "pileup1" )
156 def testPileup2( self ):
157 self.checkCommand( "pileup2" )
159 def testGLFView( self ):
160 self.checkCommand( "glfview" )
162 def testView( self ):
163 self.checkCommand( "view" )
165 def testEmptyIndex( self ):
166 self.assertRaises( pysam.SamtoolsError, pysam.index, "exdoesntexist.bam" )
170 for label, command in self.mCommands.iteritems():
171 samtools_target, samtools_command = command[0]
172 pysam_target, pysam_command = command[1]
173 if os.path.exists( samtools_target): os.remove( samtools_target )
174 if os.path.exists( pysam_target): os.remove( pysam_target )
175 if os.path.exists( "pysam_ex1.fa" ): os.remove( "pysam_ex1.fa" )
177 class IOTest(unittest.TestCase):
178 '''check if reading samfile and writing a samfile are consistent.'''
180 def checkEcho( self, input_filename, reference_filename,
182 input_mode, output_mode, use_template = True):
183 '''iterate through *input_filename* writing to *output_filename* and
184 comparing the output to *reference_filename*.
186 The files are opened according to the *input_mode* and *output_mode*.
188 If *use_template* is set, the header is copied from infile using the
189 template mechanism, otherwise target names and lengths are passed explicitely.
192 infile = pysam.Samfile( input_filename, input_mode )
194 outfile = pysam.Samfile( output_filename, output_mode, template = infile )
196 outfile = pysam.Samfile( output_filename, output_mode,
197 referencenames = infile.references,
198 referencelengths = infile.lengths )
200 iter = infile.fetch()
201 for x in iter: outfile.write( x )
205 self.assertTrue( checkBinaryEqual( reference_filename, output_filename),
206 "files %s and %s are not the same" % (reference_filename, output_filename) )
208 def testReadWriteBam( self ):
210 input_filename = "ex1.bam"
211 output_filename = "pysam_ex1.bam"
212 reference_filename = "ex1.bam"
214 self.checkEcho( input_filename, reference_filename, output_filename,
217 def testReadWriteBamWithTargetNames( self ):
219 input_filename = "ex1.bam"
220 output_filename = "pysam_ex1.bam"
221 reference_filename = "ex1.bam"
223 self.checkEcho( input_filename, reference_filename, output_filename,
224 "rb", "wb", use_template = False )
226 def testReadWriteSamWithHeader( self ):
228 input_filename = "ex2.sam"
229 output_filename = "pysam_ex2.sam"
230 reference_filename = "ex2.sam"
232 self.checkEcho( input_filename, reference_filename, output_filename,
235 def testReadWriteSamWithoutHeader( self ):
237 input_filename = "ex2.sam"
238 output_filename = "pysam_ex2.sam"
239 reference_filename = "ex1.sam"
241 self.checkEcho( input_filename, reference_filename, output_filename,
244 def testFetchFromClosedFile( self ):
246 samfile = pysam.Samfile( "ex1.bam", "rb" )
248 self.assertRaises( ValueError, samfile.fetch, 'chr1', 100, 120)
250 def testPileupFromClosedFile( self ):
252 samfile = pysam.Samfile( "ex1.bam", "rb" )
254 self.assertRaises( ValueError, samfile.pileup, 'chr1', 100, 120)
256 def testBinaryReadFromSamfile( self ):
258 # needs to re-activated, see issue 19
259 #samfile = pysam.Samfile( "ex1.bam", "r" )
260 #samfile.fetch().next()
262 def testReadingFromFileWithoutIndex( self ):
263 '''read from bam file without index.'''
265 assert not os.path.exists( "ex2.bam.bai" )
266 samfile = pysam.Samfile( "ex2.bam", "rb" )
267 self.assertRaises( ValueError, samfile.fetch )
268 self.assertEqual( len(list( samfile.fetch(until_eof = True) )), 3270 )
270 def testReadingFromFileWithWrongMode( self ):
272 assert not os.path.exists( "ex2.bam.bai" )
273 samfile = pysam.Samfile( "ex2.bam", "r" )
274 self.assertRaises( ValueError, samfile.fetch )
276 class TestIteratorRow(unittest.TestCase):
279 self.samfile=pysam.Samfile( "ex1.bam","rb" )
281 def checkRange( self, rnge ):
282 '''compare results from iterator with those from samtools.'''
283 ps = list(self.samfile.fetch(region=rnge))
284 sa = list(pysam.view( "ex1.bam", rnge , raw = True) )
285 self.assertEqual( len(ps), len(sa), "unequal number of results for range %s: %i != %i" % (rnge, len(ps), len(sa) ))
286 # check if the same reads are returned and in the same order
287 for line, pair in enumerate( zip( ps, sa ) ):
288 data = pair[1].split("\t")
289 self.assertEqual( pair[0].qname, data[0], "read id mismatch in line %i: %s != %s" % (line, pair[0].rname, data[0]) )
291 def testIteratePerContig(self):
292 '''check random access per contig'''
293 for contig in self.samfile.references:
294 self.checkRange( contig )
296 def testIterateRanges(self):
297 '''check random access per range'''
298 for contig, length in zip(self.samfile.references, self.samfile.lengths):
299 for start in range( 1, length, 90):
300 self.checkRange( "%s:%i-%i" % (contig, start, start + 90) ) # this includes empty ranges
306 class TestIteratorRowAll(unittest.TestCase):
309 self.samfile=pysam.Samfile( "ex1.bam","rb" )
311 def testIterate(self):
312 '''compare results from iterator with those from samtools.'''
313 ps = list(self.samfile.fetch())
314 sa = list(pysam.view( "ex1.bam", raw = True) )
315 self.assertEqual( len(ps), len(sa), "unequal number of results: %i != %i" % (len(ps), len(sa) ))
316 # check if the same reads are returned
317 for line, pair in enumerate( zip( ps, sa ) ):
318 data = pair[1].split("\t")
319 self.assertEqual( pair[0].qname, data[0], "read id mismatch in line %i: %s != %s" % (line, pair[0].rname, data[0]) )
324 class TestIteratorColumn(unittest.TestCase):
325 '''test iterator column against contents of ex3.bam.'''
327 # note that samfile contains 1-based coordinates
328 # 1D means deletion with respect to reference sequence
330 mCoverages = { 'chr1' : [ 0 ] * 20 + [1] * 36 + [0] * (100 - 20 -35 ),
331 'chr2' : [ 0 ] * 20 + [1] * 35 + [0] * (100 - 20 -35 ),
335 self.samfile=pysam.Samfile( "ex4.bam","rb" )
337 def checkRange( self, rnge ):
338 '''compare results from iterator with those from samtools.'''
339 # check if the same reads are returned and in the same order
340 for column in self.samfile.pileup(region=rnge):
341 thiscov = len(column.pileups)
342 refcov = self.mCoverages[self.samfile.getrname(column.tid)][column.pos]
343 self.assertEqual( thiscov, refcov, "wrong coverage at pos %s:%i %i should be %i" % (self.samfile.getrname(column.tid), column.pos, thiscov, refcov))
345 def testIterateAll(self):
346 '''check random access per contig'''
347 self.checkRange( None )
349 def testIteratePerContig(self):
350 '''check random access per contig'''
351 for contig in self.samfile.references:
352 self.checkRange( contig )
354 def testIterateRanges(self):
355 '''check random access per range'''
356 for contig, length in zip(self.samfile.references, self.samfile.lengths):
357 for start in range( 1, length, 90):
358 self.checkRange( "%s:%i-%i" % (contig, start, start + 90) ) # this includes empty ranges
360 def testInverse( self ):
361 '''test the inverse, is point-wise pileup accurate.'''
362 for contig, refseq in self.mCoverages.items():
363 refcolumns = sum(refseq)
364 for pos, refcov in enumerate( refseq ):
365 columns = list(self.samfile.pileup( contig, pos, pos+1) )
367 # if no read, no coverage
368 self.assertEqual( len(columns), refcov, "wrong number of pileup columns returned for position %s:%i, %i should be %i" %(contig,pos,len(columns), refcov) )
370 # one read, all columns of the read are returned
371 self.assertEqual( len(columns), refcolumns, "pileup incomplete at position %i: got %i, expected %i " %\
372 (pos, len(columns), refcolumns))
377 class TestAlignedReadFromBam(unittest.TestCase):
380 self.samfile=pysam.Samfile( "ex3.bam","rb" )
381 self.reads=list(self.samfile.fetch())
383 def testARqname(self):
384 self.assertEqual( self.reads[0].qname, "read_28833_29006_6945", "read name mismatch in read 1: %s != %s" % (self.reads[0].qname, "read_28833_29006_6945") )
385 self.assertEqual( self.reads[1].qname, "read_28701_28881_323b", "read name mismatch in read 2: %s != %s" % (self.reads[1].qname, "read_28701_28881_323b") )
387 def testARflag(self):
388 self.assertEqual( self.reads[0].flag, 99, "flag mismatch in read 1: %s != %s" % (self.reads[0].flag, 99) )
389 self.assertEqual( self.reads[1].flag, 147, "flag mismatch in read 2: %s != %s" % (self.reads[1].flag, 147) )
391 def testARrname(self):
392 self.assertEqual( self.reads[0].rname, 0, "chromosome/target id mismatch in read 1: %s != %s" % (self.reads[0].rname, 0) )
393 self.assertEqual( self.reads[1].rname, 1, "chromosome/target id mismatch in read 2: %s != %s" % (self.reads[1].rname, 1) )
396 self.assertEqual( self.reads[0].pos, 33-1, "mapping position mismatch in read 1: %s != %s" % (self.reads[0].pos, 33-1) )
397 self.assertEqual( self.reads[1].pos, 88-1, "mapping position mismatch in read 2: %s != %s" % (self.reads[1].pos, 88-1) )
399 def testARmapq(self):
400 self.assertEqual( self.reads[0].mapq, 20, "mapping quality mismatch in read 1: %s != %s" % (self.reads[0].mapq, 20) )
401 self.assertEqual( self.reads[1].mapq, 30, "mapping quality mismatch in read 2: %s != %s" % (self.reads[1].mapq, 30) )
403 def testARcigar(self):
404 self.assertEqual( self.reads[0].cigar, [(0, 10), (2, 1), (0, 25)], "read name length mismatch in read 1: %s != %s" % (self.reads[0].cigar, [(0, 10), (2, 1), (0, 25)]) )
405 self.assertEqual( self.reads[1].cigar, [(0, 35)], "read name length mismatch in read 2: %s != %s" % (self.reads[1].cigar, [(0, 35)]) )
407 def testARmrnm(self):
408 self.assertEqual( self.reads[0].mrnm, 0, "mate reference sequence name mismatch in read 1: %s != %s" % (self.reads[0].mrnm, 0) )
409 self.assertEqual( self.reads[1].mrnm, 1, "mate reference sequence name mismatch in read 2: %s != %s" % (self.reads[1].mrnm, 1) )
411 def testARmpos(self):
412 self.assertEqual( self.reads[0].mpos, 200-1, "mate mapping position mismatch in read 1: %s != %s" % (self.reads[0].mpos, 200-1) )
413 self.assertEqual( self.reads[1].mpos, 500-1, "mate mapping position mismatch in read 2: %s != %s" % (self.reads[1].mpos, 500-1) )
415 def testARisize(self):
416 self.assertEqual( self.reads[0].isize, 167, "insert size mismatch in read 1: %s != %s" % (self.reads[0].isize, 167) )
417 self.assertEqual( self.reads[1].isize, 412, "insert size mismatch in read 2: %s != %s" % (self.reads[1].isize, 412) )
420 self.assertEqual( self.reads[0].seq, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG", "sequence mismatch in read 1: %s != %s" % (self.reads[0].seq, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG") )
421 self.assertEqual( self.reads[1].seq, "ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA", "sequence size mismatch in read 2: %s != %s" % (self.reads[1].seq, "ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA") )
422 self.assertEqual( self.reads[3].seq, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG", "sequence mismatch in read 4: %s != %s" % (self.reads[3].seq, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG") )
424 def testARqual(self):
425 self.assertEqual( self.reads[0].qual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<", "quality string mismatch in read 1: %s != %s" % (self.reads[0].qual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<") )
426 self.assertEqual( self.reads[1].qual, "<<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<<", "quality string mismatch in read 2: %s != %s" % (self.reads[1].qual, "<<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<<") )
427 self.assertEqual( self.reads[3].qual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<", "quality string mismatch in read 3: %s != %s" % (self.reads[3].qual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<") )
429 def testARquery(self):
430 self.assertEqual( self.reads[0].query, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG", "query mismatch in read 1: %s != %s" % (self.reads[0].query, "AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG") )
431 self.assertEqual( self.reads[1].query, "ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA", "query size mismatch in read 2: %s != %s" % (self.reads[1].query, "ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA") )
432 self.assertEqual( self.reads[3].query, "TAGCTAGCTACCTATATCTTGGTCTT", "query mismatch in read 4: %s != %s" % (self.reads[3].query, "TAGCTAGCTACCTATATCTTGGTCTT") )
434 def testARqqual(self):
435 self.assertEqual( self.reads[0].qqual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<", "qquality string mismatch in read 1: %s != %s" % (self.reads[0].qqual, "<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<") )
436 self.assertEqual( self.reads[1].qqual, "<<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<<", "qquality string mismatch in read 2: %s != %s" % (self.reads[1].qqual, "<<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<<") )
437 self.assertEqual( self.reads[3].qqual, "<<<<<<<<<<<<<<<<<:<9/,&,22", "qquality string mismatch in read 3: %s != %s" % (self.reads[3].qqual, "<<<<<<<<<<<<<<<<<:<9/,&,22") )
439 def testPresentOptionalFields(self):
440 self.assertEqual( self.reads[0].opt('NM'), 1, "optional field mismatch in read 1, NM: %s != %s" % (self.reads[0].opt('NM'), 1) )
441 self.assertEqual( self.reads[0].opt('RG'), 'L1', "optional field mismatch in read 1, RG: %s != %s" % (self.reads[0].opt('RG'), 'L1') )
442 self.assertEqual( self.reads[1].opt('RG'), 'L2', "optional field mismatch in read 2, RG: %s != %s" % (self.reads[1].opt('RG'), 'L2') )
443 self.assertEqual( self.reads[1].opt('MF'), 18, "optional field mismatch in read 2, MF: %s != %s" % (self.reads[1].opt('MF'), 18) )
445 def testPairedBools(self):
446 self.assertEqual( self.reads[0].is_paired, True, "is paired mismatch in read 1: %s != %s" % (self.reads[0].is_paired, True) )
447 self.assertEqual( self.reads[1].is_paired, True, "is paired mismatch in read 2: %s != %s" % (self.reads[1].is_paired, True) )
448 self.assertEqual( self.reads[0].is_proper_pair, True, "is proper pair mismatch in read 1: %s != %s" % (self.reads[0].is_proper_pair, True) )
449 self.assertEqual( self.reads[1].is_proper_pair, True, "is proper pair mismatch in read 2: %s != %s" % (self.reads[1].is_proper_pair, True) )
451 def testTags( self ):
452 self.assertEqual( self.reads[0].tags,
453 [('NM', 1), ('RG', 'L1'),
454 ('PG', 'P1'), ('XT', 'U')] )
455 self.assertEqual( self.reads[1].tags,
456 [('MF', 18), ('RG', 'L2'),
457 ('PG', 'P2'),('XT', 'R') ] )
460 self.assertEqual( self.reads[0].opt("XT"), "U" )
461 self.assertEqual( self.reads[1].opt("XT"), "R" )
463 def testMissingOpt( self ):
464 self.assertRaises( KeyError, self.reads[0].opt, "XP" )
466 def testEmptyOpt( self ):
467 self.assertRaises( KeyError, self.reads[2].opt, "XT" )
472 class TestAlignedReadFromSam(TestAlignedReadFromBam):
475 self.samfile=pysam.Samfile( "ex3.sam","r" )
476 self.reads=list(self.samfile.fetch())
478 # needs to be implemented
479 # class TestAlignedReadFromSamWithoutHeader(TestAlignedReadFromBam):
482 # self.samfile=pysam.Samfile( "ex7.sam","r" )
483 # self.reads=list(self.samfile.fetch())
485 class TestHeaderSam(unittest.TestCase):
487 header = {'SQ': [{'LN': 1575, 'SN': 'chr1'},
488 {'LN': 1584, 'SN': 'chr2'}],
489 'RG': [{'LB': 'SC_1', 'ID': 'L1', 'SM': 'NA12891', 'PU': 'SC_1_10', "CN":"name:with:colon"},
490 {'LB': 'SC_2', 'ID': 'L2', 'SM': 'NA12891', 'PU': 'SC_2_12', "CN":"name:with:colon"}],
491 'PG': [{'ID': 'P1', 'VN': '1.0'}, {'ID': 'P2', 'VN': '1.1'}],
493 'CO' : [ 'this is a comment', 'this is another comment'],
496 def compareHeaders( self, a, b ):
497 '''compare two headers a and b.'''
498 for ak,av in a.iteritems():
499 self.assertTrue( ak in b, "key '%s' not in '%s' " % (ak,b) )
500 self.assertEqual( av, b[ak] )
503 self.samfile=pysam.Samfile( "ex3.sam","r" )
505 def testHeaders(self):
506 self.compareHeaders( self.header, self.samfile.header )
507 self.compareHeaders( self.samfile.header, self.header )
512 class TestHeaderBam(TestHeaderSam):
515 self.samfile=pysam.Samfile( "ex3.bam","rb" )
517 class TestUnmappedReads(unittest.TestCase):
520 samfile=pysam.Samfile( "ex5.sam","r" )
521 self.assertEqual( len(list(samfile.fetch( until_eof = True))), 2 )
525 samfile=pysam.Samfile( "ex5.bam","rb" )
526 self.assertEqual( len(list(samfile.fetch( until_eof = True))), 2 )
529 class TestPileupObjects(unittest.TestCase):
532 self.samfile=pysam.Samfile( "ex1.bam","rb" )
534 def testPileupColumn(self):
535 for pcolumn1 in self.samfile.pileup( region="chr1:105" ):
536 if pcolumn1.pos == 104:
537 self.assertEqual( pcolumn1.tid, 0, "chromosome/target id mismatch in position 1: %s != %s" % (pcolumn1.tid, 0) )
538 self.assertEqual( pcolumn1.pos, 105-1, "position mismatch in position 1: %s != %s" % (pcolumn1.pos, 105-1) )
539 self.assertEqual( pcolumn1.n, 2, "# reads mismatch in position 1: %s != %s" % (pcolumn1.n, 2) )
540 for pcolumn2 in self.samfile.pileup( region="chr2:1480" ):
541 if pcolumn2.pos == 1479:
542 self.assertEqual( pcolumn2.tid, 1, "chromosome/target id mismatch in position 1: %s != %s" % (pcolumn2.tid, 1) )
543 self.assertEqual( pcolumn2.pos, 1480-1, "position mismatch in position 1: %s != %s" % (pcolumn2.pos, 1480-1) )
544 self.assertEqual( pcolumn2.n, 12, "# reads mismatch in position 1: %s != %s" % (pcolumn2.n, 12) )
546 def testPileupRead(self):
547 for pcolumn1 in self.samfile.pileup( region="chr1:105" ):
548 if pcolumn1.pos == 104:
549 self.assertEqual( len(pcolumn1.pileups), 2, "# reads aligned to column mismatch in position 1: %s != %s" % (len(pcolumn1.pileups), 2) )
550 # self.assertEqual( pcolumn1.pileups[0] # need to test additional properties here
555 class TestContextManager(unittest.TestCase):
557 def testManager( self ):
558 with pysam.Samfile('ex1.bam', 'rb') as samfile:
560 self.assertEqual( samfile._isOpen(), False )
562 class TestExceptions(unittest.TestCase):
565 self.samfile=pysam.Samfile( "ex1.bam","rb" )
567 def testMissingFile(self):
569 self.assertRaises( IOError, pysam.Samfile, "exdoesntexist.bam", "rb" )
570 self.assertRaises( IOError, pysam.Samfile, "exdoesntexist.sam", "r" )
571 self.assertRaises( IOError, pysam.Samfile, "exdoesntexist.bam", "r" )
572 self.assertRaises( IOError, pysam.Samfile, "exdoesntexist.sam", "rb" )
574 def testBadContig(self):
575 self.assertRaises( ValueError, self.samfile.fetch, "chr88" )
577 def testMeaninglessCrap(self):
578 self.assertRaises( ValueError, self.samfile.fetch, "skljf" )
580 def testBackwardsOrderNewFormat(self):
581 self.assertRaises( ValueError, self.samfile.fetch, 'chr1', 100, 10 )
583 def testBackwardsOrderOldFormat(self):
584 self.assertRaises( ValueError, self.samfile.fetch, region="chr1:100-10")
586 def testOutOfRangeNegativeNewFormat(self):
587 self.assertRaises( ValueError, self.samfile.fetch, "chr1", 5, -10 )
588 self.assertRaises( ValueError, self.samfile.fetch, "chr1", 5, 0 )
589 self.assertRaises( ValueError, self.samfile.fetch, "chr1", -5, -10 )
591 def testOutOfRangeNegativeOldFormat(self):
592 self.assertRaises( ValueError, self.samfile.fetch, region="chr1:-5-10" )
593 self.assertRaises( ValueError, self.samfile.fetch, region="chr1:-5-0" )
594 self.assertRaises( ValueError, self.samfile.fetch, region="chr1:-5--10" )
596 def testOutOfRangNewFormat(self):
597 self.assertRaises( ValueError, self.samfile.fetch, "chr1", 9999999999, 99999999999 )
599 def testOutOfRangeLargeNewFormat(self):
600 self.assertRaises( ValueError, self.samfile.fetch, "chr1", 9999999999999999999999999999999, 9999999999999999999999999999999999999999 )
602 def testOutOfRangeLargeOldFormat(self):
603 self.assertRaises( ValueError, self.samfile.fetch, "chr1:99999999999999999-999999999999999999" )
608 class TestFastaFile(unittest.TestCase):
610 mSequences = { 'chr1' :
611 "CACTAGTGGCTCATTGTAAATGTGTGGTTTAACTCGTCCATGGCCCAGCATTAGGGAGCTGTGGACCCTGCAGCCTGGCTGTGGGGGCCGCAGTGGCTGAGGGGTGCAGAGCCGAGTCACGGGGTTGCCAGCACAGGGGCTTAACCTCTGGTGACTGCCAGAGCTGCTGGCAAGCTAGAGTCCCATTTGGAGCCCCTCTAAGCCGTTCTATTTGTAATGAAAACTATATTTATGCTATTCAGTTCTAAATATAGAAATTGAAACAGCTGTGTTTAGTGCCTTTGTTCAACCCCCTTGCAACAACCTTGAGAACCCCAGGGAATTTGTCAATGTCAGGGAAGGAGCATTTTGTCAGTTACCAAATGTGTTTATTACCAGAGGGATGGAGGGAAGAGGGACGCTGAAGAACTTTGATGCCCTCTTCTTCCAAAGATGAAACGCGTAACTGCGCTCTCATTCACTCCAGCTCCCTGTCACCCAATGGACCTGTGATATCTGGATTCTGGGAAATTCTTCATCCTGGACCCTGAGAGATTCTGCAGCCCAGCTCCAGATTGCTTGTGGTCTGACAGGCTGCAACTGTGAGCCATCACAATGAACAACAGGAAGAAAAGGTCTTTCAAAAGGTGATGTGTGTTCTCATCAACCTCATACACACACATGGTTTAGGGGTATAATACCTCTACATGGCTGATTATGAAAACAATGTTCCCCAGATACCATCCCTGTCTTACTTCCAGCTCCCCAGAGGGAAAGCTTTCAACGCTTCTAGCCATTTCTTTTGGCATTTGCCTTCAGACCCTACACGAATGCGTCTCTACCACAGGGGGCTGCGCGGTTTCCCATCATGAAGCACTGAACTTCCACGTCTCATCTAGGGGAACAGGGAGGTGCACTAATGCGCTCCACGCCCAAGCCCTTCTCACAGTTTCTGCCCCCAGCATGGTTGTACTGGGCAATACATGAGATTATTAGGAAATGCTTTACTGTCATAACTATGAAGAGACTATTGCCAGATGAACCACACATTAATACTATGTTTCTTATCTGCACATTACTACCCTGCAATTAATATAATTGTGTCCATGTACACACGCTGTCCTATGTACTTATCATGACTCTATCCCAAATTCCCAATTACGTCCTATCTTCTTCTTAGGGAAGAACAGCTTAGGTATCAATTTGGTGTTCTGTGTAAAGTCTCAGGGAGCCGTCCGTGTCCTCCCATCTGGCCTCGTCCACACTGGTTCTCTTGAAAGCTTGGGCTGTAATGATGCCCCTTGGCCATCACCCAGTCCCTGCCCCATCTCTTGTAATCTCTCTCCTTTTTGCTGCATCCCTGTCTTCCTCTGTCTTGATTTACTTGTTGTTGGTTTTCTGTTTCTTTGTTTGATTTGGTGGAAGACATAATCCCACGCTTCCTATGGAAAGGTTGTTGGGAGATTTTTAATGATTCCTCAATGTTAAAATGTCTATTTTTGTCTTGACACCCAACTAATATTTGTCTGAGCAAAACAGTCTAGATGAGAGAGAACTTCCCTGGAGGTCTGATGGCGTTTCTCCCTCGTCTTCTTA",
613 "TTCAAATGAACTTCTGTAATTGAAAAATTCATTTAAGAAATTACAAAATATAGTTGAAAGCTCTAACAATAGACTAAACCAAGCAGAAGAAAGAGGTTCAGAACTTGAAGACAAGTCTCTTATGAATTAACCCAGTCAGACAAAAATAAAGAAAAAAATTTTAAAAATGAACAGAGCTTTCAAGAAGTATGAGATTATGTAAAGTAACTGAACCTATGAGTCACAGGTATTCCTGAGGAAAAAGAAAAAGTGAGAAGTTTGGAAAAACTATTTGAGGAAGTAATTGGGGAAAACCTCTTTAGTCTTGCTAGAGATTTAGACATCTAAATGAAAGAGGCTCAAAGAATGCCAGGAAGATACATTGCAAGACAGACTTCATCAAGATATGTAGTCATCAGACTATCTAAAGTCAACATGAAGGAAAAAAATTCTAAAATCAGCAAGAGAAAAGCATACAGTCATCTATAAAGGAAATCCCATCAGAATAACAATGGGCTTCTCAGCAGAAACCTTACAAGCCAGAAGAGATTGGATCTAATTTTTGGACTTCTTAAAGAAAAAAAAACCTGTCAAACACGAATGTTATGCCCTGCTAAACTAAGCATCATAAATGAAGGGGAAATAAAGTCAAGTCTTTCCTGACAAGCAAATGCTAAGATAATTCATCATCACTAAACCAGTCCTATAAGAAATGCTCAAAAGAATTGTAAAAGTCAAAATTAAAGTTCAATACTCACCATCATAAATACACACAAAAGTACAAAACTCACAGGTTTTATAAAACAATTGAGACTACAGAGCAACTAGGTAAAAAATTAACATTACAACAGGAACAAAACCTCATATATCAATATTAACTTTGAATAAAAAGGGATTAAATTCCCCCACTTAAGAGATATAGATTGGCAGAACAGATTTAAAAACATGAACTAACTATATGCTGTTTACAAGAAACTCATTAATAAAGACATGAGTTCAGGTAAAGGGGTGGAAAAAGATGTTCTACGCAAACAGAAACCAAATGAGAGAAGGAGTAGCTATACTTATATCAGATAAAGCACACTTTAAATCAACAACAGTAAAATAAAACAAAGGAGGTCATCATACAATGATAAAAAGATCAATTCAGCAAGAAGATATAACCATCCTACTAAATACATATGCACCTAACACAAGACTACCCAGATTCATAAAACAAATACTACTAGACCTAAGAGGGATGAGAAATTACCTAATTGGTACAATGTACAATATTCTGATGATGGTTACACTAAAAGCCCATACTTTACTGCTACTCAATATATCCATGTAACAAATCTGCGCTTGTACTTCTAAATCTATAAAAAAATTAAAATTTAACAAAAGTAAATAAAACACATAGCTAAAACTAAAAAAGCAAAAACAAAAACTATGCTAAGTATTGGTAAAGATGTGGGGAAAAAAGTAAACTCTCAAATATTGCTAGTGGGAGTATAAATTGTTTTCCACTTTGGAAAACAATTTGGTAATTTCGTTTTTTTTTTTTTCTTTTCTCTTTTTTTTTTTTTTTTTTTTGCATGCCAGAAAAAAATATTTACAGTAACT",
617 self.file=pysam.Fastafile( "ex1.fa" )
620 for id, seq in self.mSequences.items():
621 self.assertEqual( seq, self.file.fetch( id ) )
622 for x in range( 0, len(seq), 10):
623 self.assertEqual( seq[x:x+10], self.file.fetch( id, x, x+10) )
625 self.assertEqual( seq[x:], self.file.fetch( id, x) )
627 self.assertEqual( seq[:x], self.file.fetch( id, None, x) )
630 # unknown sequence returns ""
631 self.assertEqual( "", self.file.fetch("chr12") )
633 def testFetchErrors( self ):
634 self.assertRaises( ValueError, self.file.fetch )
635 self.assertRaises( ValueError, self.file.fetch, "chr1", -1, 10 )
636 self.assertRaises( ValueError, self.file.fetch, "chr1", 20, 10 )
638 def testLength( self ):
639 self.assertEqual( len(self.file), 2 )
644 class TestAlignedRead(unittest.TestCase):
645 '''tests to check if aligned read can be constructed
649 def checkFieldEqual( self, read1, read2, exclude = []):
650 '''check if two reads are equal by comparing each field.'''
652 for x in ("qname", "seq", "flag",
653 "rname", "pos", "mapq", "cigar",
654 "mrnm", "mpos", "isize", "qual",
655 "is_paired", "is_proper_pair",
656 "is_unmapped", "mate_is_unmapped",
657 "is_reverse", "mate_is_reverse",
658 "is_read1", "is_read2",
659 "is_secondary", "is_qcfail",
660 "is_duplicate", "bin"):
661 if x in exclude: continue
662 self.assertEqual( getattr(read1, x), getattr(read2,x), "attribute mismatch for %s: %s != %s" %
663 (x, getattr(read1, x), getattr(read2,x)))
665 def testEmpty( self ):
666 a = pysam.AlignedRead()
667 self.assertEqual( a.qname, None )
668 self.assertEqual( a.seq, None )
669 self.assertEqual( a.qual, None )
670 self.assertEqual( a.flag, 0 )
671 self.assertEqual( a.rname, 0 )
672 self.assertEqual( a.mapq, 0 )
673 self.assertEqual( a.cigar, None )
674 self.assertEqual( a.tags, None )
675 self.assertEqual( a.mrnm, 0 )
676 self.assertEqual( a.mpos, 0 )
677 self.assertEqual( a.isize, 0 )
679 def buildRead( self ):
680 '''build an example read.'''
682 a = pysam.AlignedRead()
683 a.qname = "read_12345"
689 a.cigar = ( (0,10), (2,1), (0,25) )
697 def testUpdate( self ):
698 '''check if updating fields affects other variable length data
705 self.checkFieldEqual( a, b, "qname" )
706 b.qname = "read_12345678"
707 self.checkFieldEqual( a, b, "qname" )
708 b.qname = "read_12345"
709 self.checkFieldEqual( a, b)
712 b.cigar = ( (0,10), )
713 self.checkFieldEqual( a, b, "cigar" )
714 b.cigar = ( (0,10), (2,1), (0,25), (2,1), (0,25) )
715 self.checkFieldEqual( a, b, "cigar" )
716 b.cigar = ( (0,10), (2,1), (0,25) )
717 self.checkFieldEqual( a, b)
721 self.checkFieldEqual( a, b, ("seq", "qual") )
723 self.checkFieldEqual( a, b, ("seq", "qual") )
725 self.checkFieldEqual( a, b, ("qual",))
732 "is_paired", "is_proper_pair",
733 "is_unmapped", "mate_is_unmapped",
734 "is_reverse", "mate_is_reverse",
735 "is_read1", "is_read2",
736 "is_secondary", "is_qcfail",
738 setattr( b, x, True )
739 self.assertEqual( getattr(b, x), True )
740 self.checkFieldEqual( a, b, ("flag", x,) )
741 setattr( b, x, False )
742 self.assertEqual( getattr(b, x), False )
743 self.checkFieldEqual( a, b )
745 def testLargeRead( self ):
746 '''build an example read.'''
748 a = pysam.AlignedRead()
749 a.qname = "read_12345"
755 a.cigar = ( (0,10), (2,1), (0,25) )
763 class TestDeNovoConstruction(unittest.TestCase):
764 '''check BAM/SAM file construction using ex3.sam
766 (note these are +1 coordinates):
768 read_28833_29006_6945 99 chr1 33 20 10M1D25M = 200 167 AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG <<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<< NM:i:1 RG:Z:L1
769 read_28701_28881_323b 147 chr2 88 30 35M = 500 412 ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA <<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<< MF:i:18 RG:Z:L2
772 header = { 'HD': {'VN': '1.0'},
773 'SQ': [{'LN': 1575, 'SN': 'chr1'},
774 {'LN': 1584, 'SN': 'chr2'}], }
779 def checkFieldEqual( self, read1, read2, exclude = []):
780 '''check if two reads are equal by comparing each field.'''
782 for x in ("qname", "seq", "flag",
783 "rname", "pos", "mapq", "cigar",
784 "mrnm", "mpos", "isize", "qual",
786 "is_paired", "is_proper_pair",
787 "is_unmapped", "mate_is_unmapped",
788 "is_reverse", "mate_is_reverse",
789 "is_read1", "is_read2",
790 "is_secondary", "is_qcfail",
792 if x in exclude: continue
793 self.assertEqual( getattr(read1, x), getattr(read2,x), "attribute mismatch for %s: %s != %s" %
794 (x, getattr(read1, x), getattr(read2,x)))
799 a = pysam.AlignedRead()
800 a.qname = "read_28833_29006_6945"
801 a.seq="AGCTTAGCTAGCTACCTATATCTTGGTCTTGGCCG"
806 a.cigar = ( (0,10), (2,1), (0,25) )
810 a.qual="<<<<<<<<<<<<<<<<<<<<<:<9/,&,22;;<<<"
811 a.tags = ( ("NM", 1),
814 b = pysam.AlignedRead()
815 b.qname = "read_28701_28881_323b"
816 b.seq="ACCTATATCTTGGCCTTGGCCGATGCGGCCTTGCA"
821 b.cigar = ( (0,35), )
825 b.qual="<<<<<;<<<<7;:<<<6;<<<<<<<<<<<<7<<<<"
826 b.tags = ( ("MF", 18),
831 def testSAMWholeFile( self ):
833 tmpfilename = "tmp_%i.sam" % id(self)
835 outfile = pysam.Samfile( tmpfilename, "wh", header = self.header )
837 for x in self.reads: outfile.write( x )
840 self.assertTrue( checkBinaryEqual( tmpfilename, self.samfile ),
841 "mismatch when construction SAM file, see %s %s" % (tmpfilename, self.samfile))
843 os.unlink( tmpfilename )
845 def testBAMPerRead( self ):
846 '''check if individual reads are binary equal.'''
847 infile = pysam.Samfile( self.bamfile, "rb")
849 others = list(infile)
850 for denovo, other in zip( others, self.reads):
851 self.checkFieldEqual( other, denovo )
852 self.assertEqual( other.compare( denovo ), 0 )
854 def testSAMPerRead( self ):
855 '''check if individual reads are binary equal.'''
856 infile = pysam.Samfile( self.samfile, "r")
858 others = list(infile)
859 for denovo, other in zip( others, self.reads):
860 self.checkFieldEqual( other, denovo )
861 self.assertEqual( other.compare( denovo), 0 )
863 def testBAMWholeFile( self ):
865 tmpfilename = "tmp_%i.bam" % id(self)
867 outfile = pysam.Samfile( tmpfilename, "wb", header = self.header )
869 for x in self.reads: outfile.write( x )
872 self.assertTrue( checkBinaryEqual( tmpfilename, self.bamfile ),
873 "mismatch when construction BAM file, see %s %s" % (tmpfilename, self.bamfile))
875 os.unlink( tmpfilename )
877 class TestDoubleFetch(unittest.TestCase):
878 '''check if two iterators on the same bamfile are independent.'''
880 def testDoubleFetch( self ):
882 samfile1 = pysam.Samfile('ex1.bam', 'rb')
884 for a,b in zip(samfile1.fetch(), samfile1.fetch()):
885 self.assertEqual( a.compare( b ), 0 )
887 def testDoubleFetchWithRegion( self ):
889 samfile1 = pysam.Samfile('ex1.bam', 'rb')
890 chr, start, stop = 'chr1', 200, 3000000
891 self.assertTrue(len(list(samfile1.fetch ( chr, start, stop))) > 0) #just making sure the test has something to catch
893 for a,b in zip(samfile1.fetch( chr, start, stop), samfile1.fetch( chr, start, stop)):
894 self.assertEqual( a.compare( b ), 0 )
896 def testDoubleFetchUntilEOF( self ):
898 samfile1 = pysam.Samfile('ex1.bam', 'rb')
900 for a,b in zip(samfile1.fetch( until_eof = True),
901 samfile1.fetch( until_eof = True )):
902 self.assertEqual( a.compare( b), 0 )
904 class TestRemoteFileFTP(unittest.TestCase):
905 '''test remote access.
909 # Need to find an ftp server without password on standard
912 url = "ftp://ftp.sanger.ac.uk/pub/rd/humanSequences/CV.bam"
915 def testFTPView( self ):
916 result = pysam.view( self.url, self.region )
917 self.assertEqual( len(result), 36 )
919 def testFTPFetch( self ):
920 samfile = pysam.Samfile(self.url, "rb")
921 result = list(samfile.fetch( region = self.region ))
922 self.assertEqual( len(result), 36 )
924 class TestRemoteFileHTTP( unittest.TestCase):
926 url = "http://genserv.anat.ox.ac.uk/downloads/pysam/test/ex1.bam"
927 region = "chr1:1-1000"
930 def testView( self ):
931 self.assertRaises( pysam.SamtoolsError, pysam.view, self.url, self.region )
933 def testFetch( self ):
934 samfile = pysam.Samfile(self.url, "rb")
935 result = list(samfile.fetch( region = self.region ))
936 samfile_local = pysam.Samfile(self.local, "rb")
937 ref = list(samfile_local.fetch( region = self.region ))
939 self.assertEqual( len(ref), len(result) )
940 for x, y in zip(result, ref):
941 self.assertEqual( x.compare( y ), 0 )
943 def testFetchAll( self ):
944 samfile = pysam.Samfile(self.url, "rb")
945 result = list(samfile.fetch())
946 samfile_local = pysam.Samfile(self.local, "rb")
947 ref = list(samfile_local.fetch() )
949 self.assertEqual( len(ref), len(result) )
950 for x, y in zip(result, ref):
951 self.assertEqual( x.compare( y ), 0 )
955 # 1. finish testing all properties within pileup objects
956 # 2. check exceptions and bad input problems (missing files, optional fields that aren't present, etc...)
958 if __name__ == "__main__":
960 print "building data files"
961 subprocess.call( "make", shell=True)
962 print "starting tests"