Troubleshooting

Package Installation

Package installation can sometime be tricky and can go wrong for several reasons (locked files, outdated dependencies, old R version …). To minimize the chance of errors, follow this checklist:

  • Make sure no RStudio Project is loaded (except when using `{renv}`).

  • Make sure no package are loaded in the R session. Use Ctrl + Alt + F10 to restart the session to a fresh state.

  • Make sure you have a GITHUB_PAT token configured (by running Sys.getenv("GITHUB_PAT") in a R session, it should return a character starting with ghp_). If not, follow these instructions.

Git

Useful commands for resolving git problems are available in this chapter.

Quarto (or RMarkdown)

OSPsuite figures’s text is very small in my output document

In Quarto and RMarkdown documents, figures generated by {ospsuite} or {esqlabsR} needs {showtext} to be initialized in a specific way to ensure that text in figures is rendered correctly. Do to so, include the following knitr option at the very beginning of your document (after the YAML header):

```{r}
knitr::opts_chunk$set(
  fig.showtext = TRUE
)
```
Back to top