This documentation teaches how to run the net radiation component of JGrass-NewAge

1. Bancheri and Formetta
LINKERS
JGrass-NewAge: NetRadiation component
Marialaura 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 3
console. Some preliminary knowledge and installation of OMS is mandatory (see @Also
useful). This component deals with the computation of the net radiation (Rn), which is
necessary for the evapotranspiration estimation and for the snow modeling. It derives
from the local difference between downwelling radiation and upwelling radiation, and is
usually subdivided into shortwave radiation, direct and diffuse (S ↓ and d ↓) and
longwave radiation, downwelling and upwelling (L ↓ and L ↑). It is perfectly integrated
in the system and its outputs can be the inputs of different components, e.g. the
SWRB 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

2. 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

3. Bancheri and Formetta Page 3 of 6
Component Description
Net 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).

4. 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 description
Net 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
0200400600800
Net radiation
Time[h]
NetRad[W/m2]
Figure 2 Time series of net radiation obtained using data from the station ARM USDA UNL OSU
Woodward Switchgrass 1 / US-AR1 in Oklahoma.
Examples
The 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 OMS3
def home = oms_prj
def startDate= "2004 -06 -14 00:00"
def endDate="2004 -06 -16 00:00"

5. 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 writer
output 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 "

6. 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 Project
The 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
%
References
1. Formetta, G., Rigon, R., Ch´avez, J., David, O.: Modeling shortwave solar radiation using the jgrass-newage system.
Geoscientific Model Development 6(4), 915–928 (2013)