v.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