ipecharts.option.zaxis3d module#

class ipecharts.option.zaxis3d.ZAxis3D(**kwargs: Any)[source]#

Bases: BaseWidget

Warning:

Autogenerated class

The Z-axis in a 3D cartesian coordinate system. You can use [grid3DIndex](#zAxis3D.grid3DIndex) to index [3D cartesian coordinate system](#grid3D).

The [axisLine](#zAxis3D.axisLine), [axisTick](#zAxis3D.axisTick), [axisLabel](#zAxis3D.axisLabel), [splitLine](#zAxis3D.splitLine), [splitArea](#zAxis3D.splitArea), [axisPointer](#zAxis3D.axisPointer) set separately on [zAxis3D](#zAxis3D) will cover the corresponding configuration items under [grid3D](#grid3D).

show Bool(None)#

Whether to display the z-axis.

name Unicode(None)#

The name of the axis.

grid3DIndex Float(None)#

The index of the [grid3D](#grid3D) component used by the axis. The default is to use the first [grid3D](#grid3D) component.

nameTextStyle Dict()#

Text style of axis name.

nameGap Float(None)#

The gap between the axis name and axis line. Note the distance is in 3D space, not the screen pixel value.

type Unicode(None)#

The type of the axis.

Optional:

  • ‘value’ The value axis. Suitable for continuous data.

  • ‘category’ The category axis. Suitable for the discrete category data. For this type, the category data must be set through [data](#zAxis3D.data).

  • ‘time’ The timeline. Suitable for the continuous timing data. The time axis has a time format compared to the value axis, and the scale calculation is also different. For example, the scale of the month, week, day, and hour ranges can be determined according to the range of the span.

  • ‘log’ Logarithmic axis. Suitable for the logarithmic data.

min Union(None)#

The minimum value of axis.

It can be set to a special value ‘dataMin’ so that the minimum value on this axis is set to be the minimum label.

It will be automatically computed to make sure the axis tick is equally distributed when not set.

In the category axis, it can also be set as the ordinal number. For example, if a category axis has data: [‘categoryA’, ‘categoryB’, ‘categoryC’], and the ordinal 2 represents ‘categoryC’. Moreover, it can be set as a negative number, like -3.

max Union(None)#

The maximum value of the axis.

It can be set to a special value ‘dataMax’ so that the minimum value on this axis is set to be the maximum label.

It will be automatically computed to make sure the axis tick is equally distributed when not set.

In the category axis, it can also be set as the ordinal number. For example, if a category axis has data: [‘categoryA’, ‘categoryB’, ‘categoryC’], and the ordinal 2 represents ‘categoryC’. Moreover, it can be set as a negative number, like -3.

scale Bool(None)#

It is available only in numerical axis, i.e., [type](#zAxis3D.type): ‘value’.

It specifies whether not to contain zero position of axis compulsively. When it is set to be true, the axis may not contain zero position, which is useful in the scatter chart for both value axes.

This configuration item is unavailable when the [min](#zAxis3D.min) and [max](#zAxis3D.max) are set.

splitNumber Float(None)#

The number of segments that the axis is split into. Note that this number serves only as a recommendation, and the true segments may be adjusted based on readability.

This is unavailable for the category axis.

minInterval Float(None)#

Minimum gap between split lines.

For example, it can be set to be 1 to make sure the axis label is shown as an integer.

``` {

minInterval: 1

}

```

It is available only for axis of [type](#zAxis3D.type) ‘value’ or ‘time’.

interval Float(None)#

Compulsively set segmentation interval for axis.

As [splitNumber](#zAxis3D.splitNumber) is a recommendation value, the calculated tick may not be the same as expected. In this case, interval should be used along with [min](#zAxis3D.min) and [max](#zAxis3D.max) to compulsively set tickings. But in most cases, we do not suggest using this, out automatic calculation is enough for most situations.

This is unavailable for ‘category’ and ‘time’ axes. Logged value should be passed for [type](#zAxis3D.type): ‘log’ axis.

logBase Float(None)#

Base of logarithm, which is valid only for numeric axes with [type](#zAxis3D.type): ‘log’.

data Any(None)#

Category data, available in [type](#zAxis3D.type): ‘category’ axis.

If [type](#zAxis3D.type) is specified as ‘category’, but axis.data is not specified, axis.data will be auto collected from [series.data](#series.data). It brings convenience, but we should notice that axis.data provides then value range of the ‘category’ axis. If it is auto collected from [series.data](#series.data), Only the values appearing in [series.data](#series.data) can be collected. For example, if [series.data](#series.data) is empty, nothing will be collected.

Example:

``` // Name list of all categories data: [‘Monday’, ‘Tuesday’, ‘Wednesday’, ‘Thursday’, ‘Friday’, ‘Saturday’, ‘Sunday’] // Each item could also be a specific configuration item. // In this case, value is used as the category name. data: [{

value: ‘Monday’, // Highlight Monday textStyle: {

fontSize: 20, color: ‘red’

}

}, ‘Tuesday’, ‘Wednesday’, ‘Thursday’, ‘Friday’, ‘Saturday’, ‘Sunday’]

```

axisLine Dict()#

Settings related to axis line.

axisLabel Dict()#

Settings related to axis label.

axisTick Dict()#

Settings related to axis tick.

splitLine Dict()#

Settings related to axis line.

splitArea Dict()#

Split area of axis in [grid](#grid) area.

axisPointer Dict()#

Configurations for axis pointer.