PyTorch数据可视化工具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，在该模式下，所有请求都记录到文件而不是服务器上。需要设置”log_to_filename”。在离线模式下，所有不创建或更新绘图的visdom命令都将简单地返回True。(默认值:”False”)

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

基本功能

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

绘图

• 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:网格图

通用图

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.delete_env:通过env_id删除环境
• vis.win_exists:通过ID检查窗口是否已存在
• vis.get_env_list:获取服务器上所有环境的列表
• vis.win_hash:获取窗口内容的md5哈希值
• vis.get_window_data:获取窗口的当前数据
• vis.check_connection:检查服务器是否已连接
• vis.replay_log:从提供的日志文件中重播操作

细节

基础内容

vis.image

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

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

vis.images

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

支持以下参数和opts:

• nrow:连续的图像数量

• padding:在图片周围填充，在所有4条边均等填充

• opts.jpgquality:JPG的质量(number 0-100)。如果已定义，图像将另存为JPG以减小文件大小。如果未定义，图像将另存为PNG。

• opts.caption:图片的标题

vis.text

vis.properties

    properties = [
        {'type': 'text', 'name': 'Text input', 'value': 'initial'},
        {'type': 'number', 'name': 'Number input', 'value': '12'},
        {'type': 'button', 'name': 'Button', 'value': 'Start'},
        {'type': 'checkbox', 'name': 'Checkbox', 'value': True},
        {'type': 'select', 'name': 'Select', 'value': 1, 'values': ['Red', 'Green', 'Blue']},
    ]

• text:字串
• number:十进制数字
• button:标有”值”的按钮
• checkbox:布尔值呈现为复选框
• select:多个值选择框
• `value`:所选值的ID(从零开始)
• `values`:可能值的列表

• event_type:"PropertyUpdate"
• propertyId:在properties列表中的位置
• value:新值

vis.audio

• opts.sample_frequency:采样频率(integer> 0;默认= 44100)

vis.video

• opts.fps:视频的FPS(integer> 0;默认= 25)

vis.svg

vis.matplot

注意:设置为”True”时，将使用窗格。你需要安装beautifulsoup4和lxml软件包。

注意:matplot的渲染后端与绘图中的绘图不同，效率较低。使用过多的Matplot窗口可能会降低视觉效果。

vis.plotlyplot

注意你必须安装”plotly”软件包才能使用此函数。通常可以通过运行”pip install plotly”来安装它。

vis.embeddings

• features:张量列表
• labels:为features提供的张量的相应标签列表
• data_getter = fn :(可选)一个函数，该函数将要素数组中的索引作为参数并返回张量的摘要表示。如果已设置，则还必须设置"data_type"。
• data_type = str :(可选)，当前唯一可接受的值是"html"

vis.save

绘图

vis.scatter

• opts.markersymbol:标记符号(string;默认='dot')
• opts.markersize:标记大小(number;默认='10')
• opts.markercolor:每个标记的颜色。(torch.* Tensor;默认=nil)
• opts.legend:table包含图例名称
• opts.textlabels:每个点的文本标签(list:默认 =None)
• opts.layoutopts:图形后端接受布局的任何其他选项的字典。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。
• opts.traceopts:字典将跟踪名称或索引映射到图形后端接受的其他选项的字典。例如traceopts = {'plotly':{'myTrace':{'mode':'markers'}}}。
• opts.webgl:使用WebGL进行绘图(“boolean”;默认=”false”)。如果绘图包含太多点，则速度更快。谨慎使用，因为浏览器在单个页面上最多允许两个WebGL上下文。

• 大小为N的张量:每个数据点的单个强度值。0=黑色，255=红色
• 大小为"Nx3"的张量:每个数据点的红色，绿色和蓝色强度。0,0,0=黑色，255,255,255=白色
• "K"和"Kx3"大小的张量:不是每个数据点都有唯一的颜色，而是为特定标签的所有点共享相同的颜色。

vis.line

• opts.fillarea:填充线以下的区域(boolean)
• opts.markers:显示标记(boolean;默认=false)
• opts.markersymbol:标记符号(string;默认='dot')
• opts.markersize:标记大小(number;默认='10')
• opts.linecolor:线条颜色(np.array;默认=None)
• opts.dash:每行的行破折号类型(np.array;默认=’solid’)，为solid，dash，dashdot或dash之一，大小应与画线
• opts.legend:table包含图例名称
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。
• opts.traceopts:dict将跟踪名称或索引映射到plot.ly接受的其他选项的dict。
• opts.webgl:使用WebGL进行绘图(“boolean”;默认=”false”)。如果绘图包含太多点，则速度更快。谨慎使用，因为浏览器在单个页面上最多允许两个WebGL上下文。

vis.stem

• opts.colormap:颜色图(string;默认='Viridis')
• opts.legend:table包含图例名称
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.heatmap

• opts.colormap:颜色图(string;默认='Viridis')
• opts.xmin:剪辑最小值(number;默认=X:min())
• opts.xmax:剪辑最大值(number;默认=X:max())
• opts.columnnames:table包含X轴标签
• opts.rownames:包含y轴标签的table
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。
• opts.nancolor:用于绘制NaNs的颜色。如果为"None"，则将"NaN"绘制为透明。(string;默认=None)

vis.bar

• opts.rownames:table包含x轴标签
• opts.stacked:在X中堆叠多列
• opts.legend:包含图例标签的table
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.histogram

• opts.numbins:箱数(number;默认=30)
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.boxplot

• opts.legend:X中每个列的标签
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.surf

• opts.colormap:颜色图(string;默认='Viridis')
• opts.xmin:剪辑最小值(number;默认=X:min())
• opts.xmax:剪辑最大值(number;默认=X:max())
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.contour

• opts.colormap:颜色图(string;默认='Viridis')
• opts.xmin:剪辑最小值(number;默认=X:min())
• opts.xmax:剪辑最大值(number;默认=X:max())
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

vis.quiver

• opts.normalize:最长箭头的长度(number)
• opts.arrowheads:显示箭头(boolean;默认=true)
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

可见网格

• opts.color:颜色(string)
• opts.opacity:多边形的不透明度(“number”介于0和1之间)
• opts.layoutopts:图形后端为布局接受的任何其他选项的dict。例如layoutopts = {'plotly':{'legend':{'x':0，'y':0}}}。

自定义图

• opts.title:图形标题
• opts.width:图形宽度
• opts.height:图形高度
• opts.showlegend:显示图例(“true”或”false”)
• opts.xtype:x轴的类型('linear'或'log')
• opts.xlabel:x轴的标签
• opts.xtick:在x轴上显示刻度(boolean)
• opts.xtickmin:x轴上的第一个刻度(number)
• opts.xtickmax:x轴上的最后一个刻度(number)
• opts.xtickvals:x轴上的刻度线位置(“number” s的”table”表)
• opts.xticklabels:勾选x轴上的标签(strings的table)
• opts.xtickstep:x轴刻度之间的距离(number)
• opts.xtickfont:x轴标签的字体(字体信息的字典(https://plot.ly/javascript/reference/#layout-font))
• opts.ytype:y轴的类型('linear'或'log')
• opts.ylabel:y轴的标签
• opts.ytick:在y轴上显示刻度(boolean)
• opts.ytickmin:y轴上的第一个刻度(number)
• opts.ytickmax:y轴上的最后一个刻度(number)
• opts.ytickvals:y轴上的刻度位置(number类型的s的table)
• opts.yticklabels:在y轴上打勾标签(string类型的s的table)
• opts.ytickstep:y轴上刻度线之间的距离(number)
• opts.ytickfont:y轴标签的字体(字体信息的字典(https://plot.ly/javascript/reference/#layout-font))
• opts.marginleft:左边距(以像素为单位)
• opts.marginright:右边距(以像素为单位)
• opts.margintop:上边距(以像素为单位)
• opts.marginbottom:底边距(以像素为单位)

其他

vis.close

vis.delete_env

注意:delete_env删除环境中的所有数据，并且是不可撤销的。除非绝对要删除环境，否则请勿使用。

vis.fork_env

• prev_eid:我们要fork的环境ID。
• eid:将用fork创建的新环境ID。

注意:fork_env如果不存在的env被fork，则会发生异常。

vis.win_exists

• env:搜索窗口的环境。默认为None。

vis.get_env_list

vis.win_hash

• env:搜索窗口的环境。默认为None。

vis.get_window_data

• env:搜索窗口的环境。
• win:要为其返回数据的窗口。设置为”无”以检索环境中的所有窗口。

vis.check_connection

vis.replay_log

• log_filename:重播日志文件的内容。

许可

关于Lua Torch支持的注意事项

贡献

致谢