r-course

Overview

This repository hosts the slides and materials for an introductory R programming course developed for the Center for Metropolitan Studies (CEM) at the University of São Paulo (USP).

The slides are available here.

Usage

The slides are built with the Quarto publishing system and the R programming language. The renv package manages the R environment to ensure reproducibility.

After installing these three dependencies, follow these steps to reproduce the results:

Clone this repository to your local machine.
Open the project in your preferred IDE.
Restore the R environment by running renv::restore() in the R console.
Open index.qmd and run the code as described.

Rendering

After installing all dependencies (see the Usage section), run the following command in the terminal from the project's root directory:

quarto render

This will start the rendering process, which may take some time depending on your machine. Once complete, the Quarto presentation will be available in the docs folder.

Links

You can access the latest course outputs (v2.0.0) at the following links:

Slides: https://danielvartan.github.io/r-course
Code repository: https://github.com/danielvartan/r-course
Photos: https://photos.app.goo.gl/XarvYhtCPeWptmcj7
Videos (pt-BR): https://youtube.com/playlist?list=PL1CZfe9j9vWEmhy3l9_TCl97NueKaMo8m&si=rDTQAROgy4xbuqo7

Contributing

Contributions are always welcome! Whether you want to report bugs, suggest new features, or help improve the code or documentation, your input makes a difference.

Before opening a new issue, please check the issues tab to see if your topic has already been reported.

License

The code in this repository is licensed under the GNU General Public License Version 3, while the slides are available under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.

Copyright (C) 2026 Daniel Vartanian The code in this report is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Citation

To cite this work, please use the following format:

Vartanian, D. (2026). An introduction to the R programming language. Center for Metropolitan Studies, University of São Paulo.

A BibLaTeX entry for LaTeX users is:

@software{vartanian2026,
  title = {An introduction to the R programming language},
  author = {{Daniel Vartanian}},
  year = {2026},
  address = {São Paulo},
  institution = {Center for Metropolitan Studies, University of São Paulo},
  langid = {en},
  doi = {10.5281/zenodo.18332665},
  note = {Computer software}
}

Acknowledgments

This work was developed with support from the Center for Metropolitan Studies (CEM) based at the School of Philosophy, Letters and Human Sciences (FFLCH) of the University of São Paulo (USP) and at the Brazilian Center for Analysis and Planning (CEBRAP).