/*!  \mainpage ExodusII API Documentation\section intro IntroductionEXODUS II is the successor of the widely used finite element (FE) data file format EXODUS(henceforth referred to as EXODUS I) developed by Mills-Curran and Flanagan. Itcontinues the concept of a common database for multiple application codes (mesh generators,analysis codes, visualization software, etc.) rather than code-specific utilities, affordingflexibility and robustness for both the application code developer and application code user.By using the EXODUS II data model, a user inherits the flexibility of using a large array ofapplication codes (including vendor-supplied codes) which access this common data filedirectly or via translators.The uses of the EXODUS II data model include the following:    - Problem definition -- mesh generation, specification of locations of boundary conditions and load application, specification of material types.    - Simulation -- model input and results output.    - Visualization -- model verification, results postprocessing, data interrogation, and analysis tracking.\section avail License and AvailabilityThe EXODUS II library is licensed under the BSD open source license.Copyright (c) 2005 Sandia Corporation. Under the terms of Contract DE-AC04-94AL85000with Sandia Corporation, the U.S. Government retains certain rights in this software.Redistribution and use in source and binary forms, with or without modification, are permittedprovided that the following conditions are met:  - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  - Redistributions in binary form must reproduce the above copyright notice, this listof conditions and the following disclaimer in the documentation and/or othermaterials provided with the distribution.  -Neither the name of Sandia Corporation nor the names of its contributors may beused to endorse or promote products derived from this software without specificprior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHTOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANYTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USEOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.The ExodusII library source code is available on Sourceforge athttp://sourceforge.net/projects/exodusiiFor bug reports, documentation errors, and enhancement suggestions, contact:- Gregory D. Sjaardema- PHONE: (505) 844-2701- EMAIL: gdsjaar@sandia.gov\section devel Development of EXODUS IIThe evolution of the EXODUS data model has been steered by FE application code developerswho desire the advantages of a common data format. The EXODUS II model has beendesigned to overcome deficiencies in the EXODUS I file format and meet the followingfunctional requirements as specified by these developers:   - Random read/write access.   - Application programming interface (API) -- provide routines callable from FORTRAN, C, and C++ application codes.   - Extensible -- allow new data objects to be added without modifying the application programs that use the file format.   - Machine independent -- data should be independent of the machine which generated it.   - Real-time access during analysis -- allow access to the data in a file while the file isbeing created.To address these requirements, the open source database libraryetCDF (http://www.unidata.ucar.edu/software/netcdf/) was selected to handle the low-level data storage. The EXODUSII library functions provide the mapping between FE data objects andnetCDF dimensions, attributes, and variables. Thus, the code developerinteracts with the data model using the vocabulary of an FE analyst(element connectivity, nodal coordinates, etc.) and is relieved of thedetails of the data access mechanism. Because an EXODUS II file is a netCDF file, an application program canaccess data via the EXODUS II API or the netCDF API directly. Althoughaccessing the data directly via the netCDF API requires more in-depthunderstanding of netCDF, this capability is a powerful feature thatallows the development of auxiliary libraries of special purposefunctions not offered in the standard EXODUS II library. For example,if an application required access to the coordinates of a single node(the standard library function returns the coordinates for all of thenodes in the model), a simple function could be written that callsnetCDF routines directly to read the data of interest.\section descrip Description of Data ObjectsThe data in EXODUS II files can be divided into three primarycategories: initialization data, model, and results.Initialization data includes sizing parameters (number of nodes,number of elements, etc.), optional quality assurance information(names of codes that have operated on the data), and optionalinformational text.The model is described by data which are static (do not change throughtime). These data include nodal coordinates, element connectivity(node lists for each element), element attributes, and node sets andside sets (used to aid in applying loading conditions and boundaryconstraints).The results are optional and include five types of variables -- nodal,element, nodeset, sideset, and global -- each of which is storedthrough time. Nodal results are output (at each time step) for all thenodes in the model. An example of a nodal variable is displacement inthe X direction. Element, nodeset, and sideset results are output (ateach time step) for all entities (elements, nodes, sides) in one ormore entity block. For example, stress may be an elementvariable. Another use of element variables is to record element status(a binary flag indicating whether each element is "alive" or "dead")through time. Global results are output (at each time step) for asingle element or node, or for a single property. Linear momentum of astructure and the acceleration at a particular point are both examplesof global variables.  Although these examples correspond to typical FEapplications, the data format is flexible enough to accommodate aspectrum of uses.A few conventions and limitations must be cited: - There are no restrictions on the frequency of results output except that the time value associated with each successive time step must increase monotonically. - To output results at different frequencies (i.e., variable A at every simulation time step, variable B at every other time step) multiple EXODUS II files must be used. - There are no limits to the number of each type of results, but once declared, the number cannot change. - If the mesh geometry or topology changes in time (i.e., number of nodes increases, connectivity changes), then the new geometrymust be output to a new EXODUS II file.*/