CREST

Table of Contents

• Brief description
• Building CREST
• Dependencies
• Third party components
• Typical use
• Full description
• Documentation
• License

Brief description

CREST - Computational Resource for Eroded Surface Topology - is designed to generate numerical rough surfaces that respect:

• size: $n \times m$ regular grid
• statistical moments: Skewness $Ssk$ and Kurtosis $Sku$
• principal correlation lengths: $\tau_1$ and $\tau_2$
• asperity orientation: $\alpha$ angle
• periodicity: with/without

The programs are written in recent Fortran (2003+)

top

Building CREST

Make sure that the dependencies described below are built.

Debug mode:

make debug

Normal mode:

make

Dependencies

CREST needs some components that are available through the following packages:

• TOOLIB … Some general tools like FFT, file handling, minimization, sorting, etc.

• TPGLIB … Some more specific programs like filtering, anisotropy analysis, derivation, etc.

As a consequence the three packages have to be downloaded.

top

Third party components

TOOLIB also uses external codes such as:

• FFTW3.3 … Fastest Fourier Transform in the West … GNU General Public License

• Pikaia_oop … Modern Fortran Edition of the Pikaia Genetic Algorithm … BSD like

• GNUFOR … Gnuplot Fortran … GNU General Public License

• Bspline-fortran … Multidimensional B-Spline Interpolation of Data on a Regular Grid … BSD like

.sur surface files can be visualized and analyzed with Gwyddion software, a modular program for SPM (scanning probe microscopy) data visualization and analysis.

Typical use

The program main reads a script file my_script.md where the following parameters are defined:

• image size (pix)
• surface size (m)
• periodicity
• correlation lengths
• roughness orientation
• number of available threads
• statistical parameters
• output surface name
• …

as well as the algorithm for rough surface generation.

Run:

./main cfg/my_script.md

top

Full description

Test 1

Run:

./main cfg/test01.md

Result: test01_img

Test 2

Run:

./main cfg/test02.md

Result: test02_img

top

Documentation

The documentation is automatically generated with FORD, an automatic documentation generator for modern Fortran programs.

top

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but without any warrenty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see the GNU website.