Troubleshooting

Updated: May-18-2026

This vignette provides troubleshooting tips for common issues encountered when using the MotifPeeker package.

If you encounter an issue that is not covered, please open an issue on the GitHub repository.

MEME Suite Related

1. Error: Cannot find MEME Suite
   If You have ensured that the MEME Suite is installed, but still encounter this error, set the path to the MEME suite binaries (.../meme/bin/) using the meme_path parameter in the MotifPeeker() function call.

2. Error: Failed to generate .html file.
   Please ensure that the Perl dependencies required by the MEME Suite are installed, particularly XML::Parser, which can be installed using the following command in the terminal:
   bash cpan install XML::Parser

MotifPeeker() Related

1. Function takes too long to run
   It is likely motif discovery is what is taking too long to run. Try reducing the number of workers if you are running out of memory while running the MotifPeeker() function.
   Additionally, follow the runtime guidance for MotifPeeker().

Session Info

utils::sessionInfo()

## R version 4.6.0 Patched (2026-05-01 r89994)
## Platform: aarch64-apple-darwin23
## Running under: macOS Tahoe 26.3.1
## 
## Matrix products: default
## BLAS:   /Library/Frameworks/R.framework/Versions/4.6/Resources/lib/libRblas.0.dylib 
## LAPACK: /Library/Frameworks/R.framework/Versions/4.6/Resources/lib/libRlapack.dylib;  LAPACK version 3.12.1
## 
## locale:
## [1] C/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
## 
## time zone: America/New_York
## tzcode source: internal
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] MotifPeeker_1.5.0
## 
## loaded via a namespace (and not attached):
##   [1] DBI_1.3.0                         bitops_1.0-9                     
##   [3] gridExtra_2.3                     httr2_1.2.2                      
##   [5] rlang_1.2.0                       magrittr_2.0.5                   
##   [7] otel_0.2.0                        matrixStats_1.5.0                
##   [9] compiler_4.6.0                    RSQLite_3.52.0                   
##  [11] vctrs_0.7.3                       pkgconfig_2.0.3                  
##  [13] crayon_1.5.3                      fastmap_1.2.0                    
##  [15] dbplyr_2.5.2                      XVector_0.53.0                   
##  [17] memes_1.21.0                      ca_0.71.1                        
##  [19] Rsamtools_2.29.0                  rmarkdown_2.31                   
##  [21] tzdb_0.5.0                        UCSC.utils_1.9.0                 
##  [23] purrr_1.2.2                       bit_4.6.0                        
##  [25] BSgenome.Hsapiens.UCSC.hg38_1.4.5 xfun_0.57                        
##  [27] cachem_1.1.0                      cigarillo_1.3.0                  
##  [29] GenomeInfoDb_1.49.0               jsonlite_2.0.0                   
##  [31] blob_1.3.0                        DelayedArray_0.39.2              
##  [33] BiocParallel_1.47.0               parallel_4.6.0                   
##  [35] R6_2.6.1                          bslib_0.11.0                     
##  [37] RColorBrewer_1.1-3                rtracklayer_1.73.0               
##  [39] GenomicRanges_1.65.0              jquerylib_0.1.4                  
##  [41] Rcpp_1.1.1-1.1                    Seqinfo_1.3.0                    
##  [43] assertthat_0.2.1                  SummarizedExperiment_1.43.0      
##  [45] iterators_1.0.14                  knitr_1.51                       
##  [47] readr_2.2.0                       IRanges_2.47.1                   
##  [49] BiocBaseUtils_1.15.1              Matrix_1.7-5                     
##  [51] tidyselect_1.2.1                  dichromat_2.0-0.1                
##  [53] abind_1.4-8                       yaml_2.3.12                      
##  [55] viridis_0.6.5                     TSP_1.2.7                        
##  [57] codetools_0.2-20                  curl_7.1.0                       
##  [59] lattice_0.22-9                    tibble_3.3.1                     
##  [61] Biobase_2.73.1                    S7_0.2.2                         
##  [63] evaluate_1.0.5                    heatmaply_1.6.0                  
##  [65] BiocFileCache_3.3.0               universalmotif_1.31.3            
##  [67] Biostrings_2.81.1                 pillar_1.11.1                    
##  [69] filelock_1.0.3                    MatrixGenerics_1.25.0            
##  [71] DT_0.34.0                         foreach_1.5.2                    
##  [73] stats4_4.6.0                      plotly_4.12.0                    
##  [75] generics_0.1.4                    RCurl_1.98-1.18                  
##  [77] S4Vectors_0.51.2                  hms_1.1.4                        
##  [79] ggplot2_4.0.3                     scales_1.4.0                     
##  [81] glue_1.8.1                        lazyeval_0.2.3                   
##  [83] tools_4.6.0                       dendextend_1.19.1                
##  [85] BiocIO_1.23.3                     data.table_1.18.4                
##  [87] BSgenome_1.81.0                   webshot_0.5.5                    
##  [89] GenomicAlignments_1.49.0          registry_0.5-1                   
##  [91] XML_3.99-0.23                     grid_4.6.0                       
##  [93] tidyr_1.3.2                       seriation_1.5.8                  
##  [95] restfulr_0.0.16                   cli_3.6.6                        
##  [97] rappdirs_0.3.4                    S4Arrays_1.13.0                  
##  [99] viridisLite_0.4.3                 dplyr_1.2.1                      
## [101] gtable_0.3.6                      sass_0.4.10                      
## [103] digest_0.6.39                     BiocGenerics_0.59.2              
## [105] SparseArray_1.13.2                rjson_0.2.23                     
## [107] htmlwidgets_1.6.4                 farver_2.1.2                     
## [109] memoise_2.0.1                     htmltools_0.5.9                  
## [111] lifecycle_1.0.5                   httr_1.4.8                       
## [113] MASS_7.3-65                       bit64_4.8.0