# Teleplot

The Teleplot output streams real-time data from DR Sim Manager to [teleplot.fr](https://teleplot.fr), a free online tool for visualizing live data as charts and graphs. This is an invaluable tool for tuning your motion setup, diagnosing issues, comparing axis behavior, and understanding exactly what your simulator is doing in real time.

---

## When to Use This

- **Tuning motion profiles** — See exactly how your gain, smoothing, and other settings affect the output in real time.
- **Diagnosing motion issues** — If motion feels wrong, compare the raw telemetry from your game with the processed axis positions and final actuator outputs to identify where the problem lies.
- **Monitoring actuator behavior** — Watch actuator position values to check for saturation, clipping, or unexpected spikes.
- **Comparing before/after** — Visualize the effect of changes to your motion profile or sim config.

---

## Setup Steps

1. In DR Sim Manager, go to the **Outputs** tab and click the **+** tab.
2. Select **Teleplot** from the list.
3. Leave the default connection settings (or change the target host if self-hosting).
4. Click **Add Variable** to select data to stream.
5. Open [teleplot.fr](https://teleplot.fr) in your web browser.
6. Start your sim source — your selected variables will appear as live charts on the Teleplot dashboard.

---

## What It Can Send

You can select any combination of variables to stream, including:

- **Telemetry Data** — Raw data from your sim source (e.g., speed, G-forces, RPM, acceleration, angular velocity, orientation, suspension positions).
- **Axis Positions** — The computed motion axis values (sway, surge, heave, pitch, roll, yaw) after all cue processing, filtering, and blending.
- **Actuator Positions** — The final actuator output values being sent to your hardware, per sim component.

This means you can trace the entire signal path: **raw telemetry → processed motion → actuator output**.

---

## Settings

### Connection Settings

- **Target Host** — The hostname or IP to send data to (default: `teleplot.fr`). If you are running a local Teleplot instance, enter your local IP address or `localhost`.
- **UDP Port** — The port number for the connection (default: `47269`).

### Selecting Variables

1. Click **Add Variable** to open the variable picker.
2. Choose a **Data Type**:
   - **Telemetry Data** — Raw values from the sim source.
   - **Axis Position** — Processed motion axis values.
   - **Actuator Position** — Final actuator output values.
3. Select the specific **Variable** you want to monitor (e.g., `acceleration.surge`, `motion.roll`, etc.).
4. Optionally enter a custom **Output Name** for the variable as it appears in Teleplot. This is useful for giving meaningful names when monitoring multiple similar variables.
5. Click **OK** to add it to the output list.

To remove a variable, click the **x** button next to it.

---

## Viewing Your Data

1. Open [teleplot.fr](https://teleplot.fr) in your web browser.
2. Connect DR Sim Manager's Teleplot output (ensure the output tab is enabled).
3. Start your sim source — your selected variables will appear as live charts on the Teleplot dashboard.
4. Use Teleplot's built-in tools to zoom, pan, pause, and analyze the data.

---

## Practical Tips

- **Start with axis positions** — Monitoring `motion.sway`, `motion.surge`, `motion.heave`, `motion.pitch`, `motion.roll`, and `motion.yaw` gives you a good overview of what your simulator is doing.
- **Add telemetry for comparison** — Overlay raw telemetry (like `acceleration.surge`) on the same chart as the processed axis position to see how your cue settings transform the data.
- **Monitor actuator saturation** — If actuator values are frequently hitting their min or max, your gains may be too high or your platform may have insufficient travel.
- **Use custom names** — When monitoring multiple similar variables, use the Output Name field to differentiate them (e.g., "Raw Surge" vs "Processed Surge").

---

## Troubleshooting

### No data appears in Teleplot

1. **Check the output is enabled** — Ensure the Teleplot output tab is active in DR Sim Manager.
2. **Check a source is running** — Teleplot only sends data when a sim source is active and producing telemetry.
3. **Check variables are selected** — At least one variable must be added to the output list.
4. **Check firewall** — Ensure outbound UDP on port 47269 is not blocked by Windows Firewall.
5. **Check the browser tab** — Teleplot.fr must be open and active in your browser.

### Data appears delayed or choppy

- Teleplot streams data in real time, but network conditions and browser performance can affect display. A wired internet connection is recommended.
- Reduce the number of variables being streamed if performance is an issue.

### Teleplot shows "no connection"

- Verify the **Target Host** and **UDP Port** settings are correct.
- If using `teleplot.fr`, ensure your internet connection is active.
- If self-hosting, verify your local Teleplot instance is running and listening on the configured port.