com.net2plan.interfaces.networkDesign

Class Configuration

java.lang.Object

com.net2plan.interfaces.networkDesign.Configuration

public class Configuration
extends java.lang.Object

Class containing current Net2Plan-wide options, and methods to work with them.

In the current version the available options are:

• averagePacketLengthInBytes (double): Average packet length measured in bytes. Default: 340.46
• binaryRateInBitsPerSecondPerErlang (double): Binary rate in bps per Erlang. Default: 1e9
• classpath (String): Set of external libraries loaded at runtime (separated by semi-colon). Default: None
• defaultRunnableCodePath (String): Default path (either .jar file or folder) for external code. Default: BuiltInExamples.jar file
• precisionFactor (double): Precision factor for checks to overcome numeric errors. Default: 1e-3
• propagationSpeedInKmPerSecond (double): Propagation speed in the transmission media measured in km/s. On internal computations, a zero or negative value implies the propagation delay is equal to zero. Default: 2e5

In addition, due to the close relation to JOM library, some JOM-specific options can be configured:

• defaultILPSolver (String): Default solver for LP/ILP models. Default: glpk
• defaultNLPSolver (String): Default solver for NLP models. Default: ipopt
• cplexSolverLibraryName (String): Default path for cplex library (.dll/.so file). Default: None
• glpkSolverLibraryName (String): Default path for glpk library (.dll/.so file). Default: None
• ipoptSolverLibraryName (String): Default path for ipopt library (.dll/.so file). Default: None

Important: Values are stored in String format. Users are responsible to make conversions to the appropiate type (i.e. double).

Important: Users should not access this class directly. All interfaces for implementing user-made code (i.e. algorithms) include a map so-called net2planParameters as input parameter, where users can find the current configuration of the tool.

Since:

0.2.0

Author:

Pablo Pavon-Marino, Jose-Luis Izquierdo-Zaragoza

Constructor Summary

Constructors

Constructor and Description
Configuration()

Method Summary

Methods

Modifier and Type	Method and Description
static void	check(java.util.Map<java.lang.String,java.lang.String> net2planParameters) Checks the given options for validity.
static java.lang.String	getOption(java.lang.String option) Returns the value of an option.
static java.util.Map<java.lang.String,java.lang.String>	getOptions() Returns the current map of options.
static void	readFromOptionsDefaultFile() Reads options from the default file.
static void	readFromOptionsFile(java.io.File f) Reads options from a given file.
static void	saveOptions() Saves current options to the file system.
static void	setOption(java.lang.String option, java.lang.String value) Puts the value for an option.

Methods inherited from class java.lang.Object

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

Constructor Detail

Configuration

public Configuration()

Method Detail

check

public static void check(java.util.Map<java.lang.String,java.lang.String> net2planParameters)

Checks the given options for validity.

Parameters:

net2planParameters - A key-value map with Net2Plan-wide configuration options

Since:

0.2.2

readFromOptionsFile

public static void readFromOptionsFile(java.io.File f)
                                throws java.io.IOException

Reads options from a given file.

Parameters:

f - Options file

Throws:

java.io.IOException - If the specified file cannot be loaded

Since:

0.2.0

readFromOptionsDefaultFile

public static void readFromOptionsDefaultFile()
                                       throws java.io.IOException

Reads options from the default file.

Throws:

java.io.IOException - If the specified file cannot be loaded

Since:

0.2.0

getOptions

public static java.util.Map<java.lang.String,java.lang.String> getOptions()

Returns the current map of options.

Returns:

Map of current options

Since:

0.2.0

getOption

public static java.lang.String getOption(java.lang.String option)

Returns the value of an option.

Parameters:

option - Option name

Returns:

Option value

Since:

0.2.0

setOption

public static void setOption(java.lang.String option,
             java.lang.String value)

Puts the value for an option. If an option already exists, its value will be overriden.

Parameters:

option - Option name

value - Option value

Since:

0.2.0

saveOptions

public static void saveOptions()

Saves current options to the file system.

Since:

0.2.0