Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/misoproject/dataset
JavaScript library that makes managing the data behind client-side visualisations easy
https://github.com/misoproject/dataset
Last synced: 25 days ago
JSON representation
JavaScript library that makes managing the data behind client-side visualisations easy
- Host: GitHub
- URL: https://github.com/misoproject/dataset
- Owner: misoproject
- License: gpl-2.0
- Created: 2011-09-23T21:19:02.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2017-12-13T00:53:43.000Z (almost 7 years ago)
- Last Synced: 2024-04-17T02:48:30.245Z (7 months ago)
- Language: JavaScript
- Homepage: http://misoproject.com
- Size: 5.37 MB
- Stars: 1,181
- Watchers: 52
- Forks: 99
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE-GPL
Awesome Lists containing this project
- awesome-starred - misoproject/dataset - JavaScript library that makes managing the data behind client-side visualisations easy (others)
README
# 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](http://misoproject.com).
Read more about Dataset [here](http://misoproject.com/dataset)## Download
All downloads are located in the [/dist](https://github.com/misoproject/dataset/tree/master/dist) directory. Here are some of them:
### Including Dependencies
[miso.ds.dev.0.4.1.zip](https://github.com/downloads/misoproject/dataset/miso.ds.dev.0.4.1.zip) - Download Development With Dependencies - 0.4.1
[miso.ds.deps.ie.0.4.1.js](https://github.com/downloads/misoproject/dataset/miso.ds.deps.ie.0.4.1.js) - Download Development With Dependencies for IE - 0.4.1
[miso.ds.deps.ie.min.0.4.1.js](https://github.com/downloads/misoproject/dataset/miso.ds.deps.ie.0.4.1.js) - Download Production With Dependencies for IE - 0.4.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.0.4.1.js](https://github.com/downloads/misoproject/dataset/miso.ds.0.4.1.js) - Download Development No Dependencies - 0.4.1
[miso.ds.min.0.4.1.js](https://github.com/misoproject/dataset/tree/master/dist/miso.ds.min.0.4.1.js) - Download Production No Dependencies - 0.4.1
[miso.ds.0.4.1.m.js](https://github.com/misoproject/dataset/tree/master/dist/miso.ds.0.4.1.m.js) - Download AMD Compatibile Build No Dependencies- 0.4.1
[miso.ds.min.0.4.1.m.js](https://github.com/misoproject/dataset/tree/master/dist/miso.ds.min.0.4.1.m.js) - Download AMD Compatibile Build Production No Dependencies- 0.4.1
### Dependencies
Dataset has the following dependencies:
* [Lodash.js 0.9.0](http://lodash.com/)
* [Underscore.math.js (version unknown)](https://github.com/syntagmatic/underscore.math)
* [Underscore.deferred.js 0.2.0](https://github.com/wookiehangover/underscore.Deferred)
* [moment.js 1.7.2](http://momentjs.com/) (for date and time parsing)
* [miso.events.js 0.0.1](http://github.com/misoproject/events) (For adding event behavior)If you are planning on supporting IE, include the following json2.js library as well:
* [json2.js 2011-10-19](https://github.com/douglascrockford/JSON-js)## Documentation
The full documentation set can be found here:
[http://misoproject.com/dataset/docs.html](http://misoproject.com/dataset/docs.html)Miso.Dataset works in the browser and in Node.js.
### Have an intersting issue or question?
Maybe others have as well. Ask your quesiton as a ticket
or check out the current listing of tips and tricks in our
[How do I...](https://github.com/misoproject/dataset/wiki/How-Do-I...)
wiki page.#### Browser support
Include the appropriate libs as script tags in your web pages
#### Node Support
You can require it like so:
```javascript
var Miso = require("miso.dataset");
var ds = new Miso.Dataset...
```### API
For a detailed API listing, see here:
[http://misoproject.com/dataset/api.html](http://misoproject.com/dataset/api.html)### Examples
For some more complex examples, see the following page:
[http://misoproject.com/dataset/examples.html](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 bundlerOnce 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 stopOpen 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: [http://gruntjs.com/](http://gruntjs.com/). Dataset uses grunt 0.4.## 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](http://twitter.com/ireneros) on twitter, @iros on github) or Alex Graul ([@alexgraul](http://twitter.com/alexgraul) on both.)