CAxis

public struct CAxis : Encodable

Undocumented

  • Undocumented

    Declaration

    Swift

    public var title: Title?
  • Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors.

    Grid color is lightened by blending this with the plot background Individual pieces can override this.

    Declaration

    Swift

    public var color: Color?
  • Sets the tick mode for this axis.

    If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).

    Declaration

    Swift

    public var tickMode: TickMode?
  • Specifies the maximum number of ticks for the particular axis.

    The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.

    Declaration

    Swift

    public var numTicks: Int?
  • Sets the placement of the first tick on this axis.

    Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=L (see dtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.

    Declaration

    Swift

    public var tick0: Anything?
  • Sets the step in-between ticks on this axis.

    Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. log has several special values; L, where f is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values M gives ticks spaced by a number of months. n must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48

    Declaration

    Swift

    public var dTick: Anything?
  • Sets the values at which ticks on this axis appear.

    Only has an effect if tickmode is set to array. Used with ticktext.

    Declaration

    Swift

    public var tickValues: [Double]?
  • Sets the text displayed at the ticks position via tickvals.

    Only has an effect if tickmode is set to array. Used with tickvals.

    Declaration

    Swift

    public var tickText: [Double]?
  • Determines whether ticks are drawn or not.

    If *, this axis’ ticks are not drawn. If *outside (inside), this axis’ are drawn outside (inside) the axis lines.

    Declaration

    Swift

    public var ticks: Ticks?
  • Sets the tick length (in px).

    Declaration

    Swift

    public var tickLength: Double?
  • Sets the tick width (in px).

    Declaration

    Swift

    public var tickWidth: Double?
  • Sets the tick color.

    Declaration

    Swift

    public var tickColor: Color?
  • Determines whether or not the tick labels are drawn.

    Declaration

    Swift

    public var showTickLabels: Bool?
  • If all, all tick labels are displayed with a prefix.

    If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.

    Declaration

    Swift

    public var showTickPrefix: ShowTickPrefix?
  • Sets a tick label prefix.

    Declaration

    Swift

    public var tickPrefix: String?
  • Same as showtickprefix but for tick suffixes.

    Declaration

    Swift

    public var showTickSuffix: ShowTickSuffix?
  • Sets a tick label suffix.

    Declaration

    Swift

    public var tickSuffix: String?
  • If all, all exponents are shown besides their significands.

    If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.

    Declaration

    Swift

    public var showExponent: ShowExponent?
  • Determines a formatting rule for the tick exponents.

    For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.

    Declaration

    Swift

    public var exponentFormat: ExponentFormat?
  • Hide SI prefix for 10^n if |n| is below this number.

    This only has an effect when tickformat is SI or B.

    Declaration

    Swift

    public var minExponent: Double?
  • If “true”, even 4-digit integers are separated

    Declaration

    Swift

    public var separateThousands: Bool?
  • Sets the tick font.

    Declaration

    Swift

    public var tickFont: Font?
  • Sets the angle of the tick labels with respect to the horizontal.

    For example, a tickangle of -90 draws the tick labels vertically.

    Declaration

    Swift

    public var tickAngle: Angle?
  • Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python.

    For numbers, see: https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#d3_format And for dates see: https://github.com/d3/d3-time-format#locale_format We add one item to d3’s date formatter: %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46

    Declaration

    Swift

    public var tickFormat: String?
  • Undocumented

    Declaration

    Swift

    public var tickFormatStops: [TickFormatStop]?
  • Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python.

    For numbers, see: https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#d3_format And for dates see: https://github.com/d3/d3-time-format#locale_format We add one item to d3’s date formatter: %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46

    Declaration

    Swift

    public var hoverFormat: String?
  • Determines whether or not a line bounding this axis is drawn.

    Declaration

    Swift

    public var showLine: Bool?
  • Sets the axis line color.

    Declaration

    Swift

    public var lineColor: Color?
  • Sets the width (in px) of the axis line.

    Declaration

    Swift

    public var lineWidth: Double?
  • Determines whether or not grid lines are drawn.

    If true, the grid lines are drawn at every tick mark.

    Declaration

    Swift

    public var showGrid: Bool?
  • Sets the color of the grid lines.

    Declaration

    Swift

    public var gridColor: Color?
  • Sets the width (in px) of the grid lines.

    Declaration

    Swift

    public var gridWidth: Double?
  • Sets the layer on which this axis is displayed.

    If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.

    Declaration

    Swift

    public var layer: AxisLayer?
  • min

    The minimum value visible on this axis.

    The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.

    Declaration

    Swift

    public var min: Double?
  • Controls persistence of user-driven changes in axis min, and title if in editable: true configuration.

    Defaults to ternary<N>.uirevision.

    Declaration

    Swift

    public var uiRevision: Anything?
  • Creates CAxis object with specified properties.

    Declaration

    Swift

    public init(title: Title? = nil, color: Color? = nil, tickMode: TickMode? = nil, numTicks: Int?
            = nil, tick0: Anything? = nil, dTick: Anything? = nil, tickValues: [Double]? = nil, tickText:
            [Double]? = nil, ticks: Ticks? = nil, tickLength: Double? = nil, tickWidth: Double? = nil,
            tickColor: Color? = nil, showTickLabels: Bool? = nil, showTickPrefix: ShowTickPrefix? = nil,
            tickPrefix: String? = nil, showTickSuffix: ShowTickSuffix? = nil, tickSuffix: String? = nil,
            showExponent: ShowExponent? = nil, exponentFormat: ExponentFormat? = nil, minExponent: Double? =
            nil, separateThousands: Bool? = nil, tickFont: Font? = nil, tickAngle: Angle? = nil, tickFormat:
            String? = nil, tickFormatStops: [TickFormatStop]? = nil, hoverFormat: String? = nil, showLine:
            Bool? = nil, lineColor: Color? = nil, lineWidth: Double? = nil, showGrid: Bool? = nil,
            gridColor: Color? = nil, gridWidth: Double? = nil, layer: AxisLayer? = nil, min: Double? = nil,
            uiRevision: Anything? = nil)

    Parameters

    title

    color

    Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors.

    tickMode

    Sets the tick mode for this axis.

    numTicks

    Specifies the maximum number of ticks for the particular axis.

    tick0

    Sets the placement of the first tick on this axis.

    dTick

    Sets the step in-between ticks on this axis.

    tickValues

    Sets the values at which ticks on this axis appear.

    tickText

    Sets the text displayed at the ticks position via tickvals.

    ticks

    Determines whether ticks are drawn or not.

    tickLength

    Sets the tick length (in px).

    tickWidth

    Sets the tick width (in px).

    tickColor

    Sets the tick color.

    showTickLabels

    Determines whether or not the tick labels are drawn.

    showTickPrefix

    If all, all tick labels are displayed with a prefix.

    tickPrefix

    Sets a tick label prefix.

    showTickSuffix

    Same as showtickprefix but for tick suffixes.

    tickSuffix

    Sets a tick label suffix.

    showExponent

    If all, all exponents are shown besides their significands.

    exponentFormat

    Determines a formatting rule for the tick exponents.

    minExponent

    Hide SI prefix for 10^n if |n| is below this number.

    separateThousands

    If “true”, even 4-digit integers are separated

    tickFont

    Sets the tick font.

    tickAngle

    Sets the angle of the tick labels with respect to the horizontal.

    tickFormat

    Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python.

    tickFormatStops

    hoverFormat

    Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python.

    showLine

    Determines whether or not a line bounding this axis is drawn.

    lineColor

    Sets the axis line color.

    lineWidth

    Sets the width (in px) of the axis line.

    showGrid

    Determines whether or not grid lines are drawn.

    gridColor

    Sets the color of the grid lines.

    gridWidth

    Sets the width (in px) of the grid lines.

    layer

    Sets the layer on which this axis is displayed.

    min

    The minimum value visible on this axis.

    uiRevision

    Controls persistence of user-driven changes in axis min, and title if in editable: true configuration.