rstudio/concept-maps

Concept maps for all things data science

Concept Maps

Mental models used in introductory data science lessons.

All material made available under the Creative Commons - Attribution license.

• Concept Maps
  • dplyr
  • select
  • filter
  • mutate
  • group_by and summarize
  • data types
  • pivoting
  • separate - extract - unite
  • factors
  • R Markdown
  • regular expressions
  • pipe operator
  • clustering
  • data syndication
  • Make
  • functions
  • program configuration
  • column names
  • learnr tutorial
  • column-wise operations
  • across
  • Boolean
  • values and variables
  • neural networks
• Under Development
  • visualization
  • join
• Inspirations
• Contributing
  • Formatting
  • Exporting
  • Discussion

Concept Maps

dplyr

Monica Alonso, Greg Wilson

select

Monica Alonso, Greg Wilson

filter

Monica Alonso, Greg Wilson

mutate

Monica Alonso, Greg Wilson

group_by and summarize

Monica Alonso, Greg Wilson

data types

Meghan Sposato, Brendan Cullen, Monica Alonso

pivoting

Florian Schmoll, Monica Alonso

separate - extract - unite

Monica Alonso, Greg Wilson

factors

Ildiko Czeller, Graham Parsons, Monica Alonso

R Markdown

Gabriela Sandoval, Florencia D'Andrea, Yanina Bellini Saibene, Monica Alonso

regular expressions

Monica Alonso, Greg Wilson

pipe operator

Jeroen Janssens, Monica Alonso

clustering

Uli Niemann

data syndication

Greg Wilson

Make

Greg Wilson

functions

Greg Wilson

program configuration

Greg Wilson

column names

Emily Riederer (originally in this blog post)

learnr tutorial

Yanina Bellini Saibene

column-wise operations

Brendan Cullen

across

Emma Vestesson

Boolean

Greg Wilson

values and variables

Greg Wilson

neural networks

Omayma Said, Greg Wilson

Under Development

visualization

This one is still unsatisfactory: please contact us with suggestions or submit a pull request to this repository.

Monica Alonso, Greg Wilson

join

This one is still unsatisfactory: please contact us with suggestions or submit a pull request to this repository.

Garrick Aden-Buie, Greg Wilson

Inspirations

Dates and Times

Silvia Canelón

HTTP

Greg Wilson

Map

Lefkios Paikousis

Missing Values

Roman Popat

Neural Networks

Omayma Said

Text Analysis

Ahmad Husain Abdullah

Visualization

Corrado Lanera

RStudio Products

Carl Howe

Administering RStudio Server Pro

Andrie de Vries

RStudio Server Pro Configurations (simple and complex)

Andrie de Vries

Setting Up RStudio Server Pro

Andrie de Vries

programs

Greg Wilson

variables and values

Greg Wilson

Contributing

Formatting

• All diagrams are created with diagrams.net, which can be used online or downloaded from the project's GitHub repository (approximately 100MB).

• Save all diagrams as "Editable SVG" (a superset of the SVG standard that includes information about anchor points and connections).

• Use the "Sketch" style, which can be chosen from the "Style" menu when no elements are selected. (See this blog post for details.)

• Use #FEFEFF (very pale blue) as a background color and #000080 (very dark blue) for lines and text. Use 1pt lines, no fill, and 12pt Helvetica. If there is a central concept, give it a 3pt outline and make the text bold and italic

• Connect both ends of lines to anchor points on concepts and move text as needed so that it does not lie on the line.

• When mentioning specific functions, do not put () after the function's name (as this makes it impossible to distinguish between a mention of the function and a call to the function with zero arguments).

Exporting

• Export PNG by selecting everything and then using these settings:

  • Zoom: 100%
  • Border Width: 4 pixels
  • Selection Only
    • Crop

• Do not select "Transparent Background", "Shadow", "Embed Images", or "Include a copy of my diagram".

Discussion

• Why concept maps? They help authors figure out what they want to teach, give other instructors a quick overview of a lesson, and allow learners to check that they have constructed the right mental model.

• What about translations? We hope eventually to be able to store translated text in the .drawio files. For now, please copy an existing diagram and save it in the appropriate language directory (e.g., af/topic.svg for concept maps in Afar).

• Why SVG? Because vector diagrams rescale much more smoothly than raster images.

• Why not use color? Or more shapes? Or...? The simpler these diagrams are, the easier they will be to maintain. Simple diagrams also display better on smaller or older devices.

• Why not use Graphviz, DiagrammeR, or some other tool that compiles text into diagrams?

  1. As these graphviz-generated files show, it's hard to get their automatic layout algorithms to do as good a job as a person can do.
  2. They have a much steeper learning curve, which means fewer people will be able to contribute.
  3. They don't actually make version control easier (reading and understanding the textual description of a diagram is as hard as viewing two diagrams side by side).

concept-maps's Issues

pivoting

Going through this concept map I saw that it says is part of dplyr. On the Spanish version it says it part of tidyr.
I think it should say it part of tidyr in the English version too. This function works slightly different to dplyr basics (e.g. the first argument is a data frame and the subsequent arguments describe what to do with the data frame).
https://r4ds.had.co.nz/tidy-data.html

In Data Syndication should there be a relationship between Body and Data

I was wondering if there should be a relationship between body & data. Perhaps something like "body may contain data"

Joins

I've been working on a concept map for joins. I'm similarly not completely satisfied, but I thought I would share for feedback and collaboration.

In working on this, I've realized that one conceptual challenge is that the while all joins involve two tables, the verb of the operation is different for mutating and filtering joins — mutating joins combine while filtering joins filter.

I liked and I tried to retain the table structure from the current concept map, but I tried to incorporate the row-matching that occurs when joining tables. Although now comparing again to the current version, I've lost the filling with NA concept.

Feedback welcome and I'll be happy to iterate on this or open a PR to submit more formally.

VISUALIZATION

Hi! I suggest a change in Visualization chart. I've sended a PR with the translations to spanish of the concept_maps in /en folder. In Visualization, I added a detail of Visualization Properties. Attached the spanish version
I hope it would be a good approach.
Best regards
Mónica

visualization.zip