Description
Computes Shannon’s entropies and performs a partition of the sites set.
Usage
site.type(target, species, th = 0.25)
Arguments
target
the KEGG identifier of the protein of interest.
species
a character vector containing the KEGG code for the species of interest.
th
value between 0 and 1 indicating the percentile driving the site partition.
Value
Returns a dataframe including the category of each site according to its variability.
See Also
msa(), custom.aln(), list.hom(), parse.hssp(), get.hssp(), shannon()
Details
Multiple sequence alignment (MSA), is generally the alignment of three or more biological sequences. From the output, homology can be inferred and the evolutionary relationships between the sequences studied. Thus, alignment is the most important stage in most evolutionary analyses. In addition, MSA is also an essential tool for protein structure and function prediction. The package ptm offers several functions that will assist you in the process of sequence analysis:
msa
custom.aln
list.hom
parse.hssp
get.hssp
shannon
site.type (current doc)
The entropy of a random variable is a measure of the uncertainty of that variable. If we define a random variable, X, as the residue found at a given position in a MSA, then the entropy of X will measure the uncertainty regarding the residue found at that position in the alignment. That is, the higher the entropy the more uncertain one is about the amino acid one can find at that position.
The function shannon() will compute, for each position in an alignment, the socalled Shannon entropy of the random variable X, defined as the residue (or codon) found at that given position. Therefore, a preliminar step involves finding a MSA of the target sequence with the orthologous sequences of the specified species. Then, for each position in this alignment the Shannon entropy is computed.
Shannon defined the entropy H, of a discrete random variable X, as:
where is the expected value operator, and is the probability mass function of X. Thus, applying the definition of expected value:
where is support of X, that is the set of all the realizations that have a strictly positive probability of being observed.
Shannon postulated that an average of the uncertainty of random variables should be a continuous function of the probability distribution (probability mass function) satisfying:

It must be maximum when the probability distribution is uniform. In this case, it must increase when the cardinal of the support, , increases.

It must be invariant against rearrangements of the probability assigned to the different values of X.

The uncertainty about two independent random variables must be the sum of the uncertainties of each of them.
Shannon proved that the only uncertainty measure that satisfies such requirements is the Shannon entropy, H(X), as we have defined it above.
To illustrate the computation, let’s work with the following toy alignment
First, we will compute the H(X) for position 20 (blue rectangle). This computation is going to be straightforward. The support is and . Thus, . Now, let’s focus on the position 34 (purple rectangle):
Although it is not obvious at first glance, the entropy, as defined by Shannon, has a very concrete interpretation.
Suppose X takes a random value from the distribution , and anyone who knows this distribution is asked to determine the realization of X (the taken value) by asking question that can be answered ‘yes’ or ‘no’, If this person uses an optimal strategy, that is he/she restricts the set of possible values to half in each question, then the average number of question necessary to arrive at the value of X will be between H(X) and H(X) + 1.
At this point, it is time to see shannon() in action. To this end we will use the human lysozime (UniProt ID: P61626). Since to compute the Shannon entropy, we have to carry out an alignment, you can select the species of interest to be included in the alignment, but if all you are interested in is to get an impression of the uncertainty at each position (that is, you don’t mind what species are included), you can select any of the preestablished list of especies (one among: ‘vertebrates’, ‘plants’, ‘onehundred’, ‘twohundred’).
First, we compute the Shannon entropy considering an alphabet of 21 letters, H21, (one per proteinogenic amino acid plus the gap symbol):
lyz21 < shannon(target = id.mapping('P61626', from = 'uniprot', to = 'kegg'), species = 'twohundred', base = 2, alphabet = 21)
We can plot the entropy as a function of the position:
plot(lyz21$n, lyz21$Haa, ty = 'b', xlab = 'Position', ylab = 'Shannon Entropy') points(lyz21$n[which(lyz21$Haa < 0.25)], lyz21$Haa[which(lyz21$Haa < 0.25)], pch = 19, col = 'blue') points(lyz21$n[which(lyz21$Haa > 3)], lyz21$Haa[which(lyz21$Haa > 3)], pch = 19, col = 'red')
Thus, as a first approch to the study of variability, shannon() can give us an idea of the sites highly variable (red) and those that are conserved (blue). However, it may happen that some sites show some degree of variability (uncertainty) but the amino acids admited into these sites must exhibit similar physichochemical properties (conservative changes). In this case, we would like to compute the Shannon entropy using a 4letter alphabet, H4, (charged, hydrophobic, polar and spetial residues). In this way, comparing H21 and H4, we can perform a partition of the sites set. To this end, we can use the function site.type():
sites < site.type(id.mapping('P61626', from = 'uniprot', to = 'kegg'), species = 'twohundred', th = 0.25)
Each site from the alingment is labelled as:
 invariant: H21 = H4 = 0 (blue)
 pseudoinvariant: H4 = 0 < H21 (purple)
 constrained: H21 < percentile & H4 < percentile (cyan)
 conservative: H21 > percentile & H4 < percentile (aquamarine)
 unconstrained: H21 > percentile & H4 > percentile (orange)
 drastic: H21 < percentile & H4 > percentile (red)
where percentile is the value of H21 or H4 corresponding to the percentile indicated by the argument th.