### Install TTY::Pie Gem

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Instructions for installing the TTY::Pie gem using Bundler or directly via the gem command. This is the first step to using the library in a Ruby project.

```ruby
gem "tty-pie"

```

```bash
$ bundle

```

```bash
$ gem install tty-pie

```

--------------------------------

### Build Real-time Data Visualization Dashboard with TTY::Pie

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Shows a complete example of building a terminal dashboard with TTY::Pie, including real-time data updates. This example visualizes browser market share and simulates dynamic changes, re-rendering the pie chart to create a live-updating display. It utilizes screen clearing (`\e[H\e[J`) for a smooth update effect.

```ruby
require "tty-pie"

# Market share visualization
market_data = [
  { name: "Chrome", value: 65, color: :bright_green, fill: "#" },
  { name: "Safari", value: 18, color: :bright_blue, fill: "=" },
  { name: "Firefox", value: 10, color: :bright_yellow, fill: "*" },
  { name: "Edge", value: 5, color: :bright_cyan, fill: "+" },
  { name: "Other", value: 2, color: :bright_magenta, fill: "." }
]

pie = TTY::Pie.new(
  data: market_data,
  radius: 8,
  legend: {
    left: 6,
    line: 1,
    format: "%<label>s %<name>s: %<percent>.1f%%"
  },
  enable_color: true
)

puts "Browser Market Share Q4 2024"
puts "-" * 40
print pie.render

# Dynamic update simulation
loop do
  sleep 2

  # Simulate data change
  market_data.each do |item|
    item[:value] += rand(-2..2)
    item[:value] = [item[:value], 1].max
  end

  pie.update(market_data)

  print "\e[H\e[J"  # Clear screen
  puts "Browser Market Share (Live)"
  puts "-" * 40
  print pie.render
end
```

--------------------------------

### Define Pie Chart Data

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Example of how to define the data structure for a pie chart. Each item includes a name, value, color, and fill character. This data is then passed to the TTY::Pie constructor.

```ruby
data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "x" },
  { name: "LTC", value: 2030, color: :bright_magenta, fill: "@" },
  { name: "ETH", value: 2350, color: :bright_cyan, fill: "+" }
]

```

--------------------------------

### TTY::Pie Data Item Structure

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Illustrates the structure of data items for TTY::Pie charts. It shows examples of minimal data (only value required) and full data with all options (name, value, color, fill) for customization.

```ruby
require "tty-pie"

# Minimal data - only values required
minimal_data = [
  { value: 5977 },
  { value: 3045 },
  { value: 2030 }
]
pie = TTY::Pie.new(data: minimal_data, radius: 2)
print pie

# Full data with all options
full_data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "+" },
  { name: "LTC", value: 2030, color: :bright_magenta, fill: "x" }
]
pie = TTY::Pie.new(data: full_data, radius: 2)
print pie
```

--------------------------------

### Create Basic Pie Chart Instance with TTY::Pie

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Demonstrates how to create a new TTY::Pie instance with cryptocurrency data. It shows the basic structure of data items (name, value, color, fill) and how to print the chart to the console.

```ruby
require "tty-pie"

# Basic pie chart with cryptocurrency data
data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "x" },
  { name: "LTC", value: 2030, color: :bright_magenta, fill: "@" },
  { name: "ETH", value: 2350, color: :bright_cyan, fill: "+" }
]

pie_chart = TTY::Pie.new(data: data, radius: 5)
print pie_chart
```

--------------------------------

### Initialize Pie Chart with Data (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Shows how to initialize a TTY::Pie object with data. Data can be provided during initialization using the :data keyword argument.

```ruby
pie_chart = TTY::Pie.new(data: data)
```

--------------------------------

### Create and Render Pie Chart

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Demonstrates how to instantiate a TTY::Pie object with provided data and a specified radius, and then print the resulting pie chart to the terminal.

```ruby
pie_chart = TTY::Pie.new(data: data, radius: 5)
print pie_chart

```

--------------------------------

### Ruby: Customizing Currency Formatting in Legend

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Demonstrates how to customize currency formatting in the legend using `:precision` and `:delimiter` options. This allows for finer control over the displayed currency value.

```ruby
data = [
  { name: "BTC", value: 5977.12345, fill: "*" },
  { name: "BCH", value: 3045.2, fill: "+" },
  { name: "LTC", value: 2030.444, fill: "x" }
]

legend: {
  format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)",
  precision: 3,
  delimiter: "*"
}

```

--------------------------------

### Ruby: Legend Formatting with Value and Percent

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Shows how to include the data item's value along with its percentage in the legend format. This uses the `<value>` named string placeholder.

```ruby
data = [
  { name: "BTC", value: 5977.12345, fill: "*" },
  { name: "BCH", value: 3045.2, fill: "+" },
  { name: "LTC", value: 2030.444, fill: "x" }
]

legend: {
  format: "%<label>s %<name>s %<value>d (%<percent>.2f%%)"
}

```

--------------------------------

### Ruby: Legend Formatting with Currency

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Illustrates formatting the data item's value as currency in the legend. This utilizes the `<currency>` named string placeholder and defaults to a standard currency format.

```ruby
data = [
  { name: "BTC", value: 5977.12345, fill: "*" },
  { name: "BCH", value: 3045.2, fill: "+" },
  { name: "LTC", value: 2030.444, fill: "x" }
]

legend: {
  format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)"
}

```

--------------------------------

### Ruby: Default Legend Formatting

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Demonstrates the default legend format using Ruby's format sequences and named string placeholders. It displays the icon, name, and calculated percentage for each data item.

```ruby
data = [
  { name: "BTC", value: 5977.12345, fill: "*" },
  { name: "BCH", value: 3045.2, fill: "+" },
  { name: "LTC", value: 2030.444, fill: "x" }
]

# Default format: "%<label>s %<name>s %<percent>.2f%%"

```

--------------------------------

### Render Pie Chart to String (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Demonstrates how to generate a string representation of the pie chart using the 'render' or 'to_s' methods. This string can then be printed to the terminal.

```ruby
print pie_chart.render
```

```ruby
print pie_chart
```

--------------------------------

### Add Data to Pie Chart Dynamically (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Illustrates adding data to a TTY::Pie instance after initialization. Data can be added using the 'add' method or the '<<' operator.

```ruby
pie_chart = TTY::Pie.new
pie_chart << { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" }
pie_chart << { name: "BCH", value: 3045, color: :bright_green, fill: "x" }
pie_chart << { name: "LTC", value: 2030, color: :bright_magenta, fill: "@" }
pie_chart << { name: "ETH", value: 2350, color: :bright_cyan, fill: "+" }
```

--------------------------------

### Configure Pie Chart Legend (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Details how to configure the legend display for a pie chart using the :legend keyword argument. Options include :left, :line, :format, :precision, and :delimiter.

```ruby
pie_chart = TTY::Pie.new(data: data, radius: 3, legend: {left: 10, line: 2})
```

--------------------------------

### Define Pie Chart Data (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Demonstrates how to define data for a pie chart in Ruby. Data items are hashes with keys like :name, :value, :color, and :fill. The :value key is mandatory for slice size calculation.

```ruby
data = [
  { name: "BTC", value: 5977 },
  { name: "BCH", value: 3045 },
  { name: "LTC", value: 2030 },
  { name: "ETH", value: 2350 }
]
```

```ruby
data = [
  { name: "BTC", value: 5977, color: :bright_yellow },
  { name: "BCH", value: 3045, color: :bright_green },
  { name: "LTC", value: 2030, color: :bright_magenta },
  { name: "ETH", value: 2350, color: :bright_cyan }
]
```

```ruby
data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "x" },
  { name: "LTC", value: 2030, color: :bright_magenta, fill: "@" },
  { name: "ETH", value: 2350, color: :bright_cyan, fill: "+" }
]
```

--------------------------------

### Position Pie Chart on Terminal (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Shows how to specify the absolute position of the pie chart on the terminal using the :left and :top keyword arguments during initialization.

```ruby
TTY::Pie.new(data: data, left: 50, top: 10)
```

--------------------------------

### Ruby: Enabling Color Output in TTY::Pie

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Shows how to explicitly enable colored output for the TTY::Pie chart. Setting `:enable_color` to `true` forces the chart to use terminal colors.

```ruby
TTY::Pie.new(data: data, enable_color: true)
```

--------------------------------

### Update Pie Chart Data (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Explains how to completely replace the existing data of a TTY::Pie object with new data using the 'update' method.

```ruby
data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "x" }
]
pie_chart = TTY::Pie.new(data: data)

new_data = [
  { name: "BTC", value: 3400, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 1200, color: :bright_green, fill: "x" },
]

pie_chart.update(new_data)
```

--------------------------------

### Configure Legend Display with Legend Options

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Configures legend display with options for spacing and formatting. The legend shows alongside the pie chart. The `legend` option can be a boolean to disable it, or a hash to specify `left` spacing and `line` spacing between items.

```ruby
require "tty-pie"

data = [
  { name: "BTC", value: 5977.12, fill: "*" },
  { name: "BCH", value: 3045.50, fill: "+" },
  { name: "LTC", value: 2030.75, fill: "x" }
]

# Custom legend spacing: 10 columns from chart, 2 lines between items
pie = TTY::Pie.new(
  data: data,
  radius: 3,
  legend: { left: 10, line: 2 }
)
print pie.render

# Output:
#      x**               * BTC 54.08%
#   xxxx*****
# ++++xx*******
# ++++++*******          + BCH 27.55%
# ++++++*******
#   ++++*****
#      +**               x LTC 18.37%

# Disable legend
pie_no_legend = TTY::Pie.new(data: data, radius: 2, legend: false)
print pie_no_legend.render
```

--------------------------------

### Customize Legend Format Strings

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Customizes legend label format using Ruby format sequences with named placeholders: `label`, `name`, `value`, `currency`, and `percent`. The `precision` and `delimiter` options can also be used for currency formatting.

```ruby
require "tty-pie"

data = [
  { name: "BTC", value: 5977.12345, fill: "*" },
  { name: "BCH", value: 3045.2, fill: "+" },
  { name: "LTC", value: 2030.444, fill: "x" }
]

# Default format: "%<label>s %<name>s %<percent>.2f%%"
pie_default = TTY::Pie.new(data: data, radius: 2)
print pie_default.render
# Legend shows: * BTC 54.08%

# Show value and percent
pie_value = TTY::Pie.new(
  data: data,
  radius: 2,
  legend: { format: "%<label>s %<name>s %<value>d (%<percent>.2f%%)" }
)
print pie_value.render
# Legend shows: * BTC 5977 (54.08%)

# Currency format with custom precision and delimiter
pie_currency = TTY::Pie.new(
  data: data,
  radius: 2,
  legend: {
    format: "%<label>s %<name>s $%<currency>s (%<percent>.0f%%)",
    precision: 2,
    delimiter: ","
  }
)
print pie_currency.render
# Legend shows: * BTC $5,977.12 (54%)
```

--------------------------------

### Apply Colors to Pie Chart Slices

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Enables colored output using Pastel terminal colors. Colors can be specified per data item using the `color` key, or globally via the `colors` array parameter. The `enable_color` option must be set to `true`.

```ruby
require "tty-pie"

# Colors per data item
data = [
  { name: "BTC", value: 5977, color: :bright_yellow, fill: "*" },
  { name: "BCH", value: 3045, color: :bright_green, fill: "+" },
  { name: "LTC", value: 2030, color: :bright_magenta, fill: "x" }
]
pie = TTY::Pie.new(data: data, radius: 2, enable_color: true)
print pie.render

# Global colors array applied to slices in order
data_no_color = [
  { name: "BTC", value: 5977, fill: "*" },
  { name: "BCH", value: 3045, fill: "+" },
  { name: "LTC", value: 2030, fill: "x" }
]
pie = TTY::Pie.new(
  data: data_no_color,
  radius: 2,
  colors: [:yellow, :green, :magenta],
  enable_color: true
)
print pie.render

# Supported colors include:
# :black, :red, :green, :yellow, :blue, :magenta, :cyan, :white
# :bright_black, :bright_red, :bright_green, :bright_yellow
# :bright_blue, :bright_magenta, :bright_cyan, :bright_white
```

--------------------------------

### Update All Data in TTY::Pie Chart

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Demonstrates how to replace the entire dataset of a TTY::Pie chart using the `update` method. This is useful for refreshing the chart with new values.

```ruby
require "tty-pie"

# Initial chart
data = [
  { name: "BTC", value: 5977, fill: "*" }
]
pie = TTY::Pie.new(data: data, radius: 2)
print pie.render

# Replace with new data
new_data = [
  { name: "BTC", value: 3400, fill: "*" },
  { name: "ETH", value: 1200, fill: "+" }
]
pie.update(new_data)
print pie.render
```

--------------------------------

### Set Pie Chart Radius (Ruby)

Source: https://github.com/piotrmurach/tty-pie/blob/master/README.md

Explains how to customize the radius of the pie chart using the :radius keyword argument during initialization. The default radius is 10.

```ruby
TTY::Pie.new(data: data, radius: 5)
```

--------------------------------

### Control Terminal Color Output with enable_color Option

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Demonstrates how to control terminal color output in TTY::Pie charts. The `enable_color` option can be set to true to force colors, false to disable them, or nil for automatic detection based on terminal capabilities. This is useful for ensuring consistent output when piping chart data to files or other command-line tools.

```ruby
require "tty-pie"

data = [
  { name: "BTC", value: 5977, color: :bright_yellow },
  { name: "BCH", value: 3045, color: :bright_green },
  { name: "LTC", value: 2030, color: :bright_magenta }
]

# Force colored output (useful for piping to files)
pie_color = TTY::Pie.new(data: data, radius: 2, enable_color: true)
print pie_color.render

# Disable colors (plain ASCII output)
pie_plain = TTY::Pie.new(data: data, radius: 2, enable_color: false)
print pie_plain.render

# Automatic detection (default behavior)
pie_auto = TTY::Pie.new(data: data, radius: 2, enable_color: nil)
print pie_auto.render
```

--------------------------------

### Position Pie Chart with Left and Top Options

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Positions the pie chart at specific terminal coordinates using ANSI cursor positioning. Without these options, the chart renders at the current cursor location. The `left` option sets the column, and the `top` option sets the row.

```ruby
require "tty-pie"

data = [
  { name: "BTC", value: 5977, color: :bright_yellow },
  { name: "BCH", value: 3045, color: :bright_green },
  { name: "LTC", value: 2030, color: :bright_magenta }
]

# Position chart at column 50, row 10
pie = TTY::Pie.new(data: data, radius: 2, left: 50, top: 10)
print pie.render

# Chart will be positioned at absolute terminal coordinates
# Uses ANSI escape sequences: \e[row;colH
```

--------------------------------

### Customize Fill Characters for Pie Slices

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Customizes the character used to draw each pie slice. Fill can be set per data item using the `fill` key, or globally for all slices using the `fill` parameter. A global `fill` can be an array of characters to cycle through, or a single character.

```ruby
require "tty-pie"

# Fill per data item
data = [
  { name: "BTC", value: 5977, fill: "*" },
  { name: "BCH", value: 3045, fill: "+" },
  { name: "LTC", value: 2030, fill: "x" },
  { name: "ETH", value: 2350, fill: "@" }
]
pie = TTY::Pie.new(data: data, radius: 5)
print pie.render

# Global fill array - cycles through for each slice
data_no_fill = [
  { name: "BTC", value: 5977, color: :bright_yellow },
  { name: "BCH", value: 3045, color: :bright_green },
  { name: "LTC", value: 2030, color: :bright_magenta }
]
pie = TTY::Pie.new(data: data_no_fill, radius: 2, fill: ["*", "+", "x"])
print pie.render

# Single fill character for all slices (default is "bullet")
pie = TTY::Pie.new(data: data_no_fill, radius: 2, fill: "#")
print pie.render
```

--------------------------------

### Clear Data from TTY::Pie Chart

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Demonstrates how to clear all data from a TTY::Pie chart using the `clear` or `reset` methods. It also shows that new data can be added after clearing.

```ruby
require "tty-pie"

data = [{ name: "BTC", value: 5977, fill: "*" }]
pie = TTY::Pie.new(data: data, radius: 2)
print pie.render  # Renders chart

pie.reset  # or pie.clear
print pie.render  # => "" (empty string)

# Add new data after reset
pie << { name: "ETH", value: 2350, fill: "+" }
print pie.render  # Renders new chart
```

--------------------------------

### Control Pie Chart Size with Radius Option

Source: https://context7.com/piotrmurach/tty-pie/llms.txt

Controls the size of the pie chart using the `radius` option. The default radius is 10. The actual chart width is approximately 2x the radius due to the terminal character aspect ratio. Smaller radii create smaller charts, while larger radii create larger ones.

```ruby
require "tty-pie"

data = [
  { name: "BTC", value: 5977, fill: "*" },
  { name: "BCH", value: 3045, fill: "+" }
]

# Small chart with radius 2
small_pie = TTY::Pie.new(data: data, radius: 2)
print small_pie.render

# Larger chart with radius 5
large_pie = TTY::Pie.new(data: data, radius: 5)
print large_pie.render

# Default radius is 10
default_pie = TTY::Pie.new(data: data)
print default_pie.render
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.