Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
94 commits
Select commit Hold shift + click to select a range
a0e8d9a
04_how_to_improve_viz.Rmd
kweav Jan 5, 2026
10a3b1f
add some rules to the ethics section
kweav Jan 5, 2026
8b8213d
british to us spelling
kweav Jan 5, 2026
28c2057
changes to store
kweav Jan 9, 2026
e219d7e
rename files and chapter name
kweav Jan 13, 2026
f39a362
fix header rendering
kweav Jan 13, 2026
45db6bd
capitalize section headers
kweav Jan 13, 2026
c4443fb
merge bookdown yml
kweav Jan 13, 2026
33a5f1e
switch them to quarto files
kweav Jan 14, 2026
b10cfe6
resolve rename conflicts
kweav Jan 14, 2026
35bae08
rename files in quarto yml
kweav Jan 14, 2026
a447262
remove bookdown files
kweav Jan 14, 2026
15e5a65
remove another bookdown file
kweav Jan 14, 2026
8774f11
remove bookdown files directory
kweav Jan 14, 2026
94b51e0
add beginning structure for iterative example
kweav Jan 30, 2026
36b3887
increase fig width and some more exposition
kweav Jan 30, 2026
8831912
fix option name
kweav Jan 30, 2026
5e75fac
quotes needed
kweav Jan 30, 2026
5dc4d2e
are the images better quality and LOs
kweav Jan 30, 2026
0f323bf
how does it look with building out the design elements
kweav Jan 30, 2026
eee6e47
give it the data file
kweav Jan 30, 2026
2ca9f3c
look at code annotation preview
kweav Jan 30, 2026
27ca554
add some alt text
kweav Jan 30, 2026
5e71ce7
give it a library it needs
kweav Jan 30, 2026
f02b556
install ggrepel too
kweav Jan 30, 2026
48a1922
move emphasis blocks and more code annotation notes
kweav Jan 30, 2026
4709cfa
multiline annotation not working maybe now
kweav Jan 30, 2026
b43c665
remove multiline part
kweav Jan 30, 2026
ce038a5
retry multiline without intervening text
kweav Jan 30, 2026
180f5e0
move under clipboard
kweav Jan 30, 2026
672afcc
add some python does it render
kweav Feb 2, 2026
644a870
tested rendering locally
kweav Feb 2, 2026
5181028
update with new docker image
kweav Feb 3, 2026
3f48803
Merge pull request #38 from fhdsl/summaryChAddPy
kweav Feb 3, 2026
6470892
Apply suggestions from Carrie code review
kweav Feb 3, 2026
3c2b362
Update index.qmd to remove mention of second course
kweav Feb 4, 2026
81c21f2
try ethics box and reducing number of iterations
kweav Feb 12, 2026
5df4a8a
Merge branch 'summaryCh' of https://github.com/fhdsl/DataViz_Consider…
kweav Feb 12, 2026
0ab0d3d
fix ethics background
kweav Feb 12, 2026
238495f
change border color away from purple
kweav Feb 12, 2026
0a001d9
toc and accessibility box
kweav Feb 19, 2026
fc81f84
do all of these plots plot
kweav Feb 25, 2026
9080a38
load a package
kweav Feb 25, 2026
bb2113a
fix fence
kweav Feb 25, 2026
ee6d784
regenerate plots with new iteration flow
kweav Feb 25, 2026
b567720
add more python steps
kweav Feb 27, 2026
c8c75d1
try to fix rendering issue
kweav Feb 27, 2026
d4f7d6f
try to force numpy
kweav Feb 27, 2026
6802501
try to force numpy
kweav Feb 27, 2026
2d74e77
is the legend the issue
kweav Feb 27, 2026
be82e63
address spell check
kweav Feb 27, 2026
9c88fdd
handle more spell check
kweav Feb 27, 2026
6acfbd8
test py additions
kweav Mar 18, 2026
26aefa9
try to handle path issue py
kweav Mar 18, 2026
f15aeb3
try to handle path issue again py
kweav Mar 18, 2026
8c95386
need import
kweav Mar 18, 2026
81600c6
avoid cbook
kweav Mar 18, 2026
c3658f6
try iter9 py again
kweav Mar 18, 2026
46a9c93
try iter9 py dif approach
kweav Mar 18, 2026
904c796
try iter9 py explicit draw
kweav Mar 18, 2026
6250aa8
add more explicit padding
kweav Mar 18, 2026
032e451
add more explicit padding and separate lines
kweav Mar 18, 2026
a24925b
closes and more padding
kweav Mar 19, 2026
2d4524f
try again
kweav Mar 19, 2026
35dfab0
adjust and try some numbers
kweav Mar 19, 2026
b8881db
switch line order and center hopefully
kweav Mar 19, 2026
98f7fd1
try internal center hopefully
kweav Mar 19, 2026
8d1b889
adjust locs
kweav Mar 19, 2026
19d99af
thru iter 9 with py
kweav Mar 19, 2026
f7613e3
try simplified code package
kweav Mar 19, 2026
bbe5675
title and aspect ratio py
kweav Mar 19, 2026
14c82ab
try to handle indent error
kweav Mar 19, 2026
bf90838
had extra paren
kweav Mar 19, 2026
7a9281e
try to move iter 8 placement
kweav Mar 19, 2026
cba0678
adjust alignment
kweav Mar 19, 2026
8a9f6b9
retry alignment
kweav Mar 19, 2026
3f97572
adjust more alignment
kweav Mar 19, 2026
5f39d84
some legend changes
kweav Mar 19, 2026
b84ac4f
retry legend
kweav Mar 19, 2026
a08e67d
fix typo
kweav Mar 19, 2026
a4bcc24
legend and title alignment
kweav Mar 19, 2026
ce0cb5e
text size too big
kweav Mar 19, 2026
957e956
try labels
kweav Mar 19, 2026
68f4f0a
import function again
kweav Mar 19, 2026
4bbdace
add text labeling to rest of iterations
kweav Mar 20, 2026
7b9be7f
test include for steps
kweav Mar 20, 2026
5e3a281
finish breaking out files
kweav Mar 20, 2026
86a6ca3
dictionary changes too
kweav Mar 20, 2026
e647f37
Update index.qmd
kweav Mar 20, 2026
6c5081c
check if new lines still plot
kweav Mar 20, 2026
35ebff8
add code annotations and some descriptions of the steps
kweav Mar 20, 2026
30d6003
handle dictionary and remove extra quote
kweav Mar 20, 2026
5c5ee09
adjust a bit
kweav Mar 20, 2026
d81eea0
Merge pull request #37 from fhdsl/summaryCh
kweav May 1, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 0 additions & 27 deletions 04_how_to_improve_viz.qmd

This file was deleted.

133 changes: 133 additions & 0 deletions 05_how_to_improve_viz.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Ethical Data Visualization

Creating a high quality data visualization requires more than picking the right plot for your data and your research question. Certainly following visual design principles and utilizing design tools is a part of creating high quality visualization. However, further best practices are needed to ethically present complex data with clarity in a way that is accessible to audiences. This chapter will discuss ways to enhance the clarity and accessibility of data visualizations as well as important ethical considerations.

## Learning Objectives

```{r fig.align = 'center', out.width = "100%", echo = FALSE, fig.alt = "This chapter will demonstrate how to apply visual design principles to minimize complexity and improve the clarity of a data visualization, identify steps to enhance the clarity, accessibility, and understandability of a data visualization, employ ethical practices in constructing and sharing data visualizations, and how to evaluate whether a data visualization can be improved to enhance its clarity, accessibility, or accuracy."}
ottrpal::include_slide("https://docs.google.com/presentation/d/1fu-KfdN2ldOXB49o9zdpurFbVvl1bOh8cfQ3vu0szk4/edit?slide=id.g3a4b3643292_0_41#slide=id.g3a4b3643292_0_41")
```

## Clearly Presenting Complex Data

An overly complex plot can be misleading for a number of reasons. These reasons include obscuring something because the plot focuses the viewer's attention on another aspect, not separating high density areas or overlapping plot elements, including too much information, or not specifying specialized language such as acronyms or field specific/technical vocabulary.

General tips to reduce complexity when you can:

* Use your visualization to answer **only** one question at a time
* Add annotations or labels (lines, names, colors, etc.)
* Minimize white space, but don't over clutter
* Use clear and accurate labeling and axis names
* Readable (large text)
* Understandable (e..g, avoid jargon and define uncommon acronyms)
* Separate plot elements or overlapping data
* Use facets or subplots to separate different categories of data
* Increase opacity/transparency
* Decrease point size or change the shape
* Consider a log transformation
* Use a zoomed inset
* Consider typical reading order
* top to bottom
* left to right

Reducing complexity enhances clarity and accessibility by helping the viewer know where to focus and providing them with reference points or information they need to know (such as acronym meanings).

## Best Practices for Accessibility

Reducing complexity is a very important first step in designing accessible visualizations. Beyond reducing complexity, additional considerations are necessary to further enhance accessibility for visualization audiences. Audiences may have visual impairments such as low vision or blindness or color vision deficiency, motor impairments (relevant for interactive visualizations), or dyslexia. Additionally, audiences likely will be unfamiliar with your research and may be distracted when interacting with your research.

This course will mostly focus on making visualizations accessible for those with visual impairments and those unfamiliar with your research.

### Color Palettes

### Contrast

### Text

#### Axis Labels

#### Annotations

#### Titles

#### Captions

### Alternative Text Descriptions

## Ethical Data Visualization

Ethical visualizations improve viewers' understanding rather than confuse or mislead. Misleading messages are not always intentional on the part of the researcher putting together a data visualization, and mistakes happen (e.g., bugs in software, errors in data entry, etc.). It's the responsibility of the researcher to carefully evaluate all data visualizations before sharing them to make sure that the visualizations clearly and accurately present the data and communicate the overall goal.

Several of the topics we'll provide within this section about ethical considerations are related to tips to reduce complexity and enhance accessibility. This is not surprising given that clear communication is a necessity for both ethical and accessible visualizations.

### Data Inclusion: Safety & Transparency

The rules within this section are aimed to safeguard patient privacy and provide transparency.

**Rule 1: Don't include identifiable data**

ADD thoughts here

**Rule 2: Include all relevant data or subgroups**

ADD thoughts here

**Rule 3: Describe removed samples or dropouts**

ADD thoughts here

### Accuracy

The rules within this section are aimed to encourage careful verification of visualizations.

**Rule 1: Verify that visualizations accurately represent the data**

ADD thoughts about data that may be missing, or sizes/area that don't align with data. Repeat the idea of checking twice before sharing the visualization

**Rule 2: Use clear and accurate axis labels**

ADD thoughts especially related to axis labels. Often having simplified axis labels help audiences. Doing this ethically such that the simplified label is what is being plotted is really important. If the label doesn't match the data, why not plot the data for the simplified label?

### Avoiding Data Distortion

The aims for rules within this section include to avoid misleading messages and to compare groups fairly.

**Rule 1: Use fair axis limits rather than truncating axes**

ADD about starting axis limits at 0 because otherwise differences will look starker than they are

ADD about axis limits when you have facets and how audiences may expect those subplots to use the same axis limits

**Rule 2: Order axes in a logical way that corresponds to the plot's message**

ADD info about the overall message. If a line is going up over time, but the message is related to decrease, why is the line going up? This can be misleading.

**Rule 3: Separate plot elements**

ADD info about how true info can be obscured if plot elements aren't separated.

### Plagiarism & Inspiration

ADD info about plagiarism and what that means for data visualization

ADD info about inspiration

**Rule 1: If in doubt, attribute**

ADD info about attribution if you're concerned.

### Empathy

Tips for showing empathy while constructing data visualizations based on suggestions from the Urban Institute. These are more tips and not rules because they are more subjective.

*Visualize each data point*

*Avoid stereotypical colors*

*Use person-first language when appropriate and avoid insensitive language*

*Expand an "Other" category*

## Improving Visualizations

## Summary
24 changes: 0 additions & 24 deletions 06_wrapping_up.qmd

This file was deleted.

Loading
Loading