Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cmpolis/datacomb
An interactive tool for exploring large, tabular datasets.
https://github.com/cmpolis/datacomb
Last synced: 5 days ago
JSON representation
An interactive tool for exploring large, tabular datasets.
- Host: GitHub
- URL: https://github.com/cmpolis/datacomb
- Owner: cmpolis
- License: mit
- Created: 2015-08-09T23:26:55.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-04-18T04:58:50.000Z (over 5 years ago)
- Last Synced: 2024-08-01T12:35:02.363Z (3 months ago)
- Language: JavaScript
- Size: 20.2 MB
- Stars: 337
- Watchers: 20
- Forks: 33
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - cmpolis/datacomb - An interactive tool for exploring large, tabular datasets. (others)
README
# Datacomb
An interactive tool for analyzing, exploring and *combing* through tabular datasets. *by [@ChrisPolis](https://twitter.com/ChrisPolis)*
Turn **your** data into: *[live demo](http://www.bytemuse.com/datacomb/demo/)*
## Usage
#### As an `htmlwidget` in `R`
```R
devtools::install_github('cmpolis/datacomb', subdir='pkg', ref='1.1.2');
library(datacomb);
Datacomb(iris)
```
#### In a browser, with JavaScript:
to build: ` $ npm install && npm run build`
```js
//
//
// Sample usage of Datacomb (see also: /demo/demo.js)
// Column definitions, meta data
var columns = [
{
label: 'Team',
accessor: 'team',
// columns that are not quantitative need `type` flag
type: 'discrete'
},
{
label: 'Pos',
accessor: 'pos',
type: 'discrete',
sortOrder: 'PG SG SF PF C'.split(' ')
},
{
label: 'Points',
accessor: 'pts'
},
{
label: 'Minutes',
accessor: 'mp'
},
{
label: 'Pts / Min',
// column defenitions can be functions
accessor: function(d) { return d.pts / d.mp },
// can define `format` function to change how text is displayed on the tbale
format: function(val) { return val.toFixed(3) + 'pts/min'; },
}
];
// init the interface
var myDatacomb = new Datacomb({
//
el: document.getElementById('datacomb-target'),
// array of objects
data: [ {name: 'Hank', team: 'Liverpool', points: 3 }, { ... }, ... ],
//
columns: columns,
//
labelAccessor: 'name'
});
```
## Catalog of Interactions
##### Hover over rows to reveal exact values
##### Sort by column(s)
##### Filter rows visually with a slider or by specifiying exact bounds
##### Click and drag to select rows to focus
##### Show only selected rows to analyze a subset
##### View distribution data for each column
##### View summary statistics for each column
##### View relationships between columns by creating scatter plots of a column and all other columns
##### Group rows by discrete dimensions
## Contributing
Pull requests welcomed! However, please try to mention or ask about it as an issue to make sure what you are working on will be merged in and is not already in progress.
```shell
$ npm install
$ npm run build
$ npm run serve
$ open http://localhost:5050/demo/
```
## Testing
` $ npm test`
## Resources
Blog post, demo of prototype/old version: http://www.bytemuse.com/post/data-comb-visualization/
R Package(CRAN!): https://github.com/mtennekes/tabplot
Table Lens Paper: https://www.cs.ubc.ca/~tmm/courses/cpsc533c-04-fall/readings/tablelens.pdf
Demo dataset sources:
* diamonds: https://vincentarelbundock.github.io/Rdatasets/datasets.html
* nba players: http://www.basketball-reference.com/
## Status, project todo, notes
* **[IN PROGRESS]** v1/prototype:
* :thumbsup: project setup: can build, test, view in browser...
* :thumbsup: (https://github.com/cmpolis/smart-table-scroll) table row reuse *(minimize # of <.row> DOM elements)*
* :thumbsup: table layout and properly sized bars
* :thumbsup: hover interaction
* :thumbsup: click interaction
* :thumbsup: drag interaction
* :thumbsup: filtering
* :thumbsup: sorting
* :thumbsup: scatter plots (canvas)
* :thumbsup: histograms
* :thumbsup: summary statistics
* :thumbsup: grouping (by discrete dimensions)
* :thumbsup: coloring (by discrete dimensions)
* v2
* :x: expandable(full screen?) scatter plots
* :x: regressions in scatter plots
* :x: dynamic column addition, removal
* :x: custom column widths
* :x: functional column definitions from ui: eg: `areaCol: ${height} * ${width}`
* :x: axis labels
* :x: log scaling
* :x: quantize columns (continuous dim -> discrete dim)
* :x: illustrate filter response on histograms
* :x: illustrate filter response on scatter plots
* :x: close/expand groupings in table
* :construction: keyboard shortcuts
* :construction: HTMLWidget/R package
* :x: Serializable table configuration format. JSON?
* :x: Natural language/DSL mode for table configuration, querying
### Released under the MIT License.