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

# RHEED Camera

> Stream live RHEED frames to Atomscale while your RHEED software runs the camera

The **RHEED Camera (GenTL)** integration streams frames from your RHEED camera to Atomscale while your existing RHEED software, such as kSA 400, runs the camera. Frames upload as they arrive, group into one data item per acquisition, and are analyzed live.

The integration is a passive second viewer. It never starts or stops acquisition and never changes camera settings. It receives frames only **while your RHEED software is acquiring**, meaning live frames from the camera are updating in that software's viewport. When the live image stops, no frames arrive.

It needs the desktop app on Windows 10 or later; the Atomscale CLI doesn't run it. If kSA 400 runs your camera, you can use the separate [kSA 400](https://docs.atomscale.ai/gateway/rheed/ksa-400.md) integration instead, which uploads the frames kSA 400's Image Streamer sends. Choose one of the two for a camera.

## Choose a Frame Source

The **Frame Source** setting decides how frames reach the integration.

```text theme={null}
Network (GVSP Tap), the default:
  Camera ─GigE─► network adapter ─► RHEED software
                      └─ copy ──► RHEED integration

Standard (GenTL):
  Camera ─────────────────────────► RHEED software
    └─ read-only, through the
       vendor's GenTL producer ──► RHEED integration
```

| Frame Source | How it works | Use it when |
| - | - | - |
| **Network (GVSP Tap)** | Observes the GigE Vision stream as it arrives at this computer, without opening the camera. Needs [Integration admin access](https://docs.atomscale.ai/gateway/admin-access.md). | The default. The camera is a GigE Vision camera, including when the RHEED software holds it exclusively. |
| **Standard (GenTL)** | Opens the camera read-only through the vendor's GenTL producer (a `.cti` file from the vendor SDK). | The camera is not GigE Vision (for example USB3 Vision), or network capture is not possible on this computer. |

A third option, **Synthetic (Testing)**, generates test frames without a camera.

## Set It Up

> [card] [Network capture (GVSP Tap)](https://docs.atomscale.ai/gateway/rheed/network-capture.md)
>
> The default. Add the integration and start it; it finds the camera and tunes capture itself.

> [card] [Standard capture (GenTL)](https://docs.atomscale.ai/gateway/rheed/camera.md)
>
> Use the vendor's GenTL producer to open the camera as a second viewer.

After setup, check [Recording Sessions](https://docs.atomscale.ai/gateway/rheed/sessions.md) to decide how frames are split into data items, for example by following kSA 400's acquisition state. All settings are listed in the [Settings Reference](https://docs.atomscale.ai/gateway/rheed/settings.md).

## What You Get in Atomscale

Each acquisition becomes one RHEED data item named after its start time, for example **RHEED Stream @ 4:15 PM, Oct 23, 2026**. When the stream ends, its length is added, as in **RHEED Stream @ 4:15 PM, Oct 23, 2026 · 1 h 35 min**.

| Status | Meaning |
| - | - |
| Stream Active | Frames are arriving and uploading. |
| Stream Finalizing | The acquisition ended and processing is finishing. |
| Success | Processing is complete. |
| Stream Error | The stream failed, or no data arrived for 2 hours while it was open. |

Atomscale places each stream on a physical sample for its growth as soon as it starts. To group it with the tool log from the same growth, link the integration to a **Growth Instrument**; see [Finding Your Data](https://docs.atomscale.ai/gateway/data.md).

> [!NOTE]
>
> These pages describe RHEED Camera (GenTL) version 1.8. An integration configured with an earlier
> version keeps capturing exactly as before: its saved Frame Source, Capture Mode, camera address,
> and tuning values stay. To hand a field over to the integration, click Auto Manage next to it
> on the configuration page. See [Auto Values](https://docs.atomscale.ai/gateway/rheed/settings.md#auto-values).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.