К основному содержанию
скилл CX Codex

relion — скилл для Claude Code: крио-ЭМ рефайнмент в RELION

Запускает валидацию STAR-файлов, gold-standard рефайнмент частиц и постобработку независимых half-map в RELION 5.0.1. Подходит для single-particle крио-ЭМ проектов.

MIT 463 установок ★ 58 036 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add K-Dense-AI/scientific-agent-skills --skill relion -a claude-code
Открыть на GitHub

Что делает relion

Скилл выполняет три этапа: проверяет STAR-файл частиц на корректность оптических групп, индексов стеков и CTF-параметров (validate-star), запускает авторефайнмент с золотым стандартом через relion_refine_mpi (refine) и считает FSC между независимыми half-map с маской (postprocess). Внутри Python-скрипты с numpy, mrcfile и starfile плюс вызовы нативных бинарников RELION. Команда refine требует MPI (нечётное число рангов ≥3), потому что только relion_refine_mpi умеет делить частицы на независимые половины; без MPI золотой стандарт невозможен.

Рефайнмент начинается с уже экстрагированных CTF-аннотированных частиц и начального 3D-референса. Скилл не занимается motion correction, пикингом, 2D-классификацией или томографией — это отдельные workflow. Координаты частиц в STAR используют one-based индексацию ([email protected]), пути разрешаются от корня RELION-проекта, а _rlnOriginXAngst / _rlnOriginYAngst хранят сдвиги в ангстремах. Валидация открывает стеки и проверяет размеры боксов, дубликаты, конечность CTF-значений; флаг --metadata-only отключает чтение MRC-файлов, если стеки недоступны.

Команда postprocess проверяет, что маска лежит в [0,1], имеет плавный край и совпадает по сетке с half-map, затем вызывает relion_postprocess с явным B-фактором ноль (автооценка отключена). Вспомогательная команда fsc вычисляет диагностическую кривую без маски для кубических карт ≤256³; для больших карт используй нативный relion_image_handler --fsc.

Какие задачи решает

  • проверить STAR-файл частиц на корректность оптических групп и индексов стеков
  • запустить gold-standard авторефайнмент с MPI и начальным low-pass фильтром
  • посчитать FSC между независимыми half-map и применить soft-mask постобработку
  • сохранить команды, логи и random seed для воспроизводимого рефайнмента

Примеры запросов агенту

  • Провалидируй STAR-файл project/particles.star из директории project
  • Запусти рефайнмент с начальным референсом initial.mrc, диаметром 180 Å, симметрией C1 и low-pass 40 Å, используя 3 MPI-ранга и 2 потока
  • Посчитай FSC между run_half1_class001_unfil.mrc и run_half2_class001_unfil.mrc и сохрани в diagnostic-fsc.tsv

Как установить relion

1Через Skills CLI (Vercel)

npx skills add K-Dense-AI/scientific-agent-skills --skill relion -a claude-code

2Вручную: положить файлы

~/.claude/skills/relion/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/relion/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о relion

Как установить relion в Claude Code?

Выполни npx skills add K-Dense-AI/scientific-agent-skills --skill relion -a claude-code, затем открой ~/.claude/skills/relion/SKILL.md.

Что делает relion?

Скилл валидирует STAR-файлы частиц, запускает gold-standard рефайнмент в RELION через relion_refine_mpi с независимыми половинами и выполняет постобработку half-map с маской. Предназначен для single-particle крио-ЭМ проектов, начиная с экстрагированных частиц.

Зачем relion нужен MPI?

Команда refine использует relion_refine_mpi для золотого стандарта: только MPI-версия может разделить частицы на независимые половины и рефайнить их параллельно. Скилл требует нечётное число рангов ≥3 (один мастер плюс сбалансированные воркеры для двух half-set).

Исходный текст

SKILL.md · MIT
---
name: relion
description: Validates and executes RELION single-particle cryo-EM refinement and half-map postprocessing. Supports STAR optics/acquisition checks, particle-stack consistency, gold-standard half sets, soft-mask validation, diagnostic Fourier shell correlation, and restart guidance.
license: MIT
compatibility: Python 3.12+ with numpy, mrcfile and starfile for bundled validation; RELION 5.0.1 CPU/MPI executables for refinement and postprocessing. Native workflows require MPI, OpenMP and an FFT library (FFTW or MKL). GPU builds require their supported accelerator stack. Network is needed for installation only.
metadata:
  version: "1.1"
  skill-author: K-Dense Inc.
  upstream-version: "5.0.1"
  last-reviewed: "2026-10-01"
---

# RELION single-particle refinement

Use for a RELION single-particle project, especially extracted particles → homogeneous selected
particle subset → gold-standard refinement → half-map validation and postprocessing. The bundled
runner starts from **CTF-annotated extracted particles and an initial 3D reference**. It does not
replace motion correction, picking, 2D/3D selection, or a biological interpretation of map quality.
For tomography, helical reconstruction, Blush, or heterogeneous-state modeling, use the appropriate
upstream workflow rather than forcing those data into this bounded SPA runner.

## Preserve acquisition and coordinate conventions

Read [references/acquisition-and-restarts.md](references/acquisition-and-restarts.md) when starting
from movies or resuming jobs. Confirm pixel size in **Å/pixel**, voltage in **kV**, spherical
aberration in **mm**, defocus in **Å**, amplitude contrast as a fraction, and the symmetry justified
by the specimen. Do not “correct” a suspicious value by guessing its units.

`data_optics` describes acquisition/image groups; `data_particles` references them through
`_rlnOpticsGroup`. Particle filenames use **one-based** `[email protected]`; leading zeros such as
`[email protected]` are valid. Relative paths resolve
from the RELION project directory, not the STAR file's directory. Keep optics groups when merging
or subsetting STAR files. `_rlnOriginXAngst`/`_rlnOriginYAngst` are Å translations, not pixels.

Run from this skill directory with paths to the real project:

```bash
python scripts/spa_workflow.py validate-star project/particles.star --project project
```

This opens referenced stacks and checks optics membership, finite acquisition/CTF values, indices,
box sizes, duplicate particle references and existing half-set assignments. Use `--metadata-only`
only when stacks are genuinely unavailable; the JSON records `stack_checks_performed: false`.
It does not scan every particle pixel for corruption or establish correct image normalization.
Physical-range warnings are review prompts, not proof that unusual microscope settings are wrong.

## Refine a selected particle population

Before running, inspect representative particles and class averages, defocus distributions, CTF
fits, particle orientation distribution, and the initial reference. Ensure the map and particle
boxes/pixel sizes agree after any downsampling. The runner deliberately supports one effective
box/pixel size across optics groups; handle heterogeneous sampling with an explicit upstream
resampling workflow. Use conventionally extracted, normalized particles that have not already
been phase-flipped or Wiener-filtered; this runner does not configure those special input cases.

```bash
python scripts/spa_workflow.py refine \
  --star project/particles.star --reference project/initial.mrc \
  --project project --diameter 180 --symmetry C1 \
  --initial-lowpass 40 --mpi-ranks 3 --threads 2 --output project/RefinePilot
```

The diameter and low-pass filter above are illustrative **Å** values. Use specimen-appropriate
values. Refinement executes `mpirun -np 3 relion_refine_mpi` with `--auto_refine`,
`--split_random_halves`, `--ctf`, and a low-pass starting reference. Gold-standard splitting
requires MPI; the plain sequential `relion_refine` executable cannot perform this split.
Use odd ranks ≥3 (master plus balanced half-set workers), with a matching MPI installation.
The CPU command is useful for a bounded pilot; choose a documented GPU/MPI launch for full data.

The runner keeps the command, native version and log in a new output directory, records an
explicit random seed (default 1), surfaces runtime warnings, stops on process failure, and
requires converged unfiltered half maps before reporting success. It does not automatically retry
expensive jobs or silently discard failed-job artifacts. Keep `_optimiser.star`, model/sampling
STAR files, and referenced particle paths for restart. Use the original job's optimiser rather
than starting a new random split from a partially processed table.

## Inspect independent half maps

Use the two independently refined **unfiltered** half maps, never two copies of the combined,
sharpened map. Matching headers cannot establish statistical independence; the independent
particle assignments and refinement history provide that evidence. Inspect directional
anisotropy, preferred orientation and local resolution as well as a global FSC curve.

```bash
python scripts/spa_workflow.py fsc \
  project/RefinePilot/run_half1_class001_unfil.mrc \
  project/RefinePilot/run_half2_class001_unfil.mrc --output diagnostic-fsc.tsv
```

This checks map dimensions, finite values, pixel size, origin, axis order and duplicate maps, then
writes an **unmasked diagnostic FSC**. The reported 0.143 crossing uses linear interpolation;
`null` means no downward crossing was detected, not infinite resolution. Nyquist resolution is
2 × pixel size. This diagnostic is limited to even cubic maps ≤256³; use RELION's native
`relion_image_handler --fsc` for larger maps. It does not substitute for mask-corrected FSC.
The helper requires real-space maps with canonical axes, zero MRC start indices and orthogonal
cell angles. Convert other grids explicitly with provenance; merely editing headers can misalign
density. Matching headers and FSC cannot determine absolute handedness.

## Postprocess with a soft mask

Construct the solvent mask from an appropriately low-pass-filtered density, with an expanded
boundary and a smooth edge. Inspect all slices; a tight mask can inflate correlation. Avoid a
mask derived from high-frequency noise shared between half maps.

```bash
python scripts/spa_workflow.py postprocess \
  --half1 project/RefinePilot/run_half1_class001_unfil.mrc \
  --half2 project/RefinePilot/run_half2_class001_unfil.mrc \
  --mask project/soft_mask.mrc --output project/PostProcessPilot
```

The helper checks a nonconstant mask in [0,1], soft-edge voxels and matching map grids, then runs
`relion_postprocess` with explicit half maps, mask and pixel size. RELION performs its own
mask/randomization correction and writes `postprocess.star`. The bounded command leaves the
B-factor at zero (no automatic B-factor estimation); add automatic/manual sharpening only after choosing a defensible fit
range and inspecting map quality. A valid range and some fractional mask voxels do not prove the
mask is scientifically appropriate. Inspect the phase-randomized masked FSC near the reported
resolution: residual correlation calls for a smoother/wider mask and another postprocessing run.

See [references/runtime-and-validation.md](references/runtime-and-validation.md) for the tested
native utilities and the distinction between pipeline execution and reconstruction validation.

## Primary references

- [RELION 5.0 installation](https://relion.readthedocs.io/en/release-5.0/Installation.html).
- [STAR and map conventions](https://relion.readthedocs.io/en/release-5.0/Reference/Conventions.html).
- [Single-particle tutorial](https://relion.readthedocs.io/en/release-5.0/SPA_tutorial/index.html).
- [Gold-standard refinement](https://relion.readthedocs.io/en/release-5.0/SPA_tutorial/Refine3D.html).
- [Mask creation and postprocessing](https://relion.readthedocs.io/en/release-5.0/SPA_tutorial/Mask.html).

© K-Dense-AI · MIT · K-Dense-AI/scientific-agent-skills

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
tooluniverse-electron-microscopy mims-harvard Скилл tooluniverse-electron-microscopy для Claude Code ищет и анализирует данные электронной микроскопии в EMDB, PDB, EMPIAR и CryoET Data Portal. Помогает сопоставлять карты плотности с атомными моделями. CX Codex +1 238установок performance-profiling HeshamFS Скилл performance-profiling находит узкие места в материаловедческих симуляциях: парсит логи времени выполнения, считает эффективность MPI-масштабирования и оценивает требования к памяти. CX Codex +1 ★ 95звёзд репо mpi mohitmishra786 Помогает писать параллельные программы на MPI: настраивать вызовы процессов, неблокирующие операции, гибрид с OpenMP и запуск через mpirun. CX Codex +1 354установок rocprofiler-systems-choosing-a-profiling-preset amd Скилл rocprofiler-systems-choosing-a-profiling-preset для Claude Code подбирает профиль запуска rocprofiler-systems под тип работы и цель измерения. Срабатывает на вопрос о выборе профиля или запуск без --preset. CX Codex +1 266установок hpc-runtime-doctor HeshamFS Скилл hpc-runtime-doctor разбирает, почему уже отправленная задача на кластере упала, зависла или идёт медленно: раскладка MPI/OpenMP/GPU, модули, walltime, restart. CX Codex +1 ★ 95звёзд репо k-dart NomaDamas Скилл k-dart для поиска данных в DART (Электронная система공시 Корейской комиссии по финансовому надзору). Ищет публикации, финансовые отчёты и сведения о компаниях через OpenAPI. CX Codex +1 11 900установок

Из того же набора176

Весь набор →
mageck Скилл mageck считает риды из FASTQ и матрицы гайдов, проверяет библиотеки, запускает QC реплик и выдаёт рейтинг генов с FDR для пулированных CRISPR-скринов. CX Codex +1 465установок qiime2-amplicon Скилл qiime2-amplicon для Claude Code обрабатывает парные 16S-риды в QIIME 2, создавая ASV-таблицы и таксономию с историей преобразований. CX Codex +1 465установок cellprofiler Запускает CellProfiler для подсчёта ядер и измерения флуоресценции. Анализирует 2D TIFF-снимки. CX Codex +1 464установок pycalphad Скилл pycalphad рассчитывает термодинамические фазовые равновесия сплавов по TDB-базам данных. Помогает моделировать составы и доли фаз при заданных температурах и давлении. CX Codex +1 463установок nwb-conversion Скилл nwb-conversion преобразует данные двухфотонной микроскопии и поведенческих координат в формат Neurodata Without Borders с проверкой синхронизации часов и валидацией схемы. Нужен Python 3.12 и набор специализированных библиотек. CX Codex +1 462установок marine-carbonate-chemistry Скилл marine-carbonate-chemistry считает карбонатную систему морской воды через PyCO2SYS: pH, pCO2, насыщение арагонитом и кальцитом по паре измеренных параметров. CX Codex +1 ★ 58 036звёзд репо 13c-metabolic-flux Скилл 13c-metabolic-flux оценивает внутриклеточные метаболические потоки по данным изотопного мечения углеродом-13 в стационарном состоянии через mfapy и SciPy. CX Codex +1 ★ 58 036звёзд репо fictiv Скилл управляет Fictiv через браузер: загружает CAD-файлы, настраивает производство, получает расчёт и помогает оформить заказ. CX Codex +1 ★ 58 036звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой