未验证 提交 f0de5996 编写于 作者: 走神的阿圆's avatar 走神的阿圆 提交者: GitHub

adjust index of document (#849)

* add index for LogReader
上级 ae592bda
......@@ -38,6 +38,8 @@ VisualDL原生支持python的使用, 通过在模型的Python配置中添加
* [开源贡献](#开源贡献)
* [常见问题](#常见问题)
* [更多细节](#更多细节)
## **[HOT]活动公告**
......@@ -214,6 +216,43 @@ app.run(logdir="./log")
<img src="https://user-images.githubusercontent.com/48054808/82786044-67ae9880-9e96-11ea-8a2b-3a0951a6ec19.png" width="60%"/>
</p>
### 3. 使用LogReader获取日志中的数据
VisualDL的后端也提供了获取日志数据的组件`LogReader`,可通过其获取日志中任意数据,接口如下:
```python
class LogReader(logdir=None,
file_name='')
```
#### 接口参数
| 参数 | 格式 | 含义 |
| --------------- | ------- | ------------------------------------------------------------ |
| logdir | string | 日志文件所在的路径,必填|
| file_name | string | 指定要读的日志文件名,必填|
#### 示例
假定在`./log`文件夹下有一个日志文件`vdlrecords.1605533348.log`,则获取此日志中tag为`loss`的scalar数据过程如下:
```python
from visualdl import LogReader
reader = LogReader(logdir='./log', file_name='vdlrecords.1605533348.log')
data = reader.get_data('scalar', 'loss')
print(data)
```
结果为列表形式,如下
```python
...
id: 5
tag: "Metrics/Training(Step): loss"
timestamp: 1605533356039
value: 3.1297709941864014
...
```
关于LogReader的更多具体用法,可参考[LogReader](./docs/io/LogReader.md)
## 可视化功能概览
......@@ -300,6 +339,9 @@ VisualDL可视化结果保存服务,以链接形式将可视化结果保存下
<img src="https://user-images.githubusercontent.com/48054808/93729521-72382f00-fbf7-11ea-91ff-6b6ab4b41e32.png" width="85%"/>
</p>
## 常见问题
在使用VisualDL的过程中可能遇到的一些问题,可参考[常见问题](./docs/faq.md)帮助解决
## 开源贡献
VisualDL 是由 [PaddlePaddle](https://www.paddlepaddle.org/)[ECharts](https://echarts.apache.org/) 合作推出的开源项目。
......
......@@ -768,61 +768,3 @@ visualdl service upload --logdir ./log \
<p align="center">
<img src="https://user-images.githubusercontent.com/48054808/93733790-69e8ef80-fc09-11ea-9256-68a88072f5d2.png" width="100%"/>
</p>
## LogReader
### 简介
VisualDL可通过LogReader获取保存的日志中所有数据,帮助用户进行更详细的分析工作。
### 使用方式
### 1. 获取LogReader实例
LogReader的初始化接口如下:
```python
class LogReader(logdir=None,
file_name='')
```
#### 接口参数
| 参数 | 格式 | 含义 |
| --------------- | ------- | ------------------------------------------------------------ |
| logdir | string | 日志文件所在的路径,必填|
| file_name | string | 指定要读的日志文件名,必填|
#### 示例
假定在`./log`文件夹下有一个日志文件`vdlrecords.1605533348.log`,则获取LogReader实例如下:
```python
from visualdl import LogReader
reader = LogReader(logdir='./log', file_name='vdlrecords.1605533348.log')
```
### 2. 获取所有数据的tag信息
通过接口`tags()`可获取LogReader实例对应日志中的所有数据tag信息,如下:
```python
tags = reader.tags()
```
结果如下,格式为`${file_name}/${tag}:${component_name}`
```python
{'vdlrecords.1605533348.log/meta_data_tag': 'meta_data', 'vdlrecords.1605533348.log/Metrics%Training(Step): loss': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): acc1': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): acc5': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): lr': 'scalar', 'vdlrecords.1605533348.log/Metrics%Eval(Epoch): acc1': 'scalar', 'vdlrecords.1605533348.log/Metrics%Eval(Epoch): acc5': 'scalar'}
```
### 3. 获取某tag对应的数据
通过接口`get_data(component, tag)`可获取某组件某tag对应的所有数据,例如:
```python
# 获取scalar组件tag为`Metrics%Training(Step): loss`的数据
data = reader.get_data('scalar', 'Metrics%Training(Step): loss')
```
结果为列表形式,如下
```python
...
id: 5
tag: "Metrics/Training(Step): loss"
timestamp: 1605533356039
value: 3.1297709941864014
...
```
\ No newline at end of file
# LogReader
## 简介
VisualDL可通过LogReader获取保存的日志中所有数据,帮助用户进行更详细的分析工作。
## 使用方式
### 1. 获取LogReader实例
LogReader的初始化接口如下:
```python
class LogReader(logdir=None,
file_name='')
```
#### 接口参数
| 参数 | 格式 | 含义 |
| --------------- | ------- | ------------------------------------------------------------ |
| logdir | string | 日志文件所在的路径,必填|
| file_name | string | 指定要读的日志文件名,必填|
#### 示例
假定在`./log`文件夹下有一个日志文件`vdlrecords.1605533348.log`,则获取LogReader实例如下:
```python
from visualdl import LogReader
reader = LogReader(logdir='./log', file_name='vdlrecords.1605533348.log')
```
### 2. 获取所有数据的tag信息
通过接口`tags()`可获取LogReader实例对应日志中的所有数据tag信息,如下:
```python
tags = reader.tags()
```
结果如下,格式为`${file_name}/${tag}:${component_name}`
```python
{'vdlrecords.1605533348.log/meta_data_tag': 'meta_data', 'vdlrecords.1605533348.log/Metrics%Training(Step): loss': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): acc1': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): acc5': 'scalar', 'vdlrecords.1605533348.log/Metrics%Training(Step): lr': 'scalar', 'vdlrecords.1605533348.log/Metrics%Eval(Epoch): acc1': 'scalar', 'vdlrecords.1605533348.log/Metrics%Eval(Epoch): acc5': 'scalar'}
```
### 3. 获取某tag对应的数据
通过接口`get_data(component, tag)`可获取某组件某tag对应的所有数据,例如:
```python
# 获取scalar组件tag为`Metrics%Training(Step): loss`的数据
data = reader.get_data('scalar', 'Metrics%Training(Step): loss')
```
结果为列表形式,如下
```python
...
id: 5
tag: "Metrics/Training(Step): loss"
timestamp: 1605533356039
value: 3.1297709941864014
...
```
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册