Module Document - READ_WIND_TIMEST

<table cellspacing="0" cellpadding="0"> <tr height="150"> <td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td> <td width="100%" rowspan="2" align="left" valign="center"> <table cellspacing="0" cellpadding="0"> <tr> <td> <a name="READ_WIND_TIMEST"> <table width="84%" border="0" align="center"> <tr bgcolor="FFFFAA" align="center"> <td nowrap width="15%" height="32"> <tt class="label">1814</tt></td> <td nowrap width="100%"> <tt class="label">READ_WIND_TIMEST</tt></td> <td nowrap width="150"><tt class="label">04/21/94</tt></td> </tr> <tr><td align="left" colspan="3"><p>READ WINDTIMESTAMP -- read the input wind field and timestamp file and output a subset field and a subset timestamp string (suitable as recursive inputs to this module once the timestamp string is written into a file). The MCNC Environmental Programs Group has created this module as part of a suite of AVS demo modules, networks, and sample data sets to demonstrate the functionality of its visualization prototype for an Environmental Decision Support System (EDSS). You can download these modules individually from the IAC using anonymous ftp to the appropriate directories /avs_modules at avs.ncsc.org. If you would like to download the entire suite of modules, networks, and sample datasets at the same time, the IAC recommends that you use anonymous ftp to grab the following file from avs.ncsc.org - ftp/avs/Data/avs_dataMCNC_Env_Pgms/MCNC_Env_Pgms.tar.Z This contains all source code to all local and remote modules, as well as all of the sample datasets, networks, documentation, installation, and usage notes.</p></td></tr> <tr><td align="left" colspan="3"><table class="avs5_repository"> <tr valign="top"><td><b>Author:</b></td><td>Kathy Pearson, MCNC Environmental Programs</td></tr> <tr><td><b>Version:</b></td><td>1.000</td></tr> <tr><td><b>Language:</b></td><td>C</td></tr> <tr> <td><b>Path:</b></td><td>source/data_input/READ_WIND_TIMEST/</td></tr> </table></td></tr> <tr><td align="left" colspan="3"><p> <a href="READ_WIND_TI.shtml" target="_top"> <img src="../../../../../img/doc_mod.gif" border="0" width="30" height="30" alt="Module Document - READ_WIND_TIMEST"></a> <a href="source/data_input/READ_WIND_TIMEST/READ_WIND_TIMEST.tar.gz"> <img src="../../../../../img/targz.gif" border="0" width="52" height="30" alt="Archive - READ_WIND_TIMEST.tar.gz"></a> <a href="source/data_input/READ_WIND_TIMEST/READ_WIND_TIMEST.tar.Z"> <img src="../../../../../img/tarz.gif" border="0" width="52" height="30" alt="Archive - READ_WIND_TIMEST.tar.Z"></a> <a href="source/data_input/READ_WIND_TIMEST/READ_WIND_TIMEST.zip"> <img src="../../../../../img/zip.gif" border="0" width="52" height="30" alt="Archive - READ_WIND_TIMEST.zip"></a> </p></td> </tr> </table> <br> </td> </tr> <tr> <td>  <html> <head> <title>READ WINDTIMESTAMP -- read the input wind field and timestamp file and output a subset field and a subset timestamp string (suitable as recursive inputs to this module once the timestamp string is written into a file) </title> </head> <body bgcolor=#FFFFCC> <h2>READ WINDTIMESTAMP -- read the input wind field and timestamp file and output a subset field and a subset timestamp string (suitable as recursive inputs to this module once the timestamp string is written into a file) </h2> <h3>Name</h3> <blockquote> <pre> READ WINDTIMESTAMP -- read the input wind field and timestamp file and output a subset field and a subset timestamp string (suitable as recursive inputs to this module once the timestamp string is written into a file) </pre> </blockquote> <h3>Author</h3> <blockquote> <pre> Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240 </pre> </blockquote> <h3>Summary</h3> <blockquote> <pre> Name READ WINDTIMESTAMP Type data input Inputs input grid (field 4D uniform float) filename (string) Outputs output grid (field uniform 3-vector float) datetime (string) nhour (int) output species string (string) current hour (int) Parameters Name Type Def Min Max ---- ---- --- --- --- USpecies (choice) " " VSpecies (choice) " " starting record (int) 1 1 1000 starting record time (string block) NULL ending record (int) 1 1 1000 ending record time (string block) NULL Output Mode (choice) "Output Single ..." go (oneshot) 0 0 1 autogo (toggle) 0 0 1 </pre> </blockquote> <h3>Description</h3> <blockquote> <pre> The READ WINDTIMESTAMP module accepts as input a field of 4 dimensions. The </pre> </blockquote> <h3>Input </h3> <blockquote> <pre> AVS field should be XDR binary 4-byte float (except for interactive use on CRAY systems where the XDR binary field should be in 8-byte floats). The second required input is a timestamp file name, and that file should contain an ASCII list of the date/time labels for each time step in the input AVS field. The idea is to create portable data sets that can be read on the local workstation and have this data treated in the same manner as that on remote systems. This is most important for speed considerations. INPUTS input grid input data field of 4 dimensions filename full path name of the ASCII timestamp file </pre> </blockquote> <h3>Outputs</h3> <blockquote> <pre> output grid output field of either 3 or 4 dimensions, depending on the user selected Output Mode; 3 dimensions are needed for NEW TILE and "field to mesh" plots while 4 dimensions are needed for 2D graphs of time series information and for NEW TILE or "field to mesh" plots of gridded statistical plots (GRID MATH); 3 vectors are output: the u vector, the v vector, and the calculated wind speed datetime string containing the list of date and time labels corresponding to the selected record(s) in the output grid nhour the number of records in the data set (needed for ANIMATE DUAL) output species string string containing the output species (needed for MINMAX) -- set to "WIND SPEED" current hour the current record in the data set (needed for ANIMATE DUAL) </pre> </blockquote> <h3>Parameters</h3> <blockquote> <pre> USpecies the u vector selection VSpecies the v vector selection starting record the starting record number for output starting record time string containing the date and time represented by the starting record number ending record the starting record number for output ending record time string containing the date and time represented by the ending record number Output Mode choice of "Output Single Starting Record" or "Output Multiple Records" go indicator that output should occur autogo indicator that output should occur whenever an input or parameter changes </pre> </blockquote> <h3>Example</h3> <blockquote> <pre> </pre> </blockquote> <h3>Related modules</h3> <blockquote> <pre> </pre> </blockquote> <h3>Limitations</h3> <blockquote> <pre> For better coordination with the ANIMATE DUAL module, it might be better to have matching parameters of current record number, minimum record number, and maximum record number. It is a drawback that the 32-bit XDR binary AVS fields are treated differently on the CRAY than elsewhere and that special 64-bit versions of data must be created for use there. </pre> </blockquote> <h3>See also</h3> <blockquote> <pre> (MCNC Visualization Plan) 11/93 ------------------------------------------------------------------------- The MCNC Environmental Programs Group has created this module as part of a suite of AVS demo modules, networks, and sample data sets to demonstrate the functionality of its visualization prototype for an Environmental Decision Support System (EDSS). This system provides a unified method of analysis and visualization for data output from different environmental air quality models. Remotely, standard output files from the following models can be read into AVS: ROM (Regional Oxidant Model) RADM (Regional Acid Deposition Model), low res and high res RADM (Regional Acid Depostion Model) Emissions, low res UAM (Urban Airshed Model, regulatory version) UAM (Urban Airshed Model, AREAL research version) UAM Wind (Urban Airshed Model, regulatory version) MCNC ALPHA-Prototype netCDF files Alternatively, xdr portable binary AVS fields can be created from these data types and accessed directly from the local workstation. You can download these modules individually from the IAC using anonymous ftp to the appropriate directories /avs_modules at avs.ncsc.org. If you would like to download the entire suite of modules, networks, and sample datasets at the same time, the IAC recommends that you use anonymous ftp to grab the following file from avs.ncsc.org - /sample_data/avs_data/MCNC_Env_Pgms/MCNC_Env_Pgms.tar.Z This contains all source code to all local and remote modules, as well as all of the sample datasets, networks, documentation, installation, and usage notes. ------------------------------------------------------------------------- </pre> </blockquote> </body> </html>  </td> </tr> </table> </td> </tr> <tr height="100%"> <td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap"> <p><a href="../../../../../general/index.shtml" target="_top">General Information</a></p> <p><a href="../../../../../repository/index.shtml" target="_top">Repositories</a></p> <p class="sideLinkLevel2"><a href="../../../../new/index.shtml" target="_top">  New Releases</a></p> <p class="sideLinkLevel2"><a href="../../../../download/index.shtml" target="_top">  Download</a></p> <p class="sideLinkLevel2"><a href="../../../../submit/index.shtml" target="_top">  Submit</a></p> <p class="sideLinkLevel2"><a href="../../../../pfiles/index.shtml" target="_top">  Project Files</a></p> <p class="sideLinkLevel2"><a href="../../../../avs5/index.shtml" target="_top">  AVS5</a></p> <p class="sideLinkLevel3"><a href="../../../input.shtml" target="_top">    Data Input</a></p> <p class="sideLinkLevel3"><a href="../../../filters.shtml" target="_top">    Filters</a></p> <p class="sideLinkLevel3"><a href="../../../mappers.shtml" target="_top">    Mappers</a></p> <p class="sideLinkLevel3"><a href="../../../output.shtml" target="_top">    Data Output</a></p> <p class="sideLinkLevel3"><a href="../../../misc.shtml" target="_top">    Miscellaneous</a></p> <p class="sideLinkLevel2"><a href="../../../../express/index.shtml" target="_top">  AVS/Express</a></p> <p class="sideLinkLevel2"><a href="../../../../pog/index.shtml" target="_top">  Project Guidelines</a></p> <p><a href="../../../../../usergroup/index.shtml" target="_top">User Group</a></p> <p><a href="../../../../../training/index.shtml" target="_top">Training Materials</a></p> </td> </tr> </table> <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0"> <tr> <td><img src="../../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td> <td width="100%"> Last Updated:  26th November 2002 </td> </tr> </table>