index.qmd

::: {#hero-banner}

:::: {.grid}

::::: {.headline .g-col-lg-9 .g-col-12 .g-col-md-12}

:::::: h1
`utilitR`
::::::


:::::: h2
Une documentation collaborative sur {{< fa brands r-project >}}
::::::


```{=html}
<a class="github-button" href="https://github.com/inseefrlab/utilitr" data-icon="octicon-star" data-size="large" data-show-count="true" aria-label="Star this website on Github">Star this website on Github</a><script async defer src="https://buttons.github.io/buttons.js"></script>
```

<br>

Le projet `utilitR` est une __documentation collaborative__ sur l'usage du
logiciel {{< fa brands r-project >}}, née à l'__Insee__,
destinée à tout utilisateur intéressé par la manipulation
de données __sans pré-requis de niveau__.

Le contenu d'`utilitR` est entièrement disponible en _open source_ sur `Github` {{< fa brands github >}}.

<br>

::: {.callout-tip}
## [`utilitR` ne couvre pas tous les besoin, loin s'en faut!]{.bigger120}

:::: {.bigger120}

Vous voulez de l'aide pour convertir des codes SAS en `R`? Vous voulez vous former aux bonnes pratiques de développement? Vous voulez faire de la cartographie avancée avec `R`?

Si c'est le cas, `utilitR` ne vous aidera pas beaucoup, mais des liens vers des ressources utiles vous attendent en bas de cette page, n'hésitez pas à les consulter!

::::
:::




:::::

::::: {.g-col-lg-3 .g-col-12 .g-col-md-12}
![](resources/logo-utilitr.png)
:::::

::::

:::


## Principales parties {.unnumbered}

Les principales parties de la documentation, organisées sous 
forme thématique.



<br>


```{ojs}
//| echo: false
teaserList(keys)
```

```{ojs}
//| echo: false
function teaserList(docs, css = THEME_TEASERS) {
  const id = DOM.uid().id;
  return html`<div id="${id}">
    ${getScopedStyle(`#${id}`, css)}
    <div class=listing-grid>${docs.map(doc => renderTeaser(doc))}
  `;
}
```

```{ojs}
//| echo: false
function renderTeaser(doc) {
  const { image, title, description, website, order } = doc;

  return `
    <a href="${website}" class="grid-item-link" target="_blank" rel="noopener">
      <div class="card">
        <p class="card-img-top">
          <img class="thumbnail-image card-img" src="${image}" style="height: auto;">
        </p>
        <div class="card-body post-contents">
          <h5 class="no-anchor card-title listing-title" data-anchor-id="introduction-aux-méthodes-quantitatives-avec-fa-brands-r-project">${title}</h5>
          <div class="card-text listing-description delink">${description}
          </div>        
        </div>
      </div>
    </a>
  `;
}
```



```{ojs}
//| echo: false
import { THEME_TEASERS, ICON_LIKE, getScopedStyle } from "@mootari/notebook-teasers"
```


```{ojs}
//| echo: false
keys = [
  {
    "image": "https://inseefrlab.github.io/formation-bonnes-pratiques-git-R/cards/version-sensibilisation/cats.png",
    "title": "Introduction",
    "description": "Des éléments de présentation du projet <code>utilitr</code>.",
    "website": "/01_R_Insee/presentation_utilitr.html",
    "order": 1
  },
  {
    "image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
    "title": "Mener un projet statistique avec <i class=\"fa-brands fa-r-project\"></i>",
    "description": "<br>Un ensemble de fiches présentant comment se lancer dans un projet d'analyse de données avec <i class=\"fa-brands fa-r-project\"></i><br>.",
    "website": "03_Fiches_thematiques/Fiche_rprojects.html",
    "order": 2
  },
  {
    "image": "https://rgeo.linogaliana.fr/cards/introduction/baby.png",
    "title": "Import des données avec <i class=\"fa-brands fa-r-project\"></i>",
    "description": "<br>Un ensemble de fiches présentant comment importer des données depuis <i class=\"fa-brands fa-r-project\"></i>.",
    "website": "03_Fiches_thematiques/Fiche_import_fichiers_plats.html",
    "order": 3
  },
  {
    "image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
    "title": "Choisir son paradigme d'analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
    "description": "<br>Des fiches générales pour présenter les principaux écosystèmes d'analyse de données.",
    "website": "03_Fiches_thematiques/Fiche_tidyverse.html",
    "order": 4
  },
  {
    "image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
    "title": "Manipuler des données avec <i class=\"fa-brands fa-r-project\"></i>",
    "description": "<br>Des fiches sur des opérations classiques pour manipuler des bases de données avec <i class=\"fa-brands fa-r-project\"></i>",
    "website": "03_Fiches_thematiques/Fiche_joindre_donnees.html",
    "order": 5
  },
  {
    "image": "https://rgeo.linogaliana.fr/cards/quarto/scroll.png",
    "title": "Produire des sorties avec <i class=\"fa-brands fa-r-project\"></i>",
    "description": "<br>Des fiches sur la manière de partager des sorties d'une analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
    "website": "03_Fiches_thematiques/Fiche_graphiques.html",
    "order": 6
  },
  {
    "image": "https://inseefrlab.github.io/formation-bonnes-pratiques-git-R/cards/version-full/eagle.png",
    "title": "Bonnes pratiques",
    "description": "<br>Des fiches sur la manière de partager des sorties d'une analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
    "website": "02_Bonnes_pratiques/01-qualite-code.html",
    "order": 7
  }
]
```

## Ressources utiles {.unnumbered}

### Convertir des codes SAS en `R` {.unnumbered}

La Dares a constuit un [aide-mémoire de SAS vers `R`](https://aide-memoire-r-sas.netlify.app/01-aide_memoire_r_sas) pour aider les agents qui doivent convertir des chaînes SAS vers `R` et Python.

Cet aide-mémoire propose une traduction des codes standards d'une analyse statistique en SAS, `R` (environnements `R` base, `tidyverse`, `data.table`, `arrow/duckdb`) et `pandas` en Python. Ambitieux, il vise à décloisonner les différents langages, en facilitant le passage et l'intercompréhension entre eux.

Le lecteur y trouvera un utile complément d'`utilitR`: il met plus l'accent sur le code informatique que sur les explications théoriques, mais s'appuie sur les conseils d'`utilitR` et s'y réfère si nécessaire.

N'hésitez pas à le consulter, vous pourriez y trouver des réponses à vos questions ! 


<!-- ### Se former aux bonnes pratiques de développement {.unnumbered} -->

<!-- Lien vers la formation BP. -->

<!-- ### Faire de la cartographie avec `R` {.unnumbered} -->

<!-- Quelles ressources? -->