the Creative Commons Attribution 4.0 License.
the Creative Commons Attribution 4.0 License.
Modernizing the open-source community Noah-MP land surface model (version 5.0) with enhanced modularity, interoperability, and applicability
Prasanth Valayamkunnath
Michael Barlage
Fei Chen
David Gochis
Ryan Cabell
Tim Schneider
Roy Rasmussen
Guo-Yue Niu
Zong-Liang Yang
Dev Niyogi
Michael Ek
Abstract. The widely-used open-source community Noah-MP land surface model (LSM) is designed for applications ranging from uncoupled land-surface and ecohydrological process studies to coupled numerical weather prediction and decadal global/regional climate simulations. It has been used in many coupled community weather/climate/hydrology models. In this study, we modernize/refactor the Noah-MP LSM by adopting modern Fortran code and data structures and standards, which substantially enhances the model modularity, interoperability, and applicability. The modernized Noah-MP is released as the version 5.0 (v5.0), which has five key features: (1) enhanced modularization and interoperability by re-organizing model physics into individual process-level Fortran module files, (2) enhanced data structure with new hierarchical data types and optimized variable declaration and initialization structures, (3) enhanced code structure and calling workflow by leveraging the new data structure and modularization, (4) enhanced (descriptive and self-explanatory) model variable naming standard, and (5) enhanced driver and interface structures to couple with host weather/climate/hydrology models. In addition, we create a comprehensive technical documentation of the Noah-MP v5.0 and a set of model benchmark and reference datasets. The Noah-MP v5.0 will be coupled to various weather/climate/hydrology models in the future. Overall, the modernized Noah-MP will allow a more efficient and convenient process for future model developments and applications.
Cenlin He et al.
Status: open (until 07 Jun 2023)
-
CEC1: 'Comment on egusphere-2023-675', Juan Antonio Añel, 05 May 2023
reply
Dear authors,ÂUnfortunately, after checking your manuscript, it has come to our attention that it does not comply with our "Code and Data Policy".https://www.geoscientific-model-development.net/policies/code_and_data_policy.htmlÂYou have archived your code on GitHub. However, GitHub is not a suitable repository for scientific publication. GitHub itself instructs authors to use other alternatives for long-term archival and publishing, such as Zenodo. Therefore, please, publish your code in one of the appropriate repositories, and reply to this comment with the relevant information (link and DOI) as soon as possible, as it should be available for the Discussions stage.ÂÂI have to highlight that if you do not fix this problem as soon as possible, we will have to reject your manuscript for publication in our journal. I should note that, actually, your manuscript should not have been accepted in Discussions, given this lack of compliance with our policy. Therefore, the current situation with your manuscript is irregular.ÂAlso, you must include in a potentially reviewed version of your manuscript the modified 'Code and Data Availability' section, the DOI of the code. Also, in the GitHub repositories, there are no licenses listed for both NOAH-MP and HRLDAS/Noah-MP. If you do not include a license, despite what you state in the README file, the code is not "open-source"; it continues to be your property. Therefore, when uploading the model's code to Zenodo, you could want to choose a free software/open-source (FLOSS) license. We recommend the GPLv3. You only need to include the file 'https://www.gnu.org/licenses/gpl-3.0.txt' as LICENSE.txt with your code. Also, you can choose other options that Zenodo provides: GPLv2, Apache License, MIT License, etc.ÂRegarding the data, I agree that 8 TB is a sensible amount of data to store, and given the nature of this manuscript, we can understand the limitations that this represents to data sharing. However, we would expect that you can issue a DOI for the data relevant to your manuscript. It would be good if you provided better information about where it is stored (HPC infrastructure, servers, physical location, internal path in the file system, etc.)ÂJuan A. AñelGeosci. Model Dev. Exec. EditorCitation: https://doi.org/
10.5194/egusphere-2023-675-CEC1 -
AC1: 'Reply on CEC1', Cenlin He, 06 May 2023
reply
Dear Dr. Añel,
Thank you for the important notes. We have fixed all the issues following your suggestions. Specifially,
1. We have applied DOI for both Noah-MP and HRLDAS model code GitHub repositories through Zenodo. We have also included the doi information in the two GitHub pages. The doi for Noah-MP code is: https://doi.org/10.5281/zenodo.7901855, and the doi for HRLDAS code is: https://doi.org/10.5281/zenodo.7901867
2. We have added LICENSE.txt in both model code GitHub repositories. The Noah-MP GitHub repository: https://github.com/NCAR/noahmp, and the HRLDAS GitHub repository: https://github.com/NCAR/hrldas
3. We have made corresponding changes to our "Code and data availability" section in the manuscript to reflect the new doi and updated GitHub pages. Please see the attached revised manuscript with track-change.
4. We have also added more details about the 8.8-TB data archival, including the data storage system and path as follows (please also see the revised "Code and data availability" section in the attached manuscript): "The benchmark datasets are stored in the NCAR high-performance supercomputer (HPC) campaign storage file system (data path: /glade/campaign/ral/hap/cenlinhe/NoahMP_benchmark/, see details about the storage system at https://arc.ucar.edu/knowledge_base/70549621) and can be provided by the corresponding author upon request, due to the extremely large data size (8.8 TB)."
Hope that our revision satisfies the journal requirement and please let me know if you found any further issues.
Thank you
Cenlin He
Â
-
CEC2: 'Reply on AC1', Juan Antonio Añel, 10 May 2023
reply
Dear authors,
Many thanks for your quick reply. It solves all the issues regarding code and data for this version of your manuscript.
Regards,
Juan A. Añel
Geosci. Model Dev. Executive Editor
Citation: https://doi.org/10.5194/egusphere-2023-675-CEC2
-
CEC2: 'Reply on AC1', Juan Antonio Añel, 10 May 2023
reply
-
AC1: 'Reply on CEC1', Cenlin He, 06 May 2023
reply
-
RC1: 'Comment on egusphere-2023-675', Anonymous Referee #1, 22 May 2023
reply
This manuscript describes the modernization and refactoring of the widely-used state-of-art Noah-MP LSM, which was released as Noah-MP v5.0. The mordent Fortran code and data structures and standards are adopted in the refactoring. Five key features, including re-organized model physics inro individual process-level Fortran module files, enhanced data structure, enhanced code structure, self-explanatory variable naming standard, and enhanced interface structure to couple with the host models are introduced. It is introduced that the latest released Noah-MP has been coupled with NCAR/HRLDAS system. Some benchmark simulation results over the CONUS are presented. The work of coupling the Noah-MP v5.0 with the latest NASA/LIS system and the WRF-Hydro/NWM system is on-going. In the future, it is also plan to couple to other weather and climate models.
Â
The original code of the model is length single Fortran file. One has to read through the whole file and locate places interested. The refactoring procedures provide a modernized and interoperated model system, with which users could easily understand, modify or utilize in wide applications. As an open-sourced model, the simulation results should be reproducible with given forcing datasets. It is a substantial contribution to modelling science within the scope of Geoscientific Model Development. The manuscript is logical clearly, concisely, and well-structurally interpreted. In addition, model refactoring is a burdensome but less productive task. Not much people have willingness to do this work. This manuscript describes the refactoring conception and processes of the widely-used land surface model. For this kind fundamental work, encourage and circulate should be deserved. I think it is acceptable with minor revisions.
Â
The manuscript detailed describes the model structures, and what have been done with the model coupling to HRLDAS. My only concern is about the future plans. It is stated that the Noah-MP v5,0 will be coupled with more host models. It is encouraging. However, every model has its discrepancies. What are the advantages and disadvantages of this model? how about the future plans for model developments and applications? What is the next step in next several years to promote the advantages and makeup the weakness?  Â
Citation: https://doi.org/10.5194/egusphere-2023-675-RC1
Cenlin He et al.
Cenlin He et al.
Viewed
HTML | XML | Total | BibTeX | EndNote | |
---|---|---|---|---|---|
373 | 176 | 13 | 562 | 5 | 6 |
- HTML: 373
- PDF: 176
- XML: 13
- Total: 562
- BibTeX: 5
- EndNote: 6
Viewed (geographical distribution)
Country | # | Views | % |
---|
Total: | 0 |
HTML: | 0 |
PDF: | 0 |
XML: | 0 |
- 1