billios 0.1.1

A soil library
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# billios - A Soil Library

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/travisbaars/billios/integrate.yml?branch=main&logo=github)
![Crates.io Version](https://img.shields.io/crates/v/billios)
![docs.rs](https://img.shields.io/docsrs/billios)

This crate is a collection of soil related data structures and formulae.

## Installation

Standard functionality, no additional dependencies are required:

```toml
[dependencies]
billios = "0.1.1"
```

Alternatively, you can install using the `cargo add` command:

```bash
cargo add billios
```

## Code Examples

### Example - Sand Used

Using this formula only requires a couple lines of code.

Simply call the `new()` method with the desired values, then call `calculate()` to retrieve the result.

#### Use with constant `sand_in_cone` value:

```rust
use billios::math::calculations::*;

// This constructor  takes 3 arguments:
//
// cone_pre_test, cone_post_test, sand_in_cone
//
// The first two are straight forward; two float values.
// For the third we use the `None` option. The reason for this
// is becouse the `sand_in_cone` argument is a constant (mostly).
// In general this value does not change often, so we don't have to worry
// about setting it. Instead we just use `None`. If for some reason you
// needed to change the value, you simple pass in a `Some(<f64>).
let sand_used = SandUsed::new(14.65, 8.75, None);

// In order to get the calculated value we call the `calculate()` method:
let result = sand_used.calculate();

assert_eq!(2.31, result);
```

#### Use with a custom `sand_in_cone` value:

```rust
use billios::math::calculations::*;

let sand_used = SandUsed::new(14.65, 8.75, Some(3.59));
let result = sand_used.calculate();

assert_eq!(2.31, result);
```

### Example - Compaction

Using this formula can a little more complicated than the last example. However it is still pretty straghtforward.

#### Use with a pre-existing `dry_density` value:

Coming soon...

## Todo

- [x] Implement GitHub Action workflow
- [x] Create first deployment to crates.io
- [ ] Improve `README.md`
  - [x] Add the build/crates.io/docs badges
- [ ] Complete documentation
  - [x] Need basic docs atleast for crates.io
  - [ ] `lib.rs` needs attention
- [ ] Add `Setter()` methods to calculation structs
- [ ] Possibly change choice enums (ex. `SandUsedChoices`) to `SandUsedOption`
- [ ] Rework the public API. Namely how things like `domain::types` are accessed
- [ ] More calculations?
- [ ] Rename `utilities.rs`?
- [ ] Rename `calculations.rs` to `field_test.rs`?