Skip to content

Instantly share code, notes, and snippets.

@jewzaam
Last active October 6, 2025 13:52
Show Gist options
  • Select an option

  • Save jewzaam/8b9a5166622e7ae58b5e59a748f03230 to your computer and use it in GitHub Desktop.

Select an option

Save jewzaam/8b9a5166622e7ae58b5e59a748f03230 to your computer and use it in GitHub Desktop.
AP Directory Structure Notes

Directory Structure Notes

I have one "Data" directory everything is put into. Under that I have a directory per camera. I have subdirectories for bias (if I use them) and darks and a subdirectory per telescope / lens. Inside each of the telescope / lens directories I have folders for each stage of a target's lifecycle, ordered by prefixing with a number so I can't miss a step. I use 2 digits so I could slot in something new if needed without changing anything else.

  • 00 Dark Library: special case directory at the camera level (not individual telescope / lens).
  • 10 Need Blink: anything I have not yet done a visual inspection of yet.
  • 20 Add to Data Log: I keep a spreadsheet of all the data I have with goals per filter. Adding the data to the logs after blink makes it easy to decide what I want to shoot next.
  • 30 Need FLATS: anything for which I don’t have flats. This usually happens if I have a new flat exposure time and need to take the flat darks.
  • 40 Need DARKS: anything for which I don’t have darks. Maybe it got super cold and I don’t have -15C darks. Or I am trying a new exposure time because of hardware changes, etc.
  • 50 Need Data: not done collecting data.. get more!
  • 60 Need Master: done collecting data, time to cut master lights. Projects can pile up so this way I don’t forget I haven’t done this step.
  • 70 Processing: working on processing a final image. I tend to think about the final image as well for a bit and keep the project around for PixInsight in case I want to fiddle with things after I'm "done".
  • 80 Baking: I _think_ I'm done processing but I probably am not. I put it here to remind me later to move it on to "done". I have not published this on astrobin yet.
  • 90 Done: really really done, published on astrobin. From here I'd move it to long term backup.

In the dark library dir I have sub dirs for each temp and gain and a special one for flat darks. I generally have darks for my flats and darks at gain 0 and 100, so dirs FLATS, GAIN_0, GAIN_100.

In every other dir each sub-dir is the target name. Inside that I have "accept" and "master". “Accept” has all the lights that survived blink. Historically I would keep all the rejected subs but I just delete them now. “Master” is all the processed master lights, organized by the date created. I've occasionally found it useful to review older masters if a new master shows some problem. In "accept" the structure is sub-dir per day formatted as "DATE_CCYY-MM-DD" with sub-dir for each filter + exposure time, "FILTER_<filter name>_EXP_<exposure seconds>".

The master darks and flats for each night go into the DATE directory. This means duplicating master darks and master flats. The upside is I never have to worry about deleting reference data. My dark library can be deleted and it doesn't matter because all the masters are copied to where they are needed. And when loading in PixInsight I literally just load the whole "accept" directory in WBPP and am done.

In the "master" directory I create a sub-dir for the date I created the master, i.e. "CCYY-MM-DD". Under this directory I have a sub-dir for each level of drizzle. Many times this just means a "1x" directory (no drizzle) but I still do this so it's consistent when I do a "2x" drizzle.

I never keep calibrated files, those are stuffed into a temporary directory and deleted when I don't need them. I prefer having the raw lights with master darks and flats. I thought about keeping raw data for the darks and flats but the amount of data adds up and I didn't have any need to re-process them to date.

If a target is a mosaic I add a “PANEL_N” sub-dir in “accept” for each panel and use the “PANEL” keyword in WBPP for grouping. This lets me manage either each panel or the mosaic in one consistent way.

Here's an example screenshot of the dir structure which closely follows what is stated above:

https://www.dropbox.com/s/t26ysvcgsc2xrrt/ExampleFileStructure.JPG?dl=0 (link is broken, I need to create a new screenshot!)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment