/extract-boundary

Extract boundary of 2D grids

Primary LanguageC++OtherNOASSERTION

Extract Boundary

This program extracts all inner and outer boundaries of 2D grids and identifies zero-velocity boundary points. Moreover, inward or outward normal vectors on boundary points are calculated. You can use 2D grids with any type of cell and various file extensions such as *.vtk and *.vtu.

User Guide

Please refer to Documentation page or doc/UserGuide.pdf.

Quick installation

You may install by building source or getting the ready package from Ubuntu repos.

1. Building from source

Just download the installer and do the following:

$ sudo chmod +x installer
$ sudo ./installer

2. Ubuntu Package

For Ubuntu users, the package has been added to the Ubuntu repository. Type in terminal:

$ sudo add-apt-repository ppa:ameli/extractboundary
$ sudo apt-get update
$ sudo apt-get install extractboundary

Sample Usage

You may use the code either in command line or as a ParaView plugin.

1. Command Line

  • Specifying input and output paths within files:

    $ extractboundary /InputPath/InputData.vtk /OutputPath/OutputData.vtk

  • No output file is specifies. Default name will be used for output file:

    $ extractboundary InputData.vtk

  • Using options:

    • outward normals (with -n)
    • search all inner and outer boundaries (with -s)
    • identify zero-velocity points (with -z)

    $ extractboundary InputData.vtk OutputData.vtk -n outward -s all -z

2. ParaView Plugin

In ParaView, from tools menu open Manage Plugins. Then load bin/libExtractBoundary.so file. Next, in Filters menu go to Extensions and apply Extract Boundary filter to your pipeline.

You may refer to UserGuide or wiki for picture illustrations.

License

Its free and open source under GNU/zlib license. Please see LICENSE.txt for terms.

Author

Siavash Ameli
Shadden Research Group
University of California, Berkeley