adcirc

ADCIRC Model Repository

https://github.com/adcirc/adcirc

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    24 of 47 committers (51.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.8%) to scientific vocabulary

Keywords from Contributors

adcirc cyclones gcc gfortran hurricane intel intel-oneapi openmp oracle-cloud redhat
Last synced: 10 months ago · JSON representation

Repository

ADCIRC Model Repository

Basic Info
  • Host: GitHub
  • Owner: adcirc
  • License: other
  • Language: Fortran
  • Default Branch: main
  • Homepage: https://adcirc.org
  • Size: 66.7 MB
Statistics
  • Stars: 58
  • Watchers: 18
  • Forks: 23
  • Open Issues: 70
  • Releases: 33
Created about 10 years ago · Last pushed 10 months ago
Metadata Files
Readme Contributing License Codeowners

README.md

ADCIRC

CircleCI License: LGPL v3 Docker Image Version (tag) Documentation

ADCIRC is a system of computer programs for solving time-dependent, free surface circulation and transport problems in two and three dimensions. These programs use 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 documentation
  2. ADCIRC website
  3. ADCIRC Wiki

Contributors are actively consolidating information from ADCIRC website and ADCIRC Wiki into ADCIRC documentation to provide comprehensive, up-to-date information about ADCIRC.

Contributing

ADCIRC is an open source project and contributions are welcome. Please see the CONTRIBUTING.md file for more information on how to contribute to the project.

The high-level summary is: 1. Run pre-commit install to install pre-commit hooks in your development environment. Pre-commit can be installed using pip install pre-commit. 2. New source files should have a "*.F90" extension 3. All new code should contain Doxygen-style comments 4. Developers are encouraged to compile their code using the GCC compilers (even if this is not their typical development environment) with -DADCIRC_DEVELOPER_MODE=ON to ensure that the code will build in the CI environment with strict checks 5. Developers should avoid adding new variables to the GLOBAL module unless absolutely necessary

Requirements

ADCIRC minimally requires a C and Fortran compiler that minimally meet the following specifications: * C compiler: C11 standard * Fortran compiler: Fortran 2008 standard

ADCIRC has been tested with the following compilers: * GNU Compiler Collection (GCC) * Intel Classic Compilers * Intel OneAPI Compilers/IntelLLVM * NVIDIA HPC Compilers (nvc/nvfortran) * LLVM (clang/flang)

Additional features, including MPI parallelism and netCDF output require additional libraries: * MPI (Message Passing Interface)—OpenMPI, MVAPICH2, Intel MPI, or other MPI implementations * netCDF—netCDF C and Fortran libraries

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 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.

Owner

  • Name: ADCIRC Development Group
  • Login: adcirc
  • Kind: organization
  • Location: Chapel Hill, North Carolina

Development team for the ADCIRC Model

GitHub Events

Total
  • Create event: 44
  • Release event: 1
  • Issues event: 29
  • Watch event: 18
  • Delete event: 30
  • Issue comment event: 46
  • Push event: 276
  • Pull request review event: 5
  • Pull request review comment event: 3
  • Pull request event: 63
  • Fork event: 8
Last Year
  • Create event: 44
  • Release event: 1
  • Issues event: 29
  • Watch event: 18
  • Delete event: 30
  • Issue comment event: 46
  • Push event: 276
  • Pull request review event: 5
  • Pull request review comment event: 3
  • Pull request event: 63
  • Fork event: 8

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 997
  • Total Committers: 47
  • Avg Commits per committer: 21.213
  • Development Distribution Score (DDS): 0.726
Past Year
  • Commits: 75
  • Committers: 10
  • Avg Commits per committer: 7.5
  • Development Distribution Score (DDS): 0.28
Top Committers
Name Email Commits
Jason Fleming j****g@s****m 273
Zach Cobell z****l@g****m 248
Chris Massey C****y@u****l 76
Zach Cobell z****l@a****m 68
Zach Cobell z****l@a****m 51
WPringle w****e@n****u 45
Robert Weaver r****r@f****u 31
Casey Dietrich c****h@g****m 29
Dylan Wood d****d@g****m 21
Shintaro Bunya s****a@u****u 14
Damrongsak Wirasaet d****e@g****m 14
Christina Forbes c****s@n****v 13
Tristan a****r@n****u 13
T t****r 12
Shintaro Bunya s****a@g****m 11
Panagiotis Velissariou p****u@n****v 10
cblakely c****y@n****u 8
Corbitt Kerr p****r@n****u 6
Kendra Dresback d****k@o****u 5
caseydietrich d****h@i****u 4
tampbell t****l@n****m 4
Alper Altuntas a****s@g****m 3
Brian Blanton b****n@r****g 3
Seizo Tanaka t****o@g****m 3
Guoming Ling g****g@n****u 3
Aman Tejaswi a****i@a****u 3
Joel Dietrich j****1@l****u 2
William Pringle w****e@b****v 2
Youcan Feng y****g@g****m 2
Johnathan Woodruff j****6@g****m 2
and 17 more...

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 111
  • Total pull requests: 189
  • Average time to close issues: about 1 year
  • Average time to close pull requests: about 1 month
  • Total issue authors: 33
  • Total pull request authors: 23
  • Average comments per issue: 2.4
  • Average comments per pull request: 0.86
  • Merged pull requests: 150
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 19
  • Pull requests: 66
  • Average time to close issues: 8 days
  • Average time to close pull requests: 9 days
  • Issue authors: 15
  • Pull request authors: 9
  • Average comments per issue: 1.16
  • Average comments per pull request: 0.61
  • Merged pull requests: 56
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • zcobell (30)
  • jasonfleming (25)
  • wwlwpd (6)
  • krober10nd (5)
  • tgasher (5)
  • mattbilskie (3)
  • WPringle (3)
  • yujifunakoshiNOAA (2)
  • shin-ozaki (2)
  • pvelissariou1 (2)
  • MGYBY (2)
  • acrosby (2)
  • krsteffen (2)
  • ps2epsi (2)
  • XinghanLiu2002 (2)
Pull Request Authors
  • zcobell (107)
  • shinbunya (22)
  • cblakely97 (22)
  • jasonfleming (12)
  • poseidonND (8)
  • dwirasae (8)
  • jlwoodr (6)
  • pvelissariou1 (6)
  • acrosby (4)
  • dylnwood (3)
  • mattbilskie (3)
  • krober10nd (3)
  • chrismassey (2)
  • dave-gso (2)
  • WPringle (2)
Top Labels
Issue Labels
bug (46) enhancement (37) help wanted (6) question (6) bug-thirdparty (4) critical (4) duplicate (2) wontfix (1) feature-request (1) invalid (1)
Pull Request Labels
bug (57) enhancement (57) bug-thirdparty (8) maintenance (8) documentation (4) critical (2)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 13
proxy.golang.org: github.com/adcirc/adcirc
  • Versions: 13
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 10 months ago