pyDGS: version 3.0.0

In this release, there are two programs: the original 'dgs_class.py' which works the same as before but with more user options (see below), and a new 'dgs_web' program which takes a single image (file path name) and returns a dictionary object of results per image

Both programs now take the following optional inputs [default values][range of acceptable values]:

density = process every density lines of image [10] [1 - 100]

resolution = spatial resolution of image in mm/pixel [1] [>0]

dofilter = spatial resolution of image in mm/pixel [1] [0 or 1]

notes = notes per octave to consider in continuous wavelet transform [8] [1 - 8]

maxscale = maximum scale (pixels) as an inverse function of data (image row) length [8] [2 - 40]

The dgs program also has the option:

doplot = if 1, create a plot of results [1] [0 or 1]

The dgs_web program also has the option:

verbose = if 1, print stuff to screen [0] [0 or 1]

The dgs_web program (or the dgs program with a single input image) returns a dictionary object containing the following key/value pairs:

1. mean grain size: arithmetic mean grain size

2. grain size sorting: arithmetic standard deviation of grain sizes

3. grain size skewness: arithmetic skewness of grain size-distribution

4. grain size kurtosis: arithmetic kurtosis of grain-size distribution

5. percentiles: 5th, 10th, 16th, 25th, 50th, 75th, 84th, 90th, and 95th percentile of the cumulative grain size (% less than) particle size distribution

6. grain size frequencies: the normalised frequencies associated with 'grain size bins'

7. grain size bins: grain size values at which the distribution is evaluated