{"id":79,"name":"HAMS","description":"An open-source computer program for the analysis of wave diffraction and radiation of three-dimensional floating or submerged structures.","url":"https://github.com/YingyiLiu/HAMS","last_synced_at":"2026-04-20T23:30:40.574Z","repository":{"id":40501615,"uuid":"308675743","full_name":"YingyiLiu/HAMS","owner":"YingyiLiu","description":"An open-source computer program for the analysis of wave diffraction and radiation of three-dimensional floating or submerged structures","archived":false,"fork":false,"pushed_at":"2024-06-03T07:05:06.000Z","size":22826,"stargazers_count":121,"open_issues_count":11,"forks_count":58,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-04-05T16:03:09.955Z","etag":null,"topics":["boundary-element-method","ocean-wave-energy-converters","offshore-wind-platforms","potential-flow-theory","wave-structure-interaction"],"latest_commit_sha":null,"homepage":"","language":"Roff","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YingyiLiu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-30T15:48:46.000Z","updated_at":"2026-03-15T06:09:44.000Z","dependencies_parsed_at":"2023-02-10T13:46:40.068Z","dependency_job_id":"287ef8c4-53f9-4353-982e-1a3770677933","html_url":"https://github.com/YingyiLiu/HAMS","commit_stats":{"total_commits":197,"total_committers":4,"mean_commits":49.25,"dds":"0.19796954314720816","last_synced_commit":"578d74aa144ce1f4f05453d672d52f5f6f69bc6a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/YingyiLiu/HAMS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YingyiLiu","download_url":"https://codeload.github.com/YingyiLiu/HAMS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31691503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T13:07:20.380Z","status":"ssl_error","status_checked_at":"2026-04-11T13:06:47.903Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"owner":{"login":"YingyiLiu","name":"Yingyi Liu","uuid":"41184692","kind":"user","description":"","email":"","website":null,"location":"Fukuoka, Japan","twitter":null,"company":"Kyushu University","icon_url":"https://avatars.githubusercontent.com/u/41184692?v=4","repositories_count":13,"last_synced_at":"2024-06-11T15:33:28.572Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/YingyiLiu","funding_links":[],"total_stars":104,"followers":42,"following":9,"created_at":"2022-11-20T02:01:45.470Z","updated_at":"2024-06-11T15:33:33.336Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YingyiLiu","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YingyiLiu/repositories"},"packages":[],"commits":{"id":1253926,"full_name":"YingyiLiu/HAMS","default_branch":"master","total_commits":197,"total_committers":4,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":49.25,"dds":0.19796954314720816,"past_year_total_commits":0,"past_year_total_committers":0,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":0.0,"past_year_dds":0.0,"last_synced_at":"2026-04-19T18:28:02.963Z","last_synced_commit":"578d74aa144ce1f4f05453d672d52f5f6f69bc6a","created_at":"2023-03-27T10:48:30.111Z","updated_at":"2026-04-19T18:28:01.298Z","committers":[{"name":"YingyiLiu","email":"abrahamliu1986@gmail.com","login":"YingyiLiu","count":158},{"name":"Garrett Barter","email":"garrett.barter@nrel.gov","login":"gbarter","count":37},{"name":"Matthieu Ancellin","email":"matthieu.ancellin@eurobios.com","login":"mancellin","count":1},{"name":"liuyingyi-ukyushu","email":"liuyingyi@riam.kyushu-u.ac.jp","login":null,"count":1}],"past_year_committers":[],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-19T00:00:13.908Z","repositories_count":6214529,"commits_count":900194407,"contributors_count":34915600,"owners_count":1143537,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"YingyiLiu/HAMS","html_url":"https://github.com/YingyiLiu/HAMS","last_synced_at":"2026-02-21T20:00:20.818Z","status":"error","issues_count":29,"pull_requests_count":15,"avg_time_to_close_issue":5314229.05,"avg_time_to_close_pull_request":367547.9166666667,"issues_closed_count":20,"pull_requests_closed_count":12,"pull_request_authors_count":5,"issue_authors_count":21,"avg_comments_per_issue":2.7241379310344827,"avg_comments_per_pull_request":1.7333333333333334,"merged_pull_requests_count":10,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":5,"past_year_pull_requests_count":0,"past_year_avg_time_to_close_issue":9.0,"past_year_avg_time_to_close_pull_request":null,"past_year_issues_closed_count":1,"past_year_pull_requests_closed_count":0,"past_year_pull_request_authors_count":0,"past_year_issue_authors_count":3,"past_year_avg_comments_per_issue":0.8,"past_year_avg_comments_per_pull_request":null,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":0,"created_at":"2023-05-09T10:37:03.852Z","updated_at":"2026-02-21T20:00:20.818Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/YingyiLiu%2FHAMS/issues","issue_labels_count":{},"pull_request_labels_count":{},"issue_author_associations_count":{"NONE":24,"CONTRIBUTOR":5},"pull_request_author_associations_count":{"CONTRIBUTOR":11,"NONE":4},"issue_authors":{"gbarter":3,"sarantos95":2,"Dylan0824":2,"izabala123":2,"ramisetti":2,"OFZYstudy":2,"mancellin":2,"YiqXia":1,"karmoker18":1,"yzl429":1,"ucar398":1,"Aiswariak":1,"IL-1":1,"nedisy":1,"halowine":1,"vaibhavraghavan":1,"achilleas101":1,"austinerees":1,"HYFOAM":1,"dith96":1,"Ran-Tu":1},"pull_request_authors":{"gbarter":10,"forestgou":2,"mancellin":1,"mutricyl":1,"zhzenith":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-19T00:00:13.985Z","repositories_count":14332542,"issues_count":34459736,"pull_requests_count":112767108,"authors_count":11238912,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{"NONE":5},"past_year_pull_request_author_associations_count":{},"past_year_issue_authors":{"OFZYstudy":2,"sarantos95":2,"yzl429":1},"past_year_pull_request_authors":{},"maintainers":[],"active_maintainers":[]},"events":{"total":{"ForkEvent":3,"IssuesEvent":4,"WatchEvent":19,"IssueCommentEvent":11},"last_year":{"ForkEvent":1,"IssuesEvent":3,"WatchEvent":9,"IssueCommentEvent":8}},"keywords":["boundary-element-method","ocean-wave-energy-converters","offshore-wind-platforms","potential-flow-theory","wave-structure-interaction"],"dependencies":[{"ecosystem":"actions","filepath":".github/workflows/gfortran-ci.yml","sha":null,"kind":"manifest","created_at":"2023-02-10T13:46:40.030Z","updated_at":"2023-02-10T13:46:40.030Z","repository_link":"https://github.com/YingyiLiu/HAMS/blob/master/.github/workflows/gfortran-ci.yml","dependencies":[{"id":7530241167,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":7530241168,"package_name":"actions/setup-python","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]}],"score":6.269096283706261,"created_at":"2023-09-11T11:54:33.741Z","updated_at":"2026-04-20T23:30:40.582Z","avatar_url":"https://github.com/YingyiLiu.png","language":"Roff","category":"Renewable Energy","sub_category":"Wind Energy","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"\u003c!--\n  Title: HAMS\n  Description: An open-source computer program for the analysis of wave diffraction and radiation of three-dimensional floating or submerged structures.\n  Authors: Yingyi Liu.\n  --\u003e\n\n# HAMS\n**An open-source computer program for the analysis of wave diffraction and radiation of three-dimensional floating or submerged structures.**\n\n[![License: Apache v2](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/body_mesh.png\" width=\"70%\" /\u003e\u003c/p\u003e\n  \nHAMS (Hydrodynamic Analysis of Marine Structures) is a free open-source software to analyse wave-structure interactions in the frequency domain. It is based on the boundary integral equation method within the framework of the potential flow theory. The code is currently written in FORTRAN 90. It has been developed by the author Yingyi Liu for nearly a decade. \n\nHAMS is released in the hope that it will contribute to eliminating the inequality (for those who are not able to afford to purchase a costly commercial BEM software) in the continuous research developments related to offshore engineering and ocean renewable energies.\n\nHAMS is freely distributed under the Apache License, Version 2.0, http://www.apache.org/licenses/LICENSE-2.0, and may be modified and extended by researchers who intend to enhance its capabilities and port the code to other platforms. \n\nThe success of HAMS should to a large extent be attributed to Prof. Bin Teng (Dalian University of Technology), who has tutored me the theory of potential flow in marine hydrodynamics and the programming skills using the [Boundary Element Method](https://en.wikipedia.org/wiki/Boundary_element_method). The code structure and the coding style of HAMS are exactly two of the examples that I have learned and inherited from Prof. Bin Teng.\n\n## Theoretical Basis\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/global_coordinate_system.png\" width=\"70%\" /\u003e\u003c/p\u003e\n  \n### - Please refer to the following papers for the theory:\n\nThe theory of panel method that has been used by HAMS is written in detail in the following two papers:\n\n* Yingyi Liu (2021). Introduction of the Open-Source Boundary Element Method Solver HAMS to the Ocean Renewable Energy Community. In: Proc. of the 14th European Wave and Tidal Energy Conference, Plymouth, UK, Sep. 5–9, 2021.\n\n* Yingyi Liu (2019). \"HAMS: A Frequency-Domain Preprocessor for Wave-Structure Interactions—Theory, Development, and Application.\" _Journal of Marine Science and Engineering_, 7: 81.\n\n* Yingyi Liu, Changhong Hu, Makoto Sueyoshi, Hidetsugu Iwashita, Masashi Kashiwagi (2016). \"Motion response prediction by hybrid panel-stick models for a semi-submersible with bracings.\" _Journal of Marine Science and Technology_, 21:742–757.\n\nThe deepwater Green function is using a fortran subroutine (https://github.com/Hui-Liang/Green-function-in-deep-water) developed by Dr. Hui Liang. For the detailed theory you may refer to the following three papers:\n\n* Hui Liang, Huiyu Wu, and Francis Noblesse (2018). \"Validation of a global approximation for wave diffraction-radiation in deep water.\" _Applied Ocean Research_, 74 : 80-86.\n\n* Huiyu Wu, Hui Liang, and Francis Noblesse (2018). \"Wave component in the Green function for diffraction radiation of regular water waves.\" _Applied Ocean Research_, 81: 72-75.\n\n* Huiyu Wu, Chenliang Zhang, Yi Zhu, Wei Li, Decheng Wan, Francis Noblesse (2017). \"A global approximation to the Green function for diffraction radiation of water waves.\" _European Journal of Mechanics-B/Fluids_, 65: 54-64.\n\nThe finite-depth Green function is using a fortran subroutine FinGreen3D (https://github.com/YingyiLiu/FinGreen3D) developed by Dr. Yingyi Liu. For the detailed theory you may refer to the following two papers:\n\n* Yingyi Liu, Shigeo Yoshida, Changhong Hu, Makoto Sueyoshi, Liang Sun, Junliang Gao, Peiwen Cong, Guanghua He (2018). \"A reliable open-source package for performance evaluation of floating renewable energy systems in coastal and offshore regions.\" _Energy Conversion and Management_, 174: 516-536.\n\n* Yingyi Liu, Hidetsugu Iwashita, Changhong Hu (2015). \"A calculation method for finite depth free-surface green function.\" _International Journal of Naval Architecture and Ocean Engineering_, 7(2): 375-389.\n\nPlease cite appropriately the above papers in your relevant publications, reports, etc., if the HAMS code or its executable program has contributed to your work.\n\n## Generated numerical results\n\n### - Hydrodynamic coefficients\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/hydrodynamic_coefficients.png\" width=\"60%\" /\u003e\u003c/p\u003e\n\n### - Wave excitation force\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/wave_excitation_force_plot.png\" width=\"65%\" /\u003e\u003c/p\u003e\n\n### - Motion RAOs\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/RAO_of_motion.png\" width=\"75%\" /\u003e\u003c/p\u003e\n\n### - Free-surface elevation\n\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/free_surface_elevation.png\" width=\"60%\" /\u003e\u003c/p\u003e\n\n## Features\n\n### - Mesh element type\n\n* HAMS can import meshes containing triangular panel type, quadrilateral panel type, or both.\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/panel_local_coordinates.png\" width=\"90%\" /\u003e\u003c/p\u003e\n\n### - OpenMP parallel processing\n\n* HAMS can be run in the parallel mode using OpenMP techniques on PC's with multiple processors (CPU's).\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/OpenMP_parallel_process.png\" width=\"95%\" /\u003e\u003c/p\u003e\n  \n### - Computational efficiency\n\n* The following graph shows an example of DeepCwind semisubmersible using 8 threads for the computation:\n  \u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/YingyiLiu/HAMS/blob/master/Other/md_resources/computational_efficiency.png\" width=\"80%\" /\u003e\u003c/p\u003e\n\n## Useful Links\n\nThe following open-source software can be used to view the HAMS results: \u003c/p\u003e\n[1]. [BEMRosetta](https://github.com/izabala123/BEMRosetta). Developed by Iñaki Zabala, Markel Peñalba, Yerai Peña-Sanchez.\u003cbr/\u003e \n[2]. [BEMIO](https://wec-sim.github.io/bemio/). Developed by National Renewable Energy Laboratory and Sandia National Laboratories. \u003cbr/\u003e \n\nYou may need HAMS to do the frequency-domain pre-processing before you use the following programs: \u003c/p\u003e\n[1]. [FAST](https://www.nrel.gov/wind/nwtc/fast.html) or [OpenFAST](https://openfast.readthedocs.io/en/master/). Developed by National Renewable Energy Laboratory.\u003cbr/\u003e \n[2]. [WEC-Sim](https://wec-sim.github.io/WEC-Sim/). Developed by National Renewable Energy Laboratory and Sandia National Laboratories. \u003cbr/\u003e \n\nUsed by other open-source software: \u003c/p\u003e\n[1]. [pyHAMS](https://github.com/WISDEM/pyHAMS). Developed by Garrett Barter, National Renewable Energy Laboratory.\u003cbr/\u003e \n[2]. [RAFT](https://github.com/WISDEM/RAFT). Developed by Matt Hall, Stein Housner, David Ogden, Garrett Barter, National Renewable Energy Laboratory. \u003cbr/\u003e \n\n## License\n\nCode original author: Yingyi Liu (劉盈溢), [Google Scholar](https://scholar.google.co.jp/citations?hl=ja\u0026user=mpR3MvAAAAAJ\u0026view_op=list_works\u0026sortby=pubdate).\n\nHAMS is free software: you can redistribute it and/or modify it under the terms of the Apache License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.\n\nHAMS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache License for details. You should have received a copy of the Apache License along with HAMS. If not, see http://www.apache.org/licenses/LICENSE-2.0 \u003cbr/\u003e\n\n\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":[],"project_url":"https://ost.ecosyste.ms/api/v1/projects/79","html_url":"https://ost.ecosyste.ms/projects/79"}