ROCON documentation


 


CONTENTS

1.0 SUMMARY
2.0 INPUTS & OUTPUTS
3.0 INPUT FILE FORMAT
4.0 OUTPUT FILE FORMAT
5.0 DATA FILES
6.0 USAGE
7.0 KNOWN BUGS & WARNINGS
8.0 NOTES
9.0 DESCRIPTION
10.0 ALGORITHM
11.0 RELATED APPLICATIONS
12.0 DIAGNOSTIC ERROR MESSAGES
13.0 AUTHORS
14.0 REFERENCES



1.0 SUMMARY

Reads a DHF file (domain hits file) of hits (sequences of unknown structural classification) and a domain families file (validation sequences of known classification) and writes a "hits file" for the hits, which are classified and rank-ordered on the basis of score. Generates a hits file from comparing two DHF files


2.0 INPUTS & OUTPUTS

ROCON reads a DHF file (domain hits file) of hits generated for a single node from a classification hierarchy, e.g. SCOP family. These sequences are putatively related to the node in question but are, in fact, of unknown classification. ROCON also reads a domain families file (in DHF format), containing "validation" sequences (of known classification). These sequences are used to classify the input hits. A "hits file" (suitable for input into the ROCPLOT application) is written, which contains the input hits, classified and rank-ordered on the basis of score.


3.0 INPUT FILE FORMAT

The format of the DHF is described in SEQSEARCH documentation. See also the example of the DHF file for hit sequences (Figure 1) and validation sequences (Figure 2) below.

Input files for usage example

File: rocon/rocon.dhf

> Q9YBD5^.^11^105^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^61.50^0.000e+00^4.000e-10
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9YBD5^.^95^135^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^11.50^0.000e+00^4.000e-5
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9YBD5^.^181^235^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^161.50^0.000e+00^4.000e-5
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> O26938^.^11^101^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^81.90^0.000e+00^3.000e-16
VKPIKNGTVIDHITANRSLNVLNILGLPDGRSKVTVAMNMDSSQLGSKDIVKIENRELKPSEVDQIALIAPRATINIVRDYKIVEKAKVRL
> Q8Z130^.^8^99^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^181.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTDEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> Q7MX57^.^8^99^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^80.80^0.000e+00^7.000e-16
VAAIRNGIVIDHIPPTKLFKVATLLQLDDLDKRITIGNNLRSRSHGSKGVIKIEDKTFEEEELNRIALIAPNVRLNIIRDYEVVEKRQVEVP
> Q8TVB1^.^7^98^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^72.70^0.000e+00^2.000e-13
VKRIEMGTVLDHLPPGTAPQIMRILDIDPTETTLLVAINVESSKMGRKDILKIEGKILSEEEANKVALVAPNATVNIVRDYSVAEKFQVKPP
> P96175^.^8^99^SCOP^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^107.00^0.000e+00^7.000e-24
VEAICNGYVIDHIPSGQGVKILRLFSLTDTKQRVTVGFNLPSHDGTTKDLIKVENTEITKSQANQLALLAPNATVNIIENFKVTDKHSLALP

File: rocon.valid

> Q9YBD5^.^11^105^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^61.50^0.000e+00^4.000e-10
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9UX07^.^12^104^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^65.80^0.000e+00^2.000e-11
VSKIRNGTVIDHIPAGRALAVLRILGIRGSEGYRVALVMNVESKKIGRKDIVKIEDRVIDEKEASLITLIAPSATINIIRDYVVTEKRHLEVP
> Q9KP65^.^9^100^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^128.00^0.000e+00^3.000e-30
VEAIKNGTVIDHIPAKVGIKVLKLFDMHNSAQRVTIGLNLPSSALGSKDLLKIENVFISEAQANKLALYAPHATVNQIENYEVVKKLALQLP
> Q9K1K9^.^8^99^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^101.00^0.000e+00^5.000e-22
VEAIEKGTVIDHIPAGRGLTILRQFKLLHYGNAVTVGFNLPSKTQGSKDIIKIKGVCLDDKAADRLALFAPEAVVNTIDNFKVVQKRHLNLP
> Q9JWY6^.^8^99^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^98.90^0.000e+00^2.000e-21
VEAIEKGTVIDHIPAGRGLTILRQFKLLHYGNAVTVGFNLPSKTQGSKDIIKIKGVCLDDKAADRLALFAPEAVVNTIDHFKVVQKRHLNLP
> Q9HKM3^.^7^99^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^79.60^0.000e+00^2.000e-15
ISKIRDGTVIDHVPSGKGIRVIGVLGVHEDVNYTVSLAIHVPSNKMGFKDVIKIENRFLDRNELDMISLIAPNATISIIKNYEISEKFQVELP
> Q9HHN3^.^9^101^SCOP^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^78.50^0.000e+00^4.000e-15
VSKIQAGTVIDHIPAGQALQVLQILGTNGASDDQITVGMNVTSERHHRKDIVKIEGRELSQDEVDVLSLIAPDATINIVRDYEVDEKRRVDRP
> Q97FS4^.^4^93^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^49.20^0.000e+00^2.000e-06
INSIKNGIVIDHIKAGHGIKIYNYLKLGEAEFPTALIMNAISKKNKAKDIIKIENVMDLDLAVLGFLDPNITVNIIEDEKIRQKIQLKLP
> Q97B28^.^8^100^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^79.20^0.000e+00^2.000e-15
ISKIKDGTVIDHIPSGKALRVLSILGIRDDVDYTVSVGMHVPSSKMEYKDVIKIENRSLDKNELDMISLTAPNATISIIKNYEISEKFKVELP
> Q970X3^.^11^101^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^78.50^0.000e+00^3.000e-15
VSKIKNGTVIDHIPAGRALAVLRILKIAEGYRIALVMNVESKKMGKKDIVKIENKEVDEKEANLITLIAPTATINIIRDYEVVEKKKLKIP
> Q8ZTG2^.^7^99^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^66.10^0.000e+00^2.000e-11
VSKIENGTVIDHIPAGRALTVLRILGISGKEGLRVALVMNVESKKLGKKDIVKIEGRELTPEEVNIISAVAPTATINIIRNFAVVKKFKVTPP
> Q8ZB38^.^9^100^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^156.00^0.000e+00^1.000e-38
VEAIKCGTVIDHIPAQIGFKLLSLFKLTATDQRITIGLNLPSKRSGRKDLIKIENTFLTEQQANQLAMYAPDATVNRIDNYEVVKKLTLSLP
> Q8Z130^.^8^99^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^181.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTDEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> Q8U374^.^6^99^SCOP^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^92.00^0.000e+00^3.000e-19
VSAIKEGTVIDHIPAGKGLKVIQILGLGELKNGGAVLLAMNVPSKKLGRKDIVKVEGKFLSEEEVNKIALVAPTATVNIIREYKVVEKFKVEIP
> Q8TVB1^.^7^98^SCOP^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^72.70^0.000e+00^2.000e-13
VKRIEMGTVLDHLPPGTAPQIMRILDIDPTETTLLVAINVESSKMGRKDILKIEGKILSEEEANKVALVAPNATVNIVRDYSVAEKFQVKPP
> Q8THL3^.^9^100^SCOP^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^69.20^0.000e+00^2.000e-12
IQAIENGTVIDHITAGQALNVLRILRISSAFRATVSFVMNAPGARGKKDVVKIEGKELSVEELNRIALISPKATINIIRDFEVVQKNKVVLP
> Q8PXK6^.^9^100^SCOP^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^62.70^0.000e+00^2.000e-10
VQAIESGTVIDHIKSGQALNVLRILGISSAFRATISFVMNAPGAGGKKDVVKIEGKELSVEELNRIALISPKATINIIRDFVVVQKNNVVLP
> Q8K9H8^.^8^99^SCOP^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^146.00^0.000e+00^1.000e-35
VEAIKSGSVIDHIPAHIGFKLLSLFRFTETEKRITIGLNLPSQKLDKKDIIKIENTFLSDDQINQLAIYAPCATVNYIEKYNLVGKIFPSLP
> Q8DCF7^.^9^100^SCOP^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^127.00^0.000e+00^9.000e-30
VEAIKNGTVIDHIPAQVGIKVLKLFDMHNSSQRVTIGLNLPSSALGNKDLLKIENVFINEEQASKLALYAPHATVNQIEDYQVVKKLALELP
> Q8D1W6^.^9^100^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^123.00^0.000e+00^1.000e-28
VEAIFGGTVIDHIPAQVGLKLLSLFKWLHTKERITMGLNLPSNQQKKKDLIKLENVLLNEDQANQLSIYAPLATVNQIKNYIVIKKQKLKLP
> Q8A9S4^.^10^101^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^63.80^0.000e+00^9.000e-11
VAALKNGTVIDHIPSEKLFTVVQLLGVEQMKCNITIGFNLDSKKLGKKGIIKIADKFFCDEEINRISVVAPYVKLNIIRDYEVVEKKEVRMP
> Q891I9^.^4^94^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^52.30^0.000e+00^2.000e-07
ITSIKDGIVIDHIKSGYGIKIFNYLNLKNVEYSVALIMNVFSSKLGKKDIIKIANKEIDIDFTVLGLIDPTITINIIEDEKIKEKLNLELP
> Q87LF7^.^9^100^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^130.00^0.000e+00^7.000e-31
VEAIKNGTVIDHIPAQIGIKVLKLFDMHNSSQRVTIGLNLPSSALGHKDLLKIENVFINEEQASKLALYAPHATVNQIENYEVVKKLALELP
> Q83IL8^.^8^99^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^189.00^0.000e+00^0.000e+00
VEAIKRGTVIDHIPAQIGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLSEEQVDQLALYAPQATVNRIDNYEVVGKSRPSLP
> Q7P144^.^7^98^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^128.00^0.000e+00^3.000e-30
VEALKQGTVIDHIPAGEGVKILRLFKLTETGERVTVGLNLVSRHMGSKDLIKVENVALTEEQANELALFAPKATVNVIDNFEVVKKHKLTLP
> Q7MZ14^.^9^100^SCOP^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^150.00^0.000e+00^6.000e-37
VEAIRCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSNRLGKKDLIKIENTFLTEQQANQLAMYAPNATVNCIENYEVVKKLPINLP
> Q7MX57^.^8^99^SCOP^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^80.80^0.000e+00^7.000e-16
VAAIRNGIVIDHIPPTKLFKVATLLQLDDLDKRITIGNNLRSRSHGSKGVIKIEDKTFEEEELNRIALIAPNVRLNIIRDYEVVEKRQVEVP
> Q7MHF0^.^9^100^SCOP^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^127.00^0.000e+00^8.000e-30
VEAIKNGTVIDHIPAQVGIKVLKLFDMHNSSQRVTIGLNLPSSALGNKDLLKIENVFINEEQASKLALYAPHATVNQIEDYQVVKKLALELP
> Q58801^.^9^99^SCOP^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^61.50^0.000e+00^5.000e-10
VKKITNGTVIDHIDAGKALMVFKVLNVPKETSVMIAINVPSKKKGKKDILKIEGIELKKEDVDKISLISPDVTINIIRNGKVVEKLKPQIP
> P96175^.^8^99^SCOP^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^107.00^0.000e+00^7.000e-24
VEAICNGYVIDHIPSGQGVKILRLFSLTDTKQRVTVGFNLPSHDGTTKDLIKVENTEITKSQANQLALLAPNATVNIIENFKVTDKHSLALP
> P96111^.^375^472^SCOP^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^47.30^0.000e+00^9.000e-06
GIKPIENGTVIDHIAKGKTPEEIYSTILKIRKILRLYDVDSADGIFRSSDGSFKGYISLPDRYLSKKEIKKLSAISPNTTVNIIKNSTVVEKYRIKLP
> P77919^.^6^99^SCOP^.^6^Class 1^.^.^Fold 2^Superfamily 1^Family 2^PSIBLAST^93.50^0.000e+00^1.000e-19
VSAIKEGTVIDHIPAGKGLKVIEILKLGKLTNGGAVLLAMNVPSKKLGRKDIVKVEGRFLSEEEVNKIALVAPNATVNIIRDYKVVEKFKVEVP
> P74766^.^12^104^SCOP^.^6^Class 1^.^.^Fold 2^Superfamily 1^Family 2^PSIBLAST^74.20^0.000e+00^7.000e-14
VSKIKNGTVIDHIPAGRAFAVLNVLGIKGHEGFRIALVINVDSKKMGKKDIVKIEDKEISDTEANLITLIAPTATINIVREYEVVKKTKLEVP
> P57451^.^8^99^SCOP^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^143.00^0.000e+00^1.000e-34
VEAIKSGSVIDHIPEYIGFKLLSLFRFTETEKRITIGLNLPSKKLGRKDIIKIENTFLSDEQINQLAIYAPHATVNYINEYNLVRKVFPTLP
> P19936^.^8^99^SCOP^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^159.00^0.000e+00^1.000e-39
VEAIKCGTVIDHIPAQIGFKLLTLFKLTATDQRITIGLNLPSNELGRKDLIKIENTFLTEQQANQLAMYAPKATVNRIDNYEVVRKLTLSLP
> P08421^.^8^99^SCOP^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^183.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTEEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> P00478^.^8^99^SCOP^.^8^Class 1^.^.^Fold 2^Superfamily 2^Family 2^PSIBLAST^191.00^0.000e+00^0.000e+00
VEAIKRGTVIDHIPAQIGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLSEDQVDQLALYAPQATVNRIDNYEVVGKSRPSLP
> O58452^.^6^99^SCOP^.^8^Class 1^.^.^Fold 2^Superfamily 2^Family 2^PSIBLAST^94.30^0.000e+00^6.000e-20
VSAIKEGTVIDHIPAGKGLKVIEILGLSKLSNGGSVLLAMNVPSKKLGRKDIVKVEGKFLSEEEVNKIALVAPTATVNIIRNYKVVEKFKVEVP
> O30129^.^6^98^SCOP^.^9^Class 2^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^79.60^0.000e+00^2.000e-15
VSKIKEGTVIDHINAGKALLVLKILKIQPGTDLTVSMAMNVPSSKMGKKDIVKVEGMFIRDEELNKIALISPNATINLIRDYEIERKFKVSPP
> O26938^.^11^101^SCOP^.^10^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^81.90^0.000e+00^3.000e-16
VKPIKNGTVIDHITANRSLNVLNILGLPDGRSKVTVAMNMDSSQLGSKDIVKIENRELKPSEVDQIALIAPRATINIVRDYKIVEKAKVRL

<--

Figure 1 Excerpt of DHF file (hit sequences) 
> Q9YBD5^.^11^105^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^61.50^0.000e+00^4.000e-10
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9YBD5^.^95^135^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^11.50^0.000e+00^4.000e-5
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9YBD5^.^181^235^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^SPARSE^161.50^0.000e+00^4.000e-5
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> O26938^.^11^101^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^81.90^0.000e+00^3.000e-16
VKPIKNGTVIDHITANRSLNVLNILGLPDGRSKVTVAMNMDSSQLGSKDIVKIENRELKPSEVDQIALIAPRATINIVRDYKIVEKAKVRL
> Q8Z130^.^8^99^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^181.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTDEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> Q7MX57^.^8^99^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^80.80^0.000e+00^7.000e-16
VAAIRNGIVIDHIPPTKLFKVATLLQLDDLDKRITIGNNLRSRSHGSKGVIKIEDKTFEEEELNRIALIAPNVRLNIIRDYEVVEKRQVEVP
> Q8TVB1^.^7^98^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^72.70^0.000e+00^2.000e-13
VKRIEMGTVLDHLPPGTAPQIMRILDIDPTETTLLVAINVESSKMGRKDILKIEGKILSEEEANKVALVAPNATVNIVRDYSVAEKFQVKPP
> P96175^.^8^99^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^107.00^0.000e+00^7.000e-24
VEAICNGYVIDHIPSGQGVKILRLFSLTDTKQRVTVGFNLPSHDGTTKDLIKVENTEITKSQANQLALLAPNATVNIIENFKVTDKHSLALP

Figure 1 Excerpt of domain families file (validation sequences) 
> Q9YBD5^.^11^105^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^61.50^0.000e+00^4.000e-10
VRKIRSGVVIDHIPPGRAFTMLKALGLLPPRGYRWRIAVVINAESSKLGRKDILKIEGYKPRQRDLEVLGIIAPGATFNVIEDYKVVEKVKLKLP
> Q9UX07^.^12^104^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^65.80^0.000e+00^2.000e-11
VSKIRNGTVIDHIPAGRALAVLRILGIRGSEGYRVALVMNVESKKIGRKDIVKIEDRVIDEKEASLITLIAPSATINIIRDYVVTEKRHLEVP
> Q9KP65^.^9^100^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^128.00^0.000e+00^3.000e-30
VEAIKNGTVIDHIPAKVGIKVLKLFDMHNSAQRVTIGLNLPSSALGSKDLLKIENVFISEAQANKLALYAPHATVNQIENYEVVKKLALQLP
> Q9K1K9^.^8^99^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^101.00^0.000e+00^5.000e-22
VEAIEKGTVIDHIPAGRGLTILRQFKLLHYGNAVTVGFNLPSKTQGSKDIIKIKGVCLDDKAADRLALFAPEAVVNTIDNFKVVQKRHLNLP
> Q9JWY6^.^8^99^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^98.90^0.000e+00^2.000e-21
VEAIEKGTVIDHIPAGRGLTILRQFKLLHYGNAVTVGFNLPSKTQGSKDIIKIKGVCLDDKAADRLALFAPEAVVNTIDHFKVVQKRHLNLP
> Q9HKM3^.^7^99^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^79.60^0.000e+00^2.000e-15
ISKIRDGTVIDHVPSGKGIRVIGVLGVHEDVNYTVSLAIHVPSNKMGFKDVIKIENRFLDRNELDMISLIAPNATISIIKNYEISEKFQVELP
> Q9HHN3^.^9^101^.^1^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^78.50^0.000e+00^4.000e-15
VSKIQAGTVIDHIPAGQALQVLQILGTNGASDDQITVGMNVTSERHHRKDIVKIEGRELSQDEVDVLSLIAPDATINIVRDYEVDEKRRVDRP
> Q97FS4^.^4^93^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^49.20^0.000e+00^2.000e-06
INSIKNGIVIDHIKAGHGIKIYNYLKLGEAEFPTALIMNAISKKNKAKDIIKIENVMDLDLAVLGFLDPNITVNIIEDEKIRQKIQLKLP
> Q97B28^.^8^100^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^79.20^0.000e+00^2.000e-15
ISKIKDGTVIDHIPSGKALRVLSILGIRDDVDYTVSVGMHVPSSKMEYKDVIKIENRSLDKNELDMISLTAPNATISIIKNYEISEKFKVELP
> Q970X3^.^11^101^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^78.50^0.000e+00^3.000e-15
VSKIKNGTVIDHIPAGRALAVLRILKIAEGYRIALVMNVESKKMGKKDIVKIENKEVDEKEANLITLIAPTATINIIRDYEVVEKKKLKIP
> Q8ZTG2^.^7^99^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^66.10^0.000e+00^2.000e-11
VSKIENGTVIDHIPAGRALTVLRILGISGKEGLRVALVMNVESKKLGKKDIVKIEGRELTPEEVNIISAVAPTATINIIRNFAVVKKFKVTPP
> Q8ZB38^.^9^100^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^156.00^0.000e+00^1.000e-38
VEAIKCGTVIDHIPAQIGFKLLSLFKLTATDQRITIGLNLPSKRSGRKDLIKIENTFLTEQQANQLAMYAPDATVNRIDNYEVVKKLTLSLP
> Q8Z130^.^8^99^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^181.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTDEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> Q8U374^.^6^99^.^2^Class 1^.^.^Fold 1^Superfamily 1^Family 2^PSIBLAST^92.00^0.000e+00^3.000e-19
VSAIKEGTVIDHIPAGKGLKVIQILGLGELKNGGAVLLAMNVPSKKLGRKDIVKVEGKFLSEEEVNKIALVAPTATVNIIREYKVVEKFKVEIP
> Q8TVB1^.^7^98^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^72.70^0.000e+00^2.000e-13
VKRIEMGTVLDHLPPGTAPQIMRILDIDPTETTLLVAINVESSKMGRKDILKIEGKILSEEEANKVALVAPNATVNIVRDYSVAEKFQVKPP
> Q8THL3^.^9^100^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^69.20^0.000e+00^2.000e-12
IQAIENGTVIDHITAGQALNVLRILRISSAFRATVSFVMNAPGARGKKDVVKIEGKELSVEELNRIALISPKATINIIRDFEVVQKNKVVLP
> Q8PXK6^.^9^100^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^62.70^0.000e+00^2.000e-10
VQAIESGTVIDHIKSGQALNVLRILGISSAFRATISFVMNAPGAGGKKDVVKIEGKELSVEELNRIALISPKATINIIRDFVVVQKNNVVLP
> Q8K9H8^.^8^99^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^146.00^0.000e+00^1.000e-35
VEAIKSGSVIDHIPAHIGFKLLSLFRFTETEKRITIGLNLPSQKLDKKDIIKIENTFLSDDQINQLAIYAPCATVNYIEKYNLVGKIFPSLP
> Q8DCF7^.^9^100^.^3^Class 1^.^.^Fold 1^Superfamily 2^Family 1^PSIBLAST^127.00^0.000e+00^9.000e-30
VEAIKNGTVIDHIPAQVGIKVLKLFDMHNSSQRVTIGLNLPSSALGNKDLLKIENVFINEEQASKLALYAPHATVNQIEDYQVVKKLALELP
> Q8D1W6^.^9^100^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^123.00^0.000e+00^1.000e-28
VEAIFGGTVIDHIPAQVGLKLLSLFKWLHTKERITMGLNLPSNQQKKKDLIKLENVLLNEDQANQLSIYAPLATVNQIKNYIVIKKQKLKLP
> Q8A9S4^.^10^101^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^63.80^0.000e+00^9.000e-11
VAALKNGTVIDHIPSEKLFTVVQLLGVEQMKCNITIGFNLDSKKLGKKGIIKIADKFFCDEEINRISVVAPYVKLNIIRDYEVVEKKEVRMP
> Q891I9^.^4^94^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^52.30^0.000e+00^2.000e-07
ITSIKDGIVIDHIKSGYGIKIFNYLNLKNVEYSVALIMNVFSSKLGKKDIIKIANKEIDIDFTVLGLIDPTITINIIEDEKIKEKLNLELP
> Q87LF7^.^9^100^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^130.00^0.000e+00^7.000e-31
VEAIKNGTVIDHIPAQIGIKVLKLFDMHNSSQRVTIGLNLPSSALGHKDLLKIENVFINEEQASKLALYAPHATVNQIENYEVVKKLALELP
> Q83IL8^.^8^99^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^189.00^0.000e+00^0.000e+00
VEAIKRGTVIDHIPAQIGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLSEEQVDQLALYAPQATVNRIDNYEVVGKSRPSLP
> Q7P144^.^7^98^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^128.00^0.000e+00^3.000e-30
VEALKQGTVIDHIPAGEGVKILRLFKLTETGERVTVGLNLVSRHMGSKDLIKVENVALTEEQANELALFAPKATVNVIDNFEVVKKHKLTLP
> Q7MZ14^.^9^100^.^4^Class 1^.^.^Fold 1^Superfamily 2^Family 2^PSIBLAST^150.00^0.000e+00^6.000e-37
VEAIRCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSNRLGKKDLIKIENTFLTEQQANQLAMYAPNATVNCIENYEVVKKLPINLP
> Q7MX57^.^8^99^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^80.80^0.000e+00^7.000e-16
VAAIRNGIVIDHIPPTKLFKVATLLQLDDLDKRITIGNNLRSRSHGSKGVIKIEDKTFEEEELNRIALIAPNVRLNIIRDYEVVEKRQVEVP
> Q7MHF0^.^9^100^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^127.00^0.000e+00^8.000e-30
VEAIKNGTVIDHIPAQVGIKVLKLFDMHNSSQRVTIGLNLPSSALGNKDLLKIENVFINEEQASKLALYAPHATVNQIEDYQVVKKLALELP
> Q58801^.^9^99^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^61.50^0.000e+00^5.000e-10
VKKITNGTVIDHIDAGKALMVFKVLNVPKETSVMIAINVPSKKKGKKDILKIEGIELKKEDVDKISLISPDVTINIIRNGKVVEKLKPQIP
> P96175^.^8^99^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^107.00^0.000e+00^7.000e-24
VEAICNGYVIDHIPSGQGVKILRLFSLTDTKQRVTVGFNLPSHDGTTKDLIKVENTEITKSQANQLALLAPNATVNIIENFKVTDKHSLALP
> P96111^.^375^472^.^5^Class 1^.^.^Fold 2^Superfamily 1^Family 1^PSIBLAST^47.30^0.000e+00^9.000e-06
GIKPIENGTVIDHIAKGKTPEEIYSTILKIRKILRLYDVDSADGIFRSSDGSFKGYISLPDRYLSKKEIKKLSAISPNTTVNIIKNSTVVEKYRIKLP
> P77919^.^6^99^.^6^Class 1^.^.^Fold 2^Superfamily 1^Family 2^PSIBLAST^93.50^0.000e+00^1.000e-19
VSAIKEGTVIDHIPAGKGLKVIEILKLGKLTNGGAVLLAMNVPSKKLGRKDIVKVEGRFLSEEEVNKIALVAPNATVNIIRDYKVVEKFKVEVP
> P74766^.^12^104^.^6^Class 1^.^.^Fold 2^Superfamily 1^Family 2^PSIBLAST^74.20^0.000e+00^7.000e-14
VSKIKNGTVIDHIPAGRAFAVLNVLGIKGHEGFRIALVINVDSKKMGKKDIVKIEDKEISDTEANLITLIAPTATINIVREYEVVKKTKLEVP
> P57451^.^8^99^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^143.00^0.000e+00^1.000e-34
VEAIKSGSVIDHIPEYIGFKLLSLFRFTETEKRITIGLNLPSKKLGRKDIIKIENTFLSDEQINQLAIYAPHATVNYINEYNLVRKVFPTLP
> P19936^.^8^99^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^159.00^0.000e+00^1.000e-39
VEAIKCGTVIDHIPAQIGFKLLTLFKLTATDQRITIGLNLPSNELGRKDLIKIENTFLTEQQANQLAMYAPKATVNRIDNYEVVRKLTLSLP
> P08421^.^8^99^.^7^Class 1^.^.^Fold 2^Superfamily 2^Family 1^PSIBLAST^183.00^0.000e+00^0.000e+00
VEAIKCGTVIDHIPAQVGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLTEEQVNQLALYAPQATVNRIDNYDVVGKSRPSLP
> P00478^.^8^99^.^8^Class 1^.^.^Fold 2^Superfamily 2^Family 2^PSIBLAST^191.00^0.000e+00^0.000e+00
VEAIKRGTVIDHIPAQIGFKLLSLFKLTETDQRITIGLNLPSGEMGRKDLIKIENTFLSEDQVDQLALYAPQATVNRIDNYEVVGKSRPSLP
> O58452^.^6^99^.^8^Class 1^.^.^Fold 2^Superfamily 2^Family 2^PSIBLAST^94.30^0.000e+00^6.000e-20
VSAIKEGTVIDHIPAGKGLKVIEILGLSKLSNGGSVLLAMNVPSKKLGRKDIVKVEGKFLSEEEVNKIALVAPTATVNIIRNYKVVEKFKVEVP
> O30129^.^6^98^.^9^Class 2^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^79.60^0.000e+00^2.000e-15
VSKIKEGTVIDHINAGKALLVLKILKIQPGTDLTVSMAMNVPSSKMGKKDIVKVEGMFIRDEELNKIALISPNATINLIRDYEIERKFKVSPP
> O26938^.^11^101^.^54894^Class 1^.^.^Fold 1^Superfamily 1^Family 1^PSIBLAST^81.90^0.000e+00^3.000e-16
VKPIKNGTVIDHITANRSLNVLNILGLPDGRSKVTVAMNMDSSQLGSKDIVKIENRELKPSEVDQIALIAPRATINIVRDYKIVEKAKVRL
-->


4.0 OUTPUT FILE FORMAT

The format of the hits file is described in ROCPLOT documentation. See also Figure 3.

Output files for usage example

File: rocon.hits

> RELATED 8 ; ROC 2
CROSS        Q8Z130    8     99    
UNKNOWN      Q9YBD5    181   235   
FALSE        P96175    8     99    
TRUE         O26938    11    101   
FALSE        Q7MX57    8     99    
CROSS        Q8TVB1    7     98    
TRUE         Q9YBD5    11    105   
TRUE         Q9YBD5    95    135




5.0 DATA FILES

None.


6.0 USAGE 

Generates a hits file from comparing two DHF files
Version: EMBOSS:6.3.0

   Standard (Mandatory) qualifiers:
  [-hitsinfile]        infile     This option specifies the location of the
                                  DHF file (domain hits file) (input). A
                                  'domain hits file' contains database hits
                                  (sequences) with domain classification
                                  information, in the DHF format (FASTA or
                                  EMBL-like). The hits are relatives to a SCOP
                                  or CATH family and are found from a search
                                  of a sequence database. Files containing
                                  hits retrieved by PSIBLAST are generated by
                                  using SEQSEARCH, hits retrieved by a sparse
                                  protein signatare by using SIGSCAN or
                                  various types of HMM and profile by using
                                  LIBSCAN.
  [-validinfile]       infile     This option specifies the name of domain
                                  families file (input). A 'domain families
                                  file' contains sequence relatives (hits) for
                                  each of a number of different SCOP or CATH
                                  families found from searching a sequence
                                  database, e.g. by using SEQSEARCH
                                  (psiblast). The file contains the collated
                                  search results for the indvidual families;
                                  only those hits of unambiguous family
                                  assignment are included. Hits of ambiguous
                                  family assignment are assigned as relatives
                                  to a SCOP or CATH superfamily or fold
                                  instead and are collated into a 'domain
                                  ambiguities file'. The domain families and
                                  ambiguities files are generated by using
                                  SEQSORT and use the same format as a DHF
                                  file (domain hits file).
   -thresh             integer    [10] This option specifies the overlap
                                  threshold for hits. This is the minimum
                                  length (residues) of overlap required for
                                  two hits with the accession number to be
                                  counted as the same hit. The accession
                                  number of the hit, and the start and end
                                  point respectively of the hit relative to
                                  full length sequence are provided in the
                                  lists of hits in the DHF input file. The
                                  overlap is determined from the start and end
                                  points of the hit. For example two hits
                                  with the start and end points of 1-100 and
                                  91-190 respectively are considered to be the
                                  same hit if they have the same accession
                                  numbers and the overlap threshold is 10 or
                                  less. (Any integer value)
   -mode               menu       [1] This option specifies the classification
                                  scheme to use. See ROCON on-line
                                  documentation for more information. (Values:
                                  1 (Family classification scheme); 2 ((Not
                                  yet available)))
  [-hitsoutfile]       outfile    [*.rocon] This option specifies the name of
                                  the hits files (output). A 'hits
                                  file'contains a list of hits (e.g. from a
                                  prediction method) that are classified and
                                  rank-ordered on the basis of score, p-value,
                                  E-value etc. The files generated by using
                                  SIGSCAN and LIBSCAN will contain the results
                                  of a search of a discriminating element
                                  (e.g. hidden Markov model, profile or
                                  signature) against a sequence database. The
                                  ROCPLOT application is run on the files to
                                  perform Receiver Operator Characteristic
                                  (ROC) analysis on the hits.

   Additional (Optional) qualifiers: (none)
   Advanced (Unprompted) qualifiers: (none)
   Associated qualifiers:

   "-hitsoutfile" associated qualifiers
   -odirectory3        string     Output directory

   General qualifiers:
   -auto               boolean    Turn off prompts
   -stdout             boolean    Write first file to standard output
   -filter             boolean    Read first file from standard input, write
                                  first file to standard output
   -options            boolean    Prompt for standard and additional values
   -debug              boolean    Write debug output to program.dbg
   -verbose            boolean    Report some/full command line options
   -help               boolean    Report command line options and exit. More
                                  information on associated and general
                                  qualifiers can be found with -help -verbose
   -warning            boolean    Report warnings
   -error              boolean    Report errors
   -fatal              boolean    Report fatal errors
   -die                boolean    Report dying program messages
   -version            boolean    Report version number and exit

6.1 COMMAND LINE ARGUMENTS

Qualifier Type Description Allowed values Default
Standard (Mandatory) qualifiers
[-hitsinfile]
(Parameter 1)		 infile This option specifies the location of the DHF file (domain hits file) (input). A 'domain hits file' contains database hits (sequences) with domain classification information, in the DHF format (FASTA or EMBL-like). The hits are relatives to a SCOP or CATH family and are found from a search of a sequence database. Files containing hits retrieved by PSIBLAST are generated by using SEQSEARCH, hits retrieved by a sparse protein signatare by using SIGSCAN or various types of HMM and profile by using LIBSCAN. Input file Required
[-validinfile]
(Parameter 2)		 infile This option specifies the name of domain families file (input). A 'domain families file' contains sequence relatives (hits) for each of a number of different SCOP or CATH families found from searching a sequence database, e.g. by using SEQSEARCH (psiblast). The file contains the collated search results for the indvidual families; only those hits of unambiguous family assignment are included. Hits of ambiguous family assignment are assigned as relatives to a SCOP or CATH superfamily or fold instead and are collated into a 'domain ambiguities file'. The domain families and ambiguities files are generated by using SEQSORT and use the same format as a DHF file (domain hits file). Input file Required
-thresh integer This option specifies the overlap threshold for hits. This is the minimum length (residues) of overlap required for two hits with the accession number to be counted as the same hit. The accession number of the hit, and the start and end point respectively of the hit relative to full length sequence are provided in the lists of hits in the DHF input file. The overlap is determined from the start and end points of the hit. For example two hits with the start and end points of 1-100 and 91-190 respectively are considered to be the same hit if they have the same accession numbers and the overlap threshold is 10 or less. Any integer value 10
-mode list This option specifies the classification scheme to use. See ROCON on-line documentation for more information.
1 (Family classification scheme)
2 ((Not yet available))
 1
[-hitsoutfile]
(Parameter 3)		 outfile This option specifies the name of the hits files (output). A 'hits file'contains a list of hits (e.g. from a prediction method) that are classified and rank-ordered on the basis of score, p-value, E-value etc. The files generated by using SIGSCAN and LIBSCAN will contain the results of a search of a discriminating element (e.g. hidden Markov model, profile or signature) against a sequence database. The ROCPLOT application is run on the files to perform Receiver Operator Characteristic (ROC) analysis on the hits. Output file <*>.rocon
Additional (Optional) qualifiers
(none)
Advanced (Unprompted) qualifiers
(none)
Associated qualifiers
"-hitsoutfile" associated outfile qualifiers
-odirectory3
-odirectory_hitsoutfile		 string Output directory Any string  
General qualifiers
-auto boolean Turn off prompts Boolean value Yes/No N
-stdout boolean Write first file to standard output Boolean value Yes/No N
-filter boolean Read first file from standard input, write first file to standard output Boolean value Yes/No N
-options boolean Prompt for standard and additional values Boolean value Yes/No N
-debug boolean Write debug output to program.dbg Boolean value Yes/No N
-verbose boolean Report some/full command line options Boolean value Yes/No Y
-help boolean Report command line options and exit. More information on associated and general qualifiers can be found with -help -verbose Boolean value Yes/No N
-warning boolean Report warnings Boolean value Yes/No Y
-error boolean Report errors Boolean value Yes/No Y
-fatal boolean Report fatal errors Boolean value Yes/No Y
-die boolean Report dying program messages Boolean value Yes/No Y
-version boolean Report version number and exit Boolean value Yes/No N

6.2 EXAMPLE SESSION

An example of interactive use of ROCON is shown below. Here is a sample session with rocon 


% rocon 
Generates a hits file from comparing two DHF files
Domain hits file: rocon/rocon.dhf
Domain families file: rocon.valid
Overlap threshold for hits. [10]: 10
Classification scheme to use
         1 : Family classification scheme
         2 : (Not yet available)
Select number. [1]: 1
Hits output file [hits.dhf]: rocon.hits

Go to the input files for this example
Go to the output files for this example




7.0 KNOWN BUGS & WARNINGS

None.


8.0 NOTES

None.

8.1 GLOSSARY OF FILE TYPES

FILE TYPE FORMAT DESCRIPTION CREATED BY SEE ALSO
Domain hits file DHF format (FASTA-like). Database hits (sequences) with domain classification information. The hits are relatives to a SCOP or CATH family (or other node in the structural hierarchies) and are found from a search of a sequence database. SEQSEARCH (hits retrieved by PSIBLAST) N.A.
Hits file Text file of classified hits A list of hits (e.g. from a prediction method) that are classified and rank-ordered on the basis of score, p-value, E-value etc. SIGSCAN and LIBSCAN (hits from searches of a discriminating element (hidden Markov model, profile or signature) against a sequence database). ROCPLOT is run on the files to perform Receiver Operator Characteristic (ROC) analysis on the hits.
Domain families & ambiguities file DHF format (FASTA-like). Contains sequence relatives (hits) for each of a number of different SCOP or CATH families found from PSIBLAST searches of a sequence database. The file contains the collated search results for the indvidual families; only those hits of unambiguous family assignment are included. Hits of ambiguous family assignment are assigned as relatives to a SCOP or CATH superfamily or fold instead and are collated into a 'domain ambiguities file'. SEQSORT N.A.
None


9.0 DESCRIPTION

Discrciminating elements such as hidden Markov models (HMM), sparse protein signatures and profiles can be generated for a set of proteins with related sequence, structural or functional properties. These discriminators are characteristic of the property considered and can be used diagnostically, for instance, by screening a database of uncharacterised sequences.

Such screens can be performed by using the LIBSCAN and SIGSCAN applications, which generate a DHF file (domain hits file) of database hits (sequences). The hits are relatives to a SCOP or CATH family (or other node in the structural hierarchies) and are found from a search of a sequence database. The DHF file includes domain classification information of the family in question.

When assessing the performance of a predictive method, a "gold standard" of truth is required. This is a set of examples that are known to be related to the discriminating element, and, ideally, a further set that is known to be definitely not related. For example, to assess a protein family HMM to detect true members of that family requires, at least, a list of the known family members. If a method works well for the "gold standard" we can infer it will work well generally. Increasingly, use is made of databases such as SCOP, in which sequence, structural and functional relationships are classified.

Such a "gold standard" can be generated for SCOP families by using the DOMAINATRIX package and particularly the SEQSORT application. SEQSORT generates a "domain families file" containing sequence relatives (hits) for each of a number of different SCOP or CATH families found from PSIBLAST searches of a sequence database. The file contains the collated search results for the indvidual families; only those hits of unambiguous family assignment are included.

A powerful measure of diagnostic performance is to use Receiver Operator Characteristic (ROC) curves to display graphically the sensitivity and specificity of a method. ROC analysis is implemented in the ROCPLOT application. ROCPLOT requires a "hits file" containing a list of classified hits that are rank-ordered on the basis of score.

The ROCON application was developed to take as input a DHF file of hits, and a domain families file of validation sequences (the gold standard) and generate a hits file for use with ROCPLOT.


10.0 ALGORITHM

The domain families file uses the same format as a DHF file (domain hits file). Thus ROCON takes two DHF files as input, one containing hits (sequences of unknown classification) to be classified and the the domain families file containing sequences (of known classification) that are used to make the classification. A DHF file includes 6 tokens (in bold in the example below) that collectively describe the classification of a sequence as follows: domain class (SCOP and CATH domains), domain architecture (CATH only), domain topology (CATH only), domain fold (SCOP domains only), domain superfamily and domain family (SCOP only) - see below. 

> Q9WVI4^.^513^667^SCOP^.^55074^CLASS^ARCHITECTURE^TOPOLOGY^FOLD^SUPERFAMILY^FAMILY^PSIBLAST^113.00^0.000e+00^2.000e-25
RKFDDVTMLFSDIVGFTAICAQCTPMQVISMLNELYTRFDHQCGFLDIYKVETIGDAYCVASGLHRKSLCHAKPIALMALKMMELSEEVLTPDGRPIQMRIGIHSG


The value of the tokens (CLASS through to FAMILY, but, in the current implementation of classification scheme, excluding ARCHITECTURE and TOPOLOGY) determines the classification of a hit that is given in the ROCON output file as follows.

If a hit does not overlap significantly with any validation sequence then the hit is classified as UNKNOWN. A hit and validation sequence are defined as overlapping if they have identical accesssion number and have a common region of at least a user-defined number of residues. The overlap is determined from the start and end points (relative to the full-length sequences) of the hit and validation sequences. For example a hit and validation sequence with the same accession numbers and with the start and end points of 1-100 and 91 - 190 respectively are defined as overlapping if the overlap threshold is 10 or less.

If a hit does overlap significantly with a validation sequence it is defined as one of TRUE, CROSS or FALSE depending on the value of the tokens (CLASS through to FAMILY) as per the table below.
CLASS FOLD SUPERFAMILY FAMILY CLASSIFICATION
Not available Not available Not available Not available UNKNOWN
Different Different Different Different FALSE
Same Different Different Different FALSE
Same Same Different Different CROSS
Same Same Same Different CROSS
Same Same Same Same TRUE


Putting this in context of a real example, imagine an input DHF file containing hits derived from searching a sequence database with a novel type of profile specific to a SCOP family. In this case, the full SCOP classification (Class, Fold etc) of the hit are putatively assigned. To validate the novel method a validation file of manually curated sequences of known classification are used. A TRUE hit would be one that overlaps with a validation sequence belonging to the same Family (and by implication Superfamily, Fold and Class) to the hit. A CROSS hit overlaps with a sequence of the same fold, but different family, as a validation sequence, and a FALSE hit overlaps with a sequence of a different fold to the hit.

The hits are rank-ordered on the basis of score before they are written to the the Hits (output) file.


11.0 RELATED APPLICATIONS

See also

Program name Description
contacts Generate intra-chain CON files from CCF files
domainalign Generate alignments (DAF file) for nodes in a DCF file
domainrep Reorder DCF file to identify representative structures
domainreso Remove low resolution domains from a DCF file
interface Generate inter-chain CON files from CCF files
libgen Generate discriminating elements from alignments
matgen3d Generate a 3D-1D scoring matrix from CCF files
psiphi Calculates phi and psi torsion angles from protein coordinates
rocplot Performs ROC analysis on hits files
seqalign Extend alignments (DAF file) with sequences (DHF file)
seqfraggle Removes fragment sequences from DHF files
seqsearch Generate PSI-BLAST hits (DHF file) from a DAF file
seqsort Remove ambiguous classified sequences from DHF files
seqwords Generates DHF files from keyword search of UniProt
siggen Generates a sparse protein signature from an alignment
siggenlig Generates ligand-binding signatures from a CON file
sigscan Generates hits (DHF file) from a signature search
sigscanlig Searches ligand-signature library and writes hits (LHF file)



12.0 DIAGNOSTIC ERROR MESSAGES

None.


13.0 AUTHORS

Jon Ison (jison@ebi.ac.uk)
The European Bioinformatics Institute Wellcome Trust Genome Campus Cambridge CB10 1SD UK


14.0 REFERENCES

Please cite the authors and EMBOSS.

Rice P, Longden I and Bleasby A (2000) "EMBOSS - The European Molecular Biology Open Software Suite" Trends in Genetics, 15:276-278.

See also http://emboss.sourceforge.net/

14.1 Other useful references