# Getting Started with ggpop

`ggpop` is a `ggplot2` extension for creating icon-based population charts. Icons from Font Awesome replace bars or dots to represent population proportions visually.

## Quick example

    df_raw <- data.frame(
      sex = c("Female", "Male"),
      n   = c(55, 45)
    )

    df_plot <- process_data(
      data        = df_raw,
      group_var   = sex,
      sum_var     = n,
      sample_size = 40
    ) %>%
      mutate(icon = case_when(
        type == "Female" ~ "person-dress",
        type == "Male"   ~ "person"
      ))

    ggplot() +
      geom_pop(
        data = df_plot,
        aes(icon = icon, color = type),
        size = 2.5, dpi = 72
      ) +
      scale_color_manual(values = c(Female = "#C0392B", Male = "#2980B9")) +
      theme_pop() +
      scale_legend_icon(size = 5) +
      labs(title = "Population by sex", color = NULL)

## Vignettes

Vignette | Description
--- | ---
`process_data()` | Prepare count data for plotting
`geom_pop()` | Population icon grids
`geom_icon_point()` | Icon scatter plots
`fa_icons()` | Search Font Awesome icons
`Themes` | `theme_pop()`, `theme_pop_dark()`, `theme_pop_minimal()`
`Tips` | Rules, gotchas, and best practices