dolfin/parameter

Documentation for C++ code found in dolfin/parameter/*.h

Variables

empty_parameters

C++ documentation for empty_parameters from dolfin/parameter/Parameters.cpp:

Parameters dolfin::empty_parameters

Default empty parameters.

parameters

C++ documentation for parameters from dolfin/parameter/GlobalParameters.h:

GlobalParameters dolfin::parameters

The global parameter database.

Classes

BoolParameter

C++ documentation for BoolParameter from dolfin/parameter/Parameter.h:

class dolfin::BoolParameter

Parameter with value type bool.

dolfin::BoolParameter::BoolParameter(std::string key)

Create unset bool-valued parameter.

Parameters:key –
dolfin::BoolParameter::BoolParameter(std::string key, bool value)

Create bool-valued parameter.

Parameters:
  • key –
  • value –
dolfin::BoolParameter::operator bool() const

Cast parameter to bool.

const BoolParameter &dolfin::BoolParameter::operator=(bool value)

Assignment.

Parameters:value –
std::string dolfin::BoolParameter::range_str() const

Return range string.

std::string dolfin::BoolParameter::str() const

Return short string description.

std::string dolfin::BoolParameter::type_str() const

Return value type string.

std::string dolfin::BoolParameter::value_str() const

Return value string.

dolfin::BoolParameter::~BoolParameter()

Destructor.

DoubleParameter

C++ documentation for DoubleParameter from dolfin/parameter/Parameter.h:

class dolfin::DoubleParameter

Parameter with value type double.

dolfin::DoubleParameter::DoubleParameter(std::string key)

Create unset double-valued parameter.

Parameters:key –
dolfin::DoubleParameter::DoubleParameter(std::string key, double value)

Create double-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::DoubleParameter::get_range(double &min_value, double &max_value) const

Get range.

Parameters:
  • min_value –
  • max_value –
dolfin::DoubleParameter::operator double() const

Cast parameter to double.

const DoubleParameter &dolfin::DoubleParameter::operator=(double value)

Assignment.

Parameters:value –
std::string dolfin::DoubleParameter::range_str() const

Return range string.

void dolfin::DoubleParameter::set_range(double min_value, double max_value)

Set range.

Parameters:
  • min_value –
  • max_value –
std::string dolfin::DoubleParameter::str() const

Return short string description.

std::string dolfin::DoubleParameter::type_str() const

Return value type string.

std::string dolfin::DoubleParameter::value_str() const

Return value string.

dolfin::DoubleParameter::~DoubleParameter()

Destructor.

GlobalParameters

C++ documentation for GlobalParameters from dolfin/parameter/GlobalParameters.h:

class dolfin::GlobalParameters

This class defines the global DOLFIN parameter database.

dolfin::GlobalParameters::GlobalParameters()

Constructor.

void dolfin::GlobalParameters::parse(int argc, char *argv[])

Parse parameters from command-line.

Parameters:
  • argc –
  • argv –
dolfin::GlobalParameters::~GlobalParameters()

Destructor.

IntParameter

C++ documentation for IntParameter from dolfin/parameter/Parameter.h:

class dolfin::IntParameter

Parameter with value type int.

dolfin::IntParameter::IntParameter(std::string key)

Create unset int-valued.

Parameters:key –
dolfin::IntParameter::IntParameter(std::string key, int value)

Create int-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::IntParameter::get_range(int &min_value, int &max_value) const

Get range.

Parameters:
  • min_value –
  • max_value –
dolfin::IntParameter::operator int() const

Cast parameter to int.

dolfin::IntParameter::operator std::size_t() const

Cast parameter to std::size_t.

const IntParameter &dolfin::IntParameter::operator=(int value)

Assignment.

Parameters:value –
std::string dolfin::IntParameter::range_str() const

Return range string.

void dolfin::IntParameter::set_range(int min_value, int max_value)

Set range.

Parameters:
  • min_value –
  • max_value –
std::string dolfin::IntParameter::str() const

Return short string description.

std::string dolfin::IntParameter::type_str() const

Return value type string.

std::string dolfin::IntParameter::value_str() const

Return value string.

dolfin::IntParameter::~IntParameter()

Destructor.

Parameter

C++ documentation for Parameter from dolfin/parameter/Parameter.h:

class dolfin::Parameter

Base class for parameters.

dolfin::Parameter::Parameter(std::string key)

Create parameter for given key

Parameters:key – (std::string)
std::size_t dolfin::Parameter::access_count() const

Return access count (number of times parameter has been accessed)

Returns:std::size_t
std::size_t dolfin::Parameter::change_count() const

Return change count (number of times parameter has been changed)

Returns:std::size_t
void dolfin::Parameter::check_key(std::string key)

Check that key name is allowed.

Parameters:key –
std::string dolfin::Parameter::description() const

Return parameter description

Returns:std::string
void dolfin::Parameter::get_range(double &min_value, double &max_value) const

Get range for double-valued parameter

Parameters:
  • min_value – (double) [direction=out]
  • max_value – (double) [direction=out]
void dolfin::Parameter::get_range(int &min_value, int &max_value) const

Get range for int-valued parameter

Parameters:
  • min_value – (int) [direction=out]
  • max_value – (int) [direction=out]
void dolfin::Parameter::get_range(std::set<std::string> &range) const

Get range for string-valued parameter

Parameters:range – (std::set<std::string>) [direction=out]
bool dolfin::Parameter::is_set() const

Return true if parameter is set, return false otherwise

Returns:bool
std::string dolfin::Parameter::key() const

Return parameter key

Returns:std::string
dolfin::Parameter::operator bool() const

Cast parameter to bool.

dolfin::Parameter::operator double() const

Cast parameter to double.

dolfin::Parameter::operator int() const

Cast parameter to int.

dolfin::Parameter::operator std::size_t() const

Cast parameter to std::size_t.

dolfin::Parameter::operator std::string() const

Cast parameter to string.

const Parameter &dolfin::Parameter::operator=(bool value)

Assignment from bool

Parameters:value – (bool)
const Parameter &dolfin::Parameter::operator=(const char *value)

Assignment from string

Parameters:value – (char *)
const Parameter &dolfin::Parameter::operator=(double value)

Assignment from double

Parameters:value – (double)
const Parameter &dolfin::Parameter::operator=(int value)

Assignment from int

Parameters:value – (int)
const Parameter &dolfin::Parameter::operator=(std::string value)

Assignment from string

Parameters:value – (std::string)
std::string dolfin::Parameter::range_str() const = 0

Return range string.

void dolfin::Parameter::reset()

Reset the parameter to empty, so that is_set() returns false.

void dolfin::Parameter::set_range(double min_value, double max_value)

Set range for double-valued parameter

Parameters:
  • min_value – (double)
  • max_value – (double)
void dolfin::Parameter::set_range(int min_value, int max_value)

Set range for int-valued parameter

Parameters:
  • min_value – (int)
  • max_value – (int)
void dolfin::Parameter::set_range(std::set<std::string> range)

Set range for string-valued parameter

Parameters:range – (std::set<std::string>)
std::string dolfin::Parameter::str() const = 0

Return short string description.

std::string dolfin::Parameter::type_str() const = 0

Return value type string.

std::string dolfin::Parameter::value_str() const = 0

Return value string.

dolfin::Parameter::~Parameter()

Destructor.

Parameters

C++ documentation for Parameters from dolfin/parameter/Parameters.h:

class dolfin::Parameters

This class stores a set of parameters. Each parameter is identified by a unique string (the key) and a value of some given value type. Parameter sets can be nested at arbitrary depths. A parameter may be either int, double, string or boolean valued. Parameters may be added as follows:

Parameters p("my_parameters");
p.add("relative_tolerance",  1e-15);
p.add("absolute_tolerance",  1e-15);
p.add("gmres_restart",       30);
p.add("monitor_convergence", false);

Parameters may be changed as follows:

p["gmres_restart"] = 50;

Parameter values may be retrieved as follows:

int gmres_restart = p["gmres_restart"];

Parameter sets may be nested as follows:

Parameters q("nested_parameters");
p.add(q);

Nested parameters may then be accessed by

p("nested_parameters")["..."]

Parameters may be nested at arbitrary depths. Parameters may be parsed from the command-line as follows:

p.parse(argc, argv);

Note: spaces in parameter keys are not allowed (to simplify usage from command-line).

dolfin::Parameters::Parameters(const Parameters &parameters)

Copy constructor.

Parameters:parameters –
dolfin::Parameters::Parameters(std::string key = "parameters")

Create empty parameter set.

Parameters:key –
void dolfin::Parameters::add(const Parameters &parameters)

Add nested parameter set.

Parameters:parameters –
void dolfin::Parameters::add(std::string key)

Add an unset parameter of type T. For example, to create a unset parameter of type bool, do parameters.add<bool>(“my_setting”)

Parameters:key –
void dolfin::Parameters::add(std::string key, T min, T max)

Add an unset parameter of type T with allows parameters. For example, to create a unset parameter of type bool, do parameters.add<bool>(“my_setting”)

Parameters:
  • key –
  • min –
  • max –
void dolfin::Parameters::add(std::string key, bool value)

Add bool-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::Parameters::add(std::string key, const char *value)

Add string-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::Parameters::add(std::string key, const char *value, std::set<std::string> range)

Add string-valued parameter with given range.

Parameters:
  • key –
  • value –
  • range –
void dolfin::Parameters::add(std::string key, double value)

Add double-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::Parameters::add(std::string key, double value, double min_value, double max_value)

Add double-valued parameter with given range.

Parameters:
  • key –
  • value –
  • min_value –
  • max_value –
void dolfin::Parameters::add(std::string key, int value)

Add int-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::Parameters::add(std::string key, int value, int min_value, int max_value)

Add int-valued parameter with given range.

Parameters:
  • key –
  • value –
  • min_value –
  • max_value –
void dolfin::Parameters::add(std::string key, std::set<T> valid_values)

Add an unset parameter of type T with allows parameters. For example, to create a unset parameter of type bool, do parameters.add<bool>(“my_setting”)

Parameters:
  • key –
  • valid_values –
void dolfin::Parameters::add(std::string key, std::string value)

Add string-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::Parameters::add(std::string key, std::string value, std::set<std::string> range)

Add string-valued parameter with given range.

Parameters:
  • key –
  • value –
  • range –
void dolfin::Parameters::add_parameter_set_to_po(boost::program_options::options_description &desc, const Parameters &parameters, std::string base_name = "") const
Parameters:
  • desc –
  • parameters –
  • base_name –
void dolfin::Parameters::clear()

Clear parameter set.

Parameter *dolfin::Parameters::find_parameter(std::string key) const

Return pointer to parameter for given key and 0 if not found.

Parameters:key –
Parameters *dolfin::Parameters::find_parameter_set(std::string key) const

Return pointer to parameter set for given key and 0 if not found.

Parameters:key –
void dolfin::Parameters::get_parameter_keys(std::vector<std::string> &keys) const

Return a vector of parameter keys.

Parameters:keys –
void dolfin::Parameters::get_parameter_set_keys(std::vector<std::string> &keys) const

Return a vector of parameter set keys.

Parameters:keys –
bool dolfin::Parameters::has_key(std::string key) const

Check if parameter set has key (parameter or nested parameter set)

Parameters:key –
bool dolfin::Parameters::has_parameter(std::string key) const

Check if parameter set has given parameter.

Parameters:key –
bool dolfin::Parameters::has_parameter_set(std::string key) const

Check if parameter set has given nested parameter set.

Parameters:key –
std::string dolfin::Parameters::name() const

Return name for parameter set.

Parameters &dolfin::Parameters::operator()(std::string key)

Return nested parameter set for given key.

Parameters:key –
const Parameters &dolfin::Parameters::operator()(std::string key) const

Return nested parameter set for given key (const)

Parameters:key –
const Parameters &dolfin::Parameters::operator=(const Parameters &parameters)

Assignment operator.

Parameters:parameters –
Parameter &dolfin::Parameters::operator[](std::string key)

Return parameter for given key.

Parameters:key –
const Parameter &dolfin::Parameters::operator[](std::string key) const

Return parameter for given key (const version)

Parameters:key –
void dolfin::Parameters::parse(int argc, char *argv[])

Parse parameters from command-line.

Parameters:
  • argc –
  • argv –
void dolfin::Parameters::parse_common(int argc, char *argv[])

Parse filtered options (everything except PETSc options)

Parameters:
  • argc –
  • argv –
void dolfin::Parameters::parse_petsc(int argc, char *argv[])

Parse filtered options (only PETSc options)

Parameters:
  • argc –
  • argv –
void dolfin::Parameters::read_vm(boost::program_options::variables_map &vm, Parameters &parameters, std::string base_name = "")
Parameters:
  • vm –
  • parameters –
  • base_name –
void dolfin::Parameters::remove(std::string key)

Remove parameter or parameter set with given key.

Parameters:key –
void dolfin::Parameters::rename(std::string key)

Rename parameter set.

Parameters:key –
std::string dolfin::Parameters::str(bool verbose) const

Return informal string representation (pretty-print)

Parameters:verbose –
void dolfin::Parameters::update(const Parameters &parameters)

Update parameters with another set of parameters.

Parameters:parameters –
dolfin::Parameters::~Parameters()

Destructor.

StringParameter

C++ documentation for StringParameter from dolfin/parameter/Parameter.h:

class dolfin::StringParameter

Parameter with value type string.

dolfin::StringParameter::StringParameter(std::string key)

Create unset string-valued parameter.

Parameters:key –
dolfin::StringParameter::StringParameter(std::string key, std::string value)

Create string-valued parameter.

Parameters:
  • key –
  • value –
void dolfin::StringParameter::get_range(std::set<std::string> &range) const

Get range.

Parameters:range –
dolfin::StringParameter::operator std::string() const

Cast parameter to string.

const StringParameter &dolfin::StringParameter::operator=(const char *value)

Assignment.

Parameters:value –
const StringParameter &dolfin::StringParameter::operator=(std::string value)

Assignment.

Parameters:value –
std::string dolfin::StringParameter::range_str() const

Return range string.

void dolfin::StringParameter::set_range(std::set<std::string> range)

Set range.

Parameters:range –
std::string dolfin::StringParameter::str() const

Return short string description.

std::string dolfin::StringParameter::type_str() const

Return value type string.

std::string dolfin::StringParameter::value_str() const

Return value string.

dolfin::StringParameter::~StringParameter()

Destructor.