TE Curve Verification Pipeline Dataset Difference Report

Build TE Curve Verification Pipeline dataset-difference visual reports.

class scripts.reports.analysis.build_track2_dataset_difference_report.CandidatePair(pair_id, simplified_candidate_id, polished_candidate_id)[source]

Bases: object

One simplified-trained versus polished-trained candidate pair.

Parameters:

  • pair_id (str)

  • simplified_candidate_id (str)

  • polished_candidate_id (str)

pair_id: str
simplified_candidate_id: str
polished_candidate_id: str
scripts.reports.analysis.build_track2_dataset_difference_report.build_argument_parser()[source]

Build the command-line argument parser.

Return type:

ArgumentParser

scripts.reports.analysis.build_track2_dataset_difference_report.parse_command_line_arguments()[source]

Parse command-line arguments.

Return type:

Namespace

scripts.reports.analysis.build_track2_dataset_difference_report.parse_candidate_pair(pair_text)[source]

Parse one CLI candidate-pair specification.

Parameters:

pair_text (str)

Return type:

CandidatePair

scripts.reports.analysis.build_track2_dataset_difference_report.resolve_timestamped_output_paths(output_root, report_topic_root, report_date, dataset_name, surface_scope)[source]

Resolve output paths for one dataset-difference report run.

Parameters:

  • output_root (Path)

  • report_topic_root (Path)

  • report_date (str | None)

  • dataset_name (str)

  • surface_scope (str)

Return type:

tuple[str, Path, Path]

scripts.reports.analysis.build_track2_dataset_difference_report.filter_curve_record_list_by_surface_scope(curve_record_list, surface_scope)[source]

Filter curve records for one surface scope.

Parameters:

  • curve_record_list (list[HarmonicCurveRecord])

  • surface_scope (str)

Return type:

list[HarmonicCurveRecord]

scripts.reports.analysis.build_track2_dataset_difference_report.load_candidate_lookup(training_config)[source]

Load configured candidate dictionaries by candidate id.

Parameters:

training_config (dict[str, Any])

Return type:

dict[str, dict[str, Any]]

scripts.reports.analysis.build_track2_dataset_difference_report.select_representative_curve_record_list(curve_record_list, curve_count)[source]

Select deterministic representative curves across the filtered scope.

Parameters:

  • curve_record_list (list[HarmonicCurveRecord])

  • curve_count (int)

Return type:

list[HarmonicCurveRecord]

scripts.reports.analysis.build_track2_dataset_difference_report.build_curve_key(entry_dictionary)[source]

Build a stable key for one payload entry.

Parameters:

entry_dictionary (dict[str, Any])

Return type:

tuple[str, str]

scripts.reports.analysis.build_track2_dataset_difference_report.save_pair_difference_plot(plot_path, pair, simplified_entry_list, polished_entry_lookup)[source]

Save one multi-curve pair difference plot and return metric rows.

Parameters:

  • plot_path (Path)

  • pair (CandidatePair)

  • simplified_entry_list (list[dict[str, Any]])

  • polished_entry_lookup (dict[tuple[str, str], dict[str, Any]])

Return type:

list[dict[str, Any]]

scripts.reports.analysis.build_track2_dataset_difference_report.save_metrics_csv(metrics_csv_path, metric_row_list)[source]

Save dataset-difference metrics to CSV.

Parameters:

  • metrics_csv_path (Path)

  • metric_row_list (list[dict[str, Any]])

Return type:

None

scripts.reports.analysis.build_track2_dataset_difference_report.build_report_markdown(report_path, validation_summary)[source]

Build the dataset-difference Markdown report.

Parameters:

  • report_path (Path)

  • validation_summary (dict[str, Any])

Return type:

str

scripts.reports.analysis.build_track2_dataset_difference_report.build_relative_markdown_path(target_path, markdown_directory)[source]

Build a Markdown-safe relative path from a report to an artifact.

Parameters:

  • target_path (Path)

  • markdown_directory (Path)

Return type:

str

scripts.reports.analysis.build_track2_dataset_difference_report.run_dataset_difference_report(arguments)[source]

Run the dataset-difference report builder.

Parameters:

arguments (Namespace)

Return type:

dict[str, Any]

scripts.reports.analysis.build_track2_dataset_difference_report.main()[source]

Run the command-line entry point.

Return type:

None