sgio.read_output_state

sgio.read_output_state(filename: str, file_format: str, analysis: str, model_type: str = '', extension: str | list[str] = 'ele', sg: StructureGene | None = None, tool_version: str = '', num_cases: int = 1, num_elements: int = 0, **kwargs) → list[StateCase] | None

Read SG dehomogenization or failure analysis output.

Parameters:

• filename (str) – Name of the SG analysis output file.

• file_format (str) – Format of the SG data file. Choose one from ‘vabs’, ‘sc’, ‘swiftcomp’.

• analysis (str) –

  Indicator of SG analysis. Choose one from

  • ’d’ or ‘l’: Dehomogenization

  • ’fi’: Initial failure indices and strength ratios

• model_type (str) –

  Type of the macro structural model. Choose one from

  • ’SD1’: Cauchy continuum model

  • ’PL1’: Kirchhoff-Love plate/shell model

  • ’PL2’: Reissner-Mindlin plate/shell model

  • ’BM1’: Euler-Bernoulli beam model

  • ’BM2’: Timoshenko beam model

• extension (str or list of str, optional) –

  Extension(s) of the output data to read. Default is 'ele'. One or more of:

  • 'u': Displacement

  • 'ele': Element strain and stress (VABS)

  • 'sn' / 'snm': Element-node strain/stress in beam/material coordinate system (SwiftComp)

• sg (StructureGene, optional) – Structure gene object.

• tool_version (str, optional) – Solver tool version (e.g. '4', '5' for VABS).

• num_cases (int, optional) – Number of load cases. Default is 1.

• num_elements (int, optional) – Number of elements; 0 falls back to sg.nelems.

Returns:

List of state cases per load case, or None on parse failure.

Return type:

list[StateCase] or None