Runs Management

Runs Explorer

Overview

To navigate into Runs Explorer, click on the Runs navigation item from the left sidebar.

Runs explorer helps you to

Runs Explorer

Search Runs

Use Search bar to query runs with Aim QL.

Runs Explorer Search Bar

Follow runs in real time

Switch Live Update to turn on the real time mode.

Runs Explorer Live Update

Delete or archive runs

Step 1: Select runs on the runs table:

Runs Explorer Batch archive

Click on the Archive button. Fonfirmation popup appears. Click Archive again and the runs are archived!

Runs Explorer Batch archive

In order to batch delete the selected runs, just use the Delete button. In this case ase well, press Delete again on the confirmation popup and the runs will be hard deleted. *Warning:_ this operation is irreversible and the runs are deleted from the disk.

Runs Explorer Batch delete

Export Runs report

Generate Runs CSV report by clicking on the Export button on the Runs table.

Runs Explorer export runs

Single run page

Each training run has a dedicated page on Aim. Use the single run page to observe all the tracked metadata associated with that run.

Here are the tabs available on the single run page. Each tab visualizes respective tracked metadata or empty if not tracked.

Overview

Overview tab shows overall info about the run.

  • These cards can contain information about Parameters, Metrics, System Metrics, CLI Arguments, Environment Variables, Packages and Git information. With this data, you can easily reproduce your run.

  • Sidebar contains information about Run Date, Run Duration, Run Hash, attached Tags and gives the ability to navigate through tabs.

Single Run page overview tab

Also, you can apply advanced searching/filtering to those card tables.

Single Run page overview tab table

Params

Params tab contains a JSON-like visualization of all the tracked params data related to a single run of interest.

Single Run page params tab

Metrics

Metrics tab contains the visualizations of all the metrics tracked for the given run.

When exploring run results, some metrics are looked at more often. Pin those metrics to the top of the page to find them easier and faster. Undo pinning by clicking on “unpin” button.

Single Run page metrics tab

Note: you can track arbitrary number of runs with lots of steps with Aim!

System

Aim automatically tracks system metrics, so you can use them in order to detect potential resource mismanagements or anomalies.

System tab contains all the tracked system metrics for a single run.

Single Run page system tab

Distributions

You can track the gradient, the weights and the biases distributions of all the layers for lots of steps with Aim.

The Distributions tab will allow you to observe them for a single run. You can also

  • navigate between the layers

  • search for distribution on specific steps

The single run distributions tab is quite powerful!

Single Run page distributions tab

Images

The Images tab contains all the tracked images of a single run. You can track runs with different contexts and at different steps of training.

Single Run page images tab

On the left-hand side are the names of different image-sets you have tracked along with their context unpacked.

Select Context

Usually the images are tracked at diff steps and with batches. This control will allow you to quickly slice and dice the specific subset of images to view. Use these sliders to search

  • which subset of steps you’d like to see (on the left-hand side)

  • which indices you’d like to see (on the right-hand side)

Slider

If there is only 1 step or only 1 index, you will see the info message instead of the control

Slider

Audios

You can track audios with Aim. Use the Audios tab to view and play the tracked audios of a single run.

Single Run audios params tab

Texts

Use the Texts tab to view and search all the texts tracked for a single run.

On the left-hand side you will see the name and context of the tracked texts. You can use the search-bar on top to search the text with regexp or just match word or case.

Use the bottom controllers to control the steps and the indices of the tracked texts too.

Single Run page texts tab

Figures

Aim allows tracking Plotly and matplotlib figures. On the Figures tab you can view all the track figures over different contexts and steps.

Note: Aim will render figures with passed or default dimensions. There will be scrolls if the size exceeds the plotly container space of the Figures tab.

Single Run page figures tab

Terminal Logs

Aim streams the process output logs (terminal logs) to the Aim UI automatically near-real-time. The terminal logs are displayed under Logs tab on the single run page.The terminal logs can be disabled programmatically if needed. More on terminal logs here.

Single Run page logs tab

Settings

Use the Settings tab to delete or archive the single run

Single Run page settings tab

Delete Run

Delete Run card Delete confirm

Archive Run

Archive card Unarchive card