mpi4py.MPI.Win

class mpi4py.MPI.Win

Bases: object

Remote memory access context.

static __new__(cls, win=None)

Parameters:

win (Win | None) –

Return type:

Win

Methods Summary

Accumulate(origin, target_rank[, target, op])	Accumulate data into the target process.
Allocate(size[, disp_unit, info, comm])	Create an window object for one-sided communication.
Allocate_shared(size[, disp_unit, info, comm])	Create an window object for one-sided communication.
Attach(memory)	Attach a local memory region.
Call_errhandler(errorcode)	Call the error handler installed on a window.
Compare_and_swap(origin, compare, result, ...)	Perform one-sided atomic compare-and-swap.
Complete()	Complete an RMA operation begun after an Start.
Create(memory[, disp_unit, info, comm])	Create an window object for one-sided communication.
Create_dynamic([info, comm])	Create an window object for one-sided communication.
Create_errhandler(errhandler_fn)	Create a new error handler for windows.
Create_keyval([copy_fn, delete_fn, nopython])	Create a new attribute key for windows.
Delete_attr(keyval)	Delete attribute value associated with a key.
Detach(memory)	Detach a local memory region.
Fence([assertion])	Perform an MPI fence synchronization on a window.
Fetch_and_op(origin, result, target_rank[, ...])	Perform one-sided read-modify-write.
Flush(rank)	Complete all outstanding RMA operations at a target.
Flush_all()	Complete all outstanding RMA operations at all targets.
Flush_local(rank)	Complete locally all outstanding RMA operations at a target.
Flush_local_all()	Complete locally all outstanding RMA operations at all targets.
Free()	Free a window.
Free_keyval(keyval)	Free an attribute key for windows.
Get(origin, target_rank[, target])	Get data from a memory window on a remote process.
Get_accumulate(origin, result, target_rank)	Fetch-and-accumulate data into the target process.
Get_attr(keyval)	Retrieve attribute value by key.
Get_errhandler()	Get the error handler for a window.
Get_group()	Access the group of processes that created the window.
Get_info()	Return the current hints for a window.
Get_name()	Get the print name for this window.
Lock(rank[, lock_type, assertion])	Begin an RMA access epoch at the target process.
Lock_all([assertion])	Begin an RMA access epoch at all processes.
Post(group[, assertion])	Start an RMA exposure epoch.
Put(origin, target_rank[, target])	Put data into a memory window on a remote process.
Raccumulate(origin, target_rank[, target, op])	Fetch-and-accumulate data into the target process.
Rget(origin, target_rank[, target])	Get data from a memory window on a remote process.
Rget_accumulate(origin, result, target_rank)	Accumulate data into the target process using remote memory access.
Rput(origin, target_rank[, target])	Put data into a memory window on a remote process.
Set_attr(keyval, attrval)	Store attribute value associated with a key.
Set_errhandler(errhandler)	Set the error handler for a window.
Set_info(info)	Set new values for the hints associated with a window.
Set_name(name)	Set the print name for this window.
Shared_query(rank)	Query the process-local address for remote memory segments.
Start(group[, assertion])	Start an RMA access epoch for MPI.
Sync()	Synchronize public and private copies of the window.
Test()	Test whether an RMA exposure epoch has completed.
Unlock(rank)	Complete an RMA access epoch at the target process.
Unlock_all()	Complete an RMA access epoch at all processes.
Wait()	Complete an RMA exposure epoch begun with Post.
f2py(arg)
fromhandle(handle)	Create object from MPI handle.
py2f()
tomemory()	Return window memory buffer.

Attributes Summary

attrs	Attributes.
flavor	Create flavor.
group	Group.
handle	MPI handle.
info	Info hints.
model	Memory model.
name	Print name.

Methods Documentation

Accumulate(origin, target_rank, target=None, op=SUM)

Accumulate data into the target process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

• op (Op) –

Return type:

None

classmethod Allocate(size, disp_unit=1, info=INFO_NULL, comm=COMM_SELF)

Create an window object for one-sided communication.

Parameters:

• size (int) –

• disp_unit (int) –

• info (Info) –

• comm (Intracomm) –

Return type:

Self

classmethod Allocate_shared(size, disp_unit=1, info=INFO_NULL, comm=COMM_SELF)

Create an window object for one-sided communication.

Parameters:

• size (int) –

• disp_unit (int) –

• info (Info) –

• comm (Intracomm) –

Return type:

Self

Attach(memory)

Attach a local memory region.

Parameters:

memory (Buffer) –

Return type:

None

Call_errhandler(errorcode)

Call the error handler installed on a window.

Parameters:

errorcode (int) –

Return type:

None

Compare_and_swap(origin, compare, result, target_rank, target_disp=0)

Perform one-sided atomic compare-and-swap.

Parameters:

• origin (BufSpec) –

• compare (BufSpec) –

• result (BufSpec) –

• target_rank (int) –

• target_disp (int) –

Return type:

None

Complete()

Complete an RMA operation begun after an Start.

Return type:

None

classmethod Create(memory, disp_unit=1, info=INFO_NULL, comm=COMM_SELF)

Create an window object for one-sided communication.

Parameters:

• memory (Buffer | Bottom) –

• disp_unit (int) –

• info (Info) –

• comm (Intracomm) –

Return type:

Self

classmethod Create_dynamic(info=INFO_NULL, comm=COMM_SELF)

Create an window object for one-sided communication.

Parameters:

• info (Info) –

• comm (Intracomm) –

Return type:

Self

classmethod Create_errhandler(errhandler_fn)

Create a new error handler for windows.

Parameters:

errhandler_fn (Callable[[Win, int], None]) –

Return type:

Errhandler

classmethod Create_keyval(copy_fn=None, delete_fn=None, nopython=False)

Create a new attribute key for windows.

Parameters:

• copy_fn (Callable[[Win, int, Any], Any] | None) –

• delete_fn (Callable[[Win, int, Any], None] | None) –

• nopython (bool) –

Return type:

int

Delete_attr(keyval)

Delete attribute value associated with a key.

Parameters:

keyval (int) –

Return type:

None

Detach(memory)

Detach a local memory region.

Parameters:

memory (Buffer) –

Return type:

None

Fence(assertion=0)

Perform an MPI fence synchronization on a window.

Parameters:

assertion (int) –

Return type:

None

Fetch_and_op(origin, result, target_rank, target_disp=0, op=SUM)

Perform one-sided read-modify-write.

Parameters:

• origin (BufSpec) –

• result (BufSpec) –

• target_rank (int) –

• target_disp (int) –

• op (Op) –

Return type:

None

Flush(rank)

Complete all outstanding RMA operations at a target.

Parameters:

rank (int) –

Return type:

None

Flush_all()

Complete all outstanding RMA operations at all targets.

Return type:

None

Flush_local(rank)

Complete locally all outstanding RMA operations at a target.

Parameters:

rank (int) –

Return type:

None

Flush_local_all()

Complete locally all outstanding RMA operations at all targets.

Return type:

None

Free()

Free a window.

Return type:

None

classmethod Free_keyval(keyval)

Free an attribute key for windows.

Parameters:

keyval (int) –

Return type:

int

Get(origin, target_rank, target=None)

Get data from a memory window on a remote process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

Return type:

None

Get_accumulate(origin, result, target_rank, target=None, op=SUM)

Fetch-and-accumulate data into the target process.

Parameters:

• origin (BufSpec) –

• result (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

• op (Op) –

Return type:

None

Get_attr(keyval)

Retrieve attribute value by key.

Parameters:

keyval (int) –

Return type:

int | Any | None

Get_errhandler()

Get the error handler for a window.

Return type:

Errhandler

Get_group()

Access the group of processes that created the window.

Return type:

Group

Get_info()

Return the current hints for a window.

Return type:

Info

Get_name()

Get the print name for this window.

Return type:

str

Lock(rank, lock_type=LOCK_EXCLUSIVE, assertion=0)

Begin an RMA access epoch at the target process.

Parameters:

• rank (int) –

• lock_type (int) –

• assertion (int) –

Return type:

None

Lock_all(assertion=0)

Begin an RMA access epoch at all processes.

Parameters:

assertion (int) –

Return type:

None

Post(group, assertion=0)

Start an RMA exposure epoch.

Parameters:

• group (Group) –

• assertion (int) –

Return type:

None

Put(origin, target_rank, target=None)

Put data into a memory window on a remote process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

Return type:

None

Raccumulate(origin, target_rank, target=None, op=SUM)

Fetch-and-accumulate data into the target process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

• op (Op) –

Return type:

Request

Rget(origin, target_rank, target=None)

Get data from a memory window on a remote process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

Return type:

Request

Rget_accumulate(origin, result, target_rank, target=None, op=SUM)

Accumulate data into the target process using remote memory access.

Parameters:

• origin (BufSpec) –

• result (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

• op (Op) –

Return type:

Request

Rput(origin, target_rank, target=None)

Put data into a memory window on a remote process.

Parameters:

• origin (BufSpec) –

• target_rank (int) –

• target (TargetSpec | None) –

Return type:

Request

Set_attr(keyval, attrval)

Store attribute value associated with a key.

Parameters:

• keyval (int) –

• attrval (Any) –

Return type:

None

Set_errhandler(errhandler)

Set the error handler for a window.

Parameters:

errhandler (Errhandler) –

Return type:

None

Set_info(info)

Set new values for the hints associated with a window.

Parameters:

info (Info) –

Return type:

None

Set_name(name)

Set the print name for this window.

Parameters:

name (str) –

Return type:

None

Shared_query(rank)

Query the process-local address for remote memory segments.

Parameters:

rank (int) –

Return type:

tuple[memory, int]

Start(group, assertion=0)

Start an RMA access epoch for MPI.

Parameters:

• group (Group) –

• assertion (int) –

Return type:

None

Sync()

Synchronize public and private copies of the window.

Return type:

None

Test()

Test whether an RMA exposure epoch has completed.

Return type:

bool

Unlock(rank)

Complete an RMA access epoch at the target process.

Parameters:

rank (int) –

Return type:

None

Unlock_all()

Complete an RMA access epoch at all processes.

Return type:

None

Wait()

Complete an RMA exposure epoch begun with Post.

Return type:

Literal[True]

classmethod f2py(arg)

Parameters:

arg (int) –

Return type:

Win

classmethod fromhandle(handle)

Create object from MPI handle.

Parameters:

handle (int) –

Return type:

Win

py2f()

Return type:

int

tomemory()

Return window memory buffer.

Return type:

memory

Attributes Documentation

attrs

Attributes.

flavor

Create flavor.

group

Group.

handle

MPI handle.

info

Info hints.

model

Memory model.

name

Print name.