clearml-docs/docs/guides/reporting/3d_plots_reporting.md

title
3D Plots Reporting

The 3d_plots_reporting.py example demonstrates reporting a series as a surface plot and as a 3D scatter plot.

When the script runs, it creates an experiment named 3D plot reporting in the examples project.

ClearML reports these plots in the experiment's PLOTS tab.

Surface Plot

To plot a series as a surface plot, use the Logger.report_surface method.

# report 3d surface
surface = np.random.randint(10, size=(10, 10))
Logger.current_logger().report_surface(
    "example_surface",
    "series1",
    iteration=iteration,
    matrix=surface,
    xaxis="title X",
    yaxis="title Y",
    zaxis="title Z",
)

View the reported surface plot in PLOTS.

3D Scatter Plot

To plot a series as a 3D scatter plot, use the Logger.report_scatter3d method.

# report 3d scatter plot
scatter3d = np.random.randint(10, size=(10, 3))
Logger.current_logger().report_scatter3d(
    "example_scatter_3d",
    "series_xyz",
    iteration=iteration,
    scatter=scatter3d,
    xaxis="title x",
    yaxis="title y",
    zaxis="title z",
)

View the reported 3D scatter plot in PLOTS.