Violin plots
Summary: This example shows how to create violin plot charts in F#.
let's first create some data for the purpose of creating example charts:
open Plotly.NET
let y = [2.; 1.5; 5.; 1.5; 3.; 2.5; 2.5; 1.5; 3.5; 1.]
let x = ["bin1";"bin2";"bin1";"bin2";"bin1";"bin2";"bin1";"bin1";"bin2";"bin1"]
A violin plot is a method of plotting numeric data. It is similar to box plot with a rotated kernel density plot on each side. The violin plot is similar to box plots, except that they also show the probability density of the data at different values.
let violin1 =
Chart.Violin (
x,y,
Points=StyleParam.JitterPoints.All
)
By swapping x and y plus using StyleParam.Orientation.Horizontal we can flip the chart horizontaly.
open Plotly.NET.TraceObjects
let violin2 =
Chart.Violin(
y,x,
Jitter=0.1,
Points=StyleParam.JitterPoints.All,
Orientation=StyleParam.Orientation.Horizontal,
MeanLine=MeanLine.init(Visible=true)
)
You can also produce a violin plot using the Chart.Combine syntax.
let y' = [2.; 1.5; 5.; 1.5; 2.; 2.5; 2.1; 2.5; 1.5; 1.;2.; 1.5; 5.; 1.5; 3.; 2.5; 2.5; 1.5; 3.5; 1.]
let violin3 =
[
Chart.Violin ("y" ,y,Name="bin1",Jitter=0.1,Points=StyleParam.JitterPoints.All);
Chart.Violin ("y'",y',Name="bin2",Jitter=0.1,Points=StyleParam.JitterPoints.All);
]
|> Chart.combine
namespace Plotly
namespace Plotly.NET
val y: float list
val x: string list
val violin1: GenericChart.GenericChart
type Chart =
static member AnnotatedHeatmap: zData: seq<#seq<'a1>> * annotationText: seq<#seq<string>> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?X: seq<#IConvertible> * ?XGap: int * ?Y: seq<#IConvertible> * ?YGap: int * ?Text: 'a5 * ?MultiText: seq<'a5> * ?ColorBar: ColorBar * ?ColorScale: Colorscale * ?ShowScale: bool * ?ReverseScale: bool * ?ZSmooth: SmoothAlg * ?Transpose: bool * ?UseWebGL: bool * ?ReverseYAxis: bool * ?UseDefaults: bool -> GenericChart (requires 'a1 :> IConvertible and 'a5 :> IConvertible) + 1 overload
static member Area: x: seq<#IConvertible> * y: seq<#IConvertible> * ?ShowMarkers: bool * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?MultiOpacity: seq<float> * ?Text: 'a2 * ?MultiText: seq<'a2> * ?TextPosition: TextPosition * ?MultiTextPosition: seq<TextPosition> * ?MarkerColor: Color * ?MarkerColorScale: Colorscale * ?MarkerOutline: Line * ?MarkerSymbol: MarkerSymbol * ?MultiMarkerSymbol: seq<MarkerSymbol> * ?Marker: Marker * ?LineColor: Color * ?LineColorScale: Colorscale * ?LineWidth: float * ?LineDash: DrawingStyle * ?Line: Line * ?StackGroup: string * ?Orientation: Orientation * ?GroupNorm: GroupNorm * ?FillColor: Color * ?UseWebGL: bool * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible) + 1 overload
static member Bar: values: seq<#IConvertible> * ?Keys: seq<#IConvertible> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?MultiOpacity: seq<float> * ?Text: 'a2 * ?MultiText: seq<'a2> * ?MarkerColor: Color * ?MarkerColorScale: Colorscale * ?MarkerOutline: Line * ?MarkerPatternShape: PatternShape * ?MultiMarkerPatternShape: seq<PatternShape> * ?MarkerPattern: Pattern * ?Marker: Marker * ?Base: #IConvertible * ?Width: 'a4 * ?MultiWidth: seq<'a4> * ?TextPosition: TextPosition * ?MultiTextPosition: seq<TextPosition> * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible and 'a4 :> IConvertible) + 1 overload
static member BoxPlot: ?X: seq<#IConvertible> * ?Y: seq<#IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'a2 * ?MultiText: seq<'a2> * ?FillColor: Color * ?MarkerColor: Color * ?Marker: Marker * ?Opacity: float * ?WhiskerWidth: float * ?BoxPoints: BoxPoints * ?BoxMean: BoxMean * ?Jitter: float * ?PointPos: float * ?Orientation: Orientation * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?Notched: bool * ?NotchWidth: float * ?QuartileMethod: QuartileMethod * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible) + 2 overloads
static member Bubble: x: seq<#IConvertible> * y: seq<#IConvertible> * sizes: seq<int> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?MultiOpacity: seq<float> * ?Text: 'a2 * ?MultiText: seq<'a2> * ?TextPosition: TextPosition * ?MultiTextPosition: seq<TextPosition> * ?MarkerColor: Color * ?MarkerColorScale: Colorscale * ?MarkerOutline: Line * ?MarkerSymbol: MarkerSymbol * ?MultiMarkerSymbol: seq<MarkerSymbol> * ?Marker: Marker * ?LineColor: Color * ?LineColorScale: Colorscale * ?LineWidth: float * ?LineDash: DrawingStyle * ?Line: Line * ?StackGroup: string * ?Orientation: Orientation * ?GroupNorm: GroupNorm * ?UseWebGL: bool * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible) + 1 overload
static member Candlestick: ``open`` : seq<#IConvertible> * high: seq<#IConvertible> * low: seq<#IConvertible> * close: seq<#IConvertible> * x: seq<#IConvertible> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?Text: 'a5 * ?MultiText: seq<'a5> * ?Line: Line * ?IncreasingColor: Color * ?Increasing: FinanceMarker * ?DecreasingColor: Color * ?Decreasing: FinanceMarker * ?WhiskerWidth: float * ?UseDefaults: bool -> GenericChart (requires 'a5 :> IConvertible) + 1 overload
static member Column: values: seq<#IConvertible> * ?Keys: seq<#IConvertible> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?MultiOpacity: seq<float> * ?Text: 'a2 * ?MultiText: seq<'a2> * ?MarkerColor: Color * ?MarkerColorScale: Colorscale * ?MarkerOutline: Line * ?MarkerPatternShape: PatternShape * ?MultiMarkerPatternShape: seq<PatternShape> * ?MarkerPattern: Pattern * ?Marker: Marker * ?Base: #IConvertible * ?Width: 'a4 * ?MultiWidth: seq<'a4> * ?TextPosition: TextPosition * ?MultiTextPosition: seq<TextPosition> * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible and 'a4 :> IConvertible) + 1 overload
static member Contour: zData: seq<#seq<'a1>> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?X: seq<#IConvertible> * ?Y: seq<#IConvertible> * ?Text: 'a4 * ?MultiText: seq<'a4> * ?ColorBar: ColorBar * ?ColorScale: Colorscale * ?ShowScale: bool * ?ReverseScale: bool * ?Transpose: bool * ?ContourLineColor: Color * ?ContourLineDash: DrawingStyle * ?ContourLineSmoothing: float * ?ContourLine: Line * ?ContoursColoring: ContourColoring * ?ContoursOperation: ConstraintOperation * ?ContoursType: ContourType * ?ShowContourLabels: bool * ?ContourLabelFont: Font * ?Contours: Contours * ?FillColor: Color * ?NContours: int * ?UseDefaults: bool -> GenericChart (requires 'a1 :> IConvertible and 'a4 :> IConvertible)
static member Funnel: x: seq<#IConvertible> * y: seq<#IConvertible> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?Width: float * ?Offset: float * ?Text: 'a2 * ?MultiText: seq<'a2> * ?TextPosition: TextPosition * ?MultiTextPosition: seq<TextPosition> * ?Orientation: Orientation * ?AlignmentGroup: string * ?OffsetGroup: string * ?MarkerColor: Color * ?MarkerOutline: Line * ?Marker: Marker * ?TextInfo: TextInfo * ?ConnectorLineColor: Color * ?ConnectorLineStyle: DrawingStyle * ?ConnectorFillColor: Color * ?ConnectorLine: Line * ?Connector: FunnelConnector * ?InsideTextFont: Font * ?OutsideTextFont: Font * ?UseDefaults: bool -> GenericChart (requires 'a2 :> IConvertible)
static member Heatmap: zData: seq<#seq<'a1>> * ?Name: string * ?ShowLegend: bool * ?Opacity: float * ?X: seq<#IConvertible> * ?XGap: int * ?Y: seq<#IConvertible> * ?YGap: int * ?Text: 'a4 * ?MultiText: seq<'a4> * ?ColorBar: ColorBar * ?ColorScale: Colorscale * ?ShowScale: bool * ?ReverseScale: bool * ?ZSmooth: SmoothAlg * ?Transpose: bool * ?UseWebGL: bool * ?ReverseYAxis: bool * ?UseDefaults: bool -> GenericChart (requires 'a1 :> IConvertible and 'a4 :> IConvertible) + 1 overload
...
static member Chart.Violin: xy: seq<#System.IConvertible * #System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'a2 * ?MultiText: seq<'a2> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: TraceObjects.Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: TraceObjects.Box * ?BandWidth: float * ?MeanLine: TraceObjects.MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a2 :> System.IConvertible)
static member Chart.Violin: data: seq<#System.IConvertible> * orientation: StyleParam.Orientation * ?Name: string * ?ShowLegend: bool * ?Text: 'a1 * ?MultiText: seq<'a1> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Width: float * ?MarkerColor: Color * ?Marker: TraceObjects.Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: TraceObjects.Box * ?BandWidth: float * ?MeanLine: TraceObjects.MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a1 :> System.IConvertible)
static member Chart.Violin: ?X: seq<#System.IConvertible> * ?Y: seq<#System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'c * ?MultiText: seq<'c> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: TraceObjects.Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: TraceObjects.Box * ?BandWidth: float * ?MeanLine: TraceObjects.MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'c :> System.IConvertible)
static member Chart.Violin: data: seq<#System.IConvertible> * orientation: StyleParam.Orientation * ?Name: string * ?ShowLegend: bool * ?Text: 'a1 * ?MultiText: seq<'a1> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Width: float * ?MarkerColor: Color * ?Marker: TraceObjects.Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: TraceObjects.Box * ?BandWidth: float * ?MeanLine: TraceObjects.MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a1 :> System.IConvertible)
static member Chart.Violin: ?X: seq<#System.IConvertible> * ?Y: seq<#System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'c * ?MultiText: seq<'c> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: TraceObjects.Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: TraceObjects.Box * ?BandWidth: float * ?MeanLine: TraceObjects.MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'c :> System.IConvertible)
module StyleParam
from Plotly.NET
type JitterPoints = StyleParam.BoxPoints
union case StyleParam.BoxPoints.All: StyleParam.BoxPoints
module GenericChart
from Plotly.NET
<summary> Module to represent a GenericChart </summary>
<summary> Module to represent a GenericChart </summary>
val toChartHTML: gChart: GenericChart.GenericChart -> string
<summary> Converts a GenericChart to it HTML representation. The div layer has a default size of 600 if not specified otherwise. </summary>
<summary> Converts a GenericChart to it HTML representation. The div layer has a default size of 600 if not specified otherwise. </summary>
namespace Plotly.NET.TraceObjects
val violin2: GenericChart.GenericChart
static member Chart.Violin: xy: seq<#System.IConvertible * #System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'a2 * ?MultiText: seq<'a2> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: Box * ?BandWidth: float * ?MeanLine: MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a2 :> System.IConvertible)
static member Chart.Violin: data: seq<#System.IConvertible> * orientation: StyleParam.Orientation * ?Name: string * ?ShowLegend: bool * ?Text: 'a1 * ?MultiText: seq<'a1> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Width: float * ?MarkerColor: Color * ?Marker: Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: Box * ?BandWidth: float * ?MeanLine: MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a1 :> System.IConvertible)
static member Chart.Violin: ?X: seq<#System.IConvertible> * ?Y: seq<#System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'c * ?MultiText: seq<'c> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: Box * ?BandWidth: float * ?MeanLine: MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'c :> System.IConvertible)
static member Chart.Violin: data: seq<#System.IConvertible> * orientation: StyleParam.Orientation * ?Name: string * ?ShowLegend: bool * ?Text: 'a1 * ?MultiText: seq<'a1> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Width: float * ?MarkerColor: Color * ?Marker: Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: Box * ?BandWidth: float * ?MeanLine: MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'a1 :> System.IConvertible)
static member Chart.Violin: ?X: seq<#System.IConvertible> * ?Y: seq<#System.IConvertible> * ?Name: string * ?ShowLegend: bool * ?Text: 'c * ?MultiText: seq<'c> * ?FillColor: Color * ?Opacity: float * ?Points: StyleParam.JitterPoints * ?Jitter: float * ?PointPos: float * ?Orientation: StyleParam.Orientation * ?Width: float * ?MarkerColor: Color * ?Marker: Marker * ?OutlineColor: Color * ?OutlineWidth: float * ?Outline: Line * ?AlignmentGroup: string * ?OffsetGroup: string * ?ShowBox: bool * ?BoxWidth: float * ?BoxFillColor: Color * ?Box: Box * ?BandWidth: float * ?MeanLine: MeanLine * ?ScaleGroup: string * ?ScaleMode: StyleParam.ScaleMode * ?Side: StyleParam.ViolinSide * ?Span: StyleParam.Range * ?SpanMode: StyleParam.SpanMode * ?UseDefaults: bool -> GenericChart.GenericChart (requires 'c :> System.IConvertible)
type Orientation =
| Horizontal
| Vertical
member Convert: unit -> obj
override ToString: unit -> string
static member convert: (Orientation -> obj)
static member toString: (Orientation -> string)
union case StyleParam.Orientation.Horizontal: StyleParam.Orientation
Multiple items
type MeanLine = inherit DynamicObj new: unit -> MeanLine static member init: ?Visible: bool * ?Color: Color * ?Width: float -> MeanLine static member style: ?Visible: bool * ?Color: Color * ?Width: float -> (MeanLine -> MeanLine)
<summary> Meanline type inherits from dynamic object (parent violin) </summary>
--------------------
new: unit -> MeanLine
type MeanLine = inherit DynamicObj new: unit -> MeanLine static member init: ?Visible: bool * ?Color: Color * ?Width: float -> MeanLine static member style: ?Visible: bool * ?Color: Color * ?Width: float -> (MeanLine -> MeanLine)
<summary> Meanline type inherits from dynamic object (parent violin) </summary>
--------------------
new: unit -> MeanLine
static member MeanLine.init: ?Visible: bool * ?Color: Color * ?Width: float -> MeanLine
val y': float list
val violin3: GenericChart.GenericChart
static member Chart.combine: gCharts: seq<GenericChart.GenericChart> -> GenericChart.GenericChart