# Data Pane

## Overview

The Data pane is used to manage the Take files. This pane can be accessed under the [View tab](https://docs.optitrack.com/toolbar-command-bar#view) in Motive or by clicking the <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/DTiEtyDkhOCNuarotPLv/image.png" alt="" data-size="line"> icon on the main toolbar.

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/23TiHIWYVtV4NodKLGsc/Data%20Pane%20-%20Advanced%20layout%20explained.png" alt="An annotated screenshot from Motive of the Data pane."><figcaption><p>Click image to enlarge.</p></figcaption></figure>

### Pane Options menu

Click the <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/h2dfXW7QXEnpMh4o0Bus/Motive%20Context%20Menu.png" alt="A screenshot from Motive of the Data Pane context menu button." data-size="line"> button in the top right corner of the pane to open the Pane Options menu.&#x20;

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/2FNO4YAuJttBJzO11rqc/Data%20Pane%20Menu%20Options%203.3.png" alt="A screenshot from Motive of of the Data Pane Options menu."><figcaption><p>Data Pane options.</p></figcaption></figure>

<details>

<summary>Simple</summary>

Use the simplest data management layout.

</details>

<details>

<summary>Advanced</summary>

Includes additional column headers in the layout.

</details>

<details>

<summary>Custom Layouts (Optional)</summary>

Any custom layouts created by the user are available in the menu directly under the Advanced option, using the name selected by the user (*Custom 1* in the example, above.)&#x20;

</details>

<details>

<summary>New...</summary>

Create a new custom layout.&#x20;

</details>

<details>

<summary>Rename</summary>

Rename a custom layout.

</details>

<details>

<summary>Delete</summary>

Delete a custom layout.

</details>

<details>

<summary>Import Shot List...</summary>

Import a list of empty *Take* names and notes from either a CSV or XML file. This is helpful when you plan a list of shots in advance to the capture.&#x20;

</details>

<details>

<summary>Export Shot List...</summary>

Exports a list of Take information into either a CSV or XML file. Included elements are name of the session, name of the take, file directory, involved assets, notes, time range, duration, and number of frames included.

</details>

## List of Session Folders

The leftmost section of the Data pane is used to list the sessions that are loaded in Motive. Session folders in Motive group multiple associated *Take* files, and they can be imported simply by dragging-and-dropping or importing <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/N91Pv1lWLLtGjLkWmd90/Data%20Pane%20-%20Import%20Folder.png" alt="A screenshot from Motive of the &#x22;Open Session folder&#x22; icon." data-size="line"> a folder into the data management pane. When a session folder is loaded, all of the *Take* files within the folder are loaded altogether.

In the list of session folders, the currently loaded session folder will be denoted with a flag symbol <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/nyEybIqpCdinVCtE4jiz/Data%20Pane%20-%20Flag%20for%20current%20folder.png" alt="A screenshot from Motive of the flag icon that denotes the currently open session folder." data-size="line"> , and the selected session folder will be highlighted in white.

**Session Folder Buttons**

* <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/7CdrznfGoOuRy4outUsv/Data%20Pane%20-%20Add%20session%20folder.png" alt="A screenshot from Motive of the Data pane button to add a new session folder." data-size="line">  Add a new session folder. The new folder will be saved in the Motive's default location.&#x20;
* <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/meIUXdszR6XEyRkz2D8C/Data%20Pane%20-%20Data%20Mgmt%20Pane.png" alt="A screenshot from Motive of the Data pane button to toggle on/off the viewing of the Sessions folders list. " data-size="line"> Collapse the session folder sidebar.

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/SaT9FniaeGTJQm1va01j/image.png" alt="A screenshot from Motive of the Data pane with the list of loaded session folders highlighted. The current session folder is noted with a flag icon."><figcaption><p>List of loaded session folders. Current session folder is noted with a flag icon.</p></figcaption></figure>

### Context Menu Options

Right-click on any session folder to see the following options:&#x20;

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/dI9MasbRNUke61NJ6ORW/Data%20Pane%20-%20Session%20list%20context%20menu.png" alt="A screenshot from Motive of the Session Folder context menu."><figcaption><p>Session Folder context menu.</p></figcaption></figure>

<details>

<summary><strong>Create Sub-Folder</strong></summary>

This creates a new folder under the selected directory.

</details>

<details>

<summary>Show Folder Location</summary>

Opens the session folder from Windows File Explorer.

</details>

<details>

<summary>Remove</summary>

Removes the selected session folder from the list without deleting them.&#x20;

</details>

<details>

<summary>Delete</summary>

Deletes the session folder. All of the folder's contents will be deleted as well.

</details>

## List of Takes

When a session folder is selected, associated *Take* files and their descriptions are listed in a table format on the right side of the Data pane. For each *Take*, general descriptions and basic information are shown in the columns of the respective row.&#x20;

To view additional fields, click on the pane menu, select *new* to create a custom view, and all of the possible fields will be available to add to the new view. Right-click on the column header to select the columns to display. For each of the enabled columns, you can click on the arrow next to it to sort up/down the list of *Takes* depending on the category.

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/PeXhJvrculrBPemXeV75/image.png" alt="A screenshot from Motive of the data pane, with the list of take names section highlighted."><figcaption></figcaption></figure>

### Take Information

The following information about each take is available in the Data pane. To see all data, create a custom view that includes all fields.&#x20;

<details>

<summary>Best</summary>

The star icon ![](https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/P9WOca4DW7YOJsv0paKJ/image.png) allows users to mark the best *Takes*. Simply click on the star icon and mark the successful *Takes*.

</details>

<details>

<summary>Health</summary>

The <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/zr0ootTR3WpGiAxvnKIU/image.png" alt="" data-size="line"> health status column of the *Takes* indicates the user-selected status of each take:

* <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/v1WuTKPHAHyUYVJcMmui/image.png" alt="" data-size="line"> : Excellent capture
* <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/9f7Ywc58dHPbtK5MfdgN/image.png" alt="" data-size="line"> : Okay capture
* ![](https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/b19ifHlLOta9rYDzOwlC/image.png) : Poor capture

</details>

<details>

<summary>Progress</summary>

The progress indicator is used to track processing of the *Takes*. Use the indicators to track the workflow-specific progress of each *Take*. Right-click to select:&#x20;

* Ready
* Recorded
* Reviewed
* Labeled
* Cleaned
* Exported

</details>

<details>

<summary>Name</summary>

Shows the name of the Take.

</details>

<details>

<summary>2D</summary>

Indicates whether [2D data](https://v30.wiki.optitrack.com/index.php?title=Data_Types#2D_Data) exists on the corresponding *Take.*

</details>

<details>

<summary>3D</summary>

Indicates whether reconstructed [3D data](https://docs.optitrack.com/motive/data-recording/data-types) exists on the corresponding *Take*.&#x20;

If 3D data does not exist on a *Take*, it can be derived from 2D data by performing the **reconstruction** pipeline. Please see the [Reconstruction](https://docs.optitrack.com/motive/reconstruction-and-2d-mode#post-processing-reconstruction) page for more details.

</details>

<details>

<summary>Video</summary>

Indicates whether [reference videos](https://docs.optitrack.com/motive/camera-video-types#reference-videos) exist in the *Take*. Reference videos are recorded from cameras that are set to either MJPEG grayscale, raw grayscale, or Duplex modes.

</details>

<details>

<summary>Solved</summary>

Indicates whether any of the assets have [solved data](https://docs.optitrack.com/motive/data-recording/data-types#solved-data) baked into them.

</details>

<details>

<summary>Audio</summary>

Indicates whether synchronized audio data have been recorded with the *Take*. See: [Audio Recording in Motive](https://docs.optitrack.com/motive/audio-recording).

</details>

<details>

<summary>Analog</summary>

Indicates whether analog data recorded using a data acquisition device exists in the *Take*. Please see the [NI-DAQ Setup](https://docs.optitrack.com/movement-sciences/movement-sciences-hardware/ni-daq-setup) page for more information on working NI-DAQ devices.

</details>

<details>

<summary>Date Recorded</summary>

Shows the time and the date when the *Take* was recorded.

</details>

<details>

<summary>Frame Rate</summary>

Shows the camera system frame rate which the *Take* was recorded in.

</details>

<details>

<summary>Duration</summary>

Time length of the *Take.*

</details>

<details>

<summary>Total Frames</summary>

Total number of captured frames in the *Take.*

</details>

<details>

<summary>Notes</summary>

Comments and notes on each *Take.*

</details>

<details>

<summary>Start Timecode</summary>

Timecode stamped to the starting frame of the *Take*. Available only if a [timecode](https://docs.optitrack.com/synchronization/optitrack-timecode) signal was integrated to the system.

</details>

<details>

<summary>Captured in Version</summary>

Motive version used to record the *Take*.

</details>

<details>

<summary>Last Saved in Version</summary>

Motive version used to edit or save the *Take*.

</details>

### Search Bar

The search bar is located at the bottom of the Data pane. You can search a *selected* session folder using any number of keywords and search filters. Motive will use the search text to list the matching *Takes* from the selected session folder. Unless otherwise specified, the search filter will scope to all of the data pane columns.&#x20;

**Search for exact phrase**

* Wrap your search text in quotation marks.
* e.g., Search `"shooting a gun"` for searching a file named *Shooting a Gun.tak*.

**Search specific fields**

* To limit the search to specific columns, type `field:`, plus the name of a column enclosed with quotation marks, and then the value or term you're searching for.
* Multiple fields and/or values may be specified in any order.
* e.g. `field:"name" Lizzy`, `field:"notes" Static capture`.

**Search for true/false values**

* To search specific binary states from the Take list, type the name of the field followed by a colon (:), and then enter either true (\[t], \[true], \[yes], \[y]) or false (\[f], \[false], \[no], \[n]).
* e.g. `Best:[true]`, `Solved:[false]`, `Video:[T]`, `Analog:[yes]`

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/z1GaG2v4CapcLVd0qX2Z/image.png" alt="A screenshot from Motive of the Data Pane with Takes that have been partially processed. "><figcaption><p>Searching for Takes that contains solved assets data.</p></figcaption></figure>

### Customizing Table Layout

The table layout can be customized for the user's specific needs.&#x20;

From the [pane options menu](#pane-options-menu), select *New* or any of the previously customized layouts. Once you are in a customizable layout, right-click on the top header bar and add or remove categories from the table.

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/r9sLHkQNc3d2Ti0En7pN/Data%20Pane%20-%20Select%20columns%20custom%20view.png" alt="A screenshot from Motive showing the columns available when creating a custom layout for the data pane. "><figcaption><p>Customizing header categories.</p></figcaption></figure>

### Import an Empty Shot List

A list of take names is known as a shot list. Shot lists can be imported from either a CSV or XML file or by copying text that contains a take name on each line, separated by carriage returns. This feature allows you to plan, organize, and create a list of capture names ahead of actual recording. Once a shot list has been imported, a list of *empty* takes with the corresponding names will be listed for the selected session folder.

**Copy From a Text File**

Take lists can be imported by copying a list of take names and pasting them onto the Data pane. Each take name must be on its own line.&#x20;

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/skDuEd8Uwa8rKKCbWxyU/image.png" alt="2 screenshots - the image on the left shows the data pane in Motive with a list of simple take names. The image on the right shows the same list in a text file, with the context menu open and Copy selected. "><figcaption></figcaption></figure>

**From a CSV File**

Take lists can be imported from a CSV file that contains take names on each row. To import, click on the top-right menu icon <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/UbLa2DyrRnfbql3Nwml3/Motive%20Context%20Menu.png" alt="" data-size="line"> and select *Import Shot List...*

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/OFaUJINUkY477s7HlA0n/Data%20Pane%20-%20Import%20CSV%20without%20notes.png" alt="2 screenshots. The one on the left shows a simple Excel file with a list of take names. The image on the right shows the same list imported into the data pane in Motive, along with the pane menu with the Import Shot List... option highlighted. "><figcaption><p>Empty <em>Takes</em> imported from CSV. </p></figcaption></figure>

{% hint style="warning" %}
Excel has several CSV file formats to choose from. Make sure to select *CSV (Comma Delimited)* when saving your file for import.&#x20;
{% endhint %}

#### Import a CSV Shot List with Notes

* To display the Take Notes in the Data pane, create a custom layout that includes the Notes field.
* To import multiple columns, the CSV file must contain a header row with column names that match the column headings in Motive, i.e., Name and Notes.&#x20;

{% hint style="info" %}
When preparing the CSV file for import:&#x20;

* The import will fail if there is no column labeled *Name*.&#x20;
* The import will skip the *Notes* column with an error if it's not correctly labeled.
  {% endhint %}

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/B45f4lqq1Xq52v79exe8/Data%20Pane%20-%20Import%20CSV%20with%20notes.png" alt="2 screenshots - 1 of an excel file with a sample list of take names and notes and the other from Motive, showing the same file&#x27;s contents imported into the data pane."><figcaption><p>Empty <em>Takes</em> imported from CSV with Notes included.  </p></figcaption></figure>

#### Import from an XML File

Shot Management Systems often include the ability to export data to an XML file, which can then be imported into Motive. The following XML fields can be imported:

* \<Name>
* \<Notes>

You can still import an XML file into Motive if it contains more fields than those allowed for import. If extra fields are detected, Motive will return the following error message:

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/D2tHibadySlT7BBP3WZf/Import%20Shot%20List%20from%20prior%20export.png" alt="A screenshot from Motive of the error message when importing an XML file to the data pane that has more fields than the 2 allowed for import."><figcaption><p>Error message when additional form fields are included in the import file.</p></figcaption></figure>

Click OK to clear the message and continue importing the valid fields.

## Export a Shot List

The Shot List export option provides data on each take in the session folder in either a CSV or XML format. The shot list includes the take Name and the Notes field as well as other information contained in the Data pane such as the [Best ](#best)or [Progress ](#progress)fields. It also includes a list of assets in the take, the duration, number of frames, and other information related to the take.&#x20;

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/O2zcFNnKONNKXb4fKLCV/Export%20Shot%20List%20-%20XML%20data%20for%20a%20take.png" alt="A screenshot of data from an XML file that contains Take information, exported from Motive. "><figcaption><p>Take information exported to an XML file. </p></figcaption></figure>

{% hint style="info" %}
Note that the export contains fields that cannot be imported back into Motive, which allows only the Name and Notes fields to import. See the example in the[ Import from an XML File](#import-from-an-xml-file) section of this document.
{% endhint %}

## Take Menu

Open the context menu for captured *Takes* by clicking the <img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/tQ87ozk4ij4rJSfEpQLc/Motive%20Context%20Menu.png" alt="A screenshot from Motive of the button to open a context menu." data-size="line"> icon to the right of the *Take* name or by right-clicking on the selected *Take(s)*.&#x20;

The context menu lists options used to perform post-processing pipelines on the selected *Take(s)*. The menu contains essential pipelines such as reconstruction, auto-label, data export and many others. Available options are listed below.

### Context Menu Options

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/UYnvCP3vAqBcdXd1LjIQ/Data%20Pane%20-%20Take%20file%20context%20menu.png" alt="A screenshot from Motive of the Context menu for Takes, available from the Data pane."><figcaption><p>Data pane context menu for a selected Take.</p></figcaption></figure>

<details>

<summary>Save</summary>

Saves the selected take.

</details>

<details>

<summary>Revert</summary>

Reverts any changes that were made. This does not work on the currently opened Take.

</details>

<details>

<summary>Make Current</summary>

Selects the current take and loads it for playback or editing.

</details>

<details>

<summary>Rename</summary>

Allows the current take to be renamed.

</details>

<details>

<summary>Show File Location</summary>

Opens an Explorer window to the folder that contains the selected *Take*. This can be helpful when backing up, transferring, or exporting data.

</details>

<details>

<summary>Reconstruct</summary>

Separate reconstruction pipeline without the auto-labeling process. Reconstructs 3D data using the 2D data. Reconstruction is required to export Marker data.&#x20;

</details>

<details>

<summary>Auto-label</summary>

Separate auto-labeling pipeline that labels markers using the existing tracking asset definitions. Available only when 3D data is reconstructed for the *Take*. Auto-label is required to export Markers labeled from Assets.&#x20;

</details>

<details>

<summary><strong>Reconstruct and Auto-label</strong></summary>

Combines 2D data from each camera in the system to create a usable 3D take. It also incorporates assets in the *Take* to auto-label and create rigid bodies, skeletons, and trained markersets in the Take. Reconstruction is required to export Marker data and Auto-label is required when exporting Markers labeled from Assets.&#x20;

</details>

<details>

<summary><strong>Solve All Assets</strong></summary>

Solves 6 DoF tracking data of skeletons, rigid bodies, and trained markersets and bakes them into the *Take*. When the assets are solved, Motive reads from the recorded Solve instead of processing the tracking data in real-time. Solving is required prior to exporting Assets.&#x20;

</details>

<details>

<summary><strong>Reconstruct, Auto-label, and Solve</strong></summary>

Performs all three reconstruct, auto-label, and solve pipelines in consecutive order. This recreates 3D data from recorded 2D camera data.

</details>

<details>

<summary><strong>Export Tracking Data</strong></summary>

Opens the Export dialog window to select and initiate file export. Valid formats for export are CSV, C3D, FBX, BVH.&#x20;

Reconstruction is required to export Marker data, Auto-label is required when exporting Markers labeled from Assets, and Solving is required prior to exporting Assets.

{% hint style="info" %}
Please note that if you have Assets that are unsolved and just wish to export reconstructed Marker data, you can toggle off Rigid Bodies and Bones (Skeletons) from the Export window (see image below). For more information please see our [Data Export](https://docs.optitrack.com/motive/data-export) page.&#x20;
{% endhint %}

<figure><img src="https://content.gitbook.com/content/GaZwzcsVav6zPBRZpapU/blobs/Zd5Z5e4UvKwK0ULANL7k/Export%20Options%20to%20exclude%20unsolved%20assets%20MARKED%20UP.png" alt="A screenshot of the Data Export screen in Motive, with CSV export selected and the options to include Rigid Body Bones and Skeleton and Markerset Bones are both disabled. "><figcaption><p>The Motive export window, with the options to export assets disabled. </p></figcaption></figure>

</details>

<details>

<summary><strong>Export Video</strong></summary>

Opens the export dialog window to initiate scene video export to AVI.

</details>

<details>

<summary><strong>Export Audio</strong></summary>

Exports an audio file when selected *Take* contains audio data.

</details>

<details>

<summary><strong>Delete 2D / Video / Audio Data</strong></summary>

Opens the Delete 2D Data pop-up where you can select to delete the 2D data, Audio data, or reference video data. Read more in [Deleting 2D data](https://docs.optitrack.com/motive/data-recording/data-types#deleting-2d-video-audio-data).

</details>

<details>

<summary><strong>Delete 3D Data</strong></summary>

Permanently deletes the 3D data from the *Take*. This option is useful if reconstruction or editing causes damage to the data.

</details>

<details>

<summary><strong>Delete Marker Labels</strong></summary>

Unlabels all existing marker labels in 3D data. If you wish to re-auto-label markers using modified asset definitions, first unlabel markers for the respective assets.

</details>

<details>

<summary><strong>Delete All Solved Asset Data</strong></summary>

Deletes 6 DoF tracking data that was solved for skeleton and rigid bodies.&#x20;

When Solved data doesn't exist, Motive calculates tracking of the objects from recorded 3D data in real-time.

</details>

<details>

<summary><strong>Archive Take</strong></summary>

Archives the original take file and creates a duplicate version. We recommend archiving all *Takes* prior to completing any post-production work. &#x20;

</details>

<details>

<summary><strong>Delete Takes</strong></summary>

Opens a dialog box to confirm permanent deletion of the *take* and all associated 2D, 3D, and Joint Angle Data from the computer. This option cannot be undone.

</details>

<details>

<summary><strong>Delete All Assets from Take</strong></summary>

Deletes all assets that were recorded in the *Take*.

</details>

<details>

<summary>Enable All Assets in Selected Take</summary>

Enables all assets within the selected *Take*.&#x20;

</details>

<details>

<summary><strong>Copy Assets to Take</strong></summary>

Copies the assets from the current capture to the selected *Takes*.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.optitrack.com/motive-ui-panes/data-pane.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
