  The increasing availability of textual corpora and data fetched from social
networks is fuelling a huge production of works based on the model proposed by
psychologist Robert Plutchik, often referred simply as the ``Plutchik Wheel''.
Related researches range from annotation tasks description to emotions
detection tools. Visualisation of such emotions is traditionally carried out
using the most popular layouts, as bar plots or tables, which are however
sub-optimal. The classic representation of the Plutchik's wheel follows the
principles of proximity and opposition between pairs of emotions: spatial
proximity in this model is also a semantic proximity, as adjacent emotions
elicit a complex emotion (a primary dyad) when triggered together; spatial
opposition is a semantic opposition as well, as positive emotions are opposite
to negative emotions. The most common layouts fail to preserve both features,
not to mention the need of visually allowing comparisons between different
corpora in a blink of an eye, that is hard with basic design solutions. We
introduce PyPlutchik, a Python library specifically designed for the
visualisation of Plutchik's emotions in texts or in corpora. PyPlutchik draws
the Plutchik's flower with each emotion petal sized after how much that emotion
is detected or annotated in the corpus, also representing three degrees of
intensity for each of them. Notably, PyPlutchik allows users to display also
primary, secondary, tertiary and opposite dyads in a compact, intuitive way. We
substantiate our claim that PyPlutchik outperforms other classic visualisations
when displaying Plutchik emotions and we showcase a few examples that display
our library's most compelling features.
