simple_2D.c File Reference

Basic example demonstrating 2D array creation and reading in NetCDF. More...

#include <stdio.h>
#include <stdlib.h>
#include <netcdf.h>

Macros
#define	FILE_NAME   "simple_2D.nc"
#define	NDIMS   2
#define	NX   6
#define	NY   12
#define	ERRCODE   2
#define	ERR(e)   {printf("Error: %s\n", nc_strerror(e)); exit(ERRCODE);}

Functions
int	main ()

Detailed Description

Basic example demonstrating 2D array creation and reading in NetCDF.

This example shows the fundamental workflow for working with NetCDF files:

• Creating a new NetCDF file
• Defining dimensions and variables
• Writing data to variables
• Closing and reopening the file
• Reading and verifying data

The program creates a 2D integer array (6x12) with sequential values (0, 1, 2, ..., 71), writes it to a NetCDF-4 file, then reopens the file to verify both metadata and data correctness. This demonstrates the complete read-write cycle that forms the foundation of NetCDF programming.

Learning Objectives:

• Understand basic NetCDF file structure (dimensions, variables, data)
• Learn dimension and variable definition workflow
• Master data writing and reading operations
• Implement error handling patterns with nc_strerror()
• Verify metadata and data integrity

Key Concepts:

• Dimensions: Named axes that define array shapes (x=6, y=12)
• Variables: Named data arrays with defined dimensions and types
• NetCDF-4 Format: HDF5-based format with enhanced features
• Define Mode: Metadata definition phase before data writing
• Data Mode: Phase where actual data is written/read

Prerequisites: None - this is a beginner example

Related Examples:

• coord_vars.c - Adds coordinate variables and CF metadata
• f_simple_2D.f90 - Fortran equivalent of this example
• simple_nc4.c - NetCDF-4 specific features (compression, chunking)

Compilation:

gcc -o simple_2D simple_2D.c -lnetcdf

Usage:

./simple_2D
ncdump simple_2D.nc

Expected Output: Creates simple_2D.nc containing:

• 2 dimensions: x(6), y(12)
• 1 variable: data(y, x) of type int
• Data: sequential integers from 0 to 71

Author

Edward Hartnett

Date

2026-01-15

Macro Definition Documentation

ERR

#define ERR

(

e

)

{printf("Error: %s\n", nc_strerror(e)); exit(ERRCODE);}

ERRCODE

#define ERRCODE   2

FILE_NAME

#define FILE_NAME   "simple_2D.nc"

NDIMS

#define NDIMS   2

NX

#define NX   6

NY

#define NY   12

Function Documentation

main()

int main

(

)