1 line
101 KiB
HTML
1 line
101 KiB
HTML
<!DOCTYPE html> <html lang=en data-content_root="./"> <meta charset=utf-8 /> <meta name=viewport content="width=device-width, initial-scale=1.0" /><meta name=viewport content="width=device-width, initial-scale=1" /> <meta name=viewport content="width=device-width,initial-scale=1"> <meta http-equiv=x-ua-compatible content="ie=edge"> <meta name="lang:clipboard.copy" content="Copy to clipboard"> <meta name="lang:clipboard.copied" content="Copied to clipboard"> <meta name="lang:search.language" content=en > <meta name="lang:search.pipeline.stopwords" content=True > <meta name="lang:search.pipeline.trimmer" content=True > <meta name="lang:search.result.none" content="No matching documents"> <meta name="lang:search.result.one" content="1 matching document"> <meta name="lang:search.result.other" content="# matching documents"> <meta name="lang:search.tokenizer" content="[\s\-]+"> <link href="https://fonts.gstatic.com/" rel=preconnect crossorigin> <link href="https://fonts.googleapis.com/css?family=Roboto+Mono:400,500,700|Roboto:300,400,400i,700&display=fallback" rel=stylesheet > <style> body, input { font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif } code, kbd, pre { font-family: "Roboto Mono", "Courier New", Courier, monospace } </style> <link rel=stylesheet href="_static/stylesheets/application.css"/> <link rel=stylesheet href="_static/stylesheets/application-palette.css"/> <link rel=stylesheet href="_static/stylesheets/application-fixes.css"/> <link rel=stylesheet href="_static/fonts/material-icons.css"/> <meta name=theme-color content="#3f51b5"> <script src="_static/javascripts/modernizr.js"></script> <title>Acknowledgements — Jungfraujoch 1.0.0-rc.186 documentation</title> <link rel=stylesheet type="text/css" href="_static/pygments.css?v=83e35b93" /> <link rel=stylesheet type="text/css" href="_static/material.css?v=79c92029" /> <link rel=stylesheet type="text/css" href="_static/jfjoch.css?v=bb6ed8b7" /> <script src="_static/documentation_options.js?v=dbce4c6c"></script> <script src="_static/doctools.js?v=9bcbadda"></script> <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <script src="_static/jfjoch_downloads.js?v=9e84fe5a"></script> <link rel=icon href="_static/jfjoch.png"/> <link rel=index title=Index href=genindex.html /> <link rel=search title=Search href=search.html /> <link rel=next title=License href=LICENSE.html /> <link rel=prev title=Publications href=PUBLICATIONS.html /> <body dir=ltr data-md-color-primary=indigo data-md-color-accent=lime> <svg class=md-svg > <defs data-children-count=0 > <svg xmlns="http://www.w3.org/2000/svg" width=500 height=500 viewBox="0 0 500 500" id=__gitlab ><path fill=currentColor d="M93.667 473.347l90.684-279.097H2.983l90.684 279.097z" transform="translate(156.198 1.16)"/><path fill=currentColor d="M221.333 473.345L130.649 194.25H3.557l217.776 279.095z" transform="translate(28.531 1.16)" opacity=.7 /><path fill=currentColor d="M32 195.155L4.441 279.97a18.773 18.773 0 0 0 6.821 20.99l238.514 173.29L32 195.155z" transform="translate(.089 .256)" opacity=.5 /><path fill=currentColor d="M2.667-84.844h127.092L75.14-252.942c-2.811-8.649-15.047-8.649-17.856 0L2.667-84.844z" transform="translate(29.422 280.256)"/><path fill=currentColor d="M2.667 473.345L93.351 194.25h127.092L2.667 473.345z" transform="translate(247.198 1.16)" opacity=.7 /><path fill=currentColor d="M221.334 195.155l27.559 84.815a18.772 18.772 0 0 1-6.821 20.99L3.557 474.25l217.777-279.095z" transform="translate(246.307 .256)" opacity=.5 /><path fill=currentColor d="M130.667-84.844H3.575l54.618-168.098c2.811-8.649 15.047-8.649 17.856 0l54.618 168.098z" transform="translate(336.974 280.256)"/></svg> </defs> </svg> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer > <input class=md-toggle data-md-toggle=search type=checkbox id=__search > <label class=md-overlay data-md-component=overlay for=__drawer ></label> <a href="#ACKNOWLEDGEMENT" tabindex=1 class=md-skip > Skip to content </a> <header class=md-header data-md-component=header > <nav class="md-header-nav md-grid"> <div class="md-flex navheader"> <div class="md-flex__cell md-flex__cell--shrink"> <a href=documentation.html title="Jungfraujoch 1.0.0-rc.186 documentation" class="md-header-nav__button md-logo"> <i class=md-icon ></i> </a> </div> <div class="md-flex__cell md-flex__cell--shrink"> <label class="md-icon md-icon--menu md-header-nav__button" for=__drawer ></label> </div> <div class="md-flex__cell md-flex__cell--stretch"> <div class="md-flex__ellipsis md-header-nav__title" data-md-component=title > <span class=md-header-nav__topic >PSI Jungfraujoch</span> <span class=md-header-nav__topic > Acknowledgements </span> </div> </div> <div class="md-flex__cell md-flex__cell--shrink"> <label class="md-icon md-icon--search md-header-nav__button" for=__search ></label> <div class=md-search data-md-component=search role=dialog > <label class=md-search__overlay for=__search ></label> <div class=md-search__inner role=search > <form class=md-search__form action=search.html method=get name=search > <input type=text class=md-search__input name=q placeholder=""Search"" autocapitalize=off autocomplete=off spellcheck=false data-md-component=query data-md-state=active > <label class="md-icon md-search__icon" for=__search ></label> <button type=reset class="md-icon md-search__icon" data-md-component=reset tabindex=-1 >  </button> </form> <div class=md-search__output > <div class=md-search__scrollwrap data-md-scrollfix> <div class=md-search-result data-md-component=result > <div class=md-search-result__meta > Type to start searching </div> <ol class=md-search-result__list ></ol> </div> </div> </div> </div> </div> </div> <div class="md-flex__cell md-flex__cell--shrink"> <div class=md-header-nav__source > <a href="https://gitea.psi.ch/mx/jungfraujoch" title="Go to repository" class=md-source data-md-source=github > <div class=md-source__icon > <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width=28 height=28 > <use xlink:href="#__gitlab" width=24 height=24 ></use> </svg> </div> <div class=md-source__repository > Jungfraujoch </div> </a> </div> </div> <script src="_static/javascripts/version_dropdown.js"></script> <script> var json_loc = ""versions.json"", target_loc = "../", text = "Versions"; $( document ).ready( add_version_dropdown(json_loc, target_loc, text)); </script> </div> </nav> </header> <div class=md-container > <nav class=md-tabs data-md-component=tabs > <div class="md-tabs__inner md-grid"> <ul class=md-tabs__list > <li class=md-tabs__item ><a href=documentation.html class=md-tabs__link >Jungfraujoch 1.0.0-rc.186 documentation</a> </ul> </div> </nav> <main class=md-main > <div class="md-main__inner md-grid" data-md-component=container > <div class="md-sidebar md-sidebar--primary" data-md-component=navigation > <div class=md-sidebar__scrollwrap > <div class=md-sidebar__inner > <nav class="md-nav md-nav--primary" data-md-level=0 > <label class="md-nav__title md-nav__title--site" for=__drawer > <a href=documentation.html title="Jungfraujoch 1.0.0-rc.186 documentation" class="md-nav__button md-logo"> <i class=md-icon ></i> </a> <a href=documentation.html title="Jungfraujoch 1.0.0-rc.186 documentation">PSI Jungfraujoch</a> </label> <div class=md-nav__source > <a href="https://gitea.psi.ch/mx/jungfraujoch" title="Go to repository" class=md-source data-md-source=github > <div class=md-source__icon > <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width=28 height=28 > <use xlink:href="#__gitlab" width=24 height=24 ></use> </svg> </div> <div class=md-source__repository > Jungfraujoch </div> </a> </div> <ul class=md-nav__list > <li class=md-nav__item > <span class="md-nav__link caption"><span class=caption-text >Rugnux</span></span> <li class=md-nav__item > <a href=RUGNUX.html class=md-nav__link >Getting started</a> <li class=md-nav__item > <a href=RUGNUX_DOWNLOAD.html class=md-nav__link >Download</a> <li class=md-nav__item > <a href=RUGNUX_OVERVIEW.html class=md-nav__link >Overview</a> <li class=md-nav__item > <a href=RUGNUX_INSTALL.html class=md-nav__link >Installing Rugnux</a> <li class=md-nav__item > <a href=RUGNUX_FORMATS.html class=md-nav__link >Input formats</a> <li class=md-nav__item > <a href=RUGNUX_TUTORIAL.html class=md-nav__link >Running Rugnux</a> <li class=md-nav__item > <a href=RUGNUX_CLI.html class=md-nav__link >Command-line options</a> <li class=md-nav__item > <a href=RUGNUX_REPORT.html class=md-nav__link >The results report</a> <li class=md-nav__item > <a href=RUGNUX_INTEGRATION.html class=md-nav__link >Rugnux with other programs</a> <li class=md-nav__item > <a href=RUGNUX_ADVANCED.html class=md-nav__link >Advanced Rugnux</a> <li class=md-nav__item > <a href=RUGNUX_MODEL_AND_REFERENCE.html class=md-nav__link >Models and reference data</a> <li class=md-nav__item > <a href=RUGNUX_CALIBRATION.html class=md-nav__link >Detector calibration</a> <li class=md-nav__item > <span class="md-nav__link caption"><span class=caption-text >Jungfraujoch Viewer</span></span> <li class=md-nav__item > <a href=JFJOCH_VIEWER.html class=md-nav__link >Using the viewer</a> <li class=md-nav__item > <a href=VIEWER_DOWNLOAD.html class=md-nav__link >Download</a> <li class=md-nav__item > <span class="md-nav__link caption"><span class=caption-text >Jungfraujoch</span></span> <li class=md-nav__item > <a href=JUNGFRAUJOCH.html class=md-nav__link >Overview</a> <li class=md-nav__item > <a href=DEPLOYMENT.html class=md-nav__link >Deployment</a> <li class=md-nav__item > <a href=REPOSITORIES.html class=md-nav__link >Linux package repositories</a> <li class=md-nav__item > <a href=RELEASE_CONTENTS.html class=md-nav__link >Release contents</a> <li class=md-nav__item > <a href=JFJOCH_BROKER.html class=md-nav__link >jfjoch_broker</a> <li class=md-nav__item > <a href=JFJOCH_WRITER.html class=md-nav__link >jfjoch_writer</a> <li class=md-nav__item > <a href=WEB_FRONTEND.html class=md-nav__link >Web frontend</a> <li class=md-nav__item > <a href=SOFTWARE_INTEGRATION.html class=md-nav__link >MX software integration</a> <li class=md-nav__item > <a href=TOOLS.html class=md-nav__link >Tools</a> <li class=md-nav__item > <a href=PYTHON_CLIENT.html class=md-nav__link >Python client</a> <li class=md-nav__item > <span class="md-nav__link caption"><span class=caption-text >Reference</span></span> <li class=md-nav__item > <a href=TECHNICAL.html class=md-nav__link >Technical reference</a> <li class=md-nav__item > <span class="md-nav__link caption"><span class=caption-text >Project</span></span> <li class=md-nav__item > <a href=PUBLICATIONS.html class=md-nav__link >Publications</a> <li class=md-nav__item > <input class="md-toggle md-nav__toggle" data-md-toggle=toc type=checkbox id=__toc > <label class="md-nav__link md-nav__link--active" for=__toc > Acknowledgements </label> <a href="#" class="md-nav__link md-nav__link--active">Acknowledgements</a> <nav class="md-nav md-nav--secondary"> <ul class=md-nav__list data-md-scrollfix=""> </ul> </nav> <ul class=md-nav__list > <li class=md-nav__item > <a href="#funding-and-support" class=md-nav__link >Funding and support</a> <li class=md-nav__item > <a href="#crystallographic-methods-adopted-from-other-packages" class=md-nav__link >Crystallographic methods adopted from other packages</a> <li class=md-nav__item > <a href="#software-and-computing-methods" class=md-nav__link >Software and computing methods</a> <li class=md-nav__item > <a href="#file-formats-read-from-a-published-specification" class=md-nav__link >File formats read from a published specification</a> <li class=md-nav__item > <a href="#public-diffraction-data-used-for-testing" class=md-nav__link >Public diffraction data used for testing</a> <li class=md-nav__item > <a href="#generative-ai-usage-declaration" class=md-nav__link >Generative AI usage declaration</a> </ul> <li class=md-nav__item > <a href=LICENSE.html class=md-nav__link >License</a> <li class=md-nav__item > <a href=THIRD_PARTY_NOTICES.html class=md-nav__link >Third-party software notices</a> <li class=md-nav__item > <a href=NAMING.html class=md-nav__link >Naming</a> <li class=md-nav__item > <a href=CHANGELOG.html class=md-nav__link >Changelog</a> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=toc > <div class=md-sidebar__scrollwrap > <div class=md-sidebar__inner > <nav class="md-nav md-nav--secondary"> <ul class=md-nav__list data-md-scrollfix=""> </ul> </nav> </div> </div> </div> <div class=md-content > <article class="md-content__inner md-typeset" role=main > <section class="tex2jax_ignore mathjax_ignore" id=acknowledgements > <h1 id=acknowledgement--page-root >Acknowledgements<a class=headerlink href="#acknowledgement--page-root" title="Link to this heading">¶</a></h1> <p>How to cite Jungfraujoch and Rugnux, and the papers that describe them, is on the <a class="reference internal" href=PUBLICATIONS.html ><span class="std std-doc">Publications</span></a> page. In short:</p> <ul class=simple > <li><p><strong>Rugnux</strong>: F. Leonarski and M. Wang, “Rugnux: from diffraction images to structure at synchrotrons and XFELs in one program” (2026), bioRxiv <a class="reference external" href="https://doi.org/10.64898/2026.10.24.761522">doi:10.64898/2026.10.24.761522</a>.</p> <li><p><strong>Jungfraujoch</strong>: F. Leonarski, M. Brückner, C. Lopez-Cuenca, A. Mozzanica, H.-C. Stadler, Z. Matěj, A. Castellane, B. Mesnet, J. Wojdyla, B. Schmitt and M. Wang, “Jungfraujoch: hardware-accelerated data-acquisition system for kilohertz pixel-array X-ray detectors” (2023), J. Synchrotron Rad. 30, 227-234 <a class="reference external" href="https://doi.org/10.1107/S1600577522010268">doi:10.1107/S1600577522010268</a>; for real-time serial crystallography and live indexing feedback also J. Duan, H.-C. Stadler, J. Nan et al., “Jungfraujoch: 38 GB s⁻¹ real-time serial crystallography – data acquisition and live indexing feedback” (2026), J. Appl. Cryst. 59, 1668-1677 <a class="reference external" href="https://doi.org/10.1107/S1600576726008083">doi:10.1107/S1600576726008083</a>.</p> </ul> <section id=funding-and-support > <h2 id=funding-and-support >Funding and support<a class=headerlink href="#funding-and-support" title="Link to this heading">¶</a></h2> <p>The project is supported by:</p> <ul class=simple > <li><p>Innosuisse via Innovation Project “NextGenDCU high data rate acquisition system for X-ray detectors in structural biology applications” (101.535.1 IP-ENG; Apr 2023 - Sep 2025).</p> <li><p>ETH Domain via Open Research Data Contribute project (Jan - Dec 2023).</p> <li><p>AMD University Program with donation of licenses of Ethernet IP cores and Vivado software.</p> </ul> </section> <section id=crystallographic-methods-adopted-from-other-packages > <h2 id=crystallographic-methods-adopted-from-other-packages >Crystallographic methods adopted from other packages<a class=headerlink href="#crystallographic-methods-adopted-from-other-packages" title="Link to this heading">¶</a></h2> <p>The analysis pipeline builds on methods first published, and in most cases first implemented, by other crystallographic software. The code is Jungfraujoch’s own; the methods are theirs, and are acknowledged here, entry by entry: what was taken, from whom, and the citation. How rugnux uses each method is described in the <a class="reference internal" href=CPU_DATA_ANALYSIS.html ><span class="std std-doc">data-analysis reference</span></a>, not here. Where a package’s source was consulted this is said explicitly. Most of these packages are neither linked nor vendored; the three that are - GEMMI, traccc and fast-feedback-indexer - also carry a licence obligation, recorded in <a class="reference internal" href=THIRD_PARTY_NOTICES.html ><span class="std std-doc">THIRD_PARTY_NOTICES.md</span></a>.</p> <section id=experimental-geometry-and-physical-corrections > <h3 id=experimental-geometry-and-physical-corrections >Experimental geometry and physical corrections<a class=headerlink href="#experimental-geometry-and-physical-corrections" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://www.globalphasing.com/autoproc/">autoPROC</a></strong> — the principle, long argued for by Clemens Vonrhein, that a pipeline does not take the experimental metadata it is given (beam centre, detector geometry, goniometer axis) on trust but verifies it against the images and corrects it where it is wrong, and with it that the beam centre is found from the images; the aim of a pipeline that takes the decisions an expert would take and reports the evidence for each. C. Vonrhein, C. Flensburg, P. Keller, A. Sharff, O. Smart, W. Paciorek, T. Womack and G. Bricogne, “Data processing and analysis with the autoPROC toolbox” (2011), Acta Cryst. D67, 293-302 <a class="reference external" href="https://doi.org/10.1107/S0907444911007773">doi:10.1107/S0907444911007773</a>.</p> <p><strong>Sensor absorption and air path</strong> — the attenuation coefficients of silicon, CdTe, dry air and helium behind the oblique-incidence sensor efficiency, the parallax variance and the air-path attenuation are the NIST tabulation. J. H. Hubbell and S. M. Seltzer, “Tables of X-Ray Mass Attenuation Coefficients and Mass Energy-Absorption Coefficients from 1 keV to 20 MeV for Elements Z = 1 to 92 and 48 Additional Substances of Dosimetric Interest” (1995, data updated 2004), NIST Standard Reference Database 126 <a class="reference external" href="https://doi.org/10.18434/T4D01F">doi:10.18434/T4D01F</a>.</p> <p><strong>Polarization correction</strong> — the azimuthal polarization factor for a partially polarized synchrotron source. R. Kahn, R. Fourme, A. Gadet, J. Janin, C. Dumas and D. Andre, “Macromolecular crystallography with synchrotron radiation: photographic data collection and polarization correction” (1982), J. Appl. Cryst. 15, 330-337 <a class="reference external" href="https://doi.org/10.1107/S0021889882012060">doi:10.1107/S0021889882012060</a>.</p> <p><strong>Hexagonal-ice ring positions</strong> — the eleven measured ring spacings from 3.895 to 1.522 Å. D. W. Moreau, H. Atakisi and R. E. Thorne, “Ice in biomolecular cryocrystallography” (2021), Acta Cryst. D77, 540-554 <a class="reference external" href="https://doi.org/10.1107/S2059798321001170">doi:10.1107/S2059798321001170</a>. The bands below 1.522 Å are calculated here from ice Ih structure factors on the lattice constants of K. Röttger, A. Endriss, J. Ihringer, S. Doyle and W. F. Kuhs, “Lattice constants and thermal expansion of H2O and D2O ice Ih between 10 and 265 K” (1994), Acta Cryst. B50, 644-648 <a class="reference external" href="https://doi.org/10.1107/S0108768194004933">doi:10.1107/S0108768194004933</a>.</p> <p><strong>Powder calibrants</strong> — the silver behenate cell is T. C. Huang, H. Toraya, T. N. Blanton and Y. Wu, “X-ray powder diffraction analysis of silver behenate, a possible low-angle diffraction standard” (1993), J. Appl. Cryst. 26, 180-184 <a class="reference external" href="https://doi.org/10.1107/S0021889892009762">doi:10.1107/S0021889892009762</a>; the CeO2 and silicon cells are those of the NIST standard reference materials SRM 674b and SRM 640 (certificates, no DOI).</p> </section> <section id=spot-finding > <h3 id=spot-finding >Spot finding<a class=headerlink href="#spot-finding" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://www.desy.de/~twhite/crystfel/">CrystFEL</a></strong> — spot finding, the three-ring integration region, the serial/stills processing model, and the per-frame indexing acceptance test (<code class="docutils literal notranslate"><span class=pre >indexing_peak_check()</span></code> in <code class="docutils literal notranslate"><span class=pre >peaks.c</span></code>). T. A. White, R. A. Kirian, A. V. Martin, A. Aquila, K. Nass, A. Barty and H. N. Chapman, “CrystFEL: a software suite for snapshot serial crystallography” (2012), J. Appl. Cryst. 45, 335-341 <a class="reference external" href="https://doi.org/10.1107/S0021889812002312">doi:10.1107/S0021889812002312</a>.</p> <p><strong>Cheetah</strong> — the per-resolution-ring background statistics with the Bragg peaks excluded by iterated clipping, from peakfinder8. A. Barty, R. A. Kirian, F. R. N. C. Maia, M. Hantke, C. H. Yoon, T. A. White and H. N. Chapman, “Cheetah: software for high-throughput reduction and analysis of serial femtosecond X-ray diffraction data” (2014), J. Appl. Cryst. 47, 1118-1131 <a class="reference external" href="https://doi.org/10.1107/S1600576714007626">doi:10.1107/S1600576714007626</a>.</p> <p><strong>Poisson significance threshold</strong> — beyond the summation limit the Poisson quantile of the adaptive spot-finding threshold is taken from the Cornish-Fisher expansion. E. A. Cornish and R. A. Fisher, “Moments and cumulants in the specification of distributions” (1938), Rev. Int. Stat. Inst. 5, 307-320 <a class="reference external" href="https://doi.org/10.2307/1400905">doi:10.2307/1400905</a>.</p> <p><strong>GPU spot finder</strong> — the CUDA spot finder was developed by Hans-Christian Stadler (PSI).</p> <p><strong><a class="reference external" href="https://github.com/acts-project/traccc">traccc</a></strong> — the sparse connected-component labelling that groups strong pixels into spots: the CPU extractor adapts its SparseCCL source, the CUDA extractor follows the design of its GPU counterpart (MPL-2.0; see <a class="reference internal" href=THIRD_PARTY_NOTICES.html ><span class="std std-doc">THIRD_PARTY_NOTICES.md</span></a>). P. Gessinger, H. M. Gray, A. Krasznahorkay, C. Leggett, J. Niermann, A. Salzburger, S. N. Swatman and B. Yeo, “traccc: GPU track reconstruction library for HEP experiments” (2025), <a class="reference external" href="https://arxiv.org/abs/2505.22822">arXiv:2505.22822</a>. The SparseCCL algorithm itself: A. Hennequin, B. Couturier, V. V. Gligorov and L. Lacassagne, “SparseCCL: Connected Components Labeling and Analysis for sparse images” (2019), DASIP 2019, 65-70 <a class="reference external" href="https://doi.org/10.1109/DASIP48288.2019.9049184">doi:10.1109/DASIP48288.2019.9049184</a>.</p> <p><strong>XDS and DISTL</strong> — bounding a spot by its shape (how much of its bounding box it fills) rather than by its size; the statistic is rugnux’s own. XDS is cited under <a class="reference internal" href="#integration-and-rotation-geometry">Integration and rotation geometry</a>; Z. Zhang, N. K. Sauter, H. van den Bedem, G. Snell and A. M. Deacon, “Automated diffraction image analysis and spot searching for high-throughput crystal screening” (2006), J. Appl. Cryst. 39, 112-119 <a class="reference external" href="https://doi.org/10.1107/S0021889805040677">doi:10.1107/S0021889805040677</a>.</p> </section> <section id=indexing > <h3 id=indexing >Indexing<a class=headerlink href="#indexing" title="Link to this heading">¶</a></h3> <p><strong>Fourier-transform indexing</strong> — indexing with no prior knowledge of the cell by Fourier-transforming the reciprocal-space positions of the spots, proposed as a three-dimensional transform; the de-novo indexers (<code class="docutils literal notranslate"><span class=pre >-X</span> <span class=pre >fft</span></code>, <code class="docutils literal notranslate"><span class=pre >-X</span> <span class=pre >fftw</span></code>) use its one-dimensional projection form. G. Bricogne (1986), in <em>Proceedings of the EEC Cooperative Workshop on Position-Sensitive Detector Software (Phase III)</em>, LURE, Paris, p. 28 (a workshop proceedings without a DOI).</p> <p><strong>Rossmann FFT autoindexing</strong> — projecting the reciprocal-space points onto many directions and Fourier-transforming the 1D histograms. I. Steller, R. Bolotovsky and M. G. Rossmann, “An algorithm for automatic indexing of oscillation images using Fourier analysis” (1997), J. Appl. Cryst. 30, 1036-1040 <a class="reference external" href="https://doi.org/10.1107/S0021889897008777">doi:10.1107/S0021889897008777</a>.</p> <p><strong><a class="reference external" href="https://www.mrc-lmb.cam.ac.uk/mosflm/mosflm/">MOSFLM</a></strong> — the practice of that algorithm, and the post-refinement practice of which parameters are refined per image and which over a wedge. H. R. Powell, “The Rossmann Fourier autoindexing algorithm in MOSFLM” (1999), Acta Cryst. D55, 1690-1695 <a class="reference external" href="https://doi.org/10.1107/S0907444999009506">doi:10.1107/S0907444999009506</a>; A. G. W. Leslie and H. R. Powell, “Processing diffraction data with MOSFLM” (2007), in <em>Evolving Methods for Macromolecular Crystallography</em>, NATO Science Series II, vol. 245, 41-51 <a class="reference external" href="https://doi.org/10.1007/978-1-4020-6316-9_4">doi:10.1007/978-1-4020-6316-9_4</a>; T. G. G. Battye, L. Kontogiannis, O. Johnson, H. R. Powell and A. G. W. Leslie, “iMOSFLM: a new graphical interface for diffraction-image processing with MOSFLM” (2011), Acta Cryst. D67, 271-281 <a class="reference external" href="https://doi.org/10.1107/S0907444910048675">doi:10.1107/S0907444910048675</a>; H. R. Powell, T. G. G. Battye, L. Kontogiannis, O. Johnson and A. G. W. Leslie, “Integrating macromolecular X-ray diffraction data with the graphical user interface iMosflm” (2017), Nat. Protoc. 12, 1310-1325 <a class="reference external" href="https://doi.org/10.1038/nprot.2017.037">doi:10.1038/nprot.2017.037</a>.</p> <p><strong><a class="reference external" href="https://github.com/paulscherrerinstitute/fast-feedback-indexer">fast-feedback-indexer</a></strong> — the known-cell indexer for serial stills (<code class="docutils literal notranslate"><span class=pre >-X</span> <span class=pre >ffbidx</span></code>), PSI’s library linked at build time (BSD-3-Clause; see <a class="reference internal" href=THIRD_PARTY_NOTICES.html ><span class="std std-doc">THIRD_PARTY_NOTICES.md</span></a>), implementing TORO. P. Gasparotto, L. Barba, H.-C. Stadler, G. Assmann, H. Mendonça, A. W. Ashton, M. Janousch, F. Leonarski and B. Béjar, “TORO Indexer: a PyTorch-based indexing algorithm for kilohertz serial crystallography” (2024), J. Appl. Cryst. 57, 931-944 <a class="reference external" href="https://doi.org/10.1107/S1600576724003182">doi:10.1107/S1600576724003182</a>. The CPU implementation used without a GPU is a port of the library’s CUDA kernels by H.-C. Stadler (PSI).</p> </section> <section id=cell-reduction-and-lattice-symmetry > <h3 id=cell-reduction-and-lattice-symmetry >Cell reduction and lattice symmetry<a class=headerlink href="#cell-reduction-and-lattice-symmetry" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://github.com/project-gemmi/gemmi">GEMMI</a></strong> — symmetry operations, unit-cell and structure-factor machinery, and MTZ / XDS_ASCII I/O; vendored in <code class="docutils literal notranslate"><span class=pre >gemmi_gph/</span></code>, so it also carries a licence obligation. M. Wojdyr, “GEMMI: A library for structural biology” (2022), J. Open Source Softw. 7, 4200 <a class="reference external" href="https://doi.org/10.21105/joss.04200">doi:10.21105/joss.04200</a>.</p> <p><strong>Niggli reduction</strong> — used through GEMMI’s implementation. I. Křivý and B. Gruber, “A unified algorithm for determining the reduced (Niggli) cell” (1976), Acta Cryst. A32, 297-298 <a class="reference external" href="https://doi.org/10.1107/S0567739476000636">doi:10.1107/S0567739476000636</a>. The table of lattice characters that maps a reduced cell to Bravais lattices and centrings follows International Tables for Crystallography Vol. A, Table 9.2.5.1.</p> <p><strong>Numerically stable cell reduction</strong> — the magnitude-scaled tolerance that decides the sign of a structurally-zero scalar product. R. W. Grosse-Kunstleve, N. K. Sauter and P. D. Adams, “Numerically stable algorithms for the computation of reduced unit cells” (2004), Acta Cryst. A60, 1-6 <a class="reference external" href="https://doi.org/10.1107/S010876730302186X">doi:10.1107/S010876730302186X</a>.</p> <p><strong>Metric-symmetry search</strong> — the obliquity of the 81 candidate two-folds of a reduced cell, and the conventional axes derived from the rotation group found; the two-fold search is used through GEMMI. Y. Le Page, “The derivation of the axes of the conventional unit cell from the dimensions of the Buerger-reduced cell” (1982), J. Appl. Cryst. 15, 255-259 <a class="reference external" href="https://doi.org/10.1107/S0021889882011959">doi:10.1107/S0021889882011959</a>. The step from the two-folds found to a conventional cell, a centring and an integral change of basis follows R. W. Grosse-Kunstleve, “Algorithms for deriving crystallographic space-group information” (1999), Acta Cryst. A55, 383-395 <a class="reference external" href="https://doi.org/10.1107/S0108767398010186">doi:10.1107/S0108767398010186</a>.</p> </section> <section id=integration-and-rotation-geometry > <h3 id=integration-and-rotation-geometry >Integration and rotation geometry<a class=headerlink href="#integration-and-rotation-geometry" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://xds.mr.mpg.de/">XDS</a></strong> — rotation geometry and notation, the reciprocal Lorentz and partiality treatment, the maximum-likelihood mosaicity estimate, the <code class="docutils literal notranslate"><span class=pre >MINPK</span></code> criterion for a reflection whose predicted profile is not cleanly its own, the intensity-based test for a centred lattice, the recognition of shaded detector regions (<code class="docutils literal notranslate"><span class=pre >DEFPIX</span></code>), and the scaling correction surfaces indexed by image number and detector region. W. Kabsch, “XDS” (2010), Acta Cryst. D66, 125-132 <a class="reference external" href="https://doi.org/10.1107/S0907444909047337">doi:10.1107/S0907444909047337</a>; W. Kabsch, “Integration, scaling, space-group assignment and post-refinement” (2010), Acta Cryst. D66, 133-144 <a class="reference external" href="https://doi.org/10.1107/S0907444909047374">doi:10.1107/S0907444909047374</a>.</p> <p><strong>Profile fitting</strong> — the Kabsch/Otwinowski iteration with reweighted, de-biased variances, from the second XDS paper above and from Z. Otwinowski and W. Minor, “Processing of X-ray diffraction data collected in oscillation mode” (1997), Methods Enzymol. 276, 307-326 <a class="reference external" href="https://doi.org/10.1016/S0076-6879%2897%2976066-X">doi:10.1016/S0076-6879(97)76066-X</a>.</p> <p><strong>Two-dimensional integration</strong> — integrating each image in the detector plane and only afterwards combining a reflection’s partials into a full, as against three-dimensional profile fitting through the image stack, is the architecture of DENZO/SCALEPACK (Otwinowski and Minor, above) and MOSFLM (cited under <a class="reference internal" href="#indexing">Indexing</a>).</p> </section> <section id=space-group-twinning-and-pseudo-symmetry > <h3 id=space-group-twinning-and-pseudo-symmetry >Space group, twinning and pseudo-symmetry<a class=headerlink href="#space-group-twinning-and-pseudo-symmetry" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://www.ccp4.ac.uk/">POINTLESS</a></strong> (CCP4) — the space-group search: scoring each candidate rotation operator by the correlation of I(h) with I(Rh) on resolution-normalised intensities (E²); the screw-axis test that scores a predicted-absent class against the rest of its own axial row and lets confidence fall with the number of axial reflections instead of refusing below a count; and the same test on a zone for a glide plane. P. Evans, “Scaling and assessment of data quality” (2006), Acta Cryst. D62, 72-82 <a class="reference external" href="https://doi.org/10.1107/S0907444905036693">doi:10.1107/S0907444905036693</a>; P. R. Evans, “An introduction to data reduction: space-group determination, scaling and intensity statistics” (2011), Acta Cryst. D67, 282-292 <a class="reference external" href="https://doi.org/10.1107/S090744491003982X">doi:10.1107/S090744491003982X</a>; P. R. Evans and G. N. Murshudov, “How good are my data and what is the resolution?” (2013), Acta Cryst. D69, 1204-1214 <a class="reference external" href="https://doi.org/10.1107/S0907444913000061">doi:10.1107/S0907444913000061</a>; J. Agirre, M. Atanasova, H. Bagdonas et al., “The CCP4 suite: integrative software for macromolecular crystallography” (2023), Acta Cryst. D79, 449-461 <a class="reference external" href="https://doi.org/10.1107/S2059798323003595">doi:10.1107/S2059798323003595</a>.</p> <p><strong>Centrosymmetric glide groups</strong> — of two absence-equivalent glide groups the search writes the centrosymmetric one (P2/c over Pc, C2/c over Cc), a missed inversion centre being the common error. W. H. Baur and D. Kassner, “The perils of Cc: comparing the frequencies of falsely assigned space groups with their general population” (1992), Acta Cryst. B48, 356-369 <a class="reference external" href="https://doi.org/10.1107/S0108768191014726">doi:10.1107/S0108768191014726</a>.</p> <p><strong>Centre-of-symmetry statistics</strong> — the acentric and centric intensity distributions and the cumulative N(z) test built on them, read beside <|E^2-1|> and the L test. A. J. C. Wilson, “The probability distribution of X-ray intensities” (1949), Acta Cryst. 2, 318-321 <a class="reference external" href="https://doi.org/10.1107/S0365110X49000813">doi:10.1107/S0365110X49000813</a>; E. R. Howells, D. C. Phillips and D. Rogers, “The probability distribution of X-ray intensities. II. Experimental investigation and the X-ray detection of centres of symmetry” (1950), Acta Cryst. 3, 210-214 <a class="reference external" href="https://doi.org/10.1107/S0365110X50000513">doi:10.1107/S0365110X50000513</a>.</p> <p><strong>Twinning L test</strong> — the moments of L = (I1−I2)/(I1+I2) over pairs of neighbouring acentric reflections against their untwinned and perfect-twin values; its robustness to pseudo-centering is kept by the partner steps, which are restricted when a non-half-integer pseudo-translation is found. J. E. Padilla and T. O. Yeates, “A statistic for local intensity differences: robustness to anisotropy and pseudo-centering and utility for detecting twinning” (2003), Acta Cryst. D59, 1124-1130 <a class="reference external" href="https://doi.org/10.1107/S0907444903007947">doi:10.1107/S0907444903007947</a>. The test’s design - indicators on shell-normalised merged intensities, a twin law admitted within 3 degrees of obliquity - follows phenix.xtriage: Zwart, Grosse-Kunstleve and Adams (2005, cited under <a class="reference internal" href="#data-quality-and-anisotropy">Data quality and anisotropy</a>); D. Liebschner, P. V. Afonine, M. L. Baker et al., “Macromolecular structure determination using X-rays, neutrons and electrons: recent developments in Phenix” (2019), Acta Cryst. D75, 861-877 <a class="reference external" href="https://doi.org/10.1107/S2059798319011471">doi:10.1107/S2059798319011471</a>.</p> <p><strong>Twin fraction and twinned intensity</strong> — the model (1−α) I(h) + α I(Th), and the fraction read from the median of H = |I(h) − I(Th)|/(I(h) + I(Th)), uniform on [0, 1−2α]. T. O. Yeates, “Detecting and overcoming crystal twinning” (1997), Methods Enzymol. 276, 344-358 <a class="reference external" href="https://doi.org/10.1016/S0076-6879%2897%2976068-3">doi:10.1016/S0076-6879(97)76068-3</a>.</p> <p><strong>Twin refinement</strong> — one fraction per domain operator of the lattice refined with the model, small domains dropped, and twin-related reflections kept in one free set, as REFMAC5 does; the fractions re-fitted by least squares at every cycle as REFMAC5 refines them, against an amplitude likelihood with the twinned model amplitude in it (a simplification of REFMAC5’s twinned-intensity target). G. N. Murshudov, P. Skubák, A. A. Lebedev, N. S. Pannu, R. A. Steiner, R. A. Nicholls, M. D. Winn, F. Long and A. A. Vagin, “REFMAC5 for the refinement of macromolecular crystal structures” (2011), Acta Cryst. D67, 355-367 <a class="reference external" href="https://doi.org/10.1107/S0907444911001314">doi:10.1107/S0907444911001314</a>; P. Roversi, E. Blanc, S. Johnson and S. M. Lea, “Tetartohedral twinning could happen to you too” (2012), Acta Cryst. D68, 418-424 <a class="reference external" href="https://doi.org/10.1107/S0907444912006737">doi:10.1107/S0907444912006737</a>; the six-domain case of a monoclinic crystal on a hexagonal metric is K. A. Sultana, I. Alexeev, I. Kursula, P. Mäntsälä, J. Niemi and G. Schneider, “Structure determination by multiwavelength anomalous diffraction of aclacinomycin oxidoreductase: indications of multidomain pseudomerohedral twinning” (2007), Acta Cryst. D63, 149-159 <a class="reference external" href="https://doi.org/10.1107/S0907444906044271">doi:10.1107/S0907444906044271</a>. A twin fraction as a parameter refined beside the model is SHELXL’s BASF (rugnux re-fits it between cycles rather than in the same least squares): R. Herbst-Irmer and G. M. Sheldrick, “Refinement of twinned structures with SHELXL97” (1998), Acta Cryst. B54, 443-449 <a class="reference external" href="https://doi.org/10.1107/S0108768197018454">doi:10.1107/S0108768197018454</a>. The twin laws come from the lattice’s metric: A. A. Lebedev, A. A. Vagin and G. N. Murshudov, “Intensity statistics in twinned crystals with examples from the PDB” (2006), Acta Cryst. D62, 83-95 <a class="reference external" href="https://doi.org/10.1107/S0907444905036759">doi:10.1107/S0907444905036759</a>.</p> <p><strong>Deciding pseudo-symmetry by refinement</strong> — carrying the adopted group and the index-2 subgroups a refused promotion leaves, each perfectly twinned by a law of its coset, to the model and deciding by placing and refining it in each, rather than from intensity statistics. P. H. Zwart, R. W. Grosse-Kunstleve, A. A. Lebedev, G. N. Murshudov and P. D. Adams, “Surprises and pitfalls arising from (pseudo)symmetry” (2008), Acta Cryst. D64, 99-107 <a class="reference external" href="https://doi.org/10.1107/S090744490705531X">doi:10.1107/S090744490705531X</a>; A. A. Lebedev and M. N. Isupov, “Space-group and origin ambiguity in macromolecular structures with pseudo-symmetry and its treatment with the program Zanuda” (2014), Acta Cryst. D70, 2430-2443 <a class="reference external" href="https://doi.org/10.1107/S1399004714014795">doi:10.1107/S1399004714014795</a>.</p> <p><strong>Twinning by reticular merohedry</strong> — a first-pass cell that is the coincidence lattice of two twin domains (reticular merohedry or pseudo-merohedry of index up to 10, e.g. obverse/reverse rhombohedral domains) is recognised by the nodes of neither domain being empty. The twin index is Friedel’s (G. Friedel, <em>Leçons de cristallographie</em>, 1926; no DOI); the split of the reflections into those of one domain, of the other, of both and of neither, and the treatment of reticular pseudo-merohedry (Herbst-Irmer and Sheldrick 1998, above), are Herbst-Irmer and Sheldrick’s: R. Herbst-Irmer and G. M. Sheldrick, “Refinement of obverse/reverse twins” (2002), Acta Cryst. B58, 477-481 <a class="reference external" href="https://doi.org/10.1107/S0108768102001039">doi:10.1107/S0108768102001039</a>.</p> <p><strong>Translational pseudo-symmetry</strong> — the off-origin native-Patterson peak read as a pseudo-translation between copies of the asymmetric unit, and the modulation it puts on the intensities, which the axial systematic-absence test also scores against. The per-dataset permutation null for the peak, the per-row estimate of the modulation depth, and its averaging over the lattice’s rotations are rugnux’s own. R. J. Read, P. D. Adams and A. J. McCoy, “Intensity statistics in the presence of translational noncrystallographic symmetry” (2013), Acta Cryst. D69, 176-183 <a class="reference external" href="https://doi.org/10.1107/S0907444912045374">doi:10.1107/S0907444912045374</a>. A pseudo-translation is declared at a Patterson peak of a fifth of the origin or more, Phaser’s default (McCoy et al. 2007, cited under <a class="reference internal" href="#model-placement-and-molecular-replacement">Model placement and molecular replacement</a>).</p> </section> <section id=scaling-and-merging > <h3 id=scaling-and-merging >Scaling and merging<a class=headerlink href="#scaling-and-merging" title="Link to this heading">¶</a></h3> <p><strong><a class="reference external" href="https://dials.github.io/">DIALS</a></strong> — the resolution cutoff from the CC1/2 fall-off, per-observation outlier rejection at merge, the scaling error model, and the treatment of a reflection whose background is contaminated; its published behaviour, and in places its source, settled several choices here. G. Winter, D. G. Waterman, J. M. Parkhurst et al., “DIALS: implementation and evaluation of a new integration package” (2018), Acta Cryst. D74, 85-97 <a class="reference external" href="https://doi.org/10.1107/S2059798317017235">doi:10.1107/S2059798317017235</a>; D. G. Waterman, G. Winter, R. J. Gildea et al., “Diffraction-geometry refinement in the DIALS framework” (2016), Acta Cryst. D72, 558-575 <a class="reference external" href="https://doi.org/10.1107/S2059798316002187">doi:10.1107/S2059798316002187</a>; J. Beilsten-Edmands, G. Winter, R. Gildea et al., “Scaling diffraction data in the DIALS software package: algorithms and new approaches for multi-crystal scaling” (2020), Acta Cryst. D76, 385-399 <a class="reference external" href="https://doi.org/10.1107/S2059798320003198">doi:10.1107/S2059798320003198</a>; J. M. Parkhurst, G. Winter, D. G. Waterman et al., “Robust background modelling in DIALS” (2016), J. Appl. Cryst. 49, 1912-1921 <a class="reference external" href="https://doi.org/10.1107/S1600576716013595">doi:10.1107/S1600576716013595</a>.</p> <p><strong>Wilson outlier test</strong> — judging an observation without symmetry mates against the acentric and centric distributions of its shell, with the symmetry enhancement factor; rejecting only significant observations, and keeping a reflection whose observations are all large, follows AIMLESS’s EMAX test. A. J. C. Wilson, “The probability distribution of X-ray intensities” (1949), Acta Cryst. 2, 318-321 <a class="reference external" href="https://doi.org/10.1107/S0365110X49000813">doi:10.1107/S0365110X49000813</a>; P. Evans, “Scaling and assessment of data quality” (2006), Acta Cryst. D62, 72-82 <a class="reference external" href="https://doi.org/10.1107/S0907444905036693">doi:10.1107/S0907444905036693</a>.</p> <p><strong>Amplitudes from intensities</strong> — the posterior-mean amplitude under the acentric and centric Wilson priors. S. French and K. Wilson, “On the treatment of negative intensity observations” (1978), Acta Cryst. A34, 517-525 <a class="reference external" href="https://doi.org/10.1107/S0567739478001114">doi:10.1107/S0567739478001114</a>. Giving no amplitude to an intensity more than 3.7 sigma below zero, and scaling each reflection’s prior by the anisotropy tensor along its direction, follow CCP4’s <a class="reference external" href="https://www.ccp4.ac.uk/">ctruncate</a> (C. Ballard and N. Stein), cited through the suite: M. D. Winn, C. C. Ballard, K. D. Cowtan et al., “Overview of the CCP4 suite and current developments” (2011), Acta Cryst. D67, 235-242 <a class="reference external" href="https://doi.org/10.1107/S0907444910045749">doi:10.1107/S0907444910045749</a>.</p> <p><strong>Absorption as spherical harmonics</strong> — the empirical absorption correction as a series of real spherical harmonics of the beam directions in the crystal frame is Blessing’s; its use as a restrained scaling surface of the diffracted-beam direction follows SCALA and AIMLESS. R. H. Blessing, “An empirical correction for absorption anisotropy” (1995), Acta Cryst. A51, 33-38 <a class="reference external" href="https://doi.org/10.1107/S0108767394005726">doi:10.1107/S0108767394005726</a>; P. Evans, “Scaling and assessment of data quality” (2006), Acta Cryst. D62, 72-82 <a class="reference external" href="https://doi.org/10.1107/S0907444905036693">doi:10.1107/S0907444905036693</a>.</p> <p><strong>Per-frame scale smoothing</strong> — the Whittaker smoother (a second-difference penalty, the smoothness chosen by cross-validation) in Eilers’s form. P. H. C. Eilers, “A perfect smoother” (2003), Anal. Chem. 75, 3631-3636 <a class="reference external" href="https://doi.org/10.1021/ac034173t">doi:10.1021/ac034173t</a>; E. T. Whittaker, “On a new method of graduation” (1923), Proc. Edinburgh Math. Soc. 41, 63-75 <a class="reference external" href="https://doi.org/10.1017/S0013091500077853">doi:10.1017/S0013091500077853</a>.</p> <p><strong>Fisher’s z-transformation</strong> — averaging the change of the half-set CC1/2 over resolution shells on atanh(CC) when the correction surfaces are cross-validated. R. A. Fisher, “Frequency distribution of the values of the correlation coefficient in samples from an indefinitely large population” (1915), Biometrika 10, 507-521 <a class="reference external" href="https://doi.org/10.2307/2331838">doi:10.2307/2331838</a>.</p> <p><strong>Frame disposition by delta-CC1/2</strong> — the statistic in its sigma-tau form, the Fisher transformation used to compare it, its standard error, and the rejection discipline (never remove a group whose delta-CC1/2 is positive or near zero; remove a little, re-form the reference and repeat), whose reference implementation is XDSCC12. G. Assmann, W. Brehm and K. Diederichs, “Identification of rogue datasets in serial crystallography” (2016), J. Appl. Cryst. 49, 1021-1028 <a class="reference external" href="https://doi.org/10.1107/S1600576716005471">doi:10.1107/S1600576716005471</a>; G. M. Assmann, M. Wang and K. Diederichs, “Making a difference in multi-data-set crystallography: simple and deterministic data-scaling/selection methods” (2020), Acta Cryst. D76, 636-652 <a class="reference external" href="https://doi.org/10.1107/S2059798320006348">doi:10.1107/S2059798320006348</a>. Applying it at scaling, to groups of images rather than whole datasets, follows DIALS (<code class="docutils literal notranslate"><span class=pre >dials.scale</span></code>): J. Beilsten-Edmands, G. Winter, R. Gildea et al., “Scaling diffraction data in the DIALS software package: algorithms and new approaches for multi-crystal scaling” (2020), Acta Cryst. D76, 385-399 <a class="reference external" href="https://doi.org/10.1107/S2059798320003198">doi:10.1107/S2059798320003198</a>.</p> <p><strong>Reasons for a weak stretch of a sweep</strong> — named in the field’s own words: “loss of centring” after autoPROC’s “loss of centring during crystal rotation” (cited under <a class="reference internal" href="#experimental-geometry-and-physical-corrections">Experimental geometry and physical corrections</a>), and “crystal rotating out of the beam” after the HKL-2000 manual (HKL: Otwinowski and Minor 1997, cited under <a class="reference internal" href="#integration-and-rotation-geometry">Integration and rotation geometry</a>).</p> <p><strong>Several sweeps merged as one</strong> — each sweep’s partials combined into fulls on their own, then the fulls of all sweeps scaled together with per-sweep frame scales and a relative B, as XSCALE merges data sets (W. Kabsch, “Integration, scaling, space-group assignment and post-refinement” (2010), above). Ordering the sweeps by dose from their relative B follows K. Diederichs, “Some aspects of quantitative analysis and correction of radiation damage” (2006), Acta Cryst. D62, 96-101 <a class="reference external" href="https://doi.org/10.1107/S0907444905031537">doi:10.1107/S0907444905031537</a>.</p> <p><strong>Reference sweep of a joint merge</strong> — the sweep whose own merge reaches the finest resolution, as KAMO takes the data set of the smallest Wilson B. K. Yamashita, K. Hirata and M. Yamamoto, “KAMO: towards automated data processing for microcrystals” (2018), Acta Cryst. D74, 441-449 <a class="reference external" href="https://doi.org/10.1107/S2059798318004576">doi:10.1107/S2059798318004576</a>.</p> </section> <section id=serial-data > <h3 id=serial-data >Serial data<a class=headerlink href="#serial-data" title="Link to this heading">¶</a></h3> <p><strong>Per-crystal post-refinement of stills</strong> — refining per still the partiality parameters the spot positions cannot pin (a small reorientation, the rocking width, the radial scale of the reciprocal lattice) against the merged intensities, after PRIME and the mosaic-block model of Sauter et al. M. Uervirojnangkoorn, O. B. Zeldin, A. Y. Lyubimov, J. Hattne, A. S. Brewster, N. K. Sauter, A. T. Brunger and W. I. Weis, “Enabling X-ray free electron laser crystallography for challenging biological systems from a limited number of crystals” (2015), eLife 4, e05421; N. K. Sauter, J. Hattne, A. S. Brewster, N. Echols, P. H. Zwart and P. D. Adams, “Improved crystal orientation and physical properties from single-shot XFEL stills” (2014), Acta Cryst. D70, 3299-3309 (DOIs not verified here, so not given).</p> <p><strong>Indexing ambiguity without a reference</strong> — putting each crystal into the indexing in which its intensities agree best with all the others, iterated to convergence, the method CrystFEL’s <code class="docutils literal notranslate"><span class=pre >ambigator</span></code> also implements; rugnux measures the agreement as a product of standardised amplitudes rather than a correlation. W. Brehm and K. Diederichs, “Breaking the indexing ambiguity in serial crystallography” (2014), Acta Cryst. D70, 101-109 <a class="reference external" href="https://doi.org/10.1107/S1399004713025431">doi:10.1107/S1399004713025431</a>. The same objective settles the indexing of each sweep of a joint merge, decided over all pairs at once as dials.cosym does: R. J. Gildea and G. Winter, “Determination of Patterson group symmetry from sparse multi-crystal data sets in the presence of an indexing ambiguity” (2018), Acta Cryst. D74, 405-410 <a class="reference external" href="https://doi.org/10.1107/S2059798318002978">doi:10.1107/S2059798318002978</a>.</p> </section> <section id=data-quality-and-anisotropy > <h3 id=data-quality-and-anisotropy >Data quality and anisotropy<a class=headerlink href="#data-quality-and-anisotropy" title="Link to this heading">¶</a></h3> <p><strong>Data-quality statistics</strong> — R_meas and R_pim, CC1/2 and CC*, the per-shell CC(model, data), and the reporting of I/sigma(I) follow the established conventions. K. Diederichs and P. A. Karplus, “Improved R-factors for diffraction data analysis in macromolecular crystallography” (1997), Nat. Struct. Biol. 4, 269-275 <a class="reference external" href="https://doi.org/10.1038/nsb0497-269">doi:10.1038/nsb0497-269</a>; P. A. Karplus and K. Diederichs, “Linking crystallographic model and data quality” (2012), Science 336, 1030-1033 <a class="reference external" href="https://doi.org/10.1126/science.1218231">doi:10.1126/science.1218231</a>; M. S. Weiss, “Global indicators of X-ray data quality” (2001), J. Appl. Cryst. 34, 130-135 <a class="reference external" href="https://doi.org/10.1107/S0021889800018227">doi:10.1107/S0021889800018227</a>; K. Diederichs and P. A. Karplus, “Better models by discarding data?” (2013), Acta Cryst. D69, 1215-1222 <a class="reference external" href="https://doi.org/10.1107/S0907444913001121">doi:10.1107/S0907444913001121</a>.</p> <p><strong>Isomorphism of sweeps</strong> — CC_AB / (CC*_A CC*_B) as the cosine of the angle between two data sets, on which a joint merge decides whether a sweep joins. K. Diederichs, “Dissecting random and systematic differences between noisy composite data sets” (2017), Acta Cryst. D73, 286-293 <a class="reference external" href="https://doi.org/10.1107/S2059798317000699">doi:10.1107/S2059798317000699</a>.</p> <p><strong>Diffraction anisotropy</strong> — the overall fall-off as a single anisotropic displacement tensor, its symmetry constraints and the determinacy of its deviatoric part only: S. Sheriff and W. A. Hendrickson, “Description of overall anisotropy in diffraction from macromolecular crystals” (1987), Acta Cryst. A43, 118-121 <a class="reference external" href="https://doi.org/10.1107/S010876738709977X">doi:10.1107/S010876738709977X</a>. Fitting it to the intensity distribution with sigma(I) taken into account: A. N. Popov and G. P. Bourenkov, “Choice of data-collection parameters based on statistic modelling” (2003), Acta Cryst. D59, 1145-1153 <a class="reference external" href="https://doi.org/10.1107/S0907444903008163">doi:10.1107/S0907444903008163</a>. The directional diffraction limits and the anisotropic deltaB reported as the range of the principal components follow AIMLESS: P. R. Evans and G. N. Murshudov, “How good are my data and what is the resolution?” (2013), Acta Cryst. D69, 1204-1214 <a class="reference external" href="https://doi.org/10.1107/S0907444913000061">doi:10.1107/S0907444913000061</a>. That every run should analyse and report its anisotropy is inspired by <a class="reference external" href="https://staraniso.globalphasing.org/">STARANISO</a>: I. J. Tickle, C. Flensburg, P. Keller, W. Paciorek, A. Sharff, C. Vonrhein and G. Bricogne (2016), STARANISO (<a class="reference external" href="https://staraniso.globalphasing.org/cgi-bin/staraniso.cgi">staraniso.globalphasing.org/cgi-bin/staraniso.cgi</a>), Cambridge, United Kingdom: Global Phasing Ltd. Rugnux reports the anisotropy; it corrects no intensity and removes no reflection on a directional criterion.</p> <p><strong>Uncertainty conventions</strong> — the IUCr Commission on Crystallographic Nomenclature’s. D. Schwarzenbach, S. C. Abrahams, H. D. Flack et al., “Statistical descriptors in crystallography: Report of the IUCr Subcommittee on Statistical Descriptors” (1989), Acta Cryst. A45, 63-75 <a class="reference external" href="https://doi.org/10.1107/S0108767388009596">doi:10.1107/S0108767388009596</a>; D. Schwarzenbach, S. C. Abrahams, H. D. Flack, E. Prince and A. J. C. Wilson, “Statistical descriptors in crystallography. II. Report of a Working Group on Expression of Uncertainty in Measurement” (1995), Acta Cryst. A51, 565-569 <a class="reference external" href="https://doi.org/10.1107/S0108767395002340">doi:10.1107/S0108767395002340</a>.</p> <p><strong>Unit-cell e.s.d.s</strong> — that the e.s.d.s of a least-squares cell fit are too small is Herbstein’s survey, which is why the cell is also fitted on blocks of consecutive frames. F. H. Herbstein, “How precise are measurements of unit-cell dimensions from single crystals?” (2000), Acta Cryst. B56, 547-557 <a class="reference external" href="https://doi.org/10.1107/S010876810000269X">doi:10.1107/S010876810000269X</a>.</p> <p><strong>Measurability</strong> — the fraction of acentric Bijvoet pairs significant at three sigma, reported beside SigAno and CCanom, is phenix.xtriage’s. P. H. Zwart, “Anomalous signal indicators in protein crystallography” (2005), Acta Cryst. D61, 1437-1448 <a class="reference external" href="https://doi.org/10.1107/S0907444905023589">doi:10.1107/S0907444905023589</a>.</p> <p><strong>Ice in the merged intensities</strong> — reading ice off a merge’s own intensities at the hexagonal-ice ring positions, and the table of the rings’ line strengths, are phenix.xtriage’s; rugnux’s comparison is local in resolution where xtriage’s is against the whole Wilson curve. P. H. Zwart, R. W. Grosse-Kunstleve and P. D. Adams, “Xtriage and Fest: automatic assessment of X-ray data and substructure structure factor estimation” (2005), CCP4 Newsletter on Protein Crystallography 43 (no DOI).</p> <p><strong>Advice on the next collection</strong> — the rotation a sweep needs and the blind region about the spindle that a tilted second sweep recovers. Z. Dauter, “Data-collection strategies” (1999), Acta Cryst. D55, 1703-1717 (DOI not verified here).</p> </section> <section id=model-placement-and-molecular-replacement > <h3 id=model-placement-and-molecular-replacement >Model placement and molecular replacement<a class=headerlink href="#model-placement-and-molecular-replacement" title="Link to this heading">¶</a></h3> <p><strong>Bulk-solvent correction and overall scaling</strong> — the flat bulk-solvent model, its starting values and the physically meaningful range of its two parameters: A. Fokine and A. Urzhumtsev, “Flat bulk-solvent model: obtaining optimal parameters” (2002), Acta Cryst. D58, 1387-1392 <a class="reference external" href="https://doi.org/10.1107/S0907444902010284">doi:10.1107/S0907444902010284</a>. The mask (the region a probe cannot reach, shrunk back), drawn with the radii REFMAC5 uses: J.-S. Jiang and A. T. Brünger, “Protein hydration observed by X-ray diffraction: solvation properties of penicillopepsin and neuraminidase crystal structures” (1994), J. Mol. Biol. 243, 100-115 <a class="reference external" href="https://doi.org/10.1006/jmbi.1994.1633">doi:10.1006/jmbi.1994.1633</a>. The grid search over the solvent pair with scale and anisotropic B refitted at each point: P. V. Afonine, R. W. Grosse-Kunstleve and P. D. Adams, “A robust bulk-solvent correction and anisotropic scaling procedure” (2005), Acta Cryst. D61, 850-855 <a class="reference external" href="https://doi.org/10.1107/S0907444905007894">doi:10.1107/S0907444905007894</a>. The fit is unweighted, as there and in REFMAC5: G. N. Murshudov, P. Skubak, A. A. Lebedev, N. S. Pannu, R. A. Steiner, R. A. Nicholls, M. D. Winn, F. Long and A. A. Vagin, “REFMAC5 for the refinement of macromolecular crystal structures” (2011), Acta Cryst. D67, 355-367 <a class="reference external" href="https://doi.org/10.1107/S0907444911001314">doi:10.1107/S0907444911001314</a>.</p> <p><strong>sigma_A map coefficients</strong> — the Rice and Woolfson likelihoods of |Fo| given |Fc| and sigma_A, the figure of merit m and the scale D, and the bias-corrected coefficients 2mFo-DFc (acentric) and mFo (centric). R. J. Read, “Improved Fourier coefficients for maps using phases from partial structures with errors” (1986), Acta Cryst. A42, 140-149 <a class="reference external" href="https://doi.org/10.1107/S0108767386099622">doi:10.1107/S0108767386099622</a>.</p> <p><strong><a class="reference external" href="https://doi.org/10.1107/S0021889811041768">ANODE</a></strong> — reading the anomalous difference map at the atoms of a supplied model and reporting the strongest sites by name, instead of searching the map for blobs. A. Thorn and G. M. Sheldrick, “ANODE: anomalous and heavy-atom density calculation” (2011), J. Appl. Cryst. 44, 1285-1287 <a class="reference external" href="https://doi.org/10.1107/S0021889811041768">doi:10.1107/S0021889811041768</a>.</p> <p><strong>Uniform random rotations</strong> — the null a supplied model, and a molecular-replacement search, are scored against draws rotations uniformly from SO(3) through a uniform random unit quaternion. K. Shoemake, “Uniform Random Rotations”, in <em>Graphics Gems III</em>, ed. D. Kirk, Academic Press (1992), 124-132 (no DOI).</p> <p><strong>Variable projection</strong> — the rigid-body placement re-fits the overall scale at every step and folds that re-fit into its Jacobian, in Kaufman’s simplified form of Golub and Pereyra’s derivative. G. H. Golub and V. Pereyra, “The Differentiation of Pseudo-Inverses and Nonlinear Least Squares Problems Whose Variables Separate” (1973), SIAM J. Numer. Anal. 10, 413-432 <a class="reference external" href="https://doi.org/10.1137/0710036">doi:10.1137/0710036</a>; L. Kaufman, “A variable projection method for solving separable nonlinear least squares problems” (1975), BIT 15, 49-57 <a class="reference external" href="https://doi.org/10.1007/BF01932995">doi:10.1007/BF01932995</a>.</p> <p><strong>Predicted models</strong> — <code class="docutils literal notranslate"><span class=pre >--model</span></code> (and <code class="docutils literal notranslate"><span class=pre >--mr</span></code>) place an AlphaFold prediction by molecular replacement. J. Jumper, R. Evans, A. Pritzel et al., “Highly accurate protein structure prediction with AlphaFold” (2021), Nature 596, 583-589 <a class="reference external" href="https://doi.org/10.1038/s41586-021-03819-2">doi:10.1038/s41586-021-03819-2</a>; the models are those of the AlphaFold Protein Structure Database: M. Varadi, S. Anyango, M. Deshpande et al., “AlphaFold Protein Structure Database: massively expanding the structural coverage of protein-sequence space with high-accuracy models” (2022), Nucleic Acids Res. 50, D439-D444 <a class="reference external" href="https://doi.org/10.1093/nar/gkab1061">doi:10.1093/nar/gkab1061</a>. The model is prepared as phenix.process_predicted_model prepares one (residues below pLDDT 70 removed, B factors from the predicted coordinate error) and cut into rigid domains by its predicted aligned error: R. D. Oeffner, T. Croll, C. Millán et al., “Putting AlphaFold models to work with phenix.process_predicted_model and ISOLDE” (2022), Acta Cryst. D78, 1303-1314 <a class="reference external" href="https://doi.org/10.1107/S2059798322010026">doi:10.1107/S2059798322010026</a>; the error itself is AlphaFold’s: J. Jumper, R. Evans, A. Pritzel et al., “Highly accurate protein structure prediction with AlphaFold” (2021), Nature 596, 583-589 <a class="reference external" href="https://doi.org/10.1038/s41586-021-03819-2">doi:10.1038/s41586-021-03819-2</a>.</p> <p><strong>Molecular replacement search</strong> — scoring each orientation of the model by interpolating its molecular transform, computed once by FFT, as AMoRe does: J. Navaza, “AMoRe: an automated package for molecular replacement” (1994), Acta Cryst. A50, 157-163 <a class="reference external" href="https://doi.org/10.1107/S0108767393007597">doi:10.1107/S0108767393007597</a>. The full-symmetry translation function, all pairs of symmetry copies on one Fourier synthesis: R. A. Crowther and D. M. Blow, “A method of positioning a known molecule in an unknown crystal structure” (1967), Acta Cryst. 23, 544-548 <a class="reference external" href="https://doi.org/10.1107/S0365110X67003172">doi:10.1107/S0365110X67003172</a>. A placement is a solution, as Phaser calls one, where its translation-function Z-score reaches 8: A. J. McCoy, R. W. Grosse-Kunstleve, P. D. Adams, M. D. Winn, L. C. Storoni and R. J. Read, “Phaser crystallographic software” (2007), J. Appl. Cryst. 40, 658-674 <a class="reference external" href="https://doi.org/10.1107/S0021889807021206">doi:10.1107/S0021889807021206</a>.</p> <p><strong>Cell contents</strong> — whether one copy fits the cell is read off the Matthews coefficient: B. W. Matthews, “Solvent content of protein crystals” (1968), J. Mol. Biol. 33, 491-497 <a class="reference external" href="https://doi.org/10.1016/0022-2836%2868%2990205-2">doi:10.1016/0022-2836(68)90205-2</a>; how many copies to search for is weighed by its distribution over protein crystals: K. A. Kantardjieff and B. Rupp, “Matthews coefficient probabilities: Improved estimates for unit cell contents of proteins, DNA, and protein-nucleic acid complex crystals” (2003), Protein Sci. 12, 1865-1871 <a class="reference external" href="https://doi.org/10.1110/ps.0350503">doi:10.1110/ps.0350503</a>. The placements of several copies are compared by least-squares superposition: W. Kabsch, “A solution for the best rotation to relate two sets of vectors” (1976), Acta Cryst. A32, 922-923 <a class="reference external" href="https://doi.org/10.1107/S0567739476001873">doi:10.1107/S0567739476001873</a>.</p> <p><strong>Likelihood scoring of placements</strong> — the log-likelihood gain from the Rice and Woolfson distributions of the normalised amplitudes given the model’s, with sigma_A falling off with resolution for the model’s expected coordinate error as Luzzati’s D: V. Luzzati, “Traitement statistique des erreurs dans la détermination des structures cristallines” (1952), Acta Cryst. 5, 802-810 <a class="reference external" href="https://doi.org/10.1107/S0365110X52002161">doi:10.1107/S0365110X52002161</a>; R. J. Read, “Pushing the boundaries of molecular replacement with maximum likelihood” (2001), Acta Cryst. D57, 1373-1382 <a class="reference external" href="https://doi.org/10.1107/S0907444901012471">doi:10.1107/S0907444901012471</a>; the gain read as a Z-score over the same orientation at other positions, as the likelihood-enhanced translation function’s is: A. J. McCoy, R. W. Grosse-Kunstleve, L. C. Storoni and R. J. Read, “Likelihood-enhanced fast translation functions” (2005), Acta Cryst. D61, 458-464 <a class="reference external" href="https://doi.org/10.1107/S0907444905001617">doi:10.1107/S0907444905001617</a>; and a model whose expected log-likelihood gain is too small for a placement to stand out is not searched for: A. J. McCoy, R. D. Oeffner, A. G. Wrobel, J. R. M. Ojala, K. Tryggvason, B. Lohkamp and R. J. Read, “Ab initio solution of macromolecular crystal structures without direct methods” (2017), Proc. Natl. Acad. Sci. USA 114, 3637-3641 <a class="reference external" href="https://doi.org/10.1073/pnas.1701640114">doi:10.1073/pnas.1701640114</a>. Translational NCS is looked for in the native Patterson before the search, read as under <a class="reference internal" href="#space-group-twinning-and-pseudo-symmetry">Translational pseudo-symmetry</a>. The logarithm of the Bessel function I0 is evaluated with the polynomial approximations of M. Abramowitz and I. A. Stegun, “Handbook of Mathematical Functions” (1964), National Bureau of Standards, 9.8.1-9.8.2.</p> </section> <section id=structure-refinement > <h3 id=structure-refinement >Structure refinement<a class=headerlink href="#structure-refinement" title="Link to this heading">¶</a></h3> <p><strong>Likelihood target</strong> — the Rice distribution of an observed amplitude given the model’s, and its centric counterpart. N. S. Pannu and R. J. Read, “Improved structure refinement through maximum likelihood” (1996), Acta Cryst. A52, 659-668 <a class="reference external" href="https://doi.org/10.1107/S0108767396004370">doi:10.1107/S0108767396004370</a>; G. N. Murshudov, A. A. Vagin and E. J. Dodson, “Refinement of macromolecular structures by the maximum-likelihood method” (1997), Acta Cryst. D53, 240-255 <a class="reference external" href="https://doi.org/10.1107/S0907444996012255">doi:10.1107/S0907444996012255</a>. Its parameters are fitted in resolution bins, the variance on the free reflections and D on the working ones, as REFMAC5 divides them (Murshudov et al. 2011, above); estimating them on free reflections follows V. Y. Lunin and T. P. Skovoroda, “R-free likelihood-based estimates of errors for phases calculated from atomic models” (1995), Acta Cryst. A51, 880-887 <a class="reference external" href="https://doi.org/10.1107/S010876739500688X">doi:10.1107/S010876739500688X</a>; V. Y. Lunin, P. V. Afonine and A. G. Urzhumtsev, “Likelihood-based refinement. I. Irremovable model errors” (2002), Acta Cryst. A58, 270-282 <a class="reference external" href="https://doi.org/10.1107/S0108767302001046">doi:10.1107/S0108767302001046</a>.</p> <p><strong>Gradients by FFT</strong> — the derivatives of the target with respect to the structure factors transformed into a map and summed against each atom’s density derivatives. R. C. Agarwal, “A new least-squares refinement technique based on the fast Fourier transform algorithm” (1978), Acta Cryst. A34, 791-809 <a class="reference external" href="https://doi.org/10.1107/S0567739478001618">doi:10.1107/S0567739478001618</a>.</p> <p><strong>Minimiser</strong> — L-BFGS (rugnux’s own implementation). D. C. Liu and J. Nocedal, “On the limited memory BFGS method for large scale optimization” (1989), Math. Program. 45, 503-528 <a class="reference external" href="https://doi.org/10.1007/BF01589116">doi:10.1007/BF01589116</a>; its two-loop recursion: J. Nocedal, “Updating quasi-Newton matrices with limited storage” (1980), Math. Comp. 35, 773-782 <a class="reference external" href="https://doi.org/10.1090/S0025-5718-1980-0572855-7">doi:10.1090/S0025-5718-1980-0572855-7</a>. The initial inverse Hessian is rescaled at each iteration by the latest pair, the self-scaling of S. S. Oren and D. G. Luenberger, “Self-scaling variable metric (SSVM) algorithms. Part I” (1974), Management Sci. 20, 845-862 <a class="reference external" href="https://doi.org/10.1287/mnsc.20.5.845">doi:10.1287/mnsc.20.5.845</a>, and D. F. Shanno and K.-H. Phua, “Matrix conditioning and nonlinear optimization” (1978), Math. Program. 14, 149-160 <a class="reference external" href="https://doi.org/10.1007/BF01588962">doi:10.1007/BF01588962</a>.</p> <p><strong>Geometry restraints</strong> — those of the CCP4 Monomer Library, a subset of which rugnux carries (see <a class="reference internal" href=THIRD_PARTY_NOTICES.html ><span class="std std-doc">THIRD_PARTY_NOTICES.md</span></a>). A. A. Vagin, R. A. Steiner, A. A. Lebedev, L. Potterton, S. McNicholas, F. Long and G. N. Murshudov, “REFMAC5 dictionary: organization of prior chemical knowledge and guidelines for its use” (2004), Acta Cryst. D60, 2184-2195 <a class="reference external" href="https://doi.org/10.1107/S0907444904023510">doi:10.1107/S0907444904023510</a>. They are applied through GEMMI’s topology (links, modifications, planes, chiral volumes, torsions): M. Wojdyr, “GEMMI: A library for structural biology” (2022), J. Open Source Softw. 7, 4200 <a class="reference external" href="https://doi.org/10.21105/joss.04200">doi:10.21105/joss.04200</a>. The torsion derivatives follow A. Blondel and M. Karplus, “New formulation for derivatives of torsion angles and improper torsion angles in molecular mechanics: elimination of singularities” (1996), J. Comput. Chem. 17, 1132-1141 <a class="reference external" href="https://doi.org/10.1002/(SICI)1096-987X(19960715)17:9%3C1132::AID-JCC5%3E3.0.CO;2-T">doi:10.1002/(SICI)1096-987X(19960715)17:9<1132::AID-JCC5>3.0.CO;2-T</a>.</p> <p><strong>Riding hydrogens</strong> — placed on their parent atoms by GEMMI’s riding-hydrogen code, which follows D. Liebschner, P. V. Afonine, A. G. Urzhumtsev and P. D. Adams, “Implementation of the riding hydrogen model in CCTBX to support the next generation of X-ray and neutron joint refinement in Phenix” (2020), Methods Enzymol. 634, 177-199 <a class="reference external" href="https://doi.org/10.1016/bs.mie.2020.01.007">doi:10.1016/bs.mie.2020.01.007</a>.</p> <p><strong>B-factor restraints</strong> — bonded atoms, and atoms in contact, restrained to each other in the Kullback-Leibler form REFMAC5 uses (Murshudov et al. 2011, above); the divergence itself is S. Kullback and R. A. Leibler’s, “On information and sufficiency” (1951), Ann. Math. Statist. 22, 79-86 <a class="reference external" href="https://doi.org/10.1214/aoms/1177729694">doi:10.1214/aoms/1177729694</a>. The overall isotropic B of the scale is moved into the atoms as phenix.refine moves it (Afonine et al. 2012, below).</p> <p><strong>Weights and R-free</strong> — the weights of the X-ray term against the geometry and B restraints start from the ratios of the gradients, as X-PLOR’s crystallographic weight was first set: A. T. Brünger, M. Karplus and G. A. Petsko, “Crystallographic refinement by simulated annealing: application to crambin” (1989), Acta Cryst. A45, 50-61 <a class="reference external" href="https://doi.org/10.1107/S0108767388009195">doi:10.1107/S0108767388009195</a>; and are chosen among short refinements by R-free with the geometry held within bounds, as phenix.refine chooses them: P. V. Afonine, R. W. Grosse-Kunstleve, N. Echols, J. J. Headd, N. W. Moriarty, M. Mustyakimov, T. C. Terwilliger, A. Urzhumtsev, P. H. Zwart and P. D. Adams, “Towards automated crystallographic structure refinement with phenix.refine” (2012), Acta Cryst. D68, 352-367 <a class="reference external" href="https://doi.org/10.1107/S0907444912001308">doi:10.1107/S0907444912001308</a>. R-free itself: A. T. Brünger, “Free R value: a novel statistical quantity for assessing the accuracy of crystal structures” (1992), Nature 355, 472-475 <a class="reference external" href="https://doi.org/10.1038/355472a0">doi:10.1038/355472a0</a>.</p> <p><strong>Robust scaling of the model</strong> — the overall scale and anisotropic B are fitted by iteratively reweighted least squares with the pseudo-Huber weight. P. J. Huber, “Robust estimation of a location parameter” (1964), Ann. Math. Statist. 35, 73-101 <a class="reference external" href="https://doi.org/10.1214/aoms/1177703732">doi:10.1214/aoms/1177703732</a>, in the smooth form of P. Charbonnier, L. Blanc-Féraud, G. Aubert and M. Barlaud, “Deterministic edge-preserving regularization in computed imaging” (1997), IEEE Trans. Image Process. 6, 298-311 <a class="reference external" href="https://doi.org/10.1109/83.551699">doi:10.1109/83.551699</a>.</p> <p><strong>Metal-site restraints</strong> — the bonds of metal ions to the donor atoms the model’s LINK records name are restrained at the distances of the Monomer Library’s own metal-site statistics (<code class="docutils literal notranslate"><span class=pre >metals.json</span></code>, embedded as <code class="docutils literal notranslate"><span class=pre >monomers/metals.cif</span></code>), in line with the surveys of M. M. Harding, “Geometry of metal-ligand interactions in proteins” (2001), Acta Cryst. D57, 401-411 <a class="reference external" href="https://doi.org/10.1107/S0907444900019168">doi:10.1107/S0907444900019168</a> and “Small revisions to predicted distances around metal sites in proteins” (2006), Acta Cryst. D62, 678-682 <a class="reference external" href="https://doi.org/10.1107/S0907444906014594">doi:10.1107/S0907444906014594</a>, and, for Mg²⁺, Na⁺ and K⁺ at nucleic acids, F. Leonarski, L. D’Ascenzo and P. Auffinger, “Mg2+ ions: do they bind to nucleobase nitrogens?” (2017), Nucleic Acids Res. 45, 987-1004 <a class="reference external" href="https://doi.org/10.1093/nar/gkw1175">doi:10.1093/nar/gkw1175</a>.</p> <p><strong>Anisotropic displacements</strong> — the TLS model of a rigid body’s translation, libration and their correlation: V. Schomaker and K. N. Trueblood, “On the rigid-body motion of molecules in crystals” (1968), Acta Cryst. B24, 63-76 <a class="reference external" href="https://doi.org/10.1107/S0567740868001718">doi:10.1107/S0567740868001718</a>; refined against the likelihood with a residual B per atom, the B column read as total or residual, as in M. D. Winn, M. N. Isupov and G. N. Murshudov, “Use of TLS parameters to model anisotropic displacements in macromolecular refinement” (2001), Acta Cryst. D57, 122-133 <a class="reference external" href="https://doi.org/10.1107/S0907444900014736">doi:10.1107/S0907444900014736</a>. The chains are cut into TLS groups as TLSMD cuts them: J. Painter and E. A. Merritt, “Optimal description of a protein structure in terms of multiple groups undergoing TLS motion” (2006), Acta Cryst. D62, 439-450 <a class="reference external" href="https://doi.org/10.1107/S0907444906005270">doi:10.1107/S0907444906005270</a>. Atoms with a U of their own are restrained by the rigid-bond postulate of F. L. Hirshfeld, “Can X-ray data distinguish bonding effects from vibrational smearing?” (1976), Acta Cryst. A32, 239-244 <a class="reference external" href="https://doi.org/10.1107/S0567739476000533">doi:10.1107/S0567739476000533</a>, in the form of SHELXL’s RIGU: A. Thorn, B. Dittrich and G. M. Sheldrick, “Enhanced rigid-bond restraints” (2012), Acta Cryst. A68, 448-451 <a class="reference external" href="https://doi.org/10.1107/S0108767312014535">doi:10.1107/S0108767312014535</a>, with SHELXL’s SIMU and ISOR restraints as G. M. Sheldrick, “Crystal structure refinement with SHELXL” (2015), Acta Cryst. C71, 3-8 <a class="reference external" href="https://doi.org/10.1107/S2053229614024218">doi:10.1107/S2053229614024218</a> documents them. Which displacement model a refinement keeps is decided on the free set rather than by a rule of resolution: E. A. Merritt, “To B or not to B: a question of resolution?” (2012), Acta Cryst. D68, 468-477 <a class="reference external" href="https://doi.org/10.1107/S0907444911028320">doi:10.1107/S0907444911028320</a>.</p> <p><strong>NCS restraints</strong> — copies found by sequence alignment with REFMAC5’s criterion (Murshudov et al. 2011, above) and restrained locally on pairs of corresponding interatomic distances under the Geman-McClure loss, as REFMAC5’s local NCS restraints are, with the distance range of R. A. Nicholls, F. Long and G. N. Murshudov, “Low-resolution refinement tools in REFMAC5” (2012), Acta Cryst. D68, 404-417 <a class="reference external" href="https://doi.org/10.1107/S090744491105606X">doi:10.1107/S090744491105606X</a>. The superposition behind the rms criterion is GEMMI’s QCP: D. L. Theobald, “Rapid calculation of RMSDs using a quaternion-based characteristic polynomial” (2005), Acta Cryst. A61, 478-480 <a class="reference external" href="https://doi.org/10.1107/S0108767305015266">doi:10.1107/S0108767305015266</a>; P. Liu, D. K. Agrafiotis and D. L. Theobald, “Fast determination of the optimal rotational matrix for macromolecular superpositions” (2010), J. Comput. Chem. 31, 1561-1563 <a class="reference external" href="https://doi.org/10.1002/jcc.21439">doi:10.1002/jcc.21439</a>. The case for local restraints over a superposition, decided by R-free: G. J. Kleywegt, “Use of non-crystallographic symmetry in protein structure refinement” (1996), Acta Cryst. D52, 842-857 <a class="reference external" href="https://doi.org/10.1107/S0907444995016477">doi:10.1107/S0907444995016477</a>; I. Usón, E. Pohl, T. R. Schneider, Z. Dauter, A. Schmidt, H.-J. Fritz and G. M. Sheldrick, “1.7 Å structure of the stabilized REIv mutant T39K. Application of local NCS restraints” (1999), Acta Cryst. D55, 1158-1167 <a class="reference external" href="https://doi.org/10.1107/S0907444999003972">doi:10.1107/S0907444999003972</a>; and J. J. Headd, N. Echols, P. V. Afonine, N. W. Moriarty, R. J. Gildea and P. D. Adams, “Flexible torsion-angle noncrystallographic symmetry restraints for improved macromolecular structure refinement” (2014), Acta Cryst. D70, 1346-1356 <a class="reference external" href="https://doi.org/10.1107/S1399004714003277">doi:10.1107/S1399004714003277</a>, whose comparison is why the copies’ B factors are refined independently.</p> <p><strong>Special positions</strong> — an atom on a special position is kept on it, its shifts confined to the subspace its site symmetry leaves unchanged. R. W. Grosse-Kunstleve and P. D. Adams, “Algorithms for deriving crystallographic space-group information. II. Treatment of special positions” (2002), Acta Cryst. A58, 60-65 <a class="reference external" href="https://doi.org/10.1107/S0108767301016658">doi:10.1107/S0108767301016658</a>.</p> </section> <section id=solvent-ions-and-unmodelled-density > <h3 id=solvent-ions-and-unmodelled-density >Solvent, ions and unmodelled density<a class=headerlink href="#solvent-ions-and-unmodelled-density" title="Link to this heading">¶</a></h3> <p><strong>Unmodelled density</strong> — the connected regions of the difference map above a cutoff, found by flood fill as Coot’s “unmodelled blobs” are, in GEMMI’s implementation. P. Emsley, B. Lohkamp, W. G. Scott and K. Cowtan, “Features and development of Coot” (2010), Acta Cryst. D66, 486-501 <a class="reference external" href="https://doi.org/10.1107/S0907444910007493">doi:10.1107/S0907444910007493</a>.</p> <p><strong>Water build</strong> — the documented ordered-solvent defaults of phenix.refine (difference-map peaks from 3 σ, picking to 2.8 Å, waters added, filtered and refined between macro-cycles; Afonine et al. 2012, above); the distance band to the model, widened a little from the 2.4-3.2 Å Coot’s Find Waters keeps (Emsley et al. 2010, above); and the removal of a water in negative difference density at -3 σ (Echols et al. 2014, below).</p> <p><strong>Ion stereochemistry</strong> — the coordination bands, the Mg²⁺ exclusion zone and the clash shells of the surveys of ions at nucleic acids by P. Auffinger’s group. N. Naleem, A. Henning-Knechtel, S. Kirmizialtin and P. Auffinger, “Cat_Wiz: a stereochemistry-guided toolkit for locating, diagnosing, and annotating Mg2+ ions in RNA structures” (2026), Nucleic Acids Res. 54, gkag120 <a class="reference external" href="https://doi.org/10.1093/nar/gkag120">doi:10.1093/nar/gkag120</a>; F. Leonarski, A. Henning-Knechtel, S. Kirmizialtin, E. Ennifar and P. Auffinger, “Principles of ion binding to RNA inferred from the analysis of a 1.55 Å resolution bacterial ribosome structure – Part I: Mg2+” (2025), Nucleic Acids Res. 53, gkae1148 <a class="reference external" href="https://doi.org/10.1093/nar/gkae1148">doi:10.1093/nar/gkae1148</a>; F. Leonarski, L. D’Ascenzo and P. Auffinger, “Nucleobase carbonyl groups are poor Mg2+ inner-sphere binders but excellent monovalent ion binders—a critical PDB survey” (2019), RNA 25, 173-192 <a class="reference external" href="https://doi.org/10.1261/rna.068437.118">doi:10.1261/rna.068437.118</a>; and their 2017 survey (above). The score that combines the criteria is rugnux’s own.</p> <p><strong>Ion identification</strong> — the ligand sphere of the bond-valence sums, the reading of halides by their donors, and telling a light ion from a water by its density: N. Echols, N. Morshed, P. V. Afonine, A. J. McCoy, M. D. Miller, R. J. Read, J. S. Richardson, T. C. Terwilliger and P. D. Adams, “Automated identification of elemental ions in macromolecular crystal structures” (2014), Acta Cryst. D70, 1104-1114 <a class="reference external" href="https://doi.org/10.1107/S1399004714001308">doi:10.1107/S1399004714001308</a>; N. Morshed, N. Echols and P. D. Adams, “Using support vector machines to improve elemental ion identification in macromolecular crystal structures” (2015), Acta Cryst. D71, 1147-1158 <a class="reference external" href="https://doi.org/10.1107/S1399004715004241">doi:10.1107/S1399004715004241</a>. The chloride’s shell of donors: O. Carugo, “Buried chloride stereochemistry in the Protein Data Bank” (2014), BMC Struct. Biol. 14, 19 <a class="reference external" href="https://doi.org/10.1186/s12900-014-0019-8">doi:10.1186/s12900-014-0019-8</a>; halides at hydrophobic surfaces: Z. Dauter and M. Dauter, “Entering a new phase: using solvent halide ions in protein structure determination” (2001), Structure 9, R21-R26 <a class="reference external" href="https://doi.org/10.1016/S0969-2126(01)00565-2">doi:10.1016/S0969-2126(01)00565-2</a>.</p> <p><strong>Bond-valence sums</strong> — I. D. Brown and D. Altermatt, “Bond-valence parameters obtained from a systematic analysis of the Inorganic Crystal Structure Database” (1985), Acta Cryst. B41, 244-247 <a class="reference external" href="https://doi.org/10.1107/S0108768185002063">doi:10.1107/S0108768185002063</a>, with the R₀ of N. E. Brese and M. O’Keeffe, “Bond-valence parameters for solids” (1991), Acta Cryst. B47, 192-197 <a class="reference external" href="https://doi.org/10.1107/S0108768190011041">doi:10.1107/S0108768190011041</a>, as tabulated by H. Zheng, K. M. Langner, G. P. Shields, J. Hou, M. Kowiel, F. H. Allen, G. Murshudov and W. Minor, “Data mining of iron(II) and iron(III) bond-valence parameters, and their relevance for macromolecular crystallography” (2017), Acta Cryst. D73, 316-325 <a class="reference external" href="https://doi.org/10.1107/S2059798317000584">doi:10.1107/S2059798317000584</a>; weighted by occupancy as P. Müller, S. Köpke and G. M. Sheldrick weight them, “Is the bond-valence method able to identify metal atoms in protein structures?” (2003), Acta Cryst. D59, 32-37 <a class="reference external" href="https://doi.org/10.1107/S0907444902018000">doi:10.1107/S0907444902018000</a>; the normalised vector sum and its outlier bound are CheckMyMetal’s: H. Zheng, D. R. Cooper, P. J. Porebski, I. G. Shabalin, K. B. Handing and W. Minor, “CheckMyMetal: a macromolecular metal-binding validation tool” (2017), Acta Cryst. D73, 223-233 <a class="reference external" href="https://doi.org/10.1107/S2059798317001061">doi:10.1107/S2059798317001061</a>.</p> <p><strong>Anomalous scattering factors</strong> — f″ at the data’s wavelength, as GEMMI computes it (its port of the Larch routines). D. T. Cromer and D. A. Liberman, “Anomalous dispersion calculations near to and on the long-wavelength side of an absorption edge” (1981), Acta Cryst. A37, 267-268 <a class="reference external" href="https://doi.org/10.1107/S0567739481000600">doi:10.1107/S0567739481000600</a>, with the corrections of L. Kissel and R. H. Pratt, “Corrections to tabulated anomalous-scattering factors” (1990), Acta Cryst. A46, 170-175 <a class="reference external" href="https://doi.org/10.1107/S0108767389010718">doi:10.1107/S0108767389010718</a>.</p> </section> </section> <section id=software-and-computing-methods > <h2 id=software-and-computing-methods >Software and computing methods<a class=headerlink href="#software-and-computing-methods" title="Link to this heading">¶</a></h2> <p><strong>GPU decompression</strong> — decoding bitshuffle+LZ4 images on the GPU rather than on the host follows Jon Wright (ESRF): “Experiences with GPU decompression for bitshuffle + LZ4 data”, HDF5 User Group meeting (2021), and <a class="reference external" href="https://github.com/jonwright/bslz4decoders">bslz4decoders</a>. The CUDA kernels are Jungfraujoch’s own; the approach is his.</p> <p><strong>Parallel connected components</strong> — removing the islands of the bulk-solvent mask on the GPU with a parallel union-find. D. P. Playne and K. Hawick, “A New Algorithm for Parallel Connected-Component Labelling on GPUs” (2018), IEEE Trans. Parallel Distrib. Syst. 29, 1217-1230 <a class="reference external" href="https://doi.org/10.1109/TPDS.2018.2799216">doi:10.1109/TPDS.2018.2799216</a>.</p> <p><strong>Correctly rounded integer division</strong> — the FFT indexer’s GPU peak search divides by a reciprocal multiplication corrected once by the exact remainder. P. W. Markstein, “Computation of elementary functions on the IBM RISC System/6000 processor” (1990), IBM J. Res. Dev. 34, 111-119.</p> <p><strong>Anderson acceleration</strong> — of the per-frame scaling loops of the rotation merge, in the type-II form. H. F. Walker and P. Ni, “Anderson acceleration for fixed-point iterations” (2011), SIAM J. Numer. Anal. 49, 1715-1735 <a class="reference external" href="https://doi.org/10.1137/10078356X">doi:10.1137/10078356X</a>, after D. G. Anderson, “Iterative procedures for nonlinear integral equations” (1965), J. ACM 12, 547-560 <a class="reference external" href="https://doi.org/10.1145/321296.321305">doi:10.1145/321296.321305</a>.</p> <p><strong>Bootstrap</strong> — the interval reported for ISa. B. Efron, “Bootstrap methods: another look at the jackknife” (1979), Ann. Statist. 7, 1-26 <a class="reference external" href="https://doi.org/10.1214/aos/1176344552">doi:10.1214/aos/1176344552</a>. Its draws are Poisson weights hashed with the SplitMix64 finaliser of G. L. Steele Jr., D. Lea and C. H. Flood, “Fast splittable pseudorandom number generators” (2014), Proc. OOPSLA 2014, 453-472 <a class="reference external" href="https://doi.org/10.1145/2660193.2660195">doi:10.1145/2660193.2660195</a>.</p> <p><strong>Error-free floating-point arithmetic</strong> — the single-precision exp shared between the CPU and an Apple GPU (<code class="docutils literal notranslate"><span class=pre >BraggExp.h</span></code>): the argument reduction of W. J. Cody and W. Waite, “Software Manual for the Elementary Functions” (1980), Prentice-Hall; the exact product (with Veltkamp’s split) and Fast2Sum of T. J. Dekker, “A floating-point technique for extending the available precision” (1971), Numer. Math. 18, 224-242; and the 2Sum of D. E. Knuth, “The Art of Computer Programming, Vol. 2: Seminumerical Algorithms”, section 4.2.2.</p> <p><strong>Colormaps</strong> — Viridis, Magma and Inferno from Matplotlib, under its BSD-compatible license. J. D. Hunter, “Matplotlib: A 2D graphics environment” (2007), Comput. Sci. Eng. 9, 90-95 <a class="reference external" href="https://doi.org/10.1109/MCSE.2007.55">doi:10.1109/MCSE.2007.55</a>.</p> <p><strong><a class="reference external" href="https://molstar.org/">Mol*</a></strong> — the web frontend’s structure viewer. D. Sehnal, S. Bittrich, M. Deshpande, R. Svobodová, K. Berka, V. Bazgier, S. Velankar, S. K. Burley, J. Koča and A. S. Rose, “Mol* Viewer: modern web app for 3D visualization and analysis of large biomolecular structures” (2021), Nucleic Acids Res. 49, W431-W437 <a class="reference external" href="https://doi.org/10.1093/nar/gkab314">doi:10.1093/nar/gkab314</a>. Its setup follows the one Guillaume Gotthard (PSI) tuned for <a class="reference external" href="https://gitea.psi.ch/mx/aaredb">AareDB</a>, the sample-management and data-pipeline system of the PSI MX beamlines: the Coot-style mouse controls, the model representations and colours, and the display of the density maps. The virtual trackball is a port of Coot’s, itself a port of SGI’s <code class="docutils literal notranslate"><span class=pre >trackball.c</span></code> by Gavin Bell.</p> </section> <section id=file-formats-read-from-a-published-specification > <h2 id=file-formats-read-from-a-published-specification >File formats read from a published specification<a class=headerlink href="#file-formats-read-from-a-published-specification" title="Link to this heading">¶</a></h2> <p><strong>CBF / imgCIF</strong> — the native miniCBF reader implements the <code class="docutils literal notranslate"><span class=pre >x-CBF_BYTE_OFFSET</span></code> compression and the imgCIF <code class="docutils literal notranslate"><span class=pre >_axis</span></code> table from the specification alone; no CBFlib or other CBF code is used. H. J. Bernstein and A. P. Hammersley, “Specification of the Crystallographic Binary File (CBF/imgCIF)” (2006), International Tables for Crystallography Vol. G, 37-43 <a class="reference external" href="https://doi.org/10.1107/97809553602060000729">doi:10.1107/97809553602060000729</a>; A. P. Hammersley, H. J. Bernstein and J. D. Westbrook, “Image dictionary (imgCIF)” (2006), International Tables for Crystallography Vol. G, 444-458 <a class="reference external" href="https://doi.org/10.1107/97809553602060000746">doi:10.1107/97809553602060000746</a>.</p> <p><strong>PILATUS count-rate clipping</strong> — that the count-rate correction clips an over-range pixel to the cutoff rather than flagging it, which is how the miniCBF reader tells a saturated pixel. P. Trueb, C. Dejoie, M. Kobas, P. Pattison, D. J. Peake, V. Radicci, B. A. Sobott, D. A. Walko and C. Broennimann, “Bunch mode specific rate corrections for PILATUS3 detectors” (2015), J. Synchrotron Rad. 22, 701-707 <a class="reference external" href="https://doi.org/10.1107/S1600577515003288">doi:10.1107/S1600577515003288</a>.</p> <p><strong>d*TREK SMV</strong> — the SMV reader reads the d*TREK header vocabulary of Rigaku’s CrystalClear from the headers themselves, interpreting the detector vectors as dxtbx does; no d*TREK or dxtbx code is used. J. W. Pflugrath, “The finer things in X-ray diffraction data collection” (1999), Acta Cryst. D55, 1718-1725 <a class="reference external" href="https://doi.org/10.1107/S090744499900935X">doi:10.1107/S090744499900935X</a>; <a class="reference external" href="https://github.com/cctbx/dxtbx">dxtbx</a>: J. M. Parkhurst, A. S. Brewster, L. Fuentes-Montero, D. G. Waterman et al., “dxtbx: the diffraction experiment toolbox” (2014), J. Appl. Cryst. 47, 1459-1465 <a class="reference external" href="https://doi.org/10.1107/S1600576714011996">doi:10.1107/S1600576714011996</a>.</p> </section> <section id=public-diffraction-data-used-for-testing > <h2 id=public-diffraction-data-used-for-testing >Public diffraction data used for testing<a class=headerlink href="#public-diffraction-data-used-for-testing" title="Link to this heading">¶</a></h2> <p>In addition to in-house datasets collected at SLS 2.0, Jungfraujoch is tested against public diffraction data collected on other people’s beamlines, on detectors and in file formats we do not produce ourselves. Every dataset used, the DOI to cite for it, and the deposition it belongs to are listed in <a class="reference internal" href=EXTERNAL_TEST_DATA.html ><span class="std std-doc">EXTERNAL_TEST_DATA</span></a> and <a class="reference internal" href=EXTERNAL_TEST_DATA_STILLS.html ><span class="std std-doc">EXTERNAL_TEST_DATA_STILLS</span></a>; we thank the depositors, and the repositories that make the data findable and citable.</p> <p><strong><a class="reference external" href="https://proteindiffraction.org/">IRRMC</a></strong>, the Integrated Resource for Reproducibility in Macromolecular Crystallography (Minor lab, University of Virginia), is the source of the largest share of them; it releases its data under CC0 and asks that the DOI of the dataset be cited. M. Grabowski, K. M. Langner, M. Cymborowski, P. J. Porebski, P. Sroka, H. Zheng, D. R. Cooper, M. D. Zimmerman, M.-A. Elsliger, S. K. Burley and W. Minor, “A public database of macromolecular diffraction experiments” (2016), Acta Cryst. D72, 1181-1193 <a class="reference external" href="https://doi.org/10.1107/S2059798316014716">doi:10.1107/S2059798316014716</a>; M. Grabowski, M. Cymborowski, P. J. Porebski, T. Osinski, I. G. Shabalin, D. R. Cooper and W. Minor, “The Integrated Resource for Reproducibility in Macromolecular Crystallography: Experiences of the first four years” (2019), Struct. Dyn. 6, 064301 <a class="reference external" href="https://doi.org/10.1063/1.5128672">doi:10.1063/1.5128672</a>.</p> <p><strong><a class="reference external" href="https://data.sbgrid.org/">SBGrid Data Bank</a></strong>, the structural biology community’s data publication service (SBGrid Consortium, Harvard Medical School). P. A. Meyer, S. Socias, J. Key, E. Ransey, E. C. Tjon, A. Buschiazzo et al., “Data publication with the structural biology data grid supports live analysis” (2016), Nat. Commun. 7, 10882 <a class="reference external" href="https://doi.org/10.1038/ncomms10882">doi:10.1038/ncomms10882</a>.</p> <p><strong><a class="reference external" href="https://zenodo.org/">Zenodo</a></strong>, CERN’s open repository, hosts datasets deposited there directly by the groups that collected them. European Organization for Nuclear Research and OpenAIRE, “Zenodo” (2013), CERN <a class="reference external" href="https://doi.org/10.25495/7GXK-RD71">doi:10.25495/7GXK-RD71</a>. The IUCrData Raw Data Letters describing some of those deposits are cited on the <a class="reference internal" href=EXTERNAL_TEST_DATA.html ><span class="std std-doc">EXTERNAL_TEST_DATA</span></a> page.</p> <p><strong><a class="reference external" href="https://cxidb.org/">CXIDB</a></strong>, the Coherent X-ray Imaging Data Bank, is the source of the serial (XFEL stills) datasets. F. R. N. C. Maia, “The Coherent X-ray Imaging Data Bank” (2012), Nat. Methods 9, 854-855 <a class="reference external" href="https://doi.org/10.1038/nmeth.2110">doi:10.1038/nmeth.2110</a>.</p> <p><strong><a class="reference external" href="https://mxrdr.icm.edu.pl/">MXRDR</a></strong>, the Macromolecular Xtallography Raw Data Repository (ICM, University of Warsaw), releases its data under CC0 and asks that the DOI of the dataset be cited.</p> <p><strong><a class="reference external" href="https://xrda.pdbj.org/">XRDa</a></strong>, the Xtal Raw Data Archive (Protein Data Bank Japan), publishes raw diffraction images and mints a DOI for each, which it asks to be cited. It has no canonical citation paper.</p> <p><strong>The <a class="reference external" href="https://data.esrf.fr/">ESRF data portal</a></strong>, through which the European Synchrotron publishes raw data under its data policy (CC BY 4.0, with the dataset DOI to be cited). R. Dimper, A. Götz, A. De Maria, V. A. Solé, M. Chaillet and B. Lebayle, “ESRF Data Policy, Storage, and Services” (2019), Synchrotron Rad. News 32, 7-12 <a class="reference external" href="https://doi.org/10.1080/08940886.2019.1608119">doi:10.1080/08940886.2019.1608119</a>.</p> <p><strong>The <a class="reference external" href="https://researchdata.keele.ac.uk/">Keele University research data repository</a></strong> and <strong><a class="reference external" href="https://espace.library.uq.edu.au/">UQ eSpace</a></strong> (The University of Queensland) host the raw images of datasets deposited there by the groups that collected them; the dataset DOIs are cited on the <a class="reference internal" href=EXTERNAL_TEST_DATA.html ><span class="std std-doc">EXTERNAL_TEST_DATA</span></a> page.</p> <p><strong>The <a class="reference external" href="https://www.rcsb.org/">Protein Data Bank</a></strong> supplies, through the RCSB PDB data API, the beamline, resolution, space group and unit cell quoted for each dataset, and the deposited coordinates and structure factors of the public entries the refinement battery starts from. H. M. Berman, J. Westbrook, Z. Feng, G. Gilliland, T. N. Bhat, H. Weissig, I. N. Shindyalov and P. E. Bourne, “The Protein Data Bank” (2000), Nucleic Acids Res. 28, 235-242 <a class="reference external" href="https://doi.org/10.1093/nar/28.1.235">doi:10.1093/nar/28.1.235</a>.</p> <p><strong>The <a class="reference external" href="https://www.crystallography.net/cod/">Crystallography Open Database</a></strong> supplies the reference cells of the small-molecule sets. S. Gražulis, D. Chateigner, R. T. Downs, A. F. T. Yokochi, M. Quirós, L. Lutterotti, E. Manakova, J. Butkus, P. Moeck and A. Le Bail, “Crystallography Open Database – an open-access collection of crystal structures” (2009), J. Appl. Cryst. 42, 726-729 <a class="reference external" href="https://doi.org/10.1107/S0021889809016690">doi:10.1107/S0021889809016690</a>; S. Gražulis, A. Daškevič, A. Merkys et al., “Crystallography Open Database (COD): an open-access collection of crystal structures and platform for world-wide collaboration” (2012), Nucleic Acids Res. 40, D420-D427 <a class="reference external" href="https://doi.org/10.1093/nar/gkr900">doi:10.1093/nar/gkr900</a>.</p> <p><strong>The <a class="reference external" href="https://alphafold.ebi.ac.uk/">AlphaFold Protein Structure Database</a></strong> (EMBL-EBI and Google DeepMind) supplies the start models of the battery’s timing benchmark: the predictions of the deposited entities of 9ZLO (AF-P17090-F1), 9S02 (AF-P32322-F1) and 9GJX (AF-Q65MG6-F1) and, for the in-house benchmark, of horse myoglobin (AF-P68082-F1) and bovine cytochrome c (AF-P62894-F1), model version 6, with their predicted aligned error, kept unmodified in <code class="docutils literal notranslate"><span class=pre >tools/battery/models/</span></code> under CC BY 4.0. J. Jumper, R. Evans, A. Pritzel et al., “Highly accurate protein structure prediction with AlphaFold” (2021), Nature 596, 583-589 <a class="reference external" href="https://doi.org/10.1038/s41586-021-03819-2">doi:10.1038/s41586-021-03819-2</a>; M. Varadi, S. Anyango, M. Deshpande et al., “AlphaFold Protein Structure Database: massively expanding the structural coverage of protein-sequence space with high-accuracy models” (2022), Nucleic Acids Res. 50, D439-D444 <a class="reference external" href="https://doi.org/10.1093/nar/gkab1061">doi:10.1093/nar/gkab1061</a>; M. Varadi, D. Bertoni, P. Magana et al., “AlphaFold Protein Structure Database in 2024: providing structure coverage for over 214 million protein sequences” (2024), Nucleic Acids Res. 52, D368-D375 <a class="reference external" href="https://doi.org/10.1093/nar/gkad1011">doi:10.1093/nar/gkad1011</a>. The large case of both benchmarks is the deposited model of PDB entry 4NWV, moved away from its place.</p> </section> <section id=generative-ai-usage-declaration > <h2 id=generative-ai-usage-declaration >Generative AI usage declaration<a class=headerlink href="#generative-ai-usage-declaration" title="Link to this heading">¶</a></h2> <p>Large language models were used extensively in developing this code. Jungfraujoch development was supported with JetBrains AI (mostly GPT models) to refactor and verify particular code fragments. Rugnux was developed with the assistance of Claude Code (mostly the Opus model). This documentation was written with the assistance of Claude Opus and Fable models.</p> </section> </section> </article> </div> </div> </main> </div> <footer class=md-footer > <div class=md-footer-nav > <nav class="md-footer-nav__inner md-grid"> <a href=PUBLICATIONS.html title=Publications class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel=prev > <div class="md-flex__cell md-flex__cell--shrink"> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> </div> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <span class=md-flex__ellipsis > <span class=md-footer-nav__direction > "Previous" </span> Publications </span> </div> </a> <a href=LICENSE.html title=License class="md-flex md-footer-nav__link md-footer-nav__link--next" rel=next > <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"><span class=md-flex__ellipsis > <span class=md-footer-nav__direction > "Next" </span> License </span> </div> <div class="md-flex__cell md-flex__cell--shrink"><i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> </div> </a> </nav> </div> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-footer-copyright > <div class=md-footer-copyright__highlight > © Copyright 2024, Paul Scherrer Institute. </div> Created using <a href="http://www.sphinx-doc.org/">Sphinx</a> 8.1.3. and <a href="https://github.com/bashtage/sphinx-material/">Material for Sphinx</a> </div> </div> </div> </footer> <script src="_static/javascripts/application.js"></script> <script>app.initialize({version: "1.0.4", url: {base: ".."}})</script> |