laurence
c6299f41ab
Preparing to merge this repository into a combined astrophotography repo. session-scripts/ becomes pipeline/ because the scripts import layout.py from their own directory and must stay together, and because 'pipeline' says what it is rather than how it came about. observing/ stays at the top level: observing plans are not processing code.
117 lines
4.5 KiB
Python
117 lines
4.5 KiB
Python
"""Drop a short README in each session subdirectory.
|
|
|
|
Each one says what the directory holds, where it came from, and whether it is
|
|
safe to delete - the three things someone opening a folder cold needs.
|
|
"""
|
|
import os
|
|
|
|
ROOT = r"C:\Users\lhorrocks-barlow\Downloads\NGC5128\20260721"
|
|
|
|
READMES = {
|
|
"raw": """# raw/
|
|
|
|
Exactly what iTelescope delivered, untouched.
|
|
|
|
- `calibrated-*.zip` - the calibrated frames, as archives (FITS and TIFF)
|
|
- `raw-*.zip` - the uncalibrated frames, kept for completeness
|
|
- `jpeg-*.jpg` - iTelescope's own preview of each sub
|
|
|
|
**Do not edit anything here.** This is the archive copy; everything else in the
|
|
session can be rebuilt from it. `calibrated/` holds these same frames
|
|
uncompressed.
|
|
""",
|
|
"calibrated": """# calibrated/
|
|
|
|
The 24 calibrated subs, uncompressed from `raw/`. 12 Luminance, 4 Red,
|
|
4 Green, 4 Blue, all 300 s, all BIN2.
|
|
|
|
`.fit` are the data the processing uses; `.tif` are the same frames in a form
|
|
other software can open.
|
|
|
|
Already bias, dark and flat corrected by iTelescope before delivery
|
|
(`CALSTAT = 'BDF'` in the headers) - that cannot be undone here.
|
|
|
|
Safe to delete: regenerable from `raw/` by re-running `unzip.py`.
|
|
""",
|
|
"stacks": """# stacks/
|
|
|
|
The combined frames, at two levels of processing.
|
|
|
|
- `masters/` - the real stacks: registered, transparency-normalised, combined
|
|
with outlier rejection, and plate-solved. Everything downstream uses these.
|
|
- `original/` - the baseline: aligned and averaged, and **nothing else**. No
|
|
rejection, no sky subtraction, no normalisation. Satellite trails and the
|
|
moon's gradient are still in it, deliberately. Useful when a processed result
|
|
looks odd and you need to know whether the data or the processing caused it.
|
|
|
|
Both sets are pixel-aligned to the same reference frame, so they can be
|
|
compared or subtracted directly.
|
|
""",
|
|
"final": """# final/
|
|
|
|
**The finished images.** Four renderings of the same data, differing only in
|
|
how much processing was applied, plus a side-by-side comparison.
|
|
|
|
| File | What it is |
|
|
|---|---|
|
|
| `NGC5128-final-1-stacked` | stacked and stretched, nothing else |
|
|
| `NGC5128-final-2-processed` | conventional processing |
|
|
| `NGC5128-final-3-best` | corrected by what the analyses established |
|
|
| `NGC5128-final-4-closeup` | image 3 cropped to the galaxy, 23.4' square |
|
|
| `NGC5128-final-comparison.jpg` | all three side by side, with a 1:1 crop |
|
|
|
|
Each comes as `.png` (viewing), `.tif` (16-bit, for editing or printing) and
|
|
`-preview.jpg` (small).
|
|
|
|
The reasoning behind each is in `../METHODS.md`.
|
|
""",
|
|
"renderings": """# renderings/
|
|
|
|
Finished images that are not the four deliverables in `final/`.
|
|
|
|
- `NGC5128-LRGB.*` - the first full composite
|
|
- `NGC5128-LRGB-hdr.*` - the same with the core recovered by a second tone curve
|
|
- `NGC5128-img-deconvolved.*` - sharpened luminance
|
|
- `NGC5128-img-annotated.jpg` - coordinate grid and catalogued objects, placed
|
|
by the plate solution. Includes SN 1986G and SN 2016adj, both real supernovae
|
|
in this galaxy.
|
|
- `NGC5128-img-starless.png` / `NGC5128-img-stars.png` - the field split into
|
|
nebulosity and stars
|
|
- `NGC5128-img-core-print.jpg` - a print crop
|
|
|
|
Kept because they show intermediate stages and because some are useful in their
|
|
own right. `final/` is what to look at first.
|
|
""",
|
|
"science": """# science/
|
|
|
|
The measurements, as opposed to the pictures.
|
|
|
|
- `notes/` - **start here.** Three write-ups covering the globular cluster
|
|
survey, the surface photometry, and the transient and moving-object search.
|
|
Each states its method, its numbers, and its limits.
|
|
- `figures/` - the plots those notes refer to
|
|
- `catalogues/` - the measured tables (CSV): cluster candidates, isophote
|
|
profiles, flagged objects
|
|
- `data/` - the galaxy model, star and dust masks, extinction map, and a plain
|
|
text summary of derived quantities
|
|
|
|
Headline results are summarised in `../METHODS.md`; the notes carry the detail,
|
|
the caveats and the things that did not work.
|
|
""",
|
|
"intermediates": """# intermediates/
|
|
|
|
Caches and scratch files: downloaded star catalogues, detection lists, partial
|
|
results, run logs.
|
|
|
|
**Safe to delete.** Everything here is regenerated by re-running the scripts,
|
|
at the cost of re-querying Gaia, SIMBAD and VizieR. Kept so a re-run is fast
|
|
and so the exact catalogue data used is preserved rather than silently changing
|
|
under a later query.
|
|
""",
|
|
}
|
|
|
|
for name, text in READMES.items():
|
|
path = os.path.join(ROOT, name, "README.md")
|
|
os.makedirs(os.path.dirname(path), exist_ok=True)
|
|
open(path, "w", encoding="utf-8").write(text)
|
|
print(f"wrote {name}/README.md")
|