Skills, research notes and processing code from the total solar eclipse of 12 August 2026, organised so that an AI agent can pick them up and work with them.
Author and project owner: Pere Guerra Serra. The eclipse was photographed from Grajal de Campos (León, Spain) with two independent optical trains — a Vixen VSD90SS refractor with a Canon EOS R6 Mark III, and a Sony α7R IIIA with a 300 mm f/2.8 lens — both driven by Eclipse Command. The images were then processed over seven weeks by AI coding agents (Claude, from Anthropic, and Codex, from OpenAI) working under the author's direction: 123 versions of the image, 179 research notes and more than 3,000 scripts. In October the work went on with an independent check against coronagraphs and an absolute calibration of the corona (research notes 180 and 185).
This repository is that work, published as it is — plus, since version 1.1.0, a runnable package, ael, that
stacks declared RAW recipes, makes filter layers, and produces structure, polar and motion views.
Open this folder with your coding agent (Claude Code, Codex or similar) and tell it where your photos are. It reads
AGENTS.md and the skill skills/eclipse-first-steps/, looks at your
files and proposes the path one step at a time: calibrate (if you took darks or flats), linearise and stack, open a
layered 16-bit Photoshop project, and add the three most useful corona filters first. You choose how they look.
ael stack builds a linear stack with explicit calibration and registration. ael extinction
corrects that stack for differential atmospheric extinction when the Sun is low, after
subtracting the sky. ael filters adds the first three filters or sixteen portable variants
and an optional verified PSB. ael coronagraph checks the corona against K-Cor, SOHO/LASCO and
SDO/AIA: angular structure ring by ring with its null, and, with ael.coronagraph, brightness in
mean solar brightness with both published LASCO C2 calibrations and K + F for K-Cor. See stacking and filters
and the skill skills/coronagraph-comparison/.
| Product | What it is |
|---|---|
| Structure image | The corona's fine filaments from the limb to the edge of the field (the look made famous by Druckmüller's composites): mono, cool-toned, or in the data's own measured colour |
| Unrolled corona | The corona in polar coordinates around the Sun or the Moon: the limb becomes a straight line and the streamers rise like curtains |
| Coronal motion | Epochs of one totality aligned on the Sun, displacement vectors that reject sensor-fixed and Moon-fixed "motion", a visual-check sheet and GIF/MP4 animations |
pip install -e ".[raw]"
python -m ael selftest # known-truth tests and negative controls
python -m ael structure --input composite.npy --valid valid.npy --geometry geometry.json --out out/
python -m ael polar --input out/structure_cool.tif --geometry out/structure_geometry.json --out out/
python -m ael motion --config motion_config.json --out out/ # see examples/motion_config_template.json
Every function reads only observed pixels; where there is no data the result is NaN, never a fill or a mirror.
Details, and what the 2026 data taught (correlated noise, colour in linear light, a sensor pattern that looked
like coronal motion), in README_AEL.md. The agent's instructions for the three products are
the skill skills/corona-visualizations/ (in English).
NLFotografia contributed a case study on preserving an existing edit with adjustable filters in pull request #2. It records separate checks for registration and native Photoshop saves, including the remaining failures. Her field report in issue #1 (variable framing without calibration frames, rings, earthshine, Photoshop, validation) is in the field lessons since 1.3.1. Checking it against the package added ring, support and detail tests for the sixteen filters and found two filter limitations, now reported as issues.
Codex (OpenAI) has contributed as an AI coding agent to implementation, documentation and validation under Pere Guerra's direction.
Contributions are welcome through public pull requests. Only PeterWar
can update or merge changes into main.
Your experience can help the next photographer: a useful measurement, a clearer instruction, a bug or an approach that did not work. Agents using AEL are encouraged to help you prepare a short contribution and ask before sharing it. See how to contribute what you learned. Sharing is optional; you do not need to publish your photos to contribute.
| Path | What it is | Language |
|---|---|---|
AGENTS.md |
Entry point for any AI agent: what is here, where to start, the working rules that made the difference | English |
skills/eclipse-first-steps/ |
How an agent leads a newcomer from their own photos to a layered Photoshop project with the most useful filters | English |
skills/apilatge-imatges-eclipsi/ |
Linear calibration and stacking of eclipse RAW frames: darks, flats, pedestal, saturation, linearity, noise, weights, coverage | Catalan |
skills/postprocessat-corona/ |
The post-processing method: registration by ephemeris, linear HDR fusion of the two trains, detail filters (NRGF, RHEF, MGN, WOW, ACHF and our own variants), tone curve, Photoshop layer files, external judge, gates and receipts, with a long log of traps | Catalan |
skills/corregeix-artefactes/ |
Finding and curing recurring artefacts at their root: lens ghosts, fixed-pattern striping, coverage edges, limb fringes, radial-profile rings, marks painted by the photographer | Catalan |
skills/corona-visualizations/ |
Structure images, unrolled views and coronal-motion analyses with the ael package, with their gates |
English |
skills/coronagraph-comparison/ |
Checking an eclipse image against K-Cor, SOHO/LASCO and SDO/AIA: structure, orientation and brightness in mean solar brightness, with the traps that were real | English |
ael/, tests/, examples/ |
The runnable package (MIT), its tests with known truth and a configuration template | English |
3-RECERCA/ |
180 numbered research notes, July–October 2026, with their corrections left in place: capture (camera control, exposure ladders, timing) and post-processing. Start at 3-RECERCA/ABOUT_THESE_NOTES.md |
Catalan |
3-RECERCA/tools/ |
The processing code: about 3,000 Python scripts, shell chains and Photoshop JSX, one folder per stage or version | Catalan comments |
docs/LESSONS_FOR_MODEL_DEVELOPERS.md |
Recurring AI failure modes seen in this project, what fixed them, and requests for model builders | English |
docs/REGISTRE_APORTACIONS_PERE_GUERRA_20260917.md |
Dated record of the human contributions: method rules, defects found by eye, manual methods later formalised | Catalan |
PUBLICATION_MANIFEST.md |
What was left out, and why | English |
- Claude Code: clone the repository and open it; the skills load from
.claude/skills/. Or install them as a plugin in any project:/plugin marketplace add PeterWar/Agentic-Eclipse-Library /plugin install agentic-eclipse-library@pere-guerra-eclipse - Codex and other agents: point the agent at
AGENTS.md. Each skill is a plainSKILL.mdwithreferences/andscripts/. - Most text is in Catalan. Current models read and translate it without trouble; ask your agent to answer in your language.
- The research scripts are not turnkey software. The RAW frames, calibration frames, Photoshop files and
intermediate data arrays are not included, so the scripts in
3-RECERCA/tools/will not run end to end as they are. Read them as a precise record of the method, and adapt them to your own data. Theaelpackage is the exception: it runs on your data and is tested on synthetic data with known truth. - A snapshot of a working project. Notes and skills cite paths of the original project (
0-RAW,1-PHOTOSHOP,4-RESULTATS,IA,.coordination…). Only3-RECERCA/is here; the rest are references to evidence that stays with the author. - Constants are specific to this equipment and this eclipse (the Sun was 9° above the horizon).
- Nothing here is peer-reviewed. The notes correct each other in the open; later notes prevail.
- No support or maintenance is promised.
The enhancement filters come from published work by M. Druckmüller, H. Druckmüllerová, H. Morgan, S. Habbal,
F. Auchère, C. Gilly, S. Cranmer, J.-L. Starck, H. Knutsson and colleagues; we implemented them ourselves from their papers
(3-RECERCA/PAPERS_CONSULTED.md). Their published images of the same eclipse were
used only as an external judge: no pixel of theirs is in any product, and none of their images is in this
repository.
If you use this work — the skills, the notes or the code — or publish an image made with it, a mention in its caption, description or references would be appreciated. This is a courtesy request, not a condition of the licence:
Processed with Agentic Eclipse Library by Pere Guerra — https://github.com/PeterWar/Agentic-Eclipse-Library
For papers and software, CITATION.cff gives the citation (GitHub shows it under "Cite this
repository").
MIT © 2026 Pere Guerra Serra. You may use, copy, modify and redistribute this work freely, including commercially; the licence only asks you to keep the copyright notice with copies of the work.
- The field report of NLFotografia (issue #1)
in
docs/FIELD_LESSONS.md, with what was checked in the package and two filter limitations it brought to light. - Ring, support and detail tests for the sixteen filters on a synthetic scene. No output changes.
- Coronagraph check (
ael coronagraph,ael.coronagraph, skillcoronagraph-comparison): structure against K-Cor, LASCO and AIA, and brightness in mean solar brightness; on the 2026 data it reproduces the research results. - Differential extinction (
ael extinction,ael.extinction) for a low Sun, with the lesson that sky and extinction are degenerate. - Fixes prepared as 1.2.1: continuous radial statistics in NRGF and RHEF (in the field test the two-pixel rings fell to about 1 % of their old amplitude), a soft highlight shoulder instead of hard clipping, an explicit reference canvas, and the goal-first start for a new user.
- Field lessons (
docs/FIELD_LESSONS.md): coronagraphs, dust, a rotational-gradient layer, and adding layers to someone's file without rewriting theirs. - Research notes 180 and 185, and the code behind them in
3-RECERCA/tools/.
Existing images are not rewritten; compare a new numerical recipe before adopting it. See the changelog and validation.