# Table Editor

# Using the Table Editor

#### Table Editor

The Table Editor is a critical view in Atlas. Using the Table Editor, you can change calibration **lookup** **tables** and modify ECU behaviors resulting from their computed values. Most, if not all, recalibration done on your ECU will happen from within the Table Editor, so it is crucial to understand its capabilities and how to navigate around it.

[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/OAhQq6zepqClth3t-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/OAhQq6zepqClth3t-image.png)

#### Menu Bar

The **Menu Bar** contains a few options to load, save, and edit the table you are editing.

The **Live Editing Status Area** on the right-hand side of the Menu Bar shows you the current state of live editing in the Table Editor. If a red <span style="color: rgb(224, 62, 45);">**"LIVE"**</span> box appears, then any changes you make in the Table Editor will be immediately reflected on the ECU, so be careful when making changes. Sometimes, you might see a yellow **<span style="color: rgb(241, 196, 15);">"Resync"</span>** label. Click this label to redownload the ECU's table copy so you can return to a LIVE session, but beware: any local changes will be lost.

For more information and diagnostics on Live Editing, see the documentation page:

#### Toolbar

The **Toolbar** has a series of quick actions that you can perform such as exporting the table data, and performing mathematical operations on **selected cells**, such as adding values or averaging them.

The **Calibration Area** on the right-hand side of the Toolbar allows you to quickly change the Table Editor between different calibrations in your project. Most of the time, you only want to edit **Global Calibration**, which has its own dropdown in the **Atlas Toolbar** outside the Table Editor in the main Atlas window. However, you can change each Table Editor independently as you work.

Keep in mind that when the **Global Calibration** changes, any Table Editors that are currently selected to that calibration will also update to the newly selected Global Calibration. Any Table Editors that have selected a different calibration than the Global Calibration will not track the Atlas Global Calibration as it changes, unless the Global Calibration being changed from agrees with the Table Editor's calibration.

#### Table Area

##### X Axis / Y Axis

The axes for the table are listed alongside the table contents and scroll with the table cell data as you pan/scroll through it. Right-click on an axis's header to edit its contents. <span style="color: rgb(224, 62, 45);">**Be very careful!**</span> **Atlas will allow you to edit any Axis, even if it might be dangerous.** Editing axes can cause unintended behavior in the ECU; we recommend double-checking with our community (i.e. Discord) before editing axis data in your ECU, unless you know what you're doing.

##### Table Cells

The Table Cells for the table is the large area in the center of the Table Editor. In this area, you can perform several actions and modify table cell data unless the currently selected calibration is marked as **read-only**.

When Table Cells change, they will flash a certain color depending on what has been updated. Cells flash <span style="color: rgb(241, 196, 15);">yellow </span>when they have updated the calibration (or "ROM") only, as in the case with offline work, but flash <span style="color: rgb(45, 194, 107);">green</span> when the data has also been updated on the online ECU in a live session.

<table border="1" id="bkmrk-action-keystroke%28s%29-" style="border-collapse: collapse; width: 100%; height: 148.984px;"><colgroup><col style="width: 15.3754%;"></col><col style="width: 16.2058%;"></col><col style="width: 68.4188%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><span style="color: rgb(126, 140, 141);">**Action**</span></td><td style="height: 29.7969px;"><span style="color: rgb(126, 140, 141);">**Keystroke(s)**</span></td><td style="height: 29.7969px;"><span style="color: rgb(126, 140, 141);">**Description**</span>  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Enter Cell Data**</td><td style="height: 29.7969px;">*Type any number*</td><td style="height: 29.7969px;">Enter cell data by first selecting cells you want to edit, then type a number and press **Enter/Return** to have the entire selection update to the entered value.  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Undo**</td><td style="height: 29.7969px;">Ctrl+Z (Cmd+Z)</td><td style="height: 29.7969px;">Undo the last edit.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Redo**  
</td><td style="height: 29.7969px;">Ctrl+Y (Cmd+Y)</td><td style="height: 29.7969px;">Redo the last undone edit.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Add**  
</td><td style="height: 29.7969px;">Shift+(+)</td><td style="height: 29.7969px;">Type the "+" character (Shift and the "+" key together) to start adding a value to the current selection.  
**Tip:** use a negative number to quickly subtract a value.  
</td></tr><tr><td>**Multiply**</td><td>Shift+8</td><td>Type the "\*" character (Shift and the "8" key together) to start multiplying the current selection by a coefficient.</td></tr><tr><td>**Divide**</td><td>/</td><td>Type the "/" character to start dividing the current selection by a coefficient.</td></tr><tr><td>**Interpolate**</td><td>i</td><td>Type the "i" key to immediately interpolate the current **complex selection**.

Interpolation behaves differently than other actions. Selected cells will be treated as anchors and will be unchanged, but any cells in between the anchors will be interpolated according to the Table Editor's current interpolation algorithm.

</td></tr></tbody></table>

Selection in the Table Editor can either be **Simple** or **Complex**. The following table breaks down these two selection modes:

<table border="1" id="bkmrk-simple-selection-com" style="border-collapse: collapse; width: 100%; border-width: 1px; border-style: ridge; height: 58.5938px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.2969px;"><td class="align-center" style="height: 29.2969px;"><span style="color: rgb(126, 140, 141);">**Simple Selection**</span></td><td class="align-center" style="height: 29.2969px;"><span style="color: rgb(126, 140, 141);">**Complex Selection**</span></td></tr><tr><td>**Click and drag** to make a simple selection.

Use **Ctrl/Cmd + A** together to quickly select the entire table.

</td><td>Start with a simple selection (or one cell), and **hold Ctrl/Cmd** while clicking other areas of the table to produce a complex selection.

Complex selections are a key feature with **Interpolation.**

</td></tr><tr style="height: 29.2969px;"><td style="height: 29.2969px;">[![Screenshot 2024-11-07 at 2.43.41 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/OvY1SvSPwuUofrWl-screenshot-2024-11-07-at-2-43-41-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/OvY1SvSPwuUofrWl-screenshot-2024-11-07-at-2-43-41-pm.png)

</td><td style="height: 29.2969px;">[![Screenshot 2024-11-07 at 2.45.08 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/sK1dsTJLM518lDUK-screenshot-2024-11-07-at-2-45-08-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/sK1dsTJLM518lDUK-screenshot-2024-11-07-at-2-45-08-pm.png)

</td></tr></tbody></table>

# Interpolation

#### Interpolation in the Table Editor

**Interpolation** is a feature in Atlas that allows you to effectively smooth table cell data. Using interpolation, you can create gradients that prevent the ECU from suddenly "jumping" in values, helping to avoid detonation and create a smoother driver experience across a map.

Interpolation relies on **Complex Selections** for more advanced calibration editing. Due to the internal algorithm being based on complex selections, Interpolation enables you to quickly design a map in fewer interactions with the editor and speeds up your workflow.

### Basics

##### Horizontal/Vertical Smoothing

Take the following table as an example, it is an ignition timing table will all values set to 0:

[![Screenshot 2024-11-07 at 3.15.59 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/eJTud2CBuZCjcEOK-screenshot-2024-11-07-at-3-15-59-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/eJTud2CBuZCjcEOK-screenshot-2024-11-07-at-3-15-59-pm.png)

Let's begin by selecting an area of the table and setting the values to **5** degrees:

[![Screenshot 2024-11-07 at 3.16.48 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/LQuVrCvwcQrkX8kd-screenshot-2024-11-07-at-3-16-48-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/LQuVrCvwcQrkX8kd-screenshot-2024-11-07-at-3-16-48-pm.png)

Holding down the **Ctrl**/**Cmd** **key** on our keyboard, we will **click** on another cell, such as 2.34g/rev x 2000RPM:

[![Screenshot 2024-11-07 at 3.18.07 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/nmWXlPRerbyd3O9Q-screenshot-2024-11-07-at-3-18-07-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/nmWXlPRerbyd3O9Q-screenshot-2024-11-07-at-3-18-07-pm.png)

A **Complex Selection** has now been started. As you can see, a duplicate-sized column has now been selected in the area we clicked. Now, press the "i" key on the keyboard to immediately interpolate the **empty space** between the two highlighted columns:

[![Screenshot 2024-11-07 at 3.19.24 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/ULOT7NQjS3TYRdOm-screenshot-2024-11-07-at-3-19-24-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/ULOT7NQjS3TYRdOm-screenshot-2024-11-07-at-3-19-24-pm.png)

As we can see, the table has been interpolated in the **empty space,** smoothing from 5.00 degrees to 0.00 degrees. The highlighted columns did **not change,** as they are treated as **anchors** in the interpolation algorithm.

##### Corner-Based Interpolation

A typical use-case for interpolation is interpolating corners of a table. In this example, we'll interpolate 4 corners and create a blended map between them.

Selecting the 4 corners desired for interpolation by holding the **Ctrl/Cmd** key and **clicking** on each **anchor** of the area to interpolate, press the "i" key to immediately interpolate the area of the box using the anchors as waypoints for the operation:

[![Screenshot 2024-11-07 at 3.24.22 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/qs2o1ZxL61aD4lso-screenshot-2024-11-07-at-3-24-22-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/qs2o1ZxL61aD4lso-screenshot-2024-11-07-at-3-24-22-pm.png)

[![Screenshot 2024-11-07 at 3.25.34 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/UQex2pcmsoGwbAzG-screenshot-2024-11-07-at-3-25-34-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/UQex2pcmsoGwbAzG-screenshot-2024-11-07-at-3-25-34-pm.png)

### Advanced

##### Smoothing with a Waypoint

By selecting **multiple** columns (*or rows*), we can create a way-pointed interpolation. The values under the 0.94 g/rev column will be unchanged, and will instead be used to interpolate the values to the left and right as they approach the other anchors at 0.63 g/rev and 2.03 g/rev.

[![Screenshot 2024-11-07 at 3.27.50 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/EE8VaKGVw5hFLERF-screenshot-2024-11-07-at-3-27-50-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/EE8VaKGVw5hFLERF-screenshot-2024-11-07-at-3-27-50-pm.png)

[![Screenshot 2024-11-07 at 3.29.06 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/7RaM7KfxeUkRP5bz-screenshot-2024-11-07-at-3-29-06-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/7RaM7KfxeUkRP5bz-screenshot-2024-11-07-at-3-29-06-pm.png)

##### Multiple Waypoints

In a very common scenario, you may want to create a map from a series of waypoints as shown. In this example, we select each cell using the **Cmd/Ctrl** key and use the "i" key to quickly interpolate between each of the waypoints.

[![Screenshot 2024-11-07 at 3.30.40 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/aAcDT3WfE3q3QZaK-screenshot-2024-11-07-at-3-30-40-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/aAcDT3WfE3q3QZaK-screenshot-2024-11-07-at-3-30-40-pm.png)

[![Screenshot 2024-11-07 at 3.32.02 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/oQZQj7CEW2EUu11m-screenshot-2024-11-07-at-3-32-02-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/oQZQj7CEW2EUu11m-screenshot-2024-11-07-at-3-32-02-pm.png)

[![image.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/IHsSVNrs42mJn2Sn-image.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/IHsSVNrs42mJn2Sn-image.png)

# Reverting to Another Calibration

If you would like to revert your changes in the current calibration to another calibration, you can always **Apply a different calibration** by clicking *Edit -&gt; Apply different calibration...*

[![Screenshot 2024-11-07 at 3.37.31 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/dfsIv6d0vQY8iInb-screenshot-2024-11-07-at-3-37-31-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/dfsIv6d0vQY8iInb-screenshot-2024-11-07-at-3-37-31-pm.png)

The default selection in the **Select Calibration** dialog box will always be the **Base Calibration** you set for the current calibration, if applicable, for faster reverting:

[![Screenshot 2024-11-07 at 3.38.14 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/L4cDlLNdtQsJDRYw-screenshot-2024-11-07-at-3-38-14-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/L4cDlLNdtQsJDRYw-screenshot-2024-11-07-at-3-38-14-pm.png)

The calibration will be updated. Note that only **selected cells** will be changed. In this case, **Ctrl/Cmd+A** was used to select the entire table before the operation took place:

[![Screenshot 2024-11-07 at 3.38.27 PM.png](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/scaled-1680-/S3fqXVbhI0vfFrW6-screenshot-2024-11-07-at-3-38-27-pm.png)](https://docs.motorsportsresearch.org/uploads/images/gallery/2024-11/S3fqXVbhI0vfFrW6-screenshot-2024-11-07-at-3-38-27-pm.png)