Skip to main content

Create text-based graphs

Project description

tplot

Documentation status Tests status codecov

Supported Python versions PyPI version License

tplot is a Python package for creating text-based graphs. Useful for visualizing data to the terminal or log files.

Features

  • Scatter plots, line plots, horizontal/vertical bar plots, and image plots
  • Supports numerical and categorical data
  • Legend
  • Unicode characters (with automatic ascii fallback if unicode is not supported)
  • Colors (using ANSI escape characters, with Windows support)
  • Few dependencies
  • Fast and lightweight
  • Doesn't take over your terminal (it only prints strings, so it works with tqdm etc.)

Installation

tplot is available on PyPi:

pip install tplot

Documentation

Documentation is available on readthedocs.

Examples

Basic usage

import tplot

fig = tplot.Figure()
fig.scatter([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
fig.show()

Basic example

A more advanced example

import tplot
import numpy as np

x = np.linspace(start=0, stop=np.pi*3, num=80)

fig = tplot.Figure(
    xlabel="Phase",
    ylabel="Amplitude",
    title="Trigonometric functions",
    legendloc="bottomleft",
    width=60,
    height=15,
)
fig.line(x, y=np.sin(x), color="red", label="sin(x)")
fig.line(x, y=np.cos(x), color="blue", label="cos(x)")
fig.show()

Advanced example

See more examples in the documentation.

Contributing

Contributions are welcome. Bug fixes, feature suggestions, documentation improvements etc. can be contributed via issues and/or pull requests.

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

tplot-0.3.1.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

tplot-0.3.1-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file tplot-0.3.1.tar.gz.

File metadata

  • Download URL: tplot-0.3.1.tar.gz
  • Upload date:
  • Size: 13.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.8.10 Linux/5.4.0-94-generic

File hashes

Hashes for tplot-0.3.1.tar.gz
Algorithm Hash digest
SHA256 f20ff64dafbf799da7726fca44dd09f66747d12c57527a21f94c150aa6d7e70a
MD5 f353f5b5f8770dd26ddc7c242d440054
BLAKE2b-256 a34cc0ec21a8f2ca591b6655cf2453306a600b0ef919ea46511a5f2685091a9d

See more details on using hashes here.

File details

Details for the file tplot-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: tplot-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 13.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.8.10 Linux/5.4.0-94-generic

File hashes

Hashes for tplot-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8b1937175d1e7f8e07dbb0fab04be57bde371775dfc1ea5c78bb9ca9eed78930
MD5 55c2c896764cff2013903fd0d5e68fb9
BLAKE2b-256 e859f4176fcb162acbdf7050652966d98b98b511fc3241ee993b61043967e3c6

See more details on using hashes here.

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