Build Packages / build:portable:linux-x86_64:nocuda (push) Successful in 16m43s
Build Packages / build:jfjoch:ubuntu2404:nocuda (push) Successful in 28m46s
Build Packages / build:jfjoch:rocky8:cuda-sls9 (push) Successful in 32m5s
Build Packages / build:jfjoch:rocky9:cuda (push) Successful in 39m44s
Build Packages / build:portable:macos-arm64:nocuda (push) Successful in 5m7s
Build Packages / Create release (push) Successful in 8s
Build Packages / Build documentation (push) Successful in 49s
Build Packages / build:portable:linux-x86_64:cuda (push) Successful in 22m30s
Build Packages / build:jfjoch:rocky8:nocuda (push) Successful in 31m54s
Build Packages / build:rugnux:linux-aarch64:cuda (push) Successful in 11m29s
Build Packages / build:portable:windows-x86_64:nocuda (push) Successful in 23m51s
Build Packages / build:jfjoch:ubuntu2204:nocuda (push) Successful in 26m7s
Build Packages / build:jfjoch:ubuntu2204:cuda (push) Successful in 29m38s
Build Packages / build:portable:windows-x86_64:cuda (push) Successful in 28m6s
Build Packages / HDF5 consumer tests (DIALS, XDS) (push) Successful in 29m44s
Build Packages / build:jfjoch:rocky9:nocuda (push) Successful in 33m22s
Build Packages / Generate python client (push) Successful in 47s
Build Packages / build:jfjoch:rocky9:cuda-sls9 (push) Successful in 34m6s
Build Packages / Unit tests (push) Successful in 1h2m47s
Build Packages / build:jfjoch:rocky8:cuda (push) Successful in 35m59s
Build Packages / build:jfjoch:ubuntu2404:cuda (push) Successful in 34m8s
Build Packages / Validation Battery (push) Successful in 38m31s
* Rugnux: Refinement several times faster, one protocol on the CPU and the GPU, parts of it on the Apple GPU; its random draws are the same on every platform. * Rugnux: Refinement follows common practice: the free set decides only the restraint weights and the displacement model (isotropic, TLS or anisotropic, by Hamilton's test), everything else is decided on the working set; lower R-free for placed and predicted models. * Rugnux: Restraint dictionaries via `--restraints` (or among the inputs) and more built-in ligands; a model whose space group is a subgroup of the data's is refined in its own group; reflections plus a model select `--mode refine` on their own. * Rugnux: `-C` fixes the crystal system on the axes as typed; `-S` alone fixes the space group only, the cell is still found and reduced; a space group or cell stored in the input file is ignored, with a line in the log. * Rugnux: More reliable multi-sweep merging; `--mode scale` merges several stills runs as one; `_plot.txt` and the report name each input; a second crystal form is reported for stills given a cell. * jfjoch_broker (experimental): Live Rugnux on FPGA detectors (JUNGFRAU) takes the same path as a DECTRIS stream, rotation and serial alike, model step included, with analysis threads per GPU; frames waiting for the analysis can be viewed; no host stage drops a frame - a source faster than the analysis is held at the card. * jfjoch_broker: Summation of more than 256 frames per image is split between the card and the host (`summation_mode` is then `hybrid`), and live Rugnux runs on such collections; pedestal runs take a receiver of their own. * jfjoch_broker (experimental): `stills_downsample` analyses 1 of every N serial images (chosen by a hash; the first 2000 all; the others written without analysis; reset to 1 by `/initialize`); `max_spot_count` left out means 250 for per-image indexing and up to 1000 for live stills; the live status gives the merge before the model work, the fitted resolution and the anomalous peak height of each unexplained blob. * jfjoch_broker: Without a `pcie` entry the broker runs on a mock of the card instead of the HLS simulation; its spot, ROI and azimuthal results are zero then. * Web frontend: Redesigned Rugnux live page; Vite 8, TypeScript 6, Mol* 5.13 and dependency security updates. * Tools: `jfjoch_fpga_stills_test` measures live stills on the cards with a stored dataset; `jfjoch_fpga_test` loses the HLS-simulation option. * Other: FFTW no longer fetched or linked (the CPU FFT indexer keeps the name `FFTW`); PCIe driver now GPL-2.0-or-later and third-party notices complete; several crash fixes. Reviewed-on: #98 Co-authored-by: Filip Leonarski <filip.leonarski@psi.ch>
100 lines
5.3 KiB
C++
100 lines
5.3 KiB
C++
// SPDX-FileCopyrightText: 2026 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
|
|
// SPDX-License-Identifier: GPL-3.0-only
|
|
|
|
#pragma once
|
|
|
|
// A model's structure factors, and the maps made from coefficients on its reflections, on the GPU (CUDA
|
|
// builds only). It is what model validation computes on the CPU - F_calc from the model's density on a
|
|
// grid (gemmi's DensityCalculator, IT92, the Refmac-compatible blur and its unblur) and F_mask from the
|
|
// bulk-solvent mask (gemmi's SolventMasker with the Refmac radii), each transformed and read off as
|
|
// prepare_asu_data() lists them; and the inverse transform of a set of map coefficients, as
|
|
// get_f_phi_on_grid() and MapFromFPhi() make it - moved to the device. The two agree to rounding, not
|
|
// bit for bit: float distances and cuFFT for pocketfft, and the crystal's symmetry is composed in reciprocal
|
|
// space (SymmetryComposition, RigidBodyRefine.h) instead of by symmetrizing the grid. The GPU is
|
|
// deterministic on its own.
|
|
//
|
|
// Made once for a cell, a group, a resolution and a model's atoms, then evaluated as often as the
|
|
// coordinates change: everything that depends only on the first four is worked out here, once, and
|
|
// the device buffers are reserved once. The atoms' B factors and occupancies are read at every
|
|
// evaluation, but the blur is the one the model had when the engine was made.
|
|
|
|
#include <complex>
|
|
#include <cstddef>
|
|
#include <memory>
|
|
#include <mutex>
|
|
#include <vector>
|
|
|
|
#include "gemmi/asudata.hpp"
|
|
#include "gemmi/dencalc.hpp" // DensityCalculator
|
|
#include "gemmi/grid.hpp"
|
|
#include "gemmi/it92.hpp"
|
|
#include "gemmi/model.hpp"
|
|
#include "gemmi/symmetry.hpp"
|
|
#include "gemmi/unitcell.hpp"
|
|
|
|
#include "ModelStructureFactorsGPUEngine.h"
|
|
|
|
// Each atom's density as PutModelDensityOnGrid() (ModelGrid.cpp) sets it up for `dc` - its d_min, rate
|
|
// and blur - in model order; and the atoms of the bulk-solvent mask as PutMaskOnGrid() takes them: each
|
|
// one's index in the model and its radius, probe included.
|
|
void ModelDensityAtoms(const gemmi::Model &model, const gemmi::DensityCalculator<gemmi::IT92<float>, float> &dc,
|
|
std::vector<ModelDensityAtom> &atoms, std::vector<int> &mask_atom,
|
|
std::vector<float> &mask_radius);
|
|
|
|
class ModelStructureFactorsGPU {
|
|
public:
|
|
// For `device`. Host work only: the grid, the reflections and what the device will need for them.
|
|
// Nothing is reserved until Reserve(), so DeviceBytes() can decide first whether to. Throws
|
|
// JFJochException where the device cannot be asked for its memory or its transform sizes. Every call works
|
|
// on `device` and leaves the calling thread's current device as it found it; which card it is does not
|
|
// change a number.
|
|
ModelStructureFactorsGPU(int device, const gemmi::Model &model, const gemmi::UnitCell &cell,
|
|
const gemmi::SpaceGroup &sg, double d_min);
|
|
~ModelStructureFactorsGPU();
|
|
|
|
// Whether the GPU reproduces this case: the gather needs every atom's box narrower than the cell.
|
|
bool Supported() const { return supported_; }
|
|
// The device memory Reserve() takes: the grid and its transform, the solvent mask's labels, the cuFFT
|
|
// work area and the reflections. The largest map Map() can be given shares the same buffers.
|
|
size_t DeviceBytes() const { return device_bytes_; }
|
|
double DMin() const { return d_min_; }
|
|
// The reflections Compute() gives F_calc and F_mask at.
|
|
size_t Reflections() const { return rows_.size(); }
|
|
int Device() const { return device_; }
|
|
// The device's total memory, which DeviceBytes() is to be judged against.
|
|
size_t DeviceTotalMemory() const { return device_total_; }
|
|
// The grid the structure factors are computed on.
|
|
std::array<int, 3> GridSize() const { return {setup_.grid.nu, setup_.grid.nv, setup_.grid.nw}; }
|
|
std::array<int, 3> MapSizeBound() const { return map_size_; }
|
|
|
|
// Reserves the device memory. Throws JFJochException on a CUDA failure.
|
|
void Reserve();
|
|
|
|
// F_calc and F_mask of `model` - the model this was made for, its atoms anywhere - as model validation's
|
|
// compute_model_factors() makes them: prepare_asu_data(d_min, blur) of the density and
|
|
// prepare_asu_data(d_min) of the mask. Throws JFJochException on a CUDA failure. Safe to call from
|
|
// several threads; they take turns.
|
|
void Compute(const gemmi::Model &model, gemmi::AsuData<std::complex<float>> &fcalc,
|
|
gemmi::AsuData<std::complex<float>> &fmask);
|
|
|
|
// The real-space map of ASU coefficients on this engine's reflections, as model validation's
|
|
// map_from_coefficients() makes it: on the grid get_size_for_hkl(coef, {0, 0, 0}, 3.0) sizes. Sorts
|
|
// `coef`. Throws JFJochException on a CUDA failure. Safe to call from several threads; they take turns.
|
|
gemmi::Grid<float> Map(gemmi::AsuData<std::complex<float>> &coef);
|
|
|
|
private:
|
|
int device_;
|
|
size_t device_total_;
|
|
gemmi::UnitCell cell_;
|
|
const gemmi::SpaceGroup *sg_;
|
|
double d_min_;
|
|
gemmi::DensityCalculator<gemmi::IT92<float>, float> dc_;
|
|
ModelStructureFactorsGPUSetup setup_;
|
|
std::vector<gemmi::Miller> rows_;
|
|
std::array<int, 3> map_size_{};
|
|
bool supported_ = false;
|
|
size_t fft_work_bytes_ = 0, device_bytes_ = 0;
|
|
std::unique_ptr<ModelStructureFactorsGPUEngine> engine_;
|
|
std::mutex m_;
|
|
};
|