starbash 0.1.11__py3-none-any.whl → 0.1.15__py3-none-any.whl

starbash/recipes/README.md

@@ -1,3 +1,6 @@
 This is what a typical directory of recipes would look like.  it could be hosted locally in a directory tree, on github, whatever.
 
 Currently it lives in the starbash python blob, but eventually the 'master' set of recipes will live in a different repo.  In fact, different orgs could provide their own recipe repos.
+
+FIXME:
+For the time being we also have a few python scripts - until they are refactored a bit so they can live in the http tree.

starbash/recipes/master_bias/starbash.toml

@@ -34,10 +34,13 @@ input.required = 2    # siril needs at least 2 frames to stack
 output.dest = "repo"   # write to a particular repo
 output.type = "master" # write output to the special masters repo
 
+
+# context.target - the name of the target (m31 etc...) we are processing (if available)
 # the following fields will be auto populated in the context before entry:
 # context.output.base_path - the full filepath to write the output file to **excluding the suffix**
 # context.output.full_path - the full filepath to write the output file to (including suffix)
-# (NOT implemented / needed) context.output.root_path - points to the base of the destination repo
+# context.output.repo - points to the destination repo object
+# context.output.relative_base_path - the relative path within the repo (excluding suffix) (for logging/user message purposes)
 # (NOT implemented / needed) context.output.suffix - the suffix to append to the output file (e.g. .fits or .fit.gz)
 
 # The following constants are auto defined before running the tool

starbash/recipes/master_dark/starbash.toml

@@ -12,7 +12,6 @@ author.email = "FIXMESiril?"
 description = "Generate master dark"
 
 tool.name = "siril"
-tool.timeout = 30
 
 input.type = "dark"
 

starbash/recipes/osc.py

@@ -0,0 +1,190 @@
+# pyright: reportUndefinedVariable=false
+
+
+import logging
+import os
+from glob import glob
+from typing import Any
+
+from starbash.processing import NotEnoughFilesError
+from starbash.tool import tools
+
+siril = tools["siril"]
+
+delete_temps = False
+
+# ('context' and 'logger' are normally injected by the starbash runtime)
+context: dict[str, Any] = {}
+logger: logging.Logger = None  # type: ignore
+
+
+# FIXME move this into main starbash
+def perhaps_delete_temps(temps: list[str]) -> None:
+    if delete_temps:
+        for t in temps:
+            for path in glob(f"{context['process_dir']}/{t}_*"):
+                os.remove(path)
+
+
+def make_stacked(variant: str | None, output_file: str):
+    """
+    Registers and stacks all pre-processed light frames for a given filter configuration
+    across all sessions.
+    """
+    # If we are being invoked for simple/non duo filter we won't have variants generated by prior steps in the workflow
+    if variant is None:
+        input_base = "bkg_pp_light"
+    else:
+        input_base = f"{variant}_bkg_pp_light"
+
+    # The sequence name for all frames of this variant across all sessions
+    # e.g. Ha_bkg_pp_light_cHaOiii
+    merged_seq_base = f"all_{input_base}"
+
+    # Absolute path for the output stacked file
+    stacked_output_path = glob(f"{context['process_dir']}/{output_file}.fit*")
+
+    if stacked_output_path:
+        logger.info(f"Using existing stacked file: {stacked_output_path}")
+    else:
+        # Merge all frames (from multiple sessions and configs) use those for stacking
+        frames = glob(f"{context['process_dir']}/{input_base}_s*.fit*")
+
+        logger.info(
+            f"Registering and stacking {len(frames)} frames for {variant} -> {stacked_output_path}"
+        )
+        if len(frames) < 2:
+            raise NotEnoughFilesError("Need at least two frames", frames)
+
+        # Siril commands for registration and stacking. We run this in process_dir.
+        commands = f"""
+            link {merged_seq_base} -out={context["process_dir"]}
+            cd {context["process_dir"]}
+
+            # We use -2pass to select the best possible reference frame for others to register against
+            register {merged_seq_base} -2pass
+
+            # because we are using -2pass we must complete the registration here before stacking
+            # FIXME make drizzle optional
+            seqapplyreg {merged_seq_base} -drizzle
+
+            stack r_{merged_seq_base} rej g 0.3 0.05 -filter-wfwhm=3k -norm=addscale -output_norm -32b -out={output_file}
+
+            # and flip if required
+            mirrorx_single {output_file}
+            """
+
+        context["input_files"] = frames
+        siril.run(commands, context=context)
+
+    perhaps_delete_temps([merged_seq_base, f"r_{merged_seq_base}"])
+
+
+def make_renormalize(channel_num: int):
+    """
+    Aligns the stacked images (Sii, Ha, OIII) and renormalizes Sii and OIII
+    to match the flux of the Ha channel.
+    """
+    logger.info("Aligning and renormalizing stacked images.")
+
+    # Define file basenames for the stacked images created in the 'process' directory
+    ha_base = "results_00001"
+    oiii_base = "results_00002"
+    sii_base = "results_00003"
+
+    # Define final output paths. The 'results' directory is a symlink in the work dir.
+    results_dir = context["output"]["base_path"]
+    os.makedirs(results_dir, exist_ok=True)
+
+    commands = ""
+
+    if channel_num == 1:
+        # Only one channel - just copy it - eventually we'll add other metadata
+        final_path = f"{results_dir}/stacked.fits"
+        commands += f"""
+            load results_00001
+            save "{final_path}"
+            """
+
+    # Basenames for registered files (output of 'register' command)
+    r_ha = f"r_{ha_base}"
+    r_oiii = f"r_{oiii_base}"
+
+    if channel_num >= 2:
+        # Do pixelmath to fixup channel brightness
+        logger.info("Doing renormalisation of extra Ha/Oiii channels")
+
+        ha_final_path = f"{results_dir}/stacked_Ha.fits"
+        oiii_final_path = f"{results_dir}/stacked_OIII.fits"
+
+        # Pixel math formula for renormalization.
+        # It matches the median and spread (MAD) of a channel to a reference channel (Ha).
+        # Formula: new = old * (MAD(ref)/MAD(old)) - (MAD(ref)/MAD(old)) * MEDIAN(old) + MEDIAN(ref)
+        pm_oiii = f'"${r_oiii}$*mad(${r_ha}$)/mad(${r_oiii}$)-mad(${r_ha}$)/mad(${r_oiii}$)*median(${r_oiii}$)+median(${r_ha}$)"'
+
+        # Siril commands to be executed in the 'process' directory
+        commands += f"""
+            # -transf=shift fails sometimes, which I guess is possible because we have multiple sessions with possible different camera rotation
+            # -interp=none also fails sometimes, so let default interp happen
+            # -drizzle is required for success on many images
+            register results -drizzle
+            pm {pm_oiii}
+            update_key FILTER Oiii "OSC Duo filter extracted"
+            save "{oiii_final_path}"
+            load {r_ha}
+            update_key FILTER Ha "OSC Duo filter extracted"
+            save "{ha_final_path}"
+            """
+
+    if channel_num >= 3:
+        logger.info("Doing renormalisation of extra Sii channel")
+
+        sii_final_path = f"{results_dir}/stacked_Sii.fits"
+        r_sii = f"r_{sii_base}"
+        pm_sii = f'"${r_sii}$*mad(${r_ha}$)/mad(${r_sii}$)-mad(${r_ha}$)/mad(${r_sii}$)*median(${r_sii}$)+median(${r_ha}$)"'
+        commands += f"""
+            pm {pm_sii}
+            update_key FILTER Sii "OSC dual Duo filter extracted"
+            save "{sii_final_path}"
+            """
+
+    siril.run(commands, context=context, cwd=context["process_dir"])
+    logger.info(f"Saved final renormalized images to {results_dir}")
+
+
+def osc_process(has_ha_oiii: bool, has_sii_oiii: bool):
+    """Shared code for use by OSC processing scripts"""
+
+    logger.info(f"Running osc_process(has_ha_oiii={has_ha_oiii}, has_sii_oiii={has_sii_oiii})")
+    logger.debug("Using context: %s", context)
+
+    channel_num = 0
+    if has_sii_oiii:
+        # red output channel - from the SiiOiii filter Sii is on the 672nm red channel (mistakenly called Ha by siril)
+        channel_num += 1
+        make_stacked("Ha", f"results_{channel_num:05d}")
+
+    if has_ha_oiii:
+        # green output channel - from the HaOiii filter Ha is on the 656nm red channel
+        channel_num += 1
+        make_stacked("Ha", f"results_{channel_num:05d}")
+
+    if has_ha_oiii or has_sii_oiii:
+        # blue output channel - both filters have Oiii on the 500nm blue channel.  Note the case here is uppercase to match siril output
+        channel_num += 1
+        make_stacked("OIII", f"results_{channel_num:05d}")
+
+    # if we haven't already processed some other way - just do a single channel process
+    # FIXME in this case we want to use a siril line like "stack r_bkg_pp_light rej g 0.3 0.05 -filter-wfwhm=3k -norm=addscale -output_norm -rgb_equal -32b -out=result"
+    if channel_num == 0:
+        # single channel - just stack all Ha frames together
+        channel_num += 1
+        make_stacked(None, f"results_{channel_num:05d}")
+
+    # There might be an old/state autogenerated .seq file, delete it so it doesn't confuse renormalize
+    results_seq_path = f"{context['process_dir']}/results_.seq"
+    if os.path.exists(results_seq_path):
+        os.remove(results_seq_path)
+
+    assert channel_num >= 1, "At least one channel should have been processed"
+    make_renormalize(channel_num)

starbash/recipes/osc_dual_duo/starbash.toml

@@ -3,8 +3,12 @@
 kind = "recipe"
 
 [recipe]
-author.name = "Kevin Hester"
-author.email = "kevinh@geeksville.com"
+author.name = "FIXMEsirilsomeone"
+author.email = "FIXMEsirilsomeone"
+
+# Lower priority recipes are tried to match first
+# - we want this to match after the osc_dual_duo has a chance
+priority = 10
 
 # FIXME-somehow-specify-what-filternames are used to auto detect this recipe can be used?
 # figure out how to support dual duo vs single duo.  Perhaps: the FIRST recipe that matches an auto rule
@@ -17,7 +21,9 @@ author.email = "kevinh@geeksville.com"
 auto.require.filter = ["SiiOiii"]
 # for single duo look for this
 # auto.require.filter = ["HaOiii"]
-auto.require.camera = ["OSC"]
+
+# To require a color camera use this.  or to require a mono camera auto.require.mono.
+auto.require.color = true
 
 # all sb.toml files can optionally contain a version section.  if version of the running starbash app is out of bounds a warning message will be printed
 # to the user and the file will be ignored for future processing.
@@ -32,21 +38,19 @@ description = "Extract OSC dual duo filter Ha, Oiii and Sii channels"
 
 tool.name = "siril"
 
-when = "session.light" # run once per session.config
+# Auto find input light frames for the current session
+# Look for files in input repos, finding them by using the "relative" tag they contain
+input.source = "repo"
+input.required = 2    # siril needs at least 2 frames to stack
+input.type = "light" # look in all raw repos, but look only for light files
 
+# Auto find suitable masters of the following type
 input.masters = ["bias", "flat"]
 
-# FIXME, bias and flat should have been added to context by two previous stages.  But for now hardwire
-# Note: they should not have filename extensions (see strip_extension in the old process.py)
-# context.bias = '/workspaces/starbash/images/masters/biases/2025-09-09_stacked.fits'
+# the base name for our light files
+context.light_base = '''light_s{session["id"]}'''
 
-# context.sessionid = "2025-09-16" # FIXME, generate this by looping over all sessions (from outside this file)
-# context.sessionconfig = "SiiOiii" # FIXME generate this by looping over all session configs
-# context.light_base = "light_s{sessionid}_c{sessionconfig}"
 
-# FIXME until auto light finding is in
-# input.source = "path"
-# input.path = "/workspaces/starbash/images/from_astroboy/M 27/2025-09-16/LIGHT/*.fit*"
 
 script = '''
     # Create a sequence from the raw light frames, seq file goes to process_dir
@@ -54,7 +58,7 @@ script = '''
     cd {process_dir}
 
     # Calibrate the light frames using master bias and flat
-    calibrate {light_base} -bias={bias} -flat=flat -cfa -equalize_cfa
+    calibrate {light_base} -bias={master["bias"]} -flat={master["flat"]} -cfa -equalize_cfa
 
     # Remove background gradient on a per-frame basis (generates bkg_pp_light.seq)
     seqsubsky pp_{light_base} 1
@@ -63,39 +67,32 @@ script = '''
     seqextract_HaOIII bkg_pp_{light_base} -resample=ha
     '''
 
-temporaries = ["FIXME"]
+# temporaries = ["FIXME"]
 
 [recipe.stage.stack]
 
-disabled = false # not yet ready to test
-
-# FIXME this stage should only be considered if the previous stage in this same array
+# this stage is considered if the previous stage in this same array
 # was run.  It must be run inside the same tempdir (so that files from previous stage are available)
 
-# FIXME, eventually we could make it optional to even have a starbash.toml.  If we find an
-# starbash.py we could introspect it for a starbash_config dict.  And look inside that for description
-# "stage", "when" or whatever?
+description = "Stack OSC dual duo (HaOiii + SiiOiii) filter data: with separate Ha, Oiii and Sii channels"
 
-description = "Stack OSC dual duo filter data, with separate Ha, Oiii and Sii channels"
-
-# context.target = "M 27" # FIXME
-# context.targets = "/workspaces/starbash/images/processed" # FIXME, do something smarter
+input.source = "recipe" # we will use output files from previous stages in this same recipe as our input
 
 tool.name = "python"
 
-when = "final.stack" # run once after all session/session.config processing was done
-
 # Based on the following definitions in the stage toml file...
 # FIXME, we should inherit this - most recipes shouldn't have to declare it
 output.dest = "repo" # write to a particular repo
-output.type = "processed" # write output to the special masters repo
+output.type = "processed" # write output to the special processed repo
 
 # if not specified starbash.py used
 # script-file = "script.py"
 
-# or inline python code instead of that function?
-#script = '''
-#    make_stacked("SiiOiii", "Ha", f"results_00001")
-#    ...
-#    (moved to script.py)
-#    '''
+# or inline python code can be provided here.  In this case I'm using some python
+# code I'm temporarily sharing from the main project...
+script = '''
+    from starbash.recipes import osc
+    osc.logger = logger
+    osc.context = context
+    osc.osc_process(has_ha_oiii=True, has_sii_oiii=True)
+    '''

starbash/recipes/osc_simple/starbash.toml

@@ -0,0 +1,82 @@
+
+[repo]
+kind = "recipe"
+
+[recipe]
+
+# Lower priority recipes are tried to match first
+# - we want this to match after the osc_dual_duo has a chance
+priority = 30
+
+author.name = "FIXMEsirilsomeone"
+author.email = "FIXMEsirilsomeone"
+
+# no filter requirements - will work for any osc session
+auto.require.color = true
+
+# all sb.toml files can optionally contain a version section.  if version of the running starbash app is out of bounds a warning message will be printed
+# to the user and the file will be ignored for future processing.
+[recipe.require.version]
+min="0.1.0"
+max="4.5.8"
+
+[recipe.stage.light]
+
+description = "Calibrate OSC frames vs bias and flats"
+# disabled = true # FIXME, debugging later stuff
+
+tool.name = "siril"
+
+# Auto find input light frames for the current session
+# Look for files in input repos, finding them by using the "relative" tag they contain
+input.source = "repo"
+input.required = 2    # siril needs at least 2 frames to stack
+input.type = "light" # look in all raw repos, but look only for light files
+
+# Auto find suitable masters of the following type
+input.masters = ["bias", "flat"]
+
+# the base name for our light files
+context.light_base = '''light_s{session["id"]}'''
+
+script = '''
+    # Create a sequence from the raw light frames, seq file goes to process_dir
+    link {light_base} -out={process_dir}
+    cd {process_dir}
+
+    # Calibrate the light frames using master bias and flat
+    calibrate {light_base} -bias={master["bias"]} -flat={master["flat"]} -cfa -equalize_cfa
+
+    # Remove background gradient on a per-frame basis (generates bkg_pp_light.seq)
+    seqsubsky pp_{light_base} 1
+    '''
+
+# temporaries = ["FIXME"]
+
+[recipe.stage.stack]
+
+# this stage is only be considered if the previous stage in this same array
+# was run.  It must be run inside the same tempdir (so that files from previous stage are available)
+
+description = "Stack OSC simple (non duo filter) images"
+
+input.source = "recipe" # we will use output files from previous stages in this same recipe as our input
+
+tool.name = "python"
+
+# Based on the following definitions in the stage toml file...
+# FIXME, we should inherit this - most recipes shouldn't have to declare it
+output.dest = "repo" # write to a particular repo
+output.type = "processed" # write output to the special processed repo
+
+# if not specified starbash.py used
+# script-file = "script.py"
+
+# or inline python code can be provided here.  In this case I'm using some python
+# code I'm temporarily sharing from the main project...
+script = '''
+    from starbash.recipes import osc
+    osc.logger = logger
+    osc.context = context
+    osc.osc_process(has_ha_oiii=False, has_sii_oiii=False)
+    '''

starbash/recipes/osc_single_duo/starbash.toml

@@ -2,30 +2,43 @@
 [repo]
 kind = "recipe"
 
+[recipe]
+
+# Lower priority recipes are tried to match first
+# - we want this to match after the osc_dual_duo has a chance
+priority = 20
+
+author.name = "FIXMEsirilsomeone"
+author.email = "FIXMEsirilsomeone"
+
+# for single duo look for this
+auto.require.filter = ["HaOiii"]
+auto.require.color = true
+
 # all sb.toml files can optionally contain a version section.  if version of the running starbash app is out of bounds a warning message will be printed
 # to the user and the file will be ignored for future processing.
 [recipe.require.version]
 min="0.1.0"
 max="4.5.8"
 
-[recipe]
-author.name = "Kevin Hester"
-author.email = "kevinh@geeksville.com"
+[recipe.stage.light]
 
-[[stage]]
+description = "Extract OSC dual duo filter Ha, Oiii and Sii channels"
+# disabled = true # FIXME, debugging later stuff
 
-description = "Process OSC single duo filter data, extracting Ha and Oiii"
+tool.name = "siril"
 
-disabled = true # FIXME, we don't yet have auto selection based on filter types
+# Auto find input light frames for the current session
+# Look for files in input repos, finding them by using the "relative" tag they contain
+input.source = "repo"
+input.required = 2    # siril needs at least 2 frames to stack
+input.type = "light" # look in all raw repos, but look only for light files
 
-# Restrict processing of this stage to only if detected hardware was found for this session
-# for single duo look for this
-auto.for-filter = ["HaOiii"]
-auto.for-camera = ["OSC"]
+# Auto find suitable masters of the following type
+input.masters = ["bias", "flat"]
 
-tool.name = "siril"
-when = "session.light" # run once per session.config
-output = "FIXME"
+# the base name for our light files
+context.light_base = '''light_s{session["id"]}'''
 
 script = '''
     # Create a sequence from the raw light frames, seq file goes to process_dir
@@ -33,35 +46,41 @@ script = '''
     cd {process_dir}
 
     # Calibrate the light frames using master bias and flat
-    calibrate {light_base} -bias={bias} -flat={flat} -cfa -equalize_cfa
+    calibrate {light_base} -bias={master["bias"]} -flat={master["flat"]} -cfa -equalize_cfa
 
-    # Remove background gradient on a per-frame basis (generates bkg_pp_{light_base}.seq)
+    # Remove background gradient on a per-frame basis (generates bkg_pp_light.seq)
     seqsubsky pp_{light_base} 1
+
+    # FIXME only do this step for duo filters (refactor to share common light processing function)
+    seqextract_HaOIII bkg_pp_{light_base} -resample=ha
     '''
 
-temporaries = ["FIXME"]
+# temporaries = ["FIXME"]
 
-[[stage]]
+[recipe.stage.stack]
 
-disabled = true # FIXME, we don't yet have auto selection based on filter types
+# this stage is only be considered if the previous stage in this same array
+# was run.  It must be run inside the same tempdir (so that files from previous stage are available)
 
-tool.name = "python"
-when = "session.stack" # run once after all session/session.config processing was done
+description = "Stack OSC single duo filter data: with Ha, Oiii extraction"
 
-script-file = "script.py"
+input.source = "recipe" # we will use output files from previous stages in this same recipe as our input
 
-# or inline python code instead of that function?
-script = '''
-    # green output channel - from the HaOiii filter Ha is on the 656nm red channel
-    make_stacked("HaOiii", "Ha", f"results_00001")
+tool.name = "python"
 
-    # blue output channel - both filters have Oiii on the 500nm blue channel.  Note the case here is uppercase to match siril output
-    make_stacked("*", "OIII", f"results_00002")
+# Based on the following definitions in the stage toml file...
+# FIXME, we should inherit this - most recipes shouldn't have to declare it
+output.dest = "repo" # write to a particular repo
+output.type = "processed" # write output to the special processed repo
 
-    # There might be an old/state autogenerated .seq file, delete it so it doesn't confuse renormalize
-    results_seq_path = f"{process_dir}/results_.seq"
-    if os.path.exists(results_seq_path):
-        os.remove(results_seq_path)
+# if not specified starbash.py used
+# script-file = "script.py"
 
-    make_renormalize()
+# or inline python code can be provided here.  In this case I'm using some python
+# code I'm temporarily sharing from the main project...
+script = '''
+    from starbash.recipes import osc
+    osc.logger = logger
+    osc.context = context
+    osc.osc_process(has_ha_oiii=True, has_sii_oiii=False)
     '''

starbash/recipes/seestar/starbash.toml

@@ -0,0 +1,82 @@
+
+[repo]
+kind = "recipe"
+
+[recipe]
+
+# Lower priority recipes are tried to match first
+# - we want to match this before all other color cameras (because we need special processing)
+priority = 5
+
+author.name = "FIXMEsirilsomeone"
+author.email = "FIXMEsirilsomeone"
+
+# no filter requirements - will work for any osc session
+auto.require.camera = ["Seestar"]
+auto.require.color = true
+
+# all sb.toml files can optionally contain a version section.  if version of the running starbash app is out of bounds a warning message will be printed
+# to the user and the file will be ignored for future processing.
+[recipe.require.version]
+min="0.1.0"
+max="4.5.8"
+
+[recipe.stage.light]
+
+description = "Fix background gradient on Seestar frames"
+# disabled = true # FIXME, debugging later stuff
+
+tool.name = "siril"
+
+# Auto find input light frames for the current session
+# Look for files in input repos, finding them by using the "relative" tag they contain
+input.source = "repo"
+input.required = 2    # siril needs at least 2 frames to stack
+input.type = "light" # look in all raw repos, but look only for light files
+
+# We don't require any masters for seestar processing
+input.masters = []
+
+# the base name for our light files
+context.light_base = '''light_s{session["id"]}'''
+
+script = '''
+    # Create a sequence from the raw light frames, seq file goes to process_dir
+    link pp_{light_base} -out={process_dir}
+    cd {process_dir}
+
+    # No calibration needed for seestar frames - it was done in camera
+
+    # Remove background gradient on a per-frame basis (generates bkg_pp_light.seq)
+    seqsubsky pp_{light_base} 1
+    '''
+
+# temporaries = ["FIXME"]
+
+[recipe.stage.stack]
+
+# this stage is only be considered if the previous stage in this same array
+# was run.  It must be run inside the same tempdir (so that files from previous stage are available)
+
+description = "Stack OSC simple (non duo filter) images"
+
+input.source = "recipe" # we will use output files from previous stages in this same recipe as our input
+
+tool.name = "python"
+
+# Based on the following definitions in the stage toml file...
+# FIXME, we should inherit this - most recipes shouldn't have to declare it
+output.dest = "repo" # write to a particular repo
+output.type = "processed" # write output to the special processed repo
+
+# if not specified starbash.py used
+# script-file = "script.py"
+
+# or inline python code can be provided here.  In this case I'm using some python
+# code I'm temporarily sharing from the main project...
+script = '''
+    from starbash.recipes import osc
+    osc.logger = logger
+    osc.context = context
+    osc.osc_process(has_ha_oiii=False, has_sii_oiii=False)
+    '''

starbash/recipes/starbash.toml

@@ -21,12 +21,11 @@ dir = "osc_dual_duo"
 [[repo-ref]]
 dir = "osc_single_duo"
 
-# processing stages, currently all declared here, but possibly in the future they could be added by user/other toml files
+[[repo-ref]]
+dir = "osc_simple"
 
-# Not included in standard list - for now we run manually
-#[[stages]]
-#name = "setup-masters" # for flat processing, master generation etc
-#priority = 5
+[[repo-ref]]
+dir = "seestar"
 
 #
 # master specific stages
@@ -34,7 +33,7 @@ dir = "osc_single_duo"
 [[master-stages]]
 name = "master-bias" # generate master bias frames
 priority = 10
-input = "bias" # only used for frames of this type
+input = "bias"       # only used for frames of this type
 
 [[master-stages]]
 name = "master-dark" # generate master dark frames
@@ -47,8 +46,8 @@ priority = 20
 input = "flat"
 
 #
-# session specific processing stages, not currently used, for now I just do this list from code
-#
+# session specific processing stages
+# FIXME - we are not using this yet, for now we just hardcode in app.py
 
 [[stages]]
 name = "light" # generate light frames from lights and with reference to flats/bias
@@ -58,4 +57,4 @@ input = "light" # only used for frames of this type
 [[stages]]
 name = "stack" # stack frames
 priority = 30
-input = "light" # only used for frames of this type
+input = "recipe" # use output from previous stages in the same recipe