create_influence_line#

create_influence_line(**kwargs)#

Create an influence line object from stored moving-load or grid-load results.

The helper extracts one response quantity from an xarray.Dataset and reindexes it against one load-position coordinate, typically x for a driving-lane influence line.

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".

  • load_coord (str, optional) – Load-position coordinate to use as the influence-line axis. One of "x", "y", "z", or cumulative path "station". Defaults to "x".

  • 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:

InfluenceLine object.