---
# System prepended metadata

title: Introduction

---

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