readap 0.1.0

A parser for the OpenDAP DAP2 protocol
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# readap

Read OpenDAP binary data with pure rust

## Install

with `cargo add`: 

```bash
cargo add readap
```

or `Cargo.toml`: 

```toml
[dependencies]
readap = "0.1.0"
```

## Getting Started

#### Read DAS metadata

```rs
let attrs = parse_das_attributes(input).unwrap();
```

This returns a `HashMap` containing all of the attributes and their children, within another hashmap

```rs
let units: String = attrs["time"]["units"].clone().try_into().unwrap();
```

### Read a DDS dataset

```rs
let dataset = DdsDataset::from_bytes(&input).unwrap();
```

### Read a DODS dataset

```rs
let dataset = DodsDataset::from_bytes(&input).unwrap();
```

Then extract the data and coordinates for a given variable

```rs
let mwd = if let DataArray::Int32(mwd) = dataset.variable_data("mean_wave_dir").unwrap() {
   	mwd
} else {
    vec![]
};

let coords = dataset.variable_coords("mean_wave_dir").unwrap();
let time_data: Vec<i32> = coords[0].1.try_into().unwrap();
```

For concrete examples, see the [parse tests](tests/parse.rs)

## What this library is

This library is an OpenDAP binary data and metadata parser. It *is not* a data downloader. It is a lower level tool to be used in higher level data access applications. 

## License

[MIT](LICENSE) - 2025 Matthew Iannucci