Quelle est la largeur de l'argument dans position_dodge?

Je vais d'abord donner des réponses très brèves à vos trois questions principales. Puis-je marcher à travers plusieurs exemples pour illustrer les réponses de manière plus approfondie.

1. Dont la largeur ne précise pas?
   
   La largeur des éléments à être esquivé.

2. Quelle est l'unité"?
   
   La réelle ou le virtuel largeur dans les unités de données des éléments d'être esquivé.

3. Ce qui est la valeur par défaut?
   
   Si vous n'avez pas ensemble la esquivant width explicitement, mais dépendent de la valeur par défaut, position_dodge(width = NULL) (ou juste position = "dodge"), la dodge largeur qui est utilisée est la largeur réelle en unités de données de l'élément à être esquivé.

Je crois que votre quatrième question est trop large DONC. Veuillez consulter le code de collision et dodge et, si nécessaire, demandez à un nouveau, plus spécifique, question.

---

Basé sur l'esquive de la largeur de l'élément (avec son original en position horizontale et le nombre d'éléments qui sont empilés), le nouveau centre de positions (x) de chaque élément, et de nouvelles largeurs (xmin, xmax positions) sont calculés. Les éléments sont décalés horizontalement juste assez loin pour ne pas se chevauchent avec les éléments adjacents. De toute évidence, à l'échelle des éléments doit être changé plus que les éléments dans l'ordre pour éviter les chevauchements.

Pour obtenir une meilleure sensation à esquiver en général et de l'utilisation de la width argument en particulier, je montre quelques exemples. Nous commençons avec un simple esquivé diagramme en barres, avec par défaut en esquivant; on peut utiliser soit position = "dodge" ou le plus explicite position = position_dodge(width = NULL)

# some toy data
df <- data.frame(x = 1,
                 y = 1,
                 grp = c("A", "B"))

p <- ggplot(data = df, aes(x = x, y = y, fill = grp)) + theme_minimal()
p + geom_bar(stat = "identity",
             position = "dodge")
           # which is the same as:
           # position = position_dodge(width = NULL))

Donc (1) qui est width est-il dans position_dodge et (2) quelle est l'unité?

Dans ?position_dodge on peut lire:

width: En esquivant largeur, lorsque différents à la largeur des éléments individuels

Ainsi, si nous utilisons la par défaut width, c'est à dire NULL, l'esquivant calulations sont base sur la largeur des éléments individuels.

Donc une simple réponse à votre première question, "Dont la largeur ne précise pas?, serait: la largeur des éléments individuels.

Mais bien sûr, nous avons alors se demander, qu'est-ce que "la largeur des éléments individuels"? Commençons avec les barres. De ?geom_bar:

width: La largeur de la barre. Par défaut, réglé à 90% de la résolution des données

Une nouvelle question se pose: quelle est la résolution? Nous allons vérifier ?ggplot2::resolution:

La résolution est la plus petite valeur non zéro distance entre les valeurs. Si il y a une seule valeur unique [comme dans notre exemple], alors la résolution est définie à l'être.

Nous essayons:

resolution(df$x)
# [1] 1

Ainsi, la valeur par défaut la largeur de la barre dans cet exemple est 0.9 * 1 = 0.9

Nous pouvons le vérifier en consultant les données ggplot utilise pour rendre les bars sur la parcelle à l'aide de ggplot_build. Nous créons une parcelle objet avec un empilées barplot, avec des barres de largeur par défaut.

p2 <- p +
  geom_bar(stat = "identity",
           position = "stack")

L'emplacement correspondant dans l'objet est $data, qui est une liste avec un seul élément pour chaque couche dans l'intrigue, dans le même ordre qu'ils apparaissent dans le code. Dans cet exemple, nous n'avons qu'une seule couche, c'est à dire geom_bar, regardons donc le premier emplacement:

ggplot_build(p2)$data[[1]]

#      fill x y label PANEL group ymin ymax xmin xmax colour size linetype alpha
# 1 #F8766D 1 1     A     1     1    0    1 0.55 1.45     NA  0.5        1    NA
# 2 #00BFC4 1 2     B     1     2    1    2 0.55 1.45     NA  0.5        1    NA

Chaque ligne contient les données de 'tirer' une seule barre. Comme vous pouvez le voir, la largeur de la des bars sont tous à 0,9 (xmax - xmin = 0.9). Ainsi, la largeur de la empilés les bars, pour être utilisé dans les calculs de la nouvelle esquivé les positions et les largeurs, est 0.9.

---

Dans l'exemple précédent, nous avons utilisé la valeur par défaut la largeur de la barre, avec la valeur par défaut dodge largeur. Maintenant, nous allons faire la barre légèrement plus large que la largeur par défaut ci-dessus (0.9). Utiliser le width argument en geom_bar explicitement ensemble l' (empilé) la largeur de la barre de l'e.g 1. Nous essayons d'utiliser les mêmes dodge largeur comme ci-dessus (position_dodge(width = 0.9)). Ainsi, alors que nous avons ensemble la réelle la largeur de la barre à 1, la dodge calculs sont effectués comme si les barres sont de 0,9 large. Voyons ce qui se passe:

p +
  geom_bar(stat = "identity", width = 1, position = position_dodge(width = 0.9), alpha = 0.8)
p

Les bars se chevauchent, car ggplot changements bars horizontalement comme si ils ont un (empilés) largeur de 0,9 (ensemble dans position_dodge), alors qu'en fait, les bars ont une largeur de 1 (ensemble dans geom_bar).

Si nous utilisons le par défaut esquiver les valeurs, les barres sont déplacés horizontalement de manière précise en fonction de la ensemble la largeur de la barre:

p +
  geom_bar(stat = "identity", width = 1, position = "dodge", alpha = 0.8)
                                   # or: position = position_dodge(width = NULL)

---

Ensuite, nous essayons d'ajouter du texte à notre parcelle à l'aide de geom_text. Nous commençons avec la valeur par défaut en esquivant width (c'est à dire position_dodge(width = NULL)), c'est à dire en esquivant est basé sur la taille d'élément par défaut.

p <- ggplot(data = df, aes(x = x, y = y, fill = grp, label = grp)) + theme_minimal()
p2 <- p +
  geom_bar(stat = "identity", position = position_dodge(width = NULL)) +
  geom_text(size = 10, position = position_dodge(width = NULL))
                  # or position = "dodge"    

p2
# Warning message:
#  Width not defined. Set with `position_dodge(width = ?)`

La esquivant du texte n'est pas. Quel est le message d'avertissement? "La largeur n'est pas défini?". Légèrement énigmatique. Nous avons besoin de consulter la section des Détails de ?geom_text:

Note la "largeur" et "hauteur" d'un élément de texte sont 0,
donc, l'empilage et en esquivant texte ne fonctionnera pas par défaut,
[...]
Évidemment, les étiquettes ont la hauteur et la largeur, mais ils sont en unités physiques, pas d'unités de données.

Donc pour geom_text, la largeur des éléments individuels est égale à zéro. C'est aussi la première "officielle ggplot référence" à votre deuxième question: L'unité de width est dans unités de données.

Regardons les données utilisées pour rendre le texte des éléments sur l'intrigue:

ggplot_build(p3)$data[[2]]
#       fill x y label PANEL group xmin xmax ymax colour size angle hjust vjust alpha family fontface lineheight
# 1 #F8766D 1 1     A     1     1    1    1    1  black   10     0   0.5   0.5    NA               1        1.2
# 2 #00BFC4 1 1     B     1     2    1    1    1  black   10     0   0.5   0.5    NA               1        1.2

En effet, xmin == xmax; Ainsi, la largeur de l'élément de texte dans les unités de données est zéro.

Comment parvenir à corriger en esquivant de l'élément de texte avec une largeur de zéro? À partir d'Exemples dans ?geom_text:

ggplot2 ne sais pas vous voulez donner les étiquettes de la même virtuel largeur que les barres [...] Donc le dire:

Ainsi, pour esquiver l'utilisation de la même largeur pour geom_text éléments que le geom_bar éléments lorsque de nouveaux postes sont calculés, nous avons besoin de ensemble "le virtuel en esquivant largeur dans les unités de données" de l'élément de texte à la même largeur que les bars. Nous utilisons le width argument de position_dodge à ensemble le virtuel largeur de l'élément de texte à 0,9 (c'est à dire la largeur de la barre dans l'exemple ci-dessus):

p2 <- p +
  geom_bar(stat = "identity", position = position_dodge(width = NULL)) +
  geom_text(position = position_dodge(width = 0.9), size = 10)

Vérifier les données utilisées pour le rendu geom_text:

ggplot_build(p2)$data[[2]]
#      fill     x y label PANEL group xmin xmax ymax colour size angle hjust vjust alpha family fontface lineheight
# 1 #F8766D 0.775 1     A     1     1 0.55 1.00    1  black   10     0   0.5   0.5    NA               1        1.2
# 2 #00BFC4 1.225 1     B     1     2 1.00 1.45    1  black   10     0   0.5   0.5    NA               1        1.2

Maintenant les éléments de texte ont une largeur en unités de données: xmax - xmin = 0.9, c'est à dire de la même largeur que les bars. Ainsi, la dodge calculs seront maintenant comme si les éléments de texte ont une certaine largeur, ici 0.9. Le rendu de la parcelle:

p2

Le texte est esquivé correctement!

---

Semblable à du texte, la largeur en unités de données de points (geom_point) et des barres d'erreur (par exemple,geom_errorbar) est égale à zéro. Ainsi, si vous avez besoin d'esquiver ces éléments, vous devez spécifier un virtuels pertinents largeur, sur laquelle esquiver les calculs sont alors en fonction. Voir, par exemple, l'Exemple de l'article de ?geom_errorbar:

Si vous voulez esquiver les bars et les errorbars, vous devez spécifier manuellement la dodge largeur [...] Parce que les bars et les errorbars ont des largeurs différentes, nous devons spécifier la largeur de la des objets qui nous sont esquivant sont

---

Voici un exemple avec plusieurs valeurs de x sur une échelle continue:

df <- data.frame(x = rep(c(10, 20, 50), each = 2),
                 y = 1,
                 grp = c("A", "B"))

Disons que nous voulons créer un esquivé barplot avec un peu de texte au-dessus de chaque barre. D'abord, il suffit de vérifier barplot uniquement à l'aide de la valeur par défaut en esquivant largeur:

p <- ggplot(data = df, aes(x = x, y = y, fill = grp, label = grp)) + theme_minimal()

p + 
  geom_bar(stat = "identity", position = position_dodge(width = NULL))
                         # or position = "dodge"

Qu'il fonctionne comme prévu. Ensuite, ajouter le texte. Nous essayons de définir le virtuel largeur de l'élément de texte à la même que la largeur des barres dans l'exemple ci-dessus, c'est à dire on "suppose" que les barres de toujours avoir la largeur de 0,9, et que nous avons besoin d'esquiver les éléments de texte comme si ils ont une largeur de 0,9 ainsi:

p +
  geom_bar(stat = "identity", position = "dodge") +
  geom_text(position = position_dodge(width = 0.9), size = 10)

Clairement, l'esquivant de calcul pour les barres est maintenant basé sur une largeur différente de 0,9 et de réglage de l'virtuel largeur de 0,9 pour l'élément de texte est une mauvaise proposition. Donc, ce que est la largeur de la barre ici? Encore une fois, la largeur de la barre est "[e]n par défaut, réglé à 90% de la résolution des données". Vérifiez la résolution:

resolution(df$x)
# [1] 10

Ainsi, la largeur de l' (par défaut empilés) les bars, sur lequel leur nouveau, esquivé la position est calculée, est maintenant 0.9 * 10 = 9. Ainsi, pour esquiver les bars et leurs correspondants texte "main dans la main", nous avons besoin de définir le virtuel largeur de la également des éléments de texte à 9:

p +
  geom_bar(stat = "identity", position = "dodge") +
  geom_text(position = position_dodge(width = 9), size = 10)

---

Dans notre dernier exemple, nous avons une catégorie de l'axe x, juste un "facteur de la version' des valeurs de x à partir de ci-dessus.

df <- data.frame(x = factor(rep(c(10, 20, 50), each = 2)),
                 y = 1,
                 grp = c("A", "B"))

Dans R, les facteurs qui sont à l'interne un ensemble de codes entier avec un "niveaux" de l'attribut. Et à partir de ?resolution:

Si x est un entier vecteur, alors qu'il est supposé représenter une variable discrète, et la résolution est de 1.

Maintenant, nous savons que, lorsque resolution est 1, la valeur par défaut de la largeur des barres est de 0,9. Ainsi, sur un catégorique de l'axe x, la largeur par défaut pour geom_bar est de 0,9, et nous avons besoin de définir le esquivant width pour geom_text en conséquence:

ggplot(data = df, aes(x = x, y = y, fill = grp, label = grp)) +
  theme_minimal() +
  geom_bar(stat = "identity", position = "dodge") +
  # or: position = position_dodge(width = NULL)
  # or: position = position_dodge(width = 0.9)
  geom_text(position = position_dodge(width = 0.9), size = 10)