NetCDF-Users-Guide-for-FORTRAN-An-Access-Interface

NetCDFUser’sGuideforFORTRANAnAccessInterfaceforSelf-Describing,PortableDataVersion3June1997RussRew,GlennDavis,SteveEmmerson,andHarveyDaviesUnidataProgramCenterCopyright©1997UniversityCorporationforAtmosphericResearch,Boulder,Colorado.Permissionisgrantedtomakeanddistributeverbatimcopiesofthismanualprovidedthatthecopyrightnoticeandtheseparagraphsarepreservedonallcopies.Thesoftwareandanyaccompa-nyingwrittenmaterialsareprovided“asis”withoutwarrantyofanykind.UCARexpresslydis-claimsallwarrantiesofanykind,eitherexpressedorimplied,includingbutnotlimitedtotheimpliedwarrantiesofmerchantabilityandfitnessforaparticularpurpose.TheUnidataProgramCenterismanagedbytheUniversityCorporationforAtmosphericResearchandsponsoredbytheNationalScienceFoundation.Anyopinions,findings,conclu-sions,orrecommendationsexpressedinthispublicationarethoseoftheauthor(s)anddonotnec-essarilyreflecttheviewsoftheNationalScienceFoundation.Mentionofanycommercialcompanyorproductinthisdocumentdoesnotconstituteanendorse-mentbytheUnidataProgramCenter.Unidatadoesnotauthorizeanyuseofinformationfromthispublicationforadvertisingorpublicitypurposes.Chapter:1NetCDFUser’sGuideforFORTRANChapter1:Introduction.............................................11.1TheNetCDFInterface..................................................11.2NetCDFIsNotaDatabaseManagementSystem.............................11.3FileFormat..........................................................21.4WhataboutPerformance?...............................................21.5IsNetCDFaGoodArchiveFormat?......................................31.6CreatingSelf-DescribingDataconformingtoConventions.....................31.7BackgroundandEvolutionoftheNetCDFInterface..........................31.8What’sNewSincethePreviousRelease?..................................51.9LimitationsofNetCDF.................................................51.10FuturePlansforNetCDF..............................................7Chapter2:ComponentsofaNetCDFDataset..........................92.1TheNetCDFDataModel...............................................92.1.1NamingConventions...........................................92.1.2networkCommonDataFormLanguage(CDL)......................92.2Dimensions.........................................................102.3Variables...........................................................112.3.1CoordinateVariables..........................................122.4Attributes...........................................................132.5DifferencesbetweenAttributesandVariables..............................14Chapter3:Data..................................................153.1netCDFexternaldatatypes.............................................153.2DataAccess.........................................................163.2.1FormsofDataAccess.........................................163.2.2AnExampleofArray-SectionAccess.............................173.2.3MoreonGeneralArraySectionAccess............................183.3TypeConversion.....................................................193.4DataStructures......................................................20Chapter4:UseoftheNetCDFLibrary...............................234.1CreatingaNetCDFDataset............................................234.2ReadingaNetCDFDatasetwithKnownNames............................244.3ReadinganetCDFDatasetwithUnknownNames...........................254.4AddingNewDimensions,Variables,Attributes.............................264.5ErrorHandling......................................................274.6CompilingandLinkingwiththeNetCDFLibrary...........................272Chapter5:Datasets...............................................295.1NetCDFLibraryInterfaceDescriptions...................................295.2Geterrormessagecorrespondingtoerrorstatus:NF_STRERROR..............305.3GetnetCDFlibraryversion:NF_INQ_LIBVERS...........................305.4CreateaNetCDFdataset:NF_CREATE..................................315.5OpenaNetCDFDatasetforAccess:NF_OPEN.............................325.6PutOpenNetCDFDatasetintoDefineMode:NF_REDEF....................335.7LeaveDefineMode:NF_ENDDEF.......................................345.8CloseanOpenNetCDFDataset:NF_CLOSE..............................355.9InquireaboutanOpenNetCDFDataset:NF_INQFamily....................355.10SynchronizeanOpenNetCDFDatasettoDisk:NF_SYNC...................375.11BackOutofRecentDefinitions:NF_ABORT..............................385.12SetFillModeforWrites:NF_SET_FILL................................39Chapter6:Dimensions.............................................436.1CreateaDimension:NF_DEF_DIM......................................436.2GetaDimensionIDfromItsName:NF_INQ_DIMID.......................446.3InquireaboutaDimension:NF_INQ_DIMFamily..........................456.4RenameaDimension:NF_RENAME_DIM.................................47Chapter7:Variables..............................................497.1LanguageTypesCorrespondingtonetCDFexternaldatatypes................497.2CreateaVariable:NF_DEF_