Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rstudio/concept-maps
Concept maps for all things data science
https://github.com/rstudio/concept-maps
Last synced: 3 days ago
JSON representation
Concept maps for all things data science
- Host: GitHub
- URL: https://github.com/rstudio/concept-maps
- Owner: rstudio
- License: other
- Created: 2020-08-21T00:11:16.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-05-24T16:55:34.000Z (over 3 years ago)
- Last Synced: 2024-10-28T03:39:38.418Z (17 days ago)
- Language: HTML
- Size: 8.57 MB
- Stars: 162
- Watchers: 12
- Forks: 42
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- jimsghstars - rstudio/concept-maps - Concept maps for all things data science (HTML)
README
# Concept Maps
Mental models used in introductory data science lessons.
All material made available under the [Creative Commons - Attribution license](LICENSE.md).
- [Concept Maps](#concept-maps)
- [dplyr](#dplyr)
- [select](#select)
- [filter](#filter)
- [mutate](#mutate)
- [group_by and summarize](#group_by-and-summarize)
- [data types](#data-types)
- [pivoting](#pivoting)
- [separate - extract - unite](#separate---extract---unite)
- [factors](#factors)
- [R Markdown](#r-markdown)
- [regular expressions](#regular-expressions)
- [pipe operator](#pipe-operator)
- [clustering](#clustering)
- [data syndication](#data-syndication)
- [Make](#make)
- [functions](#functions)
- [program configuration](#program-configuration)
- [column names](#column-names)
- [learnr tutorial](#learnr-tutorial)
- [column-wise operations](#column-wise-operations)
- [across](#across)
- [Boolean](#boolean)
- [values and variables](#values-and-variables)
- [neural networks](#neural-networks)
- [Under Development](#under-development)
- [visualization](#visualization)
- [join](#join)
- [Inspirations](#inspirations)
- [Contributing](#contributing)
- [Formatting](#formatting)
- [Exporting](#exporting)
- [Discussion](#discussion)
## Concept Maps
### dplyr
Monica Alonso,
[Greg Wilson][wilson-greg]
### select
Monica Alonso,
[Greg Wilson][wilson-greg]
### filter
Monica Alonso,
[Greg Wilson][wilson-greg]
### mutate
Monica Alonso,
[Greg Wilson][wilson-greg]
### group_by and summarize
Monica Alonso,
[Greg Wilson][wilson-greg]
### data types
[Meghan Sposato][sposato-meghan],
[Brendan Cullen][cullen-brendan],
Monica Alonso
### pivoting
Florian Schmoll,
Monica Alonso
### separate - extract - unite
Monica Alonso,
[Greg Wilson][wilson-greg]
### factors
[Ildiko Czeller][czeller-ildiko],
[Graham Parsons][parsons-graham],
Monica Alonso
### R Markdown
[Gabriela Sandoval][sandoval-gabriela],
[Florencia D'Andrea][dandrea-florencia],
[Yanina Bellini Saibene][bellini-saibene-yanina],
Monica Alonso
### regular expressions
Monica Alonso,
[Greg Wilson][wilson-greg]
### pipe operator
[Jeroen Janssens][janssens-jeroen],
Monica Alonso
### clustering
[Uli Niemann][niemann-uli]
### data syndication
[Greg Wilson][wilson-greg]
### Make
[Greg Wilson][wilson-greg]
### functions
[Greg Wilson][wilson-greg]
### program configuration
[Greg Wilson][wilson-greg]
### column names
[Emily Riederer][riederer-emily] (originally in [this blog post](https://emilyriederer.netlify.app/post/column-name-contracts/))
### learnr tutorial
[Yanina Bellini Saibene][bellini-saibene-yanina]
### column-wise operations
[Brendan Cullen][cullen-brendan]
### across
[Emma Vestesson][vestesson-emma]
### Boolean
[Greg Wilson][wilson-greg]
### values and variables
[Greg Wilson][wilson-greg]
### neural networks
[Omayma Said][said-omayma],
[Greg Wilson][wilson-greg]
## Under Development
### visualization
*This one is still unsatisfactory: please [contact us](mailto:[email protected]) with suggestions or submit a pull request to this repository.*
Monica Alonso,
[Greg Wilson][wilson-greg]
### join
*This one is still unsatisfactory: please [contact us](mailto:[email protected]) with suggestions or submit a pull request to this repository.*
[Garrick Aden-Buie][aden-buie-garrick],
[Greg Wilson][wilson-greg]
## 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](https://app.diagrams.net/)
or [downloaded](https://github.com/jgraph/drawio-desktop/releases/tag/v13.6.2)
from [the project's GitHub repository](https://github.com/jgraph/drawio)
(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](https://www.diagrams.net/blog/rough-style) 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](https://graphviz.org/),
[DiagrammeR](https://rich-iannone.github.io/DiagrammeR/),
or some other tool that compiles text into diagrams?**
1. As [these graphviz-generated files](./dot/README.md) 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).
[aden-buie-garrick]: https://www.garrickadenbuie.com/
[bellini-saibene-yanina]: https://yabellini.netlify.app/
[cullen-brendan]: https://bcullen.rbind.io/
[czeller-ildiko]: https://ildiczeller.com/
[dandrea-florencia]: https://florencia.netlify.app/
[janssens-jeroen]: https://jeroenjanssens.com
[niemann-uli]: https://www.linkedin.com/in/uli-niemann/
[parsons-graham]: http://grahamrp.com/
[riederer-emily]: https://emilyriederer.netlify.app/
[said-omayma]: https://www.onceupondata.com/
[sandoval-gabriela]: https://twitter.com/GabySandovalM
[sposato-meghan]: https://education.rstudio.com/trainers/people/sposato+meghan/
[vestesson-emma]: https://emmavestesson.netlify.app/
[wilson-greg]: http://third-bit.com
