<!--Copyright (C) 1988-2005 by the Institute of Global Environment and Society (IGES). See file COPYRIGHT for more information.-->
<html>
<head>
<title>GrADS</title>
<link href="GrADS.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="e0f0ff" text="#000000">
<h2><b>sdfopen</b></h2>
<p> <span class="plaintext"><code>sdfopen <i>filename <template #timesteps></i></code></span>
<p>
<p class="plaintext"> Opens a NetCDF or HDF-SDS format file that conforms to the
<a href="http://ferret.wrc.noaa.gov/noaa_coop/coop_cdf_profile.html" target="_parent">COARDS conventions</a>. The sdfopen command does not support the HDF5 format, but is does support netcdf4. The arguments and options are as follows:
<p>
<ul>
<span class="plaintext"><code><i>filename</i></code> </span>
<ul>
<span class="plaintext"> The name of the COARDS-compliant NetCDF or HDF-SDS
file. </span>
</ul>
<span class="plaintext"><code><i>template</i></code> </span>
<ul>
<span class="plaintext"> This optional argument is used when you want to aggregate
multiple data files and handle them as if they were one individual file. The
individual data files must be identical in all dimensions except time. <code><i>template</i></code>
has a similar structure to the substitution template in a GrADS data descriptor
file. See <a href="templates.html">Using Templates</a> for details. </span>
</ul>
<span class="plaintext"><code><i>#timesteps</i></code> </span>
<ul>
<span class="plaintext"> This argument must be included whenever <code><i>template</i></code>
is invoked. The <code><i>#timesteps</i></code> is the sum of the timestep
counts in all the files to be examined, not the count in any one file. </span>
</ul>
</ul>
<p>
<h3>Usage Notes</h3>
<ol>
<li>The template option with sdfopen was removed in version 2.0. If you want to aggregate multiple files together use the <a href="gradcomdxdfopen.html">xdfopen</a> command with the 'options template" keyword and a complete TDEF entry.
<li>Here's a brief summary of the metadata that sdfopen is looking for when it tries to open a self-describing file. As it goes through the list of dimension variables in the file, it checks each one for attributes named "units", "axis", and "grads_dim". Acceptable values for these attributes and the GrADS dimension the coordinate variable maps to are outlined in this table:<br>
<br>
<table width="763" border="0">
<tr>
<td width="150" bgcolor="cccccc"><div align="center">GrADS Dimension</div></td>
<td width="603" bgcolor="cccccc"><div align="center">Acceptable Attribute Values</div></td>
</tr>
<tr>
<td bgcolor="b8c8d7"><div align="center">X</div></td>
<td bgcolor="b8c8d7">units: degrees_east, degree_east, degrees_E, degree_E<br>
axis: x, X</td>
</tr>
<tr>
<td bgcolor="ccdceb"><div align="center">Y</div></td>
<td bgcolor="ccdceb">unit: degrees_north, degree_north, degrees_N, degree_N<br>
axis: y, Y</td>
</tr>
<tr>
<td bgcolor="b8c8d7"><div align="center">Z (pressure)</div></td>
<td bgcolor="b8c8d7">units: mb, millibar, hybrid_sigma_pressure<br></td>
</tr>
<tr>
<td bgcolor="ccdceb"><div align="center">Z (not pressure)</div></td>
<td bgcolor="ccdceb">units: sigma_level, degreesk, degrees_k, level, layer, layers<br>
axis: z, Z</td>
</tr>
<tr>
<td bgcolor="b8c8d7"><div align="center">T</div></td>
<td bgcolor="b8c8d7">units: yyyymmddhhmmss, yymmddhh, or a Udunits-acceptable time unit<br>
axis: t, T</td>
</tr>
<tr>
<td bgcolor="ccdceb"><div align="center">E</div></td>
<td bgcolor="ccdceb">grads_dim: e<br>
axis: e, E</td>
</tr>
</table>
<br>
<li>If the sdfopen command fails to open your self-describing file, try using the <a href="gradcomdxdfopen.html"><code>xdfopen</code></a>
command which requires a special descriptor file to supplement or override the metadata in the file, or use the <a href="gradcomdopen.html">open</a> command with a <a href="SDFdescriptorfile.html">complete descriptor file</a>.
</ol>
<p>
<h3>Examples </h3>
<ol>
<li class="plaintext">If you had daily U-Wind data in two files, <code>uwnd.1989.nc</code>
and <code>uwnd.1990.nc</code>, you could access them both as one GrADS data
set by entering:
<p>
<code>sdfopen /data/uwnd.1989.nc uwnd.%y4.nc 730</code>
<p>
</ol>
</body>
</html>
