Difference between revisions of "NU-WRF"

(Imported from Wikispaces)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
{{Stub}}
 +
[[Category: WRF]]
  
<span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">NU-WRF stands for NASA Unified WRF. This is an augmented WRF code with additional software developed at NASA. This WRF version has been primarily chosen in order to run CABLE coupled to WRF through the LIS software. There are additional softwares distributed along WRF in NU-WRF:</span>
+
NU-WRF stands for NASA Unified WRF. This is an augmented WRF code with additional software developed at NASA. This WRF version has been primarily chosen in order to run CABLE coupled to WRF through the LIS software. There are additional software distributed along WRF in NU-WRF:
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">ARWpost</span>
+
* ARWpost
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">GSDSU</span>
+
* GSDSU
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">LVT</span>
+
* LVT
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">MET</span>
+
* MET
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">RIP4</span>
+
* RIP4
* <span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">UPP</span>
+
* UPP
  
<span style="font-family: Arial,Helvetica,sans-serif; font-size: 110%;">These are still distributed on NCI machine but they have not been ported or tested by the CMS team. </span>
+
These are still distributed on NCI machine but they have not been ported or tested by the CMS team.
  
=Manuals=
+
This model is still under license. If you are interested to use this model, please contact [mailto:cws_help@nci.org.au the CMS team] with information on where you are working and what you are doing.
----
 
Following are the links to the official relevant manuals for each software:
 
* [http://lis.gsfc.nasa.gov/LIS_documentation.php | LIS]
 
* [http://www2.mmm.ucar.edu/wrf/users/ | WRF]
 
* [https://trac.nci.org.au/trac/cable/wiki | CABLE]
 
 
 
=NU-WRF installation=
 
----
 
==Accessing NU-WRF==
 
LIS is under licence. To restrict access to the NU-WRF code, it was set as a private repository on [https://bitbucket.org/ | BitBucket]. To gain access to the repository, send an email to [[mailto:climate_help@nf.nci.org.au | climate_help]] to request the connection including the email address you want to link to BitBucket. You should then receive an invitation to join the NU-WRF repository.
 
 
 
==Installing NU-WRF==
 
===<span style="line-height: 1.5;">Clone the repository.</span>===
 
<span style="line-height: 1.5;">Once you have access to the BitBucket repository, you need to clone the repository onto the NCI machine. There are two ways to clone from BitBucket, you can either use a HTTPS link or a SSH link. Both work with NCI machine. With HTTPS, you will need to provide your BitBucket password at each connection. For SSH, you will need to first create a SSH key but then you can setup the system to retrieve the key automatically without entering it (see [https://confluence.atlassian.com/display/BITBUCKET/Set+up+SSH+for+Git | BitBucket help]</span>). Cloning the repository should create a local repository in your file system called nu-wrf.
 
 
 
===Compilation===
 
Since NU-WRF has been ported to NCI, you should be able to compile the WRF/WPS components of NU-WRF straight away. The code comes with the script nu-wrf/run_build. Please review the script to choose the appropriate compilation options (you can compile LIS alone '''or''' WRF alone '''or''' WRF coupled to LIS '''and/or''' WPS) and PBS options.
 
For a successful compilation, the output script should contain a line reading:
 
<syntaxhighlight>
 
Completed build of <component_name> component of NU-WRF!
 
</syntaxhighlight>
 
where <component_name> is replaced by the name of the compiled component. Note that if you ask for compiling two components at once (e.g. WRF and WPS), you will need to search for the "Completed" line for both components.
 
 
 
=Running WRF with LIS=
 
----
 
Normally to run a real simulation with WRF, the user has to create the boundary condition files with WPS then run WRF. Using LIS modifies the workflow in several ways (see [[NU-WRF workflow | graph]]):
 
* Interpolate the LIS input data to the grid resolution used for your WRF simulation.
 
* Run LIS offline (i.e. not coupled to WRF) on the exact same grid that will be used for the WRF simulation. You are required to save a certain number of fields that will be used to create the input conditions for WRF. This phase is called the spin-up.
 
* real.exe has been modified and now queries input from both WPS output and a LIS output file.
 
* wrf.exe will expect a LIS restart file and a LIS configuration file.
 
Scripts have been developed by the CMS team to facilitate the management of simulations with NU-WRF on NCI machines, including to run the spin-up and ensure the concordance of information between WRF and LIS configuration files. It is assumed that a user has access to NCI servers. However, since the workflow is based on template files, these are easily customisable to use on any machine. These also provide the possibility to store inputs and outputs on a different machine and to automatically move the files across machines for each run.
 
The scripts are in a public Git repository on Bitbucket: [https://bitbucket.org/ccarouge/nu-wrf_scripts | NU-WRF scripts].
 
 
 
See the [[NU-WRF workflow]] page for instructions about these scripts. These instructions will run you through testcases for CABLE through LIS only and CABLE-LIS-WRF.
 

Revision as of 00:19, 12 December 2019

Template:Stub This is a stub page and needs expansion

NU-WRF stands for NASA Unified WRF. This is an augmented WRF code with additional software developed at NASA. This WRF version has been primarily chosen in order to run CABLE coupled to WRF through the LIS software. There are additional software distributed along WRF in NU-WRF:

  • ARWpost
  • GSDSU
  • LVT
  • MET
  • RIP4
  • UPP

These are still distributed on NCI machine but they have not been ported or tested by the CMS team.

This model is still under license. If you are interested to use this model, please contact the CMS team with information on where you are working and what you are doing.