> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/function-blocks/blocks-reference/input-output/outputs-exports/scope.md).

# Scope

This function block displays live plots of up to ten numerical signals. Use it to monitor real-time values such as counters, sensor readings, image analysis metrics or boolean states (shown as 0/1).

## 📥 Inputs <a href="#inputs" id="inputs"></a>

`Input 1` Numerical value for curve 1 (accepts integers, floats, booleans).\
`Input 2` Numerical value for curve 2.\
`Input 3` Numerical value for curve 3.\
`Input 4` Numerical value for curve 4.\
`Input 5` Numerical value for curve 5.\
`Input 6` Numerical value for curve 6.\
`Input 7` Numerical value for curve 7.\
`Input 8` Numerical value for curve 8.\
`Input 9` Numerical value for curve 9.\
`Input 10` Numerical value for curve 10.

Each input accepts one numeric stream. Booleans are plotted as 0 or 1.

## 📤 Outputs <a href="#outputs" id="outputs"></a>

This function block does not produce outputs.

## 🕹️ Controls <a href="#controls" id="controls"></a>

`Scope` Interactive plot area where curves are drawn and updated in real time.\
`Curve Names` Automatically set from the input socket labels so you can read which curve belongs to which signal.

## 🎨 Features <a href="#features" id="features"></a>

* Live plotting of up to ten curves, updated every evaluation cycle.
* Automatic labeling of curves based on connected inputs.
* Accepts numeric and boolean inputs (booleans plotted as 0/1).
* Resizable display for clearer visualization.

## 📝 Usage Instructions <a href="#usage" id="usage"></a>

1. Connect numerical outputs from other function blocks to the desired `Input N` sockets.
2. Run the scenario; the `Scope` will plot incoming values over time.
3. Resize the block if you need a larger plotting area.
4. Use distinct inputs to compare signals side-by-side (for example, two different sensor channels).

## 📊 Evaluation <a href="#evaluation" id="evaluation"></a>

On each run cycle the block reads up to ten inputs and appends their current numeric values to the corresponding curves. If an input is disconnected or non-numeric, that curve will receive a default zero for the current update.

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* To quickly test the plot, feed values from the `Number Input` block.
* Plot counters or event rates by connecting the `Counter` or `Cycle Timer` outputs to the `Input N` sockets.
* Visualize object counts or detections by connecting outputs such as `Object Count` from `Object Detection` or `Person Count` from `Social Distance Detector`.
* Monitor image statistics by connecting outputs like `Mean Value` and `Standard Deviation` from `Mean Value of Image` and `Std. of Image`.
* Compare color channel metrics by using outputs from `Color Density Percentage`.
* Use boolean signals from `Logic Input` to monitor on/off states (they appear as 0/1).
* Combine with `Get Batch Size` or other flow-control blocks to visualize batch-processing metrics or progress.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* If nothing appears on the plot, confirm inputs are connected and producing numeric values.
* If a curve is flat at zero, check that the supplying block is actually outputting numbers (use `Number Input` to verify).
* If labels are unclear, rename upstream inputs or use distinct signal sources so automatic `Curve Names` are meaningful.
