EMBOSS: nrscope


Program nrscope

Function

Converts redundant EMBL-format SCOP file to non-redundant one

Description

Nearly all proteins have structural similarities with other proteins and, in some of these cases, share a common evolutionary origin. A knowledge of these relationships is crucial to our understanding of the evolution of proteins and of development. It will also play an important role in the analysis of the sequence data that is being produced by worldwide genome projects.

The SCOP database aims to provide a detailed and comprehensive description of the structural and evolutionary relationships between all proteins whose structure is known, including all entries in the Protein Data Bank (PDB).

nrscope reads in the EMBL-like format SCOP classification file generated by the EMBOSS application scope, and writes a file of non-redundant domains in the same format. Domain sequences are extracted from the clean domain coordinate files generated by the EMBOSS application domainer.

The current version of nrscope removes redundancy at the level of the SCOP family, i.e. entries belonging to the same family will be non-redundant. All permutations of pair-wise sequence alignments are calculated for each SCOP family in turn, using the EMBOSS implementation of the Needleman and Wunsch global alignment algorithm. If a pair of proteins achieve greater than a threshold percentage sequence identity (specified by the user) the shortest sequence is discarded. The user must specify gap insertion and extension penalties and a residue substitution matrix for use in the alignments.

Usage

Here is a sample session with nrscope:

% nrscope
Converts redundant EMBL-format SCOP file to non-redundant one
Name of scop file for input (embl-like format) [Escop.dat]: /data/scop/Escop.dat
Name of non-redundant scop file for output (embl-like format) [EscopNR.dat]: EscopNR.test
Location of clean domain coordinate files for input (embl-like format) [./]: /data/cpdbscop/
File extension of clean domain coordinate files [.pxyz]:
The % sequence identity redundancy threshold [95]: 95
Residue substitution file [EBLOSUM62]:
Gap insertion penalty [10]: 20
Gap extension penalty [0.5]: 1
Name of log file for the build [nrscope.log]: EscopNR.log
D3SDHA_
D3SDHB_
D3HBIA_
D3HBIB_
D4SDHA_
D4SDHB_
D4HBIA_
D4HBIB_
D5HBIA_
D5HBIB_

Command line arguments

   Mandatory qualifiers:
  [-scopin]            infile     Name of scop file for input (embl-like
                                  format)
  [-dpdb]              string     Location of clean domain coordinate files
                                  for input (embl-like format)
  [-extn]              string     File extension of clean domain coordinate
                                  files
  [-thresh]            float      The % sequence identity redundancy threshold
  [-datafile]          matrixf    Residue substitution matrix
  [-gapopen]           float      The gap insertion penalty is the score taken
                                  away when a gap is created. The best value
                                  depends on the choice of comparison matrix.
                                  The default value assumes you are using the
                                  EBLOSUM62 matrix for protein sequences, and
                                  the EDNAFULL matrix for nucleotide
                                  sequences.
  [-gapextend]         float      The gap extension, penalty is added to the
                                  standard gap penalty for each base or
                                  residue in the gap. This is how long gaps
                                  are penalized. Usually you will expect a few
                                  long gaps rather than many short gaps, so
                                  the gap extension penalty should be lower
                                  than the gap penalty. An exception is where
                                  one or both sequences are single reads with
                                  possible sequencing errors in which case you
                                  would expect many single base gaps. You can
                                  get this result by setting the gap open
                                  penalty to zero (or very low) and using the
                                  gap extension penalty to control gap
                                  scoring.
  [-scopout]           outfile    Name of non-redundant scop file for output
                                  (embl-like format)
  [-errf]              outfile    Name of log file for the build

   Optional qualifiers: (none)
   Advanced qualifiers: (none)
   General qualifiers:
  -help                bool       report command line options. More
                                  information on associated and general
                                  qualifiers can be found with -help -verbose


Mandatory qualifiers Allowed values Default
[-scopin]
(Parameter 1)
Name of scop file for input (embl-like format) Input file Escop.dat
[-dpdb]
(Parameter 2)
Location of clean domain coordinate files for input (embl-like format) Any string is accepted ./
[-extn]
(Parameter 3)
File extension of clean domain coordinate files Any string is accepted .pxyz
[-thresh]
(Parameter 4)
The % sequence identity redundancy threshold Any integer value 95.0
[-datafile]
(Parameter 5)
Residue substitution matrix Comparison matrix file in EMBOSS data path EBLOSUM62
[-gapopen]
(Parameter 6)
The gap insertion penalty is the score taken away when a gap is created. The best value depends on the choice of comparison matrix. The default value assumes you are using the EBLOSUM62 matrix for protein sequences, and the EDNAFULL matrix for nucleotide sequences. Floating point number from 1.0 to 100.0 10.0 for any sequence
[-gapextend]
(Parameter 7)
The gap extension, penalty is added to the standard gap penalty for each base or residue in the gap. This is how long gaps are penalized. Usually you will expect a few long gaps rather than many short gaps, so the gap extension penalty should be lower than the gap penalty. An exception is where one or both sequences are single reads with possible sequencing errors in which case you would expect many single base gaps. You can get this result by setting the gap open penalty to zero (or very low) and using the gap extension penalty to control gap scoring. Floating point number from 0.0 to 10.0 0.5 for any sequence
[-scopout]
(Parameter 8)
Name of non-redundant scop file for output (embl-like format) Output file EscopNR.dat
[-errf]
(Parameter 9)
Name of log file for the build Output file nrscope.log
Optional qualifiers Allowed values Default
(none)
Advanced qualifiers Allowed values Default
(none)

Input file format

The EMBL-like format SCOP classification file generated by the EMBOSS application scope is as follows:

Records (4) to (8) are used to describe the position of the domain in the scop hierarchy.

  1. ID - Domain identifier code. This is a 7-character code that uniquely identifies the domain in scop. It is identical to the first 7 characters of a line in the scop classification file. The first character is always 'D', the next four characters are the PDB identifier code, the fifth character is the PDB chain identifier to which the domain belongs (a '.' is given in cases where the domain is composed of multiple chains, a '_' is given where a chain identifier was not specified in the PDB file) and the final character is the number of the domain in the chain (for chains comprising more than one domain) or '_' (the chain comprises a single domain only).
  2. EN - PDB identifier code. This is the 4-character PDB identifier code of the PDB entry containing the domain.
  3. OS - Source of the protein. It is identical to the text given after 'Species' in the scop classification file.
  4. CL - Domain class. It is identical to the text given after 'Class' in the scop classification file.
  5. FO - Domain fold. It is identical to the text given after 'Fold' in the scop classification file.
  6. SF - Domain superfamily. It is identical to the text given after 'Superfamily' in the scop classification file.
  7. FA - Domain family. It is identical to the text given after 'Family' in the scop classification file.
  8. DO - Domain name. It is identical to the text given after 'Protein' in the scop classification file.
  9. NC - Number of chains comprising the domain (usually 1). If the number of chains is greater than 1, then the domain entry will have a section containing a CN and a CH record (see below) for each chain.
  10. CN - Chain number. The number given in brackets after this record indicates the start of the data for the relevent chain.
  11. CH - Domain definition. The character given before CHAIN is the PDB chain identifier (a '.' is given in cases where a chain identifier was not specified in the scop classification file), the strings before START and END give the start and end positions respectively of the domain in the PDB file (a '.' is given in cases where a position was not specified). Note that the start and end positions refer to residue numbering given in the original pdb file and therefore must be treated as strings.

Output file format

The output file has the same format as the input EMBL-like format SCOP classification file generated by the EMBOSS application scope except that it contains non-redundant domains, as explained in the Description section.

nrscope generates a log file, an excerpt of which is shown below. The first two lines describe the level in the SCOP hierarchy at which redundancy was removed (always 'FAMILIES' for the current implementation) and the value of the redundancy threshold. The file then contains a section for each SCOP family. Each section contains a line with the record '//' immediately followed by the name of the SCOP family, and two lines containing 'Retained' and 'Rejected' respectively. Domain identifier codes of domains that were discarded by nrscope are listed under 'Rejected' while those that appear in the output file are listed under 'Retained'. The text 'WARN filename not found' is given in cases where a clean domain coordinate file could not be found and 'WARN Empty family' where no files for an entire family could be found. 'ERROR filename file read error' will be given when an error was encountered during a file read.


FAMILIES are non-redundant
95% redundancy threshold
// Homeodomain
Retained
D2HDDA_
D1AKHA_
D1MNMC_
Rejected
D2HDDB_
D1ENH__
D3HDDA_
WARN  d3hdda_.pxyz not found
// Di-haem cytohrome c peroxidase
WARN  ds005__.pxyz not found
WARN  Empty family
// Nuclear receptor coactivator Src-1
Retained
D2PRGC_
Rejected

Data files

None.

Notes

None.

References

None.

Warnings

None.

Diagnostic Error Messages

None.

Exit status

It always exits with status 0.

Known bugs

None.

See also

Program nameDescription
cutgextractExtract data from CUTG
domainerBuild domain coordinate files
pdbtospConvert raw swissprot:pdb equivalence file to embl-like format
printsextractExtract data from PRINTS
prosextractBuilds the PROSITE motif database for patmatmotifs to search
rebaseextractExtract data from REBASE
scopeConvert raw scop classification file to embl-like format
scopparseReads raw scop classifications file and writes embl-like format scop classification file
seqnrConverts redundant database results to a non-redundant set of hits
tfextractExtract data from TRANSFAC

Author(s)

This application was written by Jon Ison (jison@hgmp.mrc.ac.uk)

History

Written (Jan 2001) - Jon Ison.

Target users

This program is intended to be run by EMBOSS site maintainers or those responsible for setting up and maintaining protein 3D structural data for use by others.

Comments