exportedFrom: 97d4ab6c344d331392441434764ea6dbd11a338a

^ Up | Screenshots of the visualizations contained in the Dataviz package. From left to right: Twitter dataselfies, medical information and Panama Papers. Click on each image for more details.

Dataviz is a companion package for Grafoscopio that puts together several examples of Domain Specific Visualizations and Domain Specific Languages (DSV, DSL, respectively) developed with the Roassal agile visualization engine. Included prototypes approach several themes like:
Panama Papers as reproducible Research [@luna-pp], Twitter Data Selfies [@luna-tds] and published medicine access [@luna-infomed] and are presented via blog post and internal interactive documentation via Grafoscopio notebooks. The classes in the package and their documentation show several levels of maturity from pretty mature (Panama Papers) to early coder practices (Infomed) and on going developments (Twitter Data Selfies) and are offered as examples and excersises to learners in our recurrent Dataviz workshop+hackathon, for code testing and refactoring.

It is suposed that you have familiarity with Grafoscopio and that you are in the same audience, as stated in its manual:

Grafoscopio and its companion package, Dataviz, are intended to be used by learners and researchers in several fields: academia, journalism, activism, hacktivism and for anyone interested in open reproducible research and data storytelling backed by data and agile visualizations [@bergel_agile_2016]. This document assumes that you are such person.

Here are some other quick entry points for Dataviz:

• The Dataviz paper for JOSS will give you a quick scholar view for the software: abstract, metatada and links and to dig deeper: [source] | [LaTeX] | [PDF].
• The Dataviz source code repository on SmalltalkHub.

Dataviz package is installed by default with the installation of Grafoscopio, but you can install it separately by using Monticello Pharo package manager configurations. To install and load Dataviz, simply run:

"Start by loading the configuration of Dataviz"
  Gofer new
    url: 'http://smalltalkhub.com/Offray/Dataviz/main';
    package: 'ConfigurationOfDataviz';
  load.

"After that load Datavi"
ConfigurationOfDataviz load.

As we said, Dataviz is a set of packaged exmaples of Domain Specific Visualizations and Domain Specific Language (DSV and DSL) using Roassal agile visualization engine and/or documented with Grafoscopio notebook, so the usage instructions is related with how to use and explore such examples.

Dataviz presents a main notebook (from which this ̀readme ̀ file was generated), that introduce its Domain Specific Visualizations & Languages. To open the notebook go to the Grafoscopio docking bar and select Help > Dataviz or execute the following code:;

GrafoscopioDocumentation openDatavizIntro 

Dataviz, like Grafoscopio, inhabits the Pharo full live coding environment, and we follow the custom of making the API documentation available inside a dynamic environment, instead in some static web page.

Instructions for opening different parts of the Dataviz API inside the system browser, and see the objects and messages organized by protocols, are provided in the companion interactive notebook, with other contextual information, so we recoment to refer to the notebook API documentation.

Because the community that makes/uses Grafoscopio is the same for Dataviz, we follow the same community guidelines for contributing to the community, reporting bugs and other ways of collaboration. It is supposed that you are familiar with Grafoscopio and its manual, if you are using Dataviz. But, just for reference, plese see the Community Guidelines section in the Grafoscopio manual for more detailed information about the above subjects.

Dataviz is licensed under MIT license and the readme and the Dataviz documentation downloaded with the package installation is licensed under a modified P2P license. To see a full copy of such respective licenses, please visit the files under this repository:

• Dataviz source code and software MIT license
• Dataviz documentation P2P modified license