101 lines
7.3 KiB
Markdown
101 lines
7.3 KiB
Markdown
|
# Single view
|
||
|
|
|
||
|
|
The **Single** view displays information about a single set of profiling data. You can use it to analyze how markers perform across frames. The view is divided into several frames, which contain information on frame timings, as well as min, max, median, mean, and lower / upper quartile values for frames, threads, and markers.
|
||
|
|
|
||
|
|
For information on navigating the window, see the [Profile Analyzer window navigation](profile-analyzer-window.html/#window-navigation) documentation.
|
||
|
|
|
||
|
|
<br/> *The Single view in the Profile Analyzer window, with some data loaded*
|
||
|
|
|
||
|
|
## Loading data
|
||
|
|
|
||
|
|
To load data into the **Single** view, select the **Pull Data** button in the frame control pane, and the Profile Analyzer pulls in any data in the [Profiler](https://docs.unity3d.com/Manual/Profiler.html) window. Alternatively, select the **Load** button to load Profile Analyzer (.pdata) data you have saved from a previous session.
|
||
|
|
|
||
|
|
>[!NOTE]
|
||
|
|
>If you select the **Load** option, the data must be in the Profile Analyzer .pdata format. If you have data from the Profiler in the .data file format, open it in the Profiler first, and then select the **Pull Data** button in the Profile Analyzer.
|
||
|
|
|
||
|
|
For more information on how to pull data into the Profile Analyzer, see the workflow documentation on [Collecting and viewing data](collecting-and-viewing-data.md).
|
||
|
|
|
||
|
|
## Marker details list
|
||
|
|
|
||
|
|
The **Marker details** pane contains a sortable list of markers with a number of useful statistics. If you select a marker in the list, the **Marker Summary** panel displays in depth information on the marker. Each marker in the list is an aggregation of all the instances of that marker, across all filtered threads and in all ranged frames.
|
||
|
|
|
||
|
|
You can filter the columns in the **Marker details** to a more relevant set. This is particularly useful if you want to filter out irrelevant data when you look for **Time** or **Count** values. To filter the columns, select the **Marker columns** dropdown from the **Filters** pane. For more information on how to filter data, see the [Filters](filtering-system.md) documentation.
|
||
|
|
|
||
|
|
### Marker details columns and groups
|
||
|
|
|
||
|
|
By default, the **Marker columns** dropdown in the **Filters** pane has six preset column layouts that you can use to adjust the layout of the **Marker details** pane. They are:
|
||
|
|
|
||
|
|
* **Time and count:** Displays information on the average timings and number of times the markers were called.
|
||
|
|
* **Time:** Displays information on the average timings of the markers.
|
||
|
|
* **Totals:** Displays information about the total amount of time the markers took on the whole data set.
|
||
|
|
* **Time with totals:** Displays information about both the average and total times of the markers.
|
||
|
|
* **Count totals:** Displays information about the total number of times the markers were called.
|
||
|
|
* **Count per frame:** Displays information on the average total per frame the markers were called.
|
||
|
|
* **Depths:** Displays information on where the markers are in the Hierarchy. For more information, see the documentation on Depth Slices in [Filters pane](filtering-system.html#depth-slice).
|
||
|
|
* **Threads:** Displays the name of the thread that the markers appear on. For more information, see the documentation on the Thread window in [Filters pane](filtering-system.html#thread-window).
|
||
|
|
|
||
|
|
You can also use the **Custom** column layout, to select your own custom mix of columns to add to the layout. To do this, right-click on the header of any column, and manually enable or disable any of the columns as necessary.
|
||
|
|
|
||
|
|
The following table shows the columns that the Profile Analyzer displays when you select that layout.
|
||
|
|
|
||
|
|
||**Time and count**|**Time**|**Totals**|**Time with totals**|**Count totals**|**Count per frame**|**Depths**|**Threads**|**Custom only**|
|
||
|
|
|---|---|---|---|---|---|---|---|---|---|
|
||
|
|
|**Marker Name**|✓|✓|✓|✓|✓|✓|✓|✓||
|
||
|
|
|**Depth**|✓|✓|✓|✓|✓|✓|✓|||
|
||
|
|
|**Median**|✓|✓||✓||||||
|
||
|
|
|**Median Bar**|✓|✓||✓||||||
|
||
|
|
|**Mean**|✓|||||||||
|
||
|
|
|**SD**|||||||||✓|
|
||
|
|
|**Min**|✓|✓||✓||||||
|
||
|
|
|**Max**|✓|✓||✓||||||
|
||
|
|
|**Range**|✓|✓||✓|||||
|
||
|
|
|**Count**|✓||||✓|||||
|
||
|
|
|**Count Bar**|||||✓|||||
|
||
|
|
|**Count Frame**|✓|||||✓||||
|
||
|
|
|**Count Frame Bar**||||||✓||||
|
||
|
|
|**Count SD**|||||||||✓|
|
||
|
|
|**1st**|||||||✓||||
|
||
|
|
|**At Median Frame**|✓|✓||✓||||||
|
||
|
|
|**Total**|||✓|✓||||||
|
||
|
|
|**Total Bar**|||✓|✓||||||
|
||
|
|
|**Threads**||||||||✓||
|
||
|
|
|
||
|
|
The following table explains what each column does:
|
||
|
|
|
||
|
|
|**Column**|**Description**|
|
||
|
|
|---|---|
|
||
|
|
|**Marker Name**| Displays the name of the marker.|
|
||
|
|
|**Depth**|The depth in the hierarchy that the marker appears on.|
|
||
|
|
|**Median**| The median value of the marker's time distribution.|
|
||
|
|
|**Median Bar**| A visualization of the **Median** value.|
|
||
|
|
|**Mean**| The average value of the marker's time distribution.|
|
||
|
|
|**SD**| The standard deviation of the marker's time distribution.|
|
||
|
|
|**Min**| The minimum value of the marker's time distribution.|
|
||
|
|
|**Max**| The maximum value of the marker's time distribution.|
|
||
|
|
|**Range**| The difference between the marker's **Min** and **Max** timings.|
|
||
|
|
|**Count**| The number of times the marker was pushed / popped.|
|
||
|
|
|**Count Bar**|A visualization of the **Count** value. |
|
||
|
|
|**Count Frame**|The average number of times per frame that the marker was pushed/popped.|
|
||
|
|
|**Count Frame Bar**|A visualization of the **Count Frame** value.|
|
||
|
|
|**Count SD**|The standard deviation of **Count** value.|
|
||
|
|
|**1st**| The frame number in which the marker first was pushed / popped.|
|
||
|
|
|**At Median Frame**| The sum of activity for the marker in the median frame.|
|
||
|
|
|**Total**| The total time spent for this marker in all selected frames.|
|
||
|
|
|**Total Bar**|A visualization of the **Total** value.|
|
||
|
|
|**Threads**|The name of the thread that the marker appears on.|
|
||
|
|
|
||
|
|
### Marker Details context menu commands
|
||
|
|
|
||
|
|
If you right click on a marker in the **Marker Details** list you can control the filter and list even further.
|
||
|
|
|
||
|
|
|**Command**|**Function**|
|
||
|
|
|---|---|
|
||
|
|
|**Select Frames that contain this marker (within whole data set)**| Select all the frames from the entire data set that contain an instance of this marker.|
|
||
|
|
|**Select Frames that contain this marker (within current selection)**| Select all the frames from a selected range of data that contain an instance of this marker.|
|
||
|
|
|**Select All**| Selects the entire data set, if you have a range of data selected.|
|
||
|
|
|**Add to / Remove From Include Filter**| Add or remove the selected marker to the **Include** filter. This filters the marker list to only markers that match.|
|
||
|
|
|**Add to Exclude Filter**| Add the selected marker to the **Exclude** filter. This removes the marker from the marker list. This is useful if you want to remove markers that are using up resources and skewing the markers that you are interested in.|
|
||
|
|
|**Set as Parent Marker Filter**| Limit the analysis to this marker and markers included below it on the callstack. For more information, see the [Parent Marker](filtering-system.html#parent-marker) documentation on the Filters page.|
|
||
|
|
|**Clear Parent Marker Filter**| Select this to clear the marker as a parent marker filter.|
|
||
|
|
|**Copy To Clipboard**| Copies the selected value to the clipboard.|
|