#data-set #variables #net-cdf #dimension #attributes #read-write #reading

netcdf3

A pure Rust library for reading and writing NetCDF-3 files

7 unstable releases

0.5.2 Feb 14, 2022
0.5.1 Dec 23, 2020
0.4.0 May 27, 2020
0.3.1 May 22, 2020
0.1.0 Apr 28, 2020

#670 in Encoding

Download history 13/week @ 2023-11-20 34/week @ 2023-11-27 16/week @ 2023-12-04 16/week @ 2023-12-18 4/week @ 2024-01-08 15/week @ 2024-01-22 7/week @ 2024-01-29 1/week @ 2024-02-05 44/week @ 2024-02-12 69/week @ 2024-02-19 51/week @ 2024-02-26 32/week @ 2024-03-04

196 downloads per month

MIT/Apache

565KB
8K SLoC

netcdf3

Crates.io Crates.io Version Documentation Build Status codecov Minimum rustc version

Description

A pure Rust library for reading and writing NetCDF-3 files.

Technical features

  • Define a NetCDF-3 data set :
    • Create, get, rename, and remove global attributes.
    • Create, get, rename, and remove dimensions.
    • Create, get, rename, and remove variables.
    • Create, get, rename, and remove variable attributes.
  • Read a NetCDF-3 file :
    • Read all data of a variable.
    • Read all data of a record (a part of a variable defined on one NetCDF-3 record).
    • Read a slice of data.
    • Read a variable's data into a N-dimensional array (using the crate ndarray).
  • Write a NetCDF-3 file :
    • Write all data of a variable.
    • Write all data of a record (a part of a variable defined on one NetCDF-3 record).
    • Write a slice of data.
    • Write a variable's data from a N-dimensional array (using the crate ndarray).

Notes

  • Validations are done by comparing files produced by this crate and files produced by the Python library netCDF4(see the Python script pyscripts/create_test_nc3_files.py and the Rust test file tests/tests_write_nc3_files.rs).
  • If the number of records numrecs is greater than std::i32::MAX then this value is considered as indeterminate and the actually written value is numrecs = 2^32 - 1(see the File Format Specifications).
  • If the chunk size of a given variable vsize is greater the std::i32::MAX then its value is considered as indeterminate and the actually written value is vsize = 2^32 - 1 (see the File Format Specifications).

Known limitations

  • Cannot read/write a subset of a variable data yet.
  • Cannot rewrite a NetCDF-3 file.

Examples

Various examples are available here.

Dependencies

~1MB
~19K SLoC