How do I clear a plot's series?

[hoffstadt]

Answer

A series is no different than any other Dear PyGui item. Just delete it! The structure of a plot is as follows:

• plot
  • slot 0
    • legend (optional)
    • annotations (optional)
    • drag lines (optional)
    • drag points (optional)
  • slot 1
    • x axis (required)
    • y axis (required)
      • series (optional)
    • y axis 2 (optional)
      • series (optional)
    • y axis 3 (optional)
      • series (optional)
  • slot 2
    • drawing items (optional)
  • slot 3
    • drag payloads (optional)

To clear all of a plot's series. You just need to delete the y axes' slot 1 children using delete_item(...) with children_only set to True and slot set to 1.

Example

import dearpygui.dearpygui as dpg

dpg.create_context()

with dpg.window(label="Tutorial"):

    dpg.add_button(label="delete series", callback=lambda: dpg.delete_item("y_axis", children_only=True, slot=1))

    with dpg.plot(label="Line Series", height=400, width=400):
        
        dpg.add_plot_legend()

        dpg.add_plot_axis(dpg.mvXAxis, label="x")
        dpg.add_plot_axis(dpg.mvYAxis, label="y", tag="y_axis")

        dpg.add_line_series([0, 1, 2, 3], [0, 1, 2, 3], label="data", parent="y_axis")

dpg.create_viewport(title='Custom Title', width=800, height=600)
dpg.setup_dearpygui()
dpg.show_viewport()
dpg.start_dearpygui()
dpg.destroy_context()

Reusable Code

Deletes a plot's series given the plot tag.

def delete_plot_series(plot):

    axes = dpg.get_item_children(plot, 1)

    for axis in axes:
        dpg.delete_item(axis, children_only=True, slot=1)

Resources

• Plots
• Container Slots & Children