Hello-QM/catgo-LRG / server/catgo/workflow/skills/campaign
campaign-md-orchestration
VerifiedDrive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB). Use when the user opts out of the visual workflow engine.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/catgo-cli.md | markdown | 1.8 KB |
| scripts/INDEX.md | markdown | 1.8 KB |
| scripts/aggregate.py | script | 1011 B |
| scripts/archive.py | script | 1.8 KB |
| scripts/campaign_analysis.py | script | 4.3 KB |
| scripts/campaign_lib.py | script | 24.5 KB |
| scripts/campaign_lit.py | script | 3.3 KB |
| scripts/campaign_report.py | script | 1.6 KB |
| scripts/fetch_ref.py | script | 943 B |
| scripts/ingest_lit.py | script | 1.3 KB |
| scripts/make_report.py | script | 880 B |
| scripts/new_campaign.py | script | 932 B |
| scripts/poll.py | script | 798 B |
| scripts/submit_calc.py | script | 1.6 KB |
| scripts/test_campaign_analysis.py | script | 3.7 KB |
| scripts/test_campaign_lib.py | script | 21.8 KB |
| scripts/test_campaign_lit.py | script | 2.0 KB |
| scripts/test_campaign_report.py | script | 1.4 KB |
| scripts/test_entrypoints.py | script | 2.7 KB |
| scripts/test_skill_structure.py | script | 1.8 KB |
| scripts/test_vasp_sanity.py | script | 9.6 KB |
| scripts/vasp_sanity.py | script | 12.5 KB |
| templates/saa_her/plan.md | markdown | 1009 B |
scripts/campaign_analysis.py
View on GitHub"""Cross-calc aggregation for a campaign: ranking, volcano, funnel.
Reads every ``calc/**/result.md`` (the per-calc results contract) and writes
human-readable summaries into ``analysis/``. This is the campaign-level view the
DB-only engine made hard to see.
"""
from __future__ import annotations
import math
from pathlib import Path
import campaign_lib as cl
def collect_results(project) -> list[dict]:
proj = Path(project).expanduser()
out: list[dict] = []
for rf in sorted(proj.glob("calc/**/result.md")):
rel = rf.relative_to(proj).parts # calc/<stage>/<name>/result.md
stage = rel[1] if len(rel) >= 3 else ""
out.append({"name": rf.parent.name, "stage": stage,
"values": cl.parse_result(rf.read_text(encoding="utf-8"))})
return out
def _numeric(results, key):
# Drop non-finite values (NaN/inf): a failed job's collect step may write
# `dG_H: nan`, and NaN compares false against everything, which would
# silently scramble the sorted ranking/volcano/funnel order. Exclude them.
return [(r["name"], v) for r in results
if isinstance((v := r["values"].get(key)), (int, float))
and not isinstance(v, bool) and math.isfinite(v)]
def rank_formation_energy(results, key: str = "E_form") -> tuple[str, str]:
rows = sorted(_numeric(results, key), key=lambda t: t[1])
md = [cl.tldr_header("formation-energy ranking",
f"{len(rows)} candidates, most stable first"), "",
"| rank | candidate | E_form (eV) |", "|---|---|---|"]
md += [f"| {i} | {n} | {e:.3f} |" for i, (n, e) in enumerate(rows, 1)]
csv = "rank,candidate,E_form\n" + "".join(
f"{i},{n},{e}\n" for i, (n, e) in enumerate(rows, 1))
return "\n".join(md) + "\n", csv
def volcano_csv(results, key: str = "dG_H") -> str:
rows = sorted(_numeric(results, key), key=lambda t: abs(t[1]))
return "candidate,dG_H,abs_dG_H\n" + "".join(
f"{n},{v},{abs(v)}\n" for n, v in rows)
def funnel_md(results, eform_key: str = "E_form", eform_threshold: float = 0.0,
dg_key: str = "dG_H", top: int = 3) -> str:
stage1 = _numeric(results, eform_key)
survivors = [(n, e) for n, e in stage1 if e < eform_threshold]
activity = sorted(_numeric(results, dg_key), key=lambda t: abs(t[1]))
md = [cl.tldr_header(
"funnel",
f"{len(stage1)} candidates -> {len(survivors)} stable -> "
f"top {min(top, len(activity))} active"), ""]
md.append(f"- stage 1 (stability): {len(stage1)} candidates")
md.append(f"- survivors (E_form < {eform_threshold}): {len(survivors)} -> "
+ ", ".join(n for n, _ in survivors))
md.append(f"- stage 2 (activity) top {min(top, len(activity))} by |dG_H|: "
+ ", ".join(f"{n}({v})" for n, v in activity[:top]))
return "\n".join(md) + "\n"
def write_aggregates(project, eform_threshold: float = 0.0, top: int = 3) -> dict:
proj = Path(project).expanduser()
adir = proj / "analysis"
adir.mkdir(exist_ok=True)
results = collect_results(project)
rank_md, rank_csv = rank_formation_energy(results)
(adir / "formation_energy_ranking.md").write_text(rank_md, encoding="utf-8")
(adir / "formation_energy_ranking.csv").write_text(rank_csv, encoding="utf-8")
(adir / "volcano.csv").write_text(volcano_csv(results), encoding="utf-8")
(adir / "funnel.md").write_text(
funnel_md(results, eform_threshold=eform_threshold, top=top),
encoding="utf-8",
)
return {"n_results": len(results)}
def volcano_plot(project, key: str = "dG_H", out: str = "analysis/volcano.png") -> Path:
"""Scatter |dG_H| per candidate -> analysis/volcano.png (Agg, headless)."""
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
proj = Path(project).expanduser()
pts = _numeric(collect_results(project), key)
fig, ax = plt.subplots(figsize=(max(4, len(pts) * 0.8), 4))
xs = list(range(len(pts)))
ax.scatter(xs, [abs(v) for _, v in pts])
ax.set_xticks(xs)
ax.set_xticklabels([n for n, _ in pts], rotation=45, ha="right")
ax.set_ylabel(f"|{key}| (eV)")
ax.set_title("HER activity volcano (closer to 0 = better)")
fig.tight_layout()
dest = proj / out
dest.parent.mkdir(exist_ok=True)
fig.savefig(dest, dpi=120)
plt.close(fig)
return dest
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |