ScottPlot

Published on NuGet on 2021-09-17
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook

• Controls: Decreased visibility of the render warning (introduced in ScottPlot 4.1.19) by allowing it only to appear when the debugger is attached (#1165, #1264)
• Controls: Now have a Refresh() method as an alias of Render() for manually redrawing the plot and updating the image on the screen. Using Render() in user controls is more similar to similar plotting libraries and less likely to be confused with Plot.Render() in documentation and warning messages. (#1264, #1270, #1263, #1245, #1165)
• Radar: Improved support for category labels. (#1261, #1262) Thanks @Rayffer
• Legend: Throw an exception if RenderLegend() is called on a plot with no labeled plottables (#1257)
• Radial Gaugue Plot: Fixed divide-by-zero bug affecting normalized gauges (#1272) Thanks @arthurits

Published on NuGet on 2021-09-08
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook

• Ticks: Fixed bug where corner labels would not render when multiplier or offset notation is in use (#1252, #1253) Thanks @DavidBergstromSWE

Published on NuGet on 2021-09-08
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook

• Controls: Fixed bug where render warning message is not hidden if RenderRequest() is called (#1165) Thanks @gigios

Published on NuGet on 2021-09-07
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook

Release Notes

Major Changes

• Controls: Automatic rendering has been deprecated. Users must call the control's Render() method manually at least once. Failing to do this will result in an error message displayed over the plot in the control. (#1165, #1117)

New Plot Types

• Radial Gauge Plot: AddRadialGauge() now adds a radial gauge plot (a new circular plot type where values are represented as arcs spanning a curve). See cookbook for examples and documentation. (#1242) Thanks @arthurits
• Arrow: AddArrow() can be used to place arrow on plots. Arrowhead functionality of scatter plots has been deprecated. (#1241, #1240)

Minor Changes

• Ticks: Improve placement when axis scale lock is enabled (#1229, #1197)
• Plot: SetViewLimits() replaced by SetOuterViewLimits() and SetInnerViewLimits() (#1197) Thanks @noob765
• Plot: EqualScaleMode (an enumeration accepted by AxisScaleLock()) now has PreserveSmallest and PreserveLargest members to indicate which axis to prioritize when adjusting zoom level. The new default is PreserveSmallest which prevents data from falling off the edge of the plot when resizing. (#1197) Thanks @noob765
• Axis: Improved alignment of 90º rotated ticks (#1194, #1201) Thanks @gigios
• Controls: Fix bug where middle-click-drag zoom rectangle would persist if combined with scroll wheel events (#1226) Thanks @Elgot
• Scatter Plot: Fixed bug affecting plots where YError is set but XError is not (#1237, #1238) Thanks @simmdan
• Palette: Added Microcharts colorset (#1235) Thanks @arthurits
• SignalPlotXY: Added support for FillType (#1232) Thanks @ddrrrr

Published on NuGet on 2021-08-24
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook

Release Notes

Plottables

• Radar Plot: Improved Update() default arguments (#1097) Thanks @arthurits
• Crosshair: Added XLabelOnTop and YLabelOnRight options to improve multi-axis support and label customization (#1147) Thanks @rutkowskit
• Signal Plot: Added StepDisplay option to render signal plots as step plots when zoomed in (#1092, #1128) Thanks @EmanuelFeru
• Rendering: Fixed clipping bug that caused some plot types to be rendered above data area frames (#1084)
• Crosshair: Refactored to use two AxisLines so custom formatters can now be used and lines can be independently styled (#1173, #1172, #1122, #1195) Thanks @Maoyao233 and @EmanuelFeru
• ClevelandDotPlot: Improve automatic axis limit detection (#1185) Thanks @Nextra
• ScatterPlotList: Improved legend formatting (#1190) Thanks @Maoyao233
• AxisLine: Added PositionLabel option for displaying position as text (using a user-customizable formatter function) on the axis (#1122, #1195, #1172, #1173) Thanks @EmanuelFeru and @Maoyao233
• Radar Plot: Fixed rendering artifact that occurred when axis maximum is zero (#1139) Thanks @petersesztak and @bclehmann
• Signal Plot: Fixed bug causing render artifacts when using fill modes (#1163, #1205)
• Scatter Plot: Added support for OffsetX and OffsetY (#1164, #1213)
• Coxcomb: Added a new plot type for categorical data. See cookbook for examples. (#1188) Thanks @bclehmann
• Vector Plot: Add additional options to customize arrowhead style and position. See cookbook for examples. (#1202) Thanks @hhubschle
• Finance Plot: Fixed bug affecting plots with no data points (#1200) Thanks @Maoyao233

Plot, Axes, and Ticks

• Plot: Added Width and Height properties
• Plot: GetImageBytes() now returns bytes for a PNG file for easier storage in cloud applications (#1107)
• Axis: Added a GetSettings() method for developers, testers, and experimenters to gain access to experimental objects which are normally private for extreme customization
• Axis: Axis ticks now have a Ticks() overload which allows selective control over major tick lines and major tick labels separately (#1118) Thanks @kegesch
• Plot: AxisAuto() now has xAxisIndex and yAxisIndex arguments to selectively adjust axes to fit data on a specified index (#1123)
• Plot: Added an optional argument to Frameless() to reverse its behavior and deprecated Frame() (#1112, #1192) Thanks @arthurits
• Axes: Added LockLimits() to control pan/zoom manipulation so individual axes can be manipulated in multi-axis plots. See demo application for example. (#1179, #1210) Thanks @kkaiser41
• Ticks: Improve display of rotated ticks on secondary axes (#1201) Thanks @gigios

User Controls

• WpfPlot: Improve memory management for dynamically created and destroyed WpfPlot controls by properly unloading the dispatcher timer (#1115, #1117) Thanks @RamsayGit, @bclehmann, @StendProg, and @Orace
• Mouse Processing: Improved bug that affected fast drag-dropping of draggable objects (#1076)
• Mouse Processing: Improved panning behavior when view limits (axis boundaries) are active (#1148, #1203) Thanks @at2software

Misc

• Testing: Improved error reporting on failed XML documentation tests (#1127) Thanks @StendProg
• Histogram: Marked ScottPlot.Statistics.Histogram obsolete in favor of static methods in ScottPlot.Statistics.Common designed to create histograms and probability function curves (#1051, #1166). See cookbook for usage examples. Thanks @breakwinz and @bclehmann

Published on NuGet on 2021-05-30
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook
ScottPlot 4.0 → 4.1 migration notes: What's New in ScottPlot 4.1

Release Notes

• Made it easier to use custom color palettes (see cookbook: palette) (#1058, #1082) Thanks @EmanuelFeru
• Added a IgnoreAxisAuto field to axis lines and spans (#999) Thanks @kirsan31
• Heatmaps now have a Smooth field which uses bicubic interpolation to display smooth heatmaps (#1003) Thanks @xichaoqiang
• Radar plots now have an Update() method for updating data values without clearing the plot (#1086, #1091) Thanks @arthurits
• Controls now automatically render after the list of plottables is modified (previously it was after the number of plottables changed). This behavior can be disabled by setting a public field in the control's Configuration module. (#1087, #1088) Thanks @bftrock
• New Crosshair plot type draws lines to highlight a point on the plot and labels their coordinates in the axes (#999, #1093) Thanks @kirsan31
• Added support for a custom Func<double, string> to be used as custom tick label formatters (see cookbook: custom tick formatter) (#926, #1070) Thanks @damiandixon and @ssalsinha
• Added Move, MoveFirst, and MoveLast to the Plot module for added control over which plottables appear on top (#1090) Thanks @EmanuelFeru
• Fixed bug preventing expected behavior when calling AxisAutoX and AxisAutoY (#1089) Thanks @EmanuelFeru

Published on NuGet on 2021-05-26
ScottPlot Cookbook: http://swharden.com/scottplot/cookbook
ScottPlot 4.0 → 4.1 migration notes: What's New in ScottPlot 4.1

Release Notes

• Hide design-time error message component at run time to reduce flicking when resizing (#1073, #1075) Thanks @Superberti and @bclehmann
• Added a modern Plot.GetBitmap() overload suitable for the new stateless rendering system (#913 #1063)
• Controls now have PlottableDragged and PlottableDropped event handlers (#1072) Thanks @JS-BGResearch

Published on NuGet on 2021-05-22
cookbook: http://swharden.com/scottplot/cookbook

This is the first release of ScottPlot 4.1 🎉🚀

ScottPlot 4.0 → 4.1 migration notes: What's New in ScottPlot 4.1

Changes since ScottPlot 4.1.12-beta

• Add support for custom linestyles in SignalXY plots (#1017, #1016) Thanks @StendProg and @breakwinz
• Improved Avalonia dependency versioning (#1018, #1041) Thanks @bclehmann
• Controls now properly process MouseEnter and MouseLeave events (#999) Thanks @kirsan31 and @breakwinz
• Controls now have a RenderRequest() method that uses a render queue to facilitate non-blocking render calls (#813, #1034) Thanks @StendProg
• Added Last() to finance plots to make it easier to access the final OHLC (#1038) Thanks @CalderWhite
• Controls that fail to render in design mode now display the error message in a textbox to prevent Visual Studio exceptions (#1048) Thanks @bclehmann
• Plot.Render() and Plot.SaveFig() now have a scale argument to allow for the creation of high resolution scaled plots (#983, #982, #981) Thanks @PeterDavidson
• A BubblePlot has been added to allow display of circles with custom colors and sizes. See cookbook for examples. (#984, #973, #960) Thanks @PeterDavidson
• Avalonia 0.10.3 is now supported (#986) Thanks @bclehmann
• Default version of System.Drawing.Common has been changed from 5.0.0 to 4.6.1 to minimize errors associated with downgrading (#1004, #1005, #993, #924, #655) Thanks @bukkideme

Published on NuGet on 2021-04-11
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Added "Open in New Window" option to right-click menu (#958, #969) Thanks @ademkaya and @bclehmann
• User control Configuration module now has customizable scroll wheel zoom fraction (#940, #937) Thanks @
  PassionateDeveloper86 and @StendProg
• Added options to Plot.AxisScaleLock() to let the user define scaling behavior when the plot is resized (#933, #857) Thanks @ricecakebear and @StendProg
• Improved XML documentation for DataGen module (#903, #902) Thanks @bclehmann
• Fixed bug where tick labels would not render for axes with a single tick (#945, #828, #725, #925) Thanks @saklanmazozgur and @audun
• Added option to manually refine tick density (#828) Thanks @ChrisAtVault and @bclehmann
• Improved tick density calculations for DateTime axes (#725) Thanks @bclehmann
• Fixed SignalXY rendering artifact affecting the right edge of the plot (#929, #931) Thanks @damiandixon and @StendProg
• Improved line style customization for signal plots (#929, #931) Thanks @damiandixon and @StendProg
• Fixed bug where negative bar plots would default to red fill color (#968, #946) Thanks @pietcoussens
• Fixed bug where custom vertical margin was not respected when AxisAuto() was called with a middle-click (#943) Thanks Andreas
• Added a minimum distance the mouse must travel while click-dragging for the action to be considered a drag instead of a click (#962)
• Improved Histogram documentation and simplified access to probability curves (#930, #932, #971) Thanks @LB767, @breakwinz, and @bclehmann

Published on NuGet on 2021-03-28
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• FormsPlot mouse events are now properly forwarded to the base control (#892, #919) Thanks @grabul
• Prevent right-click menu from deploying after right-click-drag (#891, #917)
• Add offset support to SignalXY (#894, #890) Thanks @StendProg
• Eliminate rendering artifacts in SignalXY plots (#893, #889) Thanks @StendProg and @grabul
• Optimize cookbook generation and test execution (#901) Thanks @bclehmann

Published on NuGet on 2021-03-20
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Fixed a bug where applying the Seabourn style modified axis frame and minor tick distribution (#866) Thanks @oszymczak
• Improved XML documentation and error reporting for getting legend bitmaps (#860) Thanks @mzemljak
• Fixed rendering bug affecting finance plots with thin borders (#837) Thanks @AlgoExecutor
• Improved argument names and XML docs for SMA and Bollinger band calculation methods (#830) Thanks @ticool
• Improved GetPointNearest support for generic signal plots (#809, #882, #886) Thanks @StendProg, @at2software, and @mrradd
• Added support for custom slice label colors in pie charts (#883, #844) Thanks @bclehmann, @StendProg, and @Timothy343
• Improved support for transparent heatmaps using nullable double arrays (#849, #852) Thanks @bclehmann
• Deprecated bar plot IsHorizontal and IsVertical in favor of an Orientation enumeration
• Deprecated bar plot xs and ys in favor of positions and values which are better orientation-agnostic names
• Added Lollipop and Cleveland plots as new types of bar plots (#842, #817) Thanks @bclehmann
• Fixed a bug where Plot.AddBarGroups() returned an array of nulls (#839) Thanks @rhys-wootton
• Fixed a bug affecting manual tick labels (#829) Thanks @ohru131
• Implemented an optional render queue to allow asynchronous rendering in user controls (#813) Thanks @StendProg

Published on NuGet on 2021-02-20
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Improved support for negative DateTimes when using DateTime axis mode (#806, #807) Thanks @StendProg and @at2software
• Improved axis limit detection when using tooltips (#805, #811) Thanks @bclehmann and @ChrisAtVault
• Added WickColor field to candlestick plots (#803) Thanks @bclehmann
• Improved rendering of candlesticks that open and close at the same price (#803, #800) Thanks @bclehmann and @AlgoExecutor
• Improved rendering of SignalXY plots near the edge of the plot (#795) Thanks @StendProg
• new AddScatterStep() helper method creates a scatter plot with the step style (#808) Thanks @KlaskSkovby
• Marked MultiPlot obsolete and added information to the FAQ
• Refactored Colormap module to use classes instead of reflection (#767, #773) Thanks @StendProg
• Refactored OHLC fields and finance plots to store DateTime and TimeSpan instead of double (#795)

Published on NuGet on 2021-02-15
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Improved validation and error reporting for large heatmaps (#772) Thanks @Matthias-C
• Removed noisy console output in ScatterPlotList (#780) Thanks @Scr0nch
• Improved rendering bug in signal plots (#783, #788) Thanks @AlgoExecutor and @StendProg
• Fix bug that hid grid lines in frameless plots (#779)
• Improved appearance of marker-only scatter plots in the legend (#790) Thanks @AlgoExecutor
• AddPoint() now has a label argument to match AddScatter() (#787) Thanks @AlgoExecutor

Published on NuGet on 2021-02-13
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Added support for image axis labels (#759, #446, #716) Thanks @bclehmann
• Added MinRenderIndex and MaxRenderIndex support to Scatter plots (#737, #763) Thanks @StendProg
• Improved display of horizontal manual axis tick labels (#724, #762) Thanks @inqb and @Saklut
• Added support for listing and retrieving colormaps by their names (#767, #773) Thanks @StendProg
• Enabled mouse pan and zoom for plots with infinitely small width and height (#768, #733, #764) Thanks @saklanmazozgur
• A descriptive exception is now thrown when attempting to create heatmaps of unsupported dimensions (#722) Thanks @Matthias-C

Published on NuGet on 2021-02-07
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Fixed single point render bug in Signal plots (#744, #745) Thanks @at2software and @StendProg
• Improved display scaling support for WPF control (#721, #720) Thanks @bclehmann
• User control OnAxesChanged events now send the control itself as the sender object (#743, #756) Thanks @at2software
• Fixed configuration bug related to Alt + middle-click-drag-zoom (#741) Thanks @JS-BGResearch and @bclehmann
• Fixed render bug related to ALT + middle-click-drag zoom box (#742) Thanks @bclehmann
• Fixed render bug for extremely small plots (#735)
• Added a coordinated heatmap plot type (#707) Thanks @StendProg
• Improved appearance of heatmap edges (#713) Thanks @StendProg
• Improved design-time rendering of Windows Forms control
• Added and expanded XML documentation for Plot and Plottable classes
• Created a new cookbook website generator that combines reflection with XML documentation (#727, #738, #756)
• ScottPlot is now a reserved prefix on NuGet

Published on NuGet on 2021-02-01
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot

• Helper methods were added for creating scatter plots with just lines (AddScatterLines()) or just markers (AddScatterPoints())
• Scatter and Signal plots have GetPointNearest() which now has a xyRatio argument to support identifying points near the cursor in pixel space (#709, #722) Thanks @olofszymczak, @StendProg, @bclehmann
• Improved display of manual tick labels (#724) Thanks @bclehmann

Published on NuGet on 2021-01-24
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot. It is largely functional, but be aware that its API will continue to evolve and that it is more likely to have undiscovered bugs than the stable branch.

Changes

• User controls have been extensively redesigned (#683)
  • All user controls are almost entirely logic-free and pass events to ScottPlot.Control, a shared common back-end module which handles mouse interaction and pixel/coordinate conversions.
  • Controls no longer have a Configure() method with numerous named arguments, but instead a Configuration field with XML-documented public fields to customize behavior.
  • Renders occur automatically when the number of plottables changes, meaning you do not have to manually call Render() when plotting data for the first time. This behavior can be disabled in the configuration.
  • Avalonia 0.10.0 is now supported and uses this new back-end (#656, #700) Thanks @Benny121221
  • Events are used to provide custom right-click menu actions.
  • The right-click plot settings window (that was only available from the WinForms control) has been removed.
• New methods were added to ScottPlot.Statistics.Common which efficiently find the Nth smallest number, quartiles, or other quantiles from arrays of numbers (#690) Thanks @Benny121221
• New tooltip plot type (#696) Thanks @Benny121221
• Fixed simple moving average (SMA) calculation (#703) Thanks @Saklut
• Improved multi-axis rendering (#706) Thanks @Benny121221
• Improved SetSourceAsync() for segmented trees (#705, #692) Thanks @jl0pd and @StendProg
• Improved layout for axes with rotated ticks (#706, #699) Thanks @MisterRedactus and @Benny121221
• ScottPlot now multi-targets more platforms and supports the latest C# language version on modern platforms but restricts the language to C# 7.3 for .NET Framework projects (#691, #711) Thanks @jl0pd
• Improved project file to install System.ValueTuple when targeting .NET Framework 4.6.1 (#88, #691)

Published on NuGet on 2020-12-27
cookbooks: http://swharden.com/scottplot/cookbook
demos: https://swharden.com/scottplot/demo

• Improved PlotFillAboveBelow() (#676) Thanks @MithrilMan

Published on NuGet on 2020-12-27
cookbook: http://swharden.com/scottplot/cookbook

⚠️ This is a pre-release version of ScottPlot. It is largely functional, but be aware that its API will continue to evolve and that it is more likely to have undiscovered bugs than the stable branch.

Changes

• Scott will make a document to summarize 4.0 → 4.1 changes as we get closer to a non-beta release
• Fixed rendering bug affecting axis spans when zoomed far in (#662) Thanks @StendProg
• Improved Gaussian blur performance (#667) Thanks @Benny121221
• Largely refactored heatmaps (#679, #680) Thanks @Benny121221
• New Colorbar plot type (#681, see cookbook)
• Improved SMA and Bollinger band generators (#647) Thanks @Saklut
• Improved tick label rounding (#657)
• Improved setting of tick label color (#672)
• Improved fill above and below for scatter plots (#676) Thanks @MithrilMan

Published on NuGet on 2020-12-11
cookbooks: http://swharden.com/scottplot/cookbook
demos: https://swharden.com/scottplot/demo

• improved high-precision floating-point rounding errors affecting some numeric axis tick labels (#657)