man/idprofile.Rd
05b77dfd
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/idprofile.R
 \name{idprofile}
 \alias{idprofile}
5a22186e
 \title{IDp PRofile From idpr Package}
05b77dfd
 \usage{
 idprofile(
   sequence,
   uniprotAccession = NA,
   proteinName = NA,
dc8b3a04
   iupredType = "long",
05b77dfd
   window = 9,
   pH = 7.2,
   pKaSet = "IPC_protein",
   structuralTendencyType = "bar",
   structuralTendencySummarize = FALSE,
   disorderPromoting = c("P", "E", "S", "Q", "K", "A", "G"),
   disorderNeutral = c("D", "T", "R"),
dc8b3a04
   orderPromoting = c("M", "N", "V", "H", "L", "F", "Y", "I", "W", "C")
05b77dfd
 )
 }
 \arguments{
 \item{sequence}{amino acid sequence as a single character string or vector of
 single characters. It also supports a single character string that
555cd2c4
 specifies the location of a .fasta or .fa file.}
05b77dfd
 
 \item{uniprotAccession}{character string specifying the UniProt Accession of
 the protein of interest. Used to fetch predictions from IUPreds REST API.
 Default is NA. Keep as NA if you do not have a UniProt Accession.}
 
 \item{proteinName}{character string, optional.
 Used to add protein name to the title in ggplot.}
 
dc8b3a04
 \item{iupredType}{character string specifying the type of IUPred2 prediction
 to retrieve. Can be c("long", "short", "glob", "anchor", "redox"). "long"
 by default. "long", "short", and "glob" use the \code{\link{iupred}}
 function and specify the type of plot. Both "redox" and "anchor" use "long"
 for predictions, but are context dependent. "anchor" uses
 \code{\link{iupredAnchor}} to get predictions of disorder with IUPred2 and
 predictions of induced folding based on ANCHOR2 predictions (Shown with a
 red line). "redox" uses \code{\link{iupredRedox}} to make predictions of
 disorder based on environmental conditions. Regions of predicted
 environmental sensitivity are highlighted. See the respective functions
 for more details. This is skipped if uniprotAccession = NA.}
 
36a54e3c
 \item{window}{a positive, odd integer. 51 by default.
05b77dfd
 Sets the size of sliding window, must be an odd number.
 The window determines the number of residues to be analyzed and averaged
36a54e3c
 for each position along the sequence. 51 is default for 
 \code{\link{foldIndexR}}\cr.}
05b77dfd
 
555cd2c4
 \item{pH}{numeric value, 7.0 by default.
 The environmental pH used to calculate residue charge.}
05b77dfd
 
 \item{pKaSet}{A character string or data frame. "IPC_protein" by default.
 Character string to load specific, preloaded pKa sets.
555cd2c4
  c("EMBOSS", "DTASelect", "Solomons", "Sillero", "Rodwell",
05b77dfd
   "Lehninger", "Toseland", "Thurlkill", "Nozaki", "Dawson",
555cd2c4
   "Bjellqvist", "ProMoST", "Vollhardt", "IPC_protein", "IPC_peptide")
5a22186e
  Alternatively, the user may supply a custom pKa dataset.
05b77dfd
  The format must be a data frame where:
0aa3e3cb
  Column 1 must be a character vector of residues named "AA" AND
05b77dfd
  Column 2 must be a numeric vector of pKa values.}
 
 \item{structuralTendencyType}{a character string specifying the type of plot
 the \code{\link{structuralTendencyPlot}} should output.
 Can be "bar" or "pie".
555cd2c4
 Equivalent argument to graphType= in the linked function.
05b77dfd
 "bar" by default.}
 
 \item{structuralTendencySummarize}{a logical value specifying the
 \code{\link{structuralTendencyPlot}} should be summarized into broad
555cd2c4
 categories. Equivalent argument to summarize= in the linked function.
 FALSE by default}
05b77dfd
 
 \item{disorderPromoting, disorderNeutral, orderPromoting}{character vectors
 of individual residues to be matched with the input sequence. Defaults:
 \itemize{
   \item disorderPromoting = c("P", "E", "S", "Q", "K", "A", "G")
   \item orderPromoting =
      c("M", "N", "V", "H", "L", "F", "Y", "I", "W", "C")
   \item disorderNeutral = c("D", "T", "R")
 }
555cd2c4
 It is not recommended to change these. Arguments passed to
05b77dfd
 \code{\link{structuralTendencyPlot}}}
 }
 \value{
 4 or 5 plots, depending if a UniProt Accession is provided.
 }
 \description{
 The IDPRofile is a summation of many features of the idpr package,
   conveniently grouped into one function for quick analysis. This combines
   many plotting functions in this package. These include:\cr
   \code{\link{chargeHydropathyPlot}}\cr
   \code{\link{chargeCalculationLocal}}\cr
   \code{\link{scaledHydropathyLocal}}\cr
   \code{\link{structuralTendencyPlot}}\cr
36a54e3c
   \code{\link{foldIndexR}}\cr
05b77dfd
   All of the above linked functions only require the sequence argument
555cd2c4
   to output plots of characteristics associated with IDPs. The function also
05b77dfd
   includes options for IUPred functions. The function does one of the
   following based on user-specified parameters:\cr
   \code{\link{iupred}}\cr
   \code{\link{iupredAnchor}}\cr
   \code{\link{iupredRedox}}\cr
   The IUPred function used depends on the argument of iupredType. All
   require the UniProt Accession to make a proper connection to the IUPred2A
   REST API. If the UniProt Accession is not specified, the IUPred plot is
   skipped.
 }
 \section{Citations for each Plot}{
 
   \itemize{
     \item \code{\link{chargeHydropathyPlot}}
       \itemize{
         \item{Kozlowski, L. P. (2016). IPC – Isoelectric Point Calculator.
               Biology Direct, 11(1), 55.
               https://doi.org/10.1186/s13062-016-0159-9}
         \item{Kyte, J., & Doolittle, R. F. (1982).
               A simple method for displaying the hydropathic character
               of a protein. Journal of molecular biology, 157(1), 105-132.}
555cd2c4
         \item{Uversky, V. N. (2016). Paradoxes and wonders of intrinsic
               disorder: Complexity of simplicity. Intrinsically Disordered
               Proteins, 4(1), e1135015.
               https://doi.org/10.1080/21690707.2015.1135015}
         \item{Uversky, V. N., Gillespie, J. R., & Fink, A. L. (2000).
               Why are “natively unfolded” proteins unstructured under
               physiologic conditions?. Proteins: structure, function,
               and bioinformatics, 41(3), 415-427.
               https://doi.org/10.1002/1097-0134(20001115)41:3<415::AID-PROT130>3.0.CO;2-7}
05b77dfd
         \item{If a pKa set is specified, see \code{\link{pKaData}}}
     }
     \item \code{\link{chargeCalculationLocal}}
       \itemize{
         \item{Kozlowski, L. P. (2016). IPC – Isoelectric Point Calculator.
               Biology Direct, 11(1), 55.
               https://doi.org/10.1186/s13062-016-0159-9}
         \item{If a pKa set is specified, see \code{\link{pKaData}}}
     }
     \item \code{\link{scaledHydropathyLocal}}
       \itemize{
         \item{Kyte, J., & Doolittle, R. F. (1982).
               A simple method for displaying the hydropathic character
               of a protein. Journal of molecular biology, 157(1), 105-132.}
     }
     \item \code{\link{structuralTendencyPlot}}
       \itemize{
555cd2c4
         \item{Uversky, V. N. (2013).
               A decade and a half of protein intrinsic disorder:
               Biology still waits for physics.
               Protein Science, 22(6), 693-724.
               doi:10.1002/pro.2261 }
05b77dfd
     }
36a54e3c
     \item \code{\link{foldIndexR}}
       \itemize{
         \item{Prilusky, J., Felder, C. E., et al. (2005). 
               FoldIndex: a simple tool to predict whether 
               a given protein sequence is intrinsically unfolded. 
               Bioinformatics, 21(16), 3435-3438.}
          \item{Uversky, V. N., Gillespie, J. R., & Fink, A. L. (2000).
               Why are “natively unfolded” proteins unstructured under
               physiologic conditions?. Proteins: structure, function,
               and bioinformatics, 41(3), 415-427.
               https://doi.org/10.1002/1097-0134(20001115)41:3<415::AID-PROT130>3.0.CO;2-7}
         \item{Also see citations for hydrapthy and charge plots above}
     }
05b77dfd
     \item \code{\link{iupred}},
           \code{\link{iupredAnchor}},
           \code{\link{iupredRedox}}
       \itemize{
         \item{Bálint Mészáros, Gábor Erdős, Zsuzsanna Dosztányi, IUPred2A:
         context-dependent prediction of protein disorder as a function of
         redox state and protein binding, Nucleic Acids Research, Volume 46,
          Issue W1, 2 July 2018, Pages W329–W337,
          https://doi.org/10.1093/nar/gky384}
         \item{Erdős, G., & Dosztányi, Z. (2020). Analyzing protein disorder
         with IUPred2A. Current Protocols in Bioinformatics, 70, e99.
         https://doi.org/10.1002/cpbi.99}
     }
  }
 }
 
35546149
 \examples{
 #For most functions, a protein sequence is all that is needed.
 
5a22186e
 #The UniProt ID is optional but recommended for IUPred results.
35546149
 proteinID <- "P04637"
5a22186e
 p53Seq <- idpr:::TP53Sequences[2]
30657eb4
 \dontrun{
35546149
 idprofile(
5a22186e
   sequence = p53Seq,
35546149
   uniprotAccession = proteinID)
 
 
 #changing the iupred to redox
 ## and getting a pie chart for structuralTendency.
 idprofile(
5a22186e
   sequence = p53Seq,
35546149
   uniprotAccession = proteinID,
5a22186e
   pKaSet = EMBOSS,
35546149
   iupredType = "redox",
   structuralTendencyType = "pie")
 }
fb8e567f
 
 
35546149
 }
05b77dfd
 \seealso{
 \code{\link{chargeHydropathyPlot}}\cr
   \code{\link{chargeCalculationLocal}}\cr
   \code{\link{scaledHydropathyLocal}}\cr
   \code{\link{structuralTendencyPlot}}\cr
36a54e3c
   \code{\link{foldIndexR}}\cr
05b77dfd
   \code{\link{iupred}}\cr
   \code{\link{iupredAnchor}}\cr
fb8e567f
   \code{\link{iupredRedox}}
05b77dfd
 }