[Dart-dev] [5883] DART/branches/development/models/noah/templates: Made a change suggested by Rafael.

nancy at ucar.edu nancy at ucar.edu
Fri Sep 21 13:07:44 MDT 2012


Revision: 5883
Author:   thoar
Date:     2012-09-21 13:07:43 -0600 (Fri, 21 Sep 2012)
Log Message:
-----------
Made a change suggested by Rafael. Combined the two separate README's into one.

Added Paths:
-----------
    DART/branches/development/models/noah/templates/README
    DART/branches/development/models/noah/templates/namelist.hrldas.template
    DART/branches/development/models/noah/templates/wrfinput.template.ascii

-------------- next part --------------
Added: DART/branches/development/models/noah/templates/README
===================================================================
--- DART/branches/development/models/noah/templates/README	                        (rev 0)
+++ DART/branches/development/models/noah/templates/README	2012-09-21 19:07:43 UTC (rev 5883)
@@ -0,0 +1,176 @@
+NOAH land surface model: Supporting files
+Rafael Rosolem (08/21/2012)
+rosolem at email.arizona.edu
+
+This document describes the necesary files needed to run NOAH HRLDAS for a single-point.
+We provide the DART-NOAH user with some template files that can be easily changed to accommodate
+specific needs. For now, we are assuming the user will run NOAH with hourly timesteps. There are
+three files in this directory:
+
+[1] namelist.hrldas.template
+This is the namelist file used by NOAH. There are only a few things the user needs to pay attention
+to in this file:
+   (a) HRLDAS_CONSTANTS_FILE: Need to point where the file 'wrfinput' is located for the simulation
+   (b) INDIR: Need to point where the directory containing the forcing files is located for the
+       simulation
+   (c) OUTDIR: Similar to INDIR but for the output and restart files generated by NOAH
+   (d) START_{YEAR,MONTH,DAY,HOUR,MIN} is only used if you are running for the very first time. Here
+       we are assuming a restart file is available (see next item), so the time information will be
+       retrieve from that file
+   (e) RESTART_FILENAME_REQUESTED: Comment if you would like to run for the very first time (we are not
+       doing this here). We will always assume there is a restart file available for the first step in
+       the simulation, hence the complete path to the file needs to be included in here
+   (f) KDAY and KHOUR: We are assuming simulations are going to be for hourly timesteps, so KDAY = 0 and
+       KHOUR = 1
+   (g) FORCING_TIMESTEP, NOAH_TIMESTEP, OUTPUT_TIMESTEP: We assume FORCING_TIMESTEP = 3600 seconds (i.e.,
+       hourly) and that model timestep follows forcing exactly (handling frequent restarts in NOAH when
+       NOAH_TIMESTEP is multiple of FORCING_TIMESTEP is difficult and cumbersome). If you running NOAH
+       coupled to DART, the OUTPUT files (LDASOUT) are not really used but for consistency we output
+       them at the same time interval as the forcing   
+   (h) RESTART_FREQUENCY_HOURS: For NOAH-DART, this is currently set to 3600 seconds (i.e., hourly) but
+       if you run standalone NOAH, you might want to set it to a different value to better accomodate your
+       needs (e.g., spin-up)
+   (i) SPLIT_OUTPUT_COUNT: If you are running standalone NOAH, you might want to set a large number so all
+        output are copied to a single file.
+   (j) ZLVL and ZLVL_WIND: Measurement height and wind measurement height. Need to change this based on 
+       specific site
+   (k) UPDATE_SNOW_FROM_FORCING: Unless you have snow data that can actually force NOAH, you should make
+       sure this options is always set to '.FALSE.'
+
+[2] wrfinput.template
+This file contains some information about the location and look-up tables for soil and vegetation parameters.
+The final file needs to be generated as NetCDF by invoking the following command:
+ncgen -o ncfile wrfinput.template.ascii, where ncfile is any name given to the file (e.g., wrfinput). You can
+check whether the file has been properly created by using ncdump.
+   (a) global attributes: There are many attributes that we don't change because they appear to be specific to
+       NOAH-WRF runs. The ones I am currently changing are:
+       (i) CEN_LAT, CEN_LON, TRUELAT1, TRUELAT2, MOAD_CEN_LAT, STAND_LON --> with site specific informaiton
+       (ii) I am not sure at the moment whether the following attributes need to be chnaged to site-specifc
+            values (GMT, JULYR, JULDAY) [NEED TO CONTACT MICHAEL BARLAGE]
+   (b) IVGTYP: Check VEGPARM.TBL for a list of vegetation types (notice that MODIFIED_IGBP_MODIS_NOAH) is being
+       used
+   (c) ISLTYP: Check SOILPARM.TBL for a list of soil types (STATS is the done used here)
+   (d) HGT: Site-specific elevation
+   (e) XLAT and XLON: Site-specific latitude (-90,90) and longitude (-180,180)
+   (f) TMN: Deep soil temperature (constant): A comment in the code mentions that annual average surface temperature
+       can be used for this variable
+
+[3] RESTART.YYYYMMDDHH_DOMAIN1.template.ascii
+This is the RESTART file for NOAH. It carries other than state variables, so in principle, you need to change
+only these state variables. The final file needs to be generated as NetCDF by invoking the following command:
+ncgen -o ncfile RESTART.YYYYMMDDHH_DOMAIN1.template.ascii, where ncfile is any name given to the file (e.g., 
+RESTART.2009010100_DOMAIN1). You can check whether the file has been properly created by using ncdump.
+The list of variables to be changed are as follows:
+    (a) Times: Make sure the date matches with the date you would like the model to restart from
+    (b) SOIL_T: Soil temperature (K) (originally for four layers)
+    (c) SOIL_M: Volumetric soil moisture content (m3/m3) (originally for four layers)
+    (d) SOIL_W: Liquid water content (volumetric) (m3/m3) (originally for four layers)
+    (e) SNODEP: Snow depth (m)
+    (f) WEASD: Water equivalent snow depth (m)
+    (g) SKINTEMP: Skin temperature (K)
+    (h) CANWAT: Canopy water content (mm)
+    (i) CH and CHX: Surface exchange coefficient for heat(-) (same value)
+    (j) CMX: Surface exchange coefficient for momentum (-)
+    (k) ALBED: Surface albedo including snow effect (fraction)
+
+
+
+
+Download the support files to test an installation from:
+http://www.image.ucar.edu/pub/DART/NOAH/NOAH_DART_files.tar.gz
+
+Please untar the file from the DART/models/noah directory.
+It will install the following files into
+DART/models/noah/ensemble_source
+DART/models/noah/forcing
+DART/models/noah/templates
+
+             ensemble_source/
+             ensemble_source/RESTART.2009010200_DOMAIN1.0001.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0002.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0003.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0004.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0005.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0006.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0007.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0008.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0009.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0010.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0011.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0012.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0013.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0014.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0015.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0016.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0017.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0018.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0019.nc
+             ensemble_source/RESTART.2009010200_DOMAIN1.0020.nc
+             forcing/
+             forcing/santarita/
+             forcing/santarita/noah_forcing_2009.0001.nc
+             forcing/santarita/noah_forcing_2009.0002.nc
+             forcing/santarita/noah_forcing_2009.0003.nc
+             forcing/santarita/noah_forcing_2009.0004.nc
+             forcing/santarita/noah_forcing_2009.0005.nc
+             forcing/santarita/noah_forcing_2009.0006.nc
+             forcing/santarita/noah_forcing_2009.0007.nc
+             forcing/santarita/noah_forcing_2009.0008.nc
+             forcing/santarita/noah_forcing_2009.0009.nc
+             forcing/santarita/noah_forcing_2009.0010.nc
+             forcing/santarita/noah_forcing_2009.0011.nc
+             forcing/santarita/noah_forcing_2009.0012.nc
+             forcing/santarita/noah_forcing_2009.0013.nc
+             forcing/santarita/noah_forcing_2009.0014.nc
+             forcing/santarita/noah_forcing_2009.0015.nc
+             forcing/santarita/noah_forcing_2009.0016.nc
+             forcing/santarita/noah_forcing_2009.0017.nc
+             forcing/santarita/noah_forcing_2009.0018.nc
+             forcing/santarita/noah_forcing_2009.0019.nc
+             forcing/santarita/noah_forcing_2009.0020.nc
+             forcing/santarita/noah_forcing_2010.0001.nc
+             forcing/santarita/noah_forcing_2010.0002.nc
+             forcing/santarita/noah_forcing_2010.0003.nc
+             forcing/santarita/noah_forcing_2010.0004.nc
+             forcing/santarita/noah_forcing_2010.0005.nc
+             forcing/santarita/noah_forcing_2010.0006.nc
+             forcing/santarita/noah_forcing_2010.0007.nc
+             forcing/santarita/noah_forcing_2010.0008.nc
+             forcing/santarita/noah_forcing_2010.0009.nc
+             forcing/santarita/noah_forcing_2010.0010.nc
+             forcing/santarita/noah_forcing_2010.0011.nc
+             forcing/santarita/noah_forcing_2010.0012.nc
+             forcing/santarita/noah_forcing_2010.0013.nc
+             forcing/santarita/noah_forcing_2010.0014.nc
+             forcing/santarita/noah_forcing_2010.0015.nc
+             forcing/santarita/noah_forcing_2010.0016.nc
+             forcing/santarita/noah_forcing_2010.0017.nc
+             forcing/santarita/noah_forcing_2010.0018.nc
+             forcing/santarita/noah_forcing_2010.0019.nc
+             forcing/santarita/noah_forcing_2010.0020.nc
+             forcing/santarita/noah_forcing_2011.0001.nc
+             forcing/santarita/noah_forcing_2011.0002.nc
+             forcing/santarita/noah_forcing_2011.0003.nc
+             forcing/santarita/noah_forcing_2011.0004.nc
+             forcing/santarita/noah_forcing_2011.0005.nc
+             forcing/santarita/noah_forcing_2011.0006.nc
+             forcing/santarita/noah_forcing_2011.0007.nc
+             forcing/santarita/noah_forcing_2011.0008.nc
+             forcing/santarita/noah_forcing_2011.0009.nc
+             forcing/santarita/noah_forcing_2011.0010.nc
+             forcing/santarita/noah_forcing_2011.0011.nc
+             forcing/santarita/noah_forcing_2011.0012.nc
+             forcing/santarita/noah_forcing_2011.0013.nc
+             forcing/santarita/noah_forcing_2011.0014.nc
+             forcing/santarita/noah_forcing_2011.0015.nc
+             forcing/santarita/noah_forcing_2011.0016.nc
+             forcing/santarita/noah_forcing_2011.0017.nc
+             forcing/santarita/noah_forcing_2011.0018.nc
+             forcing/santarita/noah_forcing_2011.0019.nc
+             forcing/santarita/noah_forcing_2011.0020.nc
+             templates/
+             templates/namelist.hrldas.template
+             templates/README
+             templates/RESTART.YYYYMMDDHH_DOMAIN1.template.ascii
+             templates/wrfinput.template
+             templates/wrfinput.template.ascii


Property changes on: DART/branches/development/models/noah/templates/README
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:keywords
   + Date Rev Author HeadURL Id
Added: svn:eol-style
   + native

Added: DART/branches/development/models/noah/templates/namelist.hrldas.template
===================================================================
--- DART/branches/development/models/noah/templates/namelist.hrldas.template	                        (rev 0)
+++ DART/branches/development/models/noah/templates/namelist.hrldas.template	2012-09-21 19:07:43 UTC (rev 5883)
@@ -0,0 +1,38 @@
+
+### THIS IS FOR DART ###
+FORCING_FILE_DIRECTORY = "/Users/thoar/svn/DART/devel/models/noah/forcing/santarita"
+
+&NOAHLSM_OFFLINE
+
+   HRLDAS_CONSTANTS_FILE = "wrfinput"
+   INDIR  = "."
+   OUTDIR = "."
+
+   RESTART_FILENAME_REQUESTED = "restart.nc"
+
+   KHOUR                   = 1
+   FORCING_TIMESTEP        = 3600
+   NOAH_TIMESTEP           = 3600
+   OUTPUT_TIMESTEP         = 3600
+   RESTART_FREQUENCY_HOURS = 1
+   SPLIT_OUTPUT_COUNT      = 1000
+
+   NSOIL=4
+   ZSOIL(1) = -0.10
+   ZSOIL(2) = -0.40
+   ZSOIL(3) = -1.00
+   ZSOIL(4) = -2.00
+
+   ZLVL      = 3.3
+   ZLVL_WIND = 3.3
+
+   IZ0TLND       = 0
+   SFCDIF_OPTION = 0
+   UPDATE_SNOW_FROM_FORCING = .FALSE.
+
+/
+
+&URBAN_OFFLINE
+   SF_URBAN_PHYSICS = 0
+   ZLVL_URBAN       = 15.0
+/

Added: DART/branches/development/models/noah/templates/wrfinput.template.ascii
===================================================================
--- DART/branches/development/models/noah/templates/wrfinput.template.ascii	                        (rev 0)
+++ DART/branches/development/models/noah/templates/wrfinput.template.ascii	2012-09-21 19:07:43 UTC (rev 5883)
@@ -0,0 +1,143 @@
+netcdf wrfinput {
+dimensions:
+	Time = 1 ;
+	south_north = 1 ;
+	west_east = 1 ;
+variables:
+	float IVGTYP(Time, south_north, west_east) ;
+		IVGTYP:FieldType = 106 ;
+		IVGTYP:MemoryOrder = "XY" ;
+		IVGTYP:description = "DOMINANT VEGETATION CATEGORY" ;
+		IVGTYP:units = "" ;
+		IVGTYP:stagger = "" ;
+		IVGTYP:coordinates = "XLONG XLAT" ;
+		IVGTYP:_FillValue = -999. ;
+	float ISLTYP(Time, south_north, west_east) ;
+		ISLTYP:FieldType = 106 ;
+		ISLTYP:MemoryOrder = "XY" ;
+		ISLTYP:description = "DOMINANT SOIL CATEGORY" ;
+		ISLTYP:units = "" ;
+		ISLTYP:stagger = "" ;
+		ISLTYP:coordinates = "XLONG XLAT" ;
+		ISLTYP:_FillValue = -999. ;
+	float HGT(Time, south_north, west_east) ;
+		HGT:FieldType = 104 ;
+		HGT:MemoryOrder = "XY" ;
+		HGT:description = "Terrain Height" ;
+		HGT:units = "m" ;
+		HGT:stagger = "" ;
+		HGT:coordinates = "XLONG XLAT" ;
+		HGT:_FillValue = -999. ;
+	float XLAT(Time, south_north, west_east) ;
+		XLAT:coordinates = "XLONG XLAT" ;
+		XLAT:FieldType = 104 ;
+		XLAT:MemoryOrder = "XY" ;
+		XLAT:description = "LATITUDE, SOUTH IS NEGATIVE" ;
+		XLAT:units = "degree_north" ;
+		XLAT:stagger = "" ;
+		XLAT:_FillValue = -999. ;
+	float XLONG(Time, south_north, west_east) ;
+		XLONG:coordinates = "XLONG XLAT" ;
+		XLONG:FieldType = 104 ;
+		XLONG:MemoryOrder = "XY" ;
+		XLONG:description = "LONGITUDE, WEST IS NEGATIVE" ;
+		XLONG:units = "degree_east" ;
+		XLONG:stagger = "" ;
+		XLONG:_FillValue = -999. ;
+	float TMN(Time, south_north, west_east) ;
+		TMN:FieldType = 104 ;
+		TMN:MemoryOrder = "XY" ;
+		TMN:description = "SOIL TEMPERATURE AT LOWER BOUNDARY" ;
+		TMN:units = "K" ;
+		TMN:stagger = "" ;
+		TMN:coordinates = "XLONG XLAT" ;
+		TMN:_FillValue = -999. ;
+
+// global attributes:
+		:TITLE = " OUTPUT FROM REAL_EM V3.1.1 PREPROCESSOR" ;
+		:START_DATE = "1901-01-01_00:00:00" ;
+		:SIMULATION_START_DATE = "1901-01-01_00:00:00" ;
+		:WEST-EAST_GRID_DIMENSION = 1 ;
+		:SOUTH-NORTH_GRID_DIMENSION = 1 ;
+		:BOTTOM-TOP_GRID_DIMENSION = 1 ;
+		:DX = 1000. ;
+		:DY = 1000. ;
+		:GRIDTYPE = "C" ;
+		:DIFF_OPT = 1 ;
+		:KM_OPT = 4 ;
+		:DAMP_OPT = 0 ;
+		:DAMPCOEF = 0.2 ;
+		:KHDIF = 0. ;
+		:KVDIF = 0. ;
+		:MP_PHYSICS = 3 ;
+		:RA_LW_PHYSICS = 1 ;
+		:RA_SW_PHYSICS = 1 ;
+		:SF_SFCLAY_PHYSICS = 1 ;
+		:SF_SURFACE_PHYSICS = 2 ;
+		:BL_PBL_PHYSICS = 1 ;
+		:CU_PHYSICS = 1 ;
+		:SURFACE_INPUT_SOURCE = 1 ;
+		:SST_UPDATE = 0 ;
+		:GRID_FDDA = 0 ;
+		:GFDDA_INTERVAL_M = 0 ;
+		:GFDDA_END_H = 0 ;
+		:GRID_SFDDA = 0 ;
+		:SGFDDA_INTERVAL_M = 0 ;
+		:SGFDDA_END_H = 0 ;
+		:WEST-EAST_PATCH_START_UNSTAG = 1 ;
+		:WEST-EAST_PATCH_END_UNSTAG = 1 ;
+		:WEST-EAST_PATCH_START_STAG = 1 ;
+		:WEST-EAST_PATCH_END_STAG = 1 ;
+		:SOUTH-NORTH_PATCH_START_UNSTAG = 1 ;
+		:SOUTH-NORTH_PATCH_END_UNSTAG = 1 ;
+		:SOUTH-NORTH_PATCH_START_STAG = 1 ;
+		:SOUTH-NORTH_PATCH_END_STAG = 1 ;
+		:BOTTOM-TOP_PATCH_START_UNSTAG = 1 ;
+		:BOTTOM-TOP_PATCH_END_UNSTAG = 27 ;
+		:BOTTOM-TOP_PATCH_START_STAG = 1 ;
+		:BOTTOM-TOP_PATCH_END_STAG = 1 ;
+		:GRID_ID = 1 ;
+		:PARENT_ID = 0 ;
+		:I_PARENT_START = 1 ;
+		:J_PARENT_START = 1 ;
+		:PARENT_GRID_RATIO = 1 ;
+		:DT = 180.f ;
+		:CEN_LAT = 31.9085 ;
+		:CEN_LON = -110.8394 ;
+		:TRUELAT1 = 31. ;
+		:TRUELAT2 = 31. ;
+		:MOAD_CEN_LAT = 31.9085 ;
+		:STAND_LON = -110.8394 ;
+		:POLE_LAT = 90. ;
+		:POLE_LON = 0. ;
+		:GMT = 0. ;
+		:JULYR = 1901 ;
+		:JULDAY = 1 ;
+		:MAP_PROJ = 1 ;
+		:MMINLU = "MODIFIED_IGBP_MODIS_NOAH" ;
+		:NUM_LAND_CAT = 20 ;
+		:ISWATER = 17 ;
+		:ISLAKE = -1 ;
+		:ISICE = 15 ;
+		:ISURBAN = 13 ;
+		:ISOILWATER = 14 ;
+data:
+
+ IVGTYP =
+  7 ;
+
+ ISLTYP =
+  3 ;
+
+ HGT =
+  989.0 ;
+
+ XLAT =
+  31.9085 ;
+
+ XLONG =
+  -110.8394 ;
+
+ TMN =
+  292.8018 ;
+}


Property changes on: DART/branches/development/models/noah/templates/wrfinput.template.ascii
___________________________________________________________________
Added: svn:executable
   + *
Added: svn:mime-type
   + text/plain
Added: svn:keywords
   + Date Rev Author HeadURL Id
Added: svn:eol-style
   + native


More information about the Dart-dev mailing list