@@ -1480,3 +1480,48 @@ Boundary:
|
||||
|
||||
- 0.5.3 documents audit and diagnostic interfaces. It does not claim complete
|
||||
industrial AL/mortar consistent tangent support.
|
||||
|
||||
## 19. 0.6.0 Lifecycle Interface Addendum
|
||||
|
||||
Fortran diagnostic API:
|
||||
|
||||
```fortran
|
||||
subroutine fem_get_nl_lifecycle_snapshot(step, increment, iteration, &
|
||||
event_id, event_name, reason_id, reason_name, ierr)
|
||||
|
||||
subroutine fem_get_nl_lifecycle_arc(load_factor, arc_residual, &
|
||||
path_appended, ierr)
|
||||
|
||||
subroutine fem_get_nl_lifecycle_audit(status_id, status_name, &
|
||||
begin_trial_count, rollback_requested_count, rollback_ok_count, &
|
||||
rollback_failed_count, commit_ok_count, ierr)
|
||||
```
|
||||
|
||||
The lifecycle event names are `none`, `increment-begin`, `trial-begin`,
|
||||
`iteration-begin`, `iteration-result`, `accept`, `reject`, `cutback`,
|
||||
`commit` and `rollback`.
|
||||
|
||||
The audit status names are `none`, `begin-trial`, `rollback-requested`,
|
||||
`rollback-ok`, `rollback-failed` and `commit-ok`.
|
||||
|
||||
CSV/output schema:
|
||||
|
||||
- `continuation_path.csv` keeps all previous columns in the same order.
|
||||
- 0.6.0 appends `lifecycle_event_id`, `lifecycle_event_name`,
|
||||
`lifecycle_audit_status`, `lifecycle_audit_name`,
|
||||
`lifecycle_increment`, `lifecycle_iteration`,
|
||||
`lifecycle_accept_count` and `lifecycle_reject_count`.
|
||||
|
||||
Restart schema:
|
||||
|
||||
- Restart files written by 0.6.0 use restart version 5.
|
||||
- Version 5 may append an optional `LIFECYCLE_DIAGNOSTICS` line before `END`.
|
||||
- Readers still accept older files, and also accept restart files that do not
|
||||
include the lifecycle diagnostics line.
|
||||
|
||||
Boundary:
|
||||
|
||||
- The 0.6.0 lifecycle interface exposes diagnostics and rollback audit state.
|
||||
It does not expose a new C ABI lifecycle wrapper yet, and it does not claim
|
||||
complete AL/mortar tangent, mixed-control continuation or cohesive mainline
|
||||
support.
|
||||
|
||||
Reference in New Issue
Block a user