<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <!--Converted with LaTeX2HTML 2017.2 (Released Jan 23, 2017) --> <HTML> <HEAD> <TITLE>psb_cdbldext -- Build an extended communication descriptor</TITLE> <META NAME="description" CONTENT="psb_cdbldext -- Build an extended communication descriptor"> <META NAME="keywords" CONTENT="userhtml"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2017.2"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="userhtml.css"> <LINK REL="next" HREF="node78.html"> <LINK REL="previous" HREF="node76.html"> <LINK REL="up" HREF="node71.html"> <LINK REL="next" HREF="node78.html"> </HEAD> <BODY > <DIV CLASS="navigation"><!--Navigation Panel--> <A NAME="tex2html1225" HREF="node78.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1221" HREF="node71.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1215" HREF="node76.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1223" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1226" HREF="node78.html">psb_spall Allocates</A> <B> Up:</B> <A NAME="tex2html1222" HREF="node71.html">Data management routines</A> <B> Previous:</B> <A NAME="tex2html1216" HREF="node76.html">psb_cdfree Frees</A> <B> <A NAME="tex2html1224" HREF="node1.html">Contents</A></B> <BR> <BR></DIV> <!--End of Navigation Panel--> <H2><A NAME="SECTION00076000000000000000"> psb_cdbldext -- Build an extended communication descriptor</A> </H2> <P> <PRE> call psb_cdbldext(a,desc_a,nl,desc_out, info, extype) </PRE> <P> This subroutine builds an extended communication descriptor, based on the input descriptor <code>desc_a</code> and on the stencil specified through the input sparse matrix <code>a</code>. <DL> <DT><STRONG>Type:</STRONG></DT> <DD>Synchronous. </DD> <DT><STRONG><B>On Entry</B></STRONG></DT> <DD> </DD> <DT><STRONG>a</STRONG></DT> <DD>A sparse matrix Scope:<B>local</B>. <BR> Type:<B>required</B>. <BR> Intent: <B>in</B>. <BR> Specified as: a structured data type. </DD> <DT><STRONG>desc_a</STRONG></DT> <DD>the communication descriptor. <BR> Scope:<B>local</B>. <BR> Type:<B>required</B>. <BR> Intent: <B>in</B>. <BR> Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>. </DD> <DT><STRONG>nl</STRONG></DT> <DD>the number of additional layers desired. <BR> Scope:<B>global</B>. <BR> Type:<B>required</B>. <BR> Intent: <B>in</B>. <BR> Specified as: an integer value <SPAN CLASS="MATH"><IMG WIDTH="47" HEIGHT="30" ALIGN="MIDDLE" BORDER="0" SRC="img102.png" ALT="$nl\ge 0$"></SPAN>. </DD> <DT><STRONG>extype</STRONG></DT> <DD>the kind of estension required. <BR> Scope:<B>global</B>. <BR> Type:<B>optional </B>. <BR> Intent: <B>in</B>. <BR> Specified as: an integer value <code>psb_ovt_xhal_</code>, <code>psb_ovt_asov_</code>, default: <code>psb_ovt_xhal_</code> <P> </DD> </DL> <P> <DL> <DT><STRONG><B>On Return</B></STRONG></DT> <DD> </DD> <DT><STRONG>desc_out</STRONG></DT> <DD>the extended communication descriptor. <BR> Scope:<B>local</B>. <BR> Type:<B>required</B>. <BR> Intent: <B>inout</B>. <BR> Specified as: a structured data of type descdata<TT>psb_desc_type</TT>. </DD> <DT><STRONG>info</STRONG></DT> <DD>Error code. <BR> Scope: <B>local</B> <BR> Type: <B>required</B> <BR> Intent: <B>out</B>. <BR> An integer value; 0 means no error has been detected. </DD> </DL> <P> <BIG CLASS="LARGE"><B>Notes</B></BIG> <OL> <LI>Specifying <code>psb_ovt_xhal_</code> for the <code>extype</code> argument the user will obtain a descriptor for a domain partition in which the additional layers are fetched as part of an (extended) halo; however the index-to-process mapping is identical to that of the base descriptor; </LI> <LI>Specifying <code>psb_ovt_asov_</code> for the <code>extype</code> argument the user will obtain a descriptor with an overlapped decomposition: the additional layer is aggregated to the local subdomain (and thus is an overlap), and a new halo extending beyond the last additional layer is formed. </LI> </OL> <P> <DIV CLASS="navigation"><HR> <!--Navigation Panel--> <A NAME="tex2html1225" HREF="node78.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1221" HREF="node71.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1215" HREF="node76.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1223" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1226" HREF="node78.html">psb_spall Allocates</A> <B> Up:</B> <A NAME="tex2html1222" HREF="node71.html">Data management routines</A> <B> Previous:</B> <A NAME="tex2html1216" HREF="node76.html">psb_cdfree Frees</A> <B> <A NAME="tex2html1224" HREF="node1.html">Contents</A></B> </DIV> <!--End of Navigation Panel--> </BODY> </HTML>