Gromacs  5.1.2
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Classes | Typedefs | Enumerations | Functions | Variables | Directories | Files
Extensible Handling of Options (options)
+ Collaboration diagram for Extensible Handling of Options (options):

Description

Provides functionality for handling options.

Basic Use

Basic interface for providing options is implemented by the Options class and classes defined in basicoptions.h for specifying individual options. Only these are needed if a class wants to provide a set of standard options. When creating an Options object and adding options, it is possible to add descriptions for individual options as well as for the whole set of options. These can then be used to write out help text.

The sequence charts below provides an overview of how the options work from usage perspective. They include two fictional modules, A and B, that provide options, and a main routine that manages these. The first chart shows a typical initialization sequence, where the main routine creates an options object, and calls an initOptions() method in each module that can provide options (the modules may also request their submodules to add their own options). Each module uses gmx::Options::addOption() to add the options they require, and specify output variables into which the options values are stored.

msc_inline_mscgraph_1

After all options have been specified, they can be parsed. A parser splits the input into option-value pairs (one option may have multiple values), and passes these into the gmx::Options object, which is responsible for converting them into the appropriate types and storing the values into the variables provided in the calls to gmx::Options::addOption().

msc_inline_mscgraph_2

After all options have been parsed (possibly using multiple different parsers), gmx::Options::finish() is called. This performs final validation of the options and may further adjust the values stored in the output variables (see documentation on individual option types on when this may happen).

msc_inline_mscgraph_3

Module Command Line Program Management (commandline) implements classes that assign option values from command line and produce help for programs that use the command line parser.

Advanced Use (in library API)

It is possible to extend the module with new option types and/or parsers for option values.

To implement new option types, it is necessary to subclass the templates OptionTemplate and OptionStorageTemplate with the type of the values that the option should provide as the template argument. After this is done, it is possible to add options of this new type using Options::addOption().

To implement new parsers, one can use OptionsAssigner, which provides an interface to set values in an Options object.

There is also an interface to iterate over all options in an Options object. One should implement the OptionsVisitor interface, and then use OptionsIterator to apply this visitor to the Options object.

Author
Teemu Murtola teemu.nosp@m..mur.nosp@m.tola@.nosp@m.gmai.nosp@m.l.com

Classes

class  gmx::AbstractOption
 Abstract base class for specifying option properties. More...
 
class  gmx::OptionTemplate< T, U >
 Templated base class for constructing concrete option settings classes. More...
 
class  gmx::OptionInfo
 Gives information and allows modifications to an option after creation. More...
 
class  gmx::AbstractOptionStorage
 Abstract base class for converting, validating, and storing option values. More...
 
class  gmx::BooleanOption
 Specifies an option that provides boolean values. More...
 
class  gmx::IntegerOption
 Specifies an option that provides integer values. More...
 
class  gmx::Int64Option
 Specifies an option that provides 64-bit integer values. More...
 
class  gmx::DoubleOption
 Specifies an option that provides floating-point (double) values. More...
 
class  gmx::FloatOption
 Specifies an option that provides floating-point (float) values. More...
 
class  gmx::StringOption
 Specifies an option that provides string values. More...
 
class  gmx::BooleanOptionInfo
 Wrapper class for accessing boolean option information. More...
 
class  gmx::IntegerOptionInfo
 Wrapper class for accessing integer option information. More...
 
class  gmx::Int64OptionInfo
 Wrapper class for accessing 64-bit integer option information. More...
 
class  gmx::DoubleOptionInfo
 Wrapper class for accessing floating-point option information. More...
 
class  gmx::FloatOptionInfo
 Wrapper class for accessing floating-point option information. More...
 
class  gmx::StringOptionInfo
 Wrapper class for accessing string option information. More...
 
class  gmx::BooleanOptionStorage
 Converts, validates, and stores boolean values. More...
 
class  gmx::IntegerOptionStorage
 Converts, validates, and stores integer values. More...
 
class  gmx::Int64OptionStorage
 Converts, validates, and stores integer values. More...
 
class  gmx::DoubleOptionStorage
 Converts, validates, and stores floating-point (double) values. More...
 
class  gmx::FloatOptionStorage
 Converts, validates, and stores floating-point (float) values. More...
 
class  gmx::StringOptionStorage
 Converts, validates, and stores string values. More...
 
struct  gmx::anonymous_namespace{filenameoption.cpp}::FileTypeMapping
 Mapping from OptionFileType to a file type in filenm.h. More...
 
class  gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler
 Handles a single file type known to FileNameOptionStorage. More...
 
class  gmx::FileNameOption
 Specifies an option that provides file names. More...
 
class  gmx::FileNameOptionInfo
 Wrapper class for accessing file name option information. More...
 
class  gmx::FileNameOptionManager::Impl
 Private implemention class for FileNameOptionManager. More...
 
class  gmx::OptionManagerContainer
 Container to keep managers added with Options::addManager() and pass them to options. More...
 
class  gmx::OptionManagerInterface
 Base class for option managers. More...
 
class  gmx::Options
 Collection of options. More...
 
class  gmx::OptionsAssigner
 Decorator class for assigning values to Options. More...
 
class  gmx::OptionStorageTemplate< T >
 Templated base class for constructing option value storage classes. More...
 
class  gmx::OptionsVisitor
 Pure interface for visiting options in a Options object. More...
 
class  gmx::OptionsTypeVisitor< InfoType >
 Abstract base class for visiting options of a particular type. More...
 
class  gmx::OptionsIterator
 Decorator class for visiting options in a Options object. More...
 
class  gmx::OptionsModifyingVisitor
 Pure interface for visiting options in a Options object, allowing modifications. More...
 
class  gmx::OptionsModifyingTypeVisitor< InfoType >
 Abstract base class for visiting options of a particular type, allowing modifications. More...
 
class  gmx::OptionsModifyingIterator
 Decorator class for visiting options in a Options object, allowing changes. More...
 
class  anonymous_namespace{abstractoptionstorage.cpp}::MockOptionStorage
 Mock implementation of an option storage class for unit testing. More...
 
class  anonymous_namespace{abstractoptionstorage.cpp}::MockOption
 Specifies an option that has a mock storage object for unit testing. More...
 
class  gmx::anonymous_namespace{timeunitmanager.cpp}::TimeOptionScaler< FloatingPointOptionInfo >
 Option visitor that scales time options. More...
 
class  gmx::TimeUnitManager
 Provides common functionality for time unit conversions. More...
 

Typedefs

typedef FloatOption gmx::RealOption
 Typedef for either DoubleOption or FloatOption, depending on precision. More...
 
typedef FloatOptionInfo gmx::RealOptionInfo
 Typedef for either DoubleOptionInfo or FloatOptionInfo, depending on precision. More...
 

Enumerations

enum  gmx::OptionFileType {
  eftUnknown, eftTopology, eftTrajectory, eftPDB,
  eftIndex, eftPlot, eftGenericData, eftOptionFileType_NR
}
 Purpose of file(s) provided through an option.
 

Functions

 gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler::FileTypeHandler (int fileType)
 Returns a handler for a single file type. More...
 
int gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler::extensionCount () const
 Returns the number of acceptable extensions for this file type.
 
const char * gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler::extension (int i) const
 Returns the extension with the given index.
 
bool gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler::isValidType (int fileType) const
 Returns whether fileType (from filenm.h) is accepted for this type.
 

Variables

const FileTypeMapping gmx::anonymous_namespace{filenameoption.cpp}::c_fileTypeMapping []
 Mappings from OptionFileType to file types in filenm.h. More...
 

Directories

directory options
 Extensible Handling of Options (options)
 
directory tests
 Unit tests for Extensible Handling of Options (options).
 

Files

file  abstractoption.cpp
 Implements classes in abstractoption.h and abstractoptionstorage.h.
 
file  abstractoption.h
 Defines gmx::AbstractOption, gmx::OptionTemplate and gmx::OptionInfo.
 
file  abstractoptionstorage.h
 Declares gmx::AbstractOptionStorage.
 
file  basicoptions.cpp
 Implements classes in basicoptions.h and basicoptionstorage.h.
 
file  basicoptions.h
 Declares option objects for basic option types.
 
file  basicoptionstorage.h
 Declares storage classes for basic option types.
 
file  filenameoption.cpp
 Implements classes in filenameoption.h and filenameoptionstorage.h.
 
file  filenameoption.h
 Declares gmx::FileNameOption and gmx::FileNameOptionInfo.
 
file  filenameoptionmanager.cpp
 Implements gmx::FileNameOptionManager.
 
file  filenameoptionmanager.h
 Declares gmx::FileNameOptionManager.
 
file  filenameoptionstorage.h
 Declares gmx::FileNameOptionStorage.
 
file  optionfiletype.h
 Defines an enumeration type for specifying file types for options.
 
file  optionflags.h
 Defines flags used in option implementation.
 
file  optionmanagercontainer.h
 Declares gmx::OptionManagerContainer.
 
file  options-impl.h
 Declares private implementation class for gmx::Options.
 
file  options.cpp
 Implements gmx::Options.
 
file  options.h
 Declares gmx::Options.
 
file  optionsassigner.cpp
 Implements gmx::OptionsAssigner.
 
file  optionsassigner.h
 Declares gmx::OptionsAssigner.
 
file  optionstoragetemplate.h
 Defines gmx::OptionStorageTemplate template.
 
file  optionsvisitor.cpp
 Implements classes in optionsvisitor.h.
 
file  optionsvisitor.h
 Declares gmx::OptionsVisitor interface and supporting classes.
 
file  abstractoptionstorage.cpp
 Tests proper handling of option storage.
 
file  filenameoption.cpp
 Tests basic file name option implementation.
 
file  filenameoptionmanager.cpp
 Tests file name option implementation dependent on gmx::FileNameOptionManager.
 
file  option.cpp
 Tests creation of basic option types.
 
file  optionsassigner.cpp
 Tests option assignment.
 
file  timeunitmanager.cpp
 Tests handling of time units with gmx::TimeUnitManager.
 
file  timeunitmanager.cpp
 Implements gmx::TimeUnitManager.
 
file  timeunitmanager.h
 Declares gmx::TimeUnitManager.
 
file  options.h
 Public API convenience header for handling of options.
 

Typedef Documentation

Typedef for either DoubleOption or FloatOption, depending on precision.

Generally, new would be better using DoubleOption, but this is provided for cases where the output value needs to be of type real for some reason.

Typedef for either DoubleOptionInfo or FloatOptionInfo, depending on precision.

Generally, new would be better using DoubleOption, but this is provided for cases where the output value needs to be of type real for some reason.

Function Documentation

gmx::anonymous_namespace{filenameoption.cpp}::FileTypeHandler::FileTypeHandler ( int  fileType)
explicit

Returns a handler for a single file type.

Parameters
[in]fileTypeFile type (from filenm.h) to use.

Variable Documentation

const FileTypeMapping gmx::anonymous_namespace{filenameoption.cpp}::c_fileTypeMapping[]
Initial value:
=
{
{ eftTopology, efTPS },
{ eftTrajectory, efTRX },
{ eftPDB, efPDB },
{ eftIndex, efNDX },
{ eftPlot, efXVG },
{ eftGenericData, efDAT }
}

Mappings from OptionFileType to file types in filenm.h.