-
Notifications
You must be signed in to change notification settings - Fork 794
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Initial draft of JOSS paper #394
Merged
Merged
Changes from 5 commits
Commits
Show all changes
17 commits
Select commit
Hold shift + click to select a range
8888fa5
Initial draft of JOSS paper.
ellisonbg 1feb413
Updates to refs and vega/d3 description.
ellisonbg b1ac107
More bib updates.
ellisonbg 9493e0f
Update author list with orcid/affiliations
ellisonbg afc1d0d
Add Ben Welsh and fix affiliations.
ellisonbg ca2fb1d
Update paper draft
domoritz 7e3b75c
Update paper.md
domoritz 6e995d0
Examples are not auto generated
domoritz a8699db
Fix typo
domoritz 41f35c9
Merge pull request #4 from domoritz/joss-paper
ellisonbg 793cdb3
Group authors by affiliation except jake and brian and the main authors
domoritz 9d915be
Add and describe example
domoritz 17c6039
Highlight interactive
domoritz 28ed561
move citations
domoritz ee73ad2
Merge pull request #5 from domoritz/joss-example
ellisonbg 11f0502
MAINT: add back to author list
stsievert 014e55e
Merge pull request #6 from stsievert/joss-paper
ellisonbg File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
@article{2011-d3, | ||
title = {D3: Data-Driven Documents}, | ||
author = {Michael Bostock AND Vadim Ogievetsky AND Jeffrey Heer}, | ||
journal = {IEEE Trans. Visualization \& Comp. Graphics (Proc. InfoVis)}, | ||
year = {2011}, | ||
url = {http://idl.cs.washington.edu/papers/d3}, | ||
} | ||
|
||
@article{2017-vega-lite, | ||
title = {Vega-Lite: A Grammar of Interactive Graphics}, | ||
author = {Arvind Satyanarayan AND Dominik Moritz AND Kanit Wongsuphasawat AND Jeffrey Heer}, | ||
journal = {IEEE Trans. Visualization \& Comp. Graphics (Proc. InfoVis)}, | ||
year = {2017}, | ||
url = {http://idl.cs.washington.edu/papers/vega-lite}, | ||
} | ||
|
||
@InProceedings{ mckinney-proc-scipy-2010, | ||
author = { Wes McKinney }, | ||
title = { Data Structures for Statistical Computing in Python }, | ||
booktitle = { Proceedings of the 9th Python in Science Conference }, | ||
pages = { 51 - 56 }, | ||
year = { 2010 }, | ||
editor = { St\'efan van der Walt and Jarrod Millman } | ||
} | ||
|
||
@Manual{, | ||
title = {R: A Language and Environment for Statistical Computing}, | ||
author = {{R Core Team}}, | ||
organization = {R Foundation for Statistical Computing}, | ||
address = {Vienna, Austria}, | ||
year = {2013}, | ||
url = {http://www.R-project.org/}, | ||
} | ||
|
||
@Article{Hunter:2007, | ||
Author = {Hunter, J. D.}, | ||
Title = {Matplotlib: A 2D graphics environment}, | ||
Journal = {Computing In Science \& Engineering}, | ||
Volume = {9}, | ||
Number = {3}, | ||
Pages = {90--95}, | ||
abstract = {Matplotlib is a 2D graphics package used for Python | ||
for application development, interactive scripting, and | ||
publication-quality image generation across user | ||
interfaces and operating systems.}, | ||
publisher = {IEEE COMPUTER SOC}, | ||
doi = {10.1109/MCSE.2007.55}, | ||
year = 2007 | ||
} | ||
|
||
@Book{, | ||
author = {Hadley Wickham}, | ||
title = {ggplot2: Elegant Graphics for Data Analysis}, | ||
publisher = {Springer-Verlag New York}, | ||
year = {2009}, | ||
isbn = {978-0-387-98140-6}, | ||
url = {http://ggplot2.org}, | ||
} | ||
|
||
@book{Wilkinson:2005:GG:1088896, | ||
author = {Wilkinson, Leland}, | ||
title = {The Grammar of Graphics (Statistics and Computing)}, | ||
year = {2005}, | ||
isbn = {0387245448}, | ||
publisher = {Springer-Verlag New York, Inc.}, | ||
address = {Secaucus, NJ, USA}, | ||
} | ||
|
||
@article{2016-reactive-vega-architecture, | ||
title = {Reactive Vega: A Streaming Dataflow Architecture for Declarative Interactive Visualization}, | ||
author = {Arvind Satyanarayan AND Ryan Russell AND Jane Hoffswell AND Jeffrey Heer}, | ||
journal = {IEEE Trans. Visualization \& Comp. Graphics (Proc. InfoVis)}, | ||
year = {2016}, | ||
url = {http://idl.cs.washington.edu/papers/reactive-vega-architecture}, | ||
} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,72 @@ | ||
--- | ||
title: 'Altair: a declarative statistical visualization library for Python' | ||
tags: | ||
- Python | ||
- visualization | ||
- statistics | ||
- Jupyter | ||
authors: | ||
- name: Jacob VanderPlas | ||
orcid: 0000-0002-9623-3401 | ||
affiliation: 1 | ||
- name: Brian E. Granger | ||
orcid: 0000-0002-5223-6168 | ||
affiliation: 2 | ||
- name: Jeffrey Heer | ||
orcid: 0000-0002-6175-1655 | ||
affiliation: 1 | ||
- name: Eitan Lees | ||
orcid: 0000-0003-0988-6015 | ||
affiliation: 4 | ||
- name: Dominik Moritz | ||
orcid: 0000-0002-3110-1053 | ||
affiliation: 1 | ||
- name: Scott Sievert | ||
orcid: 0000-0002-4275-3452 | ||
affiliation: 3 | ||
- name: Ben Welsh | ||
orcid: 0000-0002-5200-7269 | ||
affiliation: 5 | ||
- name: Kanit Wongsuphasawat | ||
orcid: 0000-0001-7231-279X | ||
affiliation: 1 | ||
affiliations: | ||
- name: University of Washington | ||
index: 1 | ||
- name: California Polytechnic State University, San Luis Obispo | ||
index: 2 | ||
- name: University of Wisconsin, Madison | ||
index: 3 | ||
- name: Florida State University | ||
index: 4 | ||
- name: Los Angeles Times Data Desk | ||
index: 5 | ||
date: 01 June 2018 | ||
bibliography: paper.bib | ||
--- | ||
|
||
# Summary | ||
|
||
Altair is a statistical visualization library for Python. Statistical visualization is a constrained subset of data visualization focused on the creation of visualizations | ||
that are helpful in statistical modeling. The constrained model of statistical visualization is usually expressed in terms of a visualization grammar [] that specifies how input data is transformed and mapped to visual properties (position, color, size, etc.). | ||
|
||
Altair is based on the Vega-Lite visualization grammar [], which allows a wide range of statistical | ||
visualizations to be expressed using a small number of grammar primitives. Vega-Lite is declarative; visualizations are specified using JSON data that follows the Vega-Lite JSON schema. | ||
As a Python library, Altair provides an API oriented towards scientists and data scientists | ||
doing exploratory data analysis []. Altair's Python API emits Vega-Lite JSON data, which is then | ||
rendered in a user-interface such as the Jupyter Notebook, JupyterLab or nteract using the | ||
Vega-Lite JavaScript library []. Vega-Lite JSON is compiled to a full Vega specification [], which is then parsed and executed using a reactive runtime that internally makes use of D3.js []. | ||
|
||
The declarative nature of the Vega-Lite visualization grammar, and its encoding in a formal | ||
JSON schema, provide Altair with a number of benefits. First, much of the Altair Python code, | ||
tests, and examples are autogenerated from the Vega-Lite JSON schema, ensuring strict conformance | ||
with the Vega-Lite specification. Second, the JSON data produced by Altair and consumed by Vega-Lite provides a natural serialization and file format for statistical visualizations. This is leveraged by JupyterLab, which provides built-in rendering of these files. Third, the JSON data | ||
provides a clean integration point for non-programming based visualization user-interfaces such as Voyager []. | ||
|
||
In addition to static documentation [], Altair includes a set of Jupyter Notebooks with examples | ||
and an interactive tutorial. These notebooks can be by anyone with only a web-browser through | ||
binder []. | ||
|
||
What example to show? | ||
|
||
# References |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
remove "examples" here, because we no longer auto-generate them
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done in ellisonbg@6e995d0