日志记录器
class Logger()
Logger
类是 ClearML 控制台日志和指标统计接口,包含用于显式报告的方法。
显式报告扩展了ClearML自动捕获输入和输出的功能。显式报告方法包括标量图、线图、直方图、混淆矩阵、2D和3D散点图、文本日志、表格以及图像上传和报告。
在ClearML Web-App(UI)中,Logger
输出会显示在CONSOLE、SCALARS、PLOTS和DEBUG SAMPLES标签页中。当你比较实验时,Logger
输出会出现在比较结果中。
不要直接构造Logger对象。
在调用任何其他Logger
类方法之前,您必须通过调用Task.get_logger
或Logger.current_logger
来获取一个Logger对象。
不要手动构造Logger! 请使用Logger.get_current
Logger.current_logger
classmethod current_logger()
获取主执行任务的Logger对象,即当前正在运行的任务(如果存在)。如果没有Logger对象存在,此方法将创建一个并返回它。因此,您可以在代码的任何地方调用此方法。
logger = Logger.current_logger()
-
返回类型
Logger
-
返回
当前运行任务的Logger对象(单例)。
报告文本
**report_text(msg, level=20, print_console=True, *args, _)
对于显式报告,将文本打印到日志中。可选地,打印日志级别并打印到控制台。
例如:
logger.report_text('log some text', level=logging.DEBUG, print_console=False)
您可以在ClearML Web-App (UI)的RESULTS标签下的CONSOLE子标签中查看报告的文本。
-
参数
-
msg (str ) – 要记录的文本。
-
level (int ) – 来自 Python
logging
包的日志级别。默认值为logging.INFO
。 -
print_console (bool ) – 除了日志外,还打印到控制台。
值为:
-
True
- 打印到控制台。(默认) -
False
- 不要打印到控制台。
-
-
args (任意 ) –
-
_ (任意 ) –
-
-
返回类型
None
report_scalar
report_scalar(title, series, value, iteration)
为了明确报告,绘制一个标量系列。
例如,绘制一个标量系列:
logger = Logger.current_logger()
scalar_series = [random.randint(0,10) for i in range(10)]
for iteration in range(10):
logger.report_scalar(
title='scalar metrics', series='series', value=scalar_series[iteration], iteration=iteration
)
您可以在ClearML Web-App (UI)的RESULTS标签页中的SCALARS子标签页查看标量图。
-
参数
-
title (str ) – 图表的标题(指标)。通过每次调用此方法时使用相同的
title
,可以在同一图表上绘制多个标量系列。 -
series (str ) – 报告标量的系列名称(变体)。
-
value (float ) – 每次迭代要绘制的值。
-
iteration (int ) – 报告的迭代/步骤(报告时间序列的x轴)
-
-
返回类型
None
report_single_value
report_single_value(name, value)
报告单个值指标(例如,总实验准确率或mAP) 您可以在ClearML Web-App (UI)的RESULTS标签页中的SCALARS子标签页查看这些指标。
-
参数
-
name (
str
) – 指标的名称 -
value (
float
) – 指标的数值
-
-
返回类型
None
报告向量
report_vector(标题, 系列, 值, 迭代=None, 标签=None, x轴标签=None, x轴=None, y轴=None, 模式=None, 额外布局=None)
对于显式报告,将向量绘制为(默认堆叠)直方图。
此方法与 Logger.report_histogram 相同。 此方法已弃用,请改用 Logger.report_histogram。
例如:
vector_series = np.random.randint(10, size=10).reshape(2,5)
logger.report_vector(title='vector example', series='vector series', values=vector_series, iteration=0,
labels=['A','B'], xaxis='X axis label', yaxis='Y axis label')
您可以在ClearML Web-App (UI)的RESULTS标签下的PLOTS子标签中查看向量图。
-
参数
-
title – 图表的标题(指标)。
-
series – 报告的直方图的系列名称(变体)。
-
values – 系列值。一个浮点数列表,或一个包含每个直方图条形数据的N维Numpy数组。
-
iteration – 报告的迭代/步骤。每个
iteration
都会创建另一个图表。 -
labels – 每个条形组的标签,用于创建图例,标注每个系列。(可选)
-
xlabels – 直方图中每个桶的每个条目的标签(向量),为x轴上的每个直方图条创建一组标签。(可选)
-
xaxis – x轴标题。(可选)
-
yaxis – y轴标题。(可选)
-
mode – 多直方图模式,堆叠 / 分组 / 相对。默认为‘group’。
-
extra_layout – 用于布局配置的可选字典,直接传递给plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/layout/ 示例:
extra_layout={'showlegend': False, 'plot_bgcolor': 'yellow'}
-
report_histogram
report_histogram(title, series, values, iteration=None, labels=None, xlabels=None, xaxis=None, yaxis=None, mode=None, data_args=None, extra_layout=None)
对于显式报告,绘制一个(默认分组的)直方图。 请注意,此函数不会计算直方图, 它假设直方图已经在值中计算完成。
例如:
vector_series = np.random.randint(10, size=10).reshape(2,5)
logger.report_histogram(title='histogram example', series='histogram series',
values=vector_series, iteration=0, labels=['A','B'], xaxis='X axis label', yaxis='Y axis label')
您可以在ClearML Web-App (UI)的RESULTS标签页中的PLOTS子标签页查看报告的直方图。
-
参数
-
title – 图表的标题(指标)。
-
series – 报告的直方图的系列名称(变体)。
-
values – 系列值。一个浮点数列表,或一个包含每个直方图条形数据的N维Numpy数组。
-
iteration – 报告的迭代/步骤。每个
iteration
都会创建另一个图表。 -
labels – 每个条形组的标签,用于创建图例,标注每个系列。(可选)
-
xlabels – 直方图中每个桶的每个条目的标签(向量),为x轴上的每个直方图条创建一组标签。(可选)
-
xaxis – x轴标题。(可选)
-
yaxis – y轴标题。(可选)
-
mode – 多直方图模式,堆叠 / 分组 / 相对。默认为‘分组’。
-
data_args – 可选的数据配置字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/bar/ 示例:
data_args={'orientation': 'h', 'marker': {'color': 'blue'}}
-
extra_layout – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/bar/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
报告表
report_table(title, series, iteration=None, table_plot=None, csv=None, url=None, extra_layout=None, extra_data=None)
对于显式报告,报告一个表格图。
必须提供以下参数中的一个且仅一个。
-
table_plot
- Pandas DataFrame 或作为行列表的表格(列表) -
csv
- CSV 文件 -
url
- CSV文件的URL
例如:
df = pd.DataFrame({'num_legs': [2, 4, 8, 0],
'num_wings': [2, 0, 0, 0],
'num_specimen_seen': [10, 2, 1, 8]},
index=['falcon', 'dog', 'spider', 'fish'])
logger.report_table(title='table example',series='pandas DataFrame',iteration=0,table_plot=df)
您可以在ClearML Web-App (UI)的RESULTS标签页中的PLOTS子标签页查看报告的表格。
-
参数
-
title – 表格的标题(指标)。
-
series – 报告表的系列名称(变体)。
-
iteration – 报告的迭代/步骤。
-
table_plot – 输出表格绘图对象
-
csv – 本地csv文件的路径
-
url – 指向csv文件位置的URL。
-
extra_layout – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/layout/ 例如:
logger.report_table(
title='table example',
series='pandas DataFrame',
iteration=0,
table_plot=df,
extra_layout={'height': 600}
)- extra_data – optional dictionary for data configuration, like column width, passed directly to plotly See full details on the supported configuration: https://plotly.com/javascript/reference/table/ For example:
logger.report_table(
title='table example',
series='pandas DataFrame',
iteration=0,
table_plot=df,
extra_data={'columnwidth': [2., 1., 1., 1.]}
) -
报告折线图
report_line_plot(title, series, xaxis, yaxis, mode='lines', iteration=None, reverse_xaxis=False, comment=None, extra_layout=None)
对于显式报告,将一个或多个系列绘制为线条。
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (list ) – 所有系列数据,每个列表元素对应图中的一条线。
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
mode (str ) – 线条图的类型。
值为:
-
lines
(默认) -
markers
-
lines+markers
-
-
reverse_xaxis (bool ) – 反转x轴。
值为:
-
True
- x轴从高到低(反转)。 -
False
- x轴从低到高(未反转)。(默认)
-
-
comment (str ) – 与图表一起显示的注释,位于标题下方。
-
extra_layout (dict ) – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/scatter/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
此方法与 Logger.report_scatter2d 相同,参数为 mode='lines'
。
此方法已弃用,请改用 Logger.report_scatter2d。
report_scatter2d
report_scatter2d(title, series, scatter, iteration=None, xaxis=None, yaxis=None, labels=None, mode='lines', comment=None, extra_layout=None)
对于显式报告,报告一个2D散点图。
例如:
scatter2d = np.hstack((np.atleast_2d(np.arange(0, 10)).T, np.random.randint(10, size=(10, 1))))
logger.report_scatter2d(title="example_scatter", series="series", iteration=0, scatter=scatter2d,
xaxis="title x", yaxis="title y")
通过将相同的title
和iteration
值传递给此方法,在同一图表上绘制多个2D散点系列:
scatter2d_1 = np.hstack((np.atleast_2d(np.arange(0, 10)).T, np.random.randint(10, size=(10, 1))))
logger.report_scatter2d(title="example_scatter", series="series_1", iteration=1, scatter=scatter2d_1,
xaxis="title x", yaxis="title y")
scatter2d_2 = np.hstack((np.atleast_2d(np.arange(0, 10)).T, np.random.randint(10, size=(10, 1))))
logger.report_scatter2d("example_scatter", "series_2", iteration=1, scatter=scatter2d_2,
xaxis="title x", yaxis="title y")
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告的散点图的系列名称(变体)。
-
scatter (list) – 散点数据。numpy.ndarray 或 (x,y) 对的列表:
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
labels (list ( str ) ) – 分配给
scatter
参数的数据中每个点的标签。标签的顺序必须与数据的顺序一致。 -
mode (str ) – 散点图的类型。可选值为:
-
lines
-
markers
-
lines+markers
-
-
comment (str ) – 与图表一起显示的注释,位于标题下方。
-
extra_layout (dict ) – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/scatter/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
report_scatter3d
report_scatter3d(title, series, scatter, iteration=None, xaxis=None, yaxis=None, zaxis=None, labels=None, mode='markers', fill=False, comment=None, extra_layout=None)
为了明确报告,绘制一个3D散点图(带有标记)。
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告的散点图的系列名称(变体)。
-
list **] ** scatter (Union [ numpy.ndarray , ) – 散点数据。 (x,y,z)对的列表,系列列表 [[(x1,y1,z1)…]],或 numpy.ndarray
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
zaxis (str ) – z轴标题。(可选)
-
labels (list ( str ) ) – 分配给
scatter
参数的数据中每个点的标签。标签的顺序必须与数据的顺序相同。 -
mode (str ) – 散点图的类型。值为:
lines
,markers
,lines+markers
。 例如:
scatter3d = np.random.randint(10, size=(10, 3))
logger.report_scatter3d(title="example_scatter_3d", series="series_xyz", iteration=1, scatter=scatter3d,
xaxis="title x", yaxis="title y", zaxis="title z")-
fill (bool ) – 填充曲线下的区域。值为:
-
True
- 填充 -
False
- 不填充(默认)
-
-
comment (str ) – 与图表一起显示的注释,位于标题下方。
-
extra_layout (dict ) – 可选的布局配置字典,直接传递给plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/scatter3d/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
报告混淆矩阵
report_confusion_matrix(title, series, matrix, iteration=None, xaxis=None, yaxis=None, xlabels=None, ylabels=None, yaxis_reversed=False, comment=None, extra_layout=None)
为了明确报告,绘制一个热图矩阵。
例如:
confusion = np.random.randint(10, size=(10, 10))
logger.report_confusion_matrix("example confusion matrix", "ignored", iteration=1, matrix=confusion,
xaxis="title X", yaxis="title Y")
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告的混淆矩阵的系列名称(变体)。
-
matrix (numpy.ndarray ) – 一个热图矩阵(例如:混淆矩阵)
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
xlabels (list ( str ) ) – 矩阵每列的标签。(可选)
-
ylabels (list ( str ) ) – 矩阵每行的标签。(可选)
-
yaxis_reversed (bool ) – 如果为 False,0,0 位于左下角。如果为 True,0,0 位于左上角
-
comment (str ) – 与图表一起显示的注释,位于标题下方。
-
extra_layout (dict ) – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/heatmap/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
报告矩阵
report_matrix(标题, 系列, 矩阵, 迭代=None, x轴=None, y轴=None, x标签=None, y标签=None, y轴反转=False, 额外布局=None)
为了明确报告,绘制一个混淆矩阵。
此方法与 Logger.report_confusion_matrix 相同。 此方法已弃用,请改用 Logger.report_confusion_matrix。
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告的混淆矩阵的系列名称(变体)。
-
matrix (numpy.ndarray ) – 一个热图矩阵(例如:混淆矩阵)
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
xlabels (list ( str ) ) – 矩阵每列的标签。(可选)
-
ylabels (list ( str ) ) – 矩阵每行的标签。(可选)
-
yaxis_reversed (bool ) – 如果为False,0,0位于左下角。如果为True,0,0位于左上角
-
extra_layout (dict ) – 用于布局配置的可选字典,直接传递给 plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/heatmap/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
报告表面
report_surface(title, series, matrix, iteration=None, xaxis=None, yaxis=None, zaxis=None, xlabels=None, ylabels=None, camera=None, comment=None, extra_layout=None)
对于显式报告,报告一个3D表面图。
此方法绘制与Logger.report_confusion_matrix相同的数据,但将数据呈现为表面图而非混淆矩阵。
surface_matrix = np.random.randint(10, size=(10, 10))
logger.report_surface("example surface", "series", iteration=0, matrix=surface_matrix,
xaxis="title X", yaxis="title Y", zaxis="title Z")
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告表面的系列名称(变体)。
-
matrix (numpy.ndarray ) – 一个热图矩阵(例如:混淆矩阵)
-
iteration (int ) – 报告的迭代/步骤。
-
xaxis (str ) – x轴标题。(可选)
-
yaxis (str ) – y轴标题。(可选)
-
zaxis (str ) – z轴标题。(可选)
-
xlabels (list ( str ) ) – 矩阵每列的标签。(可选)
-
ylabels (list ( str ) ) – 矩阵每行的标签。(可选)
-
camera (list ( float ) ) – 表示相机位置的X,Y,Z坐标。默认值为
(1,1,1)
。 -
comment (str ) – 与图表一起显示的注释,位于标题下方。
-
extra_layout (dict ) – 可选的布局配置字典,直接传递给plotly 查看支持的配置的完整详细信息:https://plotly.com/javascript/reference/surface/ 示例:
extra_layout={'xaxis': {'type': 'date', 'range': ['2020-01-01', '2020-01-31']}}
-
报告图像
report_image(title, series, iteration=None, local_path=None, image=None, matrix=None, max_image_history=None, delete_after_upload=False, url=None)
对于显式报告,报告一张图片并上传其内容。
此方法将图像上传到预配置的存储桶(参见Logger.set_default_upload_destination
),描述任务ID、标题、系列和迭代。
例如:
matrix = np.eye(256, 256, dtype=np.uint8)*255
matrix = np.concatenate((np.atleast_3d(matrix), np.zeros((256, 256, 2), dtype=np.uint8)), axis=2)
logger.report_image("test case", "image color red", iteration=1, image=m)
image_open = Image.open(os.path.join("<image_path>", "<image_filename>"))
logger.report_image("test case", "image PIL", iteration=1, image=image_open)
必须提供以下参数中的一个且仅一个。
-
local_path
-
url
-
image
-
matrix
-
参数
-
title – 图像的标题(指标)。
-
series – 报告图像的系列名称(变体)。
-
iteration – 报告的迭代/步骤。
-
local_path – 图像文件的路径。
-
url – 预上传图片位置的URL。
-
image – 图像数据(RGB)。
-
matrix – 已弃用,图像数据(RGB)。
info矩阵参数已被弃用。请使用图像参数。
-
max_image_history – 每个指标/变体组合存储的最大图像数量。 对于无限数量,请使用负值。默认值在全局配置中设置 (default=``5``)。
-
delete_after_upload – 上传后删除图像的本地副本。值为:
-
True
- 上传后删除。 -
False
- 上传后不删除。(默认)
-
-
报告媒体
report_media(title, series, iteration=None, local_path=None, stream=None, file_extension=None, max_history=None, delete_after_upload=False, url=None)
报告媒体上传其内容,包括图像、音频和视频。
媒体被上传到一个预先配置好的存储桶(参见setup_upload()),并使用一个键(文件名)来描述任务ID、标题、系列和迭代。
必须提供以下参数中的一个且仅一个
-
local_path
-
stream
-
url
如果你使用stream
作为BytesIO流来上传,必须提供file_extension
。
-
参数
-
title (str ) – 媒体的标题(指标)。
-
series (str) – 报告媒体的系列名称(变体)。
-
iteration (int ) – 报告的迭代/步骤。
-
local_path (str ) – 媒体文件的路径。
-
stream – 要上传的BytesIO流。如果提供了,则还必须提供
file_extension
。 -
url (str ) – 预上传媒体位置的URL。
-
file_extension – 当传递
stream
时使用的文件扩展名。 -
max_history (int ) – 每个指标/变体组合存储的最大媒体文件数。 使用负值表示无限制。默认值在全局配置中设置(默认=5)
-
delete_after_upload (bool ) – 文件上传后,删除本地副本
-
True
- 删除 -
False
- 不删除
-
-
report_plotly
report_plotly(title, series, figure, iteration=None)
直接报告一个Plotly
图表(绘图)
Plotly
图表可以是一个 plotly.graph_objs._figure.Figure
或由 plotly.js
定义的字典
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告图表的系列名称(变体)。
-
iteration (int ) – 报告的迭代/步骤。
-
figure (dict ) – 一个
plotly
图形对象或一个plotly
字典
-
报告_matplotlib_图表
report_matplotlib_figure(title, series, figure, iteration=None, report_image=False, report_interactive=True)
直接报告一个matplotlib
图形/绘图
matplotlib.figure.Figure
/ matplotlib.pyplot
-
参数
-
title (str ) – 图表的标题(指标)。
-
series (str ) – 报告图表的系列名称(变体)。
-
iteration (int ) – 报告的迭代/步骤。
-
figure (MatplotlibFigure ) – 一个
matplotlib
图形对象 -
report_image – 默认值为 False。如果为 True,图表将作为调试样本(png 图像)上传,并会出现在调试样本标签下(而不是图表标签下)。
-
report_interactive – 如果为True(默认),它将尝试将matplotlib转换为UI中的交互式图表。如果为False,matplotlib将按原样保存,并且将是非交互式的(除了缩放功能)。
-
设置默认上传目标
set_default_upload_destination(uri)
设置目标存储URI(例如,S3、Google Cloud Storage、文件路径)以上传调试图像。
图片是单独上传的。每个图片的链接都会被报告。
目标存储的凭证在ClearML配置文件中指定,~/clearml.conf。
-
参数
uri (str ) – 示例: ‘s3://bucket/directory/’ 或 ‘file:///tmp/debug/’
-
返回类型
None
-
返回
如果目标方案被支持(例如,
s3://
、file://
或gs://
),则为 True。 如果不支持,则为 False。
获取默认上传目的地
get_default_upload_destination()
获取用于上传调试图像的目标存储URI(例如,S3、Google Cloud Storage、文件路径)
(参见Logger.set_default_upload_destination
)。
-
返回类型
str
-
返回
默认的上传目标URI。
例如:
s3://bucket/directory/
,或file:///tmp/debug/
。
刷新
flush(wait=False)
将缓存的报告和控制台输出刷新到后端。
-
参数
wait (
bool
) – 等待所有未完成的上传和事件发送完成(默认 False) -
返回类型
bool
-
返回
如果成功刷新缓存,则为True。如果失败,则为False。
get_flush_period
get_flush_period()
获取Logger的刷新周期。
-
返回类型
Optional
[float
] -
返回
日志刷新周期(以秒为单位)。
set_flush_period
set_flush_period(period)
设置日志刷新周期。
已弃用 - 使用 sdk.development.worker.report_period_sec
从外部控制刷新周期。
-
参数
period (float ) – 日志记录器刷新的周期,以秒为单位。要设置不进行定期刷新,请指定
None
或0
。 -
返回类型
None
设置默认调试样本历史
设置默认调试样本历史记录(max_history)
设置报告媒体/调试样本时的默认最大调试样本历史记录。 覆盖配置文件的默认设置。 当报告具有相同标题/系列组合和运行迭代的调试样本时, 仅存储最后X个样本(换句话说,样本会被覆盖)。 在调用report_image、report_media等时,如果没有指定max_history,则使用max_history设置的默认历史记录大小。
-
参数
max_history (
int
) – 存储在不同迭代计数器报告的标题/系列的唯一集合上的样本(文件)数量。这用于确保用户不会在服务器存储端耗尽存储空间。例如,以下代码示例将存储最后5张图像,尽管我们报告了100个样本。
logger.set_default_debug_sample_history(5)
for i in range(100):
logger.report_image(title='image', series='sample', iteration=i, ...) -
返回类型
None
-
返回
获取默认调试样本历史
get_default_debug_sample_history()
返回报告媒体/调试样本时的默认最大调试样本历史记录。 如果未特别设置值,则函数返回配置文件的默认值。
-
返回类型
int
-
返回
默认的样本(文件)数量,用于存储在一组独特的标题/系列上报告的不同迭代计数器。这是为了确保用户不会在服务器存储端爆炸存储。
报告图片并上传
report_image_and_upload(title, series, iteration=None, path=None, matrix=None, max_image_history=None, delete_after_upload=False)
已弃用: 自版本0.13.0起已弃用:请使用Logger.report_image
代替
捕获日志
capture_logging()
返回捕获上下文中所有日志(通过日志记录)的上下文
-
返回类型
ForwardRef
-
返回
一个上下文管理器
Logger.tensorboard_auto_group_scalars
classmethod tensorboard_auto_group_scalars(group_scalars=False)
将没有标题的TensorBoard标量分组在一起,或者使用相同的标签分配标题/系列。
-
参数
group_scalars (
bool
) – 将没有标题的TensorBoard标量分组值为:
-
True
- 没有特定标题的标量会被分组在“标量”图中,保持与ClearML自动行为的向后兼容性。 -
False
- 没有标题的TensorBoard标量会获得与标签相同的标题/系列。(默认)
-
-
返回类型
None
Logger.tensorboard_single_series_per_graph
classmethod tensorboard_single_series_per_graph(single_series=False)
已弃用,现在从UI控制! 将TensorBoard标量系列分组在一起或分开绘制。
-
参数
single_series (
bool
) – 将 TensorBoard 标量系列分组在一起值为:
-
True
- 为每个TensorBoard标量系列生成单独的图表。 -
False
- 将TensorBoard标量系列在同一图表中分组。(默认)
-
-
返回类型
None
Logger.matplotlib_force_report_non_interactive
classmethod matplotlib_force_report_non_interactive(force)
如果为True,所有matplotlib图表将始终转换为非交互式静态图表(图像),显示在Plots部分下。如果为False(默认值),matplotlib图表将转换为交互式web UI plotly图表,如果图表转换失败,则默认为非交互式图表。
-
参数
force (
bool
) – 如果为True,所有matplotlib图形将自动转换为非交互式图表。 -
返回类型
None
Logger.set_reporting_nan_value
classmethod set_reporting_nan_value(value, warn_period=1000)
当遇到NaN值时,它会被报告为一个浮点值(默认为0),并且用户会收到警告。 此函数用于更改NaN转换的值以及警告周期。
-
参数
-
value (
float
) – NaN 被转换成的值 -
warn_period (
int
) – 遇到NaN并转换的次数,直到下一次警告
-
-
返回类型
None
Logger.set_reporting_inf_value
classmethod set_reporting_inf_value(value, warn_period=1000)
当遇到inf值时,它会被报告为一个浮点值(默认为0),并且用户会收到警告。 此函数用于更改inf转换的值以及警告周期。
-
参数
-
value (
float
) – 值 inf 被转换为 -
warn_period (
int
) – 遇到并转换 inf 的次数,直到下一次警告
-
-
返回类型
None