Map parameters¶

The columns of a Map's Attitudes table: what each parameter is, its unit, and the rules for values and names. To build a Map, see create a Map.

Default parameters¶

Every Map in the Account shows these columns. They can't be added to or removed from individual Maps.

Parameter	Unit	Converted by Map Units	Allowed values	Notes
Front RH	m, or mm	Yes	−1 to 1 m (−1000 to 1000 mm)	Ride height at the Kinematic Setup's front reference point
Rear RH	m, or mm	Yes	−1 to 1 m (−1000 to 1000 mm)	Ride height at the Kinematic Setup's rear reference point
Velocity	m/s	No	Any number
Yaw	degrees	No	Any number	Positive yaw means the wind comes from the driver's right. See coordinate system and units
Roll	degrees	No	Any number	Sign as defined by your Kinematic Setup
Steer	As defined by your Kinematic Setup	No	Any number	Unit and sign as defined by your Kinematic Setup

Blank values. A blank cell takes the value from the Run's Kinematic Setup, under Default Ride Parameters. Without a Kinematic Setup, the velocity comes from the Template Case. See create a Kinematic Setup.

Other default sets. Your Account may use a different set of default parameters. The Map then shows whichever of the parameters above are still defined, in the order above, followed by the Account's own.

Optional parameters¶

Optional parameters appear as checkboxes under Optional Parameters in the Map dialog, only if your Account has any. Ticking one adds its column to the Attitudes table, and unticking removes it.

When you edit a Map, any optional parameter its Attitudes already use is ticked for you.
A parameter your Account no longer has still appears in a Map that uses it.
The checkboxes are disabled while any Attitude in the Map is locked.

New Accounts have these optional parameters:

Parameter	Unit	Converted by Map Units	What it does
Corner Radius	m, or mm	Yes	Curves the flow round a corner. 0, or blank, means straight flow. See simulate cornering
Front LHS Squash, Front RHS Squash, Rear LHS Squash, Rear RHS Squash	m	No	Tyre squash (deflection) for that wheel

A blank optional parameter uses the kinematic model's own default.

Other parameters. Kinematic models can respond to other parameters, such as Pitch or a flap angle, if they're added to your Account. A parameter that no part of the kinematic model uses is still stored with each Attitude and shown in the results, so you can use one as a label. It can also drive a boundary condition: see drive a boundary condition from a Map parameter.

Adding parameters¶

Your Account's Map parameters are set up by Bramble. Contact support@bramblecfd.com to add parameters to your Account, or to change how one works.

Column types¶

Each parameter's column takes one kind of value, set when the parameter is added to your Account.

Type	Cell	Notes
Number	Number input	The default. See number format
Options	Dropdown ("Select an option") with a clear button	Choose from a fixed list
Text	Free text	No number check
Checkbox	Tick box	On or off
List	Free text	A list of numbers, separated by commas or spaces
Attitude Specific Geometry	Usually a dropdown. The header's tooltip says "Attitude Specific Geometry"	Swaps Parts for that Attitude. See below

Maps created by the optimisation workflow also have deformation parameters. Their checkboxes are always disabled.

Number format¶

Number columns accept numbers with a decimal point only, with an optional leading minus: for example 0.5, -2 or 40. The Map shows: "SI numbers with decimal points only. Decimal commas and thousand separators (commas or spaces) are not allowed."

Not accepted	Write instead
`.5`	`0.5`
`1e-3`	`0.001`
`+2`	`2`
`05`	`5`
`1,000` or `1 000`	`1000`
`0,5`	`0.5`

Invalid cells are highlighted, and Save stays disabled until they're fixed.

Map Units¶

The Map Units: toggle switches between m and mm.

It applies to parameters that are converted by Map Units: Front RH, Rear RH and Corner Radius by default. Their headers show (m) or (mm). Other columns are unaffected.
Switching converts the values already in the table, and changes the ride-height limits to match.
Values are always saved in metres. The Map dialog opens in m every time.
It only affects the Map dialog, not units anywhere else in Bramble.

Set Map Units before you type, generate or import values. For all Bramble units, see coordinate system and units.

Names¶

Name	Rules
Attitude name (Name column)	Required. Up to 100 characters: letters, digits, spaces, `-` and `_`. Unique within the Map, ignoring leading and trailing spaces ("Some attitudes have duplicated names")
Map Name	Required. Up to 100 characters. Unique within the Programme. Letters, digits, spaces and most punctuation
Map Description	Optional. Up to 255 characters

Invalid Attitude names are highlighted in red. Generated Attitudes are named Attitude 1, Attitude 2, …, and a copied row starts with a blank name.

Following vehicles¶

If it's enabled for your Account, the Map dialog has a Following Vehicles section. Tick Use Following Vehicles and give each following vehicle a Longitudinal Offset and Lateral Offset in metres. The offsets apply to every Attitude in the Map. They're read-only while any Attitude is locked. Contact support@bramblecfd.com to have it enabled. See simulate following vehicles.

Attitude Specific Geometry¶

An Attitude Specific Geometry parameter swaps Parts for individual Attitudes. The value you choose in its column picks which version of a Part to use, for example a braking version of a Part instead of the standard one. Contact support@bramblecfd.com to set it up for your Account.