diff --git a/src/Plotly.NET.CSharp/ChartAPI/Chart2D.cs b/src/Plotly.NET.CSharp/ChartAPI/Chart2D.cs index 8bebbb778..3ba286278 100644 --- a/src/Plotly.NET.CSharp/ChartAPI/Chart2D.cs +++ b/src/Plotly.NET.CSharp/ChartAPI/Chart2D.cs @@ -285,10 +285,1037 @@ public static GenericChart.GenericChart Line( UseDefaults: UseDefaults.ToOption() ); + /// Creates a Spline chart. A spline chart is a line chart in which data points are connected by smoothed curves: this modification is aimed to improve the design of a chart. + /// Very similar to Line Plots, spline charts are typically used to visualize an evolution of Y depending on X. + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Wether to show markers for the individual data points + /// Sets the amount of smoothing. "0" corresponds to no smoothing (equivalent to a "linear" shape). Use values between 0. and 1.3 + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the opactity of the trace + /// Sets the opactity of individual datum markers + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker + /// Sets the colorscale of the marker + /// Sets the outline of the marker + /// Sets the marker symbol for each datum + /// Sets the marker symbol for each individual datum + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Sets the color of the line + /// Sets the colorscale of the line + /// Sets the width of the line + /// sets the drawing style of the line + /// Sets the line (use this for more finegrained control than the other line-associated arguments) + /// Set several traces (on the same subplot) to the same stackgroup in order to add their y values (or their x values if `Orientation` is Horizontal). Stacking also turns `fill` on by default and sets the default `mode` to "lines" irrespective of point count. ou can only stack on a numeric (linear or log) axis. Traces in a `stackgroup` will only fill to (or be filled to) other traces in the same group. With multiple `stackgroup`s or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order + /// Sets the stacking direction. Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used. + /// Sets the normalization for the sum of this `stackgroup. Only relevant when `stackgroup` is used, and only the first `groupnorm` found in the `stackgroup` will be used + /// Sets the area to fill with a solid color. Defaults to "none" unless this trace is stacked, then it gets "tonexty" ("tonextx") if `orientation` is "v" ("h") Use with `FillColor` if not "none". "tozerox" and "tozeroy" fill to x=0 and y=0 respectively. "tonextx" and "tonexty" fill between the endpoints of this trace and the endpoints of the trace before it, connecting those endpoints with straight lines (to make a stacked area graph); if there is no trace before it, they behave like "tozerox" and "tozeroy". "toself" connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. "tonext" fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like "toself" if there is no trace before it. "tonext" should not be used if one trace does not enclose the other. Traces in a `stackgroup` will only fill to (or be filled to) other traces in the same group. With multiple `stackgroup`s or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order. + /// ets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. + /// If true, plotly.js will use the WebGL engine to render this chart. use this when you want to render many objects at once. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Spline( + IEnumerable x, + IEnumerable y, + Optional ShowMarkers = default, + Optional Smoothing = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional StackGroup = default, + Optional Orientation = default, + Optional GroupNorm = default, + Optional Fill = default, + Optional FillColor = default, + Optional UseWebGL = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Spline( + x: x, + y: y, + ShowMarkers: ShowMarkers.ToOption(), + Smoothing: Smoothing.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + StackGroup: StackGroup.ToOption(), + Orientation: Orientation.ToOption(), + GroupNorm: GroupNorm.ToOption(), + Fill: Fill.ToOption(), + FillColor: FillColor.ToOption(), + UseWebGL: UseWebGL.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// Creates a bubble chart. A bubble chart is a variation of the Point chart, where the data points get an additional scale by being rendered as bubbles of different sizes. + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Sets the bubble size of the plotted data + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the opactity of the trace + /// Sets the opactity of individual datum markers + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker + /// Sets the colorscale of the marker + /// Sets the outline of the marker + /// Sets the marker symbol for each datum + /// Sets the marker symbol for each individual datum + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Sets the color of the line + /// Sets the colorscale of the line + /// Sets the width of the line + /// sets the drawing style of the line + /// Sets the line (use this for more finegrained control than the other line-associated arguments) + /// Set several traces (on the same subplot) to the same stackgroup in order to add their y values (or their x values if `Orientation` is Horizontal). Stacking also turns `fill` on by default and sets the default `mode` to "lines" irrespective of point count. ou can only stack on a numeric (linear or log) axis. Traces in a `stackgroup` will only fill to (or be filled to) other traces in the same group. With multiple `stackgroup`s or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order + /// Sets the stacking direction. Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used. + /// Sets the normalization for the sum of this `stackgroup. Only relevant when `stackgroup` is used, and only the first `groupnorm` found in the `stackgroup` will be used + /// If true, plotly.js will use the WebGL engine to render this chart. use this when you want to render many objects at once. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Bubble( + IEnumerable x, + IEnumerable y, + IEnumerable sizes, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional StackGroup = default, + Optional Orientation = default, + Optional GroupNorm = default, + Optional UseWebGL = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Bubble( + x: x, + y: y, + sizes: sizes, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + StackGroup: StackGroup.ToOption(), + Orientation: Orientation.ToOption(), + GroupNorm: GroupNorm.ToOption(), + UseWebGL: UseWebGL.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + /// + /// Displays a range of data by plotting three Y values per data point (upper, mid, lower). + /// + /// The mid Y value usually resembles some kind of central tendency and the upper/lower Y values some kind of spread. + /// + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data for the mid Y value. + /// Sets the y coordinates of the plotted data for the upper Y value. + /// Sets the y coordinates of the plotted data for the lower Y value. + /// Determines the drawing mode for this scatter trace. + /// Sets the trace name of the mid Y values. The trace name appear as the legend item and on hover + /// Sets the name of the legendgroup for the three traces of this plot. + /// Determines whether or not an To show markers for each datum. + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets a text associated with each datum for the mid Y values. + /// Sets individual text for each datum for the mid Y values. + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker for the mid Y values. + /// Sets the colorscale of the marker for the mid Y values. + /// Sets the outline of the marker for the mid Y values. + /// Sets the marker symbol for each datum for the mid Y values. + /// Sets the marker symbol for each individual datum for the mid Y values. + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) for the mid Y values. + /// Sets the color of the line for the mid Y values. + /// Sets the colorscale of the line for the mid Y values. + /// Sets the width of the line for the mid Y values. + /// sets the drawing style of the line for the mid Y values. + /// Sets the line (use this for more finegrained control than the other line-associated arguments) for the mid Y values. + /// Sets the color of the range between upper and lower Y values. + /// Sets a text associated with each datum for the upper Y values. + /// Sets individual text for each datum for the upper Y values. + /// Sets a text associated with each datum for the lower Y values. + /// Sets individual text for each datum for the lower Y values. + /// Sets the text font for all Text items + /// Sets the name of the lower Y value trace. + /// Sets the line for the lower Y values. + /// Sets the marker for the lower Y values. + /// Sets the name of the uper Y value trace. + /// Sets the line for the upper Y values. + /// Sets the marker for the upper Y values. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Range( + IEnumerable x, + IEnumerable y, + IEnumerable upper, + IEnumerable lower, + StyleParam.Mode mode, + Optional Name = default, + Optional GroupName = default, + Optional ShowMarkers = default, + Optional ShowLegend = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional UpperMarker = default, + Optional LowerMarker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional UpperLine = default, + Optional LowerLine = default, + Optional RangeColor = default, + Optional UpperText = default, + Optional> MultiUpperText = default, + Optional LowerText = default, + Optional> MultiLowerText = default, + Optional TextFont = default, + Optional LowerName = default, + Optional UpperName = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Range( + x: x, + y: y, + upper: upper, + lower: lower, + mode: mode, + Name: Name.ToOption(), + GroupName: GroupName.ToOption(), + ShowMarkers: ShowMarkers.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + UpperMarker: UpperMarker.ToOption(), + LowerMarker: LowerMarker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + UpperLine: UpperLine.ToOption(), + LowerLine: LowerLine.ToOption(), + RangeColor: RangeColor.ToOption(), + UpperText: UpperText.ToOption(), + MultiUpperText: MultiUpperText.ToOption(), + LowerText: LowerText.ToOption(), + MultiLowerText: MultiLowerText.ToOption(), + TextFont: TextFont.ToOption(), + LowerName: LowerName.ToOption(), + UpperName: UpperName.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// Creates an Area chart, which uses a Line plotted between the given datums in a 2D space, additionally colouring the area between the line and the Y Axis. + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Wether to show markers for the individual data points + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the opactity of the trace + /// Sets the opactity of individual datum markers + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker + /// Sets the colorscale of the marker + /// Sets the outline of the marker + /// Sets the marker symbol for each datum + /// Sets the marker symbol for each individual datum + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Sets the color of the line + /// Sets the colorscale of the line + /// Sets the width of the line + /// sets the drawing style of the line + /// Sets the line (use this for more finegrained control than the other line-associated arguments) + /// Set several traces (on the same subplot) to the same stackgroup in order to add their y values (or their x values if `Orientation` is Horizontal). Stacking also turns `fill` on by default and sets the default `mode` to "lines" irrespective of point count. ou can only stack on a numeric (linear or log) axis. Traces in a `stackgroup` will only fill to (or be filled to) other traces in the same group. With multiple `stackgroup`s or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order + /// Sets the stacking direction. Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used. + /// Sets the normalization for the sum of this `stackgroup. Only relevant when `stackgroup` is used, and only the first `groupnorm` found in the `stackgroup` will be used + /// ets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. + /// If true, plotly.js will use the WebGL engine to render this chart. use this when you want to render many objects at once. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Area( + IEnumerable x, + IEnumerable y, + Optional ShowMarkers = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional StackGroup = default, + Optional Orientation = default, + Optional GroupNorm = default, + Optional FillColor = default, + Optional UseWebGL = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Area( + x: x, + y: y, + ShowMarkers: ShowMarkers.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + StackGroup: StackGroup.ToOption(), + Orientation: Orientation.ToOption(), + GroupNorm: GroupNorm.ToOption(), + FillColor: FillColor.ToOption(), + UseWebGL: UseWebGL.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// Creates a Spline area chart, which uses a smoothed Line plotted between the given datums in a 2D space, additionally colouring the area between the line and the Y Axis. + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Wether to show markers for the individual data points + /// Sets the amount of smoothing. "0" corresponds to no smoothing (equivalent to a "linear" shape). Use values between 0. and 1.3 + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the opactity of the trace + /// Sets the opactity of individual datum markers + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker + /// Sets the colorscale of the marker + /// Sets the outline of the marker + /// Sets the marker symbol for each datum + /// Sets the marker symbol for each individual datum + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Sets the color of the line + /// Sets the colorscale of the line + /// Sets the width of the line + /// sets the drawing style of the line + /// Sets the line (use this for more finegrained control than the other line-associated arguments) + /// Set several traces (on the same subplot) to the same stackgroup in order to add their y values (or their x values if `Orientation` is Horizontal). Stacking also turns `fill` on by default and sets the default `mode` to "lines" irrespective of point count. ou can only stack on a numeric (linear or log) axis. Traces in a `stackgroup` will only fill to (or be filled to) other traces in the same group. With multiple `stackgroup`s or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order + /// Sets the stacking direction. Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used. + /// Sets the normalization for the sum of this `stackgroup. Only relevant when `stackgroup` is used, and only the first `groupnorm` found in the `stackgroup` will be used + /// ets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. + /// If true, plotly.js will use the WebGL engine to render this chart. use this when you want to render many objects at once. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart SplineArea( + IEnumerable x, + IEnumerable y, + Optional ShowMarkers = default, + Optional Smoothing = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional StackGroup = default, + Optional Orientation = default, + Optional GroupNorm = default, + Optional FillColor = default, + Optional UseWebGL = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.SplineArea( + x: x, + y: y, + ShowMarkers: ShowMarkers.ToOption(), + Smoothing: Smoothing.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + StackGroup: StackGroup.ToOption(), + Orientation: Orientation.ToOption(), + GroupNorm: GroupNorm.ToOption(), + FillColor: FillColor.ToOption(), + UseWebGL: UseWebGL.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// Creates a stacked Area chart, which uses a Line plotted between the given datums in a 2D space, additionally colouring the area between the line and the Y Axis. Multiple Charts of this type are stacked on top of each others y dimensions + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Wether to show markers for the individual data points + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the opactity of the trace + /// Sets the opactity of individual datum markers + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the color of the marker + /// Sets the colorscale of the marker + /// Sets the outline of the marker + /// Sets the marker symbol for each datum + /// Sets the marker symbol for each individual datum + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Sets the color of the line + /// Sets the colorscale of the line + /// Sets the width of the line + /// sets the drawing style of the line + /// Sets the line (use this for more finegrained control than the other line-associated arguments) + /// Sets the stacking direction. Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used. + /// Sets the normalization for the sum of this `stackgroup. Only relevant when `stackgroup` is used, and only the first `groupnorm` found in the `stackgroup` will be used + /// ets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. + /// If true, plotly.js will use the WebGL engine to render this chart. use this when you want to render many objects at once. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart StackedArea( + IEnumerable x, + IEnumerable y, + Optional ShowMarkers = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional LineColor = default, + Optional LineColorScale = default, + Optional LineWidth = default, + Optional LineDash = default, + Optional Line = default, + Optional Orientation = default, + Optional GroupNorm = default, + Optional FillColor = default, + Optional UseWebGL = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.StackedArea( + x: x, + y: y, + ShowMarkers: ShowMarkers.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + LineColor: LineColor.ToOption(), + LineColorScale: LineColorScale.ToOption(), + LineWidth: LineWidth.ToOption(), + LineDash: LineDash.ToOption(), + Line: Line.ToOption(), + Orientation: Orientation.ToOption(), + GroupNorm: GroupNorm.ToOption(), + FillColor: FillColor.ToOption(), + UseWebGL: UseWebGL.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a Funnel chart. + /// + /// Funnel charts visualize stages in a process using length-encoded bars. This trace can be used to show data in either a part-to-whole representation wherein each item appears in a single stage, or in a "drop-off" representation wherein each item appears in each stage it traversed. See also the "funnelarea" trace type for a different approach to visualizing funnel data. + /// + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity of the trace. + /// Sets the bar width (in position axis units). + /// Shifts the position where the bar is drawn (in position axis units). In "group" barmode, traces that set "offset" will be excluded and drawn in "overlay" mode instead. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used - including if `visible` is "legendonly" but not if it is `false`. Sets the stacking direction. With "v" ("h"), the y (x) values of subsequent traces are added. Also affects the default value of `fill`. + /// Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently. + /// Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up. + /// Sets the color of the bars. + /// Sets the color of the bar outline. + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Determines which trace information appear on the graph. In the case of having multiple funnels, percentages and totals are computed separately (per trace). + /// Sets the line color of the funnel connector + /// Sets the line style of the funnel connector + /// Sets the fill color of the funnel connector + /// Sets the line of the funnel connector (use this for more finegrained control than the other connector line associated arguments). + /// Sets the funnel connector (use this for more finegrained control than the other connector-associated arguments). + /// Sets the font used for `text` lying inside the bar. + /// Sets the font used for `text` lying outside the bar. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Funnel( + IEnumerable x, + IEnumerable y, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional Width = default, + Optional Offset = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional Orientation = default, + Optional AlignmentGroup = default, + Optional OffsetGroup = default, + Optional MarkerColor = default, + Optional MarkerOutline = default, + Optional Marker = default, + Optional TextInfo = default, + Optional ConnectorLineColor = default, + Optional ConnectorLineStyle = default, + Optional ConnectorFillColor = default, + Optional ConnectorLine = default, + Optional Connector = default, + Optional InsideTextFont = default, + Optional OutsideTextFont = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Funnel( + x: x, + y: y, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + Width: Width.ToOption(), + Offset: Offset.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + Orientation: Orientation.ToOption(), + AlignmentGroup: AlignmentGroup.ToOption(), + OffsetGroup: OffsetGroup.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + Marker: Marker.ToOption(), + TextInfo: TextInfo.ToOption(), + ConnectorLineColor: ConnectorLineColor.ToOption(), + ConnectorLineStyle: ConnectorLineStyle.ToOption(), + ConnectorFillColor: ConnectorFillColor.ToOption(), + ConnectorLine: ConnectorLine.ToOption(), + Connector: Connector.ToOption(), + InsideTextFont: InsideTextFont.ToOption(), + OutsideTextFont: OutsideTextFont.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a stacked Funnel chart, a variation of the funnel chart where multiple funnel bars of each stage are stacked on top of each other. + /// To create this type of chart, combine multiple of these charts via `Chart.combine`. + /// + /// Funnel charts visualize stages in a process using length-encoded bars. This trace can be used to show data in either a part-to-whole representation wherein each item appears in a single stage, or in a "drop-off" representation wherein each item appears in each stage it traversed. See also the "funnelarea" trace type for a different approach to visualizing funnel data. + /// + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity of the trace. + /// Sets the bar width (in position axis units). + /// Shifts the position where the bar is drawn (in position axis units). In "group" barmode, traces that set "offset" will be excluded and drawn in "overlay" mode instead. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used - including if `visible` is "legendonly" but not if it is `false`. Sets the stacking direction. With "v" ("h"), the y (x) values of subsequent traces are added. Also affects the default value of `fill`. + /// Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently. + /// Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up. + /// Sets the color of the bars. + /// Sets the color of the bar outline. + /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) + /// Determines which trace information appear on the graph. In the case of having multiple funnels, percentages and totals are computed separately (per trace). + /// Sets the line color of the funnel connector + /// Sets the line style of the funnel connector + /// Sets the fill color of the funnel connector + /// Sets the line of the funnel connector (use this for more finegrained control than the other connector line associated arguments). + /// Sets the funnel connector (use this for more finegrained control than the other connector-associated arguments). + /// Sets the font used for `text` lying inside the bar. + /// Sets the font used for `text` lying outside the bar. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart StackedFunnel( + IEnumerable x, + IEnumerable y, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional Width = default, + Optional Offset = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional Orientation = default, + Optional AlignmentGroup = default, + Optional OffsetGroup = default, + Optional MarkerColor = default, + Optional MarkerOutline = default, + Optional Marker = default, + Optional TextInfo = default, + Optional ConnectorLineColor = default, + Optional ConnectorLineStyle = default, + Optional ConnectorFillColor = default, + Optional ConnectorLine = default, + Optional Connector = default, + Optional InsideTextFont = default, + Optional OutsideTextFont = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.StackedFunnel( + x: x, + y: y, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + Width: Width.ToOption(), + Offset: Offset.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + Orientation: Orientation.ToOption(), + AlignmentGroup: AlignmentGroup.ToOption(), + OffsetGroup: OffsetGroup.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + Marker: Marker.ToOption(), + TextInfo: TextInfo.ToOption(), + ConnectorLineColor: ConnectorLineColor.ToOption(), + ConnectorLineStyle: ConnectorLineStyle.ToOption(), + ConnectorFillColor: ConnectorFillColor.ToOption(), + ConnectorLine: ConnectorLine.ToOption(), + Connector: Connector.ToOption(), + InsideTextFont: InsideTextFont.ToOption(), + OutsideTextFont: OutsideTextFont.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a waterfall chart. + /// + /// Waterfall charts are special bar charts that help visualizing the cumulative effect of sequentially introduced positive or negative values + /// + /// Sets the x coordinates of the plotted data. + /// Sets the y coordinates of the plotted data. + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the color of increasing values + /// Sets the style options of increasing values (use this for more finegrained control than the other increasing-associated arguments). + /// Sets the color of decreasing values + /// Sets the style options of decreasing values (use this for more finegrained control than the other increasing-associated arguments). + /// Sets the color of total values + /// Sets the style options of total values (use this for more finegrained control than the other increasing-associated arguments). + /// Sets where the bar base is drawn (in position axis units). + /// Sets the bar width (in position axis units). + /// Sets the individual bar width of each datum (in position axis units). + /// Sets the opacity of the trace. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// Sets the font used for `text`. + /// Sets the waterfall connector of this trace + /// An array containing types of measures. By default the values are considered as 'relative'. However; it is possible to use 'total' to compute the sums. Also 'absolute' could be applied to reset the computed total or to declare an initial value where needed. + /// Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently. + /// Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up. + /// Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used - including if `visible` is "legendonly" but not if it is `false`. Sets the stacking direction. With "v" ("h"), the y (x) values of subsequent traces are added. Also affects the default value of `fill`. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Waterfall( + IEnumerable x, + IEnumerable y, + Optional Name = default, + Optional ShowLegend = default, + Optional IncreasingColor = default, + Optional Increasing = default, + Optional DecreasingColor = default, + Optional Decreasing = default, + Optional TotalsColor = default, + Optional Totals = default, + Optional Base = default, + Optional Width = default, + Optional> MultiWidth = default, + Optional Opacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional TextFont = default, + Optional Connector = default, + Optional> Measure = default, + Optional AlignmentGroup = default, + Optional OffsetGroup = default, + Optional Orientation = default, + Optional UseDefaults = default + ) + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Waterfall( + x: x, + y: y, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + IncreasingColor: IncreasingColor.ToOption(), + Increasing: Increasing.ToOption(), + DecreasingColor: DecreasingColor.ToOption(), + Decreasing: Decreasing.ToOption(), + TotalsColor: TotalsColor.ToOption(), + Totals: Totals.ToOption(), + Base: Base.ToOption(), + Width: Width.ToOption(), + MultiWidth: MultiWidth.ToOption(), + Opacity: Opacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + TextFont: TextFont.ToOption(), + Connector: Connector.ToOption(), + Measure: Measure.ToOption(), + AlignmentGroup: AlignmentGroup.ToOption(), + OffsetGroup: OffsetGroup.ToOption(), + Orientation: Orientation.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a bar chart, with bars plotted horizontally + /// + /// A bar chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. + /// + /// Sets the values that are plotted as the size of each bar. + /// Sets the keys associated with each bar. + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity of the trace. + /// Sets the Opacity of each individual bar. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the color of the bars + /// Sets the colorscale for the bars. To have an effect, `MarkerColor` must map to color scale values. + /// Sets the color of the bar outlines + /// Sets a pattern shape for all bars + /// Sets an individual pattern shape for each bar + /// Sets the marker pattern (use this for more finegrained control than the other pattern-associated arguments). + /// Sets the marker for the bars (use this for more finegrained control than the other marker-associated arguments). + /// Sets where the bar base is drawn (in position axis units). + /// Sets the bar width (in position axis units) of all bars. + /// Sets the individual bar width (in position axis units) for each bar. + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Bar( + IEnumerable values, + Optional> Keys = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerPatternShape = default, + Optional> MultiMarkerPatternShape = default, + Optional MarkerPattern = default, + Optional Marker = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional> MultiWidth = default, + Optional UseDefaults = default, + Optional Base = default, + Optional Width = default + ) + where ValuesType : IConvertible + where KeysType : IConvertible + where TextType: IConvertible + => + Plotly.NET.Chart2D.Chart.Bar( + values: values, + Keys: Keys.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerPatternShape: MarkerPatternShape.ToOption(), + MultiMarkerPatternShape: MultiMarkerPatternShape.ToOption(), + MarkerPattern: MarkerPattern.ToOption(), + Marker: Marker.ToOption(), + Base: Base.ToOption(), + Width: Width.ToOption(), + MultiWidth: MultiWidth.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a stacked bar chart, with bars plotted horizontally. Values with the same key are stacked on top of each other in the X dimension. + /// To create this type of chart, combine multiple of these charts via `Chart.combine`. + /// + /// A bar chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. + /// + /// Sets the values that are plotted as the size of each bar. + /// Sets the keys associated with each bar. + /// Sets the trace name. The trace name appear as the legend item and on hover + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity of the trace. + /// Sets the Opacity of each individual bar. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the color of the bars + /// Sets the colorscale for the bars. To have an effect, `MarkerColor` must map to color scale values. + /// Sets the color of the bar outlines + /// Sets a pattern shape for all bars + /// Sets an individual pattern shape for each bar + /// Sets the marker pattern (use this for more finegrained control than the other pattern-associated arguments). + /// Sets the marker for the bars (use this for more finegrained control than the other marker-associated arguments). + /// Sets where the bar base is drawn (in position axis units). + /// Sets the bar width (in position axis units) of all bars. + /// Sets the individual bar width (in position axis units) for each bar. + /// Sets the position of text associated with each datum + /// Sets the position of text associated with individual datum + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart StackedBar( + IEnumerable values, + Optional> Keys = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerPatternShape = default, + Optional> MultiMarkerPatternShape = default, + Optional MarkerPattern = default, + Optional Marker = default, + Optional TextPosition = default, + Optional> MultiTextPosition = default, + Optional> MultiWidth = default, + Optional UseDefaults = default, + Optional Base = default, + Optional Width = default + ) + where ValuesType : IConvertible + where KeysType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.StackedBar( + values: values, + Keys: Keys.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + MultiOpacity: MultiOpacity.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerPatternShape: MarkerPatternShape.ToOption(), + MultiMarkerPatternShape: MultiMarkerPatternShape.ToOption(), + MarkerPattern: MarkerPattern.ToOption(), + Marker: Marker.ToOption(), + Base: Base.ToOption(), + Width: Width.ToOption(), + MultiWidth: MultiWidth.ToOption(), + TextPosition: TextPosition.ToOption(), + MultiTextPosition: MultiTextPosition.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + /// - /// Creates a bar chart, with bars plotted horizontally + /// Creates a column chart, with bars plotted vertically /// - /// A bar chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. + /// A column chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. /// /// Sets the values that are plotted as the size of each bar. /// Sets the keys associated with each bar. @@ -311,34 +1338,34 @@ public static GenericChart.GenericChart Line( /// Sets the position of text associated with each datum /// Sets the position of text associated with individual datum /// If set to false, ignore the global default settings set in `Defaults` - public static GenericChart.GenericChart Bar( + public static GenericChart.GenericChart Column( IEnumerable values, - Optional> Keys = default, - Optional Name = default, - Optional ShowLegend = default, - Optional Opacity = default, - Optional> MultiOpacity = default, - Optional Text = default, - Optional> MultiText = default, - Optional MarkerColor = default, - Optional MarkerColorScale = default, - Optional MarkerOutline = default, - Optional MarkerPatternShape = default, - Optional> MultiMarkerPatternShape = default, - Optional MarkerPattern = default, + Optional> Keys = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> MultiOpacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerPatternShape = default, + Optional> MultiMarkerPatternShape = default, + Optional MarkerPattern = default, Optional Marker = default, - Optional TextPosition = default, + Optional TextPosition = default, Optional> MultiTextPosition = default, - Optional> MultiWidth = default, + Optional> MultiWidth = default, Optional UseDefaults = default, Optional Base = default, Optional Width = default ) where ValuesType : IConvertible where KeysType : IConvertible - where TextType: IConvertible + where TextType : IConvertible => - Plotly.NET.Chart2D.Chart.Bar( + Plotly.NET.Chart2D.Chart.Column( values: values, Keys: Keys.ToOption(), Name: Name.ToOption(), @@ -361,10 +1388,13 @@ public static GenericChart.GenericChart Bar( MultiTextPosition: MultiTextPosition.ToOption(), UseDefaults: UseDefaults.ToOption() ); + + /// - /// Creates a column chart, with bars plotted vertically + /// Creates a stacked column chart, with bars plotted vertically. Values with the same key are stacked on top of each other in the Y dimension. + /// To create this type of chart, combine multiple of these charts via `Chart.combine`. /// - /// A column chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. + /// A bar chart is a chart that presents categorical data with rectangular bars with heights or lengths proportional to the values that they represent. /// /// Sets the values that are plotted as the size of each bar. /// Sets the keys associated with each bar. @@ -387,7 +1417,7 @@ public static GenericChart.GenericChart Bar( /// Sets the position of text associated with each datum /// Sets the position of text associated with individual datum /// If set to false, ignore the global default settings set in `Defaults` - public static GenericChart.GenericChart Column( + public static GenericChart.GenericChart StackedColumn( IEnumerable values, Optional> Keys = default, Optional Name = default, @@ -414,7 +1444,7 @@ public static GenericChart.GenericChart Column( where KeysType : IConvertible where TextType : IConvertible => - Plotly.NET.Chart2D.Chart.Column( + Plotly.NET.Chart2D.Chart.StackedColumn( values: values, Keys: Keys.ToOption(), Name: Name.ToOption(), @@ -437,6 +1467,7 @@ public static GenericChart.GenericChart Column( MultiTextPosition: MultiTextPosition.ToOption(), UseDefaults: UseDefaults.ToOption() ); + /// /// Visualizes the distribution of the input data as a histogram. /// @@ -528,6 +1559,7 @@ public static GenericChart.GenericChart Histogram( HoverLabel: HoverLabel.ToOption(), UseDefaults: UseDefaults.ToOption() ); + /// /// Visualizes the distribution of the 2-dimensional input data as 2D Histogram. /// @@ -901,77 +1933,293 @@ public static GenericChart.GenericChart Histogram2DContour( ); /// - /// Creates a point density plot - a combination of a Scatter plot and Histogram2DContour. + /// Creates a heatmap. /// - /// Additionally to plotting the (x,y) data as points on a 2D plane, a density contour plot is computed by grouping a set of points specified by their x and y coordinates into bins, and applying a count aggregation function to compute the value to be used to compute contours. - /// The sample data from which statistics are computed is set in `x` and `y` (where `x` and `y` represent marginal distributions, binning is set in `xbins` and `ybins` in this case). The resulting distribution is visualized as a contour plot. + /// A heatmap is a data visualization technique that shows magnitude of a phenomenon as color in two dimensions. + /// + /// Sets the 2-dimensional z data, which will be visualized with the color scale. + /// Sets the trace name. The trace name appear as the legend item and on hover. + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity otf the trace. + /// Sets the x coordinates. + /// Sets the horizontal gap (in pixels) between bricks. + /// Sets the y coordinates. + /// Sets the vertical gap (in pixels) between bricks. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the styles of the colorbar for this trace. + /// Sets the colorscale for this trace. + /// Wether or not to show the colorscale/colorbar + /// Reverses the color mapping if true. If true, `zmin` will correspond to the last color in the array and `zmax` will correspond to the first color. + /// Picks a smoothing algorithm use to smooth `z` data. + /// Transposes the z data. + /// Wether or not to use WebGL to render this trace + /// Wether or not to reverse the y axis. If true, (0,0) will lie on the top left and increase downwards. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Heatmap( + IEnumerable> zData, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> X = default, + Optional XGap = default, + Optional> Y = default, + Optional YGap = default, + Optional Text = default, + Optional> MultiText = default, + Optional ColorBar = default, + Optional ColorScale = default, + Optional ShowScale = default, + Optional ReverseScale = default, + Optional ZSmooth = default, + Optional Transpose = default, + Optional UseWebGL = default, + Optional ReverseYAxis = default, + Optional UseDefaults = default + ) + where ZType : IConvertible + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.Heatmap, ZType, XType, YType, TextType>( + zData: zData, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + X: X.ToOption(), + XGap: XGap.ToOption(), + Y: Y.ToOption(), + YGap: YGap.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + ColorBar: ColorBar.ToOption(), + ColorScale: ColorScale.ToOption(), + ShowScale: ShowScale.ToOption(), + ReverseScale: ReverseScale.ToOption(), + ZSmooth: ZSmooth.ToOption(), + Transpose: Transpose.ToOption(), + UseWebGL: UseWebGL.ToOption(), + ReverseYAxis: ReverseYAxis.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a annotated heatmap. /// + /// A heatmap is a data visualization technique that shows magnitude of a phenomenon as color in two dimensions. + /// + /// The annotated heatmap additionally contains annotation text on each datum. /// - /// Sets the x coordinates of the plotted data as well as the sample data to be binned on the x axis. - /// Sets the y coordinates of the plotted data as well as the sample data to be binned on the y axis. - /// Sets the opacity of the point trace. - /// Sets the marker color of the point trace. - /// Sets the marker symbol of the point trace. - /// Sets the marker size of the point trace. - /// Sets the color of the contour lines of the histogram2dcontour trace. - /// Sets the smoothing of the contour lines of the histogram2dcontour trace. - /// Sets the width of the contour lines of the histogram2dcontour trace. - /// Wether or not to show contour lines - /// Wether or not to show contour labels - /// Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace. + /// Sets the 2-dimensional z data, which will be visualized with the color scale. + /// Sets the text to display as annotation for each datum. + /// Sets the trace name. The trace name appear as the legend item and on hover. + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity otf the trace. + /// Sets the x coordinates. + /// Sets the horizontal gap (in pixels) between bricks. + /// Sets the y coordinates. + /// Sets the vertical gap (in pixels) between bricks. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the styles of the colorbar for this trace. + /// Sets the colorscale for this trace. + /// Wether or not to show the colorscale/colorbar + /// Reverses the color mapping if true. If true, `zmin` will correspond to the last color in the array and `zmax` will correspond to the first color. + /// Picks a smoothing algorithm use to smooth `z` data. + /// Transposes the z data. + /// Wether or not to use WebGL to render this trace + /// Wether or not to reverse the y axis. If true, (0,0) will lie on the top left and increase downwards. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart AnnotatedHeatmap( + IEnumerable> zData, + IEnumerable> annotationText, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> X = default, + Optional XGap = default, + Optional> Y = default, + Optional YGap = default, + Optional Text = default, + Optional> MultiText = default, + Optional ColorBar = default, + Optional ColorScale = default, + Optional ShowScale = default, + Optional ReverseScale = default, + Optional ZSmooth = default, + Optional Transpose = default, + Optional UseWebGL = default, + Optional ReverseYAxis = default, + Optional UseDefaults = default + ) + where ZType : IConvertible + where XType : IConvertible + where YType : IConvertible + where TextType : IConvertible + => + Plotly.NET.Chart2D.Chart.AnnotatedHeatmap, ZType, IEnumerable, XType, YType, TextType>( + zData: zData, + annotationText: annotationText, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + X: X.ToOption(), + XGap: XGap.ToOption(), + Y: Y.ToOption(), + YGap: YGap.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + ColorBar: ColorBar.ToOption(), + ColorScale: ColorScale.ToOption(), + ShowScale: ShowScale.ToOption(), + ReverseScale: ReverseScale.ToOption(), + ZSmooth: ZSmooth.ToOption(), + Transpose: Transpose.ToOption(), + UseWebGL: UseWebGL.ToOption(), + ReverseYAxis: ReverseYAxis.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Display an image, i.e. data on a 2D regular raster. By default, when an image is displayed in a subplot, its y axis will be reversed (ie. `autorange: 'reversed'`), constrained to the domain (ie. `constrain: 'domain'`) and it will have the same scale as its x axis (ie. `scaleanchor: 'x,`) in order for pixels to be rendered as squares. + /// + /// A 2-dimensional array in which each element is an array of 3 or 4 numbers representing a color. + /// Specifies the data URI of the image to be visualized. The URI consists of "data:image/[<media subtype>][;base64],<data>" + /// Sets the trace name. The trace name appear as the legend item and on hover. + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity otf the trace. + /// Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type. + /// Color model used to map the numerical color components described in `z` into colors. If `source` is specified, this attribute will be set to `rgba256` otherwise it defaults to `rgb`. + /// Sets the upper bound of the color domain. Value should have the same units as in `z` and if set, `zmin` must be set as well. + /// Sets the lower bound of the color domain. Value should have the same units as in `z` and if set, `zmax` must be set as well. + /// Picks a smoothing algorithm use to smooth `z` data. + /// If set to false, ignore the global default settings set in `Defaults` + public static GenericChart.GenericChart Image( + Optional>>> Z = default, + Optional Source = default, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> Ids = default, + Optional ColorModel = default, + Optional ZMax = default, + Optional ZMin = default, + Optional ZSmooth = default, + Optional UseDefaults = default + ) + where IdType : IConvertible + => + Plotly.NET.Chart2D.Chart.Image>, IEnumerable, IdType>( + Z: Z.ToOption(), + Source: Source.ToOption(), + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + Ids: Ids.ToOption(), + ColorModel: ColorModel.ToOption(), + ZMax: ZMax.ToOption(), + ZMin: ZMin.ToOption(), + ZSmooth: ZSmooth.ToOption(), + UseDefaults: UseDefaults.ToOption() + ); + + /// + /// Creates a 2D contour plot, which shows the contour lines of a 2D numerical array z, i.e. interpolated lines of isovalues of z. + /// + /// A contour line (also isoline, isopleth, or isarithm) of a function of two variables is a curve along which the function has a constant value, so that the curve joins points of equal value + /// + /// The data from which contour lines are computed is set in `z`. Data in `z` must be a 2D array of numbers. Say that `z` has N rows and M columns, then by default, these N rows correspond to N y coordinates (set in `y` or auto-generated) and the M columns correspond to M x coordinates (set in `x` or auto-generated). By setting `transpose` to "true", the above behavior is flipped. + /// + /// Sets the z data which is used for computing the contour lines. + /// Sets the trace name. The trace name appear as the legend item and on hover. + /// Determines whether or not an item corresponding to this trace is shown in the legend. + /// Sets the Opacity otf the trace. + /// Sets the x coordinates. + /// Sets the y coordinates. + /// Sets a text associated with each datum + /// Sets individual text for each datum + /// Sets the styles of the colorbar for this trace. + /// Sets the colorscale for this trace. + /// Wether or not to show the colorscale/colorbar + /// Reverses the color mapping if true. If true, `zmin` will correspond to the last color in the array and `zmax` will correspond to the first color. + /// Transposes the z data. + /// Sets the contour line dash style + /// Sets the contour line color + /// Sets the amount of smoothing for the contour lines, where "0" corresponds to no smoothing. + /// Sets the contour lines (use this for more finegrained control than the other contourline-associated arguments). + /// Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace. + /// Sets the constraint operation. "=" keeps regions equal to `value` "<" and "<=" keep regions less than `value` ">" and ">=" keep regions greater than `value` "[]", "()", "[)", and "(]" keep regions inside `value[0]` to `value[1]` "][", ")(", "](", ")[" keep regions outside `value[0]` to value[1]` Open vs. closed intervals make no difference to constraint display, but all versions are allowed for consistency with filter transforms. + /// If `levels`, the data is represented as a contour plot with multiple levels displayed. If `constraint`, the data is represented as constraints with the invalid region shaded as specified by the `operation` and `value` parameters. + /// Determines whether to label the contour lines with their values. + /// Sets the font used for labeling the contour levels. The default color comes from the lines, if shown. The default family and size come from `layout.font`. + /// Sets the styles of the contours (use this for more finegrained control than the other contour-associated arguments). + /// Sets the fill color if `contours.type` is "constraint". Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. /// Sets the maximum number of contour levels. The actual number of contours will be chosen automatically to be less than or equal to the value of `ncontours`. Has an effect only if `autocontour` is "true" or if `contours.size` is missing. - /// Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent" / "probability", the span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of sample points (here, the sum of all bin HEIGHTS equals 100% / 1). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points). If "probability density", the area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1). - /// Sets the opacity of the histogram2dcontour trace. - /// Sets the color bar. - /// Sets the colorscale of the histogram2dcontour trace. - /// wether or not to show the colorbar /// If set to false, ignore the global default settings set in `Defaults` - public static GenericChart.GenericChart PointDensity( - IEnumerable x, - IEnumerable y, - Optional PointOpacity = default, - Optional PointMarkerColor = default, - Optional PointMarkerSymbol = default, - Optional PointMarkerSize = default, + public static GenericChart.GenericChart Contour( + IEnumerable> zData, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional> X = default, + Optional> Y = default, + Optional Text = default, + Optional> MultiText = default, + Optional ColorBar = default, + Optional ColorScale = default, + Optional ShowScale = default, + Optional ReverseScale = default, + Optional Transpose = default, Optional ContourLineColor = default, + Optional ContourLineDash = default, Optional ContourLineSmoothing = default, - Optional ContourLineWidth = default, - Optional ShowContourLines = default, + Optional ContourLine = default, + Optional ContoursColoring = default, + Optional ContoursOperation = default, + Optional ContoursType = default, Optional ShowContourLabels = default, - Optional ContourColoring = default, + Optional ContourLabelFont = default, + Optional Contours = default, + Optional FillColor = default, Optional NContours = default, - Optional HistNorm = default, - Optional ContourOpacity = default, - Optional ColorBar = default, - Optional ColorScale = default, - Optional ShowScale = default, Optional UseDefaults = default ) + where ZType : IConvertible where XType : IConvertible where YType : IConvertible + where TextType : IConvertible => - Plotly.NET.Chart2D.Chart.PointDensity( - x: x, - y: y, - PointOpacity: PointOpacity.ToOption(), - PointMarkerColor: PointMarkerColor.ToOption(), - PointMarkerSymbol: PointMarkerSymbol.ToOption(), - PointMarkerSize: PointMarkerSize.ToOption(), + Plotly.NET.Chart2D.Chart.Contour, ZType, XType, YType, TextType>( + zData: zData, + Name: Name.ToOption(), + ShowLegend: ShowLegend.ToOption(), + Opacity: Opacity.ToOption(), + X: X.ToOption(), + Y: Y.ToOption(), + Text: Text.ToOption(), + MultiText: MultiText.ToOption(), + ColorBar: ColorBar.ToOption(), + ColorScale: ColorScale.ToOption(), + ShowScale: ShowScale.ToOption(), + ReverseScale: ReverseScale.ToOption(), + Transpose: Transpose.ToOption(), ContourLineColor: ContourLineColor.ToOption(), + ContourLineDash: ContourLineDash.ToOption(), ContourLineSmoothing: ContourLineSmoothing.ToOption(), - ContourLineWidth: ContourLineWidth.ToOption(), - ShowContourLines: ShowContourLines.ToOption(), + ContourLine: ContourLine.ToOption(), + ContoursColoring: ContoursColoring.ToOption(), + ContoursOperation: ContoursOperation.ToOption(), + ContoursType: ContoursType.ToOption(), ShowContourLabels: ShowContourLabels.ToOption(), - ContourColoring: ContourColoring.ToOption(), + ContourLabelFont: ContourLabelFont.ToOption(), + Contours: Contours.ToOption(), + FillColor: FillColor.ToOption(), NContours: NContours.ToOption(), - HistNorm: HistNorm.ToOption(), - ContourOpacity: ContourOpacity.ToOption(), - ColorBar: ColorBar.ToOption(), - ColorScale: ColorScale.ToOption(), - ShowScale: ShowScale.ToOption(), UseDefaults: UseDefaults.ToOption() ); + /// /// Creates an OHLC chart. /// @@ -995,22 +2243,22 @@ public static GenericChart.GenericChart PointDensity( /// Sets the width of the open/close tick marks relative to the "x" minimal interval. /// If set to false, ignore the global default settings set in `Defaults` public static GenericChart.GenericChart OHLC( - IEnumerable open, - IEnumerable high, - IEnumerable low, - IEnumerable close, - IEnumerable x, - Optional Name = default, - Optional ShowLegend = default, - Optional Opacity = default, - Optional Text = default, - Optional> MultiText = default, - Optional Line = default, - Optional IncreasingColor = default, - Optional Increasing = default, - Optional DecreasingColor = default, - Optional Decreasing = default, - Optional TickWidth = default, + IEnumerable open, + IEnumerable high, + IEnumerable low, + IEnumerable close, + IEnumerable x, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional Line = default, + Optional IncreasingColor = default, + Optional Increasing = default, + Optional DecreasingColor = default, + Optional Decreasing = default, + Optional TickWidth = default, Optional UseDefaults = default ) where OHLCType : IConvertible @@ -1030,7 +2278,7 @@ public static GenericChart.GenericChart OHLC( MultiText: MultiText.ToOption(), Line: Line.ToOption(), IncreasingColor: IncreasingColor.ToOption(), - Increasing : Increasing.ToOption(), + Increasing: Increasing.ToOption(), DecreasingColor: DecreasingColor.ToOption(), Decreasing: Decreasing.ToOption(), TickWidth: TickWidth.ToOption(), @@ -1075,7 +2323,7 @@ public static GenericChart.GenericChart Candlestick( Optional Increasing = default, Optional DecreasingColor = default, Optional Decreasing = default, - Optional WhiskerWidth = default, + Optional WhiskerWidth = default, Optional UseDefaults = default ) where OHLCType : IConvertible @@ -1101,184 +2349,139 @@ public static GenericChart.GenericChart Candlestick( WhiskerWidth: WhiskerWidth.ToOption(), UseDefaults: UseDefaults.ToOption() ); + /// - /// Creates a waterfall chart. + /// Creates a scatter plot matrix (SPLOM) from multiple input dimensions. /// - /// Waterfall charts are special bar charts that help visualizing the cumulative effect of sequentially introduced positive or negative values + /// Each splom `dimensions` items correspond to a generated axis. Values for each of those dimensions are set in `dimensions[i].values`. Splom traces support all `scattergl` marker style attributes. Specify `layout.grid` attributes and/or layout x-axis and y-axis attributes for more control over the axis positioning and style. /// - /// Sets the x coordinates of the plotted data. - /// Sets the y coordinates of the plotted data. - /// Sets the trace name. The trace name appear as the legend item and on hover + /// Sets the dimensions of the scatter plot matrix, where each item corresponds to a generated axis. + /// Sets the trace name. The trace name appear as the legend item and on hover. /// Determines whether or not an item corresponding to this trace is shown in the legend. - /// Sets the color of increasing values - /// Sets the style options of increasing values (use this for more finegrained control than the other increasing-associated arguments). - /// Sets the color of decreasing values - /// Sets the style options of decreasing values (use this for more finegrained control than the other increasing-associated arguments). - /// Sets the color of total values - /// Sets the style options of total values (use this for more finegrained control than the other increasing-associated arguments). - /// Sets where the bar base is drawn (in position axis units). - /// Sets the bar width (in position axis units). - /// Sets the individual bar width of each datum (in position axis units). - /// Sets the opacity of the trace. + /// Sets the Opacity otf the trace. /// Sets a text associated with each datum /// Sets individual text for each datum - /// Sets the position of text associated with each datum - /// Sets the position of text associated with individual datum - /// Sets the font used for `text`. - /// Sets the waterfall connector of this trace - /// An array containing types of measures. By default the values are considered as 'relative'. However; it is possible to use 'total' to compute the sums. Also 'absolute' could be applied to reset the computed total or to declare an initial value where needed. - /// Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently. - /// Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up. - /// Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used - including if `visible` is "legendonly" but not if it is `false`. Sets the stacking direction. With "v" ("h"), the y (x) values of subsequent traces are added. Also affects the default value of `fill`. + /// Sets the color of the marker. + /// Sets the colorscale of the marker. Use `Color.fromColorScaleValues` to map marker colors to a colorscale. + /// Sets the outline of the marker + /// Sets the symbol of all marker + /// Sets the symbol of each individual marker + /// Sets the markers (use this for more finegrained control than the other marker-associated arguments). + /// Wether or not to show the matrix diagional + /// Sets the styles applied to the scatter plot matrix diagonal + /// Determines whether or not subplots on the lower half from the diagonal are displayed. + /// Determines whether or not subplots on the upper half from the diagonal are displayed. /// If set to false, ignore the global default settings set in `Defaults` - public static GenericChart.GenericChart Waterfall( - IEnumerable x, - IEnumerable y, - Optional Name = default, - Optional ShowLegend = default, - Optional IncreasingColor = default, - Optional Increasing = default, - Optional DecreasingColor = default, - Optional Decreasing = default, - Optional TotalsColor = default, - Optional Totals = default, - Optional Base = default, - Optional Width = default, - Optional> MultiWidth = default, - Optional Opacity = default, - Optional Text = default, - Optional> MultiText = default, - Optional TextPosition = default, - Optional> MultiTextPosition = default, - Optional TextFont = default, - Optional Connector = default, - Optional> Measure = default, - Optional AlignmentGroup = default, - Optional OffsetGroup = default, - Optional Orientation = default, + public static GenericChart.GenericChart Splom( + IEnumerable dimensions, + Optional Name = default, + Optional ShowLegend = default, + Optional Opacity = default, + Optional Text = default, + Optional> MultiText = default, + Optional MarkerColor = default, + Optional MarkerColorScale = default, + Optional MarkerOutline = default, + Optional MarkerSymbol = default, + Optional> MultiMarkerSymbol = default, + Optional Marker = default, + Optional ShowDiagonal = default, + Optional Diagonal = default, + Optional ShowLowerHalf = default, + Optional ShowUpperHalf = default, Optional UseDefaults = default ) - where XType : IConvertible - where YType : IConvertible where TextType : IConvertible => - Plotly.NET.Chart2D.Chart.Waterfall( - x: x, - y: y, + Plotly.NET.Chart2D.Chart.Splom( + dimensions: dimensions, Name: Name.ToOption(), ShowLegend: ShowLegend.ToOption(), - IncreasingColor: IncreasingColor.ToOption(), - Increasing: Increasing.ToOption(), - DecreasingColor: DecreasingColor.ToOption(), - Decreasing: Decreasing.ToOption(), - TotalsColor: TotalsColor.ToOption(), - Totals: Totals.ToOption(), - Base: Base.ToOption(), - Width: Width.ToOption(), - MultiWidth: MultiWidth.ToOption(), Opacity: Opacity.ToOption(), Text: Text.ToOption(), MultiText: MultiText.ToOption(), - TextPosition: TextPosition.ToOption(), - MultiTextPosition: MultiTextPosition.ToOption(), - TextFont: TextFont.ToOption(), - Connector: Connector.ToOption(), - Measure: Measure.ToOption(), - AlignmentGroup: AlignmentGroup.ToOption(), - OffsetGroup: OffsetGroup.ToOption(), - Orientation: Orientation.ToOption(), + MarkerColor: MarkerColor.ToOption(), + MarkerColorScale: MarkerColorScale.ToOption(), + MarkerOutline: MarkerOutline.ToOption(), + MarkerSymbol: MarkerSymbol.ToOption(), + MultiMarkerSymbol: MultiMarkerSymbol.ToOption(), + Marker: Marker.ToOption(), + ShowDiagonal: ShowDiagonal.ToOption(), + Diagonal: Diagonal.ToOption(), + ShowLowerHalf: ShowLowerHalf.ToOption(), + ShowUpperHalf: ShowUpperHalf.ToOption(), UseDefaults: UseDefaults.ToOption() ); /// - /// Creates a Funnel chart. + /// Creates a point density plot - a combination of a Scatter plot and Histogram2DContour. + /// + /// Additionally to plotting the (x,y) data as points on a 2D plane, a density contour plot is computed by grouping a set of points specified by their x and y coordinates into bins, and applying a count aggregation function to compute the value to be used to compute contours. + /// The sample data from which statistics are computed is set in `x` and `y` (where `x` and `y` represent marginal distributions, binning is set in `xbins` and `ybins` in this case). The resulting distribution is visualized as a contour plot. /// - /// Funnel charts visualize stages in a process using length-encoded bars. This trace can be used to show data in either a part-to-whole representation wherein each item appears in a single stage, or in a "drop-off" representation wherein each item appears in each stage it traversed. See also the "funnelarea" trace type for a different approach to visualizing funnel data. /// - /// Sets the x coordinates of the plotted data. - /// Sets the y coordinates of the plotted data. - /// Sets the trace name. The trace name appear as the legend item and on hover - /// Determines whether or not an item corresponding to this trace is shown in the legend. - /// Sets the Opacity of the trace. - /// Sets the bar width (in position axis units). - /// Shifts the position where the bar is drawn (in position axis units). In "group" barmode, traces that set "offset" will be excluded and drawn in "overlay" mode instead. - /// Sets a text associated with each datum - /// Sets individual text for each datum - /// Sets the position of text associated with each datum - /// Sets the position of text associated with individual datum - /// Only relevant when `stackgroup` is used, and only the first `orientation` found in the `stackgroup` will be used - including if `visible` is "legendonly" but not if it is `false`. Sets the stacking direction. With "v" ("h"), the y (x) values of subsequent traces are added. Also affects the default value of `fill`. - /// Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently. - /// Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up. - /// Sets the color of the bars. - /// Sets the color of the bar outline. - /// Sets the marker (use this for more finegrained control than the other marker-associated arguments) - /// Determines which trace information appear on the graph. In the case of having multiple funnels, percentages and totals are computed separately (per trace). - /// Sets the line color of the funnel connector - /// Sets the line style of the funnel connector - /// Sets the fill color of the funnel connector - /// Sets the line of the funnel connector (use this for more finegrained control than the other connector line associated arguments). - /// Sets the funnel connector (use this for more finegrained control than the other connector-associated arguments). - /// Sets the font used for `text` lying inside the bar. - /// Sets the font used for `text` lying outside the bar. + /// Sets the x coordinates of the plotted data as well as the sample data to be binned on the x axis. + /// Sets the y coordinates of the plotted data as well as the sample data to be binned on the y axis. + /// Sets the opacity of the point trace. + /// Sets the marker color of the point trace. + /// Sets the marker symbol of the point trace. + /// Sets the marker size of the point trace. + /// Sets the color of the contour lines of the histogram2dcontour trace. + /// Sets the smoothing of the contour lines of the histogram2dcontour trace. + /// Sets the width of the contour lines of the histogram2dcontour trace. + /// Wether or not to show contour lines + /// Wether or not to show contour labels + /// Determines the coloring method showing the contour values. If "fill", coloring is done evenly between each contour level If "heatmap", a heatmap gradient coloring is applied between each contour level. If "lines", coloring is done on the contour lines. If "none", no coloring is applied on this trace. + /// Sets the maximum number of contour levels. The actual number of contours will be chosen automatically to be less than or equal to the value of `ncontours`. Has an effect only if `autocontour` is "true" or if `contours.size` is missing. + /// Specifies the type of normalization used for this histogram trace. If "", the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If "percent" / "probability", the span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of sample points (here, the sum of all bin HEIGHTS equals 100% / 1). If "density", the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points). If "probability density", the area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1). + /// Sets the opacity of the histogram2dcontour trace. + /// Sets the color bar. + /// Sets the colorscale of the histogram2dcontour trace. + /// wether or not to show the colorbar /// If set to false, ignore the global default settings set in `Defaults` - public static GenericChart.GenericChart Funnel( - IEnumerable x, + public static GenericChart.GenericChart PointDensity( + IEnumerable x, IEnumerable y, - Optional Name = default, - Optional ShowLegend = default, - Optional Opacity = default, - Optional Width = default, - Optional Offset = default, - Optional Text = default, - Optional> MultiText = default, - Optional TextPosition = default, - Optional> MultiTextPosition = default, - Optional Orientation = default, - Optional AlignmentGroup = default, - Optional OffsetGroup = default, - Optional MarkerColor = default, - Optional MarkerOutline = default, - Optional Marker = default, - Optional TextInfo = default, - Optional ConnectorLineColor = default, - Optional ConnectorLineStyle = default, - Optional ConnectorFillColor = default, - Optional ConnectorLine = default, - Optional Connector = default, - Optional InsideTextFont = default, - Optional OutsideTextFont = default, + Optional PointOpacity = default, + Optional PointMarkerColor = default, + Optional PointMarkerSymbol = default, + Optional PointMarkerSize = default, + Optional ContourLineColor = default, + Optional ContourLineSmoothing = default, + Optional ContourLineWidth = default, + Optional ShowContourLines = default, + Optional ShowContourLabels = default, + Optional ContourColoring = default, + Optional NContours = default, + Optional HistNorm = default, + Optional ContourOpacity = default, + Optional ColorBar = default, + Optional ColorScale = default, + Optional ShowScale = default, Optional UseDefaults = default ) where XType : IConvertible where YType : IConvertible - where TextType : IConvertible => - Plotly.NET.Chart2D.Chart.Funnel( + Plotly.NET.Chart2D.Chart.PointDensity( x: x, y: y, - Name: Name.ToOption(), - ShowLegend: ShowLegend.ToOption(), - Opacity: Opacity.ToOption(), - Width: Width.ToOption(), - Offset: Offset.ToOption(), - Text: Text.ToOption(), - MultiText: MultiText.ToOption(), - TextPosition: TextPosition.ToOption(), - MultiTextPosition: MultiTextPosition.ToOption(), - Orientation: Orientation.ToOption(), - AlignmentGroup: AlignmentGroup.ToOption(), - OffsetGroup: OffsetGroup.ToOption(), - MarkerColor: MarkerColor.ToOption(), - MarkerOutline: MarkerOutline.ToOption(), - Marker: Marker.ToOption(), - TextInfo: TextInfo.ToOption(), - ConnectorLineColor: ConnectorLineColor.ToOption(), - ConnectorLineStyle: ConnectorLineStyle.ToOption(), - ConnectorFillColor: ConnectorFillColor.ToOption(), - ConnectorLine: ConnectorLine.ToOption(), - Connector: Connector.ToOption(), - InsideTextFont: InsideTextFont.ToOption(), - OutsideTextFont: OutsideTextFont.ToOption(), + PointOpacity: PointOpacity.ToOption(), + PointMarkerColor: PointMarkerColor.ToOption(), + PointMarkerSymbol: PointMarkerSymbol.ToOption(), + PointMarkerSize: PointMarkerSize.ToOption(), + ContourLineColor: ContourLineColor.ToOption(), + ContourLineSmoothing: ContourLineSmoothing.ToOption(), + ContourLineWidth: ContourLineWidth.ToOption(), + ShowContourLines: ShowContourLines.ToOption(), + ShowContourLabels: ShowContourLabels.ToOption(), + ContourColoring: ContourColoring.ToOption(), + NContours: NContours.ToOption(), + HistNorm: HistNorm.ToOption(), + ContourOpacity: ContourOpacity.ToOption(), + ColorBar: ColorBar.ToOption(), + ColorScale: ColorScale.ToOption(), + ShowScale: ShowScale.ToOption(), UseDefaults: UseDefaults.ToOption() ); diff --git a/tests/Plotly.NET.Tests.CSharpConsole/Program.cs b/tests/Plotly.NET.Tests.CSharpConsole/Program.cs index bddebbf98..092d50e0b 100644 --- a/tests/Plotly.NET.Tests.CSharpConsole/Program.cs +++ b/tests/Plotly.NET.Tests.CSharpConsole/Program.cs @@ -11,62 +11,224 @@ static void Main(string[] args) { Chart.Grid( nRows: 10, - nCols: 6, + nCols: 7, gCharts: new GenericChart[] { //2D basic traces - Chart.Scatter( - x: new int [] { 1, 2 }, - y: new int [] { 3, 4 }, - mode: Mode.Markers, - MultiText: new int [] { 3, 4 } + + //simple scatter derived + Chart.Combine( + new GenericChart [] + { + Chart.Scatter( + x: new int [] { 1, 2, 3 }, + y: new int [] { 5, 3, 4 }, + mode: Mode.Markers, + Name: "scatter", + MultiText: new int [] { 3, 4 } + ), + Chart.Point( + x: new int [] { 1, 2, 3 }, + y: new int [] { 6, 4, 5 }, + Name: "point", + Text: "hi" + ), + Chart.Line( + x: new int [] { 1, 2, 3 }, + y: new int [] { 7, 5, 6 }, + Name: "line" + ), + Chart.Spline( + x: new int [] { 1, 2, 3}, + y: new int [] { 8, 6, 7 }, + Name: "spline" + ), + Chart.Bubble( + x: new int [] { 1, 2, 3 }, + y: new int [] { 9, 7, 8 }, + sizes: new int [] { 10, 20, 30 }, + Name: "bubble" + ) + } + ).WithTraceInfo( + LegendGroup: "simple-scatter-derived", + LegendGroupTitle: Plotly.NET.Title.init("simple scatter-derived traces", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.Point( - x: new int [] { 5, 6 }, - y: new int [] { 7, 8 }, - Text: "hi" + + //extended scatter derived + Chart.Combine( + new GenericChart [] + { + Chart.Range( + x: new int [] { 1, 2, 3 }, + y: new int [] { 5, 3, 4 }, + upper: new int [] { 6, 4, 5 }, + lower: new int [] { 4, 2, 3 }, + mode: Mode.Lines, + Name: "range" + ), + Chart.Area( + x: new int [] { 1, 2}, + y: new int [] { 3, 1}, + Name: "area" + ), + Chart.SplineArea( + x: new int [] { 3, 4, 5}, + y: new int [] { 3, 1, 4}, + Name: "splinearea" + ), + Chart.StackedArea( + x: new int [] { 6, 7}, + y: new int [] { 3, 1}, + Name: "stacked area 1" + ), + Chart.StackedArea( + x: new int [] { 6, 7}, + y: new int [] { 3, 2}, + Name: "stacked area 2" + ) + } + ).WithTraceInfo( + LegendGroup: "extended-scatter-derived", + LegendGroupTitle: Plotly.NET.Title.init("extended scatter-derived traces", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.Line( - x: new int [] { 9, 10 }, - y: new int [] { 11, 12 } + Chart.Combine( + new GenericChart [] + { + Chart.Bar( + values: new int [] { 1,2 }, + Keys: new string [] { "first", "second"}, + Name: "bar" + ), + Chart.StackedBar( + values: new int [] { 1,2 }, + Keys: new string [] { "third", "4th"}, + Name: "stacked bar 1" + ), + Chart.StackedBar( + values: new int [] { 1,2 }, + Keys: new string [] { "third", "4th"}, + Name: "stacked bar 2" + ), + } + ).WithTraceInfo( + LegendGroup: "bar-and-derived-traces", + LegendGroupTitle: Plotly.NET.Title.init("bar and derived traces", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.Bar( - values: new int [] { 1,2 }, - Keys: new string [] { "first", "second"} + Chart.Combine( + new GenericChart [] + { + Chart.Column( + values: new int [] { 3,4 }, + Keys: new string [] { "first", "second"}, + Name: "column" + ), + Chart.StackedColumn( + values: new int [] { 1,2 }, + Keys: new string [] { "third", "4th"}, + Name: "stacked column 1" + ), + Chart.StackedColumn( + values: new int [] { 1,2 }, + Keys: new string [] { "third", "4th"}, + Name: "stacked column 2" + ), + } + ).WithTraceInfo( + LegendGroup: "bar-and-derived-traces", + LegendGroupTitle: Plotly.NET.Title.init("bar and derived traces", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.Column( - values: new int [] { 3,4 }, - Keys: new string [] { "first", "second"} + Chart.Heatmap( + zData: new int [] [] + { + new int [] { 1,2,3}, + new int [] { 2,1,2}, + new int [] { 3,2,1} + }, + ShowScale: false, + Name: "heatmap", + ShowLegend: true + ).WithTraceInfo( + LegendGroup: "other-simple-2D", + LegendGroupTitle: Plotly.NET.Title.init("other simple 2D traces", Font: Plotly.NET.Font.init(Size: 20)) + ), + Chart.Image( + Source: @"data:image/gif;base64,R0lGODdhEAAQAMwAAPj7+FmhUYjNfGuxYYDJdYTIeanOpT+DOTuANXi/bGOrWj6CONzv2sPjv2CmV1unU4zPgI/Sg6DJnJ3ImTh8Mtbs00aNP1CZSGy0YqLEn47RgXW8amasW7XWsmmvX2iuXiwAAAAAEAAQAAAFVyAgjmRpnihqGCkpDQPbGkNUOFk6DZqgHCNGg2T4QAQBoIiRSAwBE4VA4FACKgkB5NGReASFZEmxsQ0whPDi9BiACYQAInXhwOUtgCUQoORFCGt/g4QAIQA7" + ).WithTraceInfo( + LegendGroup: "other-simple-2D", + LegendGroupTitle: Plotly.NET.Title.init("other simple 2D traces", Font: Plotly.NET.Font.init(Size: 20)) ), Chart.Invisible(), //2D distributions Chart.Histogram( X: new int [] { 1,2,2,2,3,4,5,5 }, - MultiText: new int [] { 1,2,3,4,5,6,7} + MultiText: new int [] { 1,2,3,4,5,6,7}, + Name: "histogram" + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), Chart.Histogram2D( x: new int [] { 1,2,2,2,3,4,5,5 }, y: new int [] { 1,2,2,2,3,4,5,5 }, - ShowScale: false + ShowScale: false, + ShowLegend: true, + Name: "histogram2D" + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.BoxPlot( - X: new int [] { 1,2,2,2,3,4,5,5 } + Chart.Combine( + new GenericChart [] + { + Chart.BoxPlot( + X: new int [] { 1,2,2,2,3,4,5,5 }, + Name: "Boxplot" + ), + Chart.Violin( + X: new int [] { 1,2,2,2,3,4,5,5 }, + Name: "Violin" + ), + } + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), - Chart.Violin( - X: new int [] { 1,2,2,2,3,4,5,5 } + Chart.Contour( + zData: new int [] [] + { + new int [] { 1,2,3}, + new int [] { 2,1,2}, + new int [] { 3,2,1} + }, + ShowScale: false, + ShowLegend: true, + Name: "contour" + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), Chart.Histogram2DContour( x: new int [] { 1,2,2,2,3,4,5,5 }, y: new int [] { 1,2,2,2,3,4,5,5 }, - ShowScale: false + ShowScale: false, + ShowLegend: true, + Name: "histogram2Dcontour" + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), Chart.PointDensity( x: new int [] { 1,2,2,2,3,4,5,5 }, y: new int [] { 1,2,2,2,3,4,5,5 }, ShowScale: false + ).WithTraceInfo( + LegendGroup: "scientific", + LegendGroupTitle: Plotly.NET.Title.init("scientific/2D distributions", Font: Plotly.NET.Font.init(Size: 20)) ), + Chart.Invisible(), //2D Finance traces Chart.OHLC( @@ -105,6 +267,19 @@ static void Main(string[] args) x: new double [] { 1200, 909.4, 600.6, 300, 80 }, y: new string[] { "A", "B", "C", "D", "E"} ), + Chart.Combine( + new GenericChart [] + { + Chart.StackedFunnel( + x: new double [] { 1200, 909.4, 600.6, 300, 80 }, + y: new string[] { "A", "B", "C", "D", "E"} + ), + Chart.StackedFunnel( + x: new double [] { 1200, 909.4, 600.6, 300, 80 }, + y: new string[] { "A", "B", "C", "D", "E"} + ), + } + ), Chart.FunnelArea( values: new int [] { 5, 4, 3, 2, 1 }, MultiText: new string[] { "A", "B", "C", "D", "E"} @@ -127,6 +302,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), //polar traces Chart.ScatterPolar( @@ -139,6 +315,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), //geo/mapbox traces Chart.ScatterGeo( @@ -150,6 +327,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), Chart.DensityMapbox( longitudes: new int [] { 1,2,2,2,3,4,5,5 }, latitudes: new int [] { 1,2,2,2,3,4,5,5 }, @@ -169,6 +347,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), //carpet traces Chart.Carpet( @@ -181,6 +360,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), Chart.Combine( new GenericChart [] { @@ -211,6 +391,7 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), //smith traces Chart.ScatterSmith( @@ -222,10 +403,11 @@ static void Main(string[] args) Chart.Invisible(), Chart.Invisible(), Chart.Invisible(), + Chart.Invisible(), Chart.Invisible() } ) - .WithSize(1200, 2000) + .WithSize(1600, 2200) .Show(); } }