Handle a failed Attitude¶

When a stage fails, the Attitude stops and waits for you. Find the cause in the logs or checks, then reset the Attitude, skip the failed stage, or run part of the lifecycle again.

Before you start

The buttons are in the Transitions row of the Run's Summary tab, in the Attitude's column. Restricted Users don't see them.
For what each stage and status means, see statuses and lifecycle.

Find the cause¶

On the Summary tab, hover over the red icon to see which stage failed.
If it was Pre-Checks or Check the CFD solution, open the Run Checks tab. Failed checks list their messages under a bold heading. See the checks reference.
Otherwise, open the Logs tab:
1. Choose the Attitude's sub-tab.
2. Pick a log file from the list on the left. Type in Filter logs to narrow the list.
3. Read the file on the right. Click the refresh icon to reload it while a stage is running.

Which log to read. Start with stderr.log and the slurm-<job id>.out file for the HPC job, then the LOG-<step> file for the step that failed. The error is usually in the last few lines.

The list is empty ("No logs available") before the case is created, and after the Attitude has been reset or archived.

If the cause isn't clear, send the Run and Attitude name to support@bramblecfd.com.

Choose what to do¶

Failed stage	Usual action
Launch, with Insufficient Credits	Add credit, then click Insufficient Credits \| Reset and launch again
Create	Read the logs. For Star-CCM+, the column header also shows "Create Failed: …". Fix the Template Case or geometry, then Reset
Pre-Checks	Read the Run Checks tab. Fix the cause and use Rerun Prechecks or Reset. If the failure is expected, Skip Failed Task
Mesh & Solve	Read the logs, fix the cause, then Reset. Only skip it with care
Check the CFD solution	Run-on, if the workflow supports it, or Skip Failed Task to post-process anyway
Post-Process or Create Delta PostPro	Skip Failed Task to reach sign-off, then Re-run it later

Reset¶

Reset returns the Attitude to the start, ready to launch again. Use it after you've fixed the Template Case, geometry or CFD setup.

Click Reset.
In Reset Attitude, read the warning "All progress will be lost." and click Confirm.
The cell shows Resetting while Bramble tidies up. The Attitude then goes back to Pending, with Launch.

Reset:

deletes the case's geometry, mesh, solution and exports, and its post-processing outputs, including copies on the HPC cluster
clears the forces and results
returns any credits reserved for the Attitude, unless it has already been charged at Charge Account. See case lifecycle
unlocks the Parts, Template Case and Map entry, if no other case uses them, so you can edit them before you relaunch. See locking

It keeps the CFD setup, the PostPro setup, the checks template and comments.

You can also reset several Attitudes at once from Group Transitions → Reset. You can't reset an example Run.

Insufficient Credits | Reset resets the Attitude straight away, with no confirmation.

Skip Failed Task¶

Skip Failed Task marks the failed stage as skipped, and the lifecycle carries on to the next stage. The case files are kept. The stage then shows "Skipped failed task".

Use it when the failure doesn't matter, for example:

a pre-check that flags an intended change, such as a deliberate mesh-recipe change
a failed Check the CFD solution when the convergence plots are good enough and you want the postpro
a failed Post-Process or Create Delta PostPro when you want to sign off

For most stages it happens immediately. For a failed Mesh & Solve, Skip Failed Solve asks you to confirm, and warns that skipping "will likely result in the failure of remaining lifecycle actions". Check the logs first. Skipping a failed Mesh & Solve also moves the Attitude on to Charge Account, where any reserved credits are used.

There's no group Skip. Skip each Attitude separately.

Abort¶

Abort stops an Attitude that's queued or running.

Click Abort (or Group Transitions → Abort for several Attitudes).
In Abort Attitude, read the warning "You will not be able to continue the run without resetting it." and click Confirm.

Bramble stops the running stage and removes its jobs from the HPC queue. After an abort, the only option is Reset. The case files, and any reserved credits, stay until you reset.

Rerun pre-checks¶

To run Pre-Checks again, optionally with a different checks template, use Rerun Prechecks in the Pre-Checks row. It needs a role that allows it, and is only available before Mesh & Solve starts. See rerun pre-checks.

Re-run post-processing¶

Use Re-run to generate postpro again, for example after changing the Attitude's PostPro Setup, after changing Postpro Settings, or after skipping a failed post-processing stage.

Re-run is a small button inside the Post-Process cell and the Create Delta PostPro cell. It's available when:

the Attitude is waiting at Sign-off Case, or has been signed off, and
the Attitude isn't archived, and
for deltas, the stage isn't Waiting for the baseline.

It's disabled in example Projects. There's no group re-run.

On the Summary tab, in the Attitude's column, click Re-run in the Post-Process row, or in the Create Delta PostPro row for delta postpro.
In Rerun Postpro, choose:
- New only to generate only the selections that haven't been generated yet. Use it after adding items to the PostPro Setup.
- Rerun all to regenerate every selected item and overwrite the existing images, movies and data. Use it after changing cameras, Library entries or palettes, or if outputs look wrong.
Watch the stage go to Running, then Completed. The new outputs appear in Results.

Delta postpro uses the Run's current baseline and any extra deltas. Archived baseline Attitudes are skipped.

When post-processing finishes, the Attitude returns to its previous state. A signed-off Attitude doesn't need to be signed off again.