sage_tree_converter

Guides drafting or adapting a format-specific conversion driver for the SAGE merger tree converter. Use when no existing driver matches the input format and a new driver must be written in assets/ before the test conversion can run.

Provides field-level guidance for mapping input merger tree fields to the SAGE LHaloTree schema (HDF5 or binary). Use during web discovery or KDB entry creation when individual field mappings, unit conversions, or pointer reconstruction decisions need to be made.

Independently verifies the semantic validation plots and plotting code against the mandatory checklist. Use after semantic-validation generates the seven plots, before presenting results to the user. Operates independently - does not rely on the main agent's assessment.

Generates the seven mandatory semantic validation plots of the converted output merger trees. Use after a full conversion run in Stage 3 to assess whether the converted trees are physically plausible.

Runs the six structural checks on a converted SAGE LHaloTree HDF5 file. Use after any conversion run — test or full — to verify the output file is structurally correct before proceeding.

Adds a new format driver and schema mapping JSON to the KDB after a successful conversion of a previously unknown format. Use in Stage 4 when the input format was not found in the KDB at session start.

Updates an existing KDB schema mapping JSON with new information discovered during a conversion session. Use in Stage 4 when the input format was found in the KDB but the session revealed missing or incorrect information in the existing entry.

Searches the format-database/ KDB for a schema mapping that matches the input merger tree format. Use when a new input file has been identified and needs to be matched against known formats before any conversion begins.

Runs a SAGE dry run on a converted test file to validate functional correctness. Use after syntactic validation passes, if SAGE_BINARY_PATH is set in .env.

Searches the web for documentation on an unknown merger tree format. Use when kdb-lookup finds no matching format in the KDB and the input format must be identified from external sources.