create_influence_surface#

create_influence_surface(**kwargs)#

Create an influence surface object from stored results.

The helper extracts one response quantity from an xarray.Dataset and reshapes it onto a 2D load-position grid, typically x by z for bridge deck influence surfaces.

Parameters:

  • ds (xarray.Dataset) – Result DataSet from get_results().

  • component (str) – Specific response component to extract.

  • array (str, optional) – Data array to query, e.g. "displacements", "forces", "forces_beam", or "forces_shell".

  • x_coord (str, optional) – Load-position coordinate to use on the first surface axis. Defaults to "x". Station-based datasets may also use "longitudinal_station" or "transverse_station".

  • y_coord (str, optional) – Load-position coordinate to use on the second surface axis. Defaults to "z". Station-based datasets may also use "longitudinal_station" or "transverse_station".

  • loadcase (str or list[str], optional) – Optional load case name or list of names to include.

  • values (list[tuple[float, float, float]], optional) – Optional explicit (x, y, z) load positions corresponding to the selected load cases. If omitted, positions are parsed from the Loadcase coordinate strings.

  • node (int or list[int], optional) – Optional node tag or list of node tags to select.

  • element (int or list[int], optional) – Optional element tag or list of element tags to select.

Returns:

InfluenceSurface object.