1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/DMSWARM/DMSwarmMigrate.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>DMSwarmMigrate</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.10.3 2018-12-18</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.10.3 v3.10.3 docs/manualpages/DMSWARM/DMSwarmMigrate.html "><small>Report Typos and Errors</small></a></div>
<A NAME="DMSwarmMigrate"><H1>DMSwarmMigrate</H1></A>
Relocates points defined in the DMSwarm to other MPI-ranks
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscdmswarm.h"
PETSC_EXTERN <A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../DMSWARM/DMSwarmMigrate.html#DMSwarmMigrate">DMSwarmMigrate</A>(<A HREF="../DM/DM.html#DM">DM</A> dm,<A HREF="../Sys/PetscBool.html#PetscBool">PetscBool</A> remove_sent_points)
</PRE>
Collective on <A HREF="../DM/DM.html#DM">DM</A>
<P>
<H3><FONT COLOR="#CC3333">Input parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>dm </B></TD><TD>- the DMSwarm
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>remove_sent_points </B></TD><TD>- flag indicating if sent points should be removed from the current MPI-rank
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
The <A HREF="../DM/DM.html#DM">DM</A> will be modified to accomodate received points.
If remove_sent_points = <A HREF="../Sys/PETSC_TRUE.html#PETSC_TRUE">PETSC_TRUE</A>, any points that were sent will be removed from the <A HREF="../DM/DM.html#DM">DM</A>.
Different styles of migration are supported. See DMSwarmSetMigrateType().
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
DMSwarmSetMigrateType()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>advanced<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/dm/impls/swarm/swarm.c.html#DMSwarmMigrate">src/dm/impls/swarm/swarm.c</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/dm/examples/tutorials/ex20.c.html">src/dm/examples/tutorials/ex20.c.html</A><BR>
<A HREF="../../../src/dm/examples/tutorials/swarm_ex1.c.html">src/dm/examples/tutorials/swarm_ex1.c.html</A><BR>
<A HREF="../../../src/dm/examples/tutorials/swarm_ex3.c.html">src/dm/examples/tutorials/swarm_ex3.c.html</A><BR>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex70.c.html">src/ksp/ksp/examples/tutorials/ex70.c.html</A><BR>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/dm/impls/swarm/swarm.c.html#DMSwarmMigrate_Basic">DMSwarmMigrate_Basic in src/dm/impls/swarm/swarm.c</A><BR>
<A HREF="../../../src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_Push_Basic">DMSwarmMigrate_Push_Basic in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="../../../src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_DMNeighborScatter">DMSwarmMigrate_DMNeighborScatter in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="../../../src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_CellDMScatter">DMSwarmMigrate_CellDMScatter in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="../../../src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_CellDMExact">DMSwarmMigrate_CellDMExact in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="../../../src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_GlobalToLocal_Basic">DMSwarmMigrate_GlobalToLocal_Basic in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<BR><A HREF="./index.html">Index of all DMSWARM routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
</BODY></HTML>
|