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.1

    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
      • 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"
    • Methods

      • configure : use to change LineChart attributes

        Support parameters

        • height
        • axis_size
        • y_axis_section_count
        • x_axis_section_count
        • y_axis_label_count
        • x_axis_label_count
        • 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
      • 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.1.tar.gz (17.3 kB view details)

    Uploaded Source

    Built Distribution

    tkchart-1.3.1-py3-none-any.whl (11.1 kB view details)

    Uploaded Python 3

    File details

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

    File metadata

    • Download URL: tkchart-1.3.1.tar.gz
    • Upload date:
    • Size: 17.3 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.1.tar.gz
    Algorithm Hash digest
    SHA256 2d894248d50adc9274512f77ff7e14b7cf0dbcfc5d3ca4056dee1a0f7b9c5ecb
    MD5 bf786af8d250158c4cb10ae3041f717f
    BLAKE2b-256 ff884a6b5a6149d837d40c2007f10359b35ebd1cda86805f45a722ac3937843c

    See more details on using hashes here.

    Provenance

    File details

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

    File metadata

    • Download URL: tkchart-1.3.1-py3-none-any.whl
    • Upload date:
    • Size: 11.1 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.1-py3-none-any.whl
    Algorithm Hash digest
    SHA256 b2b27838210dfbad1fa0490e46eb0911a5480a84f85493e869323722731b94ac
    MD5 fd1cd4b42cd9bdab80c4f53a8b42d98d
    BLAKE2b-256 91c9588775ed686331d32130ca64b13872dcd408ff4cfe28cd070a16f6e2989c

    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