如何在 Python 中查看带有 Bokeh 的 Holoviews 选项

Question

一直在使用全息视图来生成一些整洁的图。 当我使用 opts 时，我想看看我对hv.Curve类的东西有什么选择。 几乎没有文档。 全息视图的帮助页面没有帮助。 其中写着“对于完整的文档和可用的样式和 plot 选项，请使用hv.help(hv.Curve) 。” 但是它没有解释如何使用它。 我已经尝试将它作为我的代码的一部分运行。 我尝试在终端中运行该命令。 我试过print() ，并用help()运行。 我只想知道我可以在这里放什么： overlay.opts(legend_position='right')除了legend_position吗？ 这是我试图让hv.help(hv.Curve)命令工作的代码。 我知道这很荒谬：

#!/usr/bin/env python3

import holoviews as hv
import numpy as np
import scipy.special
import pandas as pd
import bokeh
import pandas as pd
import numpy as np
import bokeh as bk
import plotly.graph_objects as go
import plotly.express as pex
import holoviews.plotting.bokeh
import numpy as np
import pandas as pd
from holoviews import *
from holoviews import Store
from bokeh.plotting import show
from holoviews import opts
from holoviews import Store
from holoviews import dim, opts

hv.help(hv.Curve)

这是我收到的错误消息：

        backend_registry = cls.store.registry.get(backend, {})
AttributeError: 'NoneType' object has no attribute 'registry'

感谢您的帮助，如果我可以提供更多信息，请告诉我，因为这是我在该网站上的第一篇文章。

Answer 1

这里涉及到几个问题。 首先，HoloViews 中的选项取决于您选择的绘图库后端，例如散景、matplotlib 或 plotly。 在您的代码清单中，您尚未加载绘图库后端，因此您将无法获得有关绘图选项（如legend_position ）的任何帮助。 当然，您不应该收到像您看到的 AttributeError 这样的错误消息，所以如果您可以帮助我们复制该虚假消息，请在https://github.com/holoviz/holoviews/issues提交问题。 在未加载绘图后端的情况下运行hv.help(hv.Curve)时，我没有看到任何错误消息； 相反，我得到了 Sander 报告的内容，这是与绘图无关的选项的简短列表，并且无论后端如何都应该始终可用：

$ python
>>> import holoviews as hv
>>> hv.help(hv.Curve)
Parameters of 'Curve'
=====================

Parameters changed from their default values are marked in red.
Soft bound values are marked in cyan.
C/V= Constant/Variable, RO/RW = ReadOnly/ReadWrite, AN=Allow None

Name                        Value                     Type     Bounds   Mode 

cdims                   OrderedDict()                 Dict              V RW 
datatype   ['dataframe', 'dictionary', 'grid', '...   List   (0, None)  V RW 
extents            (None, None, None, None)          Tuple              V RW 
group                      'Curve'                   String             C RW 
kdims                  [Dimension('x')]               List     (1, 2)   V RW 
label                         ''                     String             C RW 
vdims                  [Dimension('y')]               List   (1, None)  V RW 

Parameter docstrings:
=====================

cdims:    The constant dimensions defined as a dictionary of Dimension:value
          pairs providing additional dimension information about the object.
...          
vdims:    The value dimensions of the Chart, usually corresponding to a
          number of dependent variables.

如您所见，在这种情况下，这 7 个选项都没有帮助。 如果您加载绘图后端，您将获得更多选择：

>>> hv.extension("bokeh")
>>> hv.help(hv.Curve)
Curve

Online example: http://holoviews.org/reference/elements/bokeh/Curve.html

-------------
Style Options
-------------

    alpha, color, hover_alpha, hover_color, hover_line_alpha, hover_line_color, line_alpha, line_cap, line_color, line_dash, line_join, line_width, muted, muted_alpha, muted_color, muted_line_alpha, muted_line_color, nonselection_alpha, nonselection_color, nonselection_line_alpha, nonselection_line_color, selection_alpha, selection_color, selection_line_alpha, selection_line_color, visible

(Consult bokeh's documentation for more information.)

------------
Plot Options
------------

The plot options are the parameters of the plotting class:

Parameters of 'CurvePlot'
=========================

Parameters changed from their default values are marked in red.
Soft bound values are marked in cyan.
C/V= Constant/Variable, RO/RW = ReadOnly/ReadWrite, AN=Allow None

Name                                 Value                         Type         Bounds     Mode  

active_tools                           []                          List       (0, None)    V RW  
... 57 other options...
zlim                               (nan, nan)                     Tuple                    V RW  

Parameter docstrings:
=====================

active_tools:      Allows specifying which tools are active by default. Note
                   that only one tool per gesture type can be active, e.g.
                   both 'pan' and 'box_zoom' are drag tools, so if both are
                   listed only the last one will be active.
... 57 other options...
zlim:              User-specified z-axis range limits for the plot, as a tuple (low,high).
                   If specified, takes precedence over data and dimension ranges.

这里只列出了“样式”选项，没有记录，因为它们直接传递到底层绘图库，因此不能在这里记录； 在这种情况下，请参阅散景。 其他选项有文档字符串，因为它们是由 HoloViews 实现的。

即便如此，如果您查看 output，您会注意到legend_position实际上不在这两个列表中。 这是因为legend_position不是hv.Curve的选项，而是hv.Overlay的选项，它是可覆盖事物（曲线和许多其他对象）的通用容器。 所以你需要在 Overlay class 上做hv.help ：

>>> hv.help(hv.Overlay)
Overlay

Online example: http://holoviews.org/reference/containers/bokeh/Overlay.html

-------------
Style Options
-------------

    background_fill_alpha, background_fill_color, border_alpha, border_color, border_hover_alpha, border_hover_color, border_hover_line_alpha, border_hover_line_color, border_line_alpha, border_line_cap, border_line_color, border_line_dash, border_line_join, border_line_width, border_muted_alpha, border_muted_color, border_muted_line_alpha, border_muted_line_color, border_nonselection_alpha, border_nonselection_color, border_nonselection_line_alpha, border_nonselection_line_color, border_selection_alpha, border_selection_color, border_selection_line_alpha, border_selection_line_color, click_policy, glyph_height, glyph_width, label_height, label_standoff, label_width, legend_padding, legend_spacing, text_align, text_alpha, text_baseline, text_color, text_font, text_font_size, text_font_style

(Consult bokeh's documentation for more information.)

------------
Plot Options
------------

The plot options are the parameters of the plotting class:

Parameters of 'OverlayPlot'
===========================

Parameters changed from their default values are marked in red.
Soft bound values are marked in cyan.
C/V= Constant/Variable, RO/RW = ReadOnly/ReadWrite, AN=Allow None

Name                                 Value                         Type         Bounds     Mode  

active_tools                           []                          List       (0, None)    V RW  
...66 more options...
zlim                               (nan, nan)                     Tuple                    V RW  

Parameter docstrings:
=====================

active_tools:      Allows specifying which tools are active by default.
...
legend_position:   Allows selecting between a number of predefined legend position
                   options. The predefined options may be customized in the
                   legend_specs class attribute.
...

所以你可以看到legend_position是一个选项，但毕竟它仍然没有告诉你什么是允许的。 令人沮丧的是，在许多情况下，您可以在 Jupyter 中键入它的一部分并调用选项卡完成，但在这种情况下使用字符串参数。 你最好的选择就是提供一个不正确的值，如果你在 Jupyter 中这样做：你会得到一个允许选项的列表：

>>> hv.Overlay().opts(hv.opts.Overlay(legend_position='aslkjf'))
ValueError: aslkjf not in Parameter legend_position's list of possible objects, valid options include [top_right, top_left, bottom_left, bottom_right, right, left, top, bottom]

信息很多，但很难找到！

Answer 2

对于.opts()及其使用的一个很好的概述，我认为这个页面是最好的：
http://holoviews.org/user_guide/Customizing_Plots.html

如果我仔细看，至少有以下通用 plot 选项：

• .opts(title="Custom Title")
• .opts(bgcolor='lightgray')
• .opts(fontsize={'title': 16, 'labels': 14, 'xticks': 6, 'yticks': 12})
• .opts(fontscale=2.)
• .opts(legend_position='bottom_right', legend_offset=(0, 200))
• .opts(width=500, height=400)
• .opts(legend_muted=True, legend_cols=2)
• .opts(hooks=[hook]) （plot 的自定义更改，请参阅页面上的文档）
• .opts(logx=True, logy=True)
• .opts(shared_axes=False) （给多个图相同的共享 x 轴或 y 轴）
• .opts(invert_axes=True) （x 轴变为 y 轴，反之亦然）
• .opts(labelled=[]) （x 或 y 轴上没有标签）
• .opts(xlabel='Custom x-label')
• .opts(padding=0.1)在 plot 中添加额外的空间（=padding）
• .opts(xlim=(-10, 110), ylim=(-14, 6))改变x范围和y范围
• .opts(xticks=10)或.opts(xticks=[0, 50, 100])
• .opts(xticks=[(0, 'zero'), (50, 'fifty'), (100, 'one hundred')])
• .opts(yformatter='$%.2f')为您的轴添加特殊格式化程序
• .opts(xrotation=45)旋转刻度标签

一些选项更特定于 plot，例如散点图 plot 的设置，但对于那些可能最好检查特定 plot 的页面：

(errorbars * overlay * curve).opts(
    opts.ErrorBars(line_width=5), 
    opts.Scatter(jitter=0.2, alpha=0.5, size=6, height=400, width=600)
)

要回答您的原始问题：

你有哪个版本的 HoloViews？
我有 1.13.5，这就是我在 Jupyter 笔记本中看到的，当我这样做时： hv.help(hv.Curve) ，但这些是 arguments 您可以在hv.Curve()中执行的操作。 我认为它们对您的问题没有太大帮助：