environmentaltools.processes.equilibrium_plan_shape

environmentaltools.processes.equilibrium_plan_shape(params, data)

Compute equilibrium planform shape using parabolic bay equation.

Calculates the equilibrium beach planform shape based on wave diffraction theory and parabolic bay equation (Hsu and Evans, 1989). Useful for assessing coastal stability and headland bay beach morphology.

Parameters:

• params (dict) –

  Dictionary with parameters including:

  • xfloat

    X-coordinate of diffraction point

  • yfloat

    Y-coordinate of diffraction point

  • theta_mfloat

    Mean wave direction (degrees)

  • Ts12float

    Mean wave period (s)

  • hfloat

    Water depth (m)

  • beta_rfloat, optional

    Parabolic coefficient (default: 2.13)

• data (pd.DataFrame) –

  DataFrame with profile coordinates containing:

  • x : X-coordinates

  • y : Y-coordinates

Returns:

• x (np.ndarray) – X-coordinates of equilibrium planform

• y (np.ndarray) – Y-coordinates of equilibrium planform

• theta_0 (float) – Control angle at the reference point (radians)