Skip to main content

tkchart Library is a Python library that simplifies the process of creating line charts in tkinter and customtkinter GUI applications.

Project description

tkchart

Downloads Downloads Downloads

  • tkchart Library is a Python library that simplifies the process of creating line charts in tkinter and customtkinter GUI applications.
  • Examples



    tkchart - 1.3.3

    You need to install & import package first

    • installation

      •   pip install tkchart 
        
    • importing

      •   import tkchart
        

    objects

    • LineChart
    • Line

    To display data using LineChart you need to do 3 main tasks

    1. Creating a LineChart
    2. Creating a Line
    3. Display of data

    Attributes

    1 . Creating a LineChart

    linechart = tkchart.LineChart()
    
    • Attributes & Types & Values

      • master : tkinter | customtkinter (Frame | Canvas | Tk)
      • width : int
      • height : int
      • axis_size : int
      • y_axis_section_count : int
      • x_axis_section_count : int
      • y_axis_label_count : int
      • x_axis_label_count : int
      • x_axis_display_values_indices : list
      • y_axis_data : str | int | float
      • x_axis_data : str | int | float
      • y_axis_max_value : int | float
      • x_axis_values : List(str | float| int)
        • ["2020 Year", "2021 Year", "2022 Year", "2023 Year", "2024 Year"]
      • y_axis_precision : int
      • section_color : str
        • "#ffffff"
        • "white"
      • y_axis_font_color : str
      • x_axis_font_color : str
      • y_axis_data_font_color : str
      • x_axis_data_font_color : str
      • bg_color : str
      • fg_color : str
      • axis_color : str
      • data_font_style : tuple
        • ("arial",10,"bold")
        • ("arial",20,"normal")
      • axis_font_style : tuple
      • line_width : int | str
      • y_space : int
      • x_space : int
      • x_axis_data_position : str
        • "top"
        • "side"
      • y_axis_data_position : str
        • "top"
        • "side"
      • pointing_callback_function : function
        • function_name(*args)
      • pointer_color : str
      • pointing_values_precision : int
    • Methods

      • configure : use to change LineChart attributes

        Support parameters

        • width
        • height
        • axis_size
        • y_axis_section_count
        • x_axis_section_count
        • y_axis_label_count
        • x_axis_label_count
        • x_axis_display_values_indices
        • y_axis_data
        • x_axis_data
        • y_axis_max_value
        • x_axis_values
        • y_axis_precision
        • section_color
        • y_axis_font_color
        • x_axis_font_color
        • y_axis_data_font_color
        • x_axis_data_font_color
        • bg_color
        • fg_color
        • axis_color
        • data_font_style
        • axis_font_style
        • line_width
        • y_space
        • x_space
        • x_axis_data_position
        • y_axis_data_position
        • pointing_callback_function
        • pointer_color
        • pointing_values_precision
      • show_data : use to display data

        Support parameters

        • data : int
        • line : tkchart.Line
      • place : use to place LineChart

        Support parameters

        • x
        • y
        • rely
        • relx
        • anchor
      • pack : use to pack LineChart

        Support parameters

        • pady
        • padx
        • before
        • after
        • side
        • anchor
      • grid : use to grid LineChart

        Support parameters

        • column
        • columnspan
        • padx
        • pady
        • row
        • rowspan
        • sticky
      • place_forget : use to place forget the chart

      • pack_forget : use to pack forget the chart

      • grid_forget : use to grid forget the chart

      • place_back : use to place chart in the old location after place forget

      • pack_back : use to pack chart in the old location after pack forget

      • grid_back : use to grid chart in the old location after grid forget

      • hide_all : use to hide all the lines

        Support parameters

        • state : bool
      • hide : use to hide a specific line

        Support parameters

        • line : tkchart.Line
        • state : bool
      • reset : use to reset chart

    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5,
                                
                                section_color="#404040",
                                x_axis_font_color="#707070",
                                y_axis_font_color="#707070",
                                x_axis_data_font_color="lightblue",
                                y_axis_data_font_color="lightblue",
                                bg_color="#202020",
                                fg_color="#202020",
                                axis_color="#707070"
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5,
                                
                                section_color="#404040",
                                x_axis_font_color="#707070",
                                y_axis_font_color="#707070",
                                x_axis_data_font_color="lightblue",
                                y_axis_data_font_color="lightblue",
                                bg_color="#202020",
                                fg_color="#202020",
                                axis_color="#707070",
                                
                                data_font_style=("Arial", 15,"bold"),
                                axis_font_style=("Arial", 10,"bold")
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5,
                                
                                section_color="#404040",
                                x_axis_font_color="#707070",
                                y_axis_font_color="#707070",
                                x_axis_data_font_color="lightblue",
                                y_axis_data_font_color="lightblue",
                                bg_color="#202020",
                                fg_color="#202020",
                                axis_color="#707070",
                                
                                data_font_style=("Arial", 15,"bold"),
                                axis_font_style=("Arial", 10,"bold"),
                                
                                x_space=20,
                                y_space=20
                            )
    


    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5,
                                
                                section_color="#404040",
                                x_axis_font_color="#707070",
                                y_axis_font_color="#707070",
                                x_axis_data_font_color="lightblue",
                                y_axis_data_font_color="lightblue",
                                bg_color="#202020",
                                fg_color="#202020",
                                axis_color="#707070",
                                
                                data_font_style=("Arial", 15,"bold"),
                                axis_font_style=("Arial", 10,"bold"),
                                
                                x_space=20,
                                y_space=20,
                                
                                x_axis_data_position="side",
                                y_axis_data_position="size"
                            )
    
    linechart.pack()
    



    2 . Creating a Line

    line = tkchart.Line()
    
    • Attributes & Types & Values

      • master : tkchart.LineChart
      • color : str
        • "white"
        • "#10f0f0"
      • size : int
      • style : str
        • "line"
        • "dashed"
        • "dotted"
      • style_type : tuple(int, int)
        • (5,10)
        • (10,5)
    • Methods

      • configure : use to change Line attributes

        Support parameters
        • size
        • color
        • style
        • style_type
    line = tkchart.Line(master=linechart,
                    color="lightblue",
                    size=2,
                    style="dashed",
                    style_type=(4,10))
    
    



    3 . Display of Data

    import customtkinter 
    import tkchart
    import random
    
    root = customtkinter.CTk()
    
    linechart = tkchart.LineChart(master=root,
                                width=800, 
                                height=400,
                                axis_size=5,
                                
                                y_axis_section_count=5,
                                x_axis_section_count=5,
                                y_axis_label_count=5,
                                x_axis_label_count=10,
                                
                                y_axis_data="GB",
                                x_axis_data="S",
                                x_axis_values=[1,2,3,4,5,6,7,8,9,10],
                                y_axis_max_value=1000,
                                y_axis_precision=5,
                                
                                section_color="#404040",
                                x_axis_font_color="#707070",
                                y_axis_font_color="#707070",
                                x_axis_data_font_color="lightblue",
                                y_axis_data_font_color="lightblue",
                                bg_color="#202020",
                                fg_color="#202020",
                                axis_color="#707070",
                                
                                data_font_style=("Arial", 15,"bold"),
                                axis_font_style=("Arial", 10,"bold"),
                                
                                x_space=20,
                                y_space=20,
                                
                                x_axis_data_position="side",
                                y_axis_data_position="size"
                            )
    linechart.pack()
    
    
    line = tkchart.Line(master=linechart,
                    color="lightblue",
                    size=2,
                    style="dashed",
                    style_type=(4,10))
    
    data = [0,100,200,300,400,500,600,700,800,900,1000]
    def loop():
        linechart.show_data(data=[random.choice(data)], line=line)
        root.after(250,loop)
    loop()
    
    root.mainloop()
    



    Examples




    go to PyPi

    go to GitHub

    Project details


    Download files

    Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

    Source Distribution

    tkchart-1.3.3.tar.gz (18.9 kB view hashes)

    Uploaded Source

    Built Distribution

    tkchart-1.3.3-py3-none-any.whl (12.3 kB view hashes)

    Uploaded Python 3

    Supported by

    AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page