Skip to content

Import a Map from CSV

If you already have your Attitudes in a spreadsheet, you can load them into a Map from a .csv file instead of typing each row.

Before you start

  • Loading a CSV replaces every row in the Attitudes table. It doesn't add to them.
  • You can't load a CSV into a Map with locked Attitudes. Copy the Map instead.
  • Bramble has no CSV template or export. Build the file yourself, using the format below.

Prepare the CSV

  • Commas only. Separate values with commas. Semicolons and tabs don't work, and quoted values aren't supported, so a value can't contain a comma.
  • First line: headers. One header per column.
  • Name column. A column headed exactly Name (capital N) sets each Attitude's name. Names can contain letters, digits, spaces, - and _, and must be unique within the Map.
  • Parameter columns. Every other header must match a parameter's key exactly, including capitals and spaces, such as Front RH, Rear RH, Velocity, Yaw, Roll, Steer, or an optional parameter such as Corner Radius. See Map parameters.
  • Numbers. Use a decimal point only, such as 0.5, with an optional leading minus. Exponents such as 1e-3, + signs, leading zeros, thousand separators and values like .5 aren't accepted.
  • Blank cells use the default value, as they do when you type into the table.
  • One unit for all ride heights. Use metres or millimetres throughout. You'll set Map Units to match.

For example, in metres:

Name,Front RH,Rear RH,Velocity,Yaw,Roll,Steer
Baseline,0.030,0.070,40,0,0,0
Yaw 2,0.030,0.070,40,2,0,0
Low FRH,0.020,0.070,40,0,0,0

Check the headers

A header that doesn't match a known parameter is added as a new column. A typo such as Front Rh creates an extra Front Rh column and leaves Front RH blank. Delete any columns you don't want from the file before you load it.

Getting the header names

Copy them from the Attitudes table headers, without the (m) or (mm) suffix. For a custom optional parameter on your Account, the header shown in the table can differ from the key the CSV needs. If a column doesn't load as expected, contact support@bramblecfd.com for the key.

Load the CSV

  1. Create a Map, or open an existing one with the pencil icon on the Maps page.
  2. Set Map Units to match the ride heights in your file: m for metres, mm for millimetres. Do this before loading. Switching afterwards converts the loaded values, so a 25 mm ride height loaded in m and then switched to mm becomes 25000.
  3. Click Populate Using CSV and choose the file.
  4. Check the table. Optional parameters in the file are ticked automatically, and invalid cells are highlighted. Hover over a highlighted ride height to see why.
  5. Fix any problems in the table, or fix the file and load it again.
  6. Click Save. Nothing is saved until you do, and Cancel discards the loaded rows.

If the CSV doesn't load as expected

Bramble doesn't report errors in the file itself. Instead, check the table:

What you see Likely cause
Save disabled, names blank The file has no Name column, or its header isn't exactly Name
"Some attitudes have duplicated names" Two rows have the same name
An extra column, and a default column blank A header doesn't exactly match the parameter key
Values split across the wrong columns The file uses semicolons or tabs, or a value contains a comma
A highlighted number The number format isn't accepted, for example 1e-3, .5 or 1,000
"Ride height cannot be greater than 1m" A ride height is outside ±1 m (±1000 mm). Check Map Units matches the file
Missing values at the end of a row The row has fewer values than there are headers. The missing cells are left blank

Related: Create a Map · Generate a sweep · Map parameters · File formats and limits