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
53
54
55
56
57
58
59
60
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/IS/ISListToPair.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>ISListToPair</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.7.5 2017-01-01</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.7.5 v3.7.5 docs/manualpages/IS/ISListToPair.html "><small>Report Typos and Errors</small></a></div>
<A NAME="ISListToPair"><H1>ISListToPair</H1></A>
convert an <A HREF="../IS/IS.html#IS">IS</A> list to a pair of ISs of equal length defining an equivalent integer multimap. Each <A HREF="../IS/IS.html#IS">IS</A> on the input list is assigned an integer j so that all of the indices of that <A HREF="../IS/IS.html#IS">IS</A> are mapped to j.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscis.h"
#undef __FUNCT__
#define __FUNCT__ "ISListToPair"
PetscErrorCode ISListToPair(MPI_Comm comm, PetscInt listlen, IS islist[], IS *xis, IS *yis)
</PRE>
<P>
Collective on comm.
<P>
<H3><FONT COLOR="#CC3333">Input arguments</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>comm </B></TD><TD>- <A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A>
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>listlen </B></TD><TD>- <A HREF="../IS/IS.html#IS">IS</A> list length
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>islist </B></TD><TD>- <A HREF="../IS/IS.html#IS">IS</A> list
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output arguments</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>xis </B></TD><TD>- domain <A HREF="../IS/IS.html#IS">IS</A>
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>yis </B></TD><TD>- range <A HREF="../IS/IS.html#IS">IS</A>
</TD></TR></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
The global integers assigned to the ISs of the local input list might not correspond to the
local numbers of the ISs on that list, but the two *orderings* are the same: the global
integers assigned to the ISs on the local list form a strictly increasing sequence.
<P>
The ISs on the input list can belong to subcommunicators of comm, and the subcommunicators
on the input <A HREF="../IS/IS.html#IS">IS</A> list are assumed to be in a "deadlock-free" order.
<P>
Local lists of PetscObjects (or their subcommes) on a comm are "deadlock-free" if subcomm1
preceeds subcomm2 on any local list, then it preceeds subcomm2 on all ranks.
Equivalently, the local numbers of the subcomms on each local list are drawn from some global
numbering. This is ensured, for example, by <A HREF="../IS/ISPairToList.html#ISPairToList">ISPairToList</A>().
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../IS/ISPairToList.html#ISPairToList">ISPairToList</A>()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>advanced
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/vec/is/is/utils/isdiff.c.html#ISListToPair">src/vec/is/is/utils/isdiff.c</A>
<BR><A HREF="./index.html">Index of all IS 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>
|
