combinatorial-substitution

Generate material structure libraries via Cartesian-product substitutions across specified sites.

181|20|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Hello-QM/catgo-LRG --skill combinatorial-substitution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: combinatorial-substitution
Source: https://github.com/Hello-QM/catgo-LRG/tree/main/server/catgo/workflow/skills/structure/substitution
Command: npx skills add https://github.com/Hello-QM/catgo-LRG --skill combinatorial-substitution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Combinatorial Substitution addresses the need to efficiently generate a library of material structures by systematically replacing elements at specified sites across multiple groups, enabling broad exploration of composition space without manual trial-and-error.

Core Features & Use Cases

  • Generates Cartesian-product substitutions across independent groups of sites.
  • Supports common materials discovery scenarios like high-entropy alloys, perovskite ABO3 screening, catalyst optimization, and battery-material design.
  • Integrates with downstream workflows for relaxation and screening, enabling rapid proto-typing of new compositions.

Quick Start

Provide a current structure and define groups with target_indices and replacement_elements to generate all substitutions up to max_structures cap.

Frequently Asked Questions about combinatorial-substitution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is combinatorial substitution in materials design?▼

Combinatorial substitution is a technique for building a library of material candidates by systematically replacing elements at specified sites across multiple independent groups, enabling broad exploration of composition space without manual trial-and-error.

How do I generate perovskite ABO3 composition candidates using structure substitution?▼

To generate perovskite ABO3 composition candidates, provide your current structure and define groups with target_indices and replacement_elements, which produces all Cartesian-product substitutions across the specified A and B sites.

Can I automate high-entropy alloy screening across multiple independent sites?▼

Yes, you can automate high-entropy alloy screening by defining independent groups of sites with target_indices and replacement_elements, generating all possible multi-site substitutions in a single workflow.

Does this combinatorial substitution approach support downstream relaxation and screening workflows?▼

Yes, combinatorial substitution integrates directly with downstream workflows for structural relaxation and screening, enabling rapid prototyping and evaluation of newly generated material compositions.

What is the maximum number of structures I can generate for catalyst optimization?▼

The maximum number of generated structures is capped by the max_structures parameter, which enforces a hard limit on the total library size during Cartesian-product generation for catalyst optimization.

Why does my Cartesian-product substitution across multiple groups generate too many structures?▼

Cartesian-product substitution across multiple independent groups scales multiplicatively, so you must enforce a max_structures cap to prevent generating an unmanageable number of material candidates during composition search.