Analyses tab FAQs

Kaylee Mathews
  • Updated

In this article, we’ve listed some of the most frequently asked questions about the Analyses tab and other new interactive analysis features in Terra. If you have additional questions, please visit the Terra Community Forum or leave us a comment on this article.

To learn more about interactive analyses in Terra, see the Interactive Analysis section of the Terra support site.

1. The Notebooks tab has been replaced by the Analyses tab. Where are my Notebooks?

Jupyter Notebooks are now listed under the Analyses tab. In this tab, you’ll also see files for RStudio if you've uploaded them to your workspace.

2. Where’s the Cloud Environment widget?

The Cloud Environment widget has been replaced by a new sidebar on the right side of the Terra user interface (UI). If you haven't started using any interactive analysis applications yet, the sidebar contains two options: an Environment Configuration and a Terminal.

Screenshot of workspace Analyses tab with the cloud environment and terminal icons in the right sidebar circled

Selecting the new Environment Configuration button will allow you to choose which application you want to launch (Jupyter Notebooks, RStudio, or Galaxy).

Once an environment is created, you’ll see the application logo (or logos) in the sidebar.











3. Can I run Jupyter and RStudio at the same time in a single workspace?

Because Jupyter Notebook and RStudio environments use the same Google Cloud virtual machine (VM), creating an RStudio environment will delete an existing Jupyter Notebook environment and vice versa. If you try to do so, you’ll see a warning message:

Screenshot of Downtime required warning message - By continuing you will be changing the application of your cloud environment from Jupyter to RStudio. This change will require temporarily shutting down your cloud environment. You will be unable to perform any analysis for a few minutes. Your existing data will be preserved during this update.

However, you can have a Galaxy environment in the same workspace as either a Jupyter or RStudio environment.

4. I tried to upload my file, analysis.rmd, to Terra in the Analyses tab, but nothing happened. Why?

RStudio requires that R Markdown file extensions be exactly .Rmd. The “R” in the file extension needs to be capitalized.

5. How do I know the status of my Cloud Environment VM?

The status of each environment VM is indicated by a colored dot on the sidebar of the Analyses tab:

  • Green: running
  • Blue: pausing/resuming
  • Orange: paused
  • Red: error

Alternatively, you can hover over the application logo to see the status of the VM.

Screenshot of the Jupyter logo in the sidebar with an arrow pointing to the green dot indicating that the cloud environment VM is running.

For more information about the VM, select the Environment Configuration button on the sidebar which opens the Cloud Environment Details pane. You’ll see both a visual and textual description of the environment’s status there. You can update your Cloud Environment settings and status and launch a Jupyter, RStudio, or Galaxy instance from this pane, depending on what you created for your workspace.

6. How do I pause my Cloud Environment VM?

To pause your Cloud Environment VM, follow the steps below.

Screenshot of the Jupyter Cloud Environment Details pane whighlighting the pause environment button at the top middle

1. Select the Environment Configuration (cloud icon) button on the sidebar. This will open the Cloud Environment Details pane (left).

2. Select the Pause Environment button for any active VM in your workspace.

What to expect

When a Cloud Environment is paused, this button changes to Resume Environment.

7. How do I delete my Cloud Environment VM?

To delete your Cloud Environment VM, follow the steps below:

1. Select the Environment Configuration (cloud icon) button on the sidebar. This will open the Cloud Environment Details pane (below).

2. Select the Environment Settings button under the application where you would like to delete the VM.

Screenshot of the cloud environment details pane highlighting the Jupyter environment settings button and gear icon at the top left.

3. Select Delete environment.

Screenshot of the bottom of the environment configuration pane highlighting the delete environment button at the bottom.

Galaxy app deletion

Galaxy VMs must be running to be deleted. If your Galaxy VM is paused, it needs to be resumed before it can be deleted.

Was this article helpful?

0 out of 0 found this helpful



Please sign in to leave a comment.