Lab-0015: Difference between revisions
From CSDMS
m (Use logo with CSDMS colors) |
No edit summary |
||
Line 47: | Line 47: | ||
{{LabTopicalLearningObjectives | {{LabTopicalLearningObjectives | ||
|LabTopicalLearningObjective=Diffusion of temperature | |LabTopicalLearningObjective=Diffusion of temperature | ||
}} | |||
{{LabTopicalLearningObjectives | |||
|LabTopicalLearningObjective=Software interface | |||
}} | }} | ||
{{LabNotes | {{LabNotes |
Revision as of 14:58, 26 August 2020
Introduction to CSDMS Tools - Basic Model Interface (BMI)
Contributor(s)
Eric Hutton at INSTAAR - University of Colorado Boulder.
Mark Piper at INSTAAR - University of Colorado Boulder.
Greg Tucker at Geological Sciences - University of Colorado Boulder.
Irina Overeem at INSTAAR - University of Colorado Boulder.
Introduction
The Basic Model Interface (BMI) is a set of standard control and query functions that, when added to a model code, make that model both easier to learn and easier to couple with other software elements. Detailed information about BMI can be found at https://bmi.readthedocs.io.
Classroom organization
In this lab, we explore what BMI is and how to use it through a pair of Jupyter Notebooks. This lab first illustrates an example "Heat" model which simulates the diffusion of temperature on a uniform rectangular plate with Dirichlet boundary conditions. Then, the lab demonstrates how to run "Heat" model through its BMI.
Learning objectives
Skills
Skills
- View model source code and model BMI source code
- Learn to set up and run the Heat model
- Learn to set up and run the Heat model through its BMI
Key concepts
- Diffusion of temperature
- Software interface
Lab notes
The lab requires the source code from the bmi-example-python repository: https://github.com/csdms/bmi-example-python.
Acknowledgements
This material is based upon work supported by the National Science Foundation under Grant No. 1831623, Community Facility Support: The Community Surface Dynamics Modeling System (CSDMS).
References
- Hutton, E.W.H., Piper, M.D., and Tucker, G.E., 2020. The Basic Model Interface 2.0: A standard interface for coupling numerical models in the geosciences. Journal of Open Source Software, 5(51), 2317, https://doi.org/10.21105/joss.02317
- Peckham, S.D., Hutton, E.W., and Norris, B., 2013. A component-based approach to integrated modeling in the geosciences: The design of CSDMS. Computers & Geosciences, 53, pp.3-12, http://dx.doi.org/10.1016/j.cageo.2012.04.002.