> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
  </a>;

<GitHubLink url="https://github.com/wandb/wandb-workspaces/blob/main/wandb_workspaces/reports/v2/internal.py" />

<Note>
  W\&B Report and Workspace API is in Public Preview.
</Note>

Python library for programmatically working with W\&B Reports API.

```python theme={null}
import wandb_workspaces.reports.v2 as wr

report = wr.Report(
     entity="entity",
     project="project",
     title="An amazing title",
     description="A descriptive description.",
)

blocks = [
     wr.PanelGrid(
         panels=[
             wr.LinePlot(x="time", y="velocity"),
             wr.ScatterPlot(x="time", y="acceleration"),
         ]
     )
]

report.blocks = blocks
report.save()
```

## <kbd>class</kbd> `BarPlot`

A panel object that shows a 2D bar plot.

**Attributes:**

* `title` (Optional\[str]):  The text that appears at the top of the plot.
* `metrics` (LList\[MetricType]):  orientation Literal\["v", "h"]: The orientation of the bar plot.  Set to either vertical ("v") or horizontal ("h"). Defaults to horizontal ("h").
* `range_x` (Tuple\[float | None, float | None]):  Tuple that specifies the range of the x-axis.
* `title_x` (Optional\[str]):  The label of the x-axis.
* `title_y` (Optional\[str]):  The label of the y-axis.
* `groupby` (Optional\[str]):  Group runs based on a metric logged to your W\&B project that the  report pulls information from.
* `groupby_aggfunc` (Optional\[GroupAgg]):  Aggregate runs with specified  function. Options include "mean", "min", "max", "median", "sum", "samples", or `None`.
* `groupby_rangefunc` (Optional\[GroupArea]):   Group runs based on a range. Options  include "minmax", "stddev", "stderr", "none", "samples", or `None`.
* `max_runs_to_show` (Optional\[int]):  The maximum number of runs to show on the plot.
* `max_bars_to_show` (Optional\[int]):  The maximum number of bars to show on the bar plot.
* `custom_expressions` (Optional\[LList\[str]]):  A list of custom expressions to be used in the bar plot.
* `legend_template` (Optional\[str]):  The template for the legend.
* `font_size` ( Optional\[FontSize]):  The size of the line plot's font.  Options include "small", "medium", "large", "auto", or `None`.
* `line_titles` (Optional\[dict]):  The titles of the lines. The keys are the line names and the values are the titles.
* `line_colors` (Optional\[dict]):  The colors of the lines. The keys are the line names and the values are the colors.
* `aggregate` (Optional\[bool]):  If set to `True`, aggregate the data.

***

## <kbd>class</kbd> `BlockQuote`

A block of quoted text.

**Attributes:**

* `text` (str):  The text of the block quote.

***

## <kbd>class</kbd> `CalloutBlock`

A block of callout text.

**Attributes:**

* `text` (str):  The callout text.

***

## <kbd>class</kbd> `CheckedList`

A list of items with checkboxes. Add one or more `CheckedListItem` within `CheckedList`.

**Attributes:**

* `items` (LList\[CheckedListItem]):  A list of one or more `CheckedListItem` objects.

***

## <kbd>class</kbd> `CheckedListItem`

A list item with a checkbox. Add one or more `CheckedListItem` within `CheckedList`.

**Attributes:**

* `text` (str):  The text of the list item.
* `checked` (bool):  Whether the checkbox is checked. By default, set to `False`.

***

## <kbd>class</kbd> `CodeBlock`

A block of code.

**Attributes:**

* `code` (str):  The code in the block.
* `language` (Optional\[Language]):  The language of the code. Language specified  is used for syntax highlighting. By default, set to "python". Options include  'javascript', 'python', 'css', 'json', 'html', 'markdown', 'yaml'.

***

## <kbd>class</kbd> `CodeComparer`

A panel object that compares the code between two different runs.

**Attributes:**

* `diff` (Literal\['split', 'unified']):  How to display code differences.  Options include "split" and "unified".

***

## <kbd>class</kbd> `Config`

Metrics logged to a run's config object. Config objects are commonly logged using `run.config[name] = ...` or passing a config as a dictionary of key-value pairs, where the key is the name of the metric and the value is the value of that metric.

**Attributes:**

* `name` (str):  The name of the metric.

***

## <kbd>class</kbd> `CustomChart`

A panel that shows a custom chart. The chart is defined by a weave query.

**Attributes:**

* `query` (dict):  The query that defines the custom chart. The key is the name of the field, and the value is the query.
* `chart_name` (str):  The title of the custom chart.
* `chart_fields` (dict):  Key-value pairs that define the axis of the  plot. Where the key is the label, and the value is the metric.
* `chart_strings` (dict):  Key-value pairs that define the strings in the chart.

***

### <kbd>classmethod</kbd> `from_table`

```python theme={null}
from_table(
    table_name: str,
    chart_fields: dict = None,
    chart_strings: dict = None
)
```

Create a custom chart from a table.

**Arguments:**

* `table_name` (str):  The name of the table.
* `chart_fields` (dict):  The fields to display in the chart.
* `chart_strings` (dict):  The strings to display in the chart.

***

## <kbd>class</kbd> `Gallery`

A block that renders a gallery of reports and URLs.

**Attributes:**

* `items` (List\[Union\[`GalleryReport`, `GalleryURL`]]):  A list of  `GalleryReport` and `GalleryURL` objects.

***

## <kbd>class</kbd> `GalleryReport`

A reference to a report in the gallery.

**Attributes:**

* `report_id` (str):  The ID of the report.

***

## <kbd>class</kbd> `GalleryURL`

A URL to an external resource.

**Attributes:**

* `url` (str):  The URL of the resource.
* `title` (Optional\[str]):  The title of the resource.
* `description` (Optional\[str]):  The description of the resource.
* `image_url` (Optional\[str]):  The URL of an image to display.

***

## <kbd>class</kbd> `GradientPoint`

A point in a gradient.

**Attributes:**

* `color`:  The color of the point.
* `offset`:  The position of the point in the gradient. The value should be between 0 and 100.

***

## <kbd>class</kbd> `H1`

An H1 heading with the text specified.

**Attributes:**

* `text` (str):  The text of the heading.
* `collapsed_blocks` (Optional\[LList\["BlockTypes"]]):  The blocks to show when the heading is collapsed.

***

## <kbd>class</kbd> `H2`

An H2 heading with the text specified.

**Attributes:**

* `text` (str):  The text of the heading.
* `collapsed_blocks` (Optional\[LList\["BlockTypes"]]):  One or more blocks to  show when the heading is collapsed.

***

## <kbd>class</kbd> `H3`

An H3 heading with the text specified.

**Attributes:**

* `text` (str):  The text of the heading.
* `collapsed_blocks` (Optional\[LList\["BlockTypes"]]):  One or more blocks to  show when the heading is collapsed.

***

## <kbd>class</kbd> `Heading`

***

## <kbd>class</kbd> `HorizontalRule`

HTML horizontal line.

***

## <kbd>class</kbd> `Image`

A block that renders an image.

**Attributes:**

* `url` (str):  The URL of the image.
* `caption` (str):  The caption of the image.  Caption appears underneath the image.

***

## <kbd>class</kbd> `InlineCode`

Inline code. Does not add newline character after code.

**Attributes:**

* `text` (str):  The code you want to appear in the report.

***

## <kbd>class</kbd> `InlineLatex`

Inline LaTeX markdown. Does not add newline character after the LaTeX markdown.

**Attributes:**

* `text` (str):  LaTeX markdown you want to appear in the report.

***

## <kbd>class</kbd> `LatexBlock`

A block of LaTeX text.

**Attributes:**

* `text` (str):  The LaTeX text.

***

## <kbd>class</kbd> `Layout`

The layout of a panel in a report. Adjusts the size and position of the panel.

**Attributes:**

* `x` (int):  The x position of the panel.
* `y` (int):  The y position of the panel.
* `w` (int):  The width of the panel.
* `h` (int):  The height of the panel.

***

## <kbd>class</kbd> `LinePlot`

A panel object with 2D line plots.

**Attributes:**

* `title` (Optional\[str]):  The text that appears at the top of the plot.
* `x` (Optional\[MetricType]):  The name of a metric logged to your W\&B project that the  report pulls information from. The metric specified is used for the x-axis.
* `y` (LList\[MetricType]):  One or more metrics logged to your W\&B project that the report pulls  information from. The metric specified is used for the y-axis.
* `range_x` (Tuple\[float | `None`, float | `None`]):  Tuple that specifies the range of the x-axis.
* `range_y` (Tuple\[float | `None`, float | `None`]):  Tuple that specifies the range of the y-axis.
* `log_x` (Optional\[bool]):  Plots the x-coordinates using a base-10 logarithmic scale.
* `log_y` (Optional\[bool]):  Plots the y-coordinates using a base-10 logarithmic scale.
* `title_x` (Optional\[str]):  The label of the x-axis.
* `title_y` (Optional\[str]):  The label of the y-axis.
* `ignore_outliers` (Optional\[bool]):  If set to `True`, do not plot outliers.
* `groupby` (Optional\[str]):  Group runs based on a metric logged to your W\&B project that the  report pulls information from.
* `groupby_aggfunc` (Optional\[GroupAgg]):  Aggregate runs with specified  function. Options include "mean", "min", "max", "median", "sum", "samples", or `None`.
* `groupby_rangefunc` (Optional\[GroupArea]):   Group runs based on a range. Options  include "minmax", "stddev", "stderr", "none", "samples", or `None`.
* `smoothing_factor` (Optional\[float]):  The smoothing factor to apply to the  smoothing type. Accepted values range between 0 and 1.
* `smoothing_type Optional[SmoothingType]`:  Apply a filter based on the specified  distribution. Options include "exponentialTimeWeighted", "exponential",  "gaussian", "average", or "none".
* `smoothing_show_original` (Optional\[bool]):    If set to `True`, show the original data.
* `max_runs_to_show` (Optional\[int]):  The maximum number of runs to show on the line plot.
* `custom_expressions` (Optional\[LList\[str]]):  Custom expressions to apply to the data.
* `plot_type Optional[LinePlotStyle]`:  The type of line plot to generate.  Options include "line", "stacked-area", or "pct-area".
* `font_size Optional[FontSize]`:  The size of the line plot's font.  Options include "small", "medium", "large", "auto", or `None`.
* `legend_position Optional[LegendPosition]`:  Where to place the legend.  Options include "north", "south", "east", "west", or `None`.
* `legend_template` (Optional\[str]):  The template for the legend.
* `aggregate` (Optional\[bool]):  If set to `True`, aggregate the data.
* `xaxis_expression` (Optional\[str]):  The expression for the x-axis.
* `xaxis_format` (Optional\[str]):  The format for the x-axis. This option  appears if you define a custom metric. For example,  you can specify 'datetime' to format the x-axis as a date and time.
* `legend_fields` (Optional\[LList\[str]]):  The fields to include in the legend.
* `metric_regex` (Optional\[str]):  Regular expression pattern to match y-axis metrics.  The backend will use this pattern to select matching metrics.
* `point_visualization_method` (Optional\[PointVizMethod]):  The method used to aggregate  points when there are too many to display. Options include "bucketing-gorilla" (buckets  data points and shows min, max, avg per bucket to preserve outliers and spikes) or  "sampling" (randomly samples points for faster rendering but may miss outliers).

***

## <kbd>class</kbd> `Link`

A link to a URL.

**Attributes:**

* `text` (Union\[str, TextWithInlineComments]):  The text of the link.
* `url` (str):  The URL the link points to.

***

## <kbd>class</kbd> `MarkdownBlock`

A block of markdown text. Useful if you want to write text that uses common markdown syntax.

**Attributes:**

* `text` (str):  The markdown text.

***

## <kbd>class</kbd> `MarkdownPanel`

A panel that renders markdown.

**Attributes:**

* `markdown` (str):  The text you want to appear in the markdown panel.

***

## <kbd>class</kbd> `MediaBrowser`

A panel that displays media files in a gallery or grid layout.

**Attributes:**

* `title` (Optional\[str]):  The title of the panel.
* `num_columns` (Optional\[int]):  The number of columns in the grid.
* `media_keys` (LList\[str]):  A list of media keys that correspond to the media files.
* `mode` (Optional\[Literal\["gallery", "grid"]]):  The display mode for the panel.  If not specified, will be inferred from the axes provided. Required if both  gallery\_axis and grid axes are specified.
* `gallery_axis` (Optional\[Literal\["step", "index", "run"]]):  The field to use for the axis in gallery mode.
* `grid_x_axis` (Optional\[Literal\["step", "index", "run"]]):  The field to use for the x-axis in grid mode.
* `grid_y_axis` (Optional\[Literal\["step", "index", "run"]]):  The field to use for the y-axis in grid mode.

***

## <kbd>class</kbd> `Metric`

A metric to display in a report that is logged in your project.

**Attributes:**

* `name` (str):  The name of the metric.

***

## <kbd>class</kbd> `OrderBy`

A metric to order by.

**Attributes:**

* `name` (str):  The name of the metric.
* `ascending` (bool):  Whether to sort in ascending order.  By default set to `False`.

***

## <kbd>class</kbd> `OrderedList`

A list of items in a numbered list.

**Attributes:**

* `items` (LList\[TextLikeField]):  A list of one or more `OrderedListItem` objects.  Each item can be a string or a list of TextLike objects.

***

## <kbd>class</kbd> `OrderedListItem`

A list item in an ordered list.

**Attributes:**

* `text` (str):  The text of the list item.

***

## <kbd>class</kbd> `P`

A paragraph of text.

**Attributes:**

* `text` (str):  The text of the paragraph.

***

## <kbd>class</kbd> `Panel`

A panel that displays a visualization in a panel grid.

**Attributes:**

* `layout` (Layout):  A `Layout` object.

***

## <kbd>class</kbd> `PanelGrid`

A grid that consists of runsets and panels. Add runsets and panels with `Runset` and `Panel` objects, respectively.

Available panels include: `LinePlot`, `ScatterPlot`, `BarPlot`, `ScalarChart`, `CodeComparer`, `ParallelCoordinatesPlot`, `ParameterImportancePlot`, `RunComparer`, `MediaBrowser`, `MarkdownPanel`, `CustomChart`, `WeavePanel`, `WeavePanelSummaryTable`, `WeavePanelArtifactVersionedFile`.

**Attributes:**

* `runsets` (LList\["Runset"]):  A list of one or more `Runset` objects.
* `hide_run_sets` (bool):  Whether to hide the run sets of the panel grid for report viewers.
* `panels` (LList\["PanelTypes"]):  A list of one or more `Panel` objects.
* `active_runset` (Optional\[int]):  The index of the active runset tab. By default, it is set to 0.
* `custom_run_colors` (dict):  Key-value pairs where the key is the name of a  run and the value is a color specified by a hexadecimal value.

***

## <kbd>class</kbd> `ParallelCoordinatesPlot`

A panel object that shows a parallel coordinates plot.

**Attributes:**

* `columns` (LList\[ParallelCoordinatesPlotColumn]):  A list of one  or more `ParallelCoordinatesPlotColumn` objects.
* `title` (Optional\[str]):  The text that appears at the top of the plot.
* `gradient` (Optional\[LList\[GradientPoint]]):  A list of gradient points.
* `font_size` (Optional\[FontSize]):  The size of the line plot's font.  Options include "small", "medium", "large", "auto", or `None`.

***

## <kbd>class</kbd> `ParallelCoordinatesPlotColumn`

A column within a parallel coordinates plot.  The order of `metric`s specified determine the order of the parallel axis (x-axis) in the parallel coordinates plot.

**Attributes:**

* `metric` (str | Config | SummaryMetric):  The name of the  metric logged to your W\&B project that the report pulls information from.
* `display_name` (Optional\[str]):  The name of the metric
* `inverted` (Optional\[bool]):  Whether to invert the metric.
* `log` (Optional\[bool]):  Whether to apply a log transformation to the metric.

***

## <kbd>class</kbd> `ParameterImportancePlot`

A panel that shows how important each hyperparameter is in predicting the chosen metric.

**Attributes:**

* `with_respect_to` (str):  The metric you want to compare the  parameter importance against. Common metrics might include the loss, accuracy,  and so forth. The metric you specify must be logged within the project  that the report pulls information from.

***

## <kbd>class</kbd> `Report`

An object that represents a W\&B Report. Use the returned object's `blocks` attribute to customize your report. Report objects do not automatically save. Use the `save()` method to persists changes.

**Attributes:**

* `project` (str):  The name of the W\&B project you want to load in.  The project specified appears in the report's URL.
* `entity` (str):  The W\&B entity that owns the report.  The entity appears in the report's URL.
* `title` (str):  The title of the report. The title  appears at the top of the report as an H1 heading.
* `description` (str):  A description of the report.  The description appears underneath the report's title.
* `blocks` (LList\[BlockTypes]):  A list of one or more HTML tags,  plots, grids, runsets, and more.
* `width` (Literal\['readable', 'fixed', 'fluid']):  The width of the report. Options include 'readable', 'fixed', 'fluid'.

***

### <kbd>property</kbd> url

The URL where the report is hosted. The report URL consists of `https://wandb.ai/{entity}/{project_name}/reports/`. Where `{entity}` and `{project_name}` consists of the entity that the report belongs to and the name of the project, respectively.

***

### <kbd>method</kbd> `delete`

```python theme={null}
delete() → bool
```

Delete this report from W\&B.

This will also delete any draft views that reference this report.

**Returns:**

* `bool`:  `True` if the delete operation was acknowledged as successful by the backend, `False` otherwise.

***

### <kbd>method</kbd> `disable_share_link`

```python theme={null}
disable_share_link() → bool
```

Disable the "anyone with link can view" share link for this report.

Revokes all active public access tokens for the report.

**Returns:**

* `bool`:  True if link(s) were revoked, False if no active link existed.

***

### <kbd>method</kbd> `enable_share_link`

```python theme={null}
enable_share_link() → str
```

Enable "anyone with link can view" sharing for this report.

Creates a public access token for the report. If a share link already exists, returns the existing link.

**Returns:**

* `str`:  The magic link URL that can be shared.

***

### <kbd>classmethod</kbd> `from_url`

```python theme={null}
from_url(url: str, as_model: bool = False)
```

Load in the report into current environment. Pass in the URL where the report is hosted.

**Arguments:**

* `url` (str):  The URL where the report is hosted.
* `as_model` (bool):  If True, return the model object instead of the Report object.  By default, set to `False`.

***

### <kbd>method</kbd> `get_share_url`

```python theme={null}
get_share_url() → Optional[str]
```

Fetch the magic link URL for this report, or None if sharing is not enabled.

Makes a network call to check for active access tokens. Returns the report URL with an access token appended, allowing anyone with the link to view the report even if the project is private.

***

### <kbd>method</kbd> `save`

```python theme={null}
save(draft: bool = False, clone: bool = False)
```

Persists changes made to a report object.

***

### <kbd>method</kbd> `to_html`

```python theme={null}
to_html(height: int = 1024, hidden: bool = False) → str
```

Generate HTML containing an iframe displaying this report. Commonly used to within a Python notebook.

**Arguments:**

* `height` (int):  Height of the iframe.
* `hidden` (bool):  If True, hide the iframe. Default set to `False`.

***

## <kbd>class</kbd> `RunComparer`

A panel that compares metrics across different runs from the project the report pulls information from.

**Attributes:**

* `diff_only` (Optional\[Literal\["split", `True`]]):  Display only the  difference across runs in a project. You can toggle this feature on and off in the W\&B Report UI.

***

## <kbd>class</kbd> `RunSettings`

Configure the display appearance and visibility of an individual run in a report panel grid.

Use `RunSettings` to customize how a specific run is rendered within a `Runset`, including its line color and visibility in charts.

**Attributes:**

* `color`:  Display color for the run. Accepts hex format (`#ff0000`), a CSS color name (red), or an RGB string ("rgb(255,0,0)").
* `disabled`:  If True, hide the run from charts. This is equivalent to clicking the closed-eye icon in the UI.

***

## <kbd>class</kbd> `Runset`

A set of runs to display in a panel grid.

**Attributes:**

* `entity` (str):  An entity that owns or has the correct  permissions to the project where the runs are stored.
* `project` (str):  The name of the project were the runs are stored.
* `name` (str):  The name of the run set. Set to `Run set` by default.
* `query` (str):  A query string to filter runs.
* `filters` (Union\[str, LList\[expr.FilterExpr]]):  Filters to apply to runs. Can be:
  * A string expression: e.g., "Config('lr') = 0.001 and State = 'finished'"
* `Supports operators`: `=`, `==`, `!=`, `<`, `>`, `<=`, `>=`, `in`, `not in`
  * A list of FilterExpr objects: e.g., \[expr.Config('lr') == 0.001]
* `groupby` (LList\[str]):  A list of metric names to group by. Supported formats are:
  * "group" or "run.group" to group by a run attribute
  * "config.param" to group by a config parameter
  * "summary.metric" to group by a summary metric
* `order` (LList\[OrderBy]):  A list of `OrderBy` objects to order by.
* `custom_run_colors` (dict):  A dictionary mapping run IDs (or `RunsetGroup` keys for  grouped runs) to colors. For simple per-run colors, prefer using `run_settings`.
* `run_settings` (Dict\[str, RunSettings]):  Per-run display settings keyed by run ID.  Use this to set colors and/or hide individual runs. See `RunSettings`.

**Example:**

```python theme={null}
   # Using string filters
   wr.Runset(
        entity="my-entity",
        project="my-project",
        filters="Config('learning_rate') = 0.001 and State = 'finished'"
   )

   # Using FilterExpr list
   wr.Runset(
        entity="my-entity",
        project="my-project",
        filters=[expr.Config("learning_rate") == 0.001]
   )
```

***

### <kbd>method</kbd> `convert_filterexpr_list_to_string`

```python theme={null}
convert_filterexpr_list_to_string()
```

Convert FilterExpr list to string expression for internal processing.

***

### <kbd>method</kbd> `merge_custom_run_colors_into_run_settings`

```python theme={null}
merge_custom_run_colors_into_run_settings()
```

Merge plain-string-keyed custom\_run\_colors into run\_settings for backward compat.

***

## <kbd>class</kbd> `RunsetGroup`

UI element that shows a group of runsets.

**Attributes:**

* `runset_name` (str):  The name of the runset.
* `keys` (Tuple\[RunsetGroupKey, ...]):  The keys to group by.  Pass in one or more `RunsetGroupKey`  objects to group by.

***

## <kbd>class</kbd> `RunsetGroupKey`

Groups runsets by a metric type and value. Part of a `RunsetGroup`. Specify the metric type and value to group by as key-value pairs.

**Attributes:**

* `key` (Type\[str] | Type\[Config] | Type\[SummaryMetric] | Type\[Metric]):  The metric type to group by.
* `value` (str):  The value of the metric to group by.

***

## <kbd>class</kbd> `ScalarChart`

A panel object that shows a scalar chart.

**Attributes:**

* `title` (Optional\[str]):  The text that appears at the top of the plot.
* `metric` (MetricType):  The name of a metric logged to your W\&B project that the  report pulls information from.
* `groupby_aggfunc` (Optional\[GroupAgg]):  Aggregate runs with specified  function. Options include "mean", "min", "max", "median", "sum", "samples", or `None`.
* `groupby_rangefunc` (Optional\[GroupArea]):   Group runs based on a range. Options  include "minmax", "stddev", "stderr", "none", "samples", or `None`.
* `custom_expressions` (Optional\[LList\[str]]):  A list of custom expressions to be used in the scalar chart.
* `legend_template` (Optional\[str]):  The template for the legend.
* `font_size Optional[FontSize]`:  The size of the line plot's font.  Options include "small", "medium", "large", "auto", or `None`.

***

## <kbd>class</kbd> `ScatterPlot`

A panel object that shows a 2D or 3D scatter plot.

**Arguments:**

* `title` (Optional\[str]):  The text that appears at the top of the plot.
* `x Optional[SummaryOrConfigOnlyMetric]`:  The name of a metric logged to your W\&B project that the  report pulls information from. The metric specified is used for the x-axis.
* `y Optional[SummaryOrConfigOnlyMetric]`:   One or more metrics logged to your W\&B project that the report pulls  information from. Metrics specified are plotted within the y-axis. z Optional\[SummaryOrConfigOnlyMetric]:
* `range_x` (Tuple\[float | `None`, float | `None`]):  Tuple that specifies the range of the x-axis.
* `range_y` (Tuple\[float | `None`, float | `None`]):  Tuple that specifies the range of the y-axis.
* `range_z` (Tuple\[float | `None`, float | `None`]):  Tuple that specifies the range of the z-axis.
* `log_x` (Optional\[bool]):  Plots the x-coordinates using a base-10 logarithmic scale.
* `log_y` (Optional\[bool]):  Plots the y-coordinates using a base-10 logarithmic scale.
* `log_z` (Optional\[bool]):  Plots the z-coordinates using a base-10 logarithmic scale.
* `running_ymin` (Optional\[bool]):   Apply a moving average or rolling mean.
* `running_ymax` (Optional\[bool]):  Apply a moving average or rolling mean.
* `running_ymean` (Optional\[bool]):  Apply a moving average or rolling mean.
* `legend_template` (Optional\[str]):   A string that specifies the format of the legend.
* `gradient` (Optional\[LList\[GradientPoint]]):   A list of gradient points that specify the color gradient of the plot.
* `font_size` (Optional\[FontSize]):  The size of the line plot's font.  Options include "small", "medium", "large", "auto", or `None`.
* `regression` (Optional\[bool]):  If `True`, a regression line is plotted on the scatter plot.

***

## <kbd>class</kbd> `SoundCloud`

A block that renders a SoundCloud player.

**Attributes:**

* `html` (str):  The HTML code to embed the SoundCloud player.

***

## <kbd>class</kbd> `Spotify`

A block that renders a Spotify player.

**Attributes:**

* `spotify_id` (str):  The Spotify ID of the track or playlist.

***

## <kbd>class</kbd> `SummaryMetric`

A summary metric to display in a report.

**Attributes:**

* `name` (str):  The name of the metric.

***

## <kbd>class</kbd> `TableOfContents`

A block that contains a list of sections and subsections using H1, H2, and H3 HTML blocks specified in a report.

***

## <kbd>class</kbd> `TextWithInlineComments`

A block of text with inline comments.

**Attributes:**

* `text` (str):  The text of the block.

***

## <kbd>class</kbd> `Twitter`

A block that displays a Twitter feed.

**Attributes:**

* `html` (str):  The HTML code to display the Twitter feed.

***

## <kbd>class</kbd> `UnorderedList`

A list of items in a bulleted list.

**Attributes:**

* `items` (LList\[TextLikeField]):  A list of one or more `UnorderedListItem` objects.  Each item can be a string or a list of TextLike objects.

***

## <kbd>class</kbd> `UnorderedListItem`

A list item in an unordered list.

**Attributes:**

* `text` (str):  The text of the list item.

***

## <kbd>class</kbd> `Video`

A block that renders a video.

**Attributes:**

* `url` (str):  The URL of the video.

***

## <kbd>class</kbd> `WeaveBlockArtifact`

A block that shows an artifact logged to W\&B. The query takes the form of

```python theme={null}
project('entity', 'project').artifact('artifact-name')
```

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `entity` (str):  The entity that owns or has the appropriate  permissions to the project where the artifact is stored.
* `project` (str):  The project where the artifact is stored.
* `artifact` (str):  The name of the artifact to retrieve.
* `tab Literal["overview", "metadata", "usage", "files", "lineage"]`:  The  tab to display in the artifact panel.

***

## <kbd>class</kbd> `WeaveBlockArtifactVersionedFile`

A block that shows a versioned file logged to a W\&B artifact. The query takes the form of

```python theme={null}
project('entity', 'project').artifactVersion('name', 'version').file('file-name')
```

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `entity` (str):  The entity that owns or has the  appropriate permissions to the project where the artifact is stored.
* `project` (str):  The project where the artifact is stored.
* `artifact` (str):  The name of the artifact to retrieve.
* `version` (str):  The version of the artifact to retrieve.
* `file` (str):  The name of the file stored in the artifact to retrieve.

***

## <kbd>class</kbd> `WeaveBlockSummaryTable`

A block that shows a W\&B Table, pandas DataFrame, plot, or other value logged to W\&B. The query takes the form of

```python theme={null}
project('entity', 'project').runs.summary['value']
```

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `entity` (str):  The entity that owns or has the  appropriate permissions to the project where the values are logged.
* `project` (str):  The project where the value is logged in.
* `table_name` (str):  The name of the table, DataFrame, plot, or value.

***

## <kbd>class</kbd> `WeavePanel`

An empty query panel that can be used to display custom content using queries.

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

***

## <kbd>class</kbd> `WeavePanelArtifact`

A panel that shows an artifact logged to W\&B.

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `artifact` (str):  The name of the artifact to retrieve.
* `tab Literal["overview", "metadata", "usage", "files", "lineage"]`:  The tab to display in the artifact panel.

***

## <kbd>class</kbd> `WeavePanelArtifactVersionedFile`

A panel that shows a versioned file logged to a W\&B artifact.

```python theme={null}
project('entity', 'project').artifactVersion('name', 'version').file('file-name')
```

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `artifact` (str):  The name of the artifact to retrieve.
* `version` (str):  The version of the artifact to retrieve.
* `file` (str):  The name of the file stored in the artifact to retrieve.

***

## <kbd>class</kbd> `WeavePanelSummaryTable`

A panel that shows a W\&B Table, pandas DataFrame, plot, or other value logged to W\&B. The query takes the form of

```python theme={null}
runs.summary['value']
```

The term "Weave" in the API name does not refer to the W\&B Weave toolkit used for tracking and evaluating LLM.

**Attributes:**

* `table_name` (str):  The name of the table, DataFrame, plot, or value.
* `layout` (Layout):  The layout configuration for the panel, including position and size.  Inherited from the Panel base class. Use to adjust width (w) and height (h).

**Example:**
Create a report with a summary table panel that displays a table with custom dimensions:

```python theme={null}
    import wandb_workspaces.reports as wr

    report = wr.Report(
         project="my-project",
         entity="my-entity",
         title="Summary Table Report"
    )

    report.blocks = [
         wr.PanelGrid(
             runsets=[wr.Runset(project="my-project")],
             panels=[
                 wr.WeavePanelSummaryTable(
                     table_name="my-table-name",
                     layout=wr.Layout(w=24, h=20)
                 )
             ]
         )
    ]

    report.save()
```

The layout parameters control panel dimensions:

* w (width): Width in grid units (default: 8, max: 24)
* h (height): Height in grid units (default: 6)
* x (x-position): Horizontal position in grid (default: 0)
* y (y-position): Vertical position in grid (default: 0)
