oxscape 0.1.1

Oxscape enables parallel flow graph (D8, Dinf) traversal in Digital Elevation Models
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


# Oxscape
![An Ox pulling the word "oxscape" left over soil that is (left-to-right) tilled, mulched and grows grass.](../img/oxscape.svg)

Oxscape (oxidized FastScape) is rust port and abstraction of Barnes' parallel flow graph traversal algorithm (2019) [![DOI](https://zenodo.org/badge/110618450.svg)](https://zenodo.org/badge/latestdoi/110618450). Oxscape is the ox that pulls your landscape evolution models.

```rust
use oxscape::GridMeta;
use oxscape::order_sflow::{Order, D8};

let dem: Vec<f64> = (0..1000*1000).iter().map(|v| f64::from(v)).collect()
let order = Order::from_dem_metric(GridMeta::new(1000,1000), &dem, D8);

// write your own algorithms
pub fn accum(order: &Order, cell_area: f64, accum: &mut [f64]) {
    accum.fill(cell_area);
    order.for_lvls_top_down(accum, |a| {
        *a.cell() += a.donors().iter().sum::<f64>();
    });
}

let mut flow_accumulation = vec![0.0;order.meta().size();]
// compute flow accumulation
accum(&order, 10_000.0, &mut flow_accumulation);
```


# references

Barnes, R. (2019). Accelerating a fluvial incision and landscape evolution model with parallelism. Geomorphology, 330, 28–39. https://doi.org/10.1016/j.geomorph.2019.01.002