calcGef: Irradiation and irradiance on the generator plane.

Description Usage Arguments Value Author(s) References See Also Examples

View source: R/calcGef.R

Description

This function obtains the global, diffuse and direct irradiation and irradiance on the generator plane from the values of daily or intradaily global irradiation on the horizontal plane. It makes use of the functions calcG0, fTheta, fInclin. Besides, it can calculate the shadows effect with the calcShd function.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
calcGef(lat,
        modeTrk = 'fixed',
        modeRad = 'prom',
        dataRad,
        sample = 'hour',
        keep.night = TRUE,
        sunGeometry = 'michalsky',
        corr, f,
        betaLim = 90, beta = abs(lat)-10, alfa = 0,
        iS = 2, alb = 0.2, horizBright = TRUE, HCPV = FALSE,
        modeShd = '',
        struct = list(),
        distances = data.frame(),
        ...)

Arguments

lat

numeric, latitude (degrees) of the point of the Earth where calculations are needed. It is positive for locations above the Equator.

modeTrk

character, to be chosen from 'fixed', 'two' or 'horiz'. When modeTrk = 'fixed' the surface is fixed (inclination and azimuth angles are constant). The performance of a two-axis tracker is calculated with modeTrk = 'two', and modeTrk = 'horiz' is the option for an horizontal N-S tracker. Its default value is modeTrk = 'fixed'

modeRad, dataRad

Information about the source data of the global irradiation. See calcG0 for details.

sample, keep.night

See calcSol for details.

sunGeometry

character, method for the sun geometry calculations. See calcSol, fSolD and fSolI.

corr, f

See calcG0 for details.

beta

numeric, inclination angle of the surface (degrees). It is only needed when modeTrk = 'fixed'.

betaLim

numeric, maximum value of the inclination angle for a tracking surface. Its default value is 90 (no limitation))

alfa

numeric, azimuth angle of the surface (degrees). It is measured from the south (alfa = 0), and it is negative to the east and positive to the west. It is only needed when modeTrk = 'fixed'. Its default value is alfa = 0

iS

integer, degree of dirtiness. Its value must be included in the set (1,2,3,4). iS = 1 corresponds to a clean surface while iS = 4 is the selection for a dirty surface. Its default value is 2.

alb

numeric, albedo reflection coefficient. Its default value is 0.2

modeShd, struct, distances

See calcShd for details.

horizBright

logical, if TRUE, the horizon brightness correction proposed by Reind et al. is used.

HCPV

logical, if TRUE the diffuse and albedo components of the effective irradiance are set to zero. HCPV is the acronym of High Concentration PV system.

...

Additional arguments for calcSol and calcG0

Value

A Gef object.

Author(s)

Oscar Perpiñán Lamigueiro.

References

See Also

calcG0, fTheta, fInclin, calcShd.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
lat <- 37.2

###12 Average days.

G0dm = c(2.766, 3.491, 4.494, 5.912, 6.989, 7.742, 7.919, 7.027, 5.369,
         3.562, 2.814, 2.179)*1000;
Ta = c(10, 14.1, 15.6, 17.2, 19.3, 21.2, 28.4, 29.9, 24.3, 18.2, 17.2,
       15.2)

##Fixed surface, default values of inclination and azimuth.

gef <- calcGef(lat = lat, modeRad = 'prom', dataRad = list(G0dm = G0dm, Ta = Ta))
print(gef)
xyplot(gef)

##Two-axis surface, no limitation angle.

gef2 <- calcGef(lat = lat, modeRad = 'prom',
                dataRad = list(G0dm = G0dm, Ta = Ta),
                modeTrk = 'two')
print(gef2)
xyplot(gef2)

struct = list(W = 23.11, L = 9.8, Nrow = 2, Ncol = 8)
distances = data.frame(Lew = 40, Lns = 30, H = 0)

gefShd <- calcGef(lat = lat, modeRad = 'prom',
                  dataRad = list(G0dm = G0dm, Ta = Ta),
                  modeTrk = 'two',
                  modeShd = c('area', 'prom'), 
                  struct = struct, distances = distances)
print(gefShd)

## Not run: 
##Fixed surface using Aguiar method
gefAguiar <- calcGef(lat = lat, modeRad = 'aguiar', dataRad = G0dm)

##Two-axis tracker, using the previous result.
##'gefAguiar' is internally coerced to a 'G0' object.

gefAguiar2 <- calcGef(lat = lat, modeRad = 'prev', dataRad = gefAguiar, modeTrk = 'two')
print(gefAguiar2)
xyplot(gefAguiar2)

###Shadows between two-axis trackers, again using the gefAguiar result.

struct = list(W = 23.11, L = 9.8, Nrow = 2, Ncol = 8)
distances = data.frame(Lew = 40, Lns = 30, H = 0)

gefShdAguiar <- calcGef(lat = lat, modeRad = 'prev', 
                        dataRad = gefAguiar, modeTrk = 'two', 
                        modeShd = c('area', 'prom'), 
                        struct = struct, distances = distances)
print(gefShdAguiar)

## End(Not run)

Example output

Loading required package: zoo

Attaching package: 'zoo'

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

    as.Date, as.Date.numeric

Loading required package: lattice
Loading required package: latticeExtra
Loading required package: RColorBrewer
Time Zone set to UTC.

Object of class  Gef 

Source of meteorological information: prom- 

Latitude of source:  37.2 degrees
Latitude for calculations:  37.2 degrees

Monthly averages:
               Bod       Bnd       Gd       Dd       Bd     Gefd     Defd
Jan 2020  8.724264  4.926638 4.490761 1.200679 3.259495 4.221844 1.119227
Feb 2020  9.591093  5.037447 4.920490 1.451446 3.430439 4.629688 1.352062
Mar 2020 10.280677  5.166382 5.414581 1.779388 3.585497 5.102541 1.656855
Apr 2020 10.526983  6.410754 6.283431 1.936340 4.281713 5.919580 1.803306
May 2020 10.431896  7.618770 6.784693 1.936972 4.770434 6.371791 1.801735
Jun 2020 10.291196  9.102780 7.173615 1.762230 5.325771 6.725825 1.639105
Jul 2020 10.305233 10.035719 7.511162 1.534295 5.889296 7.057685 1.430693
Aug 2020 10.394823  8.638296 7.294596 1.545851 5.671038 6.878839 1.444652
Sep 2020 10.234397  6.695294 6.334415 1.648755 4.626287 5.981401 1.540270
Oct 2020  9.659930  4.543337 4.745656 1.538793 3.167473 4.468990 1.432641
Nov 2020  8.799330  4.636047 4.392761 1.244521 3.117122 4.133710 1.160036
Dec 2020  8.176418  3.439435 3.477964 1.128420 2.325448 3.274527 1.050661
             Befd
Jan 2020 3.081618
Feb 2020 3.251123
Mar 2020 3.411569
Apr 2020 4.071392
May 2020 4.516998
Jun 2020 5.027946
Jul 2020 5.566873
Aug 2020 5.380840
Sep 2020 4.400371
Oct 2020 3.009308
Nov 2020 2.952312
Dec 2020 2.207323

Yearly values:
          Bod      Bnd       Gd       Dd       Bd     Gefd     Defd     Befd
2020 3571.278 2321.821 2094.602 568.9922 1505.308 1971.109 530.1696 1427.002
-----------------
Mode of tracking:  fixed 
    Inclination:  27.2 
    Orientation:  0 
Object of class  Gef 

Source of meteorological information: prom- 

Latitude of source:  37.2 degrees
Latitude for calculations:  37.2 degrees

Monthly averages:
              Bod       Bnd        Gd       Dd       Bd      Gefd     Defd
Jan 2020 14.13536  4.926638  6.524644 1.440307 4.926638  6.351106 1.384005
Feb 2020 15.42754  5.037447  6.878023 1.671852 5.037447  6.683087 1.599744
Mar 2020 16.58107  5.166382  7.331502 1.997758 5.166382  7.106999 1.902055
Apr 2020 17.64047  6.410754  8.845143 2.265439 6.410754  8.579945 2.157663
May 2020 18.70771  7.618770 10.179147 2.394265 7.618770  9.886194 2.284025
Jun 2020 19.87238  9.102780 11.606787 2.329553 9.102780 11.293670 2.230246
Jul 2020 18.51695 10.035719 11.800488 2.029591 9.587736 11.494605 1.948939
Aug 2020 17.34098  8.638296 10.775475 1.948188 8.638296 10.491225 1.870116
Sep 2020 16.25295  6.695294  8.828402 1.948719 6.695294  8.582007 1.865545
Oct 2020 15.16994  4.543337  6.416144 1.711257 4.543337  6.223796 1.631728
Nov 2020 14.00493  4.636047  6.245177 1.453052 4.636047  6.074017 1.393429
Dec 2020 12.70717  3.439435  4.824824 1.254616 3.439435  4.685194 1.198821
             Befd
Jan 2020 4.828105
Feb 2020 4.936698
Mar 2020 5.063054
Apr 2020 6.282539
May 2020 7.466395
Jun 2020 8.920724
Jul 2020 9.395981
Aug 2020 8.465530
Sep 2020 6.561388
Oct 2020 4.452470
Nov 2020 4.543326
Dec 2020 3.370646

Yearly values:
          Bod      Bnd       Gd       Dd       Bd     Gefd     Defd     Befd
2020 5973.027 2321.821 3051.769 682.7701 2307.933 2966.428 653.0097 2261.774
-----------------
Mode of tracking:  two 
    Inclination limit: 90 
Object of class  Gef 

Source of meteorological information: prom- 

Latitude of source:  37.2 degrees
Latitude for calculations:  37.2 degrees

Monthly averages:
             Gef0d    Def0d    Bef0d        Gd       Dd       Bd      Gefd
Jan 2020  6.351106 1.384005 4.828105  6.524644 1.440307 4.926638  6.106104
Feb 2020  6.683087 1.599744 4.936698  6.878023 1.671852 5.037447  6.408875
Mar 2020  7.106999 1.902055 5.063054  7.331502 1.997758 5.166382  6.790603
Apr 2020  8.579945 2.157663 6.282539  8.845143 2.265439 6.410754  8.296654
May 2020  9.886194 2.284025 7.466395 10.179147 2.394265 7.618770  9.689012
Jun 2020 11.293670 2.230246 8.920724 11.606787 2.329553 9.102780 11.115237
Jul 2020 11.494605 1.948939 9.395981 11.800488 2.029591 9.587736 11.308173
Aug 2020 10.491225 1.870116 8.465530 10.775475 1.948188 8.638296 10.195305
Sep 2020  8.582007 1.865545 6.561388  8.828402 1.948719 6.695294  8.226460
Oct 2020  6.223796 1.631728 4.452470  6.416144 1.711257 4.543337  6.016188
Nov 2020  6.074017 1.393429 4.543326  6.245177 1.453052 4.636047  5.873803
Dec 2020  4.685194 1.198821 3.370646  4.824824 1.254616 3.439435  4.575582
             Defd     Befd
Jan 2020 1.343326 4.623782
Feb 2020 1.553435 4.708796
Mar 2020 1.847767 4.800946
Apr 2020 2.111597 6.045314
May 2020 2.253598 7.299639
Jun 2020 2.205213 8.767324
Jul 2020 1.925398 9.233090
Aug 2020 1.831105 8.208622
Sep 2020 1.810880 6.260507
Oct 2020 1.595753 4.280837
Nov 2020 1.359620 4.376920
Dec 2020 1.179350 3.280506

Yearly values:
        Gef0d    Def0d    Bef0d       Gd       Dd       Bd     Gefd     Defd
2020 2966.428 653.0097 2261.774 3051.769 682.7701 2307.933 2879.923 639.3807
         Befd
2020 2188.898
-----------------
Mode of tracking:  two 
    Inclination limit: 90 
Warning message:
In checkG0Ta(file, maxmin = TRUE) :
  Ambient temperature data is not available. A new column with a constant value has been added.
Object of class  Gef 

Source of meteorological information: bd-aguiar 

Latitude of source:  37.2 degrees
Latitude for calculations:  37.2 degrees

Monthly averages:
              Bod      Bnd        Gd       Dd       Bd      Gefd     Defd
Jan 2020 13.40140 4.361980  5.983165 1.490105 4.335876  5.813498 1.425831
Feb 2020 14.88373 2.990387  4.255678 1.153551 2.990387  4.126515 1.098791
Mar 2020 16.20907 4.867739  7.067372 2.063632 4.836943  6.840859 1.959238
Apr 2020 17.63733 5.907975  8.624211 2.545506 5.907975  8.346726 2.415507
May 2020 18.61484 6.842086  9.776609 2.838228 6.772050  9.466832 2.694181
Jun 2020 19.85775 8.234159 11.228901 2.820331 8.234159 10.900157 2.688015
Jul 2020 19.20131 8.969250 11.724936 2.614783 8.926819 11.400675 2.502500
Aug 2020 17.37538 7.655692 10.339560 2.528854 7.623523 10.039723 2.414605
Sep 2020 16.81519 6.047245  8.482565 2.291249 6.009460  8.224348 2.182267
Oct 2020 15.00850 3.820261  5.814320 1.846153 3.811158  5.619847 1.749576
Nov 2020 13.89238 4.190170  5.827775 1.485269 4.190170  5.659963 1.419889
Dec 2020 12.70952 3.217529  4.635443 1.287613 3.217529  4.497051 1.228595
             Befd
Jan 2020 4.249159
Feb 2020 2.930579
Mar 2020 4.740204
Apr 2020 5.789816
May 2020 6.636609
Jun 2020 8.069476
Jul 2020 8.748283
Aug 2020 7.471053
Sep 2020 5.889271
Oct 2020 3.734934
Nov 2020 4.106367
Dec 2020 3.153179

Yearly values:
          Bod      Bnd       Gd      Dd       Bd     Gefd     Defd     Befd
2020 5965.829 2049.878 2863.902 762.474 2042.215 2777.638 726.2456 2001.371
-----------------
Mode of tracking:  two 
    Inclination limit: 90 
Object of class  Gef 

Source of meteorological information: bd-aguiar 

Latitude of source:  37.2 degrees
Latitude for calculations:  37.2 degrees

Monthly averages:
             Gef0d    Def0d    Bef0d        Gd       Dd       Bd      Gefd
Jan 2020  5.813498 1.425831 4.249159  5.983165 1.490105 4.335876  5.662321
Feb 2020  4.126515 1.098791 2.930579  4.255678 1.153551 2.990387  3.999722
Mar 2020  6.840859 1.959238 4.740204  7.067372 2.063632 4.836943  6.603692
Apr 2020  8.346726 2.415507 5.789816  8.624211 2.545506 5.907975  8.067930
May 2020  9.466832 2.694181 6.636609  9.776609 2.838228 6.772050  9.314682
Jun 2020 10.900157 2.688015 8.069476 11.228901 2.820331 8.234159 10.742469
Jul 2020 11.400675 2.502500 8.748283 11.724936 2.614783 8.926819 11.192879
Aug 2020 10.039723 2.414605 7.471053 10.339560 2.528854 7.623523  9.786936
Sep 2020  8.224348 2.182267 5.889271  8.482565 2.291249 6.009460  7.862291
Oct 2020  5.619847 1.749576 3.734934  5.814320 1.846153 3.811158  5.476420
Nov 2020  5.659963 1.419889 4.106367  5.827775 1.485269 4.190170  5.491856
Dec 2020  4.497051 1.228595 3.153179  4.635443 1.287613 3.217529  4.396447
             Defd     Befd
Jan 2020 1.400092 4.123721
Feb 2020 1.077370 2.825206
Mar 2020 1.919766 4.542510
Apr 2020 2.367712 5.558815
May 2020 2.668149 6.510492
Jun 2020 2.662676 7.937127
Jul 2020 2.470226 8.572761
Aug 2020 2.373928 7.258943
Sep 2020 2.121294 5.588186
Oct 2020 1.724248 3.616836
Nov 2020 1.391029 3.967120
Dec 2020 1.210319 3.070851

Yearly values:
        Gef0d    Def0d    Bef0d       Gd      Dd       Bd     Gefd     Defd
2020 2777.638 726.2456 2001.371 2863.902 762.474 2042.215 2706.363 714.2936
         Befd
2020 1942.048
-----------------
Mode of tracking:  two 
    Inclination limit: 90 

solaR documentation built on Oct. 19, 2021, 9:06 a.m.