H_NUCLEIC_METHODS

This function returns the set of nucleate-boiling correlations that can be evaluated with the supplied inputs.

Conceptually, it performs a method-availability filter:

\mathcal{M}_{\text{available}} = g(\text{provided inputs},\; \text{range checks})

The output is returned as a single-column 2D list for Excel range compatibility.

Excel Usage

=H_NUCLEIC_METHODS(Te, Tsat, P, dPsat, Cpl, kl, mul, rhol, sigma, Hvap, rhog, MW, Pc, CAS, check_ranges)

• Te (float, optional, default: null): Excess wall temperature (K).
• Tsat (float, optional, default: null): Saturation temperature at operating pressure (K).
• P (float, optional, default: null): Saturation pressure of fluid (Pa).
• dPsat (float, optional, default: null): Saturation pressure difference at excess temperature (Pa).
• Cpl (float, optional, default: null): Heat capacity of liquid (J/kg/K).
• kl (float, optional, default: null): Thermal conductivity of liquid (W/m/K).
• mul (float, optional, default: null): Viscosity of liquid (Pa*s).
• rhol (float, optional, default: null): Density of the liquid (kg/m^3).
• sigma (float, optional, default: null): Surface tension of liquid (N/m).
• Hvap (float, optional, default: null): Heat of vaporization of the fluid (J/kg).
• rhog (float, optional, default: null): Density of the produced gas (kg/m^3).
• MW (float, optional, default: null): Molecular weight of fluid (g/mol).
• Pc (float, optional, default: null): Critical pressure of fluid (Pa).
• CAS (str, optional, default: null): CAS number of fluid (-).
• check_ranges (bool, optional, default: false): Whether to filter for methods valid for the inputs (-).

Returns (list[list]): Available method names as a single-column list, or an error message if invalid.

Example 1: Water properties with excess temperature

Inputs:

P	Pc	Te	CAS
300000	22048320	4	7732-18-5

Excel formula:

=H_NUCLEIC_METHODS(300000, 22048320, 4, "7732-18-5")

Expected output:

Gorenflo (1993)
HEDH-Taborek
Bier
Montinsky

Example 2: Filtered methods with range checks

Inputs:

P	Pc	Te	CAS	check_ranges
300000	22048320	4	7732-18-5	true

Excel formula:

=H_NUCLEIC_METHODS(300000, 22048320, 4, "7732-18-5", TRUE)

Expected output:

Gorenflo (1993)
HEDH-Taborek
Bier
Montinsky

Example 3: Methods from property set

Inputs:

Te	Cpl	kl	mul	rhol	sigma	Hvap	rhog
4.9	4217	0.68	0.000279	957.854	0.0589	2257000	0.595593

Excel formula:

=H_NUCLEIC_METHODS(4.9, 4217, 0.68, 0.000279, 957.854, 0.0589, 2257000, 0.595593)

Expected output:

"Rohsenow"

Example 4: Pressure-based methods

Inputs:

P	Pc	Te
200000	22048320	6

Excel formula:

=H_NUCLEIC_METHODS(200000, 22048320, 6)

Expected output:

HEDH-Taborek
Bier
Montinsky

Python Code

Show Code

from ht.boiling_nucleic import h_nucleic_methods as ht_h_nucleic_methods

def h_nucleic_methods(Te=None, Tsat=None, P=None, dPsat=None, Cpl=None, kl=None, mul=None, rhol=None, sigma=None, Hvap=None, rhog=None, MW=None, Pc=None, CAS=None, check_ranges=False):
    """
    List available nucleate boiling correlations based on provided inputs.

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

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

    Args:
        Te (float, optional): Excess wall temperature (K). Default is None.
        Tsat (float, optional): Saturation temperature at operating pressure (K). Default is None.
        P (float, optional): Saturation pressure of fluid (Pa). Default is None.
        dPsat (float, optional): Saturation pressure difference at excess temperature (Pa). Default is None.
        Cpl (float, optional): Heat capacity of liquid (J/kg/K). Default is None.
        kl (float, optional): Thermal conductivity of liquid (W/m/K). Default is None.
        mul (float, optional): Viscosity of liquid (Pa*s). Default is None.
        rhol (float, optional): Density of the liquid (kg/m^3). Default is None.
        sigma (float, optional): Surface tension of liquid (N/m). Default is None.
        Hvap (float, optional): Heat of vaporization of the fluid (J/kg). Default is None.
        rhog (float, optional): Density of the produced gas (kg/m^3). Default is None.
        MW (float, optional): Molecular weight of fluid (g/mol). Default is None.
        Pc (float, optional): Critical pressure of fluid (Pa). Default is None.
        CAS (str, optional): CAS number of fluid (-). Default is None.
        check_ranges (bool, optional): Whether to filter for methods valid for the inputs (-). Default is False.

    Returns:
        list[list]: Available method names as a single-column list, or an error message if invalid.
    """
    try:
        methods = ht_h_nucleic_methods(
            Te=Te,
            Tsat=Tsat,
            P=P,
            dPsat=dPsat,
            Cpl=Cpl,
            kl=kl,
            mul=mul,
            rhol=rhol,
            sigma=sigma,
            Hvap=Hvap,
            rhog=rhog,
            MW=MW,
            Pc=Pc,
            CAS=CAS,
            check_ranges=check_ranges,
        )
        return [[method] for method in methods]
    except Exception as e:
        return f"Error: {str(e)}"

Online Calculator

Te

Excess wall temperature (K).

Tsat

Saturation temperature at operating pressure (K).

P

Saturation pressure of fluid (Pa).

dPsat

Saturation pressure difference at excess temperature (Pa).

Cpl

Heat capacity of liquid (J/kg/K).

kl

Thermal conductivity of liquid (W/m/K).

mul

Viscosity of liquid (Pa*s).

rhol

Density of the liquid (kg/m^3).

sigma

Surface tension of liquid (N/m).

Hvap

Heat of vaporization of the fluid (J/kg).

rhog

Density of the produced gas (kg/m^3).

MW

Molecular weight of fluid (g/mol).

Pc

Critical pressure of fluid (Pa).

CAS

CAS number of fluid (-).

check_ranges

Whether to filter for methods valid for the inputs (-).