nu_plugin_nuplot

command module
v0.1.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 26, 2025 License: BSD-2-Clause Imports: 9 Imported by: 0

README

nuplot

nuplot is a nushell plugin for plotting charts. It builds interactive charts from your data that are opened inside the web browser.

Features

  • Supported chart types:
    • Line chart
    • Bar chart
    • Stacked bar chart
    • Pie chart
    • Boxplot chart
    • Kline chart
  • Chart title, size and color theme can be adjusted
  • Configure, which series is used for the x-axis

Examples

A Simple Pie chart
{'apples': 7 'oranges': 5 'bananas': 3} | nuplot pie --title "Fruits"

Fruits

Show weather forcast from wttr.in as bar chart
http get http://wttr.in?format=j1
| get weather
| select date avgtempC
| each {|l| {date: ($l.date | into datetime) avgtempC: ($l.avgtempC | into int)} }
| nuplot bar --xaxis date --title "Weather forcast"

The data type conversion for avgtempC is needed, because nuplot only shows series of numbers. The data type conversion of the date column can be omitted but will lead to warnings in the moment because the date format is not recognized correctly.

Weather forcast (1)

Show the average monthly temperatures as a boxplot chart
http get https://bulk.meteostat.net/v2/hourly/2024/10389.csv.gz
| gunzip
| from csv --noheaders
| select column0 column2
| rename date temperature
| upsert date {|l| $l.date | format date "%B"}
| chunk-by {$in.date}
| nuplot boxplot --xaxis date --title "Average monthly temperatures for 2024 in Berlin"

image

Build and install

Prerequisits: You will need the Go compiler to build the project.

Check out the project

git clone https://github.com/gtnebel/nu_plugin_nuplot.git

Build the project

go build

Install and use the plugin

plugin add nu_plugin_nuplot; plugin use nuplot;

Now, help nuplot line should show the help for the line chart.

TODO

  • Implement chart types
    • Line chart
    • Bar chart
    • Stacked bar chart
    • Pie chart
    • Boxplot chart
    • Kline chart
  • Implement main command nuplot
  • Define a default set of flags for all chart types
  • Define reasonable default features for all charts
  • Documentation
  • Packaging

Documentation

Overview

nu_plugin_nuplot is a [Nushell](https://nushell.sh/) plugin for plotting charts. It builds interactive charts from your data that are opened inside the web browser.

Directories

Path Synopsis
This package holds all plugin subcommands along with common data types and functions used by all subcommands.
This package holds all plugin subcommands along with common data types and functions used by all subcommands.
flags
This package holds the flags used in all subcommands.
This package holds the flags used in all subcommands.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL