biojs-vis-gprofiler

Retrieve most relevant terms from g:Profiler and render these as a string cloud.

Getting Started

Install the module with: npm install biojs-vis-gprofiler. Copy the minified module build/biojsvisgprofiler.min.js to your scripts directory.

Usage without a module loader:

<script src="/path/to/biojsvisgprofiler.min.js"></script>
<script type="text/javascript">

document.addEventListener("DOMContentLoaded", function(e) {
  gp = new biojsVisGprofiler({
    container : "#myContainer",
    width     : 600,
    height    : 600,
  });

  gp.on("onrender", function() {
    console.log("caught render event");
  });

  gp.render({
    query     : ["swi4", "swi6", "mbp1", "mcm1", "fkh1", "fkh2"],
    organism  : "scerevisiae",
  });
});

</script>

If using a module loader such as require.js require the module from within your application or directly, such as:

<script src="require.js"></script>
<script>

require(['/path/to/biojsvisgprofiler.min.js'], function(biojsVisGprofiler) {
	...
});

</script>

Documentation

###Index

Classes

• class: BioJSVisGProfiler
  • new BioJSVisGProfiler(attrs)
  • bioJSVisGProfiler.render(attrs)
  • bioJSVisGProfiler.renderStored(data)
  • bioJSVisGProfiler.getGProfiler()
  • bioJSVisGProfiler.getInfoboxId()
  • event: "onrender"
  • event: "onclick"
• class: GProfiler
  • new GProfiler()
  • gProfiler.query(attrs, cb)
  • gProfiler.getQueryParams(queryAttrs)
  • gProfiler.getQueryURL(queryAttrs)
  • gProfiler.getRootURL()

Typedefs

• callback: renderCb
• callback: distillerCb
• callback: scorerCb

###class: BioJSVisGProfiler Members

• class: BioJSVisGProfiler
  • new BioJSVisGProfiler(attrs)
  • bioJSVisGProfiler.render(attrs)
  • bioJSVisGProfiler.renderStored(data)
  • bioJSVisGProfiler.getGProfiler()
  • bioJSVisGProfiler.getInfoboxId()
  • event: "onrender"
  • event: "onclick"

####new BioJSVisGProfiler(attrs) Construct a BioJSVisGProfiler object.

Params

• attrs Object - Pass properties to the constructor via this object.

Properties

• container string - Container wherein the cloud will be rendered, in selector format. required
• width int - Width of the rendered cloud, in pixels. default: 300
• height int - Height of the rendered cloud, in pixels. default: 300
• maxN int - Max number of strings to display.
• maxTermLen int - Max length of a term description, keep this at a reasonable value to ensure all terms are displayed. No effect if useTerms is false.
• useTerms boolean - Display whole functional terms instead of single words.
• warnings boolean - Log rendering warnings to the console.
• showLogo boolean - Set to false to suppress displaying the g:Profiler logo at the bottom right.
• showInfo boolean - Set to false to suppress displaying the default tooltip upon clicking a string.
• logoHttpPost boolean - Set to true to use a HTTP POST request to g:Profiler upon clicking the logo at the bottom right.
• sizer renderCb - Callback function returning the point size of a string.
• colorer renderCb - Callback function returning the color of a string.
• scorer scorerCb - Callback function returning the score for a string. This is used for ordering to select maxN top strings and is passed to the sizer and colorer callbacks. Note that the scores are normalized to sum to 1.
• distiller distillerCb - Callback function returning an array of strings to be rendered.

Example

var gp = require('biojs-vis-gprofiler');

gp = new gp({
  container  : "#myContainer",
  width      : 600,
  height     : 600,
});

gp.on("onrender", function() {
  console.log("caught render event");
});

gp.render({
  query    : ["swi4", "swi6", "mbp1"],
  organism : "scerevisiae",
});

####bioJSVisGProfiler.render(attrs) Query g:Profiler and render a cloud.

Params

• attrs Object - Passed through to GProfiler.query.

Fires

• onrender
• onclick

####bioJSVisGProfiler.renderStored(data) Render cloud based on an object previously returned by GProfiler.query.

Params

• data Object - Object returned by GProfiler.query.

Fires

• onrender
• onclick

####bioJSVisGProfiler.getGProfiler() Return an instance of GProfiler.

####bioJSVisGProfiler.getInfoboxId() Return the infobox element id attribute.

####event: "onrender" Fired when cloud rendering has completed.

####event: "onclick" Fired upon click on a cloud element

Params

• termdata Array - Array of data structures returned from g:Profiler per functional category associated with the clicked string.
• event Event

###class: GProfiler Members

• class: GProfiler
  • new GProfiler()
  • gProfiler.query(attrs, cb)
  • gProfiler.getQueryParams(queryAttrs)
  • gProfiler.getQueryURL(queryAttrs)
  • gProfiler.getRootURL()

####new GProfiler() Construct a GProfiler object.

####gProfiler.query(attrs, cb) Query g:Profiler.

Params

• attrs Object - g:Profiler query attributes. See g:Profiler for detailed documentation on these parameters.
• cb function - A callback function receiving the result object from a g:Profiler query.

Fields of attrs:

Properties

• query Array - A list of query symbols. required
• organism String - The organism name in g:Profiler format, generally the first character of the genus + species in lowercase. E.g. "Mus musculus" -> "mmusculus". default: hsapiens
• significant boolean - Only return statistically significant results. default: true
• orderedQuery boolean - Ordered query. default: false.
• regionQuery boolean - The query consists of chromosomal regions. default: false.*
• excludeIEA boolean - Exclude electronic GO annotations. default: false.
• underrep boolean - Measure underrepresentation. default: false.
• hierFiltering String - Hierarchical filtering, one of "none", "moderate", "strong". default: none.
• maxPValue float - Custom p-value threshold. default: 1.0.
• minSetSize int - Minimum size of functional category.
• maxSetSize int - Maximum size of functional category.
• correctionMethod String - Algorithm used for determining the significance threshold, one of "gSCS", "fdr", "bonferroni". default: "gSCS".
• domainSize String - Statistical domain size, one of "annotated", "known". default: annotated.
• numericNS String - Namespace to use for fully numeric IDs.
• customBG Array - Array of symbols to use as a statistical background.
• srcFilter Array - Array of data sources to use. Currently these include GO (GO:BP, GO:MF, GO:CC to select a particular GO branch), KEGG, REAC, TF, MI, CORUM, HP. Please see the g:GOSt web tool for the comprehensive list and details on incorporated data sources.

####gProfiler.getQueryParams(queryAttrs) Return the HTTP request parameters for a query.

Params

• queryAttrs Object - See the documentation for [GProfiler#query]. If not specified, the active query (the last query executed via [GProfiler#query]) is used. Otherwise, an error is thrown.

Returns: Object
####gProfiler.getQueryURL(queryAttrs) Return g:Profiler URL encoding a query.

Params

• queryAttrs Object - See the documentation for [GProfiler#query]. If not specified, the active query (the last query executed via [GProfiler#query]) is used. Otherwise, an error is thrown.

Returns: String | null - If the resulting URL lengths exceeds the maximum allowed length, null is returned.
####gProfiler.getRootURL() Return g:Profiler root URL.

Returns: String
###callback: renderCb Params

• attrs Object - Pass properties via this object.

Properties

• score float - A score for the string (sum of all scores == 1).
• scaling int - A constant scaling value proportional to the size of the container.
• str string - The string being rendered.
• termdata Array - Array of data structures returned from g:Profiler per functional category associated with the current string.

Type: function
###callback: distillerCb Params

• termdata Object - The data structure returned from g:Profiler for a functional category.

Type: function
Returns: Array | null - - An array of strings associated with the current term. Return null to discard the term.
###callback: scorerCb Params

• attrs Object - Pass properties via this object.

Properties

• str string - The string being rendered.
• termdata Array - Array of data structures returned from g:Profiler per functional category associated with the current string.

Type: function
Returns: float

Contributing

Please submit all issues and pull requests to the tambeta/biojs-vis-gprofiler repository!

Support

If you have any problems or a suggestion please open an issue here.

License

The BSD License

Copyright (c) 2014, Tambet Arak

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

• Neither the name of the Tambet Arak nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.