pyvisco.verify

Collection of function to compare and verify the Python implementation within this module with the curve fitting routine of Ansys APDL 2021 R1.

Functions

load_prony_ANSYS(filepath)

Load Prony series parameters from ANSYS material card file.

plot_fit_ANSYS(df_master, df_GMaxw, ...)

Plot master curve, Prony series fit of Python implementation, and Prony series fit of ANSYS curve fitting routine.

prep_prony_ANSYS(df_prony, prony[, E_0])

Prepare ANSYS Prony series parameters for further processing.
pyvisco.verify.load_prony_ANSYS(filepath)

Load Prony series parameters from ANSYS material card file.

Parameters:

filepath (str) – Location and file name of ANSYS material card file (.MPL)

Returns:

df_prony – Contains the Prony series parameter.

Return type:

pandas.DataFrame

pyvisco.verify.prep_prony_ANSYS(df_prony, prony, E_0=None)

Prepare ANSYS Prony series parameters for further processing.

The ANSYS curve fitting routine for viscoelastic materials only stores the Prony series parameters (tau_i, alpha_i) in the material card file. To calculate the master curve from the Prony series parameters the instantenous modulus and frequency range are required and added to the dataframe of the ANSYS Prony series parameters.

Parameters:

  • df_prony (pandas.DataFrame) – Contains the ANSYS Prony series parameter.

  • prony (dict) – Contains the Python Prony series parameter

  • E_0 (float, default = None) – Instantaneous storage modulus; for either tensile (E_0) or shear (G_0) loading. If E_0 is not provided the instantaneous storage modulus identified during the Python curve fitting process will be used to create the master curve with the ANSYS Prony series parameters.

Returns:

prony_ANSYS – Contains the ANSYS Prony series parameter in the same format as the Python implementation provides (see prony Parameter above).

Return type:

dict

pyvisco.verify.plot_fit_ANSYS(df_master, df_GMaxw, df_GMaxw_ANSYS, units)

Plot master curve, Prony series fit of Python implementation, and Prony series fit of ANSYS curve fitting routine.

Parameters:

  • df_master (pandas.DataFrame) – Contains the master curve data.

  • df_GMaxw (pandas.DataFrame) – Contains the calculated Generalized Maxwell model data for the Prony series obtained with the Python implementation.

  • df_GMaxw_ANSYS (pandas.DataFrame) – Contains the calculated Generalized Maxwell model data for the Prony series obtained with the ANSYS implementation.

  • units (dict of {str : str}) – Contains the names of the physical quantities as key and the corresponding names of the units as item.

Returns:

fig – Plot of master curve and Prony fits.

Return type:

matplotlib.pyplot.figure