# netcdfjs

> Read and explore NetCDF files

Latest version **4.0.0** (published 2026-03-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install netcdfjs
pnpm add netcdfjs
yarn add netcdfjs
bun add netcdfjs
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 4.0.0 |
| Published | 2026-03-06 |
| First published | 2016-10-31 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 64.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 164 |
| Author | Miguel Asencio |
| Maintainers | targos, lpatiny, cheminfo-bot, stropitek, maasencioh |
| Keywords | netcdf, nc, data, format |

## Links

- npm: https://www.npmjs.com/package/netcdfjs
- Repository: https://github.com/cheminfo/netcdfjs
- Issues: https://github.com/cheminfo/netcdfjs/issues
- npm.io page: https://npm.io/package/netcdfjs

## Dependencies (1)

- [iobuffer](https://npm.io/package/iobuffer.md) ^6.0.1

## Alternatives

- [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads
- [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads
- [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads
- [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads
- [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads

## Recent versions

- 4.0.0 (latest) — 2026-03-06
- 3.0.0 — 2023-08-09
- 2.0.2 — 2022-10-21
- 2.0.1 — 2021-09-07
- 2.0.0 — 2021-09-07
- 1.0.0 — 2019-06-16
- 0.7.0 — 2018-11-11
- 0.6.0 — 2018-11-05
- 0.5.0 — 2018-11-05
- 0.4.1 — 2018-11-05
- 0.4.0 — 2018-11-05
- 0.3.3 — 2018-11-02
- 0.3.2 — 2018-11-02
- 0.3.1 — 2017-06-07
- 0.3.0 — 2016-11-03
- … 2 more at https://npm.io/package/netcdfjs/versions

## README

# netcdfjs

[![NPM version][npm-image]][npm-url]
[![build status][ci-image]][ci-url]
[![Test coverage][codecov-image]][codecov-url]
[![npm download][download-image]][download-url]

Read and explore NetCDF v3 files.

## Installation

`$ npm install netcdfjs`

## [API Documentation](https://cheminfo.github.io/netcdfjs/)

For further information about the grammar you should go to [this link](https://www.unidata.ucar.edu/software/netcdf/docs/file_format_specifications.html).

### Example

```js
const { readFileSync } = require("fs");
const { NetCDFReader } = require("netcdfjs");

// http://www.unidata.ucar.edu/software/netcdf/examples/files.html
const data = readFileSync("madis-sao.nc");

var reader = new NetCDFReader(data); // read the header
reader.getDataVariable("wmoId"); // go to offset and read it
```

## License

[MIT](./LICENSE)

[npm-image]: https://img.shields.io/npm/v/netcdfjs.svg
[npm-url]: https://www.npmjs.com/package/netcdfjs
[ci-image]: https://github.com/cheminfo/netcdfjs/workflows/Node.js%20CI/badge.svg?branch=main
[ci-url]: https://github.com/cheminfo/netcdfjs/actions?query=workflow%3A%22Node.js+CI%22
[codecov-image]: https://img.shields.io/codecov/c/github/cheminfo/netcdfjs.svg
[codecov-url]: https://codecov.io/gh/cheminfo/netcdfjs
[download-image]: https://img.shields.io/npm/dm/netcdfjs.svg

---
_Source: https://npm.io/package/netcdfjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._