#csv #multidimensional-array #2d #data #read-write #homogeneous #ndarrays

ndarray-csv

Easily read and write homogeneous CSV data to and from 2D ndarrays

11 releases

Uses old Rust 2015

0.5.2 May 4, 2023
0.5.1 Apr 25, 2021
0.5.0 Jan 30, 2021
0.4.1 Mar 6, 2020
0.3.1 Oct 30, 2018

#138 in Graphics APIs

Download history 702/week @ 2023-12-16 400/week @ 2023-12-23 417/week @ 2023-12-30 993/week @ 2024-01-06 966/week @ 2024-01-13 576/week @ 2024-01-20 554/week @ 2024-01-27 883/week @ 2024-02-03 996/week @ 2024-02-10 886/week @ 2024-02-17 704/week @ 2024-02-24 887/week @ 2024-03-02 605/week @ 2024-03-09 744/week @ 2024-03-16 965/week @ 2024-03-23 1078/week @ 2024-03-30

3,491 downloads per month
Used in 24 crates (11 directly)

MIT/Apache

14KB
244 lines

ndarray-csv

Easily read and write homogeneous CSV data to and from 2D ndarrays.

extern crate csv;
extern crate ndarray;
extern crate ndarray_csv;

use csv::{ReaderBuilder, WriterBuilder};
use ndarray::{Array, Array2};
use ndarray_csv::{Array2Reader, Array2Writer};
use std::error::Error;
use std::fs::File;

fn main() -> Result<(), Box<dyn Error>> {
    // Our 2x3 test array
    let array = Array::from(vec![1, 2, 3, 4, 5, 6]).into_shape((2, 3)).unwrap();

    // Write the array into the file.
    {
        let file = File::create("test.csv")?;
        let mut writer = WriterBuilder::new().has_headers(false).from_writer(file);
        writer.serialize_array2(&array)?;
    }

    // Read an array back from the file
    let file = File::open("test.csv")?;
    let mut reader = ReaderBuilder::new().has_headers(false).from_reader(file);
    let array_read: Array2<u64> = reader.deserialize_array2((2, 3))?;

    // Ensure that we got the original array back
    assert_eq!(array_read, array);
    Ok(())
}

This project uses cargo-make for builds; to build, run cargo make all.

To prevent denial-of-service attacks, do not read in untrusted CSV streams of unbounded length; this can be implemented with std::io::Read::take.

License: MIT/Apache-2.0

Dependencies

~3MB
~47K SLoC