Franke and Rollins 2013 liquefied p-y curves

[emabcede30]

Added Franke and Rollins (2013) hybrid py model to account for liquefied soils. It takes residual shear strength $S_r$ as an input. There are recommended values for $S_r$ such as Seed and Harder (1990), Idriss and Boulanger (2007), or Kramer and Wang (2015). $\epsilon_{30}$ is also an input, with recommendations in Franke and Rollins (2013).

TODO: make test examples from same paper.

Also added concrete sections and solid circle sections. Assuming poisson's ratio concrete at 0.15.

Some ideas to include are:

1. The cracked concrete EI (varying stiffness)
2. More sections, materials

Summary by Sourcery

Add the Franke and Rollins (2013) hybrid model for liquefied soils and support for concrete and solid circle sections in pile construction.

New Features:

• Introduce the Franke and Rollins (2013) hybrid model for liquefied soils, allowing for the input of residual shear strength and strain at 50% failure load.
• Add support for concrete and solid circle sections in pile construction, with specific properties such as Poisson's ratio and Young's modulus for concrete.

Enhancements:

• Enhance the pile construction module to include solid circle sections and concrete material, expanding the types of piles and materials that can be modeled.

[sourcery-ai]

Reviewer's Guide by Sourcery

This PR implements the Franke and Rollins (2013) hybrid model for liquefied soils and adds support for concrete materials and solid circular sections. The hybrid model combines Wang-Reese (1998) and Rollins curves to model p-y behavior of liquefied soils, taking residual shear strength and strain parameters as inputs. The implementation includes new material properties for concrete and extends the pile types to support solid circular sections with appropriate mechanical calculations.

Class diagram for Franke and Rollins 2013 model

classDiagram
    class frankeRollins2013 {
        +Union[PositiveFloat, conlist(PositiveFloat, min_items=1, max_items=2)] Sr
        +Union[PositiveFloat, conlist(PositiveFloat, min_items=1, max_items=2)] eps50
        +Literal["static", "cyclic"] kind
        +Optional[Union[PositiveFloat, conlist(PositiveFloat, min_items=1, max_items=2)]] G0
        +confloat(ge=0.25, le=0.5) J
        +PositiveFloat stiff_clay_threshold
        +Union[Callable[[float], float], confloat(ge=0.0)] p_multiplier
        +Union[Callable[[float], float], confloat(gt=0.0)] y_multiplier
        +Optional[Literal["mt_curves"]] extension
        +float m_multiplier
        +float t_multiplier
        +__post_init__()
        +__str__() str
        +py_spring_fct(sig: float, X: float, layer_height: float, depth_from_top_of_layer: float, D: float, L: float = None, below_water_table: bool = True, ymax: float = 0.0, output_length: int = 15)
    }

Loading

Class diagram for Pile modifications

classDiagram
    class Pile {
        +str name
        +Literal["Circular", "Solid-Circle"] kind
        +Literal["Steel", "Concrete"] material
        +float top_elevation
        +__post_init__()
    }

Loading

File-Level Changes

Change	Details	Files
Implementation of Franke-Rollins hybrid model for liquefied soils	Added new LateralModel class frankeRollins2013 with parameters for residual shear strength and strain Implemented p-y curve generation combining Wang-Reese and Rollins approaches Added validation and interpolation for depth-dependent parameters Included support for p and y multipliers	src/openpile/soilmodels.py src/openpile/utils/py_curves.py
Added support for concrete material and solid circular sections	Added concrete material properties including Young's modulus and Poisson's ratio Implemented solid circular section geometry calculations Updated mechanical stiffness calculations for solid circular sections Modified element stiffness matrices to handle solid circular sections	src/openpile/construct.py src/openpile/core/kernel.py

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time. You can also use
  this command to specify where the summary should be inserted.

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[emabcede30]

TODO: add stiff clay below above and below water table py curves (Reese et al. 1975; Reese and Welch 1975) .