syco Wiki The master copies of EMBOSS documentation are available at http://emboss.open-bio.org/wiki/Appdocs on the EMBOSS Wiki. Please help by correcting and extending the Wiki pages. Function Draw synonymous codon usage statistic plot for a nucleotide sequence Description syco may is a frame-specific gene finder that tries to recognize protein coding sequences by virtue of the similarity of their codon usage to a codon frequency table. Given a codon usage file and an input nucleotide sequence, syco draws a plot of the synonymous codon usage Gribskov statistic calculated for windows over the sequence. The same data may be written to an output file. syco finds regions of each forward reading frame of a nucleic acid sequence that show strong codon preference. syco is useful for locating protein coding regions, determining their reading frames, estimating the level of expression of a gene, and locating nucleic acid sequencing errors. It is essential to use the correct codon usage file for the species. Optionally the most common codon usage can be displayed, based on a minimum fraction of the codons for an amino acid. Usage Here is a sample session with syco % syco -plot -cfile Epseae.cut Draw synonymous codon usage statistic plot for a nucleotide sequence Input nucleotide sequence: tembl:x13776 Graph type [x11]: ps Created syco.ps Go to the input files for this example Go to the output files for this example Command line arguments Draw synonymous codon usage statistic plot for a nucleotide sequence Version: EMBOSS:6.4.0.0 Standard (Mandatory) qualifiers (* if not always prompted): [-sequence] sequence Nucleotide sequence filename and optional format, or reference (input USA) -cfile codon Codon usage file * -graph xygraph [$EMBOSS_GRAPHICS value, or x11] Graph type (ps, hpgl, hp7470, hp7580, meta, cps, x11, tek, tekt, none, data, xterm, png, gif, pdf, svg) * -outfile outfile [*.syco] Output file name Additional (Optional) qualifiers: (none) Advanced (Unprompted) qualifiers: -window integer [30] Averaging window (Any integer value) -uncommon boolean [N] Show common codon usage -minimum float [.15] Minimum value for a common codon (Number from 0.000 to 0.990) -[no]plot toggle [Y] Produce plot Associated qualifiers: "-sequence" associated qualifiers -sbegin1 integer Start of the sequence to be used -send1 integer End of the sequence to be used -sreverse1 boolean Reverse (if DNA) -sask1 boolean Ask for begin/end/reverse -snucleotide1 boolean Sequence is nucleotide -sprotein1 boolean Sequence is protein -slower1 boolean Make lower case -supper1 boolean Make upper case -sformat1 string Input sequence format -sdbname1 string Database name -sid1 string Entryname -ufo1 string UFO features -fformat1 string Features format -fopenfile1 string Features file name "-cfile" associated qualifiers -format string Data format "-graph" associated qualifiers -gprompt boolean Graph prompting -gdesc string Graph description -gtitle string Graph title -gsubtitle string Graph subtitle -gxtitle string Graph x axis title -gytitle string Graph y axis title -goutfile string Output file for non interactive displays -gdirectory string Output directory "-outfile" associated qualifiers -odirectory 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 Input file format syco reads a single nucleotide sequence. The input is a standard EMBOSS sequence query (also known as a 'USA'). Major sequence database sources defined as standard in EMBOSS installations include srs:embl, srs:uniprot and ensembl Data can also be read from sequence output in any supported format written by an EMBOSS or third-party application. The input format can be specified by using the command-line qualifier -sformat xxx, where 'xxx' is replaced by the name of the required format. The available format names are: gff (gff3), gff2, embl (em), genbank (gb, refseq), ddbj, refseqp, pir (nbrf), swissprot (swiss, sw), dasgff and debug. See: http://emboss.sf.net/docs/themes/SequenceFormats.html for further information on sequence formats. Input files for usage example 'tembl:x13776' is a sequence entry in the example nucleic acid database 'tembl' Database entry: tembl:x13776 ID X13776; SV 1; linear; genomic DNA; STD; PRO; 2167 BP. XX AC X13776; M43175; XX DT 19-APR-1989 (Rel. 19, Created) DT 14-NOV-2006 (Rel. 89, Last updated, Version 24) XX DE Pseudomonas aeruginosa amiC and amiR gene for aliphatic amidase regulation XX KW aliphatic amidase regulator; amiC gene; amiR gene. XX OS Pseudomonas aeruginosa OC Bacteria; Proteobacteria; Gammaproteobacteria; Pseudomonadales; OC Pseudomonadaceae; Pseudomonas. XX RN [1] RP 1167-2167 RA Rice P.M.; RT ; RL Submitted (16-DEC-1988) to the EMBL/GenBank/DDBJ databases. RL Rice P.M., EMBL, Postfach 10-2209, Meyerhofstrasse 1, 6900 Heidelberg, FRG. XX RN [2] RP 1167-2167 RX DOI; 10.1016/0014-5793(89)80249-2. RX PUBMED; 2495988. RA Lowe N., Rice P.M., Drew R.E.; RT "Nucleotide sequence of the aliphatic amidase regulator gene (amiR) of RT Pseudomonas aeruginosa"; RL FEBS Lett. 246(1-2):39-43(1989). XX RN [3] RP 1-1292 RX PUBMED; 1907262. RA Wilson S., Drew R.; RT "Cloning and DNA sequence of amiC, a new gene regulating expression of the RT Pseudomonas aeruginosa aliphatic amidase, and purification of the amiC RT product"; RL J. Bacteriol. 173(16):4914-4921(1991). XX RN [4] RP 1-2167 RA Rice P.M.; RT ; RL Submitted (04-SEP-1991) to the EMBL/GenBank/DDBJ databases. RL Rice P.M., EMBL, Postfach 10-2209, Meyerhofstrasse 1, 6900 Heidelberg, FRG. XX DR GOA; Q51417. DR InterPro; IPR003211; AmiSUreI_transpt. DR UniProtKB/Swiss-Prot; Q51417; AMIS_PSEAE. [Part of this file has been deleted for brevity] FT /replace="" FT /note="ClaI fragment deleted in pSW36, constitutive FT phenotype" FT misc_feature 1 FT /note="last base of an XhoI site" FT misc_feature 648..653 FT /note="end of 658bp XhoI fragment, deletion in pSW3 causes FT constitutive expression of amiE" FT conflict 1281 FT /replace="g" FT /citation=[3] XX SQ Sequence 2167 BP; 363 A; 712 C; 730 G; 362 T; 0 other; ggtaccgctg gccgagcatc tgctcgatca ccaccagccg ggcgacggga actgcacgat 60 ctacctggcg agcctggagc acgagcgggt tcgcttcgta cggcgctgag cgacagtcac 120 aggagaggaa acggatggga tcgcaccagg agcggccgct gatcggcctg ctgttctccg 180 aaaccggcgt caccgccgat atcgagcgct cgcacgcgta tggcgcattg ctcgcggtcg 240 agcaactgaa ccgcgagggc ggcgtcggcg gtcgcccgat cgaaacgctg tcccaggacc 300 ccggcggcga cccggaccgc tatcggctgt gcgccgagga cttcattcgc aaccgggggg 360 tacggttcct cgtgggctgc tacatgtcgc acacgcgcaa ggcggtgatg ccggtggtcg 420 agcgcgccga cgcgctgctc tgctacccga ccccctacga gggcttcgag tattcgccga 480 acatcgtcta cggcggtccg gcgccgaacc agaacagtgc gccgctggcg gcgtacctga 540 ttcgccacta cggcgagcgg gtggtgttca tcggctcgga ctacatctat ccgcgggaaa 600 gcaaccatgt gatgcgccac ctgtatcgcc agcacggcgg cacggtgctc gaggaaatct 660 acattccgct gtatccctcc gacgacgact tgcagcgcgc cgtcgagcgc atctaccagg 720 cgcgcgccga cgtggtcttc tccaccgtgg tgggcaccgg caccgccgag ctgtatcgcg 780 ccatcgcccg tcgctacggc gacggcaggc ggccgccgat cgccagcctg accaccagcg 840 aggcggaggt ggcgaagatg gagagtgacg tggcagaggg gcaggtggtg gtcgcgcctt 900 acttctccag catcgatacg cccgccagcc gggccttcgt ccaggcctgc catggtttct 960 tcccggagaa cgcgaccatc accgcctggg ccgaggcggc ctactggcag accttgttgc 1020 tcggccgcgc cgcgcaggcc gcaggcaact ggcgggtgga agacgtgcag cggcacctgt 1080 acgacatcga catcgacgcg ccacaggggc cggtccgggt ggagcgccag aacaaccaca 1140 gccgcctgtc ttcgcgcatc gcggaaatcg atgcgcgcgg cgtgttccag gtccgctggc 1200 agtcgcccga accgattcgc cccgaccctt atgtcgtcgt gcataacctc gacgactggt 1260 ccgccagcat gggcggggga ccgctcccat gagcgccaac tcgctgctcg gcagcctgcg 1320 cgagttgcag gtgctggtcc tcaacccgcc gggggaggtc agcgacgccc tggtcttgca 1380 gctgatccgc atcggttgtt cggtgcgcca gtgctggccg ccgccggaag ccttcgacgt 1440 gccggtggac gtggtcttca ccagcatttt ccagaatggc caccacgacg agatcgctgc 1500 gctgctcgcc gccgggactc cgcgcactac cctggtggcg ctggtggagt acgaaagccc 1560 cgcggtgctc tcgcagatca tcgagctgga gtgccacggc gtgatcaccc agccgctcga 1620 tgcccaccgg gtgctgcctg tgctggtatc ggcgcggcgc atcagcgagg aaatggcgaa 1680 gctgaagcag aagaccgagc agctccagga ccgcatcgcc ggccaggccc ggatcaacca 1740 ggccaaggtg ttgctgatgc agcgccatgg ctgggacgag cgcgaggcgc accagcacct 1800 gtcgcgggaa gcgatgaagc ggcgcgagcc gatcctgaag atcgctcagg agttgctggg 1860 aaacgagccg tccgcctgag cgatccgggc cgaccagaac aataacaaga ggggtatcgt 1920 catcatgctg ggactggttc tgctgtacgt tggcgcggtg ctgtttctca atgccgtctg 1980 gttgctgggc aagatcagcg gtcgggaggt ggcggtgatc aacttcctgg tcggcgtgct 2040 gagcgcctgc gtcgcgttct acctgatctt ttccgcagca gccgggcagg gctcgctgaa 2100 ggccggagcg ctgaccctgc tattcgcttt tacctatctg tgggtggccg ccaaccagtt 2160 cctcgag 2167 // Output file format Unless the -noplot qualifier is specified graphical output is produced. Otherwise a text file is written. The output is to the specified graphics device. The results can be output in one of several formats by using the command-line qualifier -graph xxx, where 'xxx' is replaced by the name of the required device. Support depends on the availability of third-party software packages. The device names that output to a file are: ps (postscript), cps (colourps), png, gif, pdf, svg, hpgl, hp7470, hp7580, das, data. The other available device names are: meta, x11 (xwindows), tek (tek4107t), tekt (tektronix), xterm, text. Output can be turned off by specifying none (null). See: http://emboss.sf.net/docs/themes/GraphicsDevices.html for further information on supported devices. Output files for usage example Graphics File: syco.ps [syco results] Data files Codon usage table files are read in. EMBOSS data files are distributed with the application and stored in the standard EMBOSS data directory, which is defined by the EMBOSS environment variable EMBOSS_DATA. To see the available EMBOSS data files, run: % embossdata -showall To fetch one of the data files (for example 'Exxx.dat') into your current directory for you to inspect or modify, run: % embossdata -fetch -file Exxx.dat Users can provide their own data files in their own directories. Project specific files can be put in the current directory, or for tidier directory listings in a subdirectory called ".embossdata". Files for all EMBOSS runs can be put in the user's home directory, or again in a subdirectory called ".embossdata". The directories are searched in the following order: * . (your current directory) * .embossdata (under your current directory) * ~/ (your home directory) * ~/.embossdata Notes None. References None. Warnings None. Diagnostic Error Messages None. Exit status It always exits with status 0. Known bugs None. See also Program name Description cai Calculate codon adaptation index checktrans Reports STOP codons and ORF statistics of a protein chips Calculates Nc codon usage statistic codcmp Codon usage table comparison codcopy Copy and reformat a codon usage table cusp Create a codon usage table from nucleotide sequence(s) getorf Finds and extracts open reading frames (ORFs) marscan Finds matrix/scaffold recognition (MRS) signatures in DNA sequences plotorf Plot potential open reading frames in a nucleotide sequence showorf Display a nucleotide sequence and translation in pretty format sixpack Display a DNA sequence with 6-frame translation and ORFs tcode Identify protein-coding regions using Fickett TESTCODE statistic wobble Plot third base position variability in a nucleotide sequence wobble does the analysis of the third base. Author(s) Alan Bleasby European Bioinformatics Institute, Wellcome Trust Genome Campus, Hinxton, Cambridge CB10 1SD, UK Please report all bugs to the EMBOSS bug team (emboss-bug (c) emboss.open-bio.org) not to the original author. History Target users This program is intended to be used by everyone and everything, from naive users to embedded scripts. Comments None