// SPDX-FileCopyrightText: 2026 Filip Leonarski, Paul Scherrer Institute // SPDX-License-Identifier: GPL-3.0-only #pragma once #include "gemmi/grid.hpp" #include "gemmi/recgrid.hpp" // The structure factors of a real-space map on the model path (Fcalc from the model density, Fmask // from the bulk-solvent mask): what gemmi::transform_map_to_f_phi(map, true) returns - the // conjugated forward transform (F = sum rho exp(+2 pi i h.x)) scaled by V/N, kept for l >= 0 on an (nu, nv, nw/2+1) grid in the map's own XYZ order, // ready for prepare_asu_data() - computed with common/CpuFFT, its lines split over `nthreads` (the same result on any // number). Safe to call from several threads at once. gemmi::FPhiGrid MapToFPhi(const gemmi::Grid &map, size_t nthreads = 1); // The inverse: the real-space map of an (nu, nv, nw/2+1) half-l coefficient grid in XYZ order, as // get_f_phi_on_grid() fills it - what gemmi::transform_f_phi_grid_to_map() returns (rho = 1/V sum F // exp(-2 pi i h.x) on an (nu, nv, 2*(nw-1)) grid, NaN coefficients read as zero). gemmi::Grid MapFromFPhi(const gemmi::FPhiGrid &hkl); // MapFromFPhi's transform itself, for a caller that fills its input: `in`, the (nu, nv, nw/2+1) half-l coefficients // u fastest as MapFromFPhi transforms them (conjugated, a NaN as zero), is overwritten, and `out` receives the // (nu, nv, nw) map before MapFromFPhi's 1/V. void MapFromFPhiExecute(int nu, int nv, int nw, std::complex *in, float *out, size_t nthreads = 1); // CropHalfL(MapToFPhi(map), reach) on `nthreads` threads, for a map of hundreds of millions of points (the // molecular transform's box), whose single-threaded transform is minutes of CPU: the r2c along w of every // (u, v) column, then the 2D transform of every plane l <= reach. The threads split the lines of a transform, each // line transformed as it would be alone, so the result does not depend on the thread count. gemmi::FPhiGrid MapToFPhiInParallel(const gemmi::Grid &map, int reach, size_t nthreads); // The half-l grid `full` with only the indices |k|, l <= reach kept, on a grid of full.nu x (2 reach + 1) x // (reach + 1) that an index wraps into as it wraps into the whole one (the molecular transform's, which is // read no further out). gemmi::FPhiGrid CropHalfL(const gemmi::FPhiGrid &full, int reach);