npy 0.1.0
Read and write NumPy binary files (.npy and .npz formats) in Dart.
Read and write NumPy binary files (.npy and .npz) in Dart.
Usage
Load an ndarray from an .npy file:
final ndarray = await NdArray.load('example.npy');
Create an ndarray and save it as an .npy file:
final ndarray = NdArray.fromList([1.0, 2.0, 3.0]);
await ndarray.save('example_save.npy');
Conveniently save an n-dimensional List to an .npy file:
await save('example_save.npy', [[1, 2, 3], [4, 5, 6]]);
Read (compressed) .npz files:
final npzFile = await NpzFile.load('example.npz');
final arr_0 = npzFile.take('arr_0.npy');
final arr_1 = npzFile.take('arr_1.npy');
Write (compressed) .npz files:
final array1 = NdArray.fromList([1.0, 2.0, 3.0]);
final array2 = NdArray.fromList([[true, false, true]]);
final npzFile = NpzFile();
npzFile.add(array1);
npzFile.add(array2);
await npzFile.save('example_save.npz');
Features
Load and save n-dimensional arrays from and to the following file formats:
✅ .npy
✅ .npz (compressed and uncompressed)
Supported data types:
✅ float64, float32
✅ int64, int32, int16, int8
✅ uint64, uint32, uint16, uint8
✅ bool
Supported memory representations:
✅ Little and big endian
✅ C and Fortran order
Tests
dart test will run integration tests, too, so make sure to have python and numpy installed and python available in your system's PATH.
Contribute
- Feel free to create an issue in case you found a bug, have any questions or want to propose new features.
- Please check open issues before creating a new one.
- Make sure to satisfy formatter, analyzer and tests when opening a pull request.
Further Reading
More information on the .npy format can be found here.
License
You can use, redistribute and/or modify the code under the terms of the MIT License.