Interface for primarily Iterative Solvers that can execute on GPU and be coupled to AGX solvers. More...

#include <SolverInterface.h>

Inheritance diagram for agxGPU::SolverInterface:

Public Types
enum	SolverBackends : int { AUTOMATIC = 0 , CUDA = 1 }

enum	SolverKernel : int { NONE = 0 , PREPARE_SOLVER , STORE_CONTACT_FORCES , ITERATIVE_SOLVE , HYBRID_IMPACT_STAGE , HYBRID_ITERATIVE_SOLVE , HYBRID_DRY_FRICTION }

Public Types inherited from agx::Component
typedef Event2< Component , Object >	ObjectEvent
	Event when adding removing child objects.

typedef Callback1< Object * >	TraverseCallback

Public Types inherited from agx::Object
typedef agx::observer_ptr< const Event >	EventConstObserver

typedef agx::ref_ptr< const Event >	EventConstRef

typedef agx::observer_ptr< Event >	EventObserver

typedef agx::Vector< EventObserver >	EventObserverVector

typedef agx::VectorPOD< Event * >	EventPtrVector

typedef agx::ref_ptr< Event >	EventRef

typedef agx::Vector< EventRef >	EventRefVector

Public Member Functions
virtual agx::Task *	getCopyToGpuTask ()
	Optional staging task that can prepare and copy some data to GPU before the Solver should run.

int	getDeviceIndex () const
	Get index of backend GPU device.

virtual agx::SolveKernel *	getSolveKernel (int kernel)=0
	Request kernel for a solve stage.

int	getSolverBackendType () const
	Get backend type for solver.

virtual bool	isSupported () const =0
	Query if solver can execute on current hardware.

Public Member Functions inherited from agx::Component
	Component (const agx::Name &name=agx::Name(), agx::Model model=agx::Component::ClassModel(), agx::Device device=nullptr)

virtual void	addObject (agx::Object *object, bool assignContext=true)
	Add an object to the component.

virtual String	autoComplete (const String &partialName, StringVector &matchingNames) const

virtual void	buildNavigationTree (agxJson::Value &eNode) const override

void	configure (Model *model)

virtual void	configure (TiXmlElement *eComponent) override

agx::Device *	getDevice ()

template<typename T >
T *	getDevice ()

const agx::Device *	getDevice () const

template<typename T >
const T *	getDevice () const

size_t	getNumObjects (const agx::Name &name) const

agx::Object *	getObject (const agx::Name &name, agx::Model *model, size_t index=0)

const agx::Object *	getObject (const agx::Name &name, agx::Model *model, size_t index=0) const

agx::Object *	getObject (const agx::Name &name, size_t index=0)

template<typename T >
T *	getObject (const agx::Name &name, size_t index=0)

const agx::Object *	getObject (const agx::Name &name, size_t index=0) const

template<typename T >
const T *	getObject (const agx::Name &name, size_t index=0) const

const agx::ObjectRefVector &	getObjects () const

template<typename T >
void	getObjects (agx::ObjectPtrVector &result, bool recursive=false) const
	Returns All child objects of a specified type in the result container.

void	getObjects (agx::ObjectPtrVector &result, const agx::Model *model, bool recursive=false) const

virtual Object *	getResourceImpl (const Path &path, agx::Model *model) override

virtual void	printSubtree () const override

void	printSubtree (std::ostream &stream, int depth=0) const

virtual void	rebind () override

void	removeAllObjects ()
	Remove all components.

virtual void	removeObject (agx::Object *object)
	Remove an object from the component.

void	removeObject (const agx::Name &name, size_t index=0)
	Remove an object with a specified name (and optional index) from the component.

virtual void	snapshot (TiXmlNode *eParent, const String &directory) const override

void	traverse (ComponentVisitor *)

void	traverse (const TraverseCallback &callback)

Public Member Functions inherited from agx::Object
	Object (const Name &name=Name(), Model *model=Object::ClassModel())

void	addListener (EventListener *listener)

virtual void	buildNavigationTree (agxJson::Value &eNode) const

virtual void	configure (TiXmlElement *)

agx::String	fullName () const

agx::String	fullPath () const

agx::String	fullPath (const agx::Object *root) const

template<typename T >
T *	getAutoScopedResource (const agx::Path &path)

template<typename T >
const T *	getAutoScopedResource (const agx::Path &path) const

agx::Object *	getAutoScopedResource (const agx::Path &path, agx::Model *model=nullptr)

const agx::Object *	getAutoScopedResource (const agx::Path &path, agx::Model *model=nullptr) const

agx::Object *	getContext ()

template<typename T >
T *	getContext ()

const agx::Object *	getContext () const

template<typename T >
const T *	getContext () const

agx::UInt32	getId () const

const agx::Name &	getImplementationName () const

agx::Model *	getModel ()

const agx::Model *	getModel () const

const agx::Name &	getName () const

agx::Object *	getNextSibling ()

const agx::Object *	getNextSibling () const

agx::Path	getPath () const

agx::Path	getPath (const agx::Object *root) const

template<typename T >
T *	getResource (const agx::Path &path)

template<typename T >
const T *	getResource (const agx::Path &path) const

agx::Object *	getResource (const agx::Path &path, agx::Model *model=nullptr)

const agx::Object *	getResource (const agx::Path &path, agx::Model *model=nullptr) const

virtual agx::Object *	getResourceImpl (const agx::Path &path, agx::Model *model)

agx::Object *	getRootContext ()

const agx::Object *	getRootContext () const

bool	hasListener (EventListener *listener)

bool	hasParent (const agx::Object *node) const

bool	isUnique () const

virtual void	printSubtree () const

virtual void	rebind ()

void	removeListener (EventListener *listener)

virtual void	save (TiXmlElement *) const

virtual void	setContext (agx::Object *context)

void	setId (UInt32 id)

void	setModel (agx::Model *model)
	Set the object model (handled automatically).

void	setName (const agx::Name &name)
	Set the name of the object.

virtual void	snapshot (TiXmlNode *, const String &) const

Public Member Functions inherited from agx::Referenced
	Referenced ()
	Default constructor.

	Referenced (const Referenced &)

template<typename T >
T *	as ()
	Subclass casting.

template<typename T >
const T *	as () const

template<typename T >
T *	asSafe ()
	Safe subclass casting, return nullptr if template type does not match.

template<typename T >
const T *	asSafe () const

int	getReferenceCount () const

template<typename T >
bool	is () const
	Subclass test.

Referenced &	operator= (const Referenced &)
	Assignment operator. Will increment the number of references to the referenced object.

void	reference (void *ptr=nullptr) const
	Explicitly increment the reference count by one, indicating that this object has another pointer which is referencing it.

void	unreference (void *ptr=nullptr) const
	Decrement the reference count by one, indicating that a pointer to this object is referencing it.

void	unreference_nodelete () const
	Decrement the reference count by one, indicating that a pointer to this object is referencing it.

Static Public Member Functions
static SolverInterface *	loadSolver (int backend, int device)
	Try to dynamically load a GPU backend.

static void	releaseSolver (SolverInterface *solver)
	Pass solver back to its originating backend library where it can be freed if reference counting allows for it.

Static Public Member Functions inherited from agx::Component
static Component *	_load (TiXmlElement eComponent, Device device)

static agx::Model *	ClassModel ()

static Component *	load (const Path &path, const Name &implementation, Device *device, const Path &_namespace=Path())

static Component *	load (const String &path, const Path &_namespace=Path())

static Component *	load (const String &path, Device *device, const Path &_namespace=Path())

static Component *	load (TiXmlElement eComponent, Device device)

Static Public Member Functions inherited from agx::Object
static agx::Model *	ClassModel ()

static agx::String	generateName (const agx::String &bindPath)

static const HashSet< Object * > &	getActiveObjects ()

static bool	getEnableRebind ()
	Should rebinding be allowed? Right now a global setting.

static Object *	load (const String &path, Device *device, const String &type, const String &attribute, const String &value)

template<typename T >
static T *	load (const String &path, Device *device, const String &type, const String &attribute, const String &value)

static Object *	load (const String &path, Device *device, const String &type="", size_t instance=0)

template<typename T >
static T *	load (const String &path, Device *device, const String &type="", size_t instance=0)

static void	load (const String &path, Device *device, ObjectPtrVector &loadedObjects)

static Object *	load (TiXmlElement eObject, Device device)

template<typename T >
static T *	load (TiXmlElement eObject, Device device)

static TiXmlDocument	openDocument (const String &path)

static void	setEnableRebind (bool flag)
	Sets if rebinding of objects should be allowed (Right now a global setting).

Static Public Member Functions inherited from agx::Referenced
template<typename T >
static bool	ValidateCast (const Referenced *object)

Additional Inherited Members
Public Attributes inherited from agx::Component
ObjectEvent	addObjectEvent

ObjectEvent	removeObjectEvent

Protected Member Functions inherited from agx::Component
virtual	~Component ()

String	expandAutoCompletionMatch (const String &query, const StringVector &matchingNames) const

void	setDevice (Device *device)

Protected Member Functions inherited from agx::Object
virtual	~Object ()

Protected Member Functions inherited from agx::Referenced
virtual	~Referenced ()
	Destructor.

void	allocateObserverVector () const

void	deleteUsingDeleteHandler () const

Static Protected Member Functions inherited from agx::Referenced
static DeleteHandler *	getDeleteHandler ()

static void	setDeleteHandler (DeleteHandler *handler)
	Internal: Set a DeleteHandler to which deletion of all referenced counted objects will be delegated to.

Protected Attributes inherited from agx::Referenced
Mutex	m_mutex

ObserverContainer	m_observers

AtomicValue	m_refCount

Detailed Description

Interface for primarily Iterative Solvers that can execute on GPU and be coupled to AGX solvers.

Definition at line 31 of file SolverInterface.h.

Member Enumeration Documentation

◆ SolverBackends

enum agxGPU::SolverInterface::SolverBackends : int

Enumerator
AUTOMATIC
CUDA

Definition at line 35 of file SolverInterface.h.

◆ SolverKernel

enum agxGPU::SolverInterface::SolverKernel : int

Enumerator
NONE
PREPARE_SOLVER
STORE_CONTACT_FORCES
ITERATIVE_SOLVE
HYBRID_IMPACT_STAGE
HYBRID_ITERATIVE_SOLVE
HYBRID_DRY_FRICTION

Definition at line 40 of file SolverInterface.h.

Member Function Documentation

◆ getCopyToGpuTask()

virtual agx::Task * agxGPU::SolverInterface::getCopyToGpuTask ( )

virtual

Optional staging task that can prepare and copy some data to GPU before the Solver should run.

◆ getDeviceIndex()

int agxGPU::SolverInterface::getDeviceIndex ( ) const

Get index of backend GPU device.

◆ getSolveKernel()

virtual agx::SolveKernel * agxGPU::SolverInterface::getSolveKernel ( int kernel )

pure virtual

Request kernel for a solve stage.

◆ getSolverBackendType()

int agxGPU::SolverInterface::getSolverBackendType ( ) const

Get backend type for solver.

◆ isSupported()

virtual bool agxGPU::SolverInterface::isSupported ( ) const

pure virtual

Query if solver can execute on current hardware.

Being able to load a backend implies all required libraries are in place, but does not indicate if hardware support is also available.

◆ loadSolver()

static SolverInterface * agxGPU::SolverInterface::loadSolver	(	int	backend,
		int	device
	)

static

Try to dynamically load a GPU backend.

Parameters

backend	Selection of backend to use. See SolverBackends.
device	Device number, often 0 unless specific card in multi device setup.

Returns: A valid pointer if a backend could be loaded, else nullptr

◆ releaseSolver()

static void agxGPU::SolverInterface::releaseSolver ( SolverInterface * solver )

static

Pass solver back to its originating backend library where it can be freed if reference counting allows for it.

The main reason for this function is to avoid potential cross-boundary shared library problems.

The documentation for this class was generated from the following file:

SolverInterface.h

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members