For pipeline 1.1rc1 or 1.3.2, look for the matrix files in the bustard dir
[htsworkflow.git] / htsworkflow / pipelines / bustard.py
index a10c909afc5f8f84f53a91f903289454fa3e58a8..a8eb4c7b7b3d3b6875b2013a5c6737cf40477f83 100644 (file)
@@ -4,12 +4,14 @@ Extract configuration from Illumina Bustard Directory.
 This includes the version number, run date, bustard executable parameters, and 
 phasing estimates. 
 """
+from copy import copy
 from datetime import date
 from glob import glob
 import logging
 import os
-import time
 import re
+import sys
+import time
 
 from htsworkflow.pipelines.runfolder import \
    ElementTree, \
@@ -19,6 +21,8 @@ from htsworkflow.pipelines.runfolder import \
 # make epydoc happy
 __docformat__ = "restructuredtext en"
 
+LANE_LIST = range(1,9)
+
 class Phasing(object):
     PHASING = 'Phasing'
     PREPHASING = 'Prephasing'
@@ -44,10 +48,13 @@ class Phasing(object):
 
     def get_elements(self):
         root = ElementTree.Element(Phasing.PHASING, {'lane': str(self.lane)})
+        root.tail = os.linesep
         phasing = ElementTree.SubElement(root, Phasing.PHASING)
         phasing.text = str(self.phasing)
+        phasing.tail = os.linesep
         prephasing = ElementTree.SubElement(root, Phasing.PREPHASING)
         prephasing.text = str(self.prephasing)
+        prephasing.tail = os.linesep
         return root
 
     def set_elements(self, tree):
@@ -62,8 +69,112 @@ class Phasing(object):
             elif element.tag == Phasing.PREPHASING:
                 self.prephasing = float(element.text)
 
+class CrosstalkMatrix(object):
+    CROSSTALK = "MatrixElements"
+    BASE = 'Base'
+    ELEMENT = 'Element'
+
+    def __init__(self, fromfile=None, xml=None):
+        self.base = {}
+
+        if fromfile is not None:
+            self._initialize_from_file(fromfile)
+        elif xml is not None:
+            self.set_elements(xml)
+
+    def _initialize_from_file(self, pathname):
+        data = open(pathname).readlines()
+        auto_header = '# Auto-generated frequency response matrix'
+        if data[0].strip() != auto_header or len(data) != 9:
+            raise RuntimeError("matrix file %s is unusual" % (pathname,))
+        # skip over lines 1,2,3,4 which contain the 4 bases
+        self.base['A'] = [ float(v) for v in data[5].split() ]
+        self.base['C'] = [ float(v) for v in data[6].split() ]
+        self.base['G'] = [ float(v) for v in data[7].split() ]
+        self.base['T'] = [ float(v) for v in data[8].split() ]
+
+    def get_elements(self):
+        root = ElementTree.Element(CrosstalkMatrix.CROSSTALK)
+        root.tail = os.linesep
+        base_order = ['A','C','G','T']
+        for b in base_order:
+            base_element = ElementTree.SubElement(root, CrosstalkMatrix.BASE)
+            base_element.text = b
+            base_element.tail = os.linesep
+        for b in base_order:
+            for value in self.base[b]:
+                crosstalk_value = ElementTree.SubElement(root, CrosstalkMatrix.ELEMENT)
+                crosstalk_value.text = unicode(value)
+                crosstalk_value.tail = os.linesep
+
+        return root
+
+    def set_elements(self, tree):
+        if tree.tag != CrosstalkMatrix.CROSSTALK:
+            raise ValueError('Invalid run-xml exptected '+CrosstalkMatrix.CROSSTALK)
+        base_order = []
+        current_base = None
+        current_index = 0
+        for element in tree.getchildren():
+            # read in the order of the bases
+            if element.tag == 'Base':
+                base_order.append(element.text)
+            elif element.tag == 'Element':
+                # we're done reading bases, now its just the 4x4 matrix
+                # written out as a list of elements
+                # if this is the first element, make a copy of the list
+                # to play with and initialize an empty list for the current base
+                if current_base is None:
+                    current_base = copy(base_order)
+                    self.base[current_base[0]] = []
+                # we found (probably) 4 bases go to the next base
+                if current_index == len(base_order):
+                    current_base.pop(0)
+                    current_index = 0
+                    self.base[current_base[0]] = []
+                value = float(element.text)
+                self.base[current_base[0]].append(value)
+
+                current_index += 1
+            else:
+                raise RuntimeError("Unrecognized tag in run xml: %s" %(element.tag,))
+
+def crosstalk_matrix_from_bustard_config(bustard_path, bustard_config_tree):
+    """
+    Analyze the bustard config file and try to find the crosstalk matrix.
+    """
+    bustard_run = bustard_config_tree[0]
+    if bustard_run.tag != 'Run':
+        raise RuntimeError('Expected Run tag, got %s' % (bustard_run.tag,))
+
+    call_parameters = bustard_run.find('BaseCallParameters')
+    if call_parameters is None:
+        raise RuntimeError('Missing BaseCallParameters section')
+
+    matrix = call_parameters.find('Matrix')
+    if matrix is None:
+        raise RuntimeError('Expected to find Matrix in Bustard BaseCallParameters')
+
+    matrix_auto_flag = int(matrix.find('AutoFlag').text)
+    matrix_auto_lane = int(matrix.find('AutoLane').text)
+
+    if matrix_auto_flag:
+        # we estimated the matrix from something in this run.
+        # though we don't really care which lane it was
+        matrix_path = os.path.join(bustard_path, 'Matrix', 's_02_matrix.txt')
+        matrix = CrosstalkMatrix(matrix_path)
+    else:
+        # the matrix was provided
+        matrix_elements = call_parameters.find('MatrixElements')
+        if matrix_elements is None:
+            raise RuntimeError('Expected to find MatrixElements in Bustard BaseCallParameters')
+        matrix = CrosstalkMatrix(xml=matrix_elements)
+
+    print "matrix:", matrix
+    return matrix
+
 class Bustard(object):
-    XML_VERSION = 1
+    XML_VERSION = 2
 
     # Xml Tags
     BUSTARD = 'Bustard'
@@ -71,13 +182,16 @@ class Bustard(object):
     DATE = 'run_time'
     USER = 'user'
     PARAMETERS = 'Parameters'
+    BUSTARD_CONFIG = 'BaseCallAnalysis'
 
     def __init__(self, xml=None):
         self.version = None
         self.date = date.today()
         self.user = None
         self.phasing = {}
+        self.crosstalk = {}
         self.pathname = None
+        self.bustard_config = None
 
         if xml is not None:
             self.set_elements(xml)
@@ -87,12 +201,8 @@ class Bustard(object):
     time = property(_get_time, doc='return run time as seconds since epoch')
 
     def dump(self):
-        print "Bustard version:", self.version
-        print "Run date", self.date
-        print "user:", self.user
-        for lane, tree in self.phasing.items():
-            print lane
-            print tree
+        #print ElementTree.tostring(self.get_elements())
+        ElementTree.dump(self.get_elements())
 
     def get_elements(self):
         root = ElementTree.Element('Bustard', 
@@ -104,8 +214,13 @@ class Bustard(object):
         user = ElementTree.SubElement(root, Bustard.USER)
         user.text = self.user
         params = ElementTree.SubElement(root, Bustard.PARAMETERS)
-        for p in self.phasing.values():
-            params.append(p.get_elements())
+
+        for lane in LANE_LIST:
+            params.append(self.phasing[lane].get_elements())
+            #params.append(self.crosstalk[lane].get_elements())
+        
+        if self.bustard_config is not None:
+            root.append(self.bustard_config)
         return root
 
     def set_elements(self, tree):
@@ -125,11 +240,11 @@ class Bustard(object):
                 for param in element:
                     p = Phasing(xml=param)
                     self.phasing[p.lane] = p
+            elif element.tag == Bustard.BUSTARD_CONFIG:
+                self.bustard_config = element
             else:
                 raise ValueError("Unrecognized tag: %s" % (element.tag,))
         
-
-
 def bustard(pathname):
     """
     Construct a Bustard object by analyzing an Illumina Bustard directory.
@@ -141,6 +256,7 @@ def bustard(pathname):
       Fully initialized Bustard object.
     """
     b = Bustard()
+    pathname = os.path.abspath(pathname)
     path, name = os.path.split(pathname)
     groups = name.split("_")
     version = re.search(VERSION_RE, groups[0])
@@ -149,11 +265,26 @@ def bustard(pathname):
     b.date = date(*t[0:3])
     b.user = groups[2]
     b.pathname = pathname
+    bustard_config_filename = os.path.join(pathname, 'config.xml')
+    print bustard_config_filename
     paramfiles = glob(os.path.join(pathname, "params?.xml"))
     for paramfile in paramfiles:
         phasing = Phasing(paramfile)
         assert (phasing.lane >= 1 and phasing.lane <= 8)
         b.phasing[phasing.lane] = phasing
+    # I only found these in Bustard1.9.5/1.9.6 directories
+    if b.version in ('1.9.5', '1.9.6'):
+        # at least for our runfolders for 1.9.5 and 1.9.6 matrix[1-8].txt are always the same
+        crosstalk_file = os.path.join(pathname, "matrix1.txt")
+        b.crosstalk = CrosstalkMatrix(crosstalk_file)
+    # for version 1.3.2 of the pipeline the bustard version number went down
+    # to match the rest of the pipeline. However there's now a nifty
+    # new (useful) bustard config file.
+    elif os.path.exists(bustard_config_filename):
+        bustard_config_root = ElementTree.parse(bustard_config_filename)
+        b.bustard_config = bustard_config_root.getroot()
+        b.crosstalk = crosstalk_matrix_from_bustard_config(b.pathname, b.bustard_config)
+
     return b
 
 def fromxml(tree):
@@ -163,3 +294,33 @@ def fromxml(tree):
     b = Bustard()
     b.set_elements(tree)
     return b
+
+def make_cmdline_parser():
+    from optparse import OptionParser
+    parser = OptionParser('%prog: bustard_directory')
+    return parser
+
+def main(cmdline):
+    parser = make_cmdline_parser()
+    opts, args = parser.parse_args(cmdline)
+
+    for bustard_dir in args:
+        print u'analyzing bustard directory: ' + unicode(bustard_dir)
+        bustard_object = bustard(bustard_dir)
+        bustard_object.dump() 
+
+        bustard_object2 = Bustard(xml=bustard_object.get_elements())
+        print ('-------------------------------------')
+        bustard_object2.dump()
+        print ('=====================================')
+        b1_tree = bustard_object.get_elements()
+        b1 = ElementTree.tostring(b1_tree).split(os.linesep)
+        b2_tree = bustard_object2.get_elements()
+        b2 = ElementTree.tostring(b2_tree).split(os.linesep)
+        for line1, line2 in zip(b1, b2):
+            if b1 != b2:
+                print "b1: ", b1
+                print "b2: ", b2
+
+if __name__ == "__main__":
+    main(sys.argv[1:])