AIKraft/Skills/pymatgen

pymatgen

Анализирует, валидирует и преобразует структуры материалов и вычисленные данные с помощью pymatgen. Подходит для построения локальных фазовых диаграмм, анализа симметрии, работы с электронными структурами и запросов к Materials Project.

KDK-Dense official Данные ★ 47.7k

Что делает навык

Навык обеспечивает анализ, валидацию и преобразование структур материалов и вычисленных данных с использованием библиотеки pymatgen. Он поддерживает работу с молекулами, периодическими структурами, симметрией, фазовыми диаграммами и электронными структурами, а также взаимодействие с Materials Project.

Когда применять

  • Валидация и парсинг CIF-файлов с проверкой предупреждений, заселенности и окислительных состояний.
  • Определение пространственной группы с отчетом о чувствительности к параметрам симметрии (symprec, angle_tolerance).
  • Построение локальных фазовых диаграмм из совместимых вычисленных энергий с сохранением провенанса.
  • Преобразование структур между форматами (CIF, POSCAR, JSON) с учетом потери семантики и круговой проверкой.
  • Парсинг данных VASP (vasprun.xml) для получения зонной структуры и плотности состояний.

Как работает

  1. Определить тип объекта (Molecule или Structure), единицы измерения и режим координат (фракционные или декартовы).
  2. Запустить валидацию входных данных (например, через composition_structure_validator.py) и проверить все предупреждения парсера.
  3. При анализе симметрии выполнить отчет о чувствительности к допускам (symprec, angle_tolerance) вместо выбора параметров наугад.
  4. При преобразовании форматов или трансформациях использовать копии объектов, фиксировать историю изменений и проверять потерю данных.
  5. Для фазовых диаграмм использовать только совместимые энергии и коррекции, строго соблюдая схему провенанса.
  6. Доступ к Materials Project (mp-api) отключен по умолчанию; перед выполнением раскрыть эндпоинты, фильтры и лицензионные условия.

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

Проанализируй файл structure.cif: определи пространственную группу с отчетом по чувствительности и проверь предупреждения парсера CIF.
Построй локальную фазовую диаграмму для Li2O на основе предоставленного JSON с энергиями и провенансом, используя скрипт phase_diagram_generator.py.
Преобразуй структуру из CIF в POSCAR с прямыми координатами, задокустировав возможные потери семантики и сохранив историю трансформации.

Что понадобится

  • Python 3.11+, пакеты pymatgen==2026.9.24, pymatgen-core==2026.9.23, mp-api==0.46.5.
  • Ключ API Materials Project через переменную окружения MP_API_KEY (для работы с mp-api).

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «pymatgen» из репозитория: # https://github.com/k-dense-ai/scientific-agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r pymatgen/ ~/.claude/skills/pymatgen/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.