Configuring the Mesostructure

class configuration.Configuration(vf_max_assembly=0.3, average_shape=False)[source]

Bases: object

Provides methods for configuring the geometrical and topological parameters of the mesostructure.

load_inclusions(conf_csv=None)[source]
Parameters

conf_csv – string (with .csv extension), Location of the csv file which has aggregate parameters.

An example csv file for concrete

a

b

c

vf_max

n_cuts

coat

t_coat

space

t_space

concave

width

depth

2

2

3

0.134042553

10

FALSE

2

FALSE

2

FALSE

0

0.1

3

5

3

0.134042553

10

FALSE

2

FALSE

2

FALSE

0

0.1

4

3

4

0.075886525

10

FALSE

2

FALSE

2

FALSE

0

0.1

4

6

4

0.075886525

20

FALSE

2

FALSE

2

FALSE

0

0.1

5

3

3

0.075886525

30

FALSE

2

FALSE

0

FALSE

3

0.1

5

3

3

0.075886525

30

FALSE

2

FALSE

0

FALSE

3

0.1

6

4

3

0.075886525

30

FALSE

2

FALSE

0

FALSE

3

0.1

6

4

4

0.075886525

10

FALSE

2

FALSE

0

FALSE

3

0.1

7

12

5

0.046099291

10

FALSE

2

FALSE

0

FALSE

3

0.1

7

12

8

0.046099291

5

FALSE

2

FALSE

0

FALSE

3

0.2

7

12

8

0.046099291

10

FALSE

2

FALSE

0

FALSE

5

0.2

8

4

8

0.045138889

10

FALSE

2

FALSE

2

FALSE

5

0.2

8

5

8

0.045138889

20

FALSE

0

FALSE

2

FALSE

5

0.2

8

5

8

0.048020095

20

FALSE

0

FALSE

2

FALSE

5

0.2

Note

The header of the parameters in the csv file should be as follows:

  • a: diameter of the inclusion along direction-1 in actual units (mm/cm etc.).

  • b: diameter of the inclusion along direction-2 in actual units (mm/cm etc.).

  • c: diameter of the inclusion along direction-3 in actual units (mm/cm etc.).

  • n_cuts: Number of faces/cuts for the polyhedron shaped aggregates.

  • concave: Yes/No. Provision for concave depressions on the aggregates.

  • n_concave: Number of concave depressions on each aggregate surface in actual units (mm/cm etc.).

  • depth: A parameter which determines depth of the concave depression on the aggregate surface. Values should be between 0 to 1 (0 lowest, 1 highest).

  • width: A parameter which determines width of the concave depression on the aggregate surface.

  • coat: Yes/No. Provision for the coating on the aggregate surface.

  • t_coat: Thickness of the coating on the aggregate surface in actual units (mm/cm etc.).

  • space: Yes/No. Provision for the spacing on the aggregate surface. Spacing is like a coat on top of the aggregate which provides minimum gap between each inclusion in the mesostructure.

  • t_space: Thickness of the spacing on the aggregate surface in actual units (mm/cm etc.).

  • vf_max: Maximum volume fraction of each sized aggregates (value between 0 to 1).

Parameters
  • conf_header – If not csv, then a header with parameter names as given above and corresponding array of values have to be loaded.

  • conf_values – In not csv, then values corresponding to the header have to be loaded.

  • conf_dict – If not csv and conf_header & conf_values, inputs can be also given through a dictionary.

class configuration.InclusionFamily(average_shape=False, Id=None, inclusion_list=[], vf_max=1, a=10, b=0, c=0, n_cuts=10, concave=False, n_concave=0, depth=0, width=0, coat=False, t_coat=0, space=False, t_space=0, x=0, y=0, z=0, kwargs=None)[source]

Bases: object

This class is for family of inclusions

Parameters
  • average_shape (array of size (3),float) – Aspect ration of the inclusion along all three axes (value between 0-1).

  • Id (int, default: None) – Id of the inclusion family.

  • inclusion_list (array/list (1D)) – Gives list of inclusions belonging to the current family.

  • vf_max (float, value between 0 to 1, default:1.0) – Maximum volume fraction of the inclusion family.

  • a (float, default:10) – Diameter of the inclusion along direction-1 in actual units (mm/cm).

  • b (float, default:b=a* average_shape[1]) – Diameter of the inclusion along direction-2 in actual units (mm/cm).

  • c (float, default:c=a* average_shape[2]) – Diameter of the inclusion along direction-3 in actual units (mm/cm).

  • n_cuts (int, default:10) – Number of faces of the irregular polyhedron.

  • concave (bool, True/False, default:False) – Boolean for concave depression on inclusion surface.

  • n_concave (int, default:0) – Number of concave depressions on the inclusion surface.

  • depth (float, value between 0 to 1, default:0) – Parameter which determines depth of the concave depression from the inclusion surface.

  • width (float, default:0) – Parameter which determines width of the concave depression on the inclusion surface.

  • coat (bool, True/False, default:False) – Boolean for coat on inclusion.

  • t_coat (float, default:0) – Thickness of the coating in actual units (mm/cm).

  • space (bool, True/False, default:False) – Boolean for space which determines gap between inclusions in micro/mesostructure.

  • t_space (flaot, default:0) – Thickness of the spacing in actual units (mm/cm). Voxel value for the coat.

  • kwargs (Other parameters, default:None) –

generate_inclusion()[source]

This method generates an inclusion

Returns

Object of class smg_inclusion.Inclusion.

set_resolution(resolution)[source]