This guide shows how to use the limited availability versions of the Scientist Experience. The Scientist Experience provides a simplified Tetra Data Platform (TDP) interface designed for scientists who need to find, analyze, share, and track scientific data without needing to navigate IT Admin functionality.

📘

NOTE

The Scientist Experience is available as part of a limited availability release and must be activated in coordination with TetraScience. The new UI is separately versioned and deployed independently from the TDP.

Prerequisites

The Scientist Experience requires the following:

• An active Tetra Data Platform (TDP) account with TDP v4.5.0 or later
• The Artifact Version Manager deployed and activated for your organization, and the Scientist Experience artifact activated through the Artifact Version Manager. For setup instructions, see Activate the Scientist Experience Through Artifact Version Manager.

Choose Your Workspace

After the Scientist Experience is activated for your organization, the Choose your workspace page appears after you first sign in. This page lets you choose how you want to interact with the TDP by default when you sign in.

• Work with scientific data — (Scientist mode) Select this option to explore and analyze scientific data using the new Scientist Experience.
• Build and manage — (IT mode) Select this option to manage platform settings, users, and system configuration using the full TDP builder interface that includes all platform capabilities.

Switch Workspaces

After you make your default workspace selection, you can switch between Scientist and IT modes at any time without signing out by selecting the upper right My Account icon.

Find Data

Run a Search

To search for specific data, do the following:

1. In the left navigation menu, choose Search. The Search page appears.
2. Enter your search terms in the search bar.
3. (Optional) Apply one or more Filters to narrow your results.
4. Press Enter. The search results appear.

Create and Apply Filters

To create filters to narrow your search results, do the following:

1. On the Search page, select Filters.
2. Choose the filter category and specify the filter criteria. For more information about each filter option, see Filter Options for Search
3. Select Search. The search results update to reflect your filter. You can combine multiple filters to refine your results further.

Save and Rerun a Search

You can save frequently used searches so that you can rerun them later without re-entering your search terms and filters.

To save a search, do the following:

1. Run a search with the terms and filters that you want to save.
2. Select Save Search.

The Create Saved Search dialog appears.

3. Enter a name for the saved search.
4. Select Save. The search is saved and available for future use.

After saving a search, you can rerun it by selecting it from the Saved Searches tile on either the Home or Search page.

View File Details

To preview a file, select the file from the search Results list. The file's Details page appears, showing the file content and related information.

For each file in the search results, you can view the following information:

• Attributes — Attributes associated with the file
• Details — File details such as file name, file ID, file path, version, source name, source type, upload date, and size
• Related Files — Pointer(s) to related files

View File History

To view the history of a specific file, select History on the file's Details page.

The file history appears. To download a specific file version, select the version's download icon.

Share Files and Search Results

When you apply filters on the Search page, the browser's address bar updates automatically with a clean URL that reflects your current search criteria. You can copy, share, or bookmark this URL, and anyone who opens it sees the same filtered results.

You can also retrieve these sharable search results URLs by choosing the Share All option on the search Results page, or by selecting the Share menu option on a specific file.

For more information, see Share and Bookmark Search Results.

Manage Data

Edit Attributes

To edit attributes for multiple files at once, do the following:

1. In the search results, select the checkboxes next to the files that you want to update. To select all files in the search results, select the top check box.
2. Choose Edit Attributes.

The Edit Attributes dialog appears.

3. Add or remove attributes as needed.
4. (Optional) Check the Track job progress box to track the bulk label edit job. To monitor the job's progress in IT mode, see Monitor a Bulk Label Edit Job's Status.
5. Select Update [#] files. The attributes are updated for all selected files.

Upload a New Version of a File

To upload a new version of an existing file, do the following:

1. In the search results, find the file that you want to update.
2. Select the file's three-dot menu icon. Then, select Upload new version.

The Upload New Version dialog appears.

3. Choose a file or drag and drop it into the dialog.
4. Select the file's Source Type and Selected Folder.
5. Choose Upload. The new version replaces the previous version as the Current version, and the file's version history is updated.

Download Files

To download multiple files, do the following:

1. In the search results, select the checkboxes next to the files that you want to download. To select all files in the search results, select the top check box.
2. Choose Download All. The files download to your local machine.

/- or -

To download a single file, go to that file's Details page and select the Download option.

Delete Files

🚧

IMPORTANT

Deleted file versions are unavailable through search or SQL queries. It is a soft delete within the system, which means that the deleted file versions remain in the Data Lake, still display with a UUID on the File Details page, and remain available through the TetraScience API. However, restoring deleted files to an active state requires manual steps that must be done in conjunction with TetraScience, and should be done only in business critical situations. Please contact your customer account leader if you need to restore deleted files.

To delete multiple files, do the following:

1. In the search results, select the checkboxes next to the files that you want to delete. To select all files in the search results, select the top check box.
2. Choose the three-dot More menu icon. Then, select Delete All.

A Delete dialog appears, asking you to confirm that you want to delete the files. Choose Delete to delete the files.

/- or -

To delete a single file, select the file's three-dot menu icon. Then, select Delete.

A Delete dialog appears, asking you to confirm that you want to delete the file. Choose Delete to delete the file.

Analyze and Visualize Data

Tetra Data Apps enable Analytics and AI on your scientific data. Once Data Apps are configured for your organization, users can access the apps through the Scientist Experience or the Tetra Data & AI Workspace.

To view Tetra Data Apps using the Scientist Experience, do the following:

1. In the left the navigation menu, choose Applications. The Applications page appears and displays a list of available apps.
2. (Optional) Use the category filters to narrow the list of apps.
3. Select an app to open it and start analyzing data. User guides for apps are available on the Details page for each app.

🚧

IMPORTANT

Apps that you want to have displayed in the Scientist Experience must have the scientific_app_category label applied to them. Apps without this label won't appear in the new UI. To apply labels to apps, see Activate an Embedded Data App to update labels in the UI, or Update Data App labels for access control in the TetraScience API Reference to update labels programmatically.