timbertrek

Explore and compare 1K+ accurate decision trees in your browser!

https://github.com/poloclub/timbertrek

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 4 DOI reference(s) in README
✓
Academic publication links
Links to: arxiv.org, scholar.google
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (10.4%) to scientific vocabulary

Keywords

decision-tree interactive-visualizations interpretability rashomon visualization

Last synced: 4 months ago · JSON representation ·

Repository

Explore and compare 1K+ accurate decision trees in your browser!

Basic Info

Host: GitHub
Owner: poloclub
License: mit
Language: TypeScript
Default Branch: master
Homepage: https://poloclub.github.io/timbertrek
Size: 36.9 MB

Statistics

Stars: 164
Watchers: 4
Forks: 12
Open Issues: 1
Releases: 1

Topics

decision-tree interactive-visualizations interpretability rashomon visualization

Created almost 4 years ago · Last pushed almost 2 years ago

Metadata Files

Readme License Citation

TimberTrek

Curate decision trees that align with your knowledge and values!


🚀 Live Demo	📺 Demo Video	👨🏻‍🏫 Conference Talk	📖 Research Paper

Web Demo

For a live web demo, visit: https://poloclub.github.io/timbertrek.

You can use the web demo to explore your own Rashomon Sets! You just need to choose the my own set tab below the tool and upload a JSON file containing all decision paths in your Rashomon Set.

Check out this example notebook to see how to generate the whole Rashomon Set and the JSON file.

Notebook Demos

You can directly use TimberTrek in your favorite computational notebooks (e.g. Jupyter Notebook/Lab, Google Colab, and VS Code Notebook).

Check out three live notebook demos below.

|Jupyter Lite|Binder|Google Colab| |:---:|:---:|:---:| ||||

Install

To use TimberTrek in a notebook, you would need to install TimberTrek with pip:

bash pip install timbertrek

Development

Clone or download this repository:

bash git clone git@github.com:poloclub/timbertrek.git

Install the dependencies:

bash npm install

Then run TimberTrek:

npm run dev

Navigate to localhost:3000. You should see TimberTrek running in your browser :)

Credits

Led by Jay Wang, TimberTrek is a result of a collaboration between ML and visualization researchers from Georgia Tech, Duke University, Fujitsu Laboratories, and University of British Columbia. TimberTrek is created by Jay Wang, Chudi Zhong, Rui Xin, Takuya Takagi, Zhi Chen, Polo Chau, Cynthia Rudin, and Margo Seltzer.

Citation

To learn more about TimberTrek, please read our research paper (published at IEEE VIS 2022). To learn more about the algorithm to generate the whole Rashomon set of sparse decision trees, please read our TreeFARMS paper (published at NeurIPS'22). If you find TimberTrek useful for your research, please consider citing our paper. Thanks!

bibTeX @inproceedings{wangTimberTrekExploringCurating2022, title = {{{TimberTrek}}: {{Exploring}} and {{Curating Trustworthy Decision Trees}} with {{Interactive Visualization}}}, booktitle = {2022 {{IEEE Visualization Conference}} ({{VIS}})}, author = {Wang, Zijie J. and Zhong, Chudi and Xin, Rui and Takagi, Takuya and Chen, Zhi and Chau, Duen Horng and Rudin, Cynthia and Seltzer, Margo}, year = {2022} }

License

The software is available under the MIT License.

Contact

If you have any questions, feel free to open an issue or contact Jay Wang.

Owner

Name: Polo Club of Data Science
Login: poloclub
Kind: organization
Location: Atlanta, GA

Website: https://poloclub.github.io
Twitter: polodataclub
Repositories: 66
Profile: https://github.com/poloclub

Research project repositories, from the Polo Club of Data Science at Georgia Tech

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: Wang
  given-names: Zijie J.
- family-names: Zhong
  given-names: Chudi
- family-names: Xin
  given-names: Rui
- family-names: Takagi
  given-names: Takuya
- family-names: Chen
  given-names: Zhi
- family-names: Chau
  given-names: Duen Horng
- family-names: Rudin
  given-names: Cynthia
- family-names: Seltzer
  given-names: Margo
title: "TimberTrek: Exploring and Curating Sparse Decision Trees with Interactive Visualization"
version: 0.1.5
doi: 10.48550/arXiv.2209.09227
date-released: 2022-09-19
url: "https://github.com/poloclub/timbertrek"
preferred-citation:
  type: article
  authors:
  - family-names: Wang
    given-names: Zijie J.
  - family-names: Zhong
    given-names: Chudi
  - family-names: Xin
    given-names: Rui
  - family-names: Takagi
    given-names: Takuya
  - family-names: Chen
    given-names: Zhi
  - family-names: Chau
    given-names: Duen Horng
  - family-names: Rudin
    given-names: Cynthia
  - family-names: Seltzer
    given-names: Margo
  title: "TimberTrek: Exploring and Curating Sparse Decision Trees with Interactive Visualization"
  doi: 10.48550/arXiv.2209.09227
  journal: "IEEE Visualization Conference"
  year: 2022

GitHub Events

Total

Watch event: 15
Fork event: 3

Last Year

Watch event: 15
Fork event: 3

Committers

Last synced: 8 months ago

All Time

Total Commits: 233
Total Committers: 1
Avg Commits per committer: 233.0
Development Distribution Score (DDS): 0.0

Past Year

Commits: 0
Committers: 0
Avg Commits per committer: 0.0
Development Distribution Score (DDS): 0.0

Top Committers

Name	Email	Commits
Jay Wang	j**y@z**g	233

Committer Domains (Top 20 + Academic)

zijie.wang: 1

Issues and Pull Requests

Last synced: 4 months ago

All Time

Total issues: 4
Total pull requests: 0
Average time to close issues: 8 days
Average time to close pull requests: N/A
Total issue authors: 3
Total pull request authors: 0
Average comments per issue: 3.5
Average comments per pull request: 0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 0
Pull requests: 0
Average time to close issues: N/A
Average time to close pull requests: N/A
Issue authors: 0
Pull request authors: 0
Average comments per issue: 0
Average comments per pull request: 0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

gllg4009 (2)
aflip (1)
sarah-huestis (1)

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

Total packages: 1
Total downloads:
- pypi 252 last-month

Total dependent packages: 1
Total dependent repositories: 1
Total versions: 8
Total maintainers: 1

pypi.org: timbertrek

A Python package to run TimberTrek in your computational notebooks.

Homepage: https://github.com/poloclub/timbertrek
Documentation: https://timbertrek.readthedocs.io/
License: MIT license
Latest release: 0.1.7
published about 3 years ago

Versions: 8
Dependent Packages: 1
Dependent Repositories: 1
Downloads: 252 Last month

Rankings

Dependent packages count: 4.6%

Stargazers count: 6.6%

Average: 11.9%

Forks count: 12.0%

Downloads: 14.3%

Dependent repos count: 21.9%

Maintainers (1)

xiaohk

Last synced: 4 months ago

Dependencies

package.json npm

@rollup/plugin-commonjs ^17.0.0 development
@rollup/plugin-node-resolve ^11.0.0 development
@rollup/plugin-typescript ^8.0.0 development
@rollup/plugin-yaml ^3.1.0 development
@sveltejs/vite-plugin-svelte ^1.0.1 development
@tsconfig/svelte ^3.0.0 development
@types/d3 ^7.1.0 development
@typescript-eslint/eslint-plugin ^5.14.0 development
@typescript-eslint/parser ^5.12.0 development
d3-array ^3.1.3 development
d3-axis ^3.0.0 development
d3-brush ^3.0.0 development
d3-color ^3.1.0 development
d3-drag ^3.0.0 development
d3-ease ^3.0.1 development
d3-fetch ^3.0.1 development
d3-format ^3.1.0 development
d3-hierarchy ^3.1.2 development
d3-interpolate ^3.0.1 development
d3-path ^3.0.1 development
d3-scale ^4.0.2 development
d3-scale-chromatic ^3.0.0 development
d3-selection ^3.0.0 development
d3-shape ^3.1.0 development
d3-time-format ^4.1.0 development
d3-timer ^3.0.1 development
d3-transition ^3.0.1 development
d3-zoom ^3.0.0 development
eslint ^8.10.0 development
eslint-config-prettier ^8.3.0 development
eslint-plugin-prettier ^4.0.0 development
eslint-plugin-svelte3 ^3.4.1 development
node-sass ^7.0.1 development
prettier ^2.5.1 development
rollup ^2.3.4 development
rollup-plugin-css-only ^3.1.0 development
rollup-plugin-livereload ^2.0.0 development
rollup-plugin-svelte ^7.0.0 development
rollup-plugin-terser ^7.0.0 development
svelte ^3.0.0 development
svelte-check ^2.0.0 development
svelte-preprocess ^4.10.3 development
tslib ^2.3.1 development
typescript ^4.5.4 development
vite ^3.0.0 development
sirv-cli ^2.0.0

notebook-widget/requirements_dev.txt pypi

Sphinx ==1.8.5 development
bump2version ==0.5.11 development
coverage ==4.5.4 development
flake8 ==3.7.8 development
ipython >=7.4.0 development
numpy >=1.15.1 development
pandas >=0.24.0 development
pip >=22.1 development
twine ==1.14.0 development
watchdog ==0.9.0 development
wheel ==0.33.6 development

.github/workflows/build.yml actions

actions/checkout v2 composite
actions/setup-node v1 composite

notebook-widget/setup.py pypi

timbertrek

Science Score: 67.0%

Keywords

Repository

Basic Info

Statistics

Topics

Metadata Files

README.md

TimberTrek

Web Demo

Notebook Demos

Install

Development

Credits

Citation

License

Contact

Owner

Citation (CITATION.cff)

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: timbertrek

Rankings

Maintainers (1)

Dependencies