Pipeline

Execution flow, mode registry, and shared pipeline utilities.

Use these helpers to wire configs, run the pipeline, or extend selection modes:

from hipscatalog_gen.pipeline import get_selection_mode, run_pipeline
mode = get_selection_mode("mag_global")
run_pipeline(cfg)

hipscatalog_gen.pipeline.main.run_pipeline

Run the full HiPS catalog generation pipeline.

hipscatalog_gen.pipeline.modes.SelectionMode

Registry entry for a selection mode.

hipscatalog_gen.pipeline.modes.get_selection_mode

Return a selection mode entry, raising on unsupported names.

hipscatalog_gen.pipeline.structure.PipelineStage

Represents a single ordered pipeline step.

hipscatalog_gen.pipeline.structure.PipelineContext

Shared state passed between pipeline stages.

hipscatalog_gen.pipeline.structure.run_stages

Execute ordered pipeline stages, threading a context object.

hipscatalog_gen.pipeline.validation.validate_common_cfg

Cross-field validation for cluster/output and shared algorithm settings.

hipscatalog_gen.pipeline.validation.validate_mag_global_cfg

Surface mag_global config issues early.

hipscatalog_gen.pipeline.validation.validate_score_global_cfg

Surface score_global config issues early.

hipscatalog_gen.pipeline.validation.validate_score_density_hybrid_cfg

Surface score_density_hybrid config issues early.

hipscatalog_gen.pipeline.common.log_prologue

Emit the initial pipeline log lines.

hipscatalog_gen.pipeline.common.log_epilogue

Emit closing log lines and optionally persist process.log.

hipscatalog_gen.pipeline.common.build_and_prepare_input

Load inputs, validate RA/DEC, repartition, and persist when needed.

hipscatalog_gen.pipeline.common.compute_and_write_densmaps

Compute density maps for all depths and write them to disk.

hipscatalog_gen.pipeline.common.write_tiles_with_allsky

Finalize tiles and write optional Allsky.tsv.

hipscatalog_gen.pipeline.common.write_counts_summaries

Build output counts from selection-stage precomputed depth totals.

hipscatalog_gen.pipeline.logging_utils.setup_structured_logger

Configure a structured logger that writes to stdout and process.log; optionally JSON lines.