There is a newer version of this record available.

Software Open Access

pyDGS: version 3.0.0

Daniel Buscombe

In this release, there are two programs: the original '' 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

Files (8.6 MB)
Name Size
8.6 MB Download
All versions This version
Views 176108
Downloads 187
Data volume 650.0 MB60.3 MB
Unique views 164102
Unique downloads 166


Cite as