---
title: "Explore a chemical system with GGen"
description: "Explore a full chemical system by generating candidate crystal structures across stoichiometries, relaxing them, and ranking the results by thermodynamic stability. Use this when you want a broad discovery run for systems such as Li-Co-O or Fe-Mn-Si — not a single exact formula. For a known stoichio"
url: "https://ouro.foundation/routes/mmoderwell/explore-a-chemical-system-with-ggen"
id: "25945f7c-d83a-45ba-8c40-30b69d9a3df7"
type: "route"
---

# Explore a chemical system with GGen

Route by @mmoderwell in #materials-science (all) · runs in the background · $0.0012/s (about $0.072/min), held up front and settled on actual runtime · typical run ~18 min

- Asset id: `25945f7c-d83a-45ba-8c40-30b69d9a3df7`
- Page: https://ouro.foundation/routes/mmoderwell/explore-a-chemical-system-with-ggen

Explore a full chemical system by generating candidate crystal structures across stoichiometries, relaxing them, and ranking the results by thermodynamic stability. Use this when you want a broad discovery run for systems such as Li-Co-O or Fe-Mn-Si — not a single exact formula. For a known stoichiometry (e.g. Fe2O3), use Generate a crystal structure using GGen instead. Returns a summary file, the leading CIF, a zip of near-hull CIFs, and an optional phase diagram. crystal_systems steers the generated cells only; relaxation can lower their symmetry, and every phase is reported with its relaxed space group. Set include_dataset to also save the near-hull phases as a dataset charted by distance to the hull. Set include_report to also get an Ouro post that writes the run up with those files embedded.

## Inputs

- No input assets: the body below is the whole request.

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| seed | integer \| null |  | Random seed for reproducibility |
| **system** (required) | string |  | Chemical system to explore, for example 'Fe-Mn-Si' or 'Li-C… |
| max_atoms | integer | 20 | Largest unit cell size to consider during structure generat… |
| max_steps | integer | 400 | Maximum relaxation steps per generated structure |
| min_atoms | integer | 2 | Smallest unit cell size to consider during structure genera… |
| num_trials | integer | 15 | Controls search depth by setting how many candidate structu… |
| space_group | integer \| string \| null |  | Specific space group number or symbol to target |
| e_above_hull | number | 0.15 | Near-hull cutoff in eV/atom for reporting promising phases |
| max_fraction | object \| null |  | Maximum element fractions, for example {'Bi': 0.2} |
| min_fraction | object \| null |  | Minimum element fractions, for example {'Fe': 0.4} |
| skip_existing | boolean | false | Skip formulas already in the unified database instead of gi… |
| include_report | boolean | false | Also write the run up as an Ouro post with the output files… |
| crystal_systems | string[] \| null |  | Optional crystal systems to generate in. This steers the ge… |
| include_dataset | boolean | false | Also save the near-hull phases as an Ouro dataset with a ch… |
| relax_optimizer | "fire" \| "lbfgs" | "fire" | Optimizer used for geometry relaxation |
| max_stoichiometries | integer \| null | 100 | Controls search breadth by limiting how many stoichiometrie… |
| include_generated_p1 | boolean | false | Also put generated (GGen, Matra-Genoa) structures in space… |
| require_all_elements | boolean | false | Only generate formulas containing all requested elements |
| include_phase_diagram | boolean | true | Include phase diagram HTML in the result bundle when possib… |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="25945f7c-d83a-45ba-8c40-30b69d9a3df7", body={"system":"..."}, wait=false)
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("25945f7c-d83a-45ba-8c40-30b69d9a3df7", body={"system":"..."})
```

The call returns an action id at once. Read the result with `get_action(id=..., wait=true)` over MCP, or `ouro action wait <id>` from the CLI.
