Mercury

The Mercury framework convert Jupyter Notebooks to interactive Web Apps. It integrates great with ipyvizzu.

Features

The features of ipyvizzu that are available in Mercury are marked with a green check.

• Change the url of Vizzu (vizzu)
• Change the width of the Chart (width)
• Change the height of the Chart (height) DisplayUse scroll into view (scroll_into_view=True)

Display features:

• Display all animations after _repr_html_ method called (display=DisplayTarget.MANUAL)
• Display all animations after show method called (display=DisplayTarget.MANUAL)
• Automatically display all animations after the first cell (display=DisplayTarget.BEGIN)
• Automatically display all animations after the currently running cell (display=DisplayTarget.ACTUAL)
• Automatically display all animations after the last running cell (display=DisplayTarget.END)
• Rerun any cell without rerun the first cell (display!=DisplayTarget.MANUAL)

Check Chart settings chapter for more details.

Live example

Installation

Add ipyvizzu to requirements.txt.

python-dotenv
pandas
mercury
ipyvizzu

Sample

Try ipyvizzu in Mercury with the following sample.

# import pandas and ipyvizzu

import pandas as pd
from ipyvizzu import Chart, Data, Config, Style, DisplayTarget
import mercury as mr


# setup Mercury App
app = mr.App(
    title="ipyvizzu demo", description="ipyvizzu demo with mercury"
)


# add widget
gender = mr.Select(
    label="Select sex", value="female", choices=["female", "male"]
)


# initialize Chart

chart = Chart(
    width="640px", height="360px"
)  # or Chart(width="640px", height="360px", display=DisplayTarget.ACTUAL)
# chart = Chart(width="640px", height="360px", display=DisplayTarget.BEGIN)
# chart = Chart(width="640px", height="360px", display=DisplayTarget.END)
# chart = Chart(width="640px", height="360px", display=DisplayTarget.MANUAL)


# add data to Chart

data = Data()
df = pd.read_csv(
    "https://ipyvizzu.vizzuhq.com/0.17/showcases/titanic/titanic.csv"
)
data.add_df(df)

chart.animate(data)


# add config to Chart

chart.animate(
    Config(
        {
            "x": "Count",
            "y": "Sex",
            "label": "Count",
            "title": "Passengers of the Titanic",
        }
    )
)
chart.animate(
    Config(
        {
            "x": ["Count", "Survived"],
            "label": ["Count", "Survived"],
            "color": "Survived",
        }
    )
)
chart.animate(Config({"x": "Count", "y": ["Sex", "Survived"]}))


# add style to Chart

chart.animate(Style({"title": {"fontSize": 35}}))


# filter data by the selected gender to Chart

data_filter = Data.filter(f"record['Sex'] == '{gender.value}'")
chart.animate(data_filter)


# display Chart with show method (display=DisplayTarget.MANUAL)

# chart.show()

Check the Tutorial for more info.