Last data update: 2014.03.03

R: Instantaneous Potential Solar Radiation
PotSolarInstR Documentation

Instantaneous Potential Solar Radiation

Description

Potential Solar Radiation at a particular time of day. Defaults to W/m2, can also report in kJ/m2/d if units set to kJ/m2/d

Usage

PotSolarInst(Jday, hour = 12, lat = 42.44 * pi/180, sunrise = NULL,
 sunset = NULL, SolarNoon = mean(c(sunrise, sunset)), units = "Wm2",
 latUnits = "unknown")

Arguments

Jday

Day of the year [-]

hour

Time of the day in hours [0-24 hr]

lat

latitude. Default is radians, but will automatically convert from degrees if value is larger than 1.62 or less than -1.62

sunrise

Time of sunrise used to calculate solar noon [0-24 hr]

sunset

Time of sunset used to calculate solar noon [0-24 hr]

SolarNoon

Time of solar noon. Can be calculated from sunrise and sunset times. [hr]

units

Units of the result. Defaults to W/m2

latUnits

Latitude units can be explicitly stated here, options are 'radians', 'degrees' or default is 'unknown', which will assume radians unless the absolute value of lat is greater than pi/2

Author(s)

Josephine Archibald

References

Lawrence Dingman. Physical Hydrology. Waveland Press, Inc. Illinois, 2002.

Examples


PotSolarInst(Jday=150, hour = 15, lat = 42.44, SolarNoon = 12.5) 
PotSolarInst(Jday=c(1,50,100,150), hour = c(9,10,12,17), lat = -pi/4, SolarNoon = 12.5) 

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(EcoHydRology)
Loading required package: operators

Attaching package: 'operators'

The following objects are masked from 'package:base':

    options, strrep

Loading required package: topmodel
Loading required package: DEoptim

DEoptim package
Differential Evolution algorithm in R
Authors: D. Ardia, K. Mullen, B. Peterson and J. Ulrich

Loading required package: XML
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/EcoHydRology/PotSolarInst.Rd_%03d_medium.png", width=480, height=480)
> ### Name: PotSolarInst
> ### Title: Instantaneous Potential Solar Radiation
> ### Aliases: PotSolarInst
> 
> ### ** Examples
> 
> 
> PotSolarInst(Jday=150, hour = 15, lat = 42.44, SolarNoon = 12.5) 
[1] 1090
> PotSolarInst(Jday=c(1,50,100,150), hour = c(9,10,12,17), lat = -pi/4, SolarNoon = 12.5) 
[1] 919 947 813   0
Warning message:
In PotSolarInst(Jday = c(1, 50, 100, 150), hour = c(9, 10, 12, 17),  :
  in PotSolarInst call: Latitude assumed to be in radians, if using degrees, please set latUnits = 'degrees'
> 
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>