Skip to main content

Platform-agnostic, highly customizable sequence plotting in console

Project description

asciiplot

PyPI - Python Version Build codecov PyPI GitHub release (latest SemVer) PyPI - Downloads GitHub

Platform-agnostic, highly customizable sequence plotting in console

Installation

$pip install asciiplot

Plot Appearance Configuration Options

Set:

  • chart height & title
  • the color of virtually all chart components and areas, picked from a wide array of shades due to the integration of colored
  • consistent margin between consecutive data points to widen your chart
  • the chart indentation within its hosting terminal, or whether it ought to be centered in it, respectively
  • axes descriptions
  • x-axis tick labels, which may be set to contain strings instead of just numeric values
  • y-axis tick label decimal places

Usage Examples

from asciiplot import asciiize, Color


print(
    asciiize(
        [1, 1, 2, 3, 5, 8, 13, 21],
        sequence_colors=[Color.BLUE_3B],
        height=21,
        inter_points_margin=5,
        background_color=Color.LIGHT_SALMON_1,
        label_color=Color.BLUE_VIOLET,
        axes_background_color=Color.DEEP_PINK_3A,
        title='Fibonacci',
        title_color=Color.RED_1,
        x_axis_description='x',
        y_axis_description='y',
        center_horizontally=True
    )
)

alt text

from asciiplot import asciiize, Color


print(
    asciiize(
        [17, 21, 19, 19, 5, 7, 12, 4],
        [7, 8, 3, 17, 19, 18, 5, 2, 20],
        sequence_colors=[Color.RED, Color.BLUE_VIOLET],
        inter_points_margin=5,
        height=20,
        background_color=Color.GREY_7,
        title='Random Sequences',
        title_color=Color.MEDIUM_PURPLE,
        label_color=Color.MEDIUM_PURPLE,
        x_axis_description='x',
        y_axis_description='y',
        center_horizontally=True
    )
)

alt text

Acknowledgements

Core sequence asciiization algorithm adopted from https://github.com/kroitor/asciichart/blob/master/asciichartpy/

Testing

git clone https://github.com/w2sv/asciiplot.git
cd asciiplot
poetry install
make test  # runs mypy, pytest doctest and outputs test coverage

License

MIT License

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

asciiplot-0.1.6.tar.gz (12.9 kB view hashes)

Uploaded Source

Built Distribution

asciiplot-0.1.6-py3-none-any.whl (15.9 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