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 '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

Files (8.6 MB)
Name Size
pyDGS-v.3.0.0.zip
md5:3721e46de5e130c59b2fffd0130f687a
8.6 MB Download
176
18
views
downloads
All versions This version
Views 176108
Downloads 187
Data volume 650.0 MB60.3 MB
Unique views 164102
Unique downloads 166

Share

Cite as