BigQuant使用文档

Pictorialbar - 象形柱状图

由qxiao创建,最终由ydong 被浏览 37 用户

接口

对于Pictorialbar(象形柱状图图)的 _type=”pictorialbar” 和 series_options:

bigcharts.Chart(
    ... 其他参数
    # 【设置图表类型】图表类型,具体参考各类型图表
    type_ = "pictorialbar",

    series_options = {
        "列名": {
                # 系列名称,用于 tooltip 的显示,legend 的图例筛选。
                series_name: str,

                # 图形类型。
                # ECharts 提供的标记类型包括 'circle', 'rect', 'roundRect', 'triangle', 
                # 'diamond', 'pin', 'arrow', 'none'
                # 可以通过 'image://url' 设置为图片,其中 URL 为图片的链接,或者 dataURI。
                # URL 为图片链接例如:'image://http://xxx.xxx.xxx/a/b.png'
                # URL 为 dataURI 例如:'image://data:image/gif;base64,R0lGODlhEAAQAMQAAORHHOVSKudfO...
                # 可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,
                # 而且可以设置为任意颜色。路径图形会自适应调整为合适的大小。路径的格式参见 SVG PathData。
                # 可以从 Adobe Illustrator 等工具编辑导出。例如:
                # 'path://M30.9,53.2C16.8,53.2,5.3,41.7,5.3,27.6S16.8,2,30.9,2C45,2,56.4,13.5,56.4,2...'
                symbol: Optional[str] = None,

                # 图形的大小。
                # 可以用数组分开表示宽和高,例如 [20, 10] 表示标记宽为20,
                # 高为 10,也可以设置成诸如 10 这样单一的数字,表示 [10, 10]。
                # 可以设置成绝对值(如 10),也可以设置成百分比(如 '120%'、['55%', 23])。
                symbol_size: Union[Numeric, Sequence, None] = None,

                # 图形的定位位置。可取值:
                # 'start':图形边缘与柱子开始的地方内切。
                # 'end':图形边缘与柱子结束的地方内切。
                # 'center':图形在柱子里居中。
                symbol_pos: Optional[str] = None,

                # 图形相对于原本位置的偏移。symbolOffset 是图形定位中最后计算的一个步骤,
                # 可以对图形计算出来的位置进行微调。
                # 可以设置成绝对值(如 10),也可以设置成百分比(如 '120%'、['55%', 23])。
                # 当设置为百分比时,表示相对于自身尺寸 symbolSize 的百分比。
                # 例如 [0, '-50%'] 就是把图形向上移动了自身尺寸的一半的位置。
                symbol_offset: Optional[Sequence] = None,

                # 图形的旋转角度。
                # 注意,symbolRotate 并不会影响图形的定位(哪怕超出基准柱的边界),而只是单纯得绕自身中心旋转。
                # 此属性可以被设置在系列的 根部,表示对此系列中所有数据都生效;
                # 也可以被设置在 data 中的 每个数据项中,表示只对此数据项生效。
                symbol_rotate: Optional[Numeric] = None,

                # 指定图形元素是否重复。值可为:
                # false/null/undefined:不重复,即每个数据值用一个图形元素表示。
                # true:使图形元素重复,即每个数据值用一组重复的图形元素表示。重复的次数依据 data 计算得到。
                # a number:使图形元素重复,即每个数据值用一组重复的图形元素表示。重复的次数是给定的定值。
                # 'fixed':使图形元素重复,即每个数据值用一组重复的图形元素表示。
                # 重复的次数依据 symbolBoundingData 计算得到,即与 data 无关。这在此图形被用于做背景时有用。
                symbol_repeat: Optional[str] = None,

                # 指定图形元素重复时,绘制的顺序。这个属性在两种情况下有用处:
                # 当 symbolMargin 设置为负值时,重复的图形会互相覆盖,这是可以使用 symbolRepeatDirection 来指定覆盖顺序。
                # 当 animationDelay 或 animationDelayUpdate 被使用时,symbolRepeatDirection 指定了 index 顺序。
                # 这个属性的值可以是:'start' 或 'end'。
                symbol_repeat_direction: Optional[str] = None,

                # 图形的两边间隔(『两边』是指其数值轴方向的两边)。可以是绝对数值(如 20),或者百分比值(如 '-30%'),
                # 表示相对于自身尺寸 symbolSize 的百分比。只有当 symbolRepeat 被使用时有意义。
                # 可以是正值,表示间隔大;也可以是负数。当 symbolRepeat 被使用时,负数时能使图形重叠。
                # 可以在其值结尾处加一个 "!",如 "30%!" 或 25!,表示第一个图形的开始和最后一个图形结尾留白,
                # 不紧贴边界。默认会紧贴边界。
                symbol_margin: Union[Numeric, str, None] = None,

                # 是否剪裁图形。
                # false/null/undefined:图形本身表示数值大小。
                # true:图形被剪裁后剩余的部分表示数值大小。
                # symbolClip 常在这种场景下使用:同时表达『总值』和『当前数值』。在这种场景下,可以使用两个系列,
                # 一个系列是完整的图形,当做『背景』来表达总数值,另一个系列是使用 symbolClip 进行剪裁过的图形,表达当前数值。
                is_symbol_clip: bool = False,

                # 是否选中图例
                is_selected: bool = True,

                # 使用的 x 轴的 index,在单个图表实例中存在多个 x 轴的时候有用。
                xaxis_index: Optional[Numeric] = None,

                # 使用的 y 轴的 index,在单个图表实例中存在多个 y 轴的时候有用。
                yaxis_index: Optional[Numeric] = None,

                # 系列 label 颜色
                color: Optional[str] = None,

                # 同一系列的柱间距离,默认为类目间距的 20%,可设固定值
                category_gap: Union[Numeric, str] = "20%",

                # 不同系列的柱间距离,为百分比(如 '30%',表示柱子宽度的 30%)。
                # 如果想要两个系列的柱子重叠,可以设置 gap 为 '-100%'。这在用柱子做背景的时候有用。
                gap: Optional[str] = None,

                # 标签配置项,参考 `series_options.LabelOpts`
                label_opts: Union[opts.LabelOpts, dict] = opts.LabelOpts(),

                # 标记点配置项,参考 `series_options.MarkPointOpts`
                markpoint_opts: Union[opts.MarkPointOpts, dict, None] = None,

                # 标记线配置项,参考 `series_options.MarkLineOpts`
                markline_opts: Union[opts.MarkLineOpts, dict, None] = None,

                # 提示框组件配置项,参考 `series_options.TooltipOpts`
                tooltip_opts: Union[opts.TooltipOpts, dict, None] = None,

                # 图元样式配置项,参考 `series_options.ItemStyleOpts`
                itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None,

                # 可以定义 data 的哪个维度被编码成什么。
                encode: types.Union[types.JsCode, dict] = None,
        },
    }
)

示例代码

https://bigquant.com/codeshare/5c96e655-9746-4301-92b8-e08c2d925aaa

\

{link}