pyREyes 3.4.0

Automated MicroED diffraction data collection and analysis package

Diffraction Map Processing Pipeline (REyes v3.4)

Quick Start

# Install the package
pip install .

# Run automated pipeline
reyes-monitor --microscope Arctica-CETA --autoprocess

Overview

pyREyes is a Python package to support REyes (Reciprocal Eyes), an end-to-end autonomous electron diffraction data collection and processing pipeline. REyes generates diffraction heatmaps, identifies key targets, and manages navigator files for SerialEM.

📚 Full Documentation

Key Features

• Grid squares detection and atlas management
• Manual or automated grid square selection
• Eucentricity correction
• Diffraction pattern quality classification using DQI (Diffraction Quality Index)
• Navigation file generation with spatial awareness
• Comprehensive visualization suite
• Automated data processing with state machine monitoring
• Optional movie processing and structure solution integration

Diffraction Quality Analysis

REyes uses advanced quality metrics to assess diffraction patterns:

LQP (Lattice Quality Peaks): A number of peaks in an FFT of the thresholded and binarized diffraction snapshot that correspond to lattice quality.

DQI (Diffraction Quality Index): A quality metric calculated as the ratio of LQP to total diffraction peaks (DQI = LQP / Diffraction Peaks). DQI values above 3.0 indicate higher crystalline quality with better-ordered lattice structures. This index is used to automatically classify and prioritize crystal targets for data collection.

Pipeline Components

Core Modules

1. Grid Squares Searcher
   • 1.1. Manual Grid Squares Adder
2. Navigator Eucentricity Corrector
3. Diffraction Map Processor
4. Navigation File Generator
   • 4.1. Selected Targets Adder
5. Final Targets Processor
6. Collection Executor

Pipeline Orchestration:

• Processing Monitor - Automatically runs all steps above and pauses for user input on optional manual steps

Directory Structure

working_directory/
├── dif_maps/               # Diffraction maps and visualizations
│   └── diff_blocks_maps/   # Block-specific maps
├── grid_squares/           # Grid square & eucentricity outputs
├── movies/                 # Continuous rotation diffraction movies
├── REyes_logs/             # Processing logs
└── targets/                # Navigation files and diffraction snapshots

Reference

The REyes methodology and its applications to small molecules, materials, and protein crystallography are described in detail in:

Eremin, D.B.; Jha, K.K.; Delgadillo, D.A.; Zhang, H.; Foxman, S.H.; Johnson, S.N.; Vlahakis, N.W.; Cascio, D.; Lavallo, V.; Rodríguez, J.A.; Nelson, H.M. "Spatially-Aware Diffraction Mapping Enables Fully Autonomous MicroED" ChemRxiv 2025, DOI: 10.26434/chemrxiv-2025-4p4c3

Data Availability

Electron diffraction data are publicly available through the Caltech.

Repository: https://miledd.caltech.edu/shared/

ZENODO Dataset: Complete Raw and Processed REyes Dataset: Autonomous MicroED Collection for (S,S)-Salen Ligand - https://doi.org/10.5281/zenodo.16971798

Support

For support and questions, please contact:

• 📫 Dmitry Eremin - [e-mail]

Developers

• Dmitry Eremin (mit-eremin)
• Hongyu Zhang (Eta2Zeta)

Patent Disclosure

Dmitry B. Eremin, Hongyu Zhang, Jose A. Rodríguez, and Hosea M. Nelson have filed a provisional patent application related to the methods implemented in this software:

Patent Application: CIT-9295-P2, filed May 8, 2025

This disclosure is provided in accordance with academic transparency standards. The software remains available for academic and research use under the terms specified in the license.

Copyright © 2025, California Institute of Technology (Caltech). All rights reserved. Use of this software is permitted for academic and non‑commercial research only. Commercial use is prohibited without a license, please contact Caltech Office of Technology Transfer & Corporate Partnerships.