Files
leonarski_f aecd48b9d3
Build Packages / Build documentation (push) Successful in 48s
Build Packages / build:portable:linux-x86_64:nocuda (push) Successful in 15m47s
Build Packages / build:portable:linux-x86_64:cuda (push) Successful in 23m19s
Build Packages / build:portable:windows-x86_64:nocuda (push) Successful in 18m47s
Build Packages / build:portable:macos-arm64:nocuda (push) Successful in 5m54s
Build Packages / build:rugnux:linux-aarch64:cuda (push) Successful in 11m27s
Build Packages / build:jfjoch:ubuntu2204:cuda (push) Successful in 26m59s
Build Packages / Unit tests (push) Successful in 1h50m25s
Build Packages / Validation Battery (push) Successful in 46m38s
Build Packages / build:jfjoch:rocky8:nocuda (push) Successful in 32m52s
Build Packages / build:jfjoch:rocky9:nocuda (push) Successful in 32m32s
Build Packages / build:jfjoch:ubuntu2204:nocuda (push) Successful in 28m34s
Build Packages / build:jfjoch:ubuntu2404:nocuda (push) Successful in 29m19s
Build Packages / build:jfjoch:rocky8:cuda-sls9 (push) Successful in 30m11s
Build Packages / build:jfjoch:rocky9:cuda-sls9 (push) Successful in 33m58s
Build Packages / build:jfjoch:rocky8:cuda (push) Successful in 31m26s
Build Packages / build:jfjoch:rocky9:cuda (push) Successful in 34m4s
Build Packages / HDF5 consumer tests (DIALS, XDS) (push) Successful in 32m17s
Build Packages / Generate python client (push) Successful in 32s
Build Packages / Create release (push) Successful in 9s
Build Packages / build:jfjoch:ubuntu2404:cuda (push) Successful in 31m50s
Build Packages / build:portable:windows-x86_64:cuda (push) Successful in 19m38s
v1.0.0-rc.186 (#97)
* jfjoch_broker (experimental): Live Rugnux covers serial collections from DECTRIS detectors; a rotation collection too large for the image buffer falls back to standard per-image processing with a warning, and a stream that ends without its end message finishes the collection instead of hanging it.
* jfjoch_broker (experimental): Live Rugnux settings to build the solvent during refinement and to process a rotation collection as stills, a Clear action for the last result, a `_report.txt` for live rotation runs, R-free reported for the refined model, and ice-ring detection on by default for rotation as in the command line.
* jfjoch_broker (experimental): More complete and reproducible live serial merges, analysed for twinning, pseudo-translation and anisotropy, with merging statistics by resolution shell in the live status.
* jfjoch_writer: Live results with large models are written reliably; update jfjoch_writer together with jfjoch_broker.
* Rugnux: Several masters can be processed together with `--force-still`, including grid scans; more robust and faster merging of several sweeps; improved twinning, pseudo-translation, anisotropy, anomalous-signal and space-group decisions.
* Rugnux: Molecular replacement places the copies of a multi-copy solution together; the pseudo-translation warning quotes the Patterson peak and is not raised once a model is placed; the report advises on extending the rotation or reorienting the crystal where the coverage would gain from it.
* Web frontend: Light and dark modes, a phone layout, a hideable page list, a redesigned Rugnux live page with step-through of the Fo-Fc peaks in the structure view.
* jfjoch_viewer: A broker URL given on the command line follows the running collection.

Reviewed-on: #97
Co-authored-by: Filip Leonarski <filip.leonarski@psi.ch>
2026-11-13 20:13:43 +01:00

57 lines
3.5 KiB
C++

// SPDX-FileCopyrightText: 2026 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
// SPDX-License-Identifier: GPL-3.0-only
#pragma once
#include <optional>
#include <vector>
#include <gemmi/symmetry.hpp>
#include "../../common/Coord.h"
#include "../../common/CrystalLattice.h"
#include "../../common/GoniometerAxis.h"
// What a rotation sweep can still gain: the fraction of the unique reflections to d_min that the
// sweep [start, end] brought through the Ewald sphere, in this crystal's actual orientation and
// point group, and the same fraction for every extension of the sweep up to a full turn. The
// counterpart of SpindleCuspLoss for a sweep of finite length: that answers what no length of sweep
// can recover (the blind double cone about the spindle), this answers how much of the rest is in.
//
// A unique reflection is measured when any member of its orbit under the proper rotations of the
// point group, with Friedel's inversion, crosses the sphere inside the sweep. The crossing angles are
// exact (the two roots of |R(-phi) s + S0| = |S0|), the unique reflections are sampled uniformly
// over reciprocal space to d_min (directions on a spiral, radii at the volume quantiles), so the
// fractions are geometric and carry no measurement noise: a merge's completeness falls short of
// them by what the detector, the integration and the rejections lost.
struct SweepCoverageForecast {
double measured_fraction = 0; // brought through the sphere by [start, end]
double asymptote_fraction = 0; // by any sweep: 1 - SpindleCuspLoss::lost_unique_fraction
// fraction_at[k]: by [start, end + k degrees], k = 0..360
std::vector<double> fraction_at;
// The least extension, in degrees, that reaches the target fraction; none where no extension does.
std::optional<double> DegreesTo(double target_fraction) const;
};
// The goniometer angles, in [0, 360), at which the reciprocal point s (the crystal at angle 0) is in
// reflecting position: the crystal turned by -phi about the unit spindle u, as GetTransformationAngle(-phi)
// turns the lattice, against the incident wavevector s0. Empty when it never is - s inside the blind
// cone of its own shell, or along the spindle.
std::vector<double> EwaldCrossingAngles_deg(const Coord &s, const Coord &u, const Coord &s0);
// lattice: the sweep's lattice at goniometer angle 0, the way ProcessResult::end_message keeps it
// (RugnuxFarEnd and the predictor place it on an image with GetTransformationAngle(-angle)).
// s0: the incident wavevector, DiffractionGeometry::GetScatteringVector(). Angles in degrees;
// end > start, and a sweep of 360 degrees or more measures everything measurable.
std::optional<SweepCoverageForecast> ForecastSweepCoverage(const gemmi::SpaceGroup &sg,
const CrystalLattice &lattice,
const GoniometerAxis &gonio,
const Coord &s0,
double d_min_A,
double start_deg, double end_deg);
// The least tilt, in whole degrees, of a second sweep's spindle against the first that leaves at most
// `max_lost_fraction` of the reciprocal space to d_min blind to both sweeps - their blind cones apart.
// Symmetry is not counted, so this is enough for any point group, and the same in every direction of tilt.
double SecondSweepTilt_deg(double wavelength_A, double d_min_A, double max_lost_fraction);