Dataset.js

Dataset is a JavaScript library that makes managing the data behind client-side visualisations easy, including realtime data. It takes care of the loading, parsing, sorting, filtering and querying of datasets as well as the creation of derivative datasets.

Dataset is part of the Miso Toolkit. Read more about Dataset here

Download

Including Dependencies

miso.ds.dev.zip - Download Development With Dependencies - 0.2.1

miso.ds.deps.min.js - Download Production With Dependencies - 0.2.1

Without Dependencies

The following builds do not have any of the dependencies built in. It is your own responsibility to include them as appropriate script elements in your page.

miso.ds.js - Download Production No Dependencies - 0.2.1

miso.ds.min.js - Download Development No Dependencies - 0.2.1

Dependencies

Dataset has the following dependencies:

• Lodash.js 0.3.2
• Underscore.math.js (version unknown)
• Underscore.deferred.js 0.1.2
• moment.js 1.4.0 (for date and time parsing)

If you are planning on supporting IE, include the following json2.js library as well:

• json2.js 2011-10-19

Documentation

The full documentation set can be found here: http://misoproject.com/dataset/docs.html

Miso.Dataset works in the browser and in Node.js.

Browser support

Include the appropriate libs as script tags in your web pages

Node Support

You can require it like so:

var Miso = require("miso.dataset");
var ds = new Miso.Dataset...

API

For a detailed API listing, see here: http://misoproject.com/dataset/api.html

Examples

For some more complex examples, see the following page: http://misoproject.com/dataset/examples.html

Contributing

We welcome pull requests! Some things to keep in mind:

Set up

Assuming that Ruby is already installed on your machine, you need to install bundler gem to install other required gems so that you can run the test server.

$ cd test
$ gem install bundler

Once bundler is installed, run bundle install which install required gems (mostly sinatra)

$ bundle install
Fetching source index for http://rubygems.org/
Using rack (1.4.1)
Installing rack-contrib (1.1.0)
Using rack-protection (1.2.0)
Using tilt (1.3.3)
Using sinatra (1.3.2)
Using bundler (1.0.21)

Once all the required gems are installed, run the following command

$ rackup
>>> Serving: ~/dataset/test/../
>> Thin web server (v1.3.1 codename Triple Espresso)
>> Maximum connections set to 1024
>> Listening on 0.0.0.0:9292, CTRL+C to stop

Open the test page on the browser

open http://localhost:9292/test/index.html

Guideline

• Any new functionality must have tests and ensure all current tests still pass. All tests are located in the test/unit directory.
• We use cowboy's grunt library to build all our final dependencies. You will need to install grunt per the instructions here: https://github.com/cowboy/grunt.

Contact

• For announcements follow @themisoproject on twitter.
• Opening issues here is a great way to let us know when something is broken!
• If you want to chat with us, join #misoproject on irc (freenode).
• Feel free to ping Irene Ros(@ireneros on twitter, @iros on github) or Alex Graul (@alexgraul on both.)