> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

*GRID Session* is a unified environment for robotics development that combines interactive coding, simulation, telemetry, and data management.

## Overview

<img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/session.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=032c470862c26b7f44c654161e192927" alt="User Session" width="1839" height="985" data-path="assets/portal/session.png" />

A **Session** is your development environment, where you can:

* **Prototype code** in Jupyter-style notebooks (left pane).
* **View and interact** with a real-time simulation (right pane).
* **Monitor telemetry** and logs in a dedicated panel (bottom-right).
* **Leverage AI Copilot** to generate actions or code from plain language.
* **Store and retrieve** data in the built-in file storage.

This integrated interface facilitates quick iteration: you write code in the left pane, immediately see your changes affect the simulation on the right, and track telemetry data as you go.

## Layout

1. **Notebook Panel (Left)**

   * Write Python code in a Jupyter-like interface.
   * Execute cells to run code, instantiate robots or models, and visualize results in the simulation view.
   * Organize your workflow with Markdown cells for documentation and commentary.

   <img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/notebook.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=557b3b87412297f0c0421aba367f58c4" alt="Notebook" width="894" height="916" data-path="assets/portal/notebook.png" />

2. **Simulation Panel (Right)**

   * Displays the simulation environment in which your code runs.
   * Interact with the simulation scene (e.g., position objects, change parameters).

   <img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/simulation.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=75daa8094a070223d3f2a3648ee58b9d" alt="Simulation" width="934" height="553" data-path="assets/portal/simulation.png" />

3. **Telemetry Tab (Bottom-Right)**

   * Powered by Rerun, the Telemetry tab logs and visualizes robot states, sensor data, and results of AI models.
   * Helps you track performance metrics, movement paths, and any events or anomalies over time.

   <img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/telemetry.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=f117ef7e7068454507b66e7d754f9e57" alt="Telemetry" width="933" height="484" data-path="assets/portal/telemetry.png" />

4. **Copilot Tab (Bottom-Right)**

   * Natural Language to Code conversion to help you prototype quickly.
   * Enter plain-language commands and Copilot will generate Python code tailored to your environment and simulation.
   * Seamless integration with your Notebook: copy/paste or insert Copilot-generated code directly into your active session.

   <img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/copilot.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=b0b66e55e56612306c5e0b7f32bd8962" alt="Copilot" width="925" height="472" data-path="assets/portal/copilot.png" />

5. **Storage**

   * Access saved data (images, logs, configuration files, etc.) generated during the session.
   * Download or upload files needed for your simulation or code.
   * Data persists across session restarts as long as you keep the session active.

   <img src="https://mintcdn.com/scaledfoundations/bbcuyC2Oq40Jh0Ty/assets/portal/save_data.png?fit=max&auto=format&n=bbcuyC2Oq40Jh0Ty&q=85&s=7f5806abed4fb2610c05c6e1bded40fe" alt="Storage" width="925" height="478" data-path="assets/portal/save_data.png" />

## Typical Workflow

1. **Initialize Objects**
   * In the left notebook panel, import the relevant robotics modules.
   * Create simulation objects, such as robots and sensors, by running `AirGenCar()`, `OneFormer()`, or other constructors.

2. **Interact with the Simulation**
   * Observe real-time changes in the simulation window when you execute your code.
   * Manipulate objects: move them around, apply commands, or adjust sensor inputs.
   * Ensure your setup reflects the scenario you want to prototype (e.g., suburban delivery routes, robotic arms in a warehouse, etc.).

3. **Monitor Telemetry**
   * As the simulation runs, switch to the Telemetry tab.
   * Inspect logs and visualize path trajectories or sensor data in real time.
   * Use this data for debugging or performance optimization.

4. **Use Copilot**
   * When you have a desired outcome in mind but aren’t sure how to implement it, open the Copilot.
   * Describe what you want in plain language (e.g., “Move the robot forward for 5 seconds”).
   * Integrate the auto-generated code snippet into your Notebook and execute it to see results.

5. **Save & Download Data**
   * As your session progresses, snapshots, logs, or analysis results will be saved in the **Storage** panel.
   * You can rename or structure files as needed, then download them for further offline analysis.

Step onto the GRID—where every idea takes shape and takes off.
