1 // Copyright (C) The Lightning Authors. All rights reserved.
3 // SPDX-License-Identifier: AGPL-3.0
22 "github.com/klauspost/pgzip"
23 log "github.com/sirupsen/logrus"
24 "golang.org/x/crypto/blake2b"
27 type tileVariantID uint16 // 1-based
29 type tileLibRef struct {
34 type tileSeq map[string][]tileLibRef
36 func (tseq tileSeq) Variants() ([]tileVariantID, int, int) {
38 for _, refs := range tseq {
39 for _, ref := range refs {
40 if maxtag < int(ref.Tag) {
45 vars := make([]tileVariantID, maxtag+1)
47 for _, refs := range tseq {
48 for _, ref := range refs {
49 if vars[int(ref.Tag)] != 0 {
54 vars[int(ref.Tag)] = ref.Variant
57 return vars, kept, dropped
60 type tileLibrary struct {
63 retainTileSequences bool
67 variant [][][blake2b.Size256]byte
68 refseqs map[string]map[string][]tileLibRef
69 compactGenomes map[string][]tileVariantID
70 seq2 map[[2]byte]map[[blake2b.Size256]byte][]byte
71 seq2lock map[[2]byte]sync.Locker
73 // if non-nil, write out any tile variants added while tiling
75 // set Ref flag when writing new variants to encoder
78 onAddTileVariant func(libref tileLibRef, hash [blake2b.Size256]byte, seq []byte) error
79 onAddGenome func(CompactGenome) error
80 onAddRefseq func(CompactSequence) error
86 func (tilelib *tileLibrary) loadTagSet(newtagset [][]byte) error {
87 // Loading a tagset means either passing it through to the
88 // output (if it's the first one we've seen), or just ensuring
89 // it doesn't disagree with what we already have.
90 if len(newtagset) == 0 {
94 defer tilelib.mtx.Unlock()
95 if tilelib.taglib == nil || tilelib.taglib.Len() == 0 {
96 tilelib.taglib = &tagLibrary{}
97 err := tilelib.taglib.setTags(newtagset)
101 if tilelib.encoder != nil {
102 err = tilelib.encoder.Encode(LibraryEntry{
109 } else if tilelib.taglib.Len() != len(newtagset) {
110 return fmt.Errorf("cannot merge libraries with differing tagsets")
112 current := tilelib.taglib.Tags()
113 for i := range newtagset {
114 if !bytes.Equal(newtagset[i], current[i]) {
115 return fmt.Errorf("cannot merge libraries with differing tagsets")
122 func (tilelib *tileLibrary) loadTileVariants(tvs []TileVariant, variantmap map[tileLibRef]tileVariantID) error {
123 for _, tv := range tvs {
124 // Assign a new variant ID (unique across all inputs)
125 // for each input variant.
126 variantmap[tileLibRef{Tag: tv.Tag, Variant: tv.Variant}] = tilelib.getRef(tv.Tag, tv.Sequence, tv.Ref).Variant
131 func (tilelib *tileLibrary) loadCompactGenomes(cgs []CompactGenome, variantmap map[tileLibRef]tileVariantID) error {
132 log.Debugf("loadCompactGenomes: %d", len(cgs))
133 var wg sync.WaitGroup
134 errs := make(chan error, 1)
135 for _, cg := range cgs {
140 for i, variant := range cg.Variants {
148 newvariant, ok := variantmap[tileLibRef{Tag: tag, Variant: variant}]
150 err := fmt.Errorf("oops: genome %q has variant %d for tag %d, but that variant was not in its library", cg.Name, variant, tag)
157 // log.Tracef("loadCompactGenomes: cg %s tag %d variant %d => %d", cg.Name, tag, variant, newvariant)
158 cg.Variants[i] = newvariant
160 if tilelib.onAddGenome != nil {
161 err := tilelib.onAddGenome(cg)
170 if tilelib.encoder != nil {
171 err := tilelib.encoder.Encode(LibraryEntry{
172 CompactGenomes: []CompactGenome{cg},
182 if tilelib.compactGenomes != nil {
184 defer tilelib.mtx.Unlock()
185 tilelib.compactGenomes[cg.Name] = cg.Variants
194 func (tilelib *tileLibrary) loadCompactSequences(cseqs []CompactSequence, variantmap map[tileLibRef]tileVariantID) error {
195 log.Infof("loadCompactSequences: %d todo", len(cseqs))
196 for _, cseq := range cseqs {
197 log.Infof("loadCompactSequences: checking %s", cseq.Name)
198 for _, tseq := range cseq.TileSequences {
199 for i, libref := range tseq {
200 if libref.Variant == 0 {
201 // No variant (e.g., import
202 // dropped tiles with
203 // no-calls) = no translation.
206 v, ok := variantmap[libref]
208 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)
213 if tilelib.encoder != nil {
214 if err := tilelib.encoder.Encode(LibraryEntry{
215 CompactSequences: []CompactSequence{cseq},
220 if tilelib.onAddRefseq != nil {
221 err := tilelib.onAddRefseq(cseq)
226 log.Infof("loadCompactSequences: checking %s done", cseq.Name)
229 defer tilelib.mtx.Unlock()
230 if tilelib.refseqs == nil {
231 tilelib.refseqs = map[string]map[string][]tileLibRef{}
233 for _, cseq := range cseqs {
234 tilelib.refseqs[cseq.Name] = cseq.TileSequences
236 log.Info("loadCompactSequences: done")
240 func allFiles(path string, re *regexp.Regexp) ([]string, error) {
247 fis, err := f.Readdir(-1)
249 return []string{path}, nil
251 for _, fi := range fis {
252 if fi.Name() == "." || fi.Name() == ".." {
254 } else if child := path + "/" + fi.Name(); fi.IsDir() {
255 add, err := allFiles(child, re)
259 files = append(files, add...)
260 } else if re == nil || re.MatchString(child) {
261 files = append(files, child)
268 var matchGobFile = regexp.MustCompile(`\.gob(\.gz)?$`)
270 func (tilelib *tileLibrary) LoadDir(ctx context.Context, path string) error {
271 log.Infof("LoadDir: walk dir %s", path)
272 files, err := allFiles(path, matchGobFile)
276 ctx, cancel := context.WithCancel(ctx)
279 allcgs := make([][]CompactGenome, len(files))
280 allcseqs := make([][]CompactSequence, len(files))
281 allvariantmap := map[tileLibRef]tileVariantID{}
282 errs := make(chan error, len(files))
283 log.Infof("LoadDir: read %d files", len(files))
284 for fileno, path := range files {
285 fileno, path := fileno, path
293 defer log.Infof("LoadDir: finished reading %s", path)
295 var variantmap = map[tileLibRef]tileVariantID{}
296 var cgs []CompactGenome
297 var cseqs []CompactSequence
298 err = DecodeLibrary(f, strings.HasSuffix(path, ".gz"), func(ent *LibraryEntry) error {
299 if ctx.Err() != nil {
302 if len(ent.TagSet) > 0 {
304 if tilelib.taglib == nil || tilelib.taglib.Len() != len(ent.TagSet) {
305 // load first set of tags, or
306 // report mismatch if 2 sets
307 // have different #tags.
308 if err := tilelib.loadTagSet(ent.TagSet); err != nil {
315 for _, tv := range ent.TileVariants {
316 variantmap[tileLibRef{Tag: tv.Tag, Variant: tv.Variant}] = tilelib.getRef(tv.Tag, tv.Sequence, tv.Ref).Variant
318 cgs = append(cgs, ent.CompactGenomes...)
319 cseqs = append(cseqs, ent.CompactSequences...)
323 allcseqs[fileno] = cseqs
326 for k, v := range variantmap {
339 log.Info("LoadDir: loadCompactGenomes")
340 var flatcgs []CompactGenome
341 for _, cgs := range allcgs {
342 flatcgs = append(flatcgs, cgs...)
344 err = tilelib.loadCompactGenomes(flatcgs, allvariantmap)
349 log.Info("LoadDir: loadCompactSequences")
350 var flatcseqs []CompactSequence
351 for _, cseqs := range allcseqs {
352 flatcseqs = append(flatcseqs, cseqs...)
354 err = tilelib.loadCompactSequences(flatcseqs, allvariantmap)
359 log.Info("LoadDir done")
363 func (tilelib *tileLibrary) WriteDir(dir string) error {
365 nfiles := ntilefiles + len(tilelib.refseqs)
366 files := make([]*os.File, nfiles)
367 for i := range files {
368 f, err := os.OpenFile(fmt.Sprintf("%s/library.%04d.gob.gz", dir, i), os.O_CREATE|os.O_WRONLY, 0666)
375 bufws := make([]*bufio.Writer, nfiles)
376 for i := range bufws {
377 bufws[i] = bufio.NewWriterSize(files[i], 1<<26)
379 zws := make([]*pgzip.Writer, nfiles)
381 zws[i] = pgzip.NewWriter(bufws[i])
384 encoders := make([]*gob.Encoder, nfiles)
385 for i := range encoders {
386 encoders[i] = gob.NewEncoder(zws[i])
389 cgnames := make([]string, 0, len(tilelib.compactGenomes))
390 for name := range tilelib.compactGenomes {
391 cgnames = append(cgnames, name)
393 sort.Strings(cgnames)
395 refnames := make([]string, 0, len(tilelib.refseqs))
396 for name := range tilelib.refseqs {
397 refnames = append(refnames, name)
399 sort.Strings(refnames)
401 log.Infof("WriteDir: writing %d files", nfiles)
402 ctx, cancel := context.WithCancel(context.Background())
404 errs := make(chan error, nfiles)
405 for start := range files {
408 err := encoders[start].Encode(LibraryEntry{TagSet: tilelib.taglib.Tags()})
413 if refidx := start - ntilefiles; refidx >= 0 {
414 // write each ref to its own file
415 // (they seem to load very slowly)
416 name := refnames[refidx]
417 errs <- encoders[start].Encode(LibraryEntry{CompactSequences: []CompactSequence{{
419 TileSequences: tilelib.refseqs[name],
423 for i := start; i < len(cgnames); i += ntilefiles {
424 err := encoders[start].Encode(LibraryEntry{CompactGenomes: []CompactGenome{{
426 Variants: tilelib.compactGenomes[cgnames[i]],
433 tvs := []TileVariant{}
434 for tag := start; tag < len(tilelib.variant) && ctx.Err() == nil; tag += ntilefiles {
436 for idx, hash := range tilelib.variant[tag] {
437 tvs = append(tvs, TileVariant{
439 Variant: tileVariantID(idx + 1),
441 Sequence: tilelib.hashSequence(hash),
444 err := encoders[start].Encode(LibraryEntry{TileVariants: tvs})
459 log.Info("WriteDir: flushing")
461 err := zws[i].Close()
465 err = bufws[i].Flush()
469 err = files[i].Close()
474 log.Info("WriteDir: done")
478 // Load library data from rdr. Tile variants might be renumbered in
479 // the process; in that case, genomes variants will be renumbered to
481 func (tilelib *tileLibrary) LoadGob(ctx context.Context, rdr io.Reader, gz bool) error {
482 cgs := []CompactGenome{}
483 cseqs := []CompactSequence{}
484 variantmap := map[tileLibRef]tileVariantID{}
485 err := DecodeLibrary(rdr, gz, func(ent *LibraryEntry) error {
486 if ctx.Err() != nil {
489 if err := tilelib.loadTagSet(ent.TagSet); err != nil {
492 if err := tilelib.loadTileVariants(ent.TileVariants, variantmap); err != nil {
495 cgs = append(cgs, ent.CompactGenomes...)
496 cseqs = append(cseqs, ent.CompactSequences...)
502 if ctx.Err() != nil {
505 err = tilelib.loadCompactGenomes(cgs, variantmap)
509 err = tilelib.loadCompactSequences(cseqs, variantmap)
516 func (tilelib *tileLibrary) dump(out io.Writer) {
517 printTV := func(tag int, variant tileVariantID) {
519 fmt.Fprintf(out, " -")
520 } else if tag >= len(tilelib.variant) {
521 fmt.Fprintf(out, " (!tag=%d)", tag)
522 } else if int(variant) > len(tilelib.variant[tag]) {
523 fmt.Fprintf(out, " (tag=%d,!variant=%d)", tag, variant)
525 fmt.Fprintf(out, " %x", tilelib.variant[tag][variant-1][:8])
528 for refname, refseqs := range tilelib.refseqs {
529 for seqname, seq := range refseqs {
530 fmt.Fprintf(out, "ref %s %s", refname, seqname)
531 for _, libref := range seq {
532 printTV(int(libref.Tag), libref.Variant)
534 fmt.Fprintf(out, "\n")
537 for name, cg := range tilelib.compactGenomes {
538 fmt.Fprintf(out, "cg %s", name)
539 for tag, variant := range cg {
540 printTV(tag/2, variant)
542 fmt.Fprintf(out, "\n")
546 type importStats struct {
552 DroppedRepeatedTags int
553 DroppedOutOfOrderTags int
556 func (tilelib *tileLibrary) TileFasta(filelabel string, rdr io.Reader, matchChromosome *regexp.Regexp, isRef bool) (tileSeq, []importStats, error) {
562 todo := make(chan jobT, 1)
563 scanner := bufio.NewScanner(rdr)
564 scanner.Buffer(make([]byte, 256), 1<<29) // 512 MiB, in case fasta does not have line breaks
570 buf := scanner.Bytes()
571 if len(buf) > 0 && buf[0] == '>' {
572 todo <- jobT{seqlabel, append([]byte(nil), fasta...)}
573 seqlabel, fasta = strings.SplitN(string(buf[1:]), " ", 2)[0], fasta[:0]
574 log.Debugf("%s %s reading fasta", filelabel, seqlabel)
575 } else if len(buf) > 0 && buf[0] == '#' {
576 // ignore testdata comment
578 fasta = append(fasta, bytes.ToLower(buf)...)
581 todo <- jobT{seqlabel, fasta}
583 type foundtag struct {
587 found := make([]foundtag, 2000000)
588 path := make([]tileLibRef, 2000000)
591 skippedSequences := 0
592 taglen := tilelib.taglib.TagLen()
593 var stats []importStats
594 for job := range todo {
595 if len(job.fasta) == 0 {
597 } else if !matchChromosome.MatchString(job.label) {
601 log.Debugf("%s %s tiling", filelabel, job.label)
604 tilelib.taglib.FindAll(job.fasta, func(tagid tagID, pos, taglen int) {
605 found = append(found, foundtag{pos: pos, tagid: tagid})
607 totalFoundTags += len(found)
609 log.Warnf("%s %s no tags found", filelabel, job.label)
613 if !tilelib.useDups {
614 // Remove any tags that appeared more than once
615 dup := map[tagID]bool{}
616 for _, ft := range found {
617 _, dup[ft.tagid] = dup[ft.tagid]
620 for _, ft := range found {
626 droppedDup = len(found) - dst
627 log.Infof("%s %s dropping %d non-unique tags", filelabel, job.label, droppedDup)
633 keep := longestIncreasingSubsequence(len(found), func(i int) int { return int(found[i].tagid) })
634 for i, x := range keep {
637 droppedOOO = len(found) - len(keep)
638 log.Infof("%s %s dropping %d out-of-order tags", filelabel, job.label, droppedOOO)
639 found = found[:len(keep)]
642 log.Infof("%s %s getting %d librefs", filelabel, job.label, len(found))
643 throttle := &throttle{Max: runtime.NumCPU()}
644 path = path[:len(found)]
646 for i, f := range found {
650 defer throttle.Release()
651 var startpos, endpos int
657 if i == len(found)-1 {
658 endpos = len(job.fasta)
660 endpos = found[i+1].pos + taglen
662 path[i] = tilelib.getRef(f.tagid, job.fasta[startpos:endpos], isRef)
663 if countBases(job.fasta[startpos:endpos]) != endpos-startpos {
664 atomic.AddInt64(&lowquality, 1)
670 log.Infof("%s %s copying path", filelabel, job.label)
672 pathcopy := make([]tileLibRef, len(path))
674 ret[job.label] = pathcopy
676 basesIn := countBases(job.fasta)
677 log.Infof("%s %s fasta in %d coverage in %d path len %d low-quality %d", filelabel, job.label, len(job.fasta), basesIn, len(path), lowquality)
678 stats = append(stats, importStats{
679 InputFile: filelabel,
680 InputLabel: job.label,
681 InputLength: len(job.fasta),
682 InputCoverage: basesIn,
683 PathLength: len(path),
684 DroppedOutOfOrderTags: droppedOOO,
685 DroppedRepeatedTags: droppedDup,
688 totalPathLen += len(path)
690 log.Printf("%s tiled with total path len %d in %d sequences (skipped %d sequences that did not match chromosome regexp, skipped %d out-of-order tags)", filelabel, totalPathLen, len(ret), skippedSequences, totalFoundTags-totalPathLen)
691 return ret, stats, scanner.Err()
694 func (tilelib *tileLibrary) Len() int64 {
695 return atomic.LoadInt64(&tilelib.variants)
698 // Return a tileLibRef for a tile with the given tag and sequence,
699 // adding the sequence to the library if needed.
700 func (tilelib *tileLibrary) getRef(tag tagID, seq []byte, usedByRef bool) tileLibRef {
702 if !tilelib.retainNoCalls {
703 for _, b := range seq {
704 if b != 'a' && b != 'c' && b != 'g' && b != 't' {
710 seqhash := blake2b.Sum256(seq)
711 var vlock sync.Locker
714 if len(tilelib.vlock) > int(tag) {
715 vlock = tilelib.vlock[tag]
717 tilelib.mtx.RUnlock()
721 for i, varhash := range tilelib.variant[tag] {
722 if varhash == seqhash {
724 return tileLibRef{Tag: tag, Variant: tileVariantID(i + 1)}
730 if tilelib.variant == nil && tilelib.taglib != nil {
731 tilelib.variant = make([][][blake2b.Size256]byte, tilelib.taglib.Len())
732 tilelib.vlock = make([]sync.Locker, tilelib.taglib.Len())
733 for i := range tilelib.vlock {
734 tilelib.vlock[i] = new(sync.Mutex)
737 if int(tag) >= len(tilelib.variant) {
738 oldlen := len(tilelib.vlock)
739 for i := 0; i < oldlen; i++ {
740 tilelib.vlock[i].Lock()
742 // If we haven't seen the tag library yet (as
743 // in a merge), tilelib.taglib.Len() is
744 // zero. We can still behave correctly, we
745 // just need to expand the tilelib.variant and
746 // tilelib.vlock slices as needed.
747 if int(tag) >= cap(tilelib.variant) {
748 // Allocate 2x capacity.
749 newslice := make([][][blake2b.Size256]byte, int(tag)+1, (int(tag)+1)*2)
750 copy(newslice, tilelib.variant)
751 tilelib.variant = newslice[:int(tag)+1]
752 newvlock := make([]sync.Locker, int(tag)+1, (int(tag)+1)*2)
753 copy(newvlock, tilelib.vlock)
754 tilelib.vlock = newvlock[:int(tag)+1]
756 // Use previously allocated capacity,
758 tilelib.variant = tilelib.variant[:int(tag)+1]
759 tilelib.vlock = tilelib.vlock[:int(tag)+1]
761 for i := oldlen; i < len(tilelib.vlock); i++ {
762 tilelib.vlock[i] = new(sync.Mutex)
764 for i := 0; i < oldlen; i++ {
765 tilelib.vlock[i].Unlock()
768 vlock = tilelib.vlock[tag]
773 for i, varhash := range tilelib.variant[tag] {
774 if varhash == seqhash {
776 return tileLibRef{Tag: tag, Variant: tileVariantID(i + 1)}
779 atomic.AddInt64(&tilelib.variants, 1)
780 tilelib.variant[tag] = append(tilelib.variant[tag], seqhash)
781 variant := tileVariantID(len(tilelib.variant[tag]))
784 if tilelib.retainTileSequences && !dropSeq {
785 seqCopy := append([]byte(nil), seq...)
786 if tilelib.seq2 == nil {
788 if tilelib.seq2 == nil {
789 tilelib.seq2lock = map[[2]byte]sync.Locker{}
790 m := map[[2]byte]map[[blake2b.Size256]byte][]byte{}
792 for i := 0; i < 256; i++ {
794 for j := 0; j < 256; j++ {
796 m[k] = map[[blake2b.Size256]byte][]byte{}
797 tilelib.seq2lock[k] = &sync.Mutex{}
805 copy(k[:], seqhash[:])
806 locker := tilelib.seq2lock[k]
808 tilelib.seq2[k][seqhash] = seqCopy
814 // Save the hash, but not the sequence
817 if tilelib.encoder != nil {
818 tilelib.encoder.Encode(LibraryEntry{
819 TileVariants: []TileVariant{{
828 if tilelib.onAddTileVariant != nil {
829 tilelib.onAddTileVariant(tileLibRef{tag, variant}, seqhash, saveSeq)
831 return tileLibRef{Tag: tag, Variant: variant}
834 func (tilelib *tileLibrary) hashSequence(hash [blake2b.Size256]byte) []byte {
835 var partition [2]byte
836 copy(partition[:], hash[:])
837 return tilelib.seq2[partition][hash]
840 func (tilelib *tileLibrary) TileVariantSequence(libref tileLibRef) []byte {
841 if libref.Variant == 0 || len(tilelib.variant) <= int(libref.Tag) || len(tilelib.variant[libref.Tag]) < int(libref.Variant) {
844 return tilelib.hashSequence(tilelib.variant[libref.Tag][libref.Variant-1])
847 // Tidy deletes unreferenced tile variants and renumbers variants so
848 // more common variants have smaller IDs.
849 func (tilelib *tileLibrary) Tidy() {
850 log.Print("Tidy: compute inref")
851 inref := map[tileLibRef]bool{}
852 for _, refseq := range tilelib.refseqs {
853 for _, librefs := range refseq {
854 for _, libref := range librefs {
859 log.Print("Tidy: compute remap")
860 remap := make([][]tileVariantID, len(tilelib.variant))
861 throttle := throttle{Max: runtime.NumCPU() + 1}
862 for tag, oldvariants := range tilelib.variant {
863 tag, oldvariants := tagID(tag), oldvariants
864 if tag%1000000 == 0 {
865 log.Printf("Tidy: tag %d", tag)
869 defer throttle.Release()
870 uses := make([]int, len(oldvariants))
871 for _, cg := range tilelib.compactGenomes {
872 for phase := 0; phase < 2; phase++ {
873 cgi := int(tag)*2 + phase
874 if cgi < len(cg) && cg[cgi] > 0 {
880 // Compute desired order of variants:
881 // neworder[x] == index in oldvariants that
882 // should move to position x.
883 neworder := make([]int, len(oldvariants))
884 for i := range neworder {
887 sort.Slice(neworder, func(i, j int) bool {
888 if cmp := uses[neworder[i]] - uses[neworder[j]]; cmp != 0 {
891 return bytes.Compare(oldvariants[neworder[i]][:], oldvariants[neworder[j]][:]) < 0
895 // Replace tilelib.variant[tag] with a new
896 // re-ordered slice of hashes, and make a
897 // mapping from old to new variant IDs.
898 remaptag := make([]tileVariantID, len(oldvariants)+1)
899 newvariants := make([][blake2b.Size256]byte, 0, len(neworder))
900 for _, oldi := range neworder {
901 if uses[oldi] > 0 || inref[tileLibRef{Tag: tag, Variant: tileVariantID(oldi + 1)}] {
902 newvariants = append(newvariants, oldvariants[oldi])
903 remaptag[oldi+1] = tileVariantID(len(newvariants))
906 tilelib.variant[tag] = newvariants
907 remap[tag] = remaptag
912 // Apply remap to genomes and reference sequences, so they
913 // refer to the same tile variants using the changed IDs.
914 log.Print("Tidy: apply remap")
915 var wg sync.WaitGroup
916 for _, cg := range tilelib.compactGenomes {
921 for idx, variant := range cg {
922 cg[idx] = remap[tagID(idx/2)][variant]
926 for _, refcs := range tilelib.refseqs {
927 for _, refseq := range refcs {
932 for i, tv := range refseq {
933 refseq[i].Variant = remap[tv.Tag][tv.Variant]
939 log.Print("Tidy: done")
942 func countBases(seq []byte) int {
944 for _, c := range seq {