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
|
<!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/ISGetTotalIndices.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>ISGetTotalIndices</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/ISGetTotalIndices.html "><small>Report Typos and Errors</small></a></div>
<A NAME="ISGetTotalIndices"><H1>ISGetTotalIndices</H1></A>
Retrieve an array containing all indices across the communicator.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscis.h"
PetscErrorCode ISGetTotalIndices(IS is, const PetscInt *indices[])
</PRE>
Collective on <A HREF="../IS/IS.html#IS">IS</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<DT><B>is </B> -the index set
<br>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<DT><B>indices </B> -total indices with rank 0 indices first, and so on; total array size is
the same as returned with <A HREF="../IS/ISGetSize.html#ISGetSize">ISGetSize</A>().
<br>
<P>
<P>
Notes: this is potentially nonscalable, but depends on the size of the total index set
and the size of the communicator. This may be feasible for index sets defined on
subcommunicators, such that the set size does not grow with PETSC_WORLD_COMM.
Note also that there is no way to tell where the local part of the indices starts
(use <A HREF="../IS/ISGetIndices.html#ISGetIndices">ISGetIndices</A>() and <A HREF="../IS/ISGetNonlocalIndices.html#ISGetNonlocalIndices">ISGetNonlocalIndices</A>() to retrieve just the local and just
the nonlocal part (complement), respectively).
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../IS/ISRestoreTotalIndices.html#ISRestoreTotalIndices">ISRestoreTotalIndices</A>(), <A HREF="../IS/ISGetNonlocalIndices.html#ISGetNonlocalIndices">ISGetNonlocalIndices</A>(), <A HREF="../IS/ISGetSize.html#ISGetSize">ISGetSize</A>()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>intermediate
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/vec/is/is/interface/index.c.html#ISGetTotalIndices">src/vec/is/is/interface/index.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>
|
