# Running apps

## Run an app on datasets stored in the cart

After browsing and selecting Planet Microbe datasets, the data of interest can be added to your personal cart using the 'Add to cart button'.

The stored datasets can be visualized, explored and removed using the Cart icon on the top right of your screen.

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04pcYqqLhfVFAI0xkb%2F-M04qYLcJzuBw0DzKzO_%2Fcart.png?alt=media\&token=e13138e3-181d-49bd-b34e-af88995da4e8)

The list of tools currently available through Planet Microbe is accessible in the "Analyze" tab.

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04nZoiu-ybQON9qFNE%2F-M04pY_LQySAQkB8oTcI%2FAnalyze_tab.png?alt=media\&token=87dfa7c3-0986-4f7c-bb33-1ddffe55a663)

Clicking on the app name, will open the app launch page. Accessing the app launch page will require the user to sign into their cyverse account. After the authentication through cyverse, the user will be automatically redirected to the app page.

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04pcYqqLhfVFAI0xkb%2F-M04rdg_LET3DWDih18e%2Fcentrifuge.png?alt=media\&token=5e2ba84e-64c2-4b30-bf5d-545017681c57)

In the Input field, select 'Cart'. This will open a discussion window allowing to refine the selection. 

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04pcYqqLhfVFAI0xkb%2F-M04uWlaJMwCnkqvAaHc%2Fcart_App.png?alt=media\&token=c915477b-f72e-40f0-9976-3e2eae22fb91)

Depending on the app, other parameter inputs may be required. When ready, hit the "Run" button to launch the analysis.

## Run an app from data stored in your Cyverse Datastore

As previously stated, the list of tools currently available through Planet Microbe is accessible in the "Analyze" tab. Clicking on the app name, will open the app launch page. Accessing the app launch page will require the user to sign into their cyverse account. After the authentication through cyverse, the user will be automatically redirected to the app page.

In the Input field, select "Data Store". This will open a discussion window allowing to browse and select files from the user's personal space on the Cyverse Data Store. 

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04pcYqqLhfVFAI0xkb%2F-M04v92x_qpjcosFCeE3%2FdataStore.png?alt=media\&token=a0b1fa2c-a753-48e8-a813-ada768a26e40)

 Depending on the app, other parameter inputs may be required. When ready, hit the "Run" button to launch the analysis.

## Viewing job results

In the "Analyze" tab, you can access your current and past jobs ran through Planet Microbe and [iMicrobe](https://www.imicrobe.us/).

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04zoYd6_Zr8khMhbLF%2F-M05AK148rFAxTrpCZpL%2Fjob_management.png?alt=media\&token=a31c0ad8-9da5-4ccd-aa55-1ba1f564cdc5)

Clicking on the job's name will give you the job's description, status and outputs.

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04zoYd6_Zr8khMhbLF%2F-M05AenK_gO17OsbuJAa%2Fjob_page.png?alt=media\&token=45e81a8a-156d-42da-a07d-d3758e759052)

Once the job is complete, outputs can be accessed and downloaded from the Cyverse Data Store.

![](https://1983881729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LqcWNnN07qIiRAjF3Ts%2F-M04zoYd6_Zr8khMhbLF%2F-M05B8UW21rXzCvXyI14%2Fjob_outputs.png?alt=media\&token=d4ca09c6-9fd2-4dd8-b4d2-e143c682a321)


---

# 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://hurwitzlab.gitbook.io/planet-microbe-documentation/getting-started/running-apps.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.