Nushell
Get Nu!
Getting Started
  • The Nushell Book
  • Command Reference
  • Cookbook
  • Language Reference Guide
  • Contributing Guide
Blog
  • English
  • 中文
  • Deutsch
  • Français
  • Español
  • 日本語
  • Português do Brasil
  • Русский язык
GitHub
Get Nu!
Getting Started
  • The Nushell Book
  • Command Reference
  • Cookbook
  • Language Reference Guide
  • Contributing Guide
Blog
  • English
  • 中文
  • Deutsch
  • Français
  • Español
  • 日本語
  • Português do Brasil
  • Русский язык
GitHub
  • Categories

    • Bits
    • Bytes
    • Chart
    • Conversions
    • Core
    • Database
    • Dataframe
    • Dataframe Or Lazyframe
    • Date
    • Debug
    • Default
    • Env
    • Experimental
    • Expression
    • Filesystem
    • Filters
    • Formats
    • Generators
    • Hash
    • History
    • Lazyframe
    • Math
    • Misc
    • Network
    • Path
    • Platform
    • Plugin
    • Prompt
    • Random
    • Removed
    • Shells
    • Strings
    • System
    • Viewers

histogram for chart

Creates a new table with a histogram based on the column name passed in.

Signature

> histogram {flags} (column-name) (frequency-column-name)

Flags

  • --percentage-type, -t {string}: percentage calculate method, can be 'normalize' or 'relative', in 'normalize', defaults to be 'normalize'

Parameters

  • column-name: Column name to calc frequency, no need to provide if input is a list.
  • frequency-column-name: Histogram's frequency column, default to be frequency column output.

Input/output types:

inputoutput
list<any>table

Examples

Compute a histogram of file types

> ls | histogram type

Compute a histogram for the types of files, with frequency column named freq

> ls | histogram type freq

Compute a histogram for a list of numbers

> [1 2 1] | histogram
╭────┬────────┬────────┬───────────┬─────────────┬────────────────────────────────────────────────────────────────────╮
│  # │ value  │ count  │ quantile  │ percentage  │                             frequency                              │
├────┼────────┼────────┼───────────┼─────────────┼────────────────────────────────────────────────────────────────────┤
│  0 │      1 │      2 │      0.67 │ 66.67%      │ ****************************************************************** │
│  1 │      2 │      1 │      0.33 │ 33.33%      │ *********************************                                  │
╰────┴────────┴────────┴───────────┴─────────────┴────────────────────────────────────────────────────────────────────╯

Compute a histogram for a list of numbers, and percentage is based on the maximum value

> [1 2 3 1 1 1 2 2 1 1] | histogram --percentage-type relative