<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="1.8.14">
  <compounddef id="interfacemom__coms_1_1reproducing__sum__efp" kind="interface" language="Fortran" prot="private">
    <compoundname>mom_coms::reproducing_sum_efp</compoundname>
      <sectiondef kind="private-func">
      <memberdef kind="function" id="interfacemom__coms_1_1reproducing__sum__efp_1a8316e3d021227cb9b54598d62b049fab" prot="private" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
        <type>type(<ref refid="structmom__coms_1_1efp__type" kindref="compound">efp_type</ref>) function</type>
        <definition>type(efp_type) function mom_coms::reproducing_sum_efp::reproducing_efp_sum_2d</definition>
        <argsstring>(array, isr, ier, jsr, jer, overflow_check, err, only_on_PE)</argsstring>
        <name>reproducing_efp_sum_2d</name>
        <param>
          <type>array</type>
          <defname>array</defname>
        </param>
        <param>
          <type>isr</type>
          <defname>isr</defname>
        </param>
        <param>
          <type>ier</type>
          <defname>ier</defname>
        </param>
        <param>
          <type>jsr</type>
          <defname>jsr</defname>
        </param>
        <param>
          <type>jer</type>
          <defname>jer</defname>
        </param>
        <param>
          <type>overflow_check</type>
          <defname>overflow_check</defname>
        </param>
        <param>
          <type>err</type>
          <defname>err</defname>
        </param>
        <param>
          <type>only_on_PE</type>
          <defname>only_on_PE</defname>
        </param>
        <briefdescription>
<para>This subroutine uses a conversion to an integer representation of real numbers to give an order-invariant sum of distributed 2-D arrays that reproduces across domain decomposition, with the result returned as an extended fixed point type that can be converted back to a real number using EFP_to_real. This technique is described in Hallberg &amp; Adcroft, 2014, Parallel Computing, doi:10.1016/j.parco.2014.04.007. </para>        </briefdescription>
        <detaileddescription>
<para><parameterlist kind="param"><parameteritem>
<parameternamelist>
<parametername direction="in">array</parametername>
</parameternamelist>
<parameterdescription>
<para>The array to be summed</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">isr</parametername>
</parameternamelist>
<parameterdescription>
<para>The starting i-index of the sum, noting that the array indices starts at 1</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">ier</parametername>
</parameternamelist>
<parameterdescription>
<para>The ending i-index of the sum, noting that the array indices starts at 1</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">jsr</parametername>
</parameternamelist>
<parameterdescription>
<para>The starting j-index of the sum, noting that the array indices starts at 1</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">jer</parametername>
</parameternamelist>
<parameterdescription>
<para>The ending j-index of the sum, noting that the array indices starts at 1</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">overflow_check</parametername>
</parameternamelist>
<parameterdescription>
<para>If present and false, disable checking for overflows in incremental results. This can speed up calculations if the number of values being summed is small enough</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="out">err</parametername>
</parameternamelist>
<parameterdescription>
<para>If present, return an error code instead of triggering any fatal errors directly from this routine.</para></parameterdescription>
</parameteritem>
<parameteritem>
<parameternamelist>
<parametername direction="in">only_on_pe</parametername>
</parameternamelist>
<parameterdescription>
<para>If present and true, do not do the sum across processors, only reporting the local sum</para></parameterdescription>
</parameteritem>
</parameterlist>
<simplesect kind="return"><para>The result in extended fixed point format </para></simplesect>
</para>        </detaileddescription>
        <inbodydescription>
        </inbodydescription>
        <location file="/home/cermak/src/MOM6.devrob/src/framework/MOM_coms.F90" line="92" column="1" bodyfile="/home/cermak/src/MOM6.devrob/src/framework/MOM_coms.F90" bodystart="93" bodyend="211"/>
      </memberdef>
      </sectiondef>
    <briefdescription>
<para>Find an accurate and order-invariant sum of a distributed 2d field, returning the result in the form of an extended fixed point value that can be converted back with EFP_to_real. </para>    </briefdescription>
    <detaileddescription>
    </detaileddescription>
    <location file="/home/cermak/src/MOM6.devrob/src/framework/MOM_coms.F90" line="59" column="1" bodyfile="/home/cermak/src/MOM6.devrob/src/framework/MOM_coms.F90" bodystart="59" bodyend="60"/>
    <listofallmembers>
      <member refid="interfacemom__coms_1_1reproducing__sum__efp_1a8316e3d021227cb9b54598d62b049fab" prot="private" virt="non-virtual"><scope>mom_coms::reproducing_sum_efp</scope><name>reproducing_efp_sum_2d</name></member>
    </listofallmembers>
  </compounddef>
</doxygen>
