= Satellite meeting for G-language development =

== Topics ==

Development of REST/SOAP web services for G-language Genome Analysis Environment
 * http://www.g-language.org/
 * http://www.ncbi.nlm.nih.gov/pubmed/12538262
 * http://www.jstage.jst.go.jp/article/jpestics/31/3/282/_pdf

== Participants ==

 * Kazuharu Arakawa
 * Nobuhiro Kido
 * Kazuki Oshita


== togoWS ==

 *  http://togows.dbcls.jp/

{{{
 Name: togoWS   -   runs togoWS REST web services

 Description:
    This is a wrapper around togoWS REST web services provided at
    http://togows.dbcls.jp/.
    
 Usage:
    #search
    @ids = togoWS(-search=>"keyword", -db=>"database");

    #entry
    $entry = togoWS(@ids);

 Options:
    -search  required option for keyword searching. 
    -db      name of the database for searching and entry retrieval
             required for searching, but not required for entry 
             retrieval, since corresponding database is automatically
             selected from the ID format. However, majority of the 
             databases simply use large numbers as IDs, which all
             result in "pubmed" as the databases. Therefore, use 
             of this option is necessary for IDs that are only numbers.
    -field   field name for entry retrieval (optional)
    -format  format name for entry retrieval (optional)
}}}

== REST ==

=== genome flatfile access ===

 * Base URL (list of available genomes):[[BR]]
   * http://www.g-language.org/gb/
 * Syntax:[[BR]]
   * {{{http://www.g-language.org/gb/[genome]/[gene]/[feature]}}}
 * Genomes (nucleotide composition)[[BR]]
   * {{{http://www.g-language.org/gb/[genome]}}}
      * examples:[[BR]]
         * http://www.g-language.org/gb/ecoli (G-language preset genome)[[BR]]
         * http://www.g-language.org/gb/NC_000908 (NCBI RefSeq accession)[[BR]]
         * http://www.g-language.org/gb/B619CD (G-language REST temporary reference id)
 * Genes[[BR]]
   * {{{http://www.g-language.org/gb/[genome]/[gene]}}}
     * examples:[[BR]]
         * http://www.g-language.org/gb/ecoli/recA (common gene name)[[BR]]
         * http://www.g-language.org/gb/ecoli/b2699 (canonical gene name / locus tag)[[BR]]
         * http://www.g-language.org/gb/ecoli/FEATURE5804 (G-language feature id)[[BR]]
         * http://www.g-language.org/gb/ecoli/CDS2646 (G-language CDS id)
 * features[[BR]]
   * {{{http://www.g-language.org/gb/[genome]/[gene]/[feature]}}}
     * examples:[[BR]]
         * http://www.g-language.org/gb/mgen/metX/gene (gene name)[[BR]]
         * http://www.g-language.org/gb/mgen/metX/translation (amino acid sequence)[[BR]]
         * http://www.g-language.org/gb/mgen/*/translation (amino acid sequence of all genes)

=== file upload ===

 * Base URL:[[BR]]
   http://www.g-language.org/gbi/
 * Syntax
   * POST a file to fileform=file
   * File types are automatically interpreted by the system. Supported formats are: ABI, ACE, ALF, BSML, CTF, EMBL, Entrez Gene, Exp, FastA, FastQ, GCG, GenBank, Phd, PIR, PLN, raw, SCF, SWISS.
 * Return
   * Returns a unique reference ID for the uploaded file. You can use this ID for the rest of the analysis so that the large file is not transferred over the network.

=== genome analysis methods ===

 * Base URL (list of available analysis methods):[[BR]]
   * http://www.g-language.org/gba/
 * Syntax:[[BR]]
   * {{{http://www.g-language.org/gba/[genome]/[method]/[required input (if any)]/[option1=value]/[option2=value]...}}}
 * Genome data access[[BR]]
      * examples:[[BR]]
         * http://www.g-language.org/gba/ecoli/before_startcodon/recA (5' upstream sequence of recA gene)[[BR]]
         * http://www.g-language.org/gba/ecoli/get_geneseq/recA (nucleotide sequence of recA gene)[[BR]]
         * http://www.g-language.org/gba/ecoli/cds (get a list of all feature ids)
 * Analysis methods[[BR]]
     * examples:[[BR]]
         * http://www.g-language.org/gba/ecoli/gcskew (GC skew analysis - produces a graph)[[BR]]
         * http://www.g-language.org/gba/ecoli/gcskew/cumulative=1 (cumulative GC skew)[[BR]]
         * http://www.g-language.org/gba/ecoli/gcskew/at=1/cumulative=1/output=f/ (cumulative AT skew - output as csv data)[[BR]]
         * http://www.g-language.org/gba/ecoli/gcsi (GC Skew Index analysis - single double value)
 
== SOAP ==
 * WSDL:
  * http://www.g-language.org/g-language.wsdl
  * 仕様とかコメントあったら書いて>cory

 * Taverna:
  * example
    * workflow 
       * http://hackathon2.dbcls.jp/attachment/wiki/SatelliteG-language/getFasta2gcskew.t2flow
    * Screen shot[[Image(pict5.gif)]]


== AJAX/CGI gateway ==
 * URL: 
  * http://www.g-language.org/gbi/frontend.pl
  * 使い方など>dokky
 * Galaxy Connection:
  * URL? >cory
  * usage? >cory

== Perl Wrapper ==
 * Available at CPAN:
   * http://search.cpan.org/~gaou/Bio-Glite-0.01/lib/Bio/Glite.pm
   * simple install with "sudo cpan Bio::Glite"
   * Bio::Glite has all of the functions G-language API, and very efficiently handles data through REST web service of G-language Project. Source code is extremely lightweight (>100KB), and requires very few (mostly standard) modules.