NetCDF User's Guide for C
abnormal termination aborting define mode definitions access example of array section other software for scientific data random shared dataset access to netCDF distribution FTP WWW adding attributes dimensions variables add_offset attribute ancillary data APIs descriptions differences between C and C++ differences between C and FORTRAN summary of C appending data along unlimited dimension to dataset variable applications, generic archive format argument, attribute name array writing mapped writing subsampled array section access example corner of definintion of edges of mapped reading mapped subsampled subsampled array section, writing arrays nested ragged ASCII characters attribute adding add_offset CDL defining global initializing changing specifications of character-string Conventions conventions copying creating C_format data type data type, CDL deleting ensuring changes to example, global FORTRAN_format getting values global history ID information, getting inquiring about length CDL getting long_name missing_value name argument name syntax number operations renaming scale_factor signedness title units valid_max valid_min valid_range values variable variable ID vs. variable _FillValue attributes global number of attributes associated with a variable
backing out of definitions backward compatibility interface bit lengths of data types buffers, I/O bug reports making searching past byte array vs. text string CDL constant data type data type vs. character byte, zero
C code via ncgen, generating C interface differences from C++ differences from FORTRAN summary of C++ interface differences from C C, Standard call sequence, typical canceling definitions CANDIS CDF NASA NSSDC SeaSpace Unidata Workshop CDL attribute data type defining initializing length byte constant byte data type char data type character constant constant notation data types table of dimension double constant data type example file, data section of fill values float constant data type global attribute int constant data type long data type names notation real data type reserved words short constant data type syntax variable initializing variables declaration changes since last release to attributes, ensuring changing dimension length char data type CDL character string attribute CDL constant fixed-length reading writing character-position dimension characters ASCII vs. byte closing a dataset code compiling netCDF-using generating via ncgen commercial netCDF software common netCDF call sequence compatibility interface, backward compiling netCDF-using code compression, data computers, CRAY computing file offsets of data concurrent dataset access limitations of conditions, error constant, CDL byte character double float int short conventions attribute discipline-specific example function name macro name name netCDF units syntax Conventions attribute converting floating-point values, cost of types error units coordinate offset vector systems, defining variable copying attributes corner of array section correspondence between data types and data netCDF-2 function name cost of converting floating-point values count vector zero-valued CRAY computers Flexible File I/O Flexible File I/O library I/O, optimizing creating attribute dataset dimension netCDF file variable C_format attribute
data access, other software for ancillary compression correspondence between data types and file offsets of history, recording loss mode model limitations order packing portability [1] [2] range, valid reading character-string representation, external resolution scaling section of CDL file section, netCDF file fixed-size self-describing storage structures structures, nested values, variable writing character-string data type and data, correspondence between attribute bit length of byte CDL CDL attribute CDL byte CDL char CDL double CDL float CDL int CDL long (deprecated) CDL real CDL short CDL, table of char double external float getting variable int NC_BYTE NC_CHAR NC_DOUBLE NC_FLOAT NC_INT NC_LONG (deprecated) NC_SHORT netCDF short signed byte sizes unsigned byte variable database management systems systems, relational dataset appending data to closing creating deleting generating via ncgen ID inquiring about opening netCDF operations reading netCDF shared, access synchronizing declaration, CDL variable default error handling fill values define mode aborting entering leaving defining attribute CDL attributes coordinate systems dimension variable definition aborting backing out of of array section restoring old deleting attribute dataset deprecated feature CDL long data type NC_LONG data type development, netCDF dimension adding CDL character-position creating ID getting unlimited information, getting inquiring about length changing getting multiple unlimited name getting syntax number of maximum variable record renaming unlimited direct access discipline-specific conventions distribution FTP access to netCDF netCDF source WWW access to netCDF documentation, HTML version of double CDL constant data type data type
edge of array section zero-length efficiency empty netCDF file enforcement, name syntax enhancements, future ensuring changes to attributes entering define mode entire variable reading writing environment variable, NETCDF_FFIOSPEC error conditions handling default messages getting suppressing returns type conversion type, prevention write example array section access CDL conventions file format global attribute extension, netCDF file external data representation types
FAN FAQ FFIO library, CRAY file data section, CDL empty extension, netCDF fixed-size data section format example specification version generating grammar header section name offsets of data sections size limitation smallest structure File Array Notation File I/O library, CRAY Flexible fill mode, setting write fill values CDL default _FillValue attribute fixed-length character-strings fixed-size data section, netCDF file Flexible File I/O library, CRAY float CDL constant data type data type floating-point IEEE values, converting flushing format archive example, file physical specification variable print version FORTRAN and C interfaces, differences between code via ncgen, generating interface FORTRAN_format attribute freely available netCDF software frequently asked questions FTP access to netCDF distribution function name conventions correspondence, netCDF-2 function prototypes summary of future enhancements
generating C code via ncgen dataset file FORTRAN code via ncgen generating code via ncgen C FORTRAN generic applications getting array section attribute information length values character-string data data dataset information dimension ID information length name error messages library version mapped array section netCDF software single value subsampled array section variable data type ID information name shape global attribute CDL example number of grammar, netCDF file grouping variables
handle handling error default HDF header section, netCDF file history data, recording of interface history attribute home page HTML documentation
I/O buffers CRAY, optimizing library, CRAY FFIO ID attribute variable dataset dimension getting unlimited netCDF variable ID,getting variable IEEE floating-point implementation include statement index order variables index mapping vector index vector indexing values information, getting on attribute on dataset on dimension on variable initializing CDL attributes CDL variables inner product inquiring about attribute dataset dimension variable installation, library int CDL constant data type data type interface backward compatibility C differences from C++ differences from FORTRAN summary of C++ changes descriptions FORTRAN history Perl [1] [2] vs. netCDF 2, netCDF 3 interval, sampling
known names
languages compatability of interfaces supported largest file size leaving define mode length attribute CDL attribute data type bit dimension changing getting maximum name variable level of support library CRAY FFIO installation linking with netCDF location UDUNITS use version, getting XDR limitation concurrent access data model file size netCDF unlimited dimension linked lists linking with netCDF library list linked mailing location, library long CDL data type (deprecated) long_name attribute loss, data
macro name conventions macro, NO_NETCDF_2 preprocessor mailing list mapped array section reading writing mapping vector, index matrices, sparse maximum attributes per variable dimensions name length records variable dimensions variables [1] [2] MAX_NC_NAME messages error getting suppressing metadata missing values missing_value attribute mode data define aborting entering leaving write fill, setting model limitations, data multiple unlimited dimensions multiple writers
name attribute CDL conventions C macro function correspondence, netCDF-2 function dimension getting known length, maximum netCDF file syntax attribute dimension enforcement variable variable, getting name attribute argument NASA CDF ncdump ncerr and ncopt elimination ncgen generating C code via generating FORTRAN code via ncopt and ncerr elimination ncrecget elimination ncrecinq elimination ncrecput elimination NCSA nctypelen elimination nc_abort nc_abort example NC_BYTE NC_BYTE data type NC_CHAR NC_CHAR data type NC_CLOBBER nc_close nc_close example nc_copy_att nc_copy_att example nc_create nc_create example nc_def_dim nc_def_dim example nc_def_var nc_def_var example nc_del_att nc_del_att example NC_DOUBLE NC_DOUBLE data type NC_EEXIST nc_enddef nc_enddef example NC_FILL NC_FILL_BYTE NC_FILL_CHAR NC_FILL_DOUBLE NC_FILL_FLOAT [1] [2] NC_FILL_INT NC_FILL_SHORT NC_FLOAT NC_FLOAT data type nc_get_att_double example nc_get_att_float nc_get_att_int nc_get_att_long nc_get_att_schar nc_get_att_short nc_get_att_text nc_get_att_uchar nc_get_var1_double nc_get_var1_double example nc_get_var1_float nc_get_var1_int nc_get_var1_long nc_get_var1_schar nc_get_var1_short nc_get_var1_text nc_get_var1_uchar nc_get_vara_double nc_get_vara_double example nc_get_vara_float nc_get_vara_int nc_get_vara_long nc_get_vara_schar nc_get_vara_short nc_get_vara_text nc_get_vara_uchar nc_get_varm_double example nc_get_varm_float nc_get_varm_int nc_get_varm_long nc_get_varm_schar nc_get_varm_short nc_get_varm_text nc_get_varm_uchar nc_get_vars_double nc_get_vars_float nc_get_vars_int nc_get_vars_long nc_get_vars_schar nc_get_vars_short nc_get_vars_text nc_get_vars_uchar nc_get_var_double nc_get_var_float nc_get_var_int nc_get_var_long nc_get_var_schar nc_get_var_short nc_get_var_text nc_get_var_uchar NC_GLOBAL nc_inq nc_inq example nc_inq_att example nc_inq_attid nc_inq_attlen nc_inq_attname nc_inq_atttype nc_inq_dim nc_inq_dim example nc_inq_dimid nc_inq_dimid example nc_inq_dimlen nc_inq_dimname nc_inq_libvers [1] [2] nc_inq_natts nc_inq_ndims nc_inq_nvars nc_inq_unlimdim nc_inq_var nc_inq_var example nc_inq_vardimid nc_inq_varid nc_inq_varid example nc_inq_varname nc_inq_varnatts nc_inq_varndims nc_inq_vartype NC_INT NC_INT data type NC_LONG data type NC_MAX_ATTRS NC_MAX_DIMS NC_MAX_NAME NC_MAX_VARS NC_MAX_VAR_DIMS NC_NOCLOBBER NC_NOFILL NC_NOWRITE nc_open nc_open example nc_put_att_double example nc_put_att_float nc_put_att_int nc_put_att_long nc_put_att_schar nc_put_att_short nc_put_att_text nc_put_att_uchar nc_put_var1_double nc_put_var1_double example nc_put_var1_float nc_put_var1_int nc_put_var1_long nc_put_var1_schar nc_put_var1_short nc_put_var1_text nc_put_var1_uchar nc_put_vara_double nc_put_vara_double example nc_put_vara_float nc_put_vara_int nc_put_vara_long nc_put_vara_schar nc_put_vara_short nc_put_vara_text [1] [2] nc_put_vara_uchar nc_put_varm_double nc_put_varm_float nc_put_varm_int nc_put_varm_long nc_put_varm_schar nc_put_varm_short nc_put_varm_text nc_put_varm_uchar nc_put_vars_double nc_put_vars_float nc_put_vars_int nc_put_vars_long nc_put_vars_schar nc_put_vars_short nc_put_vars_text nc_put_vars_uchar nc_put_var_double nc_put_var_float nc_put_var_int nc_put_var_long nc_put_var_schar nc_put_var_short nc_put_var_text nc_put_var_uchar nc_redef nc_redef example nc_rename_att example nc_rename_dim nc_rename_dim example nc_rename_var nc_rename_var example nc_set_fill nc_set_fill example NC_SHARE NC_SHORT NC_SHORT data type nc_strerror nc_sync example nc_type NC_UNLIMITED NC_WRITE nested arrays nested data structures netCDF call sequence, typical conventions data types dataset opening a reading a dataset, generating a development distribution FTP access to WWW access to file empty extension fixed-size data section format specification version generating a grammar header largest name sections size smallest structure of a function prototypes handle home page, WWW ID implementation interface history library use library, linking with limitations operations purpose software commercial freely available getting usage WWW site netCDF 2 data type coupling netCDF-2 function name correspondence interface vs netCDF-3 transition guide netCDF-3 interface vs. netCDF-2 netCDF-using code, compiling NETCDF_FFIOSPEC NETCDF_FFIOSPEC environment variable notation CDL constant NO_NETCDF_2 preprocessor macro NSSDC CDF number attribute of attribute values, getting of dimensions maximum of global attributes of records maximum written of variable dimensions, maximum [1] [2] of variables
obtaining netCDF software offset to data, file to variable, file vector, coordinate old definitions, restoring opening a dataset operating systems operations attribute dataset netCDF variable optimization platform-specific UNICOS order data index subscript
packing, data parts, netCDF file performance Perl interface [1] [2] physical file format platform-specific optimization platforms pointers [1] [2] void* portability data [1] [2] preprocessor macro, NO_NETCDF_2 prevention of type errors print format, variable problem reports, searching past product, inner prototypes summary of C function purpose, netCDF putting array section character-string data data entire variable mapped array single value subsampled array
ragged arrays random access range, valid data reading array section data character-string entire variable mapped array section netCDF dataset single value subsampled array section realCDL data type record dimension maximum number of sizes, variable variables written, number of recording data history relational database systems removing attributes renaming attributes dimensions variables reports, bug making searching archives representation, external data reserved words, CDL resolution, data restoring old definitions returns, error
safety, type sampling interval array section scalar variables scale_factor attribute scaling, data scientific data access, other software for searching past problem reports SeaSpace CDF section array corner definition edges mapped reading reading subsampled reading writing array, access example CDL file data fixed-size data netCDF file self-describing data setting write fill mode shape getting variable variable shared dataset access short CDL constant data type data type signed signed byte data type signedness attribute single value reading writing size data type bit largest file limitation, file netCDF file smallest file variable record smallest netCDF file software commercial freely available getting software for scientific data access source distribution space required for attribute sparse matrices specification, file format Standard C statement include stdio storage, data stride vector stride, array section string character fixed-length variable-length writing text, vs. byte array structure data file structures data nested subsampled array section reading writing subscript order summary of C interface support, level of supported languages suppressing error messages symbol table, variable synchronizing a dataset syntax CDL conventions, units name attribute dimension enforcement variable
table CDL data types variable symbol termination abnormal termination, abnormal text string vs. byte array title attribute trees type conversion error error prevention safety typical netCDF call seqence
UDUNITS library UNICOS optimization units and attributes and variables attribute converting syntax conventions unlimited dimension appending data along ID limitation multiple unsigned unsigned byte data type usage, netCDF use, netCDF library utilities utilities, netCDF
valid data range valid_max attribute valid_min attribute valid_range attribute value attribute getting putting CDL fill fill default floating-point, converting indexing missing reading single variable writing single variable adding appending data to attributes CDL CDL initializing characteristics coordinate creating data type data type, getting declarations, CDL dimensions, maximum number of file offset to grouping ID attribute ID, getting index information, getting inquiring about length name getting syntax number operations reading entire record record sizes renaming scalar shape getting symbol table values vs. attribute writing entire variable dimensions, maximum variable-length strings vector coordinate offset count index index mapping stride zero-valued count version library, getting netCDF file format void* void* pointers
Web, see WWW Workshop, CDF write errors write fill mode, setting writers, multiple writing array section character-string data data entire variable mapped array section single value subsampled array section WWW access to netCDF distribution netCDF home page
XDR library
zero byte zero-length edge zero-valued count vector
_FillValue attribute
Generated with Harlequin WebMaker