Skip to content
Dynamic Result Table Library
JavaScript CoffeeScript CSS Other
Branch: dev
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
dist
img
less
src
templates
test
.bowerrc
.gitignore
.gitmodules
.npmignore
CONFIGURING.md
CONTRIBUTING.md
DESIGN.md
EVENTS.md
Gruntfile.js
LICENSE
Makefile
Procfile
README.markdown
TODO
bower.json
coffeelint.json
favicon.ico
lgpl-3.0.txt
package-lock.json
package.json

README.markdown

InterMine Results Tables

A data display library for InterMine web-applications.

This library provides a highly functional data exploration and download tool suitable for embedding into any website. It requires an InterMine data-warehouse to communicate with for data, and a modern web-browser (IE 10+).

This library is free and open source software, licensed under the LGPL-v3 licence. A copy of this license is distributed with this repository.

Synopsis

    var imtables = require('imtables');

    var element = document.querySelector('#my-id');
    var service = {root: 'http://www.flymine.org/query/service'};
    var query = {
        select: ['*'],
        from: 'Gene',
        where: [['Gene', 'IN', 'MY-LIST']]
    };

    // Configure options here, using nested notation
    imtables.configure({TableCell: {PreviewTrigger: 'click'}});
    // Or using path names:
    imtables.configure('TableResults.CacheFactor', 20);

    // Then load the table (or indeed vice-versa, the table
    // will respond to changes in the options)
    imtables.loadTable(
        element, // Could also be a string or a jquery object
        {start: 0, size: 25}, // Can be null - all properties are optional.
        {service: service, query: query} // Can also be an imjs.Query object
    ).then(
        function handleTable (table) { /* ... Do something with the table. */ },
        function reportError (error) { console.error('Could not load table', error); }
    );

Installation and Usage

This library is developed with Browserify and provides a UMD (Universal Module Definition) interface to its main entry point. It can thus be loaded as a commonjs module, from an AMD loader or as a window global. We recommend using npm and browserify:

  npm install --save imtables

Then in your code:

  var imtables = require('imtables');

Issues & Support

For help and support, the developers may be contacted at:

dev@intermine.org

For a public bug tracker, please visit the github issues tracker:

https://github.com/intermine/im-tables/issues

Customisation

This library is designed to be customised by end users, in every aspect from its stylesheets and text strings, to the code that defines the behaviour of individual components. Please see the file CUSTOMISING for details on how to get started.

Development

Please see the CONTRIBUTING file included in this distribution for details of how to start developing this library.

Acknowledgements

The development work for this library was funded by the NIH and the Wellcome Trust as part of the InterMOD model organism datamine project. It is one of the constituent components of the InterMine data-warehouse system.

This set of user interface tools would not be possible without the fantastic set of open source web development tools available today. We are extremely grateful to benefit from the hard work put into the development of:

  • Backbone
  • Bootstrap
  • Browserify
  • CoffeeScript
  • d3
  • FontAwesome
  • jQuery & jQuery.UI
  • underscore

Copyright

The copyright on this work is help by Alex Kalderimis and InterMine

You can’t perform that action at this time.