musica_config Module Reference

The config_t type and related functions. More...

Data Types
type	config_iterator_t
	Configuration data iterator. More...
type	config_t
	Model configuration data. More...

Functions/Subroutines
subroutine	empty (this)
	Empties the configuration.
subroutine	construct_from_file (this, file_name)
	Constructs a configuration from a file.
subroutine	to_file (this, file_name)
	Writes a configuration to a file.
integer(kind=musica_ik) function	number_of_children (this)
	Returns the number of child objects.
class(iterator_t) function, pointer	get_iterator (this)
	Gets an interator for the configuration data.
type(string_t) function	key (this, iterator)
	Gets the key name using an iterator.
subroutine	get_config (this, key, value, caller, default, found)
	Gets a subset of the configuration data.
subroutine	get_string_string_default (this, key, value, caller, default, found)
	Gets a string from the configuration data.
subroutine	get_string (this, key, value, caller, default, found)
	Gets a string from the configuration data.
subroutine	get_int (this, key, value, caller, default, found)
	Gets an integer from the configuration data.
subroutine	get_float (this, key, value, caller, default, found)
	Gets a single-precision real number from the configuration data.
subroutine	get_double (this, key, value, caller, default, found)
	Gets a double-precision real number from the configuration data.
subroutine	get_logical (this, key, value, caller, default, found)
	Gets a boolean value from the configuration data.
subroutine	get_string_array (this, key, value, caller, default, found)
	Gets an array of strings from the configuration data.
subroutine	get_double_array (this, key, value, caller, default, found)
	Gets an array of doubles from the configuration data.
recursive subroutine	get_config_array (this, key, value, caller, default, found)
	Gets an array of config_t objects.
subroutine	get_from_iterator (this, iterator, value, caller)
	Gets a value using an iterator.
subroutine	get_array_from_iterator (this, iterator, value, caller)
	Gets an array value using an iterator.
recursive subroutine	add_config (this, key, value, caller)
	Adds a subset of configuration data.
subroutine	add_char_array (this, key, value, caller)
	Adds a string to the configuration data.
subroutine	add_string (this, key, value, caller)
	Adds a string to the configuration data.
subroutine	add_int (this, key, value, caller)
	Adds an integer to the configuration data.
subroutine	add_float (this, key, value, caller)
	Adds a single-precision real number to the configuration data.
subroutine	add_double (this, key, value, caller)
	Adds a double-precision real number to the configuration data.
subroutine	add_logical (this, key, value, caller)
	Adds a boolean to the configuration data.
subroutine	add_string_array (this, key, value, caller)
	Adds a string array to the configuration data.
subroutine	add_double_array (this, key, value, caller)
	Adds a double array to the configuration data.
recursive subroutine	add_config_array (this, key, value, caller)
	Adds a config_t array to the configuration data.
subroutine	config_assign_config (a, b)
	Assigns a config_t from a config_t.
subroutine	config_assign_string (config, string)
	Assigns a config_t from a string.
subroutine	config_assign_char (config, string)
	Assigns a config_t from a character array.
subroutine	string_assign_config (string, config)
	Assigns a string from a configuration.
subroutine	finalize (this)
	Cleans up memory.
subroutine	finalize_1d_array (this)
	Cleans up memory.
subroutine	find_by_prefix (this, prefix, full_key, found)
	Finds a full key name by a prefix.
recursive subroutine	merge_in (this, other, caller)
	Merges another config_t object into the config_t object.
logical function	find_key_in_list (key_to_find, list)
	Returns true if the given key is in the given list of keys.
logical function	validate (this, required_keys, optional_keys)
	Validates the format of the configuration data.
subroutine	do_print (this)
	Print out the raw contents of the configuration.
integer function	pack_size (this, comm)
	Returns the size of a binary buffer required to pack the object.
subroutine	mpi_pack (this, buffer, position, comm)
	Packs the configuration onto a character buffer.
subroutine	mpi_unpack (this, buffer, position, comm)
	Unpacks the configuration from a character buffer.
logical function	iterator_next (this)
	Advances the iterator.
subroutine	iterator_reset (this, parent)
	Resets the iterator.
subroutine	iterator_finalize (this)
	Cleans up memory assoicated with an iterator.
subroutine	initialize_config_t (config, string)
	Initialize a config_t object.
character(len=1, kind=c_char) function, dimension(:), allocatable	to_c_string (f_string)
	Convert a fortran character array to a c string.
character(len=:) function, allocatable	to_f_string (c_string)
	Convert a c string to a fortran character array.

Detailed Description

The config_t type and related functions.

Function/Subroutine Documentation

add_char_array()

subroutine musica_config::add_char_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, character(len=*), intent(in) value, character(len=*), intent(in) caller )

private

Adds a string to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_config()

recursive subroutine musica_config::add_config ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(config_t), intent(in) value, character(len=*), intent(in) caller )

private

Adds a subset of configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_config_array()

recursive subroutine musica_config::add_config_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(config_t), dimension(:), intent(in) value, character(len=*), intent(in) caller )

private

Adds a config_t array to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_double()

subroutine musica_config::add_double ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(kind=musica_dk), intent(in) value, character(len=*), intent(in) caller )

private

Adds a double-precision real number to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_double_array()

subroutine musica_config::add_double_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(kind=musica_dk), dimension(:), intent(in) value, character(len=*), intent(in) caller )

private

Adds a double array to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key to insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_float()

subroutine musica_config::add_float ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(kind=musica_rk), intent(in) value, character(len=*), intent(in) caller )

private

Adds a single-precision real number to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_int()

subroutine musica_config::add_int ( class(config_t), intent(inout) this, character(len=*), intent(in) key, integer, intent(in) value, character(len=*), intent(in) caller )

private

Adds an integer to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_logical()

subroutine musica_config::add_logical ( class(config_t), intent(inout) this, character(len=*), intent(in) key, logical, intent(in) value, character(len=*), intent(in) caller )

private

Adds a boolean to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_string()

subroutine musica_config::add_string ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(string_t), intent(in) value, character(len=*), intent(in) caller )

private

Adds a string to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

add_string_array()

subroutine musica_config::add_string_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(string_t), dimension(:), intent(in) value, character(len=*), intent(in) caller )

private

Adds a string array to the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key in insert
[in]	value	Value to set
[in]	caller	Name of the calling function (only for use in error messages)

config_assign_char()

subroutine musica_config::config_assign_char ( class(config_t), intent(out) config, character(len=*), intent(in) string )

private

Assigns a config_t from a character array.

Parameters

[out]	config	Configuration to assign to
[in]	string	String to assign from

config_assign_config()

subroutine musica_config::config_assign_config ( class(config_t), intent(out) a, class(config_t), intent(in) b )

private

Assigns a config_t from a config_t.

Parameters

[out]	a	Configuration to assign to
[in]	b	Configuration to assign from

config_assign_string()

subroutine musica_config::config_assign_string ( class(config_t), intent(out) config, class(string_t), intent(in) string )

private

Assigns a config_t from a string.

Parameters

[out]	config	Configuration to assign to
[in]	string	String to assign from

construct_from_file()

subroutine musica_config::construct_from_file ( class(config_t), intent(out) this, character(len=*), intent(in) file_name )

private

Constructs a configuration from a file.

Parameters

[out]	this	New configuration
[in]	file_name	File name containing configuration data

do_print()

subroutine musica_config::do_print ( class(config_t), intent(inout) this )

private

Print out the raw contents of the configuration.

Parameters

[in,out]

this

Configuration

empty()

subroutine musica_config::empty

(

class(config_t), intent(out)

this

)

Empties the configuration.

Parameters

[out]

this

Configuration

finalize()

subroutine musica_config::finalize ( type(config_t), intent(inout) this )

private

Cleans up memory.

Parameters

[in,out]

this

Configuration

finalize_1d_array()

subroutine musica_config::finalize_1d_array ( type(config_t), dimension(:), intent(inout) this )

private

Cleans up memory.

Parameters

[in,out]

this

Configuration

find_by_prefix()

subroutine musica_config::find_by_prefix ( class(config_t), intent(inout) this, character(len=*), intent(in) prefix, type(string_t), intent(out) full_key, logical, intent(out) found )

private

Finds a full key name by a prefix.

Returns the first instance of the prefix if found

Parameters

[in,out]	this	Configuration
[in]	prefix	Prefix to search for (first instance is returned)
[out]	full_key	Full key found
[out]	found	Flag indicating whether the key was found

get_array_from_iterator()

subroutine musica_config::get_array_from_iterator ( class(config_t), intent(inout) this, class(iterator_t), intent(in) iterator, type(string_t), dimension(:), intent(out), allocatable value, character(len=*), intent(in) caller )

private

Gets an array value using an iterator.

Parameters

[in,out]	this	Configuration
[in]	iterator	Iterator to use to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)

get_config()

subroutine musica_config::get_config ( class(config_t), intent(inout) this, character(len=*), intent(in) key, class(config_t), intent(out) value, character(len=*), intent(in) caller, class(config_t), intent(in), optional default, logical, intent(out), optional found )

private

Gets a subset of the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_config_array()

recursive subroutine musica_config::get_config_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(config_t), dimension(:), intent(out), allocatable value, character(len=*), intent(in) caller, type(config_t), dimension(:), intent(in), optional default, logical, intent(out), optional found )

private

Gets an array of config_t objects.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_double()

subroutine musica_config::get_double ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(kind=musica_dk), intent(out) value, character(len=*), intent(in) caller, real(kind=musica_dk), intent(in), optional default, logical, intent(out), optional found )

private

Gets a double-precision real number from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_double_array()

subroutine musica_config::get_double_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(musica_dk), dimension(:), intent(out), allocatable value, character(len=*), intent(in) caller, real(musica_dk), dimension(:), intent(in), optional default, logical, intent(out), optional found )

private

Gets an array of doubles from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_float()

subroutine musica_config::get_float ( class(config_t), intent(inout) this, character(len=*), intent(in) key, real(kind=musica_rk), intent(out) value, character(len=*), intent(in) caller, real(kind=musica_rk), intent(in), optional default, logical, intent(out), optional found )

private

Gets a single-precision real number from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_from_iterator()

subroutine musica_config::get_from_iterator ( class(config_t), intent(inout) this, class(iterator_t), intent(in) iterator, class(*), intent(out) value, character(len=*), intent(in) caller )

private

Gets a value using an iterator.

Parameters

[in,out]	this	Configuration
[in]	iterator	Iterator to use to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)

get_int()

subroutine musica_config::get_int ( class(config_t), intent(inout) this, character(len=*), intent(in) key, integer(kind=musica_ik), intent(out) value, character(len=*), intent(in) caller, integer(kind=musica_ik), intent(in), optional default, logical, intent(out), optional found )

private

Gets an integer from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_iterator()

class(iterator_t) function, pointer musica_config::get_iterator ( class(config_t), intent(in), target this )

private

Gets an interator for the configuration data.

Returns

Pointer to the iterator

Parameters

[in]

this

Configuration

get_logical()

subroutine musica_config::get_logical ( class(config_t), intent(inout) this, character(len=*), intent(in) key, logical, intent(out) value, character(len=*), intent(in) caller, logical, intent(in), optional default, logical, intent(out), optional found )

private

Gets a boolean value from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_string()

subroutine musica_config::get_string ( class(config_t), intent(inout) this, character(len=*), intent(in) key, class(string_t), intent(out) value, character(len=*), intent(in) caller, character(len=*), intent(in), optional default, logical, intent(out), optional found )

private

Gets a string from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_string_array()

subroutine musica_config::get_string_array ( class(config_t), intent(inout) this, character(len=*), intent(in) key, type(string_t), dimension(:), intent(out), allocatable value, character(len=*), intent(in) caller, type(string_t), dimension(:), intent(in), optional default, logical, intent(out), optional found )

private

Gets an array of strings from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

get_string_string_default()

subroutine musica_config::get_string_string_default ( class(config_t), intent(inout) this, character(len=*), intent(in) key, class(string_t), intent(out) value, character(len=*), intent(in) caller, class(string_t), intent(in) default, logical, intent(out), optional found )

private

Gets a string from the configuration data.

Parameters

[in,out]	this	Configuration
[in]	key	Key used to find value
[out]	value	Returned value
[in]	caller	Name of the calling function (only for use in error messages)
[in]	default	Default value if not found
[out]	found	Flag indicating whether key was found

initialize_config_t()

subroutine musica_config::initialize_config_t ( class(config_t), intent(inout) config, character(len=*), intent(in), optional string )

private

Initialize a config_t object.

Parameters

[in,out]	config	Configuration
[in]	string	YAML string

iterator_finalize()

subroutine musica_config::iterator_finalize ( type(config_iterator_t), intent(inout) this )

private

Cleans up memory assoicated with an iterator.

Parameters

[in,out]

this

Iterator

iterator_next()

logical function musica_config::iterator_next ( class(config_iterator_t), intent(inout) this )

private

Advances the iterator.

Returns false if the end of the collection has been reached

Parameters

[in,out]

this

Iterator

iterator_reset()

subroutine musica_config::iterator_reset ( class(config_iterator_t), intent(inout) this, class(iterator_t), intent(in), optional parent )

private

Resets the iterator.

Parameters

[in,out]	this	Iterator
[in]	parent	Iterator for parent model element

key()

type(string_t) function musica_config::key ( class(config_t), intent(inout) this, class(iterator_t), intent(in) iterator )

private

Gets the key name using an iterator.

Returns

Key name

Parameters

[in,out]	this	Configuration
[in]	iterator	Configuration iterator

merge_in()

recursive subroutine musica_config::merge_in ( class(config_t), intent(inout) this, class(config_t), intent(inout) other, character(len=*), intent(in) caller )

private

Merges another config_t object into the config_t object.

Parameters

[in,out]	this	Configuration
[in,out]	other	Configuration to merge in
[in]	caller	Name of the calling function (only for use in error messages)

mpi_pack()

subroutine musica_config::mpi_pack ( class(config_t), intent(inout) this, character, dimension(:), intent(inout) buffer, integer, intent(inout) position, integer, intent(in), optional comm )

private

Packs the configuration onto a character buffer.

Parameters

[in,out]	this	Configuration to pack
[in,out]	buffer	Memory buffer
[in,out]	position	Current buffer position
[in]	comm	MPI communicator

mpi_unpack()

subroutine musica_config::mpi_unpack ( class(config_t), intent(out) this, character, dimension(:), intent(inout) buffer, integer, intent(inout) position, integer, intent(in), optional comm )

private

Unpacks the configuration from a character buffer.

Parameters

[out]	this	Configuration to unpack
[in,out]	buffer	Memory buffer
[in,out]	position	Current buffer position
[in]	comm	MPI communicator

number_of_children()

integer(kind=musica_ik) function musica_config::number_of_children ( class(config_t), intent(inout) this )

private

Returns the number of child objects.

Returns

Number of child objects

Parameters

[in,out]

this

Configuration

string_assign_config()

subroutine musica_config::string_assign_config ( type(string_t), intent(out) string, class(config_t), intent(in) config )

private

Assigns a string from a configuration.

Parameters

[out]	string	String to assign to
[in]	config	Configuration to assign from

to_c_string()

character(len=1, kind=c_char) function, dimension(:), allocatable musica_config::to_c_string ( character(len=*), intent(in) f_string )

private

Convert a fortran character array to a c string.

Returns

String as const char*

Parameters

[in]

f_string

Fortran string to convert

to_f_string()

character(len=:) function, allocatable musica_config::to_f_string ( type(string_t_c), intent(in) c_string )

private

Convert a c string to a fortran character array.

Returns

Converted string for fortran

Parameters

[in]

c_string

C pointer to const char*

to_file()

subroutine musica_config::to_file ( class(config_t), intent(inout) this, character(len=*), intent(in) file_name )

private

Writes a configuration to a file.

Parameters

[in,out]	this	Configuration
[in]	file_name	File name to save configuration with

validate()

logical function musica_config::validate ( class(config_t), intent(inout) this, type(string_t), dimension(:), intent(in) required_keys, type(string_t), dimension(:), intent(in) optional_keys )

private

Validates the format of the configuration data.

Ensures that the required keys are present, and that user-defined keys start with a "`__`" prefix.

Parameters

[in,out]	this	Configuration
[in]	required_keys	Required keys
[in]	optional_keys	Optional keys