# Introduction - iPeriGrain is a software designed to delineate the perimeter of gravel grains in 2D images via interactive manner with assistance of marker controlled watershed segmentation. - The parameters, listed below, of each grains are extracted by fitting ellipse to the delineated perimeters. - a-axis - b-axis - center of grain - rotation of a-axis - Two kinds of 2D images are acceptable: - Photograph taken by handheld camera at the gravel surface (.jpg) ![](https://i.imgur.com/1W1F6IV.jpg) Image courtesy of BASEGRAIN (https://basement.ethz.ch/download/tools/basegrain.html). - DEM of gravel surface (.tif) ![](https://i.imgur.com/DLf0l8m.png) Adapted from *Fu-Chun Wu, Chi-Kuei Wang, & Guo-Hao Huang (2018). Delineation of gravel-bed clusters via factorial kriging. Geomorphology. 161-174* - iPeriGrain is based on OpenCV and developed with JAVA. # Requirement - RAM: At least 2G - [JAVA Version must be 1.8.0_211，64-Bit](https://www.java.com/en/download/manual.jsp) - Both filenames and pathnames must be in English.