Locking¶

Once a simulation has used a Part, Assembly, Template Case, Map or Kinematic Setup, Bramble locks it so it can't be changed or deleted. To make changes, you copy it and change the copy.

Why Bramble locks things¶

Reproducible results. A finished Attitude's results should always match the inputs it records. If a Template Case or Assembly could change after a Run had used it, you could no longer tell what produced those results, or run them again.

Trustworthy comparisons. Comparing against a baseline only works if you know exactly what changed. Because the baseline's inputs can't change, a change always shows up as a difference:

On the CFD Setup tab. Each Attitude is compared with the baseline Attitude of the same name. If the methodology, workflow or Template Case differs, the cell shows the baseline value in red, for example "(Baseline - <baseline value>)". Template Cases are compared by name, so a copied Template Case is always flagged. Compare Template Case then shows exactly which settings differ. See CFD setup options.
In the pre-checks. The Compare Mesh Recipe check, in the Modification checks templates, fails if any zone's mesh settings differ from the baseline, or if a new zone has no mesh recipe. That catches an accidental mesh change before the case uses HPC time. See checks.

What locks, and when¶

Locking is automatic, and happens when you launch an Attitude.

Item	Locks when	Unlocks when
Assembly	An Attitude in a Run that uses it is launched and reaches Create	Every Attitude in every Run that uses it has been reset or deleted
Part	An Assembly containing it locks. Parts swapped in by Attitude Specific Geometry lock too	No locked Assembly contains it
Template Case	An Attitude that uses it is launched and reaches Create	Every Attitude that uses it has been reset or deleted
Map (per Attitude row)	The Attitude made from that row is launched and reaches Create	Every Attitude that uses the row has been reset or deleted
Kinematic Setup	A Run that uses it is launched	No launched Attitude uses it any more
Kinematic Model	A locked Kinematic Setup uses it, or more than one Kinematic Setup uses it	Neither is true any more
Deformation volume	It's used in a Run, for example an optimisation run	—

A Part Library or Assembly Library that contains anything locked can't be deleted.

The one exception: duplicating a Run that has results locks the new Run's Parts straight away.

Reset and delete unlock

Resetting or deleting an Attitude is the only way to unlock something. It unlocks only when no other Attitude still depends on it. See statuses and lifecycle.

What you can't do while it's locked¶

Item	While locked
Part	Can't be deleted. The delete button shows a lock, "Cannot be edited as it has been used in a simulation". The kinematics settings in Edit Part are disabled. You can still change its Name and Description
Assembly	Can't be deleted ("This assembly cannot be deleted as it has been used in Runs"). Add Parts is disabled and Parts can't be removed. The 3D viewer title shows "(Locked Assembly)"
Template Case	Can't be deleted ("This template case is locked"). The editor says "Template Case is locked, cannot be edited": tables are read-only and the file opens with View File. You can still change the name and description, and the Active switch
Map	Locked rows are read-only. Populate Using CSV and the Map Configuration buttons are disabled ("This map is locked"), and the Map can't be deleted ("Map is locked")
Kinematic Setup	Opens with View Kinematic Setup instead of edit. Save is disabled ("Kinematic setup is locked") and it can't be deleted
Kinematic Model	Can't be deleted
Deformation volume	Opens as Viewing Volume, read-only, and can't be deleted ("Volume is in use and cannot be deleted"). Its parameters can't be deleted. See morphing

Making changes: copy it¶

Each lockable item can be copied. The copy starts unlocked, and the original stays as it was, so existing results still match their inputs.

Item	How to copy
Template Case	The copy icon ("Create a copy of this template case") in the Template Cases table, or Create Copy on a Run's CFD Setup tab, which also assigns the copy to that Attitude. See copy a Template Case
Assembly	Create Copy in the Assemblies table. The copy refers to the same Parts. See copy an Assembly
Part	Usually not needed: locking only stops you deleting it and changing its kinematics settings. To get a separate copy, transform it with a zero translation, or upload the file again
Map	Create Copy in the Maps table. Every row in the copy is unlocked
Kinematic Setup	Create Copy in the table on the Kinematic Setups page
Deformation volume	Import Volume in the Morphing panel imports a copy you can edit. See create a deformation volume