GroupsLC

class GroupsLC(dll: SofDll)

Bases: object

This class provides methods and a data structure to:

  • access keys 11/LC of the CDB file;

  • store the retrieved data in a convenient format;

  • provide access to the data after the CDB is closed.

The underlying data structure is a pandas.DataFrame with the following columns:

  • GROUP" group number

  • LOAD_CASE" the load case number

  • IS_ACTIVE" indicates whether the group is active in the load case

The DataFrame uses a MultiIndex with level GROUP and LOAD_CASE (in this specific order) to enable fast lookups via the is_active method. The index columns are not dropped from the DataFrame.

Note

Not all available quantities are retrieved and stored. In particular:

  • MNR: material number of the group

  • MBW: material reinforcement number of the group

  • IBB and IBD: construction stage numbers

  • MIN_ID, MAX_ID and number of elements.

are currently not included; however, MIN_ID, MAX_ID, and the number of elements are available in the Groups class.

This is a deliberate design choice and may be changed in the future without breaking the existing API.

clear(load_case: int) → None

Clear the loaded data for the given load_case number.

clear_all() → None

Clear the loaded data for all the load cases.

get_data(deep: bool = True) → DataFrame

Return the pandas.DataFrame containing the loaded keys 11/LC.

Parameters:

deep (bool, default True) – When deep=True, a new object will be created with a copy of the calling object’s data and indices. Modifications to the data or indices of the copy will not be reflected in the original object (refer to pandas.DataFrame.copy() documentation for details).

is_active(group_number: int, load_case: int) → bool

Return True if the group group_number is active in the load case load_case.

load(load_cases: int | list[bool | int]) → None

Retrieve group data for the given load_cases.

Parameters:

load_cases (int | list[int]) – load case numbers