scientific-method 0.2.0

The parts of the scientific method used to define and evaluate experiments.
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

# scientific-method

The parts of the scientific method used to define and evaluate experiments.

`scientific-method` models questions, hypotheses, predictions, independent and dependent variables, controls, observations, measurements, criteria, and conclusions. It does not run experiments or know about repositories, commands, files, or benchmarks.

Criteria are machine-evaluable and can be composed. A method evaluates its declared criteria against observations and concludes `supported`, `not_supported`, or `inconclusive`. That scientific conclusion is intentionally separate from any later decision to accept, promote, or retain an implementation.

```rust
use scientific_method::{
    Criterion, Direction, Hypothesis, Measurement, Observation, ObservationRef,
    Observations, ScientificMethod,
};

let method = ScientificMethod::new(Hypothesis::new("the candidate lowers latency"))
    .criterion(Criterion::improvement(
        ObservationRef::new("baseline", "latency"),
        ObservationRef::new("candidate", "latency"),
        Direction::LowerIsBetter,
        0.05,
    ));

let observations = Observations::new()
    .with(Observation::new("baseline", Measurement::new("latency", 100.0)))
    .with(Observation::new("candidate", Measurement::new("latency", 90.0)));

let evaluation = method.evaluate(&observations)?;
assert!(evaluation.criteria[0].passed);
# Ok::<(), scientific_method::CriterionError>(())
```

## Serde

Serialization is optional:

```toml
scientific-method = { version = "0.2", features = ["serde"] }
```

The crate keeps serialization separate from execution so experiment frameworks can choose their own file formats and storage.

## Releasing

Bump `version` in `Cargo.toml`, add a dated `## <version> (YYYY-MM-DD)` entry to `CHANGELOG.md`, and push to `main`. CI tests stable and Rust 1.89, runs clippy, and publishes a version that is not already on crates.io through trusted publishing.

## Ownership

Developed and published by James Hunt. Repository: https://github.com/jameshuntt/scientific-method.

## License

MIT OR Apache-2.0