Write import stats to stats.json.
[lightning.git] / tilelib.go
index 857b56683095dc9ddd1c7169fa3b2b1487c0edda..75e952696ad3c14ef94fe927103ccf06f3747983 100644 (file)
@@ -3,7 +3,9 @@ package main
 import (
        "bufio"
        "bytes"
+       "context"
        "encoding/gob"
+       "fmt"
        "io"
        "strings"
        "sync"
@@ -15,8 +17,8 @@ import (
 type tileVariantID uint16 // 1-based
 
 type tileLibRef struct {
-       tag     tagID
-       variant tileVariantID
+       Tag     tagID
+       Variant tileVariantID
 }
 
 type tileSeq map[string][]tileLibRef
@@ -25,8 +27,8 @@ func (tseq tileSeq) Variants() ([]tileVariantID, int, int) {
        maxtag := 0
        for _, refs := range tseq {
                for _, ref := range refs {
-                       if maxtag < int(ref.tag) {
-                               maxtag = int(ref.tag)
+                       if maxtag < int(ref.Tag) {
+                               maxtag = int(ref.Tag)
                        }
                }
        }
@@ -34,12 +36,12 @@ func (tseq tileSeq) Variants() ([]tileVariantID, int, int) {
        var kept, dropped int
        for _, refs := range tseq {
                for _, ref := range refs {
-                       if vars[int(ref.tag)] != 0 {
+                       if vars[int(ref.Tag)] != 0 {
                                dropped++
                        } else {
                                kept++
                        }
-                       vars[int(ref.tag)] = ref.variant
+                       vars[int(ref.Tag)] = ref.Variant
                }
        }
        return vars, kept, dropped
@@ -50,6 +52,7 @@ type tileLibrary struct {
        skipOOO        bool
        taglib         *tagLibrary
        variant        [][][blake2b.Size256]byte
+       refseqs        map[string]map[string][]tileLibRef
        // count [][]int
        // seq map[[blake2b.Size]byte][]byte
        variants int
@@ -59,7 +62,190 @@ type tileLibrary struct {
        mtx sync.Mutex
 }
 
-func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq, error) {
+func (tilelib *tileLibrary) loadTagSet(newtagset [][]byte) error {
+       // Loading a tagset means either passing it through to the
+       // output (if it's the first one we've seen), or just ensuring
+       // it doesn't disagree with what we already have.
+       if len(newtagset) == 0 {
+               return nil
+       }
+       tilelib.mtx.Lock()
+       defer tilelib.mtx.Unlock()
+       if tilelib.taglib == nil || tilelib.taglib.Len() == 0 {
+               tilelib.taglib = &tagLibrary{}
+               err := tilelib.taglib.setTags(newtagset)
+               if err != nil {
+                       return err
+               }
+               if tilelib.encoder != nil {
+                       err = tilelib.encoder.Encode(LibraryEntry{
+                               TagSet: newtagset,
+                       })
+                       if err != nil {
+                               return err
+                       }
+               }
+       } else if tilelib.taglib.Len() != len(newtagset) {
+               return fmt.Errorf("cannot merge libraries with differing tagsets")
+       } else {
+               current := tilelib.taglib.Tags()
+               for i := range newtagset {
+                       if !bytes.Equal(newtagset[i], current[i]) {
+                               return fmt.Errorf("cannot merge libraries with differing tagsets")
+                       }
+               }
+       }
+       return nil
+}
+
+func (tilelib *tileLibrary) loadTileVariants(tvs []TileVariant, variantmap map[tileLibRef]tileVariantID) error {
+       for _, tv := range tvs {
+               // Assign a new variant ID (unique across all inputs)
+               // for each input variant.
+               variantmap[tileLibRef{Tag: tv.Tag, Variant: tv.Variant}] = tilelib.getRef(tv.Tag, tv.Sequence).Variant
+       }
+       return nil
+}
+
+func (tilelib *tileLibrary) loadCompactGenomes(cgs []CompactGenome, variantmap map[tileLibRef]tileVariantID, onLoadGenome func(CompactGenome)) error {
+       log.Debugf("loadCompactGenomes: %d", len(cgs))
+       var wg sync.WaitGroup
+       errs := make(chan error, 1)
+       for _, cg := range cgs {
+               wg.Add(1)
+               cg := cg
+               go func() {
+                       defer wg.Done()
+                       for i, variant := range cg.Variants {
+                               if len(errs) > 0 {
+                                       return
+                               }
+                               if variant == 0 {
+                                       continue
+                               }
+                               tag := tagID(i / 2)
+                               newvariant, ok := variantmap[tileLibRef{Tag: tag, Variant: variant}]
+                               if !ok {
+                                       err := fmt.Errorf("oops: genome %q has variant %d for tag %d, but that variant was not in its library", cg.Name, variant, tag)
+                                       select {
+                                       case errs <- err:
+                                       default:
+                                       }
+                                       return
+                               }
+                               log.Tracef("loadCompactGenomes: cg %s tag %d variant %d => %d", cg.Name, tag, variant, newvariant)
+                               cg.Variants[i] = newvariant
+                       }
+                       if onLoadGenome != nil {
+                               onLoadGenome(cg)
+                       }
+                       if tilelib.encoder != nil {
+                               err := tilelib.encoder.Encode(LibraryEntry{
+                                       CompactGenomes: []CompactGenome{cg},
+                               })
+                               if err != nil {
+                                       select {
+                                       case errs <- err:
+                                       default:
+                                       }
+                                       return
+                               }
+                       }
+               }()
+       }
+       wg.Wait()
+       go close(errs)
+       return <-errs
+}
+
+func (tilelib *tileLibrary) loadCompactSequences(cseqs []CompactSequence, variantmap map[tileLibRef]tileVariantID) error {
+       log.Debugf("loadCompactSequences: %d", len(cseqs))
+       for _, cseq := range cseqs {
+               for _, tseq := range cseq.TileSequences {
+                       for i, libref := range tseq {
+                               if libref.Variant == 0 {
+                                       // No variant (e.g., import
+                                       // dropped tiles with
+                                       // no-calls) = no translation.
+                                       continue
+                               }
+                               v, ok := variantmap[libref]
+                               if !ok {
+                                       return fmt.Errorf("oops: CompactSequence %q has variant %d for tag %d, but that variant was not in its library", cseq.Name, libref.Variant, libref.Tag)
+                               }
+                               tseq[i].Variant = v
+                       }
+               }
+               if tilelib.encoder != nil {
+                       if err := tilelib.encoder.Encode(LibraryEntry{
+                               CompactSequences: []CompactSequence{cseq},
+                       }); err != nil {
+                               return err
+                       }
+               }
+       }
+       tilelib.mtx.Lock()
+       defer tilelib.mtx.Unlock()
+       if tilelib.refseqs == nil {
+               tilelib.refseqs = map[string]map[string][]tileLibRef{}
+       }
+       for _, cseq := range cseqs {
+               tilelib.refseqs[cseq.Name] = cseq.TileSequences
+       }
+       return nil
+}
+
+// Load library data from rdr. Tile variants might be renumbered in
+// the process; in that case, genomes variants will be renumbered to
+// match.
+//
+// If onLoadGenome is non-nil, call it on each CompactGenome entry.
+func (tilelib *tileLibrary) LoadGob(ctx context.Context, rdr io.Reader, onLoadGenome func(CompactGenome)) error {
+       cgs := []CompactGenome{}
+       cseqs := []CompactSequence{}
+       variantmap := map[tileLibRef]tileVariantID{}
+       err := DecodeLibrary(rdr, func(ent *LibraryEntry) error {
+               if ctx.Err() != nil {
+                       return ctx.Err()
+               }
+               if err := tilelib.loadTagSet(ent.TagSet); err != nil {
+                       return err
+               }
+               if err := tilelib.loadTileVariants(ent.TileVariants, variantmap); err != nil {
+                       return err
+               }
+               cgs = append(cgs, ent.CompactGenomes...)
+               cseqs = append(cseqs, ent.CompactSequences...)
+               return nil
+       })
+       if err != nil {
+               return err
+       }
+       if ctx.Err() != nil {
+               return ctx.Err()
+       }
+       err = tilelib.loadCompactGenomes(cgs, variantmap, onLoadGenome)
+       if err != nil {
+               return err
+       }
+       err = tilelib.loadCompactSequences(cseqs, variantmap)
+       if err != nil {
+               return err
+       }
+       return nil
+}
+
+type importStats struct {
+       InputFile              string
+       InputLabel             string
+       InputLength            int
+       InputCoverage          int
+       TileCoverage           int
+       PathLength             int
+       DroppedOutOfOrderTiles int
+}
+
+func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq, []importStats, error) {
        ret := tileSeq{}
        type jobT struct {
                label string
@@ -75,7 +261,7 @@ func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq,
                        buf := scanner.Bytes()
                        if len(buf) > 0 && buf[0] == '>' {
                                todo <- jobT{seqlabel, fasta}
-                               seqlabel, fasta = string(buf[1:]), nil
+                               seqlabel, fasta = strings.SplitN(string(buf[1:]), " ", 2)[0], nil
                                log.Debugf("%s %s reading fasta", filelabel, seqlabel)
                        } else {
                                fasta = append(fasta, bytes.ToLower(buf)...)
@@ -93,6 +279,7 @@ func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq,
        totalFoundTags := 0
        totalPathLen := 0
        skippedSequences := 0
+       stats := make([]importStats, 0, len(todo))
        for job := range todo {
                if len(job.fasta) == 0 {
                        continue
@@ -108,6 +295,7 @@ func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq,
                })
                totalFoundTags += len(found)
 
+               basesOut := 0
                skipped := 0
                path = path[:0]
                last := foundtag{tagid: -1}
@@ -121,23 +309,63 @@ func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader) (tileSeq,
                }
                for i, f := range found {
                        log.Tracef("%s %s found[%d] == %#v", filelabel, job.label, i, f)
-                       if last.taglen > 0 {
-                               path = append(path, tilelib.getRef(last.tagid, job.fasta[last.pos:f.pos+f.taglen]))
+                       if last.tagid < 0 {
+                               // first tag in sequence
+                               last = foundtag{tagid: f.tagid}
+                               continue
+                       }
+                       libref := tilelib.getRef(last.tagid, job.fasta[last.pos:f.pos+f.taglen])
+                       path = append(path, libref)
+                       if libref.Variant > 0 {
+                               // Count output coverage from
+                               // the end of the previous tag
+                               // (if any) to the end of the
+                               // current tag, IOW don't
+                               // double-count coverage for
+                               // the previous tag.
+                               basesOut += countBases(job.fasta[last.pos+last.taglen : f.pos+f.taglen])
+                       } else {
+                               // If we dropped this tile
+                               // (because !includeNoCalls),
+                               // set taglen=0 so the
+                               // overlapping tag is counted
+                               // toward coverage on the
+                               // following tile.
+                               f.taglen = 0
                        }
                        last = f
                }
-               if last.taglen > 0 {
-                       path = append(path, tilelib.getRef(last.tagid, job.fasta[last.pos:]))
+               if last.tagid < 0 {
+                       log.Warnf("%s %s no tags found", filelabel, job.label)
+               } else {
+                       libref := tilelib.getRef(last.tagid, job.fasta[last.pos:])
+                       path = append(path, libref)
+                       if libref.Variant > 0 {
+                               basesOut += countBases(job.fasta[last.pos+last.taglen:])
+                       }
                }
 
                pathcopy := make([]tileLibRef, len(path))
                copy(pathcopy, path)
                ret[job.label] = pathcopy
                log.Debugf("%s %s tiled with path len %d, skipped %d", filelabel, job.label, len(path), skipped)
+
+               basesIn := countBases(job.fasta)
+               log.Infof("%s %s fasta in %d coverage in %d coverage out %d", filelabel, job.label, len(job.fasta), basesIn, basesOut)
+               stats = append(stats, importStats{
+                       InputFile:              filelabel,
+                       InputLabel:             job.label,
+                       InputLength:            len(job.fasta),
+                       InputCoverage:          basesIn,
+                       TileCoverage:           basesOut,
+                       PathLength:             len(path),
+                       DroppedOutOfOrderTiles: skipped,
+               })
+
                totalPathLen += len(path)
        }
        log.Printf("%s tiled with total path len %d in %d sequences (skipped %d sequences with '_' in name, skipped %d out-of-order tags)", filelabel, totalPathLen, len(ret), skippedSequences, totalFoundTags-totalPathLen)
-       return ret, scanner.Err()
+       return ret, stats, scanner.Err()
 }
 
 func (tilelib *tileLibrary) Len() int {
@@ -154,7 +382,7 @@ func (tilelib *tileLibrary) getRef(tag tagID, seq []byte) tileLibRef {
                        if b != 'a' && b != 'c' && b != 'g' && b != 't' {
                                // return "tile not found" if seq has any
                                // no-calls
-                               return tileLibRef{tag: tag}
+                               return tileLibRef{Tag: tag}
                        }
                }
        }
@@ -162,21 +390,36 @@ func (tilelib *tileLibrary) getRef(tag tagID, seq []byte) tileLibRef {
        // if tilelib.seq == nil {
        //      tilelib.seq = map[[blake2b.Size]byte][]byte{}
        // }
-       if tilelib.variant == nil {
+       if tilelib.variant == nil && tilelib.taglib != nil {
                tilelib.variant = make([][][blake2b.Size256]byte, tilelib.taglib.Len())
        }
+       if int(tag) >= len(tilelib.variant) {
+               // If we haven't seen the tag library yet (as in a
+               // merge), tilelib.taglib.Len() is zero. We can still
+               // behave correctly, we just need to expand the
+               // tilelib.variant slice as needed.
+               if int(tag) >= cap(tilelib.variant) {
+                       // Allocate 2x capacity.
+                       newslice := make([][][blake2b.Size256]byte, int(tag)+1, (int(tag)+1)*2)
+                       copy(newslice, tilelib.variant)
+                       tilelib.variant = newslice[:int(tag)+1]
+               } else {
+                       // Use previously allocated capacity, avoiding
+                       // copy.
+                       tilelib.variant = tilelib.variant[:int(tag)+1]
+               }
+       }
        seqhash := blake2b.Sum256(seq)
        for i, varhash := range tilelib.variant[tag] {
                if varhash == seqhash {
                        tilelib.mtx.Unlock()
-                       return tileLibRef{tag: tag, variant: tileVariantID(i + 1)}
+                       return tileLibRef{Tag: tag, Variant: tileVariantID(i + 1)}
                }
        }
        tilelib.variants++
        tilelib.variant[tag] = append(tilelib.variant[tag], seqhash)
        // tilelib.seq[seqhash] = append([]byte(nil), seq...)
        variant := tileVariantID(len(tilelib.variant[tag]))
-       ret := tileLibRef{tag: tag, variant: variant}
        tilelib.mtx.Unlock()
 
        if tilelib.encoder != nil {
@@ -189,5 +432,15 @@ func (tilelib *tileLibrary) getRef(tag tagID, seq []byte) tileLibRef {
                        }},
                })
        }
-       return ret
+       return tileLibRef{Tag: tag, Variant: variant}
+}
+
+func countBases(seq []byte) int {
+       n := 0
+       for _, c := range seq {
+               if isbase[c] {
+                       n++
+               }
+       }
+       return n
 }