Visdom 介绍 | 二

用于创建，组织和共享实时丰富数据可视化的灵活工具。支持Python。

• 概述
• 概念
• 设置
• 用法
• API
• 注意事项
• 贡献

API

要快速了解visdom的功能，请查看example目录，或阅读以下详细信息。

Visdom Arguments(仅限Python)

python visdom客户端有以下几种选择:

• server:visdom服务器的主机名(默认值:'http://localhost')
• port:visdom服务器的端口(默认值:8097)
• base_url:基本visdom服务器url(默认:/)
• env:没有提供env时要绘制的默认环境(默认是main)
• raise_exceptions:失败时引发异常，而不是打印它们(默认值:"True"(性能好))
• log_to_filename:如果不是全部，则将所有绘图和更新事件记录到给定文件中(附加模式)，以便以后可以使用replay_log来重放它们(默认值:"None")
• use_incoming_socket:启用套接字以从Web客户端接收事件，允许用户注册回调(默认值:"True")
• http_proxy_host:已弃用。使用Proxies参数可获得完整的代理支持。
• http_proxy_port:已弃用。使用Proxies参数可获得完整的代理支持。
• username:用于验证的用户名，如果服务器以-enable_login开头(默认值:None)
• password:用于验证的密码，如果服务器以-enable_login开头(默认:None)
• proxies:字典映射协议，用于在每个请求上使用的代理URL(例如{ http:foo.bar:3128})。(默认值:"无")
• offline:标记为在脱机模式下运行visdom，在该模式下，所有请求都记录到文件而不是服务器上。需要设置"logtofilename"。在离线模式下，所有不创建或更新绘图的visdom命令都将简单地返回True。(默认值:"False")

其他选项当前未使用(端点，ipv6)或用于内部功能。

基本功能

Visdom提供以下基本的可视化功能:

• vis.image:图片
• vis.images:图像列表
• vis.text:任意HTML
• vis.properties:属性网格
• vis.audio:音频
• vis.video:视频
• vis.svg:SVG对象
• vis.matplot:matplotlib图
• vis.save:序列化状态服务器端

绘图

我们包装了几种常见的绘图类型，以轻松创建基本的可视化效果。这些可视化由Plotly(https://plot.ly/)提供支持。

当前支持以下API:

• vis.scatter:2D或3D散点图
• vis.line:线图
• vis.stem:stem图
• vis.heatmap:热图
• vis.bar:条形图
• vis.histogram:直方图
• vis.boxplot:箱线图
• vis.surf:表面图
• vis.contour:等高线图
• vis.quiver:颤动图
• vis.mesh:网格图

通用图

请注意，服务器API遵循"数据"和"布局"对象的Plotly约定，因此你可以产生自己的任意"Plotly"可视化效果:

import visdom
vis = visdom.Visdom()

trace = dict(x=[1, 2, 3], y=[4, 5, 6], mode="markers lines", type='custom',
             marker={'color': 'red', 'symbol': 104, 'size': "10"},
             text=["one", "two", "three"], name='1st Trace')
layout = dict(title="First Plot", xaxis={'title': 'x1'}, yaxis={'title': 'x2'})

vis._send({'data': [trace], 'layout': layout, 'win': 'mywin'})

其他

• vis.close:按ID关闭窗口
• vis.deleteenv:通过envid删除环境
• vis.win_exists:通过ID检查窗口是否已存在
• vis.getenvlist:获取服务器上所有环境的列表
• vis.win_hash:获取窗口内容的md5哈希值
• vis.getwindowdata:获取窗口的当前数据
• vis.check_connection:检查服务器是否已连接
• vis.replay_log:从提供的日志文件中重播操作

细节

基础内容

vis.image

该函数绘制一个"img"。它以CxHxW张量的img作为输入

支持以下opts:

• jpgquality:JPG的质量(number 0-100)。如果已定义，图像将另存为JPG以减小文件大小。如果未定义，图像将另存为PNG。
• caption:图片的标题
• store_history:将所有图像存储在同一窗口中，并在底部附加一个滑块，使你可以选择要查看的图像。将新图像发送到具有历史记录的图像时，必须始终提供此选项。

注意你可以在图像窗格上使用alt查看光标的x/y坐标。你也可以按ctrl键滚动缩放，按住alt键滚动可以垂直平移，按住alt键滚动则可以水平平移。在窗格内双击以将图像恢复为默认值。

vis.images

此函数绘制"图像"列表。它需要一个输入"BxCxHxW"张量或一个"图像列表"，且大小均相同。它使图像的尺寸为(B/nrow，nrow)。

支持以下参数和opt