Tutorials

Ten notebooks, narrative first. Each explains the hydrochemistry, then shows the code, then says what the result means — and ends with a self-contained snippet to paste into your own project.

They are executed when these pages are built, so every number and figure you see below was produced by the code shown above it.

• 00 · Quickstart
• 01 · Real data, units and quality control
• 02 · EMMA: how many source waters, and which species behave as a mixture?
• 03 · Mixing ratios: how much of each source is in each sample
• 04 · MIX: when the end-members are uncertain
• 05 · Uncertainty and identifiability
• 06 · Reading reactions out of the residuals
• 07 · A complete analysis, start to finish
• 08 · Isotope tracers, and the one that breaks linear mixing
• 09 · Fifty years of acid rain, and the assumption that broke

Where to start

• New to the library, but not to the methods — 00 · Quickstart, then 02 · EMMA: how many source waters, and which species behave as a mixture?.

• New to mixing analysis — read 01 · Real data, units and quality control, 02 · EMMA: how many source waters, and which species behave as a mixture? and 03 · Mixing ratios: how much of each source is in each sample in order. Those three assume no prior knowledge of the method and build it up: what mixing analysis is and what makes an analysis usable, how the number of source waters is counted, and how the proportions are computed.

• You have uncertain end-members — 04 · MIX: when the end-members are uncertain, which is the method this library exists for.

• You use isotopes — 08 · Isotope tracers, and the one that breaks linear mixing, and read it before you trust a δ¹³C result.

• You want the whole workflow in order — 07 · A complete analysis, start to finish.