LEGACY_S_PIPE_PLANE

Backward-compatible wrapper for the pipe-to-plane conduction shape factor. It keeps legacy naming while producing the same geometric multiplier for steady conduction calculations.

The model relation is:

Q = Sk(T_1 - T_2)

Excel Usage

=LEGACY_S_PIPE_PLANE(D, Z, L)
  • D (float, required): Pipe diameter (m).
  • Z (float, required): Distance to plane (m).
  • L (float, optional, default: 1): Pipe length (m).

Returns (float): Shape factor (m).

Example 1: Example pipe to plane

Inputs:

D Z L
1 100 3

Excel formula:

=LEGACY_S_PIPE_PLANE(1, 100, 3)

Expected output:

3.14607

Example 2: Unit length near plane

Inputs:

D Z
0.4 5

Excel formula:

=LEGACY_S_PIPE_PLANE(0.4, 5)

Expected output:

1.60629

Example 3: Moderate spacing and length

Inputs:

D Z L
0.6 8 2

Excel formula:

=LEGACY_S_PIPE_PLANE(0.6, 8, 2)

Expected output:

3.16039

Example 4: Small pipe near plane

Inputs:

D Z L
0.2 2 1

Excel formula:

=LEGACY_S_PIPE_PLANE(0.2, 2, 1)

Expected output:

1.70357

Python Code

Show Code
from ht.conduction import S_isothermal_pipe_to_plane as ht_S_isothermal_pipe_to_plane

def legacy_S_pipe_plane(D, Z, L=1):
    """
    Deprecated alias for S_pipe_to_plane.

    See: https://ht.readthedocs.io/en/latest/ht.conduction.html

    This example function is provided as-is without any representation of accuracy.

    Args:
        D (float): Pipe diameter (m).
        Z (float): Distance to plane (m).
        L (float, optional): Pipe length (m). Default is 1.

    Returns:
        float: Shape factor (m).
    """
    try:
        return ht_S_isothermal_pipe_to_plane(D=D, Z=Z, L=L)
    except Exception as e:
        return f"Error: {str(e)}"

Online Calculator

Pipe diameter (m).
Distance to plane (m).
Pipe length (m).