Visualization

Plotting facade and Mollier-style refrigerant diagrams (T-h, P-h, T-s).

Plotting facade

Visualization and summary output functions (Facade for backward compatibility).

tmhp.visualization.print_simulation_summary(df, simulation_time_step, dV_ou_a_design)[source]

Print a comprehensive summary of simulation results.

Parameters:

  • df (pd.DataFrame) – Simulation result DataFrame.

  • simulation_time_step (int) – Time step [s].

  • dV_ou_a_design (float) – Design airflow rate of outdoor unit [m3/s].

Return type:

None

tmhp.visualization.plot_ph_diagram(ax, result, refrigerant, fontsize=None, tick_pad=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot P-h diagram on given axis.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • fontsize (Optional[float])

  • tick_pad (Optional[float])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None

tmhp.visualization.plot_th_diagram(ax, result, refrigerant, T_cond_bound=None, T_evap_bound=None, fontsize=None, tick_pad=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot T-h diagram on given axis.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • T_cond_bound (Optional[dict[str, float | str]])

  • T_evap_bound (Optional[dict[str, float | str]])

  • fontsize (Optional[float])

  • tick_pad (Optional[float])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None

tmhp.visualization.plot_ts_diagram(ax, result, refrigerant, T_cond_bound=None, T_evap_bound=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot T-s diagram on given axis with super heating/cooling considered.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • T_cond_bound (Optional[dict[str, float | str]])

  • T_evap_bound (Optional[dict[str, float | str]])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None

Mollier diagrams

Mollier diagram visualization functions.

tmhp.mollier_diagram.plot_th_diagram(ax, result, refrigerant, T_cond_bound=None, T_evap_bound=None, fontsize=None, tick_pad=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot T-h diagram on given axis.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • T_cond_bound (Optional[dict[str, float | str]])

  • T_evap_bound (Optional[dict[str, float | str]])

  • fontsize (Optional[float])

  • tick_pad (Optional[float])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None

tmhp.mollier_diagram.plot_ph_diagram(ax, result, refrigerant, fontsize=None, tick_pad=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot P-h diagram on given axis.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • fontsize (Optional[float])

  • tick_pad (Optional[float])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None

tmhp.mollier_diagram.plot_ts_diagram(ax, result, refrigerant, T_cond_bound=None, T_evap_bound=None, sat_liquid_label='Sat. liquid', sat_vapor_label='Sat. vapor', ref_cycle_label='Ref. cycle', point_labels=None)[source]

Plot T-s diagram on given axis with super heating/cooling considered.

Parameters:

  • ax (Axes)

  • result (dict[str, float])

  • refrigerant (str)

  • T_cond_bound (Optional[dict[str, float | str]])

  • T_evap_bound (Optional[dict[str, float | str]])

  • sat_liquid_label (str)

  • sat_vapor_label (str)

  • ref_cycle_label (str)

  • point_labels (Optional[dict[str, str]])

Return type:

None