Package org.uma.evolver.parameter.yaml

Class YAMLParameterSpace

java.lang.Object

org.uma.evolver.parameter.ParameterSpace

org.uma.evolver.parameter.yaml.YAMLParameterSpace

public class YAMLParameterSpace
extends ParameterSpace

A YAML-based parameter space implementation that loads multi-objective metaheuristic parameter configurations from YAML files.

This class extends ParameterSpace to provide dynamic parameter loading capabilities from YAML configuration files. It supports various parameter types including categorical, integer, and double parameters, with full support for nested and conditional parameter structures commonly found in metaheuristic algorithm configurations.

Since:

1.0

Version:

1.0, 1.0

Author:

Antonio J. Nebro, Antonio J. Nebro

See Also:

• ParameterSpace
• ParameterProcessor
• Parameter
• JMetalException

Field Summary

Fields inherited from class org.uma.evolver.parameter.ParameterSpace

parameterSpace, topLevelParameters

Constructor Summary

Constructors

Constructor	Description
YAMLParameterSpace(String yamlFilePath, ParameterFactory<?> parameterFactory)	Constructs a new YAMLParameterSpace by loading parameters from the specified YAML file.

Method Summary

Modifier and Type	Method	Description
YAMLParameterSpace	createInstance()	Creates and configures a new instance of this parameter space.
ParameterProcessor	getParameterProcessor(String type)	Returns the parameter processor for the specified parameter type.
Map<String,ParameterProcessor>	getParameterProcessors()	Returns an unmodifiable view of all parameter processors.

Methods inherited from class org.uma.evolver.parameter.ParameterSpace

addTopLevelParameter, get, parameters, put, topLevelParameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

YAMLParameterSpace

public YAMLParameterSpace(String yamlFilePath,
 ParameterFactory<?> parameterFactory)

Constructs a new YAMLParameterSpace by loading parameters from the specified YAML file.

This constructor initializes the parameter processors, loads the YAML configuration,

Parameters:

yamlFilePath - the path to the YAML configuration file. The path can be a classpath resource (e.g., "config/parameters.yaml") or a filesystem path (e.g., "/path/to/parameters.yaml").

parameterFactory - the factory to use for creating parameter instances. This allows customization of parameter creation while maintaining the YAML parsing logic.

Throws:

org.uma.jmetal.util.errorchecking.JMetalException - if there is an error loading or parsing the YAML file, or if the configuration is invalid.

IllegalArgumentException - if yamlFilePath is null or empty, or if parameterFactory is null.

See Also:

• loadParametersFromYAML(String)
• processParameterDefinitions(Map)

Method Details

createInstance

public YAMLParameterSpace createInstance()

Description copied from class: ParameterSpace

Creates and configures a new instance of this parameter space.

This method is part of the prototype pattern, allowing parameter spaces to be cloned with the same configuration. Implementations should return a new instance of the concrete parameter space class with the same parameter configuration.

Example implementation:

 @Override
 public ParameterSpace createInstance() {
     return new MyParameterSpace();
 }
 

Specified by:

createInstance in class ParameterSpace

Returns:

a new instance of this parameter space

getParameterProcessors

public Map<String,ParameterProcessor> getParameterProcessors()

Returns an unmodifiable view of all parameter processors.

This method provides access to the internal processor registry for introspection and testing purposes. The returned map contains mappings from parameter type names to their corresponding processors.

Returns:

an unmodifiable map of parameter type names to their respective processors; never null

getParameterProcessor

public ParameterProcessor getParameterProcessor(String type)

Returns the parameter processor for the specified parameter type.

This method allows retrieval of specific processors for custom parameter processing or validation logic.

Parameters:

type - the parameter type (e.g., "categorical", "integer", "double"); case-sensitive

Returns:

the parameter processor for the specified type, or null if not found