A Platform defines an implementation of all the kernels needed to perform some calculation. More...
Inherits simtk::openmm::openmm::_object.
Public Member Functions | |
| def | __init__ |
| def | __del__ |
| __del__(self) | |
| def | registerPlatform |
| registerPlatform(Platform platform) | |
| def | getNumPlatforms |
| getNumPlatforms() -> int | |
| def | getPlatform |
| getPlatform(int index) -> Platform | |
| def | getPlatformByName |
| getPlatformByName(string name) -> Platform | |
| def | findPlatform |
| findPlatform(vectorstring kernelNames) -> Platform | |
| def | loadPluginLibrary |
| loadPluginLibrary(string file) | |
| def | loadPluginsFromDirectory |
| loadPluginsFromDirectory(string directory) -> vectorstring | |
| def | getDefaultPluginsDirectory |
| getDefaultPluginsDirectory() -> string | |
| def | getOpenMMVersion |
| getOpenMMVersion() -> string | |
| def | getName |
| getName(self) -> string | |
| def | getSpeed |
| getSpeed(self) -> double | |
| def | supportsDoublePrecision |
| supportsDoublePrecision(self) -> bool | |
| def | getPropertyNames |
| getPropertyNames(self) -> vectorstring | |
| def | getPropertyValue |
| getPropertyValue(self, Context context, string property) -> string | |
| def | setPropertyValue |
| setPropertyValue(self, Context context, string property, string value) | |
| def | getPropertyDefaultValue |
| getPropertyDefaultValue(self, string property) -> string | |
| def | setPropertyDefaultValue |
| setPropertyDefaultValue(self, string property, string value) | |
| def | supportsKernels |
| supportsKernels(self, vectorstring kernelNames) -> bool | |
A Platform defines an implementation of all the kernels needed to perform some calculation.
More precisely, a Platform object acts as a registry for a set of KernelFactory objects which together implement the kernels. The Platform class, in turn, provides a static registry of all available Platform objects.
To get a Platform object, call
Platform& platform Platform.findPlatform(kernelNames);
passing in the names of all kernels that will be required for the calculation you plan to perform. It will return the fastest available Platform which provides implementations of all the specified kernels. You can then call createKernel() to construct particular kernels as needed.
| def __del__ | ( | self | ) |
__del__(self)
| def __init__ | ( | self, | ||
| args, | ||||
| kwargs | ||||
| ) |
| def findPlatform | ( | args | ) |
| def getDefaultPluginsDirectory | ( | ) |
getDefaultPluginsDirectory() -> string
Get the default directory from which to load plugins. If the environment variable OPENMM_PLUGIN_DIR is set, this returns its value. Otherwise, it returns a platform specific default location.
| def getName | ( | self | ) |
getName(self) -> string
Get the name of this platform. This should be a unique identifier which can be used to recognized it.
| def getNumPlatforms | ( | ) |
getNumPlatforms() -> int
Get the number of Platforms that have been registered.
| def getOpenMMVersion | ( | ) |
getOpenMMVersion() -> string
Get a string containing the version number of the OpenMM library.
| def getPlatformByName | ( | args | ) |
| def getPropertyDefaultValue | ( | self, | ||
| args | ||||
| ) |
getPropertyDefaultValue(self, string property) -> string
Get the default value of a Platform-specific property. This is the value that will be used for newly created Contexts.
| property | the name of the property to get |
| def getPropertyNames | ( | self | ) |
getPropertyNames(self) -> vectorstring
Get the names of all Platform-specific properties this Platform supports.
| def getPropertyValue | ( | self, | ||
| args | ||||
| ) |
| def getSpeed | ( | self | ) |
getSpeed(self) -> double
Get an estimate of how fast this Platform class is. This need not be precise. It only is expected to return an order or magnitude estimate of the relative performance of different Platform classes. An unoptimized reference implementation should return 1.0, and all other Platforms should return a larger value that is an estimate of how many times faster they are than the reference implementation.
| def loadPluginLibrary | ( | args | ) |
loadPluginLibrary(string file)
Load a dynamic library (DLL) which contains an OpenMM plugin. Typically, each Platform is distributed as a separate dynamic library. This method can then be called at runtime to load each available library. Each library should contain an initializer function to register any Platforms and KernelFactories that it contains.
If the file does not exist or cannot be loaded, an exception is thrown.
| file | the path to the dynamic library file. This is interpreted using the operating system's rules for loading libraries. Typically it may be either an absolute path or relative to a set of standard locations. |
| def loadPluginsFromDirectory | ( | args | ) |
loadPluginsFromDirectory(string directory) -> vectorstring
Load multiple dynamic libraries (DLLs) which contain OpenMM plugins from a single directory. This method loops over every file contained in the specified directory and calls loadPluginLibrary() for each one. If an error occurs while trying to load a particular file, that file is simply ignored.
| directory | the path to the directory containing libraries to load |
| def registerPlatform | ( | args | ) |
registerPlatform(Platform platform)
Register a new Platform.
| def setPropertyDefaultValue | ( | self, | ||
| args | ||||
| ) |
setPropertyDefaultValue(self, string property, string value)
Set the default value of a Platform-specific property. This is the value that will be used for newly created Contexts.
| property | the name of the property to set | |
| value | the value to set for the property |
| def setPropertyValue | ( | self, | ||
| args | ||||
| ) |
| def supportsDoublePrecision | ( | self | ) |
supportsDoublePrecision(self) -> bool
Get whether this Platform supports double precision arithmetic. If this returns false, the platform is permitted to represent double precision values internally as single precision.
| def supportsKernels | ( | self, | ||
| args | ||||
| ) |
supportsKernels(self, vectorstring kernelNames) -> bool
Determine whether this Platforms provides implementations of a set of kernels.
| kernelNames | the names of the kernels of interests |
1.6.2