Module viiaChecking

This module contains functions to check certain aspects of the fem-model for seismic assessment in DIANA model.

Mesh checks

viiapackage.viiaChecking.viia_check_mesh(project: ViiaProject, min_angle: float = 15, max_angle: float = 165, max_skewness: float = 45, max_aspect_ratio: float = 5, output_folder: Optional[Path] = None) → Optional[Path][source]

This function checks the mesh of the model. The default requirements for VIIA are included in the ViiaSettings module. The function currently checks for the following items:

  • Check if the angles of the mesh-element are larger than the minimum angle requirement (VIIA default 15 degrees).

  • Check if the angles of the mesh-element are smaller than the maximum angle requirement (VIIA default 165 degrees).

  • Check if the skewness of the mesh-element is smaller than the maximum skewness requirement (VIIA default 45 degrees).

  • Check if the aspect-ratio of the mesh-element is smaller than the maximum aspect-ratio requirement (VIIA default is 5).

Note

The model must be meshed.

Input:

  • project (obj): Project object containing collections and of fem objects and project variables.

  • min_angle (float): Checking bound for smallest allowable mesh-element angle, in [deg]. Default value set in the ViiaSettings module.

  • max_angle (float): Checking bound for largest allowable mesh-element angle, in [deg]. Default value set in the ViiaSettings module.

  • max_skewness (float): Checking bound for the maximum allowed skewness of the mesh-element angle, in [deg]. Default value set in the ViiaSettings module.

  • max_aspect_ratio (float): Checking bound for the maximum allowed aspect-ratio of the mesh-element angle, in [-]. Default value set in the ViiaSettings module.

  • output_folder (Path): Optional input for location where to create the report. Default value is None, indicating the default location is used. In normal production objects do not change this!

Output:

  • Returns the path of the folder with the mesh check output files. These include the mesh check report in pdf, json-file of the model and the model summary in pdf.

  • In case there is no mesh the function is not executed and a warning is provided. Script continues.

  • The report offers insights into the mesh setup. It displays the count of mesh nodes and elements and a list of the element-types used. Alongside general information, the report includes graphs depicting distributions.

  • All mesh-elements are checked for compliance to the provided boundaries.

  • In case of not compliance a warning is raised indicating the model is not complying to the VIIA requirements. The user can proceed, but should review the locations of the exceedances. In most cases the mesh can be improved by applying a mesh-seeding or simplify geometry. Discuss with your Lead Engineer.