This library allows to save and load BQN arrays to the binary NPY format compatible with Numpy. It can also be used to interoperate with Numpy.
See also bqn-safetensors for another array serialization format.
The library only support homogeneous multidimensional arrays with the following Numpy dtypes:
| dtype | Description |
|---|---|
<f8 | little-endian 64-bit double-precision floating point number |
<i4 | little-endian 32-bit signed integer |
<u4 | little-endian 32-bit unsigned integer |
All other dtypes (big-endian numbers, booleans, bytes, objects, other sizes of floats or integers) are unsupported and files containing them will raise an error when loaded.
When serializing BQN arrays, the library uses the most restrictive
dtype possible. An array consisting only of positive integers will be
saved as <u4, otherwise <i4 if there are negative integers,
otherwise <f8 for arbitrary numbers.
⟨SaveNpy,LoadNpy⟩←•Import"npy.bqn"
# Deserialization
arr1←LoadNpy"arr1.npy"
# Serialization
arr2←2‿3‿4⥊•rand.Range 0 # will be saved as a floating point array
"arr2.npy" SaveNpy arr2Run the Python script to generate test data: python gentest.py.
To run tests, run bqn tests.bqn.