cifar-ten 0.2.0

Parses the CIFAR-10 dataset binary files, and returns them as a Rust ndarray tuple
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

[![crates.io](https://img.shields.io/crates/v/cifar-ten.svg)](https://crates.io/crates/cifar-ten)
[![Documentation](https://docs.rs/cifar-ten/badge.svg)](https://docs.rs/cifar-ten)

## cifar-ten

Parses the binary files of the CIFAR-10 data set and returns them as a pair of tuples `(data, labels)` with of type and dimension:
- Training data:  `Array4<u8> [50_000, 3, 32, 32]` and `Array2<u8> [50_000, 10]` 
- Testing data:  `Array4<u8> [10_000, 3, 32, 32]` and `Array2<u8> [10_000, 10]` 

**OR** 

- as a set of flattened `Array2<f32>` structures in the same arrangement. 

A random image from each dataset and the associated label can be displayed upon parsing. A `tar.gz` file with the original binaries can be found [here](https://www.cs.toronto.edu/~kriz/cifar.html). This can be download manually, or automatically using the `download` feature. 

```rust
use cifar_ten::*;

fn main() {
    let (train_data, train_labels, test_data, test_labels) = Cifar10::default()
        .show_images(true)
        .download_and_extract(true) // must enable the "download" feature
        .build()
        // or .build_as_flat_f32()
        .expect("Failed to build CIFAR-10 data");
}
```
To add as a dependency, please use:

```toml
[dependencies]
cifar-ten = "0.1"
```
Note: Previous commits have included the dataset, which will make the download size large. For development, it's suggested to 
```
$ git clone --depth=1 https://github.com/quietlychris/cifar-ten.git
```