UFS Short-Range Weather (SRW) Practical Session Guide | Session 1 > 1. Clone the Code

Estimated time: 5 minutes

The necessary source code is publicly available on GitHub.  To clone the ufs-v1.0.1 branch of the ufs-srweather-app repository:

git clone -b ufs-v1.0.1 https://github.com/ufs-community/ufs-srweather-app.git
cd ufs-srweather-app

For convenience, set:

SR_WX_APP_TOP_DIR=`pwd`

The UFS SRW App uses components from multiple repositories, including: the regional workflow, the UFS_UTILS pre-processor utilities, the UFS Weather Model, and the Unified Post Processor (UPP).  Obtaining the necessary external repositories is simplified by the use of manage_externals:

./manage_externals/checkout_externals

The checkout_externals script uses the configuration file Externals.cfg in the top level directory and will clone the regional workflow, pre-processing utilities, UFS Weather Model, and UPP source code into the appropriate directories under your regional_workflow and src directories.  The process will take several minutes and show the following progress information on the screen:

Processing externals description file : Externals.cfg
Checking status of externals: regional_workflow, ufs-weather-model, ufs_utils, emc_post,
Checking out externals: regional_workflow, ufs-weather-model, ufs_utils, emc_post,
Note: Take a look at the Externals.cfg file to see the repositories, branches, and local paths used for each of the external components.

Once the externals have been downloaded, you can proceed to the next step, building the executables.