FarNet friendly FSharp.Charting extension
The package is designed for FarNet.FSharpFar. To install FarNet packages, follow these steps.
The package is based on FSharp.Charting.
In addition to the original FSharp.Charting features:
- The library may be called from MTA threads.
- Loop charts, often easier than live charts.
- Chart windows are modeless by default.
- Chart windows provide more options.
- Timer helpers for live charts.
Instead of the original Chart.Show
with a chart instance, use the new
method Chart.Show
with a function which creates and configures a chart.
Example, instead of the original method:
<data>
|> Chart.Line
|> Chart.Show
use this new:
fun () ->
<data>
|> Chart.Line
|> Chart.Show(title="My chart", ...)
The new method is slightly more verbose but it has some advantages:
- It is modeless by default, the original is always modal.
- It works well in Far Manager, unlike the original.
- It provides handy features via parameters.
- It may be called from MTA threads.
The original Chart.Show
is still available and partially works in FarNet. It
shows charts. But some features may not work, for example context menu commands
"copy to clipboard", "save as", etc.
There are two ways of showing charts with dynamic content: new loop charts and original live charts.
Loop charts are very easy, just specify the required timer interval as the
parameter loop
:
fun () ->
<data>
|> Chart.X
|> Chart.Show(loop=2000)
Live charts are slightly more difficult, they require input data as special streams of events or observables. If data do not naturally come from events then some conversion is needed. See the original manual for the details.
Unlike loop charts, live charts cannot change chart parameters dynamically.
Live charts are still useful:
- Live charts may be more effective because only data change on updates.
- Live charts provide useful incremental charts right out of the box.
- Live charts are easier to code when data come from events.
If you accidentally (!) use live charts with loop shows then the result may be unexpected. But this is allowed and in some cases used effectively. See LoopLiveCharts.fsx
For generating live chart events you may use System.Windows.Forms.Timer
or
its handy helpers Timer.map
and Timer.mapi
. Important:
- Timers and mappings must be created in chart making functions.
- Do not use other timer classes like
System.Timers.Timer
.
In your script directory create the configuration *.fs.ini
:
[use]
�RHOME%\FarNet\Lib\FarNet.FSharp.Charting\FarNet.FSharp.Charting.ini
This is it. See /samples.