pycalphad — скилл для Claude Code: что делает и как установить
Скилл pycalphad рассчитывает термодинамические фазовые равновесия сплавов по TDB-базам данных. Помогает моделировать составы и доли фаз при заданных температурах и давлении.
MIT 463 установок ★ 58 036 обновлён 2026-10-19
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a claude-codeЧто делает pycalphad
Скилл запускает локальный скрипт skills/pycalphad/scripts/equilibrate.py для вычисления равновесных фаз по методу CALPHAD. Расчёт опирается на входные мольные доли компонентов, давление в паскалях и список температур до 1000 точек. На выходе формируются два файла: report.json с проверками материального баланса и phase-equilibria.csv с мольными долями фаз и общей энергией Гиббса системы.
Для работы требуются Python 3.12, pycalphad 0.11.2 и NumPy 2.5.3. Все вычисления выполняются локально. Сеть нужна только для первоначальной установки библиотек. Скрипт автоматически удваивает плотность сетки pdens, чтобы проверить устойчивость численного решения.
Входящий в комплект файл ideal-cu-ni.tdb служит лишь учебным примером, поэтому для реальных сплавов нужна проверенная экспертная база TDB. Моделирование не предсказывает скорость выделения фаз или кинетику метастабильных структур.
Какие задачи решает
- рассчитать равновесные доли и составы фаз сплава по TDB-файлу
- проверить материальный баланс термодинамической системы при заданных температурах
- оценить границы стабильности фаз и линии коннод в модельной системе
- протестировать сходимость термодинамического расчёта при удвоении шага дискретизации
Примеры запросов агенту
- Рассчитай равновесные фазы для файла
skills/pycalphad/assets/ideal-cu-ni.tdbи параметров изskills/pycalphad/assets/equilibrium.json - Выполни расчёт фазовых долей для сплава при температуре 1100 K и давлении 101325 Pa через скрипт
equilibrate.py - Проверь баланс массы и устойчивость энергии Гиббса в результатах
report.json
Как установить pycalphad
1Через Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a claude-code2Вручную: положить файлы
~/.claude/skills/pycalphad/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pycalphad/
1Через Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a codex2Вручную: положить файлы
.agents/skills/pycalphad/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a cursor2Вручную: положить файлы
.cursor/skills/pycalphad/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install K-Dense-AI/scientific-agent-skills skills/pycalphad2Вручную: положить файлы
.github/skills/pycalphad/SKILL.md1Через Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a gemini-cli2Командой платформы
gemini skills install https://github.com/K-Dense-AI/scientific-agent-skills --path skills/pycalphadВручную: положить файлы
.devin/skills/pycalphad/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pycalphad
Как установить pycalphad в Claude Code?
Выполните команду npx skills add K-Dense-AI/scientific-agent-skills --skill pycalphad -a claude-code.
Что делает скилл pycalphad?
Он запускает расчёт термодинамического равновесия многокомпонентных систем по термодинамическим базам TDB, вычисляя мольные доли фаз и их составы.
Можно ли использовать встроенную базу ideal-cu-ni.tdb для реальных сплавов меди и никеля?
Нет, база ideal-cu-ni.tdb создана исключительно как гипотетическая учебная модель. Для реальных сплавов требуется проверенная термодинамическая база данных.
Исходный текст
SKILL.md · MIT
--- name: pycalphad description: Computes finite-temperature CALPHAD equilibria, phase fractions, and phase compositions from thermodynamic TDB databases using pycalphad. Use for alloy phase stability, equilibrium temperature sweeps, tie lines, lever-rule checks, or reproducible phase-fraction calculations with explicit components and mole-fraction conditions. license: MIT compatibility: Requires Python 3.12+, pycalphad 0.11.2, and NumPy. Installation needs network access; calculations run locally without credentials. Real-material predictions require a suitable licensed thermodynamic database. metadata: version: "1.1" skill-author: K-Dense Inc. tested-package-version: "0.11.2" last-reviewed: "2026-10-01" --- # pycalphad: TDB equilibrium calculations ## When to use Use for equilibrium phase fractions and compositions at a fixed bulk elemental mole composition, specified pressure, and a list of finite temperatures. The bundled helper executes real pycalphad equilibria, checks mass balance, repeats at greater sampling density, and exports each stable composition set separately. Equilibrium is constrained by the selected database, components, phases, and conditions. It does not predict precipitation rates, retained metastable microstructures, or properties of phases missing from the database. Successful numerical checks do not establish the database's experimental accuracy. ## Workflow 1. Identify the TDB's source, license, assessment/publication, valid temperature/pressure and composition range, and required elements. Use the user's database for real alloys. The bundled [assets/ideal-cu-ni.tdb](assets/ideal-cu-ni.tdb) is an original hypothetical teaching model, **not an assessed Cu-Ni database**. 2. Inspect database elements and phases. Select the relevant phases deliberately; record exclusions because they can turn the calculation into a metastable constrained result. Include `VA` where required by sublattice models. Vacancies are not an independent bulk mole fraction. Keep coupled order/disorder definitions in the TDB, but do not select both partners as separate candidates when the ordered model already includes the disordered contribution; the helper rejects such filtered candidate lists. 3. Copy [assets/equilibrium.json](assets/equilibrium.json). Specify exactly N-1 elemental mole fractions and one dependent non-vacancy element. The dependent fraction is `1 - sum(independent fractions)`; fractions are not silently normalized. Set K and Pa. Convert weight percentages or mass fractions before using this helper. 4. Declare the database temperature interval from its assessment if known, or set `database_temperature_range_k` to null if unknown. This is user-supplied evidence, not a range automatically inferred from every TDB function. Requests outside a declared interval fail. Check pressure and composition validity separately. 5. Run the calculation. Check finite Gibbs energies, phase fractions summing to one, reconstructed bulk composition, and stability to doubled `pdens` (phase-constitution sampling density). Near transitions, refine temperatures and sampling density further. 6. Deliver phase fractions with their **molar** basis, phase compositions, database hash, conditions, excluded phases, and any numerical or assessment limitations. Read [references/model-and-validation.md](references/model-and-validation.md) for the analytic example, basis conversion, native Model/Workspace/property/plot contracts, miscibility-gap handling, and convergence limits. ## Execute the tested example From the collection root: ```bash uv run --no-project --python 3.12 --with pycalphad==0.11.2 --with numpy==2.5.3 \ python skills/pycalphad/scripts/equilibrate.py \ skills/pycalphad/assets/ideal-cu-ni.tdb \ skills/pycalphad/assets/equilibrium.json equilibrium-result ``` Tested on Python 3.12, pycalphad 0.11.2, and NumPy 2.5.3. Use a new output directory. All thermodynamic calculations are local; the script does not upload a TDB. For the supplied hypothetical model at X(Ni)=0.5 and 101325 Pa: | Temperature | Equilibrium result | | --- | --- | | 900 K | FCC_A1 only | | 1100 K | 0.5 FCC_A1 + 0.5 LIQUID; X(Ni) approximately 0.527307 and 0.472693 respectively | | 1300 K | LIQUID only | The suite verifies analytic common-tangent compositions, a noncentral lever-rule case, Gibbs energy, mass balance, both single-phase limits, and actual same-phase miscibility gap vertices. These validate the computational workflow, not real Cu-Ni metallurgy. ## Outputs and acceptance - `report.json`: settings and versions, TDB/settings SHA-256, excluded database phases, requested, solver-imposed, and reconstructed bulk compositions, per-temperature baseline/refined results, and checks. Experimental validity is not evaluated by the helper. - `phase-equilibria.csv`: one row per stable vertex per temperature and sampling run, including phase name, molar phase fraction, and elemental mole fractions. Its Gibbs energy column is the **whole-system molar Gibbs energy**, repeated for each vertex; it is not the individual phase energy. Unused pycalphad vertices have blank names and NaN values; those are omitted. Named vertices with invalid values cause failure. Multiple vertices with the same phase name are retained because a miscibility gap can contain two composition sets of one phase. Vertex indices do not track the same physical phase continuously across temperatures. In stable 0.11.2, pycalphad clips independent mole fractions to `[1e-10, 1-1e-10]`. Each result records `solver_bulk_mole_fractions` and the largest absolute difference from the requested bulk in `composition_condition_adjustment_absolute_error`. Mass-balance checks still compare against the **requested** composition; a tighter tolerance can therefore fail at an endpoint. Do not claim exact pure-component or ultratrace results from a clipped multicomponent calculation. `all_checks_passed` requires each run's phase-sum and bulk-composition residuals within `mass_balance_tolerance`, phase totals stable within `phase_fraction_tolerance`, and system Gibbs energy stable within `gibbs_energy_tolerance_j_per_mol` when `pdens` doubles. This comparison does not certify the global minimum or track individual composition-set movement within a same-phase miscibility gap; inspect their exported compositions too. Failed checks remain visible in the report rather than being relabeled as convergence. ## Boundaries and upstream contracts The helper handles elemental mole fractions, one composition, one pressure, and up to 1000 explicit positive temperatures. It validates selected phases through pycalphad's phase-compatibility rules; incompatible or automatically filtered order/disorder phase sets produce an explicit error. It does not silently remove requested phases. Charged-species constraints, externally imposed chemical potentials, custom models, activity reference-state changes, and database optimization require additional modeling and are outside this helper's tested scope. Do not extrapolate the pedagogical asset to real material selection or heat-treatment decisions. - [Equilibrium dataset semantics](https://pycalphad.org/docs/latest/examples/3_High_Throughput_Analysis/2_UsingCalculationResults.html) - [Phase fractions and composition basis](https://pycalphad.org/docs/latest/examples/2_Computing_Properties/1_PhaseCompositions.html) - [Equilibrium and sampling API](https://pycalphad.org/docs/latest/api/pycalphad.core.html) - [Ordering examples](https://pycalphad.org/docs/latest/examples/2_Computing_Properties/4_EquilibriumWithOrdering.html) - [Stable 0.11.2 source](https://github.com/pycalphad/pycalphad/tree/0.11.2/pycalphad) Upstream `latest` documentation currently describes 0.11.3 development builds. The bundled helper and the reference's native examples were exercised against stable 0.11.2 on 2026-10-01; the release's source was checked against the installed wheel. No remote thermodynamic calculation or database-fetch API is used. `Database` loads a local path, file-like object, or TDB text; a URL is not a supported download shortcut.
© K-Dense-AI · MIT · K-Dense-AI/scientific-agent-skills