legate::mapping::InstanceMappingPolicy#

class InstanceMappingPolicy#

A descriptor for instance mapping policy.

Public Functions

inline InstanceMappingPolicy &with_target(StoreTarget target) &#

Changes the store target.

Parameters:: target – A new store target
Returns:: This instance mapping policy

inline InstanceMappingPolicy &with_allocation_policy( AllocPolicy allocation ) &#

Changes the allocation policy.

Parameters:: allocation – A new allocation policy
Returns:: This instance mapping policy

inline InstanceMappingPolicy &with_instance_layout( InstLayout layout ) &#

Changes the instance layout.

Parameters:: layout – A new instance layout
Returns:: This instance mapping policy

inline InstanceMappingPolicy &with_ordering(DimOrdering ordering) &#

Changes the dimension ordering.

Parameters:: ordering – A new dimension ordering
Returns:: This instance mapping policy

inline InstanceMappingPolicy &with_exact(bool exact) &#

Changes the value of exact

Parameters:: exact – A new value for the exact field
Returns:: This instance mapping policy

inline InstanceMappingPolicy &with_redundant(bool redundant) &#

Changes the value of redundant

Parameters:: redundant – A new value for the redundant field
Returns:: This instance mapping policy

inline void set_target(StoreTarget target)#

Changes the store target.

Parameters:: target – A new store target

inline void set_allocation_policy(AllocPolicy allocation)#

Changes the allocation policy.

Parameters:: allocation – A new allocation policy

inline void set_instance_layout(InstLayout layout)#

Changes the instance layout.

Parameters:: layout – A new instance layout

inline void set_ordering(DimOrdering ordering)#

Changes the dimension ordering.

Parameters:: ordering – A new dimension ordering

inline void set_exact(bool exact)#

Changes the value of exact

Parameters:: exact – A new value for the exact field

inline void set_redundant(bool redundant)#

Changes the value of redundant

Parameters:: redundant – A new value for the redundant field

Public Members

StoreTarget target = {StoreTarget::SYSMEM}#: Target memory type for the instance.

AllocPolicy allocation = {AllocPolicy::MAY_ALLOC}#: Allocation policy.

InstLayout layout = {InstLayout::SOA}#: Instance layout for the instance.

DimOrdering ordering = {}#: Dimension ordering for the instance. C order by default.

bool exact = {false}#: If true, the instance must be tight to the store(s); i.e., the instance must not have any extra elements not included in the store(s).

bool redundant = {false}#

If true, the runtime treats the instance as a redundant copy and marks it as collectible as soon as the consumer task is done using it. In case where the program makes access to a store through several different partitions, setting this flag will help reduce the memory footprint by allowing the runtime to collect redundant instances eagerly.

This flag has no effect when the instance is not freshly created for the task or is used for updates.