List Candidates

Scan and display verified chaotic attractor candidates loaded via the public API.

This example script demonstrates how to load located candidates from a local outputs cache directory using the public load_final_candidate_records() package API.

Usage

Run the script from the root of the repository:

python examples/list_final_candidates.py

Source Code

#!/usr/bin/env python3
"""List the final candidates loaded through the package API."""

from __future__ import annotations

import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parents[1]
if str(ROOT) not in sys.path:
    sys.path.insert(0, str(ROOT))

from hidden_attractors import load_final_candidate_records


def main() -> None:
    try:
        records = list(load_final_candidate_records())
    except FileNotFoundError:
        print("No final candidate records found. Skipping display.")
        return

    for record in records:
        print(
            f"{record.candidate_id} | route={record.route} | "
            f"q={record.q:.4f} | start={record.robust_start.tolist()} | "
            f"seed={record.seed.tolist()}"
        )


if __name__ == "__main__":
    main()