Phase 4 Hysteresis Feasibility Audit Builder

Build the Wave 5.2 Phase 4 hysteresis feasibility audit.

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.parse_arguments()[source]

Parse command-line arguments.

Return type:

Namespace

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.resolve_project_path(path_value)[source]

Resolve one project-relative path.

Parameters:

path_value (str | Path)

Return type:

Path

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.project_relative_path(path)[source]

Return one normalized project-relative path.

Parameters:

path (Path)

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.compute_sha256(path)[source]

Compute the SHA-256 digest of one file.

Parameters:

path (Path)

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.load_yaml(path)[source]

Load one YAML mapping.

Parameters:

path (Path)

Return type:

dict[str, Any]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.load_phase0_split_map(path)[source]

Load the unique Phase 0 split assignment per operating condition.

Parameters:

path (Path)

Return type:

dict[str, str]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.format_condition_number(value)[source]

Format a nominal condition value for a stable identifier.

Parameters:

value (float)

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.build_condition_id(conditions)[source]

Build the canonical condition identifier.

Parameters:

conditions (dict[str, float])

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.detect_delimiter(path)[source]

Detect the single-character delimiter used by one raw CSV.

Parameters:

path (Path)

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.count_boolean_segments(mask)[source]

Count contiguous true segments in one Boolean mask.

Parameters:

mask (ndarray)

Return type:

int

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.build_sustained_motion_runs(speed_rpm, minimum_motion_speed_rpm, minimum_sustained_direction_rows)[source]

Build debounced positive and negative motion runs.

Parameters:
  • speed_rpm (ndarray)

  • minimum_motion_speed_rpm (float)

  • minimum_sustained_direction_rows (int)

Return type:

list[tuple[int, int, int]]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.resolve_window_order(forward_index_array, backward_index_array)[source]

Resolve directional window order and surrounding row counts.

Parameters:
  • forward_index_array (ndarray)

  • backward_index_array (ndarray)

Return type:

tuple[str, int, int, int]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.audit_raw_trajectory(source_path, conditions, split_name, configuration)[source]

Audit one raw bidirectional operating-condition trajectory.

Parameters:
  • source_path (Path)

  • conditions (dict[str, float])

  • split_name (str)

  • configuration (dict[str, Any])

Return type:

dict[str, Any]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.write_csv(path, field_name_list, row_list)[source]

Write one deterministic CSV artifact.

Parameters:
  • path (Path)

  • field_name_list (list[str])

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

Return type:

None

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.build_dataset_contract_rows(raw_row_list, configuration)[source]

Build dataset and prior-model chronology boundary rows.

Parameters:
  • raw_row_list (list[dict[str, Any]])

  • configuration (dict[str, Any])

Return type:

list[dict[str, Any]]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.build_formulation_rows(configuration)[source]

Build the formulation feasibility decision rows.

Parameters:

configuration (dict[str, Any])

Return type:

list[dict[str, Any]]

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.markdown_boolean(value)[source]

Render a Boolean-like value for a Markdown table.

Parameters:

value (Any)

Return type:

str

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.build_markdown_report(report_path, summary, dataset_row_list, formulation_row_list)[source]

Write the canonical Phase 4 feasibility report.

Parameters:
  • report_path (Path)

  • summary (dict[str, Any])

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

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

Return type:

None

scripts.analysis.pinn_program_hysteresis.build_phase4_hysteresis_feasibility_audit.main()[source]

Build all Phase 4 audit artifacts and the decision report.

Return type:

None