xmsstamper

Table of Contents

• xmsstamper
  • Introduction
  • License
  • Features
  • Testing
  • The Code
    • Namespaces
    • Interface pattern
  • "xmsstamper" Name

xmsstamper

Introduction

xmsstamper is a cross-platform C++ software library written by Aquaveo in partnership with ERDC. The code can be obtained from github.com.

License

The code is distributed under the xmsng Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.aquaveo.com/xmsng/LICENSE_1_0.txt).

Features

xmsstamper includes the following functionality:

• Insert man-made structures into a natural topography or bathymetry set. In common terms, this means adding an embankment (such as a levy) or dredging a channel. A stamped feature usually follows a linear object or centerline. However, it can also be based around a single point to create a mound or pit, or applied to only one side of a closed line (a polygon) to create a flat topped mound or flat bottomed pit.

The following tutorial is available:

• Stamper tutorial

Testing

The code has numerous unit tests which use the CxxTest framework. A good way to see how to use the code is to look at the unit tests. Unit tests are located at the bottom of .cpp files within a "#if CXX_TEST" code block. Header files that are named with ".t.h" contain the test suite class definitions.

The Code

Namespaces

• "xms" - Most code is in this namespace. The use of other namespaces is kept to a minimum. Two-letter prefixes are used as "pseudo-namespaces" in code modules. Preprocessor macros typically start with "XM_" to prevent name collisions.
• "xmt" - Testing code will be put into this namespace once CXX_TEST is upgraded such that it will find the testing code in this namespace.

Interface pattern

Many classes follow the interface pattern. An abstract base class is used to define the interface and a concrete implementation class is used to implement the functionality. The implementation class will be named the same as the interface class but will end in "Impl" and will only be found in the .cpp file. For example: xms::InterpIdw and xms::InterpIdwImpl. The Doxygen documentation will be for the Impl class.

More about the interface pattern can be found at the following resources:

• The C++ Programming Language, Stroustroup, p 318 - 322
• Effective C++ Third Edition, Meyers, items 31 and 40
• More Effective C++, Meyers, item 33
• Large-Scale C++ Software Design, Lakos, 6.4.1

"xmsstamper" Name

The name "xmsstamper" comes from the "XMS" (GMS, SMS, WMS) water modeling software created by Aquaveo.