Open source geotechnical analysis tools
The lab package contains tools for laboratory and index testing.
A grain size analysis, or sieve test, helps to characterize the distribution of particles in a sample of soil. See Sieve analysis.
To calculate the results of a sieve test, create a variable of type SieveTest:
t := lab.SieveTest{}the SieveTest type holds some important information about the sample being tested:
t.InitialMass = 2100.0 // grams
t.DryMass = 2000.0
t.WashedMass = 1900.0 Add weighed sieves (collected as user input after performing the test):
t.AddSieve(20, 0) // 20 mm, 0 g retained
t.AddSieve(16, 255.5) // 16 mm, 255.5 g retained
t.AddSieve(12, 172.9)
t.AddSieve(5, 194.1)Adding one sieve large enough to not capture any soil is important for plotting. In our example above, the 20 mm sieve has a retained weight of 0.
Finally, calculate the results:
t.Passing()To run unit tests, enter the lab directory and run go test.