Skip to content

namo626/adcirc

 
 

Repository files navigation

ADCIRC

CircleCI License: LGPL v3 Docker Image Version (tag)

ADCIRC is a system of computer programs for solving time dependent, free surface circulation and transport problems in two and three dimensions. These programs utilize the finite element method in space allowing the use of highly flexible, unstructured grids. Typical ADCIRC applications have included:

  • Prediction of storm surge and flooding
  • Modeling tides and wind driven circulation
  • Larval transport studies
  • Near shore marine operations
  • Dredging feasibility and material disposal studies

ADCIRC has been used around the world for various studies, including those conducted by the United States Army Corps of Engineers (USACE), Federal Emergency Management Agency (FEMA), National Oceanographic and Atmospheric Administration (NOAA), and many others.

Authors

  • Joannes Westerink, University of Notre Dame
  • Rick Luettich, University of North Carolina at Chapel Hill

Development Group

  • Brian Blanton - RENCI
  • Shintaro Bunya - University of North Carolina at Chapel Hill
  • Zachary Cobell - The Water Institute of the Gulf
  • Clint Dawson - University of Texas at Austin
  • Casey Dietrich - North Carolina State University
  • Randall Kolar - University of Oklahoma at Norman
  • Chris Massey - US Army Corps of Engineers Research and Development Center, Coastal and Hydraulics Laboratory

Gallery

Louisiana ADCIRC model simulating Hurricane Katrina storm surge and waves developed by The Water Institute of the Gulf.

Hurricane Katrina Simulation

ADCIRC mesh in the Chesapeake Bay area used for the FEMA Coastal Storm Surge Study

ADCIRC mesh in the Chesapeake Bay area used for the FEMA Coastal Storm Surge Study

Versions

Code versions are published based on semantic versioning as of version 56. Prior to that, ADCIRC used a two level versioning scheme, though it approximately mirrors semantic versioning.

Documentation

Documentation is presently undergoing upgrades, however, the main documentation locations for users are:

  1. ADCIRC website
  2. ADCIRC Wiki

Docker Containers

To help new users get spun up quickly with the ADCIRC model, ADCIRC is provided as Linux Docker containers and pushed to DockerHub. New images are published either when a new version is released or the main branch has changes. The DockerHub repository is located here. Images may be used with Docker Desktop or Singularity on x86 or ARM CPUs on Windows, Mac, and Linux.

Images are tagged for release versions (using semantic versioning) as well as the current state of the main branch as "latest". By default, a release tag should be used and only use latest to try the newest version of the code. The ADCIRC Docker images are distributed under the same license and conditions as this repository.

Images built for x86 systems use the IntelLLVM compiler while images build for ARM CPUs use the GCC compiler, version 14.2. The x86 base image is the same that is used to build ADCIRC during continuous integration testing.

Examples

The ADCIRC testing repository doubles as a set of examples which can be used for new users to become acquainted with the model. Since version 55, the branches are annotated with the expected version numbers that would allow the tests to run successfully.

About

ADCIRC Model Repository

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Fortran 96.1%
  • CMake 2.1%
  • Makefile 1.6%
  • Python 0.1%
  • Dockerfile 0.1%
  • C 0.0%