The NetCDF Fortran90Interface Guide
NetCDF Version3.6.2
Last Updated28November2006 Russ Rew,Glenn Davis,Steve Emmerson,and Harvey Davies Unidata Program Center
Copyright c 2005-2006University Corporation for Atmospheric Rearch
Permission is granted to make and distribute verbatim copies of this manual provided that the copyright notice and the paragraphs are prerved on all copies.The software and any accompanying written materials are provided“as is”without warranty of any kind.UCAR expressly disclaims all warranties of any kind,either expresd or implied,including but not limited to the implied warranties of merchantability andfitness for a particular purpo. The Unidata Program Center is managed by the University Corporation for Atmospheric Rearch and sponsored by the National Science Foundation.Any opinions,findings,con-clusions,or recommendations expresd in this publication are tho of the author(s)and do not necessarily reflect the views of the National Science Foundation.
Mention of any commercial company or product in this document does not constitute an endorment
by the Unidata Program Center.Unidata does not authorize any u of information from this publication for advertising or publicity purpos.
i Table of Contentsntv
1U of the NetCDF Library (1)
1.1Creating a NetCDF Datat (1)
1.2Reading a NetCDF Datat with Known Names (2)
1.3Reading a netCDF Datat with Unknown Names (2)
1.4Writing Data in an Existing NetCDF Datat (3)
1.5Adding New Dimensions,Variables,Attributes (4)
1.6Error Handling (5)
1.7Compiling and Linking with the NetCDF Library (6)
2Datats (7)
2.1Datats Introduction (7)
2.2NetCDF Library Interface Descriptions (7)
2.3NF90STRERROR (8)
2.4Get netCDF library version:NF90INQ LIBVERS (8)
2.5NF90CREATE (9)
2.6NF90OPEN (10)
2.7NF90REDEF (12)
2.8NF90ENDDEF (13)
航行英文2.9NF90CLOSE (14)
2.10NF90INQUIRE Family (15)
2.11NF90SYNC (16)
2.12NF90ABORT (18)
2.13NF90SET FILL (19)
3Dimensions (21)
3.1Dimensions Introduction (21)
3.2NF90DEF DIM (21)魔女宅急便日语
3.3NF90INQ DIMID (22)
3.4NF90INQUIRE DIMENSION (23)
3.5NF90RENAME DIM (24)
4Variables (27)
4.1Variables Introduction (27)
4.2Language Types Corresponding to netCDF external data types
(27)
4.3Create a Variable:NF90_DEF_VAR (28)
4.4Get a Variable ID from Its Name:NF90INQ VARID (29)
4.5Get Information about a Variable from Its ID:
NF90INQUIRE VARIABLE (30)
4.6Writing Data Values:NF90PUT VAR (32)
4.7Reading Data Values:NF90GET VAR (36)
4.8Reading and Writing Character String Values (41)
ii NetCDF Fortran90Interface Guide
4.9Fill Values (42)
4.10NF90RENAME VAR (43)
5Attributes (45)
5.1Attributes Introduction (45)
5.2Attribute Conventions (45)
eln5.3Create an Attribute:NF90PUT ATT (48)
5.4Get Information about an Attribute:
NF90INQUIRE ATTRIBUTE and NF90INQ ATTNAME (50)best regards
5.5Get Attribute’s Values:NF90GET ATT (51)
5.6Copy Attribute from One NetCDF to Another:NF90COPY ATT男性祛斑
(53)
5.7Rename an Attribute:NF90RENAME ATT (55)
5.8NF90DEL ATT (56)
去野餐
Appendix A Appendix A-Summary of Fortran
90Interface (59)
Appendix B Appendix B-FORTRAN77to
Fortran90Transition Guide (63)
The new Fortran90interface (63)
Changes to Inquiry functions (63)
Changes to put and get function (63)
Index (65)
Chapter1:U of the NetCDF Library1
1U of the NetCDF Library
You can u the netCDF library without knowing about all of the netCDF interface.If you are creating
a netCDF datat,only a handful of routines are required to define the necessary dimensions,variables,and attributes,and to write the data to the netCDF datat.(Even less are needed if you u the ncgen utility to create the datat before running a program using netCDF library calls to write data.See ction“ncgen”in NetCDF Urs Guide.) Similarly,if you are writing software to access data stored in a particular netCDF object, only a small subt of the netCDF library is required to open the netCDF datat and access the data.Authors of generic applications that access arbitrary netCDF datats need to be familiar with more of the netCDF library.
In this chapter we provide templates of common quences of netCDF calls needed for common us.For clarity we prent only the names of routines;omit declarations and error checking;omit the type-specific suffixes of routine names for variables and attributes;indent statements that are typically invoked multiple times; reprent arbitrary quences of other statements.Full parameter lists are described in later chapters.
1.1Creating a NetCDF Datat
Here is a typical quence of netCDF calls ud to create a new netCDF datat: NF90_CREATE!create netCDF datat:enter define mode ...
NF90_DEF_DIM!define dimensions:from name and length
...
NF90_DEF_VAR!define variables:from name,type,dims
...automatic
NF90_PUT_ATT!assign attribute values
...
NF90_ENDDEF!end definitions:leave define mode
...
NF90_PUT_VAR!provide values for variable
...
popular song
NF90_CLOSE!clo:save new netCDF datat Only one call is needed to create a netCDF datat,must you
at which point you will be in thefirst of two netCDF modes.When accessing an open netCDF datat,it is either in define mode or data mode.In define mode,you can create dimensions,variables,and new attributes,but you cannot read or write variable data.In data mode,you can access data and change existing attributes,but you are not permitted to create new dimensions, variables,or attributes.
One call to NF90DEF DIM is needed for each dimension created.Similarly,one call to NF90DEF VAR is needed for each variable creation,and one call to a member of the NF90PUT ATT family is needed for each attribute defined and assigned a value.To leave define mode and enter data mode,call NF90ENDDEF.
Once in data mode,you can add new data to variables,change old values,and change values of existing attributes(so long as the attribute changes do not require more storage space).Data of all types is written to a netCDF variable using the NF90PUT VAR
