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
* 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>
57 lines
3.5 KiB
C++
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);
|