convert_grid_from_legacy_to_picgrid Namespace Reference

Functions
argparse.Namespace	parse_args ()
	Parse wrapper CLI arguments.
int	main ()
	Convert the selected legacy grid file into a validated canonical PICGRID file.

Detailed Description

Backward-compatible wrapper for legacy grid conversion.

This script now delegates to:
    python3 generators/grid.gen legacy1d ...
so there is a single maintained conversion implementation.

Function Documentation

parse_args()

argparse.Namespace convert_grid_from_legacy_to_picgrid.parse_args

(

)

Parse wrapper CLI arguments.

Returns

Value returned by parse_args().

Definition at line 17 of file convert_grid_from_legacy_to_picgrid.py.

def parse_args() -> argparse.Namespace:
    """!
    @brief Parse wrapper CLI arguments.
    @return Value returned by `parse_args()`.
    """
    parser = argparse.ArgumentParser(
        description="Convert a legacy 1D-axis grid payload into canonical PICGRID format.",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog=(
            "This wrapper delegates to: python3 generators/grid.gen legacy1d ...\n\n"
            "Examples:\n"
            "  python3 generators/convert_grid_from_legacy_to_picgrid.py \\\n"
            "    --input legacy_flat.grid --output converted.picgrid\n"
            "  python3 generators/convert_grid_from_legacy_to_picgrid.py \\\n"
            "    --input legacy_flat.grid --output converted.picgrid --axis-columns 0 1 2\n"
            "  python3 generators/convert_grid_from_legacy_to_picgrid.py \\\n"
            "    --input legacy_flat.grid --output converted.picgrid --allow-trailing\n"
        ),
    )
    parser.add_argument("--input", required=True, help="Path to legacy grid input file.")
    parser.add_argument("--output", required=True, help="Path to converted PICGRID output file.")
    parser.add_argument(
        "--axis-columns",
        type=int,
        nargs=3,
        default=[0, 1, 2],
        metavar=("XCOL", "YCOL", "ZCOL"),
        help="Preferred source column index for X/Y/Z axis rows (default: 0 1 2).",
    )
    parser.add_argument(
        "--allow-trailing",
        action="store_true",
        help="Ignore trailing payload rows after expected legacy content.",
    )
    return parser.parse_args()
 
 

Here is the caller graph for this function:

main()

int convert_grid_from_legacy_to_picgrid.main

(

)

Convert the selected legacy grid file into a validated canonical PICGRID file.

Returns

Value returned by main().

Definition at line 54 of file convert_grid_from_legacy_to_picgrid.py.

def main() -> int:
    """!
    @brief Convert the selected legacy grid file into a validated canonical PICGRID file.
    @return Value returned by `main()`.
    """
    args = parse_args()
    project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
    gridgen = os.path.join(project_root, "generators", "grid.gen")
    if not os.path.isfile(gridgen):
        print(f"Error: grid.gen not found at '{gridgen}'.", file=sys.stderr)
        return 1
 
    cmd = [
        sys.executable,
        gridgen,
        "legacy1d",
        "--input",
        args.input,
        "--output",
        args.output,
        "--axis-columns",
        str(args.axis_columns[0]),
        str(args.axis_columns[1]),
        str(args.axis_columns[2]),
        "--no-write-vtk",
    ]
    cmd.append("--allow-trailing" if args.allow_trailing else "--strict-trailing")
 
    result = subprocess.run(cmd, text=True, capture_output=True)
    if result.stdout:
        print(result.stdout.strip())
    if result.stderr:
        print(result.stderr.strip(), file=sys.stderr)
    return result.returncode
 
 

Here is the call graph for this function:

Here is the caller graph for this function: