/tools/regVariation/compute_motifs_frequency.xml

https://bitbucket.org/cistrome/cistrome-harvard/ · XML · 109 lines · 73 code · 36 blank · 0 comment · 0 complexity · 9f0c2dc82febf40c4c17c789802bc72b MD5 · raw file

  1. <tool id="compute_motifs_frequency" name="Compute Motif Frequencies" version="1.0.0">
  2. <description>in indel flanking regions</description>
  3. <command interpreter="perl">
  4. compute_motifs_frequency.pl $inputFile1 $inputFile2 $inputNumber3 $outputFile1 $outputFile2
  5. </command>
  6. <inputs>
  7. <param format="tabular" name="inputFile1" type="data" label="Select motifs file"/>
  8. <param format="tabular" name="inputFile2" type="data" label="Select indel flanking regions file from your history"/>
  9. <param type="integer" name="inputNumber3" size="5" value="0" label="What is the size of each window?" help="'0' = all the upstream flanking sequence will be one window only, and the same for the downstream flanking sequence."/>
  10. </inputs>
  11. <outputs>
  12. <data format="tabular" name="outputFile1"/>
  13. <data format="tabular" name="outputFile2"/>
  14. </outputs>
  15. <tests>
  16. <test>
  17. <param name="inputFile1" value="motifs1.tabular" />
  18. <param name="inputFile2" value="indelsFlankingSequences1.tabular" />
  19. <param name="inputNumber3" value="0" />
  20. <output name="outputFile1" file="flankingSequencesWindows0.tabular" />
  21. <output name="outputFile2" file="motifFrequencies0.tabular" />
  22. </test>
  23. <test>
  24. <param name="inputFile1" value="motifs1.tabular" />
  25. <param name="inputFile2" value="indelsFlankingSequences1.tabular" />
  26. <param name="inputNumber3" value="10" />
  27. <output name="outputFile1" file="flankingSequencesWindows10.tabular" />
  28. <output name="outputFile2" file="motifFrequencies10.tabular" />
  29. </test>
  30. </tests>
  31. <help>
  32. .. class:: infomark
  33. **What it does**
  34. This program computes the frequency of motifs in the flanking regions of indels found in a chromosome or a genome.
  35. Each indel has an upstream flanking sequence and a downstream flanking one. Each of the upstream and downstream flanking
  36. sequences will be divided into a certain number of windows according to the window size input by the user.
  37. The frequency of a motif in a certain window in one of the two flanking sequences is the total sum of occurrences of
  38. that motif in that window of that flanking sequence over all indels. The indel flanking regions file will be taken
  39. from your history or it will be uploaded, whereas the motifs file should be uploaded.
  40. - The first input file is the motifs file and it is a tabular file consisting of two columns:
  41. - the first column represents the motif name
  42. - the second column represents the motif sequence, as follows::
  43. dnaPolPauseFrameshift1 GAG
  44. dnaPolPauseFrameshift2 ACG
  45. xSites1 CCG
  46. - The second input file is the indels flanking regions file and it is a tabular file consisting of five columns:
  47. - the first column represents the indel start coordinate
  48. - the second column represents the indel end coordinate
  49. - the third column represents the indel length
  50. - the fourth column represents the upstream flanking sequence
  51. - the fifth column represents the upstream flanking sequence, as follows::
  52. 16694766 16694768 3 GTGGGTCCTGCCCAGCCTCTGCCTCAGAGGGAAGAGTAGAGAACTGGG AGAGCAGGTCCTTAGGGAGCCCGAGGAAGTCCCTGACGCCAGCTGTTCTCGCGGACGAA
  53. 25169542 25169545 4 caagcccacaagccttcagaccatagcaCGGGCTCCAGAGGTGTGAGG CAGGTCAGGTGCTTTAGAAGTCAAAAACTCTCAGTAAGGCAAATCACCCCCTATCTCCT
  54. 41929580 41929585 6 ggctgtcgtatggaatctggggctcaggactctgtcccatttctctaa accattctgcTTCAACCCAGACACTGACTGTTTTCCAAATTTACTTGTTTGTTTGTTTT
  55. -----
  56. .. class:: warningmark
  57. **Notes**
  58. - The lengths of the upstream flanking sequences must be equal for all indels.
  59. - The lengths of the downstream flanking sequences must be equal for all indels.
  60. - If the length of the upstream flanking sequence L is not an integer multiple of the window size S, in other words if L/S = m + r where m is the result of division and r is the remainder, then the upstream flanking sequence will be divided into m windows only starting from the indel, and the rest of the sequence will not be considered. The same rule applies to the downstream flanking sequence.
  61. -----
  62. The **output** of this program is two files:
  63. - The first output file is a tabular file and represents the windows of both upstream and downstream flanking sequences. It consists of multiple left columns representing the windows of the upstream flanking sequence, followed by one column representing the indels, then followed by multiple right columns representing the windows of the downstream flanking sequence, as follows::
  64. cgaggtcagg agatcgagac catcctggct aacatggtga aatcccgtct ctactaaaaa indel aaatttatat ttataaacaa ttttaataca cctatgttta ttatacattt
  65. GCCAGTTTAT GGTCTAACAA GGAGAGAAAC AGGGGGCTGA AGGGGTTTCT TAACCTCCAG indel TTCCGGGCTC TGTCCCTAAC CCCCAGCTAG GTAAGTGGCA AAGCACTTCT
  66. CAGTGGGACC AAGCACTGAA CCACTTTGGG GAGAATCTCA CACTGGGGCC CTCTGACACC indel tatatatttt tttttttttt tttttttttt tttttttttg agatggtgtc
  67. AGAGCAGCAG CACCCACTTT TGCAGTGTGT GACGTTGGTG GAGCCATCGA AGTCTGTGCT indel GAGCCCTCCC CAGTGCTCCG AGGAGCTGCT GTTCCCCCTG GAGCTCAGAA
  68. - The second output file is a tabular file and represents the motif frequencies in every window of every flanking sequence. The first column on the left represents the names of motifs. The other columns represent the frequencies of motifs in the windows that correspond to the ones in the first output file, as follows::
  69. dnaPolPauseFrameshift1 2 3 1 0 1 2 indel 0 2 2 1 3
  70. dnaPolPauseFrameshift2 2 3 1 0 1 2 indel 0 2 2 1 3
  71. xSites1 3 2 0 1 1 2 indel 1 1 3 2 3
  72. </help>
  73. </tool>