ProteinPilot AIPDlab
Action▼
Chains▼
Chain — new blocks go here
Connect▼

Select an element to edit its properties.

Turn on Loop Adjacency, then click a loop, helix, strand or masked block to inspect its residues.

Ready — choose a tool, then click the canvas

Import .pt

1 · Tensors
ss.pt required
no file
adj.pt optional
no file
Choose an ss.pt file — adj.pt adds the block adjacencies.
2 · What the tensors don't carry
ss.pt is one flat array and adj.pt is one contact matrix — neither records chain breaks, and neither records where a motif came from. The contig is the only place that lives.
Contig
Chain breaks are /0; a token with a chain letter (A12-25) is a fixed motif, a bare span (16-16) is diffused.
Motif source structure
Written onto every restored motif, and used as inference.input_pdb in the .sh.
Design name
Leave empty to keep the name already set.
3 · Result
Load an ss.pt to see what will be built.
Where it goes
Adds the imported blocks to what is already on the canvas.

Import Structure

Structure Scaffold — the chain is decomposed into helix / sheet blocks; pick the ones to keep and they come in with their residues fixed.
No file loaded yet.

Fixed Residues & Ligands

Click a residue in the viewer to fix it (shown in rose), or type residues below. Written into the RFD3 .json only — it has no effect on RFD1 exports and does not change ss.pt / adj.pt.
Fixed residues — contig-style, e.g. A514,A531,A574,A579-581

RFdiffusion 3 Flags

Number of designs — inference.num_designs
Checkpoint — inference.ckpt_override_path
Diffusion steps — diffuser.T
Loops — scaffoldguided.mask_loops
Sampling noise — denoiser.noise_scale_ca / _frame
Toggles
Extra flags — one per line, added verbatim to the .sh
Anything here is appended to the run-inference command in the generated script.
Environment
HARMONIA checkout — $HARMONIA in the .sh
The clone that holds foundry/ and checkpoints/.
Python interpreter — the env RFD3 / AtomWorks is installed in
Checkpoint — ckpt_path
Leave empty for the HARMONIA epoch-698 checkpoint (phase 10) — its ss_adapter / adj_adapter weights are trained, so it reads ss.pt / adj.pt. A checkpoint without those trained weights ignores the conditioning entirely.
Scaffold dir — where ss.pt / adj.pt live on the cluster
Written into the .json as ss_file / adj_file, and re-resolved by the .sh so the two can never drift apart.
Sampling
n_batches
diffusion_batch_size
inference_sampler.num_timesteps
inference_sampler.step_scale
Classifier-free guidance
cfg_scale — 1.5–3.0 is typical. The unconditional pass masks SS and zeroes ADJ, so this is the knob that tightens fold adherence.
Run toggles
Conditioning — written into the .json
Fixed residues & ligands
none
Guideposts placed freely by RFD3 — they do not change ss.pt / adj.pt.
ss_ratio — global sheet fraction E/(H+E)
is_non_loopy
Scaffold expansion — RFD1-style masked rebuilding
sampled_insertion
sampled_N
sampled_C
ss_mask
All zero by default. N samples 0–N, A-B samples that range. Anything non-zero changes the token count, so RFD3 recomputes length itself and the length check below no longer applies.
Extra overrides — one per line, appended verbatim to the run command
Hotspot residues — ppi.hotspot_res (e.g. A30,A33,A34)
Target residues the binder should contact. Leave empty to omit — nothing is added automatically. Fill from canvas writes the residues of every target motif you linked to a binder block into the field, where you can edit or clear them.
Target structure path — the imported target
Motif structure path — the file the fixed residues are copied from
Set by your drawing
Flags preview

Export Figure

Background

Zoom

Scroll over the preview to zoom. It is for inspection only — the PNG is written at the resolution below.

Resolution

How to use — ProteinPilot

Sketch a protein binder as a 2D topology of secondary-structure blocks, then export the RFdiffusion scaffold tensors (ss.pt / adj.pt) and a ready-to-run .sh script — for RFdiffusion3 (HARMONIA SS/ADJ) or RFdiffusion1.

Placing blocks

  • Pick a tool (Helix, Strand, Masked, or a Target variant), then click the canvas to place it.
  • Click an existing block to select it · drag to move it.
  • Drag on empty canvas to marquee-select; Shift+click adds to the selection.
  • Every helix/strand runs N (top) → C (bottom). Use Flip 180° in the properties panel to swap ends.

Connecting

  • Loop: click a block's N/C port, then another — a loop must join a C-terminus to an N-terminus (N–N or C–C is rejected).
  • Adjacency: mark two blocks as spatially adjacent (β-sheet pairing / helix packing).
  • Proximity Adjacency: auto-link every pair of blocks whose circles overlap.
  • Clicking a loop or adjacency brings it to the front of the viewer.

Canvas

  • Grid: toggles a snap grid — helix/strand centres lock onto the crossings.
  • Move: drag anywhere to shift the whole design together.
  • Scroll to zoom · Space+drag or middle-mouse to pan · Del deletes · Esc cancels · Ctrl+Z / Ctrl+Y undo/redo.

Exporting

  • RFD3 / RFD1 (topbar switch): which RFdiffusion the exports target. RFD3 is the default and writes for the HARMONIA SS/ADJ checkpoint (epoch-698); RFD1 writes the original scaffoldguided script.
  • Flags: run options for whichever engine is selected — the panel swaps with the switch.
  • Download .pt: the ss.pt / adj.pt scaffold tensors. Both engines read the same files.
  • Download .json (RFD3 only): the input specification that names those tensors, plus the contig, length and hotspots.
  • Download .sh: the run script. Under RFD3 it is a SLURM launcher that resolves the .json against its own SCAFFOLD_DIR; under RFD1 it is the apptainer script as before.
  • If any block uses a length range, all of these switch to a sweep: RFD1 loops in the shell, RFD3 writes one .json key per length variant.
  • Figure: save the 2D or 3D view as a transparent-background PNG.
  • Import PDB/CIF: auto-detect helices/strands/loops and adjacencies from a structure.

3D Topology Preview

Legend

Show

Adjacency Map — adj.pt

Adjacencies
Adj (1) — drawn contact
Loop adj — contact touching a loop; support depends on the checkpoint
Masked adj (2) — no claim; all imported structure
No adj (0) — asserted non-contact
Secondary structure
H helix
S sheet
L loop
M masked
  imported structure — pinned or guidepost
Residues N→C, binder then target. Blocks carry their real fold — masked ones seafoam; anything from an imported file is rose, so provenance reads before secondary structure. Target blocks are labelled by chain letter (A, B…). Everything imported defaults to masked adj — its real contacts are in the file, not in this drawing, so asserting "no adj" for them would claim something you never said. Only pairs you draw become adj. Hover for details.