Bancheri and Formetta

LINKERS

JGrass-NewAge: NetRadiation componentMarialaura Bancheri*†

and Giuseppe Formetta†

*Correspondence:

marialaura.bancheri@unitn.it

Dipartimento di Ingegneria Civile

Ambientale e Meccanica, Trento,

Mesiano di Povo, Trento, IT

Full list of author information is

available at the end of the article†Code Author

Abstract

These pages teach how to run the NetRadiation component inside the OMS 3console. Some preliminary knowledge and installation of OMS is mandatory (see @Alsouseful). This component deals with the computation of the net radiation (Rn), which isnecessary for the evapotranspiration estimation and for the snow modeling. It derivesfrom the local difference between downwelling radiation and upwelling radiation, and isusually subdivided into shortwave radiation, direct and diffuse (S ↓ and d ↓) andlongwave radiation, downwelling and upwelling (L ↓ and L ↑). It is perfectly integratedin the system and its outputs can be the inputs of different components, e.g. theSWRB component (1)

@Version:0.1

@License:GPL v. 3

@Inputs:• L ↓ (W/m2)• L ↑ (W/m2)• S ↓ (W/m2)• d ↓ (W/m2)

@Outputs:• Rn (W/m2).

@Doc Author: Marialaura Bancheri

@References:• See References section below

Keywords: OMS; JJGrass-NewAGE Component Description; Net radiation

Bancheri and Formetta Page 2 of 6

Code Information

Executables

This link points to the jar file that, once downloaded can be used in the OMS console:

https://github.com/GEOframeOMSProjects/OMS_Project_NETRAD/tree/master/lib

Developer Info

This link points to useful information for the developers, i.e. information about the code

internals, algorithms and the source code

https://github.com/geoframecomponents

Also useful

To run JJGrass-NewAGE it is necessary to know how to use the OMS console. Information

at: ”How to install and run the OMS console”,

https://alm.engr.colostate.edu/cb/project/oms).

JJGrasstools are required for preparing some input data (information at:

http://abouthydrology.blogspot.it/2012/11/udig-jgrasstools-resources-in-italian.

html

To visualize results you need a GIS. Use your preferred GIS, following its installation

instructions. To make statistics on the results, you can probably get benefits from R:

http://www.r-project.org/ and follow its installation instruction.

To whom address questions

marialaura.bancheri@unitn.it

Authors of documentation

Marialaura Bancheri (marialaura.bancheri@unitn.it)

This documentation is released under Creative Commons 4.0 Attribution International

Bancheri and Formetta Page 3 of 6

Component DescriptionNet radiation is necessary for evapotranspiration estimation and for snow modelling. It

derives from the local difference between downwelling radiation and upwelling radiation,

and is usually subdivided into shortwave radiation and longwave radiation. Therefore,

radiation budgets can be expressed, for any point in the landscape, as:

Rn = (1− α)(S ↓ +d ↓) + L ↓ −L ↑ (1)

where Rn (W/m2) is the net radiation, α [−] is the albedo, S ↓ (W/m2) is the direct

shortwave radiation and d ↓ (W/m2) is the diffuse shortwave radiation, L ↓ (W/m2) is the

downwellling longwave radiation and L ↑ (W/m2) is the upwelling longwave radiation.

For details on Rn estimation, which includes geometric and topographic corrections, and

various attenuation factors, please refer to (1).

Detailed Inputs description

General description

The input file is a .csv file containing a header and one or more time series of input data,

depending on the number of stations involved. Each column of the file is associated to a

different station.

The file must have the following header:

• The first 3 rows with general information such as the date of the creation of the file

and the author;

• the fourth and fifth rows contain the IDs of the stations (e.g. station number 8:

value 8, ID, ,8);

• the sixth row contains the information about the type of the input data (in this

case, one column with the date and one column with double values);

• the seventh row specifies the date format (YYYY-MM-dd HH:mm).

All this information shown in the figure 1.

Figure 1 Heading of the .csv input file

L ↓The L ↓ is given in time series or raster maps of (W/m2) values. It can be computed using

the LWRB component (see https://github.com/GEOframeOMSProjects/OMS_Project_

LWRB).

Bancheri and Formetta Page 4 of 6

L ↑The L ↑ is given in time series or raster maps of (W/m2) values. It can be computed using

the LWRB component (see https://github.com/GEOframeOMSProjects/OMS_Project_

LWRB).

S ↓The S ↑ is given in time series or raster maps of (W/m2) values. It can be computed using

the SWRB component (see https://github.com/GEOframeOMSProjects/OMS_Project_

SWRB).

d ↓The d ↓ is given in time series or raster maps of (W/m2) values. It can be computed using

the SWRB component (see https://github.com/GEOframeOMSProjects/OMS_Project_

SWRB).

α

α is the double value of the soil albedo.

Detailed Outputs descriptionNet Radiation

The computed Rn is given as time series at a given point as raster maps. Its units are

(W/m2). Figure 2 shows the results of a simulation obtained using data from a station

in Oklahoma.

0 5000 10000 15000

0200

400

600

800

Net radiation

Time[h]

Net

Rad

[W/m

2]

Figure 2 Time series of net radiation obtained using data from the station ARM USDA UNL OSUWoodward Switchgrass 1 / US-AR1 in Oklahoma.

ExamplesThe following .sim file is customized for the use of the rain-snow separation component.

The .sim file can be downloaded from here:

https://github.com/GEOframeOMSProjects/OMS_Project_NETRAD/tree/master/simulation

import static oms3.SimBuilder.instance as OMS3def home = oms_prj

def startDate= "2004 -06 -14 00:00"def endDate="2004 -06 -16 00:00"

Bancheri and Formetta Page 5 of 6

OMS3.sim {

resource "$oms_prj/lib"

model(while: "reader_data_DirectSWRB.doProcess" ) {components {

// components to be called: reader input data , lwrb and writeroutput data

"reader_data_DirectSWRB" "org.jgrasstools.gears.io.timedependent.OmsTimeSeriesIteratorReader"

"reader_data_DiffuseSWRB" "org.jgrasstools.gears.io.timedependent.OmsTimeSeriesIteratorReader"

"reader_data_down" "org.jgrasstools.gears.io.timedependent.OmsTimeSeriesIteratorReader"

"reader_data_up" "org.jgrasstools.gears.io.timedependent.OmsTimeSeriesIteratorReader"

"net" "org.jgrasstools.gears.io.shapefile.OmsShapefileFeatureReader"

"writer_net" "org.jgrasstools.gears.io.timedependent.OmsTimeSeriesIteratorWriter"

}

parameter{

// parameter of the reader components"reader_data_DirectSWRB.file" "${home}/data/DIRETTA.

csv""reader_data_DirectSWRB.idfield" "ID""reader_data_DirectSWRB.tStart" "${startDate}""reader_data_DirectSWRB.tEnd" "${endDate}""reader_data_DirectSWRB.tTimestep" 60"reader_data_DirectSWRB.fileNovalue" " -9999"

"reader_data_DiffuseSWRB.file" "${home}/data/DIFFUSA.csv"

"reader_data_DiffuseSWRB.idfield" "ID""reader_data_DiffuseSWRB.tStart" "${startDate}""reader_data_DiffuseSWRB.tEnd" "${endDate}""reader_data_DiffuseSWRB.tTimestep" 60"reader_data_DiffuseSWRB.fileNovalue" " -9999"

"reader_data_down.file" "${home}/data/down.csv""reader_data_down.idfield" "ID""reader_data_down.tStart" "${startDate}""reader_data_down.tEnd" "${endDate}""reader_data_down.tTimestep" 60"reader_data_down.fileNovalue" " -9999"

"reader_data_up.file" "${home}/data/up.csv""reader_data_up.idfield" "ID""reader_data_up.tStart" "${startDate}""reader_data_up.tEnd" "${endDate}""reader_data_up.tTimestep" 60"reader_data_up.fileNovalue" " -9999"

"net.alfa" 0

// parameter of the writing component"writer_net.file" "${home}/ output/netRad.csv""writer_net.tStart" "${startDate}""writer_net.tTimestep" 60

}connect {

"reader_data_DirectSWRB.outData" "net.inShortwaveDirectValues"

"reader_data_DiffuseSWRB.outData" "net.inShortwaveDiffuseValues"

Bancheri and Formetta Page 6 of 6

"reader_data_down.outData" "net.inDownwellingValues"

"reader_data_up.outData" "net.inUpwellingValues"

"net.outHMnetRad" "writer_net.inData"

}

}}

Data and ProjectThe following link is for the download of the input data necessaries to execute the CI

component (as shown in the .sim file in the previous section ) :

https://github.com/GEOframeOMSProjects/OMS_Project_NETRAD/tree/master/data

The following link is for the download of the OMS project for the component:

https://github.com/GEOframeOMSProjects/OMS_Project_NETRAD

%

References1. Formetta, G., Rigon, R., Chavez, J., David, O.: Modeling shortwave solar radiation using the jgrass-newage system.

Geoscientific Model Development 6(4), 915–928 (2013)