<!--Copyright (C) 1988-2005 by the Institute of Global Environment and Society (IGES). See file COPYRIGHT for more information.-->
<html>
<head>
<title>GrADS Function: amaxlocy</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style type="text/css">
body {
background-color: #e0f0ff;
}
.red {
color: #900;
}
</style>
</head>
<body text="#000000">
<h2><b>amaxlocy()</b></h2>
<p>This function returns the Y location of maximum grid value over a spatial domain. The syntax is:
<p> <code>amaxlocy(<i>expr, xdim1, xdim2, ydim1, ydim2</i>)</code>
<p> where:
<ul>
<code><i>expr</i> </code>any valid GrADS grid expression <br>
<code><i>xdim1</i> </code>starting X or LON dimension expression <br>
<code><i>xdim2</i> </code>ending X or LON dimension expression <br>
<code><i>ydim1</i> </code>starting Y or LAT dimension expression <br>
<code><i>ydim2</i> </code>ending Y or LAT dimension expression <br>
</ul>
<p> For the Y location of the global maximum, a shorthand may be used:
<ul>
<code>amaxlocy(<i>expr</i>, global)</code> or <br>
<code>amaxlocy(<i>expr</i>, g)</code>
</ul>
is the same as
<ul>
<code>amaxlocy(<i>expr</i>, lon=0, lon=360, lat=-90, lat=90)</code>
</ul>
<p>
<h3>Usage Notes</h3>
<ol>
<li>This function will only work with <span class="red">GrADS version 2.0.2</span> or later.
<li>This function is more efficient that using nested <code><a href="gradfuncmaxloc.html">maxloc</a></code> and <code><a href="gradfuncmax.html">max</a></code> functions.
<li> Related function <code><a href="gradfuncamaxlocx.html">amaxlocx</a></code> will return the X location of the maximum grid value.
<li>Use the <code><a href="gradfuncamax.html">amax</a></code> function to retrieve the maximum value over the grid.
<li>If more than one grid box contains the maximum value, the location returned will be the first one encountered as the grid is scanned. The grid is scanned by rows from south to north, and each row is scanned from west to east.
<li>A similar set of functions exists for finding the minimum over an area: <code><a href="gradfuncamin.html">amin</a></code>, <code><a href="gradfuncaminlocx.html">aminlocx</a></code>, and <code><a href="gradfuncaminlocy.html">aminlocy</a></code>.
</ol>
<p>
<h3>Examples</h3>
Please see the documentation page for <code><a href="gradfuncamax.html">amax</a></code>.
</body>
</html>
