{"id":27454,"name":"FMS Coupler","description":"A software framework for supporting the efficient development, construction, execution, and scientific interpretation of atmospheric, oceanic, and climate system models.","url":"https://github.com/NOAA-GFDL/FMScoupler","last_synced_at":"2026-04-11T04:30:37.848Z","repository":{"id":33064816,"uuid":"36701409","full_name":"NOAA-GFDL/FMScoupler","owner":"NOAA-GFDL","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-04T21:33:36.000Z","size":4446,"stargazers_count":14,"open_issues_count":24,"forks_count":69,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-03-05T03:25:37.202Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NOAA-GFDL.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-06-02T02:02:23.000Z","updated_at":"2025-09-29T21:06:00.000Z","dependencies_parsed_at":"2023-02-12T04:17:11.172Z","dependency_job_id":"84e1ba9c-cc5e-47a3-8487-81260f4126c3","html_url":"https://github.com/NOAA-GFDL/FMScoupler","commit_stats":{"total_commits":307,"total_committers":45,"mean_commits":6.822222222222222,"dds":0.8827361563517915,"last_synced_commit":"2b59f6d4e52e1c7c50f6fba09918f4a0b4ad5741"},"previous_names":[],"tags_count":103,"template":false,"template_full_name":null,"purl":"pkg:github/NOAA-GFDL/FMScoupler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NOAA-GFDL","download_url":"https://codeload.github.com/NOAA-GFDL/FMScoupler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30753739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-20T11:15:16.779Z","status":"ssl_error","status_checked_at":"2026-03-20T11:14:57.379Z","response_time":129,"last_error":"SSL_read: 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":"NOAA-GFDL","name":"NOAA - Geophysical Fluid Dynamics Laboratory","uuid":"11219395","kind":"organization","description":"U.S Department of Commerce, National Oceanic and Atmospheric Administration","email":"gfdl.climate.model.info@noaa.gov","website":"www.gfdl.noaa.gov","location":"Princeton, New Jersey","twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/11219395?v=4","repositories_count":47,"last_synced_at":"2023-08-13T13:41:07.559Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/NOAA-GFDL","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2022-11-07T04:28:52.091Z","updated_at":"2023-08-13T13:41:08.578Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NOAA-GFDL","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NOAA-GFDL/repositories"},"packages":[],"commits":{"id":1339302,"full_name":"NOAA-GFDL/FMScoupler","default_branch":"main","total_commits":339,"total_committers":49,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":6.918367346938775,"dds":0.8938053097345133,"past_year_total_commits":9,"past_year_total_committers":6,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":1.5,"past_year_dds":0.6666666666666667,"last_synced_at":"2026-03-13T10:42:13.208Z","last_synced_commit":"8ac0bdcc826510501b6efe40cf651567ad6a196a","created_at":"2023-09-12T08:20:52.814Z","updated_at":"2026-03-13T10:39:52.603Z","committers":[{"name":"Flexible Modeling System","email":"Flexible.Modeling.System@noaa.gov","login":null,"count":36},{"name":"Robert Hallberg","email":"Robert.Hallberg@noaa.gov","login":"Hallberg-NOAA","count":36},{"name":"Zhi Liang","email":"Zhi.Liang@noaa.gov","login":"Zhi-Liang","count":34},{"name":"Ryan Mulhall","email":"35538242+rem1776","login":"rem1776","count":32},{"name":"Seth Underwood","email":"Seth.Underwood@noaa.gov","login":"underwoo","count":31},{"name":"MiKyung Lee","email":"58964324+mlee03","login":"mlee03","count":15},{"name":"Niki Zadeh","email":"Niki.Zadeh@noaa.gov","login":"nikizadehgfdl","count":14},{"name":"Rusty Benson","email":"Rusty.Benson@noaa.gov","login":"bensonr","count":13},{"name":"rem1776","email":"Ryan.Mulhall@lscamd50-d.gfdl.noaa.gov","login":null,"count":12},{"name":"Thomas Robinson","email":"Thomas.Robinson@noaa.gov","login":"thomas-robinson","count":12},{"name":"Bruce Wyman","email":"Bruce.Wyman@noaa.gov","login":null,"count":10},{"name":"Fabien Paulot","email":"Fabien.Paulot@noaa.gov","login":"fabienpaulot","count":9},{"name":"Uriel Ramirez","email":"uriel.ramirez@noaa.gov","login":null,"count":8},{"name":"Ryan Mulhall","email":"ryan.mulhall@llt-4421743.ad.gfdl.noaa.gov","login":null,"count":7},{"name":"Sergey Malyshev","email":"Sergey.Malyshev@noaa.gov","login":"slm7826","count":6},{"name":"Raphael Dussin","email":"raphael.dussin@gmail.com","login":"raphaeldussin","count":5},{"name":"JosephMouallem","email":"75327266+JosephMouallem","login":"JosephMouallem","count":5},{"name":"Raymond Menzel","email":"Raymond.Menzel@noaa.gov","login":"menzel-gfdl","count":4},{"name":"Eric Stofferahn","email":"7784797+GFDL-Eric","login":"GFDL-Eric","count":4},{"name":"rem1776","email":"Ryan.Mulhall@lscsky50-d.gfdl.noaa.gov","login":null,"count":4},{"name":"colingladueNOAA","email":"60889854+colingladueNOAA","login":"colingladueNOAA","count":3},{"name":"Levi.Silvers","email":"Levi.Silvers@noaa.gov","login":null,"count":3},{"name":"Chris Golaz","email":"chris.golaz@noaa.gov","login":null,"count":3},{"name":"Jeffrey Durachta","email":"Jeffrey.Durachta@noaa.gov","login":"jwdGFDL","count":2},{"name":"Garrett.Wright","email":"Garrett.Wright@noaa.gov","login":"gbw-gfdl","count":2},{"name":"Vithika Shah","email":"91550574+vithikashah001","login":"vithikashah001","count":2},{"name":"kaiyuan-cheng","email":"74800123+kaiyuan-cheng","login":"kaiyuan-cheng","count":2},{"name":"Lauren Chilutti","email":"60401591+laurenchilutti","login":"laurenchilutti","count":2},{"name":"William Cooke","email":"William.Cooke@noaa.gov","login":"wfcooke","count":2},{"name":"Huan Guo","email":"Huan.Guo@noaa.gov","login":null,"count":2},{"name":"Eric Stofferahn","email":"Eric.Stofferahn@noaa.gov","login":null,"count":1},{"name":"Huan Guo","email":"Huan.Guo@gaea7.ncrc.gov","login":null,"count":1},{"name":"Raphael Dussin","email":"Raphael.Dussin@noaa.gov","login":null,"count":1},{"name":"levi silvers","email":"silversster@gmail.com","login":"gitleviglenn","count":1},{"name":"baoqiang80","email":"baoqiang.xiang@noaa.gov","login":"baoqiang80","count":1},{"name":"abrooks1085","email":"139358099+abrooks1085","login":"abrooks1085","count":1},{"name":"Zhihong Tan","email":"tzhihong@gmail.com","login":"zhihong-tan","count":1},{"name":"Spencer Clark","email":"spencerkclark@gmail.com","login":"spencerkclark","count":1},{"name":"Carlo Rosati","email":"carlo.rosati@noaa.gov","login":null,"count":1},{"name":"Ryan Mulhall","email":"Ryan.Mulhall@lrdpub03-p.gfdl.noaa.gov","login":null,"count":1},{"name":"Rusty Benson","email":"Rusty.Benson@rab.(none)","login":null,"count":1},{"name":"theresa-morrison","email":"114184229+theresa-morrison","login":"theresa-morrison","count":1},{"name":"uramirez8707","email":"49168881+uramirez8707","login":"uramirez8707","count":1},{"name":"Andrew Ross","email":"andrew.c.ross@noaa.gov","login":"andrew-c-ross","count":1},{"name":"Bennett Chang","email":"98476720+bcc2761","login":"bcc2761","count":1},{"name":"Caitlyn McAllister","email":"65364559+mcallic2","login":"mcallic2","count":1},{"name":"Jasmin John","email":"Jasmin.John@noaa.gov","login":"jgjgfdl","count":1},{"name":"Kun Gao","email":"38074774+gaokun227","login":"gaokun227","count":1},{"name":"Molly B","email":"160655680+Scitech777","login":"Scitech777","count":1}],"past_year_committers":[{"name":"Ryan Mulhall","email":"35538242+rem1776","login":"rem1776","count":3},{"name":"Vithika Shah","email":"91550574+vithikashah001","login":"vithikashah001","count":2},{"name":"fpaulot","email":"42008691+fabienpaulot","login":"fabienpaulot","count":1},{"name":"Niki Zadeh","email":"niki.zadeh@noaa.gov","login":"nikizadehgfdl","count":1},{"name":"Kun Gao","email":"38074774+gaokun227","login":"gaokun227","count":1},{"name":"JosephMouallem","email":"75327266+JosephMouallem","login":"JosephMouallem","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-03-20T00:00:07.723Z","repositories_count":6201975,"commits_count":935831561,"contributors_count":36160707,"owners_count":1146201,"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":"NOAA-GFDL/FMScoupler","html_url":"https://github.com/NOAA-GFDL/FMScoupler","last_synced_at":"2026-01-28T17:04:31.229Z","status":null,"issues_count":43,"pull_requests_count":170,"avg_time_to_close_issue":11808622.407407407,"avg_time_to_close_pull_request":3374518.9675324676,"issues_closed_count":27,"pull_requests_closed_count":154,"pull_request_authors_count":35,"issue_authors_count":23,"avg_comments_per_issue":1.7209302325581395,"avg_comments_per_pull_request":1.1411764705882352,"merged_pull_requests_count":136,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":5,"past_year_pull_requests_count":22,"past_year_avg_time_to_close_issue":null,"past_year_avg_time_to_close_pull_request":427346.125,"past_year_issues_closed_count":0,"past_year_pull_requests_closed_count":16,"past_year_pull_request_authors_count":7,"past_year_issue_authors_count":4,"past_year_avg_comments_per_issue":0.0,"past_year_avg_comments_per_pull_request":0.6363636363636364,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":11,"created_at":"2023-09-12T08:21:29.760Z","updated_at":"2026-01-28T17:04:31.230Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-GFDL%2FFMScoupler/issues","issue_labels_count":{"enhancement":3,"bug":3,"documentation":2,"maintenance":1},"pull_request_labels_count":{"maintenance":3,"enhancement":3,"documentation":3,"bug fix":2},"issue_author_associations_count":{"CONTRIBUTOR":18,"NONE":13,"MEMBER":12},"pull_request_author_associations_count":{"CONTRIBUTOR":129,"NONE":28,"MEMBER":13},"issue_authors":{"mlee03":8,"thomas-robinson":5,"underwoo":4,"uramirez8707":3,"nikizadehgfdl":2,"rem1776":2,"adcroft":2,"bensonr":2,"J-Lentz":1,"zhihong-tan":1,"dougiesquire":1,"ceblanton":1,"StevePny":1,"wrongkindofdoctor":1,"edwardhartnett":1,"spencerkclark":1,"laurenchilutti":1,"GFDL-Eric":1,"manmeet3591":1,"colingladueNOAA":1,"theresa-morrison":1,"slm7826":1,"andrew-c-ross":1},"pull_request_authors":{"rem1776":53,"mlee03":31,"thomas-robinson":8,"JosephMouallem":7,"uramirez8707":6,"bensonr":5,"Biao-Zhao":4,"kaiyuan-cheng":4,"GFDL-Eric":4,"nikizadehgfdl":4,"wrongkindofdoctor":3,"J-Lentz":3,"colingladueNOAA":3,"laurenchilutti":3,"vithikashah001":2,"gaokun227":2,"bcc2761":2,"theresa-morrison":2,"underwoo":2,"hdrake":2,"baoqiang80":2,"fabienpaulot":2,"Scitech777":2,"spencerkclark":2,"gitleviglenn":2,"edwardhartnett":1,"andrew-c-ross":1,"alex-huth":1,"sternalon":1,"zhihong-tan":1,"mcallic2":1,"Zhi-Liang":1,"raphaeldussin":1,"wfcooke":1,"Hallberg-NOAA":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-03-20T00:00:06.365Z","repositories_count":13828717,"issues_count":34752367,"pull_requests_count":113483958,"authors_count":11207823,"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":{"documentation":1},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{"CONTRIBUTOR":4,"MEMBER":1},"past_year_pull_request_author_associations_count":{"CONTRIBUTOR":11,"NONE":7},"past_year_issue_authors":{"mlee03":2,"nikizadehgfdl":1,"slm7826":1,"thomas-robinson":1},"past_year_pull_request_authors":{"rem1776":6,"Biao-Zhao":4,"J-Lentz":3,"nikizadehgfdl":2,"vithikashah001":2,"JosephMouallem":1},"maintainers":[{"login":"thomas-robinson","count":13,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/thomas-robinson"},{"login":"underwoo","count":6,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/underwoo"},{"login":"spencerkclark","count":3,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/spencerkclark"},{"login":"adcroft","count":2,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/adcroft"},{"login":"Hallberg-NOAA","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/Hallberg-NOAA"}],"active_maintainers":[{"login":"thomas-robinson","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/thomas-robinson"}]},"events":{"total":{"ReleaseEvent":2,"DeleteEvent":1,"PullRequestEvent":21,"ForkEvent":9,"IssuesEvent":4,"IssueCommentEvent":28,"PushEvent":20,"PullRequestReviewEvent":20,"PullRequestReviewCommentEvent":11,"CreateEvent":14},"last_year":{"ReleaseEvent":1,"DeleteEvent":1,"PullRequestEvent":16,"ForkEvent":3,"IssuesEvent":4,"IssueCommentEvent":11,"PushEvent":14,"PullRequestReviewEvent":10,"CreateEvent":11}},"keywords":[],"dependencies":[{"ecosystem":"actions","filepath":".github/workflows/build.yml","sha":null,"kind":"manifest","created_at":"2023-01-14T23:14:30.199Z","updated_at":"2023-01-14T23:14:30.199Z","repository_link":"https://github.com/NOAA-GFDL/FMScoupler/blob/main/.github/workflows/build.yml","dependencies":[{"id":6908564571,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/docs.yml","sha":null,"kind":"manifest","created_at":"2023-01-14T23:14:30.219Z","updated_at":"2023-01-14T23:14:30.219Z","repository_link":"https://github.com/NOAA-GFDL/FMScoupler/blob/main/.github/workflows/docs.yml","dependencies":[{"id":6908564572,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":6908564573,"package_name":"peaceiris/actions-gh-pages","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/lint.yml","sha":null,"kind":"manifest","created_at":"2023-01-14T23:14:30.229Z","updated_at":"2023-01-14T23:14:30.229Z","repository_link":"https://github.com/NOAA-GFDL/FMScoupler/blob/main/.github/workflows/lint.yml","dependencies":[{"id":6908564574,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":6908564575,"package_name":"NOAA-GFDL/simple_lint","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]}],"score":7.529406457837013,"created_at":"2023-09-12T07:40:18.730Z","updated_at":"2026-04-11T04:30:37.859Z","avatar_url":"https://github.com/NOAA-GFDL.png","language":"Fortran","category":"Climate Change","sub_category":"Earth and Climate Modeling","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"![Build Status](https://github.com/NOAA-GFDL/FMScoupler/actions/workflows/build.yml/badge.svg?branch=main)\n\n# Flexible Modeling System (FMS) Coupler\n\nInstructions for contribuing to this project can be found in the \n[Contribution Guidelines](CONTRIBUTING.md).  Contributing to the FMScoupler involves a higher \nlevel of scrutiny and justification.\n\n\nThe Flexible Modeling System (FMS) is a software framework for supporting the\nefficient development, construction, execution, and scientific interpretation\nof atmospheric, oceanic, and climate system models.\n\nThis repository contains the FMS Coupler, meant for use alongside FMS and other component models,\nsuch as the MOM6 ocean model and the AM4 atmosphere model. More technical information for coupling\nmodels is available below.\n\nFor additional information on FMS, please see the [FMS github repository.](http://www.github.com/noaa-gfdl/fms)\n\n## Coupling Models with FMS Coupler\n\nFMS Coupler provides the capability to couple component models (atmosphere, land, sea ice, and ocean\n) on different logically rectangular grids. Presently, the atmosphere and land models are\nconstrained to be on standard longitude/latitude grids (not necessarily the same) and the ocean and\nsea-ice are constrained to be on the same grid which need only be logically rectangular.\nA logically rectangular grid has an array-like set of areas, each of which border one other area in\neach of the pseudo-north, -south, -east, and -west directions, except at the poles.\nThe coupling between the models is designed to conserve fluxes. For coupled models, a grid\nspecification file is used to initialize the model grids and perform exchanges between the models.\nThe next sections describe how this file and associated grids are used in the coupler.\n\n### Grid Specification Files\nAt runtime, the coupled model sets up its grid using a given `grid_spec.nc` file that it reads from\nthe INPUT subdirectory. This NetCDF file contains grid information for all of the component models\nas well as exchange grid information for the coupler to use.\n\nFor more information on generating the necessary files for coupled runs, please see the\n[FRE-NCtools repository](http://github.com/noaa-gfdl/FRE-NCtools) for information on grid file\ngeneration tools.\n\nIn the coupled model, ocean, sea ice, and land models will read their grids from the grid_spec.nc\nfile. The land model areas must be read from grid_spec.nc rather than calculated because the\ngrid_spec.nc land areas have been modified in the grid generation process to remove overlaps with\nthe ocean/sea-ice grid cells. The land mask is set to true where this modified area is positive.\nThe land model areas are used for conserving runoff on the land grid. The ocean and sea-ice grids\nare the same by virtue of initializing from the same fields of grid_spec.nc. Additionally, the sea\nice model uses this grid information to rotate vectors between the longitude/latitude atmosphere\ngrid and the general ocean/sea-ice grids.\n\n### Exchange Grids\n\nThe coupler uses grid_spec.nc to initialize its exchange grids. An exchange grid between two\ncomponent model grids is the grid formed with the union of the bounding lines of the component\nmodel grids. The exchange grid is, therefore, the coarsest grid that is a refinement of each of the\ncomponent model grids. The coupler uses exchange grids for two purposes:\n\n- conservative interpolation of fields between models uses the exchange grid cell areas as weights and\n- the surface flux calculation takes place on the exchange grid thereby using the finest scale data available.\n\nThe coupler has two exchange grids. The first is for surface fluxes with the atmosphere on one side\nand the land and sea ice on the other. Under FMS the sea ice model serves as the interface to the\nocean model — the atmosphere model never exchanges directly with the ocean model. The second\nexchange grid is between the land and the sea ice for runoff. No fluxes are computed on this\nexchange grid; it is used solely for conservation.\n\nThe coupler’s utility for interfacing to the grid_spec.nc file and performing exchange grid\noperations is xgrid_mod (from the FMS repository). Xgrid_mod uses the mpp_domains domain of each of\nthe models along with information it reads from the grid specification file to determine grid and\nprocessor connectivities. The coupler’s fortran call to initialize the surface exchange grid\n(xmap_sfc) is:\n```\ncall setup_xmap(xmap_sfc, (/ 'ATM', 'OCN', 'LND' /),                 \u0026\n                          (/ Atm%Domain, Ice%Domain, Land%Domain /), \u0026\n                          \"INPUT/grid_spec.nc\"                       )\n```\nXgrid_mod reads the exchange grids from grid_spec.nc as a sequence of quintuples: the i/j indices of\nthe intersecting cells of the two participating grids and their areal overlap. The names of the five\nfields are generated automatically from the three character ids of the participating grids that\nappear in the above initialization call. For example, for atmosphere/sea ice exchange on the\ncoupler’s surface exchange grid, the following fields are read by xgrid_mod: I_ATM_ATMxOCN, J_ATM_ATMxOCN, I_OCN_ATMxOCN, J_OCN_ATMxOCN, and AREA_ATMxOCN. These fields were placed in grid_spec.nc by the make_xgrids utility.\n\n### Source Code Documentation\n\nA publicly available version of this repository's doxygen-generated source documentation is\navailable at https://noaa-gfdl.github.io/FMScoupler. It is updated upon every release.\n\nAlternatively, documentation can be generated manually by running `doxygen` in the top level of your\ncloned repository.\n\n## Disclaimer\n\nThe United States Department of Commerce (DOC) GitHub project code is provided\non an 'as is' basis and the user assumes responsibility for its use. DOC has\nrelinquished control of the information and no longer has responsibility to\nprotect the integrity, confidentiality, or availability of the information. Any\nclaims against the Department of Commerce stemming from the use of its GitHub\nproject will be governed by all applicable Federal law. Any reference to\nspecific commercial products, processes, or services by service mark,\ntrademark, manufacturer, or otherwise, does not constitute or imply their\nendorsement, recommendation or favoring by the Department of Commerce. The\nDepartment of Commerce seal and logo, or the seal and logo of a DOC bureau,\nshall not be used in any manner to imply endorsement of any commercial product\nor activity by DOC or the United States Government.\n\nThis project code is made available through GitHub but is managed by NOAA-GFDL\nat https://gitlab.gfdl.noaa.gov.\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["climate-model","climate","fms","gfdl","fre","fv3","model-component","numerical-modeling","ocean-circulation","ocean-circulation-models"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/27454","html_url":"https://ost.ecosyste.ms/projects/27454"}