---
title: "Generate a GGen system report"
description: "Report the best structures known for a chemical system across the whole GGen database, published and generated alike. Where an exploration reports what a single run produced, this reports the current state of a system: its hull, how much of it comes from published data versus GGen, which phases are "
url: "https://ouro.foundation/routes/mmoderwell/generate-a-ggen-system-report"
id: "d10241ae-e66b-49a9-b8bf-ca1af66b8803"
type: "route"
---

# Generate a GGen system report

Route by @mmoderwell in #materials-science (all) · returns in one call · Free · typical run ~26 s

- Asset id: `d10241ae-e66b-49a9-b8bf-ca1af66b8803`
- Page: https://ouro.foundation/routes/mmoderwell/generate-a-ggen-system-report

Report the best structures known for a chemical system across the whole GGen database, published and generated alike. Where an exploration reports what a single run produced, this reports the current state of a system: its hull, how much of it comes from published data versus GGen, which phases are new, and CIFs for the leading candidates. Set include_dataset to also save the near-hull phases as a dataset charted by distance to the hull.

## 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 |
| --- | --- | --- | --- |
| **system** (required) | string |  | Chemical system to report |
| breakdown | boolean | false | Include stability breakdown |
| space_group | integer \| string \| null |  | Filter by space group number or symbol |
| stable_only | boolean | false | Return stable and near-hull structures |
| fully_stable | boolean | false | Return structures on hull and dynamically stable |
| energy_cutoff | number | 0.15 | Energy above hull cutoff in eV/atom |
| crystal_system | "triclinic" \| "monoclinic" \| "orthorhombic" \| "tetragona… |  | Filter by crystal system |
| include_dataset | boolean | false | Also save the near-hull phases as an Ouro dataset with a ch… |
| include_generated_p1 | boolean | false | Also put generated (GGen, Matra-Genoa) structures in space… |
| include_phase_diagram | boolean | true | Include an interactive phase diagram in the report |

## Run it

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

```
execute_route(route_id="d10241ae-e66b-49a9-b8bf-ca1af66b8803", body={"system":"..."})
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("d10241ae-e66b-49a9-b8bf-ca1af66b8803", body={"system":"..."})
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.
