Skip to content

Commit

Permalink
reorg chapters
Browse files Browse the repository at this point in the history
  • Loading branch information
JackDougherty committed Feb 18, 2021
1 parent f45ae97 commit 01424a4
Show file tree
Hide file tree
Showing 1,353 changed files with 20,680 additions and 4,483 deletions.
2 changes: 1 addition & 1 deletion 00-openaccess.Rmd → 0-openaccess.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Finally, we're not uninterested in money and its ability to fund more time for w
Clearly, our approach to open-access book publishing may not match your ideals or realities. Perhaps you rely on book sales as your sole source of income. Many authors and publishers still prefer to let readers preview only a chapter online in order to maximize revenue. Some authors will consider open-access publishing, but dare not share their drafts until the work is completed. Others take the opposite approach and widely circulate pieces of their early writing online in blog posts or social media, but do not share the comprehensive final work in the same manner. Still others have never considered any of these options, nor do they realize that the knowledge-production industry is slowly changing, and some book publishers are growing more comfortable with open-access agreements. While our approach may not suit your situation, we hope that our reasoning will nudge you to think differently about why and how we publish books.

### How to read the web edition {-}
Reading the open-access edition of *Hands-On Data Visualization* in your web browser the ideal way to explore our interactive charts and maps. Most are embedded in the web pages as iframes using the same principles illustrated in [Chapter 10: Embed on the Web](embed.html). Also, the web edition enables readers to easily click on internal cross-references and follow our links to external sources.
Reading the open-access edition of *Hands-On Data Visualization* in your web browser the ideal way to explore our interactive charts and maps. Most are embedded in the web pages as iframes using the same principles illustrated in [Chapter 9: Embed on the Web](embed.html). Also, the web edition enables readers to easily click on internal cross-references and follow our links to external sources.

Try these toolbar features located near the top of your browser:

Expand Down
22 changes: 11 additions & 11 deletions 01-introduction.Rmd → 0.0-introduction.Rmd

Large diffs are not rendered by default.

56 changes: 28 additions & 28 deletions 02-choose.Rmd → 01-choose.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,20 @@ Get ready to sketch out your data story in words and pictures. No artistic skill
(ref:data-story-panel) Sketch out your story idea on four pages: problem, question, find data, visualize.

```{r data-story-panel, out.width=750, fig.cap="(ref:data-story-panel)"}
knitr::include_graphics("images/02-choose/data-story-panel.png")
knitr::include_graphics("images/01-choose/data-story-panel.png")
```

This exercise can help you in multiple ways, whether you do it by yourself, or even better, with a team of co-workers, as shown in Figure \@ref(fig:data-story-photo-combined). First, by migrating ideas from your mind to paper, you'll make your thinking clearer not only for you, but also more visible for others. When ideas are sketched out, you can reflect on them, listen to feedback, cross-out not-so-good ones, and replace them with better ones on new sheets of paper. If your initial sketches are too complicated or confusing, break down those ideas into separate pages to make them more coherent.

(ref:data-story-photo-combined) The data story sketching exercise can be done solo, but works even better with a team of people. In our data visualization course, college students and community partners collaborate on framing the data story for their projects.

```{r data-story-photo-combined, out.width=750, fig.cap="(ref:data-story-photo-combined)"}
knitr::include_graphics("images/02-choose/data-story-photo-combined.jpg")
knitr::include_graphics("images/01-choose/data-story-photo-combined.jpg")
```

Second, look at your sheets like a storyboard. Spread them out on a table, move them around to potentially reorder the sequence, start to define the three essential stages of your story: the beginning, middle, and end. Also, these pages can help you organize your thinking about how you'll communicate your data story to larger audiences, such as a presentation slide deck, or paragraphs and pictures for your next report or web page. Don't throw them away, because we'll return to this exercise at the end of the book in [Chapter 16: Tell and Show Your Data Story](story.html).
Second, look at your sheets like a storyboard. Spread them out on a table, move them around to potentially reorder the sequence, start to define the three essential stages of your story: the beginning, middle, and end. Also, these pages can help you organize your thinking about how you'll communicate your data story to larger audiences, such as a presentation slide deck, or paragraphs and pictures for your next report or web page. Don't throw them away, because we'll return to this exercise at the end of the book in [Chapter 15: Tell and Show Your Data Story](story.html).

Finally, this sketching exercise can help you identify which chapters you should focus on in the body of this book. If you're puzzled about where to search for data, check out [Chapter 4: Find and Question Your Data](find.html). If you're thinking about building a chart or map, but need examples of different types, look at the beginning of [Chapter 7: Chart Your Data](chart.html) and [Chapter 8: Map Your Data](map.html).
Finally, this sketching exercise can help you identify which chapters you should focus on in the body of this book. If you're puzzled about where to search for data, check out [Chapter 3: Find and Question Your Data](find.html). If you're thinking about building a chart or map, but need examples of different types, look at the beginning of [Chapter 6: Chart Your Data](chart.html) and [Chapter 7: Map Your Data](map.html).

Now that you have a clearer sense of the story you wish to tell, and some initial ideas about the visualizations you wish to create, in the next two sections we'll discuss tools to do the job, and factors you should consider when deciding among them.

Expand Down Expand Up @@ -85,12 +85,12 @@ Is the tool’s software code publicly viewable? Can the code be modified and re

*10. Accessible for Visually-Impaired Readers*

Does the tool create visualizations that are accessible for visually-impaired readers? Although disability advocacy laws were passed decades ago, digital technology still lags behind and is slowly catching up, especially in the field of data visualization. But some tools include [a built-in check for colorblindness](https://blog.datawrapper.de/colorblind-check/) and offer [chart types designed for low-vision people using screen readers](https://www.highcharts.com/demo/accessible-line), as shown in Figure \@ref(fig:colorblind-accessible-combined).
Does the tool create visualizations that are accessible for visually-impaired readers? Although disability advocacy laws were passed decades ago, digital technology still lags behind and is slowly catching up, especially in the field of data visualization. But some tools include [a built-in check for colorblindness](https://blog.datawrapper.de/colorblind-check/) and offer [chart types designed for people with low vision using screen readers](https://www.highcharts.com/demo/accessible-line), as shown in Figure \@ref(fig:colorblind-accessible-combined).

(ref:colorblind-accessible-combined) On the left, the Datawrapper built-in check for colorblindness. On the right, a Highcharts line chart designed for low-vision accessibility.

```{r colorblind-accessible-combined, out.width=750, fig.cap="(ref:colorblind-accessible-combined)"}
knitr::include_graphics("images/02-choose/colorblind-accessible-combined.png")
knitr::include_graphics("images/01-choose/colorblind-accessible-combined.png")
```

Those are ten factors we consider when deciding whether to add another item into our digital toolkit. Often we need to make compromises, as you'll read in the next section. Of course, your list of factors may vary, and might include other values that are vitally important yet sometimes harder to judge, such as a software developer's ethical business practices or contribution to the public good. Whatever criteria you value, make them explicit in your decision-making process, and inform others about what influences your choices.
Expand All @@ -106,24 +106,24 @@ Table: (\#tab:tools) Recommended Tools and Uses, with Chapter References

| Tools | Collect | Clean | Chart | Geocode | Map | Table | Code | Transform |
|-|-|-|-|-|-|-|-|-|
| Google Sheets spreadsheet/charts | [Ch3](spreadsheet-tools.html) | [Ch5](clean.html) | [Ch7](chart-google.html) | [Ch3](geocode.html) | | [Ch9](table.html) | | |
| LibreOffice Calc spreadsheet/charts | [Ch3](spreadsheet-tools.html) | | | | | | | |
| Airtable relational database | [Ch3](database.html) | | | | | | | |
| Tabula PDF table extractor | | [Ch5](tabula.html) | | | | | | |
| OpenRefine data cleaner | | [Ch5](open-refine.html) | | | | | | |
| Datawrapper charts/maps/tables | | | [Ch7](chart-datawrapper.html) | [Ch8](symbolmap-datawrapper.html) | [Ch8](symbolmap-datawrapper.html) | [Ch9](table-datawrapper.html) | | |
| Tableau Public charts/maps/tables | | | [Ch7](chart-tableau.html) | | [Ch8](map-tableau.html) | [Ch8](table.html) | | |
| Chart.js code templates | | | [Ch12](chartcode.html) | | | | | |
| Highcharts code templates | | | [Ch12](chartcode.html) | | | | | |
| Google My Maps simple map maker | | | | [Ch8](mymaps.html) | [Ch8](mymaps.html) | | | |
| Leaflet map code templates | | | | | [Ch13](leaflet.html) | | | |
| GitHub edit & host code | | | | | | | [Ch11](github.html) | |
| GitHub Desktop & Atom code editor | | | | | | | [Ch11](github-desktop-atom.html) | |
| GeoJson.io edit & draw geodata | | | | | | | | [Ch14](geojsonio.html) |
| Mapshaper edit & join geodata | | | | | | | | [Ch14](mapshaper.html) |
| Map Warper georeference images | | | | | | | | [Ch14](mapwarper.html) |

If this list initially looks overwhelming, don't worry! Newer users can complete most of the twelve introductory-level chapters in this book with only two easy-to-learn tools. Begin with [Google Sheets for spreadsheets and basic charts](https://handsondataviz.org/spreadsheet-tools.html), then move up to [Datawrapper for more advanced charts and maps](https://handsondataviz.org/chart-datawrapper.html). You can create amazing data visualizations with just these two tools. Also, they play nicely together, as Datawrapper allows you to directly import and update data from Google Sheets.
| Google Sheets spreadsheet/charts | [Ch2](spreadsheet-tools.html) | [Ch4](clean.html) | [Ch6](chart-google.html) | [Ch2](geocode.html) | | [Ch8](table.html) | | |
| LibreOffice Calc spreadsheet/charts | [Ch2](spreadsheet-tools.html) | | | | | | | |
| Airtable relational database | [Ch2](database.html) | | | | | | | |
| Tabula PDF table extractor | | [Ch4](tabula.html) | | | | | | |
| OpenRefine data cleaner | | [Ch4](open-refine.html) | | | | | | |
| Datawrapper charts/maps/tables | | | [Ch6](chart-datawrapper.html) | [Ch7](symbolmap-datawrapper.html) | [Ch7](symbolmap-datawrapper.html) | [Ch8](table-datawrapper.html) | | |
| Tableau Public charts/maps/tables | | | [Ch6](chart-tableau.html) | | [Ch7](map-tableau.html) | [Ch8](table.html) | | |
| Chart.js code templates | | | [Ch11](chartcode.html) | | | | | |
| Highcharts code templates | | | [Ch11](chartcode.html) | | | | | |
| Google My Maps simple map maker | | | | [Ch7](mymaps.html) | [Ch7](mymaps.html) | | | |
| Leaflet map code templates | | | | | [Ch12](leaflet.html) | | | |
| GitHub edit & host code | | | | | | | [Ch10](github.html) | |
| GitHub Desktop & Atom code editor | | | | | | | [Ch10](github-desktop-atom.html) | |
| GeoJson.io edit & draw geodata | | | | | | | | [Ch13](geojsonio.html) |
| Mapshaper edit & join geodata | | | | | | | | [Ch13](mapshaper.html) |
| Map Warper georeference images | | | | | | | | [Ch13](mapwarper.html) |

If this list initially looks overwhelming, don't worry! Newer users can complete most of the twelve introductory-level chapters in this book with only two easy-to-learn tools. Begin with [Google Sheets for spreadsheets and basic charts](spreadsheet-tools.html), then move up to [Datawrapper for more advanced charts and maps](chart-datawrapper.html). You can create amazing data visualizations with just these two tools. Also, they play nicely together, as Datawrapper allows you to directly import and update data from Google Sheets.

In addition to the tools featured in Table \@ref(tab:tools), you'll also see many more useful add-ons and assistants mentioned in the text, including [ColorBrewer to select map colors](map-design.html), the [Geocoding by SmartMonkey add-on for Google Sheets](geocode.html), and the [W3Schools TryIt iframe page](https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_iframe). Also, consider enhancing your web security by installing the free [Privacy Badger browser extension from the Electronic Frontier Foundation](https://privacybadger.org/) to view and exercise some control over who's tracking you, and also review the [EFF's Surveillance Self-Defense Guide](https://ssd.eff.org/).

Expand All @@ -133,15 +133,15 @@ Finally, we recognize that digital tools are continually changing and evolving.

## Use a Password Manager {- #password-manager}

Finally, we highly recommend a password manager: think of it as one tool to rule them all! Password managers help you to keep track of all of the accounts you will create when using several of the online tools above. We recommend installing [BitWarden](https://bitwarden.com), an open-source password manager that offers its core features for free for Windows, Mac, and Linux computers, all major web browsers, and iOS and Android mobile devices. When you install BitWarden, you create one universal password (be careful not to forget it) that grants you access to all of the account usernames and passwords you catalog. You also install the Bitwarden extension in your preferred web browsers. When you register for a new account in your browser, the password manager typically asks if you wish to store that information in your vault with end-to-end encryption. Also, when you visit that site in the future, the password manager usually recognizes it and enters your login credentials with one click, as shown in Figure \@ref(fig:bitwarden-annotated).
Finally, we highly recommend a password manager: think of it as one tool to rule them all! Password managers help you to keep track of all of the accounts you will create when using several of the online tools above. We recommend installing [Bitwarden](https://bitwarden.com), an open-source password manager that offers its core features for free for Windows, Mac, and Linux computers, all major web browsers, and iOS and Android mobile devices. When you install BitWarden, you create one universal password (be careful not to forget it) that grants you access to all of the account usernames and passwords you catalog. You also install the Bitwarden extension in your preferred web browsers. When you register for a new account in your browser, the password manager typically asks if you wish to store that information in your vault with end-to-end encryption. Also, when you visit that site in the future, the password manager usually recognizes it and enters your login credentials with one click, as shown in Figure \@ref(fig:bitwarden-annotated).

(ref:bitwarden-annotated) The Bitwarden browser extension recognizes sites you have previously stored, and enters your credentials with one click.

```{r bitwarden-annotated, out.width=500, fig.cap="(ref:bitwarden-annotated)"}
knitr::include_graphics("images/02-choose/bitwarden-annotated.png")
knitr::include_graphics("images/01-choose/bitwarden-annotated.png")
```

We recommend storing your passwords inside a tool like BitWarden, rather than in a specific web browser (such as Chrome or Firefox) for two reasons. First, you can set up BitWarden to sync and access your passwords across *different* browsers and *multiple* devices, including your laptop and mobile phone. Second, if your primary browser or computer crashes, you still have online access to your secure BitWarden vault, which means you can continue to work on a different computer.
We recommend storing your passwords inside a tool like Bitwarden, rather than in a specific web browser (such as Chrome or Firefox) for two reasons. First, you can set up BitWarden to sync and access your passwords across *different* browsers and *multiple* devices, including your laptop and mobile phone. Second, if your primary browser or computer crashes, you still have online access to your secure Bitwarden vault, which means you can continue to work on a different computer.

### Summary {- #summary2}
### Summary {- #summary1}
Now you have a better sense of the wide range of data visualization tools we recommend in this book, and how to make wise decisions when choosing among tools in general. Always keep the data story in the forefront of your mind, since the tools are simply means to help you achieve that end. The next chapter is designed to strengthen your skills regarding the most common tool in our data visualization toolkit: spreadsheets.
Loading

0 comments on commit 01424a4

Please sign in to comment.