Note: this documentation reflects the alpha build of the repository which is currently undergoing redesign in September 2020. Please expect some specifics of e.g. interface interaction to shift. This note will be removed when user guide is caught up with the current build.
The Teach Viz by Example repository is a space for the data visualization teaching community to find, share, and contribute exemplary data visualizations + visualization-ready datasets. The beta version of this website comprises a set of sample data visualization and data set objects, including related images and metadata. The collection items in this demo were suggested by the Visualizing the Future fellows and organizers.
After navigating to the “Browse” drop-down in the menu, you can select to browse either the visualization collection or the dataset collection. Each collection has slightly different properties. For example, on the visualization Browse page, you can see thumbnail images of the visualization examples.
The “Browse” pages include facets on select metadata fields. The facets, or checkbox filters, appear on the left and allow users to specify which combination of example properties is desirable. Selecting an option in one of the facet groups will filter the examples to include only those examples tagged with that value. For example, if you are looking for examples at a “beginner” audience level, clicking the “beginner” checkbox will exclude anything not tagged for beginners. If you are okay with either beginner or intermediate examples, you can select both boxes at the same time. That will include items with either a beginner tag or an intermediate tag (or both).
If you choose checkboxes from more than one facet group, your search will become more refined. For example, if you start with beginner and intermediate examples, but then you also select “entertainment” as the topic area, your search will change from all beginner/intermediate examples to only those that also are tagged as “entertainment.” Feel free to play with the filter options to get used to how they work!
The “Search” link in the menu will take you to a search box that will search across various metadata fields for both data visualization and dataset examples. This is most useful if you know the name of the data set or visualization you are searching for, or some other qualifying information. A few examples include searching by title, creator, or topic (i.e., gun violence).
We are actively developing this resource and plan to release a workflow and documentation to facilitate user contributions in Spring 2021. As we move forward, we’d love to hear from you! The best way to reach out with technical concerns is to lodge an issue on GitHub. You can also view our code in our repository.