Dataset

The mutation dataset should include two columns containing the chromosome and genomic position of each mutation. The columns should be named “chr” and “pos” respectively. Optionally, the gene names for each mutation may be included under a column named “gene”.

data("mutation_data")
head(mutation_data)
#>    chr       pos gene
#> 22   4 126329603 FAT4
#> 23   4 126329653 FAT4
#> 24   4 126329608 FAT4
#> 25   4 126329651 FAT4
#> 26   4 126329633 FAT4
#> 27   4 126329653 FAT4

amp_pool

This algorithm searches the mutational dataset (input) for mutational hotspot regions on each chromosome:

1. Starting at the mutation with the lowest chromosomal position (primary mutation), using a modified rank and recovery system, the algorithm searches for the closest neighboring mutation.
2. If the neighboring mutation is less than one amplicon, in distance, away from the primary mutation, the neighboring mutation is included within the hotspot region. -This rank and recovery system is repeated, integrating mutations into the hotspot region until the neighboring mutation is greater than or equal to the length of one amplicon in distance, from the primary mutation. -Once neighboring mutations equal or exceed one amplicon in distance from the primary mutation, incorporation into the hotspot region, halts incorporation.
3. For hotspots within the one amplicon range, from the lowest to highest mutation location, this area is covered by a single amplicon and added to an amplicon pool, with a unique ID. -The center of these single amplicons is then defined by the weighted distribution of mutations.
4. For all hotspots larger than one amplicon, the algorithm examines 5 potential amplicons at each covered mutation in the hotspot: -one amplicon directly upstream of the primary mutation -one amplicon directly downstream of the primary mutation -one amplicon including the mutation at the end of the read and base pairs (amplicon length - 1) upstream -one amplicon including the mutation at the beginning of the read and base pairs (amplicon length - 1) downstream -one amplicon with the mutation directly in the center.
5. All amplicons generated for each hotspot region of interest, are assigned a unique ID and added to the amplicon pool.

amps <- amp_pool(data = mutation_data, amp = 100)
head(amps)
#>   lowerbound upperbound chromosome count id mut_lowerbound mut_upperbound
#> 1    1803511    1803610          4    17  x        1803553        1803564
#> 2    1806007    1806106          4    11  x        1806047        1806066
#> 3    1808912    1809011          4     6  x        1808958        1808970
#> 4  126329597  126329696          4    34  x      126329601      126329700
#> 5    7577035    7577134         17    10  x        7577058        7577127
#> 6    7577498    7577597         17    38  x        7577537        7577569

fw_hotspot

1. Amplicons covering hotspots less than or equal to one amplicon in length, are added to the final sequencing panel dataset.
2. For amplicons covering larger hotspot regions, the algorithm uses a forward selection method to determine the optimal combination of amplicons to use in the sequencing panel: -the algorithm first identifies the amplicon containing the highest number of mutations -the algorithm then identifies the next amplicon, which contains the highest number of new mutations. -this process continues until all mutations are covered by at least one amplicon
3. Each of these amplicons are then added to the final sequencing panel, with their own unique IDs.
4. All amplicons in the final sequencing panel are ranked from highest to lowest based on the number of mutations they cover.
5. The algorithm then calculates the cumulative base-pair length and the cumulative mutations covered by each amplicon.
6. Dependent on the desired length of the targeted panel, a cutoff may be applied to remove all amplicons which fall below a set cumulative length.

fw_bins <- fw_hotspot(bins = amps, data = mutation_data, amp = 100, len = 1000, include_genes = TRUE)
head(fw_bins)
#>     Lowerbound Upperbound Chromosome Mutation Count Cumulative Panel Length
#> 6      7577498    7577597         17             38                     100
#> 4    126329597  126329696          4             34                     200
#> 1      1803511    1803610          4             17                     300
#> 102  120512189  120512288          1             13                     400
#> 2      1806007    1806106          4             11                     500
#> 5      7577035    7577134         17             10                     600
#>     Cumulative Mutations   Gene
#> 6                     38   TP53
#> 4                     72   FAT4
#> 1                     89  FGFR3
#> 102                  102 NOTCH2
#> 2                    113  FGFR3
#> 5                    123   TP53

com_hotspot

1. To conserve computational power, the forward selection sequencing panel identifier is run to determine the lowest number of mutations per amplicon (mutation frequency) that need to be included in the predetermined length sequencing panel. -any amplicon generated by the algorithm, which is less than this threshold value, will be removed.
2. For the feasible exhaustive selection of amplicon combinations covering hotspot areas larger than the predefined number of amplicons in length, the algorithm breaks these large regions into multiple smaller regions. -the amplicons covering these regions are pulled from the amplicon pool, based on their unique IDs.
3. The algorithm finds both the minimum number of amplicons overlap and all positions with this value and identifies the region with the longest continuous spot of minimum value. -the region is split at the center of this longest continuous minimum post values and continues the splitting process until all smaller regions are less than the “n” number amplicon length set by the user. -As this set number of amplicons decreases, the computation time required also often decreases.
4. All amplicons contained in these bins are added back to the amplicon pool, based on a new unique ID.
5. Amplicons covering hotspots less than or equal to one amplicon length are added to the final sequencing panel dataset.
6. To determine the optimal combination of amplicons for each region, the number of amplicons necessary for full coverage of the bin is calculated.
7. A list is generated of every possible combination of n, number of amplicons, needed. For each combination of amplicons: -amplicons that would not meet the threshold of unique mutations are filtered out, and the number of all mutations captured by these amplicons is calculated. -the combination of amplicons that yields the highest number of mutations is added to the final sequencing panel.
8. All amplicons in the final sequencing panel are ranked from highest to lowest based on the number of mutations they cover.
9. All amplicons capturing the number of mutations equal to the cutoff are further ranked to favor amplicons that have mutations closer in location to the center of the amplicon.
10. Cumulative base-pair length and cumulative mutations covered by each amplicon are calculated. -Depending on the desired length of the targeted panel, a cutoff may be applied to remove all amplicons which fall below a set cumulative length.

com_bins <- com_hotspot(fw_panel = fw_bins, bins = amps, data = mutation_data, 
                        amp = 100, len = 1000, size = 3, include_genes = TRUE)
head(com_bins)
#>    Lowerbound Upperbound Chromosome Mutation Count Cumulative Panel Length
#> 6     7577498    7577597         17             38                     100
#> 4   126329597  126329696          4             34                     200
#> 1     1803511    1803610          4             17                     300
#> 2     1806007    1806106          4             11                     400
#> 5     7577035    7577134         17             10                     500
#> 47  120497611  120497710          1              8                     600
#>    Cumulative Mutations   Gene
#> 6                    38   TP53
#> 4                    72   FAT4
#> 1                    89  FGFR3
#> 2                   100  FGFR3
#> 5                   110   TP53
#> 47                  118 NOTCH2

sessionInfo()
#> R version 4.4.1 (2024-06-14)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.1 LTS
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so;  LAPACK version 3.12.0
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=C              
#>  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
#>  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
#>  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
#> 
#> time zone: Etc/UTC
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] seq.hotSPOT_1.7.0 BiocStyle_2.35.0 
#> 
#> loaded via a namespace (and not attached):
#>  [1] hash_2.2.6.3        digest_0.6.37       R6_2.5.1           
#>  [4] fastmap_1.2.0       xfun_0.48           maketools_1.3.1    
#>  [7] cachem_1.1.0        R.utils_2.12.3      knitr_1.48         
#> [10] htmltools_0.5.8.1   rmarkdown_2.28      buildtools_1.0.0   
#> [13] lifecycle_1.0.4     cli_3.6.3           R.methodsS3_1.8.2  
#> [16] sass_0.4.9          jquerylib_0.1.4     compiler_4.4.1     
#> [19] R.oo_1.26.0         sys_3.4.3           tools_4.4.1        
#> [22] evaluate_1.0.1      bslib_0.8.0         yaml_2.3.10        
#> [25] BiocManager_1.30.25 jsonlite_1.8.9      rlang_1.1.4