SIMVehicles
Lookup tables
Create and maintain 1D and 2D lookup tables used by vehicle submodule parameters.
Lookup tables are reusable numeric maps used by module parameters that support lookup table mode. Create them from Design > Lookup tables, then select them from module detail rows that reference lookup tables.
Before you start
- Select the correct team.
- You need module create permission to create a lookup table.
- You need module update permission to edit table data.
- Decide whether the parameter needs one input axis or two input axes.
Table dimensions
| Dimension | Use it for | Product description |
|---|---|---|
| 1D table | One input value mapped to one output value | Single input variable mapped to a single output value. |
| 2D table | Two input values mapped to one output matrix | Two input variables mapped to output values in a matrix. |
Supported 1D table types
| Type | X axis | Y axis | Validation / Range |
|---|---|---|---|
| Spring | Spring Travel (mm) | Suspension Spring Force (N) | At least 2 rows. X values unique and ascending. Key and value between -1000000000 and 1000000000. |
| ARB | ARB Travel (mm) | ARB Force (N) | At least 2 rows. X values unique and ascending. Key and value between -1000000000 and 1000000000. |
| Bump Rebound Stop | Travel (mm) | Force (N) | At least 2 rows. X values unique and ascending. Key and value between -1000000000 and 1000000000. |
| Damper | Damper Velocity (mm/s) | Suspension Damper Force (N) | At least 2 rows. X values unique and ascending. Key and value between -1000000000 and 1000000000. |
| Motion Ratio | Wheel Travel (mm) | Device Travel (mm) | At least 2 rows. X values unique and ascending. Key between -1000000000 and 1000000. Value between -1000000 and 1000000. Values must be ascending. |
Supported 2D table types
| Type | X axis | Y axis | Z value | Validation / Range |
|---|---|---|---|---|
| Engine Torque | Engine Speed (rpm) | Throttle Pos (%) | Torque (Nm) | At least 2 rows and 2 columns. X and Y values unique and ascending. Each row must contain one value per column. |
| Aero Drag Coefficient | Ride Height Front (mm) | Ride Height Rear (mm) | Drag Coefficient | At least 2 rows and 2 columns. X and Y values unique and ascending. Each row must contain one value per column. |
| Aero Lift Coefficient | Ride Height Front (mm) | Ride Height Rear (mm) | Lift Coefficient | At least 2 rows and 2 columns. X and Y values unique and ascending. Each row must contain one value per column. |
Create a lookup table
- Open Design > Lookup tables.
- Select New.
- Choose 1D Table or 2D Table.
- Enter name, notes, type, and tags.
- Add table data or import it.
- Use Split, Table, or Chart view to review values.
- Save the table.
Import table data
Lookup table import supports CSV, TSV, and XLSX files.
For 1D tables:
- Rows must contain exactly 2 cells.
- The first row can be either two numeric cells or two non-numeric header cells.
- Each data row must provide X value and Y value.
For 2D tables:
- The first row must contain a blank or non-numeric top-left header and numeric column headers.
- Each data row must contain one row key and one value for each column header.
- Blank lines are allowed only before or after the data, not inside it.
The import dialog previews parsed rows before replacing current table data.
Use a lookup table in a submodule
- Open the submodule detail page.
- Find the method row for the parameter group.
- Select Lookup Table when that method is available.
- Select a compatible lookup table from the lookup table row.
- Save with Update Data.
Troubleshooting
| Problem | What to check |
|---|---|
| Create button is hidden | Confirm your role has module create permission. |
| Cannot save table data | Check required name, row count, ascending axes, unique axes, and numeric values. |
| Import file fails | Use CSV, TSV, or XLSX with the expected 1D or 2D shape. |
| Lookup table is not selectable from a module | Confirm the table type matches the parameter's allowed lookup table type. |