Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prateekkumarsingh/graphical
Open-Source, Platform independent module that consumes data points as input and plots them on a 2D graph 📈📊💹 [Scatter / Bar / Line] on the PowerShell Console/Terminal
https://github.com/prateekkumarsingh/graphical
ascii-art core linux powershell terminal terminal-graphics windows
Last synced: about 2 hours ago
JSON representation
Open-Source, Platform independent module that consumes data points as input and plots them on a 2D graph 📈📊💹 [Scatter / Bar / Line] on the PowerShell Console/Terminal
- Host: GitHub
- URL: https://github.com/prateekkumarsingh/graphical
- Owner: PrateekKumarSingh
- License: mit
- Created: 2017-09-04T15:10:36.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-11-30T17:03:47.000Z (11 months ago)
- Last Synced: 2024-11-07T00:43:21.124Z (2 days ago)
- Topics: ascii-art, core, linux, powershell, terminal, terminal-graphics, windows
- Language: PowerShell
- Homepage:
- Size: 13.5 MB
- Stars: 348
- Watchers: 28
- Forks: 33
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Powershell Console/Terminal Graph
Consumes data points as input and plots them on a **2D graph in the Powershell console**
Type of Graphs Available -
1. Scatter
2. Bar
3. Line
# Installation
### [PowerShell v5](https://www.microsoft.com/en-us/download/details.aspx?id=50395) and Later
You can install the `Graphical` module directly from the PowerShell Gallery
* **[Recommended]** Install to your personal PowerShell Modules folder
```PowerShell
Install-Module Graphical -scope CurrentUser
```
* **[Requires Elevation]** Install for Everyone (computer PowerShell Modules folder)
```PowerShell
Install-Module Graphical
```
### PowerShell v4 and Earlier
To install to your personal modules folder run:
```PowerShell
iex (new-object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/PrateekKumarSingh/Graphical/master/Install.ps1')
```
# Features
* Color-coded output depending upon the Value of data point
* Colors codes can be customized by passing a color-map hash table
* Custom X an Y-Axis labels
* Graph in console is independent and fully customizable, not like Task Manager (Performance Tab)
* Could be incorporated in Powershell scripts
* Can consume data points generated during script run or Pre stored data like in a file or database.
* Independent of PowerShell version, and Works on PowerShell Core (Windows\Linux)
# Use Cases
1. The function `Show-Graph` takes data points as input and plot them on a 2D graph
You can also customize the labels on X and Y-Axis and provide a graph title
The function `Show-Graph` can consume data points, generated during script execution or from a file or database like in the above example.
2. Plotting Audio Peak Levels in your PowerShell Console (Don't forget to play some audio! :P)
```PowerShell
Install-Module AudioDeviceCmdlets, Graphical
Import-Module AudioDeviceCmdlets, Graphical -Verbose
$Device = Get-AudioDevice -Playback
[int[]]$datapoints =@(0)*50
do {
$PeakValue = $Device.Device.AudioMeterInformation.MasterPeakValue*100
$datapoints += [int]$PeakValue
$datapoints = $datapoints | Select-Object -last 50
Clear-Host
Show-Graph -datapoints $datapoints -GraphTitle AudioLevels
Show-Graph -datapoints $datapoints -GraphTitle AudioLevels -Type Line
Show-Graph -datapoints $datapoints -GraphTitle AudioLevels -Type Scatter
Start-Sleep -Milliseconds 1000
} while ($true)
```
3. Visualizing Azure Monitor Metrics like CPU %age on a Virtual machine in #PowerShell
```PowerShell
$ResourceID = '/subscriptions//resourceGroups/demo-resource-group/providers/Microsoft.Compute/virtualMachines/SimpleWinVM'
$Data = Get-AzMetric -ResourceId $ResourceID -WarningAction SilentlyContinue | Select-Object unit, data
$Datpoints = $data.data.average.foreach({[int]$_})
Import-Module Graphical
Show-Graph -Datapoints $Datpoints -GraphTitle 'CPU (% age)'
```
