Maintainer: Ji-Ping Wang, <>

References for methods:

  1. Wang, J.-P., Fondufe-Mittendorf, Y., Xi, L., Tsai, G.-F., Segal, E., and Widom, J. (2008). Preferentially quantized linker {DNA} lengths in Saccharomyces cerevisiae. PLoS Computational Biology, 4(9):e1000175.
  2. Xi, L., Fondufe-Mittendorf, Y., Xia, L., Flatow, J., Widom, J., and Wang, J.-P. (2010). Predicting nucleosome positioning using a duration hidden markov model. BMC Bioinformatics, pages doi:10.1186/1471--2105--11--346.
  3. Xi, L., Brogaard,K., Zhang, Q., Lindsay, B.G., Widom, and Wang, J.-P., A locally convoluted cluster model for nucleosome positioning signals in chemical map, Journal of American Statistical Association, 2013, 109(505) 48-62

References for chemical map data used:

  1. Brogaard, K., Xi, L., Wang, J.-P. and Widom, J. (2012), A base pair resolution map of nucleosome positions in yeast, Nature, 2012, 486: 496–501
  2. Moyle-Heyrman, G., Zaichuk, T., Xi, L., Zhang, Q., Uhlenbeck, O.C., Holmgren, R., Widom, J. and Wang, J.-P., Chemical map of Schizosaccharomyces pombe reveals species-specific features in nucleosome positioning, PNAS , 2013,110(50),20158-20163
  3. Voong, L.N, Xi, L., Sebeson, A.C., Xiong, B., Wang, J.-P., Wang, X. Insights into Nucleosome Organization in Mouse Embryonic Stem Cells through Chemical Mapping , Cell, 2016, 167(6),1555-1570.e15

NuPoP versions hightlights

  1. NuPoP V2.5 added adjustments of linker length distribution.

  2. NuPoP V2.0 added a funciton predNuPoP_chem for prediction of nucleosomes using profiles trained based on chemical maps of nucleosomes for yeast, pombe, mouse and human (profiles for other species are extrapolated based on yeast profile). To show a clear improvement, Figure: MNase_vs_Chemicale below compares the prediction based on MNase profile vs chemical profile for yeast where the red curve super-imposed is the occupancy from the chemical map for yeast data.

  3. A report of performance comparison of NuPoP (V2.0) vs nuCpos (V1.14) can be found at https://github.com/jipingw/NuPoP_doc


******************** ## About NuPoP

NuPoP is an R package for Nucleosome Positioning Prediction. NuPoP is built upon a duration hidden Markov model, in which the linker DNA length is explicitly modeled. The nucleosome or linker DNA state model can be chosen as either a fourth order or first order Markov chain. NuPoP outputs the Viterbi prediction of optimal nucleosome position map, nucleosome occupancy score (from backward and forward algorithms) and nucleosome affinity score.

In addition to the R package, we also developed a stand-alone Fortran program available at https://github.com/jipingw/NuPoP_Fortran. NuPoP R package and the Fortran program can predict nucleosome positioning for a DNA sequence of any length.

NuPoP functions

NuPoP does not depend on any other R packages. It has four major functions, predNuPoP, predNuPoP_chem, readNuPoP, and plotNuPoP. The predNuPoP function predicts the nucleosome positioning and nucleosome occupancy using MNase data trained nucleosome profiles while predNuPoP_chem predicts using profiles trained based on chemical maps. the readNuPoP function reads in the prediction results, and the function plotNuPoP visualizes the predictions.

library(NuPoP)

The predNuPoP and predNuPoP_chem call a Fortran subroutine to process the DNA sequence and make predictions, and outputs the predictions into a text file into the current working directory. This method is based on a duration Hidden Markov model consisting of two states, one for the nucleosome and the other for the linker state. For each state, a first order Markov chain and a fourth order Markov chain models are built in. For example, a sample DNA sequence is test.seq located in inst/extdata subdirectory of the package. Call the predNuPoP function as follows:

predNuPoP(system.file("extdata", "test.seq", package="NuPoP"),species=7,model=4)

Note that the argument file must be specified as the complete path and file name of the DNA sequence in FASTA format in any directory. For example, if the “test.seq” file is located in /Users/jon/DNA, the function can be called by

predNuPoP(file="/Users/jon/DNA/test.seq",species=7,model=4)

or for chemical map prediction:

predNuPoP_chem(file="/Users/jon/DNA/test.seq",species=7,model=4)

The user should not use file="~/DNA/test.seq" to speficify the path to avoid error messages. The argument species can be specified as follows: 1 = Human; 2 = Mouse; 3 = Rat; 4 = Zebrafish; 5 = D. melanogaster; 6 = C. elegans; 7 = S. cerevisiae; 8 = C. albicans; 9 = S. pombe; 10 = A. thaliana; 11 = Maize; 0 = other. If species = 0 is specified, the algorithm will identify a species from 1-11 that has most similar base composition to the input sequence, and use the models from the selected species for prediction. The default value is 7. The argument model can be either 1 or 4, standing for the order of Markov chain models used for the nucleosome and linker states.

For predNuPoP_chem, only species 1 (human), 2 (mouse), 7 (yeast), 9(S.pombe) are using actual profiles trained from chemical maps of corresponding species. For other species, there are no chemical map data available. Extrapolated profiles based on yeast data with adjustment for base composition are used.

The output file, generated in the current working directory, will be named after the sequence file name, with an added extension as _Prediction1.txt or _Prediction4.txt. For the above codes, the output file will be test.seq_Prediction4.txt. Note that predNuPoP_chem and predNuPoP do not distinguish the output names. The five columns in the output file are

  1. Position: position in the input DNA sequence.
  2. P-start: probability that the current position is the start of a nucleosome.
  3. Occup: nucleosome occupancy score. The nucleosome occupancy score is defined as the probability that the given position is covered by a nucleosome.
  4. N/L: 1 indicates the given position is covered by nucleosome and 0 for linker linker based on Viterbi prediction.
  5. Affinity: nucleosome binding affinity score. This affinity score is defined for every 147 bp of DNA sequence centered at the given position. Therefore for the first and last 73 bp of the DNA sequence, the affinity score is not defined (indicated as NA).

The output file can be imported into R by readNuPoP function:

results=readNuPoP(system.file("extdata", "test.seq_Prediction4.txt", package="NuPoP"),startPos=1,endPos=5000)
results[1:5,]
#>   Position P.start Occup N/L Affinity
#> 1        1   0.000 0.000   0       NA
#> 2        2   0.412 0.412   1       NA
#> 3        3   0.075 0.487   1       NA
#> 4        4   0.005 0.492   1       NA
#> 5        5   0.005 0.497   1       NA

The genomic sequence can be extremely long. The user can import a part of the predictions by specifying the start position startPos and the end position endPos in the readNuPoP function. For example, to visualize prediction results from startPos=1 to endPos=5000,

#par(mar=c(2,2,2,2))
plotNuPoP(results)

Session info

sessionInfo()
#> R version 4.3.1 (2023-06-16)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 22.04.3 LTS
#> 
#> Matrix products: default
#> BLAS:   /home/biocbuild/bbs-3.18-bioc/R/lib/libRblas.so 
#> LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_GB              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: America/New_York
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] NuPoP_2.10.0
#> 
#> loaded via a namespace (and not attached):
#>  [1] digest_0.6.33     R6_2.5.1          fastmap_1.1.1     xfun_0.40        
#>  [5] cachem_1.0.8      knitr_1.44        htmltools_0.5.6.1 rmarkdown_2.25   
#>  [9] cli_3.6.1         sass_0.4.7        jquerylib_0.1.4   compiler_4.3.1   
#> [13] tools_4.3.1       evaluate_0.22     bslib_0.5.1       yaml_2.3.7       
#> [17] rlang_1.1.1       jsonlite_1.8.7