Rugnux live: the uploaded model is refined after placement; refined scores, model, maps and blobs in the status, the viewer and the hero

The live run refines a placed model as `rugnux` does (ProcessConfig::refine), after every decision
and before the end message; a cut before it starts leaves it out, as the model. The writer still
gets the placed model; the refined one stays with the broker.

API (broker/jfjoch_api.yaml):
- rugnux_live_model.refinement (rugnux_live_refinement): performed, reason, on_gpu, seconds, r_work,
  r_free, rmsd_bonds_A, rmsd_angles_deg, blob_count, blobs (at most 50, rugnux_live_blob: kind, x, y,
  z, peak_sigma, volume_A3, nearest_atom, nearest_atom_distance_A)
- rugnux_live_status.refined_model
- /rugnux/model.cif and /rugnux/map.ccp4 take stage=placed|refined, by default the refined model
  where there is one; the anomalous map stays on the placed model's phases (the refined
  coefficients carry none).
Regenerated broker/gen, frontend/src/client, redoc, and the python client docs (which also brings
the hero fields and rugnux_live_model it was missing).

Frontend: the model card keeps its green/red and gets "R-free 0.xx (refined)" as its context line,
"refining..." while the step runs; the model section adds refined R-free and blob tiles; Mol*
shows the refined model and maps, with the blobs as small spheres coloured by reading (switch, off
at first). The Refinement step is in the timeline like any other.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015CeEGgpKdfkCTJb3YNMJcu
(cherry picked from commit 3b47fb9a53b7dfad1c1ed289e169094c8d3d9d3e)
This commit is contained in:
leonarski_f committed 2026-10-26 01:38:25 +01:00
1 parent 7bf906e4a2
commit baec34685d
36 files changed
+1664 -74

No files matched your search

@@ -0,0 +1,39 @@
# RugnuxLiveRefinement
The placed model refined against the merge it was placed on, as the report's REFINE_ keys state it. Set where a placed model was refined or its refinement failed; absent where the model was not placed, or refinement is off (it runs only with a GPU in live mode).
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**performed** | **bool** | Refinement ran to the end; false with &#x60;reason&#x60; where it failed |
**reason** | **str** | Why refinement did not run to the end; empty otherwise |
**on_gpu** | **bool** | |
**seconds** | **float** | Wall time of the refinement |
**r_work** | **float** | R-work of the refined model (after the restrained stage, else after the rigid body and grouped B) | [optional]
**r_free** | **float** | R-free of the refined model, on the same reflections as &#x60;r_work&#x60; | [optional]
**rmsd_bonds_a** | **float** | RMS deviation of the bond lengths from the dictionary, where the restrained stage ran | [optional]
**rmsd_angles_deg** | **float** | RMS deviation of the bond angles from the dictionary, where the restrained stage ran | [optional]
**blob_count** | **int** | Unexplained blobs of the refined model&#39;s mFo-DFc map (above 3 sigma, peaking above 4) |
**blobs** | [**List[RugnuxLiveBlob]**](RugnuxLiveBlob.md) | The strongest blobs, at most 50, strongest first |
## Example
```python
from jfjoch_client.models.rugnux_live_refinement import RugnuxLiveRefinement
# TODO update the JSON string below
json = "{}"
# create an instance of RugnuxLiveRefinement from a JSON string
rugnux_live_refinement_instance = RugnuxLiveRefinement.from_json(json)
# print the JSON string representation of the object
print(RugnuxLiveRefinement.to_json())
# convert the object into a dict
rugnux_live_refinement_dict = rugnux_live_refinement_instance.to_dict()
# create an instance of RugnuxLiveRefinement from a dict
rugnux_live_refinement_from_dict = RugnuxLiveRefinement.from_dict(rugnux_live_refinement_dict)
```
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)