cratepy.ioput.readprocedures.read_mac_load_increm

read_mac_load_increm(file, file_path, keyword, n_load_subpaths)

Read macroscale loading incrementation.

The specification of the data associated with the macroscale loading constraints has the following input data file syntax:

Option 1: Number_of_Load_Increments

This option entails a given number of equal-magnitude loading increments applied to each loading subpath.

Number_of_Load_Increments < int >

Option 2: Increment_List

This option provides a general loading incrementation scheme.

Increment_List
[n_rep:] inc_load_fact[_inc_time] | [n_rep:] inc_load_fact[_inc_time] ..
[n_rep:] inc_load_fact[_inc_time] | [n_rep:] inc_load_fact[_inc_time] ..
[n_rep:] inc_load_fact[_inc_time] | [n_rep:] inc_load_fact[_inc_time] ..

where n_rep (int) is the number of increment repetitions (optional, defaults to 1), inc_load_fact is the incremental load factor, and inc_time is the incremental time (optional, defaults to loading time factor times the absolute value of the incremental load factor). The delimiter | separates different loading subpaths.

---

The optional specification of the data associated with the macroscale loading time factor has the following input data file syntax:

Loading_Time_Factor
< float >

Unless explicitly specified in any way, the loading time factor provides the time associated with the macroscale loading incrementation. The incremental time is obtained by multiplying the loading time factor by the incremental loading factor. Defaults to 1.0 if not specified.

---

Parameters:

• file (file) – Data file.

• file_path (str) – Data file path.

• keyword (str) – Keyword.

• n_load_subpaths (int) – Number of loading subpaths.

Returns:

mac_load_increm – For each loading subpath id (key, str), stores a numpy.ndarray of shape (n_load_increments, 2) where each row is associated with a prescribed loading increment, and the columns 0 and 1 contain the corresponding incremental load factor and incremental time, respectively.

Return type:

dict