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 details)

    Uploaded Source

    Built Distribution

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

    Uploaded Python 3

    File details

    Details for the file tkchart-1.3.3.tar.gz.

    File metadata

    • Download URL: tkchart-1.3.3.tar.gz
    • Upload date:
    • Size: 18.9 kB
    • Tags: Source
    • Uploaded using Trusted Publishing? No
    • Uploaded via: twine/4.0.2 CPython/3.12.1

    File hashes

    Hashes for tkchart-1.3.3.tar.gz
    Algorithm Hash digest
    SHA256 98f9d5a90cc464788ad7e362b9eeb7b46958a4659a1bab3d0f4774f5a4ed49b0
    MD5 0e1ace9483c923d78af62e597689b5a3
    BLAKE2b-256 2201b917d3f762bfcfc721f7cfc3e0884ea78f152a9a9ed80cd876e8fd3f7c7f

    See more details on using hashes here.

    Provenance

    File details

    Details for the file tkchart-1.3.3-py3-none-any.whl.

    File metadata

    • Download URL: tkchart-1.3.3-py3-none-any.whl
    • Upload date:
    • Size: 12.3 kB
    • Tags: Python 3
    • Uploaded using Trusted Publishing? No
    • Uploaded via: twine/4.0.2 CPython/3.12.1

    File hashes

    Hashes for tkchart-1.3.3-py3-none-any.whl
    Algorithm Hash digest
    SHA256 c07d7b7be2cbfe3a1939146fdeaeed191252c56caf9caab192b9c60bffed17f1
    MD5 7c75a34530e2d1044cccfb5a2abaa32e
    BLAKE2b-256 0988cdd2d963966e1b6ac33aeb7a4f8de104c19021a2414dfc4b0fb1b2cb782c

    See more details on using hashes here.

    Provenance

    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