Also known as
Model type Tool
Model part of larger framework
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 2D
Spatial extent Regional-Scale
Model domain Coastal, Marine
One-line model description A graphical Matlab interface to the C language 2-D quality finite element grid generator Triangle.
Extended model description BATTRI does the mesh editing, bathymetry incorporation and interpolation, provides the grid generation and refinement properties, prepares the input file to Triangle and visualizes and saves the created grid.
Name Jonathan Shewchuk
Type of contact Model developer
Institute / Organization University of California at Berkeley
Postal address 1 625 Soda Hall, Computer Science Division
Postal address 2
Town / City Berkeley
Postal code 94720
State California
Country United States
Email address
Phone 510-642-3936
Fax 510-642-3962

Supported platforms
Linux, Windows
Other platform
Programming language


Other program language
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development
Does model development still take place? Yes
If above answer is no, provide end year model development
Code development status
When did you indicate the 'code development status'?
Model availability
Source code availability
(Or provide future intension)
Through web repository
Source web address
Source csdms web address
Program license type Other
Program license type other
Memory requirements
Typical run time

Describe input parameters To generate a grid, the user should input the boundary node information, boundary segment information and hole (or island) information in form of a .poly file, as described in the Triangle manual ( These input nodes and segments in the .poly file are forced into the triangulation of the domain. Alternatively (and this is a strong point of BATTRI), all this information can be created from only a bathymetric dataset with the use of the editing options of BATTRI (see Option 0 in Running BATTRI section). This process may require manual deleting of unnecessary segments and nodes, closing of islands by segment adding, addition of an open ocean boundary segment, etc.

As a starting point, ordered digital coastline node data can be extracted from the National Geophysical Data Center's webpage ( at various scales ranging from 1:70,000 to 1:5,000,000. If the coastline is very highly resolved, causing an excessive number of elements along the shoreline, the routine "xy_simplify.m" can be used to reduce the number of nodes to the desired resolution. Remember to format this data into a .poly file, consisting of nodes and segments, before inputting into BATTRI. To refine an already created grid, the user can input the above referenced information either in the form of a previously created .poly file or in the form of NML standard .nod, .ele and .bat files (see next section, Running BATTRI).

Input format ASCII
Other input format
Describe output parameters
Output format
Other output format
Pre-processing software needed? No
Describe pre-processing software
Post-processing software needed? No
Describe post-processing software
Visualization software needed? No
If above answer is yes
Other visualization software

Describe processes represented by the model
Describe key physical parameters and equations
Describe length scale and resolution constraints
Describe time scale and resolution constraints
Describe any numerical limitations and issues

Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing

Do you have current or future plans for collaborating with other researchers?
Is there a manual available? Yes
Upload manual if available: Media:BATTRI 2-D TRIANGULAR GRID GENERATOR.pdf
Model website if any
Model forum / discussion board

This part will be filled out by CSDMS staff

OpenMI compliant No but possible
BMI compliant No but possible
WMT component No but possible
PyMT component
Is this a data component
Can be coupled with:
Model info
Jonathan Shewchuk
Nr. of publications: 1
Total citations: 37
h-index: 1
m-quotient: 0.06
Qrcode BatTri.png
Link to this page




Nr. of publications: 1
Total citations: 37
h-index: 1
m-quotient: 0.06

Featured publication(s)YearModel describedType of ReferenceCitations
Bilgili, Ata; Smith, Keston W.; Lynch, Daniel R.; 2006. BatTri: A two-dimensional bathymetry-based unstructured triangular grid generator for finite element circulation modeling. Computers & Geosciences, 32, 632–642. 10.1016/j.cageo.2005.09.007
(View/edit entry)
2006 BatTri
Model overview 37
See more publications of BatTri



Input Files

Output Files