Data Manager - Functions

_get_field(name::String)

Returns the field with the given name.

Arguments

• name::String: The name of the field.

Returns

• field::Field: The field with the given name.

add_active_model(key::String, module_name::Module)

Add the main modules to an OrderedDict which are active.

Arguments

• key::String: Name of the model.
• active_module::Module: Module of the active models.

check_property(block_id::Int64, property::String)

Checks if the specified property exists for the given block_id.

Arguments

• block_id::Int64: The ID of the block.
• property::String: The name of the property to check.

Returns

• Bool: true if the property exists, false otherwise.

fem_active()

Returns if FEM is active (true) or not (false).

get_accuracy_order()

Returns the accuracy order for the "bond associated correspondence" implementation.

Arguments

• value::Int64: The value of the accuracy_order.

get_active_models()

Returns a list active model modules.

get_all_blocks()

Gives back a global list of all block, initially. Is reduced to the outer (not free) surfaces of the contact blocks.

get_all_field_keys()

Returns a list of all field keys.

get_all_positions()

Gives back a global list of current positions, initially. Is reduced to the outer (not free) surfaces of the contact blocks.

get_aniso_crit_values()

Retrieves the critical values matrix.

get_bc_free_dof()

Get all dof without displacment boundary conditions.

Returns

• Vector{Tuple{Int64, Int64}}: The point and dof without boundary condition.

get_block_id_list()

Returns a list of all block IDs.

get_block_name_list()

Returns a list of all block IDs.

get_bond_damage(time::String)

Get the bond damage

Arguments

• time::String: The time of the field.

Returns

• damage::Field: The bond damage field.

get_cancel()

This function returns the cancel flag.

Returns

• cancel::Bool: The value of the cancel variable.

get_comm()

Get the MPI communicator

get_contact_overlap_map()

Get the contact overlap map

get_coupling_dict()

Get the PD - FE coupling dict

get_coupling_fe_nodes()

Get the FE nodes involved in the coupling

get_crit_values_matrix()

Retrieves the critical values matrix.

get_current_time()

Get the current time of the simulation.

Returns

• Float64: The current time of the simulation.

get_damage(time::String) -> NodeScalarField{Float64}

Get the damage values for a specific time.

Arguments

• time::String: The time identifier for the damage field.

Returns

• NodeScalarField{Float64}: The damage values as a vector of floating-point numbers.

Examples

damage_values = get_damage("NP1")
println(damage_values)  # [1.5, 2.3, 0.8, ...]

get_dof()

Retrieves the degree of freedom (dof) value.

Returns

• dof (integer): The current degree of freedom value.

Example:

get_dof()  # returns the current degree of freedom

get_element_rotation()

This function returns the element_rotation flag.

Returns

• element_rotation::Bool: The value of the element_rotation variable.

get_field(name::String, time::String)

Returns the field with the given name and time.

Arguments

• name::String: The name of the field.
• time::String: The time of the field.

Returns

• field::Field: The field with the given name and time.

get_field_if_exists(name::String, time::String)

Returns the field with the given name if it exists.

Arguments

• name::String: The name of the field.
• time::String: The time of the field.

Returns

• field::Field: The field with the given name and time.

get_field_type()

Get the type of a field

Returns

• get_field_type (string): returns the type of a field

get_filtered_nlist()

Get the neighborhood list.

get_inverse_nlist()

Get the inverse of the neighborhood list.

get_step()

Get the iteration of the simulation.

Returns

• Int64: The iteration of the simulation.

get_local_nodes()

Determines the local node numbering.

Returns

• get_local_nodes (array): returns local nodes.

Example:

get_local_nodes()  # returns local nodes or if they do not exist at the core an empty array

get_local_synch_fields(model::String)

model - class of models; before computation of these models the synchronisation occurs
Get the fields to synchronize

get_max_rank()

This function returns the maximal rank of MPI the max_rank.

Returns

• max_rank::Number: The value of the max_rank variable.

Example

rank = get_max_rank()

get_max_step()

Get the max_step of the simulation.

Returns

• Int64: The max_step of the simulation.

get_mpi_active()

This function returns if MPI is active.

Returns

• mpi_active::Bool

Example

rank = get_mpi_active()

get_nlist()

Get the neighborhood list.

get_nnodes()

Retrieves the number of nodes.

Returns

• num_controller::Int64 : The current number of nodes.

Example:

get_nnodes()  # returns the current number of controler nodes. The neighbors are not included

get_nnsets()

Get the number of node sets.

Returns

• nnsets::Int: The number of node sets.

get_nsets()

Get the node sets

Returns

• nsets::Dict{String,Vector{Int64}}: The node sets dictionary.

get_num_elements()

Get the the number of finite elements

Returns

• get_num_elements::Int64: The number of finite elements

get_num_responder()

Get the the number of responder nodes

Returns

• num_responder::Int64: The number of responder nodes

get_output_frequency()

This function returns the output_frequency variable.

Returns

• output_frequency::Any: The value of the output_frequency variable.

get_overlap_map()

Get the overlap map

get_pre_calculation_order()

return the order of the pre calculation.

get_properties(block_id::Int64, property::String)

This function retrieves the value of a specified property for a given block_id if it exists in the properties dictionary.

Arguments

• block_id::Int64: The identifier of the block for which to retrieve the property.
• property::String: The dictionary entrycontaining the properties for the blocks.

Returns

• property_value::Any: The value associated with the specified property for the given block_id.
• Dict(): An empty dictionary if the specified property does not exist for the given block_id.

Example

block_properties = Dict(
    1 => Dict("color" => "red", "size" => 10),
    2 => Dict("color" => "blue", "height" => 20)
)

# Retrieve the 'color' property for block 1
color_value = get_properties(1, "color")  # Returns "red"

# Try to retrieve a non-existent property for block 2
non_existent_value = get_properties(2, "width")  # Returns an empty dictionary

get_property(block_id::Int64, property::String, value_name::String)

This function retrieves a specific value_name associated with a specified property for a given block_id if it exists in the properties dictionary.

Arguments

• block_id::Int64: The identifier of the block for which to retrieve the property.
• property::String: The String property type (e.g. Material model) for the blocks.
• value_name::String: The name of the value within the specified property.

Returns

• value::Any: The value associated with the specified value_name within the property for the given block_id.
• nothing: If the specified block_id, property, or value_name does not exist in the dictionary.

get_rank()

This function returns the rank of the core.

Returns

• rank::Any: The value of the rank variable.

Example

current_rank = get_rank()

get_rotation()

This function returns the rotation flag.

Returns

• rotation::Bool: The value of the rotation variable.

get_silent()

This function returns the silent flag.

Returns

• silent::Bool: The value of the silent variable.

get_step()

Get the step of the simulation.

Returns

• Int64: The step of the simulation.

get_synch_fields()

Get the fields to synchronize

get_verbose()

This function returns the verbose flag.

Returns

• verbose::Bool: The value of the verbose variable.

has_key(field_name::String)::Bool

Control if a key exists.

init_properties()

This function initializes the properties dictionary. Order of dictionary defines, in which order the models are called later on.

Returns

• keys(properties[1]): The keys of the properties dictionary in defined order for the Model_Factory.jl.

initialize_data()

Initialize all parameter in the Data_Manager and sets them to the default values.

loc_to_glob(range::UnitRange{Int64})

Converts the local index to the global index.

Arguments

• range::Union{UnitRange{Int64}, Vector{Int64}}: The range of the local index.

Example:

loc_to_glob(1:10)  # converts the local index to the global index

remove_active_model(module_name::Module)

Removes main modules from OrderedDict.

Arguments

• key::String: Key of the entry.

set_NP1_to_N(name::String, type::Type)

Sets the NP1toN dataset

Arguments

• name::String: The name of the field.
• type::Type The field type

set_accuracy_order(value::Int64)

Sets the accuracy order for the "bond associated correspondence" implementation.

Arguments

• value::Int64: The value of the accuracy_order.

setanisocritvalues(critvalues::Dict{Int64,Any})

Sets the anisotropic critical values globally.

Arguments

• crit_values::Dict{Int64,Any}: The critical values.

set_bc_free_dof(values::Vector{Tuple{Int64, Int64}})

Set all dof without displacment boundary conditions.

Returns

set_block_id_list(blocks_id_list::Vector{Int64})

Sets the block list globally.

Arguments

• blocks_id_list::Vector{Int64}: The block list.

set_block_name_list(blocks_name_list::Vector{String})

Sets the block list globally.

Arguments

• blocks_name_list::Vector{String}: The block list.

set_cancel(value::Int64)

Sets the cancel flag.

Arguments

• value::Bool: The cancel flag.

set_comm(comm::MPI.Comm)

Set the MPI communicator

Arguments

• comm::MPI.Comm: MPI communicator

set_contact_overlap_map(topo)

Sets the contact overlap map globally.

Arguments

• topo: The overlap map.

set_coupling_dict(coupling_dict::Dict{Int64,Int64})

Sets the FE - PD couplings. PD nodes -> FE Elements.

Arguments

• coupling_dict::Dict{Int64,Int64}: The coupling dictionary.

set_coupling_fe_nodes()

Get the FE nodes involved in the coupling

set_crit_values_matrix(crit_values::Array{Float64,3})

Sets the critical values matrix globally.

Arguments

• crit_values::Array{Float64,3}: The critical values matrix.

set_current_time(time::Float64)

Set the current time of the simulation.

Arguments

• time::Float64: The current time of the simulation.

set_distribution(values::Vector{Int64})

Sets the distribution globally.

Arguments

• values::Vector{Int64}: The distribution.

set_dof(n::Int64)

Sets the degree of freedom (dof) value globally.

Arguments

• n::Int64: The value to set as the degree of freedom.

Example:

set_dof(3)  # sets the degree of freedom to 3

set_element_rotation(value::Int64)

Sets the element_rotation flag.

Arguments

• value::Bool: The element_rotation flag.

set_fem(value::Bool)

Activates and deactivates the FEM option in PeriLab

Arguments

• value::Bool: The value to set FEM active (true) or not (false).

Example:

set_fem(true)  # sets the fem_option to true

set_glob_to_loc(dict::Dict{Int64,Int64})

Sets the global-to-local mapping dict globally.

Arguments

• dict (array): The dict representing the global-to-local mapping.

Example:

set_glob_to_loc([1, 3, 5])  # sets the global-to-local mapping dict

set_inverse_nlist(inv_nlist::Vector{Dict{Int64,Int64}})

Sets the inverse nlist globally.

Arguments

• inv_nlist::Vector{Dict{Int64,Int64}}: The inverse nlist.

set_iteration(iteration::Int64)

Set the iteration of the simulation.

Arguments

• iteration::Int64: The iteration of the simulation.

set_local_synch(model, name, download_from_cores, upload_to_cores, dof=0)

Sets the synchronization dictionary locally during the model update process. Should be used carefully, to avoid unessary communication.

Arguments

• name::String: The name of the field.
• download_from_cores::Bool: Whether to download the field from the cores.
• upload_to_cores::Bool: Whether to upload the field to the cores.

set_max_rank(value::Int64)

Sets the maximum rank globally.

Arguments

• value::Int64: The value to set as the maximum rank.

set_max_step(max_step::Int64)

Set the max_step of the simulation.

Arguments

• max_step::Int64: The max_step of the simulation.

set_nnodes()

Sets the number all nodes of one core globally.

Arguments

Example: ```

set_nnsets(n::Int64)

Set the number of node sets.

Arguments

• n::Int64: The number of node sets to be set.

set_nset(name, nodes)

Set the nodes associated with a named node set.

Arguments

• name::String: The name of the node set.
• nodes::Vector{Int}: The node indices associated with the node set.

set_num_controller(n::Int64)

Sets the number of controller nodes globally. For one core the number of nodes is equal to the number of controller nodes.

Arguments

• n::Int64: The value to set as the number of nodes.

Example:

set_num_controller(10)  # sets the number of nodes to 10

set_num_responder(n::Int64)

Sets the number of responder nodes globally. For one core the number of responder is zero. responder hold the information of the neighbors, of one node, but are not evaluated.

Arguments

• n::Int64: The value to set as the number of nodes.

Example:

set_num_responder(10)  # sets the number of responder nodes to 10

set_output_frequency(value)

Sets the output frequency globally.

Arguments

• value: The value to set as the output frequency.

set_overlap_map(topo)

Sets the overlap map globally.

Arguments

• topo: The overlap map.

set_pre_calculation_order(values::Vector{String})

Sets the order of the pre calculation options globally.

Arguments

• values::Vector{String}: The order of models.

set_properties(block_id, property, values)

Sets the values of a specified property for a given block_id.

Arguments

• block_id::Int64: The identifier of the block for which to set the property.
• property::String: The name of the property.
• values::Any: The values to set for the specified property.

set_properties(property, values)

Sets the values of a specified property for a all blocks. E.g. for FEM, because it corresponds not to a block yet,

Arguments

• property::String: The name of the property.
• values::Any: The values to set for the specified property.

set_property(block_id, property, value_name, value)

Sets the value of a specified property for a given block_id.

Arguments

• block_id::Int64: The identifier of the block for which to set the property.
• property::String: The name of the property.
• value_name::String: The name of the value within the specified property.
• value::Any: The value to set for the specified value_name.

set_rank(value::Int64)

Sets the rank globally.

Arguments

• value::Int64: The value to set as the rank.

set_rotation(value::Int64)

Sets the rotation flag.

Arguments

• value::Bool: The rotation flag.

set_silent(value::Bool)

Sets the silent flag.

Arguments

• value::Bool: The silent flag.

set_step(step::Int64)

Set the step of the simulation.

Arguments

• step::Int64: The step of the simulation.

set_synch(name, download_from_cores, upload_to_cores)

Sets the synchronization dictionary globally.

Arguments

• name::String: The name of the field.
• download_from_cores::Bool: Whether to download the field from the cores.
• upload_to_cores::Bool: Whether to upload the field to the cores.

set_verbose(value::Bool)

Sets the verbose flag.

Arguments

• value::Bool: The verbose flag.

switch_NP1_to_N()

Switches the fields from NP1 to N. This is more efficient than copying the data from one field the other.

synch_manager(synchronise_field, direction::String)

Synchronises the fields.

Arguments

• synchronise_field: The function to synchronise the field.
• direction::String: The direction of the synchronisation.