~/aixsci
200 records · all checked

structural-biology/ai produced the result/Acta Crystallographica Section D Structural Biology 2025 · v2

Neural network fills gaps in protein maps from raw diffraction data

Researchers trained a model called CrysFormer to produce protein electron-density maps from two inputs: a Patterson map computed from diffraction data, and an incomplete predicted template with several residues missing.

1. Curate PDB fragments2. Compute Patterson and ground-truth maps3. Build incomplete AFDB partial-structure templates4. Train CrysFormer on map triples5. Predict completed electron-density maps6. Evaluate maps against ground truth and SIGMAA baseline

spectrum · one line per step, placed by what the step does · bright lines used AI

Completion of partial structures using Patterson maps with the CrysFormer machine-learning model
Acta Crystallographica Section D Structural Biology, 2025

doi:10.1107/s2059798325009659 · record aix-00171 v2 · checked 2026-10-09

ai-resultrole of AI
AI was for
Structure determination
Model family
Transformer, Convolutional neural network
Checked by
Held-out176556 tested
Code
available

The finding the paper is about came from the AI.

read as

The science is explained before the AI appears. Switch to field specialist to go straight to the method.

Assumes the discipline and goes straight to the method.

The diagram, the record and what the paper did not report are identical in both modes. Only the framing changes — never the evidence.

Introduction by AIxSci · plain language

What this research was about

Diagram showing the overall architecture of the CrysFormer machine-learning model.
Overview of the CrysFormer model architecture.Figure 1 from Pan et al., Acta Crystallographica Section D Structural Biology 2025 · source · CC BY · resized

To work out the shape of a protein, crystallographers shine X-rays through a crystal of it and record how the beams scatter. The snag is that the detector measures only how strong each scattered beam is, not the timing, or phase, of its wave. Both are needed to rebuild a map of where the electrons sit, and from that the positions of the atoms. One standard trick is to start from a rough guess of the structure, borrowed from a related protein or a computed prediction, and use it to estimate the missing phases. If the guess is incomplete, the resulting map tends to be poor in exactly the regions nobody has guessed yet.

This work tackles that gap-filling step. The researchers built a large collection of short protein pieces, fifteen amino-acid units long, taken from structures already solved by X-ray crystallography. For each piece they computed a Patterson map, a quantity derived straight from the measured intensities without any phase information, and a matching template map built from an AlphaFold Database prediction with a run of three to seven of its fifteen residues deliberately deleted. The question was whether a model could turn that pair into the full map.

Where AI came in

CrysFormer, a hybrid of a three-dimensional vision transformer and a convolutional network, does the central work. It was trained from scratch on pairs of Patterson maps and true electron-density maps, together with the deliberately incomplete templates, and learned to output the full map. The model takes the place of the conventional calculation that would normally be used to improve a partial structure's phases, and in that sense it stands in for an existing piece of crystallographic software rather than for a human judgement.

The surrounding steps were done with ordinary tools: software computed the Patterson and reference maps, matched each fragment to a predicted structure and aligned the two, and afterwards scored the model's maps against the known answer. On a held-out test set of 176,556 examples, the paper reports higher agreement with the true density and smaller phase errors for the model's output than for the same templates processed with the established SIGMAA procedure. The code and data are available.

Written by AIxSci from the checked record below, to give context for readers outside the field. It is not part of the record.

The work

Technical · from the record

Diagram showing the overall architecture of the CrysFormer machine-learning model.
Overview of the CrysFormer model architecture.Figure 1 from Pan et al., Acta Crystallographica Section D Structural Biology 2025 · source · CC BY · resized

The authors trained CrysFormer, a hybrid 3D vision transformer and CNN, to output protein electron-density maps from two inputs: a Patterson map computed directly from simulated diffraction data, and an incomplete template map derived from an AlphaFold Database prediction with 3 to 7 of its 15 residues removed. Training used a synthetic data set of 15-residue fragments in P21 unit cells, built from 589 546 Patterson map and ground-truth density pairs expanded to 1 634 839 examples by generating up to three different residue-omission patterns per pair. On a held-out test set of 64 070 initial examples, the paper reports higher in-model-region Pearson correlation with the ground truth and lower unweighted and FOM-weighted phase errors for the model predictions than for the same partial-structure templates processed with the SIGMAA PARTIAL baseline, both over the full test set and over a 19 436-example subset with the poorest alignment of the AlphaFold-derived template to the ground truth. Pearson correlations of the predictions showed no apparent dependence on the solvent content of the ground-truth unit cell.

How AI was used

A single learned model does the central work. 15-residue fragments were extracted from a basis of nearly 38 000 curated PDB structures, placed in P21 unit cells, and used to compute structure factors with gemmi sfcalc and then Patterson and ground-truth electron-density maps with the CCP4 FFT program at resolution limits binned across 1.75-2.3 A. Matching AlphaFold Database v4 predictions were located through UniProt identifiers from PDBe SIFTS, aligned to each fragment by Needleman-Wunsch sequence alignment and then by structural alignment with the PyMOL align command as a stand-in for molecular-replacement placement, and had a randomly chosen contiguous block of 3 to 7 residues removed from one or both ends to form partial-structure template maps. CrysFormer, a 3D vision transformer with Nystrom approximate attention combined with scale-equivariant 3D convolution and batch-normalisation layers, was then trained from scratch to regress the ground-truth density from the Patterson map and the single same-sized partial-structure template, using mean-squared error plus a negative Pearson correlation term, a Schedule-Free AdamW optimiser under a OneCycle schedule, and data-parallel training over two GPUs. The trained model was run over the held-out test examples, and its predicted maps and derived structure factors were scored with Phenix get_cc_mtz_pdb and CCP4 CPHASEMATCH against the same templates improved by the non-learned SIGMAA PARTIAL procedure.

The shape of the work

Structural · the record, drawn

ACQUISITIONPREPARATIONPREPARATIONTRAININGINFERENCEVALIDATION123456AIAICurate PDBfragmentsCompute Pattersonand ground-truthmapsBuild incompleteAFDBpartial-structur…Train CrysFormeron map triplesPredict completedelectron-densitymapsEvaluate mapsagainst groundtruth and SIGMAA…↤ conventional algorithm↤ conventional algorithm
AI stepNo AI↤ what the AI stood in for
1Acquisition
no AI

Curate PDB fragments

Obtaining raw data, whether by measurement, download or retrieval.

extracted all possible 15-residue fragments without randomly removing any obtained oneswhere the paper describes this · verbatim
in the paper
2Preparation
no AI

Compute Patterson and ground-truth maps

Cleaning, filtering, normalising or labelling data already obtained.

We again generated structure factors for each example in its final P21 unit cell with the gemmi sfcalc programwhere the paper describes this · verbatim
in the paper
3Preparation
no AI

Build incomplete AFDB partial-structure templates

Cleaning, filtering, normalising or labelling data already obtained.

We then removed a subset of the residues from the AlphaFold fragments via a sequence of 2–3 random selectionswhere the paper describes this · verbatim
in the paper
4Training
AI

Train CrysFormer on map triples

Fitting model parameters, including fine-tuning an existing model. The AI stood in for conventional algorithm.

We performed a single training run of our model on a training set of 589 546 initial Patterson map–ground truth electron-density pairswhere the paper describes this · verbatim
in the paper
5Inference
AI

Predict completed electron-density maps

Running a trained model over new data to predict, classify or score. The AI stood in for conventional algorithm.

the predictions made by our model with the results after applying SIGMAA to the corresponding incomplete partial structure templates on our test exampleswhere the paper describes this · verbatim
in the paper
6Validation
no AI

Evaluate maps against ground truth and SIGMAA baseline

Testing outputs against ground truth.

we use the get_cc_mtz_pdb program from the Phenix program suite (Liebschner et al., 2019) to calculate the Pearson correlation coefficientwhere the paper describes this · verbatim
in the paper

What the record says

Technical · every part carries its own basis

+ in the paper~ our reading− not reported

How to read the quotations. A quotation shows where the paper describes something. It does not quote every value beside it: one passage locates a part of the work, and values without their own quotation are our reading of that passage.

~Role of AI
AI produced the resultour reading

The reported result is the electron-density maps produced by the trained model from Patterson maps and incomplete templates; without the model there is no result.

+What the AI was for
a hybrid 3D vision transformer and convolutional neural network (CNN) can be trained to complete and improve the templateswhere the paper describes this · verbatim
+Model families
+How it was taught
Supervisedin the paper
+Models named
CrysFormer · Trained from scratchin the paper
+How results were checked
Held-out176556 testedin the paper
once again with each associated by up to three partial structures with 3–7 omitted residues, for a total size of 176 556 exampleswhere the paper describes this · verbatim
+Code · weights · data
code availableweights not reporteddata availablein the paper
A repository, https://github.com/sciadopitys/CrysFormer_model_completion, contains our CrysFormer model architecture and training and batch-generation scriptswhere the paper describes this · verbatim
+Compute
Trained for 71 epochs in data-parallel fashion on a pair of RTX 6000 Ada GPUs with 48 GB memory eachin the paper

What this paper did not report

Technical · absence is published deliberately

Reported as not stated — 2 items
  • Trained model weightsWhether the trained model is available is not stated.
  • Version of CrysFormerWhich version of the model was used is not stated.

About this article

Record aix-00171, version 2, checked by a person on 2026-10-09. The record describes the paper; it does not assess whether the paper's findings are right. The paper is published under CC-BY; quotations are at most 25 words. How we work · Report an error