Changing the Colours and Icons

Preamble

In [1]:
from plotapi import BarFight

BarFight.set_license("your username", "your license key")

Introduction

Let's take a look at how we can change the colours and icons for nodes in our Bar Fight diagram.

Plotapi Bar Fight is a beautiful and feature rich take on the popular Bar Chart Race. As we can see, we have set our license details in the preamble with BarFight.set_license().

Dataset

Plotapi Bar Fight expects at minimum a list of dictionary items, these will define the value of our segments over time.

In [2]:
samples = [
    {"order": 0, "name": "Sankey", "value": 10},
    {"order": 0, "name": "Terminus", "value": 12},
    {"order": 0, "name": "Chord", "value": 8},
    {"order": 0, "name": "Bar Fight", "value": 9},
    {"order": 0, "name": "Pie Fight", "value": 12},

    {"order": 1, "name": "Sankey", "value": 18},
    {"order": 1, "name": "Terminus", "value": 24},
    {"order": 1, "name": "Chord", "value": 22},
    {"order": 1, "name": "Bar Fight", "value": 14},
    {"order": 1, "name": "Pie Fight", "value": 17},

    {"order": 2, "name": "Sankey", "value": 24},
    {"order": 2, "name": "Terminus", "value": 40},
    {"order": 2, "name": "Chord", "value": 32},
    {"order": 2, "name": "Bar Fight", "value": 19},
    {"order": 2, "name": "Pie Fight", "value": 42},

    {"order": 3, "name": "Sankey", "value": 32},
    {"order": 3, "name": "Terminus", "value": 62},
    {"order": 3, "name": "Chord", "value": 40},
    {"order": 3, "name": "Bar Fight", "value": 25},
    {"order": 3, "name": "Pie Fight", "value": 64},

    {"order": 4, "name": "Sankey", "value": 32},
    {"order": 4, "name": "Terminus", "value": 75},
    {"order": 4, "name": "Chord", "value": 55},
    {"order": 4, "name": "Bar Fight", "value": 45},
    {"order": 4, "name": "Pie Fight", "value": 120},
]

We can see that each dictionary item has three properties:

  • order which determines with time period this item belongs to. This should be numerical, but can be formatted e.g. as dates.
  • name the name of the item, and the text that appears on the bar.
  • value the value of the bar at the associated point in time.

Next, we'll start customising the bars, or nodes, that will represent our data over time. Plotapi Bar Fight expects a list of dictionary items to configure each node.

In [3]:
nodes = [
    {
        "name": "Sankey",
        "color": "#ffd166", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/003.png"
    },
    {
        "name": "Terminus",
        "color": "#06d6a0", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/004.png"
    },
    {
        "name": "Chord",
        "color": "#118ab2", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/025.png"
    },
    {
        "name": "Bar Fight",
        "color": "#073b4c", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/151.png"
    },
    {
        "name": "Pie Fight",
        "color": "#ef476f", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/232.png"
    }
]

We can see that each dictionary item has three properties:

  • name, the name of the item, which corresponds to names specified in the samples definitions above.
  • color, the desired colour of the bars (CSS colour e.g. "#073b4c" or "red").
  • icon, the location of the image to use for the icon.

Visualisation

Here we're using .show() which outputs to a Jupyter Notebook cell, however, we may want to output to an HTML file with .to_html() instead. More on the different output methods later!

Be sure to interact with the visualisation to see what the default settings can do!

In [4]:
BarFight(samples,
         nodes=nodes).show()
Plotapi - Bar Fight Diagram

You can do so much more than what's presented in this example, and we'll cover this in later sections. If you want to see the full list of growing features, check out the Plotapi Documentation.

Changing the Colours and Icons

Preamble

In [1]:
from plotapi import PieFight

PieFight.set_license("your username", "your license key")

Introduction

Let's take a look at how we can change the colours and icons for nodes in our Pie Fight diagram.

Plotapi Pie Fight is a beautiful and feature rich take on the popular Pie Chart Race. As we can see, we have set our license details in the preamble with PieFight.set_license().

Dataset

Plotapi Pie Fight expects at minimum a list of dictionary items, these will define the value of our segments over time.

In [2]:
samples = [
    {"order": 0, "name": "Sankey", "value": 10},
    {"order": 0, "name": "Terminus", "value": 12},
    {"order": 0, "name": "Chord", "value": 8},
    {"order": 0, "name": "Bar Fight", "value": 9},
    {"order": 0, "name": "Pie Fight", "value": 12},

    {"order": 1, "name": "Sankey", "value": 18},
    {"order": 1, "name": "Terminus", "value": 24},
    {"order": 1, "name": "Chord", "value": 22},
    {"order": 1, "name": "Bar Fight", "value": 14},
    {"order": 1, "name": "Pie Fight", "value": 17},

    {"order": 2, "name": "Sankey", "value": 24},
    {"order": 2, "name": "Terminus", "value": 40},
    {"order": 2, "name": "Chord", "value": 32},
    {"order": 2, "name": "Bar Fight", "value": 19},
    {"order": 2, "name": "Pie Fight", "value": 42},

    {"order": 3, "name": "Sankey", "value": 32},
    {"order": 3, "name": "Terminus", "value": 62},
    {"order": 3, "name": "Chord", "value": 40},
    {"order": 3, "name": "Bar Fight", "value": 25},
    {"order": 3, "name": "Pie Fight", "value": 64},

    {"order": 4, "name": "Sankey", "value": 38},
    {"order": 4, "name": "Terminus", "value": 75},
    {"order": 4, "name": "Chord", "value": 55},
    {"order": 4, "name": "Bar Fight", "value": 45},
    {"order": 4, "name": "Pie Fight", "value": 120},
]

We can see that each dictionary item has three properties:

  • order, which determines with time period this item belongs to. This should be numerical, but can be formatted e.g. as dates.
  • name, the name of the item, and the text that appears on the pie chart segment.
  • value, the value of the segment at the associated point in time.

Next, we'll start customising the segments, or nodes, that will represent our data over time. Plotapi Pie Fight expects a list of dictionary items to configure each node.

In [3]:
nodes = [
    {
        "name": "Sankey",
        "color": "#ffd166", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/003.png"
    },
    {
        "name": "Terminus",
        "color": "#06d6a0", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/004.png"
    },
    {
        "name": "Chord",
        "color": "#118ab2", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/025.png"
    },
    {
        "name": "Bar Fight",
        "color": "#073b4c", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/151.png"
    },
    {
        "name": "Pie Fight",
        "color": "#ef476f", 
        "icon": "https://datacrayon.com/datasets/pokemon_img/232.png"
    }
]

We can see that each dictionary item has three properties:

  • name, the name of the item, which corresponds to names specified in the samples definitions above.
  • color, the desired colour of the pie chart segment (CSS colour e.g. "#073b4c" or "red").
  • icon, the location of the image to use for the icon.

Visualisation

Here we're using .show() which outputs to a Jupyter Notebook cell, however, we may want to output to an HTML file with .to_html() instead. More on the different output methods later!

Be sure to interact with the visualisation to see what the default settings can do!

In [4]:
PieFight(samples,
         nodes=nodes).show()
Plotapi - Pie Fight Diagram

You can do so much more than what's presented in this example, and we'll cover this in later sections. If you want to see the full list of growing features, check out the Plotapi Documentation.

Apple's 2021 Q4 Results with Plotapi Sankey

Preamble

In [1]:
from plotapi import Sankey

Sankey.set_license("your username", "your license key")

Introduction

In this notebook we're going to use Plotapi Sankey to visualise some of the Apple's filings for the fourth quarter of 2021.

Dataset

The data can be found in the consolidated financial statements for the three months ending on September 25th 2021.

In [2]:
links = [
    {"source":"iPhone", "target":"Total Revenue", "value": 38.868},
    {"source":"Mac", "target":"Total Revenue", "value": 9.178},
    {"source":"iPad", "target":"Total Revenue", "value": 8.252},
    {"source":"Wearables & Accessories", "target":"Total Revenue", "value": 8.785},
    {"source":"Services", "target":"Total Revenue", "value": 18.277},

    {"source":"Total Revenue", "target":"Cost of Products", "value": 42.790},
    {"source":"Total Revenue", "target":"Products Gross Profit", "value": 22.293},
    {"source":"Total Revenue", "target":"Cost of Services", "value": 5.396},
    {"source":"Total Revenue", "target":"Services Gross Profit", "value": 12.881},
]

Visualisation

Let's use Plotapi Sankey for this visualisation, you can see more examples in the Gallery.

We're going to adjust some colors, layout/template parameters, and flip the intro animation on too.

In [6]:
colors = ["#61bb46", "#fdb827", "#f5821f", "#e03a3e", "#963d97", "#009ddc",
          "red", "lightgreen", "red", "lightgreen",]

Sankey(links, colors=colors, animated_intro=True,
       link_verb="$", node_verb="$", noun="billion",
       link_numbers_template="$<plotapi_value>bn").show()
Plotapi - Sankey Diagram

Animal Crossing Villager Species and Personality

Preamble

In [1]:
from plotapi import Chord
import json

Introduction

In this notebook we're going to use Plotapi Chord to visualise the co-occurrences between the species and personality of Animal Crossing villagers. We"ll use Python, but Plotapi can be used from any programming language.

In a chord diagram (or radial network), entities are arranged radially as segments with their relationships visualised by ribbons that connect them. The size of the segments illustrates the numerical proportions, whilst the size of the arc illustrates the significance of the relationships. Chord diagrams are useful when trying to convey relationships between different entities, and they can be beautiful and eye-catching.

Dataset

We're going to use data from Animal Crossing New Horizons data. Previously, we made use of the data available in this repository. However, since the 2.0 update, we've created our own! Let's get loading the data.

In [2]:
with open("ac_species_personality.json", "r") as f:
    data = json.load(f)

Visualisation

Let's use Plotapi Chord for this visualisation, you can see more examples in the Gallery.

We're going to adjust some layout and template parameters, and flip the intro animation on too.

Because we're using a data-table, we can also click on any part of the diagram to "lock" the selection.

In [3]:
Chord(
    data["matrix"],
    data["names"],
    colors=data["colors"],
    details=data["details"],
    details_thumbs=data["details_thumbs"],
    noun="villagers!",
    thumbs_width=50,
    curved_labels=True,
    popup_width=600,
    bipartite=True,
    bipartite_idx=data["bipartite_idx"],
    bipartite_size=0.4,
    padding=0.0,
    width=800,
    data_table_column_width=100,
    font_size_large="16px",
    data_table=data["data_table"],
    data_table_show_indices=False
).show()
PlotAPI - Chord Diagram

Total Global Email & Spam with Plotapi Terminus

Preamble

In [1]:
from plotapi import Terminus
import json

Terminus.set_license("your username", "your license key")

Introduction

In this notebook we're going to use Plotapi Terminus to visualise the average daily email & spam volume for August 2021.

In the Terminus diagram (a type of flow diagram), we can watch the journey of something or someone from some starting category to some ending category. In this case, we'll be watching emails travel from their classification (legitimate or spam) to their recipients represented by a single inbox.

There is no doubt that this data would be better communicated with a bar or pie chart. This is a fun exercise.

Dataset

We're going to use the Email & Spam data published by Talos Intelligence over at this page. The numbers we're interested in are under the heading TOTAL GLOBAL EMAIL & SPAM VOLUME FOR AUGUST 2021, labelled with Average Daily Legitimate Email Volume and Average Daily Spam Volume.

In [2]:
data = [
    {"source": "Legitimate", "target": "Inboxes", "value": 12.30*(10**9)}, 
    {"source": "Spam", "target": "Inboxes", "value": 65.50*(10**9)},
]

Visualisation

Let's use Plotapi Terminus for this visualisation, you can see more examples in the Gallery.

We're going to adjust some layout and template parameters. We're setting pixels_per_unit=10**7 to represent $10$ million emails with a single pixel. This effects the length of the animation, making it shorter than the default of setting.

In [3]:
Terminus(data, colors=['#56c885','#ea647e'],
         title="Watch <plotapi_count> emails sent during an Aug-2021 day",
         vertical=True,  width=400, pipe_alignment="middle", 
         pixels_per_unit=10**7).show()
Plotapi - Terminus Diagram

Desktop Browsers Market Share with Plotapi Pie Fight

Preamble

In [1]:
from plotapi import PieFight
import json

PieFight.set_license("your username", "your license key")

Introduction

In this notebook we're going to use Plotapi Pie Fight to visualise desktop browser market share over time. We"ll use Python, but Plotapi can be used from any programming language.

Dataset

We're going to use data that has been published by multiple sources for different periods, as there is no single data source that covers everything. These are:

  • 1994 - 1995: GVU WWW user survey
  • 1996 - 1998: EWS Web Server at UIUC
  • 1999 - 2001: WebSideStory
  • 2002 - 2008: OneStat.com
  • 2009-2021: StatCounter

The popup text that describes different events was taken from Wikipedia.

Browsers that did not have significant market share have been grouped and labelled as "Others".

In [2]:
with open("desktop_browsers.json", "r") as f:
    data = json.load(f)
    
samples = data['samples']
nodes = data['nodes']
events = data['events']

Visualisation

Let's use Plotapi Pie Fight for this visualisation, you can see more examples in the Gallery.

In [3]:
PieFight(samples, 
         nodes=nodes,
         events=events,
         rotate=30,
         interval=750,
         event_pause=False,
         event_duration=10000,
         format_current_order="0.2f", 
         value_suffix="%",
         autohide_labels=False).show()
Plotapi - Pie Fight Diagram

IMDb Top 1000 with Plotapi Chord

Preamble

In [ ]:
from plotapi import Chord
import json

Chord.set_license("your username", "your license key")

Introduction

In this notebook we're going to use Plotapi Chord to visualise the co-occurrences of genres in the IMDb "Top 1000" (Sorted by IMDb Rating Descending). We"ll use Python, but Plotapi can be used from any programming language.

In a chord diagram (or radial network), entities are arranged radially as segments with their relationships visualised by ribbons that connect them. The size of the segments illustrates the numerical proportions, whilst the size of the arc illustrates the significance of the relationships. Chord diagrams are useful when trying to convey relationships between different entities, and they can be beautiful and eye-catching.

Dataset

We're going to use the latest IMDB top 1000 data which is available on their website. Let"s get loading the data.

In [ ]:
with open("imdb_top_1000.json", "r") as f:
    data = json.load(f)
    
names = ['Action', 'Adventure', 'Animation', 'Biography', 'Comedy',
         'Crime', 'Drama', 'Family', 'Fantasy', 'Film-Noir',
         'History', 'Horror', 'Music', 'Musical', 'Mystery',
         'Romance', 'Sci-Fi', 'Sport', 'Thriller', 'War', 'Western']

Visualisation

Let's use Plotapi Chord for this visualisation, you can see more examples in the Gallery.

We're going to adjust some layout and template parameters, and flip the intro animation on too. We'll also configure the data table to hide the indices, and we'll make sure to compress our data table so we have a smaller output size. Finally, we've also set data_table_unique_column="Name", because we have instances where a title has 3 or more genres, and we don't want them to appear multiple times in the same data table selection.

Because we're using a data-table, we can also click on any part of the diagram to "lock" the selection.

In [6]:
Chord(
    data["matrix"],
    names,
    colors="movies",
    noun="titles",
    data_table_column_width=100,
    data_table_unique_column="Name",
    data_table_show_indices=False,
    compress=True,
    data_table=data["data_table"],
    animated_intro=True,
).show()
PlotAPI - Chord Diagram

Getting started with Plotapi Bar Fight

Preamble

In [1]:
from plotapi import BarFight

BarFight.set_license("your username", "your license key")

Introduction

Our first Plotapi Bar Fight Diagram!

Plotapi Bar Fight is a beautiful and feature rich take on the popular Bar Chart Race. As we can see, we have set our license details in the preamble with BarFight.set_license().

Dataset

Plotapi Bar Fight expects at minimum a list of dictionary items, these will define the value of our bars over time.

In [2]:
samples = [
    {"order": 0, "name": "Plotapi Sankey", "value": 10},
    {"order": 0, "name": "Plotapi Terminus", "value": 12},
    {"order": 0, "name": "Plotapi Chord", "value": 14},
    {"order": 0, "name": "Plotapi Bar Fight", "value": 9},
    {"order": 0, "name": "Plotapi Secret", "value": 12},

    {"order": 1, "name": "Plotapi Sankey", "value": 18},
    {"order": 1, "name": "Plotapi Terminus", "value": 24},
    {"order": 1, "name": "Plotapi Chord", "value": 29},
    {"order": 1, "name": "Plotapi Bar Fight", "value": 14},
    {"order": 1, "name": "Plotapi Secret", "value": 17},

    {"order": 2, "name": "Plotapi Sankey", "value": 24},
    {"order": 2, "name": "Plotapi Terminus", "value": 40},
    {"order": 2, "name": "Plotapi Chord", "value": 52},
    {"order": 2, "name": "Plotapi Bar Fight", "value": 19},
    {"order": 2, "name": "Plotapi Secret", "value": 42},

    {"order": 3, "name": "Plotapi Sankey", "value": 32},
    {"order": 3, "name": "Plotapi Terminus", "value": 62},
    {"order": 3, "name": "Plotapi Chord", "value": 72},
    {"order": 3, "name": "Plotapi Bar Fight", "value": 25},
    {"order": 3, "name": "Plotapi Secret", "value": 64},

    {"order": 4, "name": "Plotapi Sankey", "value": 38},
    {"order": 4, "name": "Plotapi Terminus", "value": 75},
    {"order": 4, "name": "Plotapi Chord", "value": 99},
    {"order": 4, "name": "Plotapi Bar Fight", "value": 45},
    {"order": 4, "name": "Plotapi Secret", "value": 120},
]

We can see that each dictionary item has three properties:

  • order which determines with time period this item belongs to. This should be numerical, but can be formatted e.g. as dates.
  • name the name of the item, and the text that appears on the bar.
  • value the value of the bar at the associated point in time.

Visualisation

Creating our first Bar Fight Diagram is as easy as calling Plotapi with our one input.

Here we're using .show() which outputs to a Jupyter Notebook cell, however, we may want to output to an HTML file with .to_html() instead. More on the different output methods later!

Be sure to interact with the visualisation to see what the default settings can do!

In [3]:
BarFight(samples).show()
Plotapi - Bar Fight Diagram

Here we can see the default behaviour of Plotapi Bar Fight.

You can do so much more than what's presented in this example, and we'll cover this in later sections. If you want to see the full list of growing features, check out the Plotapi Documentation.

Getting started with Plotapi Pie Fight

Preamble

In [1]:
from plotapi import PieFight

PieFight.set_license("your username", "your license key")

Introduction

Our first Plotapi Pie Fight Diagram!

Plotapi Pie Fight is a beautiful and feature rich take on the popular Pie Chart Race. As we can see, we have set our license details in the preamble with PieFight.set_license().

Dataset

Plotapi Pie Fight expects at minimum a list of dictionary items, these will define the value of our segments over time.

In [2]:
samples = [
    {"order": 0, "name": "Sankey", "value": 10},
    {"order": 0, "name": "Terminus", "value": 12},
    {"order": 0, "name": "Chord", "value": 8},
    {"order": 0, "name": "Bar Fight", "value": 9},
    {"order": 0, "name": "Pie Fight", "value": 12},

    {"order": 1, "name": "Sankey", "value": 18},
    {"order": 1, "name": "Terminus", "value": 24},
    {"order": 1, "name": "Chord", "value": 22},
    {"order": 1, "name": "Bar Fight", "value": 14},
    {"order": 1, "name": "Pie Fight", "value": 17},

    {"order": 2, "name": "Sankey", "value": 24},
    {"order": 2, "name": "Terminus", "value": 40},
    {"order": 2, "name": "Chord", "value": 32},
    {"order": 2, "name": "Bar Fight", "value": 19},
    {"order": 2, "name": "Pie Fight", "value": 42},

    {"order": 3, "name": "Sankey", "value": 32},
    {"order": 3, "name": "Terminus", "value": 62},
    {"order": 3, "name": "Chord", "value": 40},
    {"order": 3, "name": "Bar Fight", "value": 25},
    {"order": 3, "name": "Pie Fight", "value": 64},

    {"order": 4, "name": "Sankey", "value": 38},
    {"order": 4, "name": "Terminus", "value": 75},
    {"order": 4, "name": "Chord", "value": 55},
    {"order": 4, "name": "Bar Fight", "value": 45},
    {"order": 4, "name": "Pie Fight", "value": 120},
]

We can see that each dictionary item has three properties:

  • order which determines with time period this item belongs to. This should be numerical, but can be formatted e.g. as dates.
  • name the name of the item, and the text that appears on the pie chart segment.
  • value the value of the segment at the associated point in time.

Visualisation

Creating our first Pie Fight Diagram is as easy as calling Plotapi with our one input.

Here we're using .show() which outputs to a Jupyter Notebook cell, however, we may want to output to an HTML file with .to_html() instead. More on the different output methods later!

Be sure to interact with the visualisation to see what the default settings can do!

In [3]:
PieFight(samples).show()
Plotapi - Pie Fight Diagram

Here we can see the default behaviour of Plotapi Pie Fight.

You can do so much more than what's presented in this example, and we'll cover this in later sections. If you want to see the full list of growing features, check out the Plotapi Documentation.

Pokemon Trends Max with Plotapi Bar Fight

Preamble

In [1]:
from plotapi import BarFight
import json

BarFight.set_license("your username", "your license key")

Introduction

In this notebook we're going to use Plotapi Bar Fight to visualise Pokémon search trends over time. We"ll use Python, but Plotapi can be used from any programming language.

The core games are released in generations, each with different Pokémon. We'll include remakes and one popular spin-off - Pokémon Go!

Dataset

We're going to use Pokémon (Gen 1-8) data (a fork of which is available in this repository), combined with data from Google Trends. Let's get loading the data.

The "Interest over time"[1] was retrieved for every Pokemon from Google Trends, for each month between 2004 and 2021. Pikachu was consistently the most popular, so Pikachu was always used as the reference point for every Pokemon. What we're seeing in the plot is the cumulative sum over time.

[1] Interest over time Numbers represent search interest relative to the highest point on the chart for the given region and time. A value of 100 is the peak popularity for the term. A value of 50 means that the term is half as popular. A score of 0 means there was not enough data for this term.

In [2]:
with open("pokemon_trends.json", "r") as f:
    data = json.load(f)
    
samples = data['samples']
nodes = data['nodes']
events = data['events']

icon_base_url = "https://datacrayon.com/images/data-is-beautiful/pokemon_thumbs/"

Visualisation

Let's use Plotapi Bar Fight for this visualisation, you can see more examples in the Gallery.

We're going to adjust some layout and template parameters. These include:

  • event_pause=False: The visualisation won't pause every time an event is displayed.
  • top_n=30: By default, we'll only show 30 bars. We can add/remove bars ourselves by hovering over the visualisation and clicking the + and - buttons.
  • icon_padding=-20: Why a negative number? For this visualisation, as they have transparent backgrounds, I thought it would look nicer to have the Pokemon popping out of their bars.
In [5]:
BarFight(samples, nodes=nodes, events=events, icon_base_url=icon_base_url, event_pause=False,
         width=1000, height=1000, icon_padding=-20, top_n=30, interval=750, 
         background_color="white", border="10px solid black").show()
Plotapi - Bar Fight Diagram