v1.0.0-rc.168 (#78)

* rugnux is substantially faster - a corpus of 145 rotation datasets processes in about two thirds of the time - with identical results.
* A crystal whose lattice looks more symmetric than it is because the beam centre is off is no longer processed on the wrong cell.
* rugnux prints at startup, and writes at the foot of every results report, a short acknowledgement of the X-ray research community whose methods it implements and of the open-source projects it builds on; `ACKNOWLEDGEMENT.md` now ships in every package beside `LICENSE` and `THIRD_PARTY_NOTICES.md`.

Reviewed-on: #78
Co-authored-by: Filip Leonarski <filip.leonarski@psi.ch>

image_analysis/image_preprocessing/ImagePreprocessorGPU.h

@@ -26,6 +26,9 @@ class ImagePreprocessorGPU : public ImagePreprocessor {
     std::vector<ImageStatistics> cpu_stats;
     CudaRegisteredVector<ImageStatistics> cpu_stats_reg;
     CudaRegisteredVector<uint8_t> input_reg;   // page-locks the caller's decompression buffer
+    // The uncompressed-image counterpart of input_reg: the region PinInputRegion last page-locked.
+    const void *pinned_input = nullptr;
+    size_t pinned_input_bytes = 0;
 
     std::vector<int32_t> cpu_image;
 
@@ -46,10 +49,12 @@ public:
     // per pixel it is the single largest transfer in the pipeline, so the caller says whether it wants it.
     ImagePreprocessorGPU(const DiffractionExperiment &experiment, const PixelMask &mask, std::shared_ptr<CudaStream> stream,
                          bool copy_image_to_host = true);
+    ~ImagePreprocessorGPU() override;
     ImageStatistics Analyze(ImagePreprocessorBuffer &processed_image, const uint8_t *decompressed_image, CompressedImageMode image_mode) override;
     bool AnalyzeCompressed(ImagePreprocessorBuffer &processed_image, const CompressedImage &image,
                            ImageStatistics &stats) override;
     [[nodiscard]] float GetLastDecompressionTime_s() const override;
     void PinInputBuffer(std::vector<uint8_t> &buffer, size_t size) override;
+    void PinInputRegion(const void *ptr, size_t bytes) override;
 };